@phamvuhoang/otto-core 0.1.0

package/dist/keepalive.js

@@ -0,0 +1,138 @@
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+const NOOP_RELEASER = { release: () => { } };
+const DEFAULT_REASON = "otto-afk loop";
+function defaultSpawner(command, args, options) {
+    return spawn(command, args, {
+        detached: options.detached ?? false,
+        stdio: options.stdio ?? "ignore",
+        windowsHide: true,
+    });
+}
+function defaultWslHint() {
+    try {
+        if (!existsSync("/proc/version"))
+            return false;
+        return /microsoft/i.test(readFileSync("/proc/version", "utf8"));
+    }
+    catch {
+        return false;
+    }
+}
+function defaultWarn(msg) {
+    process.stderr.write(`[keepalive] ${msg}\n`);
+}
+/**
+ * Build the powershell argv that holds ES_SYSTEM_REQUIRED for the lifetime of
+ * the spawned child. Killing the child lets the OS clear ES_CONTINUOUS on
+ * process exit (per SetThreadExecutionState docs).
+ */
+function windowsArgs() {
+    const script = "Add-Type -TypeDefinition 'using System;using System.Runtime.InteropServices;" +
+        'public static class P{[DllImport("kernel32.dll")]' +
+        "public static extern uint SetThreadExecutionState(uint e);}';" +
+        "[P]::SetThreadExecutionState(0x80000000 -bor 0x00000001) | Out-Null;" +
+        "while($true){Start-Sleep -Seconds 60}";
+    return {
+        cmd: "powershell",
+        args: ["-NoProfile", "-NonInteractive", "-Command", script],
+    };
+}
+function macosArgs(parentPid) {
+    return {
+        cmd: "caffeinate",
+        args: ["-i", "-w", String(parentPid)],
+    };
+}
+function linuxArgs(reason) {
+    return {
+        cmd: "systemd-inhibit",
+        args: [
+            "--what=sleep",
+            `--why=${reason}`,
+            "--mode=block",
+            "sleep",
+            "infinity",
+        ],
+    };
+}
+/**
+ * Acquire an OS wake-lock for the lifetime of the returned Releaser. Platform
+ * dispatch is per-OS; missing utilities degrade to a no-op (warning emitted
+ * once) so the loop never crashes on a stripped image.
+ */
+export function acquire(opts = {}) {
+    const platform = opts.platform ?? process.platform;
+    const spawner = opts.spawner ?? defaultSpawner;
+    const parentPid = opts.parentPid ?? process.pid;
+    const wslHint = opts.wslHint ?? defaultWslHint;
+    const warn = opts.warn ?? defaultWarn;
+    const reason = opts.reason ?? DEFAULT_REASON;
+    if (platform === "linux" && wslHint()) {
+        warn("WSL2 detected: systemd-inhibit blocks WSL idle only, not Windows host sleep. " +
+            "Configure the Windows power plan to keep the host awake.");
+    }
+    let spec;
+    if (platform === "win32") {
+        spec = windowsArgs();
+    }
+    else if (platform === "darwin") {
+        spec = macosArgs(parentPid);
+    }
+    else if (platform === "linux") {
+        spec = linuxArgs(reason);
+    }
+    else {
+        warn(`unsupported platform ${platform}: skipping wake-lock`);
+        return NOOP_RELEASER;
+    }
+    let child;
+    try {
+        child = spawner(spec.cmd, spec.args, { stdio: "ignore" });
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT") {
+            warn(`${spec.cmd} not found: continuing without wake-lock`);
+        }
+        else {
+            warn(`failed to spawn ${spec.cmd}: ${err.message}. Continuing without wake-lock.`);
+        }
+        return NOOP_RELEASER;
+    }
+    // Swallow spawn-time errors emitted asynchronously (e.g. ENOENT surfaced on
+    // the child rather than thrown by spawn itself on some platforms).
+    let released = false;
+    child.on("error", (err) => {
+        if (released)
+            return;
+        released = true;
+        if (err.code === "ENOENT") {
+            warn(`${spec.cmd} not found: continuing without wake-lock`);
+        }
+        else {
+            warn(`wake-lock child error: ${err.message}`);
+        }
+    });
+    child.on("close", (code, signal) => {
+        if (released)
+            return;
+        released = true;
+        const reason = code == null ? `signal ${signal ?? "unknown"}` : `exit ${code}`;
+        warn(`${spec.cmd} wake-lock exited early (${reason}); continuing without wake-lock`);
+    });
+    return {
+        release: () => {
+            if (released)
+                return;
+            released = true;
+            try {
+                child.kill();
+            }
+            catch {
+                // Already dead; ignore.
+            }
+        },
+    };
+}
+//# sourceMappingURL=keepalive.js.map

