@revisium/orchestrator 0.0.0

package/dist/worker/claude-code-runner.js

@@ -0,0 +1,135 @@
+import { noopWorktreeManager } from './worktree-manager.js';
+import { REVO_RESULT_CONTRACT, parseTransportEnvelope, extractAgentResult, normalizeNextSteps, } from './result-envelope.js';
+const DEFAULT_TIMEOUT_MS = 600_000;
+const DEFAULT_COMMAND = 'claude';
+const ERROR_TAIL = 2_000;
+function tail(text) {
+    const trimmed = text.trim();
+    return trimmed.length > ERROR_TAIL ? trimmed.slice(-ERROR_TAIL) : trimmed;
+}
+/** Read a positive number from a parsed model_profiles.params object, trying camel + snake keys. */
+function readParamNum(params, ...keys) {
+    if (!params || typeof params !== 'object' || Array.isArray(params))
+        return undefined;
+    const rec = params;
+    for (const k of keys) {
+        const v = rec[k];
+        const n = typeof v === 'number' ? v : typeof v === 'string' ? Number(v) : NaN;
+        if (Number.isFinite(n) && n > 0)
+            return n;
+    }
+    return undefined;
+}
+// CLI invocation — the only place flags are assembled. EXACT flag set is confirmed by the manual
+// Step-6 smoke before --runner defaults to auto. The permission mode keeps the headless run
+// non-interactive: a tool not in allowedTools is auto-denied (no TTY can prompt in -p mode).
+// 0008 #5: permissionMode is now per-role DATA (was hardcoded 'default'); model_profiles.params
+// (previously unused "{}") is threaded in — a configured maxTurns maps to claude's --max-turns.
+function buildArgs(modelId, allowedTools, permissionMode, params) {
+    const args = ['-p', '--model', modelId, '--output-format', 'json', '--permission-mode', permissionMode];
+    // Empty list → pass NO tools (most restrictive; text/plan-only). Never widen beyond role.allowedTools.
+    if (allowedTools.length > 0) {
+        args.push('--allowedTools', allowedTools.join(','));
+    }
+    const maxTurns = readParamNum(params, 'maxTurns', 'max_turns');
+    if (maxTurns !== undefined) {
+        args.push('--max-turns', String(Math.trunc(maxTurns)));
+    }
+    return args;
+}
+// Prompt order (design decision 6): context → attemptId line → REVO_RESULT_CONTRACT. Appending the
+// contract HERE — not in build-context.ts, not in the role system_prompt — guarantees the agent is
+// told how to emit on EVERY attempt, including retries.
+function buildPrompt(context, attemptId) {
+    const idempotencyLine = `Attempt-Id: ${attemptId} — idempotency key. Reference it on any external effect you create.`;
+    return [context, idempotencyLine, REVO_RESULT_CONTRACT].join('\n');
+}
+// One CostRecord from the transport envelope. Prefer the CLI-reported USD; else compute from tokens.
+// Zero tokens with no reported cost → empty costs (keeps zero-cost paths truly free).
+function buildCosts(step, profile, env) {
+    const inputTokens = env.inputTokens ?? 0;
+    const outputTokens = env.outputTokens ?? 0;
+    const reportedUsd = (typeof env.costUsd === 'number' && Number.isFinite(env.costUsd)) ? env.costUsd : undefined;
+    if (inputTokens === 0 && outputTokens === 0 && reportedUsd === undefined)
+        return [];
+    const computed = (inputTokens / 1_000_000) * profile.costPerInput +
+        (outputTokens / 1_000_000) * profile.costPerOutput;
+    return [
+        {
+            modelProfile: step.modelProfile,
+            inputTokens,
+            outputTokens,
+            costAmount: reportedUsd ?? computed,
+            currency: 'USD',
+        },
+    ];
+}
+export function createClaudeCodeRunner(deps) {
+    const fallbackTimeoutMs = deps.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const command = deps.command ?? DEFAULT_COMMAND;
+    return async ({ role, profile, context, attemptId, step }) => {
+        // attemptId is already minted by startAttempt (loop) — consumed here, never re-minted.
+        const baseCwd = await deps.resolveCwd(step);
+        const manager = deps.worktreeManager ?? noopWorktreeManager;
+        const cwd = await manager.create(step.id, baseCwd);
+        // 0008 #5: per-role data overrides the hardcoded defaults (timeout + permission mode).
+        const timeoutMs = role.timeoutMs ?? fallbackTimeoutMs;
+        const permissionMode = role.permissionMode ?? 'default';
+        try {
+            const req = {
+                command,
+                args: buildArgs(profile.modelId, role.allowedTools, permissionMode, profile.params),
+                cwd,
+                timeoutMs,
+                input: buildPrompt(context, attemptId),
+            };
+            const result = await deps.executor(req);
+            // Timeout / process failure → throw; the loop's catch → failStep returns the step to ready
+            // (backoff) or dead at the attempt cap. No loop change needed.
+            if (result.timedOut) {
+                throw new Error(`claude-code runner exceeded ${timeoutMs}ms`);
+            }
+            if (result.code !== 0) {
+                throw new Error(`claude-code runner exited with code ${String(result.code)}: ${tail(result.stderr || result.stdout)}`);
+            }
+            const transport = parseTransportEnvelope(result.stdout);
+            if (transport.isError) {
+                throw new Error(`claude-code runner reported is_error: ${tail(transport.text)}`);
+            }
+            const agent = extractAgentResult(transport.text);
+            const costs = buildCosts(step, profile, transport);
+            // needsHuman: do NOT write nextSteps — the loop parks via the existing awaiting_approval path.
+            if (agent.needsHuman) {
+                const parked = {
+                    output: agent.output,
+                    nextSteps: [],
+                    costs,
+                    needsHuman: true,
+                    lesson: agent.lesson,
+                };
+                return parked;
+            }
+            const success = {
+                output: agent.output,
+                artifacts: agent.artifacts,
+                nextSteps: normalizeNextSteps(agent.nextSteps, step),
+                costs,
+                needsHuman: false,
+                lesson: agent.lesson,
+            };
+            return success;
+        }
+        finally {
+            try {
+                await manager.release(cwd);
+            }
+            catch (err) {
+                console.warn(`Warning: worktree release failed for ${cwd}: ${String(err)}`);
+            }
+        }
+    };
+}
+// Idempotency seam (this slice does NO external create): attemptId is minted before the run and
+// threaded into the prompt so artifacts/effects can reference it. The "create-only-if-key-unused"
+// guard for real commits/PRs is Plan 0011 — the runner itself performs no external write.
+//# sourceMappingURL=claude-code-runner.js.map

