@artooi/ag-ui-web-component 0.1.0 → 0.2.0

package/dist/constants.d.ts

@@ -6,6 +6,13 @@ export declare const ELEMENT_TAG = "ag-ui-chat";
  * AG-UI client; for now it is the public seam for host integration.
  */
 export declare const SUBMIT_EVENT = "ag-ui-submit";
+/**
+ * Event dispatched by `<ag-ui-chat>` when its collapsed state changes (via the
+ * built-in toggle or {@link setCollapsed}). `detail` carries
+ * `{ collapsed: boolean }`. A host can listen to drive its own chrome, or hide
+ * the built-in toggle and drive the `collapsed` attribute itself.
+ */
+export declare const TOGGLE_EVENT = "ag-ui-toggle";
 /** Roles a chat message can take. */
 export declare const MESSAGE_ROLE: {
     readonly USER: "user";
@@ -18,6 +25,19 @@ export declare const MESSAGE_ROLE: {
  * confirmation modal (unless `autoConfirm` is set).
  */
 export declare const X_DESTRUCTIVE_KEY = "x-destructive";
+/**
+ * JSON-Schema extension key carrying a human-readable confirmation prompt for a
+ * destructive tool (e.g. `"Activate this project?"`). Mirrors the `django-ag-ui`
+ * server side. When present, the inline confirmation card shows this instead of
+ * the generic `Run "<tool>"?`.
+ */
+export declare const X_CONFIRM_KEY = "x-confirm";
+/**
+ * JSON-Schema extension key carrying a short human-readable label for a tool
+ * (e.g. `"Query orders"` for `query_model`). Mirrors the `django-ag-ui` server
+ * side; the tool-call card shows it instead of the raw tool name when present.
+ */
+export declare const X_SUMMARY_KEY = "x-summary";
 /**
  * JSON-Schema extension key marking a tool as navigating — its handler triggers
  * a full page reload (an MPA navigation). When a tool's `parameters` carries
@@ -37,4 +57,18 @@ export declare const TOOL_CALL_STATUS: {
     readonly ERROR: "error";
     readonly DECLINED: "declined";
 };
+/**
+ * How much detail a tool-call card shows. Set via the `data-tool-display`
+ * attribute on `<ag-ui-chat>`; defaults to `full` (back-compatible).
+ *
+ * - `minimal` — just the tool name + status pill. No args, no result body.
+ * - `compact` — name + status, with args *and* result tucked behind a single
+ *   collapsed "Details" toggle. The light default for dense UIs.
+ * - `full` — args shown inline, result behind its own toggle (the original).
+ */
+export declare const TOOL_DISPLAY: {
+    readonly MINIMAL: "minimal";
+    readonly COMPACT: "compact";
+    readonly FULL: "full";
+};
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAGA,wEAAwE;AACxE,eAAO,MAAM,WAAW,eAAe,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,qCAAqC;AACrC,eAAO,MAAM,YAAY;;;CAGf,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,yEAAyE;AACzE,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAGA,wEAAwE;AACxE,eAAO,MAAM,WAAW,eAAe,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,qCAAqC;AACrC,eAAO,MAAM,YAAY;;;CAGf,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,yEAAyE;AACzE,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;;;;CAIf,CAAC"}

package/dist/{ag_ui_chat.d.ts → core/ag_ui_chat.d.ts}

@@ -1,17 +1,23 @@
 import type { Context, Tool } from "@ag-ui/core";
-import { type ClientTool } from "./client_tool_registry.js";
-import { MESSAGE_ROLE } from "./constants.js";
+import { MESSAGE_ROLE } from "../constants.js";
+import type { Skill } from "../skills/skill.js";
+import { type ClientTool } from "../tools/client_tool_registry.js";
+import { type PageMap } from "../tools/page_map.js";
+import { type RouteMap } from "../tools/route_map.js";
+import { type StateHook } from "../tools/state_hook.js";
+import { type ToolDisplayMode } from "../ui/tool_call_card.js";
 import { type ClientConversationStore, type NavigationCheckpoint } from "./conversation_store.js";
 import { type AgentFactory } from "./create_http_agent.js";
-import { type PageMap } from "./page_map.js";
-import { type RouteMap } from "./route_map.js";
-import { type StateHook } from "./state_hook.js";
 /** The role a rendered chat message takes. */
 export type MessageRole = (typeof MESSAGE_ROLE)[keyof typeof MESSAGE_ROLE];
 /** `detail` shape of the {@link SUBMIT_EVENT} CustomEvent. */
 export interface SubmitDetail {
     readonly content: string;
 }
+/** `detail` shape of the {@link TOGGLE_EVENT} CustomEvent. */
+export interface ToggleDetail {
+    readonly collapsed: boolean;
+}
 /**
  * `<ag-ui-chat>` — a framework-free chat sidebar Web Component over AG-UI.
  *
@@ -32,6 +38,14 @@ export declare class AgUiChat extends HTMLElement {
     headers: Record<string, string>;
     /** When true, destructive tools execute without a confirmation modal. */
     autoConfirm: boolean;
+    /**
+     * Optional per-call confirmation predicate. When set, it is authoritative:
+     * given a tool name + args it decides whether *this* call needs confirmation
+     * (so one tool can be instant for some args and confirmed for others — what a
+     * static `x-destructive` flag can't express). When unset, the `x-destructive`
+     * schema flag is used. `autoConfirm` short-circuits both.
+     */
+    confirmPredicate: ((toolName: string, args: Record<string, unknown>) => boolean | Promise<boolean>) | null;
     /**
      * Per-run frontend tool catalog provider. Defaults to the built-in
      * `route.*` tools (when a {@link routeMap} is set) plus the tools registered
@@ -71,15 +85,58 @@ export declare class AgUiChat extends HTMLElement {
      * override to include a page snapshot or post-reload validation errors.
      */
     navigationResult: (checkpoint: NavigationCheckpoint) => unknown;
+    /**
+     * Named values used to fill a skill prompt's `{placeholder}`s before send
+     * (e.g. `{ model: "Order", selected_ids: "1,2" }`). A host (the admin) sets
+     * this from the current page; a missing placeholder blocks the send.
+     */
+    skillContext: () => Record<string, unknown>;
     constructor();
+    /** Attributes whose late changes must reflect in already-rendered chrome. */
+    static get observedAttributes(): string[];
+    attributeChangedCallback(_name: string, _previous: string | null, value: string | null): void;
     /** Declare a frontend tool the agent may call. */
     registerTool(tool: ClientTool): void;
     /** Bind a piece of host state to `read_<name>` / `set_<name>` tools. */
     registerStateHook(hook: StateHook): void;
     /** The AG-UI endpoint URL, read from the `endpoint` attribute. */
     get endpoint(): string;
+    set endpoint(value: string);
+    /**
+     * How much detail tool-call cards show, from the `data-tool-display`
+     * attribute (`minimal` / `compact` / `full`). Defaults to `full`.
+     */
+    get toolDisplay(): ToolDisplayMode;
+    set toolDisplay(value: ToolDisplayMode);
     connectedCallback(): void;
-    /** Append a message bubble and return it. */
+    /**
+     * Replace the host-supplied (client) skill catalog. Merged after the embedded
+     * and fetched skills (so a client skill overrides a same-named server one).
+     */
+    setSkills(skills: readonly Skill[]): void;
+    /** Whether the widget is collapsed (reflected as the `collapsed` attribute). */
+    get collapsed(): boolean;
+    set collapsed(value: boolean);
+    /**
+     * Set the collapsed state: reflect the `collapsed` attribute, persist it
+     * per-tab, and emit a {@link TOGGLE_EVENT} so a host can mirror the state in
+     * its own chrome.
+     */
+    setCollapsed(collapsed: boolean): void;
+    /** Flip the collapsed state. Bound to the built-in header toggle. */
+    toggleCollapsed(): void;
+    /**
+     * Start a fresh conversation: forget the persisted history, drop the
+     * in-memory run state, clear the transcript, and mint a new thread id.
+     */
+    newChat(): void;
+    /**
+     * Append a message bubble and return it.
+     *
+     * Assistant content is rendered as sanitised markdown/HTML; user content
+     * stays literal text (no need to parse what the user typed, and it avoids
+     * rendering user-authored markup).
+     */
     appendMessage(role: MessageRole, content: string): HTMLDivElement;
 }
 //# sourceMappingURL=ag_ui_chat.d.ts.map

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"agui_client.d.ts","sourceRoot":"","sources":["../../src/core/agui_client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAoC,MAAM,eAAe,CAAC;AACrF,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAG1D,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;;;;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,QAAQ,IAAI,IAAI,CAAC;IACjB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;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;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,KAAK,IAAI,CAAC;CACpD;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;;gBAQT,MAAM,EAAE,gBAAgB;IASpC,4CAA4C;IAC5C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,wEAAwE;IACxE,IAAI,QAAQ,IAAI,SAAS,OAAO,EAAE,CAEjC;IAED;;;;;;OAMG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1C;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,0EAA0E;IAC1E,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CA+EzD"}

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

@@ -0,0 +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;;;;;;;;;;GAUG;AACH,MAAM,WAAW,uBAAuB;IACtC,uEAAuE;IACvE,QAAQ,IAAI,MAAM,CAAC;IACnB,sEAAsE;IACtE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACnE,mCAAmC;IACnC,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,yEAAyE;IACzE,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAMD;;;;;;;GAOG;AACH,qBAAa,mBAAoB,YAAW,uBAAuB;;IACjE,QAAQ,IAAI,MAAM;IAUlB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC;IAIlE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAIlE,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAI7D,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI;IAS/E,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAkB9B"}

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

@@ -0,0 +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;AAE3C,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,eAAe,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACtC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAgBxE;AAED,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,aAAa,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"define_ag_ui_chat.d.ts","sourceRoot":"","sources":["../../src/core/define_ag_ui_chat.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAIrC"}

package/dist/dom/animations.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Visible-action animation primitives.
+ *
+ * These run against the **host page** DOM (not the element's shadow root) so a
+ * user watches the agent type, highlight, and click at human-readable speed.
+ * Each is configurable; pass small/zero durations in tests (or use fake timers).
+ */
+/** An element whose `value` can be typed into. */
+export type TextLikeElement = HTMLInputElement | HTMLTextAreaElement;
+export interface TypeOptions {
+    /** Milliseconds between characters. Default 35. */
+    charDelayMs?: number;
+}
+/**
+ * Clear ``el`` and type ``value`` one character at a time, firing ``input``
+ * events as a real user would, then a final ``change`` event.
+ */
+export declare function typeInto(el: TextLikeElement, value: string, options?: TypeOptions): Promise<void>;
+export interface HighlightClickOptions {
+    /** Milliseconds to hold the highlight before clicking. Default 280. */
+    highlightMs?: number;
+}
+/** Outline ``el``, pause so the user sees it, then click and restore. */
+export declare function highlightThenClick(el: HTMLElement, options?: HighlightClickOptions): Promise<void>;
+/** Scroll ``el`` to the vertical centre of the viewport. */
+export declare function scrollIntoCenterView(el: HTMLElement): void;
+export interface FlashOptions {
+    /** Milliseconds to hold the focus flash. Default 200. */
+    flashMs?: number;
+}
+/** Focus ``el`` and briefly flash a ring around it. */
+export declare function focusWithFlash(el: HTMLElement, options?: FlashOptions): Promise<void>;
+/**
+ * Whether the user has asked the OS/browser to minimise motion.
+ *
+ * The richer action animations below check this and skip their hold delays so
+ * the agent's edits still happen (events fire, values set) but without the
+ * visible pause. The character-typing / highlight primitives above predate this
+ * and keep their explicit-duration contract.
+ */
+export declare function prefersReducedMotion(): boolean;
+export interface PressOptions {
+    /** Milliseconds to hold the pressed state before clicking. Default 140. */
+    pressMs?: number;
+}
+/**
+ * Show a brief "pressed" affordance on a button/control — a slight scale-down
+ * plus accent ring — then click it and restore. Reads as an actual press, not
+ * just an outline (cf. {@link highlightThenClick}).
+ */
+export declare function pressThenClick(el: HTMLElement, options?: PressOptions): Promise<void>;
+export interface SelectOptions {
+    /** Milliseconds to hold the highlight before committing. Default 220. */
+    highlightMs?: number;
+}
+/**
+ * Outline a `<select>`, pause so the user sees the pick, then set it to the
+ * option matching ``value`` (by value or visible text) and fire `input` +
+ * `change`. Throws when no option matches.
+ */
+export declare function selectOption(el: HTMLSelectElement, value: string, options?: SelectOptions): Promise<void>;
+export interface ToggleOptions {
+    /** Milliseconds to hold the flash. Default 200. */
+    flashMs?: number;
+}
+/**
+ * Flash a ring around a checkbox/radio, set its ``checked`` state, and fire
+ * `input` + `change` so frameworks observe the flip.
+ */
+export declare function toggleControl(el: HTMLInputElement, checked: boolean, options?: ToggleOptions): Promise<void>;
+//# sourceMappingURL=animations.d.ts.map

package/dist/dom/animations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animations.d.ts","sourceRoot":"","sources":["../../src/dom/animations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,kDAAkD;AAClD,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,eAAe,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yEAAyE;AACzE,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,WAAW,EACf,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAE1D;AAED,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,uDAAuD;AACvD,wBAAsB,cAAc,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/F;AAID;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAUD,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAa/F;AAED,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAYD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,gBAAgB,EACpB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/{dom_driver.d.ts → dom/dom_driver.d.ts}

@@ -1,4 +1,4 @@
-import { type HighlightClickOptions, type TextLikeElement, type TypeOptions } from "./animations.js";
+import { type HighlightClickOptions, type PressOptions, type SelectOptions, type TextLikeElement, type ToggleOptions, type TypeOptions } from "./animations.js";
 /**
  * Generic, framework-free DOM-driving primitives.
  *
@@ -15,6 +15,12 @@ interface FlashOptionsLike {
 export declare function fillField(el: TextLikeElement, value: string, options?: FillFieldOptions): Promise<void>;
 /** Scroll to, highlight, and click an element. */
 export declare function clickElement(el: HTMLElement, options?: HighlightClickOptions): Promise<void>;
+/** Scroll to a button/control and click it with a visible "press" animation. */
+export declare function pressButton(el: HTMLElement, options?: PressOptions): Promise<void>;
+/** Scroll to a `<select>`, highlight it, and pick the matching option (animated). */
+export declare function selectControl(el: HTMLSelectElement, value: string, options?: SelectOptions): Promise<void>;
+/** Scroll to a checkbox/radio, flash it, and set its checked state (animated). */
+export declare function toggleCheckbox(el: HTMLInputElement, checked: boolean, options?: ToggleOptions): Promise<void>;
 /**
  * Set a `<select>` or checkbox value without typing animation, dispatching the
  * ``input`` and ``change`` events frameworks listen for.

package/dist/dom/dom_driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom_driver.d.ts","sourceRoot":"","sources":["../../src/dom/dom_driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAE1B,KAAK,YAAY,EAEjB,KAAK,aAAa,EAGlB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAGjB,MAAM,iBAAiB,CAAC;AAGzB;;;;;;GAMG;AAEH,MAAM,WAAW,gBAAiB,SAAQ,WAAW,EAAE,gBAAgB;CAAG;AAE1E,UAAU,gBAAgB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,6EAA6E;AAC7E,wBAAsB,SAAS,CAC7B,EAAE,EAAE,eAAe,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,kDAAkD;AAClD,wBAAsB,YAAY,CAChC,EAAE,EAAE,WAAW,EACf,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,gFAAgF;AAChF,wBAAsB,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5F;AAED,qFAAqF;AACrF,wBAAsB,aAAa,CACjC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,kFAAkF;AAClF,wBAAsB,cAAc,CAClC,EAAE,EAAE,gBAAgB,EACpB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,gBAAgB,GAAG,iBAAiB,EACxC,KAAK,EAAE,MAAM,GAAG,OAAO,GACtB,IAAI,CAQN"}

package/dist/dom/native_setter.d.ts

@@ -0,0 +1,5 @@
+/** Set ``el.value`` via the element's native prototype setter. */
+export declare function setNativeValue(el: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement, value: string): void;
+/** Set ``el.checked`` via the native prototype setter. */
+export declare function setNativeChecked(el: HTMLInputElement, checked: boolean): void;
+//# sourceMappingURL=native_setter.d.ts.map

package/dist/dom/native_setter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native_setter.d.ts","sourceRoot":"","sources":["../../src/dom/native_setter.ts"],"names":[],"mappings":"AAwBA,kEAAkE;AAClE,wBAAgB,cAAc,CAC5B,EAAE,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,iBAAiB,EAC9D,KAAK,EAAE,MAAM,GACZ,IAAI,CAQN;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAE7E"}

package/dist/index.d.ts

@@ -1,18 +1,21 @@
-export { AgUiChat, type MessageRole, type SubmitDetail } from "./ag_ui_chat.js";
-export { AgUiClient, type AgUiClientConfig, type AgUiClientHandlers, type AgUiRunInputs, type AgUiToolCall, type ExecuteTool, type ToolExecution, } from "./agui_client.js";
-export { type FlashOptions, focusWithFlash, type HighlightClickOptions, highlightThenClick, scrollIntoCenterView, type TextLikeElement, type TypeOptions, typeInto, } from "./animations.js";
-export { type ClientTool, ClientToolRegistry } from "./client_tool_registry.js";
-export { type ConfirmationRequest, requestConfirmation } from "./confirmation_modal.js";
-export { ELEMENT_TAG, MAX_TOOL_ROUNDS, MESSAGE_ROLE, SUBMIT_EVENT, TOOL_CALL_STATUS, X_DESTRUCTIVE_KEY, X_NAVIGATES_KEY, } from "./constants.js";
-export { type ClientConversationStore, type NavigationCheckpoint, SessionStorageStore, } from "./conversation_store.js";
-export { type AgentFactory, createHttpAgent, type HttpAgentOptions, } from "./create_http_agent.js";
-export { defineAgUiChat } from "./define_ag_ui_chat.js";
-export { clickElement, type FillFieldOptions, fillField, setControlValue, } from "./dom_driver.js";
-export { isDestructive } from "./is_destructive.js";
-export { isNavigates } from "./is_navigates.js";
-export { createPageMapContext, type PageMap } from "./page_map.js";
-export { createRouteTools, type Route, type RouteMap } from "./route_map.js";
-export { createStateHookTools, type StateHook } from "./state_hook.js";
-export { type SettledStatus, ToolCallCard, type ToolCallStatus, } from "./tool_call_card.js";
+export { ELEMENT_TAG, MAX_TOOL_ROUNDS, MESSAGE_ROLE, SUBMIT_EVENT, TOGGLE_EVENT, TOOL_CALL_STATUS, TOOL_DISPLAY, X_CONFIRM_KEY, X_DESTRUCTIVE_KEY, X_NAVIGATES_KEY, X_SUMMARY_KEY, } from "./constants.js";
+export { AgUiChat, type MessageRole, type SubmitDetail, type ToggleDetail, } from "./core/ag_ui_chat.js";
+export { AgUiClient, type AgUiClientConfig, type AgUiClientHandlers, type AgUiRunInputs, type AgUiToolCall, type ExecuteTool, type ToolExecution, } from "./core/agui_client.js";
+export { type ClientConversationStore, type NavigationCheckpoint, SessionStorageStore, } from "./core/conversation_store.js";
+export { type AgentFactory, createHttpAgent, type HttpAgentOptions, } from "./core/create_http_agent.js";
+export { defineAgUiChat } from "./core/define_ag_ui_chat.js";
+export { type FlashOptions, focusWithFlash, type HighlightClickOptions, highlightThenClick, type PressOptions, prefersReducedMotion, pressThenClick, type SelectOptions, scrollIntoCenterView, selectOption, type TextLikeElement, type ToggleOptions, type TypeOptions, toggleControl, typeInto, } from "./dom/animations.js";
+export { clickElement, type FillFieldOptions, fillField, pressButton, selectControl, setControlValue, toggleCheckbox, } from "./dom/dom_driver.js";
+export { setNativeChecked, setNativeValue } from "./dom/native_setter.js";
+export type { Skill } from "./skills/skill.js";
+export { type ClientTool, ClientToolRegistry } from "./tools/client_tool_registry.js";
+export { isDestructive } from "./tools/is_destructive.js";
+export { isNavigates } from "./tools/is_navigates.js";
+export { createPageMapContext, type PageMap } from "./tools/page_map.js";
+export { createRouteTools, type Route, type RouteMap, type RouteWithParams, } from "./tools/route_map.js";
+export { createStateHookTools, type StateHook } from "./tools/state_hook.js";
+export { type ConfirmationRequest, requestConfirmation } from "./ui/confirmation_card.js";
+export { renderMarkdown } from "./ui/render_markdown.js";
+export { type SettledStatus, ToolCallCard, type ToolCallStatus, type ToolDisplayMode, } from "./ui/tool_call_card.js";
 export { VERSION } from "./version.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EACL,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,qBAAqB,EAC1B,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,QAAQ,GACT,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,UAAU,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,KAAK,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,EACL,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,YAAY,EACjB,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EACL,YAAY,EACZ,KAAK,gBAAgB,EACrB,SAAS,EACT,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,KAAK,KAAK,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EACL,KAAK,aAAa,EAClB,YAAY,EACZ,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,QAAQ,EACR,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,YAAY,EACjB,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EACL,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,qBAAqB,EAC1B,kBAAkB,EAClB,KAAK,YAAY,EACjB,oBAAoB,EACpB,cAAc,EACd,KAAK,aAAa,EAClB,oBAAoB,EACpB,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,aAAa,EACb,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,YAAY,EACZ,KAAK,gBAAgB,EACrB,SAAS,EACT,WAAW,EACX,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC1E,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,KAAK,UAAU,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EACL,gBAAgB,EAChB,KAAK,KAAK,EACV,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,KAAK,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EACL,KAAK,aAAa,EAClB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}