chatgsd 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts","../src/ChatGSD.tsx"],"sourcesContent":["// Components\nexport { ChatGSD } from \"./ChatGSD\";\nexport type { ChatGSDProps } from \"./ChatGSD\";\n\n// Types\nexport type {\n ChatMessage,\n ToolStatus,\n ToolCall,\n ToolResult,\n ToolHandler,\n Tool,\n ChatContext,\n ChatApiRequest,\n} from \"./types\";\n","import { useState, useRef, useEffect, useCallback } from \"react\";\nimport type { KeyboardEvent, ReactNode } from \"react\";\nimport type { ChatMessage, ToolStatus, Tool, ToolResult, ChatContext } from \"./types\";\n\nfunction generateId(): string {\n return Math.random().toString(36).substring(2, 11);\n}\n\n// Parse tool calls from content: [TOOL:name] or [TOOL:name({\"arg\": \"value\"})]\nfunction parseToolCall(content: string): { name: string; args: Record<string, unknown> } | null {\n const match = content.match(/\\[TOOL:(\\w+)(?:\\((\\{.*\\})\\))?\\]$/);\n if (!match) return null;\n \n const name = match[1];\n let args: Record<string, unknown> = {};\n \n if (match[2]) {\n try {\n args = JSON.parse(match[2]);\n } catch {\n // Invalid JSON, use empty args\n }\n }\n \n return { name, args };\n}\n\nexport interface ChatGSDProps {\n /** Initial system message to display */\n initialMessage?: string;\n /** Callback when messages change */\n onMessagesChange?: (messages: ChatMessage[]) => void;\n /** Tool definitions - key is tool name, value is tool config */\n tools?: Record<string, Tool>;\n /** Custom chat API endpoint */\n endpoint?: string;\n /** Custom headers to include in API requests */\n headers?: Record<string, string>;\n /** Additional context to send with each request */\n context?: ChatContext;\n /** Brand name to display in chat */\n brandName?: string;\n /** Custom class name */\n className?: string;\n /** Called when conversation ends (terminal tool completes) */\n onComplete?: (messages: ChatMessage[]) => void;\n}\n\ninterface ActiveTool {\n name: string;\n status: ToolStatus;\n result?: ToolResult;\n}\n\nexport function ChatGSD({\n initialMessage = \"How can I help you today?\",\n onMessagesChange,\n tools = {},\n endpoint = \"/api/chat\",\n headers = {},\n context = {},\n brandName = \"assistant\",\n className = \"\",\n onComplete,\n}: ChatGSDProps) {\n const [messages, setMessages] = useState<ChatMessage[]>([\n {\n id: generateId(),\n role: \"system\",\n content: initialMessage,\n timestamp: new Date(),\n },\n ]);\n const [input, setInput] = useState(\"\");\n const [cursorVisible, setCursorVisible] = useState(true);\n const [isLoading, setIsLoading] = useState(false);\n const [conversationEnded, setConversationEnded] = useState(false);\n const [activeTool, setActiveTool] = useState<ActiveTool | null>(null);\n const messagesEndRef = useRef<HTMLDivElement>(null);\n const inputRef = useRef<HTMLTextAreaElement>(null);\n const toolTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n // Cursor blink effect\n useEffect(() => {\n const interval = setInterval(() => setCursorVisible((v) => !v), 530);\n return () => clearInterval(interval);\n }, []);\n\n // Auto-scroll to bottom\n useEffect(() => {\n messagesEndRef.current?.scrollIntoView({\n behavior: \"smooth\",\n block: \"nearest\",\n });\n });\n\n // Focus input on mount\n useEffect(() => {\n inputRef.current?.focus();\n }, []);\n\n // Cleanup timeout on unmount\n useEffect(() => {\n return () => {\n if (toolTimeoutRef.current) {\n clearTimeout(toolTimeoutRef.current);\n }\n };\n }, []);\n\n const executeTool = useCallback(\n async (toolName: string, args: Record<string, unknown>, currentMessages: ChatMessage[]) => {\n const tool = tools[toolName];\n if (!tool) {\n console.warn(`Unknown tool: ${toolName}`);\n return;\n }\n\n setActiveTool({ name: toolName, status: \"calling\" });\n\n // Small delay for visual feedback\n await new Promise((resolve) => {\n toolTimeoutRef.current = setTimeout(resolve, 800);\n });\n\n try {\n const result = await tool.handler(args, currentMessages);\n setActiveTool({ name: toolName, status: result.success ? \"success\" : \"error\", result });\n\n if (tool.terminal) {\n setConversationEnded(true);\n onComplete?.(currentMessages);\n }\n } catch (err) {\n const message = err instanceof Error ? err.message : \"Tool execution failed\";\n setActiveTool({ name: toolName, status: \"error\", result: { success: false, message } });\n }\n },\n [tools, onComplete]\n );\n\n const fetchAIResponse = useCallback(\n async (updatedMessages: ChatMessage[]) => {\n setIsLoading(true);\n\n const aiMessage: ChatMessage = {\n id: generateId(),\n role: \"system\",\n content: \"\",\n timestamp: new Date(),\n };\n setMessages((prev) => [...prev, aiMessage]);\n\n try {\n const res = await fetch(endpoint, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n ...headers,\n },\n body: JSON.stringify({\n messages: updatedMessages.map((m) => ({\n role: m.role,\n content: m.content,\n })),\n context,\n }),\n });\n\n if (res.ok && res.body) {\n const reader = res.body.getReader();\n const decoder = new TextDecoder();\n let fullContent = \"\";\n\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n\n const chunk = decoder.decode(value, { stream: true });\n fullContent += chunk;\n\n // Strip any tool call from display\n const displayContent = fullContent.replace(/\\n?\\[TOOL:\\w+(?:\\(\\{.*\\}\\))?\\]$/, \"\");\n setMessages((prev) => {\n const updated = [...prev];\n const last = updated[updated.length - 1];\n if (last.role === \"system\") {\n last.content = displayContent;\n }\n return updated;\n });\n }\n\n // Check for tool call\n const toolCall = parseToolCall(fullContent);\n if (toolCall) {\n const finalMessages = [...updatedMessages, { \n id: generateId(), \n role: \"system\" as const, \n content: fullContent.replace(/\\n?\\[TOOL:\\w+(?:\\(\\{.*\\}\\))?\\]$/, \"\"),\n timestamp: new Date()\n }];\n await executeTool(toolCall.name, toolCall.args, finalMessages);\n }\n }\n } catch {\n // Silently fail - the chat still works without AI responses\n } finally {\n setIsLoading(false);\n }\n },\n [endpoint, headers, context, executeTool]\n );\n\n const handleSend = useCallback(async () => {\n if (!input.trim() || isLoading || conversationEnded) return;\n\n const newMessage: ChatMessage = {\n id: generateId(),\n role: \"user\",\n content: input.trim(),\n timestamp: new Date(),\n };\n const updated = [...messages, newMessage];\n setMessages(updated);\n onMessagesChange?.(updated);\n setInput(\"\");\n\n await fetchAIResponse(updated);\n }, [input, isLoading, conversationEnded, messages, onMessagesChange, fetchAIResponse]);\n\n const handleKeyDown = useCallback(\n async (e: KeyboardEvent<HTMLTextAreaElement>) => {\n if (e.key === \"Enter\" && !e.shiftKey) {\n e.preventDefault();\n await handleSend();\n }\n },\n [handleSend]\n );\n\n const downloadTranscript = useCallback(() => {\n const transcript = messages\n .map((m) => `${m.role === \"system\" ? `[${brandName}]` : \"[you]\"} ${m.content}`)\n .join(\"\\n\\n\");\n const blob = new Blob([transcript], { type: \"text/plain\" });\n const url = URL.createObjectURL(blob);\n const a = document.createElement(\"a\");\n a.href = url;\n a.download = `chat-${new Date().toISOString().split(\"T\")[0]}.txt`;\n a.click();\n URL.revokeObjectURL(url);\n }, [messages, brandName]);\n\n // Render tool status\n const renderToolStatus = (): ReactNode => {\n if (!activeTool) return null;\n\n const tool = tools[activeTool.name];\n const { name, status, result } = activeTool;\n\n if (status === \"calling\") {\n if (tool?.renderCalling) {\n return tool.renderCalling();\n }\n return (\n <div className=\"chatgsd-status-calling\">\n <span className=\"chatgsd-message-prefix\">[tool]</span>\n <span className=\"chatgsd-status-spinner\">\n <span className=\"chatgsd-spinner\">&#x25D0;</span>\n <span>{name}()</span>\n </span>\n </div>\n );\n }\n\n if (status === \"success\") {\n if (tool?.renderSuccess && result) {\n return tool.renderSuccess(result);\n }\n return (\n <div className=\"chatgsd-status-success\">\n <span className=\"chatgsd-message-prefix\">[tool]</span>\n <span>&#x2713; {name}() — {result?.message || \"success\"}</span>\n </div>\n );\n }\n\n if (status === \"error\") {\n if (tool?.renderError && result) {\n return tool.renderError(result);\n }\n return (\n <div className=\"chatgsd-status-error\">\n <span className=\"chatgsd-message-prefix\">[tool]</span>\n <span>&#x2717; {name}() — {result?.message || \"failed\"}</span>\n </div>\n );\n }\n\n return null;\n };\n\n return (\n <div className={`chatgsd ${className}`.trim()}>\n {/* Messages area */}\n <div className=\"chatgsd-messages\">\n {messages.map((msg) => (\n <div key={msg.id} className=\"chatgsd-message\">\n {msg.role === \"system\" ? (\n <div className=\"chatgsd-message-system\">\n <span className=\"chatgsd-message-prefix\">[{brandName}]</span>{\" \"}\n {msg.content}\n </div>\n ) : (\n <div className=\"chatgsd-message-user\">\n <span className=\"chatgsd-message-prompt\">&gt;</span>{\" \"}\n {msg.content}\n </div>\n )}\n </div>\n ))}\n\n {activeTool && activeTool.status !== \"idle\" && (\n <div className=\"chatgsd-tool-status\">\n {renderToolStatus()}\n </div>\n )}\n\n <div ref={messagesEndRef} />\n </div>\n\n {/* Input area */}\n <div className=\"chatgsd-input-area\">\n {conversationEnded ? (\n <div className=\"chatgsd-session-complete\">\n <span className=\"chatgsd-session-label\">session complete</span>\n <button\n type=\"button\"\n onClick={downloadTranscript}\n className=\"chatgsd-download-btn\"\n >\n <span>&#x2193;</span> download transcript\n </button>\n </div>\n ) : (\n <>\n <div className=\"chatgsd-input-line\">\n <span className=\"chatgsd-message-prompt\">&gt;</span>\n <div className=\"chatgsd-input-display\">\n <span className=\"chatgsd-input-text\">{input}</span>\n <span\n className={`chatgsd-cursor ${cursorVisible ? \"chatgsd-cursor-visible\" : \"chatgsd-cursor-hidden\"}`}\n >\n &#x2588;\n </span>\n <textarea\n ref={inputRef}\n value={input}\n onChange={(e) => setInput(e.target.value)}\n onKeyDown={handleKeyDown}\n rows={1}\n className=\"chatgsd-sr-only\"\n disabled={conversationEnded}\n aria-label=\"Chat input\"\n />\n </div>\n </div>\n <div className=\"chatgsd-input-hint\">\n press enter to send · shift+enter for new line\n </div>\n </>\n )}\n </div>\n </div>\n );\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/index.ts","../src/ChatGSD.tsx"],"sourcesContent":["// Components\nexport { ChatGSD } from \"./ChatGSD\";\nexport type { ChatGSDProps, ChatGSDHandle } from \"./ChatGSD\";\n\n// Types\nexport type {\n ChatMessage,\n ToolStatus,\n ToolCall,\n ToolResult,\n ToolCallContext,\n ToolHandler,\n Tool,\n ChatContext,\n ChatApiRequest,\n} from \"./types\";\n","import { useState, useRef, useEffect, useCallback, useImperativeHandle, forwardRef } from \"react\";\nimport type { KeyboardEvent, ReactNode, Ref } from \"react\";\nimport type { ChatMessage, ToolStatus, Tool, ToolResult, ToolCallContext, ChatContext } from \"./types\";\n\n/** Methods exposed via ref for programmatic control */\nexport interface ChatGSDHandle {\n /** Submit the current input programmatically */\n submit: () => Promise<void>;\n /** Submit a specific message (bypasses input field) */\n submitMessage: (content: string) => Promise<void>;\n /** Get current messages */\n getMessages: () => ChatMessage[];\n /** Focus the input field */\n focus: () => void;\n}\n\nfunction generateId(): string {\n return Math.random().toString(36).substring(2, 11);\n}\n\n// Stream event types\ntype StreamEvent =\n | { type: \"text\"; content: string }\n | { type: \"tool_call\"; name: string; args: Record<string, unknown> }\n | { type: \"error\"; message: string }\n | { type: \"done\" };\n\n// Parse SSE events from a line\nfunction parseSSELine(line: string): StreamEvent | null {\n if (!line.startsWith(\"data: \")) return null;\n const data = line.slice(6);\n if (data === \"[DONE]\") return { type: \"done\" };\n\n try {\n const parsed = JSON.parse(data);\n\n // Handle AI SDK format\n if (parsed.type === \"text-delta\" || parsed.type === \"text_delta\") {\n return { type: \"text\", content: parsed.textDelta ?? parsed.text_delta ?? \"\" };\n }\n if (parsed.type === \"tool-call\" || parsed.type === \"tool_call\") {\n return {\n type: \"tool_call\",\n name: parsed.toolName ?? parsed.tool_name ?? parsed.name,\n args: parsed.args ?? parsed.arguments ?? {},\n };\n }\n\n // Handle simple format: { type, content/name/args }\n if (parsed.type === \"text\") {\n return { type: \"text\", content: parsed.content ?? \"\" };\n }\n if (parsed.type === \"tool_call\") {\n return { type: \"tool_call\", name: parsed.name, args: parsed.args ?? {} };\n }\n if (parsed.type === \"error\") {\n return { type: \"error\", message: parsed.message ?? \"Unknown error\" };\n }\n if (parsed.type === \"done\") {\n return { type: \"done\" };\n }\n\n // OpenAI format: choices[0].delta.content\n if (parsed.choices?.[0]?.delta?.content) {\n return { type: \"text\", content: parsed.choices[0].delta.content };\n }\n\n return null;\n } catch {\n return null;\n }\n}\n\n// Parse Vercel AI SDK data stream format\n// Format: TYPE_CODE:JSON_VALUE\\n\n// 0 = text delta, 8 = tool call, 9 = tool result, d/e = finish\nfunction parseAISDKLine(line: string): StreamEvent | null {\n // Match: digit(s):data\n const match = line.match(/^(\\d+):(.+)$/);\n if (!match) return null;\n\n const [, typeCode, data] = match;\n\n try {\n switch (typeCode) {\n case \"0\": {\n // Text delta - data is a JSON string\n const text = JSON.parse(data);\n return { type: \"text\", content: text };\n }\n case \"8\": {\n // Tool call\n const parsed = JSON.parse(data);\n return {\n type: \"tool_call\",\n name: parsed.toolName ?? parsed.name,\n args: parsed.args ?? {},\n };\n }\n case \"d\":\n case \"e\": {\n // Finish events\n return { type: \"done\" };\n }\n default:\n return null;\n }\n } catch {\n return null;\n }\n}\n\n// Parse tool calls from text content: [TOOL:name] or [TOOL:name({\"arg\": \"value\"})]\nfunction parseToolCallFromText(content: string): { name: string; args: Record<string, unknown> } | null {\n const match = content.match(/\\[TOOL:(\\w+)(?:\\((\\{.*\\})\\))?\\]\\s*$/);\n if (!match) return null;\n\n const name = match[1];\n let args: Record<string, unknown> = {};\n\n if (match[2]) {\n try {\n args = JSON.parse(match[2]);\n } catch {\n // Invalid JSON, use empty args\n }\n }\n\n return { name, args };\n}\n\nexport interface ChatGSDProps {\n /** Initial system message to display */\n initialMessage?: string;\n /** Callback when messages change */\n onMessagesChange?: (messages: ChatMessage[]) => void;\n /** Tool definitions - key is tool name, value is tool config */\n tools?: Record<string, Tool>;\n /** Custom chat API endpoint */\n endpoint?: string;\n /** Custom headers to include in API requests */\n headers?: Record<string, string>;\n /** Additional context to send with each request */\n context?: ChatContext;\n /** Brand name to display in chat */\n brandName?: string;\n /** Custom class name */\n className?: string;\n /** Called when conversation ends (terminal tool completes) */\n onComplete?: (messages: ChatMessage[]) => void;\n /** Stream format: auto-detect, SSE, or plain text */\n format?: \"auto\" | \"sse\" | \"text\";\n}\n\ninterface ActiveTool {\n name: string;\n args: Record<string, unknown>;\n status: ToolStatus;\n result?: ToolResult;\n}\n\nfunction ChatGSDInner(\n {\n initialMessage = \"How can I help you today?\",\n onMessagesChange,\n tools = {},\n endpoint = \"/api/chat\",\n headers = {},\n context = {},\n brandName = \"assistant\",\n className = \"\",\n onComplete,\n format = \"auto\",\n }: ChatGSDProps,\n ref: Ref<ChatGSDHandle>\n) {\n const [messages, setMessages] = useState<ChatMessage[]>([\n {\n id: generateId(),\n role: \"system\",\n content: initialMessage,\n timestamp: new Date(),\n },\n ]);\n const [input, setInput] = useState(\"\");\n const [cursorVisible, setCursorVisible] = useState(true);\n const [isLoading, setIsLoading] = useState(false);\n const [conversationEnded, setConversationEnded] = useState(false);\n const [activeTool, setActiveTool] = useState<ActiveTool | null>(null);\n const messagesEndRef = useRef<HTMLDivElement>(null);\n const inputRef = useRef<HTMLTextAreaElement>(null);\n const toolTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n // Cursor blink effect\n useEffect(() => {\n const interval = setInterval(() => setCursorVisible((v) => !v), 530);\n return () => clearInterval(interval);\n }, []);\n\n // Auto-scroll to bottom\n useEffect(() => {\n messagesEndRef.current?.scrollIntoView({\n behavior: \"smooth\",\n block: \"nearest\",\n });\n });\n\n // Focus input on mount\n useEffect(() => {\n inputRef.current?.focus();\n }, []);\n\n // Cleanup timeout on unmount\n useEffect(() => {\n return () => {\n if (toolTimeoutRef.current) {\n clearTimeout(toolTimeoutRef.current);\n }\n };\n }, []);\n\n const executeTool = useCallback(\n async (toolName: string, args: Record<string, unknown>, currentMessages: ChatMessage[]) => {\n const tool = tools[toolName];\n if (!tool) {\n console.warn(`Unknown tool: ${toolName}`);\n return;\n }\n\n setActiveTool({ name: toolName, args, status: \"calling\" });\n\n // Small delay for visual feedback\n await new Promise((resolve) => {\n toolTimeoutRef.current = setTimeout(resolve, 800);\n });\n\n try {\n const result = await tool.handler(args, currentMessages);\n setActiveTool({ name: toolName, args, status: result.success ? \"success\" : \"error\", result });\n\n if (tool.terminal) {\n setConversationEnded(true);\n onComplete?.(currentMessages);\n }\n } catch (err) {\n const message = err instanceof Error ? err.message : \"Tool execution failed\";\n setActiveTool({ name: toolName, args, status: \"error\", result: { success: false, message } });\n }\n },\n [tools, onComplete]\n );\n\n // Parse a line trying both SSE and AI SDK formats\n const parseLine = useCallback((line: string): StreamEvent | null => {\n return parseSSELine(line) ?? parseAISDKLine(line);\n }, []);\n\n // Process SSE/AI SDK stream\n const processSSEStream = useCallback(\n async (reader: ReadableStreamDefaultReader<Uint8Array>, onText: (text: string) => void): Promise<StreamEvent | null> => {\n const decoder = new TextDecoder();\n let buffer = \"\";\n let toolCall: StreamEvent | null = null;\n\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n\n buffer += decoder.decode(value, { stream: true });\n const lines = buffer.split(\"\\n\");\n buffer = lines.pop() || \"\";\n\n for (const line of lines) {\n const trimmed = line.trim();\n if (!trimmed) continue;\n\n const event = parseLine(trimmed);\n if (!event) continue;\n\n if (event.type === \"text\") {\n onText(event.content);\n } else if (event.type === \"tool_call\") {\n toolCall = event;\n } else if (event.type === \"done\") {\n return toolCall;\n }\n }\n }\n\n // Process remaining buffer\n if (buffer.trim()) {\n const event = parseLine(buffer.trim());\n if (event?.type === \"tool_call\") {\n toolCall = event;\n }\n }\n\n return toolCall;\n },\n [parseLine]\n );\n\n // Process plain text stream - mirrors old TerminalChat exactly\n const processTextStream = useCallback(\n async (reader: ReadableStreamDefaultReader<Uint8Array>, onText: (text: string) => void): Promise<StreamEvent | null> => {\n const decoder = new TextDecoder();\n let fullContent = \"\";\n\n // eslint-disable-next-line no-constant-condition\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n\n const chunk = decoder.decode(value, { stream: true });\n fullContent += chunk;\n\n // Update display without tool call syntax\n const displayContent = fullContent.replace(/\\n?\\[TOOL:\\w+(?:\\(\\{.*\\}\\))?\\]\\s*$/, \"\");\n onText(displayContent);\n }\n\n // Check for tool call at end\n const toolCall = parseToolCallFromText(fullContent);\n if (toolCall) {\n return { type: \"tool_call\", name: toolCall.name, args: toolCall.args };\n }\n\n return null;\n },\n []\n );\n\n const fetchAIResponse = useCallback(\n async (updatedMessages: ChatMessage[]) => {\n setIsLoading(true);\n\n const aiMessageId = generateId();\n const aiMessage: ChatMessage = {\n id: aiMessageId,\n role: \"system\",\n content: \"\",\n timestamp: new Date(),\n };\n setMessages((prev) => [...prev, aiMessage]);\n\n let currentContent = \"\";\n const updateContent = (content: string) => {\n currentContent = content;\n setMessages((prev) => {\n const updated = [...prev];\n const msgIndex = updated.findIndex((m) => m.id === aiMessageId);\n if (msgIndex !== -1) {\n updated[msgIndex] = { ...updated[msgIndex], content };\n }\n return updated;\n });\n };\n\n try {\n const res = await fetch(endpoint, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n ...headers,\n },\n body: JSON.stringify({\n messages: updatedMessages.map((m) => ({\n role: m.role,\n content: m.content,\n })),\n context,\n }),\n });\n\n if (!res.ok || !res.body) {\n throw new Error(\"Failed to fetch response\");\n }\n\n const contentType = res.headers.get(\"Content-Type\") || \"\";\n const reader = res.body.getReader();\n\n // Determine format\n let useSSE = format === \"sse\";\n if (format === \"auto\") {\n useSSE = contentType.includes(\"text/event-stream\");\n }\n\n let toolCallEvent: StreamEvent | null = null;\n\n if (useSSE) {\n toolCallEvent = await processSSEStream(reader, (text) => {\n currentContent += text;\n updateContent(currentContent);\n });\n } else {\n toolCallEvent = await processTextStream(reader, updateContent);\n }\n\n // Execute tool if one was called\n if (toolCallEvent?.type === \"tool_call\") {\n const finalMessages: ChatMessage[] = [\n ...updatedMessages,\n {\n id: aiMessageId,\n role: \"system\",\n content: currentContent,\n timestamp: new Date(),\n },\n ];\n await executeTool(toolCallEvent.name, toolCallEvent.args, finalMessages);\n }\n } catch (err) {\n console.error(\"Chat error:\", err);\n } finally {\n setIsLoading(false);\n }\n },\n [endpoint, headers, context, format, processSSEStream, processTextStream, executeTool]\n );\n\n const handleSend = useCallback(async () => {\n if (!input.trim() || isLoading || conversationEnded) return;\n\n const newMessage: ChatMessage = {\n id: generateId(),\n role: \"user\",\n content: input.trim(),\n timestamp: new Date(),\n };\n const updated = [...messages, newMessage];\n setMessages(updated);\n onMessagesChange?.(updated);\n setInput(\"\");\n\n await fetchAIResponse(updated);\n }, [input, isLoading, conversationEnded, messages, onMessagesChange, fetchAIResponse]);\n\n const handleKeyDown = useCallback(\n async (e: KeyboardEvent<HTMLTextAreaElement>) => {\n if (e.key === \"Enter\" && !e.shiftKey) {\n e.preventDefault();\n await handleSend();\n }\n },\n [handleSend]\n );\n\n const downloadTranscript = useCallback(() => {\n const transcript = messages\n .map((m) => `${m.role === \"system\" ? `[${brandName}]` : \"[you]\"} ${m.content}`)\n .join(\"\\n\\n\");\n const blob = new Blob([transcript], { type: \"text/plain\" });\n const url = URL.createObjectURL(blob);\n const a = document.createElement(\"a\");\n a.href = url;\n a.download = `chat-${new Date().toISOString().split(\"T\")[0]}.txt`;\n a.click();\n URL.revokeObjectURL(url);\n }, [messages, brandName]);\n\n // Submit a specific message programmatically\n const submitMessage = useCallback(\n async (content: string) => {\n if (!content.trim() || isLoading || conversationEnded) return;\n\n const newMessage: ChatMessage = {\n id: generateId(),\n role: \"user\",\n content: content.trim(),\n timestamp: new Date(),\n };\n const updated = [...messages, newMessage];\n setMessages(updated);\n onMessagesChange?.(updated);\n\n await fetchAIResponse(updated);\n },\n [isLoading, conversationEnded, messages, onMessagesChange, fetchAIResponse]\n );\n\n // Expose imperative methods via ref\n useImperativeHandle(ref, () => ({\n submit: handleSend,\n submitMessage,\n getMessages: () => messages,\n focus: () => inputRef.current?.focus(),\n }), [handleSend, submitMessage, messages]);\n\n // Render tool status\n const renderToolStatus = (): ReactNode => {\n if (!activeTool) return null;\n\n const tool = tools[activeTool.name];\n const { name, args, status, result } = activeTool;\n const ctx: ToolCallContext = { name, args, result };\n\n if (status === \"calling\") {\n if (tool?.renderCalling) {\n return tool.renderCalling(ctx);\n }\n return (\n <div className=\"chatgsd-status-calling\">\n <span className=\"chatgsd-message-prefix\">[tool]</span>\n <span className=\"chatgsd-status-spinner\">\n <span className=\"chatgsd-spinner\">&#x25D0;</span>\n <span>{name}()</span>\n </span>\n </div>\n );\n }\n\n if (status === \"success\") {\n if (tool?.renderSuccess) {\n return tool.renderSuccess(ctx);\n }\n return (\n <div className=\"chatgsd-status-success\">\n <span className=\"chatgsd-message-prefix\">[tool]</span>\n <span>&#x2713; {name}() — {result?.message || \"success\"}</span>\n </div>\n );\n }\n\n if (status === \"error\") {\n if (tool?.renderError) {\n return tool.renderError(ctx);\n }\n return (\n <div className=\"chatgsd-status-error\">\n <span className=\"chatgsd-message-prefix\">[tool]</span>\n <span>&#x2717; {name}() — {result?.message || \"failed\"}</span>\n </div>\n );\n }\n\n return null;\n };\n\n return (\n <div className={`chatgsd ${className}`.trim()}>\n {/* Messages area */}\n <div className=\"chatgsd-messages\">\n {messages.map((msg) => (\n <div key={msg.id} className=\"chatgsd-message\">\n {msg.role === \"system\" ? (\n <div className=\"chatgsd-message-system\">\n <span className=\"chatgsd-message-prefix\">[{brandName}]</span>{\" \"}\n {msg.content}\n </div>\n ) : (\n <div className=\"chatgsd-message-user\">\n <span className=\"chatgsd-message-prompt\">&gt;</span>{\" \"}\n {msg.content}\n </div>\n )}\n </div>\n ))}\n\n {activeTool && activeTool.status !== \"idle\" && (\n <div className=\"chatgsd-tool-status\">\n {renderToolStatus()}\n </div>\n )}\n\n <div ref={messagesEndRef} />\n </div>\n\n {/* Input area */}\n <div className=\"chatgsd-input-area\">\n {conversationEnded ? (\n <div className=\"chatgsd-session-complete\">\n <span className=\"chatgsd-session-label\">session complete</span>\n <button\n type=\"button\"\n onClick={downloadTranscript}\n className=\"chatgsd-download-btn\"\n >\n <span>&#x2193;</span> download transcript\n </button>\n </div>\n ) : (\n <>\n <div className=\"chatgsd-input-line\">\n <span className=\"chatgsd-message-prompt\">&gt;</span>\n <div className=\"chatgsd-input-display\">\n <span className=\"chatgsd-input-text\">{input}</span>\n <span\n className={`chatgsd-cursor ${cursorVisible ? \"chatgsd-cursor-visible\" : \"chatgsd-cursor-hidden\"}`}\n >\n &#x2588;\n </span>\n <textarea\n ref={inputRef}\n value={input}\n onChange={(e) => setInput(e.target.value)}\n onKeyDown={handleKeyDown}\n rows={1}\n className=\"chatgsd-sr-only\"\n disabled={conversationEnded}\n aria-label=\"Chat input\"\n />\n </div>\n </div>\n <div className=\"chatgsd-input-hint\">\n press enter to send · shift+enter for new line\n </div>\n </>\n )}\n </div>\n </div>\n );\n}\n\n/** ChatGSD component - use ref to access imperative methods like submit() */\nexport const ChatGSD = forwardRef(ChatGSDInner);\n"],"mappings":"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","names":[]}
package/dist/index.d.cts CHANGED
@@ -1,4 +1,4 @@
1
- import * as react_jsx_runtime from 'react/jsx-runtime';
1
+ import * as react from 'react';
2
2
 
