@anuma/sdk 11.0.1 → 11.2.0

package/dist/expo/index.d.mts

@@ -2373,7 +2373,13 @@ type StreamingTransport = (options: StreamingTransportOptions) => StreamingTrans
 /**
  * Tool executor function type
  */
-type ToolExecutor = (args: Record<string, unknown>, signal?: AbortSignal) => Promise<unknown> | unknown;
+type ToolExecutor = (args: Record<string, unknown>, signal?: AbortSignal, context?: ToolExecutionContext) => Promise<unknown> | unknown;
+/** How the portal treats a call to this device tool while the device is away. */
+type DetachedToolClass = "render" | "deferred";
+/** Context for one executor run; `detached` marks a call from an answer finished while the device was away. */
+type ToolExecutionContext = {
+    detached?: boolean;
+};
 /**
  * Tool configuration with optional executor
  */
@@ -2443,6 +2449,8 @@ type ToolConfig = LlmapiChatCompletionTool & {
      * files from IndexedDB that `create_file` writes.
      */
     dependsOn?: string[];
+    /** How the portal handles a call to this tool while the device is away; unset tools pause the turn. */
+    detachedClass?: DetachedToolClass;
 };
 /**
  * Responses API options that can be passed to sendMessage
@@ -8221,6 +8229,8 @@ interface ResumeStreamOptions {
     onFinish?: (response: ApiResponse) => void;
     /** Called on a transient/unexpected failure. Never called for 410 (throws) nor interrupted terminals. */
     onError?: (error: Error) => void;
+    /** Tools a finished replay may end on because the device runs them when the answer is stored. */
+    finishedToolNames?: string[];
 }
 /**
  * Result of {@link resumeStream}. A `410 Gone` is the only outcome that throws
@@ -12054,7 +12064,7 @@ type UseChatResult = BaseUseChatResult & {
      * the hook's `getToken`/`baseUrl`/`transport` defaults; the token is resolved
      * at invocation so a refresh during the detach window is honored.
      */
-    resumeStream: (handle: StreamResumeHandle, opts?: Pick<ResumeStreamOptions, "idleTimeoutMs" | "smoothing"> & {
+    resumeStream: (handle: StreamResumeHandle, opts?: Pick<ResumeStreamOptions, "idleTimeoutMs" | "smoothing" | "finishedToolNames"> & {
         /**
          * Replay + reconcile + persist exactly as normal, but emit NOTHING to any
          * consumer callback — `onData` / `onThinking` / `onFinish` / `onError` are
@@ -12216,6 +12226,11 @@ interface UseChatStorageOptions extends BaseUseChatStorageOptions {
     }) => void;
     /** The vault inbox that receives answers finished while no client was attached. */
     inbox?: VaultInbox;
+    /**
+     * Device tools that can finish a turn the portal completed while the device was away: their
+     * executors run when that answer is stored. Pass the display tools and the memory save tool.
+     */
+    detachedTools?: ToolConfig[];
     /**
      * Observability hook fired once per send with the tools actually selected for
      * the turn (after server + client filtering). Never throws into the send path.

package/dist/expo/index.d.ts

@@ -2373,7 +2373,13 @@ type StreamingTransport = (options: StreamingTransportOptions) => StreamingTrans
 /**
  * Tool executor function type
  */
-type ToolExecutor = (args: Record<string, unknown>, signal?: AbortSignal) => Promise<unknown> | unknown;
+type ToolExecutor = (args: Record<string, unknown>, signal?: AbortSignal, context?: ToolExecutionContext) => Promise<unknown> | unknown;
+/** How the portal treats a call to this device tool while the device is away. */
+type DetachedToolClass = "render" | "deferred";
+/** Context for one executor run; `detached` marks a call from an answer finished while the device was away. */
+type ToolExecutionContext = {
+    detached?: boolean;
+};
 /**
  * Tool configuration with optional executor
  */
@@ -2443,6 +2449,8 @@ type ToolConfig = LlmapiChatCompletionTool & {
      * files from IndexedDB that `create_file` writes.
      */
     dependsOn?: string[];
+    /** How the portal handles a call to this tool while the device is away; unset tools pause the turn. */
+    detachedClass?: DetachedToolClass;
 };
 /**
  * Responses API options that can be passed to sendMessage
@@ -8221,6 +8229,8 @@ interface ResumeStreamOptions {
     onFinish?: (response: ApiResponse) => void;
     /** Called on a transient/unexpected failure. Never called for 410 (throws) nor interrupted terminals. */
     onError?: (error: Error) => void;
+    /** Tools a finished replay may end on because the device runs them when the answer is stored. */
+    finishedToolNames?: string[];
 }
 /**
  * Result of {@link resumeStream}. A `410 Gone` is the only outcome that throws
@@ -12054,7 +12064,7 @@ type UseChatResult = BaseUseChatResult & {
      * the hook's `getToken`/`baseUrl`/`transport` defaults; the token is resolved
      * at invocation so a refresh during the detach window is honored.
      */
-    resumeStream: (handle: StreamResumeHandle, opts?: Pick<ResumeStreamOptions, "idleTimeoutMs" | "smoothing"> & {
+    resumeStream: (handle: StreamResumeHandle, opts?: Pick<ResumeStreamOptions, "idleTimeoutMs" | "smoothing" | "finishedToolNames"> & {
         /**
          * Replay + reconcile + persist exactly as normal, but emit NOTHING to any
          * consumer callback — `onData` / `onThinking` / `onFinish` / `onError` are
@@ -12216,6 +12226,11 @@ interface UseChatStorageOptions extends BaseUseChatStorageOptions {
     }) => void;
     /** The vault inbox that receives answers finished while no client was attached. */
     inbox?: VaultInbox;
+    /**
+     * Device tools that can finish a turn the portal completed while the device was away: their
+     * executors run when that answer is stored. Pass the display tools and the memory save tool.
+     */
+    detachedTools?: ToolConfig[];
     /**
      * Observability hook fired once per send with the tools actually selected for
      * the turn (after server + client filtering). Never throws into the send path.