@devicai/ui 0.62.3 → 0.62.4

package/dist/cjs/hooks/useModelInterface.js

@@ -2,6 +2,76 @@
 
 var React = require('react');
 
+/**
+ * How long a call to a tool this client does not have is given to show up
+ * before it is answered as unavailable. Tools come and go with the screen the
+ * user is on, and the screen the model has just navigated to may not have
+ * registered its own yet.
+ */
+const UNAVAILABLE_TOOL_GRACE_MS = 5000;
+const UNAVAILABLE_TOOL_CHECK_MS = 250;
+/**
+ * The answer to a call for a client-side tool this client does not have loaded
+ * — typically one registered by a screen the user has since left.
+ *
+ * Answering is the point. The API holds the conversation in
+ * `waiting_for_tool_response` until every call it handed to the client is
+ * answered, and nothing else will answer this one: the run never resumes, and
+ * every later message is refused or parked behind it.
+ */
+function unavailableToolResponse(toolCall) {
+    return {
+        tool_call_id: toolCall.id,
+        content: {
+            error: `Tool "${toolCall.function.name}" is not available: the application no longer offers it in its current context (the user may have moved to another screen). Do not call it again unless it is offered again.`,
+            errorType: 'TOOL_UNAVAILABLE',
+        },
+        role: 'tool',
+    };
+}
+/**
+ * The calls still unanswered in the most recent assistant message that made
+ * any, narrowed to the ones `include` accepts.
+ */
+function unansweredToolCalls(messages, include) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const message = messages[i];
+        if (message.role !== 'assistant' || !message.tool_calls?.length)
+            continue;
+        const answered = new Set(messages
+            .slice(i + 1)
+            .filter((m) => m.role === 'tool')
+            .map((m) => m.tool_call_id));
+        return message.tool_calls.filter((toolCall) => include(toolCall) && !answered.has(toolCall.id));
+    }
+    return [];
+}
+/**
+ * The tool calls a client owes an answer to, given a realtime snapshot.
+ *
+ * While a run is going, only the calls to the client's own tools are its
+ * business: anything else in the same message is a backend tool the run is
+ * still executing. Once the API reports `waiting_for_tool_response` the backend
+ * has done its part — it runs its own tools before pausing — so every call
+ * still unanswered is waiting on the client, including one to a tool that is
+ * no longer loaded. Those are returned too, so they can be answered as
+ * unavailable instead of blocking the conversation.
+ *
+ * The exception is a backend tool that answers asynchronously: the
+ * conversation waits on it as well, but the answer comes from an external
+ * system, and the API lists it in `pendingAsyncToolCalls`.
+ */
+function resolvePendingToolCalls(data, isClientTool) {
+    if (data.pendingToolCalls)
+        return data.pendingToolCalls;
+    const messages = data.chatHistory ?? [];
+    if (data.status !== 'waiting_for_tool_response') {
+        return unansweredToolCalls(messages, (toolCall) => isClientTool(toolCall.function.name));
+    }
+    const answeredElsewhere = new Set((data.pendingAsyncToolCalls ?? []).map((call) => call.toolCallId));
+    return unansweredToolCalls(messages, (toolCall) => !answeredElsewhere.has(toolCall.id));
+}
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 /**
  * Hook for implementing the Model Interface Protocol
  *
@@ -33,7 +103,7 @@ var React = require('react');
  * ```
  */
 function useModelInterface(options) {
-    const { tools, onToolExecute, onToolComplete, onToolError } = options;
+    const { tools, onToolExecute, onToolComplete, onToolError, unavailableToolGraceMs = UNAVAILABLE_TOOL_GRACE_MS, } = options;
     // Extract tool schemas for API
     const toolSchemas = React.useMemo(() => {
         return tools.map((tool) => tool.schema);
@@ -42,6 +112,12 @@ function useModelInterface(options) {
     const toolMap = React.useMemo(() => {
         return new Map(tools.map((tool) => [tool.toolName, tool]));
     }, [tools]);
+    // The tools as of the latest render: a call waiting for a tool to appear
+    // has to see the ones registered after it started.
+    const toolMapRef = React.useRef(toolMap);
+    toolMapRef.current = toolMap;
+    const toolSchemasRef = React.useRef(toolSchemas);
+    toolSchemasRef.current = toolSchemas;
     // Check if a tool is a client-side tool
     const isClientTool = React.useCallback((toolName) => {
         return toolMap.has(toolName);
@@ -52,11 +128,8 @@ function useModelInterface(options) {
     const handleToolCalls = React.useCallback(async (toolCalls) => {
         const responses = [];
         const widgetCalls = [];
-        for (const toolCall of toolCalls) {
+        const handle = async (toolCall, tool) => {
             const toolName = toolCall.function.name;
-            const tool = toolMap.get(toolName);
-            if (!tool)
-                continue;
             let params = {};
             try {
                 params = JSON.parse(toolCall.function.arguments || '{}');
@@ -72,7 +145,7 @@ function useModelInterface(options) {
                     widget: tool.responseWidget,
                     toolName,
                 });
-                continue;
+                return;
             }
             if (!tool.callback) {
                 // Neither callback nor widget — respond with error so the model can continue
@@ -81,7 +154,7 @@ function useModelInterface(options) {
                     content: { error: `Tool "${toolName}" has no callback or responseWidget` },
                     role: 'tool',
                 });
-                continue;
+                return;
             }
             try {
                 const result = await tool.callback(params);
@@ -101,35 +174,34 @@ function useModelInterface(options) {
                     role: 'tool',
                 });
             }
+        };
+        const missing = [];
+        for (const toolCall of toolCalls) {
+            const tool = toolMapRef.current.get(toolCall.function.name);
+            if (tool)
+                await handle(toolCall, tool);
+            else
+                missing.push(toolCall);
         }
-        return { responses, widgetCalls };
-    }, [toolMap, onToolExecute, onToolComplete, onToolError]);
-    // Extract pending tool calls from messages that need client handling
-    const extractPendingToolCalls = React.useCallback((messages) => {
-        const pendingCalls = [];
-        // Look at the last assistant message
-        for (let i = messages.length - 1; i >= 0; i--) {
-            const message = messages[i];
-            if (message.role === 'assistant' && message.tool_calls?.length) {
-                // Filter for client-side tools only
-                const clientToolCalls = message.tool_calls.filter((tc) => isClientTool(tc.function.name));
-                // Check if these tool calls have been responded to
-                const respondedToolIds = new Set(messages
-                    .slice(i + 1)
-                    .filter((m) => m.role === 'tool')
-                    .map((m) => m.tool_call_id));
-                // Get unresponded tool calls
-                for (const tc of clientToolCalls) {
-                    if (!respondedToolIds.has(tc.id)) {
-                        pendingCalls.push(tc);
-                    }
-                }
-                // Only check the most recent assistant message with tool calls
-                break;
+        if (missing.length > 0) {
+            const allLoaded = () => missing.every((toolCall) => toolMapRef.current.has(toolCall.function.name));
+            const deadline = Date.now() + unavailableToolGraceMs;
+            while (!allLoaded() && Date.now() < deadline) {
+                await sleep(Math.min(UNAVAILABLE_TOOL_CHECK_MS, deadline - Date.now()));
+            }
+            for (const toolCall of missing) {
+                const tool = toolMapRef.current.get(toolCall.function.name);
+                if (tool)
+                    await handle(toolCall, tool);
+                else
+                    responses.push(unavailableToolResponse(toolCall));
             }
         }
-        return pendingCalls;
-    }, [isClientTool]);
+        return { responses, widgetCalls, toolSchemas: toolSchemasRef.current };
+    }, [onToolExecute, onToolComplete, onToolError, unavailableToolGraceMs]);
+    // Extract pending tool calls from messages that need client handling
+    const extractPendingToolCalls = React.useCallback((messages) => unansweredToolCalls(messages, (toolCall) => isClientTool(toolCall.function.name)), [isClientTool]);
+    const resolvePending = React.useCallback((data) => resolvePendingToolCalls(data, isClientTool), [isClientTool]);
     return {
         toolSchemas,
         isClientTool,
@@ -137,8 +209,12 @@ function useModelInterface(options) {
         getTool,
         handleToolCalls,
         extractPendingToolCalls,
+        resolvePendingToolCalls: resolvePending,
     };
 }
 
+exports.UNAVAILABLE_TOOL_GRACE_MS = UNAVAILABLE_TOOL_GRACE_MS;
+exports.resolvePendingToolCalls = resolvePendingToolCalls;
+exports.unavailableToolResponse = unavailableToolResponse;
 exports.useModelInterface = useModelInterface;
 //# sourceMappingURL=useModelInterface.js.map

package/dist/cjs/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  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":["useMemo","useCallback"],"mappings":"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"}
+{"version":3,"file":"useModelInterface.js","sources":["../../../../src/hooks/useModelInterface.ts"],"sourcesContent":["import { useCallback, useMemo, useRef } from 'react';\nimport type {\n  ModelInterfaceTool,\n  ModelInterfaceToolSchema,\n  ToolCall,\n  ToolCallResponse,\n  ChatMessage,\n  RealtimeChatHistory,\n  ResponseWidgetConfig,\n} from '../api/types';\n\n/**\n * How long a call to a tool this client does not have is given to show up\n * before it is answered as unavailable. Tools come and go with the screen the\n * user is on, and the screen the model has just navigated to may not have\n * registered its own yet.\n */\nexport const UNAVAILABLE_TOOL_GRACE_MS = 5_000;\nconst UNAVAILABLE_TOOL_CHECK_MS = 250;\n\n/**\n * The answer to a call for a client-side tool this client does not have loaded\n * — typically one registered by a screen the user has since left.\n *\n * Answering is the point. The API holds the conversation in\n * `waiting_for_tool_response` until every call it handed to the client is\n * answered, and nothing else will answer this one: the run never resumes, and\n * every later message is refused or parked behind it.\n */\nexport function unavailableToolResponse(toolCall: ToolCall): ToolCallResponse {\n  return {\n    tool_call_id: toolCall.id,\n    content: {\n      error: `Tool \"${toolCall.function.name}\" is not available: the application no longer offers it in its current context (the user may have moved to another screen). Do not call it again unless it is offered again.`,\n      errorType: 'TOOL_UNAVAILABLE',\n    },\n    role: 'tool',\n  };\n}\n\n/**\n * The calls still unanswered in the most recent assistant message that made\n * any, narrowed to the ones `include` accepts.\n */\nfunction unansweredToolCalls(\n  messages: ChatMessage[],\n  include: (toolCall: ToolCall) => boolean\n): ToolCall[] {\n  for (let i = messages.length - 1; i >= 0; i--) {\n    const message = messages[i];\n    if (message.role !== 'assistant' || !message.tool_calls?.length) continue;\n\n    const answered = new Set(\n      messages\n        .slice(i + 1)\n        .filter((m) => m.role === 'tool')\n        .map((m) => m.tool_call_id)\n    );\n    return message.tool_calls.filter(\n      (toolCall) => include(toolCall) && !answered.has(toolCall.id)\n    );\n  }\n  return [];\n}\n\n/**\n * The tool calls a client owes an answer to, given a realtime snapshot.\n *\n * While a run is going, only the calls to the client's own tools are its\n * business: anything else in the same message is a backend tool the run is\n * still executing. Once the API reports `waiting_for_tool_response` the backend\n * has done its part — it runs its own tools before pausing — so every call\n * still unanswered is waiting on the client, including one to a tool that is\n * no longer loaded. Those are returned too, so they can be answered as\n * unavailable instead of blocking the conversation.\n *\n * The exception is a backend tool that answers asynchronously: the\n * conversation waits on it as well, but the answer comes from an external\n * system, and the API lists it in `pendingAsyncToolCalls`.\n */\nexport function resolvePendingToolCalls(\n  data: Pick<\n    RealtimeChatHistory,\n    'status' | 'chatHistory' | 'pendingToolCalls' | 'pendingAsyncToolCalls'\n  >,\n  isClientTool: (toolName: string) => boolean\n): ToolCall[] {\n  if (data.pendingToolCalls) return data.pendingToolCalls;\n\n  const messages = data.chatHistory ?? [];\n  if (data.status !== 'waiting_for_tool_response') {\n    return unansweredToolCalls(messages, (toolCall) =>\n      isClientTool(toolCall.function.name)\n    );\n  }\n\n  const answeredElsewhere = new Set(\n    (data.pendingAsyncToolCalls ?? []).map((call) => call.toolCallId)\n  );\n  return unansweredToolCalls(\n    messages,\n    (toolCall) => !answeredElsewhere.has(toolCall.id)\n  );\n}\n\nconst sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));\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   * The tool schemas on offer once the calls were handled — what to restate\n   * alongside the responses. It can differ from the ones at the start of the\n   * call when the tools changed while an unavailable one was being waited for.\n   */\n  toolSchemas: ModelInterfaceToolSchema[];\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  /**\n   * How long (ms) a call to a tool that is not loaded waits for it to appear\n   * before it is answered as unavailable.\n   * @default 5000\n   */\n  unavailableToolGraceMs?: number;\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   * A call to a tool that is not loaded waits `unavailableToolGraceMs` for it to\n   * appear, and is otherwise answered as unavailable.\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   * The tool calls this client owes an answer to in a realtime snapshot: its\n   * own pending calls, plus — while the API waits for a tool response — calls\n   * to tools it does not have loaded, which must still be answered.\n   */\n  resolvePendingToolCalls: (data: RealtimeChatHistory) => 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 {\n    tools,\n    onToolExecute,\n    onToolComplete,\n    onToolError,\n    unavailableToolGraceMs = UNAVAILABLE_TOOL_GRACE_MS,\n  } = 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  // The tools as of the latest render: a call waiting for a tool to appear\n  // has to see the ones registered after it started.\n  const toolMapRef = useRef(toolMap);\n  toolMapRef.current = toolMap;\n  const toolSchemasRef = useRef(toolSchemas);\n  toolSchemasRef.current = toolSchemas;\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      const handle = async (toolCall: ToolCall, tool: ModelInterfaceTool) => {\n        const toolName = toolCall.function.name;\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          return;\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          return;\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      const missing: ToolCall[] = [];\n      for (const toolCall of toolCalls) {\n        const tool = toolMapRef.current.get(toolCall.function.name);\n        if (tool) await handle(toolCall, tool);\n        else missing.push(toolCall);\n      }\n\n      if (missing.length > 0) {\n        const allLoaded = () =>\n          missing.every((toolCall) => toolMapRef.current.has(toolCall.function.name));\n        const deadline = Date.now() + unavailableToolGraceMs;\n        while (!allLoaded() && Date.now() < deadline) {\n          await sleep(Math.min(UNAVAILABLE_TOOL_CHECK_MS, deadline - Date.now()));\n        }\n\n        for (const toolCall of missing) {\n          const tool = toolMapRef.current.get(toolCall.function.name);\n          if (tool) await handle(toolCall, tool);\n          else responses.push(unavailableToolResponse(toolCall));\n        }\n      }\n\n      return { responses, widgetCalls, toolSchemas: toolSchemasRef.current };\n    },\n    [onToolExecute, onToolComplete, onToolError, unavailableToolGraceMs]\n  );\n\n  // Extract pending tool calls from messages that need client handling\n  const extractPendingToolCalls = useCallback(\n    (messages: ChatMessage[]): ToolCall[] =>\n      unansweredToolCalls(messages, (toolCall) => isClientTool(toolCall.function.name)),\n    [isClientTool]\n  );\n\n  const resolvePending = useCallback(\n    (data: RealtimeChatHistory): ToolCall[] => resolvePendingToolCalls(data, isClientTool),\n    [isClientTool]\n  );\n\n  return {\n    toolSchemas,\n    isClientTool,\n    hasResponseWidget,\n    getTool,\n    handleToolCalls,\n    extractPendingToolCalls,\n    resolvePendingToolCalls: resolvePending,\n  };\n}\n"],"names":["useMemo","useRef","useCallback"],"mappings":"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"}

package/dist/esm/api/types.d.ts

@@ -376,6 +376,16 @@ export interface CoreMemorySnapshot {
     chars: number;
     timestampMs: number;
 }
+/** A backend tool call waiting on an external system for its result. */
+export interface PendingAsyncToolCall {
+    toolCallId: string;
+    toolName: string;
+    sentAt: number;
+    resolved: boolean;
+    resolvedAt?: number;
+    /** Where the external system posts the result. */
+    callbackUrl?: string;
+}
 /**
  * Real-time chat history response
  */
@@ -388,6 +398,12 @@ export interface RealtimeChatHistory {
     status: RealtimeStatus;
     lastUpdatedAt: number;
     pendingToolCalls?: ToolCall[];
+    /**
+     * Backend tools whose result an external system posts later. They hold the
+     * conversation in `waiting_for_tool_response` too, but they are not the
+     * client's to answer.
+     */
+    pendingAsyncToolCalls?: PendingAsyncToolCall[];
     handedOffSubThreadId?: string;
     /** Present only when status is `limit_exceeded`. */
     limitExceeded?: TenantLimitExceeded;

package/dist/esm/api/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../../src/api/types.ts"],"sourcesContent":["import type { AvatarStyle } from '../utils/avatar';\n\nimport type React from 'react';\n\n/**\n * File attachment for messages\n */\nexport interface ChatFile {\n  name: string;\n  downloadUrl?: string;\n  fileType?: 'image' | 'document' | 'audio' | 'video' | 'other';\n}\n\n/**\n * Attachment as it appears on a message.\n *\n * Two shapes reach the UI for the same thing: the optimistic message built\n * locally on send uses `url`/`type`, while the history returned by the API\n * carries the stored `downloadUrl`/`fileType`. Both are accepted here; use\n * `normalizeMessageFile` before reading them.\n */\nexport interface MessageFile {\n  name: string;\n  url?: string;\n  type?: string;\n  downloadUrl?: string;\n  fileType?: string;\n}\n\n/**\n * Message content structure\n */\nexport interface MessageContent {\n  /**\n   * The message text.\n   *\n   * Declared as a string because that is what it is for every role a reader\n   * cares about, but do not trust it blindly on a `guard_rail` message:\n   * conversations stopped by a guardrail before the backend fix carry the raw\n   * provider result object here instead. Guard a `typeof x === 'string'` check\n   * around anything that treats it as text.\n   */\n  message?: string;\n  data?: any;\n  files?: MessageFile[];\n}\n\n/** Collapse either attachment shape into a single one the UI can render. */\nexport function normalizeMessageFile(file: MessageFile): {\n  name: string;\n  url: string;\n  type: string;\n} {\n  return {\n    name: file.name,\n    url: file.url || file.downloadUrl || '',\n    type: file.type || file.fileType || 'other',\n  };\n}\n\n/**\n * Tool call from the model\n */\nexport interface ToolCall {\n  id: string;\n  type: 'function';\n  function: {\n    name: string;\n    arguments: string;\n  };\n}\n\n/**\n * Chat message structure\n */\nexport interface ChatMessage {\n  uid: string;\n  role: 'user' | 'assistant' | 'developer' | 'system' | 'tool' | 'guard_rail';\n  content: MessageContent;\n  timestamp: number;\n  chatUid?: string;\n  tool_calls?: ToolCall[];\n  tool_call_id?: string;\n  summary?: string;\n  /**\n   * Where `content.message` came from, when the model did not write it.\n   * `'finish_tool'`: the assistant is configured to require a tool call to\n   * finish (\"Require Tool Use to Finish\") and the backend lifted the reply from\n   * the finish tool's `message` argument, so it can be read without parsing\n   * tool calls. Absent on replies the model wrote itself — use it to label the\n   * bubble as produced by the tool.\n   */\n  contentSource?: string;\n  /**\n   * Id of a speech-to-text transcript (from POST /api/v1/whisper) that seeded\n   * this message. Present on user messages dictated by voice; the chat can use\n   * it to fetch the source audio (GET /api/v1/whisper/:transcriptId) and offer\n   * playback.\n   */\n  transcriptId?: string;\n  /**\n   * Original server uid, present when the UI adopted an optimistic uid for\n   * this message to keep React keys stable. Server-side references (e.g.\n   * memory recall anchors) match against it.\n   */\n  serverUid?: string;\n  /**\n   * Client-side only: the conversation was busy when this message was sent, so\n   * it was accepted into the queue and is waiting its turn. Drawn as a message\n   * that has not landed rather than as part of the conversation. Falls away on\n   * its own once the message comes back inside the history.\n   */\n  queued?: boolean;\n  /**\n   * Client-side only: when this message was accepted into the queue. Used to\n   * tell \"the server has not reported it yet\" from \"the server no longer has\n   * it\", which the timestamp is the only honest way to decide.\n   */\n  queuedAt?: number;\n}\n\n/**\n * Previous conversation message for initialization\n */\nexport interface PreviousMessage {\n  message: string;\n  role: 'user' | 'assistant';\n}\n\n/**\n * Model interface tool schema following OpenAI function calling format\n */\nexport interface ModelInterfaceToolSchema {\n  type: 'function';\n  function: {\n    name: string;\n    description: string;\n    parameters: {\n      type: 'object';\n      properties: Record<string, any>;\n      required?: string[];\n    };\n  };\n}\n\n/**\n * Props passed to a response widget component.\n * The widget is responsible for collecting the user's response and\n * calling `submit` with the payload to resolve the tool call.\n */\nexport interface ResponseWidgetProps {\n  /** The tool call this widget is responding to */\n  toolCall: ToolCall;\n  /** Parsed arguments from the tool call */\n  params: any;\n  /** Submit the tool response payload (sent as the tool call result to the model) */\n  submit: (response: any) => void;\n  /** Cancel the tool call. Sends an error response so the model can continue. */\n  cancel?: (reason?: string) => void;\n  /** Whether the widget is currently submitting */\n  isSubmitting?: boolean;\n}\n\n/**\n * Interactive response widget configuration for a client-side tool.\n *\n * When the model calls a tool configured with a `responseWidget`, the\n * widget is rendered in the chat UI instead of executing a callback.\n * The user interacts with the widget, which calls `submit(response)` to\n * define the tool response sent back to the model.\n *\n * - `render: 'inline'` renders the widget in the message thread at the\n *   position of the tool call. The text input remains enabled.\n * - `render: 'input'` replaces the chat input area with the widget\n *   while it is pending. The text input is disabled until submission.\n */\nexport interface ResponseWidgetConfig {\n  /** Where to render the widget */\n  render: 'inline' | 'input';\n  /** The widget component */\n  component: React.ComponentType<ResponseWidgetProps>;\n}\n\n/**\n * Model interface tool definition for client-side tools.\n *\n * A tool must provide either a `callback` (executed automatically when\n * the model invokes the tool) or a `responseWidget` (renders UI for\n * the user to produce the tool response). Providing both is an error.\n */\nexport interface ModelInterfaceTool {\n  toolName: string;\n  schema: ModelInterfaceToolSchema;\n  /** Executed automatically when the model calls this tool */\n  callback?: (params: any) => Promise<any> | any;\n  /** Interactive widget that collects the user's tool response */\n  responseWidget?: ResponseWidgetConfig;\n}\n\n/**\n * Tool call response to send back to the API\n */\nexport interface ToolCallResponse {\n  tool_call_id: string;\n  content: any;\n  role: 'tool';\n  /**\n   * The client-side tools still on offer for the rest of the turn. The API\n   * reads them off the first response of the batch: leaving them out drops\n   * the tools from the continuation, so the model cannot call them again.\n   */\n  tools?: ModelInterfaceToolSchema[];\n}\n\n/**\n * DTO for sending messages to the assistant\n */\nexport interface ProcessMessageDto {\n  disabledIntegrations?: string[];\n  message: string;\n  chatUid?: string;\n  userName?: string;\n  files?: ChatFile[];\n  /** Tags to associate with this chat (top-level, distinct from `metadata`). */\n  tags?: string[];\n  metadata?: {\n    promptTemplateParams?: Record<string, any>;\n    tenantToken?: string;\n    [key: string]: any;\n  };\n  tenantId?: string;\n  subtenantId?: string;\n  previousConversation?: PreviousMessage[];\n  enabledTools?: string[];\n  provider?: string;\n  model?: string;\n  // Model interface protocol fields\n  tools?: ModelInterfaceToolSchema[];\n  applicationState?: Record<string, any>;\n  skipSummarization?: boolean;\n  /**\n   * Id of a speech-to-text transcript (from POST /api/v1/whisper) that seeded\n   * this message. Sent so the conversation keeps a link to the original audio.\n   */\n  transcriptId?: string;\n}\n\n/**\n * Response from the /whisper speech-to-text endpoint.\n */\nexport interface WhisperTranscriptionResponse {\n  /** Public id of the transcript; send it back as ProcessMessageDto.transcriptId. */\n  transcriptId: string;\n  /** Transcribed text. */\n  text: string;\n  /** Language hint used, if any. */\n  language?: string;\n  /** Download URL of the source audio. */\n  audioUrl?: string;\n  /** Transcription model used. */\n  model?: string;\n}\n\n/**\n * Response from the assistant\n */\nexport interface AssistantResponse {\n  messages: ChatMessage[];\n  chatUid: string;\n  inputTokens?: number;\n  outputTokens?: number;\n}\n\n/**\n * Async mode response\n */\nexport interface AsyncResponse {\n  chatUid: string;\n  message?: string;\n  error?: string;\n  /**\n   * The conversation could not take the message right now, so it was queued\n   * instead of starting a run of its own. Still an acceptance: the answer comes\n   * later, and may cover several messages at once.\n   */\n  queued?: boolean;\n  /** How many messages are queued on this conversation, this one included. */\n  queuePosition?: number;\n  /** When the queued message reaches the model. */\n  willProcess?: QueueDisposition;\n}\n\n/**\n * When a queued message will reach the model.\n *\n * `after_delay` is the one that is not about being busy: an idle conversation\n * on an assistant with an input delay collects what is written during the\n * window, so a message can come back queued with nothing in flight at all.\n */\nexport type QueueDisposition = 'after_delay' | 'next_turn' | 'on_resume';\n\n/** Response of the stop endpoint. */\nexport interface StopChatResponse {\n  chatUid: string;\n  message: string;\n  /**\n   * Queued messages the stop threw away — answering them would be the opposite\n   * of what was asked. Handed back so their text can be put where the user\n   * wrote it. Absent on an API older than this, and when nothing was queued.\n   */\n  discardedMessages?: ChatMessage[];\n}\n\n/**\n * Real-time chat history status.\n * `limit_exceeded` means the message was blocked before reaching the LLM\n * because a configured tenant/subtenant usage limit was reached.\n */\nexport type RealtimeStatus =\n  | 'processing'\n  | 'completed'\n  | 'error'\n  | 'waiting_for_tool_response'\n  | 'handed_off'\n  | 'limit_exceeded'\n  /** Collecting messages during the assistant's input delay, before any run. */\n  | 'buffering';\n\n/**\n * Details of a tenant/subtenant usage limit that blocked a message.\n * Returned on the realtime endpoint when status is `limit_exceeded`, and on\n * the HTTP 429 body (`details`) when a synchronous request is blocked.\n */\nexport interface TenantLimitExceeded {\n  /** Human-readable message describing the block. */\n  message?: string;\n  /** The rule that triggered the block (scope, metric, window, limit…). */\n  blockingRule?: {\n    scope?: 'tenant' | 'subtenant';\n    subtenantId?: string;\n    metric?: 'tokens' | 'cost';\n    windowUnit?: 'hour' | 'day' | 'week' | 'month';\n    windowEvery?: number;\n    limit?: number;\n  };\n  /** Current consumption in the blocking window. */\n  current?: number;\n  /** The limit that was reached. */\n  limit?: number;\n  /** Epoch ms when the blocking window resets and usage is allowed again. */\n  resetsAt?: number;\n}\n\n/** One fact a long-term-memory recall surfaced. */\nexport interface RecalledMemoryFact {\n  fact: string;\n  relation: string;\n  /** Source entity name of the graph edge, when the fact connects two. */\n  source: string | null;\n  /** Target entity name of the graph edge, when the fact connects two. */\n  target: string | null;\n  /** ISO date the fact became valid, if known. */\n  validAt: string | null;\n}\n\n/** One graph entity a long-term-memory recall surfaced. */\nexport interface RecalledMemoryEntity {\n  id: string;\n  name: string;\n  type: string;\n  summary: string | null;\n}\n\n/** One previous-session turn a conversation-start recall carried over. */\nexport interface RecalledMemoryTurn {\n  role: string;\n  content: string;\n}\n\n/**\n * One structured long-term-memory recall event of a conversation: the facts,\n * entities and previous-session turns a recall surfaced, plus the uid of the\n * message that brought it in (`messageUid`: the initial user message, or the\n * assistant message carrying the memory tool call — resolvable through\n * `toolCallId` while the run is still in flight).\n */\nexport interface RecalledMemoryRecord {\n  uid: string;\n  messageUid?: string;\n  toolCallId?: string;\n  source:\n    | 'conversation_start'\n    | 'search_memory'\n    | 'search_memory_nodes'\n    | 'explore_memory_graph';\n  query?: string;\n  facts?: RecalledMemoryFact[];\n  entities?: RecalledMemoryEntity[];\n  turns?: RecalledMemoryTurn[];\n  timestampMs: number;\n}\n\n/**\n * Snapshot of the core-memory block a conversation saw (audit trail): the\n * render revision plus the injected entries as structured items.\n */\nexport interface CoreMemorySnapshot {\n  uid: string;\n  revision: string;\n  items: Array<{\n    id: number;\n    section: string;\n    content: string;\n    pinned: boolean;\n    source: string;\n  }>;\n  entries: number;\n  omitted: number;\n  chars: number;\n  timestampMs: number;\n}\n\n/**\n * Real-time chat history response\n */\nexport interface RealtimeChatHistory {\n  /** Ephemeral provider output; never persisted or treated as a tool call. */\n  streamingMessage?: ChatMessage;\n  chatUID: string;\n  clientUID: string;\n  chatHistory: ChatMessage[];\n  status: RealtimeStatus;\n  lastUpdatedAt: number;\n  pendingToolCalls?: ToolCall[];\n  handedOffSubThreadId?: string;\n  /** Present only when status is `limit_exceeded`. */\n  limitExceeded?: TenantLimitExceeded;\n  /**\n   * Memory-recall events of the in-flight run — lets the UI show what the\n   * assistant is recalling while the response is still processing.\n   */\n  recalledMemories?: RecalledMemoryRecord[];\n  /**\n   * Messages accepted into this conversation that the model has not seen yet.\n   * Non-zero means more is coming: a `completed` status with messages still\n   * queued is not the end of the exchange.\n   */\n  queuedMessages?: number;\n  /**\n   * The queued messages themselves. This is the conversation's queue, not the\n   * caller's — it can include messages the same conversation received through\n   * another channel. Absent on an API that does not return them, in which case\n   * the widget falls back to its own optimistic copies.\n   */\n  pendingUserMessages?: ChatMessage[];\n  /**\n   * Compaction checkpoints of the in-flight run. A conversation that compacts\n   * mid-run stops sending the messages above the cut immediately, so these\n   * arrive here before they are persisted on the conversation.\n   */\n  compactions?: CompactionCheckpoint[];\n  /** The compaction running right now, if any. */\n  compaction?: CompactionActivity;\n}\n\n/**\n * A single usage rule with its current consumption (from GET\n * /api/v1/tenant-usage/:tenantId[/subtenants/:subtenantId]).\n */\nexport interface TenantUsageRule {\n  scope: 'tenant' | 'subtenant';\n  subtenantId?: string;\n  metric: 'tokens' | 'cost';\n  windowUnit: 'hour' | 'day' | 'week' | 'month';\n  windowEvery: number;\n  /** Configured limit for the window. */\n  limit: number;\n  /** Current consumption in the active window. */\n  current: number;\n  /** Utilization percentage (0..100, capped). */\n  percent: number;\n  /** Epoch ms when the active window resets. */\n  resetsAt?: number;\n  /** Where the rule comes from ('tier' | 'adhoc'). */\n  origin?: string;\n  /** Tier the rule belongs to, if any. */\n  tierId?: string;\n}\n\n/**\n * Response of GET /api/v1/tenant-usage/:tenantId[/subtenants/:subtenantId]:\n * the effective usage rules with their current consumption + the active tier.\n */\nexport interface TenantUsage {\n  tenantId: string;\n  subtenantId?: string;\n  tierId?: string;\n  usage: TenantUsageRule[];\n}\n\n/**\n * A durable per-window usage history row (from GET\n * /api/v1/tenant-usage/:tenantId/history).\n */\nexport interface TenantUsageHistoryRow {\n  clientUID: string;\n  tenantId: string;\n  subtenantId: string;\n  scope: 'tenant' | 'subtenant';\n  metric: 'tokens' | 'cost';\n  windowUnit: 'hour' | 'day' | 'week' | 'month';\n  windowEvery: number;\n  windowKey: string;\n  windowStart: number;\n  windowEnd: number;\n  /** Counted consumption (enforced). */\n  consumption: number;\n  /** Exempt consumption that did not count toward the limit, if any. */\n  exemptConsumption?: number;\n  limit: number;\n  percent: number;\n  tierId?: string;\n  origin?: string;\n  capturedAt: number;\n}\n\n/**\n * Options for querying tenant usage history.\n */\nexport interface TenantUsageHistoryQuery {\n  subtenantId?: string;\n  scope?: 'tenant' | 'subtenant';\n  metric?: 'tokens' | 'cost';\n  windowUnit?: 'hour' | 'day' | 'week' | 'month';\n  /** Epoch ms lower bound (windowEnd >= from). */\n  from?: number;\n  /** Epoch ms upper bound (windowEnd <= to). */\n  to?: number;\n  limit?: number;\n  skip?: number;\n}\n\n/**\n * Chat history structure\n */\n/** A concrete value carried verbatim through a compaction. */\nexport interface CompactionFact {\n  kind: string;\n  value: string;\n  label?: string;\n}\n\n/** The structured body a compaction produced. */\nexport interface CompactionSummary {\n  goal?: string;\n  constraints?: string[];\n  inProgress?: string;\n  pending?: string[];\n  decisions?: string[];\n  data?: Array<{ label: string; value: string }>;\n  done?: string[];\n  openQuestions?: string[];\n  /** Fallback when the model answered without structure. */\n  raw?: string;\n}\n\n/**\n * One compaction of a conversation: the messages before its boundary folded\n * into a written summary plus the identifiers, paths and urls lifted out of\n * them verbatim. From then on the model receives the checkpoint instead of\n * those messages — which are still in the conversation, and still shown.\n *\n * Only the newest checkpoint is in force: each compaction merges the previous\n * summary into itself.\n */\nexport interface CompactionCheckpoint {\n  uid: string;\n  /** 1 for the first compaction of the conversation, 2 for the next… */\n  index: number;\n  timestampMs: number;\n  trigger: 'auto' | 'manual';\n  /** First message that still travels verbatim. */\n  firstKeptMessageUid?: string;\n  /** Last folded message: where the widget belongs in the conversation. */\n  anchorMessageUid?: string;\n  compactedMessageCount: number;\n  summary: CompactionSummary;\n  facts: CompactionFact[];\n  tokensBefore: number;\n  tokensAfter: number;\n  provider?: string;\n  model?: string;\n  cost?: number;\n}\n\n/**\n * A compaction happening right now, from the realtime endpoint.\n *\n * A compaction is a model call of its own, taken between two assistant\n * messages, so a client that only knows `processing` shows a conversation\n * that appears to have stalled for a few seconds. Present while it runs and\n * on the single update that reports it finished.\n */\nexport interface CompactionActivity {\n  state: 'running' | 'completed';\n  startedAt: number;\n  /**\n   * What this pass is folding: the messages new since the last checkpoint.\n   * Not the conversation's totals — a checkpoint's own\n   * `compactedMessageCount` and `tokensBefore` are cumulative across every\n   * compaction, so the two are on different scales and must not be paired.\n   */\n  messageCount: number;\n  tokensBefore: number;\n  /** Which checkpoint the pass produced, once it is done. */\n  index?: number;\n  finishedAt?: number;\n}\n\nexport interface ChatHistory {\n  chatUID: string;\n  clientUID: string;\n  userUID: string;\n  chatContent: ChatMessage[];\n  name?: string;\n  assistantSpecializationIdentifier: string;\n  creationTimestampMs: number;\n  lastEditTimestampMs?: number;\n  llm?: string;\n  inputTokens?: number;\n  outputTokens?: number;\n  metadata?: Record<string, any>;\n  tenantId?: string;\n  handedOff?: boolean;\n  handedOffSubThreadId?: string;\n  handedOffToolCallId?: string;\n  /** Structured long-term-memory recall events of the conversation. */\n  recalledMemories?: RecalledMemoryRecord[];\n  /** Audit trail of the core-memory blocks the conversation saw. */\n  coreMemories?: CoreMemorySnapshot[];\n  /** Compaction checkpoints of the conversation, oldest first. */\n  compactions?: CompactionCheckpoint[];\n}\n\n/** One core memory entry (the always-injected tier), as returned by the memory API. */\nexport interface CoreMemoryEntry {\n  id: number;\n  section: string;\n  content: string;\n  source: string;\n  pinned: boolean;\n  supersedes: number | null;\n  archivedAt: string | null;\n  createdAt?: string;\n  updatedAt?: string;\n}\n\n/** Deployment caps of the core memory tier. */\nexport interface CoreMemoryLimits {\n  maxChars: number;\n  maxEntries: number;\n  maxEntryChars: number;\n}\n\n/**\n * Response of GET /api/v1/memory/assistants/:identifier/core — the entries\n * of the bucket the assistant resolves for a tenant/subtenant combination.\n */\nexport interface CoreMemoryList {\n  /** False when the assistant does not have the core memory tier enabled. */\n  enabled: boolean;\n  /** The resolved bucket tuple (tenant/subtenant/owner dimensions). */\n  bucket: { tenantId?: string; subtenantId?: string; entityId?: string };\n  entries: CoreMemoryEntry[];\n  limits?: CoreMemoryLimits;\n}\n\n/**\n * Assistant specialization info\n */\nexport interface AssistantSpecialization {\n  liveVoice?: import('./liveVoice.types').LiveVoiceConfiguration;\n  identifier: string;\n  name: string;\n  description: string;\n  state: 'active' | 'inactive' | 'coming_soon';\n  imgUrl?: string;\n  /** Pinned style of the generated avatar shown when there is no imgUrl. */\n  avatarStyle?: AvatarStyle;\n  availableToolsGroups?: Array<{\n    name: string;\n    description?: string;\n    uid?: string;\n    iconUrl?: string;\n    tools?: Array<{\n      name: string;\n      description: string;\n    }>;\n  }>;\n  model?: string;\n  isCustom?: boolean;\n  creationTimestampMs?: number;\n  /**\n   * Whether this assistant offers MCP servers of the tenant's own.\n   *\n   * Same contract as `tenantIntegrations` below, absence included.\n   */\n  tenantMcpServers?: {\n    enabled: boolean;\n    /** Servers listed ready to connect. Says nothing about how many are connected. */\n    count?: number;\n  };\n  /**\n   * Whether this assistant offers connected apps to its tenants.\n   *\n   * **Absent means \"cannot tell\", not \"no\"** — an API older than this field\n   * says nothing, and treating silence as a no would hide the connected-apps\n   * button from anyone whose deployment has not caught up yet.\n   */\n  tenantIntegrations?: {\n    enabled: boolean;\n    /**\n     * How many apps the catalogue offers. An upper bound — the listing drops\n     * any the provider cannot resolve — and enough to size a placeholder.\n     */\n    count?: number;\n  };\n  /**\n   * Whether this assistant accepts messages sent while the conversation is\n   * busy, queueing them instead of refusing them.\n   *\n   * **Absent means no**, unlike `tenantIntegrations` above. Promising a queue\n   * that does not exist is paid for with a 409 and with the user's text left in\n   * the air, so silence is read as the safe answer rather than as the open one.\n   */\n  messageQueueEnabled?: boolean;\n  /** How many messages may wait at once before further sends are refused. */\n  maxQueuedMessages?: number;\n}\n\n/**\n * Summary of a conversation for listing\n */\nexport interface ConversationSummary {\n  chatUID: string;\n  name?: string;\n  creationTimestampMs: number;\n  lastEditTimestampMs?: number;\n}\n\nexport interface ListConversationsResponse {\n  histories: ConversationSummary[];\n  total: number;\n  offset: number;\n  limit: number;\n}\n\n/**\n * API error response\n */\nexport interface ApiError {\n  statusCode: number;\n  message: string;\n  error?: string;\n  /** Optional structured details (e.g. usage-limit blocking info on a 429). */\n  details?: any;\n}\n\n/**\n * Feedback submission request\n */\nexport interface FeedbackSubmission {\n  messageId: string;\n  feedback?: boolean;\n  feedbackComment?: string;\n  feedbackData?: Record<string, any>;\n}\n\n/**\n * Feedback entry response\n */\nexport interface FeedbackEntry {\n  _id: string;\n  requestId: string;\n  chatUID?: string;\n  threadId?: string;\n  agentId?: string;\n  feedback?: boolean;\n  feedbackComment?: string;\n  feedbackData?: Record<string, any>;\n  creationTimestamp: string;\n  lastEditTimestamp?: string;\n}\n\n/**\n * Agent thread states\n */\nexport enum AgentThreadState {\n  QUEUED = 'queued',\n  PROCESSING = 'processing',\n  COMPLETED = 'completed',\n  FAILED = 'failed',\n  TERMINATED = 'terminated',\n  PAUSED = 'paused',\n  PAUSED_FOR_APPROVAL = 'paused_for_approval',\n  APPROVAL_REJECTED = 'approval_rejected',\n  WAITING_FOR_RESPONSE = 'waiting_for_response',\n  PAUSED_FOR_RESUME = 'paused_for_resume',\n  HANDED_OFF = 'handed_off',\n  GUARDRAIL_TRIGGER = 'guardrail_trigger',\n}\n\n/**\n * Task within an agent thread\n */\nexport interface AgentTaskDto {\n  _id?: string;\n  title?: string;\n  description?: string;\n  completed: boolean;\n}\n\n/**\n * Agent thread DTO\n */\nexport interface AgentThreadDto {\n  _id?: string;\n  agentId: string;\n  state: AgentThreadState;\n  threadContent: ChatMessage[];\n  tasks?: AgentTaskDto[];\n  finishReason?: string;\n  pausedReason?: string;\n  name?: string;\n  creationTimestampMs?: number;\n  lastEditTimestampMs?: number;\n  pauseUntil?: number;\n  isSubthread?: boolean;\n  parentThreadId?: string;\n  subThreadToolCallId?: string;\n  parentAgentId?: string;\n}\n\n/**\n * Agent details\n */\nexport interface AgentDto {\n  _id?: string;\n  name: string;\n  description?: string;\n  imgUrl?: string;\n  /** Pinned style of the generated avatar shown when there is no imgUrl. */\n  avatarStyle?: AvatarStyle;\n  agentId?: string;\n}\n\n/**\n * Hand-off tool response content\n */\nexport interface HandOffToolResponse {\n  response: string;\n  subthreadId: string;\n}\n\n/**\n * Represents a single tool call within a tool group\n */\nexport interface ToolGroupCall {\n  name: string;\n  input: any;\n  output: any;\n  toolCallId: string;\n}\n\n/**\n * Configuration for grouping consecutive tool calls under a single renderer\n */\nexport interface ToolGroupConfig {\n  tools: string[];\n  renderer: (calls: ToolGroupCall[]) => React.ReactNode;\n}\n\n/**\n * One of the end user's connected accounts for an app.\n *\n * The provider's own identifiers do not travel here beyond `id`, which the\n * client needs in order to name the account it wants disconnected — and which\n * the server re-checks against the caller's tenant on the way back in.\n */\nexport interface IntegrationAccount {\n  id: string;\n  status: string;\n  connectedAt?: string;\n  updatedAt?: string;\n  /** True when the account exists but can no longer run tools. */\n  needsReconnect?: boolean;\n  statusReason?: string;\n}\n\n/**\n * One value the end user is asked for before an account can be connected —\n * their API key, the subdomain of their instance.\n *\n * Comes from the provider's own catalogue, so the form is rendered from this\n * rather than from anything app-specific: most apps do not authenticate with\n * credentials Devic holds, and there are hundreds of them.\n */\nexport interface IntegrationAuthField {\n  name: string;\n  label: string;\n  type: string;\n  required: boolean;\n  description?: string;\n  /** Prefilled — usually a provider endpoint most accounts should keep. */\n  default?: string;\n  /** Mask it on screen. */\n  secret: boolean;\n}\n\n/**\n * One way of connecting an app.\n *\n * `redirect` schemes send the user to the provider; the rest are connected\n * with the values they type, without ever leaving the page.\n *\n * There is deliberately no field for the *application's* credentials: the\n * OAuth application belongs to the developer who embedded this widget, is\n * registered once for every tenant, and is never the end user's to supply.\n */\nexport interface IntegrationAuthScheme {\n  /** The provider's own name for it: `OAUTH2`, `API_KEY`, … */\n  mode: string;\n  /** Credentials for this scheme are held for you — nothing to fill in. */\n  composioManaged: boolean;\n  redirect: boolean;\n  /** What this account supplies. Empty for a scheme that asks nothing. */\n  accountFields: IntegrationAuthField[];\n  /** The provider's own setup guide, when there is one. */\n  guideUrl?: string;\n}\n\n/**\n * The answer when connecting needs values that were not sent.\n *\n * `stage` decides who can act on it: `account` is the end user, and the form\n * asks them. `app` is the developer's OAuth application, which the end user\n * cannot register — so that case is shown as \"not available yet\" instead of a\n * form asking a stranger for someone else's client secret.\n */\nexport interface IntegrationSetupRequired {\n  code: \"INTEGRATION_SETUP_REQUIRED\";\n  message: string;\n  toolkit: string;\n  authScheme: string;\n  stage: \"app\" | \"account\";\n  fields: IntegrationAuthField[];\n  guideUrl?: string;\n}\n\n/**\n * An app the assistant offers to its tenants, with the accounts THIS tenant\n * has connected. Never another tenant's.\n */\nexport interface Integration {\n  /** App slug, e.g. `gmail`. */\n  app: string;\n  name: string;\n  description?: string;\n  logo?: string;\n  /** True when at least one account is active. */\n  connected: boolean;\n  accounts: IntegrationAccount[];\n  /** Event types the developer allows this tenant to switch on. */\n  availableTriggers?: string[];\n}\n\n// ── MCP servers the end user connects for themselves ──────────────────────\n\nexport type TenantMcpAuthMode = \"oauth\" | \"header\" | \"none\";\n\n/** One of the end user's own MCP connections. */\nexport interface TenantMcpConnection {\n  id: string;\n  /**\n   * What to put in `disabledIntegrations` to have this server sit a message\n   * out. Sent by the API so the prefix that separates it from an app slug lives\n   * on the server, in one place.\n   */\n  toggleId?: string;\n  name?: string;\n  url: string;\n  /** The developer's template this came from, when it came from one. */\n  templateId?: string;\n  authMode?: TenantMcpAuthMode;\n  status: \"pending_auth\" | \"active\" | \"error\";\n  toolCount?: number;\n  tools?: string[];\n  lastProbeStatus?: string;\n  lastProbeError?: string;\n  lastProbeTimestampMs?: number;\n  /** Connected for the whole tenant, so every end user of it shares this. */\n  shared: boolean;\n  /** True when this end user may use it but not change or remove it. */\n  readOnly: boolean;\n}\n\n/**\n * One row of the MCP panel: either a server the developer offers ready to\n * connect, or one this end user added.\n *\n * A single list rather than two, because that is what the panel draws — keeping\n * \"offered\" and \"connected\" apart would leave them out of step for a moment\n * after every connect.\n */\nexport interface TenantMcpServer {\n  source: \"template\" | \"custom\";\n  templateId?: string;\n  name: string;\n  url: string;\n  description?: string;\n  logoUrl?: string;\n  authMode?: TenantMcpAuthMode;\n  /** Header the credential travels in, for `header` servers. */\n  headerName?: string;\n  /** Whether the end user may supply their own OAuth application. */\n  allowClientCredentials?: boolean;\n  /** Null until this tenant connects it. */\n  connection: TenantMcpConnection | null;\n}\n\nexport interface TenantMcpListing {\n  offered: boolean;\n  /** Whether adding a server of one's own is permitted. */\n  allowCustom: boolean;\n  limits: { maxServers: number; maxToolsPerServer: number; used: number };\n  servers: TenantMcpServer[];\n}\n\n/** Credentials the end user supplies when connecting a server. */\nexport interface TenantMcpAuthInput {\n  mode?: TenantMcpAuthMode;\n  headerName?: string;\n  headerValue?: string;\n  upstreamOAuth?: { clientId?: string; clientSecret?: string; scopes?: string[] };\n}\n\n/**\n * What connecting answers with.\n *\n * `status: \"active\"` means it is done. `authorizationUrl` must be opened in a\n * popup. `requiresClientCredentials` means the server has no dynamic client\n * registration and the end user has to register an OAuth application with it\n * themselves, authorising `callbackUrl` as the redirect URI.\n */\nexport interface TenantMcpConnectResult {\n  id: string;\n  status: \"pending_auth\" | \"active\" | \"error\";\n  toolCount?: number;\n  authorizationUrl?: string;\n  requiresClientCredentials?: boolean;\n  callbackUrl?: string;\n  error?: string;\n}\n"],"names":[],"mappings":"AA+CA;AACM,SAAU,oBAAoB,CAAC,IAAiB,EAAA;IAKpD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE;QACvC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO;KAC5C;AACH;AAguBA;;AAEG;IACS;AAAZ,CAAA,UAAY,gBAAgB,EAAA;AAC1B,IAAA,gBAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;AACjB,IAAA,gBAAA,CAAA,YAAA,CAAA,GAAA,YAAyB;AACzB,IAAA,gBAAA,CAAA,WAAA,CAAA,GAAA,WAAuB;AACvB,IAAA,gBAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;AACjB,IAAA,gBAAA,CAAA,YAAA,CAAA,GAAA,YAAyB;AACzB,IAAA,gBAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;AACjB,IAAA,gBAAA,CAAA,qBAAA,CAAA,GAAA,qBAA2C;AAC3C,IAAA,gBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAuC;AACvC,IAAA,gBAAA,CAAA,sBAAA,CAAA,GAAA,sBAA6C;AAC7C,IAAA,gBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAuC;AACvC,IAAA,gBAAA,CAAA,YAAA,CAAA,GAAA,YAAyB;AACzB,IAAA,gBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAuC;AACzC,CAAC,EAbW,gBAAgB,KAAhB,gBAAgB,GAAA,EAAA,CAAA,CAAA;;;;"}
+{"version":3,"file":"types.js","sources":["../../../src/api/types.ts"],"sourcesContent":["import type { AvatarStyle } from '../utils/avatar';\n\nimport type React from 'react';\n\n/**\n * File attachment for messages\n */\nexport interface ChatFile {\n  name: string;\n  downloadUrl?: string;\n  fileType?: 'image' | 'document' | 'audio' | 'video' | 'other';\n}\n\n/**\n * Attachment as it appears on a message.\n *\n * Two shapes reach the UI for the same thing: the optimistic message built\n * locally on send uses `url`/`type`, while the history returned by the API\n * carries the stored `downloadUrl`/`fileType`. Both are accepted here; use\n * `normalizeMessageFile` before reading them.\n */\nexport interface MessageFile {\n  name: string;\n  url?: string;\n  type?: string;\n  downloadUrl?: string;\n  fileType?: string;\n}\n\n/**\n * Message content structure\n */\nexport interface MessageContent {\n  /**\n   * The message text.\n   *\n   * Declared as a string because that is what it is for every role a reader\n   * cares about, but do not trust it blindly on a `guard_rail` message:\n   * conversations stopped by a guardrail before the backend fix carry the raw\n   * provider result object here instead. Guard a `typeof x === 'string'` check\n   * around anything that treats it as text.\n   */\n  message?: string;\n  data?: any;\n  files?: MessageFile[];\n}\n\n/** Collapse either attachment shape into a single one the UI can render. */\nexport function normalizeMessageFile(file: MessageFile): {\n  name: string;\n  url: string;\n  type: string;\n} {\n  return {\n    name: file.name,\n    url: file.url || file.downloadUrl || '',\n    type: file.type || file.fileType || 'other',\n  };\n}\n\n/**\n * Tool call from the model\n */\nexport interface ToolCall {\n  id: string;\n  type: 'function';\n  function: {\n    name: string;\n    arguments: string;\n  };\n}\n\n/**\n * Chat message structure\n */\nexport interface ChatMessage {\n  uid: string;\n  role: 'user' | 'assistant' | 'developer' | 'system' | 'tool' | 'guard_rail';\n  content: MessageContent;\n  timestamp: number;\n  chatUid?: string;\n  tool_calls?: ToolCall[];\n  tool_call_id?: string;\n  summary?: string;\n  /**\n   * Where `content.message` came from, when the model did not write it.\n   * `'finish_tool'`: the assistant is configured to require a tool call to\n   * finish (\"Require Tool Use to Finish\") and the backend lifted the reply from\n   * the finish tool's `message` argument, so it can be read without parsing\n   * tool calls. Absent on replies the model wrote itself — use it to label the\n   * bubble as produced by the tool.\n   */\n  contentSource?: string;\n  /**\n   * Id of a speech-to-text transcript (from POST /api/v1/whisper) that seeded\n   * this message. Present on user messages dictated by voice; the chat can use\n   * it to fetch the source audio (GET /api/v1/whisper/:transcriptId) and offer\n   * playback.\n   */\n  transcriptId?: string;\n  /**\n   * Original server uid, present when the UI adopted an optimistic uid for\n   * this message to keep React keys stable. Server-side references (e.g.\n   * memory recall anchors) match against it.\n   */\n  serverUid?: string;\n  /**\n   * Client-side only: the conversation was busy when this message was sent, so\n   * it was accepted into the queue and is waiting its turn. Drawn as a message\n   * that has not landed rather than as part of the conversation. Falls away on\n   * its own once the message comes back inside the history.\n   */\n  queued?: boolean;\n  /**\n   * Client-side only: when this message was accepted into the queue. Used to\n   * tell \"the server has not reported it yet\" from \"the server no longer has\n   * it\", which the timestamp is the only honest way to decide.\n   */\n  queuedAt?: number;\n}\n\n/**\n * Previous conversation message for initialization\n */\nexport interface PreviousMessage {\n  message: string;\n  role: 'user' | 'assistant';\n}\n\n/**\n * Model interface tool schema following OpenAI function calling format\n */\nexport interface ModelInterfaceToolSchema {\n  type: 'function';\n  function: {\n    name: string;\n    description: string;\n    parameters: {\n      type: 'object';\n      properties: Record<string, any>;\n      required?: string[];\n    };\n  };\n}\n\n/**\n * Props passed to a response widget component.\n * The widget is responsible for collecting the user's response and\n * calling `submit` with the payload to resolve the tool call.\n */\nexport interface ResponseWidgetProps {\n  /** The tool call this widget is responding to */\n  toolCall: ToolCall;\n  /** Parsed arguments from the tool call */\n  params: any;\n  /** Submit the tool response payload (sent as the tool call result to the model) */\n  submit: (response: any) => void;\n  /** Cancel the tool call. Sends an error response so the model can continue. */\n  cancel?: (reason?: string) => void;\n  /** Whether the widget is currently submitting */\n  isSubmitting?: boolean;\n}\n\n/**\n * Interactive response widget configuration for a client-side tool.\n *\n * When the model calls a tool configured with a `responseWidget`, the\n * widget is rendered in the chat UI instead of executing a callback.\n * The user interacts with the widget, which calls `submit(response)` to\n * define the tool response sent back to the model.\n *\n * - `render: 'inline'` renders the widget in the message thread at the\n *   position of the tool call. The text input remains enabled.\n * - `render: 'input'` replaces the chat input area with the widget\n *   while it is pending. The text input is disabled until submission.\n */\nexport interface ResponseWidgetConfig {\n  /** Where to render the widget */\n  render: 'inline' | 'input';\n  /** The widget component */\n  component: React.ComponentType<ResponseWidgetProps>;\n}\n\n/**\n * Model interface tool definition for client-side tools.\n *\n * A tool must provide either a `callback` (executed automatically when\n * the model invokes the tool) or a `responseWidget` (renders UI for\n * the user to produce the tool response). Providing both is an error.\n */\nexport interface ModelInterfaceTool {\n  toolName: string;\n  schema: ModelInterfaceToolSchema;\n  /** Executed automatically when the model calls this tool */\n  callback?: (params: any) => Promise<any> | any;\n  /** Interactive widget that collects the user's tool response */\n  responseWidget?: ResponseWidgetConfig;\n}\n\n/**\n * Tool call response to send back to the API\n */\nexport interface ToolCallResponse {\n  tool_call_id: string;\n  content: any;\n  role: 'tool';\n  /**\n   * The client-side tools still on offer for the rest of the turn. The API\n   * reads them off the first response of the batch: leaving them out drops\n   * the tools from the continuation, so the model cannot call them again.\n   */\n  tools?: ModelInterfaceToolSchema[];\n}\n\n/**\n * DTO for sending messages to the assistant\n */\nexport interface ProcessMessageDto {\n  disabledIntegrations?: string[];\n  message: string;\n  chatUid?: string;\n  userName?: string;\n  files?: ChatFile[];\n  /** Tags to associate with this chat (top-level, distinct from `metadata`). */\n  tags?: string[];\n  metadata?: {\n    promptTemplateParams?: Record<string, any>;\n    tenantToken?: string;\n    [key: string]: any;\n  };\n  tenantId?: string;\n  subtenantId?: string;\n  previousConversation?: PreviousMessage[];\n  enabledTools?: string[];\n  provider?: string;\n  model?: string;\n  // Model interface protocol fields\n  tools?: ModelInterfaceToolSchema[];\n  applicationState?: Record<string, any>;\n  skipSummarization?: boolean;\n  /**\n   * Id of a speech-to-text transcript (from POST /api/v1/whisper) that seeded\n   * this message. Sent so the conversation keeps a link to the original audio.\n   */\n  transcriptId?: string;\n}\n\n/**\n * Response from the /whisper speech-to-text endpoint.\n */\nexport interface WhisperTranscriptionResponse {\n  /** Public id of the transcript; send it back as ProcessMessageDto.transcriptId. */\n  transcriptId: string;\n  /** Transcribed text. */\n  text: string;\n  /** Language hint used, if any. */\n  language?: string;\n  /** Download URL of the source audio. */\n  audioUrl?: string;\n  /** Transcription model used. */\n  model?: string;\n}\n\n/**\n * Response from the assistant\n */\nexport interface AssistantResponse {\n  messages: ChatMessage[];\n  chatUid: string;\n  inputTokens?: number;\n  outputTokens?: number;\n}\n\n/**\n * Async mode response\n */\nexport interface AsyncResponse {\n  chatUid: string;\n  message?: string;\n  error?: string;\n  /**\n   * The conversation could not take the message right now, so it was queued\n   * instead of starting a run of its own. Still an acceptance: the answer comes\n   * later, and may cover several messages at once.\n   */\n  queued?: boolean;\n  /** How many messages are queued on this conversation, this one included. */\n  queuePosition?: number;\n  /** When the queued message reaches the model. */\n  willProcess?: QueueDisposition;\n}\n\n/**\n * When a queued message will reach the model.\n *\n * `after_delay` is the one that is not about being busy: an idle conversation\n * on an assistant with an input delay collects what is written during the\n * window, so a message can come back queued with nothing in flight at all.\n */\nexport type QueueDisposition = 'after_delay' | 'next_turn' | 'on_resume';\n\n/** Response of the stop endpoint. */\nexport interface StopChatResponse {\n  chatUid: string;\n  message: string;\n  /**\n   * Queued messages the stop threw away — answering them would be the opposite\n   * of what was asked. Handed back so their text can be put where the user\n   * wrote it. Absent on an API older than this, and when nothing was queued.\n   */\n  discardedMessages?: ChatMessage[];\n}\n\n/**\n * Real-time chat history status.\n * `limit_exceeded` means the message was blocked before reaching the LLM\n * because a configured tenant/subtenant usage limit was reached.\n */\nexport type RealtimeStatus =\n  | 'processing'\n  | 'completed'\n  | 'error'\n  | 'waiting_for_tool_response'\n  | 'handed_off'\n  | 'limit_exceeded'\n  /** Collecting messages during the assistant's input delay, before any run. */\n  | 'buffering';\n\n/**\n * Details of a tenant/subtenant usage limit that blocked a message.\n * Returned on the realtime endpoint when status is `limit_exceeded`, and on\n * the HTTP 429 body (`details`) when a synchronous request is blocked.\n */\nexport interface TenantLimitExceeded {\n  /** Human-readable message describing the block. */\n  message?: string;\n  /** The rule that triggered the block (scope, metric, window, limit…). */\n  blockingRule?: {\n    scope?: 'tenant' | 'subtenant';\n    subtenantId?: string;\n    metric?: 'tokens' | 'cost';\n    windowUnit?: 'hour' | 'day' | 'week' | 'month';\n    windowEvery?: number;\n    limit?: number;\n  };\n  /** Current consumption in the blocking window. */\n  current?: number;\n  /** The limit that was reached. */\n  limit?: number;\n  /** Epoch ms when the blocking window resets and usage is allowed again. */\n  resetsAt?: number;\n}\n\n/** One fact a long-term-memory recall surfaced. */\nexport interface RecalledMemoryFact {\n  fact: string;\n  relation: string;\n  /** Source entity name of the graph edge, when the fact connects two. */\n  source: string | null;\n  /** Target entity name of the graph edge, when the fact connects two. */\n  target: string | null;\n  /** ISO date the fact became valid, if known. */\n  validAt: string | null;\n}\n\n/** One graph entity a long-term-memory recall surfaced. */\nexport interface RecalledMemoryEntity {\n  id: string;\n  name: string;\n  type: string;\n  summary: string | null;\n}\n\n/** One previous-session turn a conversation-start recall carried over. */\nexport interface RecalledMemoryTurn {\n  role: string;\n  content: string;\n}\n\n/**\n * One structured long-term-memory recall event of a conversation: the facts,\n * entities and previous-session turns a recall surfaced, plus the uid of the\n * message that brought it in (`messageUid`: the initial user message, or the\n * assistant message carrying the memory tool call — resolvable through\n * `toolCallId` while the run is still in flight).\n */\nexport interface RecalledMemoryRecord {\n  uid: string;\n  messageUid?: string;\n  toolCallId?: string;\n  source:\n    | 'conversation_start'\n    | 'search_memory'\n    | 'search_memory_nodes'\n    | 'explore_memory_graph';\n  query?: string;\n  facts?: RecalledMemoryFact[];\n  entities?: RecalledMemoryEntity[];\n  turns?: RecalledMemoryTurn[];\n  timestampMs: number;\n}\n\n/**\n * Snapshot of the core-memory block a conversation saw (audit trail): the\n * render revision plus the injected entries as structured items.\n */\nexport interface CoreMemorySnapshot {\n  uid: string;\n  revision: string;\n  items: Array<{\n    id: number;\n    section: string;\n    content: string;\n    pinned: boolean;\n    source: string;\n  }>;\n  entries: number;\n  omitted: number;\n  chars: number;\n  timestampMs: number;\n}\n\n/** A backend tool call waiting on an external system for its result. */\nexport interface PendingAsyncToolCall {\n  toolCallId: string;\n  toolName: string;\n  sentAt: number;\n  resolved: boolean;\n  resolvedAt?: number;\n  /** Where the external system posts the result. */\n  callbackUrl?: string;\n}\n\n/**\n * Real-time chat history response\n */\nexport interface RealtimeChatHistory {\n  /** Ephemeral provider output; never persisted or treated as a tool call. */\n  streamingMessage?: ChatMessage;\n  chatUID: string;\n  clientUID: string;\n  chatHistory: ChatMessage[];\n  status: RealtimeStatus;\n  lastUpdatedAt: number;\n  pendingToolCalls?: ToolCall[];\n  /**\n   * Backend tools whose result an external system posts later. They hold the\n   * conversation in `waiting_for_tool_response` too, but they are not the\n   * client's to answer.\n   */\n  pendingAsyncToolCalls?: PendingAsyncToolCall[];\n  handedOffSubThreadId?: string;\n  /** Present only when status is `limit_exceeded`. */\n  limitExceeded?: TenantLimitExceeded;\n  /**\n   * Memory-recall events of the in-flight run — lets the UI show what the\n   * assistant is recalling while the response is still processing.\n   */\n  recalledMemories?: RecalledMemoryRecord[];\n  /**\n   * Messages accepted into this conversation that the model has not seen yet.\n   * Non-zero means more is coming: a `completed` status with messages still\n   * queued is not the end of the exchange.\n   */\n  queuedMessages?: number;\n  /**\n   * The queued messages themselves. This is the conversation's queue, not the\n   * caller's — it can include messages the same conversation received through\n   * another channel. Absent on an API that does not return them, in which case\n   * the widget falls back to its own optimistic copies.\n   */\n  pendingUserMessages?: ChatMessage[];\n  /**\n   * Compaction checkpoints of the in-flight run. A conversation that compacts\n   * mid-run stops sending the messages above the cut immediately, so these\n   * arrive here before they are persisted on the conversation.\n   */\n  compactions?: CompactionCheckpoint[];\n  /** The compaction running right now, if any. */\n  compaction?: CompactionActivity;\n}\n\n/**\n * A single usage rule with its current consumption (from GET\n * /api/v1/tenant-usage/:tenantId[/subtenants/:subtenantId]).\n */\nexport interface TenantUsageRule {\n  scope: 'tenant' | 'subtenant';\n  subtenantId?: string;\n  metric: 'tokens' | 'cost';\n  windowUnit: 'hour' | 'day' | 'week' | 'month';\n  windowEvery: number;\n  /** Configured limit for the window. */\n  limit: number;\n  /** Current consumption in the active window. */\n  current: number;\n  /** Utilization percentage (0..100, capped). */\n  percent: number;\n  /** Epoch ms when the active window resets. */\n  resetsAt?: number;\n  /** Where the rule comes from ('tier' | 'adhoc'). */\n  origin?: string;\n  /** Tier the rule belongs to, if any. */\n  tierId?: string;\n}\n\n/**\n * Response of GET /api/v1/tenant-usage/:tenantId[/subtenants/:subtenantId]:\n * the effective usage rules with their current consumption + the active tier.\n */\nexport interface TenantUsage {\n  tenantId: string;\n  subtenantId?: string;\n  tierId?: string;\n  usage: TenantUsageRule[];\n}\n\n/**\n * A durable per-window usage history row (from GET\n * /api/v1/tenant-usage/:tenantId/history).\n */\nexport interface TenantUsageHistoryRow {\n  clientUID: string;\n  tenantId: string;\n  subtenantId: string;\n  scope: 'tenant' | 'subtenant';\n  metric: 'tokens' | 'cost';\n  windowUnit: 'hour' | 'day' | 'week' | 'month';\n  windowEvery: number;\n  windowKey: string;\n  windowStart: number;\n  windowEnd: number;\n  /** Counted consumption (enforced). */\n  consumption: number;\n  /** Exempt consumption that did not count toward the limit, if any. */\n  exemptConsumption?: number;\n  limit: number;\n  percent: number;\n  tierId?: string;\n  origin?: string;\n  capturedAt: number;\n}\n\n/**\n * Options for querying tenant usage history.\n */\nexport interface TenantUsageHistoryQuery {\n  subtenantId?: string;\n  scope?: 'tenant' | 'subtenant';\n  metric?: 'tokens' | 'cost';\n  windowUnit?: 'hour' | 'day' | 'week' | 'month';\n  /** Epoch ms lower bound (windowEnd >= from). */\n  from?: number;\n  /** Epoch ms upper bound (windowEnd <= to). */\n  to?: number;\n  limit?: number;\n  skip?: number;\n}\n\n/**\n * Chat history structure\n */\n/** A concrete value carried verbatim through a compaction. */\nexport interface CompactionFact {\n  kind: string;\n  value: string;\n  label?: string;\n}\n\n/** The structured body a compaction produced. */\nexport interface CompactionSummary {\n  goal?: string;\n  constraints?: string[];\n  inProgress?: string;\n  pending?: string[];\n  decisions?: string[];\n  data?: Array<{ label: string; value: string }>;\n  done?: string[];\n  openQuestions?: string[];\n  /** Fallback when the model answered without structure. */\n  raw?: string;\n}\n\n/**\n * One compaction of a conversation: the messages before its boundary folded\n * into a written summary plus the identifiers, paths and urls lifted out of\n * them verbatim. From then on the model receives the checkpoint instead of\n * those messages — which are still in the conversation, and still shown.\n *\n * Only the newest checkpoint is in force: each compaction merges the previous\n * summary into itself.\n */\nexport interface CompactionCheckpoint {\n  uid: string;\n  /** 1 for the first compaction of the conversation, 2 for the next… */\n  index: number;\n  timestampMs: number;\n  trigger: 'auto' | 'manual';\n  /** First message that still travels verbatim. */\n  firstKeptMessageUid?: string;\n  /** Last folded message: where the widget belongs in the conversation. */\n  anchorMessageUid?: string;\n  compactedMessageCount: number;\n  summary: CompactionSummary;\n  facts: CompactionFact[];\n  tokensBefore: number;\n  tokensAfter: number;\n  provider?: string;\n  model?: string;\n  cost?: number;\n}\n\n/**\n * A compaction happening right now, from the realtime endpoint.\n *\n * A compaction is a model call of its own, taken between two assistant\n * messages, so a client that only knows `processing` shows a conversation\n * that appears to have stalled for a few seconds. Present while it runs and\n * on the single update that reports it finished.\n */\nexport interface CompactionActivity {\n  state: 'running' | 'completed';\n  startedAt: number;\n  /**\n   * What this pass is folding: the messages new since the last checkpoint.\n   * Not the conversation's totals — a checkpoint's own\n   * `compactedMessageCount` and `tokensBefore` are cumulative across every\n   * compaction, so the two are on different scales and must not be paired.\n   */\n  messageCount: number;\n  tokensBefore: number;\n  /** Which checkpoint the pass produced, once it is done. */\n  index?: number;\n  finishedAt?: number;\n}\n\nexport interface ChatHistory {\n  chatUID: string;\n  clientUID: string;\n  userUID: string;\n  chatContent: ChatMessage[];\n  name?: string;\n  assistantSpecializationIdentifier: string;\n  creationTimestampMs: number;\n  lastEditTimestampMs?: number;\n  llm?: string;\n  inputTokens?: number;\n  outputTokens?: number;\n  metadata?: Record<string, any>;\n  tenantId?: string;\n  handedOff?: boolean;\n  handedOffSubThreadId?: string;\n  handedOffToolCallId?: string;\n  /** Structured long-term-memory recall events of the conversation. */\n  recalledMemories?: RecalledMemoryRecord[];\n  /** Audit trail of the core-memory blocks the conversation saw. */\n  coreMemories?: CoreMemorySnapshot[];\n  /** Compaction checkpoints of the conversation, oldest first. */\n  compactions?: CompactionCheckpoint[];\n}\n\n/** One core memory entry (the always-injected tier), as returned by the memory API. */\nexport interface CoreMemoryEntry {\n  id: number;\n  section: string;\n  content: string;\n  source: string;\n  pinned: boolean;\n  supersedes: number | null;\n  archivedAt: string | null;\n  createdAt?: string;\n  updatedAt?: string;\n}\n\n/** Deployment caps of the core memory tier. */\nexport interface CoreMemoryLimits {\n  maxChars: number;\n  maxEntries: number;\n  maxEntryChars: number;\n}\n\n/**\n * Response of GET /api/v1/memory/assistants/:identifier/core — the entries\n * of the bucket the assistant resolves for a tenant/subtenant combination.\n */\nexport interface CoreMemoryList {\n  /** False when the assistant does not have the core memory tier enabled. */\n  enabled: boolean;\n  /** The resolved bucket tuple (tenant/subtenant/owner dimensions). */\n  bucket: { tenantId?: string; subtenantId?: string; entityId?: string };\n  entries: CoreMemoryEntry[];\n  limits?: CoreMemoryLimits;\n}\n\n/**\n * Assistant specialization info\n */\nexport interface AssistantSpecialization {\n  liveVoice?: import('./liveVoice.types').LiveVoiceConfiguration;\n  identifier: string;\n  name: string;\n  description: string;\n  state: 'active' | 'inactive' | 'coming_soon';\n  imgUrl?: string;\n  /** Pinned style of the generated avatar shown when there is no imgUrl. */\n  avatarStyle?: AvatarStyle;\n  availableToolsGroups?: Array<{\n    name: string;\n    description?: string;\n    uid?: string;\n    iconUrl?: string;\n    tools?: Array<{\n      name: string;\n      description: string;\n    }>;\n  }>;\n  model?: string;\n  isCustom?: boolean;\n  creationTimestampMs?: number;\n  /**\n   * Whether this assistant offers MCP servers of the tenant's own.\n   *\n   * Same contract as `tenantIntegrations` below, absence included.\n   */\n  tenantMcpServers?: {\n    enabled: boolean;\n    /** Servers listed ready to connect. Says nothing about how many are connected. */\n    count?: number;\n  };\n  /**\n   * Whether this assistant offers connected apps to its tenants.\n   *\n   * **Absent means \"cannot tell\", not \"no\"** — an API older than this field\n   * says nothing, and treating silence as a no would hide the connected-apps\n   * button from anyone whose deployment has not caught up yet.\n   */\n  tenantIntegrations?: {\n    enabled: boolean;\n    /**\n     * How many apps the catalogue offers. An upper bound — the listing drops\n     * any the provider cannot resolve — and enough to size a placeholder.\n     */\n    count?: number;\n  };\n  /**\n   * Whether this assistant accepts messages sent while the conversation is\n   * busy, queueing them instead of refusing them.\n   *\n   * **Absent means no**, unlike `tenantIntegrations` above. Promising a queue\n   * that does not exist is paid for with a 409 and with the user's text left in\n   * the air, so silence is read as the safe answer rather than as the open one.\n   */\n  messageQueueEnabled?: boolean;\n  /** How many messages may wait at once before further sends are refused. */\n  maxQueuedMessages?: number;\n}\n\n/**\n * Summary of a conversation for listing\n */\nexport interface ConversationSummary {\n  chatUID: string;\n  name?: string;\n  creationTimestampMs: number;\n  lastEditTimestampMs?: number;\n}\n\nexport interface ListConversationsResponse {\n  histories: ConversationSummary[];\n  total: number;\n  offset: number;\n  limit: number;\n}\n\n/**\n * API error response\n */\nexport interface ApiError {\n  statusCode: number;\n  message: string;\n  error?: string;\n  /** Optional structured details (e.g. usage-limit blocking info on a 429). */\n  details?: any;\n}\n\n/**\n * Feedback submission request\n */\nexport interface FeedbackSubmission {\n  messageId: string;\n  feedback?: boolean;\n  feedbackComment?: string;\n  feedbackData?: Record<string, any>;\n}\n\n/**\n * Feedback entry response\n */\nexport interface FeedbackEntry {\n  _id: string;\n  requestId: string;\n  chatUID?: string;\n  threadId?: string;\n  agentId?: string;\n  feedback?: boolean;\n  feedbackComment?: string;\n  feedbackData?: Record<string, any>;\n  creationTimestamp: string;\n  lastEditTimestamp?: string;\n}\n\n/**\n * Agent thread states\n */\nexport enum AgentThreadState {\n  QUEUED = 'queued',\n  PROCESSING = 'processing',\n  COMPLETED = 'completed',\n  FAILED = 'failed',\n  TERMINATED = 'terminated',\n  PAUSED = 'paused',\n  PAUSED_FOR_APPROVAL = 'paused_for_approval',\n  APPROVAL_REJECTED = 'approval_rejected',\n  WAITING_FOR_RESPONSE = 'waiting_for_response',\n  PAUSED_FOR_RESUME = 'paused_for_resume',\n  HANDED_OFF = 'handed_off',\n  GUARDRAIL_TRIGGER = 'guardrail_trigger',\n}\n\n/**\n * Task within an agent thread\n */\nexport interface AgentTaskDto {\n  _id?: string;\n  title?: string;\n  description?: string;\n  completed: boolean;\n}\n\n/**\n * Agent thread DTO\n */\nexport interface AgentThreadDto {\n  _id?: string;\n  agentId: string;\n  state: AgentThreadState;\n  threadContent: ChatMessage[];\n  tasks?: AgentTaskDto[];\n  finishReason?: string;\n  pausedReason?: string;\n  name?: string;\n  creationTimestampMs?: number;\n  lastEditTimestampMs?: number;\n  pauseUntil?: number;\n  isSubthread?: boolean;\n  parentThreadId?: string;\n  subThreadToolCallId?: string;\n  parentAgentId?: string;\n}\n\n/**\n * Agent details\n */\nexport interface AgentDto {\n  _id?: string;\n  name: string;\n  description?: string;\n  imgUrl?: string;\n  /** Pinned style of the generated avatar shown when there is no imgUrl. */\n  avatarStyle?: AvatarStyle;\n  agentId?: string;\n}\n\n/**\n * Hand-off tool response content\n */\nexport interface HandOffToolResponse {\n  response: string;\n  subthreadId: string;\n}\n\n/**\n * Represents a single tool call within a tool group\n */\nexport interface ToolGroupCall {\n  name: string;\n  input: any;\n  output: any;\n  toolCallId: string;\n}\n\n/**\n * Configuration for grouping consecutive tool calls under a single renderer\n */\nexport interface ToolGroupConfig {\n  tools: string[];\n  renderer: (calls: ToolGroupCall[]) => React.ReactNode;\n}\n\n/**\n * One of the end user's connected accounts for an app.\n *\n * The provider's own identifiers do not travel here beyond `id`, which the\n * client needs in order to name the account it wants disconnected — and which\n * the server re-checks against the caller's tenant on the way back in.\n */\nexport interface IntegrationAccount {\n  id: string;\n  status: string;\n  connectedAt?: string;\n  updatedAt?: string;\n  /** True when the account exists but can no longer run tools. */\n  needsReconnect?: boolean;\n  statusReason?: string;\n}\n\n/**\n * One value the end user is asked for before an account can be connected —\n * their API key, the subdomain of their instance.\n *\n * Comes from the provider's own catalogue, so the form is rendered from this\n * rather than from anything app-specific: most apps do not authenticate with\n * credentials Devic holds, and there are hundreds of them.\n */\nexport interface IntegrationAuthField {\n  name: string;\n  label: string;\n  type: string;\n  required: boolean;\n  description?: string;\n  /** Prefilled — usually a provider endpoint most accounts should keep. */\n  default?: string;\n  /** Mask it on screen. */\n  secret: boolean;\n}\n\n/**\n * One way of connecting an app.\n *\n * `redirect` schemes send the user to the provider; the rest are connected\n * with the values they type, without ever leaving the page.\n *\n * There is deliberately no field for the *application's* credentials: the\n * OAuth application belongs to the developer who embedded this widget, is\n * registered once for every tenant, and is never the end user's to supply.\n */\nexport interface IntegrationAuthScheme {\n  /** The provider's own name for it: `OAUTH2`, `API_KEY`, … */\n  mode: string;\n  /** Credentials for this scheme are held for you — nothing to fill in. */\n  composioManaged: boolean;\n  redirect: boolean;\n  /** What this account supplies. Empty for a scheme that asks nothing. */\n  accountFields: IntegrationAuthField[];\n  /** The provider's own setup guide, when there is one. */\n  guideUrl?: string;\n}\n\n/**\n * The answer when connecting needs values that were not sent.\n *\n * `stage` decides who can act on it: `account` is the end user, and the form\n * asks them. `app` is the developer's OAuth application, which the end user\n * cannot register — so that case is shown as \"not available yet\" instead of a\n * form asking a stranger for someone else's client secret.\n */\nexport interface IntegrationSetupRequired {\n  code: \"INTEGRATION_SETUP_REQUIRED\";\n  message: string;\n  toolkit: string;\n  authScheme: string;\n  stage: \"app\" | \"account\";\n  fields: IntegrationAuthField[];\n  guideUrl?: string;\n}\n\n/**\n * An app the assistant offers to its tenants, with the accounts THIS tenant\n * has connected. Never another tenant's.\n */\nexport interface Integration {\n  /** App slug, e.g. `gmail`. */\n  app: string;\n  name: string;\n  description?: string;\n  logo?: string;\n  /** True when at least one account is active. */\n  connected: boolean;\n  accounts: IntegrationAccount[];\n  /** Event types the developer allows this tenant to switch on. */\n  availableTriggers?: string[];\n}\n\n// ── MCP servers the end user connects for themselves ──────────────────────\n\nexport type TenantMcpAuthMode = \"oauth\" | \"header\" | \"none\";\n\n/** One of the end user's own MCP connections. */\nexport interface TenantMcpConnection {\n  id: string;\n  /**\n   * What to put in `disabledIntegrations` to have this server sit a message\n   * out. Sent by the API so the prefix that separates it from an app slug lives\n   * on the server, in one place.\n   */\n  toggleId?: string;\n  name?: string;\n  url: string;\n  /** The developer's template this came from, when it came from one. */\n  templateId?: string;\n  authMode?: TenantMcpAuthMode;\n  status: \"pending_auth\" | \"active\" | \"error\";\n  toolCount?: number;\n  tools?: string[];\n  lastProbeStatus?: string;\n  lastProbeError?: string;\n  lastProbeTimestampMs?: number;\n  /** Connected for the whole tenant, so every end user of it shares this. */\n  shared: boolean;\n  /** True when this end user may use it but not change or remove it. */\n  readOnly: boolean;\n}\n\n/**\n * One row of the MCP panel: either a server the developer offers ready to\n * connect, or one this end user added.\n *\n * A single list rather than two, because that is what the panel draws — keeping\n * \"offered\" and \"connected\" apart would leave them out of step for a moment\n * after every connect.\n */\nexport interface TenantMcpServer {\n  source: \"template\" | \"custom\";\n  templateId?: string;\n  name: string;\n  url: string;\n  description?: string;\n  logoUrl?: string;\n  authMode?: TenantMcpAuthMode;\n  /** Header the credential travels in, for `header` servers. */\n  headerName?: string;\n  /** Whether the end user may supply their own OAuth application. */\n  allowClientCredentials?: boolean;\n  /** Null until this tenant connects it. */\n  connection: TenantMcpConnection | null;\n}\n\nexport interface TenantMcpListing {\n  offered: boolean;\n  /** Whether adding a server of one's own is permitted. */\n  allowCustom: boolean;\n  limits: { maxServers: number; maxToolsPerServer: number; used: number };\n  servers: TenantMcpServer[];\n}\n\n/** Credentials the end user supplies when connecting a server. */\nexport interface TenantMcpAuthInput {\n  mode?: TenantMcpAuthMode;\n  headerName?: string;\n  headerValue?: string;\n  upstreamOAuth?: { clientId?: string; clientSecret?: string; scopes?: string[] };\n}\n\n/**\n * What connecting answers with.\n *\n * `status: \"active\"` means it is done. `authorizationUrl` must be opened in a\n * popup. `requiresClientCredentials` means the server has no dynamic client\n * registration and the end user has to register an OAuth application with it\n * themselves, authorising `callbackUrl` as the redirect URI.\n */\nexport interface TenantMcpConnectResult {\n  id: string;\n  status: \"pending_auth\" | \"active\" | \"error\";\n  toolCount?: number;\n  authorizationUrl?: string;\n  requiresClientCredentials?: boolean;\n  callbackUrl?: string;\n  error?: string;\n}\n"],"names":[],"mappings":"AA+CA;AACM,SAAU,oBAAoB,CAAC,IAAiB,EAAA;IAKpD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE;QACvC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO;KAC5C;AACH;AAivBA;;AAEG;IACS;AAAZ,CAAA,UAAY,gBAAgB,EAAA;AAC1B,IAAA,gBAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;AACjB,IAAA,gBAAA,CAAA,YAAA,CAAA,GAAA,YAAyB;AACzB,IAAA,gBAAA,CAAA,WAAA,CAAA,GAAA,WAAuB;AACvB,IAAA,gBAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;AACjB,IAAA,gBAAA,CAAA,YAAA,CAAA,GAAA,YAAyB;AACzB,IAAA,gBAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;AACjB,IAAA,gBAAA,CAAA,qBAAA,CAAA,GAAA,qBAA2C;AAC3C,IAAA,gBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAuC;AACvC,IAAA,gBAAA,CAAA,sBAAA,CAAA,GAAA,sBAA6C;AAC7C,IAAA,gBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAuC;AACvC,IAAA,gBAAA,CAAA,YAAA,CAAA,GAAA,YAAyB;AACzB,IAAA,gBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAuC;AACzC,CAAC,EAbW,gBAAgB,KAAhB,gBAAgB,GAAA,EAAA,CAAA,CAAA;;;;"}

package/dist/esm/components/AICommandBar/useAICommandBar.js

@@ -164,7 +164,7 @@ function useAICommandBar(options) {
         }
     }, [apiKey, baseUrl]);
     // Model interface
-    const { toolSchemas, handleToolCalls: executeToolCalls, extractPendingToolCalls, } = useModelInterface({
+    const { toolSchemas, handleToolCalls: executeToolCalls, resolvePendingToolCalls, } = useModelInterface({
         tools: modelInterfaceTools,
         onToolExecute: onToolCall,
     });
@@ -338,13 +338,13 @@ function useAICommandBar(options) {
     const handlePendingToolCalls = useCallback(async (data) => {
         if (!clientRef.current || !chatUid)
             return;
-        const pendingCalls = data.pendingToolCalls || extractPendingToolCalls(data.chatHistory);
+        const pendingCalls = resolvePendingToolCalls(data);
         if (pendingCalls.length === 0)
             return;
         try {
-            const { responses } = await executeToolCalls(pendingCalls);
+            const { responses, toolSchemas: schemas } = await executeToolCalls(pendingCalls);
             if (responses.length > 0) {
-                await clientRef.current.sendToolResponses(assistantId, chatUid, responses, toolSchemas);
+                await clientRef.current.sendToolResponses(assistantId, chatUid, responses, schemas);
                 setShouldPoll(true);
             }
         }
@@ -353,7 +353,7 @@ function useAICommandBar(options) {
             setError(error);
             onErrorRef.current?.(error);
         }
-    }, [chatUid, assistantId, executeToolCalls, extractPendingToolCalls, toolSchemas]);
+    }, [chatUid, assistantId, executeToolCalls, resolvePendingToolCalls]);
     // Polling
     usePolling(shouldPoll ? chatUid : null, async () => {
         if (!clientRef.current || !chatUid) {