@artooi/agents-web-components 0.0.0-stage → 0.1.0

package/dist/ui/charts/chart_block.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Draw a {@link ChartSpec} as SVG.
+ *
+ * Every node is built with `createElement`, never parsed from a string, so this
+ * path never reaches the markdown sanitiser and cannot be widened by model
+ * output. That is the argument for taking a *spec* rather than markup: the model
+ * chooses the numbers, this module chooses the DOM. It is why a chart can be
+ * shown on a surface that keeps `img` off by default, a model-controlled URL
+ * being a zero-click exfiltration channel.
+ *
+ * Hand-rolled rather than a charting library, and the difference is not
+ * marginal: the whole renderer costs single-digit kilobytes where a library
+ * costs roughly half this bundle again, in a component distributed over a CDN.
+ *
+ * **The drawing is sized in CSS pixels, not scaled to them.** An SVG with a
+ * fixed viewBox and `width: 100%` is a picture the browser magnifies: widen the
+ * panel and every stroke, every label and the whole frame grow with it. So the
+ * geometry is computed for the width the block actually has, one user unit to
+ * one CSS pixel, and recomputed when that width changes -- a 10px label is
+ * 10px at every size the block is given.
+ *
+ * How wide the block is allowed to get is the stylesheet's question, not this
+ * module's, and the answer there is that a chart stops at its own width rather
+ * than stretching with the panel, the way a message does. The two halves are
+ * separate on purpose: this one keeps a chart from being magnified, that one
+ * keeps it from being stretched, and a host that raises the cap gets a bigger
+ * chart with the same 10px labels rather than a magnified one.
+ */
+/** One named series of numbers. */
+export interface ChartSeries {
+    readonly label: string;
+    readonly points: readonly number[];
+}
+/** How a spec is drawn. */
+export type ChartKind = "bar" | "line" | "pie" | "scatter" | "stacked";
+/** A chart, as data. */
+export interface ChartSpec {
+    readonly kind: ChartKind;
+    readonly title?: string;
+    readonly labels: readonly string[];
+    readonly series: readonly ChartSeries[];
+}
+/** The colour for series `index`, wrapping when there are more series than colours. */
+export declare function seriesColor(index: number): string;
+/**
+ * Render one spec as a self-contained block, or `null` when it says nothing.
+ *
+ * A spec with no labels or no series is not drawn: an empty frame reads as
+ * "there is no data" when the truth is "the caller sent nothing", and the two
+ * deserve different answers.
+ *
+ * The block returned is already drawn at {@link DEFAULT_WIDTH} and redraws
+ * itself once it is in a document and knows how wide it really is, so a caller
+ * appends it exactly as before and never has to say how big it should be.
+ */
+export declare function renderChart(spec: ChartSpec): HTMLDivElement | null;
+//# sourceMappingURL=chart_block.d.ts.map

package/dist/ui/charts/chart_block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart_block.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/chart_block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,2BAA2B;AAC3B,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvE,wBAAwB;AACxB,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;CACzC;AAgED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD;AAkWD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc,GAAG,IAAI,CAsClE"}

package/dist/ui/charts/chart_spec_from.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Narrow untrusted input into a {@link ChartSpec}.
+ *
+ * Both arrival routes are untrusted in the same way — a model writes one, a
+ * server the other — so neither is taken on shape. Kept out of the renderer
+ * because the renderer's job is drawing, and a value that reaches it has
+ * already been vouched for.
+ */
+import type { ChartSpec } from "./chart_block.js";
+/** A well-formed spec, or `null` for anything that cannot be drawn honestly. */
+export declare function chartSpecFrom(value: unknown): ChartSpec | null;
+//# sourceMappingURL=chart_spec_from.d.ts.map

package/dist/ui/charts/chart_spec_from.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart_spec_from.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/chart_spec_from.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAa,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA6E7D,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAqC9D"}

