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

package/dist/attach/daemon/index.js

@@ -1,30 +1,12 @@
-"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.daemonMain = void 0;
 /**
  * @fileoverview Barrel for the attach daemon lane (`./attach/daemon` subpath).
  * @module browser-automation/attach/daemon
  */
-__exportStar(require("./protocol.js"), exports);
-__exportStar(require("./daemon-lock.js"), exports);
-__exportStar(require("./daemon.js"), exports);
-__exportStar(require("./client.js"), exports);
-__exportStar(require("./surface.js"), exports);
-__exportStar(require("./runner.js"), exports);
-var daemon_main_js_1 = require("./daemon-main.js");
-Object.defineProperty(exports, "daemonMain", { enumerable: true, get: function () { return daemon_main_js_1.main; } });
+export * from './protocol.js';
+export * from './daemon-lock.js';
+export * from './daemon.js';
+export * from './client.js';
+export * from './surface.js';
+export * from './runner.js';
+export { main as daemonMain } from './daemon-main.js';
 //# sourceMappingURL=index.js.map

package/dist/attach/daemon/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/attach/daemon/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA;;;GAGG;AACH,gDAA8B;AAC9B,mDAAiC;AACjC,8CAA4B;AAC5B,8CAA4B;AAC5B,+CAA6B;AAC7B,8CAA4B;AAC5B,mDAAsD;AAA7C,4GAAA,IAAI,OAAc"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/attach/daemon/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/attach/daemon/protocol.d.ts

@@ -1,5 +1,5 @@
 /** Daemon-routable operations. */
-export type AttachOp = 'ping' | 'status' | 'claim' | 'goto' | 'read' | 'extract' | 'eval' | 'release' | 'control' | 'quit';
+export type AttachOp = 'ping' | 'status' | 'claim' | 'goto' | 'read' | 'extract' | 'eval' | 'screenshot' | 'release' | 'control' | 'quit';
 /** A command file body. */
 export interface AttachCmd {
     id: string;

package/dist/attach/daemon/protocol.d.ts.map

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

package/dist/attach/daemon/protocol.js

@@ -1,15 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HEARTBEAT_STALE_MS = exports.STALE_FILE_MS = exports.DEFAULT_PID_FILE = exports.DEFAULT_IPC_DIR = void 0;
-exports.resolveIpcDir = resolveIpcDir;
-exports.newCmdId = newCmdId;
-exports.cmdPath = cmdPath;
-exports.respPath = respPath;
-exports.statusPath = statusPath;
-exports.writeAtomicJson = writeAtomicJson;
-exports.readJson = readJson;
-exports.listPendingCmds = listPendingCmds;
-exports.gcStale = gcStale;
 /**
  * @fileoverview File-queue IPC protocol for the attach daemon.
  *
@@ -25,64 +13,64 @@ exports.gcStale = gcStale;
  *
  * @module browser-automation/attach/daemon/protocol
  */
-const node_fs_1 = require("node:fs");
-const node_os_1 = require("node:os");
-const node_path_1 = require("node:path");
-const node_crypto_1 = require("node:crypto");
+import { readFileSync, writeFileSync, renameSync, readdirSync, statSync, unlinkSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
 /** Default IPC directory (created 0700). */
-exports.DEFAULT_IPC_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), '.wunderland', 'attach', 'ipc');
+export const DEFAULT_IPC_DIR = join(homedir(), '.wunderland', 'attach', 'ipc');
 /** Default daemon pidfile. */
-exports.DEFAULT_PID_FILE = (0, node_path_1.join)((0, node_os_1.homedir)(), '.wunderland', 'attach', 'daemon.pid');
+export const DEFAULT_PID_FILE = join(homedir(), '.wunderland', 'attach', 'daemon.pid');
 /** cmd/resp files older than this are garbage-collected. */
-exports.STALE_FILE_MS = 10 * 60000;
+export const STALE_FILE_MS = 10 * 60_000;
 /** status.json heartbeats older than this mark the daemon stale. */
-exports.HEARTBEAT_STALE_MS = 30000;
+export const HEARTBEAT_STALE_MS = 30_000;
 /** Resolve the IPC dir from an explicit override or env, ensuring it exists 0700. */
