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

package/dist/attach/daemon/daemon-main.js

@@ -0,0 +1,99 @@
+/**
+ * @fileoverview Runnable attach-daemon entry: `node .../daemon-main.js`.
+ *
+ * Spawned by `wunderland attach start` (and by autostart, exactly once).
+ * Reads WUNDERLAND_ATTACH_* env, builds RawCdpBackend + AttachController +
+ * AttachDaemon, runs until quit/SIGTERM. This process is the ONLY one that
+ * touches the network; every caller talks to it through files.
+ *
+ * @module browser-automation/attach/daemon/daemon-main
+ */
+import { realpathSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { AttachController } from '../AttachController.js';
+import { RawCdpBackend } from '../backends/raw-cdp.js';
+import { AttachDaemon } from './daemon.js';
+import { resolveIpcDir, statusPath, writeAtomicJson, DEFAULT_PID_FILE } from './protocol.js';
+/**
+ * Build and run the daemon from an environment map. Returns the process exit
+ * code (0 clean stop, 2 failure). Exported for tests and for the CLI.
+ */
+export async function main(env = process.env) {
+    const ipcDir = resolveIpcDir(undefined, env);
+    const fail = (msg) => {
+        writeAtomicJson(statusPath(ipcDir), { t: Date.now(), pid: process.pid, state: 'failed', lastError: msg });
+        console.error(`attach daemon: ${msg}`);
+        return 2;
+    };
+    // Node 22 floor: the raw-CDP transport is the built-in WebSocket. Guarded so
+    // an older runtime gets an actionable message, never a bare ReferenceError.
+    if (typeof WebSocket === 'undefined') {
+        return fail('this runtime has no built-in WebSocket; the attach daemon requires Node 22 or newer');
+    }
+    const expectedIdentity = env.WUNDERLAND_ATTACH_IDENTITY?.trim();
+    if (!expectedIdentity) {
+        return fail('WUNDERLAND_ATTACH_IDENTITY is required (the profile identity the daemon must verify)');
+    }
+    const backend = new RawCdpBackend({
+        profileRoot: env.WUNDERLAND_ATTACH_PROFILE_ROOT?.trim() || undefined,
+        identityProbeUrl: env.WUNDERLAND_ATTACH_PROBE_URL?.trim() || undefined,
+        settleMs: 0, // settle is applied daemon-side per goto op (default 1800ms)
+    });
+    const allowHosts = env.WUNDERLAND_ATTACH_HOSTS?.split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const deadlineMs = Number(env.WUNDERLAND_ATTACH_DEADLINE_MS);
+    const controller = new AttachController({
+        backend,
+        // Mirrors the pack default in src/index.ts so CLI-started and pack-embedded
+        // sessions contend on the SAME lease file.
+        leaseFile: env.WUNDERLAND_ATTACH_LEASE?.trim() || join(homedir(), '.wunderland', 'attach.lease'),
+        expectedIdentity,
+        urlPolicy: allowHosts?.length ? { allowHosts } : undefined,
+        dryRun: env.WUNDERLAND_ATTACH_DRYRUN === '1' || env.WUNDERLAND_ATTACH_DRYRUN === 'true',
+        deadlineMs: Number.isFinite(deadlineMs) && deadlineMs > 0 ? deadlineMs : undefined,
+    });
+    const daemon = new AttachDaemon({
+        controller,
+        backend,
+        ipcDir,
+        pidFile: env.WUNDERLAND_ATTACH_PID_FILE?.trim() || DEFAULT_PID_FILE,
+        log: (line) => console.error(`[attach-daemon] ${line}`),
+    });
+    process.on('SIGTERM', () => daemon.requestStop('SIGTERM'));
+    process.on('SIGINT', () => daemon.requestStop('SIGINT'));
+    try {
+        await daemon.run();
+        return 0;
+    }
+    catch (err) {
+        return fail(err.message);
+    }
+}
+/**
+ * True when `moduleUrl` is the script Node was started with (`node <entryPath>`).
+ *
+ * Both sides resolve to a real path before the comparison: a file URL
+ * percent-encodes characters such as spaces, Node follows symlinks when it
+ * builds `import.meta.url` for the entry script but keeps them under
+ * `--preserve-symlinks-main`, and the entry path may be relative. A missing
+ * or unreadable entry path, or a module URL that is not a file, is not this
+ * module. Exported for tests.
+ */
+export function isEntryPoint(moduleUrl, entryPath) {
+    if (!entryPath)
+        return false;
+    try {
+        return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(entryPath);
+    }
+    catch {
+        return false;
+    }
+}
+// Invoked directly (not imported): run and exit with the returned code.
+if (isEntryPoint(import.meta.url, process.argv[1])) {
+    void main().then((code) => process.exit(code));
+}
+//# sourceMappingURL=daemon-main.js.map

package/dist/attach/daemon/daemon-main.js.map

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

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

@@ -0,0 +1,52 @@
+import type { AttachBackend, AttachController } from '../AttachController.js';
+/** Constructor options. */
+export interface AttachDaemonOptions {
+    controller: AttachController;
+    /** Same backend instance the controller wraps (boot connect + drop hook + identity cache). */
+    backend: AttachBackend & {
+        onUnexpectedClose?: ((err: Error) => void) | null;
+    };
+    ipcDir: string;
+    pidFile: string;
+    /** Loop tick ms (default 350). */
+    pollMs?: number;
+    /** Default claimant ttl ms (default 600000). */
+    claimTtlMs?: number;
+    log?: (line: string) => void;
+}
+/**
+ * See fileoverview. `run()` resolves after a `quit` op or {@link requestStop}.
+ * Never launches, quits, or signals Chrome under any failure.
+ */
+export declare class AttachDaemon {
+    private readonly controller;
+    private readonly backend;
+    private readonly ipcDir;
+    private readonly pidFile;
+    private readonly pollMs;
+    private readonly claimTtlMs;
+    private readonly log;
+    private lock;
+    private state;
+    private lastError?;
+    private identity?;
+    private claimant;
+    private controllerClaimed;
+    private stopRequested;
+    private reconnectAt;
+    private backoffMs;
+    private gcCountdown;
+    constructor(opts: AttachDaemonOptions);
+    /** External stop (signal handlers route here). */
+    requestStop(reason: string): void;
+    /** Acquire the singleton, open the transport, serve the queue until quit. */
+    run(): Promise<void>;
+    private setState;
+    private heartbeat;
+    private expireClaimant;
+    private maybeReconnect;
+    private requireClaimant;
+    private execute;
+    private shutdown;
+}
+//# sourceMappingURL=daemon.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../../src/attach/daemon/daemon.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAgB9E,2BAA2B;AAC3B,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,8FAA8F;IAC9F,OAAO,EAAE,aAAa,GAAG;QAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAQD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyB;IAE7C,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAqE;IACrF,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,WAAW,CAAkB;gBAEzB,IAAI,EAAE,mBAAmB;IAUrC,kDAAkD;IAClD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKjC,6EAA6E;IACvE,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAoD1B,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,eAAe;YAOT,OAAO;YAuFP,QAAQ;CAgBvB"}

package/dist/attach/daemon/daemon.js

@@ -0,0 +1,273 @@
+/**
+ * @fileoverview The attach daemon: one process, one controller, one held session.
+ *
+ * Owns the file-queue loop. Consumes `cmd-*.json` oldest-first, executes ops
+ * SERIALLY against the hosted {@link AttachController} (the single policy
+ * enforcement point), writes `resp-<id>.json`, and heartbeats `status.json`
+ * every tick. Command files are deleted BEFORE execution (at-most-once: a
+ * crash mid-op must never replay a navigation on restart). Responses are
+ * deleted by their reader; strays age out via the periodic GC — shutdown does
+ * not bulk-sweep, because that would race a client still polling for the quit
+ * response.
+ *
+ * Two-layer claim model: the controller's lease belongs to this process for
+ * the daemon's lifetime; per-caller driving rights are daemon-level
+ * bookkeeping (`claimant`). `release` parks the tab and clears the claimant;
+ * only `quit` detaches the controller.
+ *
+ * @module browser-automation/attach/daemon/daemon
+ */
+import { unlinkSync } from 'node:fs';
+import { AttachError, redactDiagnostic, toStructuredError } from '../errors.js';
+import { acquireDaemonLock } from './daemon-lock.js';
+import { resolveIpcDir, writeAtomicJson, readJson, listPendingCmds, gcStale, respPath, statusPath, } from './protocol.js';
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const BACKOFF_START_MS = 5_000;
+const BACKOFF_CAP_MS = 60_000;
+/** Loop ticks between periodic GC passes (~35s at the default tick). */
+const GC_EVERY_TICKS = 100;
+/**
+ * See fileoverview. `run()` resolves after a `quit` op or {@link requestStop}.
+ * Never launches, quits, or signals Chrome under any failure.
+ */
+export class AttachDaemon {
+    controller;
+    backend;
+    ipcDir;
+    pidFile;
+    pollMs;
+    claimTtlMs;
+    log;
+    lock = null;
+    state = 'starting';
+    lastError;
+    identity;
+    claimant = null;
+    controllerClaimed = false;
+    stopRequested = false;
+    reconnectAt = 0;
+    backoffMs = BACKOFF_START_MS;
+    gcCountdown = GC_EVERY_TICKS;
+    constructor(opts) {
+        this.controller = opts.controller;
+        this.backend = opts.backend;
+        this.ipcDir = opts.ipcDir;
+        this.pidFile = opts.pidFile;
+        this.pollMs = opts.pollMs ?? 350;
+        this.claimTtlMs = opts.claimTtlMs ?? 600_000;
+        this.log = opts.log ?? (() => { });
+    }
+    /** External stop (signal handlers route here). */
+    requestStop(reason) {
+        this.log(`stop requested: ${reason}`);
+        this.stopRequested = true;
+    }
+    /** Acquire the singleton, open the transport, serve the queue until quit. */
+    async run() {
+        // Own the IPC dir: created here (0700) so embedders passing a raw path get
+        // a working daemon, and so the dir + a 'connecting' status.json both exist
+        // before run()'s first await returns control to the caller.
+        resolveIpcDir(this.ipcDir);
+        this.lock = acquireDaemonLock(this.pidFile);
+        try {
+            this.setState('connecting');
+            this.backend.onUnexpectedClose = (err) => {
+                this.setState('degraded', redactDiagnostic(err.message));
+                this.controllerClaimed = false;
+                this.claimant = null;
+                this.reconnectAt = Date.now() + this.backoffMs;
+            };
+            await this.backend.connect();
+            this.setState('connected');
+            while (!this.stopRequested) {
+                await sleep(this.pollMs);
+                this.heartbeat();
+                this.expireClaimant();
+                this.maybeReconnect();
+                if (--this.gcCountdown <= 0) {
+                    gcStale(this.ipcDir);
+                    this.gcCountdown = GC_EVERY_TICKS;
+                }
+                for (const pending of listPendingCmds(this.ipcDir)) {
+                    const cmd = readJson(pending.path);
+                    try {
+                        unlinkSync(pending.path);
+                    }
+                    catch {
+                        /* consumed by a GC race */
+                    }
+                    if (!cmd || typeof cmd.id !== 'string' || typeof cmd.op !== 'string' || typeof cmd.client !== 'string') {
+                        this.log(`malformed cmd file dropped: ${pending.path}`);
+                        continue;
+                    }
+                    const resp = await this.execute(cmd);
+                    writeAtomicJson(respPath(this.ipcDir, cmd.id), resp);
+                    if (cmd.op === 'quit' && resp.ok) {
+                        this.stopRequested = true;
+                        break;
+                    }
+                }
+            }
+            await this.shutdown();
+        }
+        finally {
+            this.lock?.release();
+            this.lock = null;
+        }
+    }
+    setState(state, lastError) {
+        this.state = state;
+        this.lastError = lastError;
+        this.heartbeat();
+    }
+    heartbeat() {
+        const cs = this.controller.status();
+        writeAtomicJson(statusPath(this.ipcDir), {
+            t: Date.now(),
+            pid: process.pid,
+            state: this.state,
+            targetId: cs.agentTab,
+            identity: this.identity,
+            claimant: this.claimant?.client,
+            paused: cs.paused,
+            dryRun: cs.dryRun,
+            lastError: this.lastError,
+        });
+    }
+    expireClaimant() {
+        if (this.claimant && Date.now() > this.claimant.expiresAt) {
+            this.log(`claim ttl expired for ${this.claimant.client}; parking`);
+            this.claimant = null;
+            if (this.controllerClaimed) {
+                void this.controller.goto('about:blank').catch(() => {
+                    /* park is best-effort */
+                });
+            }
+        }
+    }
+    maybeReconnect() {
+        if (this.state !== 'degraded' || Date.now() < this.reconnectAt)
+            return;
+        this.reconnectAt = Number.MAX_SAFE_INTEGER; // one attempt in flight
+        void this.backend
+            .connect()
+            .then(() => {
+            this.backoffMs = BACKOFF_START_MS;
+            this.setState('connected');
+        })
+            .catch(() => {
+            this.backoffMs = Math.min(this.backoffMs * 2, BACKOFF_CAP_MS);
+            this.reconnectAt = Date.now() + this.backoffMs;
+        });
+    }
+    requireClaimant(cmd) {
+        if (!this.claimant || this.claimant.client !== cmd.client) {
+            throw new AttachError('NOT_CLAIMANT', 'no active claim for this client; send claim first');
+        }
+        this.claimant.expiresAt = Date.now() + this.claimant.ttlMs; // activity extends the ttl
+    }
+    async execute(cmd) {
+        const base = { id: cmd.id, op: cmd.op };
+        try {
+            const a = cmd.args ?? {};
+            switch (cmd.op) {
+                case 'ping':
+                    return { ...base, ok: true, data: { pong: true, pid: process.pid } };
+                case 'status':
+                    return {
+                        ...base,
+                        ok: true,
+                        data: {
+                            ...this.controller.status(),
+                            daemonState: this.state,
+                            identity: this.identity,
+                            claimant: this.claimant?.client ?? null,
+                        },
+                    };
+                case 'claim': {
+                    if (this.claimant && this.claimant.client !== cmd.client) {
+                        throw new AttachError('LEASE_DENIED', `claimed by ${this.claimant.client}`);
+                    }
+                    if (!this.controllerClaimed) {
+                        await this.controller.claim();
+                        this.controllerClaimed = true;
+                        this.identity = await this.backend.probeIdentity().catch(() => undefined);
+                    }
+                    const ttlMs = typeof a.ttlMs === 'number' && a.ttlMs > 0 ? a.ttlMs : this.claimTtlMs;
+                    this.claimant = { client: cmd.client, ttlMs, expiresAt: Date.now() + ttlMs };
+                    return { ...base, ok: true, data: { ...this.controller.status(), identity: this.identity } };
+                }
+                case 'goto': {
+                    this.requireClaimant(cmd);
+                    const landed = await this.controller.goto(String(a.url ?? ''));
+                    const settle = typeof a.settle === 'number' && a.settle >= 0 ? a.settle : 1800;
+                    if (settle > 0)
+                        await sleep(settle);
+                    return { ...base, ok: true, data: { url: landed } };
+                }
+                case 'read': {
+                    this.requireClaimant(cmd);
+                    const text = await this.controller.read(typeof a.selector === 'string' ? a.selector : undefined, typeof a.maxChars === 'number' ? a.maxChars : undefined);
+                    return { ...base, ok: true, data: { untrusted: true, text } };
+                }
+                case 'extract': {
+                    this.requireClaimant(cmd);
+                    const data = await this.controller.extract(a.fields);
+                    return { ...base, ok: true, data: { untrusted: true, data } };
+                }
+                case 'eval': {
+                    this.requireClaimant(cmd);
+                    const value = await this.controller.evaluate(String(a.expression ?? ''), typeof a.timeoutMs === 'number' ? a.timeoutMs : undefined);
+                    return { ...base, ok: true, data: { untrusted: true, value } };
+                }
+                case 'release': {
+                    this.requireClaimant(cmd);
+                    this.claimant = null;
+                    await this.controller.goto('about:blank').catch(() => {
+                        /* park is best-effort */
+                    });
+                    return { ...base, ok: true, data: { released: true } };
+                }
+                case 'control': {
+                    this.requireClaimant(cmd);
+                    const action = String(a.action ?? 'status');
+                    if (action === 'pause')
+                        this.controller.pause();
+                    else if (action === 'resume')
+                        this.controller.resume();
+                    else if (action === 'dry_run_on')
+                        this.controller.setDryRun(true);
+                    else if (action === 'dry_run_off')
+                        this.controller.setDryRun(false);
+                    return { ...base, ok: true, data: this.controller.status() };
+                }
+                case 'quit':
+                    return { ...base, ok: true, data: { stopping: true } };
+                default:
+                    throw new AttachError('UNSUPPORTED_OP', `unknown op ${String(cmd.op)}`);
+            }
+        }
+        catch (err) {
+            const s = toStructuredError(err);
+            return { ...base, ok: false, error: { code: s.code, message: s.message } };
+        }
+    }
+    async shutdown() {
+        if (this.controllerClaimed) {
+            await this.controller.goto('about:blank').catch(() => {
+                /* park best-effort */
+            });
+            await this.controller.detach().catch(() => {
+                /* transport may be gone */
+            });
+        }
+        else {
+            await this.backend.disconnectTransport().catch(() => {
+                /* never held a tab */
+            });
+        }
+        this.claimant = null;
+        this.setState('stopped');
+    }
+}
+//# sourceMappingURL=daemon.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Barrel for the attach daemon lane (`./attach/daemon` subpath).
+ * @module browser-automation/attach/daemon
+ */
+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.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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/index.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Barrel for the attach daemon lane (`./attach/daemon` subpath).
+ * @module browser-automation/attach/daemon
+ */
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,69 @@
+/** Daemon-routable operations. */
+export type AttachOp = 'ping' | 'status' | 'claim' | 'goto' | 'read' | 'extract' | 'eval' | 'release' | 'control' | 'quit';
+/** A command file body. */
+export interface AttachCmd {
+    id: string;
+    client: string;
+    op: AttachOp;
+    args?: Record<string, unknown>;
+}
+/** Response bodies (structured error codes ride `error.code`). */
+export type AttachResp = {
+    id: string;
+    op: AttachOp;
+    ok: true;
+    data: unknown;
+} | {
+    id: string;
+    op: AttachOp;
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+    };
+};
+/** Daemon lifecycle states mirrored in status.json. */
+export type DaemonState = 'starting' | 'connecting' | 'connected' | 'degraded' | 'stopped' | 'failed';
+/** status.json shape (heartbeat `t` refreshes every daemon loop tick). */
+export interface DaemonStatusFile {
+    t: number;
+    pid: number;
+    state: DaemonState;
+    targetId?: string;
+    identity?: string;
+    claimant?: string;
+    paused?: boolean;
+    dryRun?: boolean;
+    lastError?: string;
+}
+/** Default IPC directory (created 0700). */
+export declare const DEFAULT_IPC_DIR: string;
+/** Default daemon pidfile. */
+export declare const DEFAULT_PID_FILE: string;
+/** cmd/resp files older than this are garbage-collected. */
+export declare const STALE_FILE_MS: number;
+/** status.json heartbeats older than this mark the daemon stale. */
+export declare const HEARTBEAT_STALE_MS = 30000;
+/** Resolve the IPC dir from an explicit override or env, ensuring it exists 0700. */
+export declare function resolveIpcDir(override?: string, env?: Record<string, string | undefined>): string;
+/** New string command id: `<client>-<epochMs>-<random8>`. */
+export declare function newCmdId(client: string): string;
+/** Path of a command file. */
+export declare function cmdPath(dir: string, id: string): string;
+/** Path of a response file. */
+export declare function respPath(dir: string, id: string): string;
+/** Path of the daemon heartbeat file. */
+export declare function statusPath(dir: string): string;
+/** Write JSON via tmp-then-rename so readers never see a torn body. */
+export declare function writeAtomicJson(file: string, value: unknown): void;
+/** Read+parse JSON; undefined when missing or torn. */
+export declare function readJson<T>(file: string): T | undefined;
+/** Pending command files, oldest first (mtime, then name for determinism). */
+export declare function listPendingCmds(dir: string): Array<{
+    id: string;
+    path: string;
+    mtimeMs: number;
+}>;
+/** Delete cmd/resp files older than {@link STALE_FILE_MS} (pass `now` = Infinity to sweep all). */
+export declare function gcStale(dir: string, now?: number): void;
+//# sourceMappingURL=protocol.d.ts.map

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

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