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

package/dist/dom/animations.d.ts

@@ -0,0 +1,122 @@
+/**
+ * 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).
+ */
+/**
+ * Whether the user has asked the OS/browser to minimise motion.
+ *
+ * Honoured by every primitive that moves something, except `typeInto` and
+ * `highlightThenClick`, which keep their explicit durations. The flash drops its fade
+ * but still holds the ring: reduced motion asks for no animation, not no feedback.
+ */
+export declare function prefersReducedMotion(): boolean;
+/**
+ * Which `<ag-ui-chat>` a ring speaks for. The ring is drawn in the host page, which a
+ * token set on the chat never reaches, so the chat is read directly.
+ */
+export interface RingOwnerOptions {
+    /** The chat whose ring colour and accent to use. Default: the latest connected. */
+    chat?: HTMLElement;
+}
+/** 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 an `input` event
+ * per character as a real user would, then a final `change`.
+ */
+export declare function typeInto(el: TextLikeElement, value: string, options?: TypeOptions): Promise<void>;
+export interface HighlightClickOptions extends RingOwnerOptions {
+    /** 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>;
+export interface ScrollOptions {
+    /**
+     * How long to wait for a moving scroll to settle before giving up.
+     * Default 600.
+     */
+    settleMs?: number;
+}
+/**
+ * Scroll `el` to the vertical centre of the viewport.
+ *
+ * Resolves once the scroll settles, so a ring is not drawn mid-glide. Awaiting is
+ * optional; the scroll is requested synchronously.
+ */
+export declare function scrollIntoCenterView(el: HTMLElement, options?: ScrollOptions): Promise<void>;
+export interface FlashOptions extends RingOwnerOptions {
+    /** Total milliseconds the ring is on screen, hold plus fade. Default 1200. */
+    flashMs?: number;
+    /**
+     * Ring colour. Defaults to `--ag-ui-highlight-ring-color` (on the target,
+     * then on the chat), then the target's `--ag-ui-accent`, then the chat's
+     * accent.
+     */
+    color?: string;
+    /**
+     * Dim everything except the target. Draws an overlay outside the element instead of an
+     * outline (see {@link showHighlightOverlay}); it takes no pointer event, so the page
+     * stays usable.
+     */
+    scrim?: boolean;
+    /** Draw the ring as a moving gradient. Also an overlay, for the same reason. */
+    gradient?: boolean;
+    /** Gap between the target's box and an overlay ring. Default 4. */
+    ringPadding?: number;
+    /**
+     * Move keyboard focus to the element as well. Defaults to false for
+     * {@link flash} and true for {@link focusWithFlash}.
+     */
+    focus?: boolean;
+}
+/**
+ * Flash a ring around `el` without touching focus.
+ *
+ * Prefer this over {@link focusWithFlash} when the point is to show the user
+ * something: moving focus steals it from the composer, can fire blur validation
+ * on whatever they were mid-edit in, and can close an open menu.
+ */
+export declare function flash(el: HTMLElement, options?: FlashOptions): Promise<void>;
+/**
+ * Focus `el` and flash a ring around it. Focus moves unless `options.focus`
+ * says otherwise; use {@link flash} to leave focus where the user put it.
+ */
+export declare function focusWithFlash(el: HTMLElement, options?: FlashOptions): Promise<void>;
+export interface PressOptions extends RingOwnerOptions {
+    /** Milliseconds to hold the pressed state before clicking. Default 140. */
+    pressMs?: number;
+}
+/**
+ * Show a brief pressed affordance on a control — a slight scale-down plus
+ * accent ring — then click it and restore. Reads as a press rather than the
+ * plain outline {@link highlightThenClick} draws.
+ */
+export declare function pressThenClick(el: HTMLElement, options?: PressOptions): Promise<void>;
+export interface SelectOptions extends RingOwnerOptions {
+    /** 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 extends RingOwnerOptions {
+    /** 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;AAaH;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAUD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAmBD,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,qBAAsB,SAAQ,gBAAgB;IAC7D,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,uEAAuE;AACvE,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,WAAW,EACf,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAOD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BhG;AAQD,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAgDD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzF;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,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,aAAc,SAAQ,gBAAgB;IACrD,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,CAUf;AAED,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,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,CAQf"}

package/dist/dom/dom_driver.d.ts

@@ -0,0 +1,28 @@
+import { type FlashOptions, type HighlightClickOptions, type PressOptions, type SelectOptions, type TextLikeElement, type ToggleOptions, type TypeOptions } from "./animations.js";
+/**
+ * Every flash option except `focus`, which is not on offer: a field has to hold
+ * focus to be typed into.
+ */
+export interface FillFieldOptions extends TypeOptions, Omit<FlashOptions, "focus"> {
+}
+/**
+ * Scroll to, focus (with a flash), and type `value` into a text field.
+ *
+ * The scroll is awaited — typing into an element still gliding past shows the
+ * user nothing.
+ */
+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 animation, dispatching the `input`
+ * and `change` events frameworks listen for.
+ */
+export declare function setControlValue(el: HTMLInputElement | HTMLSelectElement, value: string | boolean): void;
+//# sourceMappingURL=dom_driver.d.ts.map

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,EACL,KAAK,YAAY,EAEjB,KAAK,qBAAqB,EAE1B,KAAK,YAAY,EAEjB,KAAK,aAAa,EAGlB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAGjB,MAAM,iBAAiB,CAAC;AAIzB;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,WAAW,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC;CAAG;AAErF;;;;;GAKG;AACH,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,CAON"}

package/dist/dom/highlight_overlay.d.ts

@@ -0,0 +1,39 @@
+/** How the overlay is drawn around the element being pointed at. */
+export interface HighlightOverlayOptions {
+    /** Dim everything except the target. Default false. */
+    readonly scrim?: boolean;
+    /** Draw the ring as a moving gradient rather than a flat colour. Default false. */
+    readonly gradient?: boolean;
+    /**
+     * Ring colour, and the flat fallback for the gradient. Default:
+     * `--ag-ui-highlight-ring-color` on the target, then on the chat, then the
+     * target's `--ag-ui-accent`, then the chat's accent, held to 3:1 against the
+     * surface behind the target.
+     */
+    readonly color?: string;
+    /** The chat whose ring colour and accent to use. Default: the latest connected. */
+    readonly chat?: HTMLElement;
+    /** Gap between the target's box and the ring. Default 4. */
+    readonly padding?: number;
+    /** Corner radius of the cut-out and the ring. Default: the target's own. */
+    readonly radius?: number;
+    /** Ring thickness. Default 3, or `--ag-ui-highlight-ring-width` on the target. */
+    readonly ringWidth?: number;
+    /** One pass of the gradient. Default 2400, or `--ag-ui-highlight-flow-ms`. */
+    readonly flowMs?: number;
+}
+/**
+ * Draw an overlay that points at `target`, and return a function that removes it.
+ *
+ * An overlay rather than a style on the target: a flat highlight is an `outline` so an
+ * `overflow: hidden` ancestor cannot clip it, but an outline takes a colour, never a
+ * gradient, and a dim needs a surface larger than the target. Nothing here is a descendant
+ * of the target, so none of it is clipped.
+ *
+ * It is inert: it never takes a pointer event, so the driver can still click what it
+ * just pointed at.
+ *
+ * It follows: the cut-out is recomputed on scroll and resize.
+ */
+export declare function showHighlightOverlay(target: HTMLElement, options?: HighlightOverlayOptions): () => void;
+//# sourceMappingURL=highlight_overlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"highlight_overlay.d.ts","sourceRoot":"","sources":["../../src/dom/highlight_overlay.ts"],"names":[],"mappings":"AAGA,oEAAoE;AACpE,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAcD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,uBAA4B,GACpC,MAAM,IAAI,CAsFZ"}

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":"AAsBA,gEAAgE;AAChE,wBAAgB,cAAc,CAC5B,EAAE,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,iBAAiB,EAC9D,KAAK,EAAE,MAAM,GACZ,IAAI,CAQN;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAE7E"}

package/dist/dom/ring_color.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The colour a highlight ring is drawn in when the caller passed none.
+ *
+ * In order: `--ag-ui-highlight-ring-color` on the target, the same token on the chat, the
+ * target's `--ag-ui-accent`, the chat's resolved accent, the package indigo. The target's
+ * accent outranks the chat's default so a host theming its page keeps its rings; the ring
+ * token outranks both so a host can keep the ring apart from the accent. Only the
+ * chat's own accent is adjusted, since it follows the widget's scheme rather than the
+ * page's: it is held to 3:1 against the surface behind the target (see
+ * {@link surfaceBehind}) by trying the other half of its light-dark pair, then stepping
+ * toward black or white. Every other value is a host's choice and is drawn as given.
+ *
+ * `chat` defaults to the most recently connected `<ag-ui-chat>`.
+ */
+export declare function ringColor(target: HTMLElement, chat?: HTMLElement): string;
+//# sourceMappingURL=ring_color.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ring_color.d.ts","sourceRoot":"","sources":["../../src/dom/ring_color.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAmBzE"}

