@minion-stack/shells-bridge 0.1.1

package/dist/acp-client.d.ts

@@ -0,0 +1,24 @@
+import { EventEmitter } from 'node:events';
+export interface AcpClientOptions {
+    command: string;
+    args: string[];
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+}
+export declare class AcpClient extends EventEmitter {
+    private readonly opts;
+    private proc;
+    private nextId;
+    private pending;
+    private exited;
+    constructor(opts: AcpClientOptions);
+    start(): void;
+    /** Send a JSON-RPC request; resolves with the `result` field. */
+    call<T = unknown>(method: string, params?: unknown, timeoutMs?: number): Promise<T>;
+    /** Stop the harness gracefully. Caller may force-kill via .kill() if needed. */
+    stop(): Promise<void>;
+    kill(signal?: NodeJS.Signals): void;
+    private onStdoutLine;
+    private failAllPending;
+}
+//# sourceMappingURL=acp-client.d.ts.map

package/dist/acp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-client.d.ts","sourceRoot":"","sources":["../src/acp-client.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AA4BD,qBAAa,SAAU,SAAQ,YAAY;IAM7B,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,IAAI,CAA+C;IAC3D,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAoF;IACnG,OAAO,CAAC,MAAM,CAAS;gBAEM,IAAI,EAAE,gBAAgB;IAInD,KAAK,IAAI,IAAI;IA0Bb,iEAAiE;IACjE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC;IAyBnF,gFAAgF;IAC1E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,IAAI,CAAC,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,IAAI;IAI9C,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,cAAc;CAIvB"}

package/dist/acp-client.js

