@framers/agentos-ext-browser-automation 0.1.0 → 0.2.0

package/dist/attach/__tests__/tools.test.js

@@ -0,0 +1,155 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const AttachController_js_1 = require("../AttachController.js");
+const tools_js_1 = require("../tools.js");
+function backend() {
+    return {
+        kind: 'jxa',
+        async connect() { },
+        async disconnectTransport() { },
+        async claimAgentTab() {
+            return 'w1 t1';
+        },
+        async probeIdentity() {
+            return 'Inbox - johnny@example.com - Gmail';
+        },
+        async gotoTab(_t, url) {
+            return url;
+        },
+        async readTab() {
+            return 'PAGE BODY TEXT';
+        },
+    };
+}
+let controller;
+(0, vitest_1.beforeEach)(() => {
+    const leaseFile = (0, node_path_1.join)((0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'attach-tools-')), 'attach.lease');
+    controller = new AttachController_js_1.AttachController({ backend: backend(), leaseFile, expectedIdentity: 'johnny@example.com' });
+});
+(0, vitest_1.describe)('attach tools', () => {
+    (0, vitest_1.it)('exposes exactly the six ids and no eval/js tool', () => {
+        (0, vitest_1.expect)(tools_js_1.ATTACH_TOOL_IDS).toEqual([
+            'browser_attach_status',
+            'browser_attach_claim',
+            'browser_attach_goto',
+            'browser_attach_read',
+            'browser_attach_release',
+            'browser_attach_control',
+        ]);
+        (0, vitest_1.expect)(tools_js_1.ATTACH_TOOL_IDS).not.toContain('browser_attach_eval');
+        (0, vitest_1.expect)((0, tools_js_1.createAttachTools)(controller)).toHaveLength(6);
+    });
+    (0, vitest_1.it)('control tool pauses, resumes, and toggles dry-run at runtime', async () => {
+        const ctl = new tools_js_1.AttachControlTool(controller);
+        await new tools_js_1.AttachClaimTool(controller).execute();
+        (0, vitest_1.expect)((await ctl.execute({ action: 'pause' })).data.paused).toBe(true);
+        (0, vitest_1.expect)((await ctl.execute({ action: 'resume' })).data.paused).toBe(false);
+        (0, vitest_1.expect)((await ctl.execute({ action: 'dry_run_on' })).data.dryRun).toBe(true);
+        (0, vitest_1.expect)((await ctl.execute({ action: 'dry_run_off' })).data.dryRun).toBe(false);
+        (0, vitest_1.expect)((await ctl.execute({ action: 'status' })).data.leaseHeld).toBe(true);
+    });
+    (0, vitest_1.it)('status and read are non-side-effecting; claim/goto/release are side-effecting', () => {
+        (0, vitest_1.expect)(new tools_js_1.AttachStatusTool(controller).hasSideEffects).toBe(false);
+        (0, vitest_1.expect)(new tools_js_1.AttachReadTool(controller).hasSideEffects).toBe(false);
+        (0, vitest_1.expect)(new tools_js_1.AttachClaimTool(controller).hasSideEffects).toBe(true);
+        (0, vitest_1.expect)(new tools_js_1.AttachGotoTool(controller).hasSideEffects).toBe(true);
+        (0, vitest_1.expect)(new tools_js_1.AttachReleaseTool(controller).hasSideEffects).toBe(true);
+    });
+    (0, vitest_1.it)('runs the full claim → goto → read → release envelope', async () => {
+        (0, vitest_1.expect)((await new tools_js_1.AttachClaimTool(controller).execute()).success).toBe(true);
+        const goto = await new tools_js_1.AttachGotoTool(controller).execute({ url: 'https://founderscard.com/home' });
+        (0, vitest_1.expect)(goto).toMatchObject({ success: true, data: { url: 'https://founderscard.com/home' } });
+        const read = await new tools_js_1.AttachReadTool(controller).execute({});
+        (0, vitest_1.expect)(read.data).toMatchObject({ untrusted: true, text: 'PAGE BODY TEXT' });
+        const rel = await new tools_js_1.AttachReleaseTool(controller).execute();
+        (0, vitest_1.expect)(rel).toMatchObject({ success: true, data: { released: true } });
+    });
+    (0, vitest_1.it)('goto returns a structured error envelope (not a throw) on a blocked URL', async () => {
+        await new tools_js_1.AttachClaimTool(controller).execute();
+        const res = await new tools_js_1.AttachGotoTool(controller).execute({ url: 'file:///etc/passwd' });
+        (0, vitest_1.expect)(res.success).toBe(false);
+        (0, vitest_1.expect)(res.code).toBe('POLICY_BLOCKED');
+    });
+    (0, vitest_1.it)('status never throws even before a claim', async () => {
+        const res = await new tools_js_1.AttachStatusTool(controller).execute();
+        (0, vitest_1.expect)(res.success).toBe(true);
+        (0, vitest_1.expect)(res.data.leaseHeld).toBe(false);
+    });
+});
+(0, vitest_1.describe)('tools over the daemon surface', () => {
+    (0, vitest_1.it)('browser_attach_* flows tool -> IPC -> daemon -> controller -> backend', async () => {
+        const { rmSync } = await Promise.resolve().then(() => __importStar(require('node:fs')));
+        const { DaemonAttachSurface } = await Promise.resolve().then(() => __importStar(require('../daemon/surface.js')));
+        const { AttachDaemonClient } = await Promise.resolve().then(() => __importStar(require('../daemon/client.js')));
+        const { daemonUnderTest } = await Promise.resolve().then(() => __importStar(require('../daemon/__tests__/harness.js')));
+        const { createAttachTools, ATTACH_TOOL_IDS } = await Promise.resolve().then(() => __importStar(require('../tools.js')));
+        const { dir, backend, run } = daemonUnderTest();
+        try {
+            const surface = new DaemonAttachSurface({ ipcDir: (0, node_path_1.join)(dir, 'ipc') });
+            const tools = createAttachTools(surface);
+            const byId = Object.fromEntries(tools.map((t) => [t.id, t]));
+            (0, vitest_1.expect)(Object.keys(byId).sort()).toEqual([...ATTACH_TOOL_IDS].sort()); // ids unchanged
+            (0, vitest_1.expect)(byId['browser_attach_read'].hasSideEffects).toBe(false);
+            (0, vitest_1.expect)(byId['browser_attach_status'].hasSideEffects).toBe(false);
+            (0, vitest_1.expect)((await byId['browser_attach_claim'].execute({})).success).toBe(true);
+            const nav = await byId['browser_attach_goto'].execute({ url: 'https://example.com/' });
+            (0, vitest_1.expect)(nav.success).toBe(true);
+            (0, vitest_1.expect)(backend.calls).toContain('goto:https://example.com/');
+            const read = await byId['browser_attach_read'].execute({});
+            (0, vitest_1.expect)(read.success).toBe(true);
+            (0, vitest_1.expect)(read.data.untrusted).toBe(true);
+            (0, vitest_1.expect)((await byId['browser_attach_release'].execute()).success).toBe(true);
+            await new AttachDaemonClient({ ipcDir: (0, node_path_1.join)(dir, 'ipc'), client: 'test-quit', pollMs: 25 }).quit();
+            await run;
+        }
+        finally {
+            rmSync(dir, { recursive: true, force: true });
+        }
+    }, 60000);
+    (0, vitest_1.it)('the daemon surface exposes no eval anywhere on the tool path', async () => {
+        const { DaemonAttachSurface } = await Promise.resolve().then(() => __importStar(require('../daemon/surface.js')));
+        const surface = new DaemonAttachSurface({ ipcDir: (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'attach-noeval-')) });
+        const asRecord = surface;
+        (0, vitest_1.expect)(asRecord.evaluate).toBeUndefined();
+        (0, vitest_1.expect)(asRecord.eval).toBeUndefined();
+        (0, vitest_1.expect)(asRecord.extract).toBeUndefined();
+    });
+});
+//# sourceMappingURL=tools.test.js.map