package/dist/dom/utils.d.ts

@@ -0,0 +1,3 @@
+/** Dispatch the `input` then `change` events frameworks listen for. */
+export declare function dispatchInputAndChange(el: HTMLElement): void;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/dom/utils.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAG5D"}

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+export { ATTACHMENT_EVENT, BAR_HEIGHT_EVENT, CHART_ACTIVITY_TYPE, COMPACTION_ACTIVITY_TYPE, CUSTOM_AGENT_EVENT, DOCK_WIDTH_EVENT, ELEMENT_TAG, FEEDBACK_EVENT, INVALIDATE_CUSTOM_NAME, INVALIDATE_EVENT, LOAD_CAPABILITY_TOOL, MAX_TOOL_ROUNDS, MAXIMIZE_EVENT, MESSAGE_ACTIONS, MESSAGE_ROLE, RUN_FINISHED_EVENT, STATE_EVENT, SUBMIT_EVENT, SUGGESTIONS_ACTIVITY_TYPE, THREAD_EVENT, THREAD_TITLE_EVENT, TOGGLE_EVENT, TOOL_CALL_STATUS, TOOL_DISPLAY, TOOL_GROUP_DISPLAY, TOOL_OUTCOME, type ToolGroupDisplayMode, UNREAD_EVENT, X_CONFIRM_KEY, X_DESTRUCTIVE_KEY, X_NAVIGATES_KEY, X_SUMMARY_KEY, } from "./constants.js";
+export type { ActivityRegistration } from "./core/activity_registration.js";
+export type { ActivityRenderer } from "./core/activity_renderer.js";
+export { AgUiClient, type AgUiClientConfig, type AgUiClientHandlers, type AgUiMessageIds, type AgUiRunInputs, type AgUiToolCall, ConnectionLostError, type ExecuteTool, type InterruptResponse, type ResolveInterrupts, type ToolExecution, } from "./core/agui_client.js";
+export { type AttachmentRef, messageAttachments } from "./core/attachment.js";
+export { type ClientConversationStore, type NavigationCheckpoint, SessionStorageStore, type ThreadMeta, } from "./core/conversation_store.js";
+export { type AgentFactory, createHttpAgent, type HttpAgentOptions, } from "./core/create_http_agent.js";
+export type { AttachmentsDetail } from "./core/events/attachments_detail.js";
+export type { BarHeightDetail } from "./core/events/bar_height_detail.js";
+export type { CustomAgentDetail } from "./core/events/custom_agent_detail.js";
+export type { DockWidthDetail } from "./core/events/dock_width_detail.js";
+export type { FeedbackDetail } from "./core/events/feedback_detail.js";
+export type { InvalidateDetail } from "./core/events/invalidate_detail.js";
+export type { MaximizeDetail } from "./core/events/maximize_detail.js";
+export type { RunFinishedDetail } from "./core/events/run_finished_detail.js";
+export type { StateDetail } from "./core/events/state_detail.js";
+export type { SubmitDetail } from "./core/events/submit_detail.js";
+export type { ThreadDetail } from "./core/events/thread_detail.js";
+export type { ThreadTitleDetail } from "./core/events/thread_title_detail.js";
+export type { ToggleDetail } from "./core/events/toggle_detail.js";
+export type { ToolRun } from "./core/events/tool_run.js";
+export type { UnreadDetail } from "./core/events/unread_detail.js";
+export type { MessageRole } from "./core/message_role.js";
+export { RemoteConversationStore } from "./core/remote_conversation_store.js";
+export { RunIndex, type RunRow } from "./core/run_index.js";
+export { type ToolOutcome, toolStatusFromOutcome } from "./core/tool_outcome.js";
+export { type TranscribeHandler, type TranscribeOptions, transcribeAudio, } from "./core/transcribe_audio.js";
+export { type UploadHandler, type UploadOptions, uploadAttachment, } from "./core/upload_attachment.js";
+export { type FlashOptions, flash, focusWithFlash, type HighlightClickOptions, highlightThenClick, type PressOptions, prefersReducedMotion, pressThenClick, type RingOwnerOptions, type ScrollOptions, 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 { type HighlightOverlayOptions, showHighlightOverlay, } from "./dom/highlight_overlay.js";
+export { setNativeChecked, setNativeValue } from "./dom/native_setter.js";
+export type { Skill } from "./skills/skill.js";
+export { CHAT_CORNERS, type ChatCorner, type ChatSurface, type ChatSurfaceReport, createChatSurfaceTools, isChatCorner, } from "./tools/chat_surface_tools.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 { createPageActionTools, PAGE_ACTIONS, type ResolvePageTarget, } from "./tools/page_action_tools.js";
+export { createPageMapContext, type PageMap } from "./tools/page_map.js";
+export { createPageStateTools, type PageState } from "./tools/page_state.js";
+export { parseToolCatalog, type ToolCatalogEntry } from "./tools/parse_tool_catalog.js";
+export { createRouteTools, type Route, type RouteMap, type RouteWithParams, } from "./tools/route_map.js";
+export type { ChartKind, ChartSeries, ChartSpec } from "./ui/charts/chart_block.js";
+export { renderChart } from "./ui/charts/chart_block.js";
+export { chartSpecFrom } from "./ui/charts/chart_spec_from.js";
+export { CHART_TOOL_NAME } from "./ui/charts/chart_tool.js";
+export { attachQuoteOffer, type PageQuoteOffer, type PageQuoteOfferOptions, } from "./ui/excerpts/page_quote_offer.js";
+export { asQuote, MAX_QUOTE_CHARS, type QuotableSelection, quotableSelection, } from "./ui/excerpts/quote_selection.js";
+export { CheckpointMenu, type CheckpointVerb } from "./ui/history/checkpoint_menu.js";
+export { type RelativeTimeFormatter, relativeTime, } from "./ui/history/relative_time.js";
+export { type ApprovalOptions, type ApprovalRenderer, type ApprovalRequest, requestApproval, } from "./ui/interrupts/approval_card.js";
+export { type ConfirmationOptions, type ConfirmationRequest, requestConfirmation, } from "./ui/interrupts/confirmation_card.js";
+export { type QuestionOptions, type QuestionRenderer, type QuestionRequest, requestQuestion, } from "./ui/interrupts/question_card.js";
+export type { Place } from "./ui/place/place.js";
+export { prettifyToolName } from "./ui/progress/prettify_tool_name.js";
+export { type SettledStatus, ToolCallCard, type ToolCallCardOptions, type ToolCallStatus, type ToolDisplayMode, type ToolPayload, type ToolPayloadFormatter, } from "./ui/progress/tool_call_card.js";
+export { attachMessageActions, type MessageActionsOptions, messageActionBar, } from "./ui/transcript/message_actions.js";
+export { type RenderMarkdownOptions, renderMarkdown } from "./ui/transcript/render_markdown.js";
+export { MAX_SUGGESTION_CHARS, MAX_SUGGESTIONS, renderSuggestionChips, suggestionPrompts, } from "./ui/transcript/suggestion_chips.js";
+export { DEFAULT_UI_STRINGS, mergeUiStrings, type UiStrings } from "./ui/ui_strings.js";
+export { VERSION } from "./version.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,223 @@
+import {
+  ATTACHMENT_EVENT,
+  AgUiClient,
+  BAR_HEIGHT_EVENT,
+  CHART_ACTIVITY_TYPE,
+  CHART_TOOL_NAME,
+  CHAT_CORNERS,
+  COMPACTION_ACTIVITY_TYPE,
+  CUSTOM_AGENT_EVENT,
+  CheckpointMenu,
+  ClientToolRegistry,
+  ConnectionLostError,
+  DEFAULT_UI_STRINGS,
+  DOCK_WIDTH_EVENT,
+  ELEMENT_TAG,
+  FEEDBACK_EVENT,
+  INVALIDATE_CUSTOM_NAME,
+  INVALIDATE_EVENT,
+  LOAD_CAPABILITY_TOOL,
+  MAXIMIZE_EVENT,
+  MAX_QUOTE_CHARS,
+  MAX_SUGGESTIONS,
+  MAX_SUGGESTION_CHARS,
+  MAX_TOOL_ROUNDS,
+  MESSAGE_ACTIONS,
+  MESSAGE_ROLE,
+  PAGE_ACTIONS,
+  RUN_FINISHED_EVENT,
+  RemoteConversationStore,
+  RunIndex,
+  STATE_EVENT,
+  SUBMIT_EVENT,
+  SUGGESTIONS_ACTIVITY_TYPE,
+  SessionStorageStore,
+  THREAD_EVENT,
+  THREAD_TITLE_EVENT,
+  TOGGLE_EVENT,
+  TOOL_CALL_STATUS,
+  TOOL_DISPLAY,
+  TOOL_GROUP_DISPLAY,
+  TOOL_OUTCOME,
+  ToolCallCard,
+  UNREAD_EVENT,
+  X_CONFIRM_KEY,
+  X_DESTRUCTIVE_KEY,
+  X_NAVIGATES_KEY,
+  X_SUMMARY_KEY,
+  asQuote,
+  attachMessageActions,
+  attachQuoteOffer,
+  chartSpecFrom,
+  createChatSurfaceTools,
+  createHttpAgent,
+  createPageActionTools,
+  createPageMapContext,
+  createPageStateTools,
+  createRouteTools,
+  dispatchInputAndChange,
+  flash,
+  focusWithFlash,
+  highlightThenClick,
+  isChatCorner,
+  isDestructive,
+  isNavigates,
+  mergeUiStrings,
+  messageActionBar,
+  messageAttachments,
+  parseToolCatalog,
+  prefersReducedMotion,
+  pressThenClick,
+  prettifyToolName,
+  quotableSelection,
+  relativeTime,
+  renderChart,
+  renderMarkdown,
+  renderSuggestionChips,
+  requestApproval,
+  requestConfirmation,
+  requestQuestion,
+  scrollIntoCenterView,
+  selectOption,
+  setNativeChecked,
+  setNativeValue,
+  showHighlightOverlay,
+  suggestionPrompts,
+  toggleControl,
+  toolStatusFromOutcome,
+  transcribeAudio,
+  typeInto,
+  uploadAttachment
+} from "./chunk-ARNLFGCC.js";
+
+// src/dom/dom_driver.ts
+async function fillField(el, value, options = {}) {
+  await scrollIntoCenterView(el);
+  await focusWithFlash(el, { ...options, flashMs: options.flashMs ?? 0 });
+  await typeInto(el, value, options);
+}
+async function clickElement(el, options = {}) {
+  await scrollIntoCenterView(el);
+  await highlightThenClick(el, options);
+}
+async function pressButton(el, options = {}) {
+  await scrollIntoCenterView(el);
+  await pressThenClick(el, options);
+}
+async function selectControl(el, value, options = {}) {
+  await scrollIntoCenterView(el);
+  await selectOption(el, value, options);
+}
+async function toggleCheckbox(el, checked, options = {}) {
+  await scrollIntoCenterView(el);
+  await toggleControl(el, checked, options);
+}
+function setControlValue(el, value) {
+  if (el instanceof HTMLInputElement && el.type === "checkbox") {
+    setNativeChecked(el, Boolean(value));
+  } else {
+    setNativeValue(el, String(value));
+  }
+  dispatchInputAndChange(el);
+}
+
+// src/version.ts
+var VERSION = "0.1.1";
+export {
+  ATTACHMENT_EVENT,
+  AgUiClient,
+  BAR_HEIGHT_EVENT,
+  CHART_ACTIVITY_TYPE,
+  CHART_TOOL_NAME,
+  CHAT_CORNERS,
+  COMPACTION_ACTIVITY_TYPE,
+  CUSTOM_AGENT_EVENT,
+  CheckpointMenu,
+  ClientToolRegistry,
+  ConnectionLostError,
+  DEFAULT_UI_STRINGS,
+  DOCK_WIDTH_EVENT,
+  ELEMENT_TAG,
+  FEEDBACK_EVENT,
+  INVALIDATE_CUSTOM_NAME,
+  INVALIDATE_EVENT,
+  LOAD_CAPABILITY_TOOL,
+  MAXIMIZE_EVENT,
+  MAX_QUOTE_CHARS,
+  MAX_SUGGESTIONS,
+  MAX_SUGGESTION_CHARS,
+  MAX_TOOL_ROUNDS,
+  MESSAGE_ACTIONS,
+  MESSAGE_ROLE,
+  PAGE_ACTIONS,
+  RUN_FINISHED_EVENT,
+  RemoteConversationStore,
+  RunIndex,
+  STATE_EVENT,
+  SUBMIT_EVENT,
+  SUGGESTIONS_ACTIVITY_TYPE,
+  SessionStorageStore,
+  THREAD_EVENT,
+  THREAD_TITLE_EVENT,
+  TOGGLE_EVENT,
+  TOOL_CALL_STATUS,
+  TOOL_DISPLAY,
+  TOOL_GROUP_DISPLAY,
+  TOOL_OUTCOME,
+  ToolCallCard,
+  UNREAD_EVENT,
+  VERSION,
+  X_CONFIRM_KEY,
+  X_DESTRUCTIVE_KEY,
+  X_NAVIGATES_KEY,
+  X_SUMMARY_KEY,
+  asQuote,
+  attachMessageActions,
+  attachQuoteOffer,
+  chartSpecFrom,
+  clickElement,
+  createChatSurfaceTools,
+  createHttpAgent,
+  createPageActionTools,
+  createPageMapContext,
+  createPageStateTools,
+  createRouteTools,
+  fillField,
+  flash,
+  focusWithFlash,
+  highlightThenClick,
+  isChatCorner,
+  isDestructive,
+  isNavigates,
+  mergeUiStrings,
+  messageActionBar,
+  messageAttachments,
+  parseToolCatalog,
+  prefersReducedMotion,
+  pressButton,
+  pressThenClick,
+  prettifyToolName,
+  quotableSelection,
+  relativeTime,
+  renderChart,
+  renderMarkdown,
+  renderSuggestionChips,
+  requestApproval,
+  requestConfirmation,
+  requestQuestion,
+  scrollIntoCenterView,
+  selectControl,
+  selectOption,
+  setControlValue,
+  setNativeChecked,
+  setNativeValue,
+  showHighlightOverlay,
+  suggestionPrompts,
+  toggleCheckbox,
+  toggleControl,
+  toolStatusFromOutcome,
+  transcribeAudio,
+  typeInto,
+  uploadAttachment
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/dom/dom_driver.ts", "../src/version.ts"],
+  "sourcesContent": ["import {\n  type FlashOptions,\n  focusWithFlash,\n  type HighlightClickOptions,\n  highlightThenClick,\n  type PressOptions,\n  pressThenClick,\n  type SelectOptions,\n  scrollIntoCenterView,\n  selectOption,\n  type TextLikeElement,\n  type ToggleOptions,\n  type TypeOptions,\n  toggleControl,\n  typeInto,\n} from \"./animations.js\";\nimport { setNativeChecked, setNativeValue } from \"./native_setter.js\";\nimport { dispatchInputAndChange } from \"./utils.js\";\n\n/**\n * Every flash option except `focus`, which is not on offer: a field has to hold\n * focus to be typed into.\n */\nexport interface FillFieldOptions extends TypeOptions, Omit<FlashOptions, \"focus\"> {}\n\n/**\n * Scroll to, focus (with a flash), and type `value` into a text field.\n *\n * The scroll is awaited \u2014 typing into an element still gliding past shows the\n * user nothing.\n */\nexport async function fillField(\n  el: TextLikeElement,\n  value: string,\n  options: FillFieldOptions = {},\n): Promise<void> {\n  await scrollIntoCenterView(el);\n  await focusWithFlash(el, { ...options, flashMs: options.flashMs ?? 0 });\n  await typeInto(el, value, options);\n}\n\n/** Scroll to, highlight, and click an element. */\nexport async function clickElement(\n  el: HTMLElement,\n  options: HighlightClickOptions = {},\n): Promise<void> {\n  await scrollIntoCenterView(el);\n  await highlightThenClick(el, options);\n}\n\n/** Scroll to a button/control and click it with a visible \"press\" animation. */\nexport async function pressButton(el: HTMLElement, options: PressOptions = {}): Promise<void> {\n  await scrollIntoCenterView(el);\n  await pressThenClick(el, options);\n}\n\n/** Scroll to a `<select>`, highlight it, and pick the matching option (animated). */\nexport async function selectControl(\n  el: HTMLSelectElement,\n  value: string,\n  options: SelectOptions = {},\n): Promise<void> {\n  await scrollIntoCenterView(el);\n  await selectOption(el, value, options);\n}\n\n/** Scroll to a checkbox/radio, flash it, and set its checked state (animated). */\nexport async function toggleCheckbox(\n  el: HTMLInputElement,\n  checked: boolean,\n  options: ToggleOptions = {},\n): Promise<void> {\n  await scrollIntoCenterView(el);\n  await toggleControl(el, checked, options);\n}\n\n/**\n * Set a `<select>` or checkbox value without animation, dispatching the `input`\n * and `change` events frameworks listen for.\n */\nexport function setControlValue(\n  el: HTMLInputElement | HTMLSelectElement,\n  value: string | boolean,\n): void {\n  if (el instanceof HTMLInputElement && el.type === \"checkbox\") {\n    setNativeChecked(el, Boolean(value));\n  } else {\n    setNativeValue(el, String(value));\n  }\n  dispatchInputAndChange(el);\n}\n", "export const VERSION: string = \"0.1.1\";\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,eAAsB,UACpB,IACA,OACA,UAA4B,CAAC,GACd;AACf,QAAM,qBAAqB,EAAE;AAC7B,QAAM,eAAe,IAAI,EAAE,GAAG,SAAS,SAAS,QAAQ,WAAW,EAAE,CAAC;AACtE,QAAM,SAAS,IAAI,OAAO,OAAO;AACnC;AAGA,eAAsB,aACpB,IACA,UAAiC,CAAC,GACnB;AACf,QAAM,qBAAqB,EAAE;AAC7B,QAAM,mBAAmB,IAAI,OAAO;AACtC;AAGA,eAAsB,YAAY,IAAiB,UAAwB,CAAC,GAAkB;AAC5F,QAAM,qBAAqB,EAAE;AAC7B,QAAM,eAAe,IAAI,OAAO;AAClC;AAGA,eAAsB,cACpB,IACA,OACA,UAAyB,CAAC,GACX;AACf,QAAM,qBAAqB,EAAE;AAC7B,QAAM,aAAa,IAAI,OAAO,OAAO;AACvC;AAGA,eAAsB,eACpB,IACA,SACA,UAAyB,CAAC,GACX;AACf,QAAM,qBAAqB,EAAE;AAC7B,QAAM,cAAc,IAAI,SAAS,OAAO;AAC1C;AAMO,SAAS,gBACd,IACA,OACM;AACN,MAAI,cAAc,oBAAoB,GAAG,SAAS,YAAY;AAC5D,qBAAiB,IAAI,QAAQ,KAAK,CAAC;AAAA,EACrC,OAAO;AACL,mBAAe,IAAI,OAAO,KAAK,CAAC;AAAA,EAClC;AACA,yBAAuB,EAAE;AAC3B;;;AC1FO,IAAM,UAAkB;",
+  "names": []
+}

package/dist/skills/fill_template.d.ts

@@ -0,0 +1,16 @@
+/** Result of {@link fillTemplate}: the filled text plus any unresolved keys. */
+export interface TemplateResult {
+    /** The prompt with resolved `{placeholder}`s substituted. */
+    readonly text: string;
+    /** Placeholder names with no value available (deduped, in first-seen order). */
+    readonly missing: readonly string[];
+}
+/**
+ * Substitute `{name}` placeholders in `template` from `values`.
+ *
+ * A placeholder whose value is missing, `null`, or an empty string is left
+ * verbatim and reported in `missing`, so the caller can block the send rather
+ * than dispatch a half-filled prompt.
+ */
+export declare function fillTemplate(template: string, values: Record<string, unknown>): TemplateResult;
+//# sourceMappingURL=fill_template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fill_template.d.ts","sourceRoot":"","sources":["../../src/skills/fill_template.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAID;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAa9F"}

package/dist/skills/parse_skills.d.ts

@@ -0,0 +1,8 @@
+import type { Skill } from "./skill.js";
+/**
+ * Parse an untrusted value (parsed JSON from `data-skills` or a skills
+ * endpoint) into a list of {@link Skill}s, dropping anything malformed. Never
+ * throws — a bad payload yields an empty list.
+ */
+export declare function parseSkills(value: unknown): Skill[];
+//# sourceMappingURL=parse_skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse_skills.d.ts","sourceRoot":"","sources":["../../src/skills/parse_skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAoBxC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,EAAE,CAKnD"}

package/dist/skills/skill.d.ts

@@ -0,0 +1,33 @@
+/**
+ * A pre-defined prompt the user can launch from the chat — surfaced as a chip
+ * and/or in the `/`-command palette. One catalog feeds both surfaces; the host
+ * provides skills via the `skills` property / `data-skills` attribute / a
+ * fetched endpoint (see {@link AgUiChat}).
+ */
+export interface Skill {
+    /** Stable id; the `/token` (kebab-case) in the palette. */
+    readonly name: string;
+    /** Label shown in chips and the palette. */
+    readonly title: string;
+    /** Secondary line shown in the palette. */
+    readonly description?: string;
+    /**
+     * The prompt to send. May contain `{placeholder}`s filled from the host's
+     * skill context before send; an unfilled placeholder blocks send.
+     *
+     * Omit it to keep the prompt server-side: the skill then sends the bare
+     * `/name` token for the agent to resolve, and the wording never reaches the
+     * browser. Prefer that for anything internal — a fetched catalog is a plain
+     * GET and an embedded one sits in the page source.
+     */
+    readonly prompt?: string;
+    /**
+     * Set `false` to pre-fill the composer instead of sending on pick. Defaults
+     * to sending, and is only meaningful for a skill carrying its own `prompt`;
+     * a server-resolved one always sends.
+     */
+    readonly sendImmediately?: boolean;
+    /** Also surface this skill as a chip (default false; the palette shows all). */
+    readonly chip?: boolean;
+}
+//# sourceMappingURL=skill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/skills/skill.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,gFAAgF;IAChF,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB"}