package/dist/ui/charts/chart_styles.d.ts

@@ -0,0 +1,2 @@
+export declare const CHART_STYLES: string;
+//# sourceMappingURL=chart_styles.d.ts.map

package/dist/ui/charts/chart_styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart_styles.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/chart_styles.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,YAAY,EAAE,MA6D1B,CAAC"}

package/dist/ui/charts/chart_tool.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The built-in `render_chart` tool: the agent-called route to a chart.
+ *
+ * A thin thing on purpose. It carries no `handler` of its own beyond reporting
+ * back to the model, because everything it does is drawing — which lives in
+ * `render`, the half the component replays. A consumer wanting charts gets this
+ * without writing a renderer; a consumer wanting something else writes their own
+ * tool against the same seam.
+ */
+import type { ClientTool } from "../../tools/client_tool_registry.js";
+/** The name the built-in chart tool registers under. */
+export declare const CHART_TOOL_NAME = "render_chart";
+/** The built-in chart tool. */
+export declare function createChartTool(): ClientTool;
+//# sourceMappingURL=chart_tool.d.ts.map

package/dist/ui/charts/chart_tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart_tool.d.ts","sourceRoot":"","sources":["../../../src/ui/charts/chart_tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAItE,wDAAwD;AACxD,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAgB9C,+BAA+B;AAC/B,wBAAgB,eAAe,IAAI,UAAU,CAuC5C"}

package/dist/ui/composer/attachment_styles.d.ts

@@ -0,0 +1,2 @@
+export declare const ATTACHMENT_STYLES: string;
+//# sourceMappingURL=attachment_styles.d.ts.map

package/dist/ui/composer/attachment_styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment_styles.d.ts","sourceRoot":"","sources":["../../../src/ui/composer/attachment_styles.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,iBAAiB,EAAE,MAqE/B,CAAC"}

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

@@ -0,0 +1,53 @@
+import type { AttachmentRef } from "../../core/attachment.js";
+import type { UploadHandler } from "../../core/upload_attachment.js";
+import { type UiStrings } from "../ui_strings.js";
+/** Config the host ({@link AgUiChat}) hands the tray. */
+export interface AttachmentTrayConfig {
+    /** Upload one file, reporting `0..1` progress; resolves to a durable ref. */
+    readonly upload: UploadHandler;
+    /** Client-side size cap in bytes (`0` = no cap). The server stays authoritative. */
+    readonly maxBytes: number;
+    /** Client-side accept list (`<input accept>` syntax; `""` = any). */
+    readonly accept: string;
+    /** Fired when the set of attachments changes (add / settle / remove). */
+    readonly onChange?: () => void;
+    /** Localized strings; defaults to the English {@link DEFAULT_UI_STRINGS}. */
+    readonly strings?: UiStrings;
+}
+/**
+ * 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 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 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;
+    /** The tray root; append above the input row. Hidden while empty. */
+    readonly element: HTMLDivElement;
+    constructor(config: AttachmentTrayConfig);
+    /** Queue a file: reject oversize/disallowed into an error chip, else upload. */
+    add(file: File): void;
+    /** The durable refs of every chip that finished uploading. */
+    readyRefs(): readonly AttachmentRef[];
+    /** Whether any chip is still uploading (a send would drop nothing if false). */
+    hasPending(): boolean;
+    /** How many chips are still uploading — the count a send-time notice names. */
+    pendingCount(): number;
+    /** Whether the tray holds no chips. */
+    isEmpty(): boolean;
+    /** Drop the settled (ready / error) chips, leaving any still uploading. */
+    clearReady(): void;
+    /** Drop every chip (a reset / new-chat), aborting any in-flight upload. */
+    clear(): void;
+    /**
+     * Abort every in-flight upload without touching the rendered chips — the
+     * teardown path when the host element is removed mid-upload, so a cancelled
+     * transfer doesn't orphan a server-side file.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=attachment_tray.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attachment_tray.d.ts","sourceRoot":"","sources":["../../../src/ui/composer/attachment_tray.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAIrE,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKtE,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/composer/auto_grow.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Size the field to its content: one row when empty, growing with what is
+ * typed until the CSS ceiling takes over and it scrolls.
+ *
+ * Resetting to `auto` first is what makes it shrink again — `scrollHeight`
+ * never reports less than the current height, so measuring without the reset
+ * would ratchet the composer taller and never back down.
+ */
+export declare function autoGrow(input: HTMLTextAreaElement): void;
+//# sourceMappingURL=auto_grow.d.ts.map

