@artooi/ag-ui-web-component 0.38.0 → 0.40.0

package/dist/ui/history/conversation_history.d.ts

@@ -0,0 +1,203 @@
+import type { Message } from "@ag-ui/core";
+import type { ActivityRegistry } from "../../core/activity_registry.js";
+import type { AgUiClient } from "../../core/agui_client.js";
+import type { ClientSeed } from "../../core/client_seed.js";
+import type { ClientConversationStore, NavigationCheckpoint } from "../../core/conversation_store.js";
+import type { MessageRole } from "../../core/message_role.js";
+import { RunIndex } from "../../core/run_index.js";
+import type { ToolCatalog } from "../../tools/tool_catalog.js";
+import type { AnswerActions } from "../transcript/answer_actions.js";
+import type { Transcript } from "../transcript/transcript.js";
+import type { UiStrings } from "../ui_strings.js";
+import type { CheckpointMenu, CheckpointVerb } from "./checkpoint_menu.js";
+import type { RelativeTimeFormatter } from "./relative_time.js";
+import type { ThreadDrawer } from "./thread_drawer.js";
+/** What conversation history needs from the element that owns it. */
+export interface ConversationHistoryHost {
+    /**
+     * The custom element: the attributes history reads and stamps, and the
+     * `this` a host's `agentFactory` and `navigationResult` are called with.
+     */
+    readonly element: HTMLElement;
+    /** The conversation list, which the element builds and renders. */
+    readonly drawer: ThreadDrawer;
+    /** The checkpoint panel, which the element builds and renders. */
+    readonly checkpoints: CheckpointMenu;
+    /** The transcript a restored conversation is replayed into. */
+    readonly transcript: Transcript;
+    /** The action row under each finished answer. */
+    readonly actions: AnswerActions;
+    /** The activity renderers, which redraw a restored activity. */
+    readonly activities: ActivityRegistry;
+    /** The frontend tools, whose renderers a restored call is redrawn with. */
+    readonly tools: ToolCatalog;
+    /** The composer, whose text a continuation sends. */
+    readonly input: HTMLTextAreaElement;
+    /** The one-line hint above the composer. */
+    readonly hint: HTMLDivElement;
+    /** The resolved string table. */
+    readonly strings: () => UiStrings;
+    /** The element's `conversationStore`, read per use. */
+    readonly conversationStore: () => ClientConversationStore;
+    /** The element's `formatRelativeTime`. */
+    readonly formatRelativeTime: () => RelativeTimeFormatter | null;
+    /** The element's `navigationResult`. */
+    readonly navigationResult: () => (checkpoint: NavigationCheckpoint) => unknown;
+    /** The request headers, having first reported the destination if it is foreign. */
+    readonly headersFor: (url: string) => Record<string, string>;
+    /** The configured cookie policy as `fetch` spells it. */
+    readonly requestCredentials: () => RequestCredentials | undefined;
+    /** The element's `appendMessage`, which a restored bubble opens through. */
+    readonly appendMessage: (role: MessageRole, content: string) => HTMLDivElement;
+    /** Resize the composer to its content. */
+    readonly autoGrow: () => void;
+    /**
+     * A continuation has ended, whether or not it ever ran.
+     *
+     * The composer parks a turn typed while one is in flight, and learns a run
+     * has settled from its own events -- which never arrive for a continuation
+     * that failed before starting one. Without this, such a turn stayed parked
+     * with nothing left to release it.
+     */
+    readonly continuationEnded: () => void;
+    /** The conversation's own client, or `null` until one is built. */
+    readonly client: () => AgUiClient | null;
+    /** The conversation's own client, built on first use. */
+    readonly ensureClient: () => AgUiClient;
+    /**
+     * A client from the same construction as the conversation's own, differing
+     * only in what `seed` says. A continuation's comes from here so that nothing
+     * added to one can be missing from the other.
+     */
+    readonly buildClient: (seed: ClientSeed) => AgUiClient;
+    /**
+     * Forget the conversation's own client, so the next one is built from
+     * {@link ConversationHistory.restored}. Nothing is cancelled: this is for a
+     * client that is not running.
+     */
+    readonly releaseClient: () => void;
+    /** Whether an interaction is in flight, which the composer owns. */
+    readonly running: () => boolean;
+    /** Stop the in-flight run. */
+    readonly cancelRun: () => void;
+    /** Drop the in-memory run and transcript, leaving the thread untouched. */
+    readonly resetState: () => void;
+    /** Swap the composer between Send and Stop, which the composer owns. */
+    readonly setRunning: (running: boolean) => void;
+}
+/**
+ * Which conversation is on screen, and how one gets there: restoring it from
+ * the store, switching to another from the conversation list, and continuing
+ * a run from the checkpoint panel.
+ *
+ * The one writer of the active thread's id and of the messages a restore
+ * seeded the next client with. The element reads both when it builds its
+ * client, and asks for a transition -- adopt the store's thread, mint a new
+ * one -- rather than writing either. Clearing the run, the transcript and the
+ * composer around a transition stays the element's, because it spans every
+ * part of it; history calls back for that.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance.
+ */
+export declare class ConversationHistory {
+    #private;
+    constructor(host: ConversationHistoryHost);
+    /** The active thread's id. */
+    get threadId(): string;
+    /** The conversation as last written, for seeding the next client. */
+    get restored(): readonly Message[];
+    /** The checkpoint continuation in flight, or `null` when none is running. */
+    get continuation(): AgUiClient | null;
+    /** Point at the thread the store says is active. */
+    adoptActiveThread(): void;
+    /** Make a freshly minted thread the active one. */
+    startThread(): void;
+    /**
+     * Stop the checkpoint continuation in flight, if there is one.
+     *
+     * A continuation runs on a client of its own, which the element never held,
+     * so Stop cancelled the conversation's client and left this one streaming:
+     * the button read Stop and did nothing, and New chat, a thread switch or
+     * removing the element carried on drawing the resumed answer into whatever
+     * came next. The element calls this wherever it stops its own run.
+     */
+    stopContinuation(): void;
+    /** Forget the messages the last restore seeded, with the rest of the run. */
+    forgetRestored(): void;
+    /** Delete the active thread if nothing was ever sent in it. */
+    reapUnsent(): void;
+    /** The run index, built once from `data-runs-url`; `null` when unset. */
+    runs(): RunIndex | null;
+    /** Open the conversation list, dismissing the checkpoint panel. */
+    openThreads(): void;
+    /** Open the checkpoint panel, dismissing the conversation list. */
+    openCheckpoints(): void;
+    /** Switch the active conversation to an existing thread and replay it. */
+    switchThread(threadId: string): Promise<void>;
+    /** Rename a thread, then reload the list that shows its title. */
+    renameThread(threadId: string, title: string): void;
+    /** Delete a thread; if it was the active one, fall back to a fresh chat. */
+    deleteThread(threadId: string): void;
+    /** Reload the drawer's thread list, marking the active thread. */
+    refreshDrawer(): Promise<void>;
+    /**
+     * Continue `runId` as a **new** run, seeded server-side from its snapshot.
+     *
+     * Uses a short-lived agent pointed at the resume / fork endpoint and seeded
+     * with no history, because those endpoints supply the prior turns from the
+     * snapshot and re-sending them would duplicate. A separate agent makes that
+     * structural and mints the fresh `run_id` the endpoints also require.
+     *
+     * Built by the same construction as the conversation's own client, so the
+     * continuation streams into the same transcript the user is looking at and
+     * runs under the same state, tools and bounds. It is the run in flight while
+     * it lasts: {@link stopContinuation} is how the element's Stop reaches it.
+     *
+     * What it adds joins the conversation. Its saves write the conversation on
+     * screen ahead of its exchange, and each one hands that whole list to the
+     * next client the element builds, so the next ordinary message is sent with
+     * the exchange it follows. The conversation's own client never held it, and
+     * was sending without it.
+     */
+    continueRun(runId: string, verb: CheckpointVerb): Promise<void>;
+    /**
+     * Restore the conversation from the store on mount, then — if a navigating
+     * tool reloaded the page mid-run — resume the loop by supplying that tool's
+     * result from the page we landed on.
+     *
+     * Any other call the stored run left unanswered is answered on the way in, as
+     * not finished, because no run is left to answer it.
+     *
+     * **What the store holds after a reload mid-run.** The run loop persists a
+     * round when its stream ends, which is *before* it asks about a gated call,
+     * runs a frontend tool, or collects a server-side approval. A reload in that
+     * window leaves the round's calls stored with no result, and the request that
+     * would have produced one died with the page.
+     *
+     * **Why not finished, and not declined.** Stop declines an open card because
+     * pressing it is a person answering the question. A reload answers nothing, and
+     * the stored shape is the same whether the round waited on a person or on a
+     * handler the reload killed, so declined would be unproven for the first and
+     * false for the second. A marker saved while a card is open could tell them
+     * apart, but every host store would have to round-trip it, and a store that
+     * dropped it would fall back to this wording anyway -- which is true of both.
+     *
+     * The answers come from the same helper the client runs before each request,
+     * so a restored card and the result the next request carries cannot disagree.
+     * Giving them to the replay, rather than leaving the client to add them, is
+     * what settles each card from its result. The checkpointed call is excluded,
+     * because the resume path answers it from the page the reload landed on; that
+     * exclusion is held by "still resumes with the landed page's result, and is not
+     * declined" in `ag_ui_chat_reload_mid_run.test.ts`.
+     */
+    rehydrate(): Promise<void>;
+    /**
+     * Replay a restored message: text bubbles *and* tool activity. An assistant
+     * turn may carry `toolCalls` (rendered as cards) and/or text; a `tool` turn
+     * carries a result that settles the matching card. So a refreshed page shows
+     * the full transcript — tool calls and their results — not just the prose.
+     */
+    replay(message: Message): void;
+}
+//# sourceMappingURL=conversation_history.d.ts.map

