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

package/dist/skills/skill_catalog.d.ts

@@ -0,0 +1,67 @@
+import type { SkillsMenu } from "../ui/composer/skills_menu.js";
+import type { UiStrings } from "../ui/ui_strings.js";
+import type { Skill } from "./skill.js";
+/** What the skill catalog needs from the element that owns it. */
+export interface SkillCatalogHost {
+    /** The custom element, whose `data-skills-url` names the backend catalog. */
+    readonly element: HTMLElement;
+    /** The chips row and the slash palette the merged catalog is shown in. */
+    readonly menu: SkillsMenu;
+    /** The composer a picked skill's prompt is written into. */
+    readonly input: HTMLTextAreaElement;
+    /** The hint above the composer, saying what a skill still needs. */
+    readonly hint: HTMLElement;
+    /** The resolved string table. */
+    readonly strings: () => UiStrings;
+    /** The host's `skillContext`, read at the moment of the pick. */
+    readonly context: () => Record<string, unknown>;
+    /** Read an opt-in flag attribute. */
+    readonly flag: (name: string) => boolean;
+    /** Parse a JSON-valued attribute, warning when it will not parse. */
+    readonly readJsonAttribute: (name: string) => unknown;
+    /** The fetch options every request the element makes carries. */
+    readonly fetchInit: (url: string) => RequestInit | undefined;
+    /** The element's public `sendMessage`. */
+    readonly send: (content: string) => void;
+    /** Send whatever the composer holds, as the Send button does. */
+    readonly submit: () => void;
+    /** Resize the composer to what it now holds. */
+    readonly autoGrow: () => void;
+}
+/**
+ * The element's skills: the three catalogs a skill can come from, merged into
+ * the chips and the slash palette, and what picking one does to the composer.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance.
+ */
+export declare class SkillCatalog {
+    #private;
+    constructor(host: SkillCatalogHost);
+    /** The replacement behind `AgUiChat.setSkills`, whose doc is the contract. */
+    setClientSkills(skills: readonly Skill[]): void;
+    /**
+     * Wire the skill surfaces: opt-in flags and the embedded catalog. The backend
+     * catalog is fetched from the element's startup, a microtask later, so it
+     * carries the host's transport configuration.
+     */
+    init(): void;
+    /** Fetch the backend skills catalog from `data-skills-url`, if set. */
+    fetch(): Promise<void>;
+    /**
+     * Act on a picked skill.
+     *
+     * A skill with no `prompt` is server-resolved: picking it sends the bare
+     * `/name` token for the agent to expand, so the wording never reaches the
+     * browser. Prefer that shape — a skill often states a project's internal
+     * workflow most plainly, and a catalog endpoint is a plain GET.
+     *
+     * A skill carrying a `prompt` has the client fill its `{placeholder}`s from
+     * the page instead, which is right for placeholders only the page can supply.
+     *
+     * Either way a pick sends; `sendImmediately: false` opts into pre-filling the
+     * composer instead.
+     */
+    apply(skill: Skill): void;
+}
+//# sourceMappingURL=skill_catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill_catalog.d.ts","sourceRoot":"","sources":["../../src/skills/skill_catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,CAAC;IAClC,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACzC,qEAAqE;IACrE,QAAQ,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACtD,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;IAC7D,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;;IAOvB,YAAY,IAAI,EAAE,gBAAgB,EAEjC;IAED,8EAA8E;IAC9E,eAAe,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,IAAI,CAG9C;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,CAKX;IAED,uEAAuE;IACjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAY3B;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAkCxB;CA+BF"}

package/dist/skills/skill_name_from.d.ts

@@ -0,0 +1,12 @@
+import type { AgUiToolCall } from "../core/agui_client.js";
+/**
+ * The skill name a `load_capability` call activated, or `null` when the call is
+ * something else.
+ *
+ * Every deferred capability loads through this one tool, so the id is a skill
+ * name only when the project wired agent skills; another project's capability
+ * id surfaces here too. Acceptable for a muted notice, and better than a
+ * parallel signal — the id is exactly what the model selected.
+ */
+export declare function skillNameFrom(call: AgUiToolCall): string | null;
+//# sourceMappingURL=skill_name_from.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill_name_from.d.ts","sourceRoot":"","sources":["../../src/skills/skill_name_from.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAM/D"}

