From a2bbce495dd455d45e7b20cba2e5b4111e2894ef Mon Sep 17 00:00:00 2001
From: Brian Love <brian@liveloveapp.com>
Date: Wed, 20 May 2026 08:38:44 -0700
Subject: [PATCH 1/2] =?UTF-8?q?fix(chat,e2e):=20rename=20ChatSidenavScrim.?=
 =?UTF-8?q?close=20=E2=86=92=20closed=20+=20delete=20legacy=20subagents=20?=
 =?UTF-8?q?spec?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Two cleanups bundled:

1. Rename ChatSidenavScrimComponent's `close` output to `closed` (and
   update the demo-shell consumer + spec + JSDoc + generated api docs).
   `close` collides with the native DOM event and triggers
   @angular-eslint/no-output-native, which has been failing the
   Library — lint / test / build gate on every PR for the last week.
   Past-tense is idiomatic for Angular outputs (closed, opened,
   selected, submitted).

2. Delete cockpit/chat/subagents/angular/e2e/subagents.spec.ts
   (legacy orphan from pre-aimock era). It hardcoded
   http://localhost:4505 bypassing Playwright's baseURL, tested stale
   DOM structure (Orchestrator/Research Agent/Analysis Agent/Summary
   Agent — old cap shape), and ran silently alongside c-subagents.spec.ts
   because testMatch: '**/*.spec.ts' picks both up. The aimock-backed
   c-subagents.spec.ts is the canonical coverage.

Bumps @ngaf/chat 0.0.44 → 0.0.45 (per the lib's patch-only release
convention).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../content/docs/chat/api/api-docs.json       | 84 +++++++++----------
 .../subagents/angular/e2e/subagents.spec.ts   | 21 -----
 .../src/app/shell/demo-shell.component.html   |  2 +-
 libs/chat/package.json                        |  2 +-
 .../chat-sidenav-scrim.component.spec.ts      |  4 +-
 .../chat-sidenav-scrim.component.ts           |  8 +-
 6 files changed, 51 insertions(+), 70 deletions(-)
 delete mode 100644 cockpit/chat/subagents/angular/e2e/subagents.spec.ts

