@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/core/computer/motor/platform/linux/helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/core/computer/motor/platform/linux/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ChildProcessWithoutNullStreams, spawn } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { constants as fsConstants } from \"node:fs\";\nimport { access } from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), \"..\", \"..\", \"..\");\nconst SETUP_HELPER_SCRIPT = path.join(PACKAGE_ROOT, \"scripts\", \"setup-helper.mjs\");\nconst HELPER_SETUP_TIMEOUT_MS = 60_000;\nconst COMMAND_TIMEOUT_MS = 15_000;\n\nexport const LINUX_HELPER_PROTOCOL_VERSION = 4;\nexport const LINUX_HELPER_PATH =\n\tprocess.env.ADA_COMPUTER_USE_LINUX_HELPER_PATH ||\n\tpath.join(os.homedir(), \".pi\", \"agent\", \"helpers\", \"ada-computer-use\", \"linux-bridge\");\n\ninterface Pending<T> {\n\tresolve(value: T): void;\n\treject(error: Error): void;\n\ttimer: NodeJS.Timeout;\n}\n\nasync function isExecutable(filePath: string): Promise<boolean> {\n\ttry {\n\t\tawait access(filePath, fsConstants.X_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nasync function runProcess(\n\tcommand: string,\n\targs: string[],\n\ttimeoutMs: number,\n\tsignal?: AbortSignal,\n\tenv?: NodeJS.ProcessEnv,\n): Promise<void> {\n\tif (signal?.aborted) throw new Error(\"Operation aborted.\");\n\tawait new Promise<void>((resolve, reject) => {\n\t\tconst child = spawn(command, args, { stdio: [\"ignore\", \"pipe\", \"pipe\"], env });\n\t\tlet stdout = \"\";\n\t\tlet stderr = \"\";\n\t\tlet settled = false;\n\t\tconst finish = (error?: Error) => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tclearTimeout(timer);\n\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\tif (error) reject(error);\n\t\t\telse resolve();\n\t\t};\n\t\tconst timer = setTimeout(() => {\n\t\t\tchild.kill(\"SIGTERM\");\n\t\t\tfinish(new Error(`Command timed out after ${timeoutMs}ms: ${command} ${args.join(\" \")}`));\n\t\t}, timeoutMs);\n\t\tconst onAbort = () => {\n\t\t\tchild.kill(\"SIGTERM\");\n\t\t\tfinish(new Error(\"Operation aborted.\"));\n\t\t};\n\t\tchild.stdout.on(\"data\", (chunk) => {\n\t\t\tstdout += String(chunk);\n\t\t});\n\t\tchild.stderr.on(\"data\", (chunk) => {\n\t\t\tstderr += String(chunk);\n\t\t});\n\t\tchild.on(\"error\", (error) => finish(error));\n\t\tchild.on(\"close\", (code) => {\n\t\t\tif (code === 0) return finish();\n\t\t\tconst output = [stderr.trim(), stdout.trim()].filter(Boolean).join(\"\\n\");\n\t\t\tfinish(new Error(`Command failed (${code}): ${command} ${args.join(\" \")}\\n${output}`.trim()));\n\t\t});\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t});\n}\n\nasync function waitForShared<T>(promise: Promise<T>, signal?: AbortSignal): Promise<T> {\n\tif (!signal) return await promise;\n\tif (signal.aborted) throw new Error(\"Operation aborted.\");\n\treturn await new Promise<T>((resolve, reject) => {\n\t\tconst onAbort = () => reject(new Error(\"Operation aborted.\"));\n\t\tsignal.addEventListener(\"abort\", onAbort, { once: true });\n\t\tpromise.then(\n\t\t\t(value) => {\n\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\n\t\t\t\tresolve(value);\n\t\t\t},\n\t\t\t(error) => {\n\t\t\t\tsignal.removeEventListener(\"abort\", onAbort);\n\t\t\t\treject(error);\n\t\t\t},\n\t\t);\n\t});\n}\n\nexport interface LinuxHelperClientOptions {\n\thelperPath?: string;\n\tsetupHelperScript?: string;\n}\n\nexport class LinuxHelperClient {\n\tprivate installChecked = false;\n\tprivate installPromise?: Promise<void>;\n\tprivate child?: ChildProcessWithoutNullStreams;\n\tprivate processPromise?: Promise<ChildProcessWithoutNullStreams>;\n\tprivate buffer = \"\";\n\tprivate pending = new Map<string, Pending<unknown>>();\n\tprivate readonly helperPath: string;\n\tprivate readonly setupHelperScript: string;\n\n\tconstructor(options: LinuxHelperClientOptions = {}) {\n\t\tthis.helperPath = options.helperPath ?? LINUX_HELPER_PATH;\n\t\tthis.setupHelperScript = options.setupHelperScript ?? SETUP_HELPER_SCRIPT;\n\t}\n\n\tdispose(): void {\n\t\tthis.rejectPending(new Error(\"Linux helper closed because the Pi session ended.\"));\n\t\tconst child = this.child;\n\t\tthis.child = undefined;\n\t\tif (!child) return;\n\t\tchild.stdin.destroy();\n\t\tchild.stdout.destroy();\n\t\tchild.stderr.destroy();\n\t\tchild.kill(\"SIGTERM\");\n\t\tchild.unref();\n\t}\n\n\tprivate rejectPending(error: Error): void {\n\t\tfor (const pending of this.pending.values()) {\n\t\t\tclearTimeout(pending.timer);\n\t\t\tpending.reject(error);\n\t\t}\n\t\tthis.pending.clear();\n\t\tthis.buffer = \"\";\n\t}\n\n\tasync ensureInstalled(signal?: AbortSignal): Promise<void> {\n\t\tif ((await isExecutable(this.helperPath)) && this.installChecked) return;\n\t\tif (!this.installPromise) {\n\t\t\tconst installPromise = (async () => {\n\t\t\t\tawait runProcess(\n\t\t\t\t\tprocess.execPath,\n\t\t\t\t\t[this.setupHelperScript, \"--platform\", \"linux\", \"--runtime\"],\n\t\t\t\t\tHELPER_SETUP_TIMEOUT_MS,\n\t\t\t\t\tundefined,\n\t\t\t\t\t{\n\t\t\t\t\t\t...process.env,\n\t\t\t\t\t\tELECTRON_RUN_AS_NODE: \"1\",\n\t\t\t\t\t\tBUN_BE_BUN: \"1\",\n\t\t\t\t\t\tADA_COMPUTER_USE_LINUX_HELPER_PATH: this.helperPath,\n\t\t\t\t\t},\n\t\t\t\t);\n\t\t\t\tif (!(await isExecutable(this.helperPath)))\n\t\t\t\t\tthrow new Error(`Failed to install Linux helper at ${this.helperPath}.`);\n\t\t\t\tthis.installChecked = true;\n\t\t\t})();\n\t\t\tthis.installPromise = installPromise;\n\t\t\tinstallPromise.then(\n\t\t\t\t() => {\n\t\t\t\t\tif (this.installPromise === installPromise) this.installPromise = undefined;\n\t\t\t\t},\n\t\t\t\t() => {\n\t\t\t\t\tif (this.installPromise === installPromise) this.installPromise = undefined;\n\t\t\t\t},\n\t\t\t);\n\t\t}\n\t\tawait waitForShared(this.installPromise, signal);\n\t}\n\n\tprivate async process(signal?: AbortSignal): Promise<ChildProcessWithoutNullStreams> {\n\t\tawait this.ensureInstalled(signal);\n\t\tif (this.processPromise) return await waitForShared(this.processPromise, signal);\n\t\tif (this.child && this.child.exitCode === null && !this.child.killed) return this.child;\n\t\tif (!this.processPromise) {\n\t\t\tconst processPromise = this.startProcess();\n\t\t\tthis.processPromise = processPromise;\n\t\t\tprocessPromise.then(\n\t\t\t\t() => {\n\t\t\t\t\tif (this.processPromise === processPromise) this.processPromise = undefined;\n\t\t\t\t},\n\t\t\t\t() => {\n\t\t\t\t\tif (this.processPromise === processPromise) this.processPromise = undefined;\n\t\t\t\t},\n\t\t\t);\n\t\t}\n\t\treturn await waitForShared(this.processPromise, signal);\n\t}\n\n\tprivate async startProcess(): Promise<ChildProcessWithoutNullStreams> {\n\t\tconst child = spawn(this.helperPath, [], { stdio: [\"pipe\", \"pipe\", \"pipe\"] });\n\t\tchild.stdout.setEncoding(\"utf8\");\n\t\tchild.stderr.setEncoding(\"utf8\");\n\t\tchild.stdin.setDefaultEncoding(\"utf8\");\n\t\tchild.stdout.on(\"data\", (chunk: string) => this.onStdout(chunk));\n\t\tchild.on(\"exit\", (code, signalName) => {\n\t\t\tif (this.child !== child) return;\n\t\t\tthis.child = undefined;\n\t\t\tthis.rejectPending(\n\t\t\t\tnew Error(`Linux helper exited${signalName ? ` on ${signalName}` : ` with code ${code ?? \"unknown\"}`}.`),\n\t\t\t);\n\t\t});\n\t\tchild.on(\"error\", (error) => {\n\t\t\tif (this.child !== child) return;\n\t\t\tthis.child = undefined;\n\t\t\tthis.rejectPending(error);\n\t\t});\n\t\tthis.child = child;\n\t\tthis.buffer = \"\";\n\t\treturn await new Promise<ChildProcessWithoutNullStreams>((resolve, reject) => {\n\t\t\tchild.once(\"spawn\", () => resolve(child));\n\t\t\tchild.once(\"error\", reject);\n\t\t});\n\t}\n\n\tprivate onStdout(chunk: string): void {\n\t\tthis.buffer += chunk;\n\t\tfor (;;) {\n\t\t\tconst newline = this.buffer.indexOf(\"\\n\");\n\t\t\tif (newline < 0) return;\n\t\t\tconst line = this.buffer.slice(0, newline).trim();\n\t\t\tthis.buffer = this.buffer.slice(newline + 1);\n\t\t\tif (!line) continue;\n\t\t\tlet parsed: any;\n\t\t\ttry {\n\t\t\t\tparsed = JSON.parse(line);\n\t\t\t} catch {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst pending = this.pending.get(parsed.id);\n\t\t\tif (!pending) continue;\n\t\t\tthis.pending.delete(parsed.id);\n\t\t\tclearTimeout(pending.timer);\n\t\t\tif (parsed.protocolVersion !== LINUX_HELPER_PROTOCOL_VERSION) {\n\t\t\t\tpending.reject(\n\t\t\t\t\tnew Error(\n\t\t\t\t\t\t`Linux helper protocol mismatch: expected ${LINUX_HELPER_PROTOCOL_VERSION}, got ${parsed.protocolVersion ?? \"unknown\"}. Restart Pi to use the installed helper.`,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t} else if (parsed.ok === true) {\n\t\t\t\tpending.resolve(parsed.result);\n\t\t\t} else {\n\t\t\t\tconst error = new Error(parsed.error?.message ?? \"Linux helper command failed.\") as Error & {\n\t\t\t\t\tcode?: string;\n\t\t\t\t};\n\t\t\t\terror.code = parsed.error?.code;\n\t\t\t\tpending.reject(error);\n\t\t\t}\n\t\t}\n\t}\n\n\tasync command<T>(\n\t\tcmd: string,\n\t\targs: Record<string, unknown> = {},\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<T> {\n\t\tconst child = await this.process(options?.signal);\n\t\tconst id = randomUUID();\n\t\tconst timeoutMs = options?.timeoutMs ?? COMMAND_TIMEOUT_MS;\n\t\treturn await new Promise<T>((resolve, reject) => {\n\t\t\tconst onAbort = () => {\n\t\t\t\tthis.pending.delete(id);\n\t\t\t\tclearTimeout(timer);\n\t\t\t\treject(new Error(\"Operation aborted.\"));\n\t\t\t};\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\toptions?.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\tthis.pending.delete(id);\n\t\t\t\treject(new Error(`Helper command '${cmd}' timed out after ${timeoutMs}ms.`));\n\t\t\t}, timeoutMs);\n\t\t\tthis.pending.set(id, {\n\t\t\t\tresolve: (value) => {\n\t\t\t\t\toptions?.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\tresolve(value as T);\n\t\t\t\t},\n\t\t\t\treject: (error) => {\n\t\t\t\t\toptions?.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\treject(error);\n\t\t\t\t},\n\t\t\t\ttimer,\n\t\t\t});\n\t\t\toptions?.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\t\t\tchild.stdin.write(\n\t\t\t\t`${JSON.stringify({ protocolVersion: LINUX_HELPER_PROTOCOL_VERSION, id, cmd, args })}\\n`,\n\t\t\t\t(error) => {\n\t\t\t\t\tif (!error) return;\n\t\t\t\t\toptions?.signal?.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\tthis.pending.delete(id);\n\t\t\t\t\tclearTimeout(timer);\n\t\t\t\t\treject(error);\n\t\t\t\t},\n\t\t\t);\n\t\t});\n\t}\n}\n\nexport const linuxHelper = new LinuxHelperClient();\n"]}

