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

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

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+/**
+ * @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
+ */
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const AttachController_js_1 = require("../AttachController.js");
+const raw_cdp_js_1 = require("../backends/raw-cdp.js");
+const daemon_js_1 = require("./daemon.js");
+const protocol_js_1 = require("./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.
+ */
+async function main(env = process.env) {
+    const ipcDir = (0, protocol_js_1.resolveIpcDir)(undefined, env);
+    const fail = (msg) => {
+        (0, protocol_js_1.writeAtomicJson)((0, protocol_js_1.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 raw_cdp_js_1.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_js_1.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() || (0, node_path_1.join)((0, node_os_1.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 daemon_js_1.AttachDaemon({
+        controller,
+        backend,
+        ipcDir,
+        pidFile: env.WUNDERLAND_ATTACH_PID_FILE?.trim() || protocol_js_1.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);
+    }
+}
+// Invoked directly (not imported): run and exit with the returned code.
+if (process.argv[1] && import.meta.url === `file://${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;AAe9E,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;IAgD1B,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,264 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttachDaemon = void 0;
+/**
+ * @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
+ */
+const node_fs_1 = require("node:fs");
+const errors_js_1 = require("../errors.js");
+const daemon_lock_js_1 = require("./daemon-lock.js");
+const protocol_js_1 = require("./protocol.js");
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const BACKOFF_START_MS = 5000;
+const BACKOFF_CAP_MS = 60000;
+/** 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.
+ */
+class AttachDaemon {
+    constructor(opts) {
+        this.lock = null;
+        this.state = 'starting';
+        this.claimant = null;
+        this.controllerClaimed = false;
+        this.stopRequested = false;
+        this.reconnectAt = 0;
+        this.backoffMs = BACKOFF_START_MS;
+        this.gcCountdown = GC_EVERY_TICKS;
+        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 ?? 600000;
+        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() {
+        this.lock = (0, daemon_lock_js_1.acquireDaemonLock)(this.pidFile);
+        try {
+            this.setState('connecting');
+            this.backend.onUnexpectedClose = (err) => {
+                this.setState('degraded', (0, errors_js_1.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) {
+                    (0, protocol_js_1.gcStale)(this.ipcDir);
+                    this.gcCountdown = GC_EVERY_TICKS;
+                }
+                for (const pending of (0, protocol_js_1.listPendingCmds)(this.ipcDir)) {
+                    const cmd = (0, protocol_js_1.readJson)(pending.path);
+                    try {
+                        (0, node_fs_1.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);
+                    (0, protocol_js_1.writeAtomicJson)((0, protocol_js_1.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();
+        (0, protocol_js_1.writeAtomicJson)((0, protocol_js_1.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 errors_js_1.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 errors_js_1.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 errors_js_1.AttachError('UNSUPPORTED_OP', `unknown op ${String(cmd.op)}`);
+            }
+        }
+        catch (err) {
+            const s = (0, errors_js_1.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');
+    }
+}
+exports.AttachDaemon = AttachDaemon;
+//# 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,30 @@
+"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; } });
+//# 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,gDAA8B;AAC9B,mDAAiC;AACjC,8CAA4B;AAC5B,8CAA4B;AAC5B,+CAA6B;AAC7B,8CAA4B;AAC5B,mDAAsD;AAA7C,4GAAA,IAAI,OAAc"}

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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"}