@artooi/ag-ui-web-component 0.35.2 → 0.37.0

package/dist/ui/ui_strings.d.ts

@@ -89,6 +89,10 @@ export interface UiStrings {
     pageMoved: string;
     /** Notice when Send ran while a file was still uploading. Token: `{n}`. */
     attachmentsStillUploading: string;
+    /** Notice shown when a message was typed at an element with no `endpoint`. */
+    notConnected: string;
+    /** Composer hint when a run continuation was picked with an empty composer. */
+    continueNeedsTurn: string;
     /** `aria-label` of the message textarea. */
     message: string;
     /** Placeholder of the message textarea. */

package/dist/ui/ui_strings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui_strings.d.ts","sourceRoot":"","sources":["../../src/ui/ui_strings.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ui_strings.d.ts","sourceRoot":"","sources":["../../src/ui/ui_strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAS;IAExB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IAGpB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2EAA2E;IAC3E,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kFAAkF;IAClF,wBAAwB,EAAE,MAAM,CAAC;IACjC,mEAAmE;IACnE,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB;oDACgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,eAAe,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,eAAe,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,yBAAyB,EAAE,MAAM,CAAC;IAClC,8EAA8E;IAC9E,YAAY,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,iBAAiB,EAAE,MAAM,CAAC;IAG1B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IAGvB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAGhB;;;;;;OAMG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oEAAoE;IACpE,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;IAGtB,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uEAAuE;IACvE,uBAAuB,EAAE,MAAM,CAAC;IAChC,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB;;8CAE0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,aAAa,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IAGf,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IAGb,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IAGf,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IAGrB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,gBAAgB,EAAE,MAAM,CAAC;IAGzB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IAGnB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAGlB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,EAAE,SAmIhC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CASvE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artooi/ag-ui-web-component",
-  "version": "0.35.2",
+  "version": "0.37.0",
   "description": "Framework-free <ag-ui-chat> Web Component over the AG-UI protocol. Drop-in chat sidebar with a pluggable client-side tool registry, DOM driver primitives, animations, and destructive-action confirmation modal.",
   "type": "module",
   "main": "./dist/index.js",

package/src/constants.ts

@@ -263,6 +263,32 @@ export const TOOL_CALL_STATUS = {
   DECLINED: "declined",
 } as const;
 
+/**
+ * How a tool call ended, as the server states it on `TOOL_CALL_RESULT`.
+ *
+ * The vocabulary is pydantic-ai's own `ToolReturnPart.outcome`, carried whole
+ * rather than re-spelled, so the four repos that pass a refusal along agree on
+ * one word for it.
+ *
+ * **Absent means {@link TOOL_OUTCOME.SUCCESS}, and that is load-bearing.** Every
+ * server written before the field existed omits it, so a missing field has to
+ * render exactly as a plain result did — which is why this is an optional
+ * annotation on the event and not a required one. `FAILED` is a call that ran
+ * and failed; `DENIED` is one a person or a guard refused, so it never ran at
+ * all. The two are worth distinguishing on screen because only the second is
+ * something the user did.
+ *
+ * Anything *else* on the wire — a value from a later protocol version, or
+ * pydantic-ai's own `interrupted` — is read as a success rather than rejected.
+ * A card is a claim about what happened, and "I do not know this word" is not
+ * grounds for claiming failure. `toolStatusFromOutcome` is where that is done.
+ */
+export const TOOL_OUTCOME = {
+  SUCCESS: "success",
+  FAILED: "failed",
+  DENIED: "denied",
+} as const;
+
 /**
  * Lifecycle status of a pending-attachment chip in the composer tray. A chip
  * opens as `UPLOADING` (with a progress bar), then settles to `READY` (a durable

package/src/core/ag_ui_chat.ts

@@ -35,6 +35,7 @@ import {
   TOGGLE_EVENT,
   TOOL_CALL_STATUS,
   TOOL_DISPLAY,
+  TOOL_OUTCOME,
   UNREAD_EVENT,
   X_CONFIRM_KEY,
   X_SUMMARY_KEY,
@@ -144,6 +145,7 @@ import {
 import { type AgentFactory, createHttpAgent } from "./create_http_agent.js";
 import { RemoteConversationStore } from "./remote_conversation_store.js";
 import { RunIndex } from "./run_index.js";
+import { toolStatusFromOutcome } from "./tool_outcome.js";
 import { type TranscribeHandler, transcribeAudio } from "./transcribe_audio.js";
 import { type UploadHandler, uploadAttachment } from "./upload_attachment.js";
 import { mintThread, warnOnCrossOriginCredentials, withCredentials } from "./utils.js";
@@ -827,7 +829,17 @@ export class AgUiChat extends HTMLElement {
   readonly #checkpoints: CheckpointMenu;
   /** Built lazily from `data-runs-url`; `null` when the host didn't opt in. */
   #runIndex: RunIndex | null = null;
-  readonly #skillHint: HTMLDivElement;
+  /**
+   * The one-line hint above the composer, cleared by the next keystroke.
+   *
+   * Two things write it -- a skill whose template is short of a field, and a
+   * run continuation picked with nothing typed -- and both say the same kind of
+   * thing: what the composer still needs before this can go. Its `part` stays
+   * `skill-hint`, which the skills feature named and the README documents;
+   * renaming a part is breaking, and a second hint element in the same slot
+   * would be worse than one whose name is a release older than its job.
+   */
+  readonly #composerHint: HTMLDivElement;
   /** File-picker button + hidden input + tray slot; the tray mounts on connect. */
   readonly #attachButton: HTMLButtonElement;
   readonly #fileInput: HTMLInputElement;
@@ -1050,7 +1062,7 @@ export class AgUiChat extends HTMLElement {
     this.#input = document.createElement("textarea");
     this.#send = document.createElement("button");
     this.#title = document.createElement("span");
-    this.#skillHint = document.createElement("div");
+    this.#composerHint = document.createElement("div");
     this.#attachButton = document.createElement("button");
     this.#fileInput = document.createElement("input");
     this.#attachSlot = document.createElement("div");
@@ -1142,10 +1154,29 @@ export class AgUiChat extends HTMLElement {
   async #continueRun(runId: string, verb: CheckpointVerb): Promise<void> {
     const index = this.#runs();
     if (index === null) {
+      // Unreachable from the built-in control: the header button is only
+      // rendered when `#runs()` is configured, so a row to pick cannot exist
+      // without one. A host calling `openCheckpoints()` regardless gets the
+      // documented empty panel, which has no rows either. Typed, not silent.
       return;
     }
     const content = this.#input.value.trim();
     if (content === "") {
+      // A continuation sends *only* the next turn -- the snapshot supplies
+      // everything before it -- so with an empty composer there is nothing to
+      // send. Returning here was the same failure the endpoint guard above had:
+      // the row's button closes the panel before this runs, so the widget
+      // visibly reacted and then did nothing, which reads as a resume that was
+      // attempted and lost rather than one that never started.
+      //
+      // Said at the composer rather than in the transcript, because that is
+      // where the fix goes and because the hint clears itself on the first
+      // keystroke -- a transcript notice for a recoverable slip would outlive
+      // the slip. Focus follows for the same reason `#applySkill` moves it when
+      // a template is short of a field.
+      this.#composerHint.textContent = this.#strings.continueNeedsTurn;
+      this.#composerHint.hidden = false;
+      this.#input.focus();
       return;
     }
     this.#input.value = "";
@@ -1803,21 +1834,45 @@ export class AgUiChat extends HTMLElement {
     return value !== null && value !== "false";
   }
 
-  /** Parse the inline `data-strings` JSON overrides (empty when absent/malformed). */
-  #readStringOverrides(): Partial<UiStrings> {
-    const raw = this.getAttribute("data-strings");
+  /**
+   * Parse a JSON-valued attribute, saying so when it will not parse.
+   *
+   * `null` for an absent attribute, and `null` again for one that is not JSON --
+   * but not quietly the second time. Quoting JSON inside an HTML attribute is
+   * fiddly, and the result of getting it wrong is indistinguishable from the
+   * feature being switched off: no chips appear, or the strings stay English,
+   * with nothing anywhere saying why. That is the same failure `data-paste-attach`
+   * already reports for a value it cannot read.
+   *
+   * Console only. A page author's typo is not the reader's business, nothing the
+   * reader did was refused, and the degraded widget is still perfectly usable.
+   */
+  #readJsonAttribute(name: string): unknown {
+    const raw = this.getAttribute(name);
     if (raw === null) {
-      return {};
+      return null;
     }
     try {
-      const parsed: unknown = JSON.parse(raw);
-      if (typeof parsed === "object" && parsed !== null) {
-        return parsed as Partial<UiStrings>;
-      }
+      return JSON.parse(raw);
     } catch {
-      // Malformed JSON — fall back to the defaults rather than failing to mount.
+      console.warn(
+        `<ag-ui-chat>: ${name} is not valid JSON, so it was ignored entirely and ` +
+          "the built-in default is being used. Check the quoting -- JSON inside " +
+          "an HTML attribute needs single quotes around the attribute value, or " +
+          "its own double quotes escaped.",
+      );
+      return null;
     }
-    return {};
+  }
+
+  /** Parse the inline `data-strings` JSON overrides (empty when absent/malformed). */
+  #readStringOverrides(): Partial<UiStrings> {
+    const parsed = this.#readJsonAttribute("data-strings");
+    // A JSON number or string parses fine and overrides nothing. Not warned
+    // about separately: it is the same "this attribute did not take effect"
+    // as a parse failure, and the warning above already covers the spelling
+    // that produces it by accident.
+    return typeof parsed === "object" && parsed !== null ? (parsed as Partial<UiStrings>) : {};
   }
 
   /**
@@ -2276,15 +2331,9 @@ export class AgUiChat extends HTMLElement {
 
   /** Parse the inline `data-skills` JSON catalog (empty when absent/malformed). */
   #readEmbeddedSkills(): readonly Skill[] {
-    const raw = this.getAttribute("data-skills");
-    if (raw === null) {
-      return [];
-    }
-    try {
-      return parseSkills(JSON.parse(raw));
-    } catch {
-      return [];
-    }
+    // `parseSkills` drops anything that is not a well-formed skill, `null`
+    // included, so the absent and unparseable cases need no branch here.
+    return parseSkills(this.#readJsonAttribute("data-skills"));
   }
 
   /** Fetch the backend skills catalog from `data-skills-url`, if set. */
@@ -2327,7 +2376,7 @@ export class AgUiChat extends HTMLElement {
    */
   #applySkill(skill: Skill): void {
     if (skill.prompt === undefined) {
-      this.#skillHint.hidden = true;
+      this.#composerHint.hidden = true;
       void this.sendMessage(`/${skill.name}`);
       return;
     }
@@ -2339,17 +2388,17 @@ export class AgUiChat extends HTMLElement {
       // keystroke replaces it. Blocking with a hint alone left whatever the
       // user had typed to open the palette — a lone "/" — sitting there, which
       // says nothing about what the skill wanted or how to give it.
-      this.#skillHint.textContent = this.#strings.skillNeeds
+      this.#composerHint.textContent = this.#strings.skillNeeds
         .replace("{title}", skill.title)
         .replace("{fields}", missing.join(", "));
-      this.#skillHint.hidden = false;
+      this.#composerHint.hidden = false;
       this.#input.value = text;
       this.#autoGrow();
       this.#input.focus();
       this.#selectFirstPlaceholder(text);
       return;
     }
-    this.#skillHint.hidden = true;
+    this.#composerHint.hidden = true;
     this.#input.value = text;
     this.#autoGrow();
     if (skill.sendImmediately === false) {
@@ -3995,7 +4044,17 @@ export class AgUiChat extends HTMLElement {
     if (message.role === "tool") {
       const card = this.#toolCards.get(message.toolCallId);
       if (card !== undefined) {
-        card.settle(TOOL_CALL_STATUS.DONE, message.content);
+        // The outcome `AgUiClient` annotated onto the persisted message, read
+        // back through the same mapping the live path uses -- so a card that
+        // said "declined" before the reload still says it after. Narrowed off
+        // `unknown` rather than trusted, like every other field read out of the
+        // store: `Message` does not declare it, a host store may not round-trip
+        // it, and history written before this shipped has none. All three land
+        // on DONE, which is what this line did unconditionally.
+        card.settle(
+          toolStatusFromOutcome((message as { outcome?: unknown }).outcome),
+          message.content,
+        );
       }
     }
   }
@@ -4306,9 +4365,9 @@ export class AgUiChat extends HTMLElement {
       void this.#submit();
     });
 
-    this.#skillHint.className = "skill-hint";
-    this.#skillHint.setAttribute("part", "skill-hint");
-    this.#skillHint.hidden = true;
+    this.#composerHint.className = "skill-hint";
+    this.#composerHint.setAttribute("part", "skill-hint");
+    this.#composerHint.hidden = true;
 
     // File-upload affordance: a paperclip button (hidden until
     // `data-attachments-url` is wired) opening a hidden multi-file input.
@@ -4340,8 +4399,9 @@ export class AgUiChat extends HTMLElement {
     tools.append(this.#attachButton, this.#voiceSlot, this.#send);
     composer.append(this.#input, tools);
     inputRow.append(composer, this.#fileInput);
-    // Skill surfaces sit just above the input: palette (opens on `/`), chips,
-    // the missing-placeholder hint, and the pending-attachments tray.
+    // Composer surfaces sit just above the input: the skills palette (opens on
+    // `/`), the chips, the hint saying what the composer still needs, and the
+    // pending-attachments tray.
     this.#messagesWrap.className = "messages-wrap";
     // Sibling of the list inside a shared box, not a child of it: the
     // affordance offering to scroll must not scroll away with the content.
@@ -4352,7 +4412,7 @@ export class AgUiChat extends HTMLElement {
       this.#messagesWrap,
       this.#skillsMenu.palette,
       this.#skillsMenu.chips,
-      this.#skillHint,
+      this.#composerHint,
       this.#queuedRow,
       this.#attachSlot,
       inputRow,
@@ -4677,10 +4737,16 @@ export class AgUiChat extends HTMLElement {
     this.#emptyWrap.hidden = this.#messages.childElementCount > 1;
   }
 
-  /** Forward input changes to the skills palette and clear any stale hint. */
+  /**
+   * Forward input changes to the skills palette and clear any stale hint.
+   *
+   * Typing is the answer to every hint that surface carries -- a skill short of
+   * a field, a continuation short of its next turn -- so the keystroke that
+   * starts answering it is the right moment to take it down.
+   */
   #onInput(): void {
     this.#skillsMenu.onInput(this.#input.value);
-    this.#skillHint.hidden = true;
+    this.#composerHint.hidden = true;
     this.#autoGrow();
     // Typing puts the composer back in the user's hands: the next ArrowUp
     // starts from the newest turn again rather than continuing a walk through
@@ -4980,8 +5046,39 @@ export class AgUiChat extends HTMLElement {
     );
   }
 
+  /**
+   * Hand the message to the client, or say why it is going nowhere.
+   *
+   * With no `endpoint` there is nothing to send to, and this used to return
+   * here in silence. That is the worst shape the failure can take, because the
+   * two halves of a send that *did* work have already happened by now: the
+   * user's bubble is on screen and {@link SUBMIT_EVENT} has been dispatched. So
+   * the message looks sent, the composer is empty, the Send button never turns
+   * into Stop, and no request is ever made -- an unanswered question rather
+   * than a broken widget. Nothing reached the console either, so the developer
+   * had no thread to pull and the user had no reason to think anything was
+   * wrong with the page.
+   *
+   * Both audiences are told, because they need different things. The console
+   * carries the developer's version -- the attribute is missing, here is what
+   * to set -- since a missing attribute is a page's mistake and not the
+   * reader's. The transcript carries the reader's, because they are looking at
+   * their own message waiting for a reply that cannot come, and the honest
+   * alternative to one muted line is an indefinite wait.
+   *
+   * Said on every attempt rather than once. Each send is a separate thing the
+   * user asked for and did not get, and a once-only report is silence for every
+   * attempt after the first -- which is the defect again, just later.
+   */
   async #client_send(content: string, attachments: readonly AttachmentRef[]): Promise<void> {
     if (this.endpoint === "") {
+      console.error(
+        "<ag-ui-chat>: no endpoint is set, so this message was not sent and no " +
+          "request was made. Point the element at your AG-UI mount with the " +
+          'endpoint attribute (endpoint="/agent/"), or assign chat.endpoint ' +
+          "before sending.",
+      );
+      this.#appendNotice("⚠", this.#strings.notConnected, "not-connected");
       return;
     }
     await this.#ensureClient().send(content, attachments);
@@ -5175,7 +5272,9 @@ export class AgUiChat extends HTMLElement {
       const message = this.#strings.pageMoved;
       card.settle(TOOL_CALL_STATUS.ERROR, message);
       this.#showPending();
-      return { content: `Error: ${message}`, error: message };
+      // Stated so a reload settles this card the same way. The card's own status
+      // lives only in the DOM, and the DOM is what a reload throws away.
+      return { content: `Error: ${message}`, error: message, outcome: TOOL_OUTCOME.FAILED };
     }
     const rule = await this.#confirmationRule(call, tool);
     if (rule !== null) {
@@ -5208,7 +5307,11 @@ export class AgUiChat extends HTMLElement {
         const message = this.#strings.declinedAction;
         card.settle(TOOL_CALL_STATUS.DECLINED, message);
         this.#showPending();
-        return { content: message };
+        // The one outcome with no error text and no server involvement at all:
+        // a person said no in this browser. Nothing else records that, so
+        // without the annotation the reload showed a green card for an action
+        // the user had explicitly refused.
+        return { content: message, outcome: TOOL_OUTCOME.DENIED };
       }
     }
     // A navigating tool reloads only without a client-side router; with a
@@ -5251,7 +5354,7 @@ export class AgUiChat extends HTMLElement {
       const message = error instanceof Error ? error.message : String(error);
       card.settle(TOOL_CALL_STATUS.ERROR, message);
       this.#showPending();
-      return { content: `Error: ${message}`, error: message };
+      return { content: `Error: ${message}`, error: message, outcome: TOOL_OUTCOME.FAILED };
     }
   }
 
@@ -5516,12 +5619,18 @@ export class AgUiChat extends HTMLElement {
         // got for compaction, one handler up.
         this.#appendNotice("\u{1F504}", this.#strings.historyReplaced, "history-replaced");
       },
-      onToolResult: (toolCallId, content) => {
+      onToolResult: (toolCallId, content, outcome) => {
         const card = this.#toolCards.get(toolCallId);
         if (card === undefined) {
           return;
         }
-        card.settle(TOOL_CALL_STATUS.DONE, content);
+        // Settled as the server says it ended, not as "it ended". This path used
+        // to pass DONE unconditionally, so a refusal arrived as a green card
+        // with the reason folded inside it -- a booking the server declined
+        // read, at a glance, as a booking that was made. An absent or
+        // unrecognised outcome still means DONE, so every server written before
+        // the field existed renders exactly as it did.
+        card.settle(toolStatusFromOutcome(outcome), content);
         this.#serverSettled.add(toolCallId);
         // The card stops being the live thing the moment it settles, and the
         // server goes straight back to the model with the result -- a wait with

package/src/core/agui_client.ts

@@ -8,6 +8,7 @@ import {
 import type { Context, Interrupt, Message, ResumeEntry, Tool } from "@ag-ui/core";
 import { MAX_TOOL_ROUNDS } from "../constants.js";
 import type { AttachmentRef } from "./attachment.js";
+import type { ToolOutcome } from "./tool_outcome.js";
 
 /** A tool call surfaced to the host by {@link AgUiClient}. */
 export interface AgUiToolCall {
@@ -22,6 +23,18 @@ export interface ToolExecution {
   content: string;
   /** Present when the handler failed; surfaced for logging. */
   error?: string;
+  /**
+   * How the call ended, in the same vocabulary a server states on
+   * `TOOL_CALL_RESULT`. Omit for a success -- absent *is* success, here for the
+   * same reason it is on the wire.
+   *
+   * Distinct from {@link error}, which is a *message* and only exists for the
+   * one failure shape that produces one. A refusal has no error and is still
+   * not a success, and that is the case this field exists for: without it a
+   * declined call was persisted as an ordinary result and came back from a
+   * reload as a green card.
+   */
+  outcome?: ToolOutcome;
   /**
    * When `true`, a navigating tool triggered a page reload. The loop stops
    * without appending a result — the result is supplied after the next mount
@@ -76,8 +89,19 @@ export interface AgUiClientHandlers {
    * 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.
+   *
+   * `outcome` is the event's optional `outcome` field, forwarded raw. It is
+   * `unknown` rather than {@link ToolOutcome} because it comes off a
+   * `passthrough` zod schema: the protocol does not validate it, so neither can
+   * this signature honestly claim to. Read it with `toolStatusFromOutcome`,
+   * which treats `undefined` and anything unrecognised as a success.
+   *
+   * Added as a third parameter rather than as a new callback, so an
+   * implementation written against the two-parameter form still satisfies this
+   * interface and still behaves exactly as it did — which is the same
+   * backwards-compatibility promise the wire field makes.
    */
-  onToolResult(toolCallId: string, content: string): void;
+  onToolResult(toolCallId: string, content: string, outcome?: unknown): void;
   /**
    * Fired for AG-UI activity events — ambient notices about what the *run* did,
    * as opposed to work the agent asked for. `django-ag-ui` emits one with
@@ -259,6 +283,25 @@ export class AgUiClient {
    * set would miss entirely.
    */
   readonly #closedMessageIds = new Set<string>();
+  /**
+   * How each tool call ended, keyed by call id, for the transcript this client
+   * persists.
+   *
+   * A side table rather than a field written onto the message, because neither
+   * producer of a tool message will carry it. `@ag-ui/client` builds the
+   * server-side one by destructuring five named fields off the event, so an
+   * `outcome` beside them is dropped before the message exists; and writing it
+   * back onto that message afterwards would put it in `agent.messages`, which is
+   * what the *next* request sends to the server. This keeps the annotation on
+   * the copy handed to the store and off the wire.
+   *
+   * Per client, not per run: `saveMessages` rewrites the whole transcript on
+   * every persist, so an outcome recorded in round one has to still be here in
+   * round five or the earlier card silently reverts to a green one. Bounded by
+   * the number of tool calls in the conversation, which the transcript beside it
+   * already is.
+   */
+  readonly #outcomes = new Map<string, string>();
   readonly #connectionLostMessage: string;
   readonly #maxToolRounds: number;
   // Set by cancel(); reset at the top of each #run(). Checked by the loop so
@@ -334,7 +377,7 @@ export class AgUiClient {
       (message as { attachments?: readonly AttachmentRef[] }).attachments = attachments;
     }
     this.#agent.addMessage(message);
-    this.#onPersist(this.#agent.messages);
+    this.#persist();
     await this.#run();
   }
 
@@ -373,7 +416,7 @@ export class AgUiClient {
     }
     const kept = messages.slice(0, lastUser + 1);
     this.#agent.setMessages(kept);
-    this.#onPersist(this.#agent.messages);
+    this.#persist();
     return kept;
   }
 
@@ -389,7 +432,7 @@ export class AgUiClient {
   /** Append a frontend tool result to history (used by the resume path). */
   addToolResult(toolCallId: string, content: string): void {
     this.#agent.addMessage({ id: randomUUID(), role: "tool", content, toolCallId });
-    this.#onPersist(this.#agent.messages);
+    this.#persist();
   }
 
   /**
@@ -428,10 +471,42 @@ export class AgUiClient {
   #onCancelled(): void {
     // Persist so the truncated exchange, partial assistant text included,
     // survives a reload.
-    this.#onPersist(this.#agent.messages);
+    this.#persist();
     this.#handlers.onCancelled();
   }
 
+  /**
+   * Hand the transcript to the host's store, annotated with what {@link #outcomes}
+   * knows about how each tool call ended.
+   *
+   * Every persist in this class goes through here, because the store keeps only
+   * the most recent list: annotating one call site would mean the next
+   * unannotated save quietly threw the annotations away.
+   */
+  #persist(): void {
+    const messages = this.#agent.messages;
+    if (this.#outcomes.size === 0) {
+      this.#onPersist(messages);
+      return;
+    }
+    // A copy, and only of the messages that gain something. `agent.messages` is
+    // the list the next `runAgent` sends back to the server, so writing an extra
+    // field into it would put a client-side annotation on the wire; a store is
+    // allowed to hold more than the protocol does.
+    this.#onPersist(
+      messages.map((message) => {
+        if (message.role !== "tool") {
+          return message;
+        }
+        const outcome = this.#outcomes.get(message.toolCallId);
+        // Cast at the AG-UI boundary, as the `attachments` augmentation on a
+        // user message already does: `Message` does not declare the field, and
+        // the default store round-trips it through `JSON.stringify` verbatim.
+        return outcome === undefined ? message : ({ ...message, outcome } as Message);
+      }),
+    );
+  }
+
   async #runLoop(): Promise<void> {
     // Carries resolved approval answers into the next run when a round finished
     // on a server-side-tool interrupt. Distinct from the public resume(), which
@@ -455,7 +530,7 @@ export class AgUiClient {
       }
       await this.#agent.runAgent(params, this.#buildSubscriber(pending, runState));
       resume = undefined;
-      this.#onPersist(this.#agent.messages);
+      this.#persist();
       // Cancelled mid-stream: don't execute the tool calls collected before the
       // abort.
       if (this.#cancelled) {
@@ -503,13 +578,21 @@ export class AgUiClient {
           // next mount. Stop here rather than re-running into a dead context.
           return;
         }
+        // Recorded before the persist below, so the very first save of this
+        // message already carries how it ended. A frontend tool's refusal or
+        // failure never touches the wire's `outcome` field -- no server states
+        // it, because no server ran the call -- so this side table is the only
+        // record there is, and a reload reads a card off it.
+        if (result.outcome !== undefined) {
+          this.#outcomes.set(call.id, result.outcome);
+        }
         this.#agent.addMessage({
           id: randomUUID(),
           role: "tool",
           content: result.content,
           toolCallId: call.id,
         });
-        this.#onPersist(this.#agent.messages);
+        this.#persist();
         executed = true;
       }
       if (!executed) {
@@ -521,6 +604,7 @@ export class AgUiClient {
   #buildSubscriber(pending: AgUiToolCall[], runState: RunState): AgentSubscriber {
     const h = this.#handlers;
     const closed = this.#closedMessageIds;
+    const outcomes = this.#outcomes;
     // Read at event time, not captured now: the flag flips mid-run, and the
     // subscriber is built before the run that a later `cancel()` stops.
     const cancelled = (): boolean => this.#cancelled;
@@ -562,7 +646,20 @@ export class AgUiClient {
         h.onToolCall(call);
       },
       onToolCallResultEvent({ event }) {
-        h.onToolResult(event.toolCallId, event.content);
+        // Bracket access because the field is not declared: `TOOL_CALL_RESULT`
+        // extends a `passthrough` schema, so an unknown key survives parsing and
+        // arrives here typed only by the catch-all index signature. That is the
+        // whole mechanism the outcome rides -- no schema change in `@ag-ui/core`
+        // is needed for a server to state one.
+        const outcome = event["outcome"];
+        // Recorded even when it is a word this client does not recognise, and
+        // even when it says "success": the store is a record of what the server
+        // said, and re-reading it through the same mapping as the live path is
+        // what keeps a reload agreeing with what the user watched happen.
+        if (typeof outcome === "string") {
+          outcomes.set(event.toolCallId, outcome);
+        }
+        h.onToolResult(event.toolCallId, event.content, outcome);
       },
       onActivitySnapshotEvent({ event, messages }) {
         // A snapshot for an id already in the list is a replacement, not a new

package/src/core/tool_outcome.ts

@@ -0,0 +1,36 @@
+import { TOOL_CALL_STATUS, TOOL_OUTCOME } from "../constants.js";
+import type { SettledStatus } from "../ui/tool_call_card.js";
+
+/**
+ * How a tool call ended, in the wire's own words. See {@link TOOL_OUTCOME}.
+ *
+ * Absent is the fourth case and the common one: a server that has never heard
+ * of the field says nothing, and nothing means success.
+ */
+export type ToolOutcome = (typeof TOOL_OUTCOME)[keyof typeof TOOL_OUTCOME];
+
+/**
+ * The card status a wire outcome settles into.
+ *
+ * Takes `unknown` rather than {@link ToolOutcome} on purpose: both callers read
+ * this off a boundary the type system does not police -- a `passthrough` field
+ * on an AG-UI event, and a JSON blob out of the conversation store -- so the
+ * narrowing belongs here, once, instead of at each of them.
+ *
+ * **Everything unrecognised maps to `DONE`.** Not because unknown values are
+ * expected to be successes, but because the alternative is worse in the
+ * direction that matters: a card claiming a call failed when it did not is a
+ * lie the user acts on, while a card claiming success has at least the result
+ * text under it for them to read. `interrupted` is the concrete case today --
+ * pydantic-ai emits it, this vocabulary does not carry it, and a future release
+ * may add more. Forward compatibility is the point of the open field.
+ */
+export function toolStatusFromOutcome(outcome: unknown): SettledStatus {
+  if (outcome === TOOL_OUTCOME.FAILED) {
+    return TOOL_CALL_STATUS.ERROR;
+  }
+  if (outcome === TOOL_OUTCOME.DENIED) {
+    return TOOL_CALL_STATUS.DECLINED;
+  }
+  return TOOL_CALL_STATUS.DONE;
+}