@artooi/ag-ui-web-component 0.2.0 → 0.2.2

package/dist/core/ag_ui_chat.d.ts

@@ -91,6 +91,15 @@ export declare class AgUiChat extends HTMLElement {
      * this from the current page; a missing placeholder blocks the send.
      */
     skillContext: () => Record<string, unknown>;
+    /**
+     * Friendly display labels for tool-call cards, keyed by tool name (e.g.
+     * `{ list_projects: "Search projects" }`). Used as a fallback when a tool has
+     * no `x-summary` in its own schema — chiefly **server-side tools** (drf-mcp,
+     * `@tool` registry), whose schema never reaches the browser (AG-UI streams
+     * only the tool-call name). Client tools should prefer `x-summary` on their
+     * schema; this map is the seam for everything else.
+     */
+    toolSummaries: Record<string, string>;
     constructor();
     /** Attributes whose late changes must reflect in already-rendered chrome. */
     static get observedAttributes(): string[];

package/dist/core/ag_ui_chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ag_ui_chat.d.ts","sourceRoot":"","sources":["../../src/core/ag_ui_chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAW,IAAI,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EACL,YAAY,EAOb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,KAAK,UAAU,EAAsB,MAAM,kCAAkC,CAAC;AAGvF,OAAO,EAAwB,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAM9E,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAO7E,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EAE1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,YAAY,EAAmB,MAAM,wBAAwB,CAAC;AAE5E,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE3E,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAKD;;;;;;;;;;;GAWG;AACH,qBAAa,QAAS,SAAQ,WAAW;;IACvC,wEAAwE;IACxE,YAAY,EAAE,YAAY,CAAmB;IAE7C,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAErC,yEAAyE;IACzE,WAAW,UAAS;IAEpB;;;;;;OAMG;IACH,gBAAgB,EACZ,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,GACjF,IAAI,CAAQ;IAEhB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,IAAI,EAAE,CAOpB;IAEF;;;OAGG;IACH,UAAU,EAAE,MAAM,OAAO,EAAE,CAAuE;IAElG;;;OAGG;IACH,QAAQ,EAAE,QAAQ,CAAM;IAExB;;;;OAIG;IACH,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEjD,iEAAiE;IACjE,UAAU,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,IAAI,CAAQ;IAE1C,iEAAiE;IACjE,iBAAiB,UAAQ;IAEzB;;;;OAIG;IACH,iBAAiB,EAAE,uBAAuB,CAA6B;IAEvE;;;;OAIG;IACH,gBAAgB,EAAE,CAAC,UAAU,EAAE,oBAAoB,KAAK,OAAO,CAG5D;IAEH;;;;OAIG;IACH,YAAY,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAc;;IAoCzD,6EAA6E;IAC7E,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAED,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAM7F,kDAAkD;IAClD,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIpC,wEAAwE;IACxE,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAqDxC,kEAAkE;IAClE,IAAI,QAAQ,IAAI,MAAM,CAErB;IAKD,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAEzB;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,eAAe,CAMjC;IAED,IAAI,WAAW,CAAC,KAAK,EAAE,eAAe,EAErC;IAED,iBAAiB,IAAI,IAAI;IAUzB;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,IAAI;IAoEzC,gFAAgF;IAChF,IAAI,SAAS,IAAI,OAAO,CAEvB;IAID,IAAI,SAAS,CAAC,KAAK,EAAE,OAAO,EAE3B;IAED;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAgBtC,qEAAqE;IACrE,eAAe,IAAI,IAAI;IAIvB;;;OAGG;IACH,OAAO,IAAI,IAAI;IA6Df;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc;CAuTlE"}
+{"version":3,"file":"ag_ui_chat.d.ts","sourceRoot":"","sources":["../../src/core/ag_ui_chat.ts"],"names":[],"mappings":"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"}

package/dist/core/agui_client.d.ts

@@ -40,8 +40,21 @@ export interface AgUiClientHandlers {
     onTextEnd(buffer: string): void;
     /** Fired when the agent finishes calling a tool (server- or frontend-side). */
     onToolCall(call: AgUiToolCall): void;
+    /**
+     * Fired when a server-side tool's result streams back (AG-UI's
+     * `TOOL_CALL_RESULT`). Frontend tools don't emit this — the client supplies
+     * their result itself — so this is the channel for server-executed output.
+     */
+    onToolResult(toolCallId: string, content: string): void;
     onRunEnd(): void;
     onError(message: string): void;
+    /**
+     * Fired exactly once when the whole interaction settles — after the run loop
+     * ends for any reason (a server-only round, frontend-tool rounds exhausted,
+     * or an error). The terminal guarantee that the UI returns to rest (pending
+     * indicator cleared, input re-enabled) no matter how the run finished.
+     */
+    onSettled(): void;
 }
 /**
  * Provider of the per-run frontend tool catalog and context. Both are read

package/dist/core/agui_client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agui_client.d.ts","sourceRoot":"","sources":["../../src/core/agui_client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAoC,MAAM,eAAe,CAAC;AACrF,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAG1D,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,IAAI,IAAI,CAAC;IACnB,yEAAyE;IACzE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gFAAgF;IAChF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,+EAA+E;IAC/E,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC,QAAQ,IAAI,IAAI,CAAC;IACjB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,OAAO,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,sEAAsE;IACtE,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,oEAAoE;IACpE,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,KAAK,IAAI,CAAC;CACpD;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;;gBAQT,MAAM,EAAE,gBAAgB;IASpC,4CAA4C;IAC5C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,wEAAwE;IACxE,IAAI,QAAQ,IAAI,SAAS,OAAO,EAAE,CAEjC;IAED;;;;;;OAMG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1C;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,0EAA0E;IAC1E,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CA+EzD"}
+{"version":3,"file":"agui_client.d.ts","sourceRoot":"","sources":["../../src/core/agui_client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAoC,MAAM,eAAe,CAAC;AACrF,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAG1D,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,IAAI,IAAI,CAAC;IACnB,yEAAyE;IACzE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gFAAgF;IAChF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,+EAA+E;IAC/E,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC;;;;OAIG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,QAAQ,IAAI,IAAI,CAAC;IACjB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;;OAKG;IACH,SAAS,IAAI,IAAI,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,OAAO,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,sEAAsE;IACtE,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,oEAAoE;IACpE,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,KAAK,IAAI,CAAC;CACpD;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;;gBAQT,MAAM,EAAE,gBAAgB;IASpC,4CAA4C;IAC5C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,wEAAwE;IACxE,IAAI,QAAQ,IAAI,SAAS,OAAO,EAAE,CAEjC;IAED;;;;;;OAMG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1C;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,0EAA0E;IAC1E,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAoFzD"}

package/dist/index.js

@@ -143,7 +143,7 @@ function createRouteTools(getRouteMap, getNavigate) {
     {
       name: "list_routes",
       description: "List the routes the app can navigate to. Each route's `pathParams` names the dynamic segments to pass as `params` to `navigate_to_route`.",
-      parameters: { type: "object", properties: {}, required: [] },
+      parameters: { type: "object", properties: {}, required: [], [X_SUMMARY_KEY]: "List pages" },
       handler: () => getRouteMap().map((route) => ({ ...route, pathParams: pathParamNames(route.path) }))
     },
     {
@@ -156,7 +156,8 @@ function createRouteTools(getRouteMap, getNavigate) {
           params: { type: "object" }
         },
         required: ["route_id"],
-        [X_NAVIGATES_KEY]: true
+        [X_NAVIGATES_KEY]: true,
+        [X_SUMMARY_KEY]: "Navigate"
       },
       handler: (args) => {
         const routeId = args["route_id"];
@@ -185,7 +186,12 @@ function createStateHookTools(hook) {
     {
       name: `read_${hook.name}`,
       description: `Read the "${hook.name}" state.`,
-      parameters: { type: "object", properties: {}, required: [] },
+      parameters: {
+        type: "object",
+        properties: {},
+        required: [],
+        [X_SUMMARY_KEY]: `Read ${hook.name}`
+      },
       handler: () => hook.read()
     }
   ];
@@ -194,7 +200,11 @@ function createStateHookTools(hook) {
     tools.push({
       name: `set_${hook.name}`,
       description: `Update the "${hook.name}" state.`,
-      parameters: { ...hook.schema ?? { type: "object" }, [X_DESTRUCTIVE_KEY]: true },
+      parameters: {
+        ...hook.schema ?? { type: "object" },
+        [X_DESTRUCTIVE_KEY]: true,
+        [X_SUMMARY_KEY]: `Update ${hook.name}`
+      },
       handler: (args) => write(args)
     });
   }
@@ -3145,7 +3155,10 @@ var STYLES = `
 }
 
 /* \u2500\u2500 Incoming-text animations (data-text-animation) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */
-:host([data-text-animation="fade"]) .message--assistant {
+/* .message--restored (rehydrated history) is excluded: entrance animations are
+   for freshly-arriving messages, not the whole transcript replaying on reload.
+   Word mode is excluded implicitly \u2014 restored bubbles aren't wrapped. */
+:host([data-text-animation="fade"]) .message--assistant:not(.message--restored) {
   animation: ag-ui-msg-fade 0.25s ease both;
 }
 
@@ -3669,6 +3682,8 @@ var AgUiClient = class {
       await this.#runLoop();
     } catch (error) {
       this.#handlers.onError(error instanceof Error ? error.message : String(error));
+    } finally {
+      this.#handlers.onSettled();
     }
   }
   async #runLoop() {
@@ -3726,6 +3741,9 @@ var AgUiClient = class {
         pending.push(call);
         h.onToolCall(call);
       },
+      onToolCallResultEvent({ event }) {
+        h.onToolResult(event.toolCallId, event.content);
+      },
       onRunErrorEvent({ event }) {
         h.onError(event.message);
       },
@@ -3877,9 +3895,24 @@ var AgUiChat = class extends HTMLElement {
    * this from the current page; a missing placeholder blocks the send.
    */
   skillContext = () => ({});
+  /**
+   * Friendly display labels for tool-call cards, keyed by tool name (e.g.
+   * `{ list_projects: "Search projects" }`). Used as a fallback when a tool has
+   * no `x-summary` in its own schema — chiefly **server-side tools** (drf-mcp,
+   * `@tool` registry), whose schema never reaches the browser (AG-UI streams
+   * only the tool-call name). Client tools should prefer `x-summary` on their
+   * schema; this map is the seam for everything else.
+   */
+  toolSummaries = {};
   #toolRegistry = new ClientToolRegistry();
   /** Tool-call cards awaiting execution, keyed by call id. */
   #toolCards = /* @__PURE__ */ new Map();
+  /**
+   * Call ids whose card was already settled from a streamed server-side result
+   * (`TOOL_CALL_RESULT`), so the post-run executeTool sweep doesn't overwrite
+   * the real output with the generic "executed on the server" fallback.
+   */
+  #serverSettled = /* @__PURE__ */ new Set();
   #root;
   #chat;
   #messages;
@@ -3890,6 +3923,10 @@ var AgUiChat = class extends HTMLElement {
   #skillHint;
   #client = null;
   #streamingBubble = null;
+  // Text deltas applied to the current streaming bubble. >1 ⇒ the message
+  // revealed progressively as it streamed, so the word reveal must not re-animate
+  // it; ≤1 ⇒ it arrived at once and the word reveal is appropriate.
+  #streamDeltas = 0;
   #pending = null;
   #threadId = "";
   #initialMessages = [];
@@ -3949,7 +3986,12 @@ var AgUiChat = class extends HTMLElement {
       {
         name: "read_page",
         description: "Read the current page's structure (fields, buttons, route). Call after acting to observe the result within the same turn.",
-        parameters: { type: "object", properties: {}, required: [] },
+        parameters: {
+          type: "object",
+          properties: {},
+          required: [],
+          [X_SUMMARY_KEY]: "Read the page"
+        },
         handler: () => getPageMap()
       }
     ];
@@ -4107,6 +4149,7 @@ var AgUiChat = class extends HTMLElement {
     this.#streamingBubble = null;
     this.#hidePending();
     this.#toolCards.clear();
+    this.#serverSettled.clear();
     this.#initialMessages = [];
     this.#messages.replaceChildren();
     this.#threadId = this.conversationStore.threadId();
@@ -4130,16 +4173,53 @@ var AgUiChat = class extends HTMLElement {
       await this.#resumeFrom(checkpoint);
     }
   }
-  /** Render a restored message as a chat bubble (text turns only). */
+  /**
+   * Replay a restored message: text bubbles *and* tool activity. An assistant
+   * turn may carry `toolCalls` (rendered as cards) and/or text; a `tool` turn
+   * carries a result that settles the matching card. So a refreshed page shows
+   * the full transcript — tool calls and their results — not just the prose.
+   */
   #renderHistoricMessage(message) {
-    if (typeof message.content !== "string" || message.content === "") {
+    const text2 = typeof message.content === "string" ? message.content : "";
+    if (message.role === MESSAGE_ROLE.USER) {
+      if (text2 !== "") {
+        this.appendMessage(MESSAGE_ROLE.USER, text2);
+      }
       return;
     }
-    if (message.role === MESSAGE_ROLE.USER) {
-      this.appendMessage(MESSAGE_ROLE.USER, message.content);
-    } else if (message.role === MESSAGE_ROLE.ASSISTANT) {
-      this.#revealWords(this.appendMessage(MESSAGE_ROLE.ASSISTANT, message.content));
+    if (message.role === MESSAGE_ROLE.ASSISTANT) {
+      if (text2 !== "") {
+        this.appendMessage(MESSAGE_ROLE.ASSISTANT, text2).classList.add("message--restored");
+      }
+      const toolCalls = message.toolCalls;
+      if (toolCalls !== void 0) {
+        for (const call of toolCalls) {
+          this.#cardFor({
+            id: call.id,
+            name: call.function.name,
+            args: this.#parseArgs(call.function.arguments)
+          });
+        }
+      }
+      return;
+    }
+    if (message.role === "tool") {
+      const card = this.#toolCards.get(message.toolCallId);
+      if (card !== void 0) {
+        card.settle(TOOL_CALL_STATUS.DONE, message.content);
+      }
+    }
+  }
+  /** Parse a tool call's JSON `arguments` string from history into an object. */
+  #parseArgs(raw) {
+    try {
+      const parsed = JSON.parse(raw);
+      if (typeof parsed === "object" && parsed !== null) {
+        return parsed;
+      }
+    } catch {
     }
+    return {};
   }
   /**
    * Word-by-word reveal for the `word` text-animation mode, applied to a
@@ -4305,8 +4385,9 @@ var AgUiChat = class extends HTMLElement {
     this.#toolCards.delete(call.id);
     const tool = this.#resolveTool(call.name);
     if (tool === null) {
-      card.settle(TOOL_CALL_STATUS.DONE, "Executed on the server.");
-      this.#showPending();
+      if (!this.#serverSettled.has(call.id)) {
+        card.settle(TOOL_CALL_STATUS.DONE, "No result returned.");
+      }
       return null;
     }
     if (await this.#needsConfirmation(call, tool)) {
@@ -4358,15 +4439,27 @@ var AgUiChat = class extends HTMLElement {
       onTextDelta: (buffer) => {
         this.#hidePending();
         this.#streamInto(buffer);
+        this.#streamDeltas += 1;
       },
       onTextEnd: (buffer) => {
-        this.#revealWords(this.#streamInto(buffer));
+        const bubble = this.#streamInto(buffer);
+        if (this.#streamDeltas <= 1) {
+          this.#revealWords(bubble);
+        }
         this.#streamingBubble = null;
       },
       onToolCall: (call) => {
         this.#hidePending();
         this.#cardFor(call);
       },
+      onToolResult: (toolCallId, content) => {
+        const card = this.#toolCards.get(toolCallId);
+        if (card === void 0) {
+          return;
+        }
+        card.settle(TOOL_CALL_STATUS.DONE, content);
+        this.#serverSettled.add(toolCallId);
+      },
       onRunEnd: () => {
         this.#hidePending();
         this.#send.disabled = false;
@@ -4377,6 +4470,11 @@ var AgUiChat = class extends HTMLElement {
         this.#revealWords(this.appendMessage(MESSAGE_ROLE.ASSISTANT, `\u26A0\uFE0F ${message}`));
         this.#send.disabled = false;
         this.#streamingBubble = null;
+      },
+      onSettled: () => {
+        this.#hidePending();
+        this.#send.disabled = false;
+        this.#streamingBubble = null;
       }
     };
   }
@@ -4410,6 +4508,7 @@ var AgUiChat = class extends HTMLElement {
   #streamInto(buffer) {
     if (this.#streamingBubble === null) {
       this.#streamingBubble = this.appendMessage(MESSAGE_ROLE.ASSISTANT, "");
+      this.#streamDeltas = 0;
     }
     this.#streamingBubble.innerHTML = renderMarkdown(buffer);
     this.#messages.scrollTop = this.#messages.scrollHeight;
@@ -4426,13 +4525,9 @@ var AgUiChat = class extends HTMLElement {
     if (existing !== void 0) {
       return existing;
     }
-    const summary = this.#resolveTool(call.name)?.parameters[X_SUMMARY_KEY];
-    const card = new ToolCallCard(
-      call.name,
-      call.args,
-      this.toolDisplay,
-      typeof summary === "string" ? summary : void 0
-    );
+    const labelled = this.#resolveTool(call.name)?.parameters[X_SUMMARY_KEY];
+    const summary = typeof labelled === "string" ? labelled : this.toolSummaries[call.name];
+    const card = new ToolCallCard(call.name, call.args, this.toolDisplay, summary);
     this.#toolCards.set(call.id, card);
     this.#messages.appendChild(card.element);
     this.#messages.scrollTop = this.#messages.scrollHeight;
@@ -4604,7 +4699,7 @@ function setControlValue(el, value) {
 }
 
 // src/version.ts
-var VERSION = "0.2.0";
+var VERSION = "0.2.2";
 export {
   AgUiChat,
   AgUiClient,