@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/core/computer/motor/note.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"note.js","sourceRoot":"","sources":["../../../../src/core/computer/motor/note.ts"],"names":[],"mappings":"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","sourcesContent":["import { nodeByRef, type Outline, type OutlineNode, outlineNodeLabel } from \"./outline.ts\";\n\ninterface NoteRegion {\n\tkey: string;\n\tlabel: string;\n\tstatus: \"seen\" | \"changed\" | \"never-looked\";\n\tdetail?: string;\n}\n\nexport interface WindowNote {\n\twindowRef: string;\n\ttitle: string;\n\tpairing: \"exact\" | \"high\" | \"low\";\n\tlastLookId?: string;\n\tregions: NoteRegion[];\n}\n\ninterface NoteWindowInput {\n\twindowRef?: string;\n\ttitle: string;\n\tpairing?: \"exact\" | \"high\" | \"low\";\n\tpairingScore?: number;\n}\n\ninterface NoteRefreshOutcome {\n\twindow: NoteWindowInput;\n\twindowChanged?: boolean;\n\tnewWindowLabel?: string;\n\trootDelta?: Array<{ change: string; kind: string; title?: string; ref?: string }>;\n}\n\nfunction normalizedLabel(value: string): string {\n\treturn value.toLowerCase().replace(/\\s+/g, \" \").trim();\n}\n\nfunction nodeLabel(node: OutlineNode): string {\n\treturn outlineNodeLabel(node) || node.role || node.ref;\n}\n\nfunction regionKey(node: OutlineNode): string {\n\treturn `${node.role || \"AXUnknown\"}:${node.identifier || normalizedLabel(nodeLabel(node)) || node.ref}`;\n}\n\nfunction regionLabel(node: OutlineNode): string {\n\tconst label = nodeLabel(node);\n\treturn normalizedLabel(label) || normalizedLabel(node.role) || node.ref;\n}\n\nfunction topLevelRegions(outline: Outline): Array<{ node: OutlineNode; key: string; label: string }> {\n\tconst nodes = outline.root.children.length ? outline.root.children : [outline.root];\n\treturn nodes.map((node) => ({ node, key: regionKey(node), label: regionLabel(node) }));\n}\n\nfunction topLevelAncestor(node: OutlineNode, outline: Outline): OutlineNode {\n\tlet current = node;\n\twhile (current.parent && current.parent !== outline.root) current = current.parent;\n\treturn current;\n}\n\nfunction uniqueRegions(regions: NoteRegion[]): NoteRegion[] {\n\tconst seen = new Set<string>();\n\tconst output: NoteRegion[] = [];\n\tfor (const region of regions) {\n\t\tconst dedupeKey = `${region.key}:${region.status}:${region.detail ?? \"\"}`;\n\t\tif (seen.has(dedupeKey)) continue;\n\t\tseen.add(dedupeKey);\n\t\toutput.push(region);\n\t}\n\treturn output;\n}\n\nfunction frontierRegions(\n\toutline: Outline,\n\ttopLevels: Array<{ node: OutlineNode; key: string; label: string }>,\n): NoteRegion[] {\n\tconst output: NoteRegion[] = [];\n\tfor (const node of outline.nodes) {\n\t\tif (node.scrollExtent && node.scrollExtent.seen < node.scrollExtent.total) {\n\t\t\tconst ancestor = topLevelAncestor(node, outline);\n\t\t\tconst top = topLevels.find((candidate) => candidate.node === ancestor);\n\t\t\toutput.push({\n\t\t\t\tkey: `${top?.key ?? regionKey(ancestor)}:scroll:${node.ref}`,\n\t\t\t\tlabel: top?.label ?? regionLabel(ancestor),\n\t\t\t\tstatus: \"never-looked\",\n\t\t\t\tdetail: `${node.scrollExtent.total} rows, ${node.scrollExtent.seen} seen`,\n\t\t\t});\n\t\t}\n\t\tif (node.truncated) {\n\t\t\tconst ancestor = topLevelAncestor(node, outline);\n\t\t\tconst top = topLevels.find((candidate) => candidate.node === ancestor);\n\t\t\toutput.push({\n\t\t\t\tkey: `${top?.key ?? regionKey(ancestor)}:truncated:${node.ref}`,\n\t\t\t\tlabel: top?.label ?? regionLabel(ancestor),\n\t\t\t\tstatus: \"never-looked\",\n\t\t\t\tdetail: \"subtree not walked\",\n\t\t\t});\n\t\t}\n\t}\n\treturn output;\n}\n\nexport function noteFromLook(prev: WindowNote | undefined, outline: Outline, window: NoteWindowInput): WindowNote {\n\tconst topLevels = topLevelRegions(outline);\n\tconst currentKeys = new Set(topLevels.map((region) => region.key));\n\tconst regions: NoteRegion[] = topLevels.map((region) => ({\n\t\tkey: region.key,\n\t\tlabel: region.label,\n\t\tstatus: \"seen\",\n\t}));\n\n\tif (prev) {\n\t\tfor (const old of prev.regions) {\n\t\t\tif (old.status === \"never-looked\") continue;\n\t\t\tif (!currentKeys.has(old.key)) {\n\t\t\t\tregions.push({ ...old, status: \"changed\", detail: \"not matched in latest look\" });\n\t\t\t}\n\t\t}\n\t}\n\n\tif (!window.windowRef || window.pairingScore === Number.NEGATIVE_INFINITY) {\n\t\tregions.push({\n\t\t\tkey: \"window:unpaired\",\n\t\t\tlabel: \"window capture\",\n\t\t\tstatus: \"never-looked\",\n\t\t\tdetail: \"AX window without capture pairing\",\n\t\t});\n\t}\n\n\tregions.push(...frontierRegions(outline, topLevels));\n\n\treturn {\n\t\twindowRef: window.windowRef ?? \"(unpaired)\",\n\t\ttitle: window.title,\n\t\tpairing: window.pairing ?? \"low\",\n\t\tlastLookId: outline.lookId,\n\t\tregions: uniqueRegions(regions),\n\t};\n}\n\nexport function noteAfterAct(\n\tprev: WindowNote | undefined,\n\ttargetRef: string | undefined,\n\toutline: Outline,\n\trefreshOutcome: NoteRefreshOutcome,\n): WindowNote {\n\tconst note = noteFromLook(prev, outline, refreshOutcome.window);\n\tif (targetRef) {\n\t\tconst target = nodeByRef(outline, targetRef);\n\t\tif (target) {\n\t\t\tconst ancestor = topLevelAncestor(target, outline);\n\t\t\tconst key = regionKey(ancestor);\n\t\t\tconst region = note.regions.find((candidate) => candidate.key === key);\n\t\t\tif (region) {\n\t\t\t\tregion.status = \"changed\";\n\t\t\t\tregion.detail = \"acted here\";\n\t\t\t} else {\n\t\t\t\tnote.regions.unshift({ key, label: regionLabel(ancestor), status: \"changed\", detail: \"acted here\" });\n\t\t\t}\n\t\t}\n\t}\n\tfor (const delta of refreshOutcome.rootDelta ?? []) {\n\t\tnote.regions.unshift({\n\t\t\tkey: `root:${delta.change}:${delta.ref ?? delta.kind}:${delta.title ?? \"\"}`,\n\t\t\tlabel: `${delta.kind}${delta.title ? ` ${delta.title}` : \"\"}`,\n\t\t\tstatus: delta.change === \"closed\" ? \"changed\" : \"never-looked\",\n\t\t\tdetail: `root ${delta.change}`,\n\t\t});\n\t}\n\tif (refreshOutcome.windowChanged) {\n\t\tfor (const region of note.regions) {\n\t\t\tif (region.status === \"seen\") region.status = \"changed\";\n\t\t}\n\t\tnote.regions.push({\n\t\t\tkey: `window:changed:${note.lastLookId ?? \"unknown\"}`,\n\t\t\tlabel: refreshOutcome.newWindowLabel ?? \"new sheet/window\",\n\t\t\tstatus: \"never-looked\",\n\t\t\tdetail: \"appeared after act\",\n\t\t});\n\t}\n\treturn { ...note, regions: uniqueRegions(note.regions) };\n}\n\nexport function noteRegionKeyForRef(outline: Outline, ref: string): string | undefined {\n\tconst node = nodeByRef(outline, ref);\n\treturn node ? regionKey(topLevelAncestor(node, outline)) : undefined;\n}\n\nexport function renderNote(note: WindowNote | undefined): string {\n\tif (!note) return \"\";\n\tconst looked = note.lastLookId ? \"looked just now\" : \"not looked\";\n\tconst lines = [\n\t\t`note ${note.windowRef} ${JSON.stringify(note.title.slice(0, 512))} (pairing ${note.pairing}, ${looked})`,\n\t];\n\tconst visible = note.regions.slice(0, 64);\n\tfor (const region of visible) {\n\t\tconst detail = region.detail ? `   (${region.detail.slice(0, 256)})` : \"\";\n\t\tlines.push(`  ${region.label.slice(0, 512).padEnd(14, \" \")} ${region.status}${detail}`);\n\t}\n\tif (note.regions.length > visible.length)\n\t\tlines.push(`  … ${note.regions.length - visible.length} more note regions; use search_ui or expand_ui`);\n\tconst encoded = new TextEncoder().encode(lines.join(\"\\n\"));\n\tif (encoded.byteLength <= 8 * 1024) return new TextDecoder().decode(encoded);\n\tlet end = 8 * 1024;\n\twhile (end > 0 && (encoded[end] & 0xc0) === 0x80) end -= 1;\n\treturn `${new TextDecoder().decode(encoded.subarray(0, end))}\\n… note byte budget reached`;\n}\n"]}

