@phamvuhoang/otto-core 0.1.0

package/dist/run-bin.js

@@ -0,0 +1,241 @@
+import { existsSync, readFileSync, appendFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { dirtyTreeWarning, ensureTmpIgnored, resolveBranch, } from "./branch.js";
+import { parseFlags, parseDurationMs, printConfig, printHelp, printVersion, } from "./cli-help.js";
+import { detachAndExit } from "./detach.js";
+import { runLoop } from "./loop.js";
+/**
+ * Ensure .otto/state.json is listed in the workspace .gitignore.
+ * No-op when the workspace has no .git directory (not a git repo).
+ * Kept separate from branch.ts's ensureTmpIgnored: that targets the parent
+ * workspaceDir (.otto-tmp/), while state.json lives in the effective workspace
+ * (the worktree, in worktree mode) where the loop writes it.
+ */
+function ensureStateGitignored(workspaceDir) {
+    if (!existsSync(join(workspaceDir, ".git")))
+        return;
+    const gitignorePath = join(workspaceDir, ".gitignore");
+    const entry = ".otto/state.json";
+    const existing = existsSync(gitignorePath)
+        ? readFileSync(gitignorePath, "utf8")
+        : "";
+    const alreadyPresent = existing
+        .split("\n")
+        .some((line) => line.trim() === entry);
+    if (!alreadyPresent) {
+        const prefix = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+        appendFileSync(gitignorePath, `${prefix}${entry}\n`, "utf8");
+    }
+}
+/**
+ * Shared entry for the AFK bins: parse flags, handle --version/--help/--print-config,
+ * resolve the workspace / package dirs, validate the positional args,
+ * optionally fork into the background (--detach), then drive runLoop.
+ */
+export async function runBin(argv, cfg) {
+    const flags = parseFlags(argv);
+    if (flags.version) {
+        printVersion(cfg.bin, cfg.cliVersion);
+        return;
+    }
+    if (flags.help) {
+        printHelp(cfg.bin, cfg.usage, cfg.desc);
+        return;
+    }
+    // run-bin.js ships in the same dist/ dir as the bin entrypoints, so ".." is
+    // the installed @phamvuhoang/otto-core package dir (which holds templates/).
+    const here = dirname(fileURLToPath(import.meta.url));
+    const packageDir = resolve(here, "..");
+    const workspaceDir = resolve(process.env.OTTO_WORKSPACE ?? process.cwd());
+    const envMaxWait = process.env.OTTO_MAX_WAIT?.trim();
+    const maxWaitMs = flags.maxWaitMs ?? (envMaxWait ? parseDurationMs(envMaxWait) : undefined);
+    const envBranch = process.env.OTTO_BRANCH?.trim();
+    const branchStrategyArg = flags.branch ??
+        (envBranch === "current" ||
+            envBranch === "branch" ||
+            envBranch === "worktree"
+            ? envBranch
+            : undefined);
+    const branchPrefixArg = flags.branchPrefix ??
+        (process.env.OTTO_BRANCH_PREFIX?.trim() || undefined);
+    const detachLogPath = flags.detach
+        ? (flags.log ??
+            join(workspaceDir, ".otto-tmp", "logs", `detached-${process.pid}.log`))
+        : undefined;
+    const DEFAULT_LENSES = ["correctness", "security", "tests"];
+    const envLenses = (process.env.OTTO_REVIEW_LENSES ?? "")
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const reviewLenses = envLenses.length > 0
+        ? envLenses
+        : flags.reviewPanel
+            ? DEFAULT_LENSES
+            : undefined;
+    // Resolve the run mode before the --print-config early-return so it reflects
+    // the selected mode. Depends only on flags, not on the guards below.
+    const runMode = flags.verify
+        ? "verify"
+        : flags.applyReview != null
+            ? "review"
+            : cfg.mode;
+    if (flags.printConfig) {
+        printConfig(cfg.bin, workspaceDir, packageDir, {
+            cliVersion: cfg.cliVersion,
+            mode: runMode,
+            noKeepAlive: flags.noKeepAlive,
+            maxRetries: flags.maxRetries,
+            detach: flags.detach,
+            detachLogPath,
+            notify: flags.notify,
+            budget: flags.budget,
+            cooldownMs: flags.cooldownMs,
+            reviewLenses: reviewLenses ?? [],
+            watch: flags.watch,
+            watchIntervalSec: flags.watchIntervalSec,
+            issue: flags.issue,
+            maxWaitMs,
+            branchStrategy: branchStrategyArg,
+            branchPrefix: branchPrefixArg,
+        });
+        return;
+    }
+    if (flags.issue != null && !cfg.issueStage) {
+        console.error("--issue is only supported by otto-ghafk");
+        process.exit(1);
+    }
+    const modeCount = (flags.issue != null ? 1 : 0) +
+        (flags.verify ? 1 : 0) +
+        (flags.applyReview != null ? 1 : 0) +
+        (flags.watch ? 1 : 0);
+    if (modeCount > 1) {
+        console.error("--issue, --verify, --apply-review, and --watch are mutually exclusive");
+        process.exit(1);
+    }
+    if (flags.verify && !cfg.verifyStage) {
+        console.error("--verify is only supported by otto-afk");
+        process.exit(1);
+    }
+    if (flags.applyReview != null && !cfg.applyReviewStage) {
+        console.error("--apply-review is only supported by otto-afk");
+        process.exit(1);
+    }
+    const inputs = flags.issue != null
+        ? String(flags.issue)
+        : flags.applyReview != null
+            ? flags.applyReview
+            : cfg.takesInputArg
+                ? flags.rest[0]
+                : "";
+    // --verify is one-shot (iterations forced to 1 below); --apply-review takes the
+    // doc as its flag value, so the iterations count is the first remaining positional.
+    const iterationsArg = flags.applyReview != null
+        ? flags.rest[0]
+        : cfg.takesInputArg
+            ? flags.rest[1]
+            : flags.rest[0];
+    if (flags.verify && (!cfg.takesInputArg || !inputs)) {
+        console.error(`Usage: ${cfg.bin} --verify "<plan-and-prd>"`);
+        process.exit(1);
+    }
+    if (!flags.verify && ((cfg.takesInputArg && !inputs) || !iterationsArg)) {
+        console.error(`Usage: ${cfg.bin} ${cfg.usage}`);
+        console.error(`       ${cfg.bin} --help`);
+        process.exit(1);
+    }
+    // --verify is one-shot regardless of any positional count.
+    if (flags.verify && iterationsArg) {
+        console.error("--verify is one-shot; ignoring the iterations argument");
+    }
+    const iterations = flags.verify ? 1 : Number.parseInt(iterationsArg, 10);
+    if (!flags.verify && (!Number.isFinite(iterations) || iterations < 1)) {
+        console.error(`Invalid iterations: ${iterationsArg}`);
+        process.exit(1);
+    }
+    if (flags.issue != null) {
+        if (flags.watch) {
+            console.error("--issue cannot be combined with --watch");
+            process.exit(1);
+        }
+        // Validated positive integer (parseIssueRef) — safe for the static
+        // `gh issue view "$OTTO_ISSUE"` command in ghafk-issue.md. See render.ts.
+        process.env.OTTO_ISSUE = String(flags.issue);
+    }
+    const stages = flags.verify
+        ? [cfg.verifyStage]
+        : flags.applyReview != null
+            ? [cfg.applyReviewStage, ...cfg.stages.slice(1)]
+            : flags.issue != null
+                ? [cfg.issueStage, ...cfg.stages.slice(1)]
+                : cfg.stages;
+    if (flags.detach && detachLogPath) {
+        detachAndExit({
+            logPath: detachLogPath,
+            argv,
+            binEntry: process.argv[1],
+        });
+    }
+    const resolved = await resolveBranch({
+        workspaceDir,
+        inputs,
+        isTTY: Boolean(process.stdout.isTTY),
+        flagStrategy: branchStrategyArg,
+        flagPrefix: branchPrefixArg,
+    });
+    process.stderr.write(`${resolved.summaryLine}\n`);
+    // Evaluate the dirty-tree warning against the user's tree BEFORE we mutate the
+    // workspace's .gitignore below — otherwise Otto's own .otto-tmp/ edit would
+    // make a tracked .gitignore "dirty" and fire a spurious warning on first run.
+    const dirtyWarn = dirtyTreeWarning(workspaceDir, resolved.strategy);
+    if (dirtyWarn)
+        process.stderr.write(`⚠ ${dirtyWarn}\n`);
+    ensureTmpIgnored(workspaceDir);
+    const effectiveWorkspaceDir = resolved.effectiveWorkspaceDir;
+    // state.json is written by the loop into effectiveWorkspaceDir (the worktree in
+    // worktree mode), which differs from the parent workspaceDir that
+    // ensureTmpIgnored targets — so this stays a separate call.
+    ensureStateGitignored(effectiveWorkspaceDir);
+    if (flags.watch) {
+        if (!cfg.supportsWatch) {
+            console.error("--watch is only supported by otto-ghafk");
+            process.exit(1);
+        }
+        const { runWatch } = await import("./watch.js");
+        await runWatch({
+            stages,
+            iterations,
+            workspaceDir: effectiveWorkspaceDir,
+            packageDir,
+            watchIntervalSec: flags.watchIntervalSec ?? 300,
+            watchLabel: process.env.OTTO_WATCH_LABEL?.trim() || "otto",
+            budgetUsd: flags.budget,
+            cooldownMs: flags.cooldownMs,
+            maxRetries: flags.maxRetries,
+            reviewLenses,
+            notify: flags.notify,
+            bin: cfg.bin,
+            cliVersion: cfg.cliVersion,
+        });
+        return;
+    }
+    await runLoop({
+        stages,
+        inputs: inputs ?? "",
+        iterations,
+        workspaceDir: effectiveWorkspaceDir,
+        packageDir,
+        noKeepAlive: flags.noKeepAlive,
+        maxRetries: flags.maxRetries,
+        notify: flags.notify,
+        bin: cfg.bin,
+        cliVersion: cfg.cliVersion,
+        budgetUsd: flags.budget,
+        cooldownMs: flags.cooldownMs,
+        reviewLenses,
+        mode: runMode,
+        maxWaitMs,
+        fresh: flags.fresh,
+    });
+}
+//# sourceMappingURL=run-bin.js.map

package/dist/run-bin.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,55 @@
+import type { Stage } from "./stages.js";
+export type RunStageOptions = {
+    signal?: AbortSignal;
+};
+export type StageResult = {
+    result: string;
+    costUsd: number;
+    isError: boolean;
+    apiErrorStatus: string | null;
+};
+/** Pure extraction of the fields Otto tracks from a stream-json `result` event. */
+export declare function resultFromEvent(ev: unknown): StageResult;
+/**
+ * Parse `OTTO_RESULT_GRACE_MS`. Returns the configured millisecond budget,
+ * `0` to disable the timer entirely, or `defaultMs` for any invalid input
+ * (unset, empty, non-finite, negative).
+ */
+export declare function parseGraceMs(raw: string | undefined, defaultMs?: number): number;
+/**
+ * Resolve `OTTO_MODEL` into a `claude` argv fragment. Returns
+ * `["--model", trimmed]` for a non-empty value, or `[]` for unset / empty /
+ * whitespace-only input. Pass-through: otto never validates the model spec,
+ * the `claude` CLI owns that.
+ */
+export declare function resolveModelArgs(raw: string | undefined): string[];
+export type Runner = "sandbox" | "host";
+/** `OTTO_RUNNER=host` → bare host run; anything else (incl. unset) → sandbox. */
+export declare function resolveRunner(raw: string | undefined): Runner;
+/** Parse `OTTO_SANDBOX_NET` into a domain allowlist. Empty = unrestricted. */
+export declare function resolveSandboxNet(raw: string | undefined): string[];
+/**
+ * Claude Code native-sandbox settings: confine writes to the workspace and run
+ * the Go-TLS CLIs unsandboxed. When `allowedDomains` is non-empty, also restrict
+ * network egress to that list; otherwise leave network unrestricted (filesystem
+ * is the blast-radius control; network commands fall back to the bypass-approved
+ * escape hatch).
+ */
+export declare function buildSandboxSettings(workspaceDir: string, allowedDomains: string[]): Record<string, unknown>;
+export declare function stageLogPath(workspaceDir: string, iteration: number, stageName: string): string;
+/**
+ * Build the `claude` argv. Extracted as a pure helper so callers can unit-test
+ * the argv without spawning a process.
+ *
+ * @param stage - The stage configuration (name, permissionMode, etc.).
+ * @param promptRelPath - The workspace-relative path to the rendered prompt file.
+ * @param modelArgs - The `["--model", "<spec>"]` fragment from {@link resolveModelArgs},
+ *   or `[]` when `OTTO_MODEL` is unset.
+ * @param settingsPath - Optional absolute path to a transient settings JSON file
+ *   (written by `runStage` when `OTTO_RUNNER=sandbox`).
+ * @returns The full argv starting with `"claude"` and ending with the prompt
+ *   instruction string.
+ */
+export declare function buildClaudeArgs(stage: Stage, promptRelPath: string, modelArgs: string[], settingsPath?: string): string[];
+export declare function runStage(stage: Stage, renderedPrompt: string, workspaceDir: string, iteration: number, spillHostDir?: string, logPathOverride?: string, options?: RunStageOptions): Promise<StageResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAazC,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,GAAG,WAAW,CASxD;AAKD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,SAAS,GAAE,MAAgC,GAC1C,MAAM,CAQR;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAKlE;AAED,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAExC,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAE7D;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAMnE;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EAAE,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAQD,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAQR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EAAE,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,EAAE,CAmBV;AAED,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,KAAK,EACZ,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE,MAAM,EACxB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,WAAW,CAAC,CA0CtB"}

package/dist/runner.js

@@ -0,0 +1,297 @@
+import { spawn } from "node:child_process";
+import { appendFileSync, closeSync, mkdirSync, openSync, rmSync, writeFileSync, } from "node:fs";
+import { createInterface } from "node:readline";
+import { join, posix } from "node:path";
+import { dim, renderEvent, } from "./stream-render.js";
+import { RateLimitError, isLimitResult, resetsAtFromEvent, } from "./rate-limit.js";
+/** Pure extraction of the fields Otto tracks from a stream-json `result` event. */
+export function resultFromEvent(ev) {
+    const e = (ev ?? {});
+    return {
+        result: typeof e.result === "string" ? e.result : "",
+        costUsd: typeof e.total_cost_usd === "number" ? e.total_cost_usd : 0,
+        isError: e.is_error === true,
+        apiErrorStatus: typeof e.api_error_status === "string" ? e.api_error_status : null,
+    };
+}
+const STDERR_TAIL_LINES = 40;
+const DEFAULT_RESULT_GRACE_MS = 30_000;
+/**
+ * Parse `OTTO_RESULT_GRACE_MS`. Returns the configured millisecond budget,
+ * `0` to disable the timer entirely, or `defaultMs` for any invalid input
+ * (unset, empty, non-finite, negative).
+ */
+export function parseGraceMs(raw, defaultMs = DEFAULT_RESULT_GRACE_MS) {
+    if (raw == null)
+        return defaultMs;
+    const trimmed = raw.trim();
+    if (trimmed === "")
+        return defaultMs;
+    const n = Number(trimmed);
+    if (!Number.isFinite(n))
+        return defaultMs;
+    if (n < 0)
+        return defaultMs;
+    return Math.floor(n);
+}
+/**
+ * Resolve `OTTO_MODEL` into a `claude` argv fragment. Returns
+ * `["--model", trimmed]` for a non-empty value, or `[]` for unset / empty /
+ * whitespace-only input. Pass-through: otto never validates the model spec,
+ * the `claude` CLI owns that.
+ */
+export function resolveModelArgs(raw) {
+    if (raw == null)
+        return [];
+    const trimmed = raw.trim();
+    if (trimmed === "")
+        return [];
+    return ["--model", trimmed];
+}
+/** `OTTO_RUNNER=host` → bare host run; anything else (incl. unset) → sandbox. */
+export function resolveRunner(raw) {
+    return raw?.trim() === "host" ? "host" : "sandbox";
+}
+/** Parse `OTTO_SANDBOX_NET` into a domain allowlist. Empty = unrestricted. */
+export function resolveSandboxNet(raw) {
+    if (!raw)
+        return [];
+    return raw
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+// Go-based CLIs fail TLS verification under macOS Seatbelt; run them outside the
+// sandbox so `gh`/`gcloud`/`terraform` keep working (otto-ghafk relies on gh).
+const SANDBOX_EXCLUDED_COMMANDS = ["gh *", "gcloud *", "terraform *"];
+/**
+ * Claude Code native-sandbox settings: confine writes to the workspace and run
+ * the Go-TLS CLIs unsandboxed. When `allowedDomains` is non-empty, also restrict
+ * network egress to that list; otherwise leave network unrestricted (filesystem
+ * is the blast-radius control; network commands fall back to the bypass-approved
+ * escape hatch).
+ */
+export function buildSandboxSettings(workspaceDir, allowedDomains) {
+    const sandbox = {
+        enabled: true,
+        filesystem: { allowWrite: [workspaceDir] },
+        excludedCommands: SANDBOX_EXCLUDED_COMMANDS,
+    };
+    if (allowedDomains.length > 0) {
+        sandbox.network = { allowedDomains };
+    }
+    return { sandbox };
+}
+function abortError() {
+    const err = new Error("claude command aborted");
+    err.name = "AbortError";
+    return err;
+}
+export function stageLogPath(workspaceDir, iteration, stageName) {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    return join(workspaceDir, ".otto-tmp", "logs", `${timestamp}-iter${iteration}-${stageName}.ndjson`);
+}
+/**
+ * Build the `claude` argv. Extracted as a pure helper so callers can unit-test
+ * the argv without spawning a process.
+ *
+ * @param stage - The stage configuration (name, permissionMode, etc.).
+ * @param promptRelPath - The workspace-relative path to the rendered prompt file.
+ * @param modelArgs - The `["--model", "<spec>"]` fragment from {@link resolveModelArgs},
+ *   or `[]` when `OTTO_MODEL` is unset.
+ * @param settingsPath - Optional absolute path to a transient settings JSON file
+ *   (written by `runStage` when `OTTO_RUNNER=sandbox`).
+ * @returns The full argv starting with `"claude"` and ending with the prompt
+ *   instruction string.
+ */
+export function buildClaudeArgs(stage, promptRelPath, modelArgs, settingsPath) {
+    const args = [
+        "claude",
+        "--verbose",
+        "--print",
+        "--output-format",
+        "stream-json",
+    ];
+    if (stage.permissionMode) {
+        args.push("--permission-mode", stage.permissionMode);
+    }
+    if (settingsPath) {
+        args.push("--settings", settingsPath);
+    }
+    args.push(...modelArgs);
+    args.push(`Read the full instructions from the file ./${promptRelPath} in the current workspace and execute them.`);
+    return args;
+}
+export async function runStage(stage, renderedPrompt, workspaceDir, iteration, spillHostDir, logPathOverride, options = {}) {
+    const tmpHostDir = join(workspaceDir, ".otto-tmp");
+    mkdirSync(tmpHostDir, { recursive: true });
+    const logsDir = join(tmpHostDir, "logs");
+    mkdirSync(logsDir, { recursive: true });
+    const logPath = logPathOverride ?? stageLogPath(workspaceDir, iteration, stage.name);
+    const promptName = `.run-${process.pid}-${iteration}-${Date.now()}.md`;
+    const promptHostPath = join(tmpHostDir, promptName);
+    const promptRelPath = posix.join(".otto-tmp", promptName);
+    writeFileSync(promptHostPath, renderedPrompt, "utf8");
+    let settingsHostPath;
+    if (resolveRunner(process.env.OTTO_RUNNER) === "sandbox") {
+        const settings = buildSandboxSettings(workspaceDir, resolveSandboxNet(process.env.OTTO_SANDBOX_NET));
+        settingsHostPath = join(tmpHostDir, `.sandbox-${process.pid}-${iteration}-${Date.now()}.json`);
+        writeFileSync(settingsHostPath, JSON.stringify(settings), "utf8");
+    }
+    process.stderr.write(`${dim("log → " + logPath)}\n`);
+    try {
+        const argv = buildClaudeArgs(stage, promptRelPath, resolveModelArgs(process.env.OTTO_MODEL), settingsHostPath);
+        return await streamClaude(argv, workspaceDir, logPath, options);
+    }
+    finally {
+        rmSync(promptHostPath, { force: true });
+        if (settingsHostPath)
+            rmSync(settingsHostPath, { force: true });
+        if (spillHostDir)
+            rmSync(spillHostDir, { recursive: true, force: true });
+    }
+}
+function streamClaude(argv, cwd, logPath, options = {}) {
+    if (options.signal?.aborted) {
+        return Promise.reject(abortError());
+    }
+    return new Promise((resolve, reject) => {
+        const logFd = openSync(logPath, "a");
+        const toolMap = new Map();
+        const graceMs = parseGraceMs(process.env.OTTO_RESULT_GRACE_MS);
+        // Spawn claude (argv[0]) on the host instead of docker.
+        const child = spawn(argv[0], argv.slice(1), {
+            cwd,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let final = {
+            result: "",
+            costUsd: 0,
+            isError: false,
+            apiErrorStatus: null,
+        };
+        let lastResetsAt = null;
+        const stderrTail = [];
+        let settled = false;
+        let onAbort = () => { };
+        let rl;
+        let rlErr;
+        let graceTimer;
+        const finish = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            if (graceTimer) {
+                clearTimeout(graceTimer);
+                graceTimer = undefined;
+            }
+            options.signal?.removeEventListener("abort", onAbort);
+            try {
+                rl?.close();
+            }
+            catch {
+                // Already closed.
+            }
+            try {
+                rlErr?.close();
+            }
+            catch {
+                // Already closed.
+            }
+            try {
+                closeSync(logFd);
+            }
+            catch {
+                // Already closed.
+            }
+            fn();
+        };
+        const rejectOnce = (err) => finish(() => reject(err));
+        const resolveOnce = (value) => finish(() => resolve(value));
+        onAbort = () => {
+            try {
+                child.kill();
+            }
+            catch {
+                // Already dead; close handling below will settle if needed.
+            }
+            rejectOnce(abortError());
+        };
+        rl = createInterface({ input: child.stdout });
+        rl.on("line", (line) => {
+            if (settled)
+                return;
+            if (!line.startsWith("{"))
+                return;
+            appendFileSync(logFd, line + "\n");
+            let parsed;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch {
+                return;
+            }
+            renderEvent(parsed, toolMap);
+            if (parsed.type === "rate_limit_event") {
+                const r = resetsAtFromEvent(parsed);
+                if (r != null)
+                    lastResetsAt = r;
+            }
+            if (parsed.type === "result") {
+                final = resultFromEvent(parsed);
+                // Arm one-shot post-result grace timer to recover from claude-CLI
+                // self-deadlocks where the child emits its final NDJSON but never
+                // exits. See docs/prd/result-grace-timer.md.
+                if (!graceTimer && graceMs > 0) {
+                    graceTimer = setTimeout(() => {
+                        if (settled)
+                            return;
+                        process.stderr.write(`${dim(`grace timer fired after ${graceMs}ms post-result — killing claude child`)}\n`);
+                        try {
+                            child.kill();
+                        }
+                        catch {
+                            // Already dead; close handler will be a no-op via settle guard.
+                        }
+                        if (final && isLimitResult(final)) {
+                            rejectOnce(new RateLimitError(final.result || "rate limit", lastResetsAt));
+                        }
+                        else {
+                            resolveOnce(final);
+                        }
+                    }, graceMs);
+                    graceTimer.unref?.();
+                }
+            }
+        });
+        rlErr = createInterface({ input: child.stderr });
+        rlErr.on("line", (line) => {
+            if (settled)
+                return;
+            stderrTail.push(line);
+            if (stderrTail.length > STDERR_TAIL_LINES)
+                stderrTail.shift();
+            process.stderr.write(`${dim("claude  " + line)}\n`);
+        });
+        if (options.signal?.aborted) {
+            onAbort();
+            return;
+        }
+        options.signal?.addEventListener("abort", onAbort, { once: true });
+        child.on("error", (err) => {
+            rejectOnce(err);
+        });
+        child.on("close", (code) => {
+            if (final && isLimitResult(final)) {
+                rejectOnce(new RateLimitError(final.result || "rate limit", lastResetsAt));
+                return;
+            }
+            if (code !== 0) {
+                rejectOnce(new Error(`claude exited with ${code}\n${stderrTail.join("\n")}`));
+                return;
+            }
+            resolveOnce(final);
+        });
+    });
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EACL,cAAc,EACd,SAAS,EACT,SAAS,EACT,QAAQ,EACR,MAAM,EACN,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGxC,OAAO,EACL,GAAG,EACH,WAAW,GAGZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,aAAa,EACb,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAazB,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,EAAW;IACzC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAA4B,CAAC;IAChD,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QACpD,OAAO,EAAE,OAAO,CAAC,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QACpE,OAAO,EAAE,CAAC,CAAC,QAAQ,KAAK,IAAI;QAC5B,cAAc,EACZ,OAAO,CAAC,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI;KACrE,CAAC;AACJ,CAAC;AAED,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAuB,EACvB,YAAoB,uBAAuB;IAE3C,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAClC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAuB;IACtD,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC9B,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC;AAID,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,GAAuB;IACnD,OAAO,GAAG,EAAE,IAAI,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,GAAuB;IACvD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,iFAAiF;AACjF,+EAA+E;AAC/E,MAAM,yBAAyB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,YAAoB,EACpB,cAAwB;IAExB,MAAM,OAAO,GAA4B;QACvC,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC,YAAY,CAAC,EAAE;QAC1C,gBAAgB,EAAE,yBAAyB;KAC5C,CAAC;IACF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,OAAO,GAAG,EAAE,cAAc,EAAE,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAChD,GAAG,CAAC,IAAI,GAAG,YAAY,CAAC;IACxB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,YAAoB,EACpB,SAAiB,EACjB,SAAiB;IAEjB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjE,OAAO,IAAI,CACT,YAAY,EACZ,WAAW,EACX,MAAM,EACN,GAAG,SAAS,QAAQ,SAAS,IAAI,SAAS,SAAS,CACpD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAY,EACZ,aAAqB,EACrB,SAAmB,EACnB,YAAqB;IAErB,MAAM,IAAI,GAAG;QACX,QAAQ;QACR,WAAW;QACX,SAAS;QACT,iBAAiB;QACjB,aAAa;KACd,CAAC;IACF,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACxB,IAAI,CAAC,IAAI,CACP,8CAA8C,aAAa,6CAA6C,CACzG,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAY,EACZ,cAAsB,EACtB,YAAoB,EACpB,SAAiB,EACjB,YAAqB,EACrB,eAAwB,EACxB,UAA2B,EAAE;IAE7B,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACnD,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACzC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,MAAM,OAAO,GACX,eAAe,IAAI,YAAY,CAAC,YAAY,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAEvE,MAAM,UAAU,GAAG,QAAQ,OAAO,CAAC,GAAG,IAAI,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC;IACvE,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAC1D,aAAa,CAAC,cAAc,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IAEtD,IAAI,gBAAoC,CAAC;IACzC,IAAI,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,SAAS,EAAE,CAAC;QACzD,MAAM,QAAQ,GAAG,oBAAoB,CACnC,YAAY,EACZ,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAChD,CAAC;QACF,gBAAgB,GAAG,IAAI,CACrB,UAAU,EACV,YAAY,OAAO,CAAC,GAAG,IAAI,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,OAAO,CAC1D,CAAC;QACF,aAAa,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,eAAe,CAC1B,KAAK,EACL,aAAa,EACb,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EACxC,gBAAgB,CACjB,CAAC;QACF,OAAO,MAAM,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,IAAI,gBAAgB;YAAE,MAAM,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,IAAI,YAAY;YAAE,MAAM,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CACnB,IAAc,EACd,GAAW,EACX,OAAe,EACf,UAA2B,EAAE;IAE7B,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;QAC7C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAE/D,wDAAwD;QACxD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YAC1C,GAAG;YACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QAEH,IAAI,KAAK,GAAgB;YACvB,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,KAAK;YACd,cAAc,EAAE,IAAI;SACrB,CAAC;QACF,IAAI,YAAY,GAAkB,IAAI,CAAC;QACvC,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,OAAO,GAAG,GAAS,EAAE,GAAE,CAAC,CAAC;QAC7B,IAAI,EAAkD,CAAC;QACvD,IAAI,KAAqD,CAAC;QAC1D,IAAI,UAAqD,CAAC;QAE1D,MAAM,MAAM,GAAG,CAAC,EAAc,EAAQ,EAAE;YACtC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,UAAU,EAAE,CAAC;gBACf,YAAY,CAAC,UAAU,CAAC,CAAC;gBACzB,UAAU,GAAG,SAAS,CAAC;YACzB,CAAC;YACD,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACtD,IAAI,CAAC;gBACH,EAAE,EAAE,KAAK,EAAE,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,kBAAkB;YACpB,CAAC;YACD,IAAI,CAAC;gBACH,KAAK,EAAE,KAAK,EAAE,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,kBAAkB;YACpB,CAAC;YACD,IAAI,CAAC;gBACH,SAAS,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,kBAAkB;YACpB,CAAC;YACD,EAAE,EAAE,CAAC;QACP,CAAC,CAAC;QAEF,MAAM,UAAU,GAAG,CAAC,GAAY,EAAQ,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,MAAM,WAAW,GAAG,CAAC,KAAkB,EAAQ,EAAE,CAC/C,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAE/B,OAAO,GAAG,GAAS,EAAE;YACnB,IAAI,CAAC;gBACH,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,CAAC;YAAC,MAAM,CAAC;gBACP,4DAA4D;YAC9D,CAAC;YACD,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3B,CAAC,CAAC;QAEF,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9C,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACrB,IAAI,OAAO;gBAAE,OAAO;YACpB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,OAAO;YAElC,cAAc,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;YAEnC,IAAI,MAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;YACD,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC7B,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBACvC,MAAM,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;gBACpC,IAAI,CAAC,IAAI,IAAI;oBAAE,YAAY,GAAG,CAAC,CAAC;YAClC,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;gBAChC,kEAAkE;gBAClE,kEAAkE;gBAClE,6CAA6C;gBAC7C,IAAI,CAAC,UAAU,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBAC/B,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;wBAC3B,IAAI,OAAO;4BAAE,OAAO;wBACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,GAAG,CAAC,2BAA2B,OAAO,uCAAuC,CAAC,IAAI,CACtF,CAAC;wBACF,IAAI,CAAC;4BACH,KAAK,CAAC,IAAI,EAAE,CAAC;wBACf,CAAC;wBAAC,MAAM,CAAC;4BACP,gEAAgE;wBAClE,CAAC;wBACD,IAAI,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;4BAClC,UAAU,CACR,IAAI,cAAc,CAAC,KAAK,CAAC,MAAM,IAAI,YAAY,EAAE,YAAY,CAAC,CAC/D,CAAC;wBACJ,CAAC;6BAAM,CAAC;4BACN,WAAW,CAAC,KAAK,CAAC,CAAC;wBACrB,CAAC;oBACH,CAAC,EAAE,OAAO,CAAC,CAAC;oBACZ,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,KAAK,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACjD,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,IAAI,OAAO;gBAAE,OAAO;YACpB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,IAAI,UAAU,CAAC,MAAM,GAAG,iBAAiB;gBAAE,UAAU,CAAC,KAAK,EAAE,CAAC;YAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YAC5B,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,UAAU,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClC,UAAU,CACR,IAAI,cAAc,CAAC,KAAK,CAAC,MAAM,IAAI,YAAY,EAAE,YAAY,CAAC,CAC/D,CAAC;gBACF,OAAO;YACT,CAAC;YACD,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,UAAU,CACR,IAAI,KAAK,CAAC,sBAAsB,IAAI,KAAK,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAClE,CAAC;gBACF,OAAO;YACT,CAAC;YACD,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/stage-exec.d.ts

@@ -0,0 +1,16 @@
+import { type StageResult } from "./runner.js";
+import type { Stage } from "./stages.js";
+export type ExecuteStageOptions = {
+    stage: Stage;
+    vars: Record<string, string>;
+    workspaceDir: string;
+    packageDir: string;
+    iteration: number;
+    maxRetries: number;
+    signal?: AbortSignal;
+    /** Disambiguates spill/log paths when multiple sub-stages share an iteration (panel lenses). */
+    logLabel?: string;
+};
+/** Render a stage's template (inside the retry, so flaky shell tags retry) and run it. */
+export declare function executeStage(opts: ExecuteStageOptions): Promise<StageResult>;
+//# sourceMappingURL=stage-exec.d.ts.map

package/dist/stage-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-exec.d.ts","sourceRoot":"","sources":["../src/stage-exec.ts"],"names":[],"mappings":"AAIA,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,0FAA0F;AAC1F,wBAAsB,YAAY,CAChC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,WAAW,CAAC,CAmDtB"}