package/dist/core/computer/motor/platform/macos/backend.d.ts

@@ -0,0 +1,3 @@
+import type { ComputerUsePlatformBackend } from "../types.ts";
+export declare const macosBackend: Pick<ComputerUsePlatformBackend, "listApps" | "listRoots" | "getFrontmost" | "focusWindow" | "observe" | "act" | "actBatch" | "readText" | "waitFor">;
+//# sourceMappingURL=backend.d.ts.map

package/dist/core/computer/motor/platform/macos/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../../../../src/core/computer/motor/platform/macos/backend.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,0BAA0B,EAgB1B,MAAM,aAAa,CAAC;AAyErB,eAAO,MAAM,YAAY,EAAE,IAAI,CAC9B,0BAA0B,EAC1B,UAAU,GAAG,WAAW,GAAG,cAAc,GAAG,aAAa,GAAG,SAAS,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CA+FnH,CAAC","sourcesContent":["import { getComputerUseConfig } from \"../../config.ts\";\nimport { type LookResponse, parseLookResponse } from \"../../outline.ts\";\nimport { toBoolean, toFiniteNumber, toOptionalString } from \"../coerce.ts\";\nimport type {\n\tComputerUsePlatformBackend,\n\tFramePoints,\n\tHelperActResult,\n\tPlatformActRequest,\n\tPlatformApp,\n\tPlatformFocusWindowResult,\n\tPlatformFrontmostResult,\n\tPlatformObserveRequest,\n\tPlatformReadTextRequest,\n\tPlatformReadTextResponse,\n\tPlatformRoot,\n\tPlatformRootKind,\n\tPlatformRootQuery,\n\tPlatformTarget,\n\tPlatformWaitForRequest,\n\tPlatformWaitForResponse,\n} from \"../types.ts\";\nimport { macosHelper } from \"./helper.ts\";\n\nfunction parseApps(result: unknown): PlatformApp[] {\n\tconst array = Array.isArray(result) ? result : (result as any)?.apps;\n\tif (!Array.isArray(array)) return [];\n\n\treturn array\n\t\t.map((raw) => {\n\t\t\tconst pid = Math.trunc(toFiniteNumber((raw as any)?.pid, NaN));\n\t\t\tif (!Number.isFinite(pid) || pid <= 0) return undefined;\n\t\t\tconst appName = toOptionalString((raw as any)?.appName) ?? \"Unknown App\";\n\t\t\treturn {\n\t\t\t\tappName,\n\t\t\t\tbundleId: toOptionalString((raw as any)?.bundleId),\n\t\t\t\tpid,\n\t\t\t\tisFrontmost: toBoolean((raw as any)?.isFrontmost),\n\t\t\t} as PlatformApp;\n\t\t})\n\t\t.filter((item): item is PlatformApp => Boolean(item));\n}\n\nfunction parseFramePoints(raw: unknown): FramePoints {\n\tconst frame = (raw as any)?.framePoints ?? {};\n\treturn {\n\t\tx: toFiniteNumber(frame.x, 0),\n\t\ty: toFiniteNumber(frame.y, 0),\n\t\tw: Math.max(1, toFiniteNumber(frame.w, 1)),\n\t\th: Math.max(1, toFiniteNumber(frame.h, 1)),\n\t};\n}\n\nfunction parseRoots(result: unknown): PlatformRoot[] {\n\tconst array = Array.isArray(result) ? result : (result as any)?.roots;\n\tif (!Array.isArray(array)) return [];\n\n\treturn array.map((raw) => {\n\t\tconst metadata =\n\t\t\ttypeof (raw as any)?.metadata === \"object\" && (raw as any).metadata !== null\n\t\t\t\t? ((raw as any).metadata as Record<string, unknown>)\n\t\t\t\t: {};\n\t\tconst kind = [\"window\", \"menu\", \"sheet\", \"popover\", \"dialog\"].includes((raw as any)?.kind)\n\t\t\t? ((raw as any).kind as PlatformRootKind)\n\t\t\t: \"window\";\n\t\treturn {\n\t\t\tkind,\n\t\t\trootRef: toOptionalString((raw as any)?.rootRef ?? (raw as any)?.windowRef),\n\t\t\twindowRef: toOptionalString((raw as any)?.windowRef ?? (raw as any)?.rootRef),\n\t\t\twindowId: Number.isFinite((raw as any)?.windowId) ? Math.trunc((raw as any).windowId) : undefined,\n\t\t\tpid: Number.isFinite((raw as any)?.pid) ? Math.trunc((raw as any).pid) : undefined,\n\t\t\tappName: toOptionalString((raw as any)?.appName),\n\t\t\tbundleId: toOptionalString((raw as any)?.bundleId),\n\t\t\ttitle: toOptionalString((raw as any)?.title) ?? \"\",\n\t\t\trole: toOptionalString((raw as any)?.role),\n\t\t\tsubrole: toOptionalString((raw as any)?.subrole),\n\t\t\tframePoints: parseFramePoints(raw),\n\t\t\tscaleFactor: Math.max(1, toFiniteNumber((raw as any)?.scaleFactor, 1)),\n\t\t\tzOrder: Math.trunc(toFiniteNumber((raw as any)?.zOrder, 0)),\n\t\t\tisMinimized: toBoolean((raw as any)?.isMinimized),\n\t\t\tisOnscreen: toBoolean((raw as any)?.isOnscreen),\n\t\t\tisMain: toBoolean((raw as any)?.isMain),\n\t\t\tisFocused: toBoolean((raw as any)?.isFocused),\n\t\t\tisModal: toBoolean((raw as any)?.isModal),\n\t\t\tmetadata,\n\t\t};\n\t});\n}\n\nfunction helperAction(request: PlatformActRequest): Record<string, unknown> {\n\tif (!(\"focus\" in request.target)) return { ...request };\n\treturn { ...request, target: request.target.focus, params: { ...request.params, preserveFocus: true } };\n}\n\nexport const macosBackend: Pick<\n\tComputerUsePlatformBackend,\n\t\"listApps\" | \"listRoots\" | \"getFrontmost\" | \"focusWindow\" | \"observe\" | \"act\" | \"actBatch\" | \"readText\" | \"waitFor\"\n> = {\n\tasync listApps(signal?: AbortSignal): Promise<PlatformApp[]> {\n\t\treturn parseApps(await macosHelper.command<unknown>(\"listApps\", {}, { signal }));\n\t},\n\n\tasync listRoots(query: PlatformRootQuery, signal?: AbortSignal): Promise<PlatformRoot[]> {\n\t\treturn parseRoots(\n\t\t\tawait macosHelper.command<unknown>(\n\t\t\t\t\"listRoots\",\n\t\t\t\t{\n\t\t\t\t\t...(Number.isFinite(query.pid) ? { pid: Math.trunc(query.pid!) } : {}),\n\t\t\t\t\t...(query.title?.trim() ? { title: query.title.trim() } : {}),\n\t\t\t\t},\n\t\t\t\t{ signal },\n\t\t\t),\n\t\t);\n\t},\n\n\tasync getFrontmost(signal?: AbortSignal): Promise<PlatformFrontmostResult> {\n\t\tconst result = await macosHelper.command<any>(\"getFrontmost\", {}, { signal });\n\t\tconst pid = Math.trunc(toFiniteNumber(result?.pid, NaN));\n\t\tif (!Number.isFinite(pid) || pid <= 0) {\n\t\t\tthrow new Error(\"No frontmost app was available for screenshot targeting.\");\n\t\t}\n\t\treturn {\n\t\t\tappName: toOptionalString(result?.appName) ?? \"Unknown App\",\n\t\t\tbundleId: toOptionalString(result?.bundleId),\n\t\t\tpid,\n\t\t\twindowTitle: toOptionalString(result?.windowTitle),\n\t\t\twindowId: Number.isFinite(result?.windowId) ? Math.trunc(result.windowId) : undefined,\n\t\t};\n\t},\n\n\tasync focusWindow(target: PlatformTarget, signal?: AbortSignal): Promise<PlatformFocusWindowResult> {\n\t\treturn await macosHelper.command<PlatformFocusWindowResult>(\"focusWindow\", { ...target }, { signal });\n\t},\n\n\tasync observe(\n\t\trequest: PlatformObserveRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<LookResponse> {\n\t\treturn parseLookResponse(\n\t\t\tawait macosHelper.command(\n\t\t\t\t\"look\",\n\t\t\t\t{\n\t\t\t\t\tbaseLookId: request.baseLookId,\n\t\t\t\t\twindowId: request.target.windowId,\n\t\t\t\t\twindowRef: request.target.rootRef,\n\t\t\t\t\tmaxDimension: request.maxDimension,\n\t\t\t\t\treadText: request.readText,\n\t\t\t\t\tscopeRef: request.scopeRef,\n\t\t\t\t\tincludeImage: request.includeImage,\n\t\t\t\t},\n\t\t\t\toptions,\n\t\t\t),\n\t\t);\n\t},\n\n\tasync act(\n\t\trequest: PlatformActRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<HelperActResult> {\n\t\treturn await macosHelper.command<HelperActResult>(\n\t\t\t\"act\",\n\t\t\t{ ...helperAction(request), cursorOverlay: getComputerUseConfig().cursor_overlay },\n\t\t\toptions,\n\t\t);\n\t},\n\n\tasync actBatch(\n\t\trequests: PlatformActRequest[],\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<HelperActResult> {\n\t\tconst cursorOverlay = getComputerUseConfig().cursor_overlay;\n\t\treturn await macosHelper.command<HelperActResult>(\n\t\t\t\"actBatch\",\n\t\t\t{ actions: requests.map((request) => ({ ...helperAction(request), cursorOverlay })) },\n\t\t\toptions,\n\t\t);\n\t},\n\n\tasync readText(\n\t\targs: PlatformReadTextRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<PlatformReadTextResponse> {\n\t\treturn await macosHelper.command(\"axReadText\", { ...args }, options);\n\t},\n\n\tasync waitFor(\n\t\targs: PlatformWaitForRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<PlatformWaitForResponse> {\n\t\treturn await macosHelper.command(\"axWaitFor\", { ...args }, options);\n\t},\n};\n"]}

