@artooi/ag-ui-web-component 0.38.0 → 0.40.0

package/dist/ui/transcript/answer_actions.d.ts

@@ -0,0 +1,39 @@
+import type { UiStrings } from "../ui_strings.js";
+/** What the answer actions need from the element that owns them. */
+export interface AnswerActionsHost {
+    /** The custom element: its `data-message-actions`, and where feedback is dispatched. */
+    readonly element: HTMLElement;
+    /** The resolved string table. */
+    readonly strings: () => UiStrings;
+    /** Retry the last turn, as the element's public `retryLastTurn` does. */
+    readonly retry: () => void;
+}
+/**
+ * The action row under a finished answer -- copy, retry, feedback -- and the
+ * one row currently holding Retry.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance.
+ */
+export declare class AnswerActions {
+    #private;
+    constructor(host: AnswerActionsHost);
+    /** Forget the row holding Retry, with the transcript it was in. */
+    forget(): void;
+    /**
+     * Give a finished assistant bubble its action row, and hand it Retry.
+     *
+     * Every finished bubble gets copy and feedback -- both are safe on a message
+     * of any age. Retry moves to the newest, because it is the only one where
+     * re-running answers the same question rather than rewriting history.
+     *
+     * `data-message-actions` subtracts from that. The row is built only when
+     * something survives to go in it: an empty row still takes its margin, still
+     * answers to the `message-actions` part, and still reads to a screen reader
+     * as a group of actions with none in it.
+     */
+    attach(bubble: HTMLDivElement, options?: {
+        rateable?: boolean;
+    }): void;
+}
+//# sourceMappingURL=answer_actions.d.ts.map

package/dist/ui/transcript/answer_actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer_actions.d.ts","sourceRoot":"","sources":["../../../src/ui/transcript/answer_actions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,CAAC;IAClC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;;IAaxB,YAAY,IAAI,EAAE,iBAAiB,EAElC;IAED,mEAAmE;IACnE,MAAM,IAAI,IAAI,CAEb;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI,CAwCzE;CAwCF"}

package/dist/ui/transcript/answer_stream.d.ts

@@ -0,0 +1,56 @@
+/** What the streamed answer needs from the element that owns it. */
+export interface AnswerStreamHost {
+    /** Append an empty assistant bubble to the transcript, and return it. */
+    readonly openBubble: () => HTMLDivElement;
+    /** The element's `allowImages`, read per render. */
+    readonly allowImages: () => boolean;
+    /** Keep the transcript at its foot, if the reader is there. */
+    readonly follow: () => void;
+}
+/**
+ * The assistant answer currently streaming: the bubble it streams into, the
+ * text the next frame will draw, and how many deltas it arrived in.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance.
+ */
+export declare class AnswerStream {
+    #private;
+    constructor(host: AnswerStreamHost);
+    /** Text deltas the current answer has arrived in so far. */
+    get deltas(): number;
+    /**
+     * Count one delta received. Counted per delta received, not per render: the
+     * word reveal asks whether the answer *arrived* progressively, which
+     * coalescing renders must not change the answer to.
+     */
+    countDelta(): void;
+    /**
+     * Queue a render of the answer so far, at most one per frame.
+     *
+     * Each `TEXT_MESSAGE_CONTENT` event carries the *whole* accumulated answer,
+     * and drawing it means marked + DOMPurify over the entire document and a
+     * wholesale replacement of the bubble's subtree. Once per token that is
+     * quadratic in the answer's length — a long answer is agent-controlled, so
+     * an ordinary run becomes a progressively stalling tab — and every rebuild
+     * takes any selection or focus inside the bubble with it.
+     *
+     * A frame is the right grain: it is the fastest anything on screen can
+     * change anyway, so a burst of tokens costs one parse and the text still
+     * appears to flow rather than in visible chunks.
+     */
+    queue(buffer: string): void;
+    /** Render `buffer` into the streaming bubble now, dropping any queued frame. */
+    into(buffer: string): HTMLDivElement;
+    /**
+     * Close the current answer's streaming bubble.
+     *
+     * Draws a queued render first. A run that ends without a text end — a
+     * cancel, an error, a round boundary — leaves the last delta sitting in the
+     * queue, and simply dropping the bubble here would strand it: the partial
+     * answer the user stopped mid-sentence would lose its final tokens, or be an
+     * empty bubble above the stopped note.
+     */
+    end(): void;
+}
+//# sourceMappingURL=answer_stream.d.ts.map