package/dist/ui/composer/auto_grow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto_grow.d.ts","sourceRoot":"","sources":["../../../src/ui/composer/auto_grow.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAGzD"}

package/dist/ui/composer/build_composer.d.ts

@@ -0,0 +1,32 @@
+import type { UiStrings } from "../ui_strings.js";
+/** The composer's parts, owned by the element, and what they call back into. */
+export interface ComposerOptions {
+    readonly input: HTMLTextAreaElement;
+    readonly send: HTMLButtonElement;
+    readonly attachButton: HTMLButtonElement;
+    readonly fileInput: HTMLInputElement;
+    readonly voiceSlot: HTMLElement;
+    /** The place chip; sits in the tool row between the voice slot and Send. */
+    readonly place: HTMLElement;
+    /** The line saying what the composer still needs; sits above the input. */
+    readonly hint: HTMLElement;
+    /** The queued-message row; sits above the input beside the tray. */
+    readonly queuedRow: HTMLElement;
+    /** Where the attachment tray mounts; sits above the input. */
+    readonly attachSlot: HTMLElement;
+    readonly strings: UiStrings;
+    readonly signal: AbortSignal;
+    readonly onKeydown: (event: KeyboardEvent) => void;
+    readonly onInput: () => void;
+    /** Send while idle, Stop while a run is in flight: the element decides. */
+    readonly onSend: () => void;
+    readonly onFilesPicked: () => void;
+}
+/**
+ * Build the composer row -- the field, and the tool row under it with the
+ * attach and voice controls, the place chip and Send -- and ready the composer surfaces the
+ * element mounts above it: the hint, the queued row and the attachment slot.
+ * Returns the row; the element places it and the surfaces.
+ */
+export declare function buildComposer(options: ComposerOptions): HTMLElement;
+//# sourceMappingURL=build_composer.d.ts.map

package/dist/ui/composer/build_composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build_composer.d.ts","sourceRoot":"","sources":["../../../src/ui/composer/build_composer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CA+EnE"}

package/dist/ui/composer/composer_attachments.d.ts