package/dist/core/computer/motor/platform/macos/backend.js

@@ -0,0 +1,124 @@
+import { getComputerUseConfig } from "../../config.js";
+import { parseLookResponse } from "../../outline.js";
+import { toBoolean, toFiniteNumber, toOptionalString } from "../coerce.js";
+import { macosHelper } from "./helper.js";
+function parseApps(result) {
+    const array = Array.isArray(result) ? result : result?.apps;
+    if (!Array.isArray(array))
+        return [];
+    return array
+        .map((raw) => {
+        const pid = Math.trunc(toFiniteNumber(raw?.pid, NaN));
+        if (!Number.isFinite(pid) || pid <= 0)
+            return undefined;
+        const appName = toOptionalString(raw?.appName) ?? "Unknown App";
+        return {
+            appName,
+            bundleId: toOptionalString(raw?.bundleId),
+            pid,
+            isFrontmost: toBoolean(raw?.isFrontmost),
+        };
+    })
+        .filter((item) => Boolean(item));
+}
+function parseFramePoints(raw) {
+    const frame = raw?.framePoints ?? {};
+    return {
+        x: toFiniteNumber(frame.x, 0),
+        y: toFiniteNumber(frame.y, 0),
+        w: Math.max(1, toFiniteNumber(frame.w, 1)),
+        h: Math.max(1, toFiniteNumber(frame.h, 1)),
+    };
+}
+function parseRoots(result) {
+    const array = Array.isArray(result) ? result : result?.roots;
+    if (!Array.isArray(array))
+        return [];
+    return array.map((raw) => {
+        const metadata = typeof raw?.metadata === "object" && raw.metadata !== null
+            ? raw.metadata
+            : {};
+        const kind = ["window", "menu", "sheet", "popover", "dialog"].includes(raw?.kind)
+            ? raw.kind
+            : "window";
+        return {
+            kind,
+            rootRef: toOptionalString(raw?.rootRef ?? raw?.windowRef),
+            windowRef: toOptionalString(raw?.windowRef ?? raw?.rootRef),
+            windowId: Number.isFinite(raw?.windowId) ? Math.trunc(raw.windowId) : undefined,
+            pid: Number.isFinite(raw?.pid) ? Math.trunc(raw.pid) : undefined,
+            appName: toOptionalString(raw?.appName),
+            bundleId: toOptionalString(raw?.bundleId),
+            title: toOptionalString(raw?.title) ?? "",
+            role: toOptionalString(raw?.role),
+            subrole: toOptionalString(raw?.subrole),
+            framePoints: parseFramePoints(raw),
+            scaleFactor: Math.max(1, toFiniteNumber(raw?.scaleFactor, 1)),
+            zOrder: Math.trunc(toFiniteNumber(raw?.zOrder, 0)),
+            isMinimized: toBoolean(raw?.isMinimized),
+            isOnscreen: toBoolean(raw?.isOnscreen),
+            isMain: toBoolean(raw?.isMain),
+            isFocused: toBoolean(raw?.isFocused),
+            isModal: toBoolean(raw?.isModal),
+            metadata,
+        };
+    });
+}
+function helperAction(request) {
+    if (!("focus" in request.target))
+        return { ...request };
+    return { ...request, target: request.target.focus, params: { ...request.params, preserveFocus: true } };
+}
+export const macosBackend = {
+    async listApps(signal) {
+        return parseApps(await macosHelper.command("listApps", {}, { signal }));
+    },
+    async listRoots(query, signal) {
+        return parseRoots(await macosHelper.command("listRoots", {
+            ...(Number.isFinite(query.pid) ? { pid: Math.trunc(query.pid) } : {}),
+            ...(query.title?.trim() ? { title: query.title.trim() } : {}),
+        }, { signal }));
+    },
+    async getFrontmost(signal) {
+        const result = await macosHelper.command("getFrontmost", {}, { signal });
+        const pid = Math.trunc(toFiniteNumber(result?.pid, NaN));
+        if (!Number.isFinite(pid) || pid <= 0) {
+            throw new Error("No frontmost app was available for screenshot targeting.");
+        }
+        return {
+            appName: toOptionalString(result?.appName) ?? "Unknown App",
+            bundleId: toOptionalString(result?.bundleId),
+            pid,
+            windowTitle: toOptionalString(result?.windowTitle),
+            windowId: Number.isFinite(result?.windowId) ? Math.trunc(result.windowId) : undefined,
+        };
+    },
+    async focusWindow(target, signal) {
+        return await macosHelper.command("focusWindow", { ...target }, { signal });
+    },
+    async observe(request, options) {
+        return parseLookResponse(await macosHelper.command("look", {
+            baseLookId: request.baseLookId,
+            windowId: request.target.windowId,
+            windowRef: request.target.rootRef,
+            maxDimension: request.maxDimension,
+            readText: request.readText,
+            scopeRef: request.scopeRef,
+            includeImage: request.includeImage,
+        }, options));
+    },
+    async act(request, options) {
+        return await macosHelper.command("act", { ...helperAction(request), cursorOverlay: getComputerUseConfig().cursor_overlay }, options);
+    },
+    async actBatch(requests, options) {
+        const cursorOverlay = getComputerUseConfig().cursor_overlay;
+        return await macosHelper.command("actBatch", { actions: requests.map((request) => ({ ...helperAction(request), cursorOverlay })) }, options);
+    },
+    async readText(args, options) {
+        return await macosHelper.command("axReadText", { ...args }, options);
+    },
+    async waitFor(args, options) {
+        return await macosHelper.command("axWaitFor", { ...args }, options);
+    },
+};
+//# sourceMappingURL=backend.js.map

