@mousedev/harness-core 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pete McGrath and Mouse contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# @mousedev/harness-core
+
+The Mouse completion loop and everything it needs, with zero runtime dependencies. After each model turn the loop probes the workspace deterministically (did anything change, do the repository's checks pass, was a test or workflow file deleted), then either stops with evidence or sends a continue prompt to the same session with the failing output and a request for a structured `MOUSE_AUDIT` self-audit. It is engine-agnostic: an `Engine` is anything that can take a prompt and report steps and text, and a `Workspace` is a directory plus a way to run a shell command in it.
+
+This package is what a host embeds. The CLI in `@mousedev/harness` wires it to a local checkout and to `opencode run` through `@mousedev/harness-opencode`; a hosted product wires the same functions to its own sandbox. Nothing here touches the network, and the only filesystem writes are the trace file under `~/.mouse/runs/` and the temp marker the CLI creates. Prompt bytes in `prompt.ts` and `loop.ts` are cache-sensitive and pinned by a golden test; see [AGENTS.md](../../AGENTS.md) before editing them.
+
+## Main API
+
+```ts
+import {
+  localWorkspace, loadPolicy, headSha, makeProbe, runCompletionLoop,
+  openTrace, traceFile, parseAuditBlock, buildContinuePrompt, buildAgentPrompt,
+  DEFAULT_POLICY, parsePolicy, permissionRulesForTool,
+  detectEcosystem, checksFromEcosystem, classifyInferenceFailure,
+} from "@mousedev/harness-core";
+```
+
+| Module | Exports |
+|---|---|
+| `loop.ts` | `runCompletionLoop(input)`, `buildContinuePrompt(kind, ctx)`, `parseAuditBlock(text)`, `MIN_ROUND_MS`, types `CompletionProbe`, `CompletionBudget`, `CompletionOutcome`, `ContinueKind`, `CompletionRound`, `CompletionResult` |
+| `engine.ts` | `Engine`, `PromptResult`, `PromptOptions`, `TokenTotals` |
+| `workspace.ts`, `exec.ts` | `Workspace`, `localWorkspace({ root })`, `shellPath`, `LOCAL_EXEC_TIMEOUT_CODE` |
+| `probe.ts` | `makeProbe({ workspace, runStartSha, marker, signal, checks?, checkTimeoutMs? })` |
+| `policy.ts` | `DEFAULT_POLICY`, `parsePolicy`, `loadPolicy(ws)`, `parseChecks`, `parsePermissions`, `permissionRulesForTool` |
+| `detect.ts` | `detectEcosystem(ws)`, `checksFromEcosystem`, `checksFromPackageJson`, `pytestCommand`, `detectEcosystemCommand` |
+| `git.ts` | `headSha`, `fingerprint`, `deletedVerificationFiles`, `VERIFICATION_PATH` |
+| `mea.ts` | `initTaskState`, `applyAudit`, `auditFromSandboxProbe`, types `TaskState`, `AuditReport` |
+| `prompt.ts` | `buildAgentPrompt(mode, { profile })`, `AGENT_PROMPT_MAX_CHARS`, types `Mode`, `Profile` |
+| `trace.ts`, `paths.ts` | `openTrace(file)`, `parseTrace(text)`, `TRACE_VERSION`, `mouseHome`, `runsDir`, `traceFile`, `workspaceSlug` |
+| `events.ts` | `LoopEvent` |
+| `version.ts` | `MOUSE_VERSION` |
+| `failures.ts` | `classifyInferenceFailure(message, raw?)` |
+
+A complete example that drives the loop from your own code is [`examples/sdk-run`](../../examples/sdk-run/src/run.ts). The loop's behaviour, step by step, is in [docs/loop.md](../../docs/loop.md); the policy file in [docs/config.md](../../docs/config.md).
+
+Requires Node 22 or newer. MIT.

package/dist/detect.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Which checks "done" means for a repo, detected from its manifests.
+ *
+ * package.json scripts, pytest, go test, cargo test, and make test. One shell
+ * round trip prints every signal; parsing is pure so it can be tested without
+ * a filesystem.
+ */
+import { type Workspace } from "./workspace.js";
+export type PackageManager = "pnpm" | "yarn" | "npm";
+export interface DetectedCheck {
+    name: string;
+    command: string;
+}
+export interface EcosystemManifest {
+    packageJson: string | null;
+    packageManager: PackageManager;
+    pyproject: boolean;
+    pytestIni: boolean;
+    setupCfg: boolean;
+    toxIni: boolean;
+    testsDir: boolean;
+    uvLock: boolean;
+    poetryLock: boolean;
+    goMod: boolean;
+    cargoToml: boolean;
+    makefileTest: boolean;
+}
+export declare const EMPTY_MANIFEST: EcosystemManifest;
+/** Checks derived from `package.json` scripts, or `[]` when there are none. */
+export declare function checksFromPackageJson(packageJson: string | null, pm?: PackageManager): DetectedCheck[];
+export declare function pytestCommand(m: Pick<EcosystemManifest, "uvLock" | "poetryLock">): string;
+/**
+ * Checks for every ecosystem the manifest shows. package.json scripts come
+ * first because they are the repo's own declaration; the others are the
+ * conventional runner for each toolchain. A monorepo with several gets all
+ * of them.
+ */
+export declare function checksFromEcosystem(m: EcosystemManifest): DetectedCheck[];
+/** One shell round trip that prints every manifest signal for `root`. */
+export declare function detectEcosystemCommand(root: string): string;
+/** The probe for the conventional `/workspace` root, as hosted sandboxes lay it out. */
+export declare const DETECT_ECOSYSTEM_COMMAND: string;
+export declare function parseEcosystemOutput(stdout: string): EcosystemManifest;
+export declare function detectEcosystem(ws: Workspace): Promise<EcosystemManifest>;
+//# sourceMappingURL=detect.d.ts.map

package/dist/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,cAAc,EAAE,iBAa5B,CAAC;AA2BF,+EAA+E;AAC/E,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,EAAE,GAAE,cAAsB,GACzB,aAAa,EAAE,CAUjB;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,YAAY,CAAC,GAAG,MAAM,CAIzF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,iBAAiB,GAAG,aAAa,EAAE,CAQzE;AAaD,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW3D;AAED,wFAAwF;AACxF,eAAO,MAAM,wBAAwB,QAAuC,CAAC;AAE7E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAmDtE;AAED,wBAAsB,eAAe,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAK/E"}

package/dist/detect.js

@@ -0,0 +1,170 @@
+/**
+ * Which checks "done" means for a repo, detected from its manifests.
+ *
+ * package.json scripts, pytest, go test, cargo test, and make test. One shell
+ * round trip prints every signal; parsing is pure so it can be tested without
+ * a filesystem.
+ */
+import { shellPath } from "./workspace.js";
+export const EMPTY_MANIFEST = {
+    packageJson: null,
+    packageManager: "npm",
+    pyproject: false,
+    pytestIni: false,
+    setupCfg: false,
+    toxIni: false,
+    testsDir: false,
+    uvLock: false,
+    poetryLock: false,
+    goMod: false,
+    cargoToml: false,
+    makefileTest: false,
+};
+/** Script-derived defaults, in the order they run. First present script wins per slot. */
+const DEFAULT_SCRIPTS = [
+    ["build", ["build", "typecheck"]],
+    ["test", ["test"]],
+    ["lint", ["lint"]],
+];
+const PYTEST_ARGS = "-q --maxfail=25 -p no:cacheprovider";
+function parseJsonObject(raw) {
+    if (!raw?.trim())
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+function runCommand(pm, script) {
+    return pm === "npm" ? `npm run ${script} --if-present` : `${pm} run ${script}`;
+}
+/** Checks derived from `package.json` scripts, or `[]` when there are none. */
+export function checksFromPackageJson(packageJson, pm = "npm") {
+    const scripts = parseJsonObject(packageJson)?.scripts;
+    if (!scripts || typeof scripts !== "object")
+        return [];
+    const has = (s) => typeof scripts[s] === "string";
+    const out = [];
+    for (const [name, candidates] of DEFAULT_SCRIPTS) {
+        const script = candidates.find(has);
+        if (script)
+            out.push({ name, command: runCommand(pm, script) });
+    }
+    return out;
+}
+export function pytestCommand(m) {
+    if (m.uvLock)
+        return `uv run --frozen pytest ${PYTEST_ARGS}`;
+    if (m.poetryLock)
+        return `poetry run pytest ${PYTEST_ARGS}`;
+    return `python3 -m pytest ${PYTEST_ARGS}`;
+}
+/**
+ * Checks for every ecosystem the manifest shows. package.json scripts come
+ * first because they are the repo's own declaration; the others are the
+ * conventional runner for each toolchain. A monorepo with several gets all
+ * of them.
+ */
+export function checksFromEcosystem(m) {
+    const out = checksFromPackageJson(m.packageJson, m.packageManager);
+    const python = m.pyproject || m.pytestIni || m.toxIni || (m.setupCfg && m.testsDir);
+    if (python)
+        out.push({ name: "pytest", command: pytestCommand(m) });
+    if (m.goMod)
+        out.push({ name: "go-test", command: "go test ./..." });
+    if (m.cargoToml)
+        out.push({ name: "cargo-test", command: "cargo test" });
+    if (m.makefileTest && out.length === 0)
+        out.push({ name: "make-test", command: "make test" });
+    return out;
+}
+const MANIFEST_FILES = [
+    "pyproject.toml",
+    "pytest.ini",
+    "setup.cfg",
+    "tox.ini",
+    "uv.lock",
+    "poetry.lock",
+    "go.mod",
+    "Cargo.toml",
+];
+/** One shell round trip that prints every manifest signal for `root`. */
+export function detectEcosystemCommand(root) {
+    return [
+        `cd ${shellPath(root)} 2>/dev/null || exit 0`,
+        `for f in ${MANIFEST_FILES.join(" ")}; do [ -e "$f" ] && echo "F:$f"; done`,
+        '{ [ -d tests ] || [ -d test ]; } && echo "D:tests"',
+        "grep -qE '^test:' Makefile 2>/dev/null && echo 'M:test'",
+        '[ -f pnpm-lock.yaml ] && echo "PM:pnpm"',
+        '[ -f yarn.lock ] && echo "PM:yarn"',
+        '[ -f package.json ] && { echo "PKG_BEGIN"; cat package.json; echo; echo "PKG_END"; }',
+        "true",
+    ].join("; ");
+}
+/** The probe for the conventional `/workspace` root, as hosted sandboxes lay it out. */
+export const DETECT_ECOSYSTEM_COMMAND = detectEcosystemCommand("/workspace");
+export function parseEcosystemOutput(stdout) {
+    const m = { ...EMPTY_MANIFEST };
+    const lines = stdout.split("\n");
+    const pkgStart = lines.indexOf("PKG_BEGIN");
+    const pkgEnd = lines.indexOf("PKG_END");
+    if (pkgStart >= 0 && pkgEnd > pkgStart) {
+        m.packageJson = lines.slice(pkgStart + 1, pkgEnd).join("\n");
+    }
+    for (const line of lines) {
+        switch (line.trim()) {
+            case "F:pyproject.toml":
+                m.pyproject = true;
+                break;
+            case "F:pytest.ini":
+                m.pytestIni = true;
+                break;
+            case "F:setup.cfg":
+                m.setupCfg = true;
+                break;
+            case "F:tox.ini":
+                m.toxIni = true;
+                break;
+            case "F:uv.lock":
+                m.uvLock = true;
+                break;
+            case "F:poetry.lock":
+                m.poetryLock = true;
+                break;
+            case "F:go.mod":
+                m.goMod = true;
+                break;
+            case "F:Cargo.toml":
+                m.cargoToml = true;
+                break;
+            case "D:tests":
+                m.testsDir = true;
+                break;
+            case "M:test":
+                m.makefileTest = true;
+                break;
+            case "PM:pnpm":
+                m.packageManager = "pnpm";
+                break;
+            case "PM:yarn":
+                if (m.packageManager === "npm")
+                    m.packageManager = "yarn";
+                break;
+            default:
+                break;
+        }
+    }
+    return m;
+}
+export async function detectEcosystem(ws) {
+    const res = await ws
+        .exec(detectEcosystemCommand(ws.root), { cwd: ws.root, timeoutMs: 10_000 })
+        .catch(() => ({ stdout: "" }));
+    return parseEcosystemOutput(res.stdout);
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

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

package/dist/engine.d.ts

@@ -0,0 +1,33 @@
+/**
+ * What the loop needs from a model engine: open a session, send it a prompt,
+ * learn how many steps it took and what it said last. `OpencodeRunEngine`
+ * in `@mousedev/harness-opencode` is the reference implementation.
+ */
+export interface TokenTotals {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    /** USD as reported by the engine; 0 when the engine does not price the model. */
+    cost: number;
+}
+export interface PromptResult {
+    steps: number;
+    text: string;
+}
+export interface PromptOptions {
+    /** Override the session's model for this turn (model escalation). */
+    model?: string;
+}
+export interface Engine {
+    open(opts?: {
+        sessionId?: string;
+        title?: string;
+    }): Promise<string>;
+    prompt(sessionId: string, text: string, signal: AbortSignal, opts?: PromptOptions): Promise<PromptResult>;
+    abort(sessionId: string): Promise<void>;
+    readonly steps: number;
+    readonly tokens: TokenTotals;
+    readonly lastText: string;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B"}

package/dist/engine.js

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

package/dist/engine.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,13 @@
+/** Events the loop reports while it runs. A host renders them; the CLI traces them. */
+export type LoopEvent = {
+    type: "check_status";
+    name: string;
+    conclusion: "success" | "failure";
+    detail?: string;
+    retryable?: boolean;
+} | {
+    type: "notice";
+    message: string;
+    level?: "info" | "warn";
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,MAAM,SAAS,GACjB;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC"}

package/dist/events.js

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

package/dist/events.js.map

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

package/dist/exec.d.ts

@@ -0,0 +1,9 @@
+import type { Workspace } from "./workspace.js";
+export interface LocalWorkspaceOptions {
+    root: string;
+    env?: NodeJS.ProcessEnv;
+}
+/** Exit code reported when a command is killed for exceeding its timeout. */
+export declare const LOCAL_EXEC_TIMEOUT_CODE = 124;
+export declare function localWorkspace(opts: LocalWorkspaceOptions): Workspace;
+//# sourceMappingURL=exec.d.ts.map

package/dist/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAA2B,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEzE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,wBAAgB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,SAAS,CA6CrE"}

package/dist/exec.js

@@ -0,0 +1,54 @@
+/**
+ * `Workspace` over the local machine.
+ */
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+/** Exit code reported when a command is killed for exceeding its timeout. */
+export const LOCAL_EXEC_TIMEOUT_CODE = 124;
+export function localWorkspace(opts) {
+    const root = opts.root.replace(/\/+$/, "") || "/";
+    const resolveCwd = (cwd) => (cwd && existsSync(cwd) ? cwd : root);
+    function run(file, argv, execOpts) {
+        return new Promise((resolve, reject) => {
+            const child = spawn(file, argv, {
+                cwd: resolveCwd(execOpts?.cwd),
+                env: opts.env ?? process.env,
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            let stdout = "";
+            let stderr = "";
+            let timedOut = false;
+            child.stdout.on("data", (d) => {
+                stdout += String(d);
+            });
+            child.stderr.on("data", (d) => {
+                stderr += String(d);
+            });
+            const timer = execOpts?.timeoutMs
+                ? setTimeout(() => {
+                    timedOut = true;
+                    child.kill("SIGKILL");
+                }, execOpts.timeoutMs)
+                : null;
+            const onAbort = () => child.kill("SIGKILL");
+            execOpts?.signal?.addEventListener("abort", onAbort, { once: true });
+            child.on("error", (e) => {
+                if (timer)
+                    clearTimeout(timer);
+                execOpts?.signal?.removeEventListener("abort", onAbort);
+                reject(e);
+            });
+            child.on("close", (code) => {
+                if (timer)
+                    clearTimeout(timer);
+                execOpts?.signal?.removeEventListener("abort", onAbort);
+                resolve({ stdout, stderr, code: timedOut ? LOCAL_EXEC_TIMEOUT_CODE : (code ?? 1) });
+            });
+        });
+    }
+    return {
+        root,
+        exec: (cmd, execOpts) => run("bash", ["-lc", cmd], execOpts),
+    };
+}
+//# sourceMappingURL=exec.js.map

package/dist/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAQrC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,MAAM,UAAU,cAAc,CAAC,IAA2B;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IAClD,MAAM,UAAU,GAAG,CAAC,GAAY,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAE3E,SAAS,GAAG,CAAC,IAAY,EAAE,IAAc,EAAE,QAAsB;QAC/D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE;gBAC9B,GAAG,EAAE,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC;gBAC9B,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG;gBAC5B,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aAClC,CAAC,CAAC;YACH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;gBAC5B,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;YACtB,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;gBAC5B,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;YACtB,CAAC,CAAC,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,EAAE,SAAS;gBAC/B,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;oBACd,QAAQ,GAAG,IAAI,CAAC;oBAChB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACxB,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC;gBACxB,CAAC,CAAC,IAAI,CAAC;YACT,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5C,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACrE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;gBACtB,IAAI,KAAK;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC/B,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACxD,MAAM,CAAC,CAAC,CAAC,CAAC;YACZ,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,KAAK;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC/B,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACxD,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;YACtF,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/failures.d.ts

@@ -0,0 +1,10 @@
+export type InferenceFailureKind = "transient" | "model_route" | "other";
+/** Stable string form of provider/SDK errors for classification. */
+export declare function stringifyInferenceUnknown(raw: unknown): string;
+/**
+ * Classify provider / engine failures for bounded retry and model fallback.
+ * Conservative: prefer "other" when unsure so callers never loop on a
+ * non-retryable error.
+ */
+export declare function classifyInferenceFailure(message: string, raw?: unknown): InferenceFailureKind;
+//# sourceMappingURL=failures.d.ts.map

package/dist/failures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failures.d.ts","sourceRoot":"","sources":["../src/failures.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,aAAa,GAAG,OAAO,CAAC;AAEzE,oEAAoE;AACpE,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQ9D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAuC7F"}

package/dist/failures.js

@@ -0,0 +1,52 @@
+/** Stable string form of provider/SDK errors for classification. */
+export function stringifyInferenceUnknown(raw) {
+    if (raw == null)
+        return "";
+    if (typeof raw === "string")
+        return raw;
+    try {
+        return JSON.stringify(raw);
+    }
+    catch {
+        return String(raw);
+    }
+}
+/**
+ * Classify provider / engine failures for bounded retry and model fallback.
+ * Conservative: prefer "other" when unsure so callers never loop on a
+ * non-retryable error.
+ */
+export function classifyInferenceFailure(message, raw) {
+    const blob = `${message}\n${stringifyInferenceUnknown(raw)}`.toLowerCase();
+    if (/\b429\b/.test(blob) ||
+        /\b503\b/.test(blob) ||
+        /\b502\b/.test(blob) ||
+        blob.includes("rate limit") ||
+        blob.includes("ratelimit") ||
+        blob.includes("too many requests") ||
+        blob.includes("overload") ||
+        blob.includes("overloaded") ||
+        blob.includes("econnreset") ||
+        blob.includes("etimedout") ||
+        blob.includes("timed out") ||
+        blob.includes("timeout") ||
+        blob.includes("temporarily unavailable") ||
+        blob.includes("service unavailable") ||
+        blob.includes("please retry") ||
+        blob.includes("retry your request")) {
+        return "transient";
+    }
+    if (blob.includes("model_not_found") ||
+        blob.includes("model not found") ||
+        blob.includes("invalid model") ||
+        blob.includes("no such model") ||
+        blob.includes("unknown model") ||
+        (blob.includes("does not exist") && blob.includes("model")) ||
+        (blob.includes("not available") && (blob.includes("model") || blob.includes("provider"))) ||
+        blob.includes("model id") ||
+        blob.includes("unsupported model")) {
+        return "model_route";
+    }
+    return "other";
+}
+//# sourceMappingURL=failures.js.map

package/dist/failures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failures.js","sourceRoot":"","sources":["../src/failures.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,MAAM,UAAU,yBAAyB,CAAC,GAAY;IACpD,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAe,EAAE,GAAa;IACrE,MAAM,IAAI,GAAG,GAAG,OAAO,KAAK,yBAAyB,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3E,IACE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QACpB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QACpB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QACpB,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EACnC,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IACE,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC9B,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3D,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QACzF,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAClC,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/git.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Git helpers over a `Workspace`. Every command is `git -C <root>` so the
+ * same code serves a local checkout and a hosted sandbox. All best-effort:
+ * a non-repo answers with nulls and empty lists, never an exception.
+ */
+import { type Workspace } from "./workspace.js";
+export declare function headSha(ws: Workspace): Promise<string | null>;
+/** Stable digest of the working tree relative to `baseSha`; any edit changes it. */
+export declare function fingerprint(ws: Workspace, baseSha: string | null): Promise<string>;
+/** Paths whose deletion would let a run grade its own homework. */
+export declare const VERIFICATION_PATH: RegExp;
+/** Test, spec, and workflow files deleted since `baseSha`. */
+export declare function deletedVerificationFiles(ws: Workspace, baseSha: string | null): Promise<string[]>;
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAI3D,wBAAsB,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOnE;AAED,oFAAoF;AACpF,wBAAsB,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAQxF;AAED,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,QAA8D,CAAC;AAE7F,8DAA8D;AAC9D,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,SAAS,EACb,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAanB"}

package/dist/git.js

@@ -0,0 +1,47 @@
+/**
+ * Git helpers over a `Workspace`. Every command is `git -C <root>` so the
+ * same code serves a local checkout and a hosted sandbox. All best-effort:
+ * a non-repo answers with nulls and empty lists, never an exception.
+ */
+import { shellPath } from "./workspace.js";
+const git = (ws) => `git -C ${shellPath(ws.root)}`;
+export async function headSha(ws) {
+    const r = await ws
+        .exec(`${git(ws)} rev-parse HEAD`, { cwd: ws.root, timeoutMs: 10_000 })
+        .catch(() => ({ stdout: "", code: 1 }));
+    if (r.code !== 0)
+        return null;
+    const s = r.stdout.trim();
+    return s.length >= 7 ? s : null;
+}
+/** Stable digest of the working tree relative to `baseSha`; any edit changes it. */
+export async function fingerprint(ws, baseSha) {
+    const p = await ws.exec(`${git(ws)} status --porcelain`, { cwd: ws.root, timeoutMs: 10_000 });
+    if (!baseSha)
+        return p.stdout;
+    const diff = await ws.exec(`${git(ws)} diff --shortstat ${baseSha} --`, {
+        cwd: ws.root,
+        timeoutMs: 20_000,
+    });
+    return `${p.stdout}\n${diff.stdout}`;
+}
+/** Paths whose deletion would let a run grade its own homework. */
+export const VERIFICATION_PATH = /(^|\/)(tests?|spec|__tests__)(\/|$)|\.github\/workflows\//;
+/** Test, spec, and workflow files deleted since `baseSha`. */
+export async function deletedVerificationFiles(ws, baseSha) {
+    if (!baseSha)
+        return [];
+    const r = await ws
+        .exec(`${git(ws)} diff --diff-filter=D --name-only ${baseSha} --`, {
+        cwd: ws.root,
+        timeoutMs: 20_000,
+    })
+        .catch(() => ({ stdout: "", code: 1 }));
+    if (r.code !== 0)
+        return [];
+    return r.stdout
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((p) => p && VERIFICATION_PATH.test(p));
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC;AAE3D,MAAM,GAAG,GAAG,CAAC,EAAa,EAAE,EAAE,CAAC,UAAU,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;AAE9D,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,EAAa;IACzC,MAAM,CAAC,GAAG,MAAM,EAAE;SACf,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,iBAAiB,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;SACtE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1C,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC1B,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClC,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAa,EAAE,OAAsB;IACrE,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,qBAAqB,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9F,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IAC9B,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,qBAAqB,OAAO,KAAK,EAAE;QACtE,GAAG,EAAE,EAAE,CAAC,IAAI;QACZ,SAAS,EAAE,MAAM;KAClB,CAAC,CAAC;IACH,OAAO,GAAG,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;AACvC,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAAG,2DAA2D,CAAC;AAE7F,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,EAAa,EACb,OAAsB;IAEtB,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,GAAG,MAAM,EAAE;SACf,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,qCAAqC,OAAO,KAAK,EAAE;QACjE,GAAG,EAAE,EAAE,CAAC,IAAI;QACZ,SAAS,EAAE,MAAM;KAClB,CAAC;SACD,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1C,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5B,OAAO,CAAC,CAAC,MAAM;SACZ,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export * from "./detect.js";
+export * from "./engine.js";
+export * from "./events.js";
+export * from "./exec.js";
+export * from "./failures.js";
+export * from "./git.js";
+export * from "./loop.js";
+export * from "./mea.js";
+export * from "./paths.js";
+export * from "./policy.js";
+export * from "./probe.js";
+export * from "./prompt.js";
+export * from "./trace.js";
+export * from "./version.js";
+export * from "./workspace.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+export * from "./detect.js";
+export * from "./engine.js";
+export * from "./events.js";
+export * from "./exec.js";
+export * from "./failures.js";
+export * from "./git.js";
+export * from "./loop.js";
+export * from "./mea.js";
+export * from "./paths.js";
+export * from "./policy.js";
+export * from "./probe.js";
+export * from "./prompt.js";
+export * from "./trace.js";
+export * from "./version.js";
+export * from "./workspace.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}