package/dist/ui/history/conversation_history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation_history.d.ts","sourceRoot":"","sources":["../../../src/ui/history/conversation_history.ts"],"names":[],"mappings":"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"}

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

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

package/dist/ui/history/thread_drawer.d.ts

@@ -18,15 +18,6 @@ export interface ThreadDrawerCallbacks {
     readonly onRename: (threadId: string, title: string) => void;
     /** A row was deleted (after the inline confirm). */
     readonly onDelete: (threadId: string) => void;
-    /**
-     * The list opened or closed.
-     *
-     * There are five ways out of it -- the close control, the backdrop, Escape,
-     * picking a row and starting a new chat -- and only two of them go through
-     * the host. A docked list moves the transcript over, so the host has to know
-     * about all five or the transcript stays shifted around nothing.
-     */
-    readonly onVisibility?: (open: boolean) => void;
 }
 /**
  * The chat-history drawer: a slide-over listing the user's threads (title,
@@ -56,11 +47,6 @@ export declare class ThreadDrawer {
      */
     setRelativeTimeFormatter(format: RelativeTimeFormatter | null): void;
     setStrings(strings: UiStrings): void;
-    /**
-     * Whether the list is a dialog over the conversation or a rail beside it.
-     * The host decides, because only the placement knows whether there is room.
-     */
-    setModal(modal: boolean): void;
     isOpen(): boolean;
     open(): void;
     close(): void;