package/dist/core/computer/motor/platform/macos/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../../../../../src/core/computer/motor/platform/macos/backend.ts"],"names":[],"mappings":"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","sourcesContent":["import { getComputerUseConfig } from \"../../config.ts\";\nimport { type LookResponse, parseLookResponse } from \"../../outline.ts\";\nimport { toBoolean, toFiniteNumber, toOptionalString } from \"../coerce.ts\";\nimport type {\n\tComputerUsePlatformBackend,\n\tFramePoints,\n\tHelperActResult,\n\tPlatformActRequest,\n\tPlatformApp,\n\tPlatformFocusWindowResult,\n\tPlatformFrontmostResult,\n\tPlatformObserveRequest,\n\tPlatformReadTextRequest,\n\tPlatformReadTextResponse,\n\tPlatformRoot,\n\tPlatformRootKind,\n\tPlatformRootQuery,\n\tPlatformTarget,\n\tPlatformWaitForRequest,\n\tPlatformWaitForResponse,\n} from \"../types.ts\";\nimport { macosHelper } from \"./helper.ts\";\n\nfunction parseApps(result: unknown): PlatformApp[] {\n\tconst array = Array.isArray(result) ? result : (result as any)?.apps;\n\tif (!Array.isArray(array)) return [];\n\n\treturn array\n\t\t.map((raw) => {\n\t\t\tconst pid = Math.trunc(toFiniteNumber((raw as any)?.pid, NaN));\n\t\t\tif (!Number.isFinite(pid) || pid <= 0) return undefined;\n\t\t\tconst appName = toOptionalString((raw as any)?.appName) ?? \"Unknown App\";\n\t\t\treturn {\n\t\t\t\tappName,\n\t\t\t\tbundleId: toOptionalString((raw as any)?.bundleId),\n\t\t\t\tpid,\n\t\t\t\tisFrontmost: toBoolean((raw as any)?.isFrontmost),\n\t\t\t} as PlatformApp;\n\t\t})\n\t\t.filter((item): item is PlatformApp => Boolean(item));\n}\n\nfunction parseFramePoints(raw: unknown): FramePoints {\n\tconst frame = (raw as any)?.framePoints ?? {};\n\treturn {\n\t\tx: toFiniteNumber(frame.x, 0),\n\t\ty: toFiniteNumber(frame.y, 0),\n\t\tw: Math.max(1, toFiniteNumber(frame.w, 1)),\n\t\th: Math.max(1, toFiniteNumber(frame.h, 1)),\n\t};\n}\n\nfunction parseRoots(result: unknown): PlatformRoot[] {\n\tconst array = Array.isArray(result) ? result : (result as any)?.roots;\n\tif (!Array.isArray(array)) return [];\n\n\treturn array.map((raw) => {\n\t\tconst metadata =\n\t\t\ttypeof (raw as any)?.metadata === \"object\" && (raw as any).metadata !== null\n\t\t\t\t? ((raw as any).metadata as Record<string, unknown>)\n\t\t\t\t: {};\n\t\tconst kind = [\"window\", \"menu\", \"sheet\", \"popover\", \"dialog\"].includes((raw as any)?.kind)\n\t\t\t? ((raw as any).kind as PlatformRootKind)\n\t\t\t: \"window\";\n\t\treturn {\n\t\t\tkind,\n\t\t\trootRef: toOptionalString((raw as any)?.rootRef ?? (raw as any)?.windowRef),\n\t\t\twindowRef: toOptionalString((raw as any)?.windowRef ?? (raw as any)?.rootRef),\n\t\t\twindowId: Number.isFinite((raw as any)?.windowId) ? Math.trunc((raw as any).windowId) : undefined,\n\t\t\tpid: Number.isFinite((raw as any)?.pid) ? Math.trunc((raw as any).pid) : undefined,\n\t\t\tappName: toOptionalString((raw as any)?.appName),\n\t\t\tbundleId: toOptionalString((raw as any)?.bundleId),\n\t\t\ttitle: toOptionalString((raw as any)?.title) ?? \"\",\n\t\t\trole: toOptionalString((raw as any)?.role),\n\t\t\tsubrole: toOptionalString((raw as any)?.subrole),\n\t\t\tframePoints: parseFramePoints(raw),\n\t\t\tscaleFactor: Math.max(1, toFiniteNumber((raw as any)?.scaleFactor, 1)),\n\t\t\tzOrder: Math.trunc(toFiniteNumber((raw as any)?.zOrder, 0)),\n\t\t\tisMinimized: toBoolean((raw as any)?.isMinimized),\n\t\t\tisOnscreen: toBoolean((raw as any)?.isOnscreen),\n\t\t\tisMain: toBoolean((raw as any)?.isMain),\n\t\t\tisFocused: toBoolean((raw as any)?.isFocused),\n\t\t\tisModal: toBoolean((raw as any)?.isModal),\n\t\t\tmetadata,\n\t\t};\n\t});\n}\n\nfunction helperAction(request: PlatformActRequest): Record<string, unknown> {\n\tif (!(\"focus\" in request.target)) return { ...request };\n\treturn { ...request, target: request.target.focus, params: { ...request.params, preserveFocus: true } };\n}\n\nexport const macosBackend: Pick<\n\tComputerUsePlatformBackend,\n\t\"listApps\" | \"listRoots\" | \"getFrontmost\" | \"focusWindow\" | \"observe\" | \"act\" | \"actBatch\" | \"readText\" | \"waitFor\"\n> = {\n\tasync listApps(signal?: AbortSignal): Promise<PlatformApp[]> {\n\t\treturn parseApps(await macosHelper.command<unknown>(\"listApps\", {}, { signal }));\n\t},\n\n\tasync listRoots(query: PlatformRootQuery, signal?: AbortSignal): Promise<PlatformRoot[]> {\n\t\treturn parseRoots(\n\t\t\tawait macosHelper.command<unknown>(\n\t\t\t\t\"listRoots\",\n\t\t\t\t{\n\t\t\t\t\t...(Number.isFinite(query.pid) ? { pid: Math.trunc(query.pid!) } : {}),\n\t\t\t\t\t...(query.title?.trim() ? { title: query.title.trim() } : {}),\n\t\t\t\t},\n\t\t\t\t{ signal },\n\t\t\t),\n\t\t);\n\t},\n\n\tasync getFrontmost(signal?: AbortSignal): Promise<PlatformFrontmostResult> {\n\t\tconst result = await macosHelper.command<any>(\"getFrontmost\", {}, { signal });\n\t\tconst pid = Math.trunc(toFiniteNumber(result?.pid, NaN));\n\t\tif (!Number.isFinite(pid) || pid <= 0) {\n\t\t\tthrow new Error(\"No frontmost app was available for screenshot targeting.\");\n\t\t}\n\t\treturn {\n\t\t\tappName: toOptionalString(result?.appName) ?? \"Unknown App\",\n\t\t\tbundleId: toOptionalString(result?.bundleId),\n\t\t\tpid,\n\t\t\twindowTitle: toOptionalString(result?.windowTitle),\n\t\t\twindowId: Number.isFinite(result?.windowId) ? Math.trunc(result.windowId) : undefined,\n\t\t};\n\t},\n\n\tasync focusWindow(target: PlatformTarget, signal?: AbortSignal): Promise<PlatformFocusWindowResult> {\n\t\treturn await macosHelper.command<PlatformFocusWindowResult>(\"focusWindow\", { ...target }, { signal });\n\t},\n\n\tasync observe(\n\t\trequest: PlatformObserveRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<LookResponse> {\n\t\treturn parseLookResponse(\n\t\t\tawait macosHelper.command(\n\t\t\t\t\"look\",\n\t\t\t\t{\n\t\t\t\t\tbaseLookId: request.baseLookId,\n\t\t\t\t\twindowId: request.target.windowId,\n\t\t\t\t\twindowRef: request.target.rootRef,\n\t\t\t\t\tmaxDimension: request.maxDimension,\n\t\t\t\t\treadText: request.readText,\n\t\t\t\t\tscopeRef: request.scopeRef,\n\t\t\t\t\tincludeImage: request.includeImage,\n\t\t\t\t},\n\t\t\t\toptions,\n\t\t\t),\n\t\t);\n\t},\n\n\tasync act(\n\t\trequest: PlatformActRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<HelperActResult> {\n\t\treturn await macosHelper.command<HelperActResult>(\n\t\t\t\"act\",\n\t\t\t{ ...helperAction(request), cursorOverlay: getComputerUseConfig().cursor_overlay },\n\t\t\toptions,\n\t\t);\n\t},\n\n\tasync actBatch(\n\t\trequests: PlatformActRequest[],\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<HelperActResult> {\n\t\tconst cursorOverlay = getComputerUseConfig().cursor_overlay;\n\t\treturn await macosHelper.command<HelperActResult>(\n\t\t\t\"actBatch\",\n\t\t\t{ actions: requests.map((request) => ({ ...helperAction(request), cursorOverlay })) },\n\t\t\toptions,\n\t\t);\n\t},\n\n\tasync readText(\n\t\targs: PlatformReadTextRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<PlatformReadTextResponse> {\n\t\treturn await macosHelper.command(\"axReadText\", { ...args }, options);\n\t},\n\n\tasync waitFor(\n\t\targs: PlatformWaitForRequest,\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<PlatformWaitForResponse> {\n\t\treturn await macosHelper.command(\"axWaitFor\", { ...args }, options);\n\t},\n};\n"]}

