@artooi/ag-ui-web-component 0.31.1 → 0.32.0

package/dist/ui/subagent_panel.d.ts

@@ -78,6 +78,15 @@ export declare class SubAgentPanel {
     #private;
     /** The panel's root; append this into the delegating card's slot. */
     readonly element: HTMLDivElement;
+    /**
+     * The child agent's name, as the last update that carried one gave it.
+     *
+     * Read back rather than only written to the DOM, because the two carriers
+     * split the name away from the close: `SUBAGENT_STARTED` names the agent and
+     * `SUBAGENT_FINISHED` carries only an id, so whoever words the closing line
+     * has to recover the name from what the delegation already told it.
+     */
+    get agent(): string | null;
     constructor(strings?: UiStrings);
     /**
      * Fold one announcement in.

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

@@ -1 +1 @@
-{"version":3,"file":"subagent_panel.d.ts","sourceRoot":"","sources":["../../src/ui/subagent_panel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErE,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEjF;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,aAAa;;IACxB,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAejC,YAAY,OAAO,GAAE,SAA8B,EA2ClD;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAWnC;CAmDF"}
+{"version":3,"file":"subagent_panel.d.ts","sourceRoot":"","sources":["../../src/ui/subagent_panel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErE,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEjF;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,aAAa;;IACxB,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC;;;;;;;OAOG;IACH,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,CAEzB;IAgBD,YAAY,OAAO,GAAE,SAA8B,EA2ClD;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAYnC;CAmDF"}

package/dist/ui/subagent_update.d.ts

@@ -5,6 +5,15 @@
  * renderer: the panel's job is drawing, and a value that reaches it has already
  * been vouched for.
  *
+ * **The three lifecycle phases are still accepted here, deliberately.** A current
+ * server sends only `tool_call` and `tool_result` on this carrier -- the
+ * delegation's lifetime moved to the protocol's `SUBAGENT_*` events -- but a
+ * server one release older sends all five, and this element is published and
+ * vendored separately from it. Continuing to narrow the older shape costs
+ * nothing (the panel needs those phases as visual states regardless) and is the
+ * difference between a mixed-version pair that degrades and one that shows a
+ * delegation which never opens.
+ *
  * Defensive about the payload, not about the name. A `CUSTOM` event's `value` is
  * `unknown` by the protocol, so a server can put anything there, and a malformed
  * announcement must not take a run down with it — the same rule the invalidation

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

@@ -1 +1 @@
-{"version":3,"file":"subagent_update.d.ts","sourceRoot":"","sources":["../../src/ui/subagent_update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAA+B,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA4CvF,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAiBpE"}
+{"version":3,"file":"subagent_update.d.ts","sourceRoot":"","sources":["../../src/ui/subagent_update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAA+B,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA4CvF,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAiBpE"}

package/dist/ui/ui_strings.d.ts

@@ -131,6 +131,25 @@ export interface UiStrings {
      * must never be blank.
      */
     subAgentWorking: string;
+    /**
+     * The row's line while a delegation is running. Token: `{agent}`.
+     *
+     * Worded here rather than on the wire, unlike the two step phases. The
+     * protocol's `SUBAGENT_STARTED` carries the sub-agent's `name` and no rendered
+     * status -- which is the better shape for a localised UI, and the reason this
+     * string exists at all.
+     */
+    subAgentDelegatedTo: string;
+    /** The row's line once a delegation completed. Token: `{agent}`. */
+    subAgentFinished: string;
+    /**
+     * The row's line for a delegation that failed and named no agent.
+     *
+     * A fallback only: `SUBAGENT_ERROR` carries a required `message`, which the
+     * server fills with the sub-agent's name and nothing else, and that text is
+     * what the row shows. This covers a server that sent an empty one.
+     */
+    subAgentFailed: string;
     /** `aria-label` of the region holding the sub-agent's own tool calls. */
     subAgentSteps: string;
     /** `aria-label` of the editable arguments field on an approval card. */

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":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artooi/ag-ui-web-component",
-  "version": "0.31.1",
+  "version": "0.32.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",
@@ -54,8 +54,8 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@ag-ui/client": ">=0.0.54 <0.1",
-    "@ag-ui/core": ">=0.0.54 <0.1",
+    "@ag-ui/client": ">=0.0.59 <0.1",
+    "@ag-ui/core": ">=0.0.59 <0.1",
     "dompurify": "^3.4.13",
     "marked": "^18.0.9"
   },

