fix: address code review feedback - fix ref update, extract constants, improve progress tracking

Co-authored-by: Yukaii <4230968+Yukaii@users.noreply.github.com>
Agent-Logs-Url: https://github.com/hackmdio/api-client/sessions/a73c91f7-229e-482d-b038-6bb8e454ab09

Author: Copilot

README.md

@@ -51,6 +51,26 @@ To run the book mode conference example:
 
 This example demonstrates advanced usage patterns including bulk operations, team note management, and creating interconnected note structures for conferences or events.
 
+### AI Conference Assistant (Web)
+
+The `examples/ai-conference-assistant/` directory contains a web-based AI assistant that helps create book-mode conference notes through a chat interface:
+
+- **Chat Interface**: Conversational AI (powered by Vercel AI SDK) guides you through conference note creation
+- **Frontend API Key Entry**: Provide your HackMD and OpenAI API keys from the browser — no server-side secrets needed
+- **Session Data Analysis**: Upload conference session JSON; the AI uses a jq-like tool to efficiently analyze data shape
+- **Reference Note Fetching**: Point the AI to existing HackMD notes to replicate formatting from previous conferences
+- **Markdown Preview**: Preview the generated homepage and all session pages before creating
+- **Rate-Limit-Aware Creation**: Batch note creation with configurable delay and real-time SSE progress tracking
+
+To run the AI conference assistant:
+
+1. Navigate to the example directory: `cd examples/ai-conference-assistant`
+2. Install dependencies: `npm install`
+3. Start the development server: `npm run dev`
+4. Open [http://localhost:3000](http://localhost:3000) and enter your credentials
+
+See [examples/ai-conference-assistant/README.md](./examples/ai-conference-assistant/README.md) for full documentation.
+
 ## LICENSE
 
 MIT

examples/ai-conference-assistant/public/file.svg

@@ -144,8 +144,8 @@ export async function POST(req: Request) {
             `/${shortId}`,
           )
         }
-        // Remove any remaining unresolved placeholders (failed sessions)
-        homepageContent = homepageContent.replace(/\/{noteUrl:[^}]+}/g, '#')
+        // Remove lines with unresolved placeholders (failed sessions)
+        homepageContent = homepageContent.replace(/^.*\/{noteUrl:[^}]+}.*\n?/gm, '')
 
         const mainNote = await client.createTeamNote(config.teamPath, {
           title: homepage.title,

examples/ai-conference-assistant/public/globe.svg

@@ -1,6 +1,6 @@
 'use client'
 
-import { useState, useRef } from 'react'
+import { useState, useRef, useEffect } from 'react'
 import { SetupPanel } from '@/components/setup-panel'
 import { ChatPanel } from '@/components/chat-panel'
 import { PreviewPanel } from '@/components/preview-panel'
@@ -26,7 +26,7 @@ export default function Home() {
   const [showProgress, setShowProgress] = useState(false)
   const [previewPage, setPreviewPage] = useState<{ title: string; content: string } | null>(null)
   const sessionDataRef = useRef(sessionData)
-  sessionDataRef.current = sessionData
+  useEffect(() => { sessionDataRef.current = sessionData }, [sessionData])
 
   if (!config) {
     return <SetupPanel onConfigured={setConfig} />

examples/ai-conference-assistant/public/next.svg

@@ -25,6 +25,7 @@ export function ChatPanel({
   generatedData,
 }: ChatPanelProps) {
   const [fileUploaded, setFileUploaded] = useState(false)
+  const [sessionDataSent, setSessionDataSent] = useState(false)
   const [inputValue, setInputValue] = useState('')
   const messagesEndRef = useRef<HTMLDivElement>(null)
   const fileInputRef = useRef<HTMLInputElement>(null)
@@ -77,10 +78,11 @@ export function ChatPanel({
     if (
       fileUploaded &&
       sessionData.current &&
-      !messages.some(m => m.parts?.some(p => p.type === 'text' && p.text.includes('[Session data uploaded')))
+      !sessionDataSent
     ) {
       const count = JSON.parse(sessionData.current).length
       text = `${inputValue}\n\n[Session data uploaded - ${count} sessions]\n<session_data>\n${sessionData.current}\n</session_data>`
+      setSessionDataSent(true)
     }
 
     sendMessage({ text })

examples/ai-conference-assistant/public/vercel.svg

@@ -105,21 +105,23 @@ export function ProgressModal({ config, generatedData, onClose }: ProgressModalP
           setCurrent(event.current)
 
           if (event.noteCreated) {
+            const created = event.noteCreated
             setLogs(prev => [
               ...prev,
               {
                 type: 'success',
-                text: `✅ ${event.noteCreated!.title} → ${event.noteCreated!.url}`,
+                text: `✅ ${created.title} → ${created.url}`,
               },
             ])
           }
 
           if (event.error) {
+            const err = event.error
             setLogs(prev => [
               ...prev,
               {
                 type: 'error',
-                text: `❌ ${event.error!.title || 'Error'}: ${event.error!.message}`,
+                text: `❌ ${err.title || 'Error'}: ${err.message}`,
               },
             ])
           }