package/dist/core/computer/motor/platform/macos/browser.d.ts

@@ -0,0 +1,7 @@
+export declare function isBrowserApp(appName: string, bundleId?: string): boolean;
+export declare function isChromeFamilyApp(appName: string, bundleId?: string): boolean;
+export declare function openBrowserLocationWithAppleScript(target: {
+    appName: string;
+    bundleId?: string;
+}, url: string, signal?: AbortSignal): Promise<boolean>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/core/computer/motor/platform/macos/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../../../../src/core/computer/motor/platform/macos/browser.ts"],"names":[],"mappings":"AA6EA,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAExE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAE7E;AAoBD,wBAAsB,kCAAkC,CACvD,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9C,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,OAAO,CAAC,CAUlB","sourcesContent":["import { runProcess } from \"./helper.ts\";\n\nconst BROWSER_WINDOW_OPEN_TIMEOUT_MS = 10_000;\n\nconst BROWSER_BUNDLE_IDS = new Set([\n\t\"com.apple.Safari\",\n\t\"com.google.Chrome\",\n\t\"org.chromium.Chromium\",\n\t\"company.thebrowser.Browser\",\n\t\"com.brave.Browser\",\n\t\"com.microsoft.edgemac\",\n\t\"com.vivaldi.Vivaldi\",\n\t\"net.imput.helium\",\n\t\"org.mozilla.firefox\",\n]);\nconst BROWSER_APP_NAMES = new Set([\n\t\"safari\",\n\t\"google chrome\",\n\t\"chrome\",\n\t\"chromium\",\n\t\"arc\",\n\t\"brave browser\",\n\t\"brave\",\n\t\"microsoft edge\",\n\t\"edge\",\n\t\"vivaldi\",\n\t\"helium\",\n\t\"firefox\",\n]);\nconst CHROME_FAMILY_BUNDLE_IDS = new Set([\n\t\"com.google.Chrome\",\n\t\"org.chromium.Chromium\",\n\t\"company.thebrowser.Browser\",\n\t\"com.brave.Browser\",\n\t\"com.microsoft.edgemac\",\n\t\"com.vivaldi.Vivaldi\",\n\t\"net.imput.helium\",\n]);\nconst CHROME_FAMILY_APP_NAMES = new Set([\n\t\"google chrome\",\n\t\"chrome\",\n\t\"chromium\",\n\t\"arc\",\n\t\"brave browser\",\n\t\"brave\",\n\t\"microsoft edge\",\n\t\"edge\",\n\t\"vivaldi\",\n\t\"helium\",\n]);\n\nfunction normalizeText(value: string): string {\n\treturn value.trim().toLowerCase();\n}\n\nfunction escapeAppleScriptString(value: string): string {\n\treturn value.replaceAll(\"\\\\\", \"\\\\\\\\\").replaceAll('\"', '\\\\\"');\n}\n\nfunction appendBrowserJavaScriptAppleEventsHint(error: Error): Error {\n\tconst hint = [\n\t\t\"Browser JavaScript Apple Events are disabled for the target browser.\",\n\t\t'Ask the user to enable \"Allow JavaScript from Apple Events\" in the browser\\'s developer menu, then retry the browser action.',\n\t].join(\" \");\n\tif (\n\t\t!/not allowed to send javascript commands|executing javascript through applescript is turned off|allow javascript from apple events|enable javascript from apple events/i.test(\n\t\t\terror.message,\n\t\t) ||\n\t\terror.message.includes(hint)\n\t) {\n\t\treturn error;\n\t}\n\tconst enhanced = new Error(`${error.message}\\n\\n${hint}`);\n\tenhanced.name = error.name;\n\treturn enhanced;\n}\n\nexport function isBrowserApp(appName: string, bundleId?: string): boolean {\n\treturn BROWSER_BUNDLE_IDS.has(bundleId ?? \"\") || BROWSER_APP_NAMES.has(normalizeText(appName));\n}\n\nexport function isChromeFamilyApp(appName: string, bundleId?: string): boolean {\n\treturn CHROME_FAMILY_BUNDLE_IDS.has(bundleId ?? \"\") || CHROME_FAMILY_APP_NAMES.has(normalizeText(appName));\n}\n\nfunction scriptForBrowserOpenLocation(\n\ttarget: { appName: string; bundleId?: string },\n\turl: string,\n): string[] | undefined {\n\tconst appTarget = target.bundleId\n\t\t? `application id \"${escapeAppleScriptString(target.bundleId)}\"`\n\t\t: `application \"${escapeAppleScriptString(target.appName)}\"`;\n\tconst escapedUrl = escapeAppleScriptString(url);\n\tconst normalizedName = normalizeText(target.appName);\n\tif (target.bundleId === \"com.apple.Safari\" || normalizedName === \"safari\") {\n\t\treturn [`tell ${appTarget} to set URL of front document to \"${escapedUrl}\"`];\n\t}\n\tif (isChromeFamilyApp(target.appName, target.bundleId)) {\n\t\treturn [`tell ${appTarget} to set URL of active tab of front window to \"${escapedUrl}\"`];\n\t}\n\treturn undefined;\n}\n\nexport async function openBrowserLocationWithAppleScript(\n\ttarget: { appName: string; bundleId?: string },\n\turl: string,\n\tsignal?: AbortSignal,\n): Promise<boolean> {\n\tconst script = scriptForBrowserOpenLocation(target, url);\n\tif (!script) return false;\n\tconst args = script.flatMap((line) => [\"-e\", line]);\n\ttry {\n\t\tawait runProcess(\"osascript\", args, BROWSER_WINDOW_OPEN_TIMEOUT_MS, signal);\n\t\treturn true;\n\t} catch (error) {\n\t\tthrow appendBrowserJavaScriptAppleEventsHint(error instanceof Error ? error : new Error(String(error)));\n\t}\n}\n"]}

package/dist/core/computer/motor/platform/macos/browser.js