package/dist/keepalive.js.map

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

package/dist/loop.d.ts

@@ -0,0 +1,42 @@
+import type { Stage } from "./stages.js";
+export type LoopOptions = {
+    stages: [Stage, ...Stage[]];
+    inputs: string;
+    iterations: number;
+    /** Host repo Claude runs against (cwd). */
+    workspaceDir: string;
+    /** Installed @phamvuhoang/otto-core dir; stage templates are read from <packageDir>/templates. */
+    packageDir: string;
+    /** When true, skip OS wake-lock acquisition. Default: false. */
+    noKeepAlive?: boolean;
+    /** Per-stage retry budget. Default: 3. Set to 0 to disable retries. */
+    maxRetries?: number;
+    /** When true, fire OS notification + bell on loop terminal events. Default: false. */
+    notify?: boolean;
+    /** Bin name for the init-time version banner (e.g. "otto-afk"). */
+    bin?: string;
+    /** CLI version for the init-time version banner. */
+    cliVersion?: string;
+    /** Stop the loop when cumulative stage cost reaches this USD ceiling. */
+    budgetUsd?: number;
+    /** Milliseconds to wait between iterations. 0 = no cooldown. */
+    cooldownMs?: number;
+    /** Opt-in reviewer panel: replace the single reviewer stage with K read-only lens reviewers + one synth commit. */
+    reviewLenses?: string[];
+    /** Injected AbortSignal for daemon callers (e.g. watch mode). When provided,
+     *  runLoop skips wake-lock acquisition and process signal handler installation;
+     *  the caller owns both. */
+    signal?: AbortSignal;
+    /** Run mode for state.json identity (e.g. "afk" / "ghafk"). Default "afk". */
+    mode?: string;
+    /** Cap on the rate-limit wait before halting. Default 6h. */
+    maxWaitMs?: number;
+    /** Force a fresh run, ignoring/clearing prior state. Default false. */
+    fresh?: boolean;
+};
+export type LoopOutcome = {
+    costUsd: number;
+    sentinelHit: boolean;
+};
+export declare function runLoop(opts: LoopOptions): Promise<LoopOutcome>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAUzC,MAAM,MAAM,WAAW,GAAG;IAGxB,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,kGAAkG;IAClG,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mHAAmH;IACnH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;gCAE4B;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpE,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAuRrE"}

package/dist/loop.js