@@ -0,0 +1,134 @@
+// Minimal ACP (Agent Client Protocol) client.
+//
+// ACP is JSON-RPC 2.0 over stdio. The bridge spawns the harness as a child
+// process, writes JSON-RPC requests to its stdin, and reads responses /
+// streaming `session/update` notifications from its stdout. stderr is logged.
+//
+// This file intentionally keeps the surface minimal — the bridge only needs
+// `session/prompt`, `session/cancel`, and the `session/update` notification.
+// Adding more methods is a one-line addition to AcpClient.callRaw().
+//
+// Spec ref: ACP at https://hermes-agent.nousresearch.com/docs/developer-guide/architecture
+// (HERMES exposes ACP via `acp_adapter/`). Same shape used by Zed, JetBrains, VS Code.
+import { spawn } from 'node:child_process';
+import { EventEmitter } from 'node:events';
+import { createInterface } from 'node:readline';
+function isResponse(value) {
+    return typeof value.id === 'number';
+}
+export class AcpClient extends EventEmitter {
+    opts;
+    proc = null;
+    nextId = 1;
+    pending = new Map();
+    exited = false;
+    constructor(opts) {
+        super();
+        this.opts = opts;
+    }
+    start() {
+        if (this.proc) {
+            throw new Error('AcpClient already started');
+        }
+        const proc = spawn(this.opts.command, this.opts.args, {
+            cwd: this.opts.cwd,
+            env: this.opts.env ?? process.env,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        this.proc = proc;
+        const lines = createInterface({ input: proc.stdout });
+        lines.on('line', (line) => this.onStdoutLine(line));
+        proc.stderr.on('data', (chunk) => {
+            this.emit('stderr', chunk.toString('utf8'));
+        });
+        proc.on('exit', (code, signal) => {
+            this.exited = true;
+            this.failAllPending(new Error(`harness exited code=${code} signal=${signal ?? 'none'}`));
+            this.emit('exit', { code, signal });
+        });
+        proc.on('error', (err) => {
+            this.emit('error', err);
+        });
+    }
+    /** Send a JSON-RPC request; resolves with the `result` field. */
+    call(method, params, timeoutMs = 60_000) {
+        return new Promise((resolve, reject) => {
+            if (!this.proc || this.exited) {
+                return reject(new Error('AcpClient not started or harness exited'));
+            }
+            const id = this.nextId++;
+            const req = { jsonrpc: '2.0', id, method, params };
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`ACP call '${method}' timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pending.set(id, {
+                resolve: (v) => {
+                    clearTimeout(timer);
+                    resolve(v);
+                },
+                reject: (e) => {
+                    clearTimeout(timer);
+                    reject(e);
+                },
+            });
+            this.proc.stdin.write(`${JSON.stringify(req)}\n`);
+        });
+    }
+    /** Stop the harness gracefully. Caller may force-kill via .kill() if needed. */
+    async stop() {
+        if (!this.proc || this.exited)
+            return;
+        this.proc.stdin.end();
+        // Give the harness a chance to flush state.
+        await new Promise((resolve) => {
+            if (!this.proc || this.exited)
+                return resolve();
+            const t = setTimeout(() => resolve(), 5_000);
+            this.proc.once('exit', () => {
+                clearTimeout(t);
+                resolve();
+            });
+        });
+    }
+    kill(signal = 'SIGTERM') {
+        if (this.proc && !this.exited)
+            this.proc.kill(signal);
+    }
+    onStdoutLine(line) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return;
+        let msg;
+        try {
+            msg = JSON.parse(trimmed);
+        }
+        catch (err) {
+            this.emit('parse_error', { line: trimmed, error: err });
+            return;
+        }
+        if (isResponse(msg)) {
+            const p = this.pending.get(msg.id);
+            if (!p)
+                return;
+            this.pending.delete(msg.id);
+            if (msg.error) {
+                p.reject(new Error(`ACP error ${msg.error.code}: ${msg.error.message}`));
+            }
+            else {
+                p.resolve(msg.result);
+            }
+        }
+        else {
+            // Notification (no id). The only one we care about is `session/update`,
+            // but emit them all so the bridge can subscribe broadly.
+            this.emit('notification', msg);
+        }
+    }
+    failAllPending(err) {
+        for (const p of this.pending.values())
+            p.reject(err);
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=acp-client.js.map

package/dist/acp-client.js.map

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

package/dist/backup.d.ts

@@ -0,0 +1,22 @@
+export interface BackupOptions {
+    /** Path on disk to archive. */
+    workDir: string;
+    /** Remote target (e.g. "b2://minion-shells/<shellId>/"). */
+    target: string;
+}
+export interface BackupResult {
+    backupId: string;
+    bytes: number;
+    uploadMs: number;
+    remotePath: string;
+}
+/** Stream-tar workDir into the backup target. Returns metadata. */
+export declare function backup(opts: BackupOptions): Promise<BackupResult>;
+export interface RestoreOptions {
+    /** Where to extract. Bridge typically clears this first. */
+    workDir: string;
+    /** Full remote path of the archive (e.g. "b2://bucket/<shellId>/<backupId>.tar.gz"). */
+    remotePath: string;
+}
+export declare function restore(opts: RestoreOptions): Promise<void>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../src/backup.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,mEAAmE;AACnE,wBAAsB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA8BvE;AAED,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAYjE"}

package/dist/backup.js

@@ -0,0 +1,68 @@
+// Backup / restore for shells.
+//
+// The harness is authoritative for in-VM state (per spec D3), so we tar the
+// harness's working directory and stream-upload to the configured remote.
+// Today only `b2://bucket/path/` URIs are supported, dispatched via the
+// `rclone` binary which is expected to be installed in the baked image and
+// configured with a remote named "b2".
+//
+// Restore is the inverse: download archive → extract into workDir → harness
+// is started afterwards by the supervisor.
+import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+/** Stream-tar workDir into the backup target. Returns metadata. */
+export async function backup(opts) {
+    const backupId = `${Date.now()}-${randomUUID().slice(0, 8)}`;
+    const remotePath = joinTarget(opts.target, `${backupId}.tar.gz`);
+    const started = Date.now();
+    // tar czf - <workDir> | rclone rcat <remotePath>
+    const tar = spawn('tar', ['czf', '-', '-C', opts.workDir, '.'], { stdio: ['ignore', 'pipe', 'pipe'] });
+    const rclone = spawn('rclone', ['rcat', '--progress=false', remotePath], {
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    let bytes = 0;
+    tar.stdout.on('data', (chunk) => {
+        bytes += chunk.length;
+    });
+    tar.stdout.pipe(rclone.stdin);
+    const tarStderr = collectStderr(tar);
+    const rcloneStderr = collectStderr(rclone);
+    const [tarCode, rcloneCode] = await Promise.all([waitExit(tar), waitExit(rclone)]);
+    if (tarCode !== 0)
+        throw new Error(`tar exited ${tarCode}: ${tarStderr()}`);
+    if (rcloneCode !== 0)
+        throw new Error(`rclone rcat exited ${rcloneCode}: ${rcloneStderr()}`);
+    return {
+        backupId,
+        bytes,
+        uploadMs: Date.now() - started,
+        remotePath,
+    };
+}
+export async function restore(opts) {
+    // rclone cat <remotePath> | tar xzf - -C <workDir>
+    const rclone = spawn('rclone', ['cat', opts.remotePath], { stdio: ['ignore', 'pipe', 'pipe'] });
+    const tar = spawn('tar', ['xzf', '-', '-C', opts.workDir], { stdio: ['pipe', 'pipe', 'pipe'] });
+    rclone.stdout.pipe(tar.stdin);
+    const rcloneStderr = collectStderr(rclone);
+    const tarStderr = collectStderr(tar);
+    const [rcloneCode, tarCode] = await Promise.all([waitExit(rclone), waitExit(tar)]);
+    if (rcloneCode !== 0)
+        throw new Error(`rclone cat exited ${rcloneCode}: ${rcloneStderr()}`);
+    if (tarCode !== 0)
+        throw new Error(`tar exited ${tarCode}: ${tarStderr()}`);
+}
+function joinTarget(base, name) {
+    return base.endsWith('/') ? `${base}${name}` : `${base}/${name}`;
+}
+function waitExit(proc) {
+    return new Promise((resolve) => {
+        proc.on('exit', (code) => resolve(code ?? -1));
+    });
+}
+function collectStderr(proc) {
+    const chunks = [];
+    proc.stderr.on('data', (c) => chunks.push(c));
+    return () => Buffer.concat(chunks).toString('utf8').slice(0, 2000);
+}
+//# sourceMappingURL=backup.js.map

package/dist/backup.js.map

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

package/dist/bridge.d.ts

@@ -0,0 +1,38 @@
+import type { BridgeConfig } from './config.js';
+export declare class Bridge {
+    private readonly config;
+    private ws;
+    private acp;
+    private activeRuns;
+    /** ACP session id → bridge runId. Used to correlate notifications back to the originating invoke. */
+    private acpSessionToRun;
+    private heartbeatTimer;
+    private heartbeatMs;
+    private reconnectDelay;
+    private shuttingDown;
+    private nextFrameId;
+    private pendingBridgeRpc;
+    constructor(config: BridgeConfig);
+    start(): void;
+    shutdown(): Promise<void>;
+    private connect;
+    private scheduleReconnect;
+    private send;
+    private emitEvent;
+    /** Bridge-initiated RPC (register, heartbeat, fatal). */
+    private callGateway;
+    private onFrame;
+    private handleResponse;
+    private handleRequest;
+    private dispatch;
+    private register;
+    private startHeartbeat;
+    private reportFatal;
+    private handleInvoke;
+    private handleCancel;
+    private handleBackup;
+    private handleRestore;
+    private onAcpNotification;
+    private emitFinal;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAUhD,qBAAa,MAAM;IAaL,OAAO,CAAC,QAAQ,CAAC,MAAM;IAZnC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,UAAU,CAAgC;IAClD,qGAAqG;IACrG,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,gBAAgB,CAAoF;gBAE/E,MAAM,EAAE,YAAY;IAUjD,KAAK,IAAI,IAAI;IAgBP,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B,OAAO,CAAC,OAAO;IA4Bf,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,SAAS;IAKjB,yDAAyD;IACzD,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,cAAc;YAQR,aAAa;YAeb,QAAQ;YAwBR,QAAQ;IAyBtB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,WAAW;YAgBL,YAAY;YAoBZ,YAAY;YAWZ,YAAY;YAgBZ,aAAa;IAS3B,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,SAAS;CAmBlB"}

package/dist/bridge.js

@@ -0,0 +1,364 @@
+// Bridge core — owns the WS connection to the gateway and routes RPCs to
+// the in-process ACP client + backup module.
+//
+// Lifecycle:
+//   1. construct → start()  : spawn harness, open WS, register
+//   2. WS frame in  → handleRequest() dispatches by method
+//   3. ACP notification (session/update) → emit shell.delta event upstream
+//   4. WS drop → reconnect with backoff (state preserved; harness keeps running)
+//   5. SIGTERM → graceful shutdown (close WS → stop harness → exit)
+import { WebSocket } from 'ws';
+import { SHELLS_METHODS, SHELLS_EVENTS, } from '@minion-stack/shared';
+import { AcpClient } from './acp-client.js';
+import { backup, restore } from './backup.js';
+import { randomUUID } from 'node:crypto';
+import { statSync } from 'node:fs';
+export class Bridge {
+    config;
+    ws = null;
+    acp;
+    activeRuns = new Map();
+    /** ACP session id → bridge runId. Used to correlate notifications back to the originating invoke. */
+    acpSessionToRun = new Map();
+    heartbeatTimer = null;
+    heartbeatMs;
+    reconnectDelay;
+    shuttingDown = false;
+    nextFrameId = 1;
+    pendingBridgeRpc = new Map();
+    constructor(config) {
+        this.config = config;
+        this.acp = new AcpClient({
+            command: config.harnessCommand,
+            args: config.harnessArgs,
+            cwd: config.harnessWorkDir,
+        });
+        this.heartbeatMs = config.heartbeatMs;
+        this.reconnectDelay = config.reconnectMinMs;
+    }
+    start() {
+        this.acp.on('notification', (msg) => {
+            this.onAcpNotification(msg);
+        });
+        this.acp.on('stderr', (chunk) => {
+            // Forwarded to journald via stdout; image's systemd unit captures it.
+            process.stderr.write(`[harness] ${chunk}`);
+        });
+        this.acp.on('exit', ({ code, signal }) => {
+            if (this.shuttingDown)
+                return;
+            this.reportFatal('unknown', `harness exited code=${code} signal=${signal ?? 'none'}`);
+        });
+        this.acp.start();
+        this.connect();
+    }
+    async shutdown() {
+        this.shuttingDown = true;
+        if (this.heartbeatTimer)
+            clearInterval(this.heartbeatTimer);
+        if (this.ws)
+            this.ws.close(1000, 'shutdown');
+        await this.acp.stop();
+    }
+    // ---------------------------------------------------------------------------
+    // WS lifecycle
+    // ---------------------------------------------------------------------------
+    connect() {
+        if (this.shuttingDown)
+            return;
+        const ws = new WebSocket(this.config.gatewayUrl, {
+            headers: { 'x-shell-id': this.config.shellId },
+        });
+        this.ws = ws;
+        ws.on('open', () => {
+            this.reconnectDelay = this.config.reconnectMinMs;
+            void this.register();
+        });
+        ws.on('message', (data) => {
+            const text = typeof data === 'string' ? data : data.toString('utf8');
+            this.onFrame(text);
+        });
+        ws.on('close', () => {
+            this.ws = null;
+            if (this.heartbeatTimer) {
+                clearInterval(this.heartbeatTimer);
+                this.heartbeatTimer = null;
+            }
+            if (!this.shuttingDown)
+                this.scheduleReconnect();
+        });
+        ws.on('error', (err) => {
+            process.stderr.write(`[bridge] ws error: ${err.message}\n`);
+        });
+    }
+    scheduleReconnect() {
+        const delay = this.reconnectDelay;
+        this.reconnectDelay = Math.min(this.reconnectDelay * 2, this.config.reconnectMaxMs);
+        setTimeout(() => this.connect(), delay);
+    }
+    send(frame) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN)
+            return;
+        this.ws.send(JSON.stringify(frame));
+    }
+    emitEvent(event, payload) {
+        const frame = { type: 'event', event, payload };
+        this.send(frame);
+    }
+    /** Bridge-initiated RPC (register, heartbeat, fatal). */
+    callGateway(method, params, timeoutMs = 30_000) {
+        return new Promise((resolve, reject) => {
+            if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+                return reject(new Error('not connected'));
+            }
+            const id = `b${this.nextFrameId++}`;
+            const timer = setTimeout(() => {
+                this.pendingBridgeRpc.delete(id);
+                reject(new Error(`gateway rpc '${method}' timed out`));
+            }, timeoutMs);
+            this.pendingBridgeRpc.set(id, {
+                resolve: (v) => {
+                    clearTimeout(timer);
+                    resolve(v);
+                },
+                reject: (e) => {
+                    clearTimeout(timer);
+                    reject(e);
+                },
+            });
+            const frame = { type: 'req', id, method, params };
+            this.send(frame);
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Frame routing
+    // ---------------------------------------------------------------------------
+    onFrame(raw) {
+        let frame;
+        try {
+            frame = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        if (frame.type === 'req')
+            void this.handleRequest(frame);
+        else if (frame.type === 'res')
+            this.handleResponse(frame);
+        // event frames from gateway are ignored — bridge is a leaf.
+    }
+    handleResponse(frame) {
+        const p = this.pendingBridgeRpc.get(frame.id);
+        if (!p)
+            return;
+        this.pendingBridgeRpc.delete(frame.id);
+        if (frame.ok)
+            p.resolve(frame.payload);
+        else
+            p.reject(new Error(frame.error?.message ?? 'gateway rpc failed'));
+    }
+    async handleRequest(frame) {
+        try {
+            const result = await this.dispatch(frame.method, frame.params);
+            this.send({ type: 'res', id: frame.id, ok: true, payload: result });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.send({
+                type: 'res',
+                id: frame.id,
+                ok: false,
+                error: { code: 'BRIDGE_ERROR', message: msg },
+            });
+        }
+    }
+    async dispatch(method, params) {
+        switch (method) {
+            case SHELLS_METHODS.invoke:
+                return this.handleInvoke(params);
+            case SHELLS_METHODS.cancel:
+                return this.handleCancel(params);
+            case SHELLS_METHODS.backupNow:
+                return this.handleBackup(params);
+            // shells.health — bridge-local liveness, no harness call
+            case 'shells.health':
+                return { ok: true, ts: Date.now() };
+            // shells.restore — gateway calls this after wake. Bridge expects to be
+            // mid-startup with workDir already empty.
+            case 'shells.restore':
+                return this.handleRestore(params);
+            default:
+                throw new Error(`unsupported method: ${method}`);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Register / heartbeat
+    // ---------------------------------------------------------------------------
+    async register() {
+        const params = {
+            shellId: this.config.shellId,
+            deviceToken: this.config.deviceToken,
+            harness: this.config.harness,
+            harnessVersion: this.config.harnessVersion,
+            bridgeVersion: PACKAGE_VERSION,
+            capabilities: {
+                acpMethods: ['session/prompt', 'session/cancel', 'session/update'],
+                streaming: true,
+                backupKind: 'tar+rclone',
+                maxConcurrentRuns: 1,
+            },
+        };
+        try {
+            const res = await this.callGateway(SHELLS_METHODS.register, params);
+            this.heartbeatMs = res.heartbeatMs ?? this.heartbeatMs;
+            this.startHeartbeat();
+        }
+        catch (err) {
+            process.stderr.write(`[bridge] register failed: ${err.message}\n`);
+            // Close ws; reconnect will retry.
+            this.ws?.close();
+        }
+    }
+    startHeartbeat() {
+        if (this.heartbeatTimer)
+            clearInterval(this.heartbeatTimer);
+        this.heartbeatTimer = setInterval(() => {
+            const params = {
+                shellId: this.config.shellId,
+                activeRunIds: [...this.activeRuns.keys()],
+                diskUsedMB: measureDiskMB(this.config.harnessWorkDir),
+                memoryUsedMB: measureMemoryMB(),
+            };
+            this.callGateway(SHELLS_METHODS.heartbeat, params).catch((err) => {
+                process.stderr.write(`[bridge] heartbeat failed: ${err.message}\n`);
+            });
+        }, this.heartbeatMs);
+    }
+    reportFatal(reason, message) {
+        const params = { shellId: this.config.shellId, reason, message };
+        this.callGateway(SHELLS_METHODS.fatal, params)
+            .catch(() => {
+            /* best-effort */
+        })
+            .finally(() => {
+            // systemd Restart=always will recycle us.
+            process.exit(1);
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Caller-facing RPC handlers
+    // ---------------------------------------------------------------------------
+    async handleInvoke(params) {
+        const runId = `run_${randomUUID()}`;
+        const startedAt = Date.now();
+        this.activeRuns.set(runId, { runId, sessionId: params.sessionId, startedAt });
+        this.acpSessionToRun.set(params.sessionId, runId);
+        // Fire ACP `session/prompt` — do NOT await; bridge replies to the caller
+        // immediately with runId, then streams updates via shell.delta events.
+        this.acp
+            .call('session/prompt', { sessionId: params.sessionId, input: params.input })
+            .then((result) => {
+            this.emitFinal(runId, params.sessionId, 'final', startedAt, { result });
+        })
+            .catch((err) => {
+            this.emitFinal(runId, params.sessionId, 'error', startedAt, { errorMessage: err.message });
+        });
+        return { runId, startedAt };
+    }
+    async handleCancel(params) {
+        const run = this.activeRuns.get(params.runId);
+        if (!run)
+            return { cancelled: false };
+        try {
+            await this.acp.call('session/cancel', { sessionId: run.sessionId });
+            return { cancelled: true };
+        }
+        catch {
+            return { cancelled: false };
+        }
+    }
+    async handleBackup(params) {
+        if (!this.config.backupTarget)
+            throw new Error('no backup target configured');
+        const res = await backup({
+            workDir: this.config.harnessWorkDir,
+            target: this.config.backupTarget,
+        });
+        this.emitEvent(SHELLS_EVENTS.backupDone, {
+            shellId: this.config.shellId,
+            backupId: res.backupId,
+            bytes: res.bytes,
+            uploadMs: res.uploadMs,
+            trigger: 'manual',
+        });
+        return { backupId: res.backupId, bytes: res.bytes, uploadMs: res.uploadMs };
+    }
+    async handleRestore(params) {
+        await restore({ workDir: this.config.harnessWorkDir, remotePath: params.remotePath });
+        return { ok: true };
+    }
+    // ---------------------------------------------------------------------------
+    // ACP → upstream event translation
+    // ---------------------------------------------------------------------------
+    onAcpNotification(msg) {
+        if (msg.method !== 'session/update')
+            return;
+        const params = msg.params;
+        const sessionId = params?.sessionId;
+        if (!sessionId)
+            return;
+        const runId = this.acpSessionToRun.get(sessionId);
+        if (!runId)
+            return;
+        const payload = {
+            shellId: this.config.shellId,
+            runId,
+            sessionId,
+            seq: nextSeq(this.activeRuns.get(runId)),
+            acpUpdate: msg.params,
+        };
+        this.emitEvent(SHELLS_EVENTS.delta, payload);
+    }
+    emitFinal(runId, sessionId, state, startedAt, extra) {
+        const payload = {
+            shellId: this.config.shellId,
+            runId,
+            sessionId,
+            state,
+            errorMessage: extra.errorMessage,
+            durationMs: Date.now() - startedAt,
+        };
+        this.emitEvent(SHELLS_EVENTS.final, payload);
+        this.activeRuns.delete(runId);
+        this.acpSessionToRun.delete(sessionId);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Per-run monotonic delta sequence number, stored on the ActiveRun. */
+function nextSeq(run) {
+    if (!run)
+        return 0;
+    const r = run;
+    r._seq = (r._seq ?? 0) + 1;
+    return r._seq;
+}
+function measureDiskMB(path) {
+    try {
+        const stat = statSync(path);
+        // statSync().size is not directory-recursive; this is a placeholder.
+        // Real impl will shell out to `du -sm <path>` and cache for heartbeatMs.
+        return Math.round(stat.size / (1024 * 1024));
+    }
+    catch {
+        return 0;
+    }
+}
+function measureMemoryMB() {
+    const mem = process.memoryUsage();
+    return Math.round(mem.rss / (1024 * 1024));
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+globalThis.PACKAGE_VERSION ??= '0.1.0';
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,32 @@
+export interface BridgeConfig {
+    /** Stable shell identifier issued by the gateway at provision time. */
+    shellId: string;
+    /** Gateway WSS URL, e.g. "wss://gateway.example.com/ws". */
+    gatewayUrl: string;
+    /** One-time device token for `shells.register`. */
+    deviceToken: string;
+    /** Harness identifier — selects which ACP adapter to instantiate. */
+    harness: 'hermes' | 'claude-code' | 'codex' | string;
+    /** Version string of the harness binary baked into the image. */
+    harnessVersion: string;
+    /** Command + args spawned to run the harness via ACP. */
+    harnessCommand: string;
+    harnessArgs: string[];
+    /** Working directory for the harness process. State lives here. */
+    harnessWorkDir: string;
+    /**
+     * Optional B2 (or any rclone-compatible) target for backups.
+     * Format: "b2://bucket/path/<shellId>/" — bridge appends `<backupId>.tar.gz`.
+     */
+    backupTarget?: string;
+    /** Reconnect floor (ms). Bridge backs off exponentially up to a cap. */
+    reconnectMinMs: number;
+    reconnectMaxMs: number;
+    /** Heartbeat cadence (ms) — overridden by server response to shells.register. */
+    heartbeatMs: number;
+}
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
+export declare function loadConfig(env?: NodeJS.ProcessEnv): BridgeConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,OAAO,EAAE,QAAQ,GAAG,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;IACrD,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAoBD,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CA2B7E"}

package/dist/config.js

@@ -0,0 +1,53 @@
+// Bridge configuration — sourced from environment.
+// Set by the exe.dev VM provisioning step (systemd unit env file).
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigError';
+    }
+}
+function required(name) {
+    const value = process.env[name];
+    if (!value || value.trim() === '') {
+        throw new ConfigError(`Missing required env var: ${name}`);
+    }
+    return value;
+}
+function optionalInt(name, fallback) {
+    const raw = process.env[name];
+    if (!raw)
+        return fallback;
+    const n = Number.parseInt(raw, 10);
+    if (Number.isNaN(n)) {
+        throw new ConfigError(`Env var ${name} must be an integer, got: ${raw}`);
+    }
+    return n;
+}
+export function loadConfig(env = process.env) {
+    // Allow injection in tests by swapping process.env reference.
+    const cmdRaw = env.SHELLS_HARNESS_CMD;
+    if (!cmdRaw) {
+        throw new ConfigError('Missing required env var: SHELLS_HARNESS_CMD');
+    }
+    // Naive splitter — quoted args not supported. Image builder controls this value
+    // so naive is fine.
+    const [harnessCommand, ...harnessArgs] = cmdRaw.split(/\s+/);
+    if (!harnessCommand) {
+        throw new ConfigError('SHELLS_HARNESS_CMD is empty');
+    }
+    return {
+        shellId: required('SHELLS_SHELL_ID'),
+        gatewayUrl: required('SHELLS_GATEWAY_URL'),
+        deviceToken: required('SHELLS_DEVICE_TOKEN'),
+        harness: required('SHELLS_HARNESS'),
+        harnessVersion: required('SHELLS_HARNESS_VERSION'),
+        harnessCommand,
+        harnessArgs,
+        harnessWorkDir: env.SHELLS_HARNESS_WORKDIR ?? '/home/agent/state',
+        backupTarget: env.SHELLS_BACKUP_TARGET,
+        reconnectMinMs: optionalInt('SHELLS_RECONNECT_MIN_MS', 1000),
+        reconnectMaxMs: optionalInt('SHELLS_RECONNECT_MAX_MS', 60_000),
+        heartbeatMs: optionalInt('SHELLS_HEARTBEAT_MS', 15_000),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,mEAAmE;AA8BnE,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,WAAW,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,QAAgB;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAC;IAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,WAAW,CAAC,WAAW,IAAI,6BAA6B,GAAG,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,8DAA8D;IAC9D,MAAM,MAAM,GAAG,GAAG,CAAC,kBAAkB,CAAC;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,WAAW,CAAC,8CAA8C,CAAC,CAAC;IACxE,CAAC;IACD,gFAAgF;IAChF,oBAAoB;IACpB,MAAM,CAAC,cAAc,EAAE,GAAG,WAAW,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,WAAW,CAAC,6BAA6B,CAAC,CAAC;IACvD,CAAC;IAED,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC;QACpC,UAAU,EAAE,QAAQ,CAAC,oBAAoB,CAAC;QAC1C,WAAW,EAAE,QAAQ,CAAC,qBAAqB,CAAC;QAC5C,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC;QACnC,cAAc,EAAE,QAAQ,CAAC,wBAAwB,CAAC;QAClD,cAAc;QACd,WAAW;QACX,cAAc,EAAE,GAAG,CAAC,sBAAsB,IAAI,mBAAmB;QACjE,YAAY,EAAE,GAAG,CAAC,oBAAoB;QACtC,cAAc,EAAE,WAAW,CAAC,yBAAyB,EAAE,IAAI,CAAC;QAC5D,cAAc,EAAE,WAAW,CAAC,yBAAyB,EAAE,MAAM,CAAC;QAC9D,WAAW,EAAE,WAAW,CAAC,qBAAqB,EAAE,MAAM,CAAC;KACxD,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+export { Bridge } from './bridge.js';
+export { loadConfig, ConfigError, type BridgeConfig } from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAsDA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+// @minion-stack/shells-bridge entrypoint.
+//
+// Baked into every shell VM image. Started by systemd:
+//
+//   [Service]
+//   ExecStart=/usr/bin/shells-bridge
+//   EnvironmentFile=/etc/shells-bridge.env
+//   Restart=always
+//   RestartSec=5s
+//
+// Environment (see config.ts for full list):
+//   SHELLS_SHELL_ID         — stable shell id
+//   SHELLS_GATEWAY_URL      — wss://gateway.../ws
+//   SHELLS_DEVICE_TOKEN     — one-time token for shells.register
+//   SHELLS_HARNESS          — "hermes" | "claude-code" | "codex" | …
+//   SHELLS_HARNESS_VERSION  — version string
+//   SHELLS_HARNESS_CMD      — command line spawned to run the harness via ACP
+//   SHELLS_HARNESS_WORKDIR  — state dir (default /home/agent/state)
+//   SHELLS_BACKUP_TARGET    — optional, e.g. b2://bucket/<shellId>/
+import { Bridge } from './bridge.js';
+import { loadConfig, ConfigError } from './config.js';
+async function main() {
+    let config;
+    try {
+        config = loadConfig();
+    }
+    catch (err) {
+        if (err instanceof ConfigError) {
+            process.stderr.write(`[bridge] ${err.message}\n`);
+            process.exit(2);
+        }
+        throw err;
+    }
+    const bridge = new Bridge(config);
+    const shutdown = async (signal) => {
+        process.stderr.write(`[bridge] received ${signal}, shutting down\n`);
+        await bridge.shutdown();
+        process.exit(0);
+    };
+    process.on('SIGTERM', () => void shutdown('SIGTERM'));
+    process.on('SIGINT', () => void shutdown('SIGINT'));
+    bridge.start();
+}
+void main().catch((err) => {
+    process.stderr.write(`[bridge] fatal: ${err.message}\n`);
+    process.exit(1);
+});
+export { Bridge } from './bridge.js';
+export { loadConfig, ConfigError } from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,0CAA0C;AAC1C,EAAE;AACF,uDAAuD;AACvD,EAAE;AACF,cAAc;AACd,qCAAqC;AACrC,2CAA2C;AAC3C,mBAAmB;AACnB,kBAAkB;AAClB,EAAE;AACF,6CAA6C;AAC7C,8CAA8C;AAC9C,kDAAkD;AAClD,iEAAiE;AACjE,qEAAqE;AACrE,6CAA6C;AAC7C,8EAA8E;AAC9E,oEAAoE;AACpE,oEAAoE;AAEpE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtD,KAAK,UAAU,IAAI;IACjB,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,UAAU,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;YAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;IAElC,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAsB,EAAiB,EAAE;QAC/D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,MAAM,mBAAmB,CAAC,CAAC;QACrE,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEpD,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC;AAED,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;IAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAqB,MAAM,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@minion-stack/shells-bridge",
+  "version": "0.1.1",
+  "description": "In-VM bridge process for Minion Shells — speaks @minion-stack/shared frames upstream to the gateway and ACP/JSON-RPC downstream to the local harness (HERMES, Claude Code, Codex, etc.).",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NikolasP98/minion-meta.git",
+    "directory": "packages/shells-bridge"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "shells-bridge": "dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "ws": "^8.21.0",
+    "@minion-stack/shared": "0.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@types/ws": "^8.18.1",
+    "oxlint": "^1.66.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.9",
+    "@minion-stack/tsconfig": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint src"
+  }
+}