@athenaintel/react 0.60.1 → 0.61.0

package/dist/agent-ui/screen.cjs

@@ -0,0 +1,471 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const contract = require("./contract.cjs");
+const secretFields = require("./secret-fields.cjs");
+class AgentUiError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "AgentUiError";
+  }
+}
+const CONTROL_SELECTOR = 'input:not([type="hidden"]), textarea, select, [contenteditable=""], [contenteditable="true"]';
+const MAX_LABEL_CHARS = 80;
+const MAX_VALUE_CHARS = 200;
+const MAX_DESCRIPTION_CHARS = 240;
+const MAX_OPTIONS = 30;
+const MAX_OPTION_CHARS = 60;
+const MAX_REF_CHARS = 160;
+const MAX_REGIONS = 40;
+const tagOf = (element) => element.tagName.toUpperCase();
+function clip(text, max) {
+  const collapsed = text.replace(/\s+/g, " ").trim();
+  return collapsed.length > max ? `${collapsed.slice(0, max - 1)}…` : collapsed;
+}
+function inputType(element) {
+  return (element.getAttribute("type") ?? "text").toLowerCase();
+}
+function isEditable(element) {
+  const editable = element.getAttribute("contenteditable");
+  return editable === "" || editable === "true";
+}
+function controlOf(element) {
+  if (element.matches(CONTROL_SELECTOR)) return element;
+  const tag = tagOf(element);
+  if (tag === "BUTTON" || tag === "A") return null;
+  return element.querySelector(CONTROL_SELECTOR);
+}
+function roleOf(element, control) {
+  var _a, _b;
+  const explicit = (_a = element.getAttribute("role")) == null ? void 0 : _a.trim();
+  if (explicit) return explicit;
+  const subject = control ?? element;
+  const tag = tagOf(subject);
+  if (tag === "BUTTON" || tag === "SUMMARY") return "button";
+  if (tag === "A") return subject.hasAttribute("href") ? "link" : "element";
+  if (tag === "SELECT") return "combobox";
+  if (tag === "TEXTAREA") return "textbox";
+  if (tag === "INPUT") {
+    const type = inputType(subject);
+    if (type === "checkbox") return "checkbox";
+    if (type === "radio") return "radio";
+    if (type === "range") return "slider";
+    if (type === "button" || type === "submit" || type === "reset" || type === "image") return "button";
+    if (type === "search") return "searchbox";
+    return "textbox";
+  }
+  if (isEditable(subject)) return "textbox";
+  return ((_b = subject.getAttribute("role")) == null ? void 0 : _b.trim()) || "element";
+}
+function referencedText(element, attribute) {
+  const ids = (element.getAttribute(attribute) ?? "").split(/\s+/).filter(Boolean);
+  return ids.map((id) => {
+    const named = element.ownerDocument.getElementById(id);
+    return named ? shownText(named) : "";
+  }).join(" ").trim();
+}
+function labelsText(control) {
+  if (!control) return "";
+  const labels = control.labels;
+  if (!labels) return "";
+  return Array.from(labels, shownText).join(" ").trim();
+}
+function shownText(element) {
+  let text = "";
+  for (const node of Array.from(element.childNodes)) {
+    if (node.nodeType === 3) text += node.textContent ?? "";
+    else if (node.nodeType === 1) {
+      const child = node;
+      if (child.matches(CONTROL_SELECTOR) || tagOf(child) === "OPTION") continue;
+      if (child.hasAttribute(contract.AGENT_ATTR.sensitive)) continue;
+      text += ` ${shownText(child)}`;
+    }
+  }
+  return text;
+}
+function labelOf({
+  element,
+  control,
+  sensitive,
+  fallback
+}) {
+  const subject = control ?? element;
+  const candidates = [
+    element.getAttribute(contract.AGENT_ATTR.label),
+    element.getAttribute("aria-label"),
+    subject.getAttribute("aria-label"),
+    referencedText(element, "aria-labelledby"),
+    referencedText(subject, "aria-labelledby"),
+    labelsText(control),
+    subject.getAttribute("placeholder"),
+    element.getAttribute("title"),
+    subject.getAttribute("alt"),
+    // A button drawn by an `<input>` shows its `value` as its face.
+    !sensitive && tagOf(subject) === "INPUT" && roleOf(element, control) === "button" ? subject.getAttribute("value") : null,
+    // A control's own text is its value, never its name.
+    sensitive || control !== null && control === element ? null : shownText(element)
+  ];
+  for (const candidate of candidates) {
+    const text = candidate ? clip(candidate, MAX_LABEL_CHARS) : "";
+    if (text) return text;
+  }
+  return fallback;
+}
+function ariaFlag(element, attribute) {
+  const value = element.getAttribute(attribute);
+  if (value === "true") return true;
+  if (value === "false") return false;
+  return null;
+}
+function isDisabled(element, control) {
+  const subject = control ?? element;
+  if (element.getAttribute("aria-disabled") === "true") return true;
+  if (subject.getAttribute("aria-disabled") === "true") return true;
+  try {
+    return subject.matches(":disabled") || element.matches(":disabled");
+  } catch {
+    return subject.disabled === true;
+  }
+}
+function styleHides(element) {
+  const view = element.ownerDocument.defaultView;
+  for (let node = element; node; node = node.parentElement) {
+    if (node.hasAttribute("hidden") || node.hasAttribute("inert")) return true;
+    if (node.getAttribute("aria-hidden") === "true") return true;
+    const style = view == null ? void 0 : view.getComputedStyle(node);
+    if (style && (style.display === "none" || style.visibility === "hidden")) return true;
+  }
+  return false;
+}
+function isRendered(element) {
+  if (!element.isConnected) return false;
+  const check = element.checkVisibility;
+  if (typeof check === "function") {
+    try {
+      if (!check.call(element, { visibilityProperty: true })) return false;
+    } catch {
+    }
+  }
+  return !styleHides(element);
+}
+function isInViewport(element) {
+  const view = element.ownerDocument.defaultView;
+  if (!view) return false;
+  const rect = element.getBoundingClientRect();
+  if (rect.width <= 0 && rect.height <= 0) return false;
+  return rect.bottom > 0 && rect.right > 0 && rect.top < view.innerHeight && rect.left < view.innerWidth;
+}
+function selectOptions(control) {
+  const options = control.options;
+  if (!options) return [];
+  return Array.from(options, (option) => option.label || option.text || "").filter(Boolean);
+}
+function guarded(read, fallback) {
+  try {
+    return read();
+  } catch {
+    return fallback;
+  }
+}
+function controlValue(control) {
+  if (tagOf(control) === "SELECT") {
+    const select = control;
+    const chosen = Array.from(select.selectedOptions ?? [], (option) => option.label || option.text || "");
+    return chosen.length > 0 ? chosen.join(", ") : select.value ?? "";
+  }
+  if (isEditable(control)) return control.textContent ?? "";
+  return control.value ?? "";
+}
+function isReadOnly(control) {
+  if (!control) return false;
+  return control.hasAttribute("readonly") || control.getAttribute("aria-readonly") === "true";
+}
+function isFileInput(control) {
+  return control !== null && tagOf(control) === "INPUT" && inputType(control) === "file";
+}
+function derivedActions({
+  role,
+  control,
+  handlers
+}) {
+  const actions = /* @__PURE__ */ new Set();
+  switch (isFileInput(control) ? "file" : role) {
+    case "button":
+    case "link":
+    case "tab":
+    case "menuitem":
+    case "option":
+    case "treeitem":
+      actions.add("click");
+      break;
+    case "textbox":
+    case "searchbox":
+    case "spinbutton":
+      if (!isReadOnly(control)) {
+        actions.add("type");
+        actions.add("clear");
+      }
+      break;
+    case "combobox":
+    case "listbox":
+      if (control && tagOf(control) === "SELECT") actions.add("select");
+      else if (control) {
+        actions.add("type");
+        actions.add("clear");
+      }
+      break;
+    case "checkbox":
+    case "radio":
+    case "switch":
+      actions.add("toggle");
+      break;
+  }
+  if (handlers == null ? void 0 : handlers.click) actions.add("click");
+  if (handlers == null ? void 0 : handlers.type) actions.add("type");
+  if (handlers == null ? void 0 : handlers.select) actions.add("select");
+  if (handlers == null ? void 0 : handlers.toggle) actions.add("toggle");
+  if (handlers == null ? void 0 : handlers.clear) actions.add("clear");
+  return Array.from(actions);
+}
+function declaredActions(element) {
+  const declared = element.getAttribute(contract.AGENT_ATTR.actions);
+  if (declared === null) return null;
+  return declared.split(/\s+/).filter(contract.isAgentTargetAction);
+}
+function snapshotTarget(element) {
+  var _a, _b;
+  const id = element.getAttribute(contract.AGENT_ATTR.target) ?? "";
+  const key = element.getAttribute(contract.AGENT_ATTR.key) || null;
+  const ref = contract.agentTargetRef({ id, key });
+  const handlers = contract.agentTargetHandlers(ref) ?? (key ? contract.agentTargetHandlers(id) : void 0);
+  const control = controlOf(element);
+  const role = roleOf(element, control);
+  const danger = element.hasAttribute(contract.AGENT_ATTR.danger);
+  const sensitive = element.hasAttribute(contract.AGENT_ATTR.sensitive) || control !== null && secretFields.isSecretField(control);
+  const declared = declaredActions(element);
+  const allowed = declared ?? (danger ? [] : derivedActions({ role, control, handlers }));
+  const actions = sensitive ? allowed.filter((action) => action !== "type") : allowed;
+  const raw = (handlers == null ? void 0 : handlers.value) ? guarded(() => {
+    var _a2;
+    return ((_a2 = handlers.value) == null ? void 0 : _a2.call(handlers)) ?? null;
+  }, null) : control ? controlValue(control) : null;
+  const isCheckable = role === "checkbox" || role === "radio" || role === "switch";
+  const checkedProperty = control && tagOf(control) === "INPUT" && (inputType(control) === "checkbox" || inputType(control) === "radio") ? control.checked === true : null;
+  const everyOption = (handlers == null ? void 0 : handlers.options) ? guarded(() => {
+    var _a2;
+    return Array.from(((_a2 = handlers.options) == null ? void 0 : _a2.call(handlers)) ?? [], String);
+  }, []) : control && tagOf(control) === "SELECT" ? selectOptions(control) : null;
+  const options = everyOption ? everyOption.map((option) => clip(option, MAX_OPTION_CHARS)).filter(Boolean).slice(0, MAX_OPTIONS) : null;
+  return {
+    ref,
+    id,
+    key,
+    element,
+    control,
+    role,
+    label: labelOf({ element, control, sensitive, fallback: ref }),
+    description: clip(element.getAttribute(contract.AGENT_ATTR.description) ?? "", MAX_DESCRIPTION_CHARS) || null,
+    region: ((_b = (_a = element.parentElement) == null ? void 0 : _a.closest(`[${contract.AGENT_ATTR.region}]`)) == null ? void 0 : _b.getAttribute(contract.AGENT_ATTR.region)) ?? null,
+    actions,
+    danger,
+    sensitive,
+    disabled: isDisabled(element, control),
+    visible: isRendered(element),
+    onScreen: isInViewport(element),
+    value: sensitive || isCheckable || raw === null ? null : clip(raw, MAX_VALUE_CHARS),
+    filled: sensitive && raw !== null ? raw !== "" : null,
+    checked: checkedProperty ?? ariaFlag(element, "aria-checked") ?? ariaFlag(element, "aria-pressed"),
+    selected: ariaFlag(element, "aria-selected") ?? (element.hasAttribute("aria-current") ? element.getAttribute("aria-current") !== "false" : null),
+    expanded: ariaFlag(element, "aria-expanded"),
+    options: options && options.length > 0 ? options : null,
+    optionsOmitted: everyOption && options ? Math.max(0, everyOption.length - options.length) : 0,
+    readOnly: isReadOnly(control),
+    handlers
+  };
+}
+function findTargetElements(doc) {
+  return Array.from(doc.querySelectorAll(`[${contract.AGENT_ATTR.target}]`)).filter(
+    (element) => element.getAttribute(contract.AGENT_ATTR.target) !== "" && !element.closest(`[${contract.AGENT_ATTR.layer}]`)
+  );
+}
+function snapshotTargets(doc) {
+  return findTargetElements(doc).map(snapshotTarget).filter((target) => target.visible && target.ref.length <= MAX_REF_CHARS);
+}
+function suggestions(targets, wanted) {
+  const words = wanted.toLowerCase().split(/[^a-z0-9]+/).filter((word) => word.length > 2);
+  const refs = Array.from(new Set(targets.map((target) => target.ref)));
+  const close = refs.filter((ref) => words.some((word) => ref.toLowerCase().includes(word)));
+  const listed = (close.length > 0 ? close : refs).slice(0, 8);
+  if (listed.length === 0) return "This screen has no targets.";
+  return `${close.length > 0 ? "Closest here" : "Targets here"}: ${listed.join(", ")}${refs.length > listed.length ? ", …" : ""}.`;
+}
+function resolveTarget({
+  doc,
+  ref,
+  allowLabel = false,
+  exact = false
+}) {
+  const parsed = contract.parseAgentTargetRef(ref);
+  if (!parsed) throw new AgentUiError(`"${ref}" is not a target. Give a target from read_screen.`);
+  const all = snapshotTargets(doc);
+  const byId = all.filter(
+    (target) => target.id === parsed.id && (parsed.key === null || target.key === parsed.key)
+  );
+  let matches = byId;
+  if (matches.length === 0 && allowLabel) {
+    const wanted = ref.trim().toLowerCase();
+    const exact2 = all.filter((target) => target.label.toLowerCase() === wanted);
+    const partial = all.filter((target) => target.label.toLowerCase().includes(wanted));
+    matches = exact2.length > 0 ? exact2 : partial.length === 1 ? partial : [];
+  }
+  const found = matches.find((target) => target.onScreen) ?? matches[0];
+  if (!found) {
+    throw new AgentUiError(
+      `No target "${ref}" is on the screen now. ${suggestions(all, ref)} Call read_screen for what is here; a target on another page appears once that page is open.`
+    );
+  }
+  if (exact && matches.length > 1) {
+    const keyed = Array.from(new Set(matches.map((target) => target.ref))).filter((other) => other !== ref);
+    throw new AgentUiError(
+      keyed.length > 0 ? `${matches.length} targets share "${ref}". Name the one you mean by its key, e.g. ${keyed.slice(0, 5).join(", ")}.` : `${matches.length} elements on the screen are all "${ref}", so it cannot be operated by name. Point at it instead, and let the person do it.`
+    );
+  }
+  return found;
+}
+async function waitForTarget({
+  doc,
+  ref,
+  timeoutMs,
+  signal,
+  allowLabel = false
+}) {
+  const deadline = Date.now() + timeoutMs;
+  for (; ; ) {
+    try {
+      return resolveTarget({ doc, ref, allowLabel });
+    } catch (error) {
+      if (!(error instanceof AgentUiError)) throw error;
+    }
+    if ((signal == null ? void 0 : signal.aborted) || Date.now() >= deadline) return null;
+    await new Promise((resolve) => setTimeout(resolve, 120));
+  }
+}
+function describeTarget(target) {
+  return {
+    target: target.ref,
+    role: target.role,
+    label: target.label,
+    ...target.description ? { does: target.description } : {},
+    ...target.value !== null ? { value: target.value } : {},
+    ...target.filled !== null ? { filled: target.filled } : {},
+    ...target.checked !== null ? { checked: target.checked } : {},
+    ...target.selected ? { selected: true } : {},
+    ...target.expanded !== null ? { expanded: target.expanded } : {},
+    ...target.options ? { options: target.options } : {},
+    ...target.optionsOmitted > 0 ? { more_options: target.optionsOmitted } : {},
+    ...target.readOnly ? { read_only: true } : {},
+    can: target.actions.length > 0 ? target.actions : "point only",
+    ...target.region ? { region: target.region } : {},
+    ...target.disabled ? { disabled: true } : {},
+    ...target.danger ? { danger: "the person confirms every action on it" } : {},
+    ...target.sensitive ? { sensitive: "its value is never read or typed" } : {},
+    ...target.onScreen ? {} : { scrolled_out_of_view: true }
+  };
+}
+const READ_SCREEN_MAX_TARGETS = 120;
+const READ_SCREEN_MAX_PER_ID = 25;
+const READ_SCREEN_MAX_CHARS = 24e3;
+function readScreen({
+  doc,
+  region,
+  query,
+  maxChars = READ_SCREEN_MAX_CHARS
+}) {
+  var _a;
+  const all = snapshotTargets(doc);
+  const wantedRegion = region == null ? void 0 : region.trim();
+  const wantedText = query == null ? void 0 : query.trim().toLowerCase();
+  const matching = all.filter((target) => {
+    if (wantedRegion && target.region !== wantedRegion) return false;
+    if (!wantedText) return true;
+    return [target.ref, target.label, target.description ?? "", target.value ?? ""].some(
+      (text) => text.toLowerCase().includes(wantedText)
+    );
+  });
+  const perId = /* @__PURE__ */ new Map();
+  const overPerId = /* @__PURE__ */ new Map();
+  const withinPerId = matching.filter((target) => {
+    const seen = (perId.get(target.id) ?? 0) + 1;
+    perId.set(target.id, seen);
+    if (seen <= READ_SCREEN_MAX_PER_ID) return true;
+    overPerId.set(target.id, (overPerId.get(target.id) ?? 0) + 1);
+    return false;
+  });
+  let kept = withinPerId;
+  if (kept.length > READ_SCREEN_MAX_TARGETS) {
+    const inView = kept.filter((target) => target.onScreen).slice(0, READ_SCREEN_MAX_TARGETS);
+    const room = READ_SCREEN_MAX_TARGETS - inView.length;
+    const rest = new Set(kept.filter((target) => !target.onScreen).slice(0, room));
+    const chosen = new Set(inView);
+    kept = kept.filter((target) => chosen.has(target) || rest.has(target));
+  }
+  const regions = /* @__PURE__ */ new Map();
+  for (const target of all) {
+    if (!target.region) continue;
+    const entry = regions.get(target.region);
+    if (entry) entry.targets += 1;
+    else {
+      const element = (_a = target.element.parentElement) == null ? void 0 : _a.closest(`[${contract.AGENT_ATTR.region}]`);
+      const label = (element == null ? void 0 : element.getAttribute(contract.AGENT_ATTR.label)) ?? (element == null ? void 0 : element.getAttribute("aria-label"));
+      regions.set(target.region, { label: label ? clip(label, MAX_LABEL_CHARS) : null, targets: 1 });
+    }
+  }
+  const view = doc.defaultView;
+  const listed = kept.map(describeTarget);
+  const result = (targets) => {
+    const omitted = matching.length - targets.length;
+    return {
+      page: {
+        title: clip(doc.title ?? "", MAX_LABEL_CHARS),
+        ...view ? { path: `${view.location.pathname}${view.location.search}` } : {}
+      },
+      ...regions.size > 0 ? {
+        regions: Array.from(regions, ([id, entry]) => ({
+          region: id,
+          ...entry.label ? { label: entry.label } : {},
+          targets: entry.targets
+        })).slice(0, MAX_REGIONS),
+        ...regions.size > MAX_REGIONS ? { more_regions: regions.size - MAX_REGIONS } : {}
+      } : {},
+      targets,
+      ...overPerId.size > 0 ? {
+        more_sharing_an_id: Object.fromEntries(overPerId)
+      } : {},
+      ...omitted > 0 ? {
+        omitted,
+        note: "Not every target fits one read: narrow it with `region` or `query`."
+      } : {},
+      ...all.length === 0 ? { note: "This screen has no agent targets: nothing here can be pointed at or operated." } : matching.length === 0 ? { note: "No target matches. Read again without `region` and `query`." } : {}
+    };
+  };
+  let answer = result(listed);
+  while (listed.length > 0 && JSON.stringify(answer).length > maxChars) {
+    listed.pop();
+    answer = result(listed);
+  }
+  return answer;
+}
+exports.AgentUiError = AgentUiError;
+exports.READ_SCREEN_MAX_CHARS = READ_SCREEN_MAX_CHARS;
+exports.READ_SCREEN_MAX_PER_ID = READ_SCREEN_MAX_PER_ID;
+exports.READ_SCREEN_MAX_TARGETS = READ_SCREEN_MAX_TARGETS;
+exports.controlOf = controlOf;
+exports.describeTarget = describeTarget;
+exports.findTargetElements = findTargetElements;
+exports.isInViewport = isInViewport;
+exports.isRendered = isRendered;
+exports.readScreen = readScreen;
+exports.resolveTarget = resolveTarget;
+exports.snapshotTarget = snapshotTarget;
+exports.snapshotTargets = snapshotTargets;
+exports.waitForTarget = waitForTarget;
+//# sourceMappingURL=screen.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"screen.cjs","sources":["../../src/agent-ui/screen.ts"],"sourcesContent":["/*\n * Reading the screen: the agent targets in a document, each with the name,\n * state and allowed actions the agent is told, and the lookup the tools use to\n * turn the agent's reference back into an element.\n *\n * Read at call time, never cached: the document is the registry, so a target\n * that is not in it is not on the screen.\n */\n\nimport {\n  AGENT_ATTR,\n  type AgentTargetAction,\n  type AgentTargetHandlers,\n  agentTargetHandlers,\n  agentTargetRef,\n  isAgentTargetAction,\n  parseAgentTargetRef,\n} from './contract';\nimport { isSecretField } from './secret-fields';\n\n/** A refusal or a miss the agent is told about, in words it can act on. */\nexport class AgentUiError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'AgentUiError';\n  }\n}\n\n/** One target as it is on screen now. */\nexport interface AgentTargetSnapshot {\n  /** How the agent names it: `id`, or `id[key]`. */\n  ref: string;\n  id: string;\n  key: string | null;\n  element: Element;\n  /** The form control the target stands for: itself, or the one inside it. */\n  control: Element | null;\n  role: string;\n  label: string;\n  description: string | null;\n  region: string | null;\n  /** What the agent may do to it. Empty: it may only be pointed at. */\n  actions: readonly AgentTargetAction[];\n  danger: boolean;\n  sensitive: boolean;\n  disabled: boolean;\n  /** Rendered (not hidden by the page). */\n  visible: boolean;\n  /** Inside the viewport now. */\n  onScreen: boolean;\n  /** Its value, absent for a sensitive target and for one that has none. */\n  value: string | null;\n  /** For a sensitive field: whether it holds anything. */\n  filled: boolean | null;\n  checked: boolean | null;\n  selected: boolean | null;\n  expanded: boolean | null;\n  /** What a `select` may be given. */\n  options: readonly string[] | null;\n  /** How many more options there are than `options` lists. */\n  optionsOmitted: number;\n  /** A field the page shows but does not let anyone edit. */\n  readOnly: boolean;\n  handlers: AgentTargetHandlers | undefined;\n}\n\nconst CONTROL_SELECTOR =\n  'input:not([type=\"hidden\"]), textarea, select, [contenteditable=\"\"], [contenteditable=\"true\"]';\n\nconst MAX_LABEL_CHARS = 80;\nconst MAX_VALUE_CHARS = 200;\nconst MAX_DESCRIPTION_CHARS = 240;\nconst MAX_OPTIONS = 30;\nconst MAX_OPTION_CHARS = 60;\n/** A reference longer than this is not one the agent could pass back reliably. */\nconst MAX_REF_CHARS = 160;\n/** The most regions one read names. */\nconst MAX_REGIONS = 40;\n\nconst tagOf = (element: Element): string => element.tagName.toUpperCase();\n\nfunction clip(text: string, max: number): string {\n  const collapsed = text.replace(/\\s+/g, ' ').trim();\n  return collapsed.length > max ? `${collapsed.slice(0, max - 1)}…` : collapsed;\n}\n\nfunction inputType(element: Element): string {\n  return (element.getAttribute('type') ?? 'text').toLowerCase();\n}\n\nfunction isEditable(element: Element): boolean {\n  const editable = element.getAttribute('contenteditable');\n  return editable === '' || editable === 'true';\n}\n\n/** The form control a target stands for: itself, or the first one inside it. */\nexport function controlOf(element: Element): Element | null {\n  if (element.matches(CONTROL_SELECTOR)) return element;\n  const tag = tagOf(element);\n  if (tag === 'BUTTON' || tag === 'A') return null;\n  return element.querySelector(CONTROL_SELECTOR);\n}\n\nfunction roleOf(element: Element, control: Element | null): string {\n  const explicit = element.getAttribute('role')?.trim();\n  if (explicit) return explicit;\n  const subject = control ?? element;\n  const tag = tagOf(subject);\n  if (tag === 'BUTTON' || tag === 'SUMMARY') return 'button';\n  if (tag === 'A') return subject.hasAttribute('href') ? 'link' : 'element';\n  if (tag === 'SELECT') return 'combobox';\n  if (tag === 'TEXTAREA') return 'textbox';\n  if (tag === 'INPUT') {\n    const type = inputType(subject);\n    if (type === 'checkbox') return 'checkbox';\n    if (type === 'radio') return 'radio';\n    if (type === 'range') return 'slider';\n    if (type === 'button' || type === 'submit' || type === 'reset' || type === 'image') return 'button';\n    if (type === 'search') return 'searchbox';\n    return 'textbox';\n  }\n  if (isEditable(subject)) return 'textbox';\n  return subject.getAttribute('role')?.trim() || 'element';\n}\n\nfunction referencedText(element: Element, attribute: string): string {\n  const ids = (element.getAttribute(attribute) ?? '').split(/\\s+/).filter(Boolean);\n  return ids\n    .map((id) => {\n      const named = element.ownerDocument.getElementById(id);\n      return named ? shownText(named) : '';\n    })\n    .join(' ')\n    .trim();\n}\n\nfunction labelsText(control: Element | null): string {\n  if (!control) return '';\n  const labels = (control as { labels?: ArrayLike<Element> | null }).labels;\n  if (!labels) return '';\n  // A `<label>` wrapped around its field holds the field's contents too.\n  return Array.from(labels, shownText).join(' ').trim();\n}\n\n/**\n * The words an element shows, without what any field inside it holds: a\n * field's contents are its value, never part of a name.\n */\nfunction shownText(element: Element): string {\n  let text = '';\n  for (const node of Array.from(element.childNodes)) {\n    if (node.nodeType === 3) text += node.textContent ?? '';\n    else if (node.nodeType === 1) {\n      const child = node as Element;\n      if (child.matches(CONTROL_SELECTOR) || tagOf(child) === 'OPTION') continue;\n      // Nor what the app marked sensitive inside it: a secret shown as text\n      // must not ride out in the name of the element around it.\n      if (child.hasAttribute(AGENT_ATTR.sensitive)) continue;\n      text += ` ${shownText(child)}`;\n    }\n  }\n  return text;\n}\n\nfunction labelOf({\n  element,\n  control,\n  sensitive,\n  fallback,\n}: {\n  element: Element;\n  control: Element | null;\n  /** The target's own text is then a secret, so only what names it is used. */\n  sensitive: boolean;\n  fallback: string;\n}): string {\n  const subject = control ?? element;\n  const candidates = [\n    element.getAttribute(AGENT_ATTR.label),\n    element.getAttribute('aria-label'),\n    subject.getAttribute('aria-label'),\n    referencedText(element, 'aria-labelledby'),\n    referencedText(subject, 'aria-labelledby'),\n    labelsText(control),\n    subject.getAttribute('placeholder'),\n    element.getAttribute('title'),\n    subject.getAttribute('alt'),\n    // A button drawn by an `<input>` shows its `value` as its face.\n    !sensitive && tagOf(subject) === 'INPUT' && roleOf(element, control) === 'button'\n      ? subject.getAttribute('value')\n      : null,\n    // A control's own text is its value, never its name.\n    sensitive || (control !== null && control === element) ? null : shownText(element),\n  ];\n  for (const candidate of candidates) {\n    const text = candidate ? clip(candidate, MAX_LABEL_CHARS) : '';\n    if (text) return text;\n  }\n  return fallback;\n}\n\nfunction ariaFlag(element: Element, attribute: string): boolean | null {\n  const value = element.getAttribute(attribute);\n  if (value === 'true') return true;\n  if (value === 'false') return false;\n  return null;\n}\n\nfunction isDisabled(element: Element, control: Element | null): boolean {\n  const subject = control ?? element;\n  if (element.getAttribute('aria-disabled') === 'true') return true;\n  if (subject.getAttribute('aria-disabled') === 'true') return true;\n  try {\n    return subject.matches(':disabled') || element.matches(':disabled');\n  } catch {\n    return (subject as { disabled?: boolean }).disabled === true;\n  }\n}\n\nfunction styleHides(element: Element): boolean {\n  const view = element.ownerDocument.defaultView;\n  for (let node: Element | null = element; node; node = node.parentElement) {\n    if (node.hasAttribute('hidden') || node.hasAttribute('inert')) return true;\n    if (node.getAttribute('aria-hidden') === 'true') return true;\n    const style = view?.getComputedStyle(node);\n    if (style && (style.display === 'none' || style.visibility === 'hidden')) return true;\n  }\n  return false;\n}\n\n/** Whether the page renders the element at all. */\nexport function isRendered(element: Element): boolean {\n  if (!element.isConnected) return false;\n  const check = (element as { checkVisibility?: (options?: object) => boolean }).checkVisibility;\n  if (typeof check === 'function') {\n    try {\n      if (!check.call(element, { visibilityProperty: true })) return false;\n    } catch {\n      /* fall through to the style walk */\n    }\n  }\n  return !styleHides(element);\n}\n\n/** Whether any of the element is inside the viewport now. */\nexport function isInViewport(element: Element): boolean {\n  const view = element.ownerDocument.defaultView;\n  if (!view) return false;\n  const rect = element.getBoundingClientRect();\n  if (rect.width <= 0 && rect.height <= 0) return false;\n  return (\n    rect.bottom > 0 && rect.right > 0 && rect.top < view.innerHeight && rect.left < view.innerWidth\n  );\n}\n\nfunction selectOptions(control: Element): string[] {\n  const options = (control as { options?: ArrayLike<{ label?: string; text?: string }> }).options;\n  if (!options) return [];\n  return Array.from(options, (option) => option.label || option.text || '').filter(Boolean);\n}\n\n/** `read()`, or `fallback` when it throws. */\nfunction guarded<T>(read: () => T, fallback: T): T {\n  try {\n    return read();\n  } catch {\n    return fallback;\n  }\n}\n\nfunction controlValue(control: Element): string {\n  if (tagOf(control) === 'SELECT') {\n    const select = control as unknown as {\n      selectedOptions?: ArrayLike<{ label?: string; text?: string }>;\n      value?: string;\n    };\n    const chosen = Array.from(select.selectedOptions ?? [], (option) => option.label || option.text || '');\n    return chosen.length > 0 ? chosen.join(', ') : (select.value ?? '');\n  }\n  if (isEditable(control)) return control.textContent ?? '';\n  return (control as { value?: string }).value ?? '';\n}\n\nfunction isReadOnly(control: Element | null): boolean {\n  if (!control) return false;\n  return control.hasAttribute('readonly') || control.getAttribute('aria-readonly') === 'true';\n}\n\n/** A file input opens the system's file picker, which only the person can use. */\nfunction isFileInput(control: Element | null): boolean {\n  return control !== null && tagOf(control) === 'INPUT' && inputType(control) === 'file';\n}\n\nfunction derivedActions({\n  role,\n  control,\n  handlers,\n}: {\n  role: string;\n  control: Element | null;\n  handlers: AgentTargetHandlers | undefined;\n}): AgentTargetAction[] {\n  const actions = new Set<AgentTargetAction>();\n  switch (isFileInput(control) ? 'file' : role) {\n    case 'button':\n    case 'link':\n    case 'tab':\n    case 'menuitem':\n    case 'option':\n    case 'treeitem':\n      actions.add('click');\n      break;\n    case 'textbox':\n    case 'searchbox':\n    case 'spinbutton':\n      if (!isReadOnly(control)) {\n        actions.add('type');\n        actions.add('clear');\n      }\n      break;\n    case 'combobox':\n    case 'listbox':\n      if (control && tagOf(control) === 'SELECT') actions.add('select');\n      else if (control) {\n        actions.add('type');\n        actions.add('clear');\n      }\n      break;\n    case 'checkbox':\n    case 'radio':\n    case 'switch':\n      actions.add('toggle');\n      break;\n    default:\n      break;\n  }\n  if (handlers?.click) actions.add('click');\n  if (handlers?.type) actions.add('type');\n  if (handlers?.select) actions.add('select');\n  if (handlers?.toggle) actions.add('toggle');\n  if (handlers?.clear) actions.add('clear');\n  return Array.from(actions);\n}\n\nfunction declaredActions(element: Element): AgentTargetAction[] | null {\n  const declared = element.getAttribute(AGENT_ATTR.actions);\n  if (declared === null) return null;\n  return declared.split(/\\s+/).filter(isAgentTargetAction);\n}\n\n/** One target element as the agent is told about it. */\nexport function snapshotTarget(element: Element): AgentTargetSnapshot {\n  const id = element.getAttribute(AGENT_ATTR.target) ?? '';\n  const key = element.getAttribute(AGENT_ATTR.key) || null;\n  const ref = agentTargetRef({ id, key });\n  const handlers = agentTargetHandlers(ref) ?? (key ? agentTargetHandlers(id) : undefined);\n  const control = controlOf(element);\n  const role = roleOf(element, control);\n  const danger = element.hasAttribute(AGENT_ATTR.danger);\n  const sensitive =\n    element.hasAttribute(AGENT_ATTR.sensitive) || (control !== null && isSecretField(control));\n  const declared = declaredActions(element);\n  // A dangerous target allows only what the app spelled out for it.\n  const allowed = declared ?? (danger ? [] : derivedActions({ role, control, handlers }));\n  const actions = sensitive ? allowed.filter((action) => action !== 'type') : allowed;\n\n  // A target's own handlers are the app's code: one that throws costs that\n  // target its value or options, never the whole read. Where a handler answers\n  // for the value, its answer stands (`null`: it has none to show).\n  const raw = handlers?.value\n    ? guarded(() => handlers.value?.() ?? null, null)\n    : control\n      ? controlValue(control)\n      : null;\n  const isCheckable = role === 'checkbox' || role === 'radio' || role === 'switch';\n  const checkedProperty =\n    control && tagOf(control) === 'INPUT' && (inputType(control) === 'checkbox' || inputType(control) === 'radio')\n      ? (control as { checked?: boolean }).checked === true\n      : null;\n\n  const everyOption = handlers?.options\n    ? guarded(() => Array.from(handlers.options?.() ?? [], String), [])\n    : control && tagOf(control) === 'SELECT'\n      ? selectOptions(control)\n      : null;\n  const options = everyOption\n    ? everyOption\n        .map((option) => clip(option, MAX_OPTION_CHARS))\n        .filter(Boolean)\n        .slice(0, MAX_OPTIONS)\n    : null;\n\n  return {\n    ref,\n    id,\n    key,\n    element,\n    control,\n    role,\n    label: labelOf({ element, control, sensitive, fallback: ref }),\n    description: clip(element.getAttribute(AGENT_ATTR.description) ?? '', MAX_DESCRIPTION_CHARS) || null,\n    region: element.parentElement?.closest(`[${AGENT_ATTR.region}]`)?.getAttribute(AGENT_ATTR.region) ?? null,\n    actions,\n    danger,\n    sensitive,\n    disabled: isDisabled(element, control),\n    visible: isRendered(element),\n    onScreen: isInViewport(element),\n    value: sensitive || isCheckable || raw === null ? null : clip(raw, MAX_VALUE_CHARS),\n    filled: sensitive && raw !== null ? raw !== '' : null,\n    checked: checkedProperty ?? ariaFlag(element, 'aria-checked') ?? ariaFlag(element, 'aria-pressed'),\n    selected:\n      ariaFlag(element, 'aria-selected') ??\n      (element.hasAttribute('aria-current') ? element.getAttribute('aria-current') !== 'false' : null),\n    expanded: ariaFlag(element, 'aria-expanded'),\n    options: options && options.length > 0 ? options : null,\n    optionsOmitted: everyOption && options ? Math.max(0, everyOption.length - options.length) : 0,\n    readOnly: isReadOnly(control),\n    handlers,\n  };\n}\n\n/** Every target element in the document, in document order. The overlay's own are never targets. */\nexport function findTargetElements(doc: Document): Element[] {\n  return Array.from(doc.querySelectorAll(`[${AGENT_ATTR.target}]`)).filter(\n    (element) =>\n      element.getAttribute(AGENT_ATTR.target) !== '' && !element.closest(`[${AGENT_ATTR.layer}]`),\n  );\n}\n\n/** Every rendered target, in document order. */\nexport function snapshotTargets(doc: Document): AgentTargetSnapshot[] {\n  return findTargetElements(doc)\n    .map(snapshotTarget)\n    .filter((target) => target.visible && target.ref.length <= MAX_REF_CHARS);\n}\n\nfunction suggestions(targets: readonly AgentTargetSnapshot[], wanted: string): string {\n  const words = wanted.toLowerCase().split(/[^a-z0-9]+/).filter((word) => word.length > 2);\n  const refs = Array.from(new Set(targets.map((target) => target.ref)));\n  const close = refs.filter((ref) => words.some((word) => ref.toLowerCase().includes(word)));\n  const listed = (close.length > 0 ? close : refs).slice(0, 8);\n  if (listed.length === 0) return 'This screen has no targets.';\n  return `${close.length > 0 ? 'Closest here' : 'Targets here'}: ${listed.join(', ')}${refs.length > listed.length ? ', …' : ''}.`;\n}\n\n/**\n * The target the agent named. By id (and key); a pointing tool may also name\n * it by its label. Throws an {@link AgentUiError} that says what is on screen\n * instead, so the agent can correct itself in one step.\n */\nexport function resolveTarget({\n  doc,\n  ref,\n  allowLabel = false,\n  exact = false,\n}: {\n  doc: Document;\n  ref: string;\n  allowLabel?: boolean;\n  /**\n   * The reference must name one target and no other (a tool about to act):\n   * several targets sharing the id is then a question for the agent, not a\n   * choice made for it.\n   */\n  exact?: boolean;\n}): AgentTargetSnapshot {\n  const parsed = parseAgentTargetRef(ref);\n  if (!parsed) throw new AgentUiError(`\"${ref}\" is not a target. Give a target from read_screen.`);\n  const all = snapshotTargets(doc);\n  const byId = all.filter(\n    (target) => target.id === parsed.id && (parsed.key === null || target.key === parsed.key),\n  );\n  let matches = byId;\n  if (matches.length === 0 && allowLabel) {\n    const wanted = ref.trim().toLowerCase();\n    const exact = all.filter((target) => target.label.toLowerCase() === wanted);\n    const partial = all.filter((target) => target.label.toLowerCase().includes(wanted));\n    matches = exact.length > 0 ? exact : partial.length === 1 ? partial : [];\n  }\n  const found = matches.find((target) => target.onScreen) ?? matches[0];\n  if (!found) {\n    throw new AgentUiError(\n      `No target \"${ref}\" is on the screen now. ${suggestions(all, ref)} Call read_screen for what is here; a target on another page appears once that page is open.`,\n    );\n  }\n  if (exact && matches.length > 1) {\n    const keyed = Array.from(new Set(matches.map((target) => target.ref))).filter((other) => other !== ref);\n    throw new AgentUiError(\n      keyed.length > 0\n        ? `${matches.length} targets share \"${ref}\". Name the one you mean by its key, e.g. ${keyed.slice(0, 5).join(', ')}.`\n        : `${matches.length} elements on the screen are all \"${ref}\", so it cannot be operated by name. Point at it instead, and let the person do it.`,\n    );\n  }\n  return found;\n}\n\n/** Wait for a target to be on the page (a page that is still loading), or give up. */\nexport async function waitForTarget({\n  doc,\n  ref,\n  timeoutMs,\n  signal,\n  allowLabel = false,\n}: {\n  doc: Document;\n  ref: string;\n  timeoutMs: number;\n  signal?: AbortSignal;\n  allowLabel?: boolean;\n}): Promise<AgentTargetSnapshot | null> {\n  const deadline = Date.now() + timeoutMs;\n  for (;;) {\n    try {\n      return resolveTarget({ doc, ref, allowLabel });\n    } catch (error) {\n      if (!(error instanceof AgentUiError)) throw error;\n    }\n    if (signal?.aborted || Date.now() >= deadline) return null;\n    await new Promise((resolve) => setTimeout(resolve, 120));\n  }\n}\n\n/** A target as the agent reads it: only what is set, in few words. */\nexport function describeTarget(target: AgentTargetSnapshot): Record<string, unknown> {\n  return {\n    target: target.ref,\n    role: target.role,\n    label: target.label,\n    ...(target.description ? { does: target.description } : {}),\n    ...(target.value !== null ? { value: target.value } : {}),\n    ...(target.filled !== null ? { filled: target.filled } : {}),\n    ...(target.checked !== null ? { checked: target.checked } : {}),\n    ...(target.selected ? { selected: true } : {}),\n    ...(target.expanded !== null ? { expanded: target.expanded } : {}),\n    ...(target.options ? { options: target.options } : {}),\n    ...(target.optionsOmitted > 0 ? { more_options: target.optionsOmitted } : {}),\n    ...(target.readOnly ? { read_only: true } : {}),\n    can: target.actions.length > 0 ? target.actions : 'point only',\n    ...(target.region ? { region: target.region } : {}),\n    ...(target.disabled ? { disabled: true } : {}),\n    ...(target.danger ? { danger: 'the person confirms every action on it' } : {}),\n    ...(target.sensitive ? { sensitive: 'its value is never read or typed' } : {}),\n    ...(target.onScreen ? {} : { scrolled_out_of_view: true }),\n  };\n}\n\n/** The most targets one read lists. */\nexport const READ_SCREEN_MAX_TARGETS = 120;\n/** The most targets sharing one id (a table's rows) one read lists. */\nexport const READ_SCREEN_MAX_PER_ID = 25;\n/** The most characters one read answers with, under the runtime's cap on a client tool's result. */\nexport const READ_SCREEN_MAX_CHARS = 24_000;\n\nexport interface ReadScreenArgs {\n  doc: Document;\n  /** Only the targets of this region. */\n  region?: string;\n  /** Only targets whose reference, label, description or value holds this text. */\n  query?: string;\n  /** The most characters the answer may take, when the caller adds to it. Defaults to the whole cap. */\n  maxChars?: number;\n}\n\n/** What `read_screen` answers: the page, its regions and its targets, bounded. */\nexport function readScreen({\n  doc,\n  region,\n  query,\n  maxChars = READ_SCREEN_MAX_CHARS,\n}: ReadScreenArgs): Record<string, unknown> {\n  const all = snapshotTargets(doc);\n  const wantedRegion = region?.trim();\n  const wantedText = query?.trim().toLowerCase();\n  const matching = all.filter((target) => {\n    if (wantedRegion && target.region !== wantedRegion) return false;\n    if (!wantedText) return true;\n    return [target.ref, target.label, target.description ?? '', target.value ?? ''].some((text) =>\n      text.toLowerCase().includes(wantedText),\n    );\n  });\n\n  // Rows of one table share an id: list the first of them and count the rest.\n  const perId = new Map<string, number>();\n  const overPerId = new Map<string, number>();\n  const withinPerId = matching.filter((target) => {\n    const seen = (perId.get(target.id) ?? 0) + 1;\n    perId.set(target.id, seen);\n    if (seen <= READ_SCREEN_MAX_PER_ID) return true;\n    overPerId.set(target.id, (overPerId.get(target.id) ?? 0) + 1);\n    return false;\n  });\n\n  // Over the cap, what is in view is kept first; the order stays the page's.\n  let kept = withinPerId;\n  if (kept.length > READ_SCREEN_MAX_TARGETS) {\n    const inView = kept.filter((target) => target.onScreen).slice(0, READ_SCREEN_MAX_TARGETS);\n    const room = READ_SCREEN_MAX_TARGETS - inView.length;\n    const rest = new Set(kept.filter((target) => !target.onScreen).slice(0, room));\n    const chosen = new Set(inView);\n    kept = kept.filter((target) => chosen.has(target) || rest.has(target));\n  }\n\n  const regions = new Map<string, { label: string | null; targets: number }>();\n  for (const target of all) {\n    if (!target.region) continue;\n    const entry = regions.get(target.region);\n    if (entry) entry.targets += 1;\n    else {\n      const element = target.element.parentElement?.closest(`[${AGENT_ATTR.region}]`);\n      const label = element?.getAttribute(AGENT_ATTR.label) ?? element?.getAttribute('aria-label');\n      regions.set(target.region, { label: label ? clip(label, MAX_LABEL_CHARS) : null, targets: 1 });\n    }\n  }\n\n  const view = doc.defaultView;\n  const listed = kept.map(describeTarget);\n  const result = (targets: readonly Record<string, unknown>[]): Record<string, unknown> => {\n    const omitted = matching.length - targets.length;\n    return {\n      page: {\n        title: clip(doc.title ?? '', MAX_LABEL_CHARS),\n        ...(view ? { path: `${view.location.pathname}${view.location.search}` } : {}),\n      },\n      ...(regions.size > 0\n        ? {\n            regions: Array.from(regions, ([id, entry]) => ({\n              region: id,\n              ...(entry.label ? { label: entry.label } : {}),\n              targets: entry.targets,\n            })).slice(0, MAX_REGIONS),\n            ...(regions.size > MAX_REGIONS ? { more_regions: regions.size - MAX_REGIONS } : {}),\n          }\n        : {}),\n      targets,\n      ...(overPerId.size > 0\n        ? {\n            more_sharing_an_id: Object.fromEntries(overPerId),\n          }\n        : {}),\n      ...(omitted > 0\n        ? {\n            omitted,\n            note: 'Not every target fits one read: narrow it with `region` or `query`.',\n          }\n        : {}),\n      ...(all.length === 0\n        ? { note: 'This screen has no agent targets: nothing here can be pointed at or operated.' }\n        : matching.length === 0\n          ? { note: 'No target matches. Read again without `region` and `query`.' }\n          : {}),\n    };\n  };\n\n  // Every field of a target is clipped, so targets are dropped from the end\n  // until the answer fits; with none left it still says how many there are.\n  let answer = result(listed);\n  while (listed.length > 0 && JSON.stringify(answer).length > maxChars) {\n    listed.pop();\n    answer = result(listed);\n  }\n  return answer;\n}\n"],"names":["AGENT_ATTR","isAgentTargetAction","agentTargetRef","agentTargetHandlers","isSecretField","_a","parseAgentTargetRef","exact"],"mappings":"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"}

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