package/dist/ui/transcript/answer_stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer_stream.d.ts","sourceRoot":"","sources":["../../../src/ui/transcript/answer_stream.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,cAAc,CAAC;IAC1C,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC;IACpC,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;;IAcvB,YAAY,IAAI,EAAE,gBAAgB,EAEjC;IAED,4DAA4D;IAC5D,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;OAIG;IACH,UAAU,IAAI,IAAI,CAEjB;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAU1B;IAED,gFAAgF;IAChF,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAYnC;IAED;;;;;;;;OAQG;IACH,GAAG,IAAI,IAAI,CAKV;CAgBF"}

package/dist/ui/transcript/render_or_warn.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Call a consumer's renderer, turning a throw into "nothing drawn".
+ *
+ * `render` is consumer code -- a host's activity renderer, a tool's `render` --
+ * and both call sites run inside the history replay, where a throw abandons the
+ * loop and takes every later turn of the transcript with it -- silently, and
+ * again on every reload. One thing that fails to draw is worth losing; the rest
+ * of the conversation is not. Reported so the failure is findable rather than
+ * merely survived.
+ *
+ * @param render - The consumer's renderer, already bound to its input.
+ * @param subject - What was being drawn, for the warning: `tool <name>` or
+ *   `activity <type>`.
+ */
+export declare function renderOrWarn(render: () => Node | null, subject: string): Node | null;
+//# sourceMappingURL=render_or_warn.d.ts.map

package/dist/ui/transcript/render_or_warn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render_or_warn.d.ts","sourceRoot":"","sources":["../../../src/ui/transcript/render_or_warn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAOpF"}

package/dist/ui/transcript/starter_chips.d.ts

@@ -0,0 +1,21 @@
+import type { UiStrings } from "../ui_strings.js";
+/**
+ * The prompts offered on an empty transcript, from `element`'s `data-starters`.
+ *
+ * Different from the suggestion chips a run pushes, which are follow-ups to
+ * something already said. These answer the blank-page question instead, and
+ * they are the host's rather than the model's -- only the host knows what its
+ * page is for. Shares the renderer, the count and the length limit, because
+ * two rows of prompt chips that behaved differently would be the harder
+ * thing to explain.
+ *
+ * Read once at connect: it is content for a state the widget is in before
+ * anything happens, and a host that wants it to change has `slot="empty"`.
+ *
+ * Parses the attribute itself rather than through the element's JSON attribute
+ * reader, because the warning is its own: it says no starters are shown and
+ * gives an example of the shape, where the shared one says a built-in default
+ * is in use, which for this attribute there is not.
+ */
+export declare function renderStarterChips(element: Element, strings: UiStrings, onPick: (prompt: string) => void): HTMLElement | null;
+//# sourceMappingURL=starter_chips.d.ts.map

package/dist/ui/transcript/starter_chips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter_chips.d.ts","sourceRoot":"","sources":["../../../src/ui/transcript/starter_chips.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAC/B,WAAW,GAAG,IAAI,CAgBpB"}

package/dist/ui/transcript/transcript.d.ts

