@threadplane/chat 0.0.51 → 0.0.53

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@threadplane/chat",
-  "version": "0.0.51",
+  "version": "0.0.53",
   "exports": {
     "./chat.css": "./chat.css",
     "./themes/default-dark.css": "./themes/default-dark.css",
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@cacheplane/partial-json": ">=0.1.1 <0.3.0",
-    "@cacheplane/partial-markdown": "^0.3.0",
+    "@cacheplane/partial-markdown": "^0.4.1",
     "tslib": "^2.3.0",
     "@threadplane/telemetry": "*"
   },
@@ -41,7 +41,13 @@
     "@json-render/core": "^0.16.0",
     "@langchain/core": "^1.1.33",
     "rxjs": "~7.8.0",
-    "marked": "^15.0.0 || ^16.0.0"
+    "marked": "^15.0.0 || ^16.0.0",
+    "katex": "^0.16.0 || ^0.17.0"
+  },
+  "peerDependenciesMeta": {
+    "katex": {
+      "optional": true
+    }
   },
   "license": "PolyForm-Noncommercial-1.0.0 OR LicenseRef-Threadplane-Commercial",
   "repository": {

package/types/threadplane-chat.d.ts

@@ -12,9 +12,9 @@ import * as _threadplane_chat from '@threadplane/chat';
 import { PartialJsonParser } from '@cacheplane/partial-json';
 import { BaseMessage } from '@langchain/core/messages';
 import * as _cacheplane_partial_markdown from '@cacheplane/partial-markdown';
-import { CitationDefinition, MarkdownDocumentNode, MarkdownNode, MarkdownParagraphNode, MarkdownHeadingNode, MarkdownBlockquoteNode, MarkdownListNode, MarkdownListItemNode, MarkdownCodeBlockNode, MarkdownThematicBreakNode, MarkdownTextNode, MarkdownEmphasisNode, MarkdownStrongNode, MarkdownStrikethroughNode, MarkdownInlineCodeNode, MarkdownLinkNode, MarkdownAutolinkNode, MarkdownImageNode, MarkdownSoftBreakNode, MarkdownHardBreakNode, MarkdownCitationReferenceNode, MarkdownTableNode, MarkdownTableRowNode, MarkdownTableCellNode } from '@cacheplane/partial-markdown';
+import { CitationDefinition, MarkdownDocumentNode, MarkdownNode, MarkdownParagraphNode, MarkdownHeadingNode, MarkdownBlockquoteNode, MarkdownListNode, MarkdownListItemNode, MarkdownCodeBlockNode, MarkdownThematicBreakNode, MarkdownTextNode, MarkdownEmphasisNode, MarkdownStrongNode, MarkdownStrikethroughNode, MarkdownInlineCodeNode, MarkdownMathInlineNode, MarkdownMathDisplayNode, MarkdownHtmlInlineNode, MarkdownHtmlBlockNode, MarkdownLinkNode, MarkdownAutolinkNode, MarkdownImageNode, MarkdownSoftBreakNode, MarkdownHardBreakNode, MarkdownCitationReferenceNode, MarkdownTableNode, MarkdownTableRowNode, MarkdownTableCellNode } from '@cacheplane/partial-markdown';
+import { SafeHtml, DomSanitizer } from '@angular/platform-browser';
 import { NavigationExtras } from '@angular/router';
-import { DomSanitizer, SafeHtml } from '@angular/platform-browser';
 
 /** Precise authored function tool — what `action()` returns. Carries the schema
  *  `S` and the handler's resolved return type `R`. */
@@ -52,6 +52,12 @@ type ClientToolDef = AnyFunctionToolDef | ViewToolDef | AskToolDef;
 /** A frozen, name-keyed registry of client tools. */
 type ClientToolRegistry = Readonly<Record<string, ClientToolDef>>;
 
+/**
+ * Application-wide options for {@link provideChat}. Every field is optional;
+ * the values are exposed to all chat components in the tree via the
+ * `CHAT_CONFIG` injection token, so you set them once at bootstrap instead of
+ * threading props through every component.
+ */
 interface ChatConfig {
     /** Shared render registry for consumers that read CHAT_CONFIG. */
     renderRegistry?: AngularRegistry;
@@ -198,15 +204,55 @@ interface Message {
      */
     toolCallIds?: string[];
 }
+/**
+ * Type guard narrowing a {@link Message} to `role: 'user'`.
+ *
+ * @param m The message to test.
+ * @returns `true` (and narrows `m`) when the message was sent by the user.
+ * @example
+ * ```ts
+ * const userTurns = agent.messages().filter(isUserMessage);
+ * ```
+ */
 declare function isUserMessage(m: Message): m is Message & {
     role: 'user';
 };
+/**
+ * Type guard narrowing a {@link Message} to `role: 'assistant'`.
+ *
+ * @param m The message to test.
+ * @returns `true` (and narrows `m`) when the message came from the assistant.
+ * @example
+ * ```ts
+ * const reply = agent.messages().findLast(isAssistantMessage);
+ * ```
+ */
 declare function isAssistantMessage(m: Message): m is Message & {
     role: 'assistant';
 };
+/**
+ * Type guard narrowing a {@link Message} to `role: 'tool'` (a tool result turn).
+ *
+ * @param m The message to test.
+ * @returns `true` (and narrows `m`) when the message is a tool result.
+ * @example
+ * ```ts
+ * if (isToolMessage(m)) console.log(m.toolCallId);
+ * ```
+ */
 declare function isToolMessage(m: Message): m is Message & {
     role: 'tool';
 };
+/**
+ * Type guard narrowing a {@link Message} to `role: 'system'`.
+ *
+ * @param m The message to test.
+ * @returns `true` (and narrows `m`) when the message is a system message.
+ * @example
+ * ```ts
+ * const visible = agent.messages().filter((m) => !isSystemMessage(m));
+ * ```
+ */
 declare function isSystemMessage(m: Message): m is Message & {
     role: 'system';
 };
@@ -714,6 +760,18 @@ declare class ChatInputComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatInputComponent, "chat-input", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; "submitOnEnter": { "alias": "submitOnEnter"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "showStopButton": { "alias": "showStopButton"; "required": false; "isSignal": true; }; }, { "submitted": "submitted"; "stopped": "stopped"; }, never, ["[chatInputBanner]", "[chatInputAttachments]", "[chatInputLeading]", "[chatInputModelSelect]", "[chatInputTrailing]", "[chatInputFooter]"], true, never>;
 }
 
+/**
+ * Whether the agent should show a "typing" indicator — it is loading and has
+ * not yet started streaming the assistant's reply.
+ *
+ * @param agent The agent to inspect.
+ * @returns `true` while the agent is awaiting a response but no assistant text
+ *   has streamed yet; `false` once tokens arrive or the agent is idle.
+ * @example
+ * ```ts
+ * \@if (isTyping(agent)) { <chat-typing-indicator [agent]="agent" /> }
+ * ```
+ */
 declare function isTyping(agent: Agent): boolean;
 declare class ChatTypingIndicatorComponent {
     readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
@@ -810,6 +868,19 @@ declare class ChatScrollBubbleComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatScrollBubbleComponent, "chat-scroll-bubble", never, { "mode": { "alias": "mode"; "required": true; "isSignal": true; }; }, { "clicked": "clicked"; }, never, never, true, never>;
 }
 
+/**
+ * Coerce an unknown error value into a human-readable message string — reads
+ * `.message` from `Error`s, returns strings as-is, and `String()`-casts the
+ * rest. Useful when rendering an agent's `error` outside the built-in
+ * `chat-error` component.
+ *
+ * @param error Any caught/agent error value.
+ * @returns The message text, or `null` when `error` is nullish.
+ * @example
+ * ```ts
+ * const msg = extractErrorMessage(agent.error());
+ * ```
+ */
 declare function extractErrorMessage(error: unknown): string | null;
 declare class ChatErrorComponent {
     readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
@@ -817,6 +888,18 @@ declare class ChatErrorComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatErrorComponent, "chat-error", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Read the agent's current human-in-the-loop interrupt, if any.
+ *
+ * @param agent The agent to inspect.
+ * @returns The pending {@link AgentInterrupt}, or `undefined` when the agent is
+ *   not currently waiting on an interrupt.
+ * @example
+ * ```ts
+ * const interrupt = getInterrupt(agent);
+ * if (interrupt) agent.resume('approved');
+ * ```
+ */
 declare function getInterrupt(agent: Agent): AgentInterrupt | undefined;
 declare class ChatInterruptComponent {
     readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
@@ -886,6 +969,8 @@ interface Group {
     name: string;
     calls: ToolCall[];
     templateRef?: ChatToolCallTemplateDirective;
+    /** Present when this group anchors a subagent spawned by its (single) task call. */
+    subagent?: Subagent;
 }
 declare class ChatToolCallsComponent {
     readonly agent: _angular_core.InputSignal<Agent<Record<string, unknown>>>;
@@ -1347,6 +1432,21 @@ interface ParseTreeStore {
     readonly spec: Signal<Spec | null>;
     readonly elementStates: Signal<Map<string, ElementAccumulationState>>;
 }
+/**
+ * Create a {@link ParseTreeStore} — feeds streamed JSON chunks through a
+ * partial-JSON parser and exposes the progressively-materialized spec and
+ * per-element accumulation state as signals, so a generative-UI surface can
+ * render while the spec is still arriving.
+ *
+ * @param parser The partial-JSON parser used to incrementally materialize chunks.
+ * @returns A {@link ParseTreeStore}; call `push(chunk)` as bytes stream in.
+ * @example
+ * ```ts
+ * const store = createParseTreeStore(parser);
+ * store.push('{"type":"Car');
+ * store.spec(); // best-effort Spec | null
+ * ```
+ */
 declare function createParseTreeStore(parser: PartialJsonParser): ParseTreeStore;
 
 /** Chat-internal projection of an A2UI component, materialized by the
@@ -1401,6 +1501,19 @@ interface A2uiSurfaceStore {
     readonly surfaceStates: Signal<Map<string, A2uiSurfaceState>>;
     surfaceState(surfaceId: string): Signal<A2uiSurfaceState | undefined>;
 }
+/**
+ * Create an {@link A2uiSurfaceStore} — the per-conversation store that buffers
+ * streamed A2UI surface updates, tracks each surface's data model + lifecycle
+ * state, and exposes them as signals for rendering. One store backs a chat
+ * thread's A2UI surfaces.
+ *
+ * @returns A fresh, empty {@link A2uiSurfaceStore}.
+ * @example
+ * ```ts
+ * const store = createA2uiSurfaceStore();
+ * const surfaces = store.surfaces; // Signal<Map<string, A2uiSurface>>
+ * ```
+ */
 declare function createA2uiSurfaceStore(): A2uiSurfaceStore;
 
 type ContentType = 'pending' | 'markdown' | 'json-render' | 'a2ui' | 'mixed';
@@ -1416,6 +1529,19 @@ interface ContentClassifier {
     readonly errors: Signal<string[]>;
     dispose(): void;
 }
+/**
+ * Create a {@link ContentClassifier} — the streaming accumulator that inspects
+ * an assistant message's content as it arrives and classifies it (markdown vs a
+ * generative-UI/A2UI spec), exposing the parsed result and per-element state as
+ * signals so the renderer can switch modes mid-stream.
+ *
+ * @returns A fresh {@link ContentClassifier}; call `dispose()` when done.
+ * @example
+ * ```ts
+ * const cc = createContentClassifier();
+ * effect(() => console.log(cc.type())); // 'pending' | 'markdown' | 'spec'
+ * ```
+ */
 declare function createContentClassifier(): ContentClassifier;
 
 /**
@@ -1542,6 +1668,26 @@ declare class ChatComponent {
      * reasoning pill collapses (per its internal logic).
      */
     protected isReasoningStreaming(message: Message, index: number): boolean;
+    /** The nearest preceding assistant message (skipping hidden tool messages), or undefined. */
+    private prevAssistant;
+    /**
+     * True when message[index] starts a reasoning RUN — a maximal sequence of
+     * consecutive assistant reasoning steps separated only by (hidden) tool
+     * messages. The merged reasoning pill renders once, here.
+     */
+    protected reasoningRunStart(index: number): boolean;
+    /**
+     * Aggregate the reasoning RUN starting at `index`: joins each step's
+     * reasoning, sums durations, counts steps, and computes the streaming flag
+     * and the merged label when N > 1 ("Thought for {total} · {N} steps", or
+     * just "{N} steps" when no step reported timing).
+     */
+    protected reasoningRun(index: number): {
+        content: string;
+        durationMs: number | undefined;
+        streaming: boolean;
+        label: string | undefined;
+    };
     private readonly classifiers;
     private readonly destroyRef;
     private readonly injector;
@@ -2000,6 +2146,36 @@ declare class MarkdownInlineCodeComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MarkdownInlineCodeComponent, "chat-md-inline-code", never, { "node": { "alias": "node"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+type MathNode = MarkdownMathInlineNode | MarkdownMathDisplayNode;
+/**
+ * Renders a `math-inline` / `math-display` markdown node as KaTeX. KaTeX is
+ * lazy-loaded (see katex-loader); until it resolves, or if the LaTeX is
+ * invalid, the raw `$…$` source is shown — never blank, never a crash.
+ */
+declare class MarkdownMathComponent {
+    readonly node: _angular_core.InputSignal<MathNode>;
+    private readonly sanitizer;
+    protected readonly display: _angular_core.Signal<boolean>;
+    protected readonly raw: _angular_core.Signal<string>;
+    protected readonly html: _angular_core.Signal<SafeHtml | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MarkdownMathComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MarkdownMathComponent, "chat-md-math", never, { "node": { "alias": "node"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Renders a `html-block` / `html-inline` markdown node as **escaped text** —
+ * the raw HTML is shown literally (Angular interpolation auto-escapes it),
+ * never injected as live markup. This preserves the pre-0.4 behavior where
+ * raw HTML was plain text, and keeps the chat XSS-safe: model-emitted
+ * `<script>`, `<iframe>`, etc. are displayed as text and never executed.
+ */
+declare class MarkdownHtmlComponent {
+    readonly node: _angular_core.InputSignal<MarkdownHtmlInlineNode | MarkdownHtmlBlockNode>;
+    protected readonly raw: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MarkdownHtmlComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MarkdownHtmlComponent, "chat-md-html", never, { "node": { "alias": "node"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 declare class MarkdownLinkComponent {
     readonly node: _angular_core.InputSignal<MarkdownLinkNode>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MarkdownLinkComponent, never>;
@@ -2069,8 +2245,6 @@ declare class MarkdownTableCellComponent {
  */
 declare const IS_HEADER_ROW: InjectionToken<Signal<boolean>>;
 
-declare const CHAT_MARKDOWN_STYLES = "\n  chat-streaming-md { display: block; color: var(--ngaf-chat-text); line-height: var(--ngaf-chat-line-height); }\n\n  /* Headings */\n  chat-streaming-md h1, chat-streaming-md h2, chat-streaming-md h3, chat-streaming-md h4, chat-streaming-md h5, chat-streaming-md h6 {\n    font-weight: 600;\n    line-height: 1.25;\n    margin: 1.25rem 0 0.75rem;\n  }\n  chat-streaming-md h1:first-child, chat-streaming-md h2:first-child, chat-streaming-md h3:first-child,\n  chat-streaming-md h4:first-child, chat-streaming-md h5:first-child, chat-streaming-md h6:first-child { margin-top: 0; }\n  chat-streaming-md h1 { font-size: 1.5em; font-weight: 700; }\n  chat-streaming-md h2 { font-size: 1.25em; }\n  chat-streaming-md h3 { font-size: 1.1em; }\n  chat-streaming-md h4 { font-size: 1em; }\n  chat-streaming-md h5, chat-streaming-md h6 { font-size: 0.95em; color: var(--ngaf-chat-text-muted); }\n\n  /* Paragraphs and inline emphasis */\n  chat-streaming-md p { margin: 0 0 0.75rem; line-height: 1.6; font-size: var(--ngaf-chat-font-size); }\n  chat-streaming-md p:last-child { margin-bottom: 0; }\n  chat-streaming-md strong, chat-streaming-md b { font-weight: 700; }\n  chat-streaming-md em, chat-streaming-md i { font-style: italic; }\n  chat-streaming-md del, chat-streaming-md s { text-decoration: line-through; color: var(--ngaf-chat-text-muted); }\n  chat-streaming-md mark { background: var(--ngaf-chat-surface-alt); padding: 0 2px; border-radius: 2px; }\n  chat-streaming-md sub { font-size: 0.75em; vertical-align: sub; }\n  chat-streaming-md sup { font-size: 0.75em; vertical-align: super; }\n\n  /* Links */\n  chat-streaming-md a { color: var(--ngaf-chat-primary); text-decoration: underline; text-underline-offset: 2px; }\n  chat-streaming-md a:hover { text-decoration-thickness: 2px; }\n\n  /* Lists (CommonMark + GFM task lists) */\n  chat-streaming-md ul, chat-streaming-md ol { margin: 0 0 0.75rem; padding-left: 1.5rem; }\n  chat-streaming-md ul { list-style: disc outside; }\n  chat-streaming-md ol { list-style: decimal outside; }\n  chat-streaming-md ul ul { list-style: circle outside; }\n  chat-streaming-md ul ul ul { list-style: square outside; }\n  chat-streaming-md li { margin: 0.2rem 0; }\n  chat-streaming-md li::marker { color: var(--ngaf-chat-text-muted); }\n  chat-streaming-md li > p { margin: 0 0 0.25rem; }\n  chat-streaming-md li > ul, chat-streaming-md li > ol { margin: 0.25rem 0 0; }\n  /* GFM task lists: marked emits <li><input type=\"checkbox\" disabled> ... */\n  chat-streaming-md li:has(> input[type=\"checkbox\"]) { list-style: none; margin-left: -1.25rem; }\n  chat-streaming-md li > input[type=\"checkbox\"] { margin-right: 0.5rem; vertical-align: middle; }\n\n  /* Code (inline + fenced) */\n  chat-streaming-md code {\n    background: var(--ngaf-chat-surface-alt);\n    color: var(--ngaf-chat-text);\n    padding: 1px 5px;\n    border-radius: 4px;\n    font-family: var(--ngaf-chat-font-mono);\n    font-size: 0.9em;\n  }\n  chat-streaming-md pre {\n    background: var(--ngaf-chat-surface-alt);\n    color: var(--ngaf-chat-text);\n    padding: 12px 14px;\n    border-radius: var(--ngaf-chat-radius-card);\n    overflow-x: auto;\n    font-family: var(--ngaf-chat-font-mono);\n    font-size: var(--ngaf-chat-font-size-sm);\n    line-height: 1.5;\n    margin: 0 0 0.75rem;\n  }\n  chat-streaming-md pre code { background: transparent; padding: 0; border-radius: 0; font-size: inherit; }\n\n  /* Blockquote */\n  chat-streaming-md blockquote {\n    border-left: 3px solid var(--ngaf-chat-separator);\n    padding: 0.25rem 0 0.25rem 12px;\n    margin: 0 0 0.75rem;\n    color: var(--ngaf-chat-text-muted);\n  }\n  chat-streaming-md blockquote > :last-child { margin-bottom: 0; }\n\n  /* Horizontal rule */\n  chat-streaming-md hr {\n    border: none;\n    border-top: 1px solid var(--ngaf-chat-separator);\n    margin: 1rem 0;\n  }\n\n  /* Tables (GFM) */\n  chat-streaming-md table {\n    border-collapse: collapse;\n    margin: 0 0 0.75rem;\n    width: 100%;\n    font-size: 0.95em;\n  }\n  chat-streaming-md thead { background: var(--ngaf-chat-surface-alt); }\n  chat-streaming-md th, chat-streaming-md td {\n    border: 1px solid var(--ngaf-chat-separator);\n    padding: 6px 10px;\n    text-align: left;\n    vertical-align: top;\n  }\n  chat-streaming-md th { font-weight: 600; }\n  /* Component-rendered table: chat-md-table becomes a horizontally-scrollable\n     wrapper for the inner <table>; row/cell elements stay layout-transparent\n     so the browser's table layout takes over. Without this overflow wrapper,\n     wide tables push their parent container past the viewport horizontally. */\n  chat-streaming-md chat-md-table {\n    display: block;\n    overflow-x: auto;\n    max-width: 100%;\n    margin: 0 0 0.75rem;\n  }\n  chat-streaming-md chat-md-table-row { display: contents; }\n  chat-streaming-md chat-md-table-cell { display: contents; }\n  chat-streaming-md chat-md-table > table { margin: 0; }\n  /* Task-list items: checkbox + first paragraph render inline; subsequent\n     blocks (sub-lists, multi-paragraph items) flow normally below. */\n  chat-streaming-md li.chat-md-list-item--task {\n    list-style: none;\n    margin-left: -1.25rem;\n    display: flex;\n    flex-wrap: wrap;\n    align-items: baseline;\n    gap: 0.5rem;\n  }\n  chat-streaming-md li.chat-md-list-item--task > input[type=\"checkbox\"] {\n    margin: 0;\n    flex: 0 0 auto;\n    transform: translateY(2px);\n  }\n  /* The chat-md-children wrapper around list-item content takes remaining width */\n  chat-streaming-md li.chat-md-list-item--task > chat-md-children {\n    flex: 1 1 auto;\n    min-width: 0;\n  }\n  /* Tight task items: only the FIRST paragraph aligns inline with the\n     checkbox (margin collapsed). Subsequent paragraphs/blocks keep their\n     normal vertical spacing so multi-block items render readably. */\n  chat-streaming-md li.chat-md-list-item--task > chat-md-children > chat-md-paragraph:first-child > p {\n    margin: 0;\n  }\n\n  /* Media */\n  chat-streaming-md img { max-width: 100%; height: auto; border-radius: 6px; }\n  /* Broken-image fallback: muted pill showing alt text + icon. Triggered\n     when <img> fires (error). Caught by live browser smoke \u2014 prior impl\n     showed only the browser's broken-image icon with no readable alt. */\n  chat-streaming-md .chat-md-image--broken {\n    display: inline-flex;\n    align-items: center;\n    gap: 0.4rem;\n    padding: 0.25rem 0.5rem;\n    background: var(--ngaf-chat-surface-alt);\n    border: 1px dashed var(--ngaf-chat-separator);\n    border-radius: 6px;\n    font-size: 0.9em;\n    color: var(--ngaf-chat-text-muted, currentColor);\n    opacity: 0.85;\n  }\n  chat-streaming-md .chat-md-image__icon { font-size: 1em; line-height: 1; }\n  chat-streaming-md .chat-md-image__alt { font-style: italic; }\n";
-
 /**
  * Renders markdown content to sanitized HTML.
  * Falls back to plain text with newline->br conversion if `marked` is not installed.
@@ -2090,21 +2264,6 @@ declare function renderMarkdown(content: string, sanitizer: DomSanitizer): SafeH
  */
 declare function formatDuration(ms: number): string;
 
-/** Chevron down (▼ replacement). 12x12, stroke-based. */
-declare const ICON_CHEVRON_DOWN = "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"12\" height=\"12\" viewBox=\"0 0 12 12\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M3 4.5L6 7.5L9 4.5\"/></svg>";
-/** Chevron up (▲ replacement). 12x12, stroke-based. */
-declare const ICON_CHEVRON_UP = "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"12\" height=\"12\" viewBox=\"0 0 12 12\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M3 7.5L6 4.5L9 7.5\"/></svg>";
-/** Gear icon (⚙ replacement). 14x14. */
-declare const ICON_TOOL = "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><circle cx=\"12\" cy=\"12\" r=\"3\"/><path d=\"M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42\"/></svg>";
-/** Warning triangle (⚠ replacement). 18x18. */
-declare const ICON_WARNING = "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M10.29 3.86L1.82 18a2 2 0 001.71 3h16.94a2 2 0 001.71-3L13.71 3.86a2 2 0 00-3.42 0z\"/><line x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"/><line x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"/></svg>";
-/** Robot/agent icon (replacement). 14x14. */
-declare const ICON_AGENT = "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><rect x=\"3\" y=\"11\" width=\"18\" height=\"10\" rx=\"2\"/><circle cx=\"12\" cy=\"5\" r=\"2\"/><path d=\"M12 7v4\"/><line x1=\"8\" y1=\"16\" x2=\"8\" y2=\"16\"/><line x1=\"16\" y1=\"16\" x2=\"16\" y2=\"16\"/></svg>";
-/** Check mark replacement. 12x12. */
-declare const ICON_CHECK = "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"12\" height=\"12\" viewBox=\"0 0 12 12\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M2.5 6L5 8.5L9.5 3.5\"/></svg>";
-/** Send arrow (for chat input). 16x16. */
-declare const ICON_SEND = "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M8 12V4M8 4L4 8M8 4L12 8\"/></svg>";
-
 /** Catalog entry for the A2UI surface renderer.
  *
  * `component` is mounted once all of the component's bindings (data
@@ -2222,14 +2381,24 @@ declare class A2uiSurfaceComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<A2uiSurfaceComponent, "a2ui-surface", never, { "surface": { "alias": "surface"; "required": false; "isSignal": true; }; "state": { "alias": "state"; "required": false; "isSignal": true; }; "catalog": { "alias": "catalog"; "required": true; "isSignal": true; }; "handlers": { "alias": "handlers"; "required": false; "isSignal": true; }; "surfaceFallback": { "alias": "surfaceFallback"; "required": false; "isSignal": true; }; }, { "events": "events"; "action": "action"; }, never, never, true, never>;
 }
 
-declare function surfaceToSpec(surface: A2uiSurface): Spec | null;
-
 /** Builds an A2uiActionMessage from handler params and the current surface.
  *  The action.context is serialized as v1 DynamicValue-wrapped entries.
  *  Sets action.label when the source component is a Button with a Text
  *  child whose literalString is non-empty. */
 declare function buildA2uiActionMessage(params: Record<string, unknown>, surface: A2uiSurface): A2uiActionMessage;
 
+/**
+ * Build the built-in A2UI component catalog — a {@link ViewRegistry} mapping
+ * the standard A2UI element types (Card, Button, TextField, Image, AudioPlayer,
+ * Video, …) to their Angular renderers. Spread it into `provideViews` (with any
+ * of your own views) so an agent's A2UI surface specs render.
+ *
+ * @returns A {@link ViewRegistry} of the standard A2UI components.
+ * @example
+ * ```ts
+ * providers: [provideViews({ ...a2uiBasicCatalog(), MyWidget: MyWidgetComponent })]
+ * ```
+ */
 declare function a2uiBasicCatalog(): ViewRegistry;
 
 /** Writes a typed value to the render state store if the prop has a binding path. */
@@ -2394,6 +2563,8 @@ declare class A2uiIconComponent {
     readonly childKeys: _angular_core.InputSignal<string[]>;
     readonly spec: _angular_core.InputSignal<Spec | undefined>;
     protected readonly effectiveName: _angular_core.Signal<string>;
+    /** The effective name as a Material Symbols ligature (camelCase → snake_case). */
+    protected readonly glyphName: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<A2uiIconComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<A2uiIconComponent, "a2ui-icon", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "bindings": { "alias": "bindings"; "required": false; "isSignal": true; }; "emit": { "alias": "emit"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "childKeys": { "alias": "childKeys"; "required": false; "isSignal": true; }; "spec": { "alias": "spec"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -2763,7 +2934,6 @@ interface ClientToolsCoordinator {
 }
 /** Build the catalog spec list shipped to the model. */
 declare function toClientToolSpecs(registry: ClientToolRegistry): ClientToolSpec[];
-declare function createClientToolsCoordinator(registry: ClientToolRegistry): ClientToolsCoordinator;
 
 interface MockAgent extends Agent {
     messages: WritableSignal<Message[]>;
@@ -2814,10 +2984,25 @@ interface MockAgentOptions {
     history?: AgentCheckpoint[];
     events$?: Observable<AgentEvent>;
 }
+/**
+ * Build an in-memory {@link Agent} for tests and stories — no transport, no
+ * network. Every field is a writable signal so a test can drive UI states
+ * (loading, error, interrupts, tool calls, subagents) deterministically.
+ *
+ * @param opts Initial values for the mock's signals; all optional.
+ * @returns A {@link MockAgent} satisfying the full `Agent` contract.
+ * @example
+ * ```ts
+ * const agent = mockAgent({
+ *   messages: [{ id: '1', role: 'assistant', content: 'Hi' }],
+ *   isLoading: true,
+ * });
+ * ```
+ */
 declare function mockAgent(opts?: MockAgentOptions): MockAgent;
 
 /** Inferred argument type for a schema (alias of StandardSchemaInferOutput). */
 type ToolArgs<S extends StandardSchemaV1> = StandardSchemaInferOutput<S>;
 
-export { A2uiAudioPlayerComponent, A2uiButtonComponent, A2uiCardComponent, A2uiCheckBoxComponent, A2uiColumnComponent, A2uiDateTimeInputComponent, A2uiDividerComponent, A2uiIconComponent, A2uiImageComponent, A2uiListComponent, A2uiModalComponent, A2uiMultipleChoiceComponent, A2uiRowComponent, A2uiSliderComponent, A2uiSurfaceComponent, A2uiTabsComponent, A2uiTextComponent, A2uiTextFieldComponent, A2uiVideoComponent, AGENT_ERROR_MESSAGES, AgentError, CHAT_CONFIG, CHAT_LIFECYCLE, CHAT_MARKDOWN_STYLES, ChatApprovalCardComponent, ChatCitationCardTemplateDirective, ChatCitationsCardComponent, ChatCitationsComponent, ChatComponent, ChatConfirmDialogComponent, ChatErrorComponent, ChatGenerativeUiComponent, ChatGenuiSkeletonComponent, ChatHistorySearchPaletteComponent, ChatInputComponent, ChatInterruptComponent, ChatInterruptPanelComponent, ChatLauncherButtonComponent, ChatMessageActionsComponent, ChatMessageComponent, ChatMessageListComponent, ChatOverflowMenuComponent, ChatPopupComponent, ChatProjectListComponent, ChatReasoningComponent, ChatScrollBubbleComponent, ChatSelectComponent, ChatSidebarComponent, ChatSidenavComponent, ChatSidenavScrimComponent, ChatStreamingMdComponent, ChatSubagentCardComponent, ChatSubagentsComponent, ChatSuggestionsComponent, ChatThreadListComponent, ChatTimelineComponent, ChatTimelineSliderComponent, ChatToolCallCardComponent, ChatToolCallTemplateDirective, ChatToolCallsComponent, ChatToolViewsComponent, ChatTraceComponent, ChatTypingIndicatorComponent, ChatWelcomeComponent, ChatWelcomeSuggestionComponent, ChatWindowComponent, CitationsResolverService, ICON_AGENT, ICON_CHECK, ICON_CHEVRON_DOWN, ICON_CHEVRON_UP, ICON_SEND, ICON_TOOL, ICON_WARNING, IS_HEADER_ROW, MARKDOWN_VIEW_REGISTRY, MarkdownAutolinkComponent, MarkdownBlockquoteComponent, MarkdownChildrenComponent, MarkdownCitationReferenceComponent, MarkdownCodeBlockComponent, MarkdownDocumentComponent, MarkdownEmphasisComponent, MarkdownHardBreakComponent, MarkdownHeadingComponent, MarkdownImageComponent, MarkdownInlineCodeComponent, MarkdownLinkComponent, MarkdownListComponent, MarkdownListItemComponent, MarkdownParagraphComponent, MarkdownSoftBreakComponent, MarkdownStrikethroughComponent, MarkdownStrongComponent, MarkdownTableCellComponent, MarkdownTableComponent, MarkdownTableRowComponent, MarkdownTextComponent, MarkdownThematicBreakComponent, MessageTemplateDirective, a2uiBasicCatalog, action, ask, buildA2uiActionMessage, cacheplaneMarkdownViews, createA2uiSurfaceStore, createAgentRef, createClientToolsCoordinator, createContentClassifier, createParseTreeStore, createPartialArgsBridge, deriveJsonSchema, emitBinding, executeFunctionTool, extractErrorMessage, formatDuration, getInterrupt, getMessageType, injectThreadRouting, isAbortError, isAssistantMessage, isSystemMessage, isToolMessage, isTyping, isUserMessage, messageContent, mockAgent, normalizeEnvelopeArgs, normalizeViewEntry, provideChat, renderMarkdown, startClientToolExecutor, statusColor, submitMessage, surfaceToSpec, toAgentError, toClientToolSpecs, tools, validateArgs, view };
+export { A2uiAudioPlayerComponent, A2uiButtonComponent, A2uiCardComponent, A2uiCheckBoxComponent, A2uiColumnComponent, A2uiDateTimeInputComponent, A2uiDividerComponent, A2uiIconComponent, A2uiImageComponent, A2uiListComponent, A2uiModalComponent, A2uiMultipleChoiceComponent, A2uiRowComponent, A2uiSliderComponent, A2uiSurfaceComponent, A2uiTabsComponent, A2uiTextComponent, A2uiTextFieldComponent, A2uiVideoComponent, AGENT_ERROR_MESSAGES, AgentError, CHAT_CONFIG, CHAT_LIFECYCLE, ChatApprovalCardComponent, ChatCitationCardTemplateDirective, ChatCitationsCardComponent, ChatCitationsComponent, ChatComponent, ChatConfirmDialogComponent, ChatErrorComponent, ChatGenerativeUiComponent, ChatGenuiSkeletonComponent, ChatHistorySearchPaletteComponent, ChatInputComponent, ChatInterruptComponent, ChatInterruptPanelComponent, ChatLauncherButtonComponent, ChatMessageActionsComponent, ChatMessageComponent, ChatMessageListComponent, ChatOverflowMenuComponent, ChatPopupComponent, ChatProjectListComponent, ChatReasoningComponent, ChatScrollBubbleComponent, ChatSelectComponent, ChatSidebarComponent, ChatSidenavComponent, ChatSidenavScrimComponent, ChatStreamingMdComponent, ChatSubagentCardComponent, ChatSubagentsComponent, ChatSuggestionsComponent, ChatThreadListComponent, ChatTimelineComponent, ChatTimelineSliderComponent, ChatToolCallCardComponent, ChatToolCallTemplateDirective, ChatToolCallsComponent, ChatToolViewsComponent, ChatTraceComponent, ChatTypingIndicatorComponent, ChatWelcomeComponent, ChatWelcomeSuggestionComponent, ChatWindowComponent, CitationsResolverService, IS_HEADER_ROW, MARKDOWN_VIEW_REGISTRY, MarkdownAutolinkComponent, MarkdownBlockquoteComponent, MarkdownChildrenComponent, MarkdownCitationReferenceComponent, MarkdownCodeBlockComponent, MarkdownDocumentComponent, MarkdownEmphasisComponent, MarkdownHardBreakComponent, MarkdownHeadingComponent, MarkdownHtmlComponent, MarkdownImageComponent, MarkdownInlineCodeComponent, MarkdownLinkComponent, MarkdownListComponent, MarkdownListItemComponent, MarkdownMathComponent, MarkdownParagraphComponent, MarkdownSoftBreakComponent, MarkdownStrikethroughComponent, MarkdownStrongComponent, MarkdownTableCellComponent, MarkdownTableComponent, MarkdownTableRowComponent, MarkdownTextComponent, MarkdownThematicBreakComponent, MessageTemplateDirective, a2uiBasicCatalog, action, ask, buildA2uiActionMessage, cacheplaneMarkdownViews, createA2uiSurfaceStore, createAgentRef, createContentClassifier, createParseTreeStore, createPartialArgsBridge, deriveJsonSchema, emitBinding, executeFunctionTool, extractErrorMessage, formatDuration, getInterrupt, getMessageType, injectThreadRouting, isAbortError, isAssistantMessage, isSystemMessage, isToolMessage, isTyping, isUserMessage, messageContent, mockAgent, normalizeEnvelopeArgs, normalizeViewEntry, provideChat, renderMarkdown, startClientToolExecutor, statusColor, submitMessage, toAgentError, toClientToolSpecs, tools, validateArgs, view };
 export type { A2uiComponentView, A2uiSurfaceState, A2uiSurfaceStore, A2uiViewEntry, A2uiViews, Agent, AgentCheckpoint, AgentCustomEvent, AgentErrorKind, AgentEvent, AgentInterrupt, AgentRef, AgentRuntimeTelemetryEvent, AgentRuntimeTelemetryPayload, AgentRuntimeTelemetryProperties, AgentRuntimeTelemetrySink, AgentStateUpdateEvent, AgentStatus, AgentSubmitInput, AgentSubmitOptions, AgentWithHistory, AnyFunctionToolDef, AskToolDef, ChatApprovalAction, ChatConfig, ChatLifecycle, ChatMessageRole, ChatRenderEvent, ChatScrollBubbleMode, ChatSelectOption, ChatSidenavMode, ChatToolCallTemplateContext, Citation, ClientToolDef, ClientToolRegistry, ClientToolResult, ClientToolSpec, ClientToolsCapability, ClientToolsCoordinator, ContentBlock, ContentClassifier, ContentType, ElementAccumulationState, FunctionToolDef, InterruptAction, Message, MessageTemplateType, MockAgent, MockAgentOptions, OverflowMenuItem, ParseTreeStore, PartialArgsBridge, Project, ProjectActionAdapter, ResolvedCitation, Role, Subagent, SubagentStatus, Thread, ThreadActionAdapter, ThreadMatch, ThreadRoutingConfig, ToolArgs, ToolCall, ToolCallInfo, ToolCallStatus, TraceState, ViewProps, ViewToolDef };