@@ -0,0 +1,97 @@
+import { type AgentTargetAction, type AgentTargetHandlers } from './contract';
+/** A refusal or a miss the agent is told about, in words it can act on. */
+export declare class AgentUiError extends Error {
+    constructor(message: string);
+}
+/** One target as it is on screen now. */
+export interface AgentTargetSnapshot {
+    /** How the agent names it: `id`, or `id[key]`. */
+    ref: string;
+    id: string;
+    key: string | null;
+    element: Element;
+    /** The form control the target stands for: itself, or the one inside it. */
+    control: Element | null;
+    role: string;
+    label: string;
+    description: string | null;
+    region: string | null;
+    /** What the agent may do to it. Empty: it may only be pointed at. */
+    actions: readonly AgentTargetAction[];
+    danger: boolean;
+    sensitive: boolean;
+    disabled: boolean;
+    /** Rendered (not hidden by the page). */
+    visible: boolean;
+    /** Inside the viewport now. */
+    onScreen: boolean;
+    /** Its value, absent for a sensitive target and for one that has none. */
+    value: string | null;
+    /** For a sensitive field: whether it holds anything. */
+    filled: boolean | null;
+    checked: boolean | null;
+    selected: boolean | null;
+    expanded: boolean | null;
+    /** What a `select` may be given. */
+    options: readonly string[] | null;
+    /** How many more options there are than `options` lists. */
+    optionsOmitted: number;
+    /** A field the page shows but does not let anyone edit. */
+    readOnly: boolean;
+    handlers: AgentTargetHandlers | undefined;
+}
+/** The form control a target stands for: itself, or the first one inside it. */
+export declare function controlOf(element: Element): Element | null;
+/** Whether the page renders the element at all. */
+export declare function isRendered(element: Element): boolean;
+/** Whether any of the element is inside the viewport now. */
+export declare function isInViewport(element: Element): boolean;
+/** One target element as the agent is told about it. */
+export declare function snapshotTarget(element: Element): AgentTargetSnapshot;
+/** Every target element in the document, in document order. The overlay's own are never targets. */
+export declare function findTargetElements(doc: Document): Element[];
+/** Every rendered target, in document order. */
+export declare function snapshotTargets(doc: Document): AgentTargetSnapshot[];
+/**
+ * The target the agent named. By id (and key); a pointing tool may also name
+ * it by its label. Throws an {@link AgentUiError} that says what is on screen
+ * instead, so the agent can correct itself in one step.
+ */
+export declare function resolveTarget({ doc, ref, allowLabel, exact, }: {
+    doc: Document;
+    ref: string;
+    allowLabel?: boolean;
+    /**
+     * The reference must name one target and no other (a tool about to act):
+     * several targets sharing the id is then a question for the agent, not a
+     * choice made for it.
+     */
+    exact?: boolean;
+}): AgentTargetSnapshot;
+/** Wait for a target to be on the page (a page that is still loading), or give up. */
+export declare function waitForTarget({ doc, ref, timeoutMs, signal, allowLabel, }: {
+    doc: Document;
+    ref: string;
+    timeoutMs: number;
+    signal?: AbortSignal;
+    allowLabel?: boolean;
+}): Promise<AgentTargetSnapshot | null>;
+/** A target as the agent reads it: only what is set, in few words. */
+export declare function describeTarget(target: AgentTargetSnapshot): Record<string, unknown>;
+/** The most targets one read lists. */
+export declare const READ_SCREEN_MAX_TARGETS = 120;
+/** The most targets sharing one id (a table's rows) one read lists. */
+export declare const READ_SCREEN_MAX_PER_ID = 25;
+/** The most characters one read answers with, under the runtime's cap on a client tool's result. */
+export declare const READ_SCREEN_MAX_CHARS = 24000;
+export interface ReadScreenArgs {
+    doc: Document;
+    /** Only the targets of this region. */
+    region?: string;
+    /** Only targets whose reference, label, description or value holds this text. */
+    query?: string;
+    /** The most characters the answer may take, when the caller adds to it. Defaults to the whole cap. */
+    maxChars?: number;
+}
+/** What `read_screen` answers: the page, its regions and its targets, bounded. */
+export declare function readScreen({ doc, region, query, maxChars, }: ReadScreenArgs): Record<string, unknown>;