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

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

@@ -0,0 +1,278 @@
+"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");
+/**
+ * Spy backend that records every method call. Its type deliberately mirrors
+ * AttachBackend, which has NO browser/tab close surface — the core F10 claim
+ * is proven structurally plus asserted behaviorally here.
+ */
+function makeBackend(overrides = {}) {
+    const calls = [];
+    const backend = {
+        kind: 'jxa',
+        async connect() {
+            calls.push('connect');
+        },
+        async disconnectTransport() {
+            calls.push('disconnectTransport');
+        },
+        async claimAgentTab() {
+            calls.push('claimAgentTab');
+            return 'w1 t1';
+        },
+        async probeIdentity() {
+            calls.push('probeIdentity');
+            return 'Inbox - johnny@example.com - Gmail';
+        },
+        async gotoTab(_tab, url) {
+            calls.push(`goto:${url}`);
+            return url;
+        },
+        async readTab() {
+            calls.push('read');
+            return 'text';
+        },
+        ...overrides,
+    };
+    return { backend, calls };
+}
+let leaseFile;
+(0, vitest_1.beforeEach)(() => {
+    leaseFile = (0, node_path_1.join)((0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'attach-ctl-')), 'attach.lease');
+});
+function controller(backend, extra = {}) {
+    return new AttachController_js_1.AttachController({
+        backend,
+        leaseFile,
+        expectedIdentity: 'johnny@example.com',
+        ...extra,
+    });
+}
+(0, vitest_1.describe)('AttachController', () => {
+    (0, vitest_1.it)('claims: lease → connect → identity probe → agent tab', async () => {
+        const { backend, calls } = makeBackend();
+        const c = controller(backend);
+        const st = await c.claim();
+        (0, vitest_1.expect)(st.state).toBe('ready');
+        (0, vitest_1.expect)(st.leaseHeld).toBe(true);
+        (0, vitest_1.expect)(st.agentTab).toBe('w1 t1');
+        (0, vitest_1.expect)(calls).toEqual(['connect', 'probeIdentity', 'claimAgentTab']);
+        await c.detach();
+    });
+    (0, vitest_1.it)('ABORTS with PROFILE_MISMATCH instead of proceeding on wrong identity (never launches)', async () => {
+        const { backend, calls } = makeBackend({
+            async probeIdentity() {
+                calls.push('probeIdentity');
+                return 'someone-else@example.com session';
+            },
+        });
+        const { backend: b2, calls: c2 } = { backend, calls };
+        const c = controller(b2);
+        await (0, vitest_1.expect)(c.claim()).rejects.toMatchObject({ code: 'PROFILE_MISMATCH' });
+        (0, vitest_1.expect)(c2).not.toContain('claimAgentTab'); // no tab was touched
+        (0, vitest_1.expect)(c.status().leaseHeld).toBe(false); // lease released on failure
+    });
+    (0, vitest_1.it)('policy-blocks bad navigation before touching the backend', async () => {
+        const { backend, calls } = makeBackend();
+        const c = controller(backend);
+        await c.claim();
+        await (0, vitest_1.expect)(c.goto('file:///etc/passwd')).rejects.toMatchObject({ code: 'POLICY_BLOCKED' });
+        (0, vitest_1.expect)(calls.filter((x) => x.startsWith('goto:'))).toHaveLength(0);
+        await c.detach();
+    });
+    (0, vitest_1.it)('revalidates redirects: an https→http downgrade fails the op', async () => {
+        const { backend } = makeBackend({
+            async gotoTab() {
+                return 'http://downgraded.example.com/';
+            },
+        });
+        const c = controller(backend);
+        await c.claim();
+        await (0, vitest_1.expect)(c.goto('https://ok.example.com/')).rejects.toMatchObject({ code: 'POLICY_BLOCKED' });
+        await c.detach();
+    });
+    (0, vitest_1.it)('detach closes ONLY the transport and releases the lease — no close surface exists', async () => {
+        const { backend, calls } = makeBackend();
+        const c = controller(backend);
+        await c.claim();
+        await c.detach();
+        (0, vitest_1.expect)(calls).toContain('disconnectTransport');
+        // Structural F10 guarantee: the backend contract exposes no browser/tab
+        // close method for the controller to call.
+        const forbidden = ['close', 'closeBrowser', 'closeTab', 'quit'];
+        for (const name of forbidden) {
+            (0, vitest_1.expect)(backend[name]).toBeUndefined();
+        }
+        // Lease is released → a second controller can claim.
+        const c2 = controller(makeBackend().backend);
+        await (0, vitest_1.expect)(c2.claim()).resolves.toMatchObject({ state: 'ready' });
+        await c2.detach();
+    });
+    (0, vitest_1.it)('second concurrent claim is LEASE_DENIED while the first holds', async () => {
+        const { backend } = makeBackend();
+        const c1 = controller(backend);
+        await c1.claim();
+        const c2 = controller(makeBackend().backend);
+        await (0, vitest_1.expect)(c2.claim()).rejects.toMatchObject({ code: 'LEASE_DENIED' });
+        await c1.detach();
+    });
+    (0, vitest_1.it)('a failed navigation lands in failed state and refuses further ops (no silent replay)', async () => {
+        const { backend } = makeBackend({
+            async gotoTab() {
+                throw new Error('tab 999 not found in window 1');
+            },
+        });
+        const c = controller(backend);
+        await c.claim();
+        await (0, vitest_1.expect)(c.goto('https://ok.example.com/')).rejects.toBeTruthy();
+        (0, vitest_1.expect)(c.status().state).toBe('failed');
+        (0, vitest_1.expect)(c.status().lastError?.code).toBe('TAB_CLOSED');
+        await (0, vitest_1.expect)(c.read()).rejects.toMatchObject({ code: 'UNKNOWN' });
+        await c.detach();
+        (0, vitest_1.expect)(c.status().state).toBe('disconnected');
+    });
+    (0, vitest_1.it)('HITL approver can deny a policy-clean navigation', async () => {
+        const { backend, calls } = makeBackend();
+        const c = controller(backend, { onNavigate: (url) => !url.includes('secret') });
+        await c.claim();
+        await (0, vitest_1.expect)(c.goto('https://ok.example.com/secret')).rejects.toMatchObject({ code: 'POLICY_BLOCKED' });
+        (0, vitest_1.expect)(calls.filter((x) => x.startsWith('goto:'))).toHaveLength(0); // never reached the backend
+        await (0, vitest_1.expect)(c.goto('https://ok.example.com/public')).resolves.toContain('public');
+        await c.detach();
+    });
+    (0, vitest_1.it)('dry-run reports the target without touching the backend, and counts navigations', async () => {
+        const { backend, calls } = makeBackend();
+        const c = controller(backend, { dryRun: true });
+        await c.claim();
+        (0, vitest_1.expect)(await c.goto('https://ok.example.com/')).toBe('https://ok.example.com/');
+        (0, vitest_1.expect)(await c.read()).toContain('dry-run');
+        (0, vitest_1.expect)(calls.filter((x) => x.startsWith('goto:'))).toHaveLength(0);
+        (0, vitest_1.expect)(c.status().dryRun).toBe(true);
+        (0, vitest_1.expect)(c.status().navigations).toBe(1);
+        (0, vitest_1.expect)(c.status().lastUrl).toBe('https://ok.example.com/');
+        await c.detach();
+    });
+    (0, vitest_1.it)('pause refuses operations until resume', async () => {
+        const { backend } = makeBackend();
+        const c = controller(backend);
+        await c.claim();
+        c.pause();
+        (0, vitest_1.expect)(c.status().paused).toBe(true);
+        await (0, vitest_1.expect)(c.goto('https://ok.example.com/')).rejects.toThrow(/paused/i);
+        c.resume();
+        await (0, vitest_1.expect)(c.goto('https://ok.example.com/')).resolves.toContain('ok.example.com');
+        await c.detach();
+    });
+    (0, vitest_1.it)('status tracks navigation count and last url on real ops', async () => {
+        const { backend } = makeBackend();
+        const c = controller(backend);
+        await c.claim();
+        await c.goto('https://a.example.com/');
+        await c.goto('https://b.example.com/');
+        (0, vitest_1.expect)(c.status().navigations).toBe(2);
+        (0, vitest_1.expect)(c.status().lastUrl).toBe('https://b.example.com/');
+        await c.detach();
+    });
+    (0, vitest_1.it)('ops enforce the lease nonce at call time (foreign takeover is detected)', async () => {
+        let t = 1000000;
+        const { backend } = makeBackend();
+        const c = controller(backend, { deadlineMs: 500 });
+        await c.claim();
+        // Simulate a foreign session force-taking the lease file.
+        const { acquireLease } = await Promise.resolve().then(() => __importStar(require('../lease.js')));
+        acquireLease({ file: leaseFile, isPidAlive: () => false, now: () => (t += 1) });
+        await (0, vitest_1.expect)(c.goto('https://ok.example.com/')).rejects.toMatchObject({ code: 'LEASE_DENIED' });
+    });
+});
+(0, vitest_1.describe)('extract and evaluate', () => {
+    (0, vitest_1.it)('extract maps {name: selector} to text lists via a FIXED expression (selectors are data)', async () => {
+        const exprs = [];
+        const { backend } = makeBackend({
+            async evalInTab(_tab, expression) {
+                exprs.push(expression);
+                return { perks: ['Late checkout', 'Breakfast for two'] };
+            },
+        });
+        const c = controller(backend);
+        await c.claim();
+        const out = await c.extract({ perks: "[class*='perk'] li" });
+        (0, vitest_1.expect)(out).toEqual({ perks: ['Late checkout', 'Breakfast for two'] });
+        (0, vitest_1.expect)(exprs[0]).toContain('querySelectorAll');
+        (0, vitest_1.expect)(exprs[0]).toContain('perk');
+    });
+    (0, vitest_1.it)('extract without fields requests the default page summary expression', async () => {
+        const exprs = [];
+        const { backend } = makeBackend({
+            async evalInTab(_tab, expression) {
+                exprs.push(expression);
+                return { url: 'https://x/', links: [] };
+            },
+        });
+        const c = controller(backend);
+        await c.claim();
+        await c.extract();
+        (0, vitest_1.expect)(exprs[0]).toContain('location.href');
+        (0, vitest_1.expect)(exprs[0]).toContain('document.title');
+    });
+    (0, vitest_1.it)('extract and evaluate surface UNSUPPORTED_OP when the backend lacks evalInTab', async () => {
+        const { backend } = makeBackend();
+        const c = controller(backend);
+        await c.claim();
+        await (0, vitest_1.expect)(c.extract()).rejects.toMatchObject({ code: 'UNSUPPORTED_OP' });
+        await (0, vitest_1.expect)(c.evaluate('1+1')).rejects.toMatchObject({ code: 'UNSUPPORTED_OP' });
+    });
+    (0, vitest_1.it)('evaluate passes the expression through (user lane; no tool exposes it)', async () => {
+        const { backend } = makeBackend({
+            async evalInTab(_tab, expression) {
+                return expression === '1+1' ? 2 : undefined;
+            },
+        });
+        const c = controller(backend);
+        await c.claim();
+        await (0, vitest_1.expect)(c.evaluate('1+1')).resolves.toBe(2);
+    });
+    (0, vitest_1.it)('both refuse before claim like every other driving op', async () => {
+        const { backend } = makeBackend({ async evalInTab() { return 1; } });
+        const c = controller(backend);
+        await (0, vitest_1.expect)(c.extract()).rejects.toMatchObject({ code: 'UNKNOWN' });
+        await (0, vitest_1.expect)(c.evaluate('1')).rejects.toMatchObject({ code: 'UNKNOWN' });
+    });
+});
+//# sourceMappingURL=AttachController.test.js.map

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

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

