@almyty/runner 1.2.0

package/dist/process-manager.js

@@ -0,0 +1,334 @@
+import { spawn as cpSpawn } from 'child_process';
+import { randomUUID } from 'crypto';
+import { EventEmitter } from 'events';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { RunnerError, RUNNER_ERROR_CODES, } from './types.js';
+import { lastFrameResetIndex } from './coding-agents/index.js';
+const execFileAsync = promisify(execFile);
+/** Cap on the retained status tail (~ a couple of screenfuls). */
+const RECENT_TAIL_CAP = 8192;
+/**
+ * Per-runner process orchestrator.
+ *
+ * Bookkeeping: every process is namespaced by workspaceId. Cross-
+ * workspace lookups error loudly (process_cross_workspace) — this is
+ * cheap insurance against an agent in workspace A handing a stale
+ * process_id to a tool that runs in workspace B.
+ *
+ * Buffering: stdout/stderr accumulate in a per-process string buffer.
+ * read() drains it; wait_for_idle() reads with idle-detection. We
+ * don't try to interpret encodings or framing; the runner's job is
+ * to deliver bytes faithfully, not to reason about what they mean.
+ */
+export class ProcessManager {
+    adapter;
+    maxConcurrent;
+    processes = new Map();
+    constructor(adapter, maxConcurrent) {
+        this.adapter = adapter;
+        this.maxConcurrent = maxConcurrent;
+    }
+    // ── snapshots ───────────────────────────────────────────────────────
+    inUse() {
+        let n = 0;
+        for (const p of this.processes.values())
+            if (p.handle.status === 'running')
+                n++;
+        return n;
+    }
+    list(workspaceId) {
+        const handles = [];
+        for (const p of this.processes.values()) {
+            if (workspaceId && p.handle.workspaceId !== workspaceId)
+                continue;
+            handles.push(p.handle);
+        }
+        return handles;
+    }
+    // ── lifecycle ───────────────────────────────────────────────────────
+    async spawn(workspaceId, opts) {
+        if (this.inUse() >= this.maxConcurrent) {
+            throw new RunnerError(`runner at capacity (${this.maxConcurrent} concurrent processes)`, RUNNER_ERROR_CODES.CAPACITY_EXCEEDED);
+        }
+        const usePty = opts.pty !== false;
+        const adapter = usePty
+            ? await this.adapter.spawnPty(opts)
+            : await this.adapter.spawnPipe(opts);
+        const processId = `proc_${randomUUID()}`;
+        const handle = {
+            processId,
+            binary: opts.binary,
+            startedAt: new Date(),
+            status: 'running',
+            workspaceId,
+        };
+        let resolveExit;
+        const exitPromise = new Promise(r => { resolveExit = r; });
+        const running = {
+            handle,
+            adapter,
+            buffer: '',
+            recentTail: '',
+            lastOutputAt: Date.now(),
+            exitPromise,
+            exitInfo: null,
+        };
+        adapter.on('data', (chunk) => {
+            const text = typeof chunk === 'string' ? chunk : chunk.toString('utf8');
+            running.buffer += text;
+            // Maintain the status tail as the latest repaint frame. If this chunk
+            // contains a frame-reset (erase-display / cursor-home), the prior frame
+            // is stale — keep only from the last reset so a since-cleared status line
+            // can't falsely read as busy.
+            const reset = lastFrameResetIndex(text);
+            running.recentTail =
+                reset >= 0
+                    ? text.slice(reset).slice(-RECENT_TAIL_CAP)
+                    : (running.recentTail + text).slice(-RECENT_TAIL_CAP);
+            running.lastOutputAt = Date.now();
+        });
+        adapter.on('exit', (info) => {
+            running.handle.status = info.signal ? 'killed' : 'exited';
+            const exit = {
+                exitCode: info.exitCode,
+                signal: info.signal,
+            };
+            running.exitInfo = exit;
+            resolveExit(exit);
+        });
+        this.processes.set(processId, running);
+        return handle;
+    }
+    /** Look up a process; enforces workspace ownership. */
+    getOrThrow(workspaceId, processId) {
+        const proc = this.processes.get(processId);
+        if (!proc) {
+            throw new RunnerError(`unknown process ${processId}`, RUNNER_ERROR_CODES.PROCESS_NOT_FOUND);
+        }
+        if (proc.handle.workspaceId !== workspaceId) {
+            // Match the spec: "Calls referencing a resource from a
+            // different workspace error loudly with a clear message."
+            throw new RunnerError(`process ${processId} is not in workspace ${workspaceId}`, RUNNER_ERROR_CODES.PROCESS_CROSS_WORKSPACE);
+        }
+        return proc;
+    }
+    // ── I/O ─────────────────────────────────────────────────────────────
+    write(workspaceId, processId, data) {
+        const proc = this.getOrThrow(workspaceId, processId);
+        if (proc.handle.status !== 'running') {
+            throw new RunnerError(`process ${processId} has already exited`, RUNNER_ERROR_CODES.PROCESS_ALREADY_EXITED);
+        }
+        proc.adapter.write(data);
+    }
+    /**
+     * Drain the output buffer. Returns whatever has accumulated since
+     * the last call; future calls return only what's new.
+     */
+    read(workspaceId, processId) {
+        const proc = this.getOrThrow(workspaceId, processId);
+        const data = proc.buffer;
+        proc.buffer = '';
+        return { data, moreAvailable: false };
+    }
+    /**
+     * Non-destructive peek at the recent output tail. Unlike read(), this does
+     * NOT drain anything — it's for status classification, which must work even
+     * after the agent has drained `buffer` via read(). Returns the rolling tail
+     * (capped at RECENT_TAIL_CAP) plus the process status and idle interval.
+     */
+    snapshot(workspaceId, processId) {
+        const proc = this.getOrThrow(workspaceId, processId);
+        return {
+            tail: proc.recentTail,
+            binary: proc.handle.binary,
+            status: proc.handle.status,
+            idleMs: Date.now() - proc.lastOutputAt,
+        };
+    }
+    /**
+     * Subscribe to a process's live output and exit. Push-based counterpart to
+     * read(): the coding-session layer streams chunks to the backend as they
+     * arrive instead of polling. Does NOT drain the pull buffer — a caller can
+     * observe and read() the same process without losing bytes in either place.
+     * Returns an unsubscribe function.
+     */
+    observe(workspaceId, processId, handlers) {
+        const proc = this.getOrThrow(workspaceId, processId);
+        const onData = (chunk) => {
+            handlers.onData?.(typeof chunk === 'string' ? chunk : chunk.toString('utf8'));
+        };
+        const onExit = (info) => {
+            handlers.onExit?.({ exitCode: info.exitCode, signal: info.signal });
+        };
+        if (handlers.onData)
+            proc.adapter.on('data', onData);
+        if (handlers.onExit)
+            proc.adapter.on('exit', onExit);
+        return () => {
+            proc.adapter.off('data', onData);
+            proc.adapter.off('exit', onExit);
+        };
+    }
+    async waitForIdle(workspaceId, processId, opts) {
+        const proc = this.getOrThrow(workspaceId, processId);
+        const start = Date.now();
+        let captured = '';
+        return new Promise(resolve => {
+            const drain = () => {
+                captured += proc.buffer;
+                proc.buffer = '';
+            };
+            const tick = () => {
+                const now = Date.now();
+                const sinceLast = now - proc.lastOutputAt;
+                const sinceStart = now - start;
+                drain();
+                if (sinceLast >= opts.idleMs) {
+                    clearInterval(timer);
+                    resolve({ data: captured, idle: true });
+                    return;
+                }
+                if (sinceStart >= opts.maxWaitMs) {
+                    clearInterval(timer);
+                    resolve({ data: captured, idle: false });
+                    return;
+                }
+                if (proc.handle.status !== 'running') {
+                    // Drain whatever's queued, then return idle: true since
+                    // the process is done producing.
+                    clearInterval(timer);
+                    resolve({ data: captured, idle: true });
+                    return;
+                }
+            };
+            // Poll cadence: 1/4 of idleMs, capped at 250ms. Polling instead
+            // of subscribing because we want to wake up at the deadline
+            // even if no output is arriving.
+            const intervalMs = Math.max(20, Math.min(250, Math.floor(opts.idleMs / 4)));
+            const timer = setInterval(tick, intervalMs);
+            timer.unref?.();
+        });
+    }
+    closeInput(workspaceId, processId) {
+        const proc = this.getOrThrow(workspaceId, processId);
+        if (proc.handle.status === 'running')
+            proc.adapter.closeInput();
+    }
+    signal(workspaceId, processId, sig) {
+        const proc = this.getOrThrow(workspaceId, processId);
+        if (proc.handle.status !== 'running')
+            return;
+        const mapped = `SIG${sig}`;
+        proc.adapter.kill(mapped);
+    }
+    async wait(workspaceId, processId, timeoutMs) {
+        const proc = this.getOrThrow(workspaceId, processId);
+        if (proc.exitInfo)
+            return proc.exitInfo;
+        if (timeoutMs === undefined)
+            return proc.exitPromise;
+        return Promise.race([
+            proc.exitPromise,
+            new Promise((_, reject) => {
+                const t = setTimeout(() => reject(new RunnerError(`wait timed out after ${timeoutMs}ms`, RUNNER_ERROR_CODES.TIMEOUT)), timeoutMs);
+                t.unref?.();
+            }),
+        ]);
+    }
+    /** Kill all processes for a workspace and forget them. Used on workspace release. */
+    async killWorkspace(workspaceId) {
+        let killed = 0;
+        for (const [id, proc] of this.processes) {
+            if (proc.handle.workspaceId !== workspaceId)
+                continue;
+            if (proc.handle.status === 'running') {
+                try {
+                    proc.adapter.kill('SIGKILL');
+                }
+                catch { /* */ }
+            }
+            this.processes.delete(id);
+            killed++;
+        }
+        return killed;
+    }
+}
+// ── Default adapter (real subprocess via node-pty / child_process) ──
+export function createDefaultAdapterFactory() {
+    let nodePtyMod = null;
+    return {
+        async spawnPty(opts) {
+            if (!nodePtyMod) {
+                // Native dep: load on first use so tests that never request
+                // a PTY don't pay the cost or hit the build-toolchain
+                // requirement.
+                nodePtyMod = await import('node-pty');
+            }
+            const pty = nodePtyMod.spawn(opts.binary, opts.args, {
+                name: 'xterm-color',
+                cwd: opts.cwd ?? process.cwd(),
+                env: { ...process.env, ...(opts.env ?? {}) },
+                cols: 120,
+                rows: 30,
+            });
+            const emitter = new EventEmitter();
+            Object.defineProperty(emitter, 'pid', { get: () => pty.pid });
+            emitter.write = (data) => pty.write(data);
+            emitter.resize = (cols, rows) => pty.resize(cols, rows);
+            emitter.kill = (signal) => pty.kill(signal);
+            emitter.closeInput = () => {
+                // Send EOT (^D); cleanest cross-platform "close stdin" for a PTY.
+                pty.write('\x04');
+            };
+            pty.onData((d) => emitter.emit('data', d));
+            pty.onExit(({ exitCode, signal }) => {
+                emitter.emit('exit', {
+                    exitCode: exitCode ?? null,
+                    signal: signal !== undefined && signal !== 0 ? String(signal) : null,
+                });
+            });
+            return emitter;
+        },
+        async spawnPipe(opts) {
+            const child = cpSpawn(opts.binary, opts.args, {
+                stdio: ['pipe', 'pipe', 'pipe'],
+                cwd: opts.cwd,
+                env: { ...process.env, ...(opts.env ?? {}) },
+            });
+            const emitter = new EventEmitter();
+            Object.defineProperty(emitter, 'pid', { get: () => child.pid });
+            emitter.write = (data) => { child.stdin?.write(data); };
+            emitter.kill = (signal) => { child.kill(signal); };
+            emitter.closeInput = () => { child.stdin?.end(); };
+            child.stdout?.on('data', d => emitter.emit('data', d.toString('utf8')));
+            child.stderr?.on('data', d => emitter.emit('data', d.toString('utf8')));
+            child.on('exit', (code, signal) => {
+                emitter.emit('exit', { exitCode: code, signal: signal ?? null });
+            });
+            child.on('error', () => {
+                emitter.emit('exit', { exitCode: 127, signal: null });
+            });
+            return emitter;
+        },
+    };
+}
+// ── Standalone shell.exec (no PTY, no buffer; one-shot) ─────────────
+export async function shellExec(cmd, env, timeoutMs = 60_000) {
+    try {
+        const { stdout, stderr } = await execFileAsync('/bin/sh', ['-c', cmd], {
+            env: { ...process.env, ...(env ?? {}) },
+            timeout: timeoutMs,
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        return { stdout, stderr, exitCode: 0 };
+    }
+    catch (err) {
+        return {
+            stdout: err.stdout?.toString?.() ?? '',
+            stderr: err.stderr?.toString?.() ?? '',
+            exitCode: err.code ?? null,
+        };
+    }
+}
+//# sourceMappingURL=process-manager.js.map

package/dist/process-manager.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Worker-protocol envelope, mirroring backend/src/modules/mcp/types/
+ * worker-protocol.types.ts. Duplicated rather than imported because
+ * the runner can't depend on the backend package; we keep the two
+ * files structurally identical and bump the version constant in
+ * lockstep when the shape changes.
+ */
+export declare const WORKER_PROTOCOL_VERSION: 1;
+export type WorkerEnvelopeType = 'request' | 'response' | 'event' | 'heartbeat' | 'error';
+export interface WorkerEnvelope<T = unknown> {
+    v: typeof WORKER_PROTOCOL_VERSION;
+    type: WorkerEnvelopeType;
+    id: string;
+    seq?: number;
+    ts: number;
+    payload: T;
+}
+export interface WorkerErrorPayload {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export declare const WORKER_ERROR_CODES: {
+    readonly MALFORMED_ENVELOPE: -32700;
+    readonly UNKNOWN_SESSION: -32001;
+    readonly REPLAY_UNAVAILABLE: -32002;
+    readonly INTERNAL: -32603;
+};
+export declare function isWorkerEnvelope(value: unknown): value is WorkerEnvelope;
+/**
+ * Request payload shape: a method name + arbitrary params, just like
+ * JSON-RPC. The backend dispatches by method to one of the runner's
+ * registered handlers (process.spawn, runner.info, etc.).
+ */
+export interface RequestPayload {
+    method: string;
+    params: unknown;
+    /**
+     * Optional workspace scope. Most calls require it; runner.info()
+     * is the exception (returns global metadata, not workspace-scoped).
+     */
+    workspaceId?: string;
+}
+export interface ResponsePayload {
+    ok: boolean;
+    result?: unknown;
+    error?: WorkerErrorPayload;
+}
+export interface HeartbeatPayload {
+    ts: number;
+    /** Number of running processes the runner is currently hosting. */
+    inUse?: number;
+}

package/dist/protocol.js

@@ -0,0 +1,39 @@
+/**
+ * Worker-protocol envelope, mirroring backend/src/modules/mcp/types/
+ * worker-protocol.types.ts. Duplicated rather than imported because
+ * the runner can't depend on the backend package; we keep the two
+ * files structurally identical and bump the version constant in
+ * lockstep when the shape changes.
+ */
+export const WORKER_PROTOCOL_VERSION = 1;
+export const WORKER_ERROR_CODES = {
+    MALFORMED_ENVELOPE: -32700,
+    UNKNOWN_SESSION: -32001,
+    REPLAY_UNAVAILABLE: -32002,
+    INTERNAL: -32603,
+};
+export function isWorkerEnvelope(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const e = value;
+    if (e.v !== WORKER_PROTOCOL_VERSION)
+        return false;
+    if (typeof e.id !== 'string' || e.id.length === 0)
+        return false;
+    if (typeof e.ts !== 'number' || !Number.isFinite(e.ts))
+        return false;
+    if (e.seq !== undefined && (typeof e.seq !== 'number' || !Number.isFinite(e.seq)))
+        return false;
+    switch (e.type) {
+        case 'request':
+        case 'response':
+        case 'event':
+        case 'heartbeat':
+        case 'error': break;
+        default: return false;
+    }
+    if (!('payload' in e))
+        return false;
+    return true;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAU,CAAC;AAmBlD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,kBAAkB,EAAE,CAAC,KAAK;IAC1B,eAAe,EAAE,CAAC,KAAK;IACvB,kBAAkB,EAAE,CAAC,KAAK;IAC1B,QAAQ,EAAE,CAAC,KAAK;CACR,CAAC;AAEX,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,CAAC,CAAC,CAAC,KAAK,uBAAuB;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACrE,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAChG,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,SAAS,CAAC;QAAC,KAAK,UAAU,CAAC;QAAC,KAAK,OAAO,CAAC;QAAC,KAAK,WAAW,CAAC;QAAC,KAAK,OAAO,CAAC,CAAC,MAAM;QACrF,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC;IACxB,CAAC;IACD,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/runtime-info.d.ts

@@ -0,0 +1,23 @@
+import { ProbeExec } from './binaries.js';
+import { RunnerRuntimeInfo } from './types.js';
+/**
+ * Snapshot the runner's runtime characteristics.
+ *
+ * Every field here is detected, never settable from config. This is
+ * the read-only twin of the user's RunnerConfig: routing matches on
+ * either, but only the user can change RunnerConfig values, and
+ * only the runtime can produce these values.
+ *
+ * RUNNER_VERSION should track packages/runner/package.json. Bumping
+ * the package version without bumping this constant is a benign
+ * mismatch; the constant is what the backend records in the runner
+ * row's runtimeInfo.runnerVersion.
+ */
+export declare const RUNNER_VERSION = "0.1.0";
+export interface DetectInputs {
+    /** Override binary list. Defaults to the resolved config's list. */
+    binaries: string[];
+    /** Test injection point: stub child_process.spawn. */
+    exec?: ProbeExec;
+}
+export declare function detectRuntimeInfo(inputs: DetectInputs): Promise<RunnerRuntimeInfo>;

package/dist/runtime-info.js

@@ -0,0 +1,35 @@
+import { hostname, arch as osArch, platform as osPlatform, cpus, totalmem } from 'os';
+import { probeAll, realExec } from './binaries.js';
+import { detectCodingAgents } from './coding-agents/index.js';
+/**
+ * Snapshot the runner's runtime characteristics.
+ *
+ * Every field here is detected, never settable from config. This is
+ * the read-only twin of the user's RunnerConfig: routing matches on
+ * either, but only the user can change RunnerConfig values, and
+ * only the runtime can produce these values.
+ *
+ * RUNNER_VERSION should track packages/runner/package.json. Bumping
+ * the package version without bumping this constant is a benign
+ * mismatch; the constant is what the backend records in the runner
+ * row's runtimeInfo.runnerVersion.
+ */
+export const RUNNER_VERSION = '0.1.0';
+export async function detectRuntimeInfo(inputs) {
+    const exec = inputs.exec ?? realExec;
+    const [binaries, codingAgents] = await Promise.all([
+        probeAll(inputs.binaries, exec),
+        detectCodingAgents(exec),
+    ]);
+    return {
+        os: osPlatform(),
+        arch: osArch(),
+        hostname: hostname(),
+        cpuCount: cpus().length,
+        memoryMb: Math.round(totalmem() / (1024 * 1024)),
+        runnerVersion: RUNNER_VERSION,
+        binaries,
+        codingAgents,
+    };
+}
+//# sourceMappingURL=runtime-info.js.map

package/dist/runtime-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-info.js","sourceRoot":"","sources":["../src/runtime-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,IAAI,MAAM,EAAE,QAAQ,IAAI,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAEtF,OAAO,EAAE,QAAQ,EAAa,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAStC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAoB;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAC;IACrC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACjD,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC;QAC/B,kBAAkB,CAAC,IAAI,CAAC;KACzB,CAAC,CAAC;IACH,OAAO;QACL,EAAE,EAAE,UAAU,EAAE;QAChB,IAAI,EAAE,MAAM,EAAE;QACd,QAAQ,EAAE,QAAQ,EAAE;QACpB,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM;QACvB,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QAChD,aAAa,EAAE,cAAc;QAC7B,QAAQ;QACR,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/streamable-client.d.ts

@@ -0,0 +1,69 @@
+import { EventEmitter } from 'events';
+import { WorkerEnvelope } from './protocol.js';
+/**
+ * Client for the backend's Streamable HTTP endpoint at /mcp/streamable.
+ *
+ * Two responsibilities:
+ *
+ *   1. POST envelopes to the backend (client -> server). Used for
+ *      heartbeats, responses to dispatched requests, and unsolicited
+ *      events the runner wants to emit.
+ *   2. Maintain a long-lived GET stream (server -> client) that
+ *      reconnects on disconnect, replaying via Last-Event-ID. Each
+ *      received envelope is emitted as a typed `envelope` event the
+ *      handler registry subscribes to.
+ *
+ * Reconnect policy:
+ *   - Exponential backoff capped at 30s (1s, 2s, 4s, 8s, 16s, 30s, 30s).
+ *   - We track the last event id we successfully parsed; on reconnect
+ *     we send `Last-Event-ID` so the backend can replay anything we
+ *     missed.
+ *   - Reconnect attempts emit `reconnect` events for observability;
+ *     persistent failure emits `fatal` and the daemon exits.
+ *
+ * Auth: Bearer JWT in the Authorization header. The token comes from
+ * @almyty/client's resolveCredentials and is passed in at construct
+ * time; rotation isn't a v1.0 concern (the daemon restarts on token
+ * rotation anyway because credentials.json was overwritten).
+ */
+export interface StreamableClientOptions {
+    baseUrl: string;
+    token: string;
+    /** Test injection: replace the global fetch with a stub. */
+    fetch?: typeof globalThis.fetch;
+    /** Test injection: replace setTimeout with a controllable timer. */
+    setTimeoutFn?: typeof setTimeout;
+}
+export declare class StreamableClient extends EventEmitter {
+    private readonly opts;
+    private sessionId;
+    private lastEventId;
+    private streamAbort;
+    private stopped;
+    private reconnectAttempt;
+    private readonly fetchImpl;
+    private readonly setTimeoutFn;
+    constructor(opts: StreamableClientOptions);
+    /** Returns the session id once the first POST has assigned one. */
+    getSessionId(): string | null;
+    /** Send an envelope. Returns the parsed response envelope when the
+     *  backend hands one back inline (for unary requests); otherwise null. */
+    send<T>(env: WorkerEnvelope<T>): Promise<WorkerEnvelope | null>;
+    /** Open the GET stream and dispatch envelopes via emit('envelope'). */
+    openStream(): Promise<void>;
+    stop(): void;
+    /**
+     * SSE parser. The MCP Streamable HTTP wire format follows the SSE
+     * spec: events are separated by blank lines, fields are `id:`,
+     * `event:`, `data:`. We accept arbitrary header order and ignore
+     * unknown fields.
+     *
+     * Buffers across chunk boundaries because TCP doesn't respect SSE
+     * frame boundaries; one fetch chunk often contains a half-event.
+     */
+    private consumeStream;
+    private handleFrame;
+    private scheduleReconnect;
+}
+/** Helper to mint an envelope on the runner side. */
+export declare function envelope<T>(type: WorkerEnvelope['type'], payload: T, correlationId?: string): WorkerEnvelope<T>;