@@ -0,0 +1,238 @@
+import { appendFileSync } from "node:fs";
+import { readCoreVersion } from "./cli-help.js";
+import { acquire } from "./keepalive.js";
+import { notifyComplete, notifyError } from "./notify.js";
+import { sleep, isThrottle, nextCooldownFactor } from "./pacing.js";
+import { computeWaitMs } from "./rate-limit.js";
+import { DEFAULT_MAX_RETRIES } from "./retry.js";
+import { stageLogPath } from "./runner.js";
+import { executeStage } from "./stage-exec.js";
+import { clearState, matchesResume, readState, writeState, } from "./state.js";
+import { USE_COLOR, dim, bold, red, greenOut, boldOut, dimOut, SYM, SYM_OUT, } from "./stream-render.js";
+// The agent emits this literal when there is no more work; the same string is
+// mirrored in the playbook templates (prompt.md / ghprompt.md) that instruct it.
+const SENTINEL = "<promise>NO MORE TASKS</promise>";
+const RATE_LIMIT_BUFFER_MS = 30_000;
+const RATE_LIMIT_FALLBACK_MS = 15 * 60_000;
+const DEFAULT_MAX_WAIT_MS = 6 * 3600_000;
+export async function runLoop(opts) {
+    const { stages, inputs, iterations, workspaceDir, packageDir, noKeepAlive = false, maxRetries = DEFAULT_MAX_RETRIES, notify = false, bin = "otto", cliVersion = "?", budgetUsd, cooldownMs = 0, reviewLenses, signal: externalSignal, mode = "afk", maxWaitMs = DEFAULT_MAX_WAIT_MS, fresh = false, } = opts;
+    const versionLine = `${bin} ${cliVersion} (core ${readCoreVersion()})`;
+    process.stderr.write(`${USE_COLOR ? `${dim("━━━")} ${bold(versionLine)} ${dim("━━━")}` : `== ${versionLine} ==`}\n`);
+    // When an external signal is injected (daemon/watch mode), the caller owns
+    // wake-lock + process signal handlers. Skip both here.
+    const releaser = externalSignal || noKeepAlive
+        ? { release: () => { } }
+        : acquire({ reason: `${bin} loop` });
+    const stageAbort = externalSignal ? undefined : new AbortController();
+    const activeSignal = externalSignal ?? stageAbort.signal;
+    // Single release path: signal handlers and the finally below all funnel
+    // through releaseOnce so the wake-lock child is killed exactly once.
+    let released = false;
+    const releaseOnce = () => {
+        if (released)
+            return;
+        released = true;
+        releaser.release();
+    };
+    let onSigint;
+    let onSigterm;
+    if (!externalSignal) {
+        const abortActiveStage = () => {
+            if (!stageAbort.signal.aborted)
+                stageAbort.abort();
+        };
+        onSigint = () => {
+            abortActiveStage();
+            if (notify)
+                notifyError("interrupted (SIGINT)");
+            releaseOnce();
+            process.exit(130);
+        };
+        onSigterm = () => {
+            abortActiveStage();
+            if (notify)
+                notifyError("terminated (SIGTERM)");
+            releaseOnce();
+            process.exit(143);
+        };
+        process.on("SIGINT", onSigint);
+        process.on("SIGTERM", onSigterm);
+    }
+    let completedIterations = 0;
+    let sentinelHit = false;
+    let runCostUsd = 0;
+    let cooldownFactor = 1;
+    // Single source of truth for per-stage accounting: tally cost, report it,
+    // advance the adaptive cooldown factor on throttle, and report whether the
+    // budget is now exhausted. Used once per non-panel stage AND once per panel
+    // sub-agent (passed to runPanel as onStage), so budget + adaptive pacing
+    // apply uniformly to lenses, synth, and ordinary stages alike.
+    const accountStage = (sr) => {
+        runCostUsd += sr.costUsd;
+        process.stderr.write(`${dim(`· $${sr.costUsd.toFixed(2)} (run $${runCostUsd.toFixed(2)})`)}\n`);
+        cooldownFactor = nextCooldownFactor(cooldownFactor, isThrottle(sr.apiErrorStatus));
+        return {
+            stop: budgetUsd != null && runCostUsd >= budgetUsd,
+            cooldownFactor,
+        };
+    };
+    const nowIso = () => new Date().toISOString();
+    if (fresh)
+        clearState(workspaceDir);
+    const prior = fresh ? null : readState(workspaceDir);
+    const resuming = matchesResume(prior, { bin, mode, inputs });
+    const startIteration = resuming ? prior.iteration : 1;
+    const total = resuming ? prior.of : iterations;
+    let resumeNote = "";
+    if (resuming) {
+        resumeNote = `Resumed run (iteration ${startIteration} of ${total}). Prior work is committed — reconcile against git history and the working tree before acting; do not redo completed tasks.`;
+        process.stdout.write(`${greenOut(SYM_OUT.bullet)} ${boldOut("resuming")}${dimOut(` from iteration ${startIteration}/${total}`)}\n`);
+    }
+    const persist = (iteration, status, resetsAt) => writeState(workspaceDir, {
+        bin,
+        mode,
+        inputs,
+        iteration,
+        of: total,
+        status,
+        resetsAt: resetsAt ?? null,
+        startedAt: prior?.startedAt ?? nowIso(),
+        updatedAt: nowIso(),
+    });
+    if (resuming && prior.status === "waiting-rate-limit") {
+        const waitMs = computeWaitMs(prior.resetsAt ?? null, Date.now(), RATE_LIMIT_BUFFER_MS, 0);
+        if (waitMs > 0 && waitMs <= maxWaitMs) {
+            process.stderr.write(`${dim(`waiting ${Math.round(waitMs / 60000)}m to clear the prior rate limit`)}\n`);
+            await sleep(waitMs, activeSignal);
+        }
+    }
+    try {
+        for (let i = startIteration; i <= total; i++) {
+            persist(i, "running");
+            for (let s = 0; s < stages.length; s++) {
+                const stage = stages[s];
+                // Budget gate: check before running each stage.
+                if (budgetUsd != null && runCostUsd >= budgetUsd) {
+                    process.stdout.write(`${greenOut(SYM_OUT.bullet)} ${boldOut("budget reached")}${dimOut(` $${runCostUsd.toFixed(2)} ≥ $${budgetUsd.toFixed(2)} after ${i - 1} iterations`)}\n`);
+                    return { costUsd: runCostUsd, sentinelHit };
+                }
+                const banner = USE_COLOR
+                    ? `${dim("━━━")} ${bold(`iteration ${i}/${total}`)} ${dim("·")} ${bold(stage.name)} ${dim(`(stage ${s + 1}/${stages.length})`)} ${dim("━━━")}`
+                    : `== iteration ${i}/${total} · ${stage.name} (stage ${s + 1}/${stages.length}) ==`;
+                process.stderr.write(`\n${banner}\n`);
+                const usePanel = reviewLenses && reviewLenses.length > 0 && stage.name === "reviewer";
+                let sr;
+                const runOnce = async () => {
+                    if (usePanel) {
+                        const { runPanel } = await import("./panel.js");
+                        return runPanel({
+                            lenses: reviewLenses,
+                            workspaceDir,
+                            packageDir,
+                            iteration: i,
+                            maxRetries,
+                            cooldownMs,
+                            signal: activeSignal,
+                            onStage: accountStage,
+                        });
+                    }
+                    const r = await executeStage({
+                        stage,
+                        vars: { INPUTS: inputs, RESUME: resumeNote },
+                        workspaceDir,
+                        packageDir,
+                        iteration: i,
+                        maxRetries,
+                        signal: activeSignal,
+                    });
+                    accountStage(r);
+                    return r;
+                };
+                try {
+                    for (;;) {
+                        try {
+                            sr = await runOnce();
+                            break;
+                        }
+                        catch (err) {
+                            if (err?.name !== "RateLimitError")
+                                throw err;
+                            const resetsAt = err.resetsAt;
+                            const waitMs = computeWaitMs(resetsAt, Date.now(), RATE_LIMIT_BUFFER_MS, RATE_LIMIT_FALLBACK_MS);
+                            if (waitMs > maxWaitMs) {
+                                persist(i, "interrupted", resetsAt);
+                                process.stdout.write(`${red(SYM.cross)} ${bold("rate limit")}${dim(` — reset is beyond --max-wait; halting at iteration ${i}. Re-run to resume.`)}\n`);
+                                return { costUsd: runCostUsd, sentinelHit };
+                            }
+                            persist(i, "waiting-rate-limit", resetsAt);
+                            const mins = Math.round(waitMs / 60000);
+                            process.stderr.write(`${dim(`⏸ rate limit — waiting ~${mins}m until reset, then resuming`)}\n`);
+                            await sleep(waitMs, activeSignal);
+                            persist(i, "running");
+                        }
+                    }
+                }
+                catch (err) {
+                    if (activeSignal.aborted) {
+                        return { costUsd: runCostUsd, sentinelHit };
+                    }
+                    const stageLog = stageLogPath(workspaceDir, i, stage.name);
+                    const failureMarker = `[failure] iteration ${i} stage ${stage.name} failed after ${maxRetries} retries: ${err.message}`;
+                    try {
+                        appendFileSync(stageLog, failureMarker + "\n");
+                    }
+                    catch {
+                        // log file may be unwritable; stderr still carries the failure.
+                    }
+                    const msg = `${red(SYM.cross)} ${bold("iteration " + i + " stage " + stage.name + " failed")} after ${maxRetries} retries: ${err.message}`;
+                    process.stderr.write(msg + "\n");
+                    break;
+                }
+                // Cost/pacing accounting is handled by accountStage — called once per
+                // non-panel stage above, and once per sub-agent inside runPanel.
+                if (s === 0) {
+                    if (sr.result.includes(SENTINEL)) {
+                        const msg = greenOut(SYM_OUT.bullet) +
+                            " " +
+                            boldOut("Otto complete") +
+                            dimOut(" after " + i + " iterations");
+                        process.stdout.write(msg + "\n");
+                        sentinelHit = true;
+                        completedIterations = i;
+                        persist(i, "complete");
+                        clearState(workspaceDir);
+                        return { costUsd: runCostUsd, sentinelHit };
+                    }
+                }
+            }
+            completedIterations = i;
+            // Cooldown between iterations.
+            if (cooldownMs > 0 && i < total) {
+                const wait = cooldownMs * cooldownFactor;
+                if (cooldownFactor > 1) {
+                    process.stderr.write(`${dim(`cooldown ×${cooldownFactor} → ${wait}ms (throttle backoff)`)}\n`);
+                }
+                await sleep(wait, activeSignal);
+            }
+        }
+    }
+    catch (err) {
+        if (notify)
+            notifyError(err.message);
+        throw err;
+    }
+    finally {
+        if (onSigint)
+            process.off("SIGINT", onSigint);
+        if (onSigterm)
+            process.off("SIGTERM", onSigterm);
+        releaseOnce();
+        if (notify && (sentinelHit || completedIterations === total)) {
+            notifyComplete(completedIterations, sentinelHit);
+        }
+    }
+    clearState(workspaceDir);
+    return { costUsd: runCostUsd, sentinelHit };
+}
+//# sourceMappingURL=loop.js.map