package/src/constants.ts

@@ -120,7 +120,7 @@ export const SUGGESTIONS_ACTIVITY_TYPE = "suggestions";
 export const INVALIDATE_CUSTOM_NAME = "ag_ui.invalidate";
 
 /**
- * The AG-UI `CUSTOM` event `name` carrying a delegated sub-agent's progress.
+ * The AG-UI `CUSTOM` event `name` carrying one step a delegated sub-agent took.
  *
  * Matched exactly, and namespaced the way {@link INVALIDATE_CUSTOM_NAME} is, so
  * it cannot collide with a host's own custom events on the same open field.
@@ -130,25 +130,44 @@ export const INVALIDATE_CUSTOM_NAME = "ag_ui.invalidate";
  * describes is already on screen and the progress belongs beside it. Every other
  * name still reaches the host as {@link CUSTOM_AGENT_EVENT}.
  *
+ * **This carries the steps only.** The delegation's own lifetime arrives on the
+ * protocol's `SUBAGENT_STARTED` / `SUBAGENT_FINISHED` / `SUBAGENT_ERROR` events,
+ * which name the same card through their `parentToolCallId`. The two are joined
+ * by that id, which is why the panel is keyed on it rather than on the
+ * `subagentRunId` the protocol's events carry.
+ *
  * Deliberately on the imperative carrier and not on an activity, which means it
  * is **never persisted and never replayed**. That is the right half of the
  * split: a delegation that was live an hour ago is not live now, and replaying
  * its progress on a thread restore would be a lie about a run that is over. On a
- * reload mid-run the nested detail is gone and the tool card remains.
+ * reload mid-run the nested detail is gone and the tool card remains. The three
+ * lifecycle events share that property -- `@ag-ui/client` dispatches them to
+ * subscribers without writing them into `agent.messages` -- which is what made
+ * them safe to adopt while the steps stayed here.
  */
 export const SUBAGENT_CUSTOM_NAME = "ag_ui.subagent";
 
 /**
- * The phases one delegation moves through, as the server spells them.
+ * The phases one delegation moves through, as the panel draws them.
  *
  * Exactly one `STARTED` opens a delegation and exactly one `FINISHED` or
  * `FAILED` closes it; the two tool phases repeat in between, once per call the
  * child makes and once per result it gets back.
  *
- * `FAILED` carries **no exception text**, deliberately — the same reasoning that
- * redacts a `RUN_ERROR`, since an exception's words are written for an operator.
- * The detail rides the ordinary `TOOL_CALL_RESULT` for that delegation, on the
- * card the progress is already attached to.
+ * **These are this element's five visual states, and they no longer come off one
+ * wire.** `TOOL_CALL` and `TOOL_RESULT` are spelled by the server, on the
+ * {@link SUBAGENT_CUSTOM_NAME} payload's `phase` field. The other three are this
+ * element's own names for the protocol's `SUBAGENT_STARTED` / `SUBAGENT_FINISHED`
+ * / `SUBAGENT_ERROR` events, which carry no phase field of their own because the
+ * event type *is* the phase. Keeping one vocabulary is what lets the panel stay
+ * a single state machine with one `data-phase` attribute for a host to style.
+ *
+ * `FAILED` carries **no exception text** from us — the protocol's error event
+ * has a required `message`, and the server sends only the sub-agent's name in
+ * it, on the same reasoning that redacts a `RUN_ERROR`, since an exception's
+ * words are written for an operator. The detail rides the ordinary
+ * `TOOL_CALL_RESULT` for that delegation, on the card the progress is already
+ * attached to.
  */
 export const SUBAGENT_PHASE = {
   STARTED: "started",

package/src/core/ag_ui_chat.ts

@@ -22,6 +22,7 @@ import {
   RUN_FINISHED_EVENT,
   STATE_EVENT,
   SUBAGENT_CUSTOM_NAME,
+  SUBAGENT_PHASE,
   SUBMIT_EVENT,
   SUGGESTIONS_ACTIVITY_TYPE,
   TOGGLE_EVENT,
@@ -82,7 +83,7 @@ import { renderRunNotice } from "../ui/run_notice.js";
 import { SkillsMenu } from "../ui/skills_menu.js";
 import { createStickToBottom, type StickToBottom } from "../ui/stick_to_bottom.js";
 import { STYLES } from "../ui/styles.js";
-import { SubAgentPanel } from "../ui/subagent_panel.js";
+import { SubAgentPanel, type SubAgentPhase, type SubAgentUpdate } from "../ui/subagent_panel.js";
 import { subAgentUpdate } from "../ui/subagent_update.js";
 import { renderSuggestionChips } from "../ui/suggestion_chips.js";
 import { ThoughtsBlock } from "../ui/thoughts_block.js";
@@ -630,6 +631,17 @@ export class AgUiChat extends HTMLElement {
    * approval prompt already uses.
    */
   readonly #subagentPanels = new Map<string, SubAgentPanel>();
+  /**
+   * Which delegation each live `subagentRunId` belongs to.
+   *
+   * The protocol's closing events -- `SUBAGENT_FINISHED` and `SUBAGENT_ERROR`
+   * -- carry the child's run id and nothing else, while everything drawn here
+   * is keyed on the parent's `delegate_task` call id. `SUBAGENT_STARTED` is the
+   * one event carrying both, so the pairing is recorded there and read back on
+   * the close. A close naming a run this never saw open is dropped, which is
+   * the same refusal a step for an undrawn card gets.
+   */
+  readonly #subagentRunDelegations = new Map<string, string>();
   /**
    * 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
@@ -2473,6 +2485,7 @@ export class AgUiChat extends HTMLElement {
     // the correct half of that split -- a delegation that was live before this
     // transcript was wiped is not live now.
     this.#subagentPanels.clear();
+    this.#subagentRunDelegations.clear();
     this.#serverSettled.clear();
     this.#cardElements.clear();
     this.#activityBlocks.clear();
@@ -3945,6 +3958,32 @@ export class AgUiChat extends HTMLElement {
           }),
         );
       },
+      // The delegation's own lifetime, on the protocol's events rather than the
+      // CUSTOM channel its steps ride. Both end at the same panel.
+      onSubAgentStarted: (subagentRunId, agent, parentToolCallId) => {
+        // A delegation naming no parent call names no card, and a floating
+        // panel is exactly what attaching to the card was chosen over.
+        if (parentToolCallId === null) {
+          return;
+        }
+        this.#subagentRunDelegations.set(subagentRunId, parentToolCallId);
+        this.#applySubAgent({
+          delegationId: parentToolCallId,
+          agent: agent === "" ? null : agent,
+          phase: SUBAGENT_PHASE.STARTED,
+          status: this.#strings.subAgentDelegatedTo.replace("{agent}", agent),
+          tool: null,
+        });
+      },
+      onSubAgentFinished: (subagentRunId) => {
+        this.#closeSubAgent(subagentRunId, SUBAGENT_PHASE.FINISHED, null);
+      },
+      onSubAgentError: (subagentRunId, message) => {
+        // The server's own words, which the contract keeps to the sub-agent's
+        // name. Passed through as the status line and set with textContent
+        // downstream, never parsed as markup.
+        this.#closeSubAgent(subagentRunId, SUBAGENT_PHASE.FAILED, message);
+      },
       onMessagesSnapshot: () => {
         // Honoured for persistence and announced, not re-rendered.
         //
@@ -4144,6 +4183,57 @@ export class AgUiChat extends HTMLElement {
     if (update === null) {
       return;
     }
+    this.#applySubAgent(update);
+  }
+
+  /**
+   * Fold one already-narrowed update into the delegation's panel.
+   *
+   * The join point of the two carriers, and the reason it is separate from
+   * {@link #reportSubAgent}: a `CUSTOM` step arrives as `unknown` and has to be
+   * vouched for, while a lifecycle event arrives typed off the protocol and has
+   * nothing left to check. Both end up here, so the panel has one way in and
+   * the phases stay a single state machine regardless of which wire they came
+   * from.
+   */
+  /**
+   * Settle the delegation a closing lifecycle event names.
+   *
+   * `status` is the server's text on a failure and `null` on a success, where
+   * the wording is this element's own -- the protocol's finish event carries no
+   * message, which is the better shape for a localised UI and the reason
+   * {@link UiStrings.subAgentFinished} exists.
+   *
+   * The pairing is deliberately not deleted on close. A panel outlives the
+   * delegation it drew, the map is cleared with the transcript alongside the
+   * panels, and forgetting the id here would only make a duplicate close draw
+   * nothing instead of drawing the same settled row again.
+   */
+  #closeSubAgent(subagentRunId: string, phase: SubAgentPhase, status: string | null): void {
+    const delegationId = this.#subagentRunDelegations.get(subagentRunId);
+    if (delegationId === undefined) {
+      // A close naming a delegation this never saw open -- the same refusal a
+      // step for an undrawn card gets, and the same reason.
+      return;
+    }
+    const agent = this.#subagentPanels.get(delegationId)?.agent ?? null;
+    this.#applySubAgent({
+      delegationId,
+      agent,
+      phase,
+      status: status === null ? this.#finishedLine(agent) : status,
+      tool: null,
+    });
+  }
+
+  /** The row's line for a delegation that completed, named if its name is known. */
+  #finishedLine(agent: string | null): string {
+    return agent === null
+      ? this.#strings.subAgentWorking
+      : this.#strings.subAgentFinished.replace("{agent}", agent);
+  }
+
+  #applySubAgent(update: SubAgentUpdate): void {
     const card = this.#toolCards.get(update.delegationId);
     if (card === undefined) {
       return;

package/src/core/agui_client.ts

@@ -127,6 +127,31 @@ export interface AgUiClientHandlers {
    * be the thing the open field exists to avoid.
    */
   onCustomEvent(name: string, value: unknown): void;
+  /**
+   * A delegated sub-agent started, inside the run.
+   *
+   * The protocol's own event, unlike the steps that follow it on
+   * {@link SUBAGENT_CUSTOM_NAME}. `parentToolCallId` links the delegation to the
+   * `delegate_task` call that spawned it -- the field AG-UI provides for the
+   * "agents as tools" shape -- and is `null` when the server did not send one,
+   * which a host reads as a delegation it has nothing to attach to.
+   *
+   * `subagentRunId` names the child run and is the only id the two closing
+   * events carry, so a host that wants to close what it opened has to remember
+   * the pairing.
+   */
+  onSubAgentStarted(subagentRunId: string, name: string, parentToolCallId: string | null): void;
+  /** The delegation named by `subagentRunId` completed. */
+  onSubAgentFinished(subagentRunId: string): void;
+  /**
+   * The delegation named by `subagentRunId` failed.
+   *
+   * `message` is server text and required by the protocol, but it is not an
+   * exception's words: `django-ag-ui` sends only which sub-agent failed, on the
+   * same reasoning that redacts a `RUN_ERROR`. Render it as text, never as
+   * markup.
+   */
+  onSubAgentError(subagentRunId: string, message: string): void;
   onError(message: string): void;
   /**
    * Fired when the user cancelled the run ({@link AgUiClient.cancel}) — the
@@ -567,6 +592,22 @@ export class AgUiClient {
       onCustomEvent({ event }) {
         h.onCustomEvent(event.name, event.value);
       },
+      // The delegation lifecycle. Forwarded rather than interpreted here, for
+      // the reason every other subscriber in this block is thin: this file
+      // adapts the protocol to the handler surface, and what a delegation looks
+      // like on screen is the element's business.
+      //
+      // `parentToolCallId` is optional on the wire and normalised to `null` so
+      // the handler has one absent-value to check rather than two.
+      onSubagentStartedEvent({ event }) {
+        h.onSubAgentStarted(event.subagentRunId, event.name, event.parentToolCallId ?? null);
+      },
+      onSubagentFinishedEvent({ event }) {
+        h.onSubAgentFinished(event.subagentRunId);
+      },
+      onSubagentErrorEvent({ event }) {
+        h.onSubAgentError(event.subagentRunId, event.message);
+      },
       onMessagesSnapshotEvent({ event }) {
         h.onMessagesSnapshot(event.messages as readonly Message[]);
       },

package/src/ui/subagent_panel.ts

@@ -82,6 +82,18 @@ export class SubAgentPanel {
   /** The panel's root; append this into the delegating card's slot. */
   readonly element: HTMLDivElement;
 
+  /**
+   * The child agent's name, as the last update that carried one gave it.
+   *
+   * Read back rather than only written to the DOM, because the two carriers
+   * split the name away from the close: `SUBAGENT_STARTED` names the agent and
+   * `SUBAGENT_FINISHED` carries only an id, so whoever words the closing line
+   * has to recover the name from what the delegation already told it.
+   */
+  get agent(): string | null {
+    return this.#agent;
+  }
+
   /**
    * The collapsed row, which is the expander as well as the status.
    *
@@ -94,6 +106,7 @@ export class SubAgentPanel {
   readonly #steps: HTMLDivElement;
   /** The child's tool calls, keyed by the child's own call id. */
   readonly #stepRows = new Map<string, HTMLDivElement>();
+  #agent: string | null = null;
 
   constructor(strings: UiStrings = DEFAULT_UI_STRINGS) {
     this.element = document.createElement("div");
@@ -151,6 +164,7 @@ export class SubAgentPanel {
   report(update: SubAgentUpdate): void {
     this.element.setAttribute("data-phase", update.phase);
     if (update.agent !== null) {
+      this.#agent = update.agent;
       this.element.setAttribute("data-agent", update.agent);
     }
     if (update.status !== null) {

package/src/ui/subagent_update.ts

@@ -5,6 +5,15 @@
  * renderer: the panel's job is drawing, and a value that reaches it has already
  * been vouched for.
  *
+ * **The three lifecycle phases are still accepted here, deliberately.** A current
+ * server sends only `tool_call` and `tool_result` on this carrier -- the
+ * delegation's lifetime moved to the protocol's `SUBAGENT_*` events -- but a
+ * server one release older sends all five, and this element is published and
+ * vendored separately from it. Continuing to narrow the older shape costs
+ * nothing (the panel needs those phases as visual states regardless) and is the
+ * difference between a mixed-version pair that degrades and one that shows a
+ * delegation which never opens.
+ *
  * Defensive about the payload, not about the name. A `CUSTOM` event's `value` is
  * `unknown` by the protocol, so a server can put anything there, and a malformed
  * announcement must not take a run down with it — the same rule the invalidation

package/src/ui/ui_strings.ts

@@ -140,6 +140,25 @@ export interface UiStrings {
    * must never be blank.
    */
   subAgentWorking: string;
+  /**
+   * The row's line while a delegation is running. Token: `{agent}`.
+   *
+   * Worded here rather than on the wire, unlike the two step phases. The
+   * protocol's `SUBAGENT_STARTED` carries the sub-agent's `name` and no rendered
+   * status -- which is the better shape for a localised UI, and the reason this
+   * string exists at all.
+   */
+  subAgentDelegatedTo: string;
+  /** The row's line once a delegation completed. Token: `{agent}`. */
+  subAgentFinished: string;
+  /**
+   * The row's line for a delegation that failed and named no agent.
+   *
+   * A fallback only: `SUBAGENT_ERROR` carries a required `message`, which the
+   * server fills with the sub-agent's name and nothing else, and that text is
+   * what the row shows. This covers a server that sent an empty one.
+   */
+  subAgentFailed: string;
   /** `aria-label` of the region holding the sub-agent's own tool calls. */
   subAgentSteps: string;
 
@@ -332,6 +351,9 @@ export const DEFAULT_UI_STRINGS: UiStrings = {
   details: "Details",
 
   subAgentWorking: "Working…",
+  subAgentDelegatedTo: "Delegated to {agent}",
+  subAgentFinished: "{agent} finished",
+  subAgentFailed: "The sub-agent failed",
   subAgentSteps: "Steps the sub-agent took",
 
   approvalEditArgs: "Edit the arguments before approving",

package/src/version.ts

@@ -1 +1 @@
-export const VERSION: string = "0.31.1";
+export const VERSION: string = "0.32.0";