package/dist/ui/history/thread_drawer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"thread_drawer.d.ts","sourceRoot":"","sources":["../../../src/ui/history/thread_drawer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,KAAK,qBAAqB,EAAgB,MAAM,oBAAoB,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,sEAAsE;AACtE,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7D,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACjD;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY;;IACvB,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAgCjC,YAAY,SAAS,EAAE,qBAAqB,EAAE,OAAO,GAAE,SAA8B,EA2EpF;IAED,iFAAiF;IACjF;;;;;;;OAOG;IACH,wBAAwB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAEnE;IASD,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAUnC;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAS7B;IAED,MAAM,IAAI,OAAO,CAEhB;IAED,IAAI,IAAI,IAAI,CAYX;IAED,KAAK,IAAI,IAAI,CAYZ;IAED,MAAM,IAAI,IAAI,CAMb;IAoCD,4EAA4E;IAC5E,UAAU,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIjE;CAqLF"}
+{"version":3,"file":"thread_drawer.d.ts","sourceRoot":"","sources":["../../../src/ui/history/thread_drawer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,KAAK,qBAAqB,EAAgB,MAAM,oBAAoB,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,sEAAsE;AACtE,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7D,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY;;IACvB,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAqBjC,YAAY,SAAS,EAAE,qBAAqB,EAAE,OAAO,GAAE,SAA8B,EA2EpF;IAED,iFAAiF;IACjF;;;;;;;OAOG;IACH,wBAAwB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAEnE;IASD,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAUnC;IAED,MAAM,IAAI,OAAO,CAEhB;IAED,IAAI,IAAI,IAAI,CASX;IAED,KAAK,IAAI,IAAI,CAOZ;IAED,MAAM,IAAI,IAAI,CAMb;IAgCD,4EAA4E;IAC5E,UAAU,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIjE;CAqLF"}

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

@@ -1 +1 @@
-{"version":3,"file":"confirmation_card.d.ts","sourceRoot":"","sources":["../../../src/ui/interrupts/confirmation_card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEtE,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;IACpB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,GAAG,UAAU,EACvB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,OAAO,CAAC,CAqElB"}
+{"version":3,"file":"confirmation_card.d.ts","sourceRoot":"","sources":["../../../src/ui/interrupts/confirmation_card.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEtE,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;IACpB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,GAAG,UAAU,EACvB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,OAAO,CAAC,CAsElB"}

package/dist/ui/interrupts/pending_decision.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The decision a run is suspended on, and the one way to abandon it.
+ *
+ * A run pauses on a person in three places -- a client-side confirmation, a
+ * batch of server interrupts, and the `ask_user` question -- and a Stop has to
+ * reach whichever of them is open. Each used to assign the element's own abort
+ * controller directly, so four places wrote one field and nothing said which
+ * of them owned it. Holding it here gives it one owner: a wait opens, the Stop
+ * aborts what is open, and the wait closes when it is answered.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance.
+ */
+export declare class PendingDecision {
+    #private;
+    /** Start waiting on a person; aborting the returned signal abandons the wait. */
+    open(): AbortSignal;
+    /** The wait was answered; a later Stop has nothing of this wait's to abandon. */
+    close(): void;
+    /** Abandon whatever wait is open, resolving it as declined. A no-op when none is. */
+    abort(): void;
+}
+//# sourceMappingURL=pending_decision.d.ts.map

package/dist/ui/interrupts/pending_decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending_decision.d.ts","sourceRoot":"","sources":["../../../src/ui/interrupts/pending_decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;;IAK1B,iFAAiF;IACjF,IAAI,IAAI,WAAW,CAGlB;IAED,iFAAiF;IACjF,KAAK,IAAI,IAAI,CAEZ;IAED,qFAAqF;IACrF,KAAK,IAAI,IAAI,CAEZ;CACF"}

package/dist/ui/placement/is_collapsible_placement.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Whether `placement` has a collapsed state at all.
+ *
+ * `page` does not. It is a dedicated route rather than a panel sitting on
+ * someone else's page, so there is no "away" for it to go to: collapsing it
+ * left a strip of application chrome fixed over a route that no longer had an
+ * owner. It is also the placement that hides the launcher, so the usual way
+ * back does not exist here.
+ *
+ * The header hides its collapse control under this placement, but a control
+ * removed from the UI is not a state removed from the model -- the property,
+ * the attribute and a value restored from storage all still reach it. This is
+ * what the reachable paths are gated on; the stylesheet covers the one path
+ * that never passes through here, an attribute written straight onto the
+ * element.
+ */
+export declare function isCollapsiblePlacement(placement: string | null): boolean;
+//# sourceMappingURL=is_collapsible_placement.d.ts.map

package/dist/ui/placement/is_collapsible_placement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_collapsible_placement.d.ts","sourceRoot":"","sources":["../../../src/ui/placement/is_collapsible_placement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAExE"}

package/dist/ui/placement/is_draggable_placement.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Whether `placement` is one whose launcher can be dragged.
+ *
+ * Asked by two owners: the placement, deciding whether a gesture may move the
+ * widget, and the element, deciding whether a first mount starts collapsed --
+ * the corner placements are the two with a launcher to collapse to.
+ */
+export declare function isDraggablePlacement(placement: string | null): boolean;
+//# sourceMappingURL=is_draggable_placement.d.ts.map

package/dist/ui/placement/is_draggable_placement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_draggable_placement.d.ts","sourceRoot":"","sources":["../../../src/ui/placement/is_draggable_placement.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAEtE"}

package/dist/ui/placement/launcher_drag.d.ts

@@ -19,6 +19,12 @@ export interface LauncherDragOptions {
      * per pointer move, and never per key repeat.
      */
     readonly commit: (left: number, top: number) => void;
+    /**
+     * Ends the launcher's own listeners when aborted. The launcher outlives the
+     * element's connection to the document and this is called on every connect,
+     * so without it a re-inserted element moved one arrow press two steps.
+     */
+    readonly signal: AbortSignal;
 }
 /**
  * Let the user drag the collapsed launcher anywhere on screen.

package/dist/ui/placement/launcher_drag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launcher_drag.d.ts","sourceRoot":"","sources":["../../../src/ui/placement/launcher_drag.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAExE,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,WAAW,CAAC;IACjC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,WAAW,CAAC;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AAaD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAuI5F"}
+{"version":3,"file":"launcher_drag.d.ts","sourceRoot":"","sources":["../../../src/ui/placement/launcher_drag.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAExE,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,WAAW,CAAC;IACjC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,WAAW,CAAC;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAaD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAgJ5F"}

package/dist/ui/placement/panel_placement.d.ts

@@ -0,0 +1,119 @@
+import type { ChatCorner, ChatSurfaceReport } from "../../tools/chat_surface_tools.js";
+import type { UiStrings } from "../ui_strings.js";
+/**
+ * What the placement needs from the element that owns it.
+ *
+ * Everything the element keeps private is reached through a thunk here, the
+ * same shape `PanelDragOptions` and `ResizeOptions` already give their hosts:
+ * read per call, so a value the element replaces later (the resolved string
+ * table, the connected flag) is never captured stale.
+ */
+export interface PlacementHost {
+    /** The custom element itself: its inline style, attributes and box. */
+    readonly element: HTMLElement;
+    /** The collapsed widget's button, which a drag moves and a resize carries. */
+    readonly launcher: HTMLButtonElement;
+    /** The shadow root, searched for a header mid-drag. */
+    readonly root: ShadowRoot;
+    /** Whether the element is in the document. */
+    readonly connected: () => boolean;
+    /** Whether the widget is collapsed. */
+    readonly collapsed: () => boolean;
+    /** Whether the current placement has a collapsed state at all. */
+    readonly collapsible: () => boolean;
+    /** The resolved string table. */
+    readonly strings: () => UiStrings;
+    /** Read a layout preference, durable store first. */
+    readonly readPreference: (base: string) => string | null;
+    /** Persist a layout preference to both stores. */
+    readonly writePreference: (base: string, value: string) => void;
+    /** Drop a layout preference from both stores. */
+    readonly clearPreference: (base: string) => void;
+    /** Tell the reader the agent moved their window, with the way back. */
+    readonly announceSurfaceChange: (text: string, undo: () => void) => void;
+}
+/**
+ * Where the panel and its launcher sit, and how big the panel is: the dragged
+ * launcher, the dragged header, the eight resize grips, the corner the panel
+ * opens from, and the persisted record of all of it.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance, so two elements on a page place themselves independently.
+ */
+export declare class PanelPlacement {
+    #private;
+    constructor(host: PlacementHost);
+    /**
+     * Make the header a title bar. Only while open: a collapsed widget has no
+     * header on screen, and the launcher is the handle then.
+     */
+    enablePanelDrag(header: HTMLElement): void;
+    /**
+     * Let the launcher be dragged. Only while collapsed: the launcher is scaled
+     * away and unclickable behind the open panel, so a drag there would move
+     * something nobody can see.
+     */
+    enableLauncherDrag(signal: AbortSignal): void;
+    /** Build the eight resize grips into `chat`, with one of them in the tab order. */
+    mountResizeGrips(chat: HTMLElement): void;
+    /** Restore a dragged size before the panel paints. */
+    restoreSize(): void;
+    /**
+     * A zero-sized box carrying the host's viewport insets as padding, so they
+     * can be read back as used pixel lengths. See the `.viewport-probe` rule for
+     * why a custom property cannot be read directly.
+     */
+    readonly probe: HTMLDivElement;
+    /**
+     * Whether a pointer or key gesture is currently placing the widget.
+     *
+     * Read from the stamp the drag helpers already set, rather than tracked
+     * separately: one source of truth, and it clears on `pointercancel` as well
+     * as `pointerup`, which is the end a touch gesture usually gets.
+     */
+    dragging(): boolean;
+    /** The report behind `AgUiChat.describeSurface`, whose doc is the contract. */
+    describeSurface(): ChatSurfaceReport;
+    /** The move behind `AgUiChat.moveTo`, whose doc is the contract. */
+    moveTo(corner: ChatCorner, options?: {
+        readonly announce?: boolean;
+    }): boolean;
+    /** Stamp the measured anchor so the shadow CSS can place the grip. */
+    syncResizeAnchor(): void;
+    /**
+     * Drop any dragged size the new placement has taken ownership of.
+     *
+     * Without this a size survives the switch as an inline property and silently
+     * overrides the placement it moved to — the panel keeps a floating height
+     * while docked, and reads as a component that cannot do full height.
+     */
+    releaseOwnedAxes(): void;
+    /**
+     * Publish the measured viewport height so the stylesheet can size a
+     * full-bleed panel to what the user can see.
+     *
+     * No CSS length carries this. An on-screen keyboard has no effect on any
+     * viewport-percentage unit, so a panel sized from `100dvh` puts its composer
+     * behind the keyboard being typed into. Written inline, and read through a
+     * token the host's own `--ag-ui-viewport-height` still outranks.
+     *
+     * Removed rather than frozen when the two viewports agree, so a desktop that
+     * never diverges carries no inline override at all and the declared fallback
+     * stays in charge.
+     */
+    publishVisualViewport(): void;
+    /**
+     * Re-apply the dragged position against the current viewport: on connect,
+     * whenever the window resizes, and before an expand. The viewport that
+     * stored a position may since have shrunk, and a launcher past the edge is
+     * unreachable -- it is the only way back to a collapsed conversation.
+     */
+    restoreLauncherPosition(): void;
+    /**
+     * Give the position back to the host when the new placement owns it, the way
+     * releaseOwnedAxes gives back a size. Without this a dragged inset survives
+     * the switch inline and pins a sidebar to wherever the floating launcher was.
+     */
+    releaseLauncherPosition(): void;
+}
+//# sourceMappingURL=panel_placement.d.ts.map

package/dist/ui/placement/panel_placement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel_placement.d.ts","sourceRoot":"","sources":["../../../src/ui/placement/panel_placement.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAmFlD;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC;IAClC,uCAAuC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC;IAClC,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC;IACpC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACzD,kDAAkD;IAClD,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,iDAAiD;IACjD,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,uEAAuE;IACvE,QAAQ,CAAC,qBAAqB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CAC1E;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;;IAGzB,YAAY,IAAI,EAAE,aAAa,EAE9B;IAED;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAOzC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAS5C;IAED,mFAAmF;IACnF,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAqBxC;IAED,sDAAsD;IACtD,WAAW,IAAI,IAAI,CAElB;IAED;;;;OAIG;IACH,QAAQ,CAAC,KAAK,iBAAiC;IAqE/C;;;;;;OAMG;IACH,QAAQ,IAAI,OAAO,CAKlB;IAED,+EAA+E;IAC/E,eAAe,IAAI,iBAAiB,CAwBnC;IAED,oEAAoE;IACpE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CA2CjF;IAmID,sEAAsE;IACtE,gBAAgB,IAAI,IAAI,CAYvB;IA0CD;;;;;;OAMG;IACH,gBAAgB,IAAI,IAAI,CAQvB;IAsFD;;;;;;;;;;;;OAYG;IACH,qBAAqB,IAAI,IAAI,CAgD5B;IA8PD;;;;;OAKG;IACH,uBAAuB,IAAI,IAAI,CAmB9B;IAiCD;;;;OAIG;IACH,uBAAuB,IAAI,IAAI,CAU9B;CAwGF"}

package/dist/ui/progress/run_announcer.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The screen-reader-only status region, and the one short thing it says at a
+ * time about how a run is going.
+ *
+ * The transcript cannot do this job. It is rewritten on every animation frame
+ * while an answer streams, so as a live region it re-announced the whole
+ * answer tens of times per turn -- not merely unhelpful but actively hostile.
+ * The published fix for this exact bug (Microsoft's Bot Framework WebChat
+ * #3236) is architectural rather than a matter of tuning attributes: demote the
+ * visible transcript out of live-region duty and put one synthesised status per
+ * event into a separate invisible region. MDN and Scott O'Hara prescribe the
+ * same empty-region-then-inject shape.
+ *
+ * Roughly four calls land per turn -- responding, answered, a card is waiting,
+ * stopped or failed -- so the user is told what happened and reads the answer
+ * itself by navigating the log, at their own pace, rather than having it
+ * shouted at them a token at a time.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance. The element places {@link region} in its shadow root.
+ */
+export declare class RunAnnouncer {
+    #private;
+    /** The invisible `role="status"` region the statuses are written into. */
+    readonly region: HTMLDivElement;
+    /** Stamp the region's live-region semantics, before the element places it. */
+    mount(): void;
+    /**
+     * Say one short thing to a screen reader, without touching the transcript.
+     *
+     * **The clear is load-bearing, twice.** A reader announces a live region when
+     * its content *changes*, so setting the same string twice running -- two turns
+     * in a row both starting -- is not a change and is silently not announced.
+     * Emptying first makes the next set a change again. It also stops a stale
+     * status being read out when a reader later lands on the region.
+     */
+    announce(message: string): void;
+    /** Cancel a pending clear, so no timer outlives the element's connection. */
+    dispose(): void;
+}
+//# sourceMappingURL=run_announcer.d.ts.map

package/dist/ui/progress/run_announcer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run_announcer.d.ts","sourceRoot":"","sources":["../../../src/ui/progress/run_announcer.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAY;;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,iBAAiC;IAIhD,8EAA8E;IAC9E,KAAK,IAAI,IAAI,CAOZ;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAS9B;IAED,6EAA6E;IAC7E,OAAO,IAAI,IAAI,CAKd;CACF"}

package/dist/ui/progress/subagent_progress.d.ts

@@ -0,0 +1,58 @@
+import type { UiStrings } from "../ui_strings.js";
+import type { ToolCallCard } from "./tool_call_card.js";
+/** What delegated progress needs from the element that owns it. */
+export interface SubAgentProgressHost {
+    /** The tool card drawn for a call id, which a delegation's panel hangs off. */
+    readonly card: (callId: string) => ToolCallCard | undefined;
+    /** The resolved string table. */
+    readonly strings: () => UiStrings;
+    /** Keep the transcript at its foot, if the reader is there. */
+    readonly follow: () => void;
+}
+/**
+ * A delegated sub-agent's progress, hung off the card that delegated: the live
+ * panels by delegation, and which delegation each child run belongs to.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance.
+ */
+export declare class SubAgentProgress {
+    #private;
+    constructor(host: SubAgentProgressHost);
+    /**
+     * Draw one step of a delegated sub-agent's progress, on the card that
+     * delegated.
+     *
+     * `delegationId` is the parent's own `delegate_task` tool-call id, so the
+     * attachment point is a card this element already drew on `TOOL_CALL_START`.
+     * That is the whole design: a run that hands work to a sub-agent used to read
+     * as a stall -- the card sat at "running…" for the child's entire duration --
+     * and the fix is to narrate *into* the thing that was already standing there,
+     * rather than to float a second element with the same identity.
+     *
+     * A progress event for a call this client never drew is dropped. It has no
+     * card to attach to, and inventing a floating one is precisely the alternative
+     * that was rejected: parent and child interleave in the transcript with
+     * nothing marking whose is whose, and the persisted transcript -- which never
+     * held the progress at all -- would not match what was on screen.
+     *
+     * Nothing here writes to the conversation store. `CUSTOM` never enters
+     * `agent.messages`, so a reload mid-run leaves the tool card and loses the
+     * nested detail, which is the intended behaviour rather than a gap.
+     */
+    report(value: unknown): void;
+    /** Open a delegation, on `SUBAGENT_STARTED`. */
+    start(subagentRunId: string, agent: string, parentToolCallId: string | null): void;
+    /** Settle a delegation that completed, on `SUBAGENT_FINISHED`. */
+    finish(subagentRunId: string): void;
+    /** Settle a delegation that failed, on `SUBAGENT_ERROR`. */
+    fail(subagentRunId: string, message: string): void;
+    /**
+     * Forget every delegation. The panels go with the cards they hung off.
+     * Nothing restores them: the progress rode the imperative carrier and was
+     * never persisted, which is the correct half of that split -- a delegation
+     * that was live before this transcript was wiped is not live now.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=subagent_progress.d.ts.map

package/dist/ui/progress/subagent_progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent_progress.d.ts","sourceRoot":"","sources":["../../../src/ui/progress/subagent_progress.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,mEAAmE;AACnE,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,CAAC;IAC5D,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,CAAC;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,qBAAa,gBAAgB;;IAwB3B,YAAY,IAAI,EAAE,oBAAoB,EAErC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAM3B;IAED,gDAAgD;IAChD,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAcjF;IAED,kEAAkE;IAClE,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAElC;IAED,4DAA4D;IAC5D,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAgBjD;IAED;;;;;OAKG;IACH,KAAK,IAAI,IAAI,CAGZ;CAqEF"}

package/dist/ui/progress/tool_call_card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool_call_card.d.ts","sourceRoot":"","sources":["../../../src/ui/progress/tool_call_card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEtE,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAEtF,sCAAsC;AACtC,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE/E,iEAAiE;AACjE,MAAM,MAAM,eAAe,GAAG,OAAO,gBAAgB,CAAC,OAAO,GAAG,OAAO,gBAAgB,CAAC,QAAQ,CAAC;AAEjG,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;AA+BrE;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,WAAW,GACnB;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;AAElF,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAClC,sFAAsF;IACtF,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,YAAY;;IACvB,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IAEtC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IAStC;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMvC,YACE,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,SAA8B,EACvC,OAAO,GAAE,mBAAwB,EAkFlC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAMlC;IAED;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAKlD;IAED,gFAAgF;IAChF,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBhD;CAkEF"}
+{"version":3,"file":"tool_call_card.d.ts","sourceRoot":"","sources":["../../../src/ui/progress/tool_call_card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEtE,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAEtF,sCAAsC;AACtC,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE/E,iEAAiE;AACjE,MAAM,MAAM,eAAe,GAAG,OAAO,gBAAgB,CAAC,OAAO,GAAG,OAAO,gBAAgB,CAAC,QAAQ,CAAC;AAEjG,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;AAiCrE;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,WAAW,GACnB;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;AAElF,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAClC,sFAAsF;IACtF,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,YAAY;;IACvB,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IAEtC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IAStC;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMvC,YACE,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,SAA8B,EACvC,OAAO,GAAE,mBAAwB,EAkFlC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAMlC;IAED;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAKlD;IAED,gFAAgF;IAChF,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBhD;CAkEF"}

package/dist/ui/shell/adopt_styles.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Attach the stylesheet to `root` without an inline `<style>` element.
+ *
+ * A host with a strict `style-src` and no `'unsafe-inline'` drops an injected
+ * `<style>` silently: the component mounts, functions, and renders completely
+ * unstyled, with nothing in the console to point at. `adoptedStyleSheets`
+ * carries no inline-style origin, so it is unaffected by that policy.
+ *
+ * The sheet is constructed **per call**, which is once per mounted element,
+ * rather than shared at module scope. A shared sheet would additionally avoid
+ * re-parsing the stylesheet once per mounted element, which is what
+ * `adoptedStyleSheets` is usually reached for -- but a module-level singleton
+ * is exactly what this package forbids, and the CSP defect is fixed either way.
+ * Per instance is no worse than the `<style>` element it replaces, which also
+ * parsed once per mount.
+ *
+ * No fallback: constructible `CSSStyleSheet` is Chrome 73, Firefox 101 and
+ * Safari 16.4, all below this package's declared Safari 17 runtime target. A
+ * guard here would be code no supported browser can reach, and the only way
+ * to keep it would be to exempt it from the coverage gate.
+ */
+export declare function adoptStyles(root: ShadowRoot): void;
+//# sourceMappingURL=adopt_styles.d.ts.map

package/dist/ui/shell/adopt_styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adopt_styles.d.ts","sourceRoot":"","sources":["../../../src/ui/shell/adopt_styles.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAIlD"}

package/dist/ui/shell/glyph_slot.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A `<slot>` a host can project its own mark into, falling back to one of the
+ * built-in glyphs. The markup is an author-written constant, never user or
+ * server data, so it is assigned directly rather than sanitised.
+ */
+export declare function glyphSlot(slotName: string, className: string, markup: string): HTMLSlotElement;
+//# sourceMappingURL=glyph_slot.d.ts.map

package/dist/ui/shell/glyph_slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glyph_slot.d.ts","sourceRoot":"","sources":["../../../src/ui/shell/glyph_slot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAM9F"}