package/dist/attach/__tests__/tools.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.test.js","sourceRoot":"","sources":["../../../src/attach/__tests__/tools.test.ts"],"names":[],"mappings":"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"}

package/dist/attach/backends/__tests__/raw-cdp.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=raw-cdp.test.d.ts.map

package/dist/attach/backends/__tests__/raw-cdp.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-cdp.test.d.ts","sourceRoot":"","sources":["../../../../src/attach/backends/__tests__/raw-cdp.test.ts"],"names":[],"mappings":""}

package/dist/attach/backends/__tests__/raw-cdp.test.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const ws_1 = require("ws");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const raw_cdp_js_1 = require("../raw-cdp.js");
+/** Minimal fake CDP browser endpoint: answers exactly the methods the backend may send. */
+function fakeCdp(opts = {}) {
+    const wss = new ws_1.WebSocketServer({ port: 0, path: '/devtools/browser/fake' });
+    const seen = [];
+    const created = [];
+    const closed = [];
+    wss.on('connection', (sock) => {
+        sock.on('message', (buf) => {
+            const m = JSON.parse(String(buf));
+            seen.push(m.method);
+            if (opts.wedgeAfterConnect)
+                return; // never answer: simulates a zombie handshake
+            const reply = (result) => sock.send(JSON.stringify({ id: m.id, result }));
+            switch (m.method) {
+                case 'Target.getTargets':
+                    return reply({ targetInfos: (opts.pages ?? []).map((p) => ({ ...p, type: 'page' })) });
+                case 'Target.createTarget': {
+                    const targetId = `created-${created.length + 1}`;
+                    created.push(targetId);
+                    return reply({ targetId });
+                }
+                case 'Target.attachToTarget':
+                    return reply({ sessionId: 'sess-1' });
+                case 'Target.closeTarget':
+                    closed.push(m.params.targetId);
+                    return reply({ success: true });
+                case 'Page.enable':
+                case 'Runtime.enable':
+                    return reply({});
+                case 'Page.navigate':
+                    return reply({ frameId: 'f1' });
+                case 'Runtime.evaluate':
+                    return reply({
+                        result: { value: m.params.expression.includes('location.href') ? 'https://example.com/' : 'evaluated' },
+                    });
+                default:
+                    return reply({});
+            }
+        });
+    });
+    return { wss, seen, created, closed, port: () => wss.address().port };
+}
+/** Profile root whose DevToolsActivePort points at the fake server. */
+function profileRootFor(port) {
+    const d = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'attach-prof-'));
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(d, 'DevToolsActivePort'), `${port}\n/devtools/browser/fake`);
+    return d;
+}
+const cleanup = [];
+(0, vitest_1.afterEach)(() => {
+    for (const f of cleanup.splice(0))
+        f();
+});
+(0, vitest_1.describe)('RawCdpBackend', () => {
+    (0, vitest_1.it)('attaches to exactly ONE created target and never closes foreign targets', async () => {
+        const srv = fakeCdp({
+            pages: [{ targetId: 'user-tab-1', url: 'https://mail.google.com/', title: 'Inbox - user@gmail.com - Gmail' }],
+        });
+        cleanup.push(() => srv.wss.close());
+        const prof = profileRootFor(srv.port());
+        cleanup.push(() => (0, node_fs_1.rmSync)(prof, { recursive: true, force: true }));
+        const be = new raw_cdp_js_1.RawCdpBackend({ profileRoot: prof, settleMs: 0 });
+        await be.connect();
+        const tab = await be.claimAgentTab();
+        (0, vitest_1.expect)(srv.created).toContain(tab);
+        (0, vitest_1.expect)(await be.gotoTab(tab, 'https://example.com/')).toBe('https://example.com/');
+        (0, vitest_1.expect)(await be.readTab(tab)).toBe('evaluated');
+        await be.disconnectTransport();
+        (0, vitest_1.expect)(srv.seen).not.toContain('Browser.close');
+        (0, vitest_1.expect)(srv.closed).toEqual([tab]); // ONLY our own created tab, ever
+    });
+    (0, vitest_1.it)('probeIdentity reads target metadata only (no attach, no navigation)', async () => {
+        const srv = fakeCdp({
+            pages: [{ targetId: 'user-tab-1', url: 'https://mail.google.com/mail/u/0', title: 'Inbox - user@gmail.com - Gmail' }],
+        });
+        cleanup.push(() => srv.wss.close());
+        const prof = profileRootFor(srv.port());
+        cleanup.push(() => (0, node_fs_1.rmSync)(prof, { recursive: true, force: true }));
+        const be = new raw_cdp_js_1.RawCdpBackend({ profileRoot: prof });
+        await be.connect();
+        const before = srv.seen.length;
+        const identity = await be.probeIdentity();
+        (0, vitest_1.expect)(identity).toContain('user@gmail.com');
+        (0, vitest_1.expect)(srv.seen.slice(before)).toEqual(['Target.getTargets']); // metadata only
+        await be.disconnectTransport();
+    });
+    (0, vitest_1.it)('missing DevToolsActivePort throws CDP_UNAVAILABLE without any connection', async () => {
+        const d = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'attach-noprof-'));
+        cleanup.push(() => (0, node_fs_1.rmSync)(d, { recursive: true, force: true }));
+        const be = new raw_cdp_js_1.RawCdpBackend({ profileRoot: d });
+        await (0, vitest_1.expect)(be.connect()).rejects.toMatchObject({ code: 'CDP_UNAVAILABLE' });
+    });
+    (0, vitest_1.it)('malformed DevToolsActivePort throws STALE_PORT_FILE', async () => {
+        const d = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'attach-badprof-'));
+        cleanup.push(() => (0, node_fs_1.rmSync)(d, { recursive: true, force: true }));
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(d, 'DevToolsActivePort'), 'garbage\n');
+        const be = new raw_cdp_js_1.RawCdpBackend({ profileRoot: d });
+        await (0, vitest_1.expect)(be.connect()).rejects.toMatchObject({ code: 'STALE_PORT_FILE' });
+    });
+    (0, vitest_1.it)('a wedged endpoint times out with CDP_TIMEOUT instead of hanging', async () => {
+        const srv = fakeCdp({ wedgeAfterConnect: true });
+        cleanup.push(() => srv.wss.close());
+        const prof = profileRootFor(srv.port());
+        cleanup.push(() => (0, node_fs_1.rmSync)(prof, { recursive: true, force: true }));
+        const be = new raw_cdp_js_1.RawCdpBackend({ profileRoot: prof, commandTimeoutMs: 300 });
+        await be.connect();
+        await (0, vitest_1.expect)(be.claimAgentTab()).rejects.toMatchObject({ code: 'CDP_TIMEOUT' });
+        await be.disconnectTransport();
+    });
+    (0, vitest_1.it)('an unexpected transport drop fails pending commands and fires onUnexpectedClose once', async () => {
+        const srv = fakeCdp({ wedgeAfterConnect: true });
+        cleanup.push(() => srv.wss.close());
+        const prof = profileRootFor(srv.port());
+        cleanup.push(() => (0, node_fs_1.rmSync)(prof, { recursive: true, force: true }));
+        const be = new raw_cdp_js_1.RawCdpBackend({ profileRoot: prof, commandTimeoutMs: 5000 });
+        const drops = [];
+        be.onUnexpectedClose = (err) => drops.push(err.message);
+        await be.connect();
+        const inflight = be.claimAgentTab();
+        srv.wss.clients.forEach((c) => c.terminate());
+        await (0, vitest_1.expect)(inflight).rejects.toMatchObject({ code: 'CDP_UNAVAILABLE' });
+        (0, vitest_1.expect)(drops).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=raw-cdp.test.js.map

package/dist/attach/backends/__tests__/raw-cdp.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-cdp.test.js","sourceRoot":"","sources":["../../../../src/attach/backends/__tests__/raw-cdp.test.ts"],"names":[],"mappings":"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"}

package/dist/attach/backends/jxa.d.ts

@@ -0,0 +1,39 @@
+import type { AttachBackend } from '../AttachController.js';
+/** Options for {@link JxaBackend}. */
+export interface JxaBackendOptions {
+    /** Chrome profile root (defaults to the macOS default profile root). */
+    profileRoot?: string;
+    /** Identity probe URL (a page whose title reveals the signed-in account). */
+    identityProbeUrl?: string;
+    /** Per-exec timeout ms (default 40s). */
+    execTimeoutMs?: number;
+}
+/**
+ * Build the exact osascript argv for a driver invocation. Pure + exported for
+ * unit tests: arguments pass as argv (never shell-interpolated). The driver
+ * receives `profileRoot` as its first arg, then the command and its args.
+ */
+export declare function buildJxaArgs(script: string, profileRoot: string, cmd: string, args: string[]): string[];
+/** The embedded JXA driver source (written to a temp file at first use). */
+export declare const JXA_DRIVER_SOURCE = "ObjC.import('Foundation');\nfunction chromePid(root) {\n  const dest = $.NSFileManager.defaultManager.destinationOfSymbolicLinkAtPathError(root + '/SingletonLock', null);\n  if (!dest || !dest.js) throw new Error('SingletonLock unreadable');\n  return parseInt(dest.js.match(/-(\\d+)$/)[1], 10);\n}\nfunction run(argv) {\n  const root = argv[0], cmd = argv[1];\n  const c = Application(chromePid(root));\n  c.includeStandardAdditions = false;\n  const MARKER = '__agentos_attach_tab_v1__';\n  if (cmd === 'claim') {\n    for (const w of c.windows()) {\n      for (const t of w.tabs()) {\n        if (t.url() === 'about:blank') {\n          try { c.execute(t, { javascript: 'window.name=' + JSON.stringify(MARKER) }); } catch (e) {}\n          return w.id() + ' ' + t.id();\n        }\n      }\n    }\n    throw new Error('NO_BLANK_TAB: open a fresh tab (about:blank) in the target profile first');\n  }\n  const wid = argv[2], tid = argv[3];\n  const w = c.windows().find((x) => String(x.id()) === String(wid));\n  if (!w) throw new Error('window ' + wid + ' not found');\n  const t = w.tabs().find((x) => String(x.id()) === String(tid));\n  if (!t) throw new Error('tab ' + tid + ' not found in window ' + wid);\n  if (cmd === 'goto') {\n    t.url = argv[4];\n    for (let i = 0; i < 80; i++) { delay(0.5); try { if (t.loading() === false) break; } catch (e) { break; } }\n    delay(1);\n    return t.url();\n  }\n  if (cmd === 'url') return t.url() + '\\n' + t.title();\n  if (cmd === 'read') {\n    const sel = argv[4] || 'body';\n    const max = parseInt(argv[5] || '6000', 10);\n    const js = '(document.querySelector(' + JSON.stringify(sel) + ')||document.body).innerText.slice(0,' + max + ')';\n    const r = c.execute(t, { javascript: js });\n    return typeof r === 'string' ? r : JSON.stringify(r);\n  }\n  throw new Error('unknown cmd ' + cmd);\n}\n";
+/** macOS JXA transport backend. */
+export declare class JxaBackend implements AttachBackend {
+    readonly kind: "jxa";
+    private readonly profileRoot;
+    private readonly identityProbeUrl;
+    private readonly execTimeoutMs;
+    private driverPath?;
+    private claimed?;
+    constructor(opts?: JxaBackendOptions);
+    /** Verify the SingletonLock resolves (Chrome is running) — no side effects. */
+    connect(): Promise<void>;
+    /** Nothing persistent to tear down: each op is a discrete osascript exec. */
+    disconnectTransport(): Promise<void>;
+    private driver;
+    private exec;
+    claimAgentTab(): Promise<string>;
+    probeIdentity(): Promise<string>;
+    gotoTab(tab: string, url: string): Promise<string>;
+    readTab(tab: string, selector?: string, maxChars?: number): Promise<string>;
+}
+//# sourceMappingURL=jxa.d.ts.map

package/dist/attach/backends/jxa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jxa.d.ts","sourceRoot":"","sources":["../../../src/attach/backends/jxa.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI5D,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEvG;AAED,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,00DA2C7B,CAAC;AAEF,mCAAmC;AACnC,qBAAa,UAAW,YAAW,aAAa;IAC9C,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAC,CAA+B;gBAEnC,IAAI,GAAE,iBAAsB;IAMxC,+EAA+E;IACzE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B,6EAA6E;IACvE,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;YAI5B,MAAM;YAWN,IAAI;IAeZ,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAQhC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAQhC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKlD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAIlF"}

package/dist/attach/backends/jxa.js

@@ -0,0 +1,188 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JxaBackend = exports.JXA_DRIVER_SOURCE = void 0;
+exports.buildJxaArgs = buildJxaArgs;
+/**
+ * @fileoverview JXA (macOS) attach backend.
+ *
+ * Drives the user's RUNNING Chrome through `osascript -l JavaScript`,
+ * addressing the application BY PID resolved from the profile root's
+ * `SingletonLock` symlink — bundle-name addressing is ambiguous when more than
+ * one Chrome instance runs (e.g. a devtools-mcp cache instance) and MUST NOT
+ * be used. Navigation and reads work on background tabs; nothing here focuses,
+ * creates windows beyond the agent tab, or closes anything.
+ *
+ * The embedded driver mirrors the field-proven `vca-jxa.js` contract:
+ * claim (marker-binds an about:blank tab), goto (poll `loading`), url, and a
+ * selector-scoped innerText read. Raw arbitrary page JS is deliberately NOT
+ * exposed (Codex spec review F2).
+ *
+ * @module browser-automation/attach/backends/jxa
+ */
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_fs_1 = require("node:fs");
+const singleton_lock_js_1 = require("../singleton-lock.js");
+const errors_js_1 = require("../errors.js");
+const pExecFile = (0, node_util_1.promisify)(node_child_process_1.execFile);
+/**
+ * Build the exact osascript argv for a driver invocation. Pure + exported for
+ * unit tests: arguments pass as argv (never shell-interpolated). The driver
+ * receives `profileRoot` as its first arg, then the command and its args.
+ */
+function buildJxaArgs(script, profileRoot, cmd, args) {
+    return ['-l', 'JavaScript', script, profileRoot, cmd, ...args];
+}
+/** The embedded JXA driver source (written to a temp file at first use). */
+exports.JXA_DRIVER_SOURCE = `ObjC.import('Foundation');
+function chromePid(root) {
+  const dest = $.NSFileManager.defaultManager.destinationOfSymbolicLinkAtPathError(root + '/SingletonLock', null);
+  if (!dest || !dest.js) throw new Error('SingletonLock unreadable');
+  return parseInt(dest.js.match(/-(\\d+)$/)[1], 10);
+}
+function run(argv) {
+  const root = argv[0], cmd = argv[1];
+  const c = Application(chromePid(root));
+  c.includeStandardAdditions = false;
+  const MARKER = '__agentos_attach_tab_v1__';
+  if (cmd === 'claim') {
+    for (const w of c.windows()) {
+      for (const t of w.tabs()) {
+        if (t.url() === 'about:blank') {
+          try { c.execute(t, { javascript: 'window.name=' + JSON.stringify(MARKER) }); } catch (e) {}
+          return w.id() + ' ' + t.id();
+        }
+      }
+    }
+    throw new Error('NO_BLANK_TAB: open a fresh tab (about:blank) in the target profile first');
+  }
+  const wid = argv[2], tid = argv[3];
+  const w = c.windows().find((x) => String(x.id()) === String(wid));
+  if (!w) throw new Error('window ' + wid + ' not found');
+  const t = w.tabs().find((x) => String(x.id()) === String(tid));
+  if (!t) throw new Error('tab ' + tid + ' not found in window ' + wid);
+  if (cmd === 'goto') {
+    t.url = argv[4];
+    for (let i = 0; i < 80; i++) { delay(0.5); try { if (t.loading() === false) break; } catch (e) { break; } }
+    delay(1);
+    return t.url();
+  }
+  if (cmd === 'url') return t.url() + '\\n' + t.title();
+  if (cmd === 'read') {
+    const sel = argv[4] || 'body';
+    const max = parseInt(argv[5] || '6000', 10);
+    const js = '(document.querySelector(' + JSON.stringify(sel) + ')||document.body).innerText.slice(0,' + max + ')';
+    const r = c.execute(t, { javascript: js });
+    return typeof r === 'string' ? r : JSON.stringify(r);
+  }
+  throw new Error('unknown cmd ' + cmd);
+}
+`;
+/** macOS JXA transport backend. */
+class JxaBackend {
+    constructor(opts = {}) {
+        this.kind = 'jxa';
+        this.profileRoot = opts.profileRoot ?? (0, node_path_1.join)((0, node_os_1.homedir)(), 'Library/Application Support/Google/Chrome');
+        this.identityProbeUrl = opts.identityProbeUrl ?? 'https://mail.google.com/mail/u/0/';
+        this.execTimeoutMs = opts.execTimeoutMs ?? 40000;
+    }
+    /** Verify the SingletonLock resolves (Chrome is running) — no side effects. */
+    async connect() {
+        let target;
+        try {
+            target = (0, node_fs_1.readlinkSync)((0, node_path_1.join)(this.profileRoot, 'SingletonLock'));
+        }
+        catch {
+            throw new errors_js_1.AttachError('CDP_UNAVAILABLE', 'no running Chrome found for the target profile root (SingletonLock absent)');
+        }
+        (0, singleton_lock_js_1.pidFromSingletonLock)(target); // throws on malformed
+    }
+    /** Nothing persistent to tear down: each op is a discrete osascript exec. */
+    async disconnectTransport() {
+        this.claimed = undefined;
+    }
+    async driver() {
+        if (this.driverPath)
+            return this.driverPath;
+        const { mkdtempSync, writeFileSync } = await Promise.resolve().then(() => __importStar(require('node:fs')));
+        const { tmpdir } = await Promise.resolve().then(() => __importStar(require('node:os')));
+        const dir = mkdtempSync((0, node_path_1.join)(tmpdir(), 'attach-jxa-'));
+        const file = (0, node_path_1.join)(dir, 'driver.js');
+        writeFileSync(file, exports.JXA_DRIVER_SOURCE);
+        this.driverPath = file;
+        return file;
+    }
+    async exec(cmd, args) {
+        const script = await this.driver();
+        const argv = buildJxaArgs(script, this.profileRoot, cmd, args);
+        try {
+            const { stdout } = await pExecFile('osascript', argv, { timeout: this.execTimeoutMs });
+            return stdout.trim();
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new errors_js_1.AttachError(/turned off/i.test(msg) ? 'JS_DISABLED' : /not authorized/i.test(msg) ? 'ACCESSIBILITY_DENIED' : 'UNKNOWN', msg);
+        }
+    }
+    async claimAgentTab() {
+        const out = await this.exec('claim', []);
+        const [wid, tid] = out.split(/\s+/);
+        if (!wid || !tid)
+            throw new errors_js_1.AttachError('TAB_CLOSED', `claim returned malformed ids: "${out}"`);
+        this.claimed = { wid, tid };
+        return `${wid} ${tid}`;
+    }
+    async probeIdentity() {
+        // Claim first if needed so the probe never touches a user tab.
+        if (!this.claimed)
+            await this.claimAgentTab();
+        const { wid, tid } = this.claimed;
+        await this.exec('goto', [wid, tid, this.identityProbeUrl]);
+        return this.exec('url', [wid, tid]);
+    }
+    async gotoTab(tab, url) {
+        const [wid, tid] = tab.split(/\s+/);
+        return this.exec('goto', [wid, tid, url]);
+    }
+    async readTab(tab, selector, maxChars) {
+        const [wid, tid] = tab.split(/\s+/);
+        return this.exec('read', [wid, tid, selector ?? 'body', String(maxChars ?? 6000)]);
+    }
+}
+exports.JxaBackend = JxaBackend;
+//# sourceMappingURL=jxa.js.map

package/dist/attach/backends/jxa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jxa.js","sourceRoot":"","sources":["../../../src/attach/backends/jxa.ts"],"names":[],"mappings":"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"}

package/dist/attach/backends/raw-cdp.d.ts

@@ -0,0 +1,53 @@
+import type { AttachBackend } from '../AttachController.js';
+/** Options for {@link RawCdpBackend}. */
+export interface RawCdpBackendOptions {
+    /** Chrome profile root holding `DevToolsActivePort` (default: macOS default profile root). */
+    profileRoot?: string;
+    /** Identity probe: substring matched against page-target urls (default `mail.google.com`). */
+    identityProbeUrl?: string;
+    /** Post-navigation settle delay ms (default 1800; the daemon sets 0 and settles per op). */
+    settleMs?: number;
+    /** Per-CDP-command timeout ms (default 20000). */
+    commandTimeoutMs?: number;
+    /** ws open timeout ms (default 15000). */
+    connectTimeoutMs?: number;
+    /** Eval result size cap in serialized chars (default 512 * 1024). */
+    evalMaxChars?: number;
+}
+/**
+ * Raw single-target CDP backend (see fileoverview for the contract).
+ *
+ * Never sends `Browser.close`; `Target.closeTarget` is only ever issued for
+ * the tab this instance created.
+ */
+export declare class RawCdpBackend implements AttachBackend {
+    readonly kind: "cdp";
+    private readonly opts;
+    private ws;
+    private nextId;
+    private readonly pending;
+    private sessionId;
+    private createdTargetId;
+    /** Invoked once when the transport drops unexpectedly (daemon schedules backoff reconnect). */
+    onUnexpectedClose: ((err: Error) => void) | null;
+    constructor(options?: RawCdpBackendOptions);
+    /** Open the ws to the browser endpoint. Creates/focuses NOTHING. Idempotent while connected. */
+    connect(): Promise<void>;
+    /** Close ONLY our created tab (if any), then the ws. Never `Browser.close`. */
+    disconnectTransport(): Promise<void>;
+    /** Create the agent tab, attach flattened to it alone, enable Page/Runtime on that session only. */
+    claimAgentTab(): Promise<string>;
+    /** Metadata-only identity read: matching page targets' titles/urls. No attach, no navigation. */
+    probeIdentity(): Promise<string>;
+    /** Navigate the agent tab, settle, return the landed URL. */
+    gotoTab(tab: string, url: string): Promise<string>;
+    /** innerText read, optional selector scope, capped. */
+    readTab(tab: string, selector?: string, maxChars?: number): Promise<string>;
+    /** Runtime.evaluate in the agent tab (optional backend capability used by extract/evaluate). */
+    evalInTab(tab: string, expression: string, timeoutMs?: number): Promise<unknown>;
+    private requireTab;
+    private onMessage;
+    private failAllPending;
+    private send;
+}
+//# sourceMappingURL=raw-cdp.d.ts.map

package/dist/attach/backends/raw-cdp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-cdp.d.ts","sourceRoot":"","sources":["../../../src/attach/backends/raw-cdp.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI5D,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8FAA8F;IAC9F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAWD;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,aAAa;IACjD,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,eAAe,CAAuB;IAC9C,+FAA+F;IAC/F,iBAAiB,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;gBAE5C,OAAO,GAAE,oBAAyB;IAW9C,gGAAgG;IAC1F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqD9B,+EAA+E;IACzE,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB1C,oGAAoG;IAC9F,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAatC,iGAAiG;IAC3F,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAUtC,6DAA6D;IACvD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOxD,uDAAuD;IACjD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ/E,gGAAgG;IAC1F,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBtF,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,IAAI;CAoBb"}