package/dist/tools/tool_catalog.d.ts

@@ -0,0 +1,79 @@
+import type { Tool } from "@ag-ui/core";
+import type { PendingDecision } from "../ui/interrupts/pending_decision.js";
+import { type QuestionRenderer } from "../ui/interrupts/question_card.js";
+import type { UiStrings } from "../ui/ui_strings.js";
+import { type ChatSurface } from "./chat_surface_tools.js";
+import { type ClientTool } from "./client_tool_registry.js";
+import type { PageMap } from "./page_map.js";
+import { type PageState } from "./page_state.js";
+import { type RouteMap } from "./route_map.js";
+/** What the tool catalog needs from the element that owns it. */
+export interface ToolCatalogHost {
+    /** The custom element: its tool attributes, and the surface the chat tools drive. */
+    readonly element: HTMLElement & ChatSurface;
+    /** The element's `routeMap`, read per call. */
+    readonly routeMap: () => RouteMap;
+    /** The element's `navigate`, read per call. */
+    readonly navigate: () => ((path: string) => void) | null;
+    /** The element's `getPageMap`, read per call. */
+    readonly getPageMap: () => (() => PageMap) | null;
+    /** The element's `resolvePageTarget`, called per target. */
+    readonly resolvePageTarget: (target: string) => HTMLElement | null;
+    /** The element's `getTools`, which a host may have replaced. */
+    readonly getTools: () => Tool[];
+    /** The element's `askUser` flag. */
+    readonly askUser: () => boolean;
+    /** The element's `askUserRenderer`. */
+    readonly askUserRenderer: () => QuestionRenderer | null;
+    /** The decision a run is suspended on, which a Stop abandons. */
+    readonly decision: PendingDecision;
+    /** The current answer group, opening one if none is open. */
+    readonly ensureGroup: () => HTMLDivElement;
+    /** The resolved string table. */
+    readonly strings: () => UiStrings;
+    /** Remove the pending indicator if shown. */
+    readonly hidePending: () => void;
+    /** Update the empty state after the transcript changed. */
+    readonly updateEmptyState: () => void;
+    /** Keep the transcript at its foot, if the reader is there. */
+    readonly follow: () => void;
+    /** The fetch options every request the element makes carries. */
+    readonly fetchInit: (url: string) => RequestInit | undefined;
+}
+/**
+ * The frontend tools the agent is offered: the host's registered tools, the
+ * built-in ones the element's configuration switches on, what the current round
+ * advertised, and the server's catalog of labels for the tools it runs itself.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance.
+ */
+export declare class ToolCatalog {
+    #private;
+    constructor(host: ToolCatalogHost);
+    /** The registration behind `AgUiChat.registerTool`, whose doc is the contract. */
+    register(tool: ClientTool): void;
+    /** The binding behind `AgUiChat.registerPageState`, whose doc is the contract. */
+    registerPageState(binding: PageState): void;
+    /** Whether a tool of this name is registered, built-ins aside. */
+    has(name: string): boolean;
+    /** The catalog behind the default `AgUiChat.getTools`, whose doc is the contract. */
+    defaultTools(): Tool[];
+    /**
+     * The catalog for the round about to start, remembering what it offered.
+     *
+     * Every path to a frontend tool goes through here first — the client asks
+     * for `RunAgentInput.tools` at the top of each round — so this is the one
+     * place that can know what the agent was actually told about.
+     */
+    advertise(): Tool[];
+    /** Whether the current round offered a tool of this name. */
+    wasAdvertised(name: string): boolean;
+    /** Resolve a tool by name: built-in tools first, then the registry. */
+    resolve(name: string): ClientTool | null;
+    /** The server catalog's label for a tool, if it sent one. */
+    summary(name: string): string | undefined;
+    /** Fetch the server tool-label catalog from `data-tools-url`, if set. */
+    fetchCatalog(): Promise<void>;
+}
+//# sourceMappingURL=tool_catalog.d.ts.map

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

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