package/dist/core/computer/motor/outline.d.ts

@@ -0,0 +1,155 @@
+export interface OutlineRect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface OutlineText {
+    string: string;
+    confidence: number;
+    rect?: OutlineRect;
+}
+export interface OutlineScrollExtent {
+    seen: number;
+    total: number;
+}
+export interface OutlineNode {
+    ref: string;
+    wireRef?: string;
+    role: string;
+    subrole: string;
+    identifier: string;
+    title: string;
+    description: string;
+    value: string;
+    actions: string[];
+    canPress: boolean;
+    canFocus: boolean;
+    canSetValue: boolean;
+    canScroll: boolean;
+    canIncrement: boolean;
+    canDecrement: boolean;
+    isTextInput: boolean;
+    rect?: OutlineRect;
+    focused: boolean;
+    offscreen: boolean;
+    pictureOnly: boolean;
+    truncated: boolean;
+    scrollExtent?: OutlineScrollExtent;
+    text: OutlineText[];
+    children: OutlineNode[];
+    parent?: OutlineNode;
+}
+export interface Outline {
+    lookId: string;
+    root: OutlineNode;
+    nodes: OutlineNode[];
+    refToWireRef: Map<string, string>;
+    wireRefToRef: Map<string, string>;
+}
+export interface LookImage {
+    jpegBase64: string;
+    mimeType?: "image/jpeg" | "image/png";
+    width: number;
+    height: number;
+}
+export interface LookWindow {
+    windowId: number;
+    rootRef?: string;
+    kind?: string;
+    framePoints: OutlineRect;
+    scaleFactor: number;
+    isModal: boolean;
+    metadata?: Record<string, unknown>;
+    role: string;
+    subrole: string;
+}
+export interface LookResponse {
+    lookId: string;
+    capturedAt: number;
+    window: LookWindow;
+    image?: LookImage;
+    outline: OutlineNode;
+    timings: Record<string, number>;
+    readText?: {
+        requested?: "auto" | "always" | "never";
+        executed: boolean;
+    };
+    parsedOutline?: Outline;
+}
+export interface OutlineSearchMatch {
+    ref: string;
+    role: string;
+    label: string;
+    actions: string[];
+    path: string;
+    matchReason?: "exact" | "prefix" | "substring" | "fuzzy" | "filter";
+    score?: number;
+    node: OutlineNode;
+}
+export type SerializedOutlineSearchMatch = Omit<OutlineSearchMatch, "node"> & {
+    node?: never;
+};
+export interface FoldResult {
+    text: string;
+    renderedRefs: string[];
+    nodeCount: number;
+    fullUnfoldLineCount: number;
+    truncated: boolean;
+}
+export type OutlineChange = {
+    type: "added";
+    ref: string;
+    parent?: string;
+    node: SerializedOutlineNode;
+} | {
+    type: "updated";
+    ref: string;
+    path: string[];
+    fields: Partial<Omit<SerializedOutlineNode, "children">>;
+} | {
+    type: "removed";
+    ref: string;
+    parent?: string;
+};
+export interface OutlineDiff {
+    changes: OutlineChange[];
+    changedNodeCount: number;
+    fullNodeCount: number;
+    useFullView: boolean;
+    reason?: "root_replaced" | "change_budget_exceeded" | "identity_confidence_low";
+}
+export type SerializedOutlineNode = Omit<OutlineNode, "parent" | "children"> & {
+    children: SerializedOutlineNode[];
+};
+export interface SerializedOutline {
+    lookId: string;
+    root: SerializedOutlineNode;
+}
+declare const DEFAULT_BUDGET: {
+    maxDepth: number;
+    maxNodes: number;
+};
+export declare function parseLookResponse(raw: unknown): LookResponse;
+export declare function nodeByRef(outline: Outline, ref: string): OutlineNode | undefined;
+export declare function outlineNodeLabel(node: OutlineNode): string;
+export declare function outlineNodePath(node: OutlineNode): string;
+export declare function foldToBudget(outline: Outline, budget?: Partial<typeof DEFAULT_BUDGET>, unfoldPaths?: string[]): FoldResult;
+export declare function rankedTextMatch(values: string[], text: string): {
+    reason: "exact" | "prefix" | "substring" | "fuzzy";
+    score: number;
+} | undefined;
+export declare function searchOutlineRanked(outline: Outline, text?: string, role?: string, capability?: string, limit?: number): {
+    matches: OutlineSearchMatch[];
+    totalMatches: number;
+};
+export declare function searchOutline(outline: Outline, text?: string, role?: string, action?: string, limit?: number): OutlineSearchMatch[];
+export declare function serializeOutlineSearchMatch(match: OutlineSearchMatch): SerializedOutlineSearchMatch;
+export declare function countOutlineNodes(root: OutlineNode): number;
+export declare function serializeOutline(outline: Outline): SerializedOutline;
+export declare function serializeOutlineNode(node: OutlineNode): SerializedOutlineNode;
+export declare function serializeOutlineNodeShallow(node: OutlineNode): SerializedOutlineNode;
+export declare function restoreOutline(serialized: SerializedOutline): Outline;
+export declare function graftScopedOutline(outline: Outline, targetRef: string, scoped: Outline): OutlineNode;
+export {};
+//# sourceMappingURL=outline.d.ts.map