@@ -0,0 +1,57 @@
+import { type UploadHandler } from "../../core/upload_attachment.js";
+import type { UiStrings } from "../ui_strings.js";
+import { AttachmentTray } from "./attachment_tray.js";
+/** What the composer's attachments need from the element that owns them. */
+export interface ComposerAttachmentsHost {
+    /** The custom element: its upload attributes, and where the event is dispatched. */
+    readonly element: HTMLElement;
+    /** The chat shell, which a file can be dropped or pasted anywhere on. */
+    readonly chat: HTMLElement;
+    /** Where the tray mounts, above the composer. */
+    readonly slot: HTMLElement;
+    /** The hidden multi-file input the paperclip opens. */
+    readonly fileInput: HTMLInputElement;
+    /** The paperclip, revealed once uploads are possible. */
+    readonly button: HTMLButtonElement;
+    /** The resolved string table. */
+    readonly strings: () => UiStrings;
+    /** The host's `uploadHandler`, read when the tray is wired. */
+    readonly uploadHandler: () => UploadHandler | null;
+    /** The headers a request to `url` carries. */
+    readonly headersFor: (url: string) => Record<string, string>;
+    /** The cookie policy every request carries, when one is configured. */
+    readonly credentialsOption: () => {
+        credentials?: RequestCredentials;
+    };
+}
+/**
+ * Files handed to the composer: the tray they upload through, and the four
+ * ways into it -- the picker, a drop, a paste, and a host's `attachFile`.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance.
+ */
+export declare class ComposerAttachments {
+    #private;
+    constructor(host: ComposerAttachmentsHost);
+    /** The tray, once uploads are wired; `null` while the chat is text-only. */
+    get tray(): AttachmentTray | null;
+    /**
+     * Enable the composer's file-upload tray when uploads are possible — either a
+     * custom `uploadHandler` is set or `data-attachments-url` provides the
+     * built-in multipart endpoint: reveal the 📎 button, wire the hidden file
+     * input + drag-and-drop, and mount the tray. With neither, the affordance
+     * stays hidden and the chat degrades to text-only.
+     *
+     * Called on every connect, so it starts by taking down the tray the last
+     * connection mounted: that one was disposed when the element left, and the
+     * attributes that decide whether there is a tray at all may have changed
+     * since. The shell outlives a connection, so its listeners go under `signal`.
+     */
+    wire(signal: AbortSignal): void;
+    /** The queueing behind `AgUiChat.attachFile`, whose doc is the contract. */
+    attach(file: File): boolean;
+    /** Queue every file from the picker into the tray, then reset the input. */
+    onFilesPicked(): void;
+}
+//# sourceMappingURL=composer_attachments.d.ts.map

package/dist/ui/composer/composer_attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer_attachments.d.ts","sourceRoot":"","sources":["../../../src/ui/composer/composer_attachments.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,iCAAiC,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,4EAA4E;AAC5E,MAAM,WAAW,uBAAuB;IACtC,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,CAAC;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;IACnD,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7D,uEAAuE;IACvE,QAAQ,CAAC,iBAAiB,EAAE,MAAM;QAAE,WAAW,CAAC,EAAE,kBAAkB,CAAA;KAAE,CAAC;CACxE;AAED;;;;;;GAMG;AACH,qBAAa,mBAAmB;;IAK9B,YAAY,IAAI,EAAE,uBAAuB,EAExC;IAED,4EAA4E;IAC5E,IAAI,IAAI,IAAI,cAAc,GAAG,IAAI,CAEhC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CA4B9B;IAED,4EAA4E;IAC5E,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAM1B;IAED,4EAA4E;IAC5E,aAAa,IAAI,IAAI,CAUpB;CA2KF"}

package/dist/ui/composer/composer_styles.d.ts

@@ -0,0 +1,2 @@
+export declare const COMPOSER_STYLES: string;
+//# sourceMappingURL=composer_styles.d.ts.map

package/dist/ui/composer/composer_styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer_styles.d.ts","sourceRoot":"","sources":["../../../src/ui/composer/composer_styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,EAAE,MA8K7B,CAAC"}

package/dist/ui/composer/composer_voice.d.ts

