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

package/dist/core/agui_client.d.ts

@@ -23,9 +23,9 @@ export interface ToolExecution {
 /**
  * Executes a frontend tool call.
  *
- * Returns the {@link ToolExecution} to post back to the agent, or ``null`` when
- * the call is not a frontend tool the host owns (a server-side tool the server
- * already executed — the client must not re-run for it).
+ * Returns the {@link ToolExecution} to post back to the agent, or `null` when
+ * the call is not a frontend tool the host owns — a server-side tool the server
+ * already executed, which the client must not re-run.
  */
 export type ExecuteTool = (call: AgUiToolCall) => Promise<ToolExecution | null>;
 /**
@@ -43,11 +43,10 @@ export type InterruptResponse = {
 /**
  * Resolves the approval interrupts a run finished on, keyed by interrupt id.
  *
- * When a gated **server-side** tool defers instead of executing, the run
- * finishes on an AG-UI interrupt outcome; the host renders an approval card per
- * interrupt and returns each decision here, and the loop resumes the run with
- * the answers. Omit for agents that never gate server-side tools — an
- * unresolved interrupt then simply ends the loop.
+ * A gated server-side tool defers instead of executing, so the run finishes on
+ * an interrupt outcome; the host collects one decision per interrupt and the
+ * loop resumes with the answers. Omit for agents that never gate server-side
+ * tools — an unresolved interrupt then ends the loop.
  */
 export type ResolveInterrupts = (interrupts: readonly Interrupt[]) => Promise<Record<string, InterruptResponse>>;
 /**
@@ -57,9 +56,9 @@ export type ResolveInterrupts = (interrupts: readonly Interrupt[]) => Promise<Re
  */
 export interface AgUiClientHandlers {
     onRunStart(): void;
-    /** Fired on every streamed token; ``buffer`` is the full text so far. */
+    /** Fired on every streamed token; `buffer` is the full text so far. */
     onTextDelta(buffer: string): void;
-    /** Fired when the assistant message completes; ``buffer`` is the final text. */
+    /** Fired when the assistant message completes; `buffer` is the final text. */
     onTextEnd(buffer: string): void;
     /** Fired when the agent finishes calling a tool (server- or frontend-side). */
     onToolCall(call: AgUiToolCall): void;
@@ -85,17 +84,15 @@ export interface AgUiClientHandlers {
     onError(message: string): void;
     /**
      * Fired when the user cancelled the run ({@link AgUiClient.cancel}) — the
-     * deliberate-stop sibling of `onError`. Any partial assistant text already
-     * streamed stays valid; the host should keep the bubble and show a muted
-     * "stopped" affordance rather than an error. `onSettled` still follows.
+     * deliberate-stop sibling of `onError`. Partial assistant text already
+     * streamed stays valid, so the host keeps the bubble and shows a stopped
+     * affordance rather than an error. `onSettled` still follows.
      */
     onCancelled(): void;
     /**
-     * Fired exactly once when the whole interaction settles — after the run loop
-     * ends for any reason (a server-only round, frontend-tool rounds exhausted,
-     * a cancellation, or an error). The terminal guarantee that the UI returns
-     * to rest (pending indicator cleared, input re-enabled) no matter how the
-     * run finished.
+     * Fired exactly once when the interaction settles, however the run loop ended
+     * — server-only round, rounds exhausted, cancellation, or error. The terminal
+     * guarantee that the UI returns to rest.
      */
     onSettled(): void;
 }
@@ -126,17 +123,15 @@ export interface AgUiClientConfig extends AgUiRunInputs {
      */
     onPersist?: (messages: readonly Message[]) => void;
     /**
-     * Called whenever AG-UI shared state changes — the server streamed a
-     * `STATE_SNAPSHOT` / `STATE_DELTA`, or {@link AgUiClient.setState} was
-     * called. `@ag-ui/client` owns applying those events; this only forwards
-     * the result so a host can react.
+     * Called whenever AG-UI shared state changes — a streamed `STATE_SNAPSHOT` /
+     * `STATE_DELTA`, or {@link AgUiClient.setState}. `@ag-ui/client` owns applying
+     * those events; this only forwards the result.
      */
     onStateChanged?: (state: Readonly<Record<string, unknown>>) => void;
     /**
-     * Error text surfaced to {@link AgUiClientHandlers.onError} when a run's
-     * stream closes without a terminal AG-UI event (`RUN_FINISHED`/`RUN_ERROR`) —
-     * a dropped connection. Defaults to `"Connection lost"`; the host passes its
-     * localized string.
+     * Error text for {@link AgUiClientHandlers.onError} when a run's stream closes
+     * without a terminal AG-UI event. Defaults to `"Connection lost"`; the host
+     * passes its localized string.
      */
     connectionLostMessage?: string;
 }
@@ -175,15 +170,14 @@ export declare class AgUiClient {
      * tools (bounded by {@link MAX_TOOL_ROUNDS}).
      *
      * `attachments` ride on the user message as a non-standard field so the
-     * default client store round-trips them for history replay; the agent learns
-     * the ids from the run context (the server's strict validation ignores the
-     * unknown message field), then reads bytes via the `read_attachment` tool.
+     * default store round-trips them for history replay; see
+     * {@link messageAttachments}.
      */
     send(content: string, attachments?: readonly AttachmentRef[]): Promise<void>;
     /**
      * Resume the run loop after a navigating tool's result was supplied
      * post-reload (via {@link addToolResult}). Unlike {@link send}, adds no user
-     * message — it simply continues the conversation already in history.
+     * message; it continues the conversation already in history.
      */
     resume(): Promise<void>;
     /** Append a frontend tool result to history (used by the resume path). */

package/dist/core/agui_client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agui_client.d.ts","sourceRoot":"","sources":["../../src/core/agui_client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAe,IAAI,EAAE,MAAM,aAAa,CAAC;AAElF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAEpG;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,UAAU,EAAE,SAAS,SAAS,EAAE,KAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,IAAI,IAAI,CAAC;IACnB,yEAAyE;IACzE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gFAAgF;IAChF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,+EAA+E;IAC/E,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC;;;;OAIG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD;;;;OAIG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACzD,yEAAyE;IACzE,gBAAgB,IAAI,IAAI,CAAC;IACzB,oFAAoF;IACpF,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,4EAA4E;IAC5E,cAAc,IAAI,IAAI,CAAC;IACvB,QAAQ,IAAI,IAAI,CAAC;IACjB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;;OAKG;IACH,WAAW,IAAI,IAAI,CAAC;IACpB;;;;;;OAMG;IACH,SAAS,IAAI,IAAI,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,OAAO,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,sEAAsE;IACtE,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,oEAAoE;IACpE,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,KAAK,IAAI,CAAC;IACnD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;IACpE;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;;IAoBrB,YAAY,MAAM,EAAE,gBAAgB,EAoBnC;IAED,oEAAoE;IACpE,IAAI,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAE7C;IAED,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAEvD;IAED,4CAA4C;IAC5C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,wEAAwE;IACxE,IAAI,QAAQ,IAAI,SAAS,OAAO,EAAE,CAEjC;IAED;;;;;;;;;;;OAWG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,SAAS,aAAa,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrF;IAED;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5B;IAED,0EAA0E;IAC1E,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGvD;IAED;;;;;;OAMG;IACH,MAAM,IAAI,IAAI,CAGb;CAoMF"}
+{"version":3,"file":"agui_client.d.ts","sourceRoot":"","sources":["../../src/core/agui_client.ts"],"names":[],"mappings":"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"}

package/dist/core/attachment.d.ts

@@ -3,11 +3,9 @@ import type { Message } from "@ag-ui/core";
  * A durable, lightweight reference to one uploaded file — what an upload
  * returns and what rides on a sent message, never the bytes.
  *
- * Mirrors django-ag-ui's `AttachmentRef`: a file uploads out-of-band to the
+ * Mirrors django-ag-ui's `AttachmentRef`: the file uploads out-of-band to the
  * attachments endpoint, the server hands back this ref, and the agent reads the
- * actual content server-side via the `read_attachment` tool. Keeping the AG-UI
- * message stream free of base64 mirrors how the tool catalog keeps schemas off
- * the wire.
+ * content server-side via the `read_attachment` tool.
  */
 export interface AttachmentRef {
     /** Opaque, owner-scoped handle the server resolves back to bytes. */
@@ -24,17 +22,14 @@ export interface AttachmentRef {
 /**
  * The attachment refs a user message carries.
  *
- * Refs are stored on the user message as a non-standard `attachments` field: a
- * web-component augmentation that the default client store round-trips and
- * `@ag-ui/client` preserves through `addMessage` / `structuredClone`, so a
- * restored conversation re-renders its attachment chips. The server's strict
- * `RunAgentInput` validation ignores the unknown field — the model learns the
- * ids from the run context manifest instead.
+ * Refs ride on the message as a non-standard `attachments` field, which the
+ * default store round-trips and `@ag-ui/client` preserves through `addMessage`
+ * / `structuredClone`, so a restored conversation re-renders its chips. The
+ * server's strict `RunAgentInput` validation ignores the unknown field.
  *
- * The persisted array is untrusted (it can be hand-edited, truncated, or
- * corrupted in storage), so every entry is validated and malformed ones are
- * dropped — a `null` or shapeless entry would otherwise throw in `iconFor` and
- * abort the whole history replay.
+ * Storage is untrusted — hand-edited, truncated, or corrupted — so malformed
+ * entries are dropped here; a shapeless one would throw in `iconFor` and abort
+ * the whole history replay.
  */
 export declare function messageAttachments(message: Message): readonly AttachmentRef[];
 //# sourceMappingURL=attachment.d.ts.map

package/dist/core/attachment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../../src/core/attachment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,aAAa,EAAE,CAG7E"}
+{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../../src/core/attachment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,aAAa,EAAE,CAG7E"}

package/dist/core/conversation_store.d.ts

@@ -10,13 +10,11 @@ export interface NavigationCheckpoint {
     readonly toolCallId: string;
 }
 /**
- * Lightweight metadata for one conversation — the thread-drawer row shape.
- *
- * Returned by {@link ClientConversationStore.listThreads} so the drawer can
- * render a list without loading message bodies. `title` defaults to a
- * truncation of the first user message (until an explicit rename); `preview`
- * is a one-line excerpt of the latest message; `updatedAt` is epoch ms of the
- * last change, used to order the list.
+ * Lightweight metadata for one conversation — the thread-drawer row shape, so
+ * the drawer renders without loading message bodies. `title` defaults to a
+ * truncation of the first user message until an explicit rename, `preview` is a
+ * one-line excerpt of the latest message, and `updatedAt` is epoch ms of the
+ * last change, which orders the list.
  */
 export interface ThreadMeta {
     readonly threadId: string;
@@ -28,16 +26,14 @@ export interface ThreadMeta {
  * Client-side persistence seam for the conversation and a pending-navigation
  * checkpoint, keyed by `thread_id`.
  *
- * The default {@link SessionStorageStore} keeps everything per-tab in
- * `sessionStorage`, so the chat survives the full page reloads of a
- * multi-page app. A host may inject a server-backed store instead (e.g. one
- * that rehydrates from a history endpoint); `loadMessages` and `listThreads`
- * are therefore async-friendly. The checkpoint methods stay synchronous — the
- * marker is a tiny local hint a server store can derive from history and no-op.
+ * The default {@link SessionStorageStore} keeps everything per-tab. A host may
+ * inject a server-backed store instead, which is why `loadMessages` and
+ * `listThreads` are async. The checkpoint methods stay synchronous: the marker
+ * is a small local hint a server store can derive from history and no-op.
  *
- * Thread enumeration (`listThreads` / `setActiveThread` / `renameThread`) backs
- * the chat-history drawer; "delete a thread" reuses {@link clear} and "new
- * chat" reuses {@link threadId} after clearing the active thread.
+ * Thread enumeration backs the chat-history drawer; deleting a thread reuses
+ * {@link clear} and "new chat" reuses {@link threadId} after clearing the
+ * active thread.
  */
 export interface ClientConversationStore {
     /** The active conversation id, generated and persisted on first read. */
@@ -62,18 +58,15 @@ export interface ClientConversationStore {
 /**
  * Default {@link ClientConversationStore}: per-tab `sessionStorage`.
  *
- * Survives full page reloads and same-tab navigation, clears on tab close —
- * the right scope for an embedded agent's conversation in a multi-page app.
- * Tracks multiple threads per tab: the active id lives under one key, the
- * message history / checkpoint are namespaced by id, and a small index feeds
- * the drawer so it works with no server.
+ * Survives full page reloads and same-tab navigation, clears on tab close.
+ * Tracks multiple threads per tab: the active id under one key, message history
+ * and checkpoint namespaced by id, and a small index feeding the drawer with no
+ * server involved.
  *
- * An optional `namespace` scopes every key to one element (its `id`, else its
- * endpoint), so two `<ag-ui-chat>` instances — or two apps — on the same origin
- * keep separate active-thread pointers and drawer indexes instead of clobbering
- * each other. Constructing with a namespace migrates any pre-namespacing
- * (`ag-ui-chat:*`) keys into it once, so an existing conversation survives the
- * upgrade; the default empty namespace keeps the legacy origin-global keys.
+ * An optional `namespace` scopes every key to one element, so two
+ * `<ag-ui-chat>` instances on the same origin keep separate active-thread
+ * pointers and drawer indexes instead of clobbering each other. The default
+ * empty namespace keeps the origin-global keys; see {@link #migrateLegacyKeys}.
  */
 export declare class SessionStorageStore implements ClientConversationStore {
     #private;

package/dist/core/conversation_store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation_store.d.ts","sourceRoot":"","sources":["../../src/core/conversation_store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,QAAQ,IAAI,MAAM,CAAC;IACnB,sEAAsE;IACtE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACnE,8EAA8E;IAC9E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC;IACnE,0EAA0E;IAC1E,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAAC;IAC9D,4EAA4E;IAC5E,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAAC;IAChF,+EAA+E;IAC/E,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,+EAA+E;IAC/E,WAAW,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;IAC9C,4EAA4E;IAC5E,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,gEAAgE;IAChE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrD;AAqBD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAoB,YAAW,uBAAuB;;IAGjE,YAAY,SAAS,SAAK,EAKzB;IAED,QAAQ,IAAI,MAAM,CASjB;IAED,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC,CAEjE;IAED,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAGjE;IAED,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAE5D;IAED,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAO9E;IAED,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAU5B;IAED,WAAW,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAK5C;IAED,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEtC;IAED,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CASlD;CAwFF"}
+{"version":3,"file":"conversation_store.d.ts","sourceRoot":"","sources":["../../src/core/conversation_store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,QAAQ,IAAI,MAAM,CAAC;IACnB,sEAAsE;IACtE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACnE,8EAA8E;IAC9E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC;IACnE,0EAA0E;IAC1E,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAAC;IAC9D,4EAA4E;IAC5E,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAAC;IAChF,+EAA+E;IAC/E,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,+EAA+E;IAC/E,WAAW,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;IAC9C,4EAA4E;IAC5E,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,gEAAgE;IAChE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrD;AAqBD;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,YAAW,uBAAuB;;IAGjE,YAAY,SAAS,SAAK,EAKzB;IAED,QAAQ,IAAI,MAAM,CASjB;IAED,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC,CAEjE;IAED,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAGjE;IAED,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAE5D;IAED,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAO9E;IAED,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAU5B;IAED,WAAW,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAK5C;IAED,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEtC;IAED,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CASlD;CAuFF"}

package/dist/core/create_http_agent.d.ts

@@ -6,20 +6,18 @@ export interface HttpAgentOptions {
     headers?: Record<string, string>;
     /**
      * Cookie policy for the run request, as `fetch`'s own `credentials` mode.
-     * Unset leaves the browser default (`same-origin`) alone — which sends **no**
-     * cookies when the agent endpoint is on a different origin (or a different
-     * subdomain) from the page. A cookie-authenticated cross-origin deployment
-     * needs `"include"` here, and a server that answers it with
-     * `Access-Control-Allow-Credentials: true` and a concrete origin.
+     * Unset leaves the browser default (`same-origin`), which sends no cookies
+     * to an agent endpoint on a different origin or subdomain. A
+     * cookie-authenticated cross-origin deployment needs `"include"` here plus a
+     * server answering with `Access-Control-Allow-Credentials: true` and a
+     * concrete origin.
      */
     credentials?: RequestCredentials;
     /**
-     * Live header source, re-read on **every** request. `HttpAgent` bakes the
-     * static `headers` into its constructor and the element caches the agent
-     * for the whole conversation — so a rotated token (CSRF, short-lived JWT)
-     * would otherwise never reach the agent endpoint and a long session 401s
-     * mid-conversation. When set, the fetch wrapper overlays these values on
-     * each call; `headers` still seeds the initial/static configuration.
+     * Live header source, re-read on every request, overlaid on `headers`.
+     * `HttpAgent` bakes static `headers` in at construction and the element
+     * caches the agent for the whole conversation, so rotating credentials (CSRF,
+     * short-lived JWT) must come through here.
      */
     getHeaders?: () => Record<string, string>;
     /** Stable conversation id, so the agent's runs share a thread. */
@@ -34,11 +32,11 @@ export interface HttpAgentOptions {
     initialState?: Readonly<Record<string, unknown>>;
 }
 /**
- * Build an AG-UI {@link HttpAgent} pointed at ``endpoint``.
+ * Build an AG-UI {@link HttpAgent} pointed at `endpoint`.
  *
- * This is the default agent factory used by ``<ag-ui-chat>``. Tests and
- * advanced hosts override the element's ``agentFactory`` to inject a
- * different {@link AbstractAgent} (e.g. a fake, or a middleware-wrapped one).
+ * The default agent factory for `<ag-ui-chat>`; tests and advanced hosts
+ * override the element's `agentFactory` to inject a different
+ * {@link AbstractAgent}.
  */
 export declare function createHttpAgent(options: HttpAgentOptions): AbstractAgent;
 /** Signature of the agent factory the element calls to build its agent. */

package/dist/core/create_http_agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create_http_agent.d.ts","sourceRoot":"","sources":["../../src/core/create_http_agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,eAAe,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC;;;;OAIG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CA8BxE;AAED,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,aAAa,CAAC"}
+{"version":3,"file":"create_http_agent.d.ts","sourceRoot":"","sources":["../../src/core/create_http_agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,eAAe,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC;;;;OAIG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CA4BxE;AAED,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,aAAa,CAAC"}

package/dist/core/remote_conversation_store.d.ts

@@ -3,10 +3,9 @@ import { type ClientConversationStore, type NavigationCheckpoint, type ThreadMet
 /** Live header source, read per request so rotated tokens / CSRF reach the server. */
 type HeadersProvider = () => Record<string, string>;
 /**
- * Live cookie policy, read per request. A provider rather than a value because
- * the store is built once (on connect) and kept, while a host may configure the
- * element after inserting it — a captured value would pin whatever was set
- * during that first frame.
+ * Live cookie policy, read per request. A provider rather than a value: the
+ * store is built once on connect, but a host may configure the element after
+ * inserting it, and a captured value would pin that first frame's setting.
  */
 type CredentialsProvider = () => RequestCredentials | undefined;
 /**
@@ -19,11 +18,11 @@ type CredentialsProvider = () => RequestCredentials | undefined;
  * - `PATCH <url><id>/`  → rename (`{ "title": … }`);
  * - `DELETE <url><id>/` → delete.
  *
- * It wraps a local store (default {@link SessionStorageStore}) for the
- * client-only concerns — the active thread id, the navigation checkpoint, and a
- * message cache — and as the graceful fallback when a request fails. Rename and
- * delete apply **optimistically** (a small local overlay) so the drawer
- * reflects them at once, before the fire-and-forget server round-trip lands.
+ * Wraps a local store (default {@link SessionStorageStore}) for the client-only
+ * concerns — active thread id, navigation checkpoint, message cache — and as
+ * the fallback when a request fails. Rename and delete apply optimistically via
+ * a local overlay, so the drawer reflects them before the fire-and-forget
+ * round-trip lands.
  */
 export declare class RemoteConversationStore implements ClientConversationStore {
     #private;

package/dist/core/remote_conversation_store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote_conversation_store.d.ts","sourceRoot":"","sources":["../../src/core/remote_conversation_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EAEzB,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAWjC,sFAAsF;AACtF,KAAK,eAAe,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,KAAK,mBAAmB,GAAG,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAEhE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,uBAAwB,YAAW,uBAAuB;;IAQrE,YACE,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,eAA4B,EACrC,KAAK,GAAE,uBAAmD,EAC1D,WAAW,GAAE,mBAAqC,EAMnD;IAED,QAAQ,IAAI,MAAM,CAEjB;IAED,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEtC;IAED,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAGjE;IAED,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAE5D;IAED,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAE9E;IAED,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIlD;IAED,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI5B;IAEK,WAAW,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAMlD;IAEK,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC,CAavE;CAoEF"}
+{"version":3,"file":"remote_conversation_store.d.ts","sourceRoot":"","sources":["../../src/core/remote_conversation_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EAEzB,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAWjC,sFAAsF;AACtF,KAAK,eAAe,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD;;;;GAIG;AACH,KAAK,mBAAmB,GAAG,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAEhE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,uBAAwB,YAAW,uBAAuB;;IAQrE,YACE,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,eAA4B,EACrC,KAAK,GAAE,uBAAmD,EAC1D,WAAW,GAAE,mBAAqC,EAMnD;IAED,QAAQ,IAAI,MAAM,CAEjB;IAED,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEtC;IAED,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAGjE;IAED,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAE5D;IAED,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAE9E;IAED,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIlD;IAED,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI5B;IAEK,WAAW,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAMlD;IAEK,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC,CAavE;CAoEF"}

package/dist/core/run_index.d.ts

@@ -9,12 +9,7 @@ export interface RunRow {
 }
 /** Live header source, read per request so rotated tokens / CSRF reach the server. */
 type HeadersProvider = () => Record<string, string>;
-/**
- * Live cookie policy, read per request. A provider rather than a value because
- * the index is built once (on connect) and kept, while a host may configure the
- * element after inserting it — a captured value would pin whatever was set
- * during that first frame.
- */
+/** Live cookie policy, read per request; see `RemoteConversationStore`'s note. */
 type CredentialsProvider = () => RequestCredentials | undefined;
 /**
  * Reads the server's run index and derives the resume / fork URLs beside it.
@@ -24,26 +19,22 @@ type CredentialsProvider = () => RequestCredentials | undefined;
  *
  * - `GET <url>` → the user's runs, newest first.
  *
- * **Only `continuable` rows can be resumed.** The server reports whether a run
- * has a saved snapshot to seed from; a run that never reached a provider-valid
- * boundary has none, so resuming it would start from nothing. Callers should
- * offer the action only for those rows and treat the rest as informational — a
- * crashed run worth showing, not worth continuing. {@link continuable} filters
- * for exactly that.
+ * Only `continuable` rows can be resumed: the server reports whether a run has
+ * a saved snapshot to seed from, and a run that never reached a provider-valid
+ * boundary has none. Offer the action only for those rows ({@link continuable}
+ * filters them) and treat the rest as informational.
  *
- * **Resume and fork are siblings of the index**, not separate configuration.
- * django-ag-ui mounts all three under one prefix whenever a step store is
- * configured (`runs/`, `resume/<id>/`, `fork/<id>/`), so one URL locates them
- * all and there is no way to configure a half-working set.
+ * Resume and fork are siblings of the index rather than separate configuration
+ * — django-ag-ui mounts `runs/`, `resume/<id>/` and `fork/<id>/` under one
+ * prefix — so this one URL locates all three.
  */
 export declare class RunIndex {
     #private;
     constructor(url: string, headers?: HeadersProvider, credentials?: CredentialsProvider);
     /**
-     * The user's runs, or `[]` when the endpoint is unreachable or answers with
-     * an error. A history affordance that cannot load is empty, never broken:
-     * the caller renders its empty state rather than surfacing a transport fault
-     * the user can do nothing about.
+     * The user's runs, or `[]` when the endpoint is unreachable or errors — the
+     * caller renders its empty state rather than a transport fault the user can
+     * do nothing about.
      */
     list(): Promise<readonly RunRow[]>;
     /** The rows a client may actually continue. */

package/dist/core/run_index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run_index.d.ts","sourceRoot":"","sources":["../../src/core/run_index.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,sFAAsF;AACtF,KAAK,eAAe,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,KAAK,mBAAmB,GAAG,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,QAAQ;;IAKnB,YACE,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,eAA4B,EACrC,WAAW,GAAE,mBAAqC,EAKnD;IAED;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAoBvC;IAED,+CAA+C;IACzC,WAAW,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAE9C;IAED,wDAAwD;IACxD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/B;IAED,uFAAuF;IACvF,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7B;CAaF"}
+{"version":3,"file":"run_index.d.ts","sourceRoot":"","sources":["../../src/core/run_index.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,sFAAsF;AACtF,KAAK,eAAe,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD,kFAAkF;AAClF,KAAK,mBAAmB,GAAG,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAEhE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,QAAQ;;IAKnB,YACE,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,eAA4B,EACrC,WAAW,GAAE,mBAAqC,EAKnD;IAED;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAoBvC;IAED,+CAA+C;IACzC,WAAW,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAE9C;IAED,wDAAwD;IACxD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/B;IAED,uFAAuF;IACvF,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7B;CAaF"}

package/dist/core/transcribe_audio.d.ts

@@ -1,9 +1,9 @@
 /**
  * The composer's voice-transcription contract: take a recorded audio `Blob` and
- * resolve to the transcript text. The built-in handler is {@link transcribeAudio}
- * (multipart POST to `data-transcribe-url`); a host swaps in its own — e.g. a
- * browser Web Speech adapter or a direct-to-provider call — via
- * `AgUiChat.transcribeHandler`, without touching the mic button.
+ * resolve to the transcript text. The built-in handler is
+ * {@link transcribeAudio}; a host swaps in its own (a Web Speech adapter, a
+ * direct-to-provider call) via `AgUiChat.transcribeHandler` without touching
+ * the mic button.
  */
 export type TranscribeHandler = (audio: Blob) => Promise<string>;
 /** Options for {@link transcribeAudio}. */
@@ -23,10 +23,10 @@ export interface TranscribeOptions {
 /**
  * POST a recorded clip to the transcription endpoint and resolve to its text.
  *
- * The clip is sent as multipart under the `audio` field with the element's
- * `headers`, mirroring {@link uploadAttachment}; the server replies
- * `{ "text": "<transcript>" }`. A non-2xx response or a network error rejects so
- * the mic button can surface the failure.
+ * The clip goes as multipart under the `audio` field with the element's
+ * `headers`, mirroring {@link uploadAttachment}, and the server replies
+ * `{ "text": "<transcript>" }`. A non-2xx response or a network error rejects
+ * so the mic button can surface the failure.
  */
 export declare function transcribeAudio(audio: Blob, options: TranscribeOptions): Promise<string>;
 //# sourceMappingURL=transcribe_audio.d.ts.map

package/dist/core/transcribe_audio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transcribe_audio.d.ts","sourceRoot":"","sources":["../../src/core/transcribe_audio.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEjE,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAC3C;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6B9F"}
+{"version":3,"file":"transcribe_audio.d.ts","sourceRoot":"","sources":["../../src/core/transcribe_audio.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEjE,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAC3C;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4B9F"}

package/dist/core/upload_attachment.d.ts

@@ -2,16 +2,13 @@ import type { AttachmentRef } from "./attachment.js";
 /**
  * The composer's upload contract: take a `File`, report `0..1` progress, and
  * resolve to a durable {@link AttachmentRef}. The built-in handler is
- * {@link uploadAttachment} (multipart POST); a host swaps in its own — e.g. a
- * `tus-js-client` or direct-to-S3 adapter — via `AgUiChat.uploadHandler`,
- * **without** touching the tray, the chips, or the AG-UI wire (refs are
- * transport-agnostic).
+ * {@link uploadAttachment}; a host swaps in its own (a `tus-js-client` or
+ * direct-to-S3 adapter) via `AgUiChat.uploadHandler` without touching the tray,
+ * the chips, or the AG-UI wire, refs being transport-agnostic.
  *
- * The optional third `signal` argument lets the tray abort an in-flight upload
- * when its chip is removed (or the element is torn down), so a cancelled upload
- * doesn't orphan a server-side file. It is non-breaking: existing two-argument
- * handlers keep working (the extra argument is simply ignored), and a custom
- * handler that honours it should abort its own transport when the signal fires.
+ * The optional `signal` fires when the tray removes a chip or the element is
+ * torn down; a handler that honours it should abort its own transport, so a
+ * cancelled upload doesn't orphan a server-side file.
  */
 export type UploadHandler = (file: File, onProgress: (fraction: number) => void, signal?: AbortSignal) => Promise<AttachmentRef>;
 /** Options for {@link uploadAttachment}. */
@@ -22,11 +19,11 @@ export interface UploadOptions {
     readonly headers?: Record<string, string>;
     /**
      * Cookie policy, spelled as `fetch`'s `credentials` mode for consistency with
-     * the component's other endpoints — but carried by `XMLHttpRequest`, which
-     * only has the two-state `withCredentials`. `"include"` sets it; every other
-     * value leaves it off, which matches `"same-origin"`. `"omit"` therefore
-     * **cannot** be honoured for a same-origin upload (XHR always sends cookies
-     * there); use a custom {@link UploadHandler} if that matters.
+     * the other endpoints, but carried by `XMLHttpRequest`'s two-state
+     * `withCredentials`: `"include"` sets it and every other value leaves it off,
+     * matching `"same-origin"`. `"omit"` therefore cannot be honoured for a
+     * same-origin upload, XHR always sending cookies there; use a custom
+     * {@link UploadHandler} if that matters.
      */
     readonly credentials?: RequestCredentials;
     /** Progress callback, `0..1`, fired as the body uploads. */
@@ -38,10 +35,10 @@ export interface UploadOptions {
  * Upload one file to the attachments endpoint and resolve to its durable
  * {@link AttachmentRef}.
  *
- * Uses `XMLHttpRequest` (not `fetch`) for real upload-progress events: the file
- * is sent as multipart under the `file` field, with the element's `headers` so
- * CSRF / auth ride along exactly like the skills/tools fetches. A non-2xx
- * response or a network/abort error rejects, so the tray can show an error chip.
+ * Uses `XMLHttpRequest` rather than `fetch` for real upload-progress events.
+ * The file goes as multipart under the `file` field with the element's
+ * `headers`, so CSRF / auth ride along; a non-2xx response or a network/abort
+ * error rejects, letting the tray show an error chip.
  */
 export declare function uploadAttachment(file: File, options: UploadOptions): Promise<AttachmentRef>;
 //# sourceMappingURL=upload_attachment.d.ts.map

package/dist/core/upload_attachment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload_attachment.d.ts","sourceRoot":"","sources":["../../src/core/upload_attachment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EACtC,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CA6C3F"}
+{"version":3,"file":"upload_attachment.d.ts","sourceRoot":"","sources":["../../src/core/upload_attachment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EACtC,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CA6C3F"}

package/dist/core/utils.d.ts

@@ -1,12 +1,10 @@
 /**
  * Overlay a `credentials` mode onto a fetch `init`, or hand the `init` back
- * untouched when the caller has none configured.
+ * untouched when none is configured.
  *
- * Absent and `undefined` are not the same thing here. `exactOptionalPropertyTypes`
- * rejects an explicit `credentials: undefined`, and writing one anyway would
- * state a mode where the point is to leave the browser's own default in place.
- * Every fetch this component makes has to make that choice, so it is made in one
- * place rather than repeated (and eventually forgotten) at each call site.
+ * Absent and `undefined` differ: `exactOptionalPropertyTypes` rejects an
+ * explicit `credentials: undefined`, and writing one anyway would state a mode
+ * where the point is to leave the browser's own default in place.
  */
 export declare function withCredentials(init: RequestInit | undefined, credentials: RequestCredentials | undefined): RequestInit | undefined;
 //# sourceMappingURL=utils.d.ts.map

package/dist/core/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,WAAW,EAAE,kBAAkB,GAAG,SAAS,GAC1C,WAAW,GAAG,SAAS,CAEzB"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,WAAW,EAAE,kBAAkB,GAAG,SAAS,GAC1C,WAAW,GAAG,SAAS,CAEzB"}