@@ -0,0 +1,101 @@
+import { runProcess } from "./helper.js";
+const BROWSER_WINDOW_OPEN_TIMEOUT_MS = 10_000;
+const BROWSER_BUNDLE_IDS = new Set([
+    "com.apple.Safari",
+    "com.google.Chrome",
+    "org.chromium.Chromium",
+    "company.thebrowser.Browser",
+    "com.brave.Browser",
+    "com.microsoft.edgemac",
+    "com.vivaldi.Vivaldi",
+    "net.imput.helium",
+    "org.mozilla.firefox",
+]);
+const BROWSER_APP_NAMES = new Set([
+    "safari",
+    "google chrome",
+    "chrome",
+    "chromium",
+    "arc",
+    "brave browser",
+    "brave",
+    "microsoft edge",
+    "edge",
+    "vivaldi",
+    "helium",
+    "firefox",
+]);
+const CHROME_FAMILY_BUNDLE_IDS = new Set([
+    "com.google.Chrome",
+    "org.chromium.Chromium",
+    "company.thebrowser.Browser",
+    "com.brave.Browser",
+    "com.microsoft.edgemac",
+    "com.vivaldi.Vivaldi",
+    "net.imput.helium",
+]);
+const CHROME_FAMILY_APP_NAMES = new Set([
+    "google chrome",
+    "chrome",
+    "chromium",
+    "arc",
+    "brave browser",
+    "brave",
+    "microsoft edge",
+    "edge",
+    "vivaldi",
+    "helium",
+]);
+function normalizeText(value) {
+    return value.trim().toLowerCase();
+}
+function escapeAppleScriptString(value) {
+    return value.replaceAll("\\", "\\\\").replaceAll('"', '\\"');
+}
+function appendBrowserJavaScriptAppleEventsHint(error) {
+    const hint = [
+        "Browser JavaScript Apple Events are disabled for the target browser.",
+        'Ask the user to enable "Allow JavaScript from Apple Events" in the browser\'s developer menu, then retry the browser action.',
+    ].join(" ");
+    if (!/not allowed to send javascript commands|executing javascript through applescript is turned off|allow javascript from apple events|enable javascript from apple events/i.test(error.message) ||
+        error.message.includes(hint)) {
+        return error;
+    }
+    const enhanced = new Error(`${error.message}\n\n${hint}`);
+    enhanced.name = error.name;
+    return enhanced;
+}
+export function isBrowserApp(appName, bundleId) {
+    return BROWSER_BUNDLE_IDS.has(bundleId ?? "") || BROWSER_APP_NAMES.has(normalizeText(appName));
+}
+export function isChromeFamilyApp(appName, bundleId) {
+    return CHROME_FAMILY_BUNDLE_IDS.has(bundleId ?? "") || CHROME_FAMILY_APP_NAMES.has(normalizeText(appName));
+}
+function scriptForBrowserOpenLocation(target, url) {
+    const appTarget = target.bundleId
+        ? `application id "${escapeAppleScriptString(target.bundleId)}"`
+        : `application "${escapeAppleScriptString(target.appName)}"`;
+    const escapedUrl = escapeAppleScriptString(url);
+    const normalizedName = normalizeText(target.appName);
+    if (target.bundleId === "com.apple.Safari" || normalizedName === "safari") {
+        return [`tell ${appTarget} to set URL of front document to "${escapedUrl}"`];
+    }
+    if (isChromeFamilyApp(target.appName, target.bundleId)) {
+        return [`tell ${appTarget} to set URL of active tab of front window to "${escapedUrl}"`];
+    }
+    return undefined;
+}
+export async function openBrowserLocationWithAppleScript(target, url, signal) {
+    const script = scriptForBrowserOpenLocation(target, url);
+    if (!script)
+        return false;
+    const args = script.flatMap((line) => ["-e", line]);
+    try {
+        await runProcess("osascript", args, BROWSER_WINDOW_OPEN_TIMEOUT_MS, signal);
+        return true;
+    }
+    catch (error) {
+        throw appendBrowserJavaScriptAppleEventsHint(error instanceof Error ? error : new Error(String(error)));
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/core/computer/motor/platform/macos/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../../../../src/core/computer/motor/platform/macos/browser.ts"],"names":[],"mappings":"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","sourcesContent":["import { runProcess } from \"./helper.ts\";\n\nconst BROWSER_WINDOW_OPEN_TIMEOUT_MS = 10_000;\n\nconst BROWSER_BUNDLE_IDS = new Set([\n\t\"com.apple.Safari\",\n\t\"com.google.Chrome\",\n\t\"org.chromium.Chromium\",\n\t\"company.thebrowser.Browser\",\n\t\"com.brave.Browser\",\n\t\"com.microsoft.edgemac\",\n\t\"com.vivaldi.Vivaldi\",\n\t\"net.imput.helium\",\n\t\"org.mozilla.firefox\",\n]);\nconst BROWSER_APP_NAMES = new Set([\n\t\"safari\",\n\t\"google chrome\",\n\t\"chrome\",\n\t\"chromium\",\n\t\"arc\",\n\t\"brave browser\",\n\t\"brave\",\n\t\"microsoft edge\",\n\t\"edge\",\n\t\"vivaldi\",\n\t\"helium\",\n\t\"firefox\",\n]);\nconst CHROME_FAMILY_BUNDLE_IDS = new Set([\n\t\"com.google.Chrome\",\n\t\"org.chromium.Chromium\",\n\t\"company.thebrowser.Browser\",\n\t\"com.brave.Browser\",\n\t\"com.microsoft.edgemac\",\n\t\"com.vivaldi.Vivaldi\",\n\t\"net.imput.helium\",\n]);\nconst CHROME_FAMILY_APP_NAMES = new Set([\n\t\"google chrome\",\n\t\"chrome\",\n\t\"chromium\",\n\t\"arc\",\n\t\"brave browser\",\n\t\"brave\",\n\t\"microsoft edge\",\n\t\"edge\",\n\t\"vivaldi\",\n\t\"helium\",\n]);\n\nfunction normalizeText(value: string): string {\n\treturn value.trim().toLowerCase();\n}\n\nfunction escapeAppleScriptString(value: string): string {\n\treturn value.replaceAll(\"\\\\\", \"\\\\\\\\\").replaceAll('\"', '\\\\\"');\n}\n\nfunction appendBrowserJavaScriptAppleEventsHint(error: Error): Error {\n\tconst hint = [\n\t\t\"Browser JavaScript Apple Events are disabled for the target browser.\",\n\t\t'Ask the user to enable \"Allow JavaScript from Apple Events\" in the browser\\'s developer menu, then retry the browser action.',\n\t].join(\" \");\n\tif (\n\t\t!/not allowed to send javascript commands|executing javascript through applescript is turned off|allow javascript from apple events|enable javascript from apple events/i.test(\n\t\t\terror.message,\n\t\t) ||\n\t\terror.message.includes(hint)\n\t) {\n\t\treturn error;\n\t}\n\tconst enhanced = new Error(`${error.message}\\n\\n${hint}`);\n\tenhanced.name = error.name;\n\treturn enhanced;\n}\n\nexport function isBrowserApp(appName: string, bundleId?: string): boolean {\n\treturn BROWSER_BUNDLE_IDS.has(bundleId ?? \"\") || BROWSER_APP_NAMES.has(normalizeText(appName));\n}\n\nexport function isChromeFamilyApp(appName: string, bundleId?: string): boolean {\n\treturn CHROME_FAMILY_BUNDLE_IDS.has(bundleId ?? \"\") || CHROME_FAMILY_APP_NAMES.has(normalizeText(appName));\n}\n\nfunction scriptForBrowserOpenLocation(\n\ttarget: { appName: string; bundleId?: string },\n\turl: string,\n): string[] | undefined {\n\tconst appTarget = target.bundleId\n\t\t? `application id \"${escapeAppleScriptString(target.bundleId)}\"`\n\t\t: `application \"${escapeAppleScriptString(target.appName)}\"`;\n\tconst escapedUrl = escapeAppleScriptString(url);\n\tconst normalizedName = normalizeText(target.appName);\n\tif (target.bundleId === \"com.apple.Safari\" || normalizedName === \"safari\") {\n\t\treturn [`tell ${appTarget} to set URL of front document to \"${escapedUrl}\"`];\n\t}\n\tif (isChromeFamilyApp(target.appName, target.bundleId)) {\n\t\treturn [`tell ${appTarget} to set URL of active tab of front window to \"${escapedUrl}\"`];\n\t}\n\treturn undefined;\n}\n\nexport async function openBrowserLocationWithAppleScript(\n\ttarget: { appName: string; bundleId?: string },\n\turl: string,\n\tsignal?: AbortSignal,\n): Promise<boolean> {\n\tconst script = scriptForBrowserOpenLocation(target, url);\n\tif (!script) return false;\n\tconst args = script.flatMap((line) => [\"-e\", line]);\n\ttry {\n\t\tawait runProcess(\"osascript\", args, BROWSER_WINDOW_OPEN_TIMEOUT_MS, signal);\n\t\treturn true;\n\t} catch (error) {\n\t\tthrow appendBrowserJavaScriptAppleEventsHint(error instanceof Error ? error : new Error(String(error)));\n\t}\n}\n"]}

package/dist/core/computer/motor/platform/macos/helper-path.mjs

