cueline 0.1.0

package/dist/src/router/config-loader.js

@@ -0,0 +1,92 @@
+import { readFile } from "node:fs/promises";
+import { CueLineError } from "../core/errors.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function invalid(message, details) {
+    return new CueLineError("ROUTING_CONFIG_INVALID", message, { details });
+}
+function parseCandidate(value, lane, index) {
+    if (!isRecord(value)) {
+        throw invalid("route candidate must be an object", { lane, index });
+    }
+    const { id, argv, task_input, enabled } = value;
+    if (typeof id !== "string" || id.trim().length === 0) {
+        throw invalid("route candidate id must be a non-empty string", { lane, index });
+    }
+    if (!Array.isArray(argv) || argv.length === 0 || argv.some((part) => typeof part !== "string" || part.length === 0)) {
+        throw invalid("route candidate argv must contain non-empty strings", { lane, index });
+    }
+    if (enabled !== undefined && typeof enabled !== "boolean") {
+        throw invalid("route candidate enabled must be a boolean", { lane, index });
+    }
+    if (task_input !== undefined && task_input !== "argv" && task_input !== "stdin") {
+        throw invalid("route candidate task_input must be argv or stdin", { lane, index });
+    }
+    return {
+        id,
+        argv: [...argv],
+        ...(task_input === undefined ? {} : { task_input }),
+        ...(enabled === undefined ? {} : { enabled }),
+    };
+}
+function parseLane(value, lane) {
+    if (!isRecord(value)) {
+        throw invalid("lane configuration must be an object", { lane });
+    }
+    const { enabled, candidates } = value;
+    if (typeof enabled !== "boolean") {
+        throw invalid("lane enabled must be a boolean", { lane });
+    }
+    if (!Array.isArray(candidates) || candidates.length === 0) {
+        throw invalid("lane candidates must be a non-empty array", { lane });
+    }
+    const parsedCandidates = candidates.map((candidate, index) => parseCandidate(candidate, lane, index));
+    const identifiers = new Set();
+    for (const candidate of parsedCandidates) {
+        if (identifiers.has(candidate.id)) {
+            throw invalid("lane candidate ids must be unique", { lane, id: candidate.id });
+        }
+        identifiers.add(candidate.id);
+    }
+    return { enabled, candidates: parsedCandidates };
+}
+export function parseRoutingConfig(value) {
+    if (!isRecord(value)) {
+        throw invalid("routing configuration must be an object");
+    }
+    if (value.version !== 1) {
+        throw invalid("routing configuration version must be 1", { version: value.version });
+    }
+    if (!isRecord(value.lanes) || Object.keys(value.lanes).length === 0) {
+        throw invalid("routing configuration must define at least one lane");
+    }
+    const lanes = {};
+    for (const [lane, laneValue] of Object.entries(value.lanes)) {
+        if (lane.trim().length === 0) {
+            throw invalid("lane name must be non-empty");
+        }
+        lanes[lane] = parseLane(laneValue, lane);
+    }
+    return { version: 1, lanes };
+}
+export async function loadRoutingConfig(filePath) {
+    let source;
+    try {
+        source = await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        throw new CueLineError("ROUTING_CONFIG_READ_FAILED", `unable to read routing config: ${filePath}`, {
+            cause: error,
+        });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(source);
+    }
+    catch (error) {
+        throw new CueLineError("ROUTING_CONFIG_INVALID", "routing config is not valid JSON", { cause: error });
+    }
+    return parseRoutingConfig(parsed);
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/src/router/config-loader.js.map

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

package/dist/src/router/materialize.d.ts

@@ -0,0 +1,8 @@
+import type { ControllerJobSpec } from "../protocol/types.js";
+import type { RunnerSpec } from "../runners/runner-adapter.js";
+import type { ResolvedRoute } from "./types.js";
+export interface MaterializeRunnerOptions {
+    cwd?: string;
+    timeoutMs?: number;
+}
+export declare function materializeRunnerSpec(jobId: string, job: ControllerJobSpec, route: ResolvedRoute, options?: MaterializeRunnerOptions): RunnerSpec;

package/dist/src/router/materialize.js

@@ -0,0 +1,39 @@
+import { CueLineError } from "../core/errors.js";
+import { runtimeCwd } from "../core/runtime.js";
+const TOKEN_PATTERN = /\{(job_id|lane|mode|sandbox|task|workdir)\}/g;
+export function materializeRunnerSpec(jobId, job, route, options = {}) {
+    const cwd = job.workdir ?? options.cwd ?? runtimeCwd();
+    const taskInput = route.candidate.task_input ?? "argv";
+    let placedTask = false;
+    const values = {
+        job_id: jobId,
+        lane: route.lane,
+        mode: job.mode,
+        sandbox: job.mode === "advise" ? "read-only" : "workspace-write",
+        task: job.task,
+        workdir: cwd,
+    };
+    const argv = route.candidate.argv.map((part) => part.replace(TOKEN_PATTERN, (_match, token) => {
+        if (token === "task")
+            placedTask = true;
+        return values[token] ?? "";
+    }));
+    if (taskInput === "argv" && !placedTask) {
+        throw new CueLineError("ROUTE_TEMPLATE_TASK_MISSING", `runner '${route.candidate.id}' uses argv input but has no {task} placeholder`, { details: { lane: route.lane, candidate: route.candidate.id } });
+    }
+    if (taskInput === "stdin" && placedTask) {
+        throw new CueLineError("ROUTE_TEMPLATE_TASK_DUPLICATE", `runner '${route.candidate.id}' cannot use both stdin and a {task} placeholder`, { details: { lane: route.lane, candidate: route.candidate.id } });
+    }
+    return {
+        jobId,
+        argv,
+        ...(taskInput === "stdin" ? { stdin: job.task } : {}),
+        mode: job.mode,
+        timeoutMs: job.timeout_ms ?? options.timeoutMs ?? 10 * 60 * 1_000,
+        lane: route.lane,
+        task: job.task,
+        cwd,
+        ...(job.background === undefined ? {} : { background: job.background }),
+    };
+}
+//# sourceMappingURL=materialize.js.map

package/dist/src/router/materialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize.js","sourceRoot":"","sources":["../../../src/router/materialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAUhD,MAAM,aAAa,GAAG,8CAA8C,CAAC;AAErE,MAAM,UAAU,qBAAqB,CACnC,KAAa,EACb,GAAsB,EACtB,KAAoB,EACpB,OAAO,GAA6B,EAAE;IAEtC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,CAAC;IACvD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,UAAU,IAAI,MAAM,CAAC;IACvD,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,MAAM,MAAM,GAA2B;QACrC,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB;QAChE,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG;KACb,CAAC;IACF,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC7C,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,KAAa,EAAE,EAAE;QACpD,IAAI,KAAK,KAAK,MAAM;YAAE,UAAU,GAAG,IAAI,CAAC;QACxC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC,CAAC,CACH,CAAC;IAEF,IAAI,SAAS,KAAK,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,MAAM,IAAI,YAAY,CACpB,6BAA6B,EAC7B,WAAW,KAAK,CAAC,SAAS,CAAC,EAAE,iDAAiD,EAC9E,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CACjE,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,KAAK,OAAO,IAAI,UAAU,EAAE,CAAC;QACxC,MAAM,IAAI,YAAY,CACpB,+BAA+B,EAC/B,WAAW,KAAK,CAAC,SAAS,CAAC,EAAE,kDAAkD,EAC/E,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CACjE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK;QACL,IAAI;QACJ,GAAG,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,SAAS,EAAE,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,SAAS,IAAI,EAAE,GAAG,EAAE,GAAG,KAAK;QACjE,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,GAAG;QACH,GAAG,CAAC,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;KACxE,CAAC;AACJ,CAAC"}

package/dist/src/router/resolver.d.ts

@@ -0,0 +1,6 @@
+import type { ResolvedRoute, RouteAvailability, RoutingConfig } from "./types.js";
+/**
+ * Chooses a candidate before any runner is invoked. This function never spawns
+ * a process and therefore cannot perform post-spawn fallback.
+ */
+export declare function resolveRoute(lane: string, config: RoutingConfig, availability: RouteAvailability, requestedCandidateId?: string): ResolvedRoute;

package/dist/src/router/resolver.js

@@ -0,0 +1,55 @@
+import { CueLineError } from "../core/errors.js";
+function isAvailabilityChecker(value) {
+    return typeof value === "object" && value !== null && "isAvailable" in value;
+}
+function isAvailable(availability, candidate, lane) {
+    if (typeof availability === "function") {
+        return availability(candidate, lane);
+    }
+    if (isAvailabilityChecker(availability)) {
+        return availability.isAvailable(candidate, lane);
+    }
+    return availability[candidate.id] === true;
+}
+/**
+ * Chooses a candidate before any runner is invoked. This function never spawns
+ * a process and therefore cannot perform post-spawn fallback.
+ */
+export function resolveRoute(lane, config, availability, requestedCandidateId) {
+    const laneConfig = config.lanes[lane];
+    if (laneConfig === undefined) {
+        throw new CueLineError("ROUTE_LANE_UNKNOWN", `unknown routing lane: ${lane}`, { details: { lane } });
+    }
+    if (!laneConfig.enabled) {
+        throw new CueLineError("ROUTE_LANE_DISABLED", `routing lane is disabled: ${lane}`, {
+            details: { lane },
+        });
+    }
+    if (requestedCandidateId !== undefined) {
+        const candidateIndex = laneConfig.candidates.findIndex((candidate) => candidate.id === requestedCandidateId);
+        if (candidateIndex < 0) {
+            throw new CueLineError("ROUTE_RUNNER_UNKNOWN", `runner '${requestedCandidateId}' is not configured for lane: ${lane}`, { details: { lane, runner: requestedCandidateId } });
+        }
+        const candidate = laneConfig.candidates[candidateIndex];
+        if (candidate === undefined || candidate.enabled === false) {
+            throw new CueLineError("ROUTE_RUNNER_DISABLED", `runner '${requestedCandidateId}' is disabled for lane: ${lane}`, { details: { lane, runner: requestedCandidateId } });
+        }
+        if (!isAvailable(availability, candidate, lane)) {
+            throw new CueLineError("ROUTE_RUNNER_UNAVAILABLE", `runner '${requestedCandidateId}' is unavailable for lane: ${lane}`, { details: { lane, runner: requestedCandidateId } });
+        }
+        return { lane, candidate, candidateIndex };
+    }
+    for (let candidateIndex = 0; candidateIndex < laneConfig.candidates.length; candidateIndex += 1) {
+        const candidate = laneConfig.candidates[candidateIndex];
+        if (candidate === undefined || candidate.enabled === false) {
+            continue;
+        }
+        if (isAvailable(availability, candidate, lane)) {
+            return { lane, candidate, candidateIndex };
+        }
+    }
+    throw new CueLineError("ROUTE_NO_CANDIDATE", `no available candidate for routing lane: ${lane}`, {
+        details: { lane },
+    });
+}
+//# sourceMappingURL=resolver.js.map

package/dist/src/router/resolver.js.map

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

package/dist/src/router/types.d.ts

@@ -0,0 +1,24 @@
+export interface RouteCandidate {
+    id: string;
+    argv: readonly string[];
+    task_input?: "argv" | "stdin";
+    enabled?: boolean;
+}
+export interface LaneConfig {
+    enabled: boolean;
+    candidates: readonly RouteCandidate[];
+}
+export interface RoutingConfig {
+    version: 1;
+    lanes: Readonly<Record<string, LaneConfig>>;
+}
+export type CandidateAvailability = (candidate: RouteCandidate, lane: string) => boolean;
+export interface CandidateAvailabilityChecker {
+    isAvailable(candidate: RouteCandidate, lane: string): boolean;
+}
+export type RouteAvailability = CandidateAvailability | CandidateAvailabilityChecker | Readonly<Record<string, boolean | undefined>>;
+export interface ResolvedRoute {
+    lane: string;
+    candidate: RouteCandidate;
+    candidateIndex: number;
+}

package/dist/src/router/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/router/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/router/types.ts"],"names":[],"mappings":""}

package/dist/src/runners/process-runner.d.ts

@@ -0,0 +1,15 @@
+import type { JobResult, RunnerAdapter, RunnerSpec } from "./runner-adapter.js";
+import { RunnerRegistry } from "./registry.js";
+export interface ProcessRunnerOptions {
+    environment?: NodeJS.ProcessEnv;
+}
+/**
+ * Executes exactly one registered argv. Candidate fallback belongs to the
+ * router and is intentionally unavailable here after a process starts.
+ */
+export declare class ProcessRunner implements RunnerAdapter {
+    #private;
+    private readonly registry;
+    constructor(registry: RunnerRegistry, options?: ProcessRunnerOptions);
+    run(spec: RunnerSpec): Promise<JobResult>;
+}

package/dist/src/runners/process-runner.js

@@ -0,0 +1,124 @@
+import { spawn } from "node:child_process";
+import { CueLineError } from "../core/errors.js";
+import { runtimeEnvironment } from "../core/runtime.js";
+import { RunnerRegistry } from "./registry.js";
+function combineOutput(stdout, stderr) {
+    if (stdout.length === 0) {
+        return stderr;
+    }
+    if (stderr.length === 0) {
+        return stdout;
+    }
+    return stdout.endsWith("\n") ? `${stdout}${stderr}` : `${stdout}\n${stderr}`;
+}
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Executes exactly one registered argv. Candidate fallback belongs to the
+ * router and is intentionally unavailable here after a process starts.
+ */
+export class ProcessRunner {
+    registry;
+    #environment;
+    constructor(registry, options = {}) {
+        this.registry = registry;
+        this.#environment = { ...(options.environment ?? runtimeEnvironment()) };
+    }
+    async run(spec) {
+        if (this.#environment.CUELINE_DEPTH !== undefined || spec.env?.CUELINE_DEPTH !== undefined) {
+            throw new CueLineError("NESTED_ROUTING_REJECTED", "nested CueLine routing is not allowed");
+        }
+        if (!Number.isFinite(spec.timeoutMs) || spec.timeoutMs <= 0) {
+            throw new CueLineError("PROCESS_TIMEOUT_INVALID", "process timeout must be a positive finite number", {
+                details: { timeoutMs: spec.timeoutMs },
+            });
+        }
+        const registered = this.registry.requireArgv(spec.argv);
+        const executable = spec.argv[0];
+        if (executable === undefined) {
+            throw new CueLineError("RUNNER_ARGV_INVALID", "argv must begin with a registered executable");
+        }
+        if (registered.executable !== executable) {
+            throw new CueLineError("RUNNER_EXECUTABLE_UNREGISTERED", "argv executable registration did not match");
+        }
+        return new Promise((resolve) => {
+            const startedAt = new Date().toISOString();
+            const environment = {
+                ...this.#environment,
+                ...spec.env,
+                CUELINE_DEPTH: "1",
+            };
+            let stdout = "";
+            let stderr = "";
+            let timedOut = false;
+            let settled = false;
+            let timeoutTimer;
+            let forceKillTimer;
+            const finish = (status, exitCode) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                if (timeoutTimer !== undefined) {
+                    clearTimeout(timeoutTimer);
+                }
+                if (forceKillTimer !== undefined) {
+                    clearTimeout(forceKillTimer);
+                }
+                const output = combineOutput(stdout, stderr);
+                resolve({
+                    status,
+                    exitCode,
+                    stdout,
+                    stderr,
+                    output,
+                    emptyOutput: output.length === 0,
+                    timedOut,
+                    ambiguousSideEffects: spec.mode === "work" && status !== "succeeded",
+                    retryable: false,
+                    startedAt,
+                    finishedAt: new Date().toISOString(),
+                });
+            };
+            let child;
+            try {
+                child = spawn(executable, [...spec.argv.slice(1)], {
+                    cwd: spec.cwd,
+                    env: environment,
+                    shell: false,
+                    stdio: [spec.stdin === undefined ? "ignore" : "pipe", "pipe", "pipe"],
+                });
+            }
+            catch (error) {
+                stderr = errorText(error);
+                finish("failed", null);
+                return;
+            }
+            timeoutTimer = setTimeout(() => {
+                timedOut = true;
+                child.kill("SIGTERM");
+                forceKillTimer = setTimeout(() => child.kill("SIGKILL"), 250);
+            }, spec.timeoutMs);
+            child.stdout?.setEncoding("utf8");
+            child.stdout?.on("data", (chunk) => {
+                stdout += chunk.toString();
+            });
+            child.stderr?.setEncoding("utf8");
+            child.stderr?.on("data", (chunk) => {
+                stderr += chunk.toString();
+            });
+            if (spec.stdin !== undefined) {
+                child.stdin?.end(spec.stdin, "utf8");
+            }
+            child.once("error", (error) => {
+                stderr += errorText(error);
+                finish("failed", null);
+            });
+            child.once("close", (exitCode) => {
+                finish(timedOut ? "timed_out" : exitCode === 0 ? "succeeded" : "failed", exitCode);
+            });
+        });
+    }
+}
+//# sourceMappingURL=process-runner.js.map

