@artooi/ag-ui-web-component 0.22.0 → 0.23.1

package/dist/skills/fill_template.d.ts

@@ -6,12 +6,11 @@ export interface TemplateResult {
     readonly missing: readonly string[];
 }
 /**
- * Substitute `{name}` placeholders in ``template`` from ``values``.
+ * Substitute `{name}` placeholders in `template` from `values`.
  *
- * A placeholder whose value is missing, ``null``, or an empty string is left
- * verbatim and reported in ``missing`` — the caller blocks send and tells the
- * user what's needed (e.g. "select rows first") rather than sending a
- * half-filled prompt.
+ * A placeholder whose value is missing, `null`, or an empty string is left
+ * verbatim and reported in `missing`, so the caller can block the send rather
+ * than dispatch a half-filled prompt.
  */
 export declare function fillTemplate(template: string, values: Record<string, unknown>): TemplateResult;
 //# sourceMappingURL=fill_template.d.ts.map

package/dist/skills/fill_template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fill_template.d.ts","sourceRoot":"","sources":["../../src/skills/fill_template.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAID;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAa9F"}
+{"version":3,"file":"fill_template.d.ts","sourceRoot":"","sources":["../../src/skills/fill_template.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAID;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAa9F"}

package/dist/skills/parse_skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse_skills.d.ts","sourceRoot":"","sources":["../../src/skills/parse_skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAqBxC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,EAAE,CAKnD"}
+{"version":3,"file":"parse_skills.d.ts","sourceRoot":"","sources":["../../src/skills/parse_skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAoBxC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,EAAE,CAKnD"}

package/dist/skills/skill.d.ts

@@ -15,17 +15,16 @@ export interface Skill {
      * The prompt to send. May contain `{placeholder}`s filled from the host's
      * skill context before send; an unfilled placeholder blocks send.
      *
-     * **Omit it to keep the prompt on the server.** The skill then sends the bare
-     * `/name` token and the agent resolves what it means, so the wording never
-     * reaches the browser — worth preferring for anything internal, since a
-     * fetched catalog is a plain GET and an embedded one sits in the page source.
+     * Omit it to keep the prompt server-side: the skill then sends the bare
+     * `/name` token for the agent to resolve, and the wording never reaches the
+     * browser. Prefer that for anything internal — a fetched catalog is a plain
+     * GET and an embedded one sits in the page source.
      */
     readonly prompt?: string;
     /**
-     * Set `false` to pre-fill the composer instead of sending on pick. Only
-     * meaningful for a skill that carries its own `prompt`; a server-resolved one
-     * always sends. Defaults to sending — a chip that needs a second click to do
-     * anything is a two-step shortcut.
+     * Set `false` to pre-fill the composer instead of sending on pick. Defaults
+     * to sending, and is only meaningful for a skill carrying its own `prompt`;
+     * a server-resolved one always sends.
      */
     readonly sendImmediately?: boolean;
     /** Also surface this skill as a chip (default false; the palette shows all). */

package/dist/skills/skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/skills/skill.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,gFAAgF;IAChF,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB"}
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/skills/skill.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,gFAAgF;IAChF,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/tools/client_tool_registry.d.ts

@@ -24,8 +24,8 @@ export declare class ClientToolRegistry {
     /**
      * Register a tool, replacing any existing one with the same name.
      *
-     * Idempotent on the name so re-fired host refs / React StrictMode's
-     * double-invoke don't throw — re-registering is a replace, not an error.
+     * Idempotent on the name so a re-fired host ref or React StrictMode's
+     * double-invoke replaces rather than throws.
      */
     register(tool: ClientTool): void;
     has(name: string): boolean;

package/dist/tools/page_action_tools.d.ts

@@ -1,10 +1,8 @@
 import type { ClientTool } from "./client_tool_registry.js";
 /**
  * Resolve a page-action target string to a host-page element, or `null` when it
- * matches nothing. The default (`document.querySelector`) treats the string as a
- * CSS selector; a host with a page map overrides it to map its own element ids,
- * the same way host packages wrap the DOM-driver primitives with environment-
- * aware lookups.
+ * matches nothing. The default treats the string as a CSS selector; a host with
+ * a page map overrides it to map its own element ids.
  */
 export type ResolvePageTarget = (target: string) => HTMLElement | null;
 /** The built-in page-action tool tokens, opted in via `data-page-actions`. */
@@ -19,13 +17,12 @@ export declare const PAGE_ACTIONS: {
  * - `scroll_to` — scroll a target (`top` / `bottom` / a resolver target) into
  *   view. Benign; no confirmation.
  * - `drag_and_drop` — drag one element onto another, firing the standard HTML5
- *   drag sequence so the host page's own drop handler reacts. Not stamped
- *   destructive: a drag rearranges transient state and the durable change
- *   happens at the page's explicit commit. A host whose page persists *on drop*
- *   gates it with the element's `confirmPredicate`.
+ *   drag sequence so the host page's own drop handler reacts. Deliberately not
+ *   stamped destructive: a drag rearranges transient state, and the durable
+ *   change happens at the page's explicit commit. A host whose page persists on
+ *   drop must gate it with the element's `confirmPredicate`.
  *
- * Both report a clean, model-readable error when a target resolves to nothing,
- * rather than throwing an opaque crash.
+ * Both report a model-readable error when a target resolves to nothing.
  */
 export declare function createPageActionTools(enabled: ReadonlySet<string>, resolveTarget: ResolvePageTarget): ClientTool[];
 //# sourceMappingURL=page_action_tools.d.ts.map

package/dist/tools/page_action_tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page_action_tools.d.ts","sourceRoot":"","sources":["../../src/tools/page_action_tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;AAEvE,8EAA8E;AAC9E,eAAO,MAAM,YAAY;aACvB,MAAM,EAAE,QAAQ;aAChB,IAAI,EAAE,MAAM;CACJ,CAAC;AAEX;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAC5B,aAAa,EAAE,iBAAiB,GAC/B,UAAU,EAAE,CASd"}
+{"version":3,"file":"page_action_tools.d.ts","sourceRoot":"","sources":["../../src/tools/page_action_tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;AAEvE,8EAA8E;AAC9E,eAAO,MAAM,YAAY;aACvB,MAAM,EAAE,QAAQ;aAChB,IAAI,EAAE,MAAM;CACJ,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAC5B,aAAa,EAAE,iBAAiB,GAC/B,UAAU,EAAE,CASd"}

package/dist/tools/page_state.d.ts

@@ -5,11 +5,9 @@ import type { ClientTool } from "./client_tool_registry.js";
  * Ergonomic sugar over `registerTool` for SPA state (Redux/Zustand/signals):
  * generates a read tool and, when `write` is given, a destructive set tool.
  *
- * This is **not** AG-UI shared state. `STATE_SNAPSHOT` / `STATE_DELTA` are
- * protocol events carrying state between agent and client; this is a pair of
- * ordinary client tools the agent calls like any other. The two are unrelated,
- * which is why this no longer carries the word "hook" — the old name read as
- * protocol state sync, which this component does not implement.
+ * Not AG-UI shared state. `STATE_SNAPSHOT` / `STATE_DELTA` are protocol events
+ * carrying state between agent and client; these are ordinary client tools the
+ * agent calls like any other.
  */
 export interface PageState {
     /** Base name; tools become `read_<name>` and `set_<name>`. */
@@ -27,9 +25,8 @@ export interface PageState {
  */
 export declare function createPageStateTools(binding: PageState): ClientTool[];
 /**
- * @deprecated Renamed to {@link PageState}. The old name read as AG-UI
- * shared-state sync (`STATE_SNAPSHOT` / `STATE_DELTA`), which this component
- * does not implement. Will be removed in a future major.
+ * @deprecated Renamed to {@link PageState} — the old name read as AG-UI
+ * shared-state sync. Will be removed in a future major.
  */
 export type StateHook = PageState;
 /**

package/dist/tools/page_state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page_state.d.ts","sourceRoot":"","sources":["../../src/tools/page_state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,SAAS;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IAC5D,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,GAAG,UAAU,EAAE,CA4BrE;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,oBAAoB,6BAAuB,CAAC"}
+{"version":3,"file":"page_state.d.ts","sourceRoot":"","sources":["../../src/tools/page_state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IAC5D,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,GAAG,UAAU,EAAE,CA4BrE;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,oBAAoB,6BAAuB,CAAC"}

package/dist/tools/route_map.d.ts

@@ -5,9 +5,8 @@ export interface Route {
     readonly id: string;
     /**
      * The URL path to navigate to. May contain `:name` placeholders for dynamic
-     * segments (e.g. `/admin/shop/book/:pk/change/`); the agent fills them via
-     * the `navigate_to_route` `params` argument. Real apps are mostly
-     * parameterised — few pages have a truly static path.
+     * segments (e.g. `/admin/shop/book/:pk/change/`), which the agent fills via
+     * `navigate_to_route`'s `params` argument.
      */
     readonly path: string;
     /** Human label shown to the agent. */
@@ -28,13 +27,11 @@ export interface RouteWithParams extends Route {
  * The built-in `route.*` tools, bound to live getters so a host can set
  * `routeMap` / `navigate` before or after mount.
  *
- * `list_routes` is read-only and advertises each route's dynamic
- * `pathParams` so the model knows what to supply. `navigate_to_route` is marked
- * `x-navigates` so an MPA reload checkpoints + resumes; it substitutes path
- * params into the template and appends any remaining params as a query string.
- * When the host supplies a `navigate(path)` callback (an SPA), the element
- * routes client-side instead and the run loop simply continues — see
- * `AgUiChat`'s execute path.
+ * `list_routes` is read-only and advertises each route's `pathParams` so the
+ * model knows what to supply. `navigate_to_route` fills those params, appends
+ * the rest as a query string, and is stamped `x-navigates` so an MPA reload
+ * checkpoints and resumes; with a host `navigate(path)` callback (an SPA) it
+ * routes client-side and the run loop continues instead.
  */
 export declare function createRouteTools(getRouteMap: () => RouteMap, getNavigate: () => ((path: string) => void) | null): ClientTool[];
 //# sourceMappingURL=route_map.d.ts.map

package/dist/tools/route_map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route_map.d.ts","sourceRoot":"","sources":["../../src/tools/route_map.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,gEAAgE;AAChE,MAAM,WAAW,KAAK;IACpB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qDAAqD;AACrD,MAAM,MAAM,QAAQ,GAAG,SAAS,KAAK,EAAE,CAAC;AAExC,yEAAyE;AACzE,MAAM,WAAW,eAAgB,SAAQ,KAAK;IAC5C,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAgDD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,QAAQ,EAC3B,WAAW,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,GACjD,UAAU,EAAE,CA6Cd"}
+{"version":3,"file":"route_map.d.ts","sourceRoot":"","sources":["../../src/tools/route_map.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,gEAAgE;AAChE,MAAM,WAAW,KAAK;IACpB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qDAAqD;AACrD,MAAM,MAAM,QAAQ,GAAG,SAAS,KAAK,EAAE,CAAC;AAExC,yEAAyE;AACzE,MAAM,WAAW,eAAgB,SAAQ,KAAK;IAC5C,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AA+CD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,QAAQ,EAC3B,WAAW,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,GACjD,UAAU,EAAE,CA6Cd"}

package/dist/ui/approval_card.d.ts

@@ -13,9 +13,8 @@ export interface ApprovalRequest {
 /** Options for {@link requestApproval}. */
 export interface ApprovalOptions {
     /**
-     * Aborting this signal resolves the card as **denied** (buttons disabled,
-     * `data-resolved="denied"`) — the hook a Stop control uses to dismiss a
-     * pending approval when the user cancels the whole run.
+     * Aborting this signal resolves the card as denied, with buttons disabled and
+     * `data-resolved="denied"` — how a Stop control dismisses a pending approval.
      */
     signal?: AbortSignal;
     /** Localized strings; defaults to the English {@link DEFAULT_UI_STRINGS}. */
@@ -23,29 +22,25 @@ export interface ApprovalOptions {
 }
 /**
  * A fully custom renderer for a server-side-tool approval, set via
- * `AgUiChat.approvalRenderer`. Receives the {@link ApprovalRequest} (the
- * interrupt's message + tool name) and an `AbortSignal` that fires when the run
- * is stopped, and resolves `true` to approve or `false` to deny. When provided
- * it **replaces** the built-in {@link requestApproval} card entirely — the host
- * owns the DOM, so it can render a native modal, a framework component, or
- * anything else. See the `strings` / `::part()` seams for styling the built-in
- * card instead of replacing it.
+ * `AgUiChat.approvalRenderer`. Receives the {@link ApprovalRequest} and an
+ * `AbortSignal` that fires when the run is stopped, and resolves `true` to
+ * approve or `false` to deny. Replaces the built-in {@link requestApproval}
+ * card entirely, the host owning the DOM; to restyle the built-in card instead,
+ * use the `strings` and `::part()` seams.
  */
 export type ApprovalRenderer = (request: ApprovalRequest, options: {
     signal: AbortSignal;
 }) => Promise<boolean>;
 /**
- * Append an inline **approval** card to ``host`` and resolve when the user
- * decides whether a gated *server-side* tool may run.
+ * Append an inline approval card to `host` and resolve `true` to run a gated
+ * server-side tool or `false` to deny it.
  *
- * The server-side approval gate is distinct from the client-tool confirmation
- * card ({@link requestConfirmation}): a destructive server tool defers instead
- * of executing, and the run finishes on an AG-UI *interrupt* the client answers
- * with `resume[]`. This card is the browser half of that loop — it reads
- * naturally after the tool-call card whose execution it gates, and resolves
- * ``true`` to approve (run the tool) or ``false`` to deny. The card stays in the
- * transcript as a resolved record (buttons disabled, `data-resolved` set)
- * rather than vanishing.
+ * Distinct from the client-tool confirmation card
+ * ({@link requestConfirmation}): a gated server tool defers instead of
+ * executing, so the run finishes on an AG-UI interrupt the client answers with
+ * `resume[]`, and this is the browser half of that loop. Unlike the
+ * confirmation card, this one stays in the transcript as a resolved record,
+ * buttons disabled and `data-resolved` set.
  */
 export declare function requestApproval(host: Node & ParentNode, request: ApprovalRequest, options?: ApprovalOptions): Promise<boolean>;
 //# sourceMappingURL=approval_card.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"approval_card.d.ts","sourceRoot":"","sources":["../../src/ui/approval_card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErE,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAYD,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,KAC7B,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,GAAG,UAAU,EACvB,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAkDlB"}
+{"version":3,"file":"approval_card.d.ts","sourceRoot":"","sources":["../../src/ui/approval_card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErE,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAYD,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,KAC7B,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,GAAG,UAAU,EACvB,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAkDlB"}

package/dist/ui/attach_copy_buttons.d.ts

@@ -2,17 +2,11 @@ import type { UiStrings } from "./ui_strings.js";
 /**
  * Give every fenced code block in `root` a copy button.
  *
- * An agent that answers with code is answering with something the reader means
- * to *use*, and selecting it by hand out of a scrolling transcript — inside a
- * shadow root, in a narrow sidebar — is the one interaction the chat surface
- * made harder than the page around it.
+ * Call only on finished bubbles: the streaming bubble reassigns its `innerHTML`
+ * on every delta, so a button attached mid-stream is discarded and rebuilt for
+ * each one.
  *
- * Applied to **finished** bubbles only. The streaming bubble reassigns its
- * `innerHTML` on every delta, so a button attached mid-stream would be
- * discarded and rebuilt for each one; waiting until the turn ends costs
- * nothing and does that work once.
- *
- * Idempotent: a bubble already processed is skipped, so a re-render or a second
+ * Idempotent — a bubble already processed is skipped, so a re-render or a second
  * call cannot stack buttons.
  */
 export declare function attachCopyButtons(root: ParentNode, strings: UiStrings): void;

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

@@ -1 +1 @@
-{"version":3,"file":"attach_copy_buttons.d.ts","sourceRoot":"","sources":["../../src/ui/attach_copy_buttons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKjD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAS5E"}
+{"version":3,"file":"attach_copy_buttons.d.ts","sourceRoot":"","sources":["../../src/ui/attach_copy_buttons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKjD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAS5E"}

package/dist/ui/attachment_chips.d.ts

@@ -1,12 +1,20 @@
 import type { AttachmentRef } from "../core/attachment.js";
 /**
- * Render the read-only attachment chips shown on a sent user message bubble
- * (and on restored history) — one chip per ref with a type icon, the filename,
- * and a human size. Static by design: no progress, no remove (that lives in the
- * composer tray); a restored bubble re-renders these with no animation.
+ * Render the read-only attachment chips on a sent user message bubble and on
+ * restored history — one chip per ref with a type icon, filename, and human
+ * size. Static: no progress and no remove, both of which live in the composer
+ * tray.
  */
 export declare function renderAttachmentChips(refs: readonly AttachmentRef[]): HTMLDivElement;
-/** A coarse type icon for a chip — image, document, or generic file. */
+/**
+ * A coarse type mark for a chip — image, PDF, text document, or generic file —
+ * as inline SVG markup rather than a character, so it matches the composer's
+ * SVG buttons in weight and takes the glyph size and `currentColor`, which
+ * emoji do not.
+ *
+ * The MIME string only selects among author-written constants and is never
+ * interpolated into one, so the result is safe to assign as markup.
+ */
 export declare function iconFor(mime: string): string;
 /** A compact human-readable byte size (e.g. `1.2 MB`). */
 export declare function formatBytes(bytes: number): string;

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

@@ -1 +1 @@
-{"version":3,"file":"attachment_chips.d.ts","sourceRoot":"","sources":["../../src/ui/attachment_chips.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,GAAG,cAAc,CAQpF;AA4BD,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW5C;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAajD"}
+{"version":3,"file":"attachment_chips.d.ts","sourceRoot":"","sources":["../../src/ui/attachment_chips.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,GAAG,cAAc,CAQpF;AA4BD;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW5C;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAajD"}

package/dist/ui/attachment_tray.d.ts

@@ -16,13 +16,13 @@ export interface AttachmentTrayConfig {
 }
 /**
  * The composer's pending-attachments tray: a chip per picked file with a
- * progress bar while it uploads, settling to a ready chip (holding the durable
- * ref) or an error chip (with retry). A *stateful view* in the spirit of
- * {@link ThreadDrawer} — the host appends {@link element}, calls {@link add} on
- * pick/drop, reads {@link readyRefs} when the user sends, and clears it.
+ * progress bar while it uploads, settling to a ready chip holding the durable
+ * ref or an error chip with retry. A stateful view like {@link ThreadDrawer}:
+ * the host appends {@link element}, calls {@link add} on pick or drop, reads
+ * {@link readyRefs} on send, and clears it.
  *
- * Client-side size/type guards reject a bad file into an error chip without
- * uploading — instant feedback, but the server is the authority.
+ * Client-side size and type guards reject a bad file into an error chip without
+ * uploading, for instant feedback, but the server stays the authority.
  */
 export declare class AttachmentTray {
     #private;

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

@@ -1 +1 @@
-{"version":3,"file":"attachment_tray.d.ts","sourceRoot":"","sources":["../../src/ui/attachment_tray.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKrE,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;CAC9B;AAcD;;;;;;;;;GASG;AACH,qBAAa,cAAc;;IACzB,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAMjC,YAAY,MAAM,EAAE,oBAAoB,EAOvC;IAED,gFAAgF;IAChF,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAsBpB;IAED,8DAA8D;IAC9D,SAAS,IAAI,SAAS,aAAa,EAAE,CAQpC;IAED,gFAAgF;IAChF,UAAU,IAAI,OAAO,CAEpB;IAED,+EAA+E;IAC/E,YAAY,IAAI,MAAM,CAErB;IAED,uCAAuC;IACvC,OAAO,IAAI,OAAO,CAEjB;IAED,2EAA2E;IAC3E,UAAU,IAAI,IAAI,CAGjB;IAED,2EAA2E;IAC3E,KAAK,IAAI,IAAI,CAMZ;IAED;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAId;CAoIF"}
+{"version":3,"file":"attachment_tray.d.ts","sourceRoot":"","sources":["../../src/ui/attachment_tray.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKrE,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;CAC9B;AAcD;;;;;;;;;GASG;AACH,qBAAa,cAAc;;IACzB,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAMjC,YAAY,MAAM,EAAE,oBAAoB,EAOvC;IAED,gFAAgF;IAChF,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAsBpB;IAED,8DAA8D;IAC9D,SAAS,IAAI,SAAS,aAAa,EAAE,CAQpC;IAED,gFAAgF;IAChF,UAAU,IAAI,OAAO,CAEpB;IAED,+EAA+E;IAC/E,YAAY,IAAI,MAAM,CAErB;IAED,uCAAuC;IACvC,OAAO,IAAI,OAAO,CAEjB;IAED,2EAA2E;IAC3E,UAAU,IAAI,IAAI,CAGjB;IAED,2EAA2E;IAC3E,KAAK,IAAI,IAAI,CAMZ;IAED;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAId;CAqIF"}

package/dist/ui/checkpoint_menu.d.ts

@@ -5,16 +5,15 @@ export type CheckpointVerb = "resume" | "fork";
 /**
  * The checkpoint panel: continuable runs, each offering **resume** or **fork**.
  *
- * A separate surface from the thread drawer on purpose — they are different
- * axes. A thread is a conversation you switch *to*; a checkpoint is a run you
- * continue *from*, and one thread can hold many. Folding them into one list
- * would make "resume" look like "open", which it isn't: resuming starts a new
+ * Deliberately separate from the thread drawer: a thread is a conversation you
+ * switch to, a checkpoint is a run you continue from, and one thread holds
+ * many. One list would make "resume" read as "open", when resuming starts a new
  * run seeded from a snapshot.
  *
- * Only rows the server marked `continuable` are worth offering, so the host
- * feeds those; a run with no snapshot would resume from nothing. Pure DOM in
- * the spirit of {@link SkillsMenu} — the host appends {@link element}, toggles
- * it, feeds rows via {@link setRuns}, and acts on {@link onPick}.
+ * The host feeds only rows the server marked `continuable`, a run without a
+ * snapshot having nothing to resume from. Pure DOM, like {@link SkillsMenu}:
+ * append {@link element}, toggle it, feed {@link setRuns}, act on
+ * {@link onPick}.
  */
 export declare class CheckpointMenu {
     #private;

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

@@ -1 +1 @@
-{"version":3,"file":"checkpoint_menu.d.ts","sourceRoot":"","sources":["../../src/ui/checkpoint_menu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErE,2CAA2C;AAC3C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAc;;IACzB,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAUjC,YACE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,KAAK,IAAI,EACrD,OAAO,GAAE,SAA8B,EA+BxC;IAED,iEAAiE;IACjE,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAGrC;IAED,oEAAoE;IACpE,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAKnC;IAED,IAAI,IAAI,IAAI,CAYX;IAED,KAAK,IAAI,IAAI,CAOZ;IAqCD,IAAI,KAAK,IAAI,OAAO,CAEnB;CA+DF"}
+{"version":3,"file":"checkpoint_menu.d.ts","sourceRoot":"","sources":["../../src/ui/checkpoint_menu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErE,2CAA2C;AAC3C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAc;;IACzB,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAUjC,YACE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,KAAK,IAAI,EACrD,OAAO,GAAE,SAA8B,EA+BxC;IAED,iEAAiE;IACjE,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAGrC;IAED,oEAAoE;IACpE,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAKnC;IAED,IAAI,IAAI,IAAI,CAYX;IAED,KAAK,IAAI,IAAI,CAOZ;IAqCD,IAAI,KAAK,IAAI,OAAO,CAEnB;CA+DF"}

package/dist/ui/confirmation_card.d.ts

@@ -12,29 +12,24 @@ export interface ConfirmationRequest {
 /** Options for {@link requestConfirmation}. */
 export interface ConfirmationOptions {
     /**
-     * Aborting this signal resolves the card as declined (buttons disabled,
-     * `data-resolved="declined"`) — the hook a Stop control uses to dismiss a
-     * pending confirmation when the user cancels the whole run.
+     * Aborting this signal resolves the card as declined, with buttons disabled
+     * and `data-resolved="declined"` — how a Stop control dismisses a pending
+     * confirmation.
      */
     signal?: AbortSignal;
     /** Localized strings; defaults to the English {@link DEFAULT_UI_STRINGS}. */
     strings?: UiStrings;
 }
 /**
- * Append an inline confirmation card to ``host`` (the chat message list) and
- * resolve when the user decides.
+ * Append an inline confirmation card to `host` (the chat message list) and
+ * resolve `true` on confirm, `false` on cancel.
  *
- * Unlike a modal overlay, the card lives in the transcript right where the
- * action is — it reads naturally after the assistant's explanation and never
- * steals focus from the page. Resolves ``true`` on confirm, ``false`` on
- * cancel.
+ * The card lives in the transcript rather than in a modal overlay, so it reads
+ * after the assistant's explanation and never steals focus from the page.
  *
- * **Answering it removes it.** A prompt and a record are two different objects:
- * the prompt owns the user's attention until it is answered, and the record of
- * what was decided belongs in the transcript, in order, scrolling with
- * everything else. The tool card this gates is that record — it settles to
- * `done` or `declined` and carries the decision. Leaving the spent form in
- * place made an answered question read as outstanding.
+ * Answering it removes it: the record of the decision belongs to the tool card
+ * this gates, which settles to `done` or `declined` and carries it. A spent
+ * form left in place reads as still outstanding.
  */
 export declare function requestConfirmation(host: Node & ParentNode, request: ConfirmationRequest, options?: ConfirmationOptions): Promise<boolean>;
 //# sourceMappingURL=confirmation_card.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"confirmation_card.d.ts","sourceRoot":"","sources":["../../src/ui/confirmation_card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErE,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,GAAG,UAAU,EACvB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,OAAO,CAAC,CAyDlB"}
+{"version":3,"file":"confirmation_card.d.ts","sourceRoot":"","sources":["../../src/ui/confirmation_card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErE,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,GAAG,UAAU,EACvB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,OAAO,CAAC,CAyDlB"}

package/dist/ui/question_card.d.ts

@@ -17,9 +17,8 @@ export interface QuestionRequest {
 /** Options for {@link requestQuestion}. */
 export interface QuestionOptions {
     /**
-     * Aborting this signal resolves the card with an empty answer (fields
-     * disabled) — the hook a Stop control uses to dismiss an open question when
-     * the user cancels the whole run.
+     * Aborting this signal resolves the card with an empty answer and disabled
+     * fields — how a Stop control dismisses an open question.
      */
     signal?: AbortSignal;
     /** Localized strings; defaults to the English {@link DEFAULT_UI_STRINGS}. */
@@ -29,24 +28,22 @@ export interface QuestionOptions {
  * A fully custom renderer for the `ask_user` question, set via
  * `AgUiChat.askUserRenderer`. Receives the parsed {@link QuestionRequest} and an
  * `AbortSignal` that fires when the run is stopped, and resolves with the user's
- * answer (an empty string signals "no answer", e.g. on abort). When provided it
- * **replaces** the built-in {@link requestQuestion} card entirely — the host owns
- * the DOM, so it can render a native modal, a framework component, or anything
- * else. See the `strings` / `::part()` seams for styling the built-in card
- * instead of replacing it.
+ * answer; an empty string means no answer. Replaces the built-in
+ * {@link requestQuestion} card entirely — see {@link ApprovalRenderer} for the
+ * same seam on approvals.
  */
 export type QuestionRenderer = (request: QuestionRequest, options: {
     signal: AbortSignal;
 }) => Promise<string>;
 /**
- * Append an inline **question** card to ``host`` and resolve with the user's
- * answer — the browser half of the built-in `ask_user` frontend tool.
+ * Append an inline question card to `host` and resolve with the user's answer —
+ * the browser half of the built-in `ask_user` frontend tool.
  *
- * Unlike the confirmation/approval cards (which resolve a yes/no), this collects
- * a typed answer: a radio pick from ``options``, or free text (when
- * ``allowCustom`` or no ``options`` are given). The card stays in the transcript
- * as a resolved record (controls disabled, `data-resolved` set) rather than
- * vanishing. A Stop while it is open resolves it with an empty string.
+ * Collects a typed answer rather than the yes/no the confirmation and approval
+ * cards return: a radio pick from `options`, or free text when `allowCustom` is
+ * set or no `options` are given. Stays in the transcript as a resolved record,
+ * controls disabled and `data-resolved` set; a Stop while it is open resolves
+ * it with an empty string.
  */
 export declare function requestQuestion(host: Node & ParentNode, request: QuestionRequest, options?: QuestionOptions): Promise<string>;
 //# sourceMappingURL=question_card.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"question_card.d.ts","sourceRoot":"","sources":["../../src/ui/question_card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErE,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,KAC7B,OAAO,CAAC,MAAM,CAAC,CAAC;AAYrB;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,GAAG,UAAU,EACvB,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAkJjB"}
+{"version":3,"file":"question_card.d.ts","sourceRoot":"","sources":["../../src/ui/question_card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErE,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,KAC7B,OAAO,CAAC,MAAM,CAAC,CAAC;AAYrB;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,GAAG,UAAU,EACvB,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAkJjB"}

package/dist/ui/relative_time.d.ts

@@ -3,13 +3,11 @@ import { type UiStrings } from "./ui_strings.js";
  * A compact relative timestamp for a thread row — e.g. `"just now"`, `"5m ago"`,
  * `"3h ago"`, `"2d ago"`, `"4w ago"`.
  *
- * `now` is injectable so callers (and tests) can pin the reference point; it
- * defaults to the current time. A timestamp in the future (clock skew) reads as
- * `"just now"`. A non-finite timestamp — an unparseable or missing `updated_at`
- * that arrived as `NaN` — has no meaningful age, so it falls back to `justNow`
- * rather than rendering `"NaNw ago"` or `"~2950w ago"`. The unit words come from
- * {@link UiStrings} (the `{n}` token is filled in here) so a localized host
- * translates them; the bucketing stays integer-rounded and locale-neutral.
+ * `now` is injectable so callers and tests can pin the reference point. A
+ * future timestamp (clock skew) and a non-finite one (an unparseable or missing
+ * `updated_at`, arriving as `NaN`) both read as `justNow`, rather than
+ * rendering a nonsense age. Unit words come from {@link UiStrings} with `{n}`
+ * filled in here; the bucketing stays integer-rounded and locale-neutral.
  */
 export declare function relativeTime(timestamp: number, now?: number, strings?: UiStrings): string;
 //# sourceMappingURL=relative_time.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"relative_time.d.ts","sourceRoot":"","sources":["../../src/ui/relative_time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAAmB,EACxB,OAAO,GAAE,SAA8B,GACtC,MAAM,CAqBR"}
+{"version":3,"file":"relative_time.d.ts","sourceRoot":"","sources":["../../src/ui/relative_time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAAmB,EACxB,OAAO,GAAE,SAA8B,GACtC,MAAM,CAqBR"}

package/dist/ui/render_markdown.d.ts

@@ -1,22 +1,22 @@
 /** Options for {@link renderMarkdown}. */
 export interface RenderMarkdownOptions {
     /**
-     * Permit `<img>` tags (and their `src`/`alt`/`width`/`height` attributes)
-     * in the sanitised output. **Off by default** — see the allowlist note on
-     * the exfiltration risk. Only enable for trusted content sources.
+     * Permit `<img>` tags (and their `src`/`alt`/`width`/`height` attributes) in
+     * the sanitised output. Off by default; see the exfiltration note on the
+     * allowlist above. Only enable for trusted content sources.
      */
     readonly allowImages?: boolean;
 }
 /**
  * Render markdown (and any embedded raw HTML) to a sanitised HTML string.
  *
- * Both markdown syntax and literal HTML flow through one path: `marked` emits
- * HTML, then DOMPurify strips everything outside {@link ALLOWED_TAGS} /
- * {@link ALLOWED_ATTR} (scripts, event handlers, `javascript:` URLs, etc.).
- * Links are hardened with `target="_blank"` + `rel="noopener noreferrer"`.
+ * Markdown syntax and literal HTML share one path: `marked` emits HTML, then
+ * DOMPurify strips everything outside {@link ALLOWED_TAGS} /
+ * {@link ALLOWED_ATTR} — scripts, event handlers, `javascript:` URLs. Links are
+ * hardened with `target="_blank"` and `rel="noopener noreferrer"`.
  *
  * The result is trimmed so a single-paragraph message round-trips to clean
- * `textContent` (no trailing newline from the wrapping `<p>`).
+ * `textContent`, without the wrapping paragraph's trailing newline.
  */
 export declare function renderMarkdown(text: string, options?: RenderMarkdownOptions): string;
 //# sourceMappingURL=render_markdown.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"render_markdown.d.ts","sourceRoot":"","sources":["../../src/ui/render_markdown.ts"],"names":[],"mappings":"AAwFA,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAcpF"}
+{"version":3,"file":"render_markdown.d.ts","sourceRoot":"","sources":["../../src/ui/render_markdown.ts"],"names":[],"mappings":"AA8DA,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAcpF"}