package/dist/attach/__tests__/attach-primitives.test.d.ts

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

package/dist/attach/__tests__/attach-primitives.test.d.ts.map

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

package/dist/attach/__tests__/attach-primitives.test.js

@@ -0,0 +1,158 @@
+"use strict";
+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 devtools_port_js_1 = require("../devtools-port.js");
+const singleton_lock_js_1 = require("../singleton-lock.js");
+const url_policy_js_1 = require("../url-policy.js");
+const errors_js_1 = require("../errors.js");
+const state_js_1 = require("../state.js");
+const lease_js_1 = require("../lease.js");
+(0, vitest_1.describe)('parseDevToolsActivePort', () => {
+    (0, vitest_1.it)('parses a well-formed file', () => {
+        const r = (0, devtools_port_js_1.parseDevToolsActivePort)('9222\n/devtools/browser/07797f92-4fc3-432a-91dd-0e982e1a3bc0\n');
+        (0, vitest_1.expect)(r.port).toBe(9222);
+        (0, vitest_1.expect)(r.wsUrl).toBe('ws://localhost:9222/devtools/browser/07797f92-4fc3-432a-91dd-0e982e1a3bc0');
+    });
+    (0, vitest_1.it)('builds ws URLs on localhost, never 127.0.0.1 (Chrome DNS-rebinding guard 403s the IP form)', () => {
+        const r = (0, devtools_port_js_1.parseDevToolsActivePort)('9222\n/devtools/browser/abc-def\n');
+        (0, vitest_1.expect)(r.wsUrl).toBe('ws://localhost:9222/devtools/browser/abc-def');
+        (0, vitest_1.expect)(r.wsUrl).not.toContain('127.0.0.1');
+    });
+    (0, vitest_1.it)('rejects a single-line file', () => {
+        (0, vitest_1.expect)(() => (0, devtools_port_js_1.parseDevToolsActivePort)('9222\n')).toThrow(/malformed/i);
+    });
+    (0, vitest_1.it)('rejects a non-numeric port', () => {
+        (0, vitest_1.expect)(() => (0, devtools_port_js_1.parseDevToolsActivePort)('nope\n/devtools/browser/x\n')).toThrow(/invalid port/i);
+    });
+    (0, vitest_1.it)('rejects a non-browser-target ws path', () => {
+        (0, vitest_1.expect)(() => (0, devtools_port_js_1.parseDevToolsActivePort)('9222\n/devtools/page/abc\n')).toThrow(/unexpected ws path/i);
+    });
+});
+(0, vitest_1.describe)('pidFromSingletonLock', () => {
+    (0, vitest_1.it)('extracts the pid', () => {
+        (0, vitest_1.expect)((0, singleton_lock_js_1.pidFromSingletonLock)('MacBook-Air.local-666')).toBe(666);
+    });
+    (0, vitest_1.it)('handles hostnames containing dashes', () => {
+        (0, vitest_1.expect)((0, singleton_lock_js_1.pidFromSingletonLock)('my-host-name.local-12345')).toBe(12345);
+    });
+    (0, vitest_1.it)('rejects a target without a pid suffix', () => {
+        (0, vitest_1.expect)(() => (0, singleton_lock_js_1.pidFromSingletonLock)('just-a-hostname.local')).toThrow(/malformed/i);
+    });
+});
+(0, vitest_1.describe)('url-policy', () => {
+    (0, vitest_1.it)('allows https and about:blank', () => {
+        (0, vitest_1.expect)((0, url_policy_js_1.isNavigationAllowed)('https://founderscard.com/home').allowed).toBe(true);
+        (0, vitest_1.expect)((0, url_policy_js_1.isNavigationAllowed)('about:blank').allowed).toBe(true);
+    });
+    vitest_1.it.each([
+        ['file:///etc/passwd', 'SCHEME_BLOCKED'],
+        ['javascript:alert(1)', 'SCHEME_BLOCKED'],
+        ['data:text/html,<b>x</b>', 'SCHEME_BLOCKED'],
+        ['devtools://devtools/bundled/inspector.html', 'SCHEME_BLOCKED'],
+        ['chrome://settings', 'SCHEME_BLOCKED'],
+        ['http://example.com', 'SCHEME_BLOCKED'],
+        ['https://user:pass@example.com/x', 'CREDENTIALS_IN_URL'],
+        ['https://localhost/admin', 'PRIVATE_HOST'],
+        ['https://127.0.0.1:8080/', 'PRIVATE_HOST'],
+        ['https://192.168.1.10/router', 'PRIVATE_HOST'],
+        ['https://10.1.2.3/internal', 'PRIVATE_HOST'],
+        ['https://172.16.0.1/', 'PRIVATE_HOST'],
+        ['https://printer.local/', 'PRIVATE_HOST'],
+        ['not a url', 'MALFORMED_URL'],
+    ])('rejects %s with %s', (url, reason) => {
+        const r = (0, url_policy_js_1.isNavigationAllowed)(url);
+        (0, vitest_1.expect)(r.allowed).toBe(false);
+        (0, vitest_1.expect)(r.reason).toBe(reason);
+    });
+    (0, vitest_1.it)('enforces the host allowlist including subdomains', () => {
+        const opts = { allowHosts: ['founderscard.com', 'hotels.com'] };
+        (0, vitest_1.expect)((0, url_policy_js_1.isNavigationAllowed)('https://founderscard.com/x', opts).allowed).toBe(true);
+        (0, vitest_1.expect)((0, url_policy_js_1.isNavigationAllowed)('https://www.hotels.com/', opts).allowed).toBe(true);
+        (0, vitest_1.expect)((0, url_policy_js_1.isNavigationAllowed)('https://evil.com/', opts).reason).toBe('HOST_NOT_ALLOWLISTED');
+    });
+    (0, vitest_1.it)('revalidates redirects with the same policy', () => {
+        (0, vitest_1.expect)((0, url_policy_js_1.revalidateRedirect)('https://ok.com/landing').allowed).toBe(true);
+        (0, vitest_1.expect)((0, url_policy_js_1.revalidateRedirect)('http://downgraded.com/').reason).toBe('SCHEME_BLOCKED');
+    });
+});
+(0, vitest_1.describe)('errors', () => {
+    (0, vitest_1.it)('redacts credential-class substrings', () => {
+        const out = (0, errors_js_1.redactDiagnostic)('failed with token=abc123 and api_key: xyz987 at https://x.com?access_token=zz9secret');
+        (0, vitest_1.expect)(out).not.toContain('abc123');
+        (0, vitest_1.expect)(out).not.toContain('xyz987');
+        (0, vitest_1.expect)(out).not.toContain('zz9secret');
+    });
+    (0, vitest_1.it)('keeps explicit AttachError codes', () => {
+        (0, vitest_1.expect)((0, errors_js_1.toStructuredError)(new errors_js_1.AttachError('LEASE_DENIED', 'nope')).code).toBe('LEASE_DENIED');
+    });
+    (0, vitest_1.it)('classifies known failure shapes', () => {
+        (0, vitest_1.expect)((0, errors_js_1.toStructuredError)(new Error('Executing JavaScript through AppleScript is turned off')).code).toBe('JS_DISABLED');
+        (0, vitest_1.expect)((0, errors_js_1.toStructuredError)(new Error('browserType.connectOverCDP: Timeout 12000ms exceeded')).code).toBe('CDP_TIMEOUT');
+        (0, vitest_1.expect)((0, errors_js_1.toStructuredError)(new Error('tab 999 not found in window 1')).code).toBe('TAB_CLOSED');
+    });
+    (0, vitest_1.it)('defaults to UNKNOWN', () => {
+        (0, vitest_1.expect)((0, errors_js_1.toStructuredError)(new Error('weird')).code).toBe('UNKNOWN');
+    });
+});
+(0, vitest_1.describe)('AttachStateMachine', () => {
+    (0, vitest_1.it)('walks the happy path', () => {
+        const m = new state_js_1.AttachStateMachine();
+        m.to('connecting');
+        m.to('ready');
+        m.to('navigating');
+        m.to('ready');
+        (0, vitest_1.expect)(m.state).toBe('ready');
+    });
+    (0, vitest_1.it)('rejects illegal transitions', () => {
+        const m = new state_js_1.AttachStateMachine();
+        (0, vitest_1.expect)(() => m.to('navigating')).toThrow(/illegal/i);
+    });
+    (0, vitest_1.it)('failed only resets through disconnected (no silent replay)', () => {
+        const m = new state_js_1.AttachStateMachine();
+        m.to('connecting');
+        m.to('ready');
+        m.to('navigating');
+        m.to('failed');
+        (0, vitest_1.expect)(() => m.to('navigating')).toThrow(/illegal/i);
+        m.to('disconnected');
+        (0, vitest_1.expect)(m.state).toBe('disconnected');
+    });
+    (0, vitest_1.it)('withDeadline rejects with NAV_TIMEOUT after expiry', async () => {
+        await (0, vitest_1.expect)((0, state_js_1.withDeadline)(new Promise(() => { }), 20, 'goto')).rejects.toMatchObject({ code: 'NAV_TIMEOUT' });
+    });
+});
+(0, vitest_1.describe)('lease', () => {
+    const dir = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'attach-lease-'));
+    const file = (0, node_path_1.join)(dir, 'attach.lease');
+    (0, vitest_1.it)('acquires, requires, and releases', () => {
+        const lease = (0, lease_js_1.acquireLease)({ file, isPidAlive: () => true });
+        (0, vitest_1.expect)((0, lease_js_1.requireLease)(file, lease.nonce).pid).toBe(process.pid);
+        (0, lease_js_1.releaseLease)(file, lease.nonce);
+        (0, vitest_1.expect)(() => (0, lease_js_1.requireLease)(file, lease.nonce)).toThrow(/nonce/i);
+    });
+    (0, vitest_1.it)('denies while a live lease exists, allows after the holder dies', () => {
+        const lease = (0, lease_js_1.acquireLease)({ file, isPidAlive: () => true });
+        (0, vitest_1.expect)(() => (0, lease_js_1.acquireLease)({ file, isPidAlive: () => true })).toThrow(/lease held/i);
+        const takenOver = (0, lease_js_1.acquireLease)({ file, isPidAlive: () => false });
+        (0, vitest_1.expect)(takenOver.nonce).not.toBe(lease.nonce);
+        (0, lease_js_1.releaseLease)(file, takenOver.nonce);
+    });
+    (0, vitest_1.it)('allows reclaim after TTL expiry even if the holder is alive', () => {
+        let t = 1000000;
+        const now = () => t;
+        (0, lease_js_1.acquireLease)({ file, ttlMs: 100, now, isPidAlive: () => true });
+        t += 101;
+        const second = (0, lease_js_1.acquireLease)({ file, ttlMs: 100, now, isPidAlive: () => true });
+        (0, vitest_1.expect)(second.acquiredAt).toBe(t);
+        (0, lease_js_1.releaseLease)(file, second.nonce);
+    });
+    (0, vitest_1.it)('refuses to release with a foreign nonce', () => {
+        const lease = (0, lease_js_1.acquireLease)({ file, isPidAlive: () => true });
+        (0, vitest_1.expect)(() => (0, lease_js_1.releaseLease)(file, 'not-the-nonce')).toThrow(/another session/i);
+        (0, lease_js_1.releaseLease)(file, lease.nonce);
+    });
+});
+//# sourceMappingURL=attach-primitives.test.js.map