@@ -0,0 +1,48 @@
+import { type TranscribeHandler } from "../../core/transcribe_audio.js";
+import type { UiStrings } from "../ui_strings.js";
+/** What the composer's mic needs from the element that owns it. */
+export interface ComposerVoiceHost {
+    /** The custom element, whose `data-transcribe-url` names the built-in endpoint. */
+    readonly element: HTMLElement;
+    /** Where the mic button mounts, in the composer's tool row. */
+    readonly slot: HTMLElement;
+    /** The composer a transcript is written into. */
+    readonly input: HTMLTextAreaElement;
+    /** The resolved string table. */
+    readonly strings: () => UiStrings;
+    /** The host's `transcribeHandler`, read when the mic is wired. */
+    readonly transcribeHandler: () => TranscribeHandler | null;
+    /** The headers a request to `url` carries. */
+    readonly headersFor: (url: string) => Record<string, string>;
+    /** The cookie policy every request carries, when one is configured. */
+    readonly credentialsOption: () => {
+        credentials?: RequestCredentials;
+    };
+    /** React to the composer's value changing, as typing does. */
+    readonly onInput: () => void;
+}
+/**
+ * The composer's mic: mounted when transcription is possible, and what a
+ * transcript does to the composer.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance.
+ */
+export declare class ComposerVoice {
+    #private;
+    constructor(host: ComposerVoiceHost);
+    /**
+     * Reveal the composer's 🎤 mic button when transcription is possible — either
+     * a custom `transcribeHandler` is set or `data-transcribe-url` provides the
+     * built-in POST endpoint. The control records via `MediaRecorder` and drops
+     * the transcript into the composer; with neither configured the mic stays
+     * hidden and the chat is text-only.
+     *
+     * Called on every connect, so it starts by taking down the mic the last
+     * connection mounted, which was released when the element left.
+     */
+    wire(): void;
+    /** Release the mic, so the browser's recording indicator clears. */
+    dispose(): void;
+}
+//# sourceMappingURL=composer_voice.d.ts.map

package/dist/ui/composer/composer_voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer_voice.d.ts","sourceRoot":"","sources":["../../../src/ui/composer/composer_voice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAmB,MAAM,gCAAgC,CAAC;AACzF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,CAAC;IAClC,kEAAkE;IAClE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,iBAAiB,GAAG,IAAI,CAAC;IAC3D,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7D,uEAAuE;IACvE,QAAQ,CAAC,iBAAiB,EAAE,MAAM;QAAE,WAAW,CAAC,EAAE,kBAAkB,CAAA;KAAE,CAAC;IACvE,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;;IAKxB,YAAY,IAAI,EAAE,iBAAiB,EAElC;IAED;;;;;;;;;OASG;IACH,IAAI,IAAI,IAAI,CAcX;IAED,oEAAoE;IACpE,OAAO,IAAI,IAAI,CAEd;CAuBF"}

package/dist/ui/composer/skill_styles.d.ts

@@ -0,0 +1,2 @@
+export declare const SKILL_STYLES: string;
+//# sourceMappingURL=skill_styles.d.ts.map

package/dist/ui/composer/skill_styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill_styles.d.ts","sourceRoot":"","sources":["../../../src/ui/composer/skill_styles.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,YAAY,EAAE,MAsH1B,CAAC"}

package/dist/ui/composer/skills_menu.d.ts

@@ -0,0 +1,34 @@
+import type { Skill } from "../../skills/skill.js";
+/**
+ * The two skill surfaces over a single catalog: a chips row (the `chip: true`
+ * subset) and a slash-command palette (all skills, filtered). Both opt-in.
+ * Pure DOM; the host appends {@link chips} and {@link palette}, feeds input via
+ * {@link onInput} / {@link onKeydown}, and acts on {@link onPick}.
+ */
+export declare class SkillsMenu {
+    #private;
+    /** Chips row — append above the input. Hidden unless chips are enabled and present. */
+    readonly chips: HTMLDivElement;
+    /** The `/`-command dropdown — append in the input area. Hidden until opened. */
+    readonly palette: HTMLDivElement;
+    constructor(onPick: (skill: Skill) => void);
+    /** Replace the catalog (both surfaces re-derive from it). */
+    setSkills(skills: readonly Skill[]): void;
+    enableChips(enabled: boolean): void;
+    enableSlash(enabled: boolean): void;
+    /** Whether the palette is currently open. */
+    isOpen(): boolean;
+    /**
+     * React to an input value change: open + filter the palette when slash mode
+     * is on and the value starts with `/`, otherwise close it.
+     */
+    onInput(value: string): void;
+    /**
+     * Handle a keydown while the palette is open. Returns ``true`` when consumed
+     * (the host should `preventDefault` and skip its own handling).
+     */
+    onKeydown(event: KeyboardEvent): boolean;
+    /** Close the palette. */
+    close(): void;
+}
+//# sourceMappingURL=skills_menu.d.ts.map

