@opencx/widget-react 5.0.0-beta.6 → 5.0.0-beta.9

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("react/jsx-runtime");require("@radix-ui/react-popover");require("framer-motion");require("react");require("@opencx/widget-react-headless");const e=require("./index-BBzL0SrG.cjs");exports.HostedSpecRenderer=e.HostedSpecRenderer;exports.Widget=e.Widget;exports.segmentContent=e.segmentContent;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("react/jsx-runtime");require("@radix-ui/react-popover");require("framer-motion");require("react");require("@opencx/widget-react-headless");const e=require("./index-BQvciEuH.cjs");exports.HostedSpecRenderer=e.HostedSpecRenderer;exports.Widget=e.Widget;exports.segmentContent=e.segmentContent;
 //# sourceMappingURL=index.cjs.map

package/dist/index.js

@@ -3,7 +3,7 @@ import "@radix-ui/react-popover";
 import "framer-motion";
 import "react";
 import "@opencx/widget-react-headless";
-import { H as s, W as n, s as a } from "./index-CYkoYO0G.js";
+import { H as s, W as n, s as a } from "./index-CYVpvKPr.js";
 export {
   s as HostedSpecRenderer,
   n as Widget,

package/dist/package.json.d.ts

@@ -1,7 +1,7 @@
 declare const _default: {
   "name": "@opencx/widget-react",
   "private": false,
-  "version": "5.0.0-beta.6",
+  "version": "5.0.0-beta.9",
   "type": "module",
   "repository": {
     "type": "git",

package/dist/src/companion/ChatPicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatPicker.d.ts","sourceRoot":"","sources":["../../../src/companion/ChatPicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAMN,MAAM,OAAO,CAAC;AAKf,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKrD,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,GAAG,KAAK,EACT,EAAE,WAAW,GAAG;IACf,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;CAC1C,qBA2BA;AA+ED,KAAK,eAAe,GAAG;IACrB,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IACzC,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,4BAShD"}
+{"version":3,"file":"ChatPicker.d.ts","sourceRoot":"","sources":["../../../src/companion/ChatPicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAMN,MAAM,OAAO,CAAC;AAKf,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKrD,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,GAAG,KAAK,EACT,EAAE,WAAW,GAAG;IACf,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;CAC1C,qBAgCA;AA+ED,KAAK,eAAe,GAAG;IACrB,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IACzC,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,4BAShD"}

package/dist/src/components/ConnectionCard.d.ts

@@ -0,0 +1,6 @@
+import { ConnectionRequest } from '@opencx/widget-react-headless';
+import { default as React } from 'react';
+export declare function ConnectionCard({ request }: {
+    request: ConnectionRequest;
+}): React.JSX.Element;
+//# sourceMappingURL=ConnectionCard.d.ts.map

package/dist/src/components/ConnectionCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionCard.d.ts","sourceRoot":"","sources":["../../../src/components/ConnectionCard.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,iBAAiB,CAAA;CAAE,qBA0HzE"}

package/dist/src/components/ConnectionsSettings.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export declare function ConnectionsSettings({ children, }: {
+    children: React.ReactNode;
+}): React.JSX.Element;
+//# sourceMappingURL=ConnectionsSettings.d.ts.map

package/dist/src/components/ConnectionsSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionsSettings.d.ts","sourceRoot":"","sources":["../../../src/components/ConnectionsSettings.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAcnD,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,qBAqPA"}

package/dist/src/components/ElicitationForm.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+import { ElicitationRequest, ElicitationResponse } from '@opencx/widget-core';
+export declare function ElicitationForm({ sessionId, active, }: {
+    sessionId: string;
+    active: boolean;
+}): React.JSX.Element;
+export declare function RequestForm({ request, onAnswer, }: {
+    request: ElicitationRequest;
+    onAnswer: (answer: ElicitationResponse) => Promise<void>;
+}): React.JSX.Element;
+//# sourceMappingURL=ElicitationForm.d.ts.map

package/dist/src/components/ElicitationForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElicitationForm.d.ts","sourceRoot":"","sources":["../../../src/components/ElicitationForm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAEnD,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAK7B,wBAAgB,eAAe,CAAC,EAC9B,SAAS,EACT,MAAM,GACP,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB,qBA+CA;AAED,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D,qBA4OA"}

package/dist/src/components/MessageActions.d.ts

@@ -1,7 +1,7 @@
 import { WidgetAiMessage } from '@opencx/widget-core';
 import { default as React } from 'react';
 /** The reply as text: every message of the group, citation tags removed. */
-export declare function replyText(messages: readonly WidgetAiMessage[]): string;
+export declare function replyText(messages: readonly Pick<WidgetAiMessage, 'data'>[]): string;
 /**
  * Whether the copy button shows. The companion is the v5-native surface and
  * gets it out of the box; the popover is what a v4 embed upgrades into and
@@ -16,6 +16,6 @@ export declare function useShowsCopyAction(): boolean;
  * insecure-origin host page — rather than showing a button that fails.
  */
 export declare function MessageActions({ messages, }: {
-    messages: readonly WidgetAiMessage[];
+    messages: readonly Pick<WidgetAiMessage, 'data'>[];
 }): React.JSX.Element | null;
 //# sourceMappingURL=MessageActions.d.ts.map

package/dist/src/components/MessageActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageActions.d.ts","sourceRoot":"","sources":["../../../src/components/MessageActions.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,KAAsC,MAAM,OAAO,CAAC;AAU3D,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAKtE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAI5C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CACtC,4BAoEA"}
+{"version":3,"file":"MessageActions.d.ts","sourceRoot":"","sources":["../../../src/components/MessageActions.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,KAAsC,MAAM,OAAO,CAAC;AAU3D,4EAA4E;AAC5E,wBAAgB,SAAS,CACvB,QAAQ,EAAE,SAAS,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,GACjD,MAAM,CAKR;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAI5C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,CAAC;CACpD,4BAoEA"}

package/dist/src/components/PageActionCard.d.ts

@@ -0,0 +1,17 @@
+import { PendingPageAction } from '@opencx/widget-react-headless';
+import { default as React } from 'react';
+/**
+ * The moment the visitor decides.
+ *
+ * It names the control — the control's own name, read off their page, not
+ * anything the agent wrote — because "Allow this action?" is a question
+ * nobody reads, and "Allow the agent to click Cancel subscription?" is a
+ * question everybody reads.
+ *
+ * One chip at a time, and No is final: the agent is told it was declined
+ * and does not get to ask again or reach the same control another way.
+ */
+export declare function PageActionCard({ request }: {
+    request: PendingPageAction;
+}): React.JSX.Element;
+//# sourceMappingURL=PageActionCard.d.ts.map

package/dist/src/components/PageActionCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageActionCard.d.ts","sourceRoot":"","sources":["../../../src/components/PageActionCard.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,MAAM,OAAO,CAAC;AAY1B;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,iBAAiB,CAAA;CAAE,qBAiCzE"}

package/dist/src/components/StreamingTurn.d.ts

@@ -25,9 +25,15 @@ export declare function StreamingTurn({ turn, agent, timestamp, }: {
  * Assembles the accumulating spec from the turn's `data-spec` patches and
  * renders it through the shared `SpecRenderer` seam (same defenses as the
  * persisted-history path).
+ *
+ * `active` is the turn's own flag: while it streams, containers whose content
+ * has not arrived show a shimmer; once the turn settles they show their
+ * ordinary empty state. Optional so an embedder's custom spec component (and
+ * a direct render) keeps compiling without it.
  */
 export type StreamingSpecComponentProps = {
     parts: SpecDataPart[];
+    active?: boolean;
 };
-export declare function StreamingSpec({ parts }: StreamingSpecComponentProps): React.JSX.Element;
+export declare function StreamingSpec({ parts, active, }: StreamingSpecComponentProps): React.JSX.Element;
 //# sourceMappingURL=StreamingTurn.d.ts.map

package/dist/src/components/StreamingTurn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StreamingTurn.d.ts","sourceRoot":"","sources":["../../../src/components/StreamingTurn.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,YAAY,EAEZ,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAA4B,MAAM,OAAO,CAAC;AAMjD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,KAAK,EACL,SAAS,GACV,EAAE;IACD,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAChC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,qBAgFA;AAOD;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG;IAAE,KAAK,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC;AAEpE,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,EAAE,2BAA2B,qBAKnE"}
+{"version":3,"file":"StreamingTurn.d.ts","sourceRoot":"","sources":["../../../src/components/StreamingTurn.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,YAAY,EAEZ,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAA4B,MAAM,OAAO,CAAC;AAOjD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,KAAK,EACL,SAAS,GACV,EAAE;IACD,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAChC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,qBAiGA;AAOD;;;;;;;;;GASG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,MAAc,GACf,EAAE,2BAA2B,qBAK7B"}

package/dist/src/components/lib/McpIcon.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+/** Official MCP mark: https://github.com/modelcontextprotocol/docs/blob/main/favicon.svg */
+export declare function McpIcon(): React.JSX.Element;
+//# sourceMappingURL=McpIcon.d.ts.map

package/dist/src/components/lib/McpIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpIcon.d.ts","sourceRoot":"","sources":["../../../../src/components/lib/McpIcon.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;EAsBE;AACF,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,4FAA4F;AAC5F,wBAAgB,OAAO,sBAgBtB"}

package/dist/src/components/lib/button.d.ts

@@ -6,6 +6,8 @@ declare const buttonVariants: (props?: ({
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
     asChild?: boolean;
+    /** Disable decorative pointer-follow movement for stable action targets. */
+    wobble?: boolean;
 }
 declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
 export { Button, buttonVariants };

package/dist/src/components/lib/button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../../src/components/lib/button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAKlE,QAAA,MAAM,cAAc;;;8EAuCnB,CAAC;AAEF,MAAM,WAAW,WACf,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EACnD,YAAY,CAAC,OAAO,cAAc,CAAC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,QAAA,MAAM,MAAM,uFAiBX,CAAC;AAGF,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../../src/components/lib/button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAKlE,QAAA,MAAM,cAAc;;;8EAuCnB,CAAC;AAEF,MAAM,WAAW,WACf,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EACnD,YAAY,CAAC,OAAO,cAAc,CAAC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,QAAA,MAAM,MAAM,uFAwBX,CAAC;AAGF,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC"}

package/dist/src/components/lib/wobble.d.ts

@@ -9,9 +9,9 @@ export declare const WOBBLE_MAX_MOVEMENT_PIXELS: {
     y: number;
 };
 type ChildProps = {
-    onMouseMove?: (event: React.MouseEvent<HTMLElement>) => void;
-    onMouseEnter?: () => void;
-    onMouseLeave?: () => void;
+    onMouseMove?: React.MouseEventHandler<HTMLElement>;
+    onMouseEnter?: React.MouseEventHandler<HTMLElement>;
+    onMouseLeave?: React.MouseEventHandler<HTMLElement>;
     style?: React.CSSProperties;
     className?: string;
     ref: React.ForwardedRef<HTMLElement>;

package/dist/src/components/lib/wobble.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wobble.d.ts","sourceRoot":"","sources":["../../../../src/components/lib/wobble.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAGZ,KAAK,YAAY,EAElB,MAAM,OAAO,CAAC;AAIf;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;CAGtC,CAAC;AAIF,KAAK,UAAU,GAAG;IAChB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC7D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,QAAA,MAAM,MAAM,4EAgFX,CAAC;AAIF,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"wobble.d.ts","sourceRoot":"","sources":["../../../../src/components/lib/wobble.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAGZ,KAAK,YAAY,EAElB,MAAM,OAAO,CAAC;AAMf;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;CAGtC,CAAC;AAIF,KAAK,UAAU,GAAG;IAChB,WAAW,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACnD,YAAY,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACpD,YAAY,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACpD,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,QAAA,MAAM,MAAM,4EAoFX,CAAC;AAIF,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/src/hooks/useCanHover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCanHover.d.ts","sourceRoot":"","sources":["../../../src/hooks/useCanHover.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAOrC"}
+{"version":3,"file":"useCanHover.d.ts","sourceRoot":"","sources":["../../../src/hooks/useCanHover.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAQrC"}

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAGV,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAML,KAAK,mBAAmB,EACzB,MAAM,+BAA+B,CAAC;AAUvC,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAEL,KAAK,SAAS,EACf,MAAM,2BAA2B,CAAC;AA6EnC,QAAA,MAAM,MAAM;aAGC,YAAY;iBACR,mBAAmB,EAAE;uBACf,KAAK,CAAC,SAAS;qBACjB,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC,SAAS;mCAgDpD,CAAC;AAGH,OAAO,EAAE,MAAM,EAAE,CAAC;AAClB;;;;;GAKG;AACH,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,SAAS,GACV,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAGV,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAML,KAAK,mBAAmB,EACzB,MAAM,+BAA+B,CAAC;AAWvC,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAEL,KAAK,SAAS,EACf,MAAM,2BAA2B,CAAC;AA6EnC,QAAA,MAAM,MAAM;aAGC,YAAY;iBACR,mBAAmB,EAAE;uBACf,KAAK,CAAC,SAAS;qBACjB,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC,SAAS;mCAkDpD,CAAC;AAGH,OAAO,EAAE,MAAM,EAAE,CAAC;AAClB;;;;;GAKG;AACH,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,SAAS,GACV,CAAC"}

package/dist/src/json-render/Chart.impl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Chart.impl.d.ts","sourceRoot":"","sources":["../../../src/json-render/Chart.impl.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAgB1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAuD1C,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EAChC,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,WAAW,GACZ,EAAE,UAAU,qBAsGZ"}
+{"version":3,"file":"Chart.impl.d.ts","sourceRoot":"","sources":["../../../src/json-render/Chart.impl.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAgB1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AA2F1C,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EAChC,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,WAAW,GACZ,EAAE,UAAU,qBAwHZ"}

package/dist/src/json-render/SpecRenderer.d.ts

@@ -9,9 +9,14 @@ import { default as React } from 'react';
  * Applies leaf-`repeat` recovery, guards empty/partial specs, and renders under
  * a per-spec state provider (so `{ "$state": "/path" }` refs resolve against
  * THIS spec's own state) wrapped in an error boundary.
+ *
+ * `active` says the spec is still being streamed: containers with nothing to
+ * paint yet show a shimmer instead of their settled empty state. History and
+ * settled turns leave it off.
  */
-export declare function SpecRenderer({ spec }: {
+export declare function SpecRenderer({ spec, active, }: {
     spec: Spec | null;
+    active?: boolean;
 }): React.JSX.Element;
 /**
  * The same renderer for a page that is not the widget but shows what the

package/dist/src/json-render/SpecRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SpecRenderer.d.ts","sourceRoot":"","sources":["../../../src/json-render/SpecRenderer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAkB,MAAM,OAAO,CAAC;AAWvC;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,qBAQ3D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,YAAY,GACb,EAAE;IACD,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,qBAGA"}
+{"version":3,"file":"SpecRenderer.d.ts","sourceRoot":"","sources":["../../../src/json-render/SpecRenderer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAkB,MAAM,OAAO,CAAC;AAWvC;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,MAAc,GACf,EAAE;IACD,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,qBAQA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,YAAY,GACb,EAAE;IACD,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,qBAGA"}

package/dist/src/json-render/StreamingShimmer.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+/**
+ * The placeholder a container shows while its spec is still streaming and it
+ * has nothing to paint yet — the same pulse the lazy Chart holds its space
+ * with (`ChartShimmer` in `Chart.tsx`), so an empty Card, List, Table, Grid or
+ * Stack mid-stream reads as "loading" rather than as a bare frame or an "empty"
+ * message that flips to content a moment later.
+ */
+export declare function StreamingShimmer({ height }: {
+    height?: number;
+}): React.JSX.Element;
+//# sourceMappingURL=StreamingShimmer.d.ts.map

package/dist/src/json-render/StreamingShimmer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamingShimmer.d.ts","sourceRoot":"","sources":["../../../src/json-render/StreamingShimmer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,MAAW,EAAE,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,qBAQpE"}

package/dist/src/json-render/chart-axis.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Y-axis sizing for the cartesian charts.
+ *
+ * recharts 2.x has no auto-width axis: `YAxis.width` is a fixed number, and a
+ * tick label wider than the room left of its tick pokes out past the svg's
+ * left edge, where the viewport clips it. That is how a 120/80/150/90/200 bar
+ * chart rendered "0" for every tick in the 400px chat panel — only the last
+ * digit of each label survived. The axis is sized from the labels recharts
+ * actually painted instead: measured in a browser, estimated where the text
+ * cannot be measured (jsdom, a hidden embed).
+ */
+/** recharts' painted Y tick labels (`<text>`, right-anchored at their `x`). */
+export declare const Y_TICK_LABEL_SELECTOR = ".recharts-yAxis .recharts-cartesian-axis-tick-value";
+export declare function estimateTextWidth(text: string, fontSize: number): number;
+/**
+ * The painted width of an svg text node: the browser's glyph run when it can
+ * report one (a non-positive length means not laid out — a hidden embed), the
+ * estimate otherwise.
+ */
+export declare function measureSvgTextWidth(node: Element, fontSize: number): number;
+/**
+ * The narrowest `YAxis.width` that keeps every painted tick label inside the
+ * svg, or `null` when no Y ticks are in the DOM (a pie, or nothing painted
+ * yet). Derived from geometry, not from recharts constants: each label's
+ * right edge sits at its tick's `x`, and `currentWidth - x` is whatever gap
+ * the axis reserves between label and plot — so the requirement is the widest
+ * label plus that gap, whichever tick size/margin recharts applied.
+ */
+export declare function requiredYAxisWidth(container: ParentNode, currentWidth: number, fontSize: number): number | null;
+//# sourceMappingURL=chart-axis.d.ts.map

package/dist/src/json-render/chart-axis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-axis.d.ts","sourceRoot":"","sources":["../../../src/json-render/chart-axis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,wDACqB,CAAC;AAExD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExE;AAYD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM3E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,UAAU,EACrB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAaf"}

package/dist/src/json-render/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/json-render/registry.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAkE5E,eAAO,MAAQ,QAAQ,gDAsOrB,CAAC;AAEH,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,EAAE,iBAOhC,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/json-render/registry.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAwE5E,eAAO,MAAQ,QAAQ,gDA4OrB,CAAC;AAEH,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,EAAE,iBAOhC,CAAC"}

package/dist/src/json-render/segment-content.d.ts

@@ -14,12 +14,20 @@ export type ContentSegment = {
  * fence (persist raw, transform on serve). So the history path re-derives the
  * spec from the stored text here.
  *
- * There is exactly ONE spec format: JSONL patch lines inside a ` ```spec `
- * fence — what the prompt instructs the model to emit and what every tool
- * that hands back a card emits. Everything else is markdown. A fence is consumed only after its patches compile to nonempty UI;
- * malformed, unsupported, empty, and incomplete-only fences remain visible as
- * their original fenced markdown. An unclosed fence (turn cut mid-stream)
- * still compiles when enough valid patches arrived.
+ * There is exactly ONE spec format: JSONL patch lines — what the prompt
+ * instructs the model to emit inside a ` ```spec ` fence and what every tool
+ * that hands back a card emits. A model that forgets the fence still emits the
+ * same lines, and the live stream renders them as UI regardless (its transform
+ * drains every patch-shaped line, fenced or not), so a run of consecutive bare
+ * patch lines outside any fence is a spec block too — otherwise a reloaded
+ * transcript shows raw JSON where the customer watched a card.
+ *
+ * Everything else is markdown. A spec block (fenced or bare) is consumed only
+ * after its patches compile to renderable UI; malformed, unsupported, empty,
+ * and incomplete-only blocks remain visible as their original text. An
+ * unclosed fence (turn cut mid-stream) still compiles when enough valid
+ * patches arrived, and a cut-off patch line ending a bare run at the very end
+ * of the text is the run's tail, never a stray `{"op":...` bubble.
  */
 export declare function segmentContent(text: string): ContentSegment[];
 //# sourceMappingURL=segment-content.d.ts.map

package/dist/src/json-render/segment-content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"segment-content.d.ts","sourceRoot":"","sources":["../../../src/json-render/segment-content.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,IAAI,EACV,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAE/B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAmF7D"}
+{"version":3,"file":"segment-content.d.ts","sourceRoot":"","sources":["../../../src/json-render/segment-content.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,IAAI,EACV,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAoH7D"}

package/dist/src/page-controls/accessible-name.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The accessible name of a control — the words a screen reader would say.
+ *
+ * This is the whole point of reading the page: a customer says "the Change
+ * plan button", and the only way that matches a node is if we resolved the
+ * name the same way their browser does. A CSS class or a tag name is not a
+ * name; `aria-label`, a `<label>`, a `placeholder` and the visible text are.
+ *
+ * A trimmed-down accname resolution, in spec order for the cases that occur
+ * on real pages: aria-labelledby → aria-label → the native label (label
+ * element, legend, alt, title-of-image) → visible text → placeholder →
+ * title. `value` is NEVER a name source, even where the spec allows it for
+ * buttons, because an `<input type="submit" value="…">` is the one place
+ * where a field's value and its name are the same string, and letting it
+ * through would make "no values" depend on an input type.
+ */
+/**
+ * Resolve the name. Returns '' when the control has none — a nameless
+ * control is one the agent cannot talk about, so the reader drops it rather
+ * than inventing a name out of markup.
+ */
+export declare function accessibleName(el: HTMLElement): string;
+//# sourceMappingURL=accessible-name.d.ts.map

package/dist/src/page-controls/accessible-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessible-name.d.ts","sourceRoot":"","sources":["../../../src/page-controls/accessible-name.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAqDH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAwCtD"}

package/dist/src/page-controls/act-input.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+/**
+ * What the agent is allowed to ask for. `ref` is the only way to name a
+ * control — there is no selector and no text — and the action set is closed,
+ * so an invented verb is refused rather than interpreted.
+ */
+export declare const actOnPageInputSchema: z.ZodObject<{
+    ref: z.ZodString;
+    action: z.ZodEnum<{
+        fill: "fill";
+        select: "select";
+        check: "check";
+        click: "click";
+        uncheck: "uncheck";
+    }>;
+    value: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+//# sourceMappingURL=act-input.d.ts.map

package/dist/src/page-controls/act-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"act-input.d.ts","sourceRoot":"","sources":["../../../src/page-controls/act-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAK/B,CAAC"}

package/dist/src/page-controls/act-types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Doing something on the customer's page, and knowing whether it happened.
+ *
+ * The rule that shapes all of this: the agent may only report what the page
+ * actually did. Firing a click is easy; knowing whether the click DID
+ * anything is the work, and it is the difference between "I've cancelled
+ * your subscription" and the truth.
+ */
+/** What the agent can do to a control. Deliberately small. */
+export declare const PAGE_ACTIONS: readonly ["click", "fill", "select", "check", "uncheck"];
+export type PageAction = (typeof PAGE_ACTIONS)[number];
+/**
+ * Actions that COMMIT something on the customer's behalf — money moves, a
+ * record is destroyed, a form is submitted. These never happen without the
+ * visitor saying yes to that exact control, first.
+ *
+ * Recognised from what the control IS and what it SAYS, because that is all
+ * a page reliably tells us. It over-includes on purpose: asking about a
+ * harmless "Apply filters" button costs one chip, and not asking about
+ * "Delete account" costs an account.
+ */
+export declare const COMMITTING_WORDS: RegExp;
+/** The answer, in the same words the server and the agent use. */
+export type ActOutcome = 'done' | 'covered' | 'gone' | 'hidden' | 'unsupported' | 'no_change' | 'declined';
+export type ActResult = {
+    outcome: ActOutcome;
+    /** One short sentence for the agent to pass on. Never page text. */
+    detail?: string;
+};
+/**
+ * How long the page gets to react before we look at what changed. Long
+ * enough for a re-render, a menu to open or a fetch to come back on a local
+ * network; short enough that the turn's round trip stays under its budget.
+ */
+export declare const SETTLE_MS = 500;
+/**
+ * Controls the widget will never act on, whatever the agent asks and
+ * whatever the visitor allows. A password or a file picker is not something
+ * an agent types into, and a control inside a cross-origin frame is not
+ * something this page can honestly report on.
+ */
+export declare const NEVER_ACT_INPUT_TYPES: Set<string>;
+//# sourceMappingURL=act-types.d.ts.map

package/dist/src/page-controls/act-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"act-types.d.ts","sourceRoot":"","sources":["../../../src/page-controls/act-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,YAAY,0DAMf,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,QAC4M,CAAC;AAE1O,kEAAkE;AAClE,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,SAAS,GACT,MAAM,GACN,QAAQ,GACR,aAAa,GACb,WAAW,GACX,UAAU,CAAC;AAEf,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,UAAU,CAAC;IACpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,aAA0C,CAAC"}

package/dist/src/page-controls/act.d.ts

@@ -0,0 +1,8 @@
+import { ActResult, PageAction } from './act-types';
+export declare function actOnPage(input: {
+    ref: string;
+    action: PageAction;
+    value?: string;
+    settleMs?: number;
+}): Promise<ActResult>;
+//# sourceMappingURL=act.d.ts.map

package/dist/src/page-controls/act.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"act.d.ts","sourceRoot":"","sources":["../../../src/page-controls/act.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AA+FrB,wBAAsB,SAAS,CAAC,KAAK,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,SAAS,CAAC,CAerB"}

package/dist/src/page-controls/control-ref.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The table behind the references — held here, in the page, never sent.
+ *
+ * Every control the agent can talk about is one the reader put in this table
+ * in this turn. The wire carries `c7`; only this module knows which node
+ * that is. Three properties fall out of that, and they are the reason the
+ * table exists instead of the agent authoring CSS selectors:
+ *
+ * - The agent cannot reach a node we did not offer it. There is no selector
+ *   to widen, no text to guess at, no way to name the password field we
+ *   skipped.
+ * - A reference is checkable. Before drawing or clicking, `resolve` says
+ *   whether that exact node is still in the document — a stale reference
+ *   after a re-render is a "no", not a click on whatever moved into place.
+ * - The nodes are held weakly, so a table entry never keeps a detached
+ *   subtree of the customer's page alive.
+ */
+/** Open a new reading. Returns the mint function for its references. */
+export declare function beginSnapshot(): (el: HTMLElement) => string;
+/**
+ * The element behind a reference, or null — gone from the table, collected,
+ * or no longer in the document. "No longer the same node" and "not found"
+ * are deliberately the same answer: both mean do not act.
+ */
+export declare function resolveRef(ref: string): HTMLElement | null;
+/** Test seam: forget every reading. */
+export declare function resetRefsForTest(): void;
+//# sourceMappingURL=control-ref.d.ts.map

package/dist/src/page-controls/control-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-ref.d.ts","sourceRoot":"","sources":["../../../src/page-controls/control-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH,wEAAwE;AACxE,wBAAgB,aAAa,IAAI,CAAC,EAAE,EAAE,WAAW,KAAK,MAAM,CAW3D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAM1D;AAED,uCAAuC;AACvC,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/src/page-controls/cursor.d.ts

@@ -0,0 +1,72 @@
+/**
+ * The pointer the visitor watches.
+ *
+ * Without it the page simply changes: a menu opens, a field fills, and the
+ * customer is left to work out whether they did that or something did it to
+ * them. A cursor that travels to the control and presses it answers that
+ * before they have to ask.
+ *
+ * It is drawn, never simulated input — the real events still come from
+ * `firePointerSequence`. The two are kept in step by aiming both at the same
+ * point: the control's centre. If the gesture and the event were allowed to
+ * drift apart this would be theatre, and theatre about what an agent did to
+ * someone's account is worse than no animation at all.
+ *
+ * Widget-owned and `pointer-events: none` throughout. It lives inside a
+ * fixed, clipped, full-viewport layer so travelling near an edge cannot
+ * grow the host page's scroll area, and it never touches a customer
+ * element or intercepts a click.
+ */
+export declare const CURSOR_APPEAR_MS = 260;
+/** The long haul. A hand crossing a dashboard takes about this. */
+export declare const CURSOR_TRAVEL_MS = 1600;
+/** A hand stops before it presses; without this the two moves read as one jerk. */
+export declare const CURSOR_REST_MS = 180;
+export declare const CURSOR_PRESS_MS = 240;
+type Cursor = {
+    /** Travel to a viewport point and stop there. */
+    moveTo(x: number, y: number): Promise<void>;
+    /** The squash and ring that read as a press. */
+    press(): Promise<void>;
+    /** Fade out and release the node. */
+    release(): void;
+};
+/**
+ * Take the pointer off the page NOW.
+ *
+ * `release` fades, which is right at the end of the work and wrong when
+ * something else is starting: the fade outlives the call, so effects in
+ * quick succession left ghosts drifting behind the live one. Anything still
+ * carrying the marker is removed outright here.
+ */
+export declare function dismissAgentCursor(): void;
+/**
+ * Put a pointer on the page, or hand back the one already there.
+ *
+ * Returns null when the document will not have it — the caller then does
+ * its own thing silently, because a missing animation must never stop the
+ * actual work.
+ */
+export declare function showAgentCursor(from?: {
+    x: number;
+    y: number;
+}): Cursor | null;
+/** The point both the gesture and the real event aim at. */
+export declare function centreOf(el: HTMLElement): {
+    x: number;
+    y: number;
+};
+/**
+ * Bring the control into view and walk the pointer to it.
+ *
+ * Every failure here is swallowed on purpose. The caller owes the waiting
+ * turn an answer, and an animation that cannot run is not a reason to
+ * withhold one — the work still happens, it just happens unaccompanied.
+ */
+export declare function travelTo(el: HTMLElement, { press }?: {
+    press?: boolean;
+}): Promise<{
+    done: () => void;
+}>;
+export {};
+//# sourceMappingURL=cursor.d.ts.map

package/dist/src/page-controls/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/page-controls/cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,mFAAmF;AACnF,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,eAAe,MAAM,CAAC;AAqFnC,KAAK,MAAM,GAAG;IACZ,iDAAiD;IACjD,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,gDAAgD;IAChD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,qCAAqC;IACrC,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAwBF;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAOzC;AAQD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE;IACrC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,GAAG,MAAM,GAAG,IAAI,CAgIhB;AAED,4DAA4D;AAC5D,wBAAgB,QAAQ,CAAC,EAAE,EAAE,WAAW,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAGlE;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,WAAW,EACf,EAAE,KAAa,EAAE,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC,CAkB/B"}

package/dist/src/page-controls/guard.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The check that runs immediately before the widget touches a control —
+ * before it draws a mark, and (later) before it clicks.
+ *
+ * Between the reading that produced a reference and the tool call that uses
+ * it, a page can do anything: re-render, scroll, open a modal over the top.
+ * So the reference is not trusted as a permission to act; it is looked up,
+ * and then the element itself is asked three questions. Each "no" is a
+ * distinct answer, because the agent has to be able to say which one
+ * happened — "it is behind the dialog that just opened" is useful, "it
+ * didn't work" is not.
+ */
+export type GuardOutcome = 
+/** The element is there, visible, and the topmost thing at its own centre. */
+{
+    ok: true;
+    element: HTMLElement;
+}
+/** The reference means nothing here: never minted, expired, or detached. */
+ | {
+    ok: false;
+    reason: 'gone';
+}
+/** Still in the document, but not on screen. */
+ | {
+    ok: false;
+    reason: 'hidden';
+}
+/** On screen, but something else is in front of it. */
+ | {
+    ok: false;
+    reason: 'covered';
+}
+/**
+ * The page says hands off — a region marked private, something hidden
+ * from assistive tech, a credential field, our own UI. Re-checked HERE
+ * and not only when the page was read, because a page can mark a region
+ * private after the reference to it was handed out.
+ */
+ | {
+    ok: false;
+    reason: 'off-limits';
+    detail: string;
+};
+/** Look a reference up and ask the element whether it can be touched. */
+export declare function guardRef(ref: string): GuardOutcome;
+//# sourceMappingURL=guard.d.ts.map

package/dist/src/page-controls/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../src/page-controls/guard.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY;AACtB,8EAA8E;AAC5E;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE;AACpC,4EAA4E;GAC1E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC/B,gDAAgD;GAC9C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE;AACjC,uDAAuD;GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE;AAClC;;;;;GAKG;GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AA6BxD,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CA6BlD"}