@founderos/runner 0.1.1

package/dist/spawn.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Spawn `claude` CLI for a claimed runner job. Streams stream-json from
+ * stdout, parses each line into a typed event, and emits events via the
+ * caller's `onEvent` callback. The caller is responsible for batching and
+ * shipping events back to the cloud (see api.ts appendEvents).
+ *
+ * Why we don't use `claude --output-format=stream-json` for everything:
+ *   `claude --print -` accepts the prompt on stdin and writes mixed stdout —
+ *   stream-json events when `--output-format=stream-json` is set, plain text
+ *   otherwise. We always set stream-json so parsing is uniform. Lines that
+ *   fail JSON.parse are surfaced as `stdout_line` raw text events (so noisy
+ *   stderr output from claude's setup phase is still visible to ops).
+ *
+ * Result extraction: the LAST `claude_result` event (kind `result` in
+ * stream-json terms) carries the cost + sessionId. We snapshot it so the
+ * caller can read it after the child exits.
+ */
+import { spawn } from "node:child_process";
+import { type RunnerEvent } from "./api.js";
+export interface SpawnArgs {
+    binary: string;
+    prompt: string;
+    sessionId?: string | null;
+    model?: string | null;
+    maxTurns?: number | null;
+    /** Base64 contents of the agent's append-system-prompt file. */
+    instructionsBase64?: string | null;
+    /** Hard timeout — if claude doesn't exit by then, we SIGTERM then SIGKILL. */
+    timeoutSec: number;
+    /** Working directory for the spawned claude. Defaults to cwd. */
+    cwd?: string;
+    /** Optional --add-dir entries the cloud suggested. */
+    addDirs?: string[];
+}
+export interface SpawnResult {
+    exitCode: number;
+    signal: string | null;
+    elapsedSec: number;
+    /** True iff we killed the process due to the timeout. */
+    timedOut: boolean;
+    /** Captured `result` event from stream-json — null if claude never emitted one. */
+    finalResult: {
+        sessionId?: string | null;
+        costUsd?: number | null;
+        raw: Record<string, unknown>;
+    } | null;
+}
+/**
+ * Build the claude CLI argv. Kept pure so it's unit-testable without
+ * actually spawning a child.
+ */
+export declare function buildClaudeArgs(args: {
+    sessionId?: string | null;
+    model?: string | null;
+    maxTurns?: number | null;
+    instructionsFilePath?: string | null;
+    addDirs?: string[];
+}): string[];
+/**
+ * Parse one line of claude stream-json into a RunnerEvent. The mapping
+ * follows ADR-011 § "Event taxonomy":
+ *   - `assistant` / `user` messages → claude_message
+ *   - `tool_use` blocks → claude_tool_use
+ *   - `tool_result` blocks → claude_tool_result
+ *   - `result` (final stats) → claude_result
+ *   - anything else → stdout_line (raw)
+ */
+export declare function parseStreamJsonLine(line: string): RunnerEvent | null;
+/**
+ * Materialize the base64 instructions blob to a tempfile so claude can
+ * `--append-system-prompt-file` it. Returns the path; caller is responsible
+ * for cleanup (we surface the cleanup function to keep this composable).
+ */
+export declare function materializeInstructions(base64: string): Promise<{
+    path: string;
+    cleanup: () => Promise<void>;
+}>;
+/**
+ * Run claude end-to-end. Streams events, enforces timeout, returns the
+ * captured final result. Tests can substitute `spawnImpl` to run a mock
+ * binary that prints scripted stream-json.
+ */
+export declare function runClaude(args: SpawnArgs, hooks: {
+    onEvent: (evt: RunnerEvent) => void | Promise<void>;
+}, spawnImpl?: typeof spawn): Promise<SpawnResult>;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../src/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAO9D,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,QAAQ,EAAE,OAAO,CAAC;IAClB,mFAAmF;IACnF,WAAW,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;CAC1G;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,MAAM,EAAE,CAkBX;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAmEpE;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAezD;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,SAAS,EACf,KAAK,EAAE;IACL,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD,EACD,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,WAAW,CAAC,CAwHtB"}

package/dist/spawn.js

@@ -0,0 +1,264 @@
+/**
+ * Spawn `claude` CLI for a claimed runner job. Streams stream-json from
+ * stdout, parses each line into a typed event, and emits events via the
+ * caller's `onEvent` callback. The caller is responsible for batching and
+ * shipping events back to the cloud (see api.ts appendEvents).
+ *
+ * Why we don't use `claude --output-format=stream-json` for everything:
+ *   `claude --print -` accepts the prompt on stdin and writes mixed stdout —
+ *   stream-json events when `--output-format=stream-json` is set, plain text
+ *   otherwise. We always set stream-json so parsing is uniform. Lines that
+ *   fail JSON.parse are surfaced as `stdout_line` raw text events (so noisy
+ *   stderr output from claude's setup phase is still visible to ops).
+ *
+ * Result extraction: the LAST `claude_result` event (kind `result` in
+ * stream-json terms) carries the cost + sessionId. We snapshot it so the
+ * caller can read it after the child exits.
+ */
+import { spawn } from "node:child_process";
+import { setTimeout as sleep } from "node:timers/promises";
+import { writeFile, mkdtemp, rm } from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+import { performance } from "node:perf_hooks";
+import { makeEventId } from "./api.js";
+/**
+ * Build the claude CLI argv. Kept pure so it's unit-testable without
+ * actually spawning a child.
+ */
+export function buildClaudeArgs(args) {
+    const argv = ["--print", "-", "--output-format", "stream-json", "--verbose"];
+    if (args.sessionId) {
+        argv.push("--resume", args.sessionId);
+    }
+    if (args.model) {
+        argv.push("--model", args.model);
+    }
+    if (typeof args.maxTurns === "number" && args.maxTurns > 0) {
+        argv.push("--max-turns", String(args.maxTurns));
+    }
+    if (args.instructionsFilePath) {
+        argv.push("--append-system-prompt-file", args.instructionsFilePath);
+    }
+    for (const dir of args.addDirs ?? []) {
+        argv.push("--add-dir", dir);
+    }
+    return argv;
+}
+/**
+ * Parse one line of claude stream-json into a RunnerEvent. The mapping
+ * follows ADR-011 § "Event taxonomy":
+ *   - `assistant` / `user` messages → claude_message
+ *   - `tool_use` blocks → claude_tool_use
+ *   - `tool_result` blocks → claude_tool_result
+ *   - `result` (final stats) → claude_result
+ *   - anything else → stdout_line (raw)
+ */
+export function parseStreamJsonLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    // Try strict JSON first.
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return {
+            eventId: makeEventId(),
+            kind: "stdout_line",
+            ts: new Date().toISOString(),
+            payload: trimmed,
+        };
+    }
+    if (!parsed || typeof parsed !== "object") {
+        return {
+            eventId: makeEventId(),
+            kind: "stdout_line",
+            ts: new Date().toISOString(),
+            payload: trimmed,
+        };
+    }
+    const obj = parsed;
+    const type = typeof obj.type === "string" ? obj.type : "";
+    if (type === "result") {
+        return {
+            eventId: makeEventId(),
+            kind: "claude_result",
+            ts: new Date().toISOString(),
+            payload: obj,
+        };
+    }
+    if (type === "assistant" || type === "user" || type === "system") {
+        return {
+            eventId: makeEventId(),
+            kind: "claude_message",
+            ts: new Date().toISOString(),
+            payload: obj,
+        };
+    }
+    if (type === "tool_use") {
+        return {
+            eventId: makeEventId(),
+            kind: "claude_tool_use",
+            ts: new Date().toISOString(),
+            payload: obj,
+        };
+    }
+    if (type === "tool_result") {
+        return {
+            eventId: makeEventId(),
+            kind: "claude_tool_result",
+            ts: new Date().toISOString(),
+            payload: obj,
+        };
+    }
+    return {
+        eventId: makeEventId(),
+        kind: "stdout_line",
+        ts: new Date().toISOString(),
+        payload: obj,
+    };
+}
+/**
+ * Materialize the base64 instructions blob to a tempfile so claude can
+ * `--append-system-prompt-file` it. Returns the path; caller is responsible
+ * for cleanup (we surface the cleanup function to keep this composable).
+ */
+export async function materializeInstructions(base64) {
+    const dir = await mkdtemp(path.join(os.tmpdir(), "founderos-runner-"));
+    const filePath = path.join(dir, "instructions.md");
+    const buf = Buffer.from(base64, "base64");
+    await writeFile(filePath, buf);
+    return {
+        path: filePath,
+        cleanup: async () => {
+            try {
+                await rm(dir, { recursive: true, force: true });
+            }
+            catch {
+                /* best-effort */
+            }
+        },
+    };
+}
+/**
+ * Run claude end-to-end. Streams events, enforces timeout, returns the
+ * captured final result. Tests can substitute `spawnImpl` to run a mock
+ * binary that prints scripted stream-json.
+ */
+export async function runClaude(args, hooks, spawnImpl = spawn) {
+    let cleanup = null;
+    let instructionsPath = null;
+    if (args.instructionsBase64) {
+        const m = await materializeInstructions(args.instructionsBase64);
+        instructionsPath = m.path;
+        cleanup = m.cleanup;
+    }
+    const argv = buildClaudeArgs({
+        sessionId: args.sessionId,
+        model: args.model,
+        maxTurns: args.maxTurns,
+        instructionsFilePath: instructionsPath,
+        addDirs: args.addDirs,
+    });
+    const startedAt = performance.now();
+    const child = spawnImpl(args.binary, argv, {
+        cwd: args.cwd,
+        stdio: ["pipe", "pipe", "pipe"],
+        env: process.env,
+    });
+    let timedOut = false;
+    let finalResult = null;
+    // Hard kill after 1.5x timeout if SIGTERM didn't land.
+    const termTimer = setTimeout(() => {
+        timedOut = true;
+        if (!child.killed)
+            child.kill("SIGTERM");
+    }, args.timeoutSec * 1000);
+    const killTimer = setTimeout(() => {
+        if (!child.killed)
+            child.kill("SIGKILL");
+    }, args.timeoutSec * 1000 * 1.5);
+    // stdin: write the prompt then close.
+    if (child.stdin) {
+        child.stdin.write(args.prompt);
+        child.stdin.end();
+    }
+    // Line-buffer stdout. claude emits one JSON object per line in
+    // stream-json mode; partial lines accumulate until the next \n.
+    let stdoutBuf = "";
+    child.stdout?.setEncoding("utf-8");
+    child.stdout?.on("data", (chunk) => {
+        stdoutBuf += chunk;
+        let nl;
+        while ((nl = stdoutBuf.indexOf("\n")) >= 0) {
+            const line = stdoutBuf.slice(0, nl);
+            stdoutBuf = stdoutBuf.slice(nl + 1);
+            const evt = parseStreamJsonLine(line);
+            if (!evt)
+                continue;
+            if (evt.kind === "claude_result" && typeof evt.payload === "object" && evt.payload) {
+                const p = evt.payload;
+                finalResult = {
+                    sessionId: typeof p.session_id === "string" ? p.session_id : null,
+                    costUsd: typeof p.total_cost_usd === "number" ? p.total_cost_usd : null,
+                    raw: p,
+                };
+            }
+            void hooks.onEvent(evt);
+        }
+    });
+    // stderr: surface as raw stderr_line events. Don't try to parse —
+    // claude's stderr is human-readable diagnostics, not stream-json.
+    let stderrBuf = "";
+    child.stderr?.setEncoding("utf-8");
+    child.stderr?.on("data", (chunk) => {
+        stderrBuf += chunk;
+        let nl;
+        while ((nl = stderrBuf.indexOf("\n")) >= 0) {
+            const line = stderrBuf.slice(0, nl);
+            stderrBuf = stderrBuf.slice(nl + 1);
+            if (!line.trim())
+                continue;
+            void hooks.onEvent({
+                eventId: makeEventId(),
+                kind: "stderr_line",
+                ts: new Date().toISOString(),
+                payload: line,
+            });
+        }
+    });
+    const exit = await new Promise((resolve) => {
+        child.once("exit", (code, signal) => resolve({ code: code ?? -1, signal }));
+        child.once("error", () => resolve({ code: -1, signal: null }));
+    });
+    // Drain any trailing partial line.
+    if (stdoutBuf.trim()) {
+        const evt = parseStreamJsonLine(stdoutBuf);
+        if (evt)
+            await hooks.onEvent(evt);
+    }
+    if (stderrBuf.trim()) {
+        await hooks.onEvent({
+            eventId: makeEventId(),
+            kind: "stderr_line",
+            ts: new Date().toISOString(),
+            payload: stderrBuf,
+        });
+    }
+    clearTimeout(termTimer);
+    clearTimeout(killTimer);
+    if (cleanup)
+        await cleanup();
+    // Tiny sleep to let any straggler stream events flush through onEvent.
+    await sleep(10);
+    return {
+        exitCode: exit.code,
+        signal: exit.signal,
+        elapsedSec: (performance.now() - startedAt) / 1000,
+        timedOut,
+        finalResult,
+    };
+}
+//# sourceMappingURL=spawn.js.map

package/dist/spawn.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const RUNNER_VERSION = "0.1.1";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,5 @@
+// Sourced from package.json at install time. Bumping this should match a
+// `npm version` so the runner identifies itself accurately to the cloud
+// (used in `cliVersion` field of /jobs/:id/complete).
+export const RUNNER_VERSION = "0.1.1";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,wEAAwE;AACxE,sDAAsD;AACtD,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@founderos/runner",
+  "version": "0.1.1",
+  "description": "FounderOS local runner — polls cloud, spawns claude CLI under your Pro session, streams events back. ADR-011.",
+  "license": "MIT",
+  "homepage": "https://github.com/founderos-ai/founderos",
+  "bugs": {
+    "url": "https://github.com/founderos-ai/founderos/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/founderos-ai/founderos",
+    "directory": "packages/runner"
+  },
+  "type": "module",
+  "bin": {
+    "founderos-runner": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "typescript": "^5.7.3",
+    "vitest": "^3.2.4"
+  }
+}