@athenaintel/react 0.60.0 → 0.61.0

package/dist/agent-ui/driver.d.ts

@@ -0,0 +1,66 @@
+import type { AgentTargetAction } from './contract';
+import { type AgentUiInterruptReason, type AgentUiPace } from './pace';
+import { type AgentTargetSnapshot } from './screen';
+/** Bring an element into view at the pace's speed, and wait until it has stopped moving. */
+export declare function revealElement({ element, pace, signal, }: {
+    element: Element;
+    pace: AgentUiPace;
+    signal?: AbortSignal;
+}): Promise<void>;
+/** The pieces a value is typed in: one character each, or larger so long text stays within the pace. */
+export declare function typingSteps({ text, pace }: {
+    text: string;
+    pace: AgentUiPace;
+}): string[];
+export interface AgentUiActArgs {
+    target: AgentTargetSnapshot;
+    action: AgentTargetAction;
+    /** `type`: the text. */
+    text?: string;
+    /** `type`: press Enter after the text. */
+    submit?: boolean;
+    /** `select`: the option, by its label. */
+    option?: string;
+    /** `toggle`: the state wanted; absent flips it. */
+    checked?: boolean;
+    pace: AgentUiPace;
+    signal?: AbortSignal;
+    /** Called as the cursor should press (the layer shows the click). */
+    onPress?: () => void;
+    /**
+     * Called immediately before each thing done to the page, after every wait:
+     * the caller throws when the element is no longer the target it named (a
+     * list that reused the node for another row while the cursor glided).
+     */
+    beforeTouch?: () => void;
+}
+/** What an action did, in the words the agent is told. */
+export interface AgentUiActOutcome {
+    /** Nothing needed doing (already in the state asked for). */
+    unchanged?: boolean;
+    detail: string;
+}
+/** Throws {@link AgentUiError} unless the target allows the action now. */
+export declare function assertCanAct({ target, action, }: {
+    target: AgentTargetSnapshot;
+    action: AgentTargetAction;
+}): void;
+/** Take one action on a target. Throws {@link AgentUiError} for one the target does not allow. */
+export declare function performAct({ target, action, text, submit, option, checked, pace, signal, onPress, beforeTouch, }: AgentUiActArgs): Promise<AgentUiActOutcome>;
+/** Wait until the page has stopped changing after an action, bounded by the pace. */
+export declare function waitForPageToSettle({ doc, pace, signal, }: {
+    doc: Document;
+    pace: AgentUiPace;
+    signal?: AbortSignal;
+}): Promise<void>;
+/**
+ * Watch for the person taking over while the agent acts: a key, a press or a
+ * scroll of their own, anywhere but on the overlay. The agent's own events are
+ * scripted, so they never count.
+ */
+export declare function watchForPerson({ doc, isLayerEvent, isPersonEvent, onTakeover, }: {
+    doc: Document;
+    isLayerEvent: (event: Event) => boolean;
+    isPersonEvent?: (event: Event) => boolean;
+    onTakeover: (reason: AgentUiInterruptReason) => void;
+}): () => void;

package/dist/agent-ui/driver.js