@@ -0,0 +1,34 @@
+import { accessSync, constants as fsConstants, existsSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+const HELPER_APP_NAME = "ada-computer-use.app";
+const SYSTEM_HELPER_APP_PATH = path.join("/Applications", HELPER_APP_NAME);
+
+/**
+ * Resolve one stable helper location for both installation and runtime use.
+ * Existing writable system installs stay in place; all other installs are
+ * per-user so standard macOS accounts never require administrator access.
+ */
+export function resolveMacosHelperAppPath(options = {}) {
+	const env = options.env ?? process.env;
+	const explicitPath = env.ADA_COMPUTER_USE_HELPER_APP_PATH?.trim();
+	if (explicitPath) return path.resolve(explicitPath);
+
+	const homeDir = options.homeDir ?? os.homedir();
+	const systemHelperAppPath = options.systemHelperAppPath ?? SYSTEM_HELPER_APP_PATH;
+	const fileExists = options.fileExists ?? existsSync;
+	const directoryIsWritable = options.directoryIsWritable ?? ((directoryPath) => {
+		try {
+			accessSync(directoryPath, fsConstants.W_OK);
+			return true;
+		} catch {
+			return false;
+		}
+	});
+
+	if (fileExists(systemHelperAppPath) && directoryIsWritable(path.dirname(systemHelperAppPath))) {
+		return systemHelperAppPath;
+	}
+	return path.join(homeDir, "Applications", HELPER_APP_NAME);
+}

package/dist/core/computer/motor/platform/macos/helper.d.ts

@@ -0,0 +1,32 @@
+import type { PlatformDiagnostics } from "../types.ts";
+export declare const HELPER_BUNDLE_ID = "com.hoilab.ada-computer-use";
+export declare const HELPER_APP_PATH: string;
+export declare const HELPER_APP_EXECUTABLE_PATH: string;
+export declare const HELPER_SOCKET_PATH: string;
+export declare class HelperTransportError extends Error {
+    constructor(message: string);
+}
+export declare class HelperCommandError extends Error {
+    readonly code?: string;
+    constructor(message: string, code?: string);
+}
+export declare function runProcess(command: string, args: string[], timeoutMs: number, signal?: AbortSignal, env?: NodeJS.ProcessEnv): Promise<void>;
+export declare class MacosHelperClient {
+    private daemonAvailable;
+    private requestSequence;
+    private diagnosticsCache?;
+    get diagnostics(): PlatformDiagnostics | undefined;
+    ensureInstalled(signal?: AbortSignal): Promise<void>;
+    launchDaemon(signal?: AbortSignal): Promise<void>;
+    daemonCommand<T>(cmd: string, args: Record<string, unknown>, timeoutMs: number, signal?: AbortSignal): Promise<T>;
+    ensureDaemon(signal?: AbortSignal): Promise<boolean>;
+    command<T>(cmd: string, args?: Record<string, unknown>, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<T>;
+    restart(signal?: AbortSignal): Promise<void>;
+    diagnosticsCommand(signal?: AbortSignal): Promise<PlatformDiagnostics>;
+    ensureProtocol(signal?: AbortSignal): Promise<PlatformDiagnostics>;
+}
+export declare const macosHelper: MacosHelperClient;
+//# sourceMappingURL=helper.d.ts.map

package/dist/core/computer/motor/platform/macos/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../../src/core/computer/motor/platform/macos/helper.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAOvD,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAC9D,eAAO,MAAM,eAAe,QAA8B,CAAC;AAC3D,eAAO,MAAM,0BAA0B,QAA4D,CAAC;AAEpG,eAAO,MAAM,kBAAkB,QAA8D,CAAC;AAM9F,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAIzC;CACD;AAoCD,wBAAsB,UAAU,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,EACpB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,IAAI,CAAC,CAsDf;AAED,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,gBAAgB,CAAC,CAAsB;IAE/C,IAAI,WAAW,IAAI,mBAAmB,GAAG,SAAS,CAEjD;IAEK,eAAe,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBzD;IAEK,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAYtD;IAEK,aAAa,CAAC,CAAC,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,CAAC,CAAC,CA8CZ;IAEK,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBzD;IAEK,OAAO,CAAC,CAAC,EACd,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACpD,OAAO,CAAC,CAAC,CAAC,CAWZ;IAEK,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAOjD;IAEK,kBAAkB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqB3E;IAEK,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAmBvE;CACD;AAED,eAAO,MAAM,WAAW,mBAA0B,CAAC","sourcesContent":["import { spawn } from \"node:child_process\";\nimport { constants as fsConstants } from \"node:fs\";\nimport { access, mkdir, realpath } from \"node:fs/promises\";\nimport net from \"node:net\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { toBoolean, toFiniteNumber, toOptionalString } from \"../coerce.ts\";\nimport type { PlatformDiagnostics } from \"../types.ts\";\nimport { resolveMacosHelperAppPath } from \"./helper-path.mjs\";\n\nconst COMMAND_TIMEOUT_MS = 15_000;\nconst HELPER_PROTOCOL_VERSION = 6;\nconst HELPER_SETUP_TIMEOUT_MS = 60_000;\n\nexport const HELPER_BUNDLE_ID = \"com.hoilab.ada-computer-use\";\nexport const HELPER_APP_PATH = resolveMacosHelperAppPath();\nexport const HELPER_APP_EXECUTABLE_PATH = path.join(HELPER_APP_PATH, \"Contents\", \"MacOS\", \"bridge\");\nconst DEFAULT_HELPER_SOCKET_PATH = path.join(os.homedir(), \"Library\", \"Caches\", \"ada-computer-use\", \"bridge.sock\");\nexport const HELPER_SOCKET_PATH = process.env.PI_CU_SOCKET_PATH ?? DEFAULT_HELPER_SOCKET_PATH;\nconst usingExternalHelperSocket = HELPER_SOCKET_PATH !== DEFAULT_HELPER_SOCKET_PATH;\n\nconst PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), \"..\", \"..\", \"..\");\nconst SETUP_HELPER_SCRIPT = path.join(PACKAGE_ROOT, \"scripts\", \"setup-helper.mjs\");\n\nexport class HelperTransportError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"HelperTransportError\";\n\t}\n}\n\nexport class HelperCommandError extends Error {\n\treadonly code?: string;\n\n\tconstructor(message: string, code?: string) {\n\t\tsuper(message);\n\t\tthis.name = \"HelperCommandError\";\n\t\tthis.code = code;\n\t}\n}\n\nfunction throwIfAborted(signal?: AbortSignal): void {\n\tif (signal?.aborted) throw new Error(\"Operation aborted.\");\n}\n\nasync function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n\tthrowIfAborted(signal);\n\tawait new Promise<void>((resolve, reject) => {\n\t\tconst timer = setTimeout(resolve, ms);\n\t\tconst onAbort = () => {\n\t\t\tclearTimeout(timer);\n\t\t\treject(new Error(\"Operation aborted.\"));\n\t\t};\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t}).finally(() => signal?.throwIfAborted?.());\n}\n\nasync function isExecutable(filePath: string): Promise<boolean> {\n\ttry {\n\t\tawait access(filePath, fsConstants.X_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nasync function isResolvedHelperExecutable(filePath?: string): Promise<boolean> {\n\tif (!filePath) return true;\n\tconst [actualPath, expectedPath] = await Promise.all([\n\t\trealpath(filePath).catch(() => path.resolve(filePath)),\n\t\trealpath(HELPER_APP_EXECUTABLE_PATH).catch(() => path.resolve(HELPER_APP_EXECUTABLE_PATH)),\n\t]);\n\treturn actualPath === expectedPath;\n}\n\nexport async function runProcess(\n\tcommand: string,\n\targs: string[],\n\ttimeoutMs: number,\n\tsignal?: AbortSignal,\n\tenv?: NodeJS.ProcessEnv,\n): Promise<void> {\n\tthrowIfAborted(signal);\n\n\tawait new Promise<void>((resolve, reject) => {\n\t\tconst child = spawn(command, args, {\n\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t\tenv,\n\t\t});\n\n\t\tlet stderr = \"\";\n\t\tlet stdout = \"\";\n\n\t\tconst timer = setTimeout(() => {\n\t\t\tchild.kill(\"SIGTERM\");\n\t\t\tcleanup();\n\t\t\treject(new Error(`Command timed out after ${timeoutMs}ms: ${command} ${args.join(\" \")}`));\n\t\t}, timeoutMs);\n\n\t\tconst onAbort = () => {\n\t\t\tchild.kill(\"SIGTERM\");\n\t\t\tcleanup();\n\t\t\treject(new Error(\"Operation aborted.\"));\n\t\t};\n\n\t\tconst cleanup = () => {\n\t\t\tclearTimeout(timer);\n\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t};\n\n\t\tchild.stdout.on(\"data\", (chunk) => {\n\t\t\tstdout += String(chunk);\n\t\t});\n\n\t\tchild.stderr.on(\"data\", (chunk) => {\n\t\t\tstderr += String(chunk);\n\t\t});\n\n\t\tchild.on(\"error\", (error) => {\n\t\t\tcleanup();\n\t\t\treject(error);\n\t\t});\n\n\t\tchild.on(\"close\", (code) => {\n\t\t\tcleanup();\n\t\t\tif (code === 0) {\n\t\t\t\tresolve();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst output = [stderr.trim(), stdout.trim()].filter(Boolean).join(\"\\n\");\n\t\t\treject(new Error(`Command failed (${code}): ${command} ${args.join(\" \")}\\n${output}`.trim()));\n\t\t});\n\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t});\n}\n\nexport class MacosHelperClient {\n\tprivate daemonAvailable = false;\n\tprivate requestSequence = 0;\n\tprivate diagnosticsCache?: PlatformDiagnostics;\n\n\tget diagnostics(): PlatformDiagnostics | undefined {\n\t\treturn this.diagnosticsCache;\n\t}\n\n\tasync ensureInstalled(signal?: AbortSignal): Promise<void> {\n\t\tif (usingExternalHelperSocket) return;\n\t\t// Installation is a deployment/repair operation, not part of every new\n\t\t// agent process's hot path. Protocol compatibility is checked against the\n\t\t// live daemon immediately afterwards.\n\t\tif (await isExecutable(HELPER_APP_EXECUTABLE_PATH)) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Re-enter Electron and Bun standalone hosts as their JavaScript runtimes.\n\t\tawait runProcess(process.execPath, [SETUP_HELPER_SCRIPT, \"--runtime\"], HELPER_SETUP_TIMEOUT_MS, signal, {\n\t\t\t...process.env,\n\t\t\tELECTRON_RUN_AS_NODE: \"1\",\n\t\t\tBUN_BE_BUN: \"1\",\n\t\t});\n\n\t\tif (!(await isExecutable(HELPER_APP_EXECUTABLE_PATH))) {\n\t\t\tthrow new Error(`Failed to install ada-computer-use helper app at ${HELPER_APP_PATH}.`);\n\t\t}\n\t}\n\n\tasync launchDaemon(signal?: AbortSignal): Promise<void> {\n\t\tif (usingExternalHelperSocket)\n\t\t\tthrow new HelperTransportError(`External helper socket is unavailable at ${HELPER_SOCKET_PATH}.`);\n\t\tawait mkdir(path.dirname(HELPER_SOCKET_PATH), { recursive: true });\n\t\t// Open the resolved bundle directly so a legacy system-wide copy with the\n\t\t// same bundle id cannot win LaunchServices resolution.\n\t\tawait runProcess(\n\t\t\t\"open\",\n\t\t\t[\"-n\", \"-g\", HELPER_APP_PATH, \"--args\", \"serve\", \"--socket\", HELPER_SOCKET_PATH],\n\t\t\tCOMMAND_TIMEOUT_MS,\n\t\t\tsignal,\n\t\t);\n\t}\n\n\tasync daemonCommand<T>(\n\t\tcmd: string,\n\t\targs: Record<string, unknown>,\n\t\ttimeoutMs: number,\n\t\tsignal?: AbortSignal,\n\t): Promise<T> {\n\t\treturn await new Promise<T>((resolve, reject) => {\n\t\t\tconst id = `req_${++this.requestSequence}`;\n\t\t\tconst socket = net.createConnection(HELPER_SOCKET_PATH);\n\t\t\tlet buffer = \"\";\n\t\t\tconst timer = setTimeout(() => {\n\t\t\t\tsocket.destroy();\n\t\t\t\treject(new HelperTransportError(`Daemon command '${cmd}' timed out after ${timeoutMs}ms.`));\n\t\t\t}, timeoutMs);\n\t\t\tconst cleanup = () => {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\t};\n\t\t\tconst onAbort = () => {\n\t\t\t\tsocket.destroy();\n\t\t\t\tcleanup();\n\t\t\t\treject(new Error(\"Operation aborted.\"));\n\t\t\t};\n\t\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t\t\tsocket.setEncoding(\"utf8\");\n\t\t\tsocket.on(\"connect\", () => socket.write(`${JSON.stringify({ id, cmd, ...args })}\\n`));\n\t\t\tsocket.on(\"data\", (chunk) => {\n\t\t\t\tbuffer += chunk;\n\t\t\t\tconst newline = buffer.indexOf(\"\\n\");\n\t\t\t\tif (newline < 0) return;\n\t\t\t\tcleanup();\n\t\t\t\tsocket.end();\n\t\t\t\ttry {\n\t\t\t\t\tconst parsed = JSON.parse(buffer.slice(0, newline));\n\t\t\t\t\tif (parsed.ok === true) resolve(parsed.result as T);\n\t\t\t\t\telse\n\t\t\t\t\t\treject(\n\t\t\t\t\t\t\tnew HelperCommandError(\n\t\t\t\t\t\t\t\tparsed?.error?.message ?? `Daemon command '${cmd}' failed.`,\n\t\t\t\t\t\t\t\tparsed?.error?.code,\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\t\t\t\t} catch (error) {\n\t\t\t\t\treject(error);\n\t\t\t\t}\n\t\t\t});\n\t\t\tsocket.on(\"error\", (error) => {\n\t\t\t\tcleanup();\n\t\t\t\treject(new HelperTransportError(error.message));\n\t\t\t});\n\t\t});\n\t}\n\n\tasync ensureDaemon(signal?: AbortSignal): Promise<boolean> {\n\t\tif (this.daemonAvailable) return true;\n\t\ttry {\n\t\t\tawait this.daemonCommand(\"diagnostics\", {}, 1_000, signal);\n\t\t\tthis.daemonAvailable = true;\n\t\t\treturn true;\n\t\t} catch {}\n\t\tawait this.launchDaemon(signal).catch(() => undefined);\n\t\tfor (let index = 0; index < 30; index += 1) {\n\t\t\ttry {\n\t\t\t\tawait this.daemonCommand(\"diagnostics\", {}, 1_000, signal);\n\t\t\t\tthis.daemonAvailable = true;\n\t\t\t\treturn true;\n\t\t\t} catch {\n\t\t\t\tawait sleep(100, signal);\n\t\t\t}\n\t\t}\n\t\treturn false;\n\t}\n\n\tasync command<T>(\n\t\tcmd: string,\n\t\targs: Record<string, unknown> = {},\n\t\toptions?: { timeoutMs?: number; signal?: AbortSignal },\n\t): Promise<T> {\n\t\tconst timeoutMs = options?.timeoutMs ?? COMMAND_TIMEOUT_MS;\n\t\tif (!(await this.ensureDaemon(options?.signal))) {\n\t\t\tthrow new HelperTransportError(`ada-computer-use helper app daemon is unavailable at ${HELPER_APP_PATH}.`);\n\t\t}\n\t\ttry {\n\t\t\treturn await this.daemonCommand<T>(cmd, args, timeoutMs, options?.signal);\n\t\t} catch (error) {\n\t\t\tthis.daemonAvailable = false;\n\t\t\tthrow error instanceof Error ? error : new Error(String(error));\n\t\t}\n\t}\n\n\tasync restart(signal?: AbortSignal): Promise<void> {\n\t\tawait this.command(\"shutdown\", {}, { signal, timeoutMs: 2_000 }).catch(() => undefined);\n\t\tthis.daemonAvailable = false;\n\t\tawait sleep(400, signal);\n\t\tif (!(await this.ensureDaemon(signal))) {\n\t\t\tthrow new Error(`ada-computer-use helper did not come back after restart. Helper app: ${HELPER_APP_PATH}`);\n\t\t}\n\t}\n\n\tasync diagnosticsCommand(signal?: AbortSignal): Promise<PlatformDiagnostics> {\n\t\tconst result = await this.command<any>(\"diagnostics\", {}, { signal });\n\t\tconst diagnostics = {\n\t\t\tprotocolVersion: Math.trunc(toFiniteNumber(result?.protocolVersion, 0)),\n\t\t\tarchitectureVersion: Math.trunc(toFiniteNumber(result?.architectureVersion, 0)),\n\t\t\tinvariants: Array.isArray(result?.invariants)\n\t\t\t\t? result.invariants.filter((value: unknown): value is string => typeof value === \"string\")\n\t\t\t\t: [],\n\t\t\tpid: Math.trunc(toFiniteNumber(result?.pid, 0)),\n\t\t\tparentPid: Math.trunc(toFiniteNumber(result?.parentPid, 0)) || undefined,\n\t\t\tparentAppName: toOptionalString(result?.parentAppName),\n\t\t\tparentBundleId: toOptionalString(result?.parentBundleId),\n\t\t\tparentPath: toOptionalString(result?.parentPath),\n\t\t\texecutablePath: toOptionalString(result?.executablePath),\n\t\t\tos: toOptionalString(result?.macOS),\n\t\t\tarch: toOptionalString(result?.arch),\n\t\t\taccessibility: toBoolean(result?.accessibility),\n\t\t\tscreenRecording: toBoolean(result?.screenRecording),\n\t\t};\n\t\tthis.diagnosticsCache = diagnostics;\n\t\treturn diagnostics;\n\t}\n\n\tasync ensureProtocol(signal?: AbortSignal): Promise<PlatformDiagnostics> {\n\t\tlet diagnostics = await this.diagnosticsCommand(signal);\n\t\tconst executableMatches = await isResolvedHelperExecutable(diagnostics.executablePath);\n\t\tif (diagnostics.protocolVersion === HELPER_PROTOCOL_VERSION && executableMatches) return diagnostics;\n\n\t\t// The helper daemon outlives Pi, so restarting/reloading Pi alone does not\n\t\t// replace a stale daemon or one launched from the legacy system location.\n\t\t// Stop it through the backwards-compatible command channel and relaunch\n\t\t// the exact app bundle that ensureInstalled() resolved.\n\t\tawait this.restart(signal);\n\t\tdiagnostics = await this.diagnosticsCommand(signal);\n\t\tconst relaunchedExecutableMatches = await isResolvedHelperExecutable(diagnostics.executablePath);\n\t\tif (diagnostics.protocolVersion !== HELPER_PROTOCOL_VERSION || !relaunchedExecutableMatches) {\n\t\t\tthis.daemonAvailable = false;\n\t\t\tthrow new Error(\n\t\t\t\t`ada-computer-use helper mismatch after relaunch: expected protocol ${HELPER_PROTOCOL_VERSION} and executable ${HELPER_APP_EXECUTABLE_PATH}; got protocol ${diagnostics.protocolVersion} and executable ${diagnostics.executablePath ?? \"unknown\"}. Reinstall or rebuild the helper app at ${HELPER_APP_PATH}.`,\n\t\t\t);\n\t\t}\n\t\treturn diagnostics;\n\t}\n}\n\nexport const macosHelper = new MacosHelperClient();\n"]}