@almyty/runner 1.2.0

package/dist/daemon.js

@@ -0,0 +1,353 @@
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, chmodSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { resolveCredentialsOrExit } from '@almyty/client';
+import { loadConfig } from './config.js';
+import { detectRuntimeInfo, RUNNER_VERSION } from './runtime-info.js';
+import { createDefaultAdapterFactory, ProcessManager } from './process-manager.js';
+import { StreamableClient, envelope } from './streamable-client.js';
+import { dispatchHandler } from './handlers.js';
+import { CodingSessionManager } from './coding-sessions.js';
+const STATE_DIR = join(homedir(), '.almyty', 'runner');
+const PID_FILE = join(STATE_DIR, 'daemon.pid');
+const STATUS_FILE = join(STATE_DIR, 'status.json');
+const HEARTBEAT_INTERVAL_MS = 30_000;
+/** Backoff between session re-establish attempts after a 404 session-lost. */
+const SESSION_LOST_BACKOFF_MS = [500, 1_000, 2_000, 5_000, 10_000];
+/** Consecutive session-lost failures tolerated before exiting fatal. */
+const MAX_SESSION_LOST_STREAK = 8;
+/**
+ * Runner daemon. Responsibilities, in order:
+ *
+ *   1. Resolve config (defaults <- files <- env <- flags).
+ *   2. Resolve credentials (env <- ~/.almyty/credentials.json).
+ *   3. Detect runtime info + probe binaries.
+ *   4. POST /runners/register with the snapshot.
+ *   5. Open the Streamable HTTP stream and start dispatching incoming
+ *      envelopes to handlers.
+ *   6. Heartbeat every 30s.
+ *   7. On SIGTERM / SIGINT: send a final shutdown envelope, wait
+ *      briefly for in-flight responses, then exit.
+ *
+ * The daemon writes its PID and a status snapshot to ~/.almyty/runner/
+ * so `almyty runner status` and `almyty runner stop` can find it.
+ */
+export class RunnerDaemon {
+    resolved = null;
+    client = null;
+    processes = null;
+    coding = null;
+    runnerId = null;
+    heartbeatTimer = null;
+    status = null;
+    /** Guards against overlapping re-establish attempts. */
+    reestablishing = false;
+    /** Consecutive failed re-establish attempts; bounds the retry loop. */
+    sessionLostStreak = 0;
+    /**
+     * Bootstraps the daemon. Returns when the runner has registered and
+     * the stream is open. Errors here exit the process; caller is the
+     * CLI's `start` command, which doesn't try to recover from a failed
+     * register/connect — just prints and dies.
+     */
+    async start(flags) {
+        const resolved = loadConfig({ flags });
+        this.resolved = resolved;
+        const credentials = resolveCredentialsOrExit();
+        const backendUrl = resolved.backendUrl || credentials.url;
+        process.stdout.write(`almyty-runner v${RUNNER_VERSION} starting\n`);
+        process.stdout.write(`name=${resolved.name} url=${backendUrl}\n`);
+        // Detect runtime info before anything else; if a probe hangs (e.g.
+        // a misbehaving node-pty install) we want to fail fast here rather
+        // than after registration has succeeded.
+        const runtime = await detectRuntimeInfo({ binaries: resolved.binaryProbeList });
+        process.stdout.write(`detected ${Object.values(runtime.binaries).filter(v => v).length}/${resolved.binaryProbeList.length} binaries on PATH\n`);
+        // Register over the existing REST endpoint (POST /runners/register).
+        // Streamable HTTP isn't used for registration itself — registration
+        // is a one-shot HTTP exchange that returns the runner row plus the
+        // effective config, which we use to confirm what limits the backend
+        // applied. After registration we switch to Streamable HTTP for the
+        // long-lived connection.
+        const regResp = await fetch(`${backendUrl}/runners/register`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${credentials.token}`,
+            },
+            body: JSON.stringify({
+                name: resolved.name,
+                labels: resolved.labels,
+                runtimeInfo: runtime,
+                config: resolved.config,
+            }),
+        });
+        if (!regResp.ok) {
+            const text = await regResp.text();
+            throw new Error(`register failed: ${regResp.status} ${text}`);
+        }
+        const regBody = await regResp.json();
+        this.runnerId = regBody.data.runner.id;
+        process.stdout.write(`registered as ${this.runnerId}\n`);
+        // Construct the process manager with the effective config (backend
+        // may have constrained max_concurrent below what we requested).
+        const effective = regBody.data.effectiveConfig;
+        this.processes = new ProcessManager(createDefaultAdapterFactory(), effective.maxConcurrent);
+        // Coding-session registry for the chat bridge. Output events are sent
+        // through the same streamable client the heartbeats ride; the client is
+        // captured lazily so construction order doesn't matter.
+        this.coding = new CodingSessionManager(this.processes, (payload) => {
+            void this.client?.send(envelope('event', payload)).catch((err) => {
+                process.stderr.write(`coding event send failed: ${err?.message ?? err}\n`);
+            });
+        });
+        // Open the Streamable HTTP stream.
+        this.client = new StreamableClient({ baseUrl: backendUrl, token: credentials.token });
+        this.wireClient();
+        // First POST mints the session id; send a hello envelope so the
+        // backend's StreamableHttpTransport assigns one.
+        await this.client.send(envelope('event', { kind: 'runner.hello', runnerId: this.runnerId }));
+        await this.client.openStream();
+        // Heartbeat loop. This timer is deliberately REF'd: it is the daemon's
+        // keep-alive. The GET command stream can briefly drop (e.g. a reconnect
+        // after a wrong-replica 404), and during that gap the fetch handle is
+        // gone; if the heartbeat timer were unref'd, the event loop would drain
+        // and the process would exit(0) BEFORE the first heartbeat ever fired —
+        // so the runner could never report online. Keeping it ref'd holds the
+        // process up across stream gaps; SIGINT/SIGTERM clears it for a clean exit.
+        this.heartbeatTimer = setInterval(() => this.heartbeat().catch(err => {
+            process.stderr.write(`heartbeat failed: ${err.message}\n`);
+        }), HEARTBEAT_INTERVAL_MS);
+        // Send one immediately so the runner reports online within seconds rather
+        // than waiting a full interval for the first beat.
+        void this.heartbeat().catch(err => {
+            process.stderr.write(`initial heartbeat failed: ${err.message}\n`);
+        });
+        this.installSignalHandlers();
+        this.writeState({
+            pid: process.pid,
+            startedAt: new Date().toISOString(),
+            runnerName: resolved.name,
+            backendUrl,
+            runnerId: this.runnerId,
+            sessionId: this.client.getSessionId(),
+            inUseProcesses: 0,
+            connectionState: 'online',
+        });
+        process.stdout.write(`runner online; press ctrl-c to exit\n`);
+    }
+    /**
+     * Exit signal flow. On the first SIGINT/SIGTERM, transition to
+     * draining and inform the backend; on the second, hard exit.
+     */
+    installSignalHandlers() {
+        let drainingSent = false;
+        const handle = (sig) => {
+            if (drainingSent) {
+                process.stderr.write(`\nsecond ${sig}; force exit\n`);
+                process.exit(1);
+            }
+            drainingSent = true;
+            process.stderr.write(`\n${sig} received; draining...\n`);
+            this.gracefulShutdown().finally(() => process.exit(0));
+        };
+        process.on('SIGINT', () => handle('SIGINT'));
+        process.on('SIGTERM', () => handle('SIGTERM'));
+    }
+    async gracefulShutdown() {
+        try {
+            if (this.heartbeatTimer)
+                clearInterval(this.heartbeatTimer);
+            if (this.client) {
+                await this.client.send(envelope('event', { kind: 'runner.draining' })).catch(() => { });
+                this.client.stop();
+            }
+            this.deleteState();
+        }
+        catch (err) {
+            process.stderr.write(`shutdown error: ${err.message}\n`);
+        }
+    }
+    wireClient() {
+        if (!this.client)
+            return;
+        this.client.on('envelope', (env) => {
+            if (env.type === 'request') {
+                this.handleRequest(env).catch(err => {
+                    process.stderr.write(`request handling error: ${err.message}\n`);
+                });
+            }
+            // Heartbeat / event envelopes from the server are observational;
+            // the runner doesn't react to them in v1.0.
+        });
+        this.client.on('reconnect', info => {
+            process.stderr.write(`reconnecting (attempt ${info.attempt}, delay ${info.delayMs}ms): ${info.reason}\n`);
+            this.updateState({ connectionState: 'reconnecting' });
+        });
+        this.client.on('open', () => {
+            this.updateState({ connectionState: 'online', sessionId: this.client?.getSessionId() ?? null });
+        });
+        this.client.on('session-lost', () => {
+            // The backend forgot our session (404 UNKNOWN_SESSION). The common
+            // cause is a multi-replica backend with pod-local streamable sessions:
+            // our mint-POST landed on one pod and the GET stream load-balanced to
+            // another that never saw the session. Exiting here was too fragile —
+            // a single wrong-replica hit killed the runner permanently. Instead,
+            // re-establish a fresh session (re-mint + reopen the stream). The
+            // client already cleared its session id, so the next send mints a new
+            // one; with backoff this lands on a consistent pod and stays online.
+            void this.reestablishSession();
+        });
+    }
+    async handleRequest(req) {
+        // Trust model: inbound requests are trusted at the CHANNEL level. The
+        // runner authenticates itself to the backend at registration, the
+        // command stream rides the resulting authenticated session, and the
+        // backend URL is required to be https for any non-loopback host (see
+        // config.ts), which closes the MITM / stream-injection vectors. We do
+        // NOT additionally verify a per-request signature here — that would
+        // defend against a *compromised backend* and needs a coordinated
+        // backend signing scheme (tracked separately). Each command is still
+        // gated by the execution policy (isolation/deny/cwd/env) before it runs.
+        if (!this.processes || !this.client || !this.resolved)
+            return;
+        const ctx = {
+            processes: this.processes,
+            runnerName: this.resolved.name,
+            labels: this.resolved.labels,
+            maxConcurrent: this.resolved.config.maxConcurrent,
+            config: this.resolved.config,
+            coding: this.coding ?? undefined,
+        };
+        const response = await dispatchHandler(ctx, req.payload);
+        await this.client.send(envelope('response', response, req.id));
+    }
+    async heartbeat() {
+        if (!this.client || !this.processes)
+            return;
+        const inUse = this.processes.inUse();
+        await this.client.send(envelope('heartbeat', { ts: Date.now(), inUse }));
+        this.updateState({ inUseProcesses: inUse });
+    }
+    /**
+     * Re-establish the command stream after a session-lost (404). Re-mints a
+     * session (hello envelope) and reopens the GET stream, with backoff. Only
+     * gives up — exiting fatal — after MAX_SESSION_LOST_STREAK consecutive
+     * failures, so a transient wrong-replica hit recovers transparently while a
+     * genuinely-down backend still terminates rather than spinning forever.
+     */
+    async reestablishSession() {
+        if (this.reestablishing || !this.client)
+            return;
+        this.reestablishing = true;
+        this.updateState({ connectionState: 'reconnecting' });
+        try {
+            this.sessionLostStreak++;
+            if (this.sessionLostStreak > MAX_SESSION_LOST_STREAK) {
+                process.stderr.write(`backend session lost ${this.sessionLostStreak}x in a row; giving up\n`);
+                this.updateState({ connectionState: 'fatal' });
+                process.exit(2);
+            }
+            const delay = SESSION_LOST_BACKOFF_MS[Math.min(this.sessionLostStreak - 1, SESSION_LOST_BACKOFF_MS.length - 1)];
+            process.stderr.write(`backend session lost; re-establishing in ${delay}ms (attempt ${this.sessionLostStreak})\n`);
+            await new Promise(r => setTimeout(r, delay));
+            // Re-mint a session (client already cleared the stale id) and reopen.
+            await this.client.send(envelope('event', { kind: 'runner.hello', runnerId: this.runnerId }));
+            await this.client.openStream();
+            // openStream's 'open' event resets connectionState to 'online'; a clean
+            // reopen means the streak is broken.
+            this.sessionLostStreak = 0;
+            this.updateState({ connectionState: 'online', sessionId: this.client.getSessionId() });
+            process.stdout.write('backend session re-established\n');
+        }
+        catch (err) {
+            process.stderr.write(`re-establish failed: ${err?.message ?? err}\n`);
+            // Retry: openStream/send failures schedule the client's own reconnect,
+            // and another session-lost will re-enter here; release the guard so it can.
+        }
+        finally {
+            this.reestablishing = false;
+        }
+    }
+    writeState(s) {
+        // status.json holds the sessionId (bearer-equivalent for the command
+        // channel) — keep the dir and file owner-only.
+        mkdirSync(STATE_DIR, { recursive: true, mode: 0o700 });
+        try {
+            chmodSync(STATE_DIR, 0o700);
+        }
+        catch { /* best-effort */ }
+        writeFileSync(PID_FILE, String(s.pid));
+        writeFileSync(STATUS_FILE, JSON.stringify(s, null, 2), { mode: 0o600 });
+        try {
+            chmodSync(STATUS_FILE, 0o600);
+        }
+        catch { /* best-effort */ }
+        this.status = s;
+    }
+    updateState(patch) {
+        if (!this.status)
+            return;
+        this.status = { ...this.status, ...patch };
+        try {
+            writeFileSync(STATUS_FILE, JSON.stringify(this.status, null, 2));
+        }
+        catch { /* */ }
+    }
+    deleteState() {
+        try {
+            unlinkSync(PID_FILE);
+        }
+        catch { /* */ }
+        try {
+            unlinkSync(STATUS_FILE);
+        }
+        catch { /* */ }
+    }
+}
+// ── status / stop helpers (used by CLI subcommands) ─────────────────
+export function readStatus() {
+    try {
+        if (!existsSync(STATUS_FILE))
+            return null;
+        const raw = readFileSync(STATUS_FILE, 'utf-8');
+        const status = JSON.parse(raw);
+        if (!isAlive(status.pid)) {
+            // Stale state file: PID's gone.
+            try {
+                unlinkSync(STATUS_FILE);
+            }
+            catch { /* */ }
+            try {
+                unlinkSync(PID_FILE);
+            }
+            catch { /* */ }
+            return null;
+        }
+        return status;
+    }
+    catch {
+        return null;
+    }
+}
+export function stopDaemon() {
+    const status = readStatus();
+    if (!status)
+        return false;
+    try {
+        process.kill(status.pid, 'SIGTERM');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

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

package/dist/handlers.d.ts

@@ -0,0 +1,39 @@
+import { ProcessManager } from './process-manager.js';
+import { detectRuntimeInfo } from './runtime-info.js';
+import { RequestPayload, ResponsePayload } from './protocol.js';
+import { type ProbeExec } from './binaries.js';
+import { CodingSessionManager } from './coding-sessions.js';
+import { RunnerConfig } from './types.js';
+/**
+ * Runner-side method dispatch. The protocol surface is the public
+ * v1.0 contract documented in the runner spec; method names are
+ * dotted strings ("process.spawn", "shell.exec", "runner.info").
+ *
+ * Every handler:
+ *   - Pulls workspaceId out of the request payload (required for
+ *     process.* and shell.*; optional for runner.info).
+ *   - Validates params just enough to surface a typed error
+ *     (RunnerError with a code) rather than crashing.
+ *   - Returns a ResponsePayload with ok=true|false; the daemon wraps
+ *     it in a `response` envelope and posts it back over the
+ *     Streamable HTTP transport.
+ *
+ * Error mapping: unhandled exceptions become INTERNAL responses; any
+ * RunnerError surfaces with its own code intact so the agent can
+ * reason about retryability.
+ */
+export interface HandlerContext {
+    processes: ProcessManager;
+    runnerName: string;
+    labels: Record<string, string>;
+    maxConcurrent: number;
+    /** Runner execution policy (isolation, denyPatterns, cwd roots, …). */
+    config: RunnerConfig;
+    /** Test injection point for runner.info; returns the cached probe map. */
+    cachedRuntimeInfo?: Awaited<ReturnType<typeof detectRuntimeInfo>>;
+    /** Coding-session registry (chat-to-runner bridge); wired by the daemon. */
+    coding?: CodingSessionManager;
+    /** Test injection for coding.list's binary probing. */
+    probeExec?: ProbeExec;
+}
+export declare function dispatchHandler(ctx: HandlerContext, req: RequestPayload): Promise<ResponsePayload>;