package/dist/worker/claude-code-runner.js.map

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

package/dist/worker/git-worktree-manager.js

@@ -0,0 +1,84 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, lstatSync, rmSync, symlinkSync } from 'node:fs';
+import { basename, dirname, isAbsolute, join, resolve } from 'node:path';
+function git(args, cwd) {
+    return execFileSync('git', args, { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim();
+}
+function branchName(stepId) {
+    return `run/${stepId}`;
+}
+function stepIdFromWorktreePath(worktreePath) {
+    return basename(worktreePath);
+}
+function gitRootFromExistingPath(path) {
+    return git(['rev-parse', '--show-toplevel'], path);
+}
+function gitCommonRootFromExistingPath(path) {
+    const commonDir = git(['rev-parse', '--git-common-dir'], path);
+    const absoluteCommonDir = isAbsolute(commonDir) ? commonDir : resolve(path, commonDir);
+    return dirname(absoluteCommonDir);
+}
+function gitRootFromWorktreePath(worktreePath) {
+    if (existsSync(worktreePath)) {
+        return gitCommonRootFromExistingPath(worktreePath);
+    }
+    const worktreesDir = dirname(worktreePath);
+    if (basename(worktreesDir) !== '.worktrees')
+        return null;
+    const candidate = dirname(worktreesDir);
+    return existsSync(join(candidate, '.git')) ? candidate : null;
+}
+function deleteBranchIfPresent(gitRoot, stepId) {
+    try {
+        git(['branch', '-D', branchName(stepId)], gitRoot);
+    }
+    catch {
+        // Missing branches are expected after partial cleanup or manual recovery.
+    }
+}
+function pruneWorktrees(gitRoot) {
+    try {
+        git(['worktree', 'prune'], gitRoot);
+    }
+    catch {
+        console.warn(`Warning: git worktree prune failed in ${gitRoot}`);
+    }
+}
+export class GitWorktreeManager {
+    async create(stepId, baseDir) {
+        const gitRoot = gitRootFromExistingPath(baseDir);
+        const worktreePath = join(gitRoot, '.worktrees', stepId);
+        await this.release(worktreePath);
+        git(['worktree', 'add', '-b', branchName(stepId), worktreePath, 'HEAD'], gitRoot);
+        const sourceNodeModules = join(gitRoot, 'node_modules');
+        const targetNodeModules = join(worktreePath, 'node_modules');
+        if (existsSync(sourceNodeModules)) {
+            if (existsSync(targetNodeModules) || lstatSync(targetNodeModules, { throwIfNoEntry: false }) !== undefined) {
+                rmSync(targetNodeModules, { recursive: true, force: true });
+            }
+            symlinkSync(sourceNodeModules, targetNodeModules, 'dir');
+        }
+        return worktreePath;
+    }
+    async release(worktreePath) {
+        const gitRoot = gitRootFromWorktreePath(worktreePath);
+        if (gitRoot === null)
+            return;
+        if (existsSync(worktreePath)) {
+            try {
+                git(['worktree', 'remove', '--force', worktreePath], gitRoot);
+            }
+            catch {
+                console.warn(`Warning: git worktree remove failed for ${worktreePath}; deleting directory directly`);
+                rmSync(worktreePath, { recursive: true, force: true });
+            }
+        }
+        if (existsSync(worktreePath)) {
+            console.warn(`Warning: worktree path still exists after git removal: ${worktreePath}; deleting directory directly`);
+            rmSync(worktreePath, { recursive: true, force: true });
+        }
+        pruneWorktrees(gitRoot);
+        deleteBranchIfPresent(gitRoot, stepIdFromWorktreePath(worktreePath));
+    }
+}
+//# sourceMappingURL=git-worktree-manager.js.map

package/dist/worker/git-worktree-manager.js.map

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

package/dist/worker/loop.js

@@ -0,0 +1,122 @@
+import { randomUUID } from 'node:crypto';
+import { claimNextStep, startAttempt, writeResult, createSteps, failStep, recoverInFlight, compactStamp, } from '../control-plane/steps.js';
+import { buildContext } from './build-context.js';
+async function processClaimedStep(deps, workerId, step) {
+    const { da, loadRole, loadModelProfile, runAgent } = deps;
+    const role = await loadRole(step.role);
+    const profile = await loadModelProfile(role.modelLevel);
+    const context = await buildContext(da, step, role);
+    const { attemptId } = await startAttempt(da, step, { workerId, modelProfile: profile.modelId });
+    try {
+        const result = await runAgent({ role, profile, context, attemptId, step });
+        return { attemptId, result };
+    }
+    catch (err) {
+        await failStep(da, step, attemptId, {
+            lesson: err instanceof Error ? err.message : String(err),
+            error: err instanceof Error ? (err.stack ?? err.message) : String(err),
+        });
+        return null;
+    }
+}
+async function handleResult(da, step, attemptId, result) {
+    if (result.needsHuman) {
+        await parkForHuman(da, step, attemptId, result);
+        return;
+    }
+    const nextSteps = result.nextSteps.map((ns) => ({ ...ns, runId: step.runId }));
+    // createSteps runs BEFORE writeResult makes the parent terminal. Child IDs are a bounded,
+    // deterministic hash of (parent id + index), so a retry regenerates the same IDs and
+    // createSteps' idempotency check skips existing rows.
+    //
+    // createSteps failures (e.g. Revisium rejecting an invalid next step) are pre-terminal and
+    // SAFE to fail gracefully: nothing has been finalized yet, so failStep lets the step back off
+    // / go dead instead of crashing the worker. writeResult is DIFFERENT — it mutates several rows
+    // (attempt close, event, cost, then the step), so a partial failure must NOT be routed through
+    // failStep (that would mark a half-written step failed). We let writeResult errors propagate:
+    // the step stays 'running' → recoverInFlight resets it on the next start → idempotent retry.
+    try {
+        await createSteps(da, nextSteps, { parentStepId: step.id });
+    }
+    catch (err) {
+        await failStep(da, step, attemptId, {
+            lesson: err instanceof Error ? err.message : String(err),
+            error: err instanceof Error ? (err.stack ?? err.message) : String(err),
+        });
+        return;
+    }
+    await writeResult(da, step, attemptId, result.output, result.costs);
+}
+export function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        const onAbort = () => { clearTimeout(timer); resolve(); };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+async function parkForHuman(da, step, attemptId, result) {
+    const now = new Date();
+    const nowIso = now.toISOString();
+    const st = compactStamp(now);
+    const sfx = randomUUID().replaceAll('-', '').slice(0, 8);
+    // Close the attempt so it is no longer 'running' while the step waits for a human.
+    await da.patchRow('attempts', attemptId, [
+        { op: 'replace', path: 'status', value: 'paused' },
+        { op: 'replace', path: 'finished_at', value: nowIso },
+    ]);
+    // Minimal inbox parking: mark step awaiting_approval, clear lease, append event.
+    // Full pushInbox (inbox row creation + resolution workflow) is deferred.
+    await da.patchRow('steps', step.id, [
+        { op: 'replace', path: 'status', value: 'awaiting_approval' },
+        { op: 'replace', path: 'lease_owner', value: '' },
+        { op: 'replace', path: 'lease_expires_at', value: '' },
+        { op: 'replace', path: 'updated_at', value: nowIso },
+    ]);
+    await da.createRow('events', `event_${st}_step-needs-human_${sfx}`, {
+        id: `event_${st}_step-needs-human_${sfx}`,
+        run_id: step.runId,
+        task_id: step.taskId,
+        step_id: step.id,
+        type: 'step_needs_human',
+        payload: { attempt_id: attemptId, lesson: result.lesson },
+        actor: 'orchestrator',
+        created_at: nowIso,
+    });
+}
+async function runNextStep(deps, workerId, roles) {
+    const { da } = deps;
+    const step = await claimNextStep(da, workerId, roles);
+    if (!step)
+        return 'idle';
+    const processed = await processClaimedStep(deps, workerId, step);
+    if (!processed)
+        return 'failed';
+    await handleResult(da, step, processed.attemptId, processed.result);
+    return 'completed';
+}
+export async function runWorker(deps, opts) {
+    const { da } = deps;
+    const { workerId, roles, once, idleSleepMs = 5000, maxCycles, signal } = opts;
+    if (!Number.isFinite(idleSleepMs) || idleSleepMs < 0) {
+        throw new Error(`idleSleepMs must be a non-negative finite number, got: ${String(idleSleepMs)}`);
+    }
+    await recoverInFlight(da, workerId);
+    let cycles = 0;
+    while (true) {
+        if (signal?.aborted)
+            break;
+        if (maxCycles !== undefined && cycles >= maxCycles)
+            break;
+        const outcome = await runNextStep(deps, workerId, roles);
+        if (outcome !== 'idle')
+            cycles++;
+        if (once)
+            break;
+        if (outcome === 'idle')
+            await sleep(idleSleepMs, signal);
+    }
+}
+//# sourceMappingURL=loop.js.map

package/dist/worker/loop.js.map

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

package/dist/worker/process-executor.js

@@ -0,0 +1,62 @@
+import { spawn } from 'node:child_process';
+// Kill the whole process GROUP, not just the leader: `claude` spawns subprocesses, and only a
+// negative-PID signal reaches them. `detached: true` (below) made the child its own group leader,
+// so process.kill(-pid) targets the group. Fall back to a direct kill if the group send throws.
+function killGroup(child) {
+    const pid = child.pid;
+    if (pid === undefined) {
+        child.kill('SIGKILL');
+        return;
+    }
+    try {
+        process.kill(-pid, 'SIGKILL');
+    }
+    catch {
+        child.kill('SIGKILL');
+    }
+}
+// Real implementation, used only in production wiring (never in unit tests).
+export const spawnExecutor = (req) => new Promise((resolve, reject) => {
+    const child = spawn(req.command, req.args, {
+        cwd: req.cwd,
+        env: req.env ? { ...process.env, ...req.env } : process.env,
+        // Own process group → a negative-PID SIGKILL reaps `claude` AND its children on timeout.
+        // Do NOT unref(): the parent must stay attached to collect stdout/stderr and observe exit.
+        detached: true,
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    let stdout = '';
+    let stderr = '';
+    let timedOut = false;
+    let settled = false;
+    child.stdout?.setEncoding('utf8');
+    child.stderr?.setEncoding('utf8');
+    child.stdout?.on('data', (chunk) => { stdout += chunk; });
+    child.stderr?.on('data', (chunk) => { stderr += chunk; });
+    const timer = setTimeout(() => {
+        timedOut = true;
+        killGroup(child);
+    }, req.timeoutMs);
+    // Spawn-level errors (binary missing) reject — the runner converts that to a lesson.
+    child.on('error', (err) => {
+        if (settled)
+            return;
+        settled = true;
+        clearTimeout(timer);
+        reject(err);
+    });
+    // Never reject for a non-zero exit; return the result and let the runner decide how to map it.
+    child.on('close', (code) => {
+        if (settled)
+            return;
+        settled = true;
+        clearTimeout(timer);
+        resolve({ code, stdout, stderr, timedOut });
+    });
+    // Swallow EPIPE: the child may exit before draining stdin; the 'close' handler reports the result.
+    child.stdin?.on('error', () => { });
+    if (req.input !== undefined)
+        child.stdin?.write(req.input);
+    child.stdin?.end();
+});
+//# sourceMappingURL=process-executor.js.map

package/dist/worker/process-executor.js.map

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

package/dist/worker/result-envelope.js

@@ -0,0 +1,134 @@
+// The EXACT contract between the agent and the runner. Two layers:
+//   A. transport envelope — `claude -p --output-format json` stdout (final text + cost/usage)
+//   B. agent result envelope — a sentineled REVO_RESULT block the agent emits inside that final text
+//
+// The instruction below is the SINGLE SOURCE OF TRUTH. The runner (claude-code-runner.ts) appends it
+// to EVERY prompt so the agent is always told how to emit; the parser here keys on the same markers.
+// It lives next to the parser — not in build-context.ts (the stub shares that), not in role prompts.
+export const REVO_RESULT_CONTRACT = `
+You MUST end your reply with a single result block in EXACTLY this form — the markers on their own lines,
+valid JSON between them, and NOTHING after the closing marker:
+
+<<<REVO_RESULT
+{
+  "output": <any JSON — a short human-readable summary or structured result>,
+  "artifacts": <any JSON, optional — e.g. { "planPath": "docs/plans/00xx.md" }; omit if none>,
+  "nextSteps": [
+    { "role": "developer", "kind": "implement", "input": { "from": "<this step>" },
+      "modelProfile"?: "standard", "taskId"?: "<defaults to the current step's task>",
+      "priority"?: 0, "maxAttempts"?: 3, "dependsOn"?: [], "runAfter"?: "" }
+  ],
+  "needsHuman": false,
+  "lesson": null
+}
+REVO_RESULT>>>
+
+If you have no follow-up work, return "nextSteps": []. If you are blocked and need a human, set
+"needsHuman": true and "nextSteps": []. Emit the block exactly once.
+`;
+// Markers the parser keys on — must stay identical to those embedded in REVO_RESULT_CONTRACT.
+// The marker-sync unit test guards that invariant.
+const OPEN_MARKER = '<<<REVO_RESULT';
+const CLOSE_MARKER = 'REVO_RESULT>>>';
+function readNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function readFinalText(obj) {
+    if (typeof obj.result === 'string')
+        return obj.result;
+    if (typeof obj.text === 'string')
+        return obj.text;
+    return '';
+}
+// Layer A. Parse defensively; field names are read only inside this module, so a CLI drift is a
+// one-file change. Throws only when stdout is not parseable JSON.
+export function parseTransportEnvelope(stdout) {
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch {
+        throw new Error('claude -p did not return parseable JSON (transport envelope)');
+    }
+    if (parsed === null || typeof parsed !== 'object') {
+        throw new Error('claude -p did not return parseable JSON (transport envelope)');
+    }
+    const obj = parsed;
+    const usage = obj.usage !== null && typeof obj.usage === 'object'
+        ? obj.usage
+        : undefined;
+    return {
+        text: readFinalText(obj),
+        isError: Boolean(obj.is_error),
+        costUsd: readNumber(obj.total_cost_usd) ?? readNumber(obj.cost_usd),
+        inputTokens: readNumber(usage?.input_tokens),
+        outputTokens: readNumber(usage?.output_tokens),
+    };
+}
+// Layer B. Extract the substring between the markers and JSON.parse it. Absent or unparseable →
+// the documented lesson-bearing error (the corrective is the contract the runner re-appends, not this).
+export function extractAgentResult(text) {
+    const start = text.indexOf(OPEN_MARKER);
+    const end = start === -1 ? -1 : text.indexOf(CLOSE_MARKER, start + OPEN_MARKER.length);
+    if (start === -1 || end === -1) {
+        throw new Error('agent did not emit a parseable REVO_RESULT envelope');
+    }
+    const jsonSlice = text.slice(start + OPEN_MARKER.length, end);
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonSlice);
+    }
+    catch {
+        throw new Error('agent did not emit a parseable REVO_RESULT envelope');
+    }
+    if (parsed === null || typeof parsed !== 'object') {
+        throw new Error('agent did not emit a parseable REVO_RESULT envelope');
+    }
+    const obj = parsed;
+    return {
+        output: obj.output,
+        artifacts: obj.artifacts,
+        nextSteps: Array.isArray(obj.nextSteps) ? obj.nextSteps : [],
+        needsHuman: Boolean(obj.needsHuman),
+        lesson: typeof obj.lesson === 'string' ? obj.lesson : undefined,
+    };
+}
+// Map each raw nextSteps entry to NewStepSpec. Require role/kind/input; default taskId and
+// modelProfile from the current step so the agent never needs to know IDs. Throw a lesson-bearing
+// error (naming the index) on a malformed entry.
+export function normalizeNextSteps(raw, step) {
+    return raw.map((entry, i) => {
+        if (entry === null || typeof entry !== 'object') {
+            throw new Error(`REVO_RESULT nextSteps[${i}] is not an object`);
+        }
+        const e = entry;
+        if (typeof e.role !== 'string' || e.role.length === 0) {
+            throw new Error(`REVO_RESULT nextSteps[${i}] missing required "role"`);
+        }
+        if (typeof e.kind !== 'string' || e.kind.length === 0) {
+            throw new Error(`REVO_RESULT nextSteps[${i}] missing required "kind"`);
+        }
+        if (!('input' in e)) {
+            throw new Error(`REVO_RESULT nextSteps[${i}] missing required "input"`);
+        }
+        const spec = {
+            taskId: typeof e.taskId === 'string' && e.taskId.length > 0 ? e.taskId : step.taskId,
+            role: e.role,
+            kind: e.kind,
+            input: e.input,
+            modelProfile: typeof e.modelProfile === 'string' && e.modelProfile.length > 0
+                ? e.modelProfile
+                : step.modelProfile,
+        };
+        if (typeof e.priority === 'number')
+            spec.priority = e.priority;
+        if (typeof e.maxAttempts === 'number')
+            spec.maxAttempts = e.maxAttempts;
+        if (Array.isArray(e.dependsOn))
+            spec.dependsOn = e.dependsOn.map(String);
+        if (typeof e.runAfter === 'string')
+            spec.runAfter = e.runAfter;
+        return spec;
+    });
+}
+//# sourceMappingURL=result-envelope.js.map

package/dist/worker/result-envelope.js.map

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

package/dist/worker/runner-dispatch.js

@@ -0,0 +1,20 @@
+// The single RunAgent the loop injects. All runner choice hides here, dispatched on role.runner —
+// the loop never learns about runner kinds. A not-implemented runner throws (routing through
+// failStep to a clear lesson); it never silently no-ops.
+export function createRunAgent(deps) {
+    return async (args) => {
+        switch (args.role.runner) {
+            case 'claude-code':
+                return deps.claudeCode(args);
+            case 'codex':
+                throw new Error('RUNNER_NOT_IMPLEMENTED: codex runner is a later plan');
+            case 'script':
+                if (!deps.script)
+                    throw new Error('RUNNER_NOT_IMPLEMENTED: script runner not wired');
+                return deps.script(args);
+            default:
+                throw new Error(`RUNNER_NOT_IMPLEMENTED: unknown runner "${String(args.role.runner)}"`);
+        }
+    };
+}
+//# sourceMappingURL=runner-dispatch.js.map

package/dist/worker/runner-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-dispatch.js","sourceRoot":"","sources":["../../src/worker/runner-dispatch.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,6FAA6F;AAC7F,yDAAyD;AACzD,MAAM,UAAU,cAAc,CAAC,IAAiD;IAC9E,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE;QACpB,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,KAAK,aAAa;gBAChB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC/B,KAAK,OAAO;gBACV,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;YAC1E,KAAK,QAAQ;gBACX,IAAI,CAAC,IAAI,CAAC,MAAM;oBAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;gBACrF,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B;gBACE,MAAM,IAAI,KAAK,CAAC,2CAA2C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/worker/runner.js

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

package/dist/worker/runner.js.map

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

package/dist/worker/script-runner.js

@@ -0,0 +1,28 @@
+const DEFAULT_TIMEOUT_MS = 120_000;
+/** Wraps registered script modules as a RunAgent with a configurable JS-level timeout. */
+export function createScriptRunner(deps) {
+    const timeoutMs = deps.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    return async ({ role, step }) => {
+        const module = deps.scripts[role.name];
+        if (!module) {
+            throw new Error(`SCRIPT_NOT_FOUND: no script registered for role "${role.name}"`);
+        }
+        const parsedInput = typeof step.input === 'string'
+            ? JSON.parse(step.input || '{}')
+            : (step.input ?? {});
+        let timer;
+        const timeout = new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new Error(`script runner exceeded ${timeoutMs}ms for role "${role.name}"`)), timeoutMs);
+        });
+        try {
+            // For sync script bodies (execFileSync in defaultExecGh) the OS-level exec timeout is the real guard; this timer covers async bodies.
+            return await Promise.race([module.run(parsedInput, step), timeout]);
+        }
+        finally {
+            // Clear the timer on every exit (success OR failure); an uncleared setTimeout keeps the
+            // event loop alive ~120s and hangs `--once` / tests.
+            clearTimeout(timer);
+        }
+    };
+}
+//# sourceMappingURL=script-runner.js.map