@@ -0,0 +1,171 @@
+import type { AgUiToolCall } from "../../core/agui_client.js";
+import type { MessageRole } from "../../core/message_role.js";
+import type { ChartRenderer, ClientTool } from "../../tools/client_tool_registry.js";
+import { ThoughtsBlock } from "../progress/thoughts_block.js";
+import { ToolCallCard, type ToolPayload } from "../progress/tool_call_card.js";
+import type { UiStrings } from "../ui_strings.js";
+/** What the transcript needs from the element that owns it. */
+export interface TranscriptHost {
+    /** The custom element: its text-animation attribute, and the `data-empty` stamp. */
+    readonly element: HTMLElement;
+    /** The scrolling message list. */
+    readonly messages: HTMLDivElement;
+    /** The empty-state region at the top of the list. */
+    readonly emptyWrap: HTMLDivElement;
+    /** The resolved string table. */
+    readonly strings: () => UiStrings;
+    /** The element's `allowImages`, read per render. */
+    readonly allowImages: () => boolean;
+    /** Resolve a frontend tool by name, for its `x-summary`. */
+    readonly resolveTool: (name: string) => ClientTool | null;
+    /** The element's `toolSummaries`, read per card. */
+    readonly toolSummaries: () => Record<string, string>;
+    /** The server catalog's label for a tool, if it sent one. */
+    readonly serverSummary: (name: string) => string | undefined;
+    /** The element's `formatToolPayload`, asked per region of a card. */
+    readonly formatToolPayload: (payload: ToolPayload) => Node | string | null;
+}
+/**
+ * The transcript: the bubbles, the open answer group, the pending dots, the
+ * reasoning region, the tool cards by call id, and the scroller that follows
+ * the foot.
+ *
+ * The hub most other parts of the element draw into, so it holds only the
+ * transcript's own state and asks the element for nothing but configuration.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance.
+ */
+export declare class Transcript {
+    #private;
+    constructor(host: TranscriptHost);
+    /**
+     * Start following the foot of the list, and wire the jump button to it.
+     * Called while rendering rather than at construction: the viewport has to
+     * exist and the observer has to have something to observe. The button
+     * outlives a connection, so its listener goes under `signal`.
+     */
+    mountScroller(jumpButton: HTMLButtonElement, signal: AbortSignal): void;
+    /** Stop following, when the element leaves the document. */
+    disposeScroller(): void;
+    /** Keep the list at its foot, if the reader is there. */
+    follow(): void;
+    /** Go to the foot, whether or not the reader had scrolled away. */
+    jump(): void;
+    /** Whether the empty-state region is showing, which is when nothing else is. */
+    isEmpty(): boolean;
+    /** The card drawn for a call id, while it is still awaiting execution. */
+    card(callId: string): ToolCallCard | undefined;
+    /** Every card still awaiting execution. */
+    cards(): IterableIterator<ToolCallCard>;
+    /** Stop tracking a call's card as awaiting execution. */
+    forgetCard(callId: string): void;
+    /** Remember the element a call's card is, for a renderer to place itself against. */
+    setCardElement(callId: string, element: HTMLElement): void;
+    /** Record that a call's card was settled from a streamed server-side result. */
+    markServerSettled(callId: string): void;
+    /** Whether a call's card was settled from a streamed server-side result. */
+    isServerSettled(callId: string): boolean;
+    /** Fold the reasoning region away, once the answer has begun. */
+    collapseThoughts(): void;
+    /**
+     * Close the turn's answer group. Drop it if the turn rendered nothing
+     * (e.g. a server-only round that streamed no text/card) so an opted-in
+     * well leaves no empty box behind.
+     */
+    closeGroup(): void;
+    /**
+     * Let go of the open turn: its group, its reasoning region, its pending dots
+     * and the cards awaiting execution. The first half of wiping the transcript.
+     */
+    releaseTurn(): void;
+    /** Forget which cards settled from the server and where each card is. */
+    forgetCards(): void;
+    /** Empty the list back to its empty-state region. The last half of wiping it. */
+    empty(): void;
+    /** The bubble behind `AgUiChat.appendMessage`, whose doc is the contract. */
+    append(role: MessageRole, content: string): HTMLDivElement;
+    /**
+     * The open answer group, creating and appending it on first use. Everything a
+     * single assistant turn renders (text, tool cards, the pending indicator)
+     * goes inside it, so the opt-in `data-answer-well` styling can box the whole
+     * turn. Idempotent across the turn's runs — it persists until the run's
+     * settle closes it, see {@link closeGroup}.
+     */
+    ensureGroup(): HTMLDivElement;
+    /**
+     * Word-by-word reveal for the `word` text-animation mode, applied to a
+     * completed assistant bubble. `fade` is pure CSS (no JS); `none` is a no-op.
+     */
+    revealWords(bubble: HTMLDivElement): void;
+    /**
+     * Hide the empty-state region once the message list holds anything else, and
+     * say so on the host as `data-empty`.
+     *
+     * Stamped on the host because the layout has to answer it: where the
+     * composer sits is decided outside the list this region lives in, and no
+     * selector reaches from inside the list back up to the list's siblings. It is
+     * also a documented styling hook for a host's own chrome around a full-page
+     * chat.
+     */
+    updateEmptyState(): void;
+    /** A muted "⏹ Stopped" line in the transcript (distinct from the ⚠️ error bubble). */
+    appendStoppedNote(): void;
+    /**
+     * Show a "thinking" indicator while the agent is being awaited — both the
+     * silent stretch before the first token and the gap after a tool result
+     * while the next round is requested. Idempotent.
+     */
+    showPending(): void;
+    /** Remove the pending indicator if shown. */
+    hidePending(): void;
+    /**
+     * The current turn's thoughts region, creating it (at the top of the answer
+     * group, above any streamed text or tool cards) on first sight. Idempotent
+     * across a turn's reasoning tokens.
+     */
+    showThoughts(): ThoughtsBlock;
+    /**
+     * Render a skill notice for a `load_capability` call; ``true`` when handled.
+     *
+     * Shared by the live stream and history replay so the transcript looks the
+     * same before and after a reload.
+     */
+    noticeIfSkillLoad(call: AgUiToolCall): boolean;
+    /**
+     * An inline notice about something the run did.
+     *
+     * Goes through {@link ensureGroup} like a tool card so it lands *inside* the
+     * assistant turn it annotates rather than floating between turns, and does
+     * the same empty-state and scroll bookkeeping afterwards.
+     *
+     * `undo` is offered only where the agent rearranged the user's own window --
+     * see {@link renderRunNotice} for why a notice may carry that one control and
+     * nothing else.
+     */
+    appendNotice(icon: string, text: string, kind: string, undo?: {
+        readonly label: string;
+        readonly onActivate: () => void;
+    }): void;
+    /**
+     * Place a tool's rendered node against its own card.
+     *
+     * Anchored rather than appended because a client tool's handler does not run
+     * until the round is over: appending would put the node after everything the
+     * model said next, visibly detached from the call that produced it, and in a
+     * different order than the same transcript takes on reload. The card was
+     * created inline, in the right place, so anchoring makes *when* the handler
+     * runs stop mattering.
+     */
+    renderToolOutput(render: ChartRenderer, call: AgUiToolCall): void;
+    /** Update the empty state and follow the foot, after the transcript grew. */
+    afterGrew(): void;
+    /**
+     * The card for ``call``, creating and appending it on first sight.
+     *
+     * The run's tool-call handler creates the card (pending) during the run; the
+     * tool's execution later retrieves the same card to settle it.
+     */
+    cardFor(call: AgUiToolCall): ToolCallCard;
+}
+//# sourceMappingURL=transcript.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../src/ui/transcript/transcript.ts"],"names":[],"mappings":"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"}