package/dist/core/computer/motor/outline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline.d.ts","sourceRoot":"","sources":["../../../../src/core/computer/motor/outline.ts"],"names":[],"mappings":"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","sourcesContent":["export interface OutlineRect {\n\tx: number;\n\ty: number;\n\tw: number;\n\th: number;\n}\n\nexport interface OutlineText {\n\tstring: string;\n\tconfidence: number;\n\trect?: OutlineRect;\n}\n\nexport interface OutlineScrollExtent {\n\tseen: number;\n\ttotal: number;\n}\n\nexport interface OutlineNode {\n\tref: string;\n\twireRef?: string;\n\trole: string;\n\tsubrole: string;\n\tidentifier: string;\n\ttitle: string;\n\tdescription: string;\n\tvalue: string;\n\tactions: string[];\n\tcanPress: boolean;\n\tcanFocus: boolean;\n\tcanSetValue: boolean;\n\tcanScroll: boolean;\n\tcanIncrement: boolean;\n\tcanDecrement: boolean;\n\tisTextInput: boolean;\n\trect?: OutlineRect;\n\tfocused: boolean;\n\toffscreen: boolean;\n\tpictureOnly: boolean;\n\ttruncated: boolean;\n\tscrollExtent?: OutlineScrollExtent;\n\ttext: OutlineText[];\n\tchildren: OutlineNode[];\n\tparent?: OutlineNode;\n}\n\nexport interface Outline {\n\tlookId: string;\n\troot: OutlineNode;\n\tnodes: OutlineNode[];\n\trefToWireRef: Map<string, string>;\n\twireRefToRef: Map<string, string>;\n}\n\nexport interface LookImage {\n\tjpegBase64: string;\n\tmimeType?: \"image/jpeg\" | \"image/png\";\n\twidth: number;\n\theight: number;\n}\n\nexport interface LookWindow {\n\twindowId: number;\n\trootRef?: string;\n\tkind?: string;\n\tframePoints: OutlineRect;\n\tscaleFactor: number;\n\tisModal: boolean;\n\tmetadata?: Record<string, unknown>;\n\trole: string;\n\tsubrole: string;\n}\n\nexport interface LookResponse {\n\tlookId: string;\n\tcapturedAt: number;\n\twindow: LookWindow;\n\timage?: LookImage;\n\toutline: OutlineNode;\n\ttimings: Record<string, number>;\n\treadText?: { requested?: \"auto\" | \"always\" | \"never\"; executed: boolean };\n\tparsedOutline?: Outline;\n}\n\nexport interface OutlineSearchMatch {\n\tref: string;\n\trole: string;\n\tlabel: string;\n\tactions: string[];\n\tpath: string;\n\tmatchReason?: \"exact\" | \"prefix\" | \"substring\" | \"fuzzy\" | \"filter\";\n\tscore?: number;\n\tnode: OutlineNode;\n}\n\nexport type SerializedOutlineSearchMatch = Omit<OutlineSearchMatch, \"node\"> & { node?: never };\n\nexport interface FoldResult {\n\ttext: string;\n\trenderedRefs: string[];\n\tnodeCount: number;\n\tfullUnfoldLineCount: number;\n\ttruncated: boolean;\n}\n\nexport type OutlineChange =\n\t| { type: \"added\"; ref: string; parent?: string; node: SerializedOutlineNode }\n\t| { type: \"updated\"; ref: string; path: string[]; fields: Partial<Omit<SerializedOutlineNode, \"children\">> }\n\t| { type: \"removed\"; ref: string; parent?: string };\n\nexport interface OutlineDiff {\n\tchanges: OutlineChange[];\n\tchangedNodeCount: number;\n\tfullNodeCount: number;\n\tuseFullView: boolean;\n\treason?: \"root_replaced\" | \"change_budget_exceeded\" | \"identity_confidence_low\";\n}\n\nexport type SerializedOutlineNode = Omit<OutlineNode, \"parent\" | \"children\"> & { children: SerializedOutlineNode[] };\n\nexport interface SerializedOutline {\n\tlookId: string;\n\troot: SerializedOutlineNode;\n}\n\nconst DEFAULT_BUDGET = { maxDepth: 2, maxNodes: 150 };\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nfunction comoTexto(value: unknown): string {\n\treturn typeof value === \"string\" ? value : \"\";\n}\n\nfunction toNumber(value: unknown, fallback = 0): number {\n\tif (typeof value === \"number\" && Number.isFinite(value)) return value;\n\tif (typeof value === \"string\") {\n\t\tconst parsed = Number(value);\n\t\tif (Number.isFinite(parsed)) return parsed;\n\t}\n\treturn fallback;\n}\n\nfunction toBoolean(value: unknown): boolean {\n\treturn value === true;\n}\n\nfunction parseRect(raw: unknown): OutlineRect {\n\tconst rect = isRecord(raw) ? raw : {};\n\treturn {\n\t\tx: toNumber(rect.x),\n\t\ty: toNumber(rect.y),\n\t\tw: Math.max(0, toNumber(rect.w)),\n\t\th: Math.max(0, toNumber(rect.h)),\n\t};\n}\n\nfunction parseText(raw: unknown): OutlineText[] {\n\tif (!Array.isArray(raw)) return [];\n\treturn raw\n\t\t.map((item): OutlineText | undefined => {\n\t\t\tif (!isRecord(item)) return undefined;\n\t\t\tconst string = comoTexto(item.string);\n\t\t\tif (!string) return undefined;\n\t\t\treturn {\n\t\t\t\tstring,\n\t\t\t\tconfidence: Math.max(0, Math.min(1, toNumber(item.confidence))),\n\t\t\t\trect: parseRect(item.rect),\n\t\t\t};\n\t\t})\n\t\t.filter((item): item is OutlineText => Boolean(item));\n}\n\nfunction parseNode(raw: unknown, parent?: OutlineNode): OutlineNode {\n\tconst record = isRecord(raw) ? raw : {};\n\tconst wireRef = comoTexto(record.ref) || undefined;\n\tconst node: OutlineNode = {\n\t\tref: \"\",\n\t\twireRef,\n\t\trole: comoTexto(record.role),\n\t\tsubrole: comoTexto(record.subrole),\n\t\tidentifier: comoTexto(record.identifier),\n\t\ttitle: comoTexto(record.title),\n\t\tdescription: comoTexto(record.description),\n\t\tvalue: comoTexto(record.value),\n\t\tactions: Array.isArray(record.actions)\n\t\t\t? record.actions.filter((value): value is string => typeof value === \"string\")\n\t\t\t: [],\n\t\tcanPress: toBoolean(record.canPress),\n\t\tcanFocus: toBoolean(record.canFocus),\n\t\tcanSetValue: toBoolean(record.canSetValue),\n\t\tcanScroll: toBoolean(record.canScroll),\n\t\tcanIncrement: toBoolean(record.canIncrement),\n\t\tcanDecrement: toBoolean(record.canDecrement),\n\t\tisTextInput: toBoolean(record.isTextInput),\n\t\trect: parseRect(record.rect),\n\t\tfocused: toBoolean(record.focused),\n\t\toffscreen: toBoolean(record.offscreen),\n\t\tpictureOnly: toBoolean(record.pictureOnly),\n\t\ttruncated: toBoolean(record.truncated),\n\t\tscrollExtent: isRecord(record.scrollExtent)\n\t\t\t? {\n\t\t\t\t\tseen: Math.max(0, Math.trunc(toNumber(record.scrollExtent.seen))),\n\t\t\t\t\ttotal: Math.max(0, Math.trunc(toNumber(record.scrollExtent.total))),\n\t\t\t\t}\n\t\t\t: undefined,\n\t\ttext: parseText(record.text),\n\t\tchildren: [],\n\t\tparent,\n\t};\n\tnode.children = (Array.isArray(record.children) ? record.children : []).map((child) => parseNode(child, node));\n\treturn node;\n}\n\nexport function parseLookResponse(raw: unknown): LookResponse {\n\tconst record = isRecord(raw) ? raw : {};\n\tconst image = isRecord(record.image) ? record.image : undefined;\n\tconst window = isRecord(record.window) ? record.window : {};\n\tconst metadata = isRecord(window.metadata) ? window.metadata : undefined;\n\tconst outline = buildOutline(comoTexto(record.lookId), parseNode(record.outline));\n\tconst readText = isRecord(record.readText) ? record.readText : undefined;\n\tconst requestedReadText =\n\t\treadText?.requested === \"auto\" || readText?.requested === \"always\" || readText?.requested === \"never\"\n\t\t\t? readText.requested\n\t\t\t: undefined;\n\tconst look: LookResponse = {\n\t\tlookId: comoTexto(record.lookId),\n\t\tcapturedAt: toNumber(record.capturedAt, Date.now() / 1000),\n\t\twindow: {\n\t\t\twindowId: Math.trunc(toNumber(window.windowId)),\n\t\t\trootRef: comoTexto(window.rootRef) || undefined,\n\t\t\tkind: comoTexto(window.kind) || undefined,\n\t\t\tframePoints: parseRect(window.framePoints),\n\t\t\tscaleFactor: Math.max(1, toNumber(window.scaleFactor, 1)),\n\t\t\tisModal: toBoolean(window.isModal),\n\t\t\tmetadata,\n\t\t\trole: comoTexto(window.role),\n\t\t\tsubrole: comoTexto(window.subrole),\n\t\t},\n\t\timage: image\n\t\t\t? {\n\t\t\t\t\tjpegBase64: comoTexto(image.jpegBase64),\n\t\t\t\t\tmimeType: image.mimeType === \"image/png\" ? \"image/png\" : \"image/jpeg\",\n\t\t\t\t\twidth: Math.max(1, Math.trunc(toNumber(image.width, 1))),\n\t\t\t\t\theight: Math.max(1, Math.trunc(toNumber(image.height, 1))),\n\t\t\t\t}\n\t\t\t: undefined,\n\t\toutline: outline.root,\n\t\ttimings: isRecord(record.timings)\n\t\t\t? Object.fromEntries(Object.entries(record.timings).map(([key, value]) => [key, toNumber(value)]))\n\t\t\t: {},\n\t\treadText: readText ? { requested: requestedReadText, executed: toBoolean(readText.executed) } : undefined,\n\t\tparsedOutline: outline,\n\t};\n\tif (!look.lookId) throw new Error(\"Helper returned a look without lookId.\");\n\treturn look;\n}\n\nfunction buildOutline(lookId: string, root: OutlineNode): Outline {\n\tconst nodes: OutlineNode[] = [];\n\tconst refToWireRef = new Map<string, string>();\n\tconst wireRefToRef = new Map<string, string>();\n\tconst queue = [root];\n\tlet index = 0;\n\twhile (index < queue.length) {\n\t\tconst node = queue[index++];\n\t\tnode.ref = `@e${nodes.length + 1}`;\n\t\tnodes.push(node);\n\t\tif (node.wireRef) {\n\t\t\trefToWireRef.set(node.ref, node.wireRef);\n\t\t\twireRefToRef.set(node.wireRef, node.ref);\n\t\t}\n\t\tqueue.push(...node.children);\n\t}\n\treturn { lookId, root, nodes, refToWireRef, wireRefToRef };\n}\n\nexport function nodeByRef(outline: Outline, ref: string): OutlineNode | undefined {\n\treturn outline.nodes.find((node) => node.ref === ref || node.wireRef === ref);\n}\n\nexport function outlineNodeLabel(node: OutlineNode): string {\n\treturn (\n\t\tnode.title ||\n\t\tnode.description ||\n\t\tnode.value ||\n\t\tnode.identifier ||\n\t\tnode.text\n\t\t\t.map((item) => item.string)\n\t\t\t.join(\" \")\n\t\t\t.trim()\n\t);\n}\n\nfunction displayName(node: OutlineNode): string {\n\tconst label = outlineNodeLabel(node);\n\treturn `${node.role || \"AXUnknown\"}${node.subrole ? `/${node.subrole}` : \"\"}${label ? ` ${JSON.stringify(label)}` : \"\"}`;\n}\n\nexport function outlineNodePath(node: OutlineNode): string {\n\tconst parts: string[] = [];\n\tlet current: OutlineNode | undefined = node;\n\twhile (current) {\n\t\tparts.unshift(displayName(current));\n\t\tcurrent = current.parent;\n\t}\n\treturn parts.join(\" ▸ \");\n}\n\nfunction countDescendants(node: OutlineNode): { total: number; roles: Map<string, number>; pictureOnly: number } {\n\tconst roles = new Map<string, number>();\n\tlet total = 0;\n\tlet pictureOnly = 0;\n\tconst visit = (current: OutlineNode) => {\n\t\tfor (const child of current.children) {\n\t\t\ttotal += 1;\n\t\t\tif (child.pictureOnly) pictureOnly += 1;\n\t\t\tconst role = child.pictureOnly ? \"picture-only\" : roleName(child.role);\n\t\t\troles.set(role, (roles.get(role) ?? 0) + 1);\n\t\t\tvisit(child);\n\t\t}\n\t};\n\tvisit(node);\n\treturn { total, roles, pictureOnly };\n}\n\nfunction roleName(role: string): string {\n\tconst stripped = role.replace(/^AX/, \"\").toLowerCase();\n\treturn stripped || \"nodes\";\n}\n\nfunction plural(count: number, singular: string): string {\n\tif (singular === \"picture-only\") return \"picture-only\";\n\treturn `${singular}${count === 1 ? \"\" : \"s\"}`;\n}\n\nfunction foldedSummary(node: OutlineNode): string {\n\tconst counts = countDescendants(node);\n\tconst roleCounts = [...counts.roles.entries()]\n\t\t.sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))\n\t\t.slice(0, 4)\n\t\t.map(([role, count]) => `${count} ${plural(count, role)}`);\n\tconst countText = `${counts.total}: ${roleCounts.join(\", \") || \"0 children\"}`;\n\tconst scroll = node.scrollExtent ? ` [scrollable ${node.scrollExtent.seen}/${node.scrollExtent.total}]` : \"\";\n\treturn ` ▸ (${countText})${scroll}`;\n}\n\nfunction annotationText(node: OutlineNode): string {\n\tconst annotations = [\n\t\tnode.offscreen ? \"offscreen\" : undefined,\n\t\tnode.pictureOnly ? \"pictureOnly\" : undefined,\n\t\tnode.truncated ? \"truncated\" : undefined,\n\t\tnode.scrollExtent ? `scrollable ${node.scrollExtent.seen}/${node.scrollExtent.total}` : undefined,\n\t].filter((item): item is string => Boolean(item));\n\treturn annotations.length ? ` [${annotations.join(\", \")}]` : \"\";\n}\n\nfunction lineForNode(node: OutlineNode, depth: number, folded: boolean): string {\n\tconst actions = node.actions.length ? ` {${node.actions.join(\",\")}}` : \"\";\n\treturn `${\"  \".repeat(depth)}${node.ref} ${displayName(node)}${actions}${annotationText(node)}${folded ? foldedSummary(node) : \"\"}`;\n}\n\nfunction pathRefs(node: OutlineNode): string[] {\n\tconst refs: string[] = [];\n\tlet current: OutlineNode | undefined = node;\n\twhile (current) {\n\t\trefs.unshift(current.ref);\n\t\tcurrent = current.parent;\n\t}\n\treturn refs;\n}\n\nfunction defaultUnfoldRefs(outline: Outline): Set<string> {\n\tconst refs = new Set<string>([outline.root.ref]);\n\tfor (const node of outline.nodes) {\n\t\tif (node.truncated || node.parent?.role === \"AXSheet\" || node.role === \"AXSheet\" || node.role === \"AXDialog\") {\n\t\t\tfor (const ref of pathRefs(node)) refs.add(ref);\n\t\t}\n\t\tif (node.focused) {\n\t\t\tfor (const ref of pathRefs(node)) refs.add(ref);\n\t\t\tfor (const child of node.children) refs.add(child.ref);\n\t\t}\n\t}\n\treturn refs;\n}\n\nexport function foldToBudget(\n\toutline: Outline,\n\tbudget: Partial<typeof DEFAULT_BUDGET> = {},\n\tunfoldPaths: string[] = [],\n): FoldResult {\n\tconst maxDepth = Math.max(0, Math.trunc(budget.maxDepth ?? DEFAULT_BUDGET.maxDepth));\n\tconst maxNodes = Math.max(1, Math.trunc(budget.maxNodes ?? DEFAULT_BUDGET.maxNodes));\n\tconst unfolded = defaultUnfoldRefs(outline);\n\tfor (const ref of unfoldPaths) {\n\t\tconst node = nodeByRef(outline, ref);\n\t\tif (!node) continue;\n\t\tfor (const pathRef of pathRefs(node)) unfolded.add(pathRef);\n\t\tfor (const child of node.children) unfolded.add(child.ref);\n\t}\n\n\tconst lines: string[] = [];\n\tconst renderedRefs: string[] = [];\n\tlet truncated = false;\n\tconst render = (node: OutlineNode, depth: number) => {\n\t\tif (lines.length >= maxNodes) {\n\t\t\ttruncated = true;\n\t\t\treturn;\n\t\t}\n\t\tconst shouldUnfold = depth < maxDepth || unfolded.has(node.ref);\n\t\tconst folded = node.children.length > 0 && !shouldUnfold;\n\t\tlines.push(lineForNode(node, depth, folded));\n\t\trenderedRefs.push(node.ref);\n\t\tif (folded) return;\n\t\tfor (const child of node.children) render(child, depth + 1);\n\t};\n\trender(outline.root, 0);\n\tif (truncated) {\n\t\tconst remaining = Math.max(0, outline.nodes.length - renderedRefs.length);\n\t\tlines.push(`… render budget reached: ${remaining} more nodes not shown; use search_ui or expand_ui(@eN)`);\n\t}\n\treturn {\n\t\ttext: lines.join(\"\\n\"),\n\t\trenderedRefs,\n\t\tnodeCount: outline.nodes.length,\n\t\tfullUnfoldLineCount: outline.nodes.length,\n\t\ttruncated,\n\t};\n}\n\nfunction actionMatches(node: OutlineNode, action: string): boolean {\n\tconst query = action.toLowerCase();\n\tif (query === \"press\" && node.canPress) return true;\n\tif (query === \"focus\" && node.canFocus) return true;\n\tif ((query === \"setvalue\" || query === \"set_text\" || query === \"settext\") && node.canSetValue) return true;\n\tif (query === \"scroll\" && node.canScroll) return true;\n\tif (query === \"increment\" && node.canIncrement) return true;\n\tif (query === \"decrement\" && node.canDecrement) return true;\n\treturn node.actions.some((candidate) => candidate.toLowerCase().includes(query));\n}\n\nfunction normalizedSearchRole(value: string): string {\n\treturn value\n\t\t.trim()\n\t\t.toLowerCase()\n\t\t.replace(/^ax/, \"\")\n\t\t.replace(/[ _-]+/g, \"\");\n}\n\nfunction damerauLevenshtein(a: string, b: string): number {\n\tconst rows = a.length + 1;\n\tconst cols = b.length + 1;\n\tconst matrix = Array.from({ length: rows }, (_, i) =>\n\t\tArray.from({ length: cols }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)),\n\t);\n\tfor (let i = 1; i < rows; i += 1) {\n\t\tfor (let j = 1; j < cols; j += 1) {\n\t\t\tconst cost = a[i - 1] === b[j - 1] ? 0 : 1;\n\t\t\tmatrix[i][j] = Math.min(matrix[i - 1][j] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j - 1] + cost);\n\t\t\tif (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1])\n\t\t\t\tmatrix[i][j] = Math.min(matrix[i][j], matrix[i - 2][j - 2] + 1);\n\t\t}\n\t}\n\treturn matrix[a.length][b.length];\n}\n\nexport function rankedTextMatch(\n\tvalues: string[],\n\ttext: string,\n): { reason: \"exact\" | \"prefix\" | \"substring\" | \"fuzzy\"; score: number } | undefined {\n\tconst query = text.toLowerCase().replace(/\\s+/g, \" \").trim().slice(0, 256);\n\tif (!query) return undefined;\n\tconst candidates = values\n\t\t.map((value) => value.toLowerCase().replace(/\\s+/g, \" \").trim().slice(0, 512))\n\t\t.filter(Boolean);\n\tif (candidates.some((value) => value === query)) return { reason: \"exact\", score: 1 };\n\tif (\n\t\tcandidates.some((value) => value.startsWith(query) || value.split(/\\W+/).some((token) => token.startsWith(query)))\n\t)\n\t\treturn { reason: \"prefix\", score: 0.95 };\n\tif (candidates.some((value) => value.includes(query))) return { reason: \"substring\", score: 0.9 };\n\tlet score = 0;\n\tfor (const value of candidates) {\n\t\tfor (const candidate of [value, ...value.split(/\\W+/)]) {\n\t\t\tif (!candidate || candidate.length > 256) continue;\n\t\t\tscore = Math.max(score, 1 - damerauLevenshtein(query, candidate) / Math.max(query.length, candidate.length));\n\t\t}\n\t}\n\treturn score >= 0.72 ? { reason: \"fuzzy\", score } : undefined;\n}\n\nexport function searchOutlineRanked(\n\toutline: Outline,\n\ttext?: string,\n\trole?: string,\n\tcapability?: string,\n\tlimit = 12,\n): { matches: OutlineSearchMatch[]; totalMatches: number } {\n\tconst query = text?.trim();\n\tconst roleQuery = role ? normalizedSearchRole(role) : undefined;\n\tconst actionQuery = capability?.trim();\n\tconst strong: Array<OutlineSearchMatch & { order: number }> = [];\n\tconst fuzzy: Array<OutlineSearchMatch & { order: number }> = [];\n\tfor (const [order, node] of outline.nodes.entries()) {\n\t\tif (roleQuery && normalizedSearchRole(node.role) !== roleQuery) continue;\n\t\tif (actionQuery && !actionMatches(node, actionQuery)) continue;\n\t\tconst label = outlineNodeLabel(node);\n\t\tconst match = query\n\t\t\t? rankedTextMatch(\n\t\t\t\t\t[\n\t\t\t\t\t\tlabel,\n\t\t\t\t\t\tnode.identifier,\n\t\t\t\t\t\tnode.title,\n\t\t\t\t\t\tnode.description,\n\t\t\t\t\t\tnode.value,\n\t\t\t\t\t\t...node.text.map((item) => item.string),\n\t\t\t\t\t],\n\t\t\t\t\tquery,\n\t\t\t\t)\n\t\t\t: undefined;\n\t\tif (query && !match) continue;\n\t\tconst result = {\n\t\t\tref: node.ref,\n\t\t\trole: node.role,\n\t\t\tlabel,\n\t\t\tactions: node.actions,\n\t\t\tpath: outlineNodePath(node),\n\t\t\tmatchReason: match?.reason ?? (\"filter\" as const),\n\t\t\tscore: match?.score ?? 1,\n\t\t\tnode,\n\t\t\torder,\n\t\t};\n\t\t(match?.reason === \"fuzzy\" ? fuzzy : strong).push(result);\n\t}\n\tconst rank = { exact: 0, prefix: 1, substring: 2, filter: 3, fuzzy: 4 } as const;\n\tconst sorted = [\n\t\t...strong.sort((a, b) => rank[a.matchReason!] - rank[b.matchReason!] || b.score! - a.score! || a.order - b.order),\n\t];\n\tconst useFuzzy = sorted.length < limit;\n\tif (useFuzzy) sorted.push(...fuzzy.sort((a, b) => b.score! - a.score! || a.order - b.order));\n\treturn {\n\t\tmatches: sorted.slice(0, limit).map(({ order: _order, ...match }) => match),\n\t\ttotalMatches: strong.length + (useFuzzy ? fuzzy.length : 0),\n\t};\n}\n\nexport function searchOutline(\n\toutline: Outline,\n\ttext?: string,\n\trole?: string,\n\taction?: string,\n\tlimit = 50,\n): OutlineSearchMatch[] {\n\tconst query = text?.trim().toLowerCase();\n\tconst roleQuery = role?.trim();\n\tconst actionQuery = action?.trim();\n\tconst matches: OutlineSearchMatch[] = [];\n\tfor (const node of outline.nodes) {\n\t\tconst label = outlineNodeLabel(node);\n\t\t// outlineNodeLabel short-circuits (title || description || value), so\n\t\t// list the fields individually too or a titled node's value/description\n\t\t// can never match.\n\t\tconst haystack = [\n\t\t\tlabel,\n\t\t\tnode.role,\n\t\t\tnode.subrole,\n\t\t\tnode.identifier,\n\t\t\tnode.title,\n\t\t\tnode.description,\n\t\t\tnode.value,\n\t\t\t...node.text.map((item) => item.string),\n\t\t]\n\t\t\t.join(\" \")\n\t\t\t.toLowerCase();\n\t\tif (query && !haystack.includes(query)) continue;\n\t\tif (roleQuery && node.role !== roleQuery) continue;\n\t\tif (actionQuery && !actionMatches(node, actionQuery)) continue;\n\t\tmatches.push({ ref: node.ref, role: node.role, label, actions: node.actions, path: outlineNodePath(node), node });\n\t\tif (matches.length >= limit) break;\n\t}\n\treturn matches;\n}\n\nexport function serializeOutlineSearchMatch(match: OutlineSearchMatch): SerializedOutlineSearchMatch {\n\tconst { node: _node, ...serialized } = match;\n\treturn serialized;\n}\n\nexport function countOutlineNodes(root: OutlineNode): number {\n\tlet count = 1;\n\tfor (const child of root.children) count += countOutlineNodes(child);\n\treturn count;\n}\n\nexport function serializeOutline(outline: Outline): SerializedOutline {\n\treturn { lookId: outline.lookId, root: serializeOutlineNode(outline.root) };\n}\n\nexport function serializeOutlineNode(node: OutlineNode): SerializedOutlineNode {\n\tconst { parent: _parent, children, ...rest } = node;\n\treturn { ...rest, children: children.map(serializeOutlineNode) };\n}\n\nexport function serializeOutlineNodeShallow(node: OutlineNode): SerializedOutlineNode {\n\tconst { parent: _parent, children: _children, ...rest } = node;\n\treturn { ...rest, children: [] };\n}\n\nexport function restoreOutline(serialized: SerializedOutline): Outline {\n\tconst nodes: OutlineNode[] = [];\n\tconst refToWireRef = new Map<string, string>();\n\tconst wireRefToRef = new Map<string, string>();\n\tconst restoreNode = (raw: SerializedOutlineNode, parent?: OutlineNode): OutlineNode => {\n\t\tconst node: OutlineNode = { ...raw, children: [], parent };\n\t\tnodes.push(node);\n\t\tif (node.wireRef) {\n\t\t\trefToWireRef.set(node.ref, node.wireRef);\n\t\t\twireRefToRef.set(node.wireRef, node.ref);\n\t\t}\n\t\tnode.children = raw.children.map((child) => restoreNode(child, node));\n\t\treturn node;\n\t};\n\tconst root = restoreNode(serialized.root);\n\treturn { lookId: serialized.lookId, root, nodes, refToWireRef, wireRefToRef };\n}\n\nfunction outlineRefNumber(ref: string): number {\n\tconst match = /^@e(\\d+)$/.exec(ref);\n\treturn match ? Number(match[1]) : 0;\n}\n\nfunction clearScopedRects(node: OutlineNode): void {\n\t// Scoped look geometry is in the scoped image's pixel space, not the full look.\n\t// Until helper-side act carries stable look geometry, grafted nodes are AX-only\n\t// for ref actions; coordinate fallback must re-observe the full window.\n\tnode.rect = undefined;\n\tfor (const text of node.text) text.rect = undefined;\n\tfor (const child of node.children) clearScopedRects(child);\n}\n\nfunction rebuildIndexes(outline: Outline): void {\n\toutline.nodes = [];\n\toutline.refToWireRef = new Map();\n\toutline.wireRefToRef = new Map();\n\tconst queue = [outline.root];\n\tlet index = 0;\n\twhile (index < queue.length) {\n\t\tconst node = queue[index++];\n\t\toutline.nodes.push(node);\n\t\tif (node.wireRef) {\n\t\t\toutline.refToWireRef.set(node.ref, node.wireRef);\n\t\t\toutline.wireRefToRef.set(node.wireRef, node.ref);\n\t\t}\n\t\tqueue.push(...node.children);\n\t}\n}\n\nfunction copyNodeFields(target: OutlineNode, source: OutlineNode, preserveWireRef = false): void {\n\tif (!preserveWireRef) target.wireRef = source.wireRef;\n\ttarget.role = source.role;\n\ttarget.subrole = source.subrole;\n\ttarget.identifier = source.identifier;\n\ttarget.title = source.title;\n\ttarget.description = source.description;\n\ttarget.value = source.value;\n\ttarget.actions = [...source.actions];\n\ttarget.canPress = source.canPress;\n\ttarget.canFocus = source.canFocus;\n\ttarget.canSetValue = source.canSetValue;\n\ttarget.canScroll = source.canScroll;\n\ttarget.canIncrement = source.canIncrement;\n\ttarget.canDecrement = source.canDecrement;\n\ttarget.isTextInput = source.isTextInput;\n\ttarget.rect = source.rect;\n\ttarget.focused = source.focused;\n\ttarget.offscreen = source.offscreen;\n\ttarget.pictureOnly = source.pictureOnly;\n\ttarget.truncated = false;\n\ttarget.scrollExtent = source.scrollExtent ? { ...source.scrollExtent } : undefined;\n\ttarget.text = source.text.map((text) => ({ ...text, rect: text.rect ? { ...text.rect } : undefined }));\n}\n\nfunction preserveUnreused(node: OutlineNode, parent: OutlineNode, used: Set<OutlineNode>): OutlineNode | undefined {\n\tif (used.has(node)) return undefined;\n\tnode.parent = parent;\n\tnode.children = node.children\n\t\t.map((child) => preserveUnreused(child, node, used))\n\t\t.filter((child): child is OutlineNode => Boolean(child));\n\treturn node;\n}\n\nfunction cloneForGraft(\n\tsource: OutlineNode,\n\tparent: OutlineNode,\n\tnextRef: () => string,\n\treusableByWireRef: Map<string, OutlineNode>,\n\tused: Set<OutlineNode>,\n): OutlineNode {\n\tconst existing = source.wireRef ? reusableByWireRef.get(source.wireRef) : undefined;\n\tif (existing) used.add(existing);\n\tconst oldChildren = existing?.children ?? [];\n\tconst node: OutlineNode = existing ?? {\n\t\t...source,\n\t\tref: nextRef(),\n\t\tchildren: [],\n\t\tparent,\n\t\ttext: [],\n\t\tactions: [],\n\t\tscrollExtent: undefined,\n\t};\n\tcopyNodeFields(node, source, Boolean(existing));\n\tnode.parent = parent;\n\tconst graftedChildren = source.children.map((child) => cloneForGraft(child, node, nextRef, reusableByWireRef, used));\n\tconst preservedChildren = oldChildren\n\t\t.map((child) => preserveUnreused(child, node, used))\n\t\t.filter((child): child is OutlineNode => Boolean(child));\n\tnode.children = [...graftedChildren, ...preservedChildren];\n\treturn node;\n}\n\nexport function graftScopedOutline(outline: Outline, targetRef: string, scoped: Outline): OutlineNode {\n\tconst target = nodeByRef(outline, targetRef);\n\tif (!target) throw new Error(`Cannot graft scoped outline: target ${targetRef} is not in the current outline.`);\n\tconst targetRect = target.rect ? { ...target.rect } : undefined;\n\tconst reusableByWireRef = new Map<string, OutlineNode>();\n\tconst collect = (node: OutlineNode) => {\n\t\tif (node.wireRef) reusableByWireRef.set(node.wireRef, node);\n\t\tfor (const child of node.children) collect(child);\n\t};\n\tcollect(target);\n\tlet nextNumber = Math.max(...outline.nodes.map((node) => outlineRefNumber(node.ref)), 0) + 1;\n\tconst nextRef = () => `@e${nextNumber++}`;\n\tconst oldChildren = target.children;\n\tconst used = new Set<OutlineNode>([target]);\n\tcopyNodeFields(target, scoped.root, true);\n\ttarget.ref = targetRef;\n\ttarget.rect = targetRect;\n\tconst graftedChildren = scoped.root.children.map((child) =>\n\t\tcloneForGraft(child, target, nextRef, reusableByWireRef, used),\n\t);\n\tconst preservedChildren = oldChildren\n\t\t.map((child) => preserveUnreused(child, target, used))\n\t\t.filter((child): child is OutlineNode => Boolean(child));\n\ttarget.children = [...graftedChildren, ...preservedChildren];\n\tfor (const child of target.children) clearScopedRects(child);\n\trebuildIndexes(outline);\n\treturn target;\n}\n"]}