package/dist/ui/composer/skills_menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills_menu.d.ts","sourceRoot":"","sources":["../../../src/ui/composer/skills_menu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD;;;;;GAKG;AACH,qBAAa,UAAU;;IACrB,uFAAuF;IACvF,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IASjC,YAAY,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAWzC;IAED,6DAA6D;IAC7D,SAAS,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,IAAI,CAGxC;IAED,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAGlC;IAED,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAElC;IAED,6CAA6C;IAC7C,MAAM,IAAI,OAAO,CAEhB;IAED;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAM3B;IAED;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAyBvC;IAED,yBAAyB;IACzB,KAAK,IAAI,IAAI,CAGZ;CAsFF"}

package/dist/ui/composer/voice_input.d.ts

@@ -0,0 +1,46 @@
+import type { TranscribeHandler } from "../../core/transcribe_audio.js";
+import { type UiStrings } from "../ui_strings.js";
+/** Construction options for {@link VoiceInput}. */
+export interface VoiceInputOptions {
+    /** Turns a recorded clip into text (the built-in or a custom transport). */
+    readonly transcribe: TranscribeHandler;
+    /** Called with the transcript when a recording transcribes successfully. */
+    readonly onText: (text: string) => void;
+    /** UI string table (labels/tooltips). */
+    readonly strings?: UiStrings;
+}
+/**
+ * The composer's voice-input control: a mic button that records via
+ * `MediaRecorder`, then POSTs the clip through a {@link TranscribeHandler} and
+ * hands the transcript back via `onText`.
+ *
+ * Click to start recording, which prompts for mic permission, and again to stop
+ * and transcribe. The button reflects its `idle` / `recording` / `transcribing`
+ * state on `data-state` for theming and is exposed as `part="voice-button"`; a
+ * capture or transcription failure returns it to idle and surfaces the message
+ * on its tooltip.
+ *
+ * Pure DOM. The host mounts {@link element} in the input row.
+ */
+export declare class VoiceInput {
+    #private;
+    /** The mic button; mount this in the composer. */
+    readonly element: HTMLButtonElement;
+    constructor(options: VoiceInputOptions);
+    /** Start recording when idle, stop (and transcribe) when recording. */
+    toggle(): Promise<void>;
+    /**
+     * Tear the control down, for a host element removed mid-recording or handed
+     * to the next principal. Stops any live `MediaRecorder`, releases the mic
+     * tracks so the browser's recording indicator clears, and suppresses the
+     * pending transcription — a disconnected control must not fire `onText` into
+     * a detached element.
+     *
+     * Disposal is final: nothing un-disposes an instance, and the host's next
+     * wiring builds a new one. So the disposed flag alone tells a continuation
+     * that outlived the control from a live one, and a clip already posted when this runs is
+     * dropped whenever its answer arrives.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=voice_input.d.ts.map

package/dist/ui/composer/voice_input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice_input.d.ts","sourceRoot":"","sources":["../../../src/ui/composer/voice_input.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAoBtE,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,yCAAyC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;CAC9B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAU;;IACrB,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IAepC,YAAY,OAAO,EAAE,iBAAiB,EAmBrC;IAED,uEAAuE;IACjE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAS5B;IAsFD;;;;;;;;;;;OAWG;IACH,OAAO,IAAI,IAAI,CAQd;CAiFF"}

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

@@ -0,0 +1,13 @@
+import type { UiStrings } from "../ui_strings.js";
+/**
+ * Give every fenced code block in `root` a copy button.
+ *
+ * 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.
+ *
+ * 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;
+//# sourceMappingURL=attach_copy_buttons.d.ts.map

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

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

package/dist/ui/excerpts/copy_payload.d.ts

@@ -0,0 +1,30 @@
+/** What a copied message puts on the clipboard, in both flavours. */
+export interface CopyPayload {
+    /** The plain-text flavour, structured so a table survives a paste. */
+    readonly text: string;
+    /** The rich flavour, so a table pastes as a table. */
+    readonly html: string;
+}
+/**
+ * What to copy from one rendered message, in both clipboard flavours.
+ *
+ * `textContent` was the obvious answer and the wrong one. It concatenates every
+ * descendant with no separator at all, so a markdown table arrives as one run
+ * of digits with the headers welded to the first row -- unusable in a
+ * spreadsheet, and unreadable anywhere. Lists lose their bullets the same way,
+ * and paragraphs run together.
+ *
+ * So the plain flavour is serialised structurally: table rows become tab
+ * separated lines, which is the format spreadsheets parse on paste, and blocks
+ * and list items get their own lines. The rich flavour carries the markup, so a
+ * target that understands it -- a document, a chat client, a spreadsheet --
+ * gets the real table rather than a reconstruction of one.
+ *
+ * Both are taken from a **clone with the component's own buttons removed**. The
+ * code-block copy buttons are appended inside their own `pre`, so they are
+ * descendants of the bubble and `textContent` was picking their label up: a
+ * message containing a code block copied with the word for Copy sitting in the
+ * middle of it.
+ */
+export declare function copyPayload(root: Element): CopyPayload;
+//# sourceMappingURL=copy_payload.d.ts.map

package/dist/ui/excerpts/copy_payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy_payload.d.ts","sourceRoot":"","sources":["../../../src/ui/excerpts/copy_payload.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AA+BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAQtD"}

package/dist/ui/excerpts/page_quote_offer.d.ts

@@ -0,0 +1,33 @@
+/** A live page-side offer. */
+export interface PageQuoteOffer {
+    /** The button itself, for a host that wants to style or inspect it. */
+    readonly element: HTMLButtonElement;
+    /** Stop offering: every listener removed, the button and its styles gone. */
+    detach(): void;
+}
+/** What {@link attachQuoteOffer} needs to know. */
+export interface PageQuoteOfferOptions {
+    /** Where a selection is worth offering to quote. */
+    within: HTMLElement;
+    /** What the offer says. */
+    label: string;
+    /**
+     * A subtree to stay out of -- the chat widget itself.
+     *
+     * Its transcript runs this same gesture on the inside, so without this a
+     * selection there would be offered twice and quoted twice.
+     */
+    exclude: Node;
+    /** Take the offer. */
+    onQuote: (text: string) => void;
+}
+/**
+ * Offer to quote what the user selects inside `within`.
+ *
+ * Nothing is quoted until the offer is taken -- which is the whole point. An
+ * automatic version of this is easy to write and horrible to use: every drag
+ * made to read, to copy, or to fix a typo silently appends to whatever the user
+ * was in the middle of typing.
+ */
+export declare function attachQuoteOffer(options: PageQuoteOfferOptions): PageQuoteOffer;
+//# sourceMappingURL=page_quote_offer.d.ts.map

package/dist/ui/excerpts/page_quote_offer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page_quote_offer.d.ts","sourceRoot":"","sources":["../../../src/ui/excerpts/page_quote_offer.ts"],"names":[],"mappings":"AAqDA,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,6EAA6E;IAC7E,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,oDAAoD;IACpD,MAAM,EAAE,WAAW,CAAC;IACpB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,OAAO,EAAE,IAAI,CAAC;IACd,sBAAsB;IACtB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAgG/E"}

package/dist/ui/excerpts/place_offer.d.ts

@@ -0,0 +1,9 @@
+/** The box an offer is positioned in: its top-left corner and width, in viewport pixels. */
+export interface OfferBox {
+    readonly top: number;
+    readonly left: number;
+    readonly width: number;
+}
+/** Float the offer beside `rect`, above it when there is room and inside `box` horizontally. */
+export declare function placeOffer(button: HTMLButtonElement, rect: DOMRect, box: OfferBox): void;
+//# sourceMappingURL=place_offer.d.ts.map

package/dist/ui/excerpts/place_offer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"place_offer.d.ts","sourceRoot":"","sources":["../../../src/ui/excerpts/place_offer.ts"],"names":[],"mappings":"AAGA,4FAA4F;AAC5F,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAYxF"}