package/dist/src/runners/process-runner.js.map

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

package/dist/src/runners/registry.d.ts

@@ -0,0 +1,17 @@
+export interface RegisteredExecutable {
+    id: string;
+    executable: string;
+}
+/**
+ * Explicit allow-list for argv[0]. Registering an executable never grants
+ * permission to invoke a shell or to substitute a different argv[0].
+ */
+export declare class RunnerRegistry {
+    #private;
+    constructor(entries?: Iterable<RegisteredExecutable>);
+    register(entry: RegisteredExecutable): this;
+    get(id: string): RegisteredExecutable | undefined;
+    hasExecutable(executable: string): boolean;
+    requireExecutable(executable: string): RegisteredExecutable;
+    requireArgv(argv: readonly string[]): RegisteredExecutable;
+}

package/dist/src/runners/registry.js

@@ -0,0 +1,57 @@
+import { CueLineError } from "../core/errors.js";
+function validateEntry(entry) {
+    if (entry.id.trim().length === 0) {
+        throw new CueLineError("RUNNER_REGISTRY_INVALID", "registered runner id must be non-empty");
+    }
+    if (entry.executable.trim().length === 0) {
+        throw new CueLineError("RUNNER_REGISTRY_INVALID", "registered executable must be non-empty", {
+            details: { id: entry.id },
+        });
+    }
+}
+/**
+ * Explicit allow-list for argv[0]. Registering an executable never grants
+ * permission to invoke a shell or to substitute a different argv[0].
+ */
+export class RunnerRegistry {
+    #byId = new Map();
+    #byExecutable = new Map();
+    constructor(entries = []) {
+        for (const entry of entries) {
+            this.register(entry);
+        }
+    }
+    register(entry) {
+        validateEntry(entry);
+        if (this.#byId.has(entry.id) || this.#byExecutable.has(entry.executable)) {
+            throw new CueLineError("RUNNER_REGISTRY_DUPLICATE", "runner executable is already registered", {
+                details: { id: entry.id, executable: entry.executable },
+            });
+        }
+        const registered = { ...entry };
+        this.#byId.set(registered.id, registered);
+        this.#byExecutable.set(registered.executable, registered);
+        return this;
+    }
+    get(id) {
+        return this.#byId.get(id);
+    }
+    hasExecutable(executable) {
+        return this.#byExecutable.has(executable);
+    }
+    requireExecutable(executable) {
+        const registered = this.#byExecutable.get(executable);
+        if (registered === undefined) {
+            throw new CueLineError("RUNNER_EXECUTABLE_UNREGISTERED", `argv executable is not pre-registered: ${executable}`, { details: { executable } });
+        }
+        return registered;
+    }
+    requireArgv(argv) {
+        const executable = argv[0];
+        if (typeof executable !== "string" || executable.length === 0) {
+            throw new CueLineError("RUNNER_ARGV_INVALID", "argv must begin with a non-empty executable");
+        }
+        return this.requireExecutable(executable);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/runners/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/runners/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOjD,SAAS,aAAa,CAAC,KAA2B;IAChD,IAAI,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,YAAY,CAAC,yBAAyB,EAAE,wCAAwC,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,YAAY,CAAC,yBAAyB,EAAE,yCAAyC,EAAE;YAC3F,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE;SAC1B,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,cAAc;IAChB,KAAK,GAAG,IAAI,GAAG,EAAgC,CAAC;IAChD,aAAa,GAAG,IAAI,GAAG,EAAgC,CAAC;IAEjE,YAAY,OAAO,GAAmC,EAAE;QACtD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,KAA2B;QAClC,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YACzE,MAAM,IAAI,YAAY,CAAC,2BAA2B,EAAE,yCAAyC,EAAE;gBAC7F,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;aACxD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAC1C,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,aAAa,CAAC,UAAkB;QAC9B,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,iBAAiB,CAAC,UAAkB;QAClC,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,YAAY,CACpB,gCAAgC,EAChC,0CAA0C,UAAU,EAAE,EACtD,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,EAAE,CAC5B,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,WAAW,CAAC,IAAuB;QACjC,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,YAAY,CAAC,qBAAqB,EAAE,6CAA6C,CAAC,CAAC;QAC/F,CAAC;QACD,OAAO,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/src/runners/runner-adapter.d.ts

@@ -0,0 +1,32 @@
+import type { JobMode } from "../protocol/types.js";
+export type JobExecution = "foreground" | "background";
+export type JobResultStatus = "succeeded" | "failed" | "timed_out" | "ambiguous";
+export interface RunnerSpec {
+    jobId: string;
+    argv: readonly string[];
+    stdin?: string;
+    mode: JobMode;
+    timeoutMs: number;
+    background?: boolean;
+    lane?: string;
+    task?: string;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}
+export interface JobResult {
+    status: JobResultStatus;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    output: string;
+    emptyOutput: boolean;
+    timedOut: boolean;
+    ambiguousSideEffects: boolean;
+    retryable: false;
+    startedAt: string;
+    finishedAt: string;
+}
+export interface RunnerAdapter {
+    run(spec: RunnerSpec): Promise<JobResult>;
+}
+export declare function executionFor(spec: Pick<RunnerSpec, "background">): JobExecution;

package/dist/src/runners/runner-adapter.js

@@ -0,0 +1,4 @@
+export function executionFor(spec) {
+    return spec.background === true ? "background" : "foreground";
+}
+//# sourceMappingURL=runner-adapter.js.map

package/dist/src/runners/runner-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-adapter.js","sourceRoot":"","sources":["../../../src/runners/runner-adapter.ts"],"names":[],"mappings":"AAoCA,MAAM,UAAU,YAAY,CAAC,IAAoC;IAC/D,OAAO,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;AAChE,CAAC"}

package/dist/src/state/atomic-write.d.ts

@@ -0,0 +1 @@
+export declare function atomicWriteJson(target: string, value: unknown): Promise<void>;

package/dist/src/state/atomic-write.js

@@ -0,0 +1,27 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, open, rename, unlink } from "node:fs/promises";
+import path from "node:path";
+import { canonicalJson } from "../core/ids.js";
+import { runtimePidTag } from "../core/runtime.js";
+export async function atomicWriteJson(target, value) {
+    const directory = path.dirname(target);
+    await mkdir(directory, { recursive: true });
+    const temporary = path.join(directory, `.${path.basename(target)}.${runtimePidTag()}.${randomUUID()}.tmp`);
+    let handle;
+    try {
+        handle = await open(temporary, "wx", 0o600);
+        await handle.writeFile(`${canonicalJson(value)}\n`, "utf8");
+        await handle.sync();
+        await handle.close();
+        handle = undefined;
+        await rename(temporary, target);
+    }
+    catch (error) {
+        if (handle !== undefined) {
+            await handle.close().catch(() => undefined);
+        }
+        await unlink(temporary).catch(() => undefined);
+        throw error;
+    }
+}
+//# sourceMappingURL=atomic-write.js.map

package/dist/src/state/atomic-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../../src/state/atomic-write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,KAAc;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CACzB,SAAS,EACT,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,aAAa,EAAE,IAAI,UAAU,EAAE,MAAM,CACnE,CAAC;IACF,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5C,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,GAAG,SAAS,CAAC;QACnB,MAAM,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/src/state/event-log.d.ts

@@ -0,0 +1,8 @@
+export interface RunEvent {
+    sequence: number;
+    timestamp: string;
+    type: string;
+    payload: unknown;
+}
+export declare function appendEvent(file: string, event: RunEvent): Promise<void>;
+export declare function readEvents(file: string): Promise<RunEvent[]>;

package/dist/src/state/event-log.js

@@ -0,0 +1,56 @@
+import { mkdir, open, readFile } from "node:fs/promises";
+import path from "node:path";
+import { canonicalJson } from "../core/ids.js";
+function validateEvent(value, expectedSequence) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new Error(`EVENT_LOG_INVALID: event ${expectedSequence} is not an object`);
+    }
+    const record = value;
+    if (record.sequence !== expectedSequence ||
+        typeof record.timestamp !== "string" ||
+        typeof record.type !== "string" ||
+        record.type === "") {
+        throw new Error(`EVENT_LOG_INVALID: malformed event ${expectedSequence}`);
+    }
+    return {
+        sequence: expectedSequence,
+        timestamp: record.timestamp,
+        type: record.type,
+        payload: record.payload,
+    };
+}
+export async function appendEvent(file, event) {
+    await mkdir(path.dirname(file), { recursive: true });
+    const handle = await open(file, "a", 0o600);
+    try {
+        await handle.writeFile(`${canonicalJson(event)}\n`, "utf8");
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+export async function readEvents(file) {
+    let contents;
+    try {
+        contents = await readFile(file, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    }
+    const lines = contents.split("\n").filter((line) => line.trim() !== "");
+    return lines.map((line, index) => {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch (error) {
+            throw new Error(`EVENT_LOG_INVALID: invalid JSON at line ${index + 1}`, { cause: error });
+        }
+        return validateEvent(parsed, index + 1);
+    });
+}
+//# sourceMappingURL=event-log.js.map

package/dist/src/state/event-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.js","sourceRoot":"","sources":["../../../src/state/event-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAS/C,SAAS,aAAa,CAAC,KAAc,EAAE,gBAAwB;IAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,4BAA4B,gBAAgB,mBAAmB,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,IACE,MAAM,CAAC,QAAQ,KAAK,gBAAgB;QACpC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QACpC,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC/B,MAAM,CAAC,IAAI,KAAK,EAAE,EAClB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sCAAsC,gBAAgB,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,gBAAgB;QAC1B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,KAAe;IAC7D,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,2CAA2C,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,aAAa,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC"}