package/dist/tools/tool_dispatch.d.ts

@@ -0,0 +1,104 @@
+import type { Context, Interrupt } from "@ag-ui/core";
+import type { AgUiToolCall, InterruptResponse, ToolExecution } from "../core/agui_client.js";
+import type { ClientConversationStore } from "../core/conversation_store.js";
+import { type ApprovalRenderer } from "../ui/interrupts/approval_card.js";
+import type { PendingDecision } from "../ui/interrupts/pending_decision.js";
+import type { Transcript } from "../ui/transcript/transcript.js";
+import type { UiStrings } from "../ui/ui_strings.js";
+import type { PageMap } from "./page_map.js";
+import type { ToolCatalog } from "./tool_catalog.js";
+/** What tool dispatch needs from the element that owns it. */
+export interface ToolDispatchHost {
+    /** The custom element, which a host's predicate and renderer are called on. */
+    readonly element: HTMLElement;
+    /** The transcript the cards and prompts are drawn in. */
+    readonly transcript: Transcript;
+    /** The tools this round advertised, and their implementations. */
+    readonly tools: ToolCatalog;
+    /** The decision a run is suspended on, which a Stop abandons. */
+    readonly decision: PendingDecision;
+    /** The resolved string table. */
+    readonly strings: () => UiStrings;
+    /** Say one short thing to a screen reader. */
+    readonly announce: (message: string) => void;
+    /** The element's `autoConfirm`. */
+    readonly autoConfirm: () => boolean;
+    /** The element's `confirmPredicate`. */
+    readonly confirmPredicate: () => ((toolName: string, args: Record<string, unknown>) => boolean | Promise<boolean>) | null;
+    /** The element's `getPageMap`. */
+    readonly getPageMap: () => (() => PageMap) | null;
+    /** The element's `navigate`. */
+    readonly navigate: () => ((path: string) => void) | null;
+    /** The element's `approveWithEdits`. */
+    readonly approveWithEdits: () => boolean;
+    /** The element's `approvalRenderer`. */
+    readonly approvalRenderer: () => ApprovalRenderer | null;
+    /** The element's `getContext`, which a host may have replaced. */
+    readonly getContext: () => Context[];
+    /** The element's `conversationStore`, read per use. */
+    readonly conversationStore: () => ClientConversationStore;
+    /** The active thread's id. */
+    readonly threadId: () => string;
+}
+/**
+ * Running the frontend tool calls a round produced, and answering the server's
+ * interrupts: the page each round's context described, the confirmation rules,
+ * and the tools the user waived confirmation for.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance.
+ */
+export declare class ToolDispatch {
+    #private;
+    constructor(host: ToolDispatchHost);
+    /**
+     * Forget every tool the user waived confirmation for.
+     *
+     * A waiver is one person's click, and it is only ever that person's to give.
+     * `user-key` exists because a logout is a navigation inside one tab rather
+     * than a remount, so the element outlives the principal who clicked Always
+     * allow -- and without this the next one's destructive calls would run on the
+     * previous one's say-so, with no card to show that anyone was asked.
+     */
+    forgetWaivers(): void;
+    /**
+     * Build a round's context, recording which page it describes.
+     *
+     * The AG-UI client re-invokes this at the top of **every** tool round, not
+     * once per `send()`, so the page map the agent sees is already refreshed
+     * between rounds and the href captured here is the page it was shown for
+     * *this* round. {@link execute} compares against it to catch a page that
+     * moved under a round still in flight.
+     */
+    buildContext(): Context[];
+    /**
+     * Execute one frontend tool call the round produced, against its own card:
+     * refused when the page moved under the round, asked about when a rule gates
+     * it, and settled with what the handler returned or threw.
+     */
+    execute(call: AgUiToolCall): Promise<ToolExecution | null>;
+    /**
+     * Render an approval card per server-side-tool interrupt and collect the
+     * user's decisions (approve → run it, deny → decline it).
+     *
+     * **One card per gated call, in that call's own tool card, all at once.** A run
+     * can defer several calls, and the wire answers each independently — so the UI
+     * has to let a person answer each independently, which means saying which is
+     * which. The prompt cannot: it comes from the tool's `x-confirm` and is
+     * identical for every call of that tool. The tool card can, by position, and it
+     * is already showing the arguments. Asking them serially was the other half of
+     * the problem: the second question only appeared once the first was answered,
+     * so a person could neither compare them nor tell that more were coming.
+     *
+     * Each gated card is marked `deferred` for the wait. That is not cosmetic — at
+     * `pending` it read "running…" while the stream was over and the server idle.
+     *
+     * The run is suspended on these cards. A Stop while any is open aborts the
+     * shared pending decision, resolving every still-open card as
+     * denied. An approved tool runs on the follow-up resume run and streams its
+     * result into the same card (returned to `pending`, since it now really is
+     * running); a denied one settles here, as no result will ever arrive.
+     */
+    resolveInterrupts(interrupts: readonly Interrupt[]): Promise<Record<string, InterruptResponse>>;
+}
+//# sourceMappingURL=tool_dispatch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool_dispatch.d.ts","sourceRoot":"","sources":["../../src/tools/tool_dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAG7E,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,mCAAmC,CAAC;AAK3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,CAAC;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,mCAAmC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC;IACpC,wCAAwC;IACxC,QAAQ,CAAC,gBAAgB,EAAE,MACvB,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,GACjF,IAAI,CAAC;IACT,kCAAkC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC;IAClD,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACzD,wCAAwC;IACxC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,OAAO,CAAC;IACzC,wCAAwC;IACxC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,gBAAgB,GAAG,IAAI,CAAC;IACzD,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,EAAE,CAAC;IACrC,uDAAuD;IACvD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;IAC1D,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,qBAAa,YAAY;;IAiBvB,YAAY,IAAI,EAAE,gBAAgB,EAEjC;IAED;;;;;;;;OAQG;IACH,aAAa,IAAI,IAAI,CAEpB;IAED;;;;;;;;OAQG;IACH,YAAY,IAAI,OAAO,EAAE,CAGxB;IAED;;;;OAIG;IACG,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAuJ/D;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,iBAAiB,CACrB,UAAU,EAAE,SAAS,SAAS,EAAE,GAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CA+F5C;CAiGF"}

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