-function resolveIpcDir(override, env = process.env) {
-    const dir = override?.trim() || env.WUNDERLAND_ATTACH_IPC_DIR?.trim() || exports.DEFAULT_IPC_DIR;
-    (0, node_fs_1.mkdirSync)(dir, { recursive: true, mode: 0o700 });
+export function resolveIpcDir(override, env = process.env) {
+    const dir = override?.trim() || env.WUNDERLAND_ATTACH_IPC_DIR?.trim() || DEFAULT_IPC_DIR;
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
     return dir;
 }
 /** New string command id: `<client>-<epochMs>-<random8>`. */
-function newCmdId(client) {
-    return `${client}-${Date.now()}-${(0, node_crypto_1.randomUUID)().slice(0, 8)}`;
+export function newCmdId(client) {
+    return `${client}-${Date.now()}-${randomUUID().slice(0, 8)}`;
 }
 /** Path of a command file. */
-function cmdPath(dir, id) {
-    return (0, node_path_1.join)(dir, `cmd-${id}.json`);
+export function cmdPath(dir, id) {
+    return join(dir, `cmd-${id}.json`);
 }
 /** Path of a response file. */
-function respPath(dir, id) {
-    return (0, node_path_1.join)(dir, `resp-${id}.json`);
+export function respPath(dir, id) {
+    return join(dir, `resp-${id}.json`);
 }
 /** Path of the daemon heartbeat file. */
-function statusPath(dir) {
-    return (0, node_path_1.join)(dir, 'status.json');
+export function statusPath(dir) {
+    return join(dir, 'status.json');
 }
 /** Write JSON via tmp-then-rename so readers never see a torn body. */
-function writeAtomicJson(file, value) {
+export function writeAtomicJson(file, value) {
     const tmp = `${file}.${process.pid}.tmp`;
-    (0, node_fs_1.writeFileSync)(tmp, JSON.stringify(value), { mode: 0o600 });
-    (0, node_fs_1.renameSync)(tmp, file);
+    writeFileSync(tmp, JSON.stringify(value), { mode: 0o600 });
+    renameSync(tmp, file);
 }
 /** Read+parse JSON; undefined when missing or torn. */
-function readJson(file) {
+export function readJson(file) {
     try {
-        return JSON.parse((0, node_fs_1.readFileSync)(file, 'utf8'));
+        return JSON.parse(readFileSync(file, 'utf8'));
     }
     catch {
         return undefined;
     }
 }
 /** Pending command files, oldest first (mtime, then name for determinism). */
-function listPendingCmds(dir) {
+export function listPendingCmds(dir) {
     const out = [];
-    for (const name of (0, node_fs_1.readdirSync)(dir)) {
+    for (const name of readdirSync(dir)) {
         if (!name.startsWith('cmd-') || !name.endsWith('.json'))
             continue;
-        const path = (0, node_path_1.join)(dir, name);
+        const path = join(dir, name);
         try {
-            out.push({ id: name.slice(4, -5), path, mtimeMs: (0, node_fs_1.statSync)(path).mtimeMs });
+            out.push({ id: name.slice(4, -5), path, mtimeMs: statSync(path).mtimeMs });
         }
         catch {
             /* raced with GC or the consumer */
@@ -91,14 +79,14 @@ function listPendingCmds(dir) {
     return out.sort((a, b) => a.mtimeMs - b.mtimeMs || (a.id < b.id ? -1 : 1));
 }
 /** Delete cmd/resp files older than {@link STALE_FILE_MS} (pass `now` = Infinity to sweep all). */
-function gcStale(dir, now = Date.now()) {
-    for (const name of (0, node_fs_1.readdirSync)(dir)) {
+export function gcStale(dir, now = Date.now()) {
+    for (const name of readdirSync(dir)) {
         if (!/^(cmd|resp)-.*\.json$/.test(name))
             continue;
-        const path = (0, node_path_1.join)(dir, name);
+        const path = join(dir, name);
         try {
-            if (now - (0, node_fs_1.statSync)(path).mtimeMs > exports.STALE_FILE_MS)
-                (0, node_fs_1.unlinkSync)(path);
+            if (now - statSync(path).mtimeMs > STALE_FILE_MS)
+                unlinkSync(path);
         }
         catch {
             /* raced with the consumer */

package/dist/attach/daemon/protocol.js.map

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

package/dist/attach/daemon/runner.js

@@ -1,13 +1,10 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runAttachScript = runAttachScript;
 const ALLOWED = new Set(['goto', 'read', 'extract', 'wait']);
 /**
  * Execute `plan` against a live daemon via `client`. Validates the op
  * whitelist up front (an eval step is a hard error, not a skipped step),
  * aborts on the first failing step, and always releases the claim.
  */
-async function runAttachScript(plan, client) {
+export async function runAttachScript(plan, client) {
     if (!plan || !Array.isArray(plan.steps))
         throw new Error('attach run plan needs a steps array');
     for (const [i, s] of plan.steps.entries()) {

package/dist/attach/daemon/runner.js.map

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

package/dist/attach/daemon/surface.d.ts

@@ -21,6 +21,11 @@ export declare class DaemonAttachSurface implements AttachSurface {
     goto(url: string): Promise<string>;
     /** Read visible text from the agent tab. */
     read(selector?: string, maxChars?: number): Promise<string>;
+    /** Capture a PNG of the agent tab to `path` (CDP transport behind the daemon). */
+    screenshot(path: string, fullPage?: boolean): Promise<{
+        path: string;
+        bytes: number;
+    }>;
     /** Give up driving rights; the daemon keeps its held session. */
     detach(): Promise<void>;
     pause(): void;

package/dist/attach/daemon/surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../../src/attach/daemon/surface.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI5D,+CAA+C;AAC/C,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAID,wBAAwB;AACxB,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,kBAAkB,CAAS;gBAEvB,IAAI,GAAE,0BAA+B;IAKjD,wEAAwE;IACxE,MAAM,IAAI,OAAO;IAKjB,4EAA4E;IACtE,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAQ/B,4DAA4D;IACtD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIxC,4CAA4C;IACtC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjE,iEAAiE;IAC3D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7B,KAAK,IAAI,IAAI;IAMb,MAAM,IAAI,IAAI;IAMd,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI;YAMd,eAAe;CAmB9B"}
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../../src/attach/daemon/surface.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI5D,+CAA+C;AAC/C,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAID,wBAAwB;AACxB,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,kBAAkB,CAAS;gBAEvB,IAAI,GAAE,0BAA+B;IAKjD,wEAAwE;IACxE,MAAM,IAAI,OAAO;IAKjB,4EAA4E;IACtE,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAQ/B,4DAA4D;IACtD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIxC,4CAA4C;IACtC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjE,kFAAkF;IAC5E,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAI5F,iEAAiE;IAC3D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7B,KAAK,IAAI,IAAI;IAMb,MAAM,IAAI,IAAI;IAMd,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI;YAMd,eAAe;CAmB9B"}

package/dist/attach/daemon/surface.js

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DaemonAttachSurface = void 0;
 /**
  * @fileoverview Daemon-backed implementation of the tool-facing AttachSurface.
  *
@@ -12,17 +9,19 @@ exports.DaemonAttachSurface = void 0;
  *
  * @module browser-automation/attach/daemon/surface
  */
-const node_child_process_1 = require("node:child_process");
-const node_url_1 = require("node:url");
-const errors_js_1 = require("../errors.js");
-const client_js_1 = require("./client.js");
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { AttachError } from '../errors.js';
+import { AttachDaemonClient } from './client.js';
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 /** See fileoverview. */
-class DaemonAttachSurface {
+export class DaemonAttachSurface {
+    client;
+    opts;
+    autostartAttempted = false;
     constructor(opts = {}) {
-        this.autostartAttempted = false;
         this.opts = opts;
-        this.client = new client_js_1.AttachDaemonClient({ ipcDir: opts.ipcDir, client: 'agent-tools' });
+        this.client = new AttachDaemonClient({ ipcDir: opts.ipcDir, client: 'agent-tools' });
     }
     /** Synchronous snapshot from status.json (tools call status() sync). */
     status() {
@@ -45,6 +44,10 @@ class DaemonAttachSurface {
     async read(selector, maxChars) {
         return (await this.client.read({ selector, maxChars })).text;
     }
+    /** Capture a PNG of the agent tab to `path` (CDP transport behind the daemon). */
+    async screenshot(path, fullPage) {
+        return this.client.screenshot(path, fullPage);
+    }
     /** Give up driving rights; the daemon keeps its held session. */
     async detach() {
         await this.client.release();
@@ -67,8 +70,8 @@ class DaemonAttachSurface {
         });
     }
     async spawnDaemonOnce() {
-        const entry = (0, node_url_1.fileURLToPath)(new URL('./daemon-main.js', import.meta.url));
-        (0, node_child_process_1.spawn)(process.execPath, [entry], {
+        const entry = fileURLToPath(new URL('./daemon-main.js', import.meta.url));
+        spawn(process.execPath, [entry], {
             detached: true,
             stdio: 'ignore',
             env: { ...(this.opts.env ?? process.env) },
@@ -82,8 +85,7 @@ class DaemonAttachSurface {
             if (s?.state === 'failed')
                 break;
         }
-        throw new errors_js_1.AttachError('DAEMON_UNAVAILABLE', `autostart did not reach connected: ${this.client.statusFile()?.lastError ?? 'no status'}`);
+        throw new AttachError('DAEMON_UNAVAILABLE', `autostart did not reach connected: ${this.client.statusFile()?.lastError ?? 'no status'}`);
     }
 }
-exports.DaemonAttachSurface = DaemonAttachSurface;
 //# sourceMappingURL=surface.js.map

package/dist/attach/daemon/surface.js.map

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

package/dist/attach/devtools-port.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * @fileoverview Parser for Chrome's `DevToolsActivePort` discovery file.
  *
@@ -16,8 +15,6 @@
  *
  * @module browser-automation/attach/devtools-port
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseDevToolsActivePort = parseDevToolsActivePort;
 /**
  * Parse the raw text of a `DevToolsActivePort` file.
  *
@@ -27,7 +24,7 @@ exports.parseDevToolsActivePort = parseDevToolsActivePort;
  *   a non-numeric/out-of-range port, or a ws path that is not a
  *   `/devtools/browser/…` browser-target path.
  */
-function parseDevToolsActivePort(text) {
+export function parseDevToolsActivePort(text) {
     const lines = String(text)
         .split('\n')
         .map((l) => l.trim())

package/dist/attach/devtools-port.js.map

@@ -1 +1 @@
-{"version":3,"file":"devtools-port.js","sourceRoot":"","sources":["../../src/attach/devtools-port.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;AAqBH,0DAmBC;AA5BD;;;;;;;;GAQG;AACH,SAAgB,uBAAuB,CAAC,IAAY;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;SACvB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,+CAA+C,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,qDAAqD,MAAM,GAAG,CAAC,CAAC;IAClF,CAAC;IACD,0EAA0E;IAC1E,+DAA+D;IAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,IAAI,GAAG,MAAM,EAAE,EAAE,CAAC;AACpE,CAAC"}
+{"version":3,"file":"devtools-port.js","sourceRoot":"","sources":["../../src/attach/devtools-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;SACvB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,+CAA+C,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,qDAAqD,MAAM,GAAG,CAAC,CAAC;IAClF,CAAC;IACD,0EAA0E;IAC1E,+DAA+D;IAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,IAAI,GAAG,MAAM,EAAE,EAAE,CAAC;AACpE,CAAC"}

package/dist/attach/errors.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * @fileoverview Structured errors + diagnostic redaction for the attach lane.
  *
@@ -10,19 +9,15 @@
  *
  * @module browser-automation/attach/errors
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AttachError = void 0;
-exports.redactDiagnostic = redactDiagnostic;
-exports.toStructuredError = toStructuredError;
 /** Error subclass carrying a structured code through throw sites. */
-class AttachError extends Error {
+export class AttachError extends Error {
+    code;
     constructor(code, message) {
         super(message);
         this.name = 'AttachError';
         this.code = code;
     }
 }
-exports.AttachError = AttachError;
 const CREDENTIAL_PATTERNS = [
     [/(token|secret|password|passwd|apikey|api_key|auth|bearer|session|cookie)(["']?\s*[:=]\s*["']?)[^\s"'&;]+/gi, '$1$2[redacted]'],
     [/eyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{4,}/g, '[redacted-jwt]'],
@@ -35,7 +30,7 @@ const CREDENTIAL_PATTERNS = [
  * @param text Raw diagnostic text.
  * @returns The text with tokens/keys/secrets masked.
  */
-function redactDiagnostic(text) {
+export function redactDiagnostic(text) {
     let out = String(text ?? '');
     for (const [re, rep] of CREDENTIAL_PATTERNS)
         out = out.replace(re, rep);
@@ -58,7 +53,7 @@ const CODE_MATCHERS = [
  * message. An {@link AttachError} keeps its explicit code; everything else is
  * classified by message pattern, defaulting to `UNKNOWN`.
  */
-function toStructuredError(err) {
+export function toStructuredError(err) {
     if (err instanceof AttachError) {
         return { code: err.code, message: redactDiagnostic(err.message) };
     }

package/dist/attach/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/attach/errors.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAkDH,4CAIC;AAoBD,8CASC;AAxDD,qEAAqE;AACrE,MAAa,WAAY,SAAQ,KAAK;IAEpC,YAAY,IAAqB,EAAE,OAAe;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAPD,kCAOC;AAED,MAAM,mBAAmB,GAA4B;IACnD,CAAC,4GAA4G,EAAE,gBAAgB,CAAC;IAChI,CAAC,6DAA6D,EAAE,gBAAgB,CAAC;IACjF,CAAC,uCAAuC,EAAE,gBAAgB,CAAC;IAC3D,CAAC,kEAAkE,EAAE,mBAAmB,CAAC;CAC1F,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,IAAI,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7B,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,mBAAmB;QAAE,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACxE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,aAAa,GAAqC;IACtD,CAAC,+DAA+D,EAAE,aAAa,CAAC;IAChF,CAAC,wDAAwD,EAAE,iBAAiB,CAAC;IAC7E,CAAC,+CAA+C,EAAE,aAAa,CAAC;IAChE,CAAC,oDAAoD,EAAE,sBAAsB,CAAC;IAC9E,CAAC,kCAAkC,EAAE,kBAAkB,CAAC;IACxD,CAAC,qDAAqD,EAAE,YAAY,CAAC;IACrE,CAAC,sDAAsD,EAAE,aAAa,CAAC;IACvE,CAAC,6BAA6B,EAAE,gBAAgB,CAAC;IACjD,CAAC,QAAQ,EAAE,cAAc,CAAC;IAC1B,CAAC,4CAA4C,EAAE,iBAAiB,CAAC;CAClE,CAAC;AAEF;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,GAAY;IAC5C,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;IACpE,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,aAAa,EAAE,CAAC;QACvC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/attach/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA2BH,qEAAqE;AACrE,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAkB;IAC/B,YAAY,IAAqB,EAAE,OAAe;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,mBAAmB,GAA4B;IACnD,CAAC,4GAA4G,EAAE,gBAAgB,CAAC;IAChI,CAAC,6DAA6D,EAAE,gBAAgB,CAAC;IACjF,CAAC,uCAAuC,EAAE,gBAAgB,CAAC;IAC3D,CAAC,kEAAkE,EAAE,mBAAmB,CAAC;CAC1F,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7B,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,mBAAmB;QAAE,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACxE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,aAAa,GAAqC;IACtD,CAAC,+DAA+D,EAAE,aAAa,CAAC;IAChF,CAAC,wDAAwD,EAAE,iBAAiB,CAAC;IAC7E,CAAC,+CAA+C,EAAE,aAAa,CAAC;IAChE,CAAC,oDAAoD,EAAE,sBAAsB,CAAC;IAC9E,CAAC,kCAAkC,EAAE,kBAAkB,CAAC;IACxD,CAAC,qDAAqD,EAAE,YAAY,CAAC;IACrE,CAAC,sDAAsD,EAAE,aAAa,CAAC;IACvE,CAAC,6BAA6B,EAAE,gBAAgB,CAAC;IACjD,CAAC,QAAQ,EAAE,cAAc,CAAC;IAC1B,CAAC,4CAA4C,EAAE,iBAAiB,CAAC;CAClE,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;IACpE,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,aAAa,EAAE,CAAC;QACvC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;AAC7D,CAAC"}

package/dist/attach/evidence.d.ts

@@ -0,0 +1,64 @@
+/** The evidence directory when none is configured. */
+export declare const DEFAULT_EVIDENCE_DIR: string;
+/** A directory as it was checked: its path and its identity on the file system. */
+interface CheckedDirectory {
+    path: string;
+    dev: bigint;
+    ino: bigint;
+}
+/** A screenshot's file, prepared by {@link prepareEvidenceFile}. */
+export interface PreparedEvidence {
+    /** The file to create, inside the evidence directory's real path. */
+    target: string;
+    /** The evidence directory, then each directory in it on the way to the file, as checked. */
+    directories: readonly CheckedDirectory[];
+}
+/**
+ * The path a screenshot at `filePath` would be written to, for a dry run:
+ * the same reading of the path as {@link prepareEvidenceFile}, with nothing
+ * made on the disk. The evidence directory is named by its real path when it
+ * exists, as a written screenshot's path is.
+ *
+ * @param evidenceDir - The configured evidence directory, or `undefined` for the default.
+ * @param filePath - The path asked for, relative to the directory or absolute inside it.
+ * @throws POLICY_BLOCKED when the path names no file or leaves the directory.
+ */
+export declare function plannedEvidencePath(evidenceDir: string | undefined, filePath: string): Promise<string>;
+/**
+ * Prepares the file a screenshot is written to, before the page is captured.
+ * The evidence directory is made when missing (mode 0700) and read by its
+ * real path, so a link swapped in for it later moves nothing. Each directory
+ * from it to the file is made (mode 0700) or checked: a directory, not a
+ * link, private to this user, with no directory above the evidence directory
+ * that another user can change. A file already at the path is refused.
+ *
+ * @param evidenceDir - The configured evidence directory, or `undefined` for the default.
+ * @param filePath - The path asked for, relative to the directory or absolute inside it.
+ * @throws POLICY_BLOCKED for a path that names no file, leaves the directory,
+ *   passes through a link or a file, or names something that exists, and for
+ *   a directory that is not private to this user.
+ * @throws UNKNOWN when the directory cannot take a new file (its mode, or a
+ *   file system mounted read-only).
+ */
+export declare function prepareEvidenceFile(evidenceDir: string | undefined, filePath: string): Promise<PreparedEvidence>;
+/**
+ * Creates the prepared file and writes `bytes` to it.
+ *
+ * The directories are checked to be the ones prepared, the file is created
+ * with flag `wx` (it never replaces a file, and a link at its name is not
+ * followed), and with the file open the directories are checked again and the
+ * file is checked to be the one at its path, with no other name. Only then
+ * are the bytes written, through the handle. Node has no `openat`, so this is
+ * the order that keeps an image out of a directory swapped in while the page
+ * was captured: a file created in the wrong place stays empty.
+ *
+ * A write that fails leaves no partial image: the file is emptied through
+ * its handle, and removed when it is still the file at its path. A close
+ * that reports the write failed is an error of the call too, and the file is
+ * removed by the same rule.
+ *
+ * @throws POLICY_BLOCKED when a file is already there or a directory changed.
+ */
+export declare function writeEvidenceFile(prepared: PreparedEvidence, bytes: Buffer): Promise<void>;
+export {};
+//# sourceMappingURL=evidence.d.ts.map

package/dist/attach/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../src/attach/evidence.ts"],"names":[],"mappings":"AAiCA,sDAAsD;AACtD,eAAO,MAAM,oBAAoB,QAAoD,CAAC;AAEtF,mFAAmF;AACnF,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC1C;AA2GD;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK5G;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6BtH;AA6BD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhG"}