diff --git a/apps/website/content/docs/chat/api/api-docs.json b/apps/website/content/docs/chat/api/api-docs.json
index 1b0201a4..9d91538c 100644
--- a/apps/website/content/docs/chat/api/api-docs.json
+++ b/apps/website/content/docs/chat/api/api-docs.json
@@ -356,13 +356,13 @@
       {
         "name": "enableDate",
         "type": "InputSignal<boolean>",
-        "description": "v1 prop: enableDate — include date portion.",
+        "description": "v1 prop: enableDate \u2014 include date portion.",
         "optional": false
       },
       {
         "name": "enableTime",
         "type": "InputSignal<boolean>",
-        "description": "v1 prop: enableTime — include time portion.",
+        "description": "v1 prop: enableTime \u2014 include time portion.",
         "optional": false
       },
       {
@@ -458,7 +458,7 @@
       {
         "name": "orientation",
         "type": "Signal<\"horizontal\" | \"vertical\">",
-        "description": "Effective axis — `axis` wins if provided, otherwise fall back to `direction`.",
+        "description": "Effective axis \u2014 `axis` wins if provided, otherwise fall back to `direction`.",
         "optional": false
       },
       {
@@ -809,7 +809,7 @@
       {
         "name": "maxAllowedSelections",
         "type": "InputSignal<number>",
-        "description": "When ≤ 1 — render as single-select <select>; otherwise multi-select checkboxes.",
+        "description": "When \u2264 1 \u2014 render as single-select <select>; otherwise multi-select checkboxes.",
         "optional": false
       },
       {
@@ -1115,13 +1115,13 @@
       {
         "name": "rootIds",
         "type": "Signal<string[]>",
-        "description": "Roots from the surface state — components whose ids appear as\nchildren of no other component. The wire spec includes\n`beginRendering.root` as the single root; that path stays usable\nbut we keep the renderer permissive in case future surfaces emit\nmultiple top-level components.\n\nConservative: returns only the first key from componentViews\ninsertion order. The wire format's beginRendering.root carries the\ntrue root id; plumbing it through A2uiSurfaceState is a follow-up.",
+        "description": "Roots from the surface state \u2014 components whose ids appear as\nchildren of no other component. The wire spec includes\n`beginRendering.root` as the single root; that path stays usable\nbut we keep the renderer permissive in case future surfaces emit\nmultiple top-level components.\n\nConservative: returns only the first key from componentViews\ninsertion order. The wire format's beginRendering.root carries the\ntrue root id; plumbing it through A2uiSurfaceState is a follow-up.",
         "optional": false
       },
       {
         "name": "spec",
         "type": "Signal<Spec | null>",
-        "description": "Convert the A2UI surface to a json-render Spec for rendering.\n Prefers `state().surface` (the progressively-built wire surface)\n over the legacy `surface` input. surfaceToSpec handles\n children.explicitList → spec.children translation + reserved-key\n filtering + path-ref → $bindState rewriting; the rendered tree\n then uses render-element's standard input-mapping\n (`childKeys: el.children`) so catalog components receive the\n inputs they actually declare.\n\n This supersedes the earlier slot-based progressive renderer,\n which mounted root components but never populated their\n childKeys input — leaving Columns/Rows/etc. with no children.",
+        "description": "Convert the A2UI surface to a json-render Spec for rendering.\n Prefers `state().surface` (the progressively-built wire surface)\n over the legacy `surface` input. surfaceToSpec handles\n children.explicitList \u2192 spec.children translation + reserved-key\n filtering + path-ref \u2192 $bindState rewriting; the rendered tree\n then uses render-element's standard input-mapping\n (`childKeys: el.children`) so catalog components receive the\n inputs they actually declare.\n\n This supersedes the earlier slot-based progressive renderer,\n which mounted root components but never populated their\n childKeys input \u2014 leaving Columns/Rows/etc. with no children.",
         "optional": false
       },
       {
@@ -1133,7 +1133,7 @@
       {
         "name": "surface",
         "type": "InputSignal<any>",
-        "description": "Wire-format surface (legacy path — kept for backwards compat).",
+        "description": "Wire-format surface (legacy path \u2014 kept for backwards compat).",
         "optional": false
       },
       {
@@ -1187,7 +1187,7 @@
       {
         "name": "childKeys",
         "type": "InputSignal<string[]>",
-        "description": "v1: each child key corresponds to a tab's contentChild (childKeys[i] ↔ tabTitles[i]).",
+        "description": "v1: each child key corresponds to a tab's contentChild (childKeys[i] \u2194 tabTitles[i]).",
         "optional": false
       },
       {
@@ -1211,7 +1211,7 @@
       {
         "name": "tabTitles",
         "type": "InputSignal<string[]>",
-        "description": "Resolved tab titles from tabItems[*].title — produced by surface-to-spec.",
+        "description": "Resolved tab titles from tabItems[*].title \u2014 produced by surface-to-spec.",
         "optional": false
       }
     ],
@@ -1378,7 +1378,7 @@
       {
         "name": "value",
         "type": "Signal<string>",
-        "description": "Back-compat alias: value. surface-to-spec resolves DynamicString → plain string.",
+        "description": "Back-compat alias: value. surface-to-spec resolves DynamicString \u2192 plain string.",
         "optional": false
       }
     ],
@@ -1504,7 +1504,7 @@
       {
         "name": "citations",
         "type": "Signal<Citation[]>",
-        "description": "Combined citation list:\n  1. Message.citations (provider-populated, takes precedence by id)\n  2. Markdown sidecar defs (Pandoc-formatted [^id]: lines), merged in\n     for any id not already present.\n\nSorted by index ascending. This guarantees the sources panel surfaces\ncitations whether they come from message metadata, content syntax, or\nboth — matching the same precedence as inline-marker resolution.",
+        "description": "Combined citation list:\n  1. Message.citations (provider-populated, takes precedence by id)\n  2. Markdown sidecar defs (Pandoc-formatted [^id]: lines), merged in\n     for any id not already present.\n\nSorted by index ascending. This guarantees the sources panel surfaces\ncitations whether they come from message metadata, content syntax, or\nboth \u2014 matching the same precedence as inline-marker resolution.",
         "optional": false
       },
       {
@@ -1709,7 +1709,7 @@
       {
         "name": "humanContent",
         "signature": "humanContent(message: unknown)",
-        "description": "Renderable content for a human-role message bubble. Most human\nmessages are typed prompts and pass through `messageContent`\nunchanged. A2UI action messages (e.g. form submits, button clicks\non a rendered surface) flow through the same submit channel and\nland in the message stream as a HumanMessage whose content is a\nJSON-serialized `A2uiActionMessage`. Showing the raw JSON as if\nthe user typed it leaks the protocol; per the A2UI v0.9 spec\nthose events resemble tool calls more than user utterances.\n\n`a2uiActionLabel` returns a short human-readable label for\nrecognized action shapes (\"Search flights\", \"Selected flight UA123\",\netc.) — or null for any non-action content, in which case we fall\nback to the original text.",
+        "description": "Renderable content for a human-role message bubble. Most human\nmessages are typed prompts and pass through `messageContent`\nunchanged. A2UI action messages (e.g. form submits, button clicks\non a rendered surface) flow through the same submit channel and\nland in the message stream as a HumanMessage whose content is a\nJSON-serialized `A2uiActionMessage`. Showing the raw JSON as if\nthe user typed it leaks the protocol; per the A2UI v0.9 spec\nthose events resemble tool calls more than user utterances.\n\n`a2uiActionLabel` returns a short human-readable label for\nrecognized action shapes (\"Search flights\", \"Selected flight UA123\",\netc.) \u2014 or null for any non-action content, in which case we fall\nback to the original text.",
         "params": [
           {
             "name": "message",
@@ -1722,7 +1722,7 @@
       {
         "name": "isGenuiTurn",
         "signature": "isGenuiTurn(message: unknown, _prevMsg: unknown, index: number)",
-        "description": "True when this assistant message is part of a GenUI render turn.\nWalks backward through messages from `index` until it finds either\nan assistant message with `tool_calls` referencing a GenUI tool\n(→ this turn produces a surface) or a human message (→ the\npreceding turn ended; this assistant message stands on its own).\n\nAlso checks the message itself for:\n  - `extra.tool_calls[].name` matching a GenUI tool (post-streaming\n    state of the tool-call AI message), OR\n  - `extra.content[].type === 'function_call' && .name` matching\n    (live during the OpenAI Responses-API streaming chunks before\n    `tool_calls` populates).\n\nThe walk-back approach is robust to LangGraph's in-place\nreplacement of the ToolMessage (which strips the `name` field),\nunlike a single prev-message check.",
+        "description": "True when this assistant message is part of a GenUI render turn.\nWalks backward through messages from `index` until it finds either\nan assistant message with `tool_calls` referencing a GenUI tool\n(\u2192 this turn produces a surface) or a human message (\u2192 the\npreceding turn ended; this assistant message stands on its own).\n\nAlso checks the message itself for:\n  - `extra.tool_calls[].name` matching a GenUI tool (post-streaming\n    state of the tool-call AI message), OR\n  - `extra.content[].type === 'function_call' && .name` matching\n    (live during the OpenAI Responses-API streaming chunks before\n    `tool_calls` populates).\n\nThe walk-back approach is robust to LangGraph's in-place\nreplacement of the ToolMessage (which strips the `name` field),\nunlike a single prev-message check.",
         "params": [
           {
             "name": "message",
@@ -1747,7 +1747,7 @@
       {
         "name": "isReasoningStreaming",
         "signature": "isReasoningStreaming(message: Message, index: number)",
-        "description": "True while a message's reasoning is mid-stream — i.e. it's the latest\nmessage, the agent is loading, the message has reasoning content, and\nno response text has arrived yet. Once the response text begins, the\nreasoning pill collapses (per its internal logic).",
+        "description": "True while a message's reasoning is mid-stream \u2014 i.e. it's the latest\nmessage, the agent is loading, the message has reasoning content, and\nno response text has arrived yet. Once the response text begins, the\nreasoning pill collapses (per its internal logic).",
         "params": [
           {
             "name": "message",
@@ -2414,7 +2414,7 @@
       {
         "name": "clicked",
         "type": "OutputEmitterRef<void>",
-        "description": "Fires when the inner <button> receives a click. Prefer this over\n binding `(click)` on the host element — explicit output gives\n consumers (and Playwright) an unambiguous click target that won't\n be intercepted by sibling overlays in higher stacking contexts.\n Native `(click)` on the host still works for back-compat: the\n click event bubbles through unchanged.",
+        "description": "Fires when the inner <button> receives a click. Prefer this over\n binding `(click)` on the host element \u2014 explicit output gives\n consumers (and Playwright) an unambiguous click target that won't\n be intercepted by sibling overlays in higher stacking contexts.\n Native `(click)` on the host still works for back-compat: the\n click event bubbles through unchanged.",
         "optional": false
       }
     ],
@@ -2717,7 +2717,7 @@
       {
         "name": "shortcut",
         "type": "InputSignal<string | null>",
-        "description": "Keyboard shortcut (single key) that toggles the popup with cmd (mac)\nor ctrl (other). Set to `null` to disable. Default: 'k' — matches the\nwidely-used cmd/ctrl+K convention.",
+        "description": "Keyboard shortcut (single key) that toggles the popup with cmd (mac)\nor ctrl (other). Set to `null` to disable. Default: 'k' \u2014 matches the\nwidely-used cmd/ctrl+K convention.",
         "optional": false
       },
       {
@@ -2978,7 +2978,7 @@
   {
     "name": "ChatReasoningComponent",
     "kind": "class",
-    "description": "Renders an assistant's reasoning content as a compact pill that\nexpands to reveal the underlying text. Three visual states:\n\n- Streaming: pill shows \"Thinking…\" with a pulsing dot; auto-expanded\n  so the user sees reasoning stream in real time.\n- Idle, with durationMs known: pill shows \"Thought for {duration}\";\n  collapsed by default, expand on click.\n- Idle, no duration: pill shows \"Show reasoning\"; collapsed by default.\n\nThe body re-uses chat-streaming-md so reasoning content gets the same\nmarkdown rendering pipeline as the visible response (lists, code,\nstep labels often appear in reasoning output).\n\nInternal state: a tristate \"expanded\" — null means follow auto state-\ndriven logic (force-expand on isStreaming, otherwise honor\ndefaultExpanded), boolean is a manual user choice that wins for the\nlifetime of the instance.",
+    "description": "Renders an assistant's reasoning content as a compact pill that\nexpands to reveal the underlying text. Three visual states:\n\n- Streaming: pill shows \"Thinking\u2026\" with a pulsing dot; auto-expanded\n  so the user sees reasoning stream in real time.\n- Idle, with durationMs known: pill shows \"Thought for {duration}\";\n  collapsed by default, expand on click.\n- Idle, no duration: pill shows \"Show reasoning\"; collapsed by default.\n\nThe body re-uses chat-streaming-md so reasoning content gets the same\nmarkdown rendering pipeline as the visible response (lists, code,\nstep labels often appear in reasoning output).\n\nInternal state: a tristate \"expanded\" \u2014 null means follow auto state-\ndriven logic (force-expand on isStreaming, otherwise honor\ndefaultExpanded), boolean is a manual user choice that wins for the\nlifetime of the instance.",
     "params": [],
     "examples": [],
     "properties": [
@@ -3077,7 +3077,7 @@
   {
     "name": "ChatSelectComponent",
     "kind": "class",
-    "description": "Generic single-select dropdown. Designed to slot into the chat input pill\n(via [chatInputModelSelect]) but usable anywhere.\n\nInputs:\n  options      — array of { value, label, disabled? }; required\n  value        — currently selected value (two-way via model())\n  placeholder  — trigger label when no option matches; default 'Select'\n  disabled     — disables the trigger; default false\n  menuLabel    — aria-label for the popover; defaults to placeholder",
+    "description": "Generic single-select dropdown. Designed to slot into the chat input pill\n(via [chatInputModelSelect]) but usable anywhere.\n\nInputs:\n  options      \u2014 array of { value, label, disabled? }; required\n  value        \u2014 currently selected value (two-way via model())\n  placeholder  \u2014 trigger label when no option matches; default 'Select'\n  disabled     \u2014 disables the trigger; default false\n  menuLabel    \u2014 aria-label for the popover; defaults to placeholder",
     "params": [],
     "examples": [],
     "properties": [
@@ -3414,14 +3414,14 @@
   {
     "name": "ChatSidenavScrimComponent",
     "kind": "class",
-    "description": "Backdrop scrim for chat-sidenav's drawer mode, rendered as a sibling of\n<chat-sidenav> so its z-index sits cleanly between the page content\nand the drawer host (escapes the drawer host's stacking context).\n\nUsage:\n  <chat-sidenav-scrim [open]=\"drawerOpen()\" (close)=\"drawerOpen.set(false)\" />\n  <chat-sidenav [(open)]=\"drawerOpen\" ...></chat-sidenav>",
+    "description": "Backdrop scrim for chat-sidenav's drawer mode, rendered as a sibling of\n<chat-sidenav> so its z-index sits cleanly between the page content\nand the drawer host (escapes the drawer host's stacking context).\n\nUsage:\n  <chat-sidenav-scrim [open]=\"drawerOpen()\" (closed)=\"drawerOpen.set(false)\" />\n  <chat-sidenav [(open)]=\"drawerOpen\" ...></chat-sidenav>",
     "params": [],
     "examples": [],
     "properties": [
       {
-        "name": "close",
+        "name": "closed",
         "type": "OutputEmitterRef<void>",
-        "description": "Fires when the user clicks the backdrop.",
+        "description": "Fires when the user clicks the backdrop. Past-tense to avoid collision with native DOM close event.",
         "optional": false
       },
       {
@@ -3436,7 +3436,7 @@
   {
     "name": "ChatStreamingMdComponent",
     "kind": "class",
-    "description": "Renders streaming markdown by walking a @cacheplane/partial-markdown AST\nthrough @ngaf/render's view registry.\n\nReactivity model: the live `parser.root` keeps a stable JS reference\nacross pushes (partial-markdown's identity guarantee). To make Angular\nsignals propagate downstream when the underlying tree changes, we surface\na materialized snapshot via `materialize()`. The snapshot shares\nstructurally — unchanged subtrees keep the SAME reference, and any\ndescendant change yields a NEW root reference. This lets Angular's\n`Object.is` equality check both detect changes (root reference differs)\nand short-circuit unchanged subtrees (per-node references stable).\n\nOverride per-node-type renderers via the `[viewRegistry]` input or by\nsupplying a different `MARKDOWN_VIEW_REGISTRY` provider in the injector\ntree.",
+    "description": "Renders streaming markdown by walking a @cacheplane/partial-markdown AST\nthrough @ngaf/render's view registry.\n\nReactivity model: the live `parser.root` keeps a stable JS reference\nacross pushes (partial-markdown's identity guarantee). To make Angular\nsignals propagate downstream when the underlying tree changes, we surface\na materialized snapshot via `materialize()`. The snapshot shares\nstructurally \u2014 unchanged subtrees keep the SAME reference, and any\ndescendant change yields a NEW root reference. This lets Angular's\n`Object.is` equality check both detect changes (root reference differs)\nand short-circuit unchanged subtrees (per-node references stable).\n\nOverride per-node-type renderers via the `[viewRegistry]` input or by\nsupplying a different `MARKDOWN_VIEW_REGISTRY` provider in the injector\ntree.",
     "params": [],
     "examples": [],
     "properties": [
@@ -3615,7 +3615,7 @@
       {
         "name": "menuAnchorPos",
         "type": "WritableSignal<object | null>",
-        "description": "Cursor-anchored position when the menu was opened via right-click.\n Mutually exclusive with `menuAnchor` — set one, null the other.",
+        "description": "Cursor-anchored position when the menu was opened via right-click.\n Mutually exclusive with `menuAnchor` \u2014 set one, null the other.",
         "optional": false
       },
       {
@@ -3855,7 +3855,7 @@
       {
         "name": "onRowContextMenu",
         "signature": "onRowContextMenu(threadId: string, event: MouseEvent)",
-        "description": "Right-click on a row opens the same overflow menu anchored at the\n cursor. Always prevents the native context menu — including when the\n adapter exposes no row actions (in which case we open nothing rather\n than confusing the user with the OS menu on what looks like a custom\n list).",
+        "description": "Right-click on a row opens the same overflow menu anchored at the\n cursor. Always prevents the native context menu \u2014 including when the\n adapter exposes no row actions (in which case we open nothing rather\n than confusing the user with the OS menu on what looks like a custom\n list).",
         "params": [
           {
             "name": "threadId",
@@ -4256,7 +4256,7 @@
       {
         "name": "excludeToolNames",
         "type": "InputSignal<readonly string[]>",
-        "description": "Tool names whose groups should be hidden. Used by chat compositions\nto filter out internal/orchestration tools (e.g. GenUI dispatchers)\nwhose args streaming is not meaningful to surface in the chat.\nDefault empty — preserves prior behavior for non-filtering consumers.",
+        "description": "Tool names whose groups should be hidden. Used by chat compositions\nto filter out internal/orchestration tools (e.g. GenUI dispatchers)\nwhose args streaming is not meaningful to surface in the chat.\nDefault empty \u2014 preserves prior behavior for non-filtering consumers.",
         "optional": false
       },
       {
@@ -4438,7 +4438,7 @@
   {
     "name": "ChatWelcomeComponent",
     "kind": "class",
-    "description": "Empty-state owner. Renders a centered greeting + slot-projected input +\noptional vertical suggestion rows. Mounted only when the parent chat has\nno messages and welcome is not disabled.\n\nSlots:\n  [chatWelcomeTitle]       — replaces the default <h1> \"How can I help?\"\n  [chatWelcomeInput]       — projects the chat input into the center column\n  [chatWelcomeSuggestions] — projects suggestion rows below the input\n\nHost CSS variables (override on :host or any ancestor):\n  --ngaf-chat-welcome-max-width  default 36rem\n  --ngaf-chat-welcome-gap        default 1.25rem\n  --ngaf-chat-welcome-padding    default 24px",
+    "description": "Empty-state owner. Renders a centered greeting + slot-projected input +\noptional vertical suggestion rows. Mounted only when the parent chat has\nno messages and welcome is not disabled.\n\nSlots:\n  [chatWelcomeTitle]       \u2014 replaces the default <h1> \"How can I help?\"\n  [chatWelcomeInput]       \u2014 projects the chat input into the center column\n  [chatWelcomeSuggestions] \u2014 projects suggestion rows below the input\n\nHost CSS variables (override on :host or any ancestor):\n  --ngaf-chat-welcome-max-width  default 36rem\n  --ngaf-chat-welcome-gap        default 1.25rem\n  --ngaf-chat-welcome-padding    default 24px",
     "params": [],
     "examples": [],
     "properties": [],
@@ -4972,7 +4972,7 @@
   {
     "name": "A2uiComponentView",
     "kind": "interface",
-    "description": "Chat-internal projection of an A2UI component, materialized by the\nsurface store. Distinct from the wire-format `A2uiComponent` in\n`@ngaf/a2ui` (which carries the raw `component: A2uiComponentDef`\npayload) — this type adds the per-component readiness fields the\nprogressive renderer consumes.",
+    "description": "Chat-internal projection of an A2UI component, materialized by the\nsurface store. Distinct from the wire-format `A2uiComponent` in\n`@ngaf/a2ui` (which carries the raw `component: A2uiComponentDef`\npayload) \u2014 this type adds the per-component readiness fields the\nprogressive renderer consumes.",
     "properties": [
       {
         "name": "bindings",
@@ -5007,7 +5007,7 @@
       {
         "name": "type",
         "type": "string",
-        "description": "The component type key — e.g. `'Button'`, `'TextField'` — matched\nagainst catalog `views` entries.",
+        "description": "The component type key \u2014 e.g. `'Button'`, `'TextField'` \u2014 matched\nagainst catalog `views` entries.",
         "optional": false
       }
     ],
@@ -5016,7 +5016,7 @@
   {
     "name": "A2uiSurfaceState",
     "kind": "interface",
-    "description": "Chat-side state for a surface — wraps the wire-format `A2uiSurface`\nwith the per-component projection the progressive renderer consumes.\nBoth maps are kept in sync; the wire shape preserves existing\n`surfaceToSpec` semantics, the view shape carries readiness.",
+    "description": "Chat-side state for a surface \u2014 wraps the wire-format `A2uiSurface`\nwith the per-component projection the progressive renderer consumes.\nBoth maps are kept in sync; the wire shape preserves existing\n`surfaceToSpec` semantics, the view shape carries readiness.",
     "properties": [
       {
         "name": "componentViews",
@@ -5166,7 +5166,7 @@
   {
     "name": "AgentCheckpoint",
     "kind": "interface",
-    "description": "Runtime-neutral snapshot of a point in an agent's execution history.\n\nConsumed by time-travel / debug UIs. `id` is adapter-opaque — UIs emit\nit back to the parent app on replay/fork, and the parent app dispatches\nto the underlying runtime.",
+    "description": "Runtime-neutral snapshot of a point in an agent's execution history.\n\nConsumed by time-travel / debug UIs. `id` is adapter-opaque \u2014 UIs emit\nit back to the parent app on replay/fork, and the parent app dispatches\nto the underlying runtime.",
     "properties": [
       {
         "name": "id",
@@ -5409,7 +5409,7 @@
       {
         "name": "messageCheckpoints",
         "type": "Signal<ReadonlyMap<string, string>>",
-        "description": "Optional reactive map of `messageId → checkpointId`, computed by\nwalking history once: for each checkpoint, find the most recent\nassistant message present in its `values.messages` and pair them.\nUIs use this to anchor inline checkpoint markers on each assistant\nturn. Missing on adapters that don't compute it.",
+        "description": "Optional reactive map of `messageId \u2192 checkpointId`, computed by\nwalking history once: for each checkpoint, find the most recent\nassistant message present in its `values.messages` and pair them.\nUIs use this to anchor inline checkpoint markers on each assistant\nturn. Missing on adapters that don't compute it.",
         "optional": true
       },
       {
@@ -5521,7 +5521,7 @@
       {
         "name": "firstMessageSent",
         "type": "Signal<boolean>",
-        "description": "True after the first user submit. Sticky for the life of the chat instance — does NOT reset on clearThread.",
+        "description": "True after the first user submit. Sticky for the life of the chat instance \u2014 does NOT reset on clearThread.",
         "optional": false
       },
       {
@@ -5793,7 +5793,7 @@
       {
         "name": "reasoning",
         "type": "string",
-        "description": "Reasoning text emitted by the model before/alongside the visible\nresponse. Populated by adapters from {type:'reasoning'} or\n{type:'thinking'} content blocks (LangGraph) or REASONING_MESSAGE_*\nevents (AG-UI). Always a plain string — provider-specific shape\n(encrypted blocks, multi-step summaries) is absorbed by the adapter\nand not surfaced here.",
+        "description": "Reasoning text emitted by the model before/alongside the visible\nresponse. Populated by adapters from {type:'reasoning'} or\n{type:'thinking'} content blocks (LangGraph) or REASONING_MESSAGE_*\nevents (AG-UI). Always a plain string \u2014 provider-specific shape\n(encrypted blocks, multi-step summaries) is absorbed by the adapter\nand not surfaced here.",
         "optional": true
       },
       {
@@ -5817,7 +5817,7 @@
       {
         "name": "toolCallIds",
         "type": "string[]",
-        "description": "IDs of tool calls emitted BY this assistant message. Populated by\nadapters from provider-native fields (LangGraph: `tool_calls[].id`;\nAnthropic: `tool_use` content blocks). Used by `<chat-tool-calls>` to\nscope its rendering to a single message — otherwise it falls back to\nthe agent's global toolCalls list, which renders duplicates across\nevery AI message in a thread.",
+        "description": "IDs of tool calls emitted BY this assistant message. Populated by\nadapters from provider-native fields (LangGraph: `tool_calls[].id`;\nAnthropic: `tool_use` content blocks). Used by `<chat-tool-calls>` to\nscope its rendering to a single message \u2014 otherwise it falls back to\nthe agent's global toolCalls list, which renders duplicates across\nevery AI message in a thread.",
         "optional": true
       }
     ],
@@ -6166,7 +6166,7 @@
   {
     "name": "ThreadActionAdapter",
     "kind": "interface",
-    "description": "Per-thread row-action adapter. Consumer-provided. The framework calls\nthese methods after user confirmation (delete) or commit (rename) and\nmanages optimistic UI + rollback on rejection.\n\nConsumers MUST refresh their `threads` signal on success — the framework\nclears optimistic overrides in a `finally` block, so a successful adapter\ncall that leaves the input list unchanged would re-render the row.",
+    "description": "Per-thread row-action adapter. Consumer-provided. The framework calls\nthese methods after user confirmation (delete) or commit (rename) and\nmanages optimistic UI + rollback on rejection.\n\nConsumers MUST refresh their `threads` signal on success \u2014 the framework\nclears optimistic overrides in a `finally` block, so a successful adapter\ncall that leaves the input list unchanged would re-render the row.",
     "properties": [
       {
         "name": "archive",
@@ -6321,7 +6321,7 @@
       {
         "name": "status",
         "type": "ToolCallStatus",
-        "description": "Optional — present when the parent provides it. Drives the pill + default-collapsed logic.",
+        "description": "Optional \u2014 present when the parent provides it. Drives the pill + default-collapsed logic.",
         "optional": true
       }
     ],
@@ -6344,7 +6344,7 @@
   {
     "name": "A2uiViews",
     "kind": "type",
-    "description": "Catalog shape accepted by `<a2ui-surface>`. Each entry is either a\nbare `Type<unknown>` (legacy shape — no per-component fallback) or\nan `A2uiViewEntry`.",
+    "description": "Catalog shape accepted by `<a2ui-surface>`. Each entry is either a\nbare `Type<unknown>` (legacy shape \u2014 no per-component fallback) or\nan `A2uiViewEntry`.",
     "signature": "Readonly<Record<string, Type<unknown> | A2uiViewEntry>>",
     "examples": []
   },
@@ -6557,7 +6557,7 @@
   {
     "name": "createPartialArgsBridge",
     "kind": "function",
-    "description": "Subscribes to LangGraph custom events of name 'a2ui-partial' and feeds\nthe surface store envelope-by-envelope as the parent LLM streams its\ntool_call.arguments JSON. Uses @cacheplane/partial-json to extract\nstructurally-complete envelope objects from the growing args string.\n\nSynthesis safety net: if the first complete surfaceUpdate arrives and\nno beginRendering has been extracted yet, the bridge synthesises one\ntargeted at the surfaceUpdate's first component (preferring id='root'\nif present). This makes the surface mount IMMEDIATELY after the first\nsurfaceUpdate parses — without waiting for the LLM to emit beginRendering\nat the end of its envelope list — so the render-element fallback gate\n(PR #252) actually fires while dataModelUpdates flow in.\n\nThe store's apply() already treats repeated beginRendering for the same\nsurfaceId as idempotent (just re-applies styles), so the LLM's eventual\nbeginRendering (if any) is a no-op rather than a conflict.",
+    "description": "Subscribes to LangGraph custom events of name 'a2ui-partial' and feeds\nthe surface store envelope-by-envelope as the parent LLM streams its\ntool_call.arguments JSON. Uses @cacheplane/partial-json to extract\nstructurally-complete envelope objects from the growing args string.\n\nSynthesis safety net: if the first complete surfaceUpdate arrives and\nno beginRendering has been extracted yet, the bridge synthesises one\ntargeted at the surfaceUpdate's first component (preferring id='root'\nif present). This makes the surface mount IMMEDIATELY after the first\nsurfaceUpdate parses \u2014 without waiting for the LLM to emit beginRendering\nat the end of its envelope list \u2014 so the render-element fallback gate\n(PR #252) actually fires while dataModelUpdates flow in.\n\nThe store's apply() already treats repeated beginRendering for the same\nsurfaceId as idempotent (just re-applies styles), so the LLM's eventual\nbeginRendering (if any) is a no-op rather than a conflict.",
     "signature": "createPartialArgsBridge(store: A2uiSurfaceStore): PartialArgsBridge",
     "params": [
       {
@@ -6632,7 +6632,7 @@
   {
     "name": "formatDuration",
     "kind": "function",
-    "description": "Render a millisecond duration as a human-readable label suitable for\nthe chat-reasoning \"Thought for Ns\" pill.\n\n- <1 s         → \"<1s\"\n- 1–59 s       → \"Ns\"     (e.g. \"4s\")\n- ≥60 s        → \"Nm Ms\"  (e.g. \"1m 12s\", \"60m 0s\")\n\nNegative or non-finite inputs collapse to \"<1s\" so a corrupted timing\nmap never produces noisy output.",
+    "description": "Render a millisecond duration as a human-readable label suitable for\nthe chat-reasoning \"Thought for Ns\" pill.\n\n- <1 s         \u2192 \"<1s\"\n- 1\u201359 s       \u2192 \"Ns\"     (e.g. \"4s\")\n- \u226560 s        \u2192 \"Nm Ms\"  (e.g. \"1m 12s\", \"60m 0s\")\n\nNegative or non-finite inputs collapse to \"<1s\" so a corrupted timing\nmap never produces noisy output.",
     "signature": "formatDuration(ms: number): string",
     "params": [
       {
@@ -7005,7 +7005,7 @@
   {
     "name": "views",
     "kind": "function",
-    "description": "Creates a view registry from a name → component map.",
+    "description": "Creates a view registry from a name \u2192 component map.",
     "signature": "views(map: Record<string, Type<unknown> | RenderViewEntry>): ViewRegistry",
     "params": [
       {
@@ -7094,7 +7094,7 @@
   {
     "name": "assertReasoningFixtureMessages",
     "kind": "function",
-    "description": "Assertion — common to both adapters. Throws if the produced messages\ndon't match the shared expectation.",
+    "description": "Assertion \u2014 common to both adapters. Throws if the produced messages\ndon't match the shared expectation.",
     "signature": "assertReasoningFixtureMessages(messages: readonly Message[]): void",
     "params": [
       {
@@ -7160,4 +7160,4 @@
     },
     "examples": []
   }
-]
\ No newline at end of file
+]
diff --git a/cockpit/chat/subagents/angular/e2e/subagents.spec.ts b/cockpit/chat/subagents/angular/e2e/subagents.spec.ts
deleted file mode 100644
index 5599ffd9..00000000
--- a/cockpit/chat/subagents/angular/e2e/subagents.spec.ts
+++ /dev/null
@@ -1,21 +0,0 @@
-import { expect, test } from '@playwright/test';
-
-test.describe('Chat Subagents Example', () => {
-  test.beforeEach(async ({ page }) => {
-    await page.goto('http://localhost:4505');
-    await page.waitForSelector('app-subagents', { state: 'attached' });
-  });
-
-  test('renders the chat interface with subagents sidebar', async ({ page }) => {
-    await expect(page.locator('chat')).toBeVisible();
-    await expect(page.locator('aside')).toBeVisible();
-    await expect(page.locator('aside h3')).toHaveText('Active Subagents');
-  });
-
-  test('displays the agent pipeline', async ({ page }) => {
-    await expect(page.locator('aside')).toContainText('Orchestrator');
-    await expect(page.locator('aside')).toContainText('Research Agent');
-    await expect(page.locator('aside')).toContainText('Analysis Agent');
-    await expect(page.locator('aside')).toContainText('Summary Agent');
-  });
-});
diff --git a/examples/chat/angular/src/app/shell/demo-shell.component.html b/examples/chat/angular/src/app/shell/demo-shell.component.html
index e8402678..0cd681f6 100644
--- a/examples/chat/angular/src/app/shell/demo-shell.component.html
+++ b/examples/chat/angular/src/app/shell/demo-shell.component.html
@@ -60,7 +60,7 @@
 
   <chat-sidenav-scrim
     [open]="sidenavMode() === 'drawer' && drawerOpen()"
-    (close)="drawerOpen.set(false)"
+    (closed)="drawerOpen.set(false)"
   />
   <chat-sidenav
     [threads]="visibleThreads()"
diff --git a/libs/chat/package.json b/libs/chat/package.json
index 560b8a3c..ac3b474d 100644
--- a/libs/chat/package.json
+++ b/libs/chat/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@ngaf/chat",
-  "version": "0.0.44",
+  "version": "0.0.45",
   "exports": {
     "./chat.css": "./chat.css",
     "./themes/default-dark.css": "./themes/default-dark.css",
diff --git a/libs/chat/src/lib/primitives/chat-sidenav-scrim/chat-sidenav-scrim.component.spec.ts b/libs/chat/src/lib/primitives/chat-sidenav-scrim/chat-sidenav-scrim.component.spec.ts
index d8dd4299..7dc1b431 100644
--- a/libs/chat/src/lib/primitives/chat-sidenav-scrim/chat-sidenav-scrim.component.spec.ts
+++ b/libs/chat/src/lib/primitives/chat-sidenav-scrim/chat-sidenav-scrim.component.spec.ts
@@ -24,11 +24,11 @@ describe('ChatSidenavScrimComponent', () => {
     expect(btn.getAttribute('aria-label')).toBe('Close conversations');
   });
 
-  it('emits (close) on click', () => {
+  it('emits (closed) on click', () => {
     fx.componentRef.setInput('open', true);
     fx.detectChanges();
     let closed = false;
-    fx.componentInstance.close.subscribe(() => { closed = true; });
+    fx.componentInstance.closed.subscribe(() => { closed = true; });
     const btn = fx.nativeElement.querySelector('button.chat-sidenav-scrim__button') as HTMLButtonElement;
     btn.click();
     expect(closed).toBe(true);
diff --git a/libs/chat/src/lib/primitives/chat-sidenav-scrim/chat-sidenav-scrim.component.ts b/libs/chat/src/lib/primitives/chat-sidenav-scrim/chat-sidenav-scrim.component.ts
index 41d107f0..d8e823cc 100644
--- a/libs/chat/src/lib/primitives/chat-sidenav-scrim/chat-sidenav-scrim.component.ts
+++ b/libs/chat/src/lib/primitives/chat-sidenav-scrim/chat-sidenav-scrim.component.ts
@@ -8,7 +8,7 @@ import { ChangeDetectionStrategy, Component, input, output } from '@angular/core
  * and the drawer host (escapes the drawer host's stacking context).
  *
  * Usage:
- *   <chat-sidenav-scrim [open]="drawerOpen()" (close)="drawerOpen.set(false)" />
+ *   <chat-sidenav-scrim [open]="drawerOpen()" (closed)="drawerOpen.set(false)" />
  *   <chat-sidenav [(open)]="drawerOpen" ...></chat-sidenav>
  */
 @Component({
@@ -43,6 +43,8 @@ import { ChangeDetectionStrategy, Component, input, output } from '@angular/core
 export class ChatSidenavScrimComponent {
   /** When true, render the backdrop button covering the viewport. */
   readonly open = input<boolean>(false);
-  /** Fires when the user clicks the backdrop. */
-  readonly close = output<void>();
+  /** Fires when the user clicks the backdrop. Past-tense to avoid
+   *  collision with the native DOM `close` event (per
+   *  `@angular-eslint/no-output-native`). */
+  readonly closed = output<void>();
 }

From d570f61843f08bb09d38ffa1e8ec260da990f162 Mon Sep 17 00:00:00 2001
From: Brian Love <brian@liveloveapp.com>
Date: Wed, 20 May 2026 08:39:38 -0700
Subject: [PATCH 2/2] chore(api-docs): preserve em-dash unicode literals
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Prior commit's python json.dump used default ASCII escaping, which
converted ~38 unrelated em-dash characters to — across the file.
Rewriting with ensure_ascii=False so the api-docs.json keeps its
original encoding; my ChatSidenavScrim.closed rename remains.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../content/docs/chat/api/api-docs.json       | 76 +++++++++----------
 1 file changed, 38 insertions(+), 38 deletions(-)

diff --git a/apps/website/content/docs/chat/api/api-docs.json b/apps/website/content/docs/chat/api/api-docs.json
index 9d91538c..afa5cc20 100644
--- a/apps/website/content/docs/chat/api/api-docs.json
+++ b/apps/website/content/docs/chat/api/api-docs.json
@@ -356,13 +356,13 @@
       {
         "name": "enableDate",
         "type": "InputSignal<boolean>",
-        "description": "v1 prop: enableDate \u2014 include date portion.",
+        "description": "v1 prop: enableDate — include date portion.",
         "optional": false
       },
       {
         "name": "enableTime",
         "type": "InputSignal<boolean>",
-        "description": "v1 prop: enableTime \u2014 include time portion.",
+        "description": "v1 prop: enableTime — include time portion.",
         "optional": false
       },
       {
@@ -458,7 +458,7 @@
       {
         "name": "orientation",
         "type": "Signal<\"horizontal\" | \"vertical\">",
-        "description": "Effective axis \u2014 `axis` wins if provided, otherwise fall back to `direction`.",
+        "description": "Effective axis — `axis` wins if provided, otherwise fall back to `direction`.",
         "optional": false
       },
       {
@@ -809,7 +809,7 @@
       {
         "name": "maxAllowedSelections",
         "type": "InputSignal<number>",
-        "description": "When \u2264 1 \u2014 render as single-select <select>; otherwise multi-select checkboxes.",
+        "description": "When ≤ 1 — render as single-select <select>; otherwise multi-select checkboxes.",
         "optional": false
       },
       {
@@ -1115,13 +1115,13 @@
       {
         "name": "rootIds",
         "type": "Signal<string[]>",
-        "description": "Roots from the surface state \u2014 components whose ids appear as\nchildren of no other component. The wire spec includes\n`beginRendering.root` as the single root; that path stays usable\nbut we keep the renderer permissive in case future surfaces emit\nmultiple top-level components.\n\nConservative: returns only the first key from componentViews\ninsertion order. The wire format's beginRendering.root carries the\ntrue root id; plumbing it through A2uiSurfaceState is a follow-up.",
+        "description": "Roots from the surface state — components whose ids appear as\nchildren of no other component. The wire spec includes\n`beginRendering.root` as the single root; that path stays usable\nbut we keep the renderer permissive in case future surfaces emit\nmultiple top-level components.\n\nConservative: returns only the first key from componentViews\ninsertion order. The wire format's beginRendering.root carries the\ntrue root id; plumbing it through A2uiSurfaceState is a follow-up.",
         "optional": false
       },
       {
         "name": "spec",
         "type": "Signal<Spec | null>",
-        "description": "Convert the A2UI surface to a json-render Spec for rendering.\n Prefers `state().surface` (the progressively-built wire surface)\n over the legacy `surface` input. surfaceToSpec handles\n children.explicitList \u2192 spec.children translation + reserved-key\n filtering + path-ref \u2192 $bindState rewriting; the rendered tree\n then uses render-element's standard input-mapping\n (`childKeys: el.children`) so catalog components receive the\n inputs they actually declare.\n\n This supersedes the earlier slot-based progressive renderer,\n which mounted root components but never populated their\n childKeys input \u2014 leaving Columns/Rows/etc. with no children.",
+        "description": "Convert the A2UI surface to a json-render Spec for rendering.\n Prefers `state().surface` (the progressively-built wire surface)\n over the legacy `surface` input. surfaceToSpec handles\n children.explicitList → spec.children translation + reserved-key\n filtering + path-ref → $bindState rewriting; the rendered tree\n then uses render-element's standard input-mapping\n (`childKeys: el.children`) so catalog components receive the\n inputs they actually declare.\n\n This supersedes the earlier slot-based progressive renderer,\n which mounted root components but never populated their\n childKeys input — leaving Columns/Rows/etc. with no children.",
         "optional": false
       },
       {
@@ -1133,7 +1133,7 @@
       {
         "name": "surface",
         "type": "InputSignal<any>",
-        "description": "Wire-format surface (legacy path \u2014 kept for backwards compat).",
+        "description": "Wire-format surface (legacy path — kept for backwards compat).",
         "optional": false
       },
       {
@@ -1187,7 +1187,7 @@
       {
         "name": "childKeys",
         "type": "InputSignal<string[]>",
-        "description": "v1: each child key corresponds to a tab's contentChild (childKeys[i] \u2194 tabTitles[i]).",
+        "description": "v1: each child key corresponds to a tab's contentChild (childKeys[i] ↔ tabTitles[i]).",
         "optional": false
       },
       {
@@ -1211,7 +1211,7 @@
       {
         "name": "tabTitles",
         "type": "InputSignal<string[]>",
-        "description": "Resolved tab titles from tabItems[*].title \u2014 produced by surface-to-spec.",
+        "description": "Resolved tab titles from tabItems[*].title — produced by surface-to-spec.",
         "optional": false
       }
     ],
@@ -1378,7 +1378,7 @@
       {
         "name": "value",
         "type": "Signal<string>",
-        "description": "Back-compat alias: value. surface-to-spec resolves DynamicString \u2192 plain string.",
+        "description": "Back-compat alias: value. surface-to-spec resolves DynamicString → plain string.",
         "optional": false
       }
     ],
@@ -1504,7 +1504,7 @@
       {
         "name": "citations",
         "type": "Signal<Citation[]>",
-        "description": "Combined citation list:\n  1. Message.citations (provider-populated, takes precedence by id)\n  2. Markdown sidecar defs (Pandoc-formatted [^id]: lines), merged in\n     for any id not already present.\n\nSorted by index ascending. This guarantees the sources panel surfaces\ncitations whether they come from message metadata, content syntax, or\nboth \u2014 matching the same precedence as inline-marker resolution.",
+        "description": "Combined citation list:\n  1. Message.citations (provider-populated, takes precedence by id)\n  2. Markdown sidecar defs (Pandoc-formatted [^id]: lines), merged in\n     for any id not already present.\n\nSorted by index ascending. This guarantees the sources panel surfaces\ncitations whether they come from message metadata, content syntax, or\nboth — matching the same precedence as inline-marker resolution.",
         "optional": false
       },
       {
@@ -1709,7 +1709,7 @@
       {
         "name": "humanContent",
         "signature": "humanContent(message: unknown)",
-        "description": "Renderable content for a human-role message bubble. Most human\nmessages are typed prompts and pass through `messageContent`\nunchanged. A2UI action messages (e.g. form submits, button clicks\non a rendered surface) flow through the same submit channel and\nland in the message stream as a HumanMessage whose content is a\nJSON-serialized `A2uiActionMessage`. Showing the raw JSON as if\nthe user typed it leaks the protocol; per the A2UI v0.9 spec\nthose events resemble tool calls more than user utterances.\n\n`a2uiActionLabel` returns a short human-readable label for\nrecognized action shapes (\"Search flights\", \"Selected flight UA123\",\netc.) \u2014 or null for any non-action content, in which case we fall\nback to the original text.",
+        "description": "Renderable content for a human-role message bubble. Most human\nmessages are typed prompts and pass through `messageContent`\nunchanged. A2UI action messages (e.g. form submits, button clicks\non a rendered surface) flow through the same submit channel and\nland in the message stream as a HumanMessage whose content is a\nJSON-serialized `A2uiActionMessage`. Showing the raw JSON as if\nthe user typed it leaks the protocol; per the A2UI v0.9 spec\nthose events resemble tool calls more than user utterances.\n\n`a2uiActionLabel` returns a short human-readable label for\nrecognized action shapes (\"Search flights\", \"Selected flight UA123\",\netc.) — or null for any non-action content, in which case we fall\nback to the original text.",
         "params": [
           {
             "name": "message",
@@ -1722,7 +1722,7 @@
       {
         "name": "isGenuiTurn",
         "signature": "isGenuiTurn(message: unknown, _prevMsg: unknown, index: number)",
-        "description": "True when this assistant message is part of a GenUI render turn.\nWalks backward through messages from `index` until it finds either\nan assistant message with `tool_calls` referencing a GenUI tool\n(\u2192 this turn produces a surface) or a human message (\u2192 the\npreceding turn ended; this assistant message stands on its own).\n\nAlso checks the message itself for:\n  - `extra.tool_calls[].name` matching a GenUI tool (post-streaming\n    state of the tool-call AI message), OR\n  - `extra.content[].type === 'function_call' && .name` matching\n    (live during the OpenAI Responses-API streaming chunks before\n    `tool_calls` populates).\n\nThe walk-back approach is robust to LangGraph's in-place\nreplacement of the ToolMessage (which strips the `name` field),\nunlike a single prev-message check.",
+        "description": "True when this assistant message is part of a GenUI render turn.\nWalks backward through messages from `index` until it finds either\nan assistant message with `tool_calls` referencing a GenUI tool\n(→ this turn produces a surface) or a human message (→ the\npreceding turn ended; this assistant message stands on its own).\n\nAlso checks the message itself for:\n  - `extra.tool_calls[].name` matching a GenUI tool (post-streaming\n    state of the tool-call AI message), OR\n  - `extra.content[].type === 'function_call' && .name` matching\n    (live during the OpenAI Responses-API streaming chunks before\n    `tool_calls` populates).\n\nThe walk-back approach is robust to LangGraph's in-place\nreplacement of the ToolMessage (which strips the `name` field),\nunlike a single prev-message check.",
         "params": [
           {
             "name": "message",
@@ -1747,7 +1747,7 @@
       {
         "name": "isReasoningStreaming",
         "signature": "isReasoningStreaming(message: Message, index: number)",
-        "description": "True while a message's reasoning is mid-stream \u2014 i.e. it's the latest\nmessage, the agent is loading, the message has reasoning content, and\nno response text has arrived yet. Once the response text begins, the\nreasoning pill collapses (per its internal logic).",
+        "description": "True while a message's reasoning is mid-stream — i.e. it's the latest\nmessage, the agent is loading, the message has reasoning content, and\nno response text has arrived yet. Once the response text begins, the\nreasoning pill collapses (per its internal logic).",
         "params": [
           {
             "name": "message",
@@ -2414,7 +2414,7 @@
       {
         "name": "clicked",
         "type": "OutputEmitterRef<void>",
-        "description": "Fires when the inner <button> receives a click. Prefer this over\n binding `(click)` on the host element \u2014 explicit output gives\n consumers (and Playwright) an unambiguous click target that won't\n be intercepted by sibling overlays in higher stacking contexts.\n Native `(click)` on the host still works for back-compat: the\n click event bubbles through unchanged.",
+        "description": "Fires when the inner <button> receives a click. Prefer this over\n binding `(click)` on the host element — explicit output gives\n consumers (and Playwright) an unambiguous click target that won't\n be intercepted by sibling overlays in higher stacking contexts.\n Native `(click)` on the host still works for back-compat: the\n click event bubbles through unchanged.",
         "optional": false
       }
     ],
@@ -2717,7 +2717,7 @@
       {
         "name": "shortcut",
         "type": "InputSignal<string | null>",
-        "description": "Keyboard shortcut (single key) that toggles the popup with cmd (mac)\nor ctrl (other). Set to `null` to disable. Default: 'k' \u2014 matches the\nwidely-used cmd/ctrl+K convention.",
+        "description": "Keyboard shortcut (single key) that toggles the popup with cmd (mac)\nor ctrl (other). Set to `null` to disable. Default: 'k' — matches the\nwidely-used cmd/ctrl+K convention.",
         "optional": false
       },
       {
@@ -2978,7 +2978,7 @@
   {
     "name": "ChatReasoningComponent",
     "kind": "class",
-    "description": "Renders an assistant's reasoning content as a compact pill that\nexpands to reveal the underlying text. Three visual states:\n\n- Streaming: pill shows \"Thinking\u2026\" with a pulsing dot; auto-expanded\n  so the user sees reasoning stream in real time.\n- Idle, with durationMs known: pill shows \"Thought for {duration}\";\n  collapsed by default, expand on click.\n- Idle, no duration: pill shows \"Show reasoning\"; collapsed by default.\n\nThe body re-uses chat-streaming-md so reasoning content gets the same\nmarkdown rendering pipeline as the visible response (lists, code,\nstep labels often appear in reasoning output).\n\nInternal state: a tristate \"expanded\" \u2014 null means follow auto state-\ndriven logic (force-expand on isStreaming, otherwise honor\ndefaultExpanded), boolean is a manual user choice that wins for the\nlifetime of the instance.",
+    "description": "Renders an assistant's reasoning content as a compact pill that\nexpands to reveal the underlying text. Three visual states:\n\n- Streaming: pill shows \"Thinking…\" with a pulsing dot; auto-expanded\n  so the user sees reasoning stream in real time.\n- Idle, with durationMs known: pill shows \"Thought for {duration}\";\n  collapsed by default, expand on click.\n- Idle, no duration: pill shows \"Show reasoning\"; collapsed by default.\n\nThe body re-uses chat-streaming-md so reasoning content gets the same\nmarkdown rendering pipeline as the visible response (lists, code,\nstep labels often appear in reasoning output).\n\nInternal state: a tristate \"expanded\" — null means follow auto state-\ndriven logic (force-expand on isStreaming, otherwise honor\ndefaultExpanded), boolean is a manual user choice that wins for the\nlifetime of the instance.",
     "params": [],
     "examples": [],
     "properties": [
@@ -3077,7 +3077,7 @@
   {
     "name": "ChatSelectComponent",
     "kind": "class",
-    "description": "Generic single-select dropdown. Designed to slot into the chat input pill\n(via [chatInputModelSelect]) but usable anywhere.\n\nInputs:\n  options      \u2014 array of { value, label, disabled? }; required\n  value        \u2014 currently selected value (two-way via model())\n  placeholder  \u2014 trigger label when no option matches; default 'Select'\n  disabled     \u2014 disables the trigger; default false\n  menuLabel    \u2014 aria-label for the popover; defaults to placeholder",
+    "description": "Generic single-select dropdown. Designed to slot into the chat input pill\n(via [chatInputModelSelect]) but usable anywhere.\n\nInputs:\n  options      — array of { value, label, disabled? }; required\n  value        — currently selected value (two-way via model())\n  placeholder  — trigger label when no option matches; default 'Select'\n  disabled     — disables the trigger; default false\n  menuLabel    — aria-label for the popover; defaults to placeholder",
     "params": [],
     "examples": [],
     "properties": [
@@ -3436,7 +3436,7 @@
   {
     "name": "ChatStreamingMdComponent",
     "kind": "class",
-    "description": "Renders streaming markdown by walking a @cacheplane/partial-markdown AST\nthrough @ngaf/render's view registry.\n\nReactivity model: the live `parser.root` keeps a stable JS reference\nacross pushes (partial-markdown's identity guarantee). To make Angular\nsignals propagate downstream when the underlying tree changes, we surface\na materialized snapshot via `materialize()`. The snapshot shares\nstructurally \u2014 unchanged subtrees keep the SAME reference, and any\ndescendant change yields a NEW root reference. This lets Angular's\n`Object.is` equality check both detect changes (root reference differs)\nand short-circuit unchanged subtrees (per-node references stable).\n\nOverride per-node-type renderers via the `[viewRegistry]` input or by\nsupplying a different `MARKDOWN_VIEW_REGISTRY` provider in the injector\ntree.",
+    "description": "Renders streaming markdown by walking a @cacheplane/partial-markdown AST\nthrough @ngaf/render's view registry.\n\nReactivity model: the live `parser.root` keeps a stable JS reference\nacross pushes (partial-markdown's identity guarantee). To make Angular\nsignals propagate downstream when the underlying tree changes, we surface\na materialized snapshot via `materialize()`. The snapshot shares\nstructurally — unchanged subtrees keep the SAME reference, and any\ndescendant change yields a NEW root reference. This lets Angular's\n`Object.is` equality check both detect changes (root reference differs)\nand short-circuit unchanged subtrees (per-node references stable).\n\nOverride per-node-type renderers via the `[viewRegistry]` input or by\nsupplying a different `MARKDOWN_VIEW_REGISTRY` provider in the injector\ntree.",
     "params": [],
     "examples": [],
     "properties": [
@@ -3615,7 +3615,7 @@
       {
         "name": "menuAnchorPos",
         "type": "WritableSignal<object | null>",
-        "description": "Cursor-anchored position when the menu was opened via right-click.\n Mutually exclusive with `menuAnchor` \u2014 set one, null the other.",
+        "description": "Cursor-anchored position when the menu was opened via right-click.\n Mutually exclusive with `menuAnchor` — set one, null the other.",
         "optional": false
       },
       {
@@ -3855,7 +3855,7 @@
       {
         "name": "onRowContextMenu",
         "signature": "onRowContextMenu(threadId: string, event: MouseEvent)",
-        "description": "Right-click on a row opens the same overflow menu anchored at the\n cursor. Always prevents the native context menu \u2014 including when the\n adapter exposes no row actions (in which case we open nothing rather\n than confusing the user with the OS menu on what looks like a custom\n list).",
+        "description": "Right-click on a row opens the same overflow menu anchored at the\n cursor. Always prevents the native context menu — including when the\n adapter exposes no row actions (in which case we open nothing rather\n than confusing the user with the OS menu on what looks like a custom\n list).",
         "params": [
           {
             "name": "threadId",
@@ -4256,7 +4256,7 @@
       {
         "name": "excludeToolNames",
         "type": "InputSignal<readonly string[]>",
-        "description": "Tool names whose groups should be hidden. Used by chat compositions\nto filter out internal/orchestration tools (e.g. GenUI dispatchers)\nwhose args streaming is not meaningful to surface in the chat.\nDefault empty \u2014 preserves prior behavior for non-filtering consumers.",
+        "description": "Tool names whose groups should be hidden. Used by chat compositions\nto filter out internal/orchestration tools (e.g. GenUI dispatchers)\nwhose args streaming is not meaningful to surface in the chat.\nDefault empty — preserves prior behavior for non-filtering consumers.",
         "optional": false
       },
       {
@@ -4438,7 +4438,7 @@
   {
     "name": "ChatWelcomeComponent",
     "kind": "class",
-    "description": "Empty-state owner. Renders a centered greeting + slot-projected input +\noptional vertical suggestion rows. Mounted only when the parent chat has\nno messages and welcome is not disabled.\n\nSlots:\n  [chatWelcomeTitle]       \u2014 replaces the default <h1> \"How can I help?\"\n  [chatWelcomeInput]       \u2014 projects the chat input into the center column\n  [chatWelcomeSuggestions] \u2014 projects suggestion rows below the input\n\nHost CSS variables (override on :host or any ancestor):\n  --ngaf-chat-welcome-max-width  default 36rem\n  --ngaf-chat-welcome-gap        default 1.25rem\n  --ngaf-chat-welcome-padding    default 24px",
+    "description": "Empty-state owner. Renders a centered greeting + slot-projected input +\noptional vertical suggestion rows. Mounted only when the parent chat has\nno messages and welcome is not disabled.\n\nSlots:\n  [chatWelcomeTitle]       — replaces the default <h1> \"How can I help?\"\n  [chatWelcomeInput]       — projects the chat input into the center column\n  [chatWelcomeSuggestions] — projects suggestion rows below the input\n\nHost CSS variables (override on :host or any ancestor):\n  --ngaf-chat-welcome-max-width  default 36rem\n  --ngaf-chat-welcome-gap        default 1.25rem\n  --ngaf-chat-welcome-padding    default 24px",
     "params": [],
     "examples": [],
     "properties": [],
@@ -4972,7 +4972,7 @@
   {
     "name": "A2uiComponentView",
     "kind": "interface",
-    "description": "Chat-internal projection of an A2UI component, materialized by the\nsurface store. Distinct from the wire-format `A2uiComponent` in\n`@ngaf/a2ui` (which carries the raw `component: A2uiComponentDef`\npayload) \u2014 this type adds the per-component readiness fields the\nprogressive renderer consumes.",
+    "description": "Chat-internal projection of an A2UI component, materialized by the\nsurface store. Distinct from the wire-format `A2uiComponent` in\n`@ngaf/a2ui` (which carries the raw `component: A2uiComponentDef`\npayload) — this type adds the per-component readiness fields the\nprogressive renderer consumes.",
     "properties": [
       {
         "name": "bindings",
@@ -5007,7 +5007,7 @@
       {
         "name": "type",
         "type": "string",
-        "description": "The component type key \u2014 e.g. `'Button'`, `'TextField'` \u2014 matched\nagainst catalog `views` entries.",
+        "description": "The component type key — e.g. `'Button'`, `'TextField'` — matched\nagainst catalog `views` entries.",
         "optional": false
       }
     ],
@@ -5016,7 +5016,7 @@
   {
     "name": "A2uiSurfaceState",
     "kind": "interface",
-    "description": "Chat-side state for a surface \u2014 wraps the wire-format `A2uiSurface`\nwith the per-component projection the progressive renderer consumes.\nBoth maps are kept in sync; the wire shape preserves existing\n`surfaceToSpec` semantics, the view shape carries readiness.",
+    "description": "Chat-side state for a surface — wraps the wire-format `A2uiSurface`\nwith the per-component projection the progressive renderer consumes.\nBoth maps are kept in sync; the wire shape preserves existing\n`surfaceToSpec` semantics, the view shape carries readiness.",
     "properties": [
       {
         "name": "componentViews",
@@ -5166,7 +5166,7 @@
   {
     "name": "AgentCheckpoint",
     "kind": "interface",
-    "description": "Runtime-neutral snapshot of a point in an agent's execution history.\n\nConsumed by time-travel / debug UIs. `id` is adapter-opaque \u2014 UIs emit\nit back to the parent app on replay/fork, and the parent app dispatches\nto the underlying runtime.",
+    "description": "Runtime-neutral snapshot of a point in an agent's execution history.\n\nConsumed by time-travel / debug UIs. `id` is adapter-opaque — UIs emit\nit back to the parent app on replay/fork, and the parent app dispatches\nto the underlying runtime.",
     "properties": [
       {
         "name": "id",
@@ -5409,7 +5409,7 @@
       {
         "name": "messageCheckpoints",
         "type": "Signal<ReadonlyMap<string, string>>",
-        "description": "Optional reactive map of `messageId \u2192 checkpointId`, computed by\nwalking history once: for each checkpoint, find the most recent\nassistant message present in its `values.messages` and pair them.\nUIs use this to anchor inline checkpoint markers on each assistant\nturn. Missing on adapters that don't compute it.",
+        "description": "Optional reactive map of `messageId → checkpointId`, computed by\nwalking history once: for each checkpoint, find the most recent\nassistant message present in its `values.messages` and pair them.\nUIs use this to anchor inline checkpoint markers on each assistant\nturn. Missing on adapters that don't compute it.",
         "optional": true
       },
       {
@@ -5521,7 +5521,7 @@
       {
         "name": "firstMessageSent",
         "type": "Signal<boolean>",
-        "description": "True after the first user submit. Sticky for the life of the chat instance \u2014 does NOT reset on clearThread.",
+        "description": "True after the first user submit. Sticky for the life of the chat instance — does NOT reset on clearThread.",
         "optional": false
       },
       {
@@ -5793,7 +5793,7 @@
       {
         "name": "reasoning",
         "type": "string",
-        "description": "Reasoning text emitted by the model before/alongside the visible\nresponse. Populated by adapters from {type:'reasoning'} or\n{type:'thinking'} content blocks (LangGraph) or REASONING_MESSAGE_*\nevents (AG-UI). Always a plain string \u2014 provider-specific shape\n(encrypted blocks, multi-step summaries) is absorbed by the adapter\nand not surfaced here.",
+        "description": "Reasoning text emitted by the model before/alongside the visible\nresponse. Populated by adapters from {type:'reasoning'} or\n{type:'thinking'} content blocks (LangGraph) or REASONING_MESSAGE_*\nevents (AG-UI). Always a plain string — provider-specific shape\n(encrypted blocks, multi-step summaries) is absorbed by the adapter\nand not surfaced here.",
         "optional": true
       },
       {
@@ -5817,7 +5817,7 @@
       {
         "name": "toolCallIds",
         "type": "string[]",
-        "description": "IDs of tool calls emitted BY this assistant message. Populated by\nadapters from provider-native fields (LangGraph: `tool_calls[].id`;\nAnthropic: `tool_use` content blocks). Used by `<chat-tool-calls>` to\nscope its rendering to a single message \u2014 otherwise it falls back to\nthe agent's global toolCalls list, which renders duplicates across\nevery AI message in a thread.",
+        "description": "IDs of tool calls emitted BY this assistant message. Populated by\nadapters from provider-native fields (LangGraph: `tool_calls[].id`;\nAnthropic: `tool_use` content blocks). Used by `<chat-tool-calls>` to\nscope its rendering to a single message — otherwise it falls back to\nthe agent's global toolCalls list, which renders duplicates across\nevery AI message in a thread.",
         "optional": true
       }
     ],
@@ -6166,7 +6166,7 @@
   {
     "name": "ThreadActionAdapter",
     "kind": "interface",
-    "description": "Per-thread row-action adapter. Consumer-provided. The framework calls\nthese methods after user confirmation (delete) or commit (rename) and\nmanages optimistic UI + rollback on rejection.\n\nConsumers MUST refresh their `threads` signal on success \u2014 the framework\nclears optimistic overrides in a `finally` block, so a successful adapter\ncall that leaves the input list unchanged would re-render the row.",
+    "description": "Per-thread row-action adapter. Consumer-provided. The framework calls\nthese methods after user confirmation (delete) or commit (rename) and\nmanages optimistic UI + rollback on rejection.\n\nConsumers MUST refresh their `threads` signal on success — the framework\nclears optimistic overrides in a `finally` block, so a successful adapter\ncall that leaves the input list unchanged would re-render the row.",
     "properties": [
       {
         "name": "archive",
@@ -6321,7 +6321,7 @@
       {
         "name": "status",
         "type": "ToolCallStatus",
-        "description": "Optional \u2014 present when the parent provides it. Drives the pill + default-collapsed logic.",
+        "description": "Optional — present when the parent provides it. Drives the pill + default-collapsed logic.",
         "optional": true
       }
     ],
@@ -6344,7 +6344,7 @@
   {
     "name": "A2uiViews",
     "kind": "type",
-    "description": "Catalog shape accepted by `<a2ui-surface>`. Each entry is either a\nbare `Type<unknown>` (legacy shape \u2014 no per-component fallback) or\nan `A2uiViewEntry`.",
+    "description": "Catalog shape accepted by `<a2ui-surface>`. Each entry is either a\nbare `Type<unknown>` (legacy shape — no per-component fallback) or\nan `A2uiViewEntry`.",
     "signature": "Readonly<Record<string, Type<unknown> | A2uiViewEntry>>",
     "examples": []
   },
@@ -6557,7 +6557,7 @@
   {
     "name": "createPartialArgsBridge",
     "kind": "function",
-    "description": "Subscribes to LangGraph custom events of name 'a2ui-partial' and feeds\nthe surface store envelope-by-envelope as the parent LLM streams its\ntool_call.arguments JSON. Uses @cacheplane/partial-json to extract\nstructurally-complete envelope objects from the growing args string.\n\nSynthesis safety net: if the first complete surfaceUpdate arrives and\nno beginRendering has been extracted yet, the bridge synthesises one\ntargeted at the surfaceUpdate's first component (preferring id='root'\nif present). This makes the surface mount IMMEDIATELY after the first\nsurfaceUpdate parses \u2014 without waiting for the LLM to emit beginRendering\nat the end of its envelope list \u2014 so the render-element fallback gate\n(PR #252) actually fires while dataModelUpdates flow in.\n\nThe store's apply() already treats repeated beginRendering for the same\nsurfaceId as idempotent (just re-applies styles), so the LLM's eventual\nbeginRendering (if any) is a no-op rather than a conflict.",
+    "description": "Subscribes to LangGraph custom events of name 'a2ui-partial' and feeds\nthe surface store envelope-by-envelope as the parent LLM streams its\ntool_call.arguments JSON. Uses @cacheplane/partial-json to extract\nstructurally-complete envelope objects from the growing args string.\n\nSynthesis safety net: if the first complete surfaceUpdate arrives and\nno beginRendering has been extracted yet, the bridge synthesises one\ntargeted at the surfaceUpdate's first component (preferring id='root'\nif present). This makes the surface mount IMMEDIATELY after the first\nsurfaceUpdate parses — without waiting for the LLM to emit beginRendering\nat the end of its envelope list — so the render-element fallback gate\n(PR #252) actually fires while dataModelUpdates flow in.\n\nThe store's apply() already treats repeated beginRendering for the same\nsurfaceId as idempotent (just re-applies styles), so the LLM's eventual\nbeginRendering (if any) is a no-op rather than a conflict.",
     "signature": "createPartialArgsBridge(store: A2uiSurfaceStore): PartialArgsBridge",
     "params": [
       {
@@ -6632,7 +6632,7 @@
   {
     "name": "formatDuration",
     "kind": "function",
-    "description": "Render a millisecond duration as a human-readable label suitable for\nthe chat-reasoning \"Thought for Ns\" pill.\n\n- <1 s         \u2192 \"<1s\"\n- 1\u201359 s       \u2192 \"Ns\"     (e.g. \"4s\")\n- \u226560 s        \u2192 \"Nm Ms\"  (e.g. \"1m 12s\", \"60m 0s\")\n\nNegative or non-finite inputs collapse to \"<1s\" so a corrupted timing\nmap never produces noisy output.",
+    "description": "Render a millisecond duration as a human-readable label suitable for\nthe chat-reasoning \"Thought for Ns\" pill.\n\n- <1 s         → \"<1s\"\n- 1–59 s       → \"Ns\"     (e.g. \"4s\")\n- ≥60 s        → \"Nm Ms\"  (e.g. \"1m 12s\", \"60m 0s\")\n\nNegative or non-finite inputs collapse to \"<1s\" so a corrupted timing\nmap never produces noisy output.",
     "signature": "formatDuration(ms: number): string",
     "params": [
       {
@@ -7005,7 +7005,7 @@
   {
     "name": "views",
     "kind": "function",
-    "description": "Creates a view registry from a name \u2192 component map.",
+    "description": "Creates a view registry from a name → component map.",
     "signature": "views(map: Record<string, Type<unknown> | RenderViewEntry>): ViewRegistry",
     "params": [
       {
@@ -7094,7 +7094,7 @@
   {
     "name": "assertReasoningFixtureMessages",
     "kind": "function",
-    "description": "Assertion \u2014 common to both adapters. Throws if the produced messages\ndon't match the shared expectation.",
+    "description": "Assertion — common to both adapters. Throws if the produced messages\ndon't match the shared expectation.",
     "signature": "assertReasoningFixtureMessages(messages: readonly Message[]): void",
     "params": [
       {