package/dist/attach/__tests__/attach-primitives.test.js.map

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

package/dist/attach/__tests__/jxa-args.test.d.ts

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

package/dist/attach/__tests__/jxa-args.test.d.ts.map

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

package/dist/attach/__tests__/jxa-args.test.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const jxa_js_1 = require("../backends/jxa.js");
+(0, vitest_1.describe)('buildJxaArgs', () => {
+    (0, vitest_1.it)('builds exact argv with profileRoot first, then cmd and args (no shell interpolation)', () => {
+        (0, vitest_1.expect)((0, jxa_js_1.buildJxaArgs)('/tmp/driver.js', '/Users/x/Chrome', 'goto', ['1', '2', 'https://a.com/?q=1&r=2'])).toEqual([
+            '-l',
+            'JavaScript',
+            '/tmp/driver.js',
+            '/Users/x/Chrome',
+            'goto',
+            '1',
+            '2',
+            'https://a.com/?q=1&r=2',
+        ]);
+    });
+});
+(0, vitest_1.describe)('JXA driver source', () => {
+    (0, vitest_1.it)('addresses Chrome by PID from SingletonLock, never by bundle name', () => {
+        (0, vitest_1.expect)(jxa_js_1.JXA_DRIVER_SOURCE).toContain('SingletonLock');
+        (0, vitest_1.expect)(jxa_js_1.JXA_DRIVER_SOURCE).toContain('Application(chromePid(root))');
+        (0, vitest_1.expect)(jxa_js_1.JXA_DRIVER_SOURCE).not.toMatch(/Application\((['"])Google Chrome\1\)/);
+    });
+    (0, vitest_1.it)('marker-binds the claimed tab and exposes no close/quit commands', () => {
+        (0, vitest_1.expect)(jxa_js_1.JXA_DRIVER_SOURCE).toContain('__agentos_attach_tab_v1__');
+        (0, vitest_1.expect)(jxa_js_1.JXA_DRIVER_SOURCE).not.toMatch(/\.close\(\)|\bquit\b/);
+    });
+    (0, vitest_1.it)('supports only claim/goto/url/read (no arbitrary JS command)', () => {
+        for (const cmd of ['claim', 'goto', 'url', 'read']) {
+            (0, vitest_1.expect)(jxa_js_1.JXA_DRIVER_SOURCE).toContain(`'${cmd}'`);
+        }
+        (0, vitest_1.expect)(jxa_js_1.JXA_DRIVER_SOURCE).not.toContain("'eval'");
+        (0, vitest_1.expect)(jxa_js_1.JXA_DRIVER_SOURCE).not.toContain("'js'");
+    });
+});
+//# sourceMappingURL=jxa-args.test.js.map

package/dist/attach/__tests__/jxa-args.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jxa-args.test.js","sourceRoot":"","sources":["../../../src/attach/__tests__/jxa-args.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,+CAAqE;AAErE,IAAA,iBAAQ,EAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAA,WAAE,EAAC,sFAAsF,EAAE,GAAG,EAAE;QAC9F,IAAA,eAAM,EAAC,IAAA,qBAAY,EAAC,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9G,IAAI;YACJ,YAAY;YACZ,gBAAgB;YAChB,iBAAiB;YACjB,MAAM;YACN,GAAG;YACH,GAAG;YACH,wBAAwB;SACzB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAA,WAAE,EAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,IAAA,eAAM,EAAC,0BAAiB,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACrD,IAAA,eAAM,EAAC,0BAAiB,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACpE,IAAA,eAAM,EAAC,0BAAiB,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IACH,IAAA,WAAE,EAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,IAAA,eAAM,EAAC,0BAAiB,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;QACjE,IAAA,eAAM,EAAC,0BAAiB,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IACH,IAAA,WAAE,EAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;YACnD,IAAA,eAAM,EAAC,0BAAiB,CAAC,CAAC,SAAS,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;QAClD,CAAC;QACD,IAAA,eAAM,EAAC,0BAAiB,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAA,eAAM,EAAC,0BAAiB,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/attach/__tests__/pack-registration.test.d.ts

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

package/dist/attach/__tests__/pack-registration.test.d.ts.map

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

package/dist/attach/__tests__/pack-registration.test.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_js_1 = require("../../index.js");
+(0, vitest_1.describe)('browser-automation attach registration', () => {
+    (0, vitest_1.it)('does NOT register attach tools by default', () => {
+        const pack = (0, index_js_1.createExtensionPack)({ options: {} });
+        const ids = pack.descriptors.map((d) => d.id);
+        (0, vitest_1.expect)(ids).not.toContain('browser_attach_claim');
+        (0, vitest_1.expect)(ids).not.toContain('browser_attach_goto');
+    });
+    (0, vitest_1.it)('registers the attach tools (default-off descriptors) when opted in', () => {
+        const pack = (0, index_js_1.createExtensionPack)({ options: { attach: { expectedIdentity: 'johnny@example.com' } } });
+        const attach = pack.descriptors.filter((d) => d.id.startsWith('browser_attach_'));
+        (0, vitest_1.expect)(attach.map((d) => d.id).sort()).toEqual([
+            'browser_attach_claim',
+            'browser_attach_control',
+            'browser_attach_goto',
+            'browser_attach_read',
+            'browser_attach_release',
+            'browser_attach_status',
+        ]);
+        for (const d of attach)
+            (0, vitest_1.expect)(d.enableByDefault).toBe(false);
+    });
+    (0, vitest_1.it)('leaves the launch-mode tools intact in both modes', () => {
+        for (const options of [{}, { attach: { expectedIdentity: 'x@y.com' } }]) {
+            const ids = (0, index_js_1.createExtensionPack)({ options }).descriptors.map((d) => d.id);
+            (0, vitest_1.expect)(ids).toContain('browserNavigate');
+            (0, vitest_1.expect)(ids).toContain('browserSession');
+        }
+    });
+});
+//# sourceMappingURL=pack-registration.test.js.map

package/dist/attach/__tests__/pack-registration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-registration.test.js","sourceRoot":"","sources":["../../../src/attach/__tests__/pack-registration.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,6CAAqD;AAErD,IAAA,iBAAQ,EAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,IAAA,WAAE,EAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,IAAI,GAAG,IAAA,8BAAmB,EAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAA,eAAM,EAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;QAClD,IAAA,eAAM,EAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,IAAI,GAAG,IAAA,8BAAmB,EAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,EAAE,EAAE,CAAC,CAAC;QACtG,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAClF,IAAA,eAAM,EAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC;YAC7C,sBAAsB;YACtB,wBAAwB;YACxB,qBAAqB;YACrB,qBAAqB;YACrB,wBAAwB;YACxB,uBAAuB;SACxB,CAAC,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,MAAM;YAAE,IAAA,eAAM,EAAC,CAAC,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,KAAK,MAAM,OAAO,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,gBAAgB,EAAE,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC;YACxE,MAAM,GAAG,GAAG,IAAA,8BAAmB,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1E,IAAA,eAAM,EAAC,GAAG,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YACzC,IAAA,eAAM,EAAC,GAAG,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/attach/__tests__/tools.test.d.ts

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

package/dist/attach/__tests__/tools.test.d.ts.map

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