@devicai/ui 0.12.1 → 0.14.0

package/dist/esm/hooks/useDevicChat.js

@@ -2,9 +2,9 @@ import { useMemo, useRef, useState, useEffect, useCallback } from 'react';
 import 'react/jsx-runtime';
 import { useOptionalDevicContext } from '../provider/DevicContext.js';
 import { DevicApiClient } from '../api/client.js';
+import { createLogger } from '../utils/logger.js';
 import { usePolling } from './usePolling.js';
 import { useModelInterface } from './useModelInterface.js';
-import { createLogger } from '../utils/logger.js';
 
 /**
  * Main hook for managing chat with a Devic assistant
@@ -151,6 +151,12 @@ function useDevicChat(options) {
         tools: modelInterfaceTools,
         onToolExecute: onToolCall,
     });
+    // Pending widget calls awaiting user interaction
+    const [pendingWidgetCalls, setPendingWidgetCalls] = useState([]);
+    const pendingWidgetCallsRef = useRef([]);
+    useEffect(() => {
+        pendingWidgetCallsRef.current = pendingWidgetCalls;
+    }, [pendingWidgetCalls]);
     // Polling hook - uses callbacks for side effects, return value not needed
     logRef.current.log('[useDevicChat] Render - shouldPoll:', shouldPoll, 'chatUid:', chatUid);
     usePolling(shouldPoll ? chatUid : null, async () => {
@@ -243,14 +249,28 @@ function useDevicChat(options) {
         if (pendingCalls.length === 0)
             return;
         try {
-            // Execute client-side tools
-            const responses = await handleToolCalls(pendingCalls);
+            // Execute client-side tools (partitioned into immediate responses and widget-driven)
+            const { responses, widgetCalls } = await handleToolCalls(pendingCalls);
+            // Queue widget-driven tool calls for user interaction
+            if (widgetCalls.length > 0) {
+                const existingIds = new Set(pendingWidgetCallsRef.current.map((c) => c.toolCall.id));
+                const deduped = widgetCalls.filter((c) => !existingIds.has(c.toolCall.id));
+                const next = [...pendingWidgetCallsRef.current, ...deduped];
+                pendingWidgetCallsRef.current = next;
+                setPendingWidgetCalls(next);
+                // Stop polling while we wait for the user to submit the widget response.
+                // The widget submission will re-trigger polling via submitWidgetResponse.
+                setShouldPoll(false);
+                setIsLoading(false);
+            }
             if (responses.length > 0) {
                 // Send tool responses back to the API
                 await clientRef.current.sendToolResponses(assistantId, chatUid, responses);
-                // Resume polling
-                setShouldPoll(true);
-                setIsLoading(true);
+                // Only resume polling if no widgets are blocking
+                if (widgetCalls.length === 0) {
+                    setShouldPoll(true);
+                    setIsLoading(true);
+                }
             }
         }
         catch (err) {
@@ -381,6 +401,8 @@ function useDevicChat(options) {
         setIsLoading(false);
         setStatus('idle');
         setError(null);
+        pendingWidgetCallsRef.current = [];
+        setPendingWidgetCalls([]);
     }, []);
     // Load existing chat
     const loadChat = useCallback(async (loadChatUid) => {
@@ -394,6 +416,8 @@ function useDevicChat(options) {
         setShouldPoll(false);
         setHandedOff(false);
         setHandedOffSubThreadId(null);
+        pendingWidgetCallsRef.current = [];
+        setPendingWidgetCalls([]);
         if (handoffPollRef.current) {
             clearInterval(handoffPollRef.current);
             handoffPollRef.current = null;
@@ -458,6 +482,44 @@ function useDevicChat(options) {
         setHandedOffSubThreadId(null);
         setShouldPoll(true);
     }, []);
+    // Submit a response for a pending widget tool call
+    const submitWidgetResponse = useCallback(async (toolCallId, response) => {
+        const uid = chatUidRef.current;
+        if (!clientRef.current || !uid)
+            return;
+        // Check pending widgets via ref (state updates are async)
+        const current = pendingWidgetCallsRef.current;
+        const found = current.some((c) => c.toolCall.id === toolCallId);
+        if (!found)
+            return;
+        // Remove the widget call from pending list
+        const remaining = current.filter((c) => c.toolCall.id !== toolCallId);
+        pendingWidgetCallsRef.current = remaining;
+        setPendingWidgetCalls(remaining);
+        try {
+            logRef.current.log('[useDevicChat] sending widget tool response', toolCallId);
+            await clientRef.current.sendToolResponses(assistantId, uid, [
+                { tool_call_id: toolCallId, content: response, role: 'tool' },
+            ]);
+            // Resume polling only if no more widget calls are blocking
+            if (remaining.length === 0) {
+                setShouldPoll(true);
+                setIsLoading(true);
+            }
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            logRef.current.error('[useDevicChat] submitWidgetResponse failed', error);
+            setError(error);
+            onErrorRef.current?.(error);
+        }
+    }, [assistantId]);
+    // Cancel a pending widget tool call (sends an error response to the model)
+    const cancelWidgetCall = useCallback(async (toolCallId, reason) => {
+        await submitWidgetResponse(toolCallId, {
+            error: reason || 'User cancelled the tool call',
+        });
+    }, [submitWidgetResponse]);
     // Stop current conversation — calls the server-side stop endpoint
     // then stops polling and resets loading state.
     const stopChat = useCallback(async () => {
@@ -489,6 +551,9 @@ function useDevicChat(options) {
         loadChat,
         onHandoffCompleted,
         stopChat,
+        pendingWidgetCalls,
+        submitWidgetResponse,
+        cancelWidgetCall,
     };
 }
 

package/dist/esm/hooks/useDevicChat.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDevicChat.js","sources":["../../../src/hooks/useDevicChat.ts"],"sourcesContent":["import { useState, useCallback, useEffect, useRef, useMemo } from 'react';\nimport { useOptionalDevicContext } from '../provider';\nimport { DevicApiClient } from '../api/client';\nimport { usePolling } from './usePolling';\nimport { useModelInterface } from './useModelInterface';\nimport { createLogger } from '../utils/logger';\nimport type {\n  ChatMessage,\n  ChatFile,\n  ModelInterfaceTool,\n  RealtimeChatHistory,\n  RealtimeStatus,\n} from '../api/types';\n\nexport interface UseDevicChatOptions {\n  /**\n   * Assistant identifier\n   */\n  assistantId: string;\n\n  /**\n   * Existing chat UID to continue a conversation\n   */\n  chatUid?: string;\n\n  /**\n   * API key (overrides provider context)\n   */\n  apiKey?: string;\n\n  /**\n   * Base URL (overrides provider context)\n   */\n  baseUrl?: string;\n\n  /**\n   * Tenant ID for multi-tenant environments\n   */\n  tenantId?: string;\n\n  /**\n   * Tenant metadata\n   */\n  tenantMetadata?: Record<string, any>;\n\n  /**\n   * Tools enabled from the assistant's configured tool groups\n   */\n  enabledTools?: string[];\n\n  /**\n   * Client-side tools for model interface protocol\n   */\n  modelInterfaceTools?: ModelInterfaceTool[];\n\n  /**\n   * Polling interval for async mode (ms)\n   * @default 1000\n   */\n  pollingInterval?: number;\n\n  /**\n   * Callback when a message is sent\n   */\n  onMessageSent?: (message: ChatMessage) => void;\n\n  /**\n   * Callback when a message is received\n   */\n  onMessageReceived?: (message: ChatMessage) => void;\n\n  /**\n   * Callback when a tool is called\n   */\n  onToolCall?: (toolName: string, params: any) => void;\n\n  /**\n   * Callback when an error occurs\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * Callback when a new chat is created\n   */\n  onChatCreated?: (chatUid: string) => void;\n\n  /**\n   * Custom file upload handler. When provided, replaces the default\n   * upload to Devic API. Receives the raw File objects and must return\n   * an array of ChatFile with downloadUrl set.\n   */\n  onFileUpload?: (files: File[]) => Promise<ChatFile[]>;\n\n  /**\n   * Enable debug logging to the browser console.\n   * Overrides the provider-level debug setting when provided.\n   * @default false\n   */\n  debug?: boolean;\n}\n\nexport interface UseDevicChatResult {\n  /**\n   * Current chat messages\n   */\n  messages: ChatMessage[];\n\n  /**\n   * Current chat UID\n   */\n  chatUid: string | null;\n\n  /**\n   * Whether a message is being processed\n   */\n  isLoading: boolean;\n\n  /**\n   * Current status\n   */\n  status: RealtimeStatus | 'idle';\n\n  /**\n   * Last error\n   */\n  error: Error | null;\n\n  /**\n   * Whether the assistant has handed off to a subagent\n   */\n  handedOff: boolean;\n\n  /**\n   * The subthread ID when a handoff is active\n   */\n  handedOffSubThreadId: string | null;\n\n  /**\n   * Send a message\n   */\n  sendMessage: (\n    message: string,\n    options?: {\n      files?: File[];\n      metadata?: Record<string, any>;\n    }\n  ) => Promise<void>;\n\n  /**\n   * Clear the chat and start a new conversation\n   */\n  clearChat: () => void;\n\n  /**\n   * Load an existing chat\n   */\n  loadChat: (chatUid: string) => Promise<void>;\n\n  /**\n   * Called when the handoff subagent completes.\n   * Triggers reload of full chat content.\n   */\n  onHandoffCompleted: () => void;\n\n  /**\n   * Stop the current conversation processing (client-side only).\n   * Stops polling and resets loading state.\n   */\n  stopChat: () => void;\n}\n\n/**\n * Main hook for managing chat with a Devic assistant\n *\n * @example\n * ```tsx\n * const {\n *   messages,\n *   isLoading,\n *   sendMessage,\n * } = useDevicChat({\n *   assistantId: 'my-assistant',\n *   modelInterfaceTools: [\n *     {\n *       toolName: 'get_user_location',\n *       schema: { ... },\n *       callback: async () => ({ lat: 40.7, lng: -74.0 })\n *     }\n *   ],\n *   onMessageReceived: (msg) => console.log('Received:', msg),\n * });\n * ```\n */\nexport function useDevicChat(options: UseDevicChatOptions): UseDevicChatResult {\n  const {\n    assistantId,\n    chatUid: initialChatUid,\n    apiKey: propsApiKey,\n    baseUrl: propsBaseUrl,\n    tenantId,\n    tenantMetadata,\n    enabledTools,\n    modelInterfaceTools = [],\n    pollingInterval = 1000,\n    onMessageSent,\n    onMessageReceived,\n    onToolCall,\n    onError,\n    onChatCreated,\n    onFileUpload,\n    debug: propsDebug,\n  } = options;\n\n  // Get context (may be null if not wrapped in provider)\n  const context = useOptionalDevicContext();\n\n  // Resolve configuration\n  const apiKey = propsApiKey || context?.apiKey;\n  const baseUrl = propsBaseUrl || context?.baseUrl || 'https://api.devic.ai';\n  const resolvedTenantId = tenantId || context?.tenantId;\n  const resolvedTenantMetadata = { ...context?.tenantMetadata, ...tenantMetadata };\n  const debug = propsDebug ?? context?.debug ?? false;\n  const log = useMemo(() => createLogger(debug), [debug]);\n  const logRef = useRef(log);\n  logRef.current = log;\n\n  // State\n  const [messages, setMessages] = useState<ChatMessage[]>([]);\n  const [chatUid, setChatUid] = useState<string | null>(initialChatUid || null);\n  const [isLoading, setIsLoading] = useState(false);\n  const [status, setStatus] = useState<RealtimeStatus | 'idle'>('idle');\n  const [error, setError] = useState<Error | null>(null);\n\n  // Handoff state\n  const [handedOff, setHandedOff] = useState(false);\n  const [handedOffSubThreadId, setHandedOffSubThreadId] = useState<string | null>(null);\n  const handoffPollRef = useRef<ReturnType<typeof setInterval> | null>(null);\n\n  // Polling state\n  const [shouldPoll, setShouldPoll] = useState(false);\n\n  // Keep a ref to chatUid so async callbacks always read the latest value\n  const chatUidRef = useRef(chatUid);\n  chatUidRef.current = chatUid;\n\n  // Refs for callbacks\n  const onMessageReceivedRef = useRef(onMessageReceived);\n  const onErrorRef = useRef(onError);\n  const onChatCreatedRef = useRef(onChatCreated);\n\n  useEffect(() => {\n    onMessageReceivedRef.current = onMessageReceived;\n    onErrorRef.current = onError;\n    onChatCreatedRef.current = onChatCreated;\n  });\n\n  // Create API client\n  const clientRef = useRef<DevicApiClient | null>(null);\n  if (!clientRef.current && apiKey) {\n    clientRef.current = new DevicApiClient({ apiKey, baseUrl });\n  }\n\n  // Update client config if it changes\n  useEffect(() => {\n    if (clientRef.current && apiKey) {\n      clientRef.current.setConfig({ apiKey, baseUrl });\n    }\n  }, [apiKey, baseUrl]);\n\n  // Resume chat state based on realtime status.\n  // Called after loading chat history to detect in-progress conversations.\n  const resumeFromRealtimeStatus = useCallback(\n    async (targetChatUid: string) => {\n      if (!clientRef.current) return;\n      try {\n        const realtime = await clientRef.current.getRealtimeHistory(assistantId, targetChatUid);\n        logRef.current.log('[useDevicChat] resumeFromRealtimeStatus:', realtime.status);\n\n        // Update messages with realtime data (may be fresher than static history)\n        if (realtime.chatHistory?.length) {\n          setMessages(realtime.chatHistory);\n        }\n        setStatus(realtime.status);\n\n        if (realtime.status === 'processing') {\n          // Chat is still processing — resume polling\n          setIsLoading(true);\n          setShouldPoll(true);\n        } else if (realtime.status === 'waiting_for_tool_response') {\n          // Chat is waiting for tool response — resume polling to trigger tool handling\n          setIsLoading(true);\n          setShouldPoll(true);\n        } else if (realtime.status === 'handed_off') {\n          // Chat has an active handoff\n          setIsLoading(true);\n          setHandedOff(true);\n          const subThreadId = realtime.handedOffSubThreadId || null;\n          logRef.current.log('[useDevicChat] Resuming handoff state:', { subThreadId });\n          if (subThreadId) {\n            setHandedOffSubThreadId(subThreadId);\n          }\n        } else {\n          // completed or error — just stop\n          setIsLoading(false);\n        }\n      } catch (err) {\n        // If realtime fetch fails (e.g. chat has no realtime entry), just stay idle\n        logRef.current.warn('[useDevicChat] resumeFromRealtimeStatus failed:', err);\n        setIsLoading(false);\n      }\n    },\n    [assistantId]\n  );\n\n  // Load initial chat history if chatUid prop is provided\n  // This runs once on mount (or when initialChatUid changes) to fetch existing conversation\n  const initialChatLoadedRef = useRef(false);\n  useEffect(() => {\n    if (initialChatUid && clientRef.current && !initialChatLoadedRef.current) {\n      initialChatLoadedRef.current = true;\n\n      const loadInitialChat = async () => {\n        setIsLoading(true);\n        setError(null);\n        try {\n          const history = await clientRef.current!.getChatHistory(\n            assistantId,\n            initialChatUid,\n            { tenantId: resolvedTenantId }\n          );\n          setMessages(history.chatContent);\n          setChatUid(initialChatUid);\n\n          // Check realtime status to resume in-progress conversations\n          await resumeFromRealtimeStatus(initialChatUid);\n        } catch (err) {\n          const error = err instanceof Error ? err : new Error(String(err));\n          setError(error);\n          onErrorRef.current?.(error);\n          setIsLoading(false);\n        }\n      };\n\n      loadInitialChat();\n    }\n  }, [initialChatUid, assistantId, resolvedTenantId, resumeFromRealtimeStatus]);\n\n  // Model interface hook\n  const {\n    toolSchemas,\n    handleToolCalls,\n    extractPendingToolCalls,\n  } = useModelInterface({\n    tools: modelInterfaceTools,\n    onToolExecute: onToolCall,\n  });\n\n  // Polling hook - uses callbacks for side effects, return value not needed\n  logRef.current.log('[useDevicChat] Render - shouldPoll:', shouldPoll, 'chatUid:', chatUid);\n  usePolling(\n    shouldPoll ? chatUid : null,\n    async () => {\n      logRef.current.log('[useDevicChat] fetchFn called, chatUid:', chatUid);\n      if (!clientRef.current || !chatUid) {\n        throw new Error('Cannot poll without client or chatUid');\n      }\n      const result = await clientRef.current.getRealtimeHistory(assistantId, chatUid);\n      logRef.current.log('[useDevicChat] getRealtimeHistory result:', result);\n      return result;\n    },\n    {\n      interval: pollingInterval,\n      enabled: shouldPoll,\n      stopStatuses: ['completed', 'error', 'waiting_for_tool_response', 'handed_off'],\n      onUpdate: async (data: RealtimeChatHistory) => {\n        logRef.current.log('[useDevicChat] onUpdate called, status:', data.status);\n\n        // Merge realtime data with optimistic messages.\n        // When a server user message matches an optimistic one by text, adopt the\n        // optimistic uid so React's key stays stable (avoids unmount/remount flicker).\n        setMessages((prev) => {\n          const normalize = (t?: string) => (t ?? '').trim();\n          const optimisticUserByText = new Map(\n            prev\n              .filter((m) => m.role === 'user' && m.uid.startsWith('temp-'))\n              .map((m) => [normalize(m.content?.message), m.uid])\n          );\n\n          const adoptedTempUids = new Set<string>();\n          const merged = data.chatHistory.map((m) => {\n            if (m.role === 'user') {\n              const tempUid = optimisticUserByText.get(normalize(m.content?.message));\n              if (tempUid) {\n                adoptedTempUids.add(tempUid);\n                return { ...m, uid: tempUid };\n              }\n            }\n            return m;\n          });\n\n          const mergedUIDs = new Set(merged.map((m) => m.uid));\n          const optimistic = prev.filter(\n            (m) => !mergedUIDs.has(m.uid) && !adoptedTempUids.has(m.uid)\n          );\n\n          return [...merged, ...optimistic];\n        });\n        setStatus(data.status);\n\n        // Notify about new messages\n        const lastMessage = data.chatHistory[data.chatHistory.length - 1];\n        if (lastMessage && lastMessage.role === 'assistant') {\n          onMessageReceivedRef.current?.(lastMessage);\n        }\n\n        // Handle model interface - check for pending tool calls\n        if (data.status === 'waiting_for_tool_response' || data.pendingToolCalls?.length) {\n          await handlePendingToolCalls(data);\n        }\n      },\n      onStop: (data) => {\n        logRef.current.log('[useDevicChat] onStop called, status:', data?.status);\n        setShouldPoll(false);\n\n        if (data?.status === 'error') {\n          setIsLoading(false);\n          const err = new Error('Chat processing failed');\n          setError(err);\n          onErrorRef.current?.(err);\n        } else if (data?.status === 'completed') {\n          setIsLoading(false);\n        } else if (data?.status === 'handed_off') {\n          // Subagent is working — keep isLoading true so the UI stays in loading state.\n          // Set handoff state directly from the realtime status.\n          setHandedOff(true);\n\n          const subThreadId = data.handedOffSubThreadId || null;\n          logRef.current.log('[useDevicChat] Handoff state set:', { handedOff: true, subThreadId });\n          if (subThreadId) {\n            setHandedOffSubThreadId(subThreadId);\n          }\n        }\n        // Note: waiting_for_tool_response is handled in onUpdate to avoid double execution\n      },\n      onError: (err) => {\n        logRef.current.error('[useDevicChat] onError called:', err);\n        setError(err);\n        setIsLoading(false);\n        setShouldPoll(false);\n        onErrorRef.current?.(err);\n      },\n      debug,\n    }\n  );\n\n  // Handle pending tool calls from model interface\n  const handlePendingToolCalls = useCallback(\n    async (data: RealtimeChatHistory) => {\n      if (!clientRef.current || !chatUid) return;\n\n      // Get pending tool calls\n      const pendingCalls = data.pendingToolCalls || extractPendingToolCalls(data.chatHistory);\n\n      if (pendingCalls.length === 0) return;\n\n      try {\n        // Execute client-side tools\n        const responses = await handleToolCalls(pendingCalls);\n\n        if (responses.length > 0) {\n          // Send tool responses back to the API\n          await clientRef.current.sendToolResponses(assistantId, chatUid, responses);\n\n          // Resume polling\n          setShouldPoll(true);\n          setIsLoading(true);\n        }\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        setError(error);\n        onErrorRef.current?.(error);\n      }\n    },\n    [chatUid, assistantId, handleToolCalls, extractPendingToolCalls]\n  );\n\n  // Send a message\n  const sendMessage = useCallback(\n    async (\n      message: string,\n      sendOptions?: {\n        files?: File[];\n        metadata?: Record<string, any>;\n      }\n    ) => {\n      if (!clientRef.current) {\n        const err = new Error(\n          'API client not configured. Please provide an API key.'\n        );\n        setError(err);\n        onErrorRef.current?.(err);\n        return;\n      }\n\n      setIsLoading(true);\n      setError(null);\n      setStatus('processing');\n\n      // Add user message optimistically (show file names before upload)\n      const userMessage: ChatMessage = {\n        uid: `temp-${Date.now()}`,\n        role: 'user',\n        content: {\n          message,\n          files: sendOptions?.files?.map((f) => ({\n            name: f.name,\n            url: '',\n            type: f.type.split('/')[0] || 'other',\n          })),\n        },\n        timestamp: Date.now(),\n      };\n\n      setMessages((prev) => [...prev, userMessage]);\n      onMessageSent?.(userMessage);\n\n      try {\n        // Upload files if provided\n        let uploadedFiles: ChatFile[] | undefined;\n        if (sendOptions?.files && sendOptions.files.length > 0) {\n          logRef.current.log('[useDevicChat] Uploading files...');\n          if (onFileUpload) {\n            // Use custom upload handler\n            uploadedFiles = await onFileUpload(sendOptions.files);\n          } else {\n            // Default: upload via Devic API\n            const uploadResults = await Promise.all(\n              sendOptions.files.map((file) => clientRef.current!.uploadFile(file))\n            );\n            uploadedFiles = uploadResults.map((r) => ({\n              name: r.name,\n              downloadUrl: r.downloadUrl,\n              fileType: r.fileType as ChatFile['fileType'],\n            }));\n          }\n          logRef.current.log('[useDevicChat] Files uploaded:', uploadedFiles);\n\n          // Update optimistic message with download URLs\n          setMessages((prev) =>\n            prev.map((m) =>\n              m.uid === userMessage.uid\n                ? {\n                    ...m,\n                    content: {\n                      ...m.content,\n                      files: uploadedFiles!.map((f) => ({\n                        name: f.name,\n                        url: f.downloadUrl || '',\n                        type: f.fileType || 'other',\n                      })),\n                    },\n                  }\n                : m\n            )\n          );\n        }\n\n        // Build request DTO\n        const dto = {\n          message,\n          chatUid: chatUid || undefined,\n          files: uploadedFiles,\n          metadata: {\n            ...resolvedTenantMetadata,\n            ...sendOptions?.metadata,\n          },\n          tenantId: resolvedTenantId,\n          enabledTools,\n          // Include model interface tools if any\n          ...(toolSchemas.length > 0 && { tools: toolSchemas }),\n        };\n\n        // Send message in async mode\n        logRef.current.log('[useDevicChat] Sending message async...');\n        const response = await clientRef.current.sendMessageAsync(assistantId, dto);\n        logRef.current.log('[useDevicChat] sendMessageAsync response:', response);\n\n        // Update chat UID if this is a new chat\n        if (response.chatUid && response.chatUid !== chatUid) {\n          logRef.current.log('[useDevicChat] Setting chatUid:', response.chatUid);\n          setChatUid(response.chatUid);\n          onChatCreatedRef.current?.(response.chatUid);\n        }\n\n        // Start polling for results\n        logRef.current.log('[useDevicChat] Setting shouldPoll to true');\n        setShouldPoll(true);\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        setError(error);\n        setIsLoading(false);\n        setStatus('error');\n        onErrorRef.current?.(error);\n\n        // Remove optimistic user message on error\n        setMessages((prev) => prev.filter((m) => m.uid !== userMessage.uid));\n      }\n    },\n    [\n      chatUid,\n      assistantId,\n      enabledTools,\n      resolvedTenantId,\n      resolvedTenantMetadata,\n      toolSchemas,\n      onMessageSent,\n      onFileUpload,\n    ]\n  );\n\n  // Clear chat\n  const clearChat = useCallback(() => {\n    setShouldPoll(false);\n    setHandedOff(false);\n    setHandedOffSubThreadId(null);\n    if (handoffPollRef.current) {\n      clearInterval(handoffPollRef.current);\n      handoffPollRef.current = null;\n    }\n    setMessages([]);\n    setChatUid(null);\n    setIsLoading(false);\n    setStatus('idle');\n    setError(null);\n  }, []);\n\n  // Load existing chat\n  const loadChat = useCallback(\n    async (loadChatUid: string) => {\n      if (!clientRef.current) {\n        const err = new Error('API client not configured');\n        setError(err);\n        onErrorRef.current?.(err);\n        return;\n      }\n\n      // Reset any active polling/handoff state from previous conversation\n      setShouldPoll(false);\n      setHandedOff(false);\n      setHandedOffSubThreadId(null);\n      if (handoffPollRef.current) {\n        clearInterval(handoffPollRef.current);\n        handoffPollRef.current = null;\n      }\n\n      setIsLoading(true);\n      setError(null);\n\n      try {\n        const history = await clientRef.current.getChatHistory(\n          assistantId,\n          loadChatUid,\n          { tenantId: resolvedTenantId }\n        );\n\n        setMessages(history.chatContent);\n        setChatUid(loadChatUid);\n\n        // Check realtime status to resume in-progress conversations\n        await resumeFromRealtimeStatus(loadChatUid);\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        setError(error);\n        onErrorRef.current?.(error);\n        setIsLoading(false);\n      }\n    },\n    [assistantId, resolvedTenantId, resumeFromRealtimeStatus]\n  );\n\n  // Handoff polling: while handedOff is true, poll the realtime endpoint every 5s\n  // to detect when the parent thread is no longer in handed_off state.\n  useEffect(() => {\n    if (!handedOff || !chatUid || !clientRef.current) return;\n\n    const pollHandoff = async () => {\n      try {\n        const realtime = await clientRef.current!.getRealtimeHistory(assistantId, chatUid!);\n        logRef.current.log('[useDevicChat] Handoff poll - realtime status:', realtime.status);\n        if (realtime.status !== 'handed_off') {\n          // Handoff completed — clear handoff state and resume main polling\n          if (handoffPollRef.current) {\n            clearInterval(handoffPollRef.current);\n            handoffPollRef.current = null;\n          }\n          setHandedOff(false);\n          setHandedOffSubThreadId(null);\n          // Resume main polling to pick up the parent thread's continuation\n          setShouldPoll(true);\n        }\n      } catch {}\n    };\n\n    handoffPollRef.current = setInterval(pollHandoff, 5000);\n    return () => {\n      if (handoffPollRef.current) {\n        clearInterval(handoffPollRef.current);\n        handoffPollRef.current = null;\n      }\n    };\n  }, [handedOff, chatUid, assistantId]);\n\n  // Called by HandoffSubagentWidget when the subthread reaches a terminal state\n  const onHandoffCompleted = useCallback(() => {\n    logRef.current.log('[useDevicChat] onHandoffCompleted called');\n    // Clear the handoff polling\n    if (handoffPollRef.current) {\n      clearInterval(handoffPollRef.current);\n      handoffPollRef.current = null;\n    }\n    // Clear handoff state and resume main polling\n    setHandedOff(false);\n    setHandedOffSubThreadId(null);\n    setShouldPoll(true);\n  }, []);\n\n  // Stop current conversation — calls the server-side stop endpoint\n  // then stops polling and resets loading state.\n  const stopChat = useCallback(async () => {\n    const uid = chatUidRef.current;\n    logRef.current.log('[useDevicChat] stopChat called, chatUid:', uid);\n    if (clientRef.current && uid) {\n      try {\n        await clientRef.current.stopChat(assistantId, uid);\n        logRef.current.log('[useDevicChat] stopChat API call succeeded');\n      } catch (err) {\n        logRef.current.warn('[useDevicChat] stopChat API call failed:', err);\n      }\n    }\n    setShouldPoll(false);\n    setIsLoading(false);\n    setStatus('idle');\n  }, [assistantId]);\n\n  return {\n    messages,\n    chatUid,\n    isLoading,\n    status,\n    error,\n    handedOff,\n    handedOffSubThreadId,\n    sendMessage,\n    clearChat,\n    loadChat,\n    onHandoffCompleted,\n    stopChat,\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"useDevicChat.js","sources":["../../../src/hooks/useDevicChat.ts"],"sourcesContent":["import { useState, useCallback, useEffect, useRef, useMemo } from 'react';\nimport { useOptionalDevicContext } from '../provider';\nimport { DevicApiClient } from '../api/client';\nimport { usePolling } from './usePolling';\nimport { useModelInterface, type PendingWidgetCall } from './useModelInterface';\nimport { createLogger } from '../utils/logger';\nimport type {\n  ChatMessage,\n  ChatFile,\n  ModelInterfaceTool,\n  RealtimeChatHistory,\n  RealtimeStatus,\n} from '../api/types';\n\nexport interface UseDevicChatOptions {\n  /**\n   * Assistant identifier\n   */\n  assistantId: string;\n\n  /**\n   * Existing chat UID to continue a conversation\n   */\n  chatUid?: string;\n\n  /**\n   * API key (overrides provider context)\n   */\n  apiKey?: string;\n\n  /**\n   * Base URL (overrides provider context)\n   */\n  baseUrl?: string;\n\n  /**\n   * Tenant ID for multi-tenant environments\n   */\n  tenantId?: string;\n\n  /**\n   * Tenant metadata\n   */\n  tenantMetadata?: Record<string, any>;\n\n  /**\n   * Tools enabled from the assistant's configured tool groups\n   */\n  enabledTools?: string[];\n\n  /**\n   * Client-side tools for model interface protocol\n   */\n  modelInterfaceTools?: ModelInterfaceTool[];\n\n  /**\n   * Polling interval for async mode (ms)\n   * @default 1000\n   */\n  pollingInterval?: number;\n\n  /**\n   * Callback when a message is sent\n   */\n  onMessageSent?: (message: ChatMessage) => void;\n\n  /**\n   * Callback when a message is received\n   */\n  onMessageReceived?: (message: ChatMessage) => void;\n\n  /**\n   * Callback when a tool is called\n   */\n  onToolCall?: (toolName: string, params: any) => void;\n\n  /**\n   * Callback when an error occurs\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * Callback when a new chat is created\n   */\n  onChatCreated?: (chatUid: string) => void;\n\n  /**\n   * Custom file upload handler. When provided, replaces the default\n   * upload to Devic API. Receives the raw File objects and must return\n   * an array of ChatFile with downloadUrl set.\n   */\n  onFileUpload?: (files: File[]) => Promise<ChatFile[]>;\n\n  /**\n   * Enable debug logging to the browser console.\n   * Overrides the provider-level debug setting when provided.\n   * @default false\n   */\n  debug?: boolean;\n}\n\nexport interface UseDevicChatResult {\n  /**\n   * Current chat messages\n   */\n  messages: ChatMessage[];\n\n  /**\n   * Current chat UID\n   */\n  chatUid: string | null;\n\n  /**\n   * Whether a message is being processed\n   */\n  isLoading: boolean;\n\n  /**\n   * Current status\n   */\n  status: RealtimeStatus | 'idle';\n\n  /**\n   * Last error\n   */\n  error: Error | null;\n\n  /**\n   * Whether the assistant has handed off to a subagent\n   */\n  handedOff: boolean;\n\n  /**\n   * The subthread ID when a handoff is active\n   */\n  handedOffSubThreadId: string | null;\n\n  /**\n   * Send a message\n   */\n  sendMessage: (\n    message: string,\n    options?: {\n      files?: File[];\n      metadata?: Record<string, any>;\n    }\n  ) => Promise<void>;\n\n  /**\n   * Clear the chat and start a new conversation\n   */\n  clearChat: () => void;\n\n  /**\n   * Load an existing chat\n   */\n  loadChat: (chatUid: string) => Promise<void>;\n\n  /**\n   * Called when the handoff subagent completes.\n   * Triggers reload of full chat content.\n   */\n  onHandoffCompleted: () => void;\n\n  /**\n   * Stop the current conversation processing (client-side only).\n   * Stops polling and resets loading state.\n   */\n  stopChat: () => void;\n\n  /**\n   * Pending tool calls that require user interaction via a response widget\n   */\n  pendingWidgetCalls: PendingWidgetCall[];\n\n  /**\n   * Submit a response for a pending widget tool call.\n   * Sends the response to the API and resumes the conversation.\n   */\n  submitWidgetResponse: (toolCallId: string, response: any) => Promise<void>;\n\n  /**\n   * Cancel a pending widget tool call.\n   * Sends an error response so the model can continue.\n   */\n  cancelWidgetCall: (toolCallId: string, reason?: string) => Promise<void>;\n}\n\n/**\n * Main hook for managing chat with a Devic assistant\n *\n * @example\n * ```tsx\n * const {\n *   messages,\n *   isLoading,\n *   sendMessage,\n * } = useDevicChat({\n *   assistantId: 'my-assistant',\n *   modelInterfaceTools: [\n *     {\n *       toolName: 'get_user_location',\n *       schema: { ... },\n *       callback: async () => ({ lat: 40.7, lng: -74.0 })\n *     }\n *   ],\n *   onMessageReceived: (msg) => console.log('Received:', msg),\n * });\n * ```\n */\nexport function useDevicChat(options: UseDevicChatOptions): UseDevicChatResult {\n  const {\n    assistantId,\n    chatUid: initialChatUid,\n    apiKey: propsApiKey,\n    baseUrl: propsBaseUrl,\n    tenantId,\n    tenantMetadata,\n    enabledTools,\n    modelInterfaceTools = [],\n    pollingInterval = 1000,\n    onMessageSent,\n    onMessageReceived,\n    onToolCall,\n    onError,\n    onChatCreated,\n    onFileUpload,\n    debug: propsDebug,\n  } = options;\n\n  // Get context (may be null if not wrapped in provider)\n  const context = useOptionalDevicContext();\n\n  // Resolve configuration\n  const apiKey = propsApiKey || context?.apiKey;\n  const baseUrl = propsBaseUrl || context?.baseUrl || 'https://api.devic.ai';\n  const resolvedTenantId = tenantId || context?.tenantId;\n  const resolvedTenantMetadata = { ...context?.tenantMetadata, ...tenantMetadata };\n  const debug = propsDebug ?? context?.debug ?? false;\n  const log = useMemo(() => createLogger(debug), [debug]);\n  const logRef = useRef(log);\n  logRef.current = log;\n\n  // State\n  const [messages, setMessages] = useState<ChatMessage[]>([]);\n  const [chatUid, setChatUid] = useState<string | null>(initialChatUid || null);\n  const [isLoading, setIsLoading] = useState(false);\n  const [status, setStatus] = useState<RealtimeStatus | 'idle'>('idle');\n  const [error, setError] = useState<Error | null>(null);\n\n  // Handoff state\n  const [handedOff, setHandedOff] = useState(false);\n  const [handedOffSubThreadId, setHandedOffSubThreadId] = useState<string | null>(null);\n  const handoffPollRef = useRef<ReturnType<typeof setInterval> | null>(null);\n\n  // Polling state\n  const [shouldPoll, setShouldPoll] = useState(false);\n\n  // Keep a ref to chatUid so async callbacks always read the latest value\n  const chatUidRef = useRef(chatUid);\n  chatUidRef.current = chatUid;\n\n  // Refs for callbacks\n  const onMessageReceivedRef = useRef(onMessageReceived);\n  const onErrorRef = useRef(onError);\n  const onChatCreatedRef = useRef(onChatCreated);\n\n  useEffect(() => {\n    onMessageReceivedRef.current = onMessageReceived;\n    onErrorRef.current = onError;\n    onChatCreatedRef.current = onChatCreated;\n  });\n\n  // Create API client\n  const clientRef = useRef<DevicApiClient | null>(null);\n  if (!clientRef.current && apiKey) {\n    clientRef.current = new DevicApiClient({ apiKey, baseUrl });\n  }\n\n  // Update client config if it changes\n  useEffect(() => {\n    if (clientRef.current && apiKey) {\n      clientRef.current.setConfig({ apiKey, baseUrl });\n    }\n  }, [apiKey, baseUrl]);\n\n  // Resume chat state based on realtime status.\n  // Called after loading chat history to detect in-progress conversations.\n  const resumeFromRealtimeStatus = useCallback(\n    async (targetChatUid: string) => {\n      if (!clientRef.current) return;\n      try {\n        const realtime = await clientRef.current.getRealtimeHistory(assistantId, targetChatUid);\n        logRef.current.log('[useDevicChat] resumeFromRealtimeStatus:', realtime.status);\n\n        // Update messages with realtime data (may be fresher than static history)\n        if (realtime.chatHistory?.length) {\n          setMessages(realtime.chatHistory);\n        }\n        setStatus(realtime.status);\n\n        if (realtime.status === 'processing') {\n          // Chat is still processing — resume polling\n          setIsLoading(true);\n          setShouldPoll(true);\n        } else if (realtime.status === 'waiting_for_tool_response') {\n          // Chat is waiting for tool response — resume polling to trigger tool handling\n          setIsLoading(true);\n          setShouldPoll(true);\n        } else if (realtime.status === 'handed_off') {\n          // Chat has an active handoff\n          setIsLoading(true);\n          setHandedOff(true);\n          const subThreadId = realtime.handedOffSubThreadId || null;\n          logRef.current.log('[useDevicChat] Resuming handoff state:', { subThreadId });\n          if (subThreadId) {\n            setHandedOffSubThreadId(subThreadId);\n          }\n        } else {\n          // completed or error — just stop\n          setIsLoading(false);\n        }\n      } catch (err) {\n        // If realtime fetch fails (e.g. chat has no realtime entry), just stay idle\n        logRef.current.warn('[useDevicChat] resumeFromRealtimeStatus failed:', err);\n        setIsLoading(false);\n      }\n    },\n    [assistantId]\n  );\n\n  // Load initial chat history if chatUid prop is provided\n  // This runs once on mount (or when initialChatUid changes) to fetch existing conversation\n  const initialChatLoadedRef = useRef(false);\n  useEffect(() => {\n    if (initialChatUid && clientRef.current && !initialChatLoadedRef.current) {\n      initialChatLoadedRef.current = true;\n\n      const loadInitialChat = async () => {\n        setIsLoading(true);\n        setError(null);\n        try {\n          const history = await clientRef.current!.getChatHistory(\n            assistantId,\n            initialChatUid,\n            { tenantId: resolvedTenantId }\n          );\n          setMessages(history.chatContent);\n          setChatUid(initialChatUid);\n\n          // Check realtime status to resume in-progress conversations\n          await resumeFromRealtimeStatus(initialChatUid);\n        } catch (err) {\n          const error = err instanceof Error ? err : new Error(String(err));\n          setError(error);\n          onErrorRef.current?.(error);\n          setIsLoading(false);\n        }\n      };\n\n      loadInitialChat();\n    }\n  }, [initialChatUid, assistantId, resolvedTenantId, resumeFromRealtimeStatus]);\n\n  // Model interface hook\n  const {\n    toolSchemas,\n    handleToolCalls,\n    extractPendingToolCalls,\n  } = useModelInterface({\n    tools: modelInterfaceTools,\n    onToolExecute: onToolCall,\n  });\n\n  // Pending widget calls awaiting user interaction\n  const [pendingWidgetCalls, setPendingWidgetCalls] = useState<PendingWidgetCall[]>([]);\n  const pendingWidgetCallsRef = useRef<PendingWidgetCall[]>([]);\n  useEffect(() => {\n    pendingWidgetCallsRef.current = pendingWidgetCalls;\n  }, [pendingWidgetCalls]);\n\n  // Polling hook - uses callbacks for side effects, return value not needed\n  logRef.current.log('[useDevicChat] Render - shouldPoll:', shouldPoll, 'chatUid:', chatUid);\n  usePolling(\n    shouldPoll ? chatUid : null,\n    async () => {\n      logRef.current.log('[useDevicChat] fetchFn called, chatUid:', chatUid);\n      if (!clientRef.current || !chatUid) {\n        throw new Error('Cannot poll without client or chatUid');\n      }\n      const result = await clientRef.current.getRealtimeHistory(assistantId, chatUid);\n      logRef.current.log('[useDevicChat] getRealtimeHistory result:', result);\n      return result;\n    },\n    {\n      interval: pollingInterval,\n      enabled: shouldPoll,\n      stopStatuses: ['completed', 'error', 'waiting_for_tool_response', 'handed_off'],\n      onUpdate: async (data: RealtimeChatHistory) => {\n        logRef.current.log('[useDevicChat] onUpdate called, status:', data.status);\n\n        // Merge realtime data with optimistic messages.\n        // When a server user message matches an optimistic one by text, adopt the\n        // optimistic uid so React's key stays stable (avoids unmount/remount flicker).\n        setMessages((prev) => {\n          const normalize = (t?: string) => (t ?? '').trim();\n          const optimisticUserByText = new Map(\n            prev\n              .filter((m) => m.role === 'user' && m.uid.startsWith('temp-'))\n              .map((m) => [normalize(m.content?.message), m.uid])\n          );\n\n          const adoptedTempUids = new Set<string>();\n          const merged = data.chatHistory.map((m) => {\n            if (m.role === 'user') {\n              const tempUid = optimisticUserByText.get(normalize(m.content?.message));\n              if (tempUid) {\n                adoptedTempUids.add(tempUid);\n                return { ...m, uid: tempUid };\n              }\n            }\n            return m;\n          });\n\n          const mergedUIDs = new Set(merged.map((m) => m.uid));\n          const optimistic = prev.filter(\n            (m) => !mergedUIDs.has(m.uid) && !adoptedTempUids.has(m.uid)\n          );\n\n          return [...merged, ...optimistic];\n        });\n        setStatus(data.status);\n\n        // Notify about new messages\n        const lastMessage = data.chatHistory[data.chatHistory.length - 1];\n        if (lastMessage && lastMessage.role === 'assistant') {\n          onMessageReceivedRef.current?.(lastMessage);\n        }\n\n        // Handle model interface - check for pending tool calls\n        if (data.status === 'waiting_for_tool_response' || data.pendingToolCalls?.length) {\n          await handlePendingToolCalls(data);\n        }\n      },\n      onStop: (data) => {\n        logRef.current.log('[useDevicChat] onStop called, status:', data?.status);\n        setShouldPoll(false);\n\n        if (data?.status === 'error') {\n          setIsLoading(false);\n          const err = new Error('Chat processing failed');\n          setError(err);\n          onErrorRef.current?.(err);\n        } else if (data?.status === 'completed') {\n          setIsLoading(false);\n        } else if (data?.status === 'handed_off') {\n          // Subagent is working — keep isLoading true so the UI stays in loading state.\n          // Set handoff state directly from the realtime status.\n          setHandedOff(true);\n\n          const subThreadId = data.handedOffSubThreadId || null;\n          logRef.current.log('[useDevicChat] Handoff state set:', { handedOff: true, subThreadId });\n          if (subThreadId) {\n            setHandedOffSubThreadId(subThreadId);\n          }\n        }\n        // Note: waiting_for_tool_response is handled in onUpdate to avoid double execution\n      },\n      onError: (err) => {\n        logRef.current.error('[useDevicChat] onError called:', err);\n        setError(err);\n        setIsLoading(false);\n        setShouldPoll(false);\n        onErrorRef.current?.(err);\n      },\n      debug,\n    }\n  );\n\n  // Handle pending tool calls from model interface\n  const handlePendingToolCalls = useCallback(\n    async (data: RealtimeChatHistory) => {\n      if (!clientRef.current || !chatUid) return;\n\n      // Get pending tool calls\n      const pendingCalls = data.pendingToolCalls || extractPendingToolCalls(data.chatHistory);\n\n      if (pendingCalls.length === 0) return;\n\n      try {\n        // Execute client-side tools (partitioned into immediate responses and widget-driven)\n        const { responses, widgetCalls } = await handleToolCalls(pendingCalls);\n\n        // Queue widget-driven tool calls for user interaction\n        if (widgetCalls.length > 0) {\n          const existingIds = new Set(pendingWidgetCallsRef.current.map((c) => c.toolCall.id));\n          const deduped = widgetCalls.filter((c) => !existingIds.has(c.toolCall.id));\n          const next = [...pendingWidgetCallsRef.current, ...deduped];\n          pendingWidgetCallsRef.current = next;\n          setPendingWidgetCalls(next);\n          // Stop polling while we wait for the user to submit the widget response.\n          // The widget submission will re-trigger polling via submitWidgetResponse.\n          setShouldPoll(false);\n          setIsLoading(false);\n        }\n\n        if (responses.length > 0) {\n          // Send tool responses back to the API\n          await clientRef.current.sendToolResponses(assistantId, chatUid, responses);\n\n          // Only resume polling if no widgets are blocking\n          if (widgetCalls.length === 0) {\n            setShouldPoll(true);\n            setIsLoading(true);\n          }\n        }\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        setError(error);\n        onErrorRef.current?.(error);\n      }\n    },\n    [chatUid, assistantId, handleToolCalls, extractPendingToolCalls]\n  );\n\n  // Send a message\n  const sendMessage = useCallback(\n    async (\n      message: string,\n      sendOptions?: {\n        files?: File[];\n        metadata?: Record<string, any>;\n      }\n    ) => {\n      if (!clientRef.current) {\n        const err = new Error(\n          'API client not configured. Please provide an API key.'\n        );\n        setError(err);\n        onErrorRef.current?.(err);\n        return;\n      }\n\n      setIsLoading(true);\n      setError(null);\n      setStatus('processing');\n\n      // Add user message optimistically (show file names before upload)\n      const userMessage: ChatMessage = {\n        uid: `temp-${Date.now()}`,\n        role: 'user',\n        content: {\n          message,\n          files: sendOptions?.files?.map((f) => ({\n            name: f.name,\n            url: '',\n            type: f.type.split('/')[0] || 'other',\n          })),\n        },\n        timestamp: Date.now(),\n      };\n\n      setMessages((prev) => [...prev, userMessage]);\n      onMessageSent?.(userMessage);\n\n      try {\n        // Upload files if provided\n        let uploadedFiles: ChatFile[] | undefined;\n        if (sendOptions?.files && sendOptions.files.length > 0) {\n          logRef.current.log('[useDevicChat] Uploading files...');\n          if (onFileUpload) {\n            // Use custom upload handler\n            uploadedFiles = await onFileUpload(sendOptions.files);\n          } else {\n            // Default: upload via Devic API\n            const uploadResults = await Promise.all(\n              sendOptions.files.map((file) => clientRef.current!.uploadFile(file))\n            );\n            uploadedFiles = uploadResults.map((r) => ({\n              name: r.name,\n              downloadUrl: r.downloadUrl,\n              fileType: r.fileType as ChatFile['fileType'],\n            }));\n          }\n          logRef.current.log('[useDevicChat] Files uploaded:', uploadedFiles);\n\n          // Update optimistic message with download URLs\n          setMessages((prev) =>\n            prev.map((m) =>\n              m.uid === userMessage.uid\n                ? {\n                    ...m,\n                    content: {\n                      ...m.content,\n                      files: uploadedFiles!.map((f) => ({\n                        name: f.name,\n                        url: f.downloadUrl || '',\n                        type: f.fileType || 'other',\n                      })),\n                    },\n                  }\n                : m\n            )\n          );\n        }\n\n        // Build request DTO\n        const dto = {\n          message,\n          chatUid: chatUid || undefined,\n          files: uploadedFiles,\n          metadata: {\n            ...resolvedTenantMetadata,\n            ...sendOptions?.metadata,\n          },\n          tenantId: resolvedTenantId,\n          enabledTools,\n          // Include model interface tools if any\n          ...(toolSchemas.length > 0 && { tools: toolSchemas }),\n        };\n\n        // Send message in async mode\n        logRef.current.log('[useDevicChat] Sending message async...');\n        const response = await clientRef.current.sendMessageAsync(assistantId, dto);\n        logRef.current.log('[useDevicChat] sendMessageAsync response:', response);\n\n        // Update chat UID if this is a new chat\n        if (response.chatUid && response.chatUid !== chatUid) {\n          logRef.current.log('[useDevicChat] Setting chatUid:', response.chatUid);\n          setChatUid(response.chatUid);\n          onChatCreatedRef.current?.(response.chatUid);\n        }\n\n        // Start polling for results\n        logRef.current.log('[useDevicChat] Setting shouldPoll to true');\n        setShouldPoll(true);\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        setError(error);\n        setIsLoading(false);\n        setStatus('error');\n        onErrorRef.current?.(error);\n\n        // Remove optimistic user message on error\n        setMessages((prev) => prev.filter((m) => m.uid !== userMessage.uid));\n      }\n    },\n    [\n      chatUid,\n      assistantId,\n      enabledTools,\n      resolvedTenantId,\n      resolvedTenantMetadata,\n      toolSchemas,\n      onMessageSent,\n      onFileUpload,\n    ]\n  );\n\n  // Clear chat\n  const clearChat = useCallback(() => {\n    setShouldPoll(false);\n    setHandedOff(false);\n    setHandedOffSubThreadId(null);\n    if (handoffPollRef.current) {\n      clearInterval(handoffPollRef.current);\n      handoffPollRef.current = null;\n    }\n    setMessages([]);\n    setChatUid(null);\n    setIsLoading(false);\n    setStatus('idle');\n    setError(null);\n    pendingWidgetCallsRef.current = [];\n    setPendingWidgetCalls([]);\n  }, []);\n\n  // Load existing chat\n  const loadChat = useCallback(\n    async (loadChatUid: string) => {\n      if (!clientRef.current) {\n        const err = new Error('API client not configured');\n        setError(err);\n        onErrorRef.current?.(err);\n        return;\n      }\n\n      // Reset any active polling/handoff state from previous conversation\n      setShouldPoll(false);\n      setHandedOff(false);\n      setHandedOffSubThreadId(null);\n      pendingWidgetCallsRef.current = [];\n    setPendingWidgetCalls([]);\n      if (handoffPollRef.current) {\n        clearInterval(handoffPollRef.current);\n        handoffPollRef.current = null;\n      }\n\n      setIsLoading(true);\n      setError(null);\n\n      try {\n        const history = await clientRef.current.getChatHistory(\n          assistantId,\n          loadChatUid,\n          { tenantId: resolvedTenantId }\n        );\n\n        setMessages(history.chatContent);\n        setChatUid(loadChatUid);\n\n        // Check realtime status to resume in-progress conversations\n        await resumeFromRealtimeStatus(loadChatUid);\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        setError(error);\n        onErrorRef.current?.(error);\n        setIsLoading(false);\n      }\n    },\n    [assistantId, resolvedTenantId, resumeFromRealtimeStatus]\n  );\n\n  // Handoff polling: while handedOff is true, poll the realtime endpoint every 5s\n  // to detect when the parent thread is no longer in handed_off state.\n  useEffect(() => {\n    if (!handedOff || !chatUid || !clientRef.current) return;\n\n    const pollHandoff = async () => {\n      try {\n        const realtime = await clientRef.current!.getRealtimeHistory(assistantId, chatUid!);\n        logRef.current.log('[useDevicChat] Handoff poll - realtime status:', realtime.status);\n        if (realtime.status !== 'handed_off') {\n          // Handoff completed — clear handoff state and resume main polling\n          if (handoffPollRef.current) {\n            clearInterval(handoffPollRef.current);\n            handoffPollRef.current = null;\n          }\n          setHandedOff(false);\n          setHandedOffSubThreadId(null);\n          // Resume main polling to pick up the parent thread's continuation\n          setShouldPoll(true);\n        }\n      } catch {}\n    };\n\n    handoffPollRef.current = setInterval(pollHandoff, 5000);\n    return () => {\n      if (handoffPollRef.current) {\n        clearInterval(handoffPollRef.current);\n        handoffPollRef.current = null;\n      }\n    };\n  }, [handedOff, chatUid, assistantId]);\n\n  // Called by HandoffSubagentWidget when the subthread reaches a terminal state\n  const onHandoffCompleted = useCallback(() => {\n    logRef.current.log('[useDevicChat] onHandoffCompleted called');\n    // Clear the handoff polling\n    if (handoffPollRef.current) {\n      clearInterval(handoffPollRef.current);\n      handoffPollRef.current = null;\n    }\n    // Clear handoff state and resume main polling\n    setHandedOff(false);\n    setHandedOffSubThreadId(null);\n    setShouldPoll(true);\n  }, []);\n\n  // Submit a response for a pending widget tool call\n  const submitWidgetResponse = useCallback(\n    async (toolCallId: string, response: any) => {\n      const uid = chatUidRef.current;\n      if (!clientRef.current || !uid) return;\n\n      // Check pending widgets via ref (state updates are async)\n      const current = pendingWidgetCallsRef.current;\n      const found = current.some((c) => c.toolCall.id === toolCallId);\n      if (!found) return;\n\n      // Remove the widget call from pending list\n      const remaining = current.filter((c) => c.toolCall.id !== toolCallId);\n      pendingWidgetCallsRef.current = remaining;\n      setPendingWidgetCalls(remaining);\n\n      try {\n        logRef.current.log('[useDevicChat] sending widget tool response', toolCallId);\n        await clientRef.current.sendToolResponses(assistantId, uid, [\n          { tool_call_id: toolCallId, content: response, role: 'tool' },\n        ]);\n        // Resume polling only if no more widget calls are blocking\n        if (remaining.length === 0) {\n          setShouldPoll(true);\n          setIsLoading(true);\n        }\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error(String(err));\n        logRef.current.error('[useDevicChat] submitWidgetResponse failed', error);\n        setError(error);\n        onErrorRef.current?.(error);\n      }\n    },\n    [assistantId]\n  );\n\n  // Cancel a pending widget tool call (sends an error response to the model)\n  const cancelWidgetCall = useCallback(\n    async (toolCallId: string, reason?: string) => {\n      await submitWidgetResponse(toolCallId, {\n        error: reason || 'User cancelled the tool call',\n      });\n    },\n    [submitWidgetResponse]\n  );\n\n  // Stop current conversation — calls the server-side stop endpoint\n  // then stops polling and resets loading state.\n  const stopChat = useCallback(async () => {\n    const uid = chatUidRef.current;\n    logRef.current.log('[useDevicChat] stopChat called, chatUid:', uid);\n    if (clientRef.current && uid) {\n      try {\n        await clientRef.current.stopChat(assistantId, uid);\n        logRef.current.log('[useDevicChat] stopChat API call succeeded');\n      } catch (err) {\n        logRef.current.warn('[useDevicChat] stopChat API call failed:', err);\n      }\n    }\n    setShouldPoll(false);\n    setIsLoading(false);\n    setStatus('idle');\n  }, [assistantId]);\n\n  return {\n    messages,\n    chatUid,\n    isLoading,\n    status,\n    error,\n    handedOff,\n    handedOffSubThreadId,\n    sendMessage,\n    clearChat,\n    loadChat,\n    onHandoffCompleted,\n    stopChat,\n    pendingWidgetCalls,\n    submitWidgetResponse,\n    cancelWidgetCall,\n  };\n}\n"],"names":[],"mappings":";;;;;;;;AA4LA;;;;;;;;;;;;;;;;;;;;;AAqBG;AACG,SAAU,YAAY,CAAC,OAA4B,EAAA;IACvD,MAAM,EACJ,WAAW,EACX,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,YAAY,EACrB,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,mBAAmB,GAAG,EAAE,EACxB,eAAe,GAAG,IAAI,EACtB,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,OAAO,EACP,aAAa,EACb,YAAY,EACZ,KAAK,EAAE,UAAU,GAClB,GAAG,OAAO;;AAGX,IAAA,MAAM,OAAO,GAAG,uBAAuB,EAAE;;AAGzC,IAAA,MAAM,MAAM,GAAG,WAAW,IAAI,OAAO,EAAE,MAAM;IAC7C,MAAM,OAAO,GAAG,YAAY,IAAI,OAAO,EAAE,OAAO,IAAI,sBAAsB;AAC1E,IAAA,MAAM,gBAAgB,GAAG,QAAQ,IAAI,OAAO,EAAE,QAAQ;IACtD,MAAM,sBAAsB,GAAG,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE;IAChF,MAAM,KAAK,GAAG,UAAU,IAAI,OAAO,EAAE,KAAK,IAAI,KAAK;AACnD,IAAA,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AACvD,IAAA,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC;AAC1B,IAAA,MAAM,CAAC,OAAO,GAAG,GAAG;;IAGpB,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAgB,EAAE,CAAC;AAC3D,IAAA,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAgB,cAAc,IAAI,IAAI,CAAC;IAC7E,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;IACjD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAA0B,MAAM,CAAC;IACrE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC;;IAGtD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;IACjD,MAAM,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC;AACrF,IAAA,MAAM,cAAc,GAAG,MAAM,CAAwC,IAAI,CAAC;;IAG1E,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;;AAGnD,IAAA,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC;AAClC,IAAA,UAAU,CAAC,OAAO,GAAG,OAAO;;AAG5B,IAAA,MAAM,oBAAoB,GAAG,MAAM,CAAC,iBAAiB,CAAC;AACtD,IAAA,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC;AAClC,IAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,aAAa,CAAC;IAE9C,SAAS,CAAC,MAAK;AACb,QAAA,oBAAoB,CAAC,OAAO,GAAG,iBAAiB;AAChD,QAAA,UAAU,CAAC,OAAO,GAAG,OAAO;AAC5B,QAAA,gBAAgB,CAAC,OAAO,GAAG,aAAa;AAC1C,IAAA,CAAC,CAAC;;AAGF,IAAA,MAAM,SAAS,GAAG,MAAM,CAAwB,IAAI,CAAC;AACrD,IAAA,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,MAAM,EAAE;AAChC,QAAA,SAAS,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC7D;;IAGA,SAAS,CAAC,MAAK;AACb,QAAA,IAAI,SAAS,CAAC,OAAO,IAAI,MAAM,EAAE;YAC/B,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAClD;AACF,IAAA,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;;;IAIrB,MAAM,wBAAwB,GAAG,WAAW,CAC1C,OAAO,aAAqB,KAAI;QAC9B,IAAI,CAAC,SAAS,CAAC,OAAO;YAAE;AACxB,QAAA,IAAI;AACF,YAAA,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,aAAa,CAAC;YACvF,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,0CAA0C,EAAE,QAAQ,CAAC,MAAM,CAAC;;AAG/E,YAAA,IAAI,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE;AAChC,gBAAA,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC;YACnC;AACA,YAAA,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;AAE1B,YAAA,IAAI,QAAQ,CAAC,MAAM,KAAK,YAAY,EAAE;;gBAEpC,YAAY,CAAC,IAAI,CAAC;gBAClB,aAAa,CAAC,IAAI,CAAC;YACrB;AAAO,iBAAA,IAAI,QAAQ,CAAC,MAAM,KAAK,2BAA2B,EAAE;;gBAE1D,YAAY,CAAC,IAAI,CAAC;gBAClB,aAAa,CAAC,IAAI,CAAC;YACrB;AAAO,iBAAA,IAAI,QAAQ,CAAC,MAAM,KAAK,YAAY,EAAE;;gBAE3C,YAAY,CAAC,IAAI,CAAC;gBAClB,YAAY,CAAC,IAAI,CAAC;AAClB,gBAAA,MAAM,WAAW,GAAG,QAAQ,CAAC,oBAAoB,IAAI,IAAI;gBACzD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,wCAAwC,EAAE,EAAE,WAAW,EAAE,CAAC;gBAC7E,IAAI,WAAW,EAAE;oBACf,uBAAuB,CAAC,WAAW,CAAC;gBACtC;YACF;iBAAO;;gBAEL,YAAY,CAAC,KAAK,CAAC;YACrB;QACF;QAAE,OAAO,GAAG,EAAE;;YAEZ,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,iDAAiD,EAAE,GAAG,CAAC;YAC3E,YAAY,CAAC,KAAK,CAAC;QACrB;AACF,IAAA,CAAC,EACD,CAAC,WAAW,CAAC,CACd;;;AAID,IAAA,MAAM,oBAAoB,GAAG,MAAM,CAAC,KAAK,CAAC;IAC1C,SAAS,CAAC,MAAK;QACb,IAAI,cAAc,IAAI,SAAS,CAAC,OAAO,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE;AACxE,YAAA,oBAAoB,CAAC,OAAO,GAAG,IAAI;AAEnC,YAAA,MAAM,eAAe,GAAG,YAAW;gBACjC,YAAY,CAAC,IAAI,CAAC;gBAClB,QAAQ,CAAC,IAAI,CAAC;AACd,gBAAA,IAAI;AACF,oBAAA,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,OAAQ,CAAC,cAAc,CACrD,WAAW,EACX,cAAc,EACd,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAC/B;AACD,oBAAA,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC;oBAChC,UAAU,CAAC,cAAc,CAAC;;AAG1B,oBAAA,MAAM,wBAAwB,CAAC,cAAc,CAAC;gBAChD;gBAAE,OAAO,GAAG,EAAE;oBACZ,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,GAAG,GAAG,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBACjE,QAAQ,CAAC,KAAK,CAAC;AACf,oBAAA,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;oBAC3B,YAAY,CAAC,KAAK,CAAC;gBACrB;AACF,YAAA,CAAC;AAED,YAAA,eAAe,EAAE;QACnB;IACF,CAAC,EAAE,CAAC,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,wBAAwB,CAAC,CAAC;;IAG7E,MAAM,EACJ,WAAW,EACX,eAAe,EACf,uBAAuB,GACxB,GAAG,iBAAiB,CAAC;AACpB,QAAA,KAAK,EAAE,mBAAmB;AAC1B,QAAA,aAAa,EAAE,UAAU;AAC1B,KAAA,CAAC;;IAGF,MAAM,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,GAAG,QAAQ,CAAsB,EAAE,CAAC;AACrF,IAAA,MAAM,qBAAqB,GAAG,MAAM,CAAsB,EAAE,CAAC;IAC7D,SAAS,CAAC,MAAK;AACb,QAAA,qBAAqB,CAAC,OAAO,GAAG,kBAAkB;AACpD,IAAA,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC;;AAGxB,IAAA,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC;AAC1F,IAAA,UAAU,CACR,UAAU,GAAG,OAAO,GAAG,IAAI,EAC3B,YAAW;QACT,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,yCAAyC,EAAE,OAAO,CAAC;QACtE,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE;AAClC,YAAA,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC;QAC1D;AACA,QAAA,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC;QAC/E,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,2CAA2C,EAAE,MAAM,CAAC;AACvE,QAAA,OAAO,MAAM;AACf,IAAA,CAAC,EACD;AACE,QAAA,QAAQ,EAAE,eAAe;AACzB,QAAA,OAAO,EAAE,UAAU;QACnB,YAAY,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,2BAA2B,EAAE,YAAY,CAAC;AAC/E,QAAA,QAAQ,EAAE,OAAO,IAAyB,KAAI;YAC5C,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,yCAAyC,EAAE,IAAI,CAAC,MAAM,CAAC;;;;AAK1E,YAAA,WAAW,CAAC,CAAC,IAAI,KAAI;AACnB,gBAAA,MAAM,SAAS,GAAG,CAAC,CAAU,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE;AAClD,gBAAA,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAClC;qBACG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;qBAC5D,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CACtD;AAED,gBAAA,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU;gBACzC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,KAAI;AACxC,oBAAA,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE;AACrB,wBAAA,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;wBACvE,IAAI,OAAO,EAAE;AACX,4BAAA,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC;4BAC5B,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE;wBAC/B;oBACF;AACA,oBAAA,OAAO,CAAC;AACV,gBAAA,CAAC,CAAC;AAEF,gBAAA,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;AACpD,gBAAA,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAC5B,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAC7D;AAED,gBAAA,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,UAAU,CAAC;AACnC,YAAA,CAAC,CAAC;AACF,YAAA,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;;AAGtB,YAAA,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;YACjE,IAAI,WAAW,IAAI,WAAW,CAAC,IAAI,KAAK,WAAW,EAAE;AACnD,gBAAA,oBAAoB,CAAC,OAAO,GAAG,WAAW,CAAC;YAC7C;;AAGA,YAAA,IAAI,IAAI,CAAC,MAAM,KAAK,2BAA2B,IAAI,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE;AAChF,gBAAA,MAAM,sBAAsB,CAAC,IAAI,CAAC;YACpC;QACF,CAAC;AACD,QAAA,MAAM,EAAE,CAAC,IAAI,KAAI;YACf,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,uCAAuC,EAAE,IAAI,EAAE,MAAM,CAAC;YACzE,aAAa,CAAC,KAAK,CAAC;AAEpB,YAAA,IAAI,IAAI,EAAE,MAAM,KAAK,OAAO,EAAE;gBAC5B,YAAY,CAAC,KAAK,CAAC;AACnB,gBAAA,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,wBAAwB,CAAC;gBAC/C,QAAQ,CAAC,GAAG,CAAC;AACb,gBAAA,UAAU,CAAC,OAAO,GAAG,GAAG,CAAC;YAC3B;AAAO,iBAAA,IAAI,IAAI,EAAE,MAAM,KAAK,WAAW,EAAE;gBACvC,YAAY,CAAC,KAAK,CAAC;YACrB;AAAO,iBAAA,IAAI,IAAI,EAAE,MAAM,KAAK,YAAY,EAAE;;;gBAGxC,YAAY,CAAC,IAAI,CAAC;AAElB,gBAAA,MAAM,WAAW,GAAG,IAAI,CAAC,oBAAoB,IAAI,IAAI;AACrD,gBAAA,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,mCAAmC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBACzF,IAAI,WAAW,EAAE;oBACf,uBAAuB,CAAC,WAAW,CAAC;gBACtC;YACF;;QAEF,CAAC;AACD,QAAA,OAAO,EAAE,CAAC,GAAG,KAAI;YACf,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,GAAG,CAAC;YAC3D,QAAQ,CAAC,GAAG,CAAC;YACb,YAAY,CAAC,KAAK,CAAC;YACnB,aAAa,CAAC,KAAK,CAAC;AACpB,YAAA,UAAU,CAAC,OAAO,GAAG,GAAG,CAAC;QAC3B,CAAC;QACD,KAAK;AACN,KAAA,CACF;;IAGD,MAAM,sBAAsB,GAAG,WAAW,CACxC,OAAO,IAAyB,KAAI;AAClC,QAAA,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,OAAO;YAAE;;AAGpC,QAAA,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,IAAI,uBAAuB,CAAC,IAAI,CAAC,WAAW,CAAC;AAEvF,QAAA,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE;AAE/B,QAAA,IAAI;;YAEF,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,MAAM,eAAe,CAAC,YAAY,CAAC;;AAGtE,YAAA,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE;gBAC1B,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,qBAAqB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACpF,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAC1E,MAAM,IAAI,GAAG,CAAC,GAAG,qBAAqB,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC;AAC3D,gBAAA,qBAAqB,CAAC,OAAO,GAAG,IAAI;gBACpC,qBAAqB,CAAC,IAAI,CAAC;;;gBAG3B,aAAa,CAAC,KAAK,CAAC;gBACpB,YAAY,CAAC,KAAK,CAAC;YACrB;AAEA,YAAA,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE;;AAExB,gBAAA,MAAM,SAAS,CAAC,OAAO,CAAC,iBAAiB,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC;;AAG1E,gBAAA,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE;oBAC5B,aAAa,CAAC,IAAI,CAAC;oBACnB,YAAY,CAAC,IAAI,CAAC;gBACpB;YACF;QACF;QAAE,OAAO,GAAG,EAAE;YACZ,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,GAAG,GAAG,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,QAAQ,CAAC,KAAK,CAAC;AACf,YAAA,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7B;IACF,CAAC,EACD,CAAC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,uBAAuB,CAAC,CACjE;;IAGD,MAAM,WAAW,GAAG,WAAW,CAC7B,OACE,OAAe,EACf,WAGC,KACC;AACF,QAAA,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE;AACtB,YAAA,MAAM,GAAG,GAAG,IAAI,KAAK,CACnB,uDAAuD,CACxD;YACD,QAAQ,CAAC,GAAG,CAAC;AACb,YAAA,UAAU,CAAC,OAAO,GAAG,GAAG,CAAC;YACzB;QACF;QAEA,YAAY,CAAC,IAAI,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC;QACd,SAAS,CAAC,YAAY,CAAC;;AAGvB,QAAA,MAAM,WAAW,GAAgB;AAC/B,YAAA,GAAG,EAAE,CAAA,KAAA,EAAQ,IAAI,CAAC,GAAG,EAAE,CAAA,CAAE;AACzB,YAAA,IAAI,EAAE,MAAM;AACZ,YAAA,OAAO,EAAE;gBACP,OAAO;AACP,gBAAA,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM;oBACrC,IAAI,EAAE,CAAC,CAAC,IAAI;AACZ,oBAAA,GAAG,EAAE,EAAE;AACP,oBAAA,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO;AACtC,iBAAA,CAAC,CAAC;AACJ,aAAA;AACD,YAAA,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB;AAED,QAAA,WAAW,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC;AAC7C,QAAA,aAAa,GAAG,WAAW,CAAC;AAE5B,QAAA,IAAI;;AAEF,YAAA,IAAI,aAAqC;AACzC,YAAA,IAAI,WAAW,EAAE,KAAK,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;AACtD,gBAAA,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC;gBACvD,IAAI,YAAY,EAAE;;oBAEhB,aAAa,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC;gBACvD;qBAAO;;AAEL,oBAAA,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CACrC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,OAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CACrE;oBACD,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM;wBACxC,IAAI,EAAE,CAAC,CAAC,IAAI;wBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,QAAQ,EAAE,CAAC,CAAC,QAAgC;AAC7C,qBAAA,CAAC,CAAC;gBACL;gBACA,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gCAAgC,EAAE,aAAa,CAAC;;gBAGnE,WAAW,CAAC,CAAC,IAAI,KACf,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KACT,CAAC,CAAC,GAAG,KAAK,WAAW,CAAC;AACpB,sBAAE;AACE,wBAAA,GAAG,CAAC;AACJ,wBAAA,OAAO,EAAE;4BACP,GAAG,CAAC,CAAC,OAAO;4BACZ,KAAK,EAAE,aAAc,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM;gCAChC,IAAI,EAAE,CAAC,CAAC,IAAI;AACZ,gCAAA,GAAG,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;AACxB,gCAAA,IAAI,EAAE,CAAC,CAAC,QAAQ,IAAI,OAAO;AAC5B,6BAAA,CAAC,CAAC;AACJ,yBAAA;AACF;AACH,sBAAE,CAAC,CACN,CACF;YACH;;AAGA,YAAA,MAAM,GAAG,GAAG;gBACV,OAAO;gBACP,OAAO,EAAE,OAAO,IAAI,SAAS;AAC7B,gBAAA,KAAK,EAAE,aAAa;AACpB,gBAAA,QAAQ,EAAE;AACR,oBAAA,GAAG,sBAAsB;oBACzB,GAAG,WAAW,EAAE,QAAQ;AACzB,iBAAA;AACD,gBAAA,QAAQ,EAAE,gBAAgB;gBAC1B,YAAY;;AAEZ,gBAAA,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;aACtD;;AAGD,YAAA,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC;AAC7D,YAAA,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,gBAAgB,CAAC,WAAW,EAAE,GAAG,CAAC;YAC3E,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,2CAA2C,EAAE,QAAQ,CAAC;;YAGzE,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,KAAK,OAAO,EAAE;gBACpD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,iCAAiC,EAAE,QAAQ,CAAC,OAAO,CAAC;AACvE,gBAAA,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAC5B,gBAAgB,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;YAC9C;;AAGA,YAAA,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC;YAC/D,aAAa,CAAC,IAAI,CAAC;QACrB;QAAE,OAAO,GAAG,EAAE;YACZ,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,GAAG,GAAG,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,QAAQ,CAAC,KAAK,CAAC;YACf,YAAY,CAAC,KAAK,CAAC;YACnB,SAAS,CAAC,OAAO,CAAC;AAClB,YAAA,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;;YAG3B,WAAW,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,WAAW,CAAC,GAAG,CAAC,CAAC;QACtE;AACF,IAAA,CAAC,EACD;QACE,OAAO;QACP,WAAW;QACX,YAAY;QACZ,gBAAgB;QAChB,sBAAsB;QACtB,WAAW;QACX,aAAa;QACb,YAAY;AACb,KAAA,CACF;;AAGD,IAAA,MAAM,SAAS,GAAG,WAAW,CAAC,MAAK;QACjC,aAAa,CAAC,KAAK,CAAC;QACpB,YAAY,CAAC,KAAK,CAAC;QACnB,uBAAuB,CAAC,IAAI,CAAC;AAC7B,QAAA,IAAI,cAAc,CAAC,OAAO,EAAE;AAC1B,YAAA,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC;AACrC,YAAA,cAAc,CAAC,OAAO,GAAG,IAAI;QAC/B;QACA,WAAW,CAAC,EAAE,CAAC;QACf,UAAU,CAAC,IAAI,CAAC;QAChB,YAAY,CAAC,KAAK,CAAC;QACnB,SAAS,CAAC,MAAM,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC;AACd,QAAA,qBAAqB,CAAC,OAAO,GAAG,EAAE;QAClC,qBAAqB,CAAC,EAAE,CAAC;IAC3B,CAAC,EAAE,EAAE,CAAC;;IAGN,MAAM,QAAQ,GAAG,WAAW,CAC1B,OAAO,WAAmB,KAAI;AAC5B,QAAA,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE;AACtB,YAAA,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,2BAA2B,CAAC;YAClD,QAAQ,CAAC,GAAG,CAAC;AACb,YAAA,UAAU,CAAC,OAAO,GAAG,GAAG,CAAC;YACzB;QACF;;QAGA,aAAa,CAAC,KAAK,CAAC;QACpB,YAAY,CAAC,KAAK,CAAC;QACnB,uBAAuB,CAAC,IAAI,CAAC;AAC7B,QAAA,qBAAqB,CAAC,OAAO,GAAG,EAAE;QACpC,qBAAqB,CAAC,EAAE,CAAC;AACvB,QAAA,IAAI,cAAc,CAAC,OAAO,EAAE;AAC1B,YAAA,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC;AACrC,YAAA,cAAc,CAAC,OAAO,GAAG,IAAI;QAC/B;QAEA,YAAY,CAAC,IAAI,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC;AAEd,QAAA,IAAI;AACF,YAAA,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,cAAc,CACpD,WAAW,EACX,WAAW,EACX,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAC/B;AAED,YAAA,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC;YAChC,UAAU,CAAC,WAAW,CAAC;;AAGvB,YAAA,MAAM,wBAAwB,CAAC,WAAW,CAAC;QAC7C;QAAE,OAAO,GAAG,EAAE;YACZ,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,GAAG,GAAG,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,QAAQ,CAAC,KAAK,CAAC;AACf,YAAA,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;YAC3B,YAAY,CAAC,KAAK,CAAC;QACrB;IACF,CAAC,EACD,CAAC,WAAW,EAAE,gBAAgB,EAAE,wBAAwB,CAAC,CAC1D;;;IAID,SAAS,CAAC,MAAK;QACb,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO;YAAE;AAElD,QAAA,MAAM,WAAW,GAAG,YAAW;AAC7B,YAAA,IAAI;AACF,gBAAA,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,OAAQ,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAQ,CAAC;gBACnF,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gDAAgD,EAAE,QAAQ,CAAC,MAAM,CAAC;AACrF,gBAAA,IAAI,QAAQ,CAAC,MAAM,KAAK,YAAY,EAAE;;AAEpC,oBAAA,IAAI,cAAc,CAAC,OAAO,EAAE;AAC1B,wBAAA,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC;AACrC,wBAAA,cAAc,CAAC,OAAO,GAAG,IAAI;oBAC/B;oBACA,YAAY,CAAC,KAAK,CAAC;oBACnB,uBAAuB,CAAC,IAAI,CAAC;;oBAE7B,aAAa,CAAC,IAAI,CAAC;gBACrB;YACF;YAAE,MAAM,EAAC;AACX,QAAA,CAAC;QAED,cAAc,CAAC,OAAO,GAAG,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC;AACvD,QAAA,OAAO,MAAK;AACV,YAAA,IAAI,cAAc,CAAC,OAAO,EAAE;AAC1B,gBAAA,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC;AACrC,gBAAA,cAAc,CAAC,OAAO,GAAG,IAAI;YAC/B;AACF,QAAA,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;;AAGrC,IAAA,MAAM,kBAAkB,GAAG,WAAW,CAAC,MAAK;AAC1C,QAAA,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC;;AAE9D,QAAA,IAAI,cAAc,CAAC,OAAO,EAAE;AAC1B,YAAA,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC;AACrC,YAAA,cAAc,CAAC,OAAO,GAAG,IAAI;QAC/B;;QAEA,YAAY,CAAC,KAAK,CAAC;QACnB,uBAAuB,CAAC,IAAI,CAAC;QAC7B,aAAa,CAAC,IAAI,CAAC;IACrB,CAAC,EAAE,EAAE,CAAC;;IAGN,MAAM,oBAAoB,GAAG,WAAW,CACtC,OAAO,UAAkB,EAAE,QAAa,KAAI;AAC1C,QAAA,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO;AAC9B,QAAA,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,GAAG;YAAE;;AAGhC,QAAA,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO;AAC7C,QAAA,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAK,UAAU,CAAC;AAC/D,QAAA,IAAI,CAAC,KAAK;YAAE;;AAGZ,QAAA,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAK,UAAU,CAAC;AACrE,QAAA,qBAAqB,CAAC,OAAO,GAAG,SAAS;QACzC,qBAAqB,CAAC,SAAS,CAAC;AAEhC,QAAA,IAAI;YACF,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,6CAA6C,EAAE,UAAU,CAAC;YAC7E,MAAM,SAAS,CAAC,OAAO,CAAC,iBAAiB,CAAC,WAAW,EAAE,GAAG,EAAE;gBAC1D,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE;AAC9D,aAAA,CAAC;;AAEF,YAAA,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE;gBAC1B,aAAa,CAAC,IAAI,CAAC;gBACnB,YAAY,CAAC,IAAI,CAAC;YACpB;QACF;QAAE,OAAO,GAAG,EAAE;YACZ,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,GAAG,GAAG,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,KAAK,CAAC;YACzE,QAAQ,CAAC,KAAK,CAAC;AACf,YAAA,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7B;AACF,IAAA,CAAC,EACD,CAAC,WAAW,CAAC,CACd;;IAGD,MAAM,gBAAgB,GAAG,WAAW,CAClC,OAAO,UAAkB,EAAE,MAAe,KAAI;QAC5C,MAAM,oBAAoB,CAAC,UAAU,EAAE;YACrC,KAAK,EAAE,MAAM,IAAI,8BAA8B;AAChD,SAAA,CAAC;AACJ,IAAA,CAAC,EACD,CAAC,oBAAoB,CAAC,CACvB;;;AAID,IAAA,MAAM,QAAQ,GAAG,WAAW,CAAC,YAAW;AACtC,QAAA,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO;QAC9B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,0CAA0C,EAAE,GAAG,CAAC;AACnE,QAAA,IAAI,SAAS,CAAC,OAAO,IAAI,GAAG,EAAE;AAC5B,YAAA,IAAI;gBACF,MAAM,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC;AAClD,gBAAA,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC;YAClE;YAAE,OAAO,GAAG,EAAE;gBACZ,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,0CAA0C,EAAE,GAAG,CAAC;YACtE;QACF;QACA,aAAa,CAAC,KAAK,CAAC;QACpB,YAAY,CAAC,KAAK,CAAC;QACnB,SAAS,CAAC,MAAM,CAAC;AACnB,IAAA,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;IAEjB,OAAO;QACL,QAAQ;QACR,OAAO;QACP,SAAS;QACT,MAAM;QACN,KAAK;QACL,SAAS;QACT,oBAAoB;QACpB,WAAW;QACX,SAAS;QACT,QAAQ;QACR,kBAAkB;QAClB,QAAQ;QACR,kBAAkB;QAClB,oBAAoB;QACpB,gBAAgB;KACjB;AACH;;;;"}

package/dist/esm/hooks/useModelInterface.d.ts

@@ -1,4 +1,16 @@
-import type { ModelInterfaceTool, ModelInterfaceToolSchema, ToolCall, ToolCallResponse, ChatMessage } from '../api/types';
+import type { ModelInterfaceTool, ModelInterfaceToolSchema, ToolCall, ToolCallResponse, ChatMessage, ResponseWidgetConfig } from '../api/types';
+export interface PendingWidgetCall {
+    toolCall: ToolCall;
+    params: any;
+    widget: ResponseWidgetConfig;
+    toolName: string;
+}
+export interface HandleToolCallsResult {
+    /** Responses ready to send back to the API (from callback-based tools) */
+    responses: ToolCallResponse[];
+    /** Tool calls that require user interaction via a response widget */
+    widgetCalls: PendingWidgetCall[];
+}
 export interface UseModelInterfaceOptions {
     /**
      * Client-side tools available for model interface protocol
@@ -27,9 +39,19 @@ export interface UseModelInterfaceResult {
      */
     isClientTool: (toolName: string) => boolean;
     /**
-     * Handle tool calls from the model, returns tool responses
+     * Check if a tool has a response widget (user-driven) instead of a callback
+     */
+    hasResponseWidget: (toolName: string) => boolean;
+    /**
+     * Get the tool definition by name
+     */
+    getTool: (toolName: string) => ModelInterfaceTool | undefined;
+    /**
+     * Handle tool calls from the model.
+     * Callback-based tools are executed immediately and their responses returned.
+     * Widget-based tools are returned as pending widget calls for user interaction.
      */
-    handleToolCalls: (toolCalls: ToolCall[]) => Promise<ToolCallResponse[]>;
+    handleToolCalls: (toolCalls: ToolCall[]) => Promise<HandleToolCallsResult>;
     /**
      * Process messages and extract pending tool calls that need client handling
      */

package/dist/esm/hooks/useModelInterface.js

@@ -44,32 +44,46 @@ function useModelInterface(options) {
     const isClientTool = useCallback((toolName) => {
         return toolMap.has(toolName);
     }, [toolMap]);
-    // Handle tool calls and execute client-side tools
+    const hasResponseWidget = useCallback((toolName) => Boolean(toolMap.get(toolName)?.responseWidget), [toolMap]);
+    const getTool = useCallback((toolName) => toolMap.get(toolName), [toolMap]);
+    // Handle tool calls: execute callback tools, queue widget tools for user input
     const handleToolCalls = useCallback(async (toolCalls) => {
         const responses = [];
+        const widgetCalls = [];
         for (const toolCall of toolCalls) {
             const toolName = toolCall.function.name;
             const tool = toolMap.get(toolName);
-            if (!tool) {
-                // Not a client-side tool, skip
+            if (!tool)
+                continue;
+            let params = {};
+            try {
+                params = JSON.parse(toolCall.function.arguments || '{}');
+            }
+            catch {
+                // Keep empty params if parsing fails
+            }
+            onToolExecute?.(toolName, params);
+            if (tool.responseWidget) {
+                widgetCalls.push({
+                    toolCall,
+                    params,
+                    widget: tool.responseWidget,
+                    toolName,
+                });
+                continue;
+            }
+            if (!tool.callback) {
+                // Neither callback nor widget — respond with error so the model can continue
+                responses.push({
+                    tool_call_id: toolCall.id,
+                    content: { error: `Tool "${toolName}" has no callback or responseWidget` },
+                    role: 'tool',
+                });
                 continue;
             }
             try {
-                // Parse arguments
-                let params = {};
-                try {
-                    params = JSON.parse(toolCall.function.arguments || '{}');
-                }
-                catch {
-                    // Keep empty params if parsing fails
-                }
-                // Notify about execution
-                onToolExecute?.(toolName, params);
-                // Execute the tool callback
                 const result = await tool.callback(params);
-                // Notify about completion
                 onToolComplete?.(toolName, result);
-                // Add response
                 responses.push({
                     tool_call_id: toolCall.id,
                     content: result,
@@ -78,9 +92,7 @@ function useModelInterface(options) {
             }
             catch (err) {
                 const error = err instanceof Error ? err : new Error(String(err));
-                // Notify about error
                 onToolError?.(toolName, error);
-                // Add error response
                 responses.push({
                     tool_call_id: toolCall.id,
                     content: { error: error.message },
@@ -88,7 +100,7 @@ function useModelInterface(options) {
                 });
             }
         }
-        return responses;
+        return { responses, widgetCalls };
     }, [toolMap, onToolExecute, onToolComplete, onToolError]);
     // Extract pending tool calls from messages that need client handling
     const extractPendingToolCalls = useCallback((messages) => {
@@ -119,6 +131,8 @@ function useModelInterface(options) {
     return {
         toolSchemas,
         isClientTool,
+        hasResponseWidget,
+        getTool,
         handleToolCalls,
         extractPendingToolCalls,
     };

package/dist/esm/hooks/useModelInterface.js.map

@@ -1 +1 @@
-{"version":3,"file":"useModelInterface.js","sources":["../../../src/hooks/useModelInterface.ts"],"sourcesContent":["import { useCallback, useMemo } from 'react';\nimport type {\n  ModelInterfaceTool,\n  ModelInterfaceToolSchema,\n  ToolCall,\n  ToolCallResponse,\n  ChatMessage,\n} from '../api/types';\n\nexport interface UseModelInterfaceOptions {\n  /**\n   * Client-side tools available for model interface protocol\n   */\n  tools: ModelInterfaceTool[];\n\n  /**\n   * Callback when a tool is being executed\n   */\n  onToolExecute?: (toolName: string, params: any) => void;\n\n  /**\n   * Callback when a tool execution completes\n   */\n  onToolComplete?: (toolName: string, result: any) => void;\n\n  /**\n   * Callback when a tool execution fails\n   */\n  onToolError?: (toolName: string, error: Error) => void;\n}\n\nexport interface UseModelInterfaceResult {\n  /**\n   * Tool schemas to send to the API\n   */\n  toolSchemas: ModelInterfaceToolSchema[];\n\n  /**\n   * Check if a tool call should be handled client-side\n   */\n  isClientTool: (toolName: string) => boolean;\n\n  /**\n   * Handle tool calls from the model, returns tool responses\n   */\n  handleToolCalls: (toolCalls: ToolCall[]) => Promise<ToolCallResponse[]>;\n\n  /**\n   * Process messages and extract pending tool calls that need client handling\n   */\n  extractPendingToolCalls: (messages: ChatMessage[]) => ToolCall[];\n}\n\n/**\n * Hook for implementing the Model Interface Protocol\n *\n * The Model Interface Protocol allows client-side tools to be executed\n * during an assistant conversation. When the model calls a client-side tool,\n * this hook handles executing the tool and preparing the response.\n *\n * @example\n * ```tsx\n * const { toolSchemas, handleToolCalls } = useModelInterface({\n *   tools: [\n *     {\n *       toolName: 'get_user_location',\n *       schema: {\n *         type: 'function',\n *         function: {\n *           name: 'get_user_location',\n *           description: 'Get user current location',\n *           parameters: { type: 'object', properties: {} }\n *         }\n *       },\n *       callback: async () => {\n *         const pos = await getCurrentPosition();\n *         return { lat: pos.coords.latitude, lng: pos.coords.longitude };\n *       }\n *     }\n *   ]\n * });\n * ```\n */\nexport function useModelInterface(\n  options: UseModelInterfaceOptions\n): UseModelInterfaceResult {\n  const { tools, onToolExecute, onToolComplete, onToolError } = options;\n\n  // Extract tool schemas for API\n  const toolSchemas = useMemo(() => {\n    return tools.map((tool) => tool.schema);\n  }, [tools]);\n\n  // Map of tool name to tool definition\n  const toolMap = useMemo(() => {\n    return new Map(tools.map((tool) => [tool.toolName, tool]));\n  }, [tools]);\n\n  // Check if a tool is a client-side tool\n  const isClientTool = useCallback(\n    (toolName: string): boolean => {\n      return toolMap.has(toolName);\n    },\n    [toolMap]\n  );\n\n  // Handle tool calls and execute client-side tools\n  const handleToolCalls = useCallback(\n    async (toolCalls: ToolCall[]): Promise<ToolCallResponse[]> => {\n      const responses: ToolCallResponse[] = [];\n\n      for (const toolCall of toolCalls) {\n        const toolName = toolCall.function.name;\n        const tool = toolMap.get(toolName);\n\n        if (!tool) {\n          // Not a client-side tool, skip\n          continue;\n        }\n\n        try {\n          // Parse arguments\n          let params: any = {};\n          try {\n            params = JSON.parse(toolCall.function.arguments || '{}');\n          } catch {\n            // Keep empty params if parsing fails\n          }\n\n          // Notify about execution\n          onToolExecute?.(toolName, params);\n\n          // Execute the tool callback\n          const result = await tool.callback(params);\n\n          // Notify about completion\n          onToolComplete?.(toolName, result);\n\n          // Add response\n          responses.push({\n            tool_call_id: toolCall.id,\n            content: result,\n            role: 'tool',\n          });\n        } catch (err) {\n          const error = err instanceof Error ? err : new Error(String(err));\n\n          // Notify about error\n          onToolError?.(toolName, error);\n\n          // Add error response\n          responses.push({\n            tool_call_id: toolCall.id,\n            content: { error: error.message },\n            role: 'tool',\n          });\n        }\n      }\n\n      return responses;\n    },\n    [toolMap, onToolExecute, onToolComplete, onToolError]\n  );\n\n  // Extract pending tool calls from messages that need client handling\n  const extractPendingToolCalls = useCallback(\n    (messages: ChatMessage[]): ToolCall[] => {\n      const pendingCalls: ToolCall[] = [];\n\n      // Look at the last assistant message\n      for (let i = messages.length - 1; i >= 0; i--) {\n        const message = messages[i];\n\n        if (message.role === 'assistant' && message.tool_calls?.length) {\n          // Filter for client-side tools only\n          const clientToolCalls = message.tool_calls.filter((tc) =>\n            isClientTool(tc.function.name)\n          );\n\n          // Check if these tool calls have been responded to\n          const respondedToolIds = new Set(\n            messages\n              .slice(i + 1)\n              .filter((m) => m.role === 'tool')\n              .map((m) => m.tool_call_id)\n          );\n\n          // Get unresponded tool calls\n          for (const tc of clientToolCalls) {\n            if (!respondedToolIds.has(tc.id)) {\n              pendingCalls.push(tc);\n            }\n          }\n\n          // Only check the most recent assistant message with tool calls\n          break;\n        }\n      }\n\n      return pendingCalls;\n    },\n    [isClientTool]\n  );\n\n  return {\n    toolSchemas,\n    isClientTool,\n    handleToolCalls,\n    extractPendingToolCalls,\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"useModelInterface.js","sources":["../../../src/hooks/useModelInterface.ts"],"sourcesContent":["import { useCallback, useMemo } from 'react';\nimport type {\n  ModelInterfaceTool,\n  ModelInterfaceToolSchema,\n  ToolCall,\n  ToolCallResponse,\n  ChatMessage,\n  ResponseWidgetConfig,\n} from '../api/types';\n\nexport interface PendingWidgetCall {\n  toolCall: ToolCall;\n  params: any;\n  widget: ResponseWidgetConfig;\n  toolName: string;\n}\n\nexport interface HandleToolCallsResult {\n  /** Responses ready to send back to the API (from callback-based tools) */\n  responses: ToolCallResponse[];\n  /** Tool calls that require user interaction via a response widget */\n  widgetCalls: PendingWidgetCall[];\n}\n\nexport interface UseModelInterfaceOptions {\n  /**\n   * Client-side tools available for model interface protocol\n   */\n  tools: ModelInterfaceTool[];\n\n  /**\n   * Callback when a tool is being executed\n   */\n  onToolExecute?: (toolName: string, params: any) => void;\n\n  /**\n   * Callback when a tool execution completes\n   */\n  onToolComplete?: (toolName: string, result: any) => void;\n\n  /**\n   * Callback when a tool execution fails\n   */\n  onToolError?: (toolName: string, error: Error) => void;\n}\n\nexport interface UseModelInterfaceResult {\n  /**\n   * Tool schemas to send to the API\n   */\n  toolSchemas: ModelInterfaceToolSchema[];\n\n  /**\n   * Check if a tool call should be handled client-side\n   */\n  isClientTool: (toolName: string) => boolean;\n\n  /**\n   * Check if a tool has a response widget (user-driven) instead of a callback\n   */\n  hasResponseWidget: (toolName: string) => boolean;\n\n  /**\n   * Get the tool definition by name\n   */\n  getTool: (toolName: string) => ModelInterfaceTool | undefined;\n\n  /**\n   * Handle tool calls from the model.\n   * Callback-based tools are executed immediately and their responses returned.\n   * Widget-based tools are returned as pending widget calls for user interaction.\n   */\n  handleToolCalls: (toolCalls: ToolCall[]) => Promise<HandleToolCallsResult>;\n\n  /**\n   * Process messages and extract pending tool calls that need client handling\n   */\n  extractPendingToolCalls: (messages: ChatMessage[]) => ToolCall[];\n}\n\n/**\n * Hook for implementing the Model Interface Protocol\n *\n * The Model Interface Protocol allows client-side tools to be executed\n * during an assistant conversation. When the model calls a client-side tool,\n * this hook handles executing the tool and preparing the response.\n *\n * @example\n * ```tsx\n * const { toolSchemas, handleToolCalls } = useModelInterface({\n *   tools: [\n *     {\n *       toolName: 'get_user_location',\n *       schema: {\n *         type: 'function',\n *         function: {\n *           name: 'get_user_location',\n *           description: 'Get user current location',\n *           parameters: { type: 'object', properties: {} }\n *         }\n *       },\n *       callback: async () => {\n *         const pos = await getCurrentPosition();\n *         return { lat: pos.coords.latitude, lng: pos.coords.longitude };\n *       }\n *     }\n *   ]\n * });\n * ```\n */\nexport function useModelInterface(\n  options: UseModelInterfaceOptions\n): UseModelInterfaceResult {\n  const { tools, onToolExecute, onToolComplete, onToolError } = options;\n\n  // Extract tool schemas for API\n  const toolSchemas = useMemo(() => {\n    return tools.map((tool) => tool.schema);\n  }, [tools]);\n\n  // Map of tool name to tool definition\n  const toolMap = useMemo(() => {\n    return new Map(tools.map((tool) => [tool.toolName, tool]));\n  }, [tools]);\n\n  // Check if a tool is a client-side tool\n  const isClientTool = useCallback(\n    (toolName: string): boolean => {\n      return toolMap.has(toolName);\n    },\n    [toolMap]\n  );\n\n  const hasResponseWidget = useCallback(\n    (toolName: string): boolean => Boolean(toolMap.get(toolName)?.responseWidget),\n    [toolMap]\n  );\n\n  const getTool = useCallback(\n    (toolName: string): ModelInterfaceTool | undefined => toolMap.get(toolName),\n    [toolMap]\n  );\n\n  // Handle tool calls: execute callback tools, queue widget tools for user input\n  const handleToolCalls = useCallback(\n    async (toolCalls: ToolCall[]): Promise<HandleToolCallsResult> => {\n      const responses: ToolCallResponse[] = [];\n      const widgetCalls: PendingWidgetCall[] = [];\n\n      for (const toolCall of toolCalls) {\n        const toolName = toolCall.function.name;\n        const tool = toolMap.get(toolName);\n\n        if (!tool) continue;\n\n        let params: any = {};\n        try {\n          params = JSON.parse(toolCall.function.arguments || '{}');\n        } catch {\n          // Keep empty params if parsing fails\n        }\n\n        onToolExecute?.(toolName, params);\n\n        if (tool.responseWidget) {\n          widgetCalls.push({\n            toolCall,\n            params,\n            widget: tool.responseWidget,\n            toolName,\n          });\n          continue;\n        }\n\n        if (!tool.callback) {\n          // Neither callback nor widget — respond with error so the model can continue\n          responses.push({\n            tool_call_id: toolCall.id,\n            content: { error: `Tool \"${toolName}\" has no callback or responseWidget` },\n            role: 'tool',\n          });\n          continue;\n        }\n\n        try {\n          const result = await tool.callback(params);\n          onToolComplete?.(toolName, result);\n          responses.push({\n            tool_call_id: toolCall.id,\n            content: result,\n            role: 'tool',\n          });\n        } catch (err) {\n          const error = err instanceof Error ? err : new Error(String(err));\n          onToolError?.(toolName, error);\n          responses.push({\n            tool_call_id: toolCall.id,\n            content: { error: error.message },\n            role: 'tool',\n          });\n        }\n      }\n\n      return { responses, widgetCalls };\n    },\n    [toolMap, onToolExecute, onToolComplete, onToolError]\n  );\n\n  // Extract pending tool calls from messages that need client handling\n  const extractPendingToolCalls = useCallback(\n    (messages: ChatMessage[]): ToolCall[] => {\n      const pendingCalls: ToolCall[] = [];\n\n      // Look at the last assistant message\n      for (let i = messages.length - 1; i >= 0; i--) {\n        const message = messages[i];\n\n        if (message.role === 'assistant' && message.tool_calls?.length) {\n          // Filter for client-side tools only\n          const clientToolCalls = message.tool_calls.filter((tc) =>\n            isClientTool(tc.function.name)\n          );\n\n          // Check if these tool calls have been responded to\n          const respondedToolIds = new Set(\n            messages\n              .slice(i + 1)\n              .filter((m) => m.role === 'tool')\n              .map((m) => m.tool_call_id)\n          );\n\n          // Get unresponded tool calls\n          for (const tc of clientToolCalls) {\n            if (!respondedToolIds.has(tc.id)) {\n              pendingCalls.push(tc);\n            }\n          }\n\n          // Only check the most recent assistant message with tool calls\n          break;\n        }\n      }\n\n      return pendingCalls;\n    },\n    [isClientTool]\n  );\n\n  return {\n    toolSchemas,\n    isClientTool,\n    hasResponseWidget,\n    getTool,\n    handleToolCalls,\n    extractPendingToolCalls,\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -1,5 +1,5 @@
 export { DevicProvider, DevicContext, useDevicContext, useOptionalDevicContext } from './provider';
-export type { DevicProviderConfig, DevicProviderProps, DevicContextValue } from './provider';
+export type { DevicProviderConfig, DevicProviderProps, DevicContextValue, AIReference, DrawerRegistration, } from './provider';
 export { ChatDrawer, ChatMessages, ChatInput, ToolTimeline, ConversationSelector, HandoffSubagentWidget } from './components/ChatDrawer';
 export type { ChatDrawerProps, ChatDrawerOptions, ChatDrawerHandle, ChatMessagesProps, ChatInputProps, CustomPromptBoxProps, ToolTimelineProps, AllowedFileTypes, ConversationSelectorProps, HandoffSubagentWidgetProps, SuggestedMessage, } from './components/ChatDrawer';
 export { ThreadStateTag } from './components/ThreadStateTag';
@@ -8,12 +8,14 @@ export { AICommandBar, useAICommandBar, formatShortcut } from './components/AICo
 export type { AICommandBarProps, AICommandBarOptions, AICommandBarHandle, AICommandBarCommand, CommandBarResult, ToolCallSummary, } from './components/AICommandBar';
 export { AIGenerationButton, useAIGenerationButton } from './components/AIGenerationButton';
 export type { AIGenerationButtonProps, AIGenerationButtonOptions, AIGenerationButtonHandle, AIGenerationButtonMode, GenerationResult, } from './components/AIGenerationButton';
+export { AIElementWrapper, useAIElementWrapper } from './components/AIElementWrapper';
+export type { AIElementWrapperProps, AIElementWrapperOptions, AIElementWrapperHandle, AIElementWrapperBehavior, AIElementWrapperShowOn, AIElementWrapperPlacement, } from './components/AIElementWrapper';
 export { useDevicChat, usePolling, useModelInterface } from './hooks';
-export type { UseDevicChatOptions, UseDevicChatResult, UsePollingOptions, UsePollingResult, UseModelInterfaceOptions, UseModelInterfaceResult, } from './hooks';
+export type { UseDevicChatOptions, UseDevicChatResult, UsePollingOptions, UsePollingResult, UseModelInterfaceOptions, UseModelInterfaceResult, PendingWidgetCall, HandleToolCallsResult, } from './hooks';
 export { DevicApiClient, DevicApiError } from './api/client';
 export type { DevicApiClientConfig } from './api/client';
 export { AgentThreadState, } from './api/types';
-export type { ChatMessage, ChatFile, MessageContent, ToolCall, ToolCallResponse, ProcessMessageDto, AssistantResponse, AsyncResponse, RealtimeChatHistory, RealtimeStatus, ChatHistory, AssistantSpecialization, ModelInterfaceTool, ModelInterfaceToolSchema, PreviousMessage, ApiError, ConversationSummary, FeedbackSubmission, FeedbackEntry, AgentThreadDto, AgentTaskDto, AgentDto, HandOffToolResponse, ToolGroupCall, ToolGroupConfig, } from './api/types';
+export type { ChatMessage, ChatFile, MessageContent, ToolCall, ToolCallResponse, ProcessMessageDto, AssistantResponse, AsyncResponse, RealtimeChatHistory, RealtimeStatus, ChatHistory, AssistantSpecialization, ModelInterfaceTool, ModelInterfaceToolSchema, ResponseWidgetProps, ResponseWidgetConfig, PreviousMessage, ApiError, ConversationSummary, FeedbackSubmission, FeedbackEntry, AgentThreadDto, AgentTaskDto, AgentDto, HandOffToolResponse, ToolGroupCall, ToolGroupConfig, } from './api/types';
 export { MessageActions, FeedbackModal } from './components/Feedback';
 export type { MessageActionsProps, FeedbackModalProps, FeedbackState, FeedbackTheme } from './components/Feedback';
 export { generateId, deepMerge, debounce, throttle, formatFileSize, storage, segmentToolCalls } from './utils';

package/dist/esm/index.js

@@ -11,6 +11,8 @@ export { AICommandBar } from './components/AICommandBar/AICommandBar.js';
 export { formatShortcut, useAICommandBar } from './components/AICommandBar/useAICommandBar.js';
 export { AIGenerationButton } from './components/AIGenerationButton/AIGenerationButton.js';
 export { useAIGenerationButton } from './components/AIGenerationButton/useAIGenerationButton.js';
+export { AIElementWrapper } from './components/AIElementWrapper/AIElementWrapper.js';
+export { useAIElementWrapper } from './components/AIElementWrapper/useAIElementWrapper.js';
 export { useDevicChat } from './hooks/useDevicChat.js';
 export { usePolling } from './hooks/usePolling.js';
 export { useModelInterface } from './hooks/useModelInterface.js';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;"}