@@ -0,0 +1,335 @@
+import { throwIfInterrupted, pause } from "./pace.js";
+import { AgentUiError, isInViewport } from "./screen.js";
+const tagOf = (element) => element.tagName.toUpperCase();
+function isFocusable(element) {
+  return typeof element.focus === "function";
+}
+async function revealElement({
+  element,
+  pace,
+  signal
+}) {
+  throwIfInterrupted(signal);
+  if (isInViewport(element) && isFullyInViewport(element)) return;
+  element.scrollIntoView({
+    behavior: pace.smoothScroll ? "smooth" : "auto",
+    block: "center",
+    inline: "nearest"
+  });
+  if (pace.scrollSettleMaxMs <= 0) return;
+  const deadline = Date.now() + pace.scrollSettleMaxMs;
+  let last = element.getBoundingClientRect();
+  let still = 0;
+  while (Date.now() < deadline && still < 3) {
+    await pause(50, signal);
+    const next = element.getBoundingClientRect();
+    still = Math.abs(next.top - last.top) < 0.5 && Math.abs(next.left - last.left) < 0.5 ? still + 1 : 0;
+    last = next;
+  }
+}
+function isFullyInViewport(element) {
+  const view = element.ownerDocument.defaultView;
+  if (!view) return false;
+  const rect = element.getBoundingClientRect();
+  return rect.top >= 0 && rect.left >= 0 && rect.bottom <= view.innerHeight && rect.right <= view.innerWidth;
+}
+function setNativeValue(control, value) {
+  var _a, _b, _c, _d;
+  const view = control.ownerDocument.defaultView;
+  const prototype = tagOf(control) === "TEXTAREA" ? (_a = view == null ? void 0 : view.HTMLTextAreaElement) == null ? void 0 : _a.prototype : tagOf(control) === "SELECT" ? (_b = view == null ? void 0 : view.HTMLSelectElement) == null ? void 0 : _b.prototype : (_c = view == null ? void 0 : view.HTMLInputElement) == null ? void 0 : _c.prototype;
+  const setter = prototype ? (_d = Object.getOwnPropertyDescriptor(prototype, "value")) == null ? void 0 : _d.set : void 0;
+  if (setter) setter.call(control, value);
+  else control.value = value;
+}
+function fire(element, type, init = {}) {
+  const view = element.ownerDocument.defaultView;
+  const EventClass = (view == null ? void 0 : view.Event) ?? Event;
+  const event = new EventClass(type, { bubbles: true, cancelable: true, ...init });
+  return element.dispatchEvent(event);
+}
+function fireInput(control, data) {
+  const view = control.ownerDocument.defaultView;
+  const InputEventClass = view == null ? void 0 : view.InputEvent;
+  if (InputEventClass) {
+    control.dispatchEvent(
+      new InputEventClass("input", {
+        bubbles: true,
+        cancelable: false,
+        data,
+        inputType: data === null ? "deleteContentBackward" : "insertText"
+      })
+    );
+  } else {
+    fire(control, "input");
+  }
+}
+function isEditable(control) {
+  const editable = control.getAttribute("contenteditable");
+  return editable === "" || editable === "true";
+}
+function writeValue(control, value, typed) {
+  if (isEditable(control)) control.textContent = value;
+  else setNativeValue(control, value);
+  fireInput(control, typed);
+}
+function typingSteps({ text, pace }) {
+  const characters = Array.from(text);
+  if (!pace.typeByCharacter || characters.length === 0) return [text];
+  const most = pace.typeCharMs > 0 ? Math.max(1, Math.floor(pace.typeMaxMs / pace.typeCharMs)) : 1;
+  const size = Math.max(1, Math.ceil(characters.length / most));
+  const steps = [];
+  for (let index = size; index < characters.length; index += size) {
+    steps.push(characters.slice(0, index).join(""));
+  }
+  steps.push(text);
+  return steps;
+}
+function pressEnter(control) {
+  const view = control.ownerDocument.defaultView;
+  const KeyboardEventClass = (view == null ? void 0 : view.KeyboardEvent) ?? KeyboardEvent;
+  const init = { key: "Enter", code: "Enter", keyCode: 13, which: 13, bubbles: true, cancelable: true };
+  const proceeded = control.dispatchEvent(new KeyboardEventClass("keydown", init));
+  const form = control.form;
+  if (proceeded && form && typeof form.requestSubmit === "function") form.requestSubmit();
+  control.dispatchEvent(new KeyboardEventClass("keyup", init));
+}
+function clickElement(element) {
+  const view = element.ownerDocument.defaultView;
+  const rect = element.getBoundingClientRect();
+  const point = {
+    bubbles: true,
+    cancelable: true,
+    composed: true,
+    button: 0,
+    clientX: rect.left + rect.width / 2,
+    clientY: rect.top + rect.height / 2,
+    view
+  };
+  const PointerEventClass = view == null ? void 0 : view.PointerEvent;
+  const MouseEventClass = (view == null ? void 0 : view.MouseEvent) ?? MouseEvent;
+  const pointer = { ...point, pointerId: 1, pointerType: "mouse", isPrimary: true };
+  if (PointerEventClass) element.dispatchEvent(new PointerEventClass("pointerdown", { ...pointer, buttons: 1 }));
+  element.dispatchEvent(new MouseEventClass("mousedown", { ...point, buttons: 1 }));
+  if (isFocusable(element)) element.focus({ preventScroll: true });
+  if (PointerEventClass) element.dispatchEvent(new PointerEventClass("pointerup", pointer));
+  element.dispatchEvent(new MouseEventClass("mouseup", point));
+  if (typeof element.click === "function") element.click();
+  else element.dispatchEvent(new MouseEventClass("click", point));
+}
+const sameWords = (text) => text.replace(/\s+/g, " ").trim().toLowerCase();
+function matchOption(options, wanted) {
+  const text = sameWords(wanted).replace(/…$/, "").trimEnd();
+  const exact = options.filter(
+    (option) => sameWords(option.label) === text || option.value.toLowerCase() === text
+  );
+  if (exact[0]) return exact[0];
+  const starts = options.filter((option) => sameWords(option.label).startsWith(text));
+  if (starts.length === 1) return starts[0];
+  const holds = options.filter((option) => sameWords(option.label).includes(text));
+  return holds.length === 1 ? holds[0] : void 0;
+}
+function assertCanAct({
+  target,
+  action
+}) {
+  if (!target.actions.includes(action)) {
+    const allowed = target.actions.length > 0 ? target.actions.join(", ") : "nothing: it can only be pointed at";
+    throw new AgentUiError(
+      `"${target.ref}" (${target.label}) does not allow "${action}". It allows: ${allowed}.`
+    );
+  }
+  if (target.disabled) {
+    throw new AgentUiError(`"${target.ref}" (${target.label}) is disabled right now.`);
+  }
+}
+async function performAct({
+  target,
+  action,
+  text,
+  submit,
+  option,
+  checked,
+  pace,
+  signal,
+  onPress,
+  beforeTouch
+}) {
+  var _a;
+  assertCanAct({ target, action });
+  const { handlers } = target;
+  const control = target.control;
+  switch (action) {
+    case "click": {
+      onPress == null ? void 0 : onPress();
+      await pause(pace.pressMs, signal);
+      beforeTouch == null ? void 0 : beforeTouch();
+      if (handlers == null ? void 0 : handlers.click) await handlers.click();
+      else clickElement(target.element);
+      return { detail: `Clicked ${target.label}.` };
+    }
+    case "toggle": {
+      const current = target.checked;
+      const wanted = checked ?? (current === null ? null : !current);
+      if (wanted !== null && current === wanted) {
+        return { unchanged: true, detail: `${target.label} is already ${wanted ? "on" : "off"}.` };
+      }
+      if (target.role === "radio" && wanted === false) {
+        throw new AgentUiError(`"${target.ref}" is a radio button: choose another option instead of turning it off.`);
+      }
+      onPress == null ? void 0 : onPress();
+      await pause(pace.pressMs, signal);
+      beforeTouch == null ? void 0 : beforeTouch();
+      if (handlers == null ? void 0 : handlers.toggle) await handlers.toggle({ checked: wanted });
+      else clickElement(control ?? target.element);
+      return { detail: `Turned ${target.label} ${wanted === false ? "off" : "on"}.` };
+    }
+    case "select": {
+      if (typeof option !== "string" || !option.trim()) {
+        throw new AgentUiError(`Give the option to choose: act_on({ target: "${target.ref}", action: "select", option: "…" }).`);
+      }
+      if (handlers == null ? void 0 : handlers.select) {
+        const known = (_a = handlers.options) == null ? void 0 : _a.call(handlers);
+        const chosen2 = known ? matchOption(known.map((label) => ({ label, value: label })), option) : void 0;
+        if (known && !chosen2) {
+          throw new AgentUiError(`"${option}" is not an option of ${target.label}. Options: ${known.join(", ")}.`);
+        }
+        onPress == null ? void 0 : onPress();
+        await pause(pace.pressMs, signal);
+        beforeTouch == null ? void 0 : beforeTouch();
+        beforeTouch == null ? void 0 : beforeTouch();
+        await handlers.select({ option: (chosen2 == null ? void 0 : chosen2.label) ?? option.trim() });
+        return { detail: `Chose ${(chosen2 == null ? void 0 : chosen2.label) ?? option.trim()} in ${target.label}.` };
+      }
+      if (!control || tagOf(control) !== "SELECT") {
+        throw new AgentUiError(`"${target.ref}" has no list of options to choose from.`);
+      }
+      const select = control;
+      const options = Array.from(select.options).filter((entry) => !entry.disabled).map((entry) => ({ label: (entry.label || entry.text).trim(), value: entry.value, entry }));
+      const chosen = matchOption(options, option);
+      if (!chosen) {
+        const listed = options.slice(0, 30).map((entry) => entry.label);
+        throw new AgentUiError(
+          `"${option}" is not an option of ${target.label}. Options: ${listed.join(", ")}${options.length > listed.length ? ", …" : ""}.`
+        );
+      }
+      const already = select.multiple ? chosen.entry.selected : select.value === chosen.value;
+      if (already) {
+        return { unchanged: true, detail: `${target.label} is already ${chosen.label}.` };
+      }
+      onPress == null ? void 0 : onPress();
+      await pause(pace.pressMs, signal);
+      beforeTouch == null ? void 0 : beforeTouch();
+      if (isFocusable(control)) control.focus({ preventScroll: true });
+      if (select.multiple) chosen.entry.selected = true;
+      else setNativeValue(control, chosen.value);
+      fire(control, "input");
+      fire(control, "change");
+      return { detail: `Chose ${chosen.label} in ${target.label}.` };
+    }
+    case "clear":
+    case "type": {
+      const value = action === "clear" ? "" : text ?? "";
+      if (action === "type" && typeof text !== "string") {
+        throw new AgentUiError(`Give the text to type: act_on({ target: "${target.ref}", action: "type", text: "…" }).`);
+      }
+      if (target.sensitive && action === "type") {
+        throw new AgentUiError(`"${target.ref}" holds a secret: only the person types into it.`);
+      }
+      if (action === "clear" && (handlers == null ? void 0 : handlers.clear)) {
+        beforeTouch == null ? void 0 : beforeTouch();
+        await handlers.clear();
+        return { detail: `Cleared ${target.label}.` };
+      }
+      if (handlers == null ? void 0 : handlers.type) {
+        for (const step of typingSteps({ text: value, pace })) {
+          throwIfInterrupted(signal);
+          beforeTouch == null ? void 0 : beforeTouch();
+          await handlers.type({ text: step, done: false });
+          await pause(pace.typeCharMs, signal);
+        }
+        await handlers.type({ text: value, done: true });
+        return { detail: action === "clear" ? `Cleared ${target.label}.` : `Typed into ${target.label}.` };
+      }
+      if (!control) {
+        throw new AgentUiError(`"${target.ref}" has no field to type into.`);
+      }
+      if (target.readOnly) {
+        throw new AgentUiError(`"${target.ref}" (${target.label}) is read-only: nobody can type into it.`);
+      }
+      const longest = Number(control.maxLength);
+      if (Number.isFinite(longest) && longest >= 0 && Array.from(value).length > longest) {
+        throw new AgentUiError(`${target.label} takes at most ${longest} characters, and this text has ${Array.from(value).length}.`);
+      }
+      beforeTouch == null ? void 0 : beforeTouch();
+      if (isFocusable(control)) control.focus({ preventScroll: true });
+      if (value === "") {
+        writeValue(control, "", null);
+      } else {
+        let previous = "";
+        for (const step of typingSteps({ text: value, pace })) {
+          throwIfInterrupted(signal);
+          beforeTouch == null ? void 0 : beforeTouch();
+          writeValue(control, step, step.slice(previous.length));
+          previous = step;
+          await pause(pace.typeCharMs, signal);
+        }
+      }
+      fire(control, "change");
+      if (submit) pressEnter(control);
+      return {
+        detail: action === "clear" ? `Cleared ${target.label}.` : `Typed into ${target.label}${submit ? " and pressed Enter" : ""}.`
+      };
+    }
+  }
+}
+async function waitForPageToSettle({
+  doc,
+  pace,
+  signal
+}) {
+  var _a;
+  await pause(pace.afterActMs, signal);
+  const Observer = (_a = doc.defaultView) == null ? void 0 : _a.MutationObserver;
+  if (pace.settleMaxMs <= 0 || !Observer || !doc.body) {
+    await new Promise((resolve) => setTimeout(resolve, 0));
+    return;
+  }
+  let lastChange = Date.now();
+  const observer = new Observer(() => {
+    lastChange = Date.now();
+  });
+  observer.observe(doc.body, { subtree: true, childList: true, attributes: true, characterData: true });
+  const deadline = Date.now() + pace.settleMaxMs;
+  try {
+    while (Date.now() < deadline && Date.now() - lastChange < pace.settleQuietMs) {
+      await pause(40, signal);
+    }
+  } finally {
+    observer.disconnect();
+  }
+}
+function watchForPerson({
+  doc,
+  isLayerEvent,
+  isPersonEvent = (event) => event.isTrusted,
+  onTakeover
+}) {
+  const types = ["pointerdown", "keydown", "wheel", "touchstart"];
+  const listener = (event) => {
+    if (!isPersonEvent(event) || isLayerEvent(event)) return;
+    onTakeover("person");
+  };
+  for (const type of types) doc.addEventListener(type, listener, { capture: true, passive: true });
+  return () => {
+    for (const type of types) doc.removeEventListener(type, listener, { capture: true });
+  };
+}
+export {
+  assertCanAct,
+  performAct,
+  revealElement,
+  typingSteps,
+  waitForPageToSettle,
+  watchForPerson
+};
+//# sourceMappingURL=driver.js.map