package/dist/ui/ui_strings.d.ts

@@ -44,6 +44,13 @@ export interface UiStrings {
     expandUnread: string;
     /** Built-in header theme toggle (light ⇄ dark). */
     toggleTheme: string;
+    /**
+     * The greeting over an empty conversation under `placement="page"` (or an
+     * `embedded` panel that opted in). Token: `{name}`, the `user-name` attribute.
+     */
+    greeting: string;
+    /** The same greeting when the host named nobody: no `user-name`, or a blank one. */
+    greetingNoName: string;
     /** `aria-label` of the scrolling message log. */
     conversation: string;
     /** The button offering to return to the foot of the transcript. */
@@ -67,10 +74,25 @@ export interface UiStrings {
     stopped: string;
     /** Error shown when the stream drops without a terminal AG-UI event. */
     connectionLost: string;
-    /** Fallback when a tool call produced no result. */
+    /**
+     * Formerly the card text for a tool call that produced no result.
+     *
+     * @deprecated No longer drawn: such a call is now answered with
+     * {@link callNotFinished}, on its card and in the conversation alike. Kept so a
+     * string table that sets it still type-checks.
+     */
     noResult: string;
+    /**
+     * Tool-result content (and card text) for a call that never produced a result
+     * and that nobody refused: the run was stopped or failed first, the page
+     * reloaded, or no tool here answered it. Sent to the agent, so it must not say
+     * a person declined.
+     */
+    callNotFinished: string;
     /** Tool-result content when the user declines a confirmed action. */
     declinedAction: string;
+    /** Tool-result content (and card text) when `confirmPredicate` threw, so the call was refused. */
+    confirmCheckFailed: string;
     /** A navigating tool's card text while the page reloads. */
     navigating: string;
     /** Notice shown when the server replaced the conversation wholesale. */
@@ -93,6 +115,8 @@ export interface UiStrings {
     notConnected: string;
     /** Composer hint when a run continuation was picked with an empty composer. */
     continueNeedsTurn: string;
+    /** Composer hint when a run continuation was picked while a run is in flight. */
+    continueWhileRunning: string;
     /** `aria-label` of the message textarea. */
     message: string;
     /** Placeholder of the message textarea. */
@@ -127,6 +151,8 @@ export interface UiStrings {
     toolError: string;
     /** Status pill on a declined call. */
     toolDeclined: string;
+    /** Status pill on a call that ended without a result nobody refused. */
+    toolInterrupted: string;
     /** Accessible label on the panel resize handle. */
     resizePanel: string;
     /** Note on a tool card whose call a human approved. */
@@ -141,6 +167,8 @@ export interface UiStrings {
     errorLabel: string;
     /** Heading over a tool card's result region when the call was declined. */
     declinedLabel: string;
+    /** Heading over a tool card's result region when the call did not finish. */
+    interruptedLabel: string;
     /** Label on the toggle that expands a tool card's body. */
     details: string;
     /**

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.38.0",
+  "version": "0.40.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

@@ -244,7 +244,13 @@ export const MESSAGE_ACTIONS = {
 
 /**
  * Lifecycle status of a rendered tool-call card. A card opens as `PENDING`
- * while the call runs, then settles to `DONE`, `ERROR`, or `DECLINED`.
+ * while the call runs, then settles to `DONE`, `ERROR`, `DECLINED` or
+ * `INTERRUPTED`.
+ *
+ * `INTERRUPTED` is a call that never produced a result and that nobody refused:
+ * the run was stopped or failed before it finished, or no tool here answered it.
+ * Neither of the older terminal states is true of it. `DONE` claimed a success
+ * nothing achieved, and `DECLINED` says a person or a guard refused.
  *
  * `DEFERRED` is the one non-terminal state that is not "running": a server-side
  * tool a `ToolGuard` gated never executed, the run finished on an interrupt, and
@@ -261,6 +267,7 @@ export const TOOL_CALL_STATUS = {
   DONE: "done",
   ERROR: "error",
   DECLINED: "declined",
+  INTERRUPTED: "interrupted",
 } as const;
 
 /**
@@ -276,10 +283,14 @@ export const TOOL_CALL_STATUS = {
  * 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.
+ * something the user did. `INTERRUPTED` is a call that produced no result because
+ * the run ended first: pydantic-ai writes it when it repairs a history a
+ * cancelled stream left, and the element writes it for the same reason when a
+ * run ends with a call still unanswered, so the next request carries a result
+ * for every call without claiming anyone refused one.
+ *
+ * Anything *else* on the wire — a value from a later protocol version — 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.
  */
@@ -287,6 +298,7 @@ export const TOOL_OUTCOME = {
   SUCCESS: "success",
   FAILED: "failed",
   DENIED: "denied",
+  INTERRUPTED: "interrupted",
 } as const;
 
 /**
@@ -460,16 +472,6 @@ export const ANNOUNCE_CLEAR_MS = 150;
  */
 export const HIGHLIGHT_OVERLAY_Z_INDEX = 2147483001;
 
-/**
- * The panel width at which the conversation list stops covering the transcript
- * and docks beside it.
- *
- * Wide enough that the list and a readable column both fit: the list asks for
- * 300px and the reading column is capped at 820px. Below this a docked list
- * would leave a strip of transcript narrower than the messages in it.
- */
-export const THREADS_DOCK_MIN_WIDTH = 900;
-
 /**
  * How many characters a pasted string has to reach before it becomes an
  * attachment rather than composer text.

package/src/core/activity_registry.ts

@@ -0,0 +1,133 @@
+import { renderOrWarn } from "../ui/transcript/render_or_warn.js";
+import type { ActivityRegistration } from "./activity_registration.js";
+
+/** What the activity registry needs from the element that owns it. */
+export interface ActivityRegistryHost {
+  /** The current answer group, opening one if none is open. */
+  readonly ensureGroup: () => HTMLDivElement;
+  /** Update the empty state and follow the foot after the transcript grew. */
+  readonly afterTranscriptGrew: () => void;
+  /** Append an ambient run notice to the current group. */
+  readonly appendNotice: (icon: string, text: string, kind: string) => void;
+}
+
+/**
+ * The AG-UI activities this element can draw, and the blocks it drew: which
+ * `activity_type`s have a renderer, which arrived with none, and the node each
+ * drawn activity is on screen as.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance.
+ */
+export class ActivityRegistry {
+  readonly #host: ActivityRegistryHost;
+  /**
+   * Which `activity_type`s this element can draw, by name.
+   *
+   * A registry rather than a branch because `activity_type` is an open string
+   * the protocol does not enumerate. The two built-ins go through it like any
+   * host registration, which is the test that the seam is real.
+   */
+  readonly #activityRenderers = new Map<string, ActivityRegistration>();
+  /** Types that arrived with nobody registered to draw them. See {@link unhandledTypes}. */
+  readonly #unhandledActivityTypes = new Set<string>();
+  /** Chart blocks by activity message id, so an update redraws in place. */
+  readonly #activityBlocks = new Map<string, HTMLElement>();
+
+  constructor(host: ActivityRegistryHost) {
+    this.#host = host;
+  }
+
+  /** The registration behind `AgUiChat.registerActivityRenderer`, whose doc is the contract. */
+  register(registration: ActivityRegistration): void {
+    this.#activityRenderers.set(registration.type, registration);
+    this.#unhandledActivityTypes.delete(registration.type);
+  }
+
+  /** Whether a renderer is registered for `activityType`. */
+  has(activityType: string): boolean {
+    return this.#activityRenderers.has(activityType);
+  }
+
+  /** The set behind `AgUiChat.unhandledActivityTypes`, whose doc is the contract. */
+  unhandledTypes(): readonly string[] {
+    return [...this.#unhandledActivityTypes];
+  }
+
+  /** Forget the drawn blocks, with the transcript they were drawn into. */
+  clearBlocks(): void {
+    this.#activityBlocks.clear();
+  }
+
+  /**
+   * Draw, replace or remove one activity, whatever kind it is.
+   *
+   * The single path for all three routes an activity arrives by -- pushed
+   * (`onActivity`), patched (`onActivityChanged`) and replayed from history --
+   * which is why the renderer contract has to be pure: the same content is
+   * drawn again on every thread load.
+   *
+   * An unregistered type draws nothing and says nothing. That is the protocol's
+   * own answer -- a client that does not know a name ignores the event -- and a
+   * warning here would fire on every well-behaved forward-compatible server,
+   * while a placeholder would put the protocol's growth in the user's face.
+   * {@link unhandledTypes} is the way to find out what arrived.
+   */
+  draw(messageId: string, activityType: string, content: unknown): void {
+    const registration = this.#activityRenderers.get(activityType);
+    if (registration === undefined) {
+      this.#unhandledActivityTypes.add(activityType);
+      return;
+    }
+    const node = renderOrWarn(() => registration.render(content), `activity ${activityType}`);
+    if (node === null) {
+      this.#remove(messageId, activityType, registration.removedNotice, content);
+      return;
+    }
+    const existing = this.#activityBlocks.get(messageId);
+    if (existing === undefined) {
+      this.#host.ensureGroup().appendChild(node as HTMLElement);
+    } else {
+      // Replaced rather than appended: a server redrawing under the same id
+      // means *this one changed*, and a second copy below the first would read
+      // as two measurements instead of one that moved.
+      existing.replaceWith(node);
+    }
+    this.#activityBlocks.set(messageId, node as HTMLElement);
+    this.#host.afterTranscriptGrew();
+  }
+
+  /**
+   * Take away an activity whose content stopped being drawable.
+   *
+   * Leaving the old one up is the worst available answer: it shows values that
+   * have been retracted, reading as current, and a reload drops it anyway
+   * because the *stored* content is the version that could not be drawn. Live
+   * and reload should agree, and both should say "gone".
+   *
+   * Removing is right; doing it in silence was not. A chart that had been drawn
+   * simply disappeared, with no `console` call anywhere on the path -- which
+   * nobody reports as a bug, they report as "the charts are flaky".
+   */
+  #remove(
+    messageId: string,
+    activityType: string,
+    notice: string | undefined,
+    content: unknown,
+  ): void {
+    const had = this.#activityBlocks.has(messageId);
+    this.#activityBlocks.get(messageId)?.remove();
+    this.#activityBlocks.delete(messageId);
+    console.warn(
+      `ag-ui-chat: activity ${messageId} (${activityType}) was not drawable and has been ` +
+        "removed. A chart's points must each be a finite JSON number; a numeric column " +
+        "serialised as a string (a Decimal, typically) is rejected rather than coerced.",
+      content,
+    );
+    // Only when something was on screen: content that never drew has no
+    // disappearance to explain, and a notice for every rejected push is noise.
+    if (had && notice !== undefined) {
+      this.#host.appendNotice("\u{1F4C9}", notice, "chart-undrawable");
+    }
+  }
+}