@@ -1 +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;AAErE,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"}
+{"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/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_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/voice_input.d.ts.map

@@ -1 +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;AACxE,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;IAapC,YAAY,OAAO,EAAE,iBAAiB,EAmBrC;IAED,uEAAuE;IACjE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAS5B;IA6CD;;;;;OAKG;IACH,OAAO,IAAI,IAAI,CAQd;CAkEF"}
+{"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;IAapC,YAAY,OAAO,EAAE,iBAAiB,EAmBrC;IAED,uEAAuE;IACjE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAS5B;IA6CD;;;;;OAKG;IACH,OAAO,IAAI,IAAI,CAQd;CAiEF"}

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

@@ -0,0 +1,57 @@
+import type { UiStrings } from "../ui_strings.js";
+/** What the quote offer needs from the element that owns it. */
+export interface TranscriptQuoteHost {
+    /** The custom element: its opt-out attribute, and what a page offer excludes. */
+    readonly element: HTMLElement;
+    /** The shadow root a transcript selection is read through. */
+    readonly root: ShadowRoot;
+    /** The transcript, whose selections are offered. */
+    readonly messages: HTMLElement;
+    /** The transcript's positioning box, which the offer floats inside. */
+    readonly messagesWrap: HTMLElement;
+    /** The composer a quotation is written into. */
+    readonly input: HTMLTextAreaElement;
+    /** The resolved string table. */
+    readonly strings: () => UiStrings;
+    /** Resize the composer to what it now holds. */
+    readonly autoGrow: () => void;
+    /** The element's public `quote`, so a host that replaced it is the one called. */
+    readonly quote: (text: string) => void;
+}
+/**
+ * Quoting a selection into the composer: the offer floated beside a selection
+ * in the transcript, the same offer over the host page, and the quotation
+ * itself.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance.
+ */
+export declare class TranscriptQuoteOffer {
+    #private;
+    /**
+     * Offer to quote the current selection, floated beside it.
+     *
+     * Shares the transcript's positioning box with the jump button for the same
+     * reason: it is positioned against the transcript, and must not scroll away
+     * with the words it is pointing at.
+     */
+    readonly button: HTMLButtonElement;
+    constructor(host: TranscriptQuoteHost);
+    /** The quotation behind `AgUiChat.quote`, whose doc is the contract. */
+    insert(text: string): void;
+    /** The offer behind `AgUiChat.offerQuoteInPage`, whose doc is the contract. */
+    offerInPage(within: HTMLElement): () => void;
+    /**
+     * Take the host-page offer down. It listens on the host's document, not on
+     * anything of ours, so nothing else would ever take it down.
+     */
+    detachPageOffer(): void;
+    /**
+     * Build the offer and listen for settled selections in the transcript.
+     *
+     * The button and the transcript outlive a connection, so the listeners go
+     * under `signal`, which the element aborts when it leaves the document.
+     */
+    mount(signal: AbortSignal): void;
+}
+//# sourceMappingURL=transcript_quote_offer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcript_quote_offer.d.ts","sourceRoot":"","sources":["../../../src/ui/excerpts/transcript_quote_offer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAOlD,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,SAAS,CAAC;IAClC,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAoB;;IAC/B;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAoC;IAQtE,YAAY,IAAI,EAAE,mBAAmB,EAEpC;IAED,wEAAwE;IACxE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBzB;IAED,+EAA+E;IAC/E,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,IAAI,CAe3C;IAED;;;OAGG;IACH,eAAe,IAAI,IAAI,CAGtB;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAoC/B;CAsDF"}

package/dist/ui/fill_ui_string.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Fill the `{token}` placeholders of a string-table template.
+ *
+ * Every string-table template goes through here rather than through
+ * `template.replace("{token}", value)`, which was wrong in two ways at once:
+ *
+ * - **A string replacement interprets dollar patterns in the value.** `$&`
+ *   inserts the matched token, and `` $` `` and `$'` the text either side of it,
+ *   so a queued message reading `costs $& more` was labelled
+ *   `Do not send "costs {text} more"`. Several of these values are text a user
+ *   or a server wrote -- a queued message, a tool name, a skill title, an
+ *   agent name -- so the value has to land verbatim. A replacer function's
+ *   return value is never interpreted, which is the whole fix.
+ * - **A string pattern replaces only the first occurrence**, so a translation
+ *   that uses a token twice was left half filled.
+ *
+ * One pass over the template, so a value that itself contains a `{token}` is
+ * inserted as written rather than filled in turn: a skill titled
+ * `Fill {fields}` stays that, where chained replacements filled it twice.
+ *
+ * A token with no entry in `values` is left as written. Every call site passes
+ * the tokens its key documents, so that is a translation carrying a token the
+ * call site does not know, and printing it is more honest than dropping it.
+ * `skills/fill_template.ts` is the prompt-side counterpart, and its contract is
+ * different on purpose: a prompt reports what it could not fill so a send can
+ * be refused.
+ *
+ * @param template - A string-table value, e.g. `strings.removeQueued`.
+ * @param values - The value for each token the template's key documents.
+ */
+export declare function fillUiString(template: string, values: Readonly<Record<string, string | number>>): string;
+//# sourceMappingURL=fill_ui_string.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fill_ui_string.d.ts","sourceRoot":"","sources":["../../src/ui/fill_ui_string.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,GAChD,MAAM,CAIR"}