3
3
  type ChatMessage = {
4
4
  id: string;
@@ -15,6 +15,15 @@ interface ToolResult {
15
15
  success: boolean;
16
16
  message?: string;
17
17
  }
18
+ /** Context passed to tool render callbacks */
19
+ interface ToolCallContext {
20
+ /** Name of the tool being called */
21
+ name: string;
22
+ /** Arguments passed to the tool */
23
+ args: Record<string, unknown>;
24
+ /** Result of the tool execution (only in success/error states) */
25
+ result?: ToolResult;
26
+ }
18
27
  type ToolHandler = (args: Record<string, unknown>, messages: ChatMessage[]) => Promise<ToolResult>;
19
28
  interface Tool {
20
29
  /** Handler function called when the tool is invoked */
@@ -22,11 +31,11 @@ interface Tool {
22
31
  /** Whether this tool ends the conversation (default: false) */
23
32
  terminal?: boolean;
24
33
  /** Custom render for the "calling" state */
25
- renderCalling?: () => React.ReactNode;
34
+ renderCalling?: (ctx: ToolCallContext) => React.ReactNode;
26
35
  /** Custom render for the "success" state */
27
- renderSuccess?: (result: ToolResult) => React.ReactNode;
36
+ renderSuccess?: (ctx: ToolCallContext) => React.ReactNode;
28
37
  /** Custom render for the "error" state */
29
- renderError?: (result: ToolResult) => React.ReactNode;
38
+ renderError?: (ctx: ToolCallContext) => React.ReactNode;
30
39
  }
31
40
  interface ChatContext {
32
41
  [key: string]: unknown;
@@ -39,6 +48,17 @@ interface ChatApiRequest {
39
48
  context: ChatContext;
40
49
  }
41
50
 
51
+ /** Methods exposed via ref for programmatic control */
52
+ interface ChatGSDHandle {
53
+ /** Submit the current input programmatically */
54
+ submit: () => Promise<void>;
55
+ /** Submit a specific message (bypasses input field) */
56
+ submitMessage: (content: string) => Promise<void>;
57
+ /** Get current messages */
58
+ getMessages: () => ChatMessage[];
59
+ /** Focus the input field */
60
+ focus: () => void;
61
+ }
42
62
  interface ChatGSDProps {
43
63
  /** Initial system message to display */
44
64
  initialMessage?: string;
@@ -58,7 +78,10 @@ interface ChatGSDProps {
58
78
  className?: string;
59
79
  /** Called when conversation ends (terminal tool completes) */
60
80
  onComplete?: (messages: ChatMessage[]) => void;
81
+ /** Stream format: auto-detect, SSE, or plain text */
82
+ format?: "auto" | "sse" | "text";
61
83
  }
62
- declare function ChatGSD({ initialMessage, onMessagesChange, tools, endpoint, headers, context, brandName, className, onComplete, }: ChatGSDProps): react_jsx_runtime.JSX.Element;
84
+ /** ChatGSD component - use ref to access imperative methods like submit() */
85
+ declare const ChatGSD: react.ForwardRefExoticComponent<ChatGSDProps & react.RefAttributes<ChatGSDHandle>>;
63
86
 
64
- export { type ChatApiRequest, type ChatContext, ChatGSD, type ChatGSDProps, type ChatMessage, type Tool, type ToolCall, type ToolHandler, type ToolResult, type ToolStatus };
87
+ export { type ChatApiRequest, type ChatContext, ChatGSD, type ChatGSDHandle, type ChatGSDProps, type ChatMessage, type Tool, type ToolCall, type ToolCallContext, type ToolHandler, type ToolResult, type ToolStatus };
package/dist/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import * as react_jsx_runtime from 'react/jsx-runtime';
1
+ import * as react from 'react';
2
2
 
3
3
  type ChatMessage = {
4
4
  id: string;
@@ -15,6 +15,15 @@ interface ToolResult {
15
15
  success: boolean;
16
16
  message?: string;
17
17
  }
18
+ /** Context passed to tool render callbacks */
19
+ interface ToolCallContext {
20
+ /** Name of the tool being called */
21
+ name: string;
22
+ /** Arguments passed to the tool */
23
+ args: Record<string, unknown>;
24
+ /** Result of the tool execution (only in success/error states) */
25
+ result?: ToolResult;
26
+ }
18
27
  type ToolHandler = (args: Record<string, unknown>, messages: ChatMessage[]) => Promise<ToolResult>;
19
28
  interface Tool {
20
29
  /** Handler function called when the tool is invoked */
@@ -22,11 +31,11 @@ interface Tool {
22
31
  /** Whether this tool ends the conversation (default: false) */
23
32
  terminal?: boolean;
24
33
  /** Custom render for the "calling" state */
25
- renderCalling?: () => React.ReactNode;
34
+ renderCalling?: (ctx: ToolCallContext) => React.ReactNode;
26
35
  /** Custom render for the "success" state */
27
- renderSuccess?: (result: ToolResult) => React.ReactNode;
36
+ renderSuccess?: (ctx: ToolCallContext) => React.ReactNode;
28
37
  /** Custom render for the "error" state */
29
- renderError?: (result: ToolResult) => React.ReactNode;
38
+ renderError?: (ctx: ToolCallContext) => React.ReactNode;
30
39
  }
31
40
  interface ChatContext {
32
41
  [key: string]: unknown;
@@ -39,6 +48,17 @@ interface ChatApiRequest {
39
48
  context: ChatContext;
40
49
  }
41
50
 
51
+ /** Methods exposed via ref for programmatic control */
52
+ interface ChatGSDHandle {
53
+ /** Submit the current input programmatically */
54
+ submit: () => Promise<void>;
55
+ /** Submit a specific message (bypasses input field) */
56
+ submitMessage: (content: string) => Promise<void>;
57
+ /** Get current messages */
58
+ getMessages: () => ChatMessage[];
59
+ /** Focus the input field */
60
+ focus: () => void;
61
+ }
42
62
  interface ChatGSDProps {
43
63
  /** Initial system message to display */
44
64
  initialMessage?: string;
@@ -58,7 +78,10 @@ interface ChatGSDProps {
58
78
  className?: string;
59
79
  /** Called when conversation ends (terminal tool completes) */
60
80
  onComplete?: (messages: ChatMessage[]) => void;
81
+ /** Stream format: auto-detect, SSE, or plain text */
82
+ format?: "auto" | "sse" | "text";
61
83
  }
62
- declare function ChatGSD({ initialMessage, onMessagesChange, tools, endpoint, headers, context, brandName, className, onComplete, }: ChatGSDProps): react_jsx_runtime.JSX.Element;
84
+ /** ChatGSD component - use ref to access imperative methods like submit() */
85
+ declare const ChatGSD: react.ForwardRefExoticComponent<ChatGSDProps & react.RefAttributes<ChatGSDHandle>>;
63
86
 
64
- export { type ChatApiRequest, type ChatContext, ChatGSD, type ChatGSDProps, type ChatMessage, type Tool, type ToolCall, type ToolHandler, type ToolResult, type ToolStatus };
87
+ export { type ChatApiRequest, type ChatContext, ChatGSD, type ChatGSDHandle, type ChatGSDProps, type ChatMessage, type Tool, type ToolCall, type ToolCallContext, type ToolHandler, type ToolResult, type ToolStatus };
package/dist/index.js CHANGED
@@ -1,11 +1,76 @@
1
1
  // src/ChatGSD.tsx
2
- import { useState, useRef, useEffect, useCallback } from "react";
2
+ import { useState, useRef, useEffect, useCallback, useImperativeHandle, forwardRef } from "react";
3
3
  import { Fragment, jsx, jsxs } from "react/jsx-runtime";
4
4
  function generateId() {
5
5
  return Math.random().toString(36).substring(2, 11);
6
6
  }
7
- function parseToolCall(content) {
8
- const match = content.match(/\[TOOL:(\w+)(?:\((\{.*\})\))?\]$/);
7
+ function parseSSELine(line) {
8
+ if (!line.startsWith("data: ")) return null;
9
+ const data = line.slice(6);
10
+ if (data === "[DONE]") return { type: "done" };
11
+ try {
12
+ const parsed = JSON.parse(data);
13
+ if (parsed.type === "text-delta" || parsed.type === "text_delta") {
14
+ return { type: "text", content: parsed.textDelta ?? parsed.text_delta ?? "" };
15
+ }
16
+ if (parsed.type === "tool-call" || parsed.type === "tool_call") {
17
+ return {
18
+ type: "tool_call",
19
+ name: parsed.toolName ?? parsed.tool_name ?? parsed.name,
20
+ args: parsed.args ?? parsed.arguments ?? {}
21
+ };
22
+ }
23
+ if (parsed.type === "text") {
24
+ return { type: "text", content: parsed.content ?? "" };
25
+ }
26
+ if (parsed.type === "tool_call") {
27
+ return { type: "tool_call", name: parsed.name, args: parsed.args ?? {} };
28
+ }
29
+ if (parsed.type === "error") {
30
+ return { type: "error", message: parsed.message ?? "Unknown error" };
31
+ }
32
+ if (parsed.type === "done") {
33
+ return { type: "done" };
34
+ }
35
+ if (parsed.choices?.[0]?.delta?.content) {
36
+ return { type: "text", content: parsed.choices[0].delta.content };
37
+ }
38
+ return null;
39
+ } catch {
40
+ return null;
41
+ }
42
+ }
43
+ function parseAISDKLine(line) {
44
+ const match = line.match(/^(\d+):(.+)$/);
45
+ if (!match) return null;
46
+ const [, typeCode, data] = match;
47
+ try {
48
+ switch (typeCode) {
49
+ case "0": {
50
+ const text = JSON.parse(data);
51
+ return { type: "text", content: text };
52
+ }
53
+ case "8": {
54
+ const parsed = JSON.parse(data);
55
+ return {
56
+ type: "tool_call",
57
+ name: parsed.toolName ?? parsed.name,
58
+ args: parsed.args ?? {}
59
+ };
60
+ }
61
+ case "d":
62
+ case "e": {
63
+ return { type: "done" };
64
+ }
65
+ default:
66
+ return null;
67
+ }
68
+ } catch {
69
+ return null;
70
+ }
71
+ }
72
+ function parseToolCallFromText(content) {
73
+ const match = content.match(/\[TOOL:(\w+)(?:\((\{.*\})\))?\]\s*$/);
9
74
  if (!match) return null;
10
75
  const name = match[1];
11
76
  let args = {};
@@ -17,7 +82,7 @@ function parseToolCall(content) {
17
82
  }
18
83
  return { name, args };
19
84
  }
20
- function ChatGSD({
85
+ function ChatGSDInner({
21
86
  initialMessage = "How can I help you today?",
22
87
  onMessagesChange,
23
88
  tools = {},
@@ -26,8 +91,9 @@ function ChatGSD({
26
91
  context = {},
27
92
  brandName = "assistant",
28
93
  className = "",
29
- onComplete
30
- }) {
94
+ onComplete,
95
+ format = "auto"
96
+ }, ref) {
31
97
  const [messages, setMessages] = useState([
32
98
  {
33
99
  id: generateId(),
@@ -71,34 +137,105 @@ function ChatGSD({
71
137
  console.warn(`Unknown tool: ${toolName}`);
72
138
  return;
73
139
  }
74
- setActiveTool({ name: toolName, status: "calling" });
140
+ setActiveTool({ name: toolName, args, status: "calling" });
75
141
  await new Promise((resolve) => {
76
142
  toolTimeoutRef.current = setTimeout(resolve, 800);
77
143
  });
78
144
  try {
79
145
  const result = await tool.handler(args, currentMessages);
80
- setActiveTool({ name: toolName, status: result.success ? "success" : "error", result });
146
+ setActiveTool({ name: toolName, args, status: result.success ? "success" : "error", result });
81
147
  if (tool.terminal) {
82
148
  setConversationEnded(true);
83
149
  onComplete?.(currentMessages);
84
150
  }
85
151
  } catch (err) {
86
152
  const message = err instanceof Error ? err.message : "Tool execution failed";
87
- setActiveTool({ name: toolName, status: "error", result: { success: false, message } });
153
+ setActiveTool({ name: toolName, args, status: "error", result: { success: false, message } });
88
154
  }
89
155
  },
90
156
  [tools, onComplete]
91
157
  );
158
+ const parseLine = useCallback((line) => {
159
+ return parseSSELine(line) ?? parseAISDKLine(line);
160
+ }, []);
161
+ const processSSEStream = useCallback(
162
+ async (reader, onText) => {
163
+ const decoder = new TextDecoder();
164
+ let buffer = "";
165
+ let toolCall = null;
166
+ while (true) {
167
+ const { done, value } = await reader.read();
168
+ if (done) break;
169
+ buffer += decoder.decode(value, { stream: true });
170
+ const lines = buffer.split("\n");
171
+ buffer = lines.pop() || "";
172
+ for (const line of lines) {
173
+ const trimmed = line.trim();
174
+ if (!trimmed) continue;
175
+ const event = parseLine(trimmed);
176
+ if (!event) continue;
177
+ if (event.type === "text") {
178
+ onText(event.content);
179
+ } else if (event.type === "tool_call") {
180
+ toolCall = event;
181
+ } else if (event.type === "done") {
182
+ return toolCall;
183
+ }
184
+ }
185
+ }
186
+ if (buffer.trim()) {
187
+ const event = parseLine(buffer.trim());
188
+ if (event?.type === "tool_call") {
189
+ toolCall = event;
190
+ }
191
+ }
192
+ return toolCall;
193
+ },
194
+ [parseLine]
195
+ );
196
+ const processTextStream = useCallback(
197
+ async (reader, onText) => {
198
+ const decoder = new TextDecoder();
199
+ let fullContent = "";
200
+ while (true) {
201
+ const { done, value } = await reader.read();
202
+ if (done) break;
203
+ const chunk = decoder.decode(value, { stream: true });
204
+ fullContent += chunk;
205
+ const displayContent = fullContent.replace(/\n?\[TOOL:\w+(?:\(\{.*\}\))?\]\s*$/, "");
206
+ onText(displayContent);
207
+ }
208
+ const toolCall = parseToolCallFromText(fullContent);
209
+ if (toolCall) {
210
+ return { type: "tool_call", name: toolCall.name, args: toolCall.args };
211
+ }
212
+ return null;
213
+ },
214
+ []
215
+ );
92
216
  const fetchAIResponse = useCallback(
93
217
  async (updatedMessages) => {
94
218
  setIsLoading(true);
219
+ const aiMessageId = generateId();
95
220
  const aiMessage = {
96
- id: generateId(),
221
+ id: aiMessageId,
97
222
  role: "system",
98
223
  content: "",
99
224
  timestamp: /* @__PURE__ */ new Date()
100
225
  };
101
226
  setMessages((prev) => [...prev, aiMessage]);
227
+ let currentContent = "";
228
+ const updateContent = (content) => {
229
+ currentContent = content;
230
+ setMessages((prev) => {
231
+ const updated = [...prev];
232
+ const msgIndex = updated.findIndex((m) => m.id === aiMessageId);
233
+ if (msgIndex !== -1) {
234
+ updated[msgIndex] = { ...updated[msgIndex], content };
235
+ }
236
+ return updated;
237
+ });
238
+ };
102
239
  try {
103
240
  const res = await fetch(endpoint, {
104
241
  method: "POST",
@@ -114,42 +251,43 @@ function ChatGSD({
114
251
  context
115
252
  })
116
253
  });
117
- if (res.ok && res.body) {
118
- const reader = res.body.getReader();
119
- const decoder = new TextDecoder();
120
- let fullContent = "";
121
- while (true) {
122
- const { done, value } = await reader.read();
123
- if (done) break;
124
- const chunk = decoder.decode(value, { stream: true });
125
- fullContent += chunk;
126
- const displayContent = fullContent.replace(/\n?\[TOOL:\w+(?:\(\{.*\}\))?\]$/, "");
127
- setMessages((prev) => {
128
- const updated = [...prev];
129
- const last = updated[updated.length - 1];
130
- if (last.role === "system") {
131
- last.content = displayContent;
132
- }
133
- return updated;
134
- });
135
- }
136
- const toolCall = parseToolCall(fullContent);
137
- if (toolCall) {
138
- const finalMessages = [...updatedMessages, {
139
- id: generateId(),
254
+ if (!res.ok || !res.body) {
255
+ throw new Error("Failed to fetch response");
256
+ }
257
+ const contentType = res.headers.get("Content-Type") || "";
258
+ const reader = res.body.getReader();
259
+ let useSSE = format === "sse";
260
+ if (format === "auto") {
261
+ useSSE = contentType.includes("text/event-stream");
262
+ }
263
+ let toolCallEvent = null;
264
+ if (useSSE) {
265
+ toolCallEvent = await processSSEStream(reader, (text) => {
266
+ currentContent += text;
267
+ updateContent(currentContent);
268
+ });
269
+ } else {
270
+ toolCallEvent = await processTextStream(reader, updateContent);
271
+ }
272
+ if (toolCallEvent?.type === "tool_call") {
273
+ const finalMessages = [
274
+ ...updatedMessages,
275
+ {
276
+ id: aiMessageId,
140
277
  role: "system",
141
- content: fullContent.replace(/\n?\[TOOL:\w+(?:\(\{.*\}\))?\]$/, ""),
278
+ content: currentContent,
142
279
  timestamp: /* @__PURE__ */ new Date()
143
- }];
144
- await executeTool(toolCall.name, toolCall.args, finalMessages);
145
- }
280
+ }
281
+ ];
282
+ await executeTool(toolCallEvent.name, toolCallEvent.args, finalMessages);
146
283
  }
147
- } catch {
284
+ } catch (err) {
285
+ console.error("Chat error:", err);
148
286
  } finally {
149
287
  setIsLoading(false);
150
288
  }
151
289
  },
152
- [endpoint, headers, context, executeTool]
290
+ [endpoint, headers, context, format, processSSEStream, processTextStream, executeTool]
153
291
  );
154
292
  const handleSend = useCallback(async () => {
155
293
  if (!input.trim() || isLoading || conversationEnded) return;
@@ -184,13 +322,36 @@ function ChatGSD({
184
322
  a.click();
185
323
  URL.revokeObjectURL(url);
186
324
  }, [messages, brandName]);
325
+ const submitMessage = useCallback(
326
+ async (content) => {
327
+ if (!content.trim() || isLoading || conversationEnded) return;
328
+ const newMessage = {
329
+ id: generateId(),
330
+ role: "user",
331
+ content: content.trim(),
332
+ timestamp: /* @__PURE__ */ new Date()
333
+ };
334
+ const updated = [...messages, newMessage];
335
+ setMessages(updated);
336
+ onMessagesChange?.(updated);
337
+ await fetchAIResponse(updated);
338
+ },
339
+ [isLoading, conversationEnded, messages, onMessagesChange, fetchAIResponse]
340
+ );
341
+ useImperativeHandle(ref, () => ({
342
+ submit: handleSend,
343
+ submitMessage,
344
+ getMessages: () => messages,
345
+ focus: () => inputRef.current?.focus()
346
+ }), [handleSend, submitMessage, messages]);
187
347
  const renderToolStatus = () => {
188
348
  if (!activeTool) return null;
189
349
  const tool = tools[activeTool.name];
190
- const { name, status, result } = activeTool;
350
+ const { name, args, status, result } = activeTool;
351
+ const ctx = { name, args, result };
191
352
  if (status === "calling") {
192
353
  if (tool?.renderCalling) {
193
- return tool.renderCalling();
354
+ return tool.renderCalling(ctx);
194
355
  }
195
356
  return /* @__PURE__ */ jsxs("div", { className: "chatgsd-status-calling", children: [
196
357
  /* @__PURE__ */ jsx("span", { className: "chatgsd-message-prefix", children: "[tool]" }),
@@ -204,8 +365,8 @@ function ChatGSD({
204
365
  ] });
205
366
  }
206
367
  if (status === "success") {
207
- if (tool?.renderSuccess && result) {
208
- return tool.renderSuccess(result);
368
+ if (tool?.renderSuccess) {
369
+ return tool.renderSuccess(ctx);
209
370
  }
210
371
  return /* @__PURE__ */ jsxs("div", { className: "chatgsd-status-success", children: [
211
372
  /* @__PURE__ */ jsx("span", { className: "chatgsd-message-prefix", children: "[tool]" }),
@@ -218,8 +379,8 @@ function ChatGSD({
218
379
  ] });
219
380
  }
220
381
  if (status === "error") {
221
- if (tool?.renderError && result) {
222
- return tool.renderError(result);
382
+ if (tool?.renderError) {
383
+ return tool.renderError(ctx);
223
384
  }
224
385
  return /* @__PURE__ */ jsxs("div", { className: "chatgsd-status-error", children: [
225
386
  /* @__PURE__ */ jsx("span", { className: "chatgsd-message-prefix", children: "[tool]" }),
@@ -296,6 +457,7 @@ function ChatGSD({
296
457
  ] }) })
297
458
  ] });
298
459
  }
460
+ var ChatGSD = forwardRef(ChatGSDInner);
299
461
  export {
300
462
  ChatGSD
301
463
  };