claudius-chat-widget 1.12.0 → 1.13.0

package/dist/index.d.cts

@@ -215,6 +215,8 @@ export declare class ChatApiClient {
               content: string;
               /** Sources cited by the assistant for this message, when any. */
               sources?: Source[];
+              /** Tools the assistant called while producing this message, when any. */
+              toolUses?: ToolUse[];
           }
 
           /**
@@ -233,6 +235,8 @@ export declare class ChatApiClient {
               reply: string;
               /** Sources the assistant cited, when any. */
               sources?: Source[];
+              /** Tools the assistant called while producing the reply, when any. */
+              toolUses?: ToolUse[];
           }
 
           /**
@@ -246,6 +250,11 @@ export declare class ChatApiClient {
                * @param fullText - The full reply accumulated so far, including this chunk.
                */
               onChunk?: (text: string, fullText: string) => void;
+              /**
+               * Called when the assistant finishes a tool call mid-stream, so the UI can
+               * show a "used tool" affordance before the reply completes.
+               */
+              onToolUse?: (toolUse: ToolUse, allToolUses: ToolUse[]) => void;
               /**
                * Cancels the stream when aborted. Cancellation is not an error: the
                * promise resolves with the partial reply and `aborted: true`.
@@ -460,6 +469,10 @@ export declare class ChatApiClient {
               sendMessage: string;
               /** Accessible label for the stop button shown while a reply streams in. */
               stopGenerating: string;
+              /** Label prefix for the "used tool" chip on assistant messages. */
+              toolUsed: string;
+              /** Accessible label for the tool-details disclosure toggle. */
+              toolDetails: string;
               /** Accessible label for the message input field. */
               typeYourMessage: string;
               /** Accessible label for the button that opens the chat. */
@@ -684,6 +697,21 @@ export declare class ChatApiClient {
           /** Names of the box-shadow tokens a theme can override. */
           export declare type ThemeShadowToken = (typeof THEME_SHADOW_TOKENS)[number];
 
+          /**
+           * One tool call the assistant made while producing a reply. Rendered as a
+           * compact "used tool" affordance with an optional details disclosure.
+           */
+          export declare interface ToolUse {
+              /** Tool name (e.g. `"get_current_time"`). */
+              name: string;
+              /** Input the model supplied to the tool. */
+              input?: Record<string, unknown>;
+              /** Serialized tool result, as the model saw it. */
+              result?: string;
+              /** Present when the tool call failed. */
+              isError?: boolean;
+          }
+
           /**
            * A proactive engagement rule. Each variant fires at most once per page on a
            * different signal: elapsed time, scroll depth, exit intent, or URL match.

package/dist/index.d.ts

@@ -215,6 +215,8 @@ export declare class ChatApiClient {
               content: string;
               /** Sources cited by the assistant for this message, when any. */
               sources?: Source[];
+              /** Tools the assistant called while producing this message, when any. */
+              toolUses?: ToolUse[];
           }
 
           /**
@@ -233,6 +235,8 @@ export declare class ChatApiClient {
               reply: string;
               /** Sources the assistant cited, when any. */
               sources?: Source[];
+              /** Tools the assistant called while producing the reply, when any. */
+              toolUses?: ToolUse[];
           }
 
           /**
@@ -246,6 +250,11 @@ export declare class ChatApiClient {
                * @param fullText - The full reply accumulated so far, including this chunk.
                */
               onChunk?: (text: string, fullText: string) => void;
+              /**
+               * Called when the assistant finishes a tool call mid-stream, so the UI can
+               * show a "used tool" affordance before the reply completes.
+               */
+              onToolUse?: (toolUse: ToolUse, allToolUses: ToolUse[]) => void;
               /**
                * Cancels the stream when aborted. Cancellation is not an error: the
                * promise resolves with the partial reply and `aborted: true`.
@@ -460,6 +469,10 @@ export declare class ChatApiClient {
               sendMessage: string;
               /** Accessible label for the stop button shown while a reply streams in. */
               stopGenerating: string;
+              /** Label prefix for the "used tool" chip on assistant messages. */
+              toolUsed: string;
+              /** Accessible label for the tool-details disclosure toggle. */
+              toolDetails: string;
               /** Accessible label for the message input field. */
               typeYourMessage: string;
               /** Accessible label for the button that opens the chat. */
@@ -684,6 +697,21 @@ export declare class ChatApiClient {
           /** Names of the box-shadow tokens a theme can override. */
           export declare type ThemeShadowToken = (typeof THEME_SHADOW_TOKENS)[number];
 
+          /**
+           * One tool call the assistant made while producing a reply. Rendered as a
+           * compact "used tool" affordance with an optional details disclosure.
+           */
+          export declare interface ToolUse {
+              /** Tool name (e.g. `"get_current_time"`). */
+              name: string;
+              /** Input the model supplied to the tool. */
+              input?: Record<string, unknown>;
+              /** Serialized tool result, as the model saw it. */
+              result?: string;
+              /** Present when the tool call failed. */
+              isError?: boolean;
+          }
+
           /**
            * A proactive engagement rule. Each variant fires at most once per page on a
            * different signal: elapsed time, scroll depth, exit intent, or URL match.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudius-chat-widget",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "type": "module",
   "description": "Embeddable AI chat widget powered by Claude. Drop-in React component or standalone script embed, backed by a Cloudflare Worker.",
   "keywords": [