package/dist/agent-ui/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sources":["../../src/agent-ui/driver.ts"],"sourcesContent":["/*\n * The driver: how the agent's actions reach the page. Every one goes through\n * the element's own events (a pointer press and a click, values set and\n * `input` / `change` fired the way a keyboard would), so the app's handlers,\n * validation and undo run exactly as they do for a person. Nothing is written\n * around the app.\n *\n * A target that ordinary input cannot drive registers its own handler\n * (`useAgentTarget`), which the driver calls instead.\n */\n\nimport type { AgentTargetAction } from './contract';\nimport {\n  type AgentUiInterruptReason,\n  type AgentUiPace,\n  pause,\n  throwIfInterrupted,\n} from './pace';\nimport { AgentUiError, type AgentTargetSnapshot, isInViewport } from './screen';\n\nconst tagOf = (element: Element): string => element.tagName.toUpperCase();\n\ninterface FocusableElement extends Element {\n  focus(options?: { preventScroll?: boolean }): void;\n  click(): void;\n}\n\nfunction isFocusable(element: Element): element is FocusableElement {\n  return typeof (element as { focus?: unknown }).focus === 'function';\n}\n\n/** Bring an element into view at the pace's speed, and wait until it has stopped moving. */\nexport async function revealElement({\n  element,\n  pace,\n  signal,\n}: {\n  element: Element;\n  pace: AgentUiPace;\n  signal?: AbortSignal;\n}): Promise<void> {\n  throwIfInterrupted(signal);\n  if (isInViewport(element) && isFullyInViewport(element)) return;\n  element.scrollIntoView({\n    behavior: pace.smoothScroll ? 'smooth' : 'auto',\n    block: 'center',\n    inline: 'nearest',\n  });\n  if (pace.scrollSettleMaxMs <= 0) return;\n  // A smooth scroll has no end event everywhere: wait until the element has\n  // held one position for a few frames, bounded.\n  const deadline = Date.now() + pace.scrollSettleMaxMs;\n  let last = element.getBoundingClientRect();\n  let still = 0;\n  while (Date.now() < deadline && still < 3) {\n    await pause(50, signal);\n    const next = element.getBoundingClientRect();\n    still = Math.abs(next.top - last.top) < 0.5 && Math.abs(next.left - last.left) < 0.5 ? still + 1 : 0;\n    last = next;\n  }\n}\n\nfunction isFullyInViewport(element: Element): boolean {\n  const view = element.ownerDocument.defaultView;\n  if (!view) return false;\n  const rect = element.getBoundingClientRect();\n  return rect.top >= 0 && rect.left >= 0 && rect.bottom <= view.innerHeight && rect.right <= view.innerWidth;\n}\n\nfunction setNativeValue(control: Element, value: string): void {\n  const view = control.ownerDocument.defaultView;\n  const prototype =\n    tagOf(control) === 'TEXTAREA'\n      ? view?.HTMLTextAreaElement?.prototype\n      : tagOf(control) === 'SELECT'\n        ? view?.HTMLSelectElement?.prototype\n        : view?.HTMLInputElement?.prototype;\n  // React tracks a controlled field's value on the element itself; the\n  // prototype's setter is the one a keystroke goes through, so `onChange` fires.\n  const setter = prototype ? Object.getOwnPropertyDescriptor(prototype, 'value')?.set : undefined;\n  if (setter) setter.call(control, value);\n  else (control as { value?: string }).value = value;\n}\n\nfunction fire(element: Element, type: string, init: Record<string, unknown> = {}): boolean {\n  const view = element.ownerDocument.defaultView;\n  const EventClass = view?.Event ?? Event;\n  const event = new EventClass(type, { bubbles: true, cancelable: true, ...init });\n  return element.dispatchEvent(event);\n}\n\nfunction fireInput(control: Element, data: string | null): void {\n  const view = control.ownerDocument.defaultView;\n  const InputEventClass = view?.InputEvent;\n  if (InputEventClass) {\n    control.dispatchEvent(\n      new InputEventClass('input', {\n        bubbles: true,\n        cancelable: false,\n        data,\n        inputType: data === null ? 'deleteContentBackward' : 'insertText',\n      }),\n    );\n  } else {\n    fire(control, 'input');\n  }\n}\n\nfunction isEditable(control: Element): boolean {\n  const editable = control.getAttribute('contenteditable');\n  return editable === '' || editable === 'true';\n}\n\nfunction writeValue(control: Element, value: string, typed: string | null): void {\n  if (isEditable(control)) control.textContent = value;\n  else setNativeValue(control, value);\n  fireInput(control, typed);\n}\n\n/** The pieces a value is typed in: one character each, or larger so long text stays within the pace. */\nexport function typingSteps({ text, pace }: { text: string; pace: AgentUiPace }): string[] {\n  const characters = Array.from(text);\n  if (!pace.typeByCharacter || characters.length === 0) return [text];\n  const most = pace.typeCharMs > 0 ? Math.max(1, Math.floor(pace.typeMaxMs / pace.typeCharMs)) : 1;\n  const size = Math.max(1, Math.ceil(characters.length / most));\n  const steps: string[] = [];\n  for (let index = size; index < characters.length; index += size) {\n    steps.push(characters.slice(0, index).join(''));\n  }\n  steps.push(text);\n  return steps;\n}\n\nfunction pressEnter(control: Element): void {\n  const view = control.ownerDocument.defaultView;\n  const KeyboardEventClass = view?.KeyboardEvent ?? KeyboardEvent;\n  const init = { key: 'Enter', code: 'Enter', keyCode: 13, which: 13, bubbles: true, cancelable: true };\n  const proceeded = control.dispatchEvent(new KeyboardEventClass('keydown', init));\n  // A script's key event submits nothing by itself: do what the browser would\n  // have, unless the app's own handler took the key.\n  const form = (control as { form?: { requestSubmit?: () => void } | null }).form;\n  if (proceeded && form && typeof form.requestSubmit === 'function') form.requestSubmit();\n  control.dispatchEvent(new KeyboardEventClass('keyup', init));\n}\n\n/** A person's click, as the page receives it: pointer and mouse down and up, focus, then the click. */\nfunction clickElement(element: Element): void {\n  const view = element.ownerDocument.defaultView;\n  const rect = element.getBoundingClientRect();\n  const point = {\n    bubbles: true,\n    cancelable: true,\n    composed: true,\n    button: 0,\n    clientX: rect.left + rect.width / 2,\n    clientY: rect.top + rect.height / 2,\n    view,\n  };\n  const PointerEventClass = view?.PointerEvent;\n  const MouseEventClass = view?.MouseEvent ?? MouseEvent;\n  const pointer = { ...point, pointerId: 1, pointerType: 'mouse', isPrimary: true };\n  if (PointerEventClass) element.dispatchEvent(new PointerEventClass('pointerdown', { ...pointer, buttons: 1 }));\n  element.dispatchEvent(new MouseEventClass('mousedown', { ...point, buttons: 1 }));\n  if (isFocusable(element)) element.focus({ preventScroll: true });\n  if (PointerEventClass) element.dispatchEvent(new PointerEventClass('pointerup', pointer));\n  element.dispatchEvent(new MouseEventClass('mouseup', point));\n  // An SVG element can be focused but has no `click()` of its own.\n  if (typeof (element as { click?: unknown }).click === 'function') (element as FocusableElement).click();\n  else element.dispatchEvent(new MouseEventClass('click', point));\n}\n\nconst sameWords = (text: string): string => text.replace(/\\s+/g, ' ').trim().toLowerCase();\n\nfunction matchOption<T extends { label: string; value: string }>(\n  options: readonly T[],\n  wanted: string,\n): T | undefined {\n  // A long option is listed cut short with an ellipsis: what the agent read\n  // back is then the start of the one it means.\n  const text = sameWords(wanted).replace(/…$/, '').trimEnd();\n  const exact = options.filter(\n    (option) => sameWords(option.label) === text || option.value.toLowerCase() === text,\n  );\n  if (exact[0]) return exact[0];\n  const starts = options.filter((option) => sameWords(option.label).startsWith(text));\n  if (starts.length === 1) return starts[0];\n  const holds = options.filter((option) => sameWords(option.label).includes(text));\n  return holds.length === 1 ? holds[0] : undefined;\n}\n\nexport interface AgentUiActArgs {\n  target: AgentTargetSnapshot;\n  action: AgentTargetAction;\n  /** `type`: the text. */\n  text?: string;\n  /** `type`: press Enter after the text. */\n  submit?: boolean;\n  /** `select`: the option, by its label. */\n  option?: string;\n  /** `toggle`: the state wanted; absent flips it. */\n  checked?: boolean;\n  pace: AgentUiPace;\n  signal?: AbortSignal;\n  /** Called as the cursor should press (the layer shows the click). */\n  onPress?: () => void;\n  /**\n   * Called immediately before each thing done to the page, after every wait:\n   * the caller throws when the element is no longer the target it named (a\n   * list that reused the node for another row while the cursor glided).\n   */\n  beforeTouch?: () => void;\n}\n\n/** What an action did, in the words the agent is told. */\nexport interface AgentUiActOutcome {\n  /** Nothing needed doing (already in the state asked for). */\n  unchanged?: boolean;\n  detail: string;\n}\n\n/** Throws {@link AgentUiError} unless the target allows the action now. */\nexport function assertCanAct({\n  target,\n  action,\n}: {\n  target: AgentTargetSnapshot;\n  action: AgentTargetAction;\n}): void {\n  if (!target.actions.includes(action)) {\n    const allowed =\n      target.actions.length > 0 ? target.actions.join(', ') : 'nothing: it can only be pointed at';\n    throw new AgentUiError(\n      `\"${target.ref}\" (${target.label}) does not allow \"${action}\". It allows: ${allowed}.`,\n    );\n  }\n  if (target.disabled) {\n    throw new AgentUiError(`\"${target.ref}\" (${target.label}) is disabled right now.`);\n  }\n}\n\n/** Take one action on a target. Throws {@link AgentUiError} for one the target does not allow. */\nexport async function performAct({\n  target,\n  action,\n  text,\n  submit,\n  option,\n  checked,\n  pace,\n  signal,\n  onPress,\n  beforeTouch,\n}: AgentUiActArgs): Promise<AgentUiActOutcome> {\n  assertCanAct({ target, action });\n  const { handlers } = target;\n  const control = target.control;\n\n  switch (action) {\n    case 'click': {\n      onPress?.();\n      await pause(pace.pressMs, signal);\n      beforeTouch?.();\n      if (handlers?.click) await handlers.click();\n      else clickElement(target.element);\n      return { detail: `Clicked ${target.label}.` };\n    }\n\n    case 'toggle': {\n      const current = target.checked;\n      const wanted = checked ?? (current === null ? null : !current);\n      if (wanted !== null && current === wanted) {\n        return { unchanged: true, detail: `${target.label} is already ${wanted ? 'on' : 'off'}.` };\n      }\n      if (target.role === 'radio' && wanted === false) {\n        throw new AgentUiError(`\"${target.ref}\" is a radio button: choose another option instead of turning it off.`);\n      }\n      onPress?.();\n      await pause(pace.pressMs, signal);\n      beforeTouch?.();\n      if (handlers?.toggle) await handlers.toggle({ checked: wanted });\n      else clickElement(control ?? target.element);\n      return { detail: `Turned ${target.label} ${wanted === false ? 'off' : 'on'}.` };\n    }\n\n    case 'select': {\n      if (typeof option !== 'string' || !option.trim()) {\n        throw new AgentUiError(`Give the option to choose: act_on({ target: \"${target.ref}\", action: \"select\", option: \"…\" }).`);\n      }\n      if (handlers?.select) {\n        const known = handlers.options?.();\n        const chosen = known ? matchOption(known.map((label) => ({ label, value: label })), option) : undefined;\n        if (known && !chosen) {\n          throw new AgentUiError(`\"${option}\" is not an option of ${target.label}. Options: ${known.join(', ')}.`);\n        }\n        onPress?.();\n        await pause(pace.pressMs, signal);\n        beforeTouch?.();\n      beforeTouch?.();\n        await handlers.select({ option: chosen?.label ?? option.trim() });\n        return { detail: `Chose ${chosen?.label ?? option.trim()} in ${target.label}.` };\n      }\n      if (!control || tagOf(control) !== 'SELECT') {\n        throw new AgentUiError(`\"${target.ref}\" has no list of options to choose from.`);\n      }\n      const select = control as unknown as {\n        multiple?: boolean;\n        value?: string;\n        options: ArrayLike<{ label: string; text: string; value: string; disabled: boolean; selected: boolean }>;\n      };\n      const options = Array.from(select.options)\n        .filter((entry) => !entry.disabled)\n        .map((entry) => ({ label: (entry.label || entry.text).trim(), value: entry.value, entry }));\n      const chosen = matchOption(options, option);\n      if (!chosen) {\n        const listed = options.slice(0, 30).map((entry) => entry.label);\n        throw new AgentUiError(\n          `\"${option}\" is not an option of ${target.label}. Options: ${listed.join(', ')}${options.length > listed.length ? ', …' : ''}.`,\n        );\n      }\n      const already = select.multiple ? chosen.entry.selected : select.value === chosen.value;\n      if (already) {\n        return { unchanged: true, detail: `${target.label} is already ${chosen.label}.` };\n      }\n      onPress?.();\n      await pause(pace.pressMs, signal);\n      beforeTouch?.();\n      if (isFocusable(control)) control.focus({ preventScroll: true });\n      // A list that takes several choices gains this one; the others stay.\n      if (select.multiple) chosen.entry.selected = true;\n      else setNativeValue(control, chosen.value);\n      fire(control, 'input');\n      fire(control, 'change');\n      return { detail: `Chose ${chosen.label} in ${target.label}.` };\n    }\n\n    case 'clear':\n    case 'type': {\n      const value = action === 'clear' ? '' : (text ?? '');\n      if (action === 'type' && typeof text !== 'string') {\n        throw new AgentUiError(`Give the text to type: act_on({ target: \"${target.ref}\", action: \"type\", text: \"…\" }).`);\n      }\n      if (target.sensitive && action === 'type') {\n        throw new AgentUiError(`\"${target.ref}\" holds a secret: only the person types into it.`);\n      }\n      if (action === 'clear' && handlers?.clear) {\n        beforeTouch?.();\n        await handlers.clear();\n        return { detail: `Cleared ${target.label}.` };\n      }\n      if (handlers?.type) {\n        for (const step of typingSteps({ text: value, pace })) {\n          throwIfInterrupted(signal);\n          beforeTouch?.();\n          await handlers.type({ text: step, done: false });\n          await pause(pace.typeCharMs, signal);\n        }\n        await handlers.type({ text: value, done: true });\n        return { detail: action === 'clear' ? `Cleared ${target.label}.` : `Typed into ${target.label}.` };\n      }\n      if (!control) {\n        throw new AgentUiError(`\"${target.ref}\" has no field to type into.`);\n      }\n      // What a keyboard could not do, the agent does not do either.\n      if (target.readOnly) {\n        throw new AgentUiError(`\"${target.ref}\" (${target.label}) is read-only: nobody can type into it.`);\n      }\n      const longest = Number((control as { maxLength?: number }).maxLength);\n      if (Number.isFinite(longest) && longest >= 0 && Array.from(value).length > longest) {\n        throw new AgentUiError(`${target.label} takes at most ${longest} characters, and this text has ${Array.from(value).length}.`);\n      }\n      beforeTouch?.();\n      if (isFocusable(control)) control.focus({ preventScroll: true });\n      // Typing replaces what the field held, as selecting it all and typing would.\n      if (value === '') {\n        writeValue(control, '', null);\n      } else {\n        let previous = '';\n        for (const step of typingSteps({ text: value, pace })) {\n          throwIfInterrupted(signal);\n          beforeTouch?.();\n          writeValue(control, step, step.slice(previous.length));\n          previous = step;\n          await pause(pace.typeCharMs, signal);\n        }\n      }\n      fire(control, 'change');\n      if (submit) pressEnter(control);\n      return {\n        detail:\n          action === 'clear'\n            ? `Cleared ${target.label}.`\n            : `Typed into ${target.label}${submit ? ' and pressed Enter' : ''}.`,\n      };\n    }\n  }\n}\n\n/** Wait until the page has stopped changing after an action, bounded by the pace. */\nexport async function waitForPageToSettle({\n  doc,\n  pace,\n  signal,\n}: {\n  doc: Document;\n  pace: AgentUiPace;\n  signal?: AbortSignal;\n}): Promise<void> {\n  await pause(pace.afterActMs, signal);\n  const Observer = doc.defaultView?.MutationObserver;\n  if (pace.settleMaxMs <= 0 || !Observer || !doc.body) {\n    // Let the app's own updates from the action land before the page is read back.\n    await new Promise<void>((resolve) => setTimeout(resolve, 0));\n    return;\n  }\n  let lastChange = Date.now();\n  const observer = new Observer(() => {\n    lastChange = Date.now();\n  });\n  observer.observe(doc.body, { subtree: true, childList: true, attributes: true, characterData: true });\n  const deadline = Date.now() + pace.settleMaxMs;\n  try {\n    while (Date.now() < deadline && Date.now() - lastChange < pace.settleQuietMs) {\n      await pause(40, signal);\n    }\n  } finally {\n    observer.disconnect();\n  }\n}\n\n/**\n * Watch for the person taking over while the agent acts: a key, a press or a\n * scroll of their own, anywhere but on the overlay. The agent's own events are\n * scripted, so they never count.\n */\nexport function watchForPerson({\n  doc,\n  isLayerEvent,\n  isPersonEvent = (event) => event.isTrusted,\n  onTakeover,\n}: {\n  doc: Document;\n  isLayerEvent: (event: Event) => boolean;\n  isPersonEvent?: (event: Event) => boolean;\n  onTakeover: (reason: AgentUiInterruptReason) => void;\n}): () => void {\n  const types = ['pointerdown', 'keydown', 'wheel', 'touchstart'] as const;\n  const listener = (event: Event) => {\n    if (!isPersonEvent(event) || isLayerEvent(event)) return;\n    onTakeover('person');\n  };\n  for (const type of types) doc.addEventListener(type, listener, { capture: true, passive: true });\n  return () => {\n    for (const type of types) doc.removeEventListener(type, listener, { capture: true });\n  };\n}\n"],"names":["chosen"],"mappings":";;AAoBA,MAAM,QAAQ,CAAC,YAA6B,QAAQ,QAAQ,YAAA;AAO5D,SAAS,YAAY,SAA+C;AAClE,SAAO,OAAQ,QAAgC,UAAU;AAC3D;AAGA,eAAsB,cAAc;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF,GAIkB;AAChB,qBAAmB,MAAM;AACzB,MAAI,aAAa,OAAO,KAAK,kBAAkB,OAAO,EAAG;AACzD,UAAQ,eAAe;AAAA,IACrB,UAAU,KAAK,eAAe,WAAW;AAAA,IACzC,OAAO;AAAA,IACP,QAAQ;AAAA,EAAA,CACT;AACD,MAAI,KAAK,qBAAqB,EAAG;AAGjC,QAAM,WAAW,KAAK,IAAA,IAAQ,KAAK;AACnC,MAAI,OAAO,QAAQ,sBAAA;AACnB,MAAI,QAAQ;AACZ,SAAO,KAAK,IAAA,IAAQ,YAAY,QAAQ,GAAG;AACzC,UAAM,MAAM,IAAI,MAAM;AACtB,UAAM,OAAO,QAAQ,sBAAA;AACrB,YAAQ,KAAK,IAAI,KAAK,MAAM,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,KAAK,OAAO,KAAK,IAAI,IAAI,MAAM,QAAQ,IAAI;AACnG,WAAO;AAAA,EACT;AACF;AAEA,SAAS,kBAAkB,SAA2B;AACpD,QAAM,OAAO,QAAQ,cAAc;AACnC,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,OAAO,QAAQ,sBAAA;AACrB,SAAO,KAAK,OAAO,KAAK,KAAK,QAAQ,KAAK,KAAK,UAAU,KAAK,eAAe,KAAK,SAAS,KAAK;AAClG;AAEA,SAAS,eAAe,SAAkB,OAAqB;;AAC7D,QAAM,OAAO,QAAQ,cAAc;AACnC,QAAM,YACJ,MAAM,OAAO,MAAM,cACf,kCAAM,wBAAN,mBAA2B,YAC3B,MAAM,OAAO,MAAM,YACjB,kCAAM,sBAAN,mBAAyB,aACzB,kCAAM,qBAAN,mBAAwB;AAGhC,QAAM,SAAS,aAAY,YAAO,yBAAyB,WAAW,OAAO,MAAlD,mBAAqD,MAAM;AACtF,MAAI,OAAQ,QAAO,KAAK,SAAS,KAAK;AAAA,MAChC,SAA+B,QAAQ;AAC/C;AAEA,SAAS,KAAK,SAAkB,MAAc,OAAgC,CAAA,GAAa;AACzF,QAAM,OAAO,QAAQ,cAAc;AACnC,QAAM,cAAa,6BAAM,UAAS;AAClC,QAAM,QAAQ,IAAI,WAAW,MAAM,EAAE,SAAS,MAAM,YAAY,MAAM,GAAG,MAAM;AAC/E,SAAO,QAAQ,cAAc,KAAK;AACpC;AAEA,SAAS,UAAU,SAAkB,MAA2B;AAC9D,QAAM,OAAO,QAAQ,cAAc;AACnC,QAAM,kBAAkB,6BAAM;AAC9B,MAAI,iBAAiB;AACnB,YAAQ;AAAA,MACN,IAAI,gBAAgB,SAAS;AAAA,QAC3B,SAAS;AAAA,QACT,YAAY;AAAA,QACZ;AAAA,QACA,WAAW,SAAS,OAAO,0BAA0B;AAAA,MAAA,CACtD;AAAA,IAAA;AAAA,EAEL,OAAO;AACL,SAAK,SAAS,OAAO;AAAA,EACvB;AACF;AAEA,SAAS,WAAW,SAA2B;AAC7C,QAAM,WAAW,QAAQ,aAAa,iBAAiB;AACvD,SAAO,aAAa,MAAM,aAAa;AACzC;AAEA,SAAS,WAAW,SAAkB,OAAe,OAA4B;AAC/E,MAAI,WAAW,OAAO,EAAG,SAAQ,cAAc;AAAA,MAC1C,gBAAe,SAAS,KAAK;AAClC,YAAU,SAAS,KAAK;AAC1B;AAGO,SAAS,YAAY,EAAE,MAAM,QAAuD;AACzF,QAAM,aAAa,MAAM,KAAK,IAAI;AAClC,MAAI,CAAC,KAAK,mBAAmB,WAAW,WAAW,EAAG,QAAO,CAAC,IAAI;AAClE,QAAM,OAAO,KAAK,aAAa,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,YAAY,KAAK,UAAU,CAAC,IAAI;AAC/F,QAAM,OAAO,KAAK,IAAI,GAAG,KAAK,KAAK,WAAW,SAAS,IAAI,CAAC;AAC5D,QAAM,QAAkB,CAAA;AACxB,WAAS,QAAQ,MAAM,QAAQ,WAAW,QAAQ,SAAS,MAAM;AAC/D,UAAM,KAAK,WAAW,MAAM,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC;AAAA,EAChD;AACA,QAAM,KAAK,IAAI;AACf,SAAO;AACT;AAEA,SAAS,WAAW,SAAwB;AAC1C,QAAM,OAAO,QAAQ,cAAc;AACnC,QAAM,sBAAqB,6BAAM,kBAAiB;AAClD,QAAM,OAAO,EAAE,KAAK,SAAS,MAAM,SAAS,SAAS,IAAI,OAAO,IAAI,SAAS,MAAM,YAAY,KAAA;AAC/F,QAAM,YAAY,QAAQ,cAAc,IAAI,mBAAmB,WAAW,IAAI,CAAC;AAG/E,QAAM,OAAQ,QAA6D;AAC3E,MAAI,aAAa,QAAQ,OAAO,KAAK,kBAAkB,iBAAiB,cAAA;AACxE,UAAQ,cAAc,IAAI,mBAAmB,SAAS,IAAI,CAAC;AAC7D;AAGA,SAAS,aAAa,SAAwB;AAC5C,QAAM,OAAO,QAAQ,cAAc;AACnC,QAAM,OAAO,QAAQ,sBAAA;AACrB,QAAM,QAAQ;AAAA,IACZ,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,SAAS,KAAK,OAAO,KAAK,QAAQ;AAAA,IAClC,SAAS,KAAK,MAAM,KAAK,SAAS;AAAA,IAClC;AAAA,EAAA;AAEF,QAAM,oBAAoB,6BAAM;AAChC,QAAM,mBAAkB,6BAAM,eAAc;AAC5C,QAAM,UAAU,EAAE,GAAG,OAAO,WAAW,GAAG,aAAa,SAAS,WAAW,KAAA;AAC3E,MAAI,kBAAmB,SAAQ,cAAc,IAAI,kBAAkB,eAAe,EAAE,GAAG,SAAS,SAAS,EAAA,CAAG,CAAC;AAC7G,UAAQ,cAAc,IAAI,gBAAgB,aAAa,EAAE,GAAG,OAAO,SAAS,EAAA,CAAG,CAAC;AAChF,MAAI,YAAY,OAAO,EAAG,SAAQ,MAAM,EAAE,eAAe,MAAM;AAC/D,MAAI,kBAAmB,SAAQ,cAAc,IAAI,kBAAkB,aAAa,OAAO,CAAC;AACxF,UAAQ,cAAc,IAAI,gBAAgB,WAAW,KAAK,CAAC;AAE3D,MAAI,OAAQ,QAAgC,UAAU,WAAa,SAA6B,MAAA;AAAA,eACnF,cAAc,IAAI,gBAAgB,SAAS,KAAK,CAAC;AAChE;AAEA,MAAM,YAAY,CAAC,SAAyB,KAAK,QAAQ,QAAQ,GAAG,EAAE,KAAA,EAAO,YAAA;AAE7E,SAAS,YACP,SACA,QACe;AAGf,QAAM,OAAO,UAAU,MAAM,EAAE,QAAQ,MAAM,EAAE,EAAE,QAAA;AACjD,QAAM,QAAQ,QAAQ;AAAA,IACpB,CAAC,WAAW,UAAU,OAAO,KAAK,MAAM,QAAQ,OAAO,MAAM,kBAAkB;AAAA,EAAA;AAEjF,MAAI,MAAM,CAAC,EAAG,QAAO,MAAM,CAAC;AAC5B,QAAM,SAAS,QAAQ,OAAO,CAAC,WAAW,UAAU,OAAO,KAAK,EAAE,WAAW,IAAI,CAAC;AAClF,MAAI,OAAO,WAAW,EAAG,QAAO,OAAO,CAAC;AACxC,QAAM,QAAQ,QAAQ,OAAO,CAAC,WAAW,UAAU,OAAO,KAAK,EAAE,SAAS,IAAI,CAAC;AAC/E,SAAO,MAAM,WAAW,IAAI,MAAM,CAAC,IAAI;AACzC;AAiCO,SAAS,aAAa;AAAA,EAC3B;AAAA,EACA;AACF,GAGS;AACP,MAAI,CAAC,OAAO,QAAQ,SAAS,MAAM,GAAG;AACpC,UAAM,UACJ,OAAO,QAAQ,SAAS,IAAI,OAAO,QAAQ,KAAK,IAAI,IAAI;AAC1D,UAAM,IAAI;AAAA,MACR,IAAI,OAAO,GAAG,MAAM,OAAO,KAAK,qBAAqB,MAAM,iBAAiB,OAAO;AAAA,IAAA;AAAA,EAEvF;AACA,MAAI,OAAO,UAAU;AACnB,UAAM,IAAI,aAAa,IAAI,OAAO,GAAG,MAAM,OAAO,KAAK,0BAA0B;AAAA,EACnF;AACF;AAGA,eAAsB,WAAW;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA+C;;AAC7C,eAAa,EAAE,QAAQ,QAAQ;AAC/B,QAAM,EAAE,aAAa;AACrB,QAAM,UAAU,OAAO;AAEvB,UAAQ,QAAA;AAAA,IACN,KAAK,SAAS;AACZ;AACA,YAAM,MAAM,KAAK,SAAS,MAAM;AAChC;AACA,UAAI,qCAAU,MAAO,OAAM,SAAS,MAAA;AAAA,UAC/B,cAAa,OAAO,OAAO;AAChC,aAAO,EAAE,QAAQ,WAAW,OAAO,KAAK,IAAA;AAAA,IAC1C;AAAA,IAEA,KAAK,UAAU;AACb,YAAM,UAAU,OAAO;AACvB,YAAM,SAAS,YAAY,YAAY,OAAO,OAAO,CAAC;AACtD,UAAI,WAAW,QAAQ,YAAY,QAAQ;AACzC,eAAO,EAAE,WAAW,MAAM,QAAQ,GAAG,OAAO,KAAK,eAAe,SAAS,OAAO,KAAK,IAAA;AAAA,MACvF;AACA,UAAI,OAAO,SAAS,WAAW,WAAW,OAAO;AAC/C,cAAM,IAAI,aAAa,IAAI,OAAO,GAAG,uEAAuE;AAAA,MAC9G;AACA;AACA,YAAM,MAAM,KAAK,SAAS,MAAM;AAChC;AACA,UAAI,qCAAU,OAAQ,OAAM,SAAS,OAAO,EAAE,SAAS,QAAQ;AAAA,UAC1D,cAAa,WAAW,OAAO,OAAO;AAC3C,aAAO,EAAE,QAAQ,UAAU,OAAO,KAAK,IAAI,WAAW,QAAQ,QAAQ,IAAI,IAAA;AAAA,IAC5E;AAAA,IAEA,KAAK,UAAU;AACb,UAAI,OAAO,WAAW,YAAY,CAAC,OAAO,QAAQ;AAChD,cAAM,IAAI,aAAa,gDAAgD,OAAO,GAAG,sCAAsC;AAAA,MACzH;AACA,UAAI,qCAAU,QAAQ;AACpB,cAAM,SAAQ,cAAS,YAAT;AACd,cAAMA,UAAS,QAAQ,YAAY,MAAM,IAAI,CAAC,WAAW,EAAE,OAAO,OAAO,MAAA,EAAQ,GAAG,MAAM,IAAI;AAC9F,YAAI,SAAS,CAACA,SAAQ;AACpB,gBAAM,IAAI,aAAa,IAAI,MAAM,yBAAyB,OAAO,KAAK,cAAc,MAAM,KAAK,IAAI,CAAC,GAAG;AAAA,QACzG;AACA;AACA,cAAM,MAAM,KAAK,SAAS,MAAM;AAChC;AACF;AACE,cAAM,SAAS,OAAO,EAAE,SAAQA,mCAAQ,UAAS,OAAO,KAAA,GAAQ;AAChE,eAAO,EAAE,QAAQ,UAASA,mCAAQ,UAAS,OAAO,KAAA,CAAM,OAAO,OAAO,KAAK,IAAA;AAAA,MAC7E;AACA,UAAI,CAAC,WAAW,MAAM,OAAO,MAAM,UAAU;AAC3C,cAAM,IAAI,aAAa,IAAI,OAAO,GAAG,0CAA0C;AAAA,MACjF;AACA,YAAM,SAAS;AAKf,YAAM,UAAU,MAAM,KAAK,OAAO,OAAO,EACtC,OAAO,CAAC,UAAU,CAAC,MAAM,QAAQ,EACjC,IAAI,CAAC,WAAW,EAAE,QAAQ,MAAM,SAAS,MAAM,MAAM,KAAA,GAAQ,OAAO,MAAM,OAAO,MAAA,EAAQ;AAC5F,YAAM,SAAS,YAAY,SAAS,MAAM;AAC1C,UAAI,CAAC,QAAQ;AACX,cAAM,SAAS,QAAQ,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,UAAU,MAAM,KAAK;AAC9D,cAAM,IAAI;AAAA,UACR,IAAI,MAAM,yBAAyB,OAAO,KAAK,cAAc,OAAO,KAAK,IAAI,CAAC,GAAG,QAAQ,SAAS,OAAO,SAAS,QAAQ,EAAE;AAAA,QAAA;AAAA,MAEhI;AACA,YAAM,UAAU,OAAO,WAAW,OAAO,MAAM,WAAW,OAAO,UAAU,OAAO;AAClF,UAAI,SAAS;AACX,eAAO,EAAE,WAAW,MAAM,QAAQ,GAAG,OAAO,KAAK,eAAe,OAAO,KAAK,IAAA;AAAA,MAC9E;AACA;AACA,YAAM,MAAM,KAAK,SAAS,MAAM;AAChC;AACA,UAAI,YAAY,OAAO,EAAG,SAAQ,MAAM,EAAE,eAAe,MAAM;AAE/D,UAAI,OAAO,SAAU,QAAO,MAAM,WAAW;AAAA,UACxC,gBAAe,SAAS,OAAO,KAAK;AACzC,WAAK,SAAS,OAAO;AACrB,WAAK,SAAS,QAAQ;AACtB,aAAO,EAAE,QAAQ,SAAS,OAAO,KAAK,OAAO,OAAO,KAAK,IAAA;AAAA,IAC3D;AAAA,IAEA,KAAK;AAAA,IACL,KAAK,QAAQ;AACX,YAAM,QAAQ,WAAW,UAAU,KAAM,QAAQ;AACjD,UAAI,WAAW,UAAU,OAAO,SAAS,UAAU;AACjD,cAAM,IAAI,aAAa,4CAA4C,OAAO,GAAG,kCAAkC;AAAA,MACjH;AACA,UAAI,OAAO,aAAa,WAAW,QAAQ;AACzC,cAAM,IAAI,aAAa,IAAI,OAAO,GAAG,kDAAkD;AAAA,MACzF;AACA,UAAI,WAAW,YAAW,qCAAU,QAAO;AACzC;AACA,cAAM,SAAS,MAAA;AACf,eAAO,EAAE,QAAQ,WAAW,OAAO,KAAK,IAAA;AAAA,MAC1C;AACA,UAAI,qCAAU,MAAM;AAClB,mBAAW,QAAQ,YAAY,EAAE,MAAM,OAAO,KAAA,CAAM,GAAG;AACrD,6BAAmB,MAAM;AACzB;AACA,gBAAM,SAAS,KAAK,EAAE,MAAM,MAAM,MAAM,OAAO;AAC/C,gBAAM,MAAM,KAAK,YAAY,MAAM;AAAA,QACrC;AACA,cAAM,SAAS,KAAK,EAAE,MAAM,OAAO,MAAM,MAAM;AAC/C,eAAO,EAAE,QAAQ,WAAW,UAAU,WAAW,OAAO,KAAK,MAAM,cAAc,OAAO,KAAK,IAAA;AAAA,MAC/F;AACA,UAAI,CAAC,SAAS;AACZ,cAAM,IAAI,aAAa,IAAI,OAAO,GAAG,8BAA8B;AAAA,MACrE;AAEA,UAAI,OAAO,UAAU;AACnB,cAAM,IAAI,aAAa,IAAI,OAAO,GAAG,MAAM,OAAO,KAAK,0CAA0C;AAAA,MACnG;AACA,YAAM,UAAU,OAAQ,QAAmC,SAAS;AACpE,UAAI,OAAO,SAAS,OAAO,KAAK,WAAW,KAAK,MAAM,KAAK,KAAK,EAAE,SAAS,SAAS;AAClF,cAAM,IAAI,aAAa,GAAG,OAAO,KAAK,kBAAkB,OAAO,kCAAkC,MAAM,KAAK,KAAK,EAAE,MAAM,GAAG;AAAA,MAC9H;AACA;AACA,UAAI,YAAY,OAAO,EAAG,SAAQ,MAAM,EAAE,eAAe,MAAM;AAE/D,UAAI,UAAU,IAAI;AAChB,mBAAW,SAAS,IAAI,IAAI;AAAA,MAC9B,OAAO;AACL,YAAI,WAAW;AACf,mBAAW,QAAQ,YAAY,EAAE,MAAM,OAAO,KAAA,CAAM,GAAG;AACrD,6BAAmB,MAAM;AACzB;AACA,qBAAW,SAAS,MAAM,KAAK,MAAM,SAAS,MAAM,CAAC;AACrD,qBAAW;AACX,gBAAM,MAAM,KAAK,YAAY,MAAM;AAAA,QACrC;AAAA,MACF;AACA,WAAK,SAAS,QAAQ;AACtB,UAAI,mBAAmB,OAAO;AAC9B,aAAO;AAAA,QACL,QACE,WAAW,UACP,WAAW,OAAO,KAAK,MACvB,cAAc,OAAO,KAAK,GAAG,SAAS,uBAAuB,EAAE;AAAA,MAAA;AAAA,IAEzE;AAAA,EAAA;AAEJ;AAGA,eAAsB,oBAAoB;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AACF,GAIkB;;AAChB,QAAM,MAAM,KAAK,YAAY,MAAM;AACnC,QAAM,YAAW,SAAI,gBAAJ,mBAAiB;AAClC,MAAI,KAAK,eAAe,KAAK,CAAC,YAAY,CAAC,IAAI,MAAM;AAEnD,UAAM,IAAI,QAAc,CAAC,YAAY,WAAW,SAAS,CAAC,CAAC;AAC3D;AAAA,EACF;AACA,MAAI,aAAa,KAAK,IAAA;AACtB,QAAM,WAAW,IAAI,SAAS,MAAM;AAClC,iBAAa,KAAK,IAAA;AAAA,EACpB,CAAC;AACD,WAAS,QAAQ,IAAI,MAAM,EAAE,SAAS,MAAM,WAAW,MAAM,YAAY,MAAM,eAAe,KAAA,CAAM;AACpG,QAAM,WAAW,KAAK,IAAA,IAAQ,KAAK;AACnC,MAAI;AACF,WAAO,KAAK,QAAQ,YAAY,KAAK,QAAQ,aAAa,KAAK,eAAe;AAC5E,YAAM,MAAM,IAAI,MAAM;AAAA,IACxB;AAAA,EACF,UAAA;AACE,aAAS,WAAA;AAAA,EACX;AACF;AAOO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA,gBAAgB,CAAC,UAAU,MAAM;AAAA,EACjC;AACF,GAKe;AACb,QAAM,QAAQ,CAAC,eAAe,WAAW,SAAS,YAAY;AAC9D,QAAM,WAAW,CAAC,UAAiB;AACjC,QAAI,CAAC,cAAc,KAAK,KAAK,aAAa,KAAK,EAAG;AAClD,eAAW,QAAQ;AAAA,EACrB;AACA,aAAW,QAAQ,MAAO,KAAI,iBAAiB,MAAM,UAAU,EAAE,SAAS,MAAM,SAAS,KAAA,CAAM;AAC/F,SAAO,MAAM;AACX,eAAW,QAAQ,MAAO,KAAI,oBAAoB,MAAM,UAAU,EAAE,SAAS,MAAM;AAAA,EACrF;AACF;"}

package/dist/agent-ui/index.cjs

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const contract = require("./contract.cjs");
+const AgentTarget = require("./AgentTarget.cjs");
+const AgentUiLayer = require("./AgentUiLayer.cjs");
+const pace = require("./pace.cjs");
+const screen = require("./screen.cjs");
+const tools = require("./tools.cjs");
+const useAgentTarget = require("./use-agent-target.cjs");
+const useAgentUi = require("./use-agent-ui.cjs");
+exports.AGENT_ATTR = contract.AGENT_ATTR;
+exports.AGENT_TARGET_ACTIONS = contract.AGENT_TARGET_ACTIONS;
+exports.agentRegion = contract.agentRegion;
+exports.agentTarget = contract.agentTarget;
+exports.agentTargetRef = contract.agentTargetRef;
+exports.isAgentTargetId = contract.isAgentTargetId;
+exports.registerAgentTargetHandlers = contract.registerAgentTargetHandlers;
+exports.AgentTarget = AgentTarget.AgentTarget;
+exports.AgentUiLayer = AgentUiLayer.AgentUiLayer;
+exports.MAX_STEPS = pace.MAX_STEPS;
+exports.POINT_DEFAULT_MS = pace.POINT_DEFAULT_MS;
+exports.POINT_MAX_MS = pace.POINT_MAX_MS;
+exports.AgentUiError = screen.AgentUiError;
+exports.describeTarget = screen.describeTarget;
+exports.readScreen = screen.readScreen;
+exports.resolveTarget = screen.resolveTarget;
+exports.snapshotTargets = screen.snapshotTargets;
+exports.AGENT_UI_ACT_SUMMARY = tools.AGENT_UI_ACT_SUMMARY;
+exports.AGENT_UI_TOOL_NAMES = tools.AGENT_UI_TOOL_NAMES;
+exports.createAgentUi = tools.createAgentUi;
+exports.useAgentTarget = useAgentTarget.useAgentTarget;
+exports.useAgentUi = useAgentUi.useAgentUi;
+//# sourceMappingURL=index.cjs.map

package/dist/agent-ui/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/agent-ui/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Agent-drivable UI: an app marks the elements its agent may see, point at and
+ * operate, and the agent gets a handful of tools for the screen the person has
+ * open: read it, point at something, walk through steps, operate a control.
+ * Everything it does is shown on the page as it happens.
+ *
+ * Published as the `@athenaintel/react/agent-ui` sub-path. `<AthenaProvider
+ * agentUi>` wires all of it in one prop; the pieces are here for a host that
+ * wires them itself or draws its own overlay.
+ */
+export { AGENT_ATTR, AGENT_TARGET_ACTIONS, type AgentTargetAction, type AgentTargetHandlers, type AgentTargetOptions, type AgentTargetProps as AgentTargetAttributes, agentRegion, agentTarget, agentTargetRef, isAgentTargetId, registerAgentTargetHandlers, } from './contract';
+export { AgentTarget, type AgentTargetProps } from './AgentTarget';
+export { AgentUiLayer, type AgentUiLayerClassNames, type AgentUiLayerProps, } from './AgentUiLayer';
+export { type AgentUiPace, type AgentUiSpeed, MAX_STEPS, POINT_DEFAULT_MS, POINT_MAX_MS } from './pace';
+export { AgentUiError, type AgentTargetSnapshot, describeTarget, readScreen, resolveTarget, snapshotTargets, } from './screen';
+export type { AgentUiCursor, AgentUiMark, AgentUiMarkTone, AgentUiQuestion, AgentUiStage, AgentUiStageState, AgentUiTour, AgentUiTourStep, } from './stage';
+export { AGENT_UI_ACT_SUMMARY, AGENT_UI_TOOL_NAMES, type AgentUi, type AgentUiOptions, type AgentUiRoute, type AgentUiTool, type AgentUiToolName, createAgentUi, } from './tools';
+export { type UseAgentTargetOptions, useAgentTarget } from './use-agent-target';
+export { type UseAgentUi, useAgentUi } from './use-agent-ui';

package/dist/agent-ui/index.js

@@ -0,0 +1,33 @@
+import { AGENT_ATTR, AGENT_TARGET_ACTIONS, agentRegion, agentTarget, agentTargetRef, isAgentTargetId, registerAgentTargetHandlers } from "./contract.js";
+import { AgentTarget } from "./AgentTarget.js";
+import { AgentUiLayer } from "./AgentUiLayer.js";
+import { MAX_STEPS, POINT_DEFAULT_MS, POINT_MAX_MS } from "./pace.js";
+import { AgentUiError, describeTarget, readScreen, resolveTarget, snapshotTargets } from "./screen.js";
+import { AGENT_UI_ACT_SUMMARY, AGENT_UI_TOOL_NAMES, createAgentUi } from "./tools.js";
+import { useAgentTarget } from "./use-agent-target.js";
+import { useAgentUi } from "./use-agent-ui.js";
+export {
+  AGENT_ATTR,
+  AGENT_TARGET_ACTIONS,
+  AGENT_UI_ACT_SUMMARY,
+  AGENT_UI_TOOL_NAMES,
+  AgentTarget,
+  AgentUiError,
+  AgentUiLayer,
+  MAX_STEPS,
+  POINT_DEFAULT_MS,
+  POINT_MAX_MS,
+  agentRegion,
+  agentTarget,
+  agentTargetRef,
+  createAgentUi,
+  describeTarget,
+  isAgentTargetId,
+  readScreen,
+  registerAgentTargetHandlers,
+  resolveTarget,
+  snapshotTargets,
+  useAgentTarget,
+  useAgentUi
+};
+//# sourceMappingURL=index.js.map

package/dist/agent-ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}