package/dist/ui/excerpts/quote_selection.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Reading a text selection out of the shadow tree, and shaping it for the
+ * composer.
+ *
+ * Selection is the one DOM API shadow encapsulation genuinely broke, and it
+ * broke it in two different directions. WebKit rescopes a selection made inside
+ * a shadow tree to the **host** element, so `document.getSelection()` reports
+ * the whole widget and none of the words; Chromium exposes the shadow nodes
+ * directly, so the same call reports exactly the words. `getComposedRanges` is
+ * the settled answer to both -- it hands back real endpoints for each shadow
+ * root it is *given permission to see* -- but it is recent enough that the
+ * direct read has to stay behind it.
+ */
+/**
+ * The longest quotation put into the composer, in characters.
+ *
+ * A cap rather than no cap because the point of a quotation is to say *which*
+ * part of an answer the next question is about. Select-all-then-quote is a
+ * gesture the transcript already answers -- it is the whole conversation, which
+ * the model has -- and pasting it back costs the user tokens to say nothing.
+ */
+export declare const MAX_QUOTE_CHARS = 500;
+/** A selection worth offering to quote. */
+export interface QuotableSelection {
+    /** The selected text, trimmed. Never empty. */
+    readonly text: string;
+    /**
+     * One **line** of the selection, for placing the affordance beside it.
+     *
+     * Deliberately not the selection's bounding box. See {@link lineToHangFrom}:
+     * the union of a selection spanning several elements has a centre with no
+     * selected text anywhere near it.
+     */
+    readonly rect: DOMRect;
+}
+/** Where a gesture ended, in viewport coordinates. */
+export interface Point {
+    readonly x: number;
+    readonly y: number;
+}
+/**
+ * The current selection, when it lies wholly inside `container`.
+ *
+ * `roots` are the shadow roots the read is allowed to look inside, in the shape
+ * `getComposedRanges` itself takes. Pass the one holding `container` for a
+ * selection made in a shadow tree, or nothing at all for one made in the page.
+ *
+ * `near` is where the gesture ended, when a pointer made it -- it decides which
+ * line of a multi-line selection the offer is hung from.
+ *
+ * `null` for no selection, a collapsed one, whitespace only, or one that
+ * starts or ends outside `container` -- a drag that ran off the transcript and
+ * into the page is not a quotation from the transcript.
+ */
+export declare function quotableSelection(container: HTMLElement, roots?: readonly ShadowRoot[], near?: Point): QuotableSelection | null;
+/**
+ * Wrap `text` as a markdown blockquote, ready to be followed by a question.
+ *
+ * Markdown rather than a bespoke fence because the transcript renders markdown
+ * and the server reads markdown: a quotation that survives both ends without a
+ * convention to agree on first. The trailing blank line is what leaves the
+ * caret on a fresh paragraph, which is the whole point of quoting into a
+ * composer rather than sending straight away.
+ */
+export declare function asQuote(text: string): string;
+//# sourceMappingURL=quote_selection.d.ts.map

package/dist/ui/excerpts/quote_selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote_selection.d.ts","sourceRoot":"","sources":["../../../src/ui/excerpts/quote_selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,sDAAsD;AACtD,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,WAAW,EACtB,KAAK,GAAE,SAAS,UAAU,EAAO,EACjC,IAAI,CAAC,EAAE,KAAK,GACX,iBAAiB,GAAG,IAAI,CAqB1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAa5C"}