package/dist/loop.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,5 @@
+export type RunAfkOptions = {
+    cliVersion?: string;
+};
+export declare function runAfk(argv: string[], opts?: RunAfkOptions): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpD,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/main.js

@@ -0,0 +1,16 @@
+import { runBin } from "./run-bin.js";
+import { STAGES } from "./stages.js";
+export async function runAfk(argv, opts = {}) {
+    await runBin(argv, {
+        bin: "otto-afk",
+        usage: "<plan-and-prd> <iterations>",
+        desc: "plan/PRD-driven Claude Code AFK loop",
+        stages: [STAGES.implementer, STAGES.reviewer],
+        takesInputArg: true,
+        cliVersion: opts.cliVersion,
+        verifyStage: STAGES.verifier,
+        applyReviewStage: STAGES.applyReviewImplementer,
+        mode: "afk",
+    });
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,IAAc,EACd,OAAsB,EAAE;IAExB,MAAM,MAAM,CAAC,IAAI,EAAE;QACjB,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,6BAA6B;QACpC,IAAI,EAAE,sCAAsC;QAC5C,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC;QAC7C,aAAa,EAAE,IAAI;QACnB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,MAAM,CAAC,QAAQ;QAC5B,gBAAgB,EAAE,MAAM,CAAC,sBAAsB;QAC/C,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;AACL,CAAC"}

package/dist/notify.d.ts

@@ -0,0 +1,28 @@
+import { type ChildProcess } from "node:child_process";
+export type NotifyLevel = "info" | "error";
+export type NotifySpawnedChild = Pick<ChildProcess, "on" | "unref">;
+export type NotifySpawner = (command: string, args: readonly string[]) => NotifySpawnedChild;
+export type NotifyOptions = {
+    title: string;
+    body: string;
+    level: NotifyLevel;
+    /** When false, suppress the terminal bell. Default: true. */
+    sound?: boolean;
+    platform?: NodeJS.Platform;
+    spawner?: NotifySpawner;
+    stderr?: {
+        write: (s: string) => void;
+    };
+};
+/**
+ * Fire a best-effort OS notification + terminal bell. Synchronous return;
+ * never blocks on toast delivery, never crashes on a missing utility.
+ *
+ * Bell (\x07) is written to stderr on every call regardless of OS path.
+ * Apostrophes / quotes in `title` / `body` are escaped per-platform so a
+ * `'` in the message doesn't break the shell wrapping.
+ */
+export declare function notify(opts: NotifyOptions): void;
+export declare function notifyComplete(iterations: number, sentinel: boolean): void;
+export declare function notifyError(message: string): void;
+//# sourceMappingURL=notify.d.ts.map

package/dist/notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3C,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC;AAEpE,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,KACpB,kBAAkB,CAAC;AAExB,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;CACzC,CAAC;AAmGF;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAsBhD;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAQ1E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAMjD"}

package/dist/notify.js

@@ -0,0 +1,119 @@
+import { spawn } from "node:child_process";
+function defaultSpawner(command, args) {
+    return spawn(command, args, {
+        detached: true,
+        stdio: "ignore",
+        windowsHide: true,
+    });
+}
+/**
+ * Spawn a fire-and-forget child. Swallows spawn-time + async errors so a
+ * missing utility (ENOENT) never crashes the loop.
+ */
+function fireAndForget(spawner, cmd, args) {
+    try {
+        const child = spawner(cmd, args);
+        child.on("error", () => {
+            // Async ENOENT (Linux): swallow. The whole point is fire-and-forget.
+        });
+        child.unref();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function escDoubleQuote(s) {
+    return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+function escPsString(s) {
+    // PowerShell single-quoted literal: ' is escaped by doubling.
+    return s.replace(/'/g, "''");
+}
+function windowsToast(spawner, title, body) {
+    // Try BurntToast first; fall back to msg.exe. Both fire-and-forget; if the
+    // module is missing, the powershell child exits non-zero — we don't observe
+    // it, the caller has already gotten the bell.
+    const psScript = `if (Get-Module -ListAvailable -Name BurntToast) { ` +
+        `Import-Module BurntToast; ` +
+        `New-BurntToastNotification -Text '${escPsString(title)}','${escPsString(body)}' ` +
+        `} else { exit 1 }`;
+    const ok = fireAndForget(spawner, "powershell", [
+        "-NoProfile",
+        "-NonInteractive",
+        "-Command",
+        psScript,
+    ]);
+    if (!ok)
+        return false;
+    // Always also try msg.exe as a secondary path (cheap, mostly a no-op when
+    // BurntToast wins). msg.exe is not on every Windows SKU (Home edition lacks
+    // it) — swallow failure.
+    fireAndForget(spawner, "msg.exe", ["*", `${title}: ${body}`]);
+    return true;
+}
+function macosBanner(spawner, title, body, level) {
+    const sound = level === "info" ? "Glass" : "Basso";
+    const script = `display notification "${escDoubleQuote(body)}" ` +
+        `with title "${escDoubleQuote(title)}" ` +
+        `sound name "${sound}"`;
+    return fireAndForget(spawner, "osascript", ["-e", script]);
+}
+function linuxNotifySend(spawner, title, body, level) {
+    const urgency = level === "error" ? "critical" : "normal";
+    return fireAndForget(spawner, "notify-send", [
+        "--urgency",
+        urgency,
+        title,
+        body,
+    ]);
+}
+/**
+ * Fire a best-effort OS notification + terminal bell. Synchronous return;
+ * never blocks on toast delivery, never crashes on a missing utility.
+ *
+ * Bell (\x07) is written to stderr on every call regardless of OS path.
+ * Apostrophes / quotes in `title` / `body` are escaped per-platform so a
+ * `'` in the message doesn't break the shell wrapping.
+ */
+export function notify(opts) {
+    const platform = opts.platform ?? process.platform;
+    const spawner = opts.spawner ?? defaultSpawner;
+    const stderr = opts.stderr ?? process.stderr;
+    const sound = opts.sound ?? true;
+    if (sound) {
+        try {
+            stderr.write("\x07");
+        }
+        catch {
+            // never crash on a bell write.
+        }
+    }
+    if (platform === "win32") {
+        windowsToast(spawner, opts.title, opts.body);
+    }
+    else if (platform === "darwin") {
+        macosBanner(spawner, opts.title, opts.body, opts.level);
+    }
+    else if (platform === "linux") {
+        linuxNotifySend(spawner, opts.title, opts.body, opts.level);
+    }
+    // unsupported platforms: bell-only, no toast attempt.
+}
+export function notifyComplete(iterations, sentinel) {
+    notify({
+        level: "info",
+        title: "Otto complete",
+        body: sentinel
+            ? `Sentinel hit after ${iterations} iteration${iterations === 1 ? "" : "s"}.`
+            : `Reached iteration cap (${iterations}).`,
+    });
+}
+export function notifyError(message) {
+    notify({
+        level: "error",
+        title: "Otto failed",
+        body: message,
+    });
+}
+//# sourceMappingURL=notify.js.map

package/dist/notify.js.map

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

package/dist/pacing.d.ts

@@ -0,0 +1,8 @@
+/** Abortable delay. Resolves after `ms`; rejects with an AbortError if `signal` fires. */
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+export declare const THROTTLE_RE: RegExp;
+/** True when a result's `api_error_status` looks like provider throttling. */
+export declare function isThrottle(apiErrorStatus: string | null): boolean;
+/** Adaptive cooldown multiplier: reset to 1 when healthy, else double up to `cap`. */
+export declare function nextCooldownFactor(prev: number, throttled: boolean, cap?: number): number;
+//# sourceMappingURL=pacing.d.ts.map

package/dist/pacing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pacing.d.ts","sourceRoot":"","sources":["../src/pacing.ts"],"names":[],"mappings":"AAMA,0FAA0F;AAC1F,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAcrE;AAED,eAAO,MAAM,WAAW,QAA8B,CAAC;AAEvD,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAEjE;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,OAAO,EAClB,GAAG,SAAI,GACN,MAAM,CAER"}