@mousedev/harness-core 0.1.1

package/dist/policy.d.ts

@@ -0,0 +1,74 @@
+/**
+ * `.mouse/policy.json`: the only thing Mouse reads from a repo.
+ *
+ * Hand-rolled parsing with defaults, no schema library, so `core` stays
+ * dependency-free. Unknown keys are preserved on `extra` and ignored, which
+ * keeps the file forward-compatible with hosts that add blocks of their own.
+ */
+import type { DetectedCheck } from "./detect.js";
+import type { Workspace } from "./workspace.js";
+export type PermissionAction = "allow" | "ask" | "deny";
+/** Either a single action for every call, or a pattern -> action map. */
+export type PermissionToolEntry = PermissionAction | Record<string, PermissionAction>;
+export interface PermissionsPolicy {
+    bash?: PermissionToolEntry;
+    write?: PermissionToolEntry;
+    edit?: PermissionToolEntry;
+    doom_loop?: PermissionAction;
+}
+export interface VerifyPolicy {
+    /** Explicit checks; `null` means detect them from the repo's manifests. */
+    checks: DetectedCheck[] | null;
+    /** Per-check wall clock. */
+    timeoutSec: number;
+}
+export interface LoopPolicy {
+    maxWallSec: number;
+    maxSteps: number;
+    nonProgressRounds: number;
+    idleTimeoutSec: number;
+    minRoundSec: number;
+}
+export interface PrunePolicy {
+    enabled: boolean;
+    thresholdChars: number;
+    headChars: number;
+    tailChars: number;
+}
+export interface Policy {
+    version: 1;
+    verify: VerifyPolicy;
+    loop: LoopPolicy;
+    context: {
+        prune: PrunePolicy;
+    };
+    permissions: PermissionsPolicy;
+    /** Top-level keys this version does not know, kept verbatim. */
+    extra: Record<string, unknown>;
+}
+export declare const DEFAULT_POLICY: Policy;
+/**
+ * `verify.checks` accepts the array form `[{name, command}]` and the object
+ * form `{ "test": "pnpm test" }` from `.mouse/app.json`.
+ */
+export declare function parseChecks(v: unknown): DetectedCheck[] | null;
+export declare function parsePermissions(v: unknown): PermissionsPolicy;
+/** Parse a policy document leniently: every block optional, every field defaulted. */
+export declare function parsePolicy(raw: unknown): Policy;
+/**
+ * Decode a single tool entry into an ordered list of `[pattern, action]`
+ * tuples. A single-action entry is normalized to `[["*", action]]`. Callers
+ * walk the list in order: first match wins. Object iteration order matches
+ * JSON declaration order, which is the contract users sign up for when they
+ * hand-edit policy.json.
+ */
+export declare function permissionRulesForTool(entry: PermissionToolEntry | undefined): Array<[pattern: string, action: PermissionAction]>;
+/** Read one file out of the workspace, or null when it is missing or unreadable. */
+export declare function readWorkspaceFile(ws: Workspace, relPath: string): Promise<string | null>;
+/**
+ * Load `.mouse/policy.json`. When it has no `verify` block, `.mouse/app.json`'s
+ * `verify.checks` is read as an alias so repos written for the hosted product
+ * keep their declared checks.
+ */
+export declare function loadPolicy(ws: Workspace): Promise<Policy>;
+//# sourceMappingURL=policy.d.ts.map

package/dist/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AACxD,yEAAyE;AACzE,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAEtF,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAC/B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC;IAChC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,eAAO,MAAM,cAAc,EAAE,MAa5B,CAAC;AAiBF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,EAAE,GAAG,IAAI,CAkB9D;AAcD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAY9D;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAgChD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,mBAAmB,GAAG,SAAS,GACrC,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAIpD;AAED,oFAAoF;AACpF,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAa9F;AAWD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAa/D"}

package/dist/policy.js

@@ -0,0 +1,179 @@
+import { shellPath } from "./workspace.js";
+export const DEFAULT_POLICY = {
+    version: 1,
+    verify: { checks: null, timeoutSec: 900 },
+    loop: {
+        maxWallSec: 780,
+        maxSteps: 600,
+        nonProgressRounds: 3,
+        idleTimeoutSec: 600,
+        minRoundSec: 60,
+    },
+    context: { prune: { enabled: false, thresholdChars: 8192, headChars: 4096, tailChars: 1024 } },
+    permissions: {},
+    extra: {},
+};
+const KNOWN_KEYS = new Set(["version", "verify", "loop", "context", "permissions"]);
+const ACTIONS = new Set(["allow", "ask", "deny"]);
+function obj(v) {
+    return v && typeof v === "object" && !Array.isArray(v) ? v : null;
+}
+function int(v, fallback, min = 1, max = Number.MAX_SAFE_INTEGER) {
+    return typeof v === "number" && Number.isInteger(v) && v >= min && v <= max ? v : fallback;
+}
+function bool(v, fallback) {
+    return typeof v === "boolean" ? v : fallback;
+}
+/**
+ * `verify.checks` accepts the array form `[{name, command}]` and the object
+ * form `{ "test": "pnpm test" }` from `.mouse/app.json`.
+ */
+export function parseChecks(v) {
+    if (Array.isArray(v)) {
+        const out = [];
+        for (const item of v) {
+            const o = obj(item);
+            if (o && typeof o.name === "string" && typeof o.command === "string" && o.command.trim()) {
+                out.push({ name: o.name, command: o.command });
+            }
+        }
+        return out;
+    }
+    const o = obj(v);
+    if (!o)
+        return null;
+    const out = [];
+    for (const [name, command] of Object.entries(o)) {
+        if (typeof command === "string" && command.trim())
+            out.push({ name, command });
+    }
+    return out;
+}
+function parseToolEntry(v) {
+    if (typeof v === "string")
+        return ACTIONS.has(v) ? v : undefined;
+    const o = obj(v);
+    if (!o)
+        return undefined;
+    const out = {};
+    for (const [pattern, action] of Object.entries(o)) {
+        if (typeof action === "string" && ACTIONS.has(action))
+            out[pattern] = action;
+    }
+    return out;
+}
+export function parsePermissions(v) {
+    const o = obj(v);
+    if (!o)
+        return {};
+    const out = {};
+    for (const tool of ["bash", "write", "edit"]) {
+        const entry = parseToolEntry(o[tool]);
+        if (entry !== undefined)
+            out[tool] = entry;
+    }
+    if (typeof o.doom_loop === "string" && ACTIONS.has(o.doom_loop)) {
+        out.doom_loop = o.doom_loop;
+    }
+    return out;
+}
+/** Parse a policy document leniently: every block optional, every field defaulted. */
+export function parsePolicy(raw) {
+    const o = obj(raw) ?? {};
+    const d = DEFAULT_POLICY;
+    const verify = obj(o.verify) ?? {};
+    const loop = obj(o.loop) ?? {};
+    const prune = obj(obj(o.context)?.prune) ?? {};
+    const extra = {};
+    for (const [k, v] of Object.entries(o))
+        if (!KNOWN_KEYS.has(k))
+            extra[k] = v;
+    return {
+        version: 1,
+        verify: {
+            checks: "checks" in verify ? parseChecks(verify.checks) : d.verify.checks,
+            timeoutSec: int(verify.timeoutSec, d.verify.timeoutSec, 1, 86_400),
+        },
+        loop: {
+            maxWallSec: int(loop.maxWallSec, d.loop.maxWallSec),
+            maxSteps: int(loop.maxSteps, d.loop.maxSteps),
+            nonProgressRounds: int(loop.nonProgressRounds, d.loop.nonProgressRounds),
+            idleTimeoutSec: int(loop.idleTimeoutSec, d.loop.idleTimeoutSec),
+            minRoundSec: int(loop.minRoundSec, d.loop.minRoundSec, 0),
+        },
+        context: {
+            prune: {
+                enabled: bool(prune.enabled, d.context.prune.enabled),
+                thresholdChars: int(prune.thresholdChars, d.context.prune.thresholdChars),
+                headChars: int(prune.headChars, d.context.prune.headChars, 0),
+                tailChars: int(prune.tailChars, d.context.prune.tailChars, 0),
+            },
+        },
+        permissions: parsePermissions(o.permissions),
+        extra,
+    };
+}
+/**
+ * Decode a single tool entry into an ordered list of `[pattern, action]`
+ * tuples. A single-action entry is normalized to `[["*", action]]`. Callers
+ * walk the list in order: first match wins. Object iteration order matches
+ * JSON declaration order, which is the contract users sign up for when they
+ * hand-edit policy.json.
+ */
+export function permissionRulesForTool(entry) {
+    if (!entry)
+        return [];
+    if (typeof entry === "string")
+        return [["*", entry]];
+    return Object.entries(entry);
+}
+/** Read one file out of the workspace, or null when it is missing or unreadable. */
+export async function readWorkspaceFile(ws, relPath) {
+    if (relPath.includes("..") || relPath.startsWith("/"))
+        return null;
+    const abs = `${ws.root.replace(/\/+$/, "")}/${relPath}`;
+    try {
+        const res = await ws.exec(`test -f ${shellPath(abs)} && cat ${shellPath(abs)} || true`, {
+            cwd: ws.root,
+            timeoutMs: 5000,
+        });
+        if (res.code !== 0)
+            return null;
+        return res.stdout || null;
+    }
+    catch {
+        return null;
+    }
+}
+function parseJson(raw) {
+    if (!raw?.trim())
+        return null;
+    try {
+        return obj(JSON.parse(raw));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load `.mouse/policy.json`. When it has no `verify` block, `.mouse/app.json`'s
+ * `verify.checks` is read as an alias so repos written for the hosted product
+ * keep their declared checks.
+ */
+export async function loadPolicy(ws) {
+    const raw = parseJson(await readWorkspaceFile(ws, ".mouse/policy.json")) ?? {};
+    if (!obj(raw.verify)) {
+        const app = parseJson(await readWorkspaceFile(ws, ".mouse/app.json"));
+        const verify = obj(app?.verify);
+        if (verify) {
+            const alias = {};
+            if ("checks" in verify)
+                alias.checks = verify.checks;
+            if (typeof verify.timeoutSec === "number")
+                alias.timeoutSec = verify.timeoutSec;
+            raw.verify = alias;
+        }
+    }
+    return parsePolicy(raw);
+}
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

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

package/dist/probe.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Workspace probe for a checkout. Prefers git for the fingerprint and tamper
+ * scan; a directory that is not a repo falls back to "files newer than the
+ * marker written before the first turn".
+ */
+import { type DetectedCheck } from "./detect.js";
+import { type CompletionProbe } from "./loop.js";
+import { type Workspace } from "./workspace.js";
+export interface ProbeOptions {
+    workspace: Workspace;
+    /** HEAD before the first turn; `null` when the directory is not a repo. */
+    runStartSha: string | null;
+    /** A file touched before the first turn, for the non-git fallback. */
+    marker: string;
+    signal: AbortSignal;
+    /** Declared checks; `null` or `undefined` detects them from the manifests. */
+    checks?: DetectedCheck[] | null;
+    checkTimeoutMs?: number;
+}
+export declare function makeProbe(o: ProbeOptions): CompletionProbe;
+//# sourceMappingURL=probe.d.ts.map

package/dist/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../src/probe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAuB,KAAK,aAAa,EAAmB,MAAM,aAAa,CAAC;AAGvF,OAAO,EAAoB,KAAK,eAAe,EAAqB,MAAM,WAAW,CAAC;AACtF,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAOD,wBAAgB,SAAS,CAAC,CAAC,EAAE,YAAY,GAAG,eAAe,CAuC1D"}

package/dist/probe.js

@@ -0,0 +1,55 @@
+/**
+ * Workspace probe for a checkout. Prefers git for the fingerprint and tamper
+ * scan; a directory that is not a repo falls back to "files newer than the
+ * marker written before the first turn".
+ */
+import { checksFromEcosystem, detectEcosystem } from "./detect.js";
+import { LOCAL_EXEC_TIMEOUT_CODE } from "./exec.js";
+import { deletedVerificationFiles, fingerprint as gitFingerprint } from "./git.js";
+import { EXCERPT_MAX_CHARS } from "./loop.js";
+import { shellPath } from "./workspace.js";
+const DEFAULT_CHECK_TIMEOUT_MS = 900_000;
+/** Ceiling on the non-git fallback listing; a larger tree still fingerprints, just coarsely. */
+const FALLBACK_LIST_MAX = 2_000;
+const FALLBACK_LIST_TIMEOUT_MS = 20_000;
+export function makeProbe(o) {
+    const ws = o.workspace;
+    const timeoutMs = o.checkTimeoutMs ?? DEFAULT_CHECK_TIMEOUT_MS;
+    let checksCache = o.checks ?? null;
+    async function detected() {
+        if (checksCache)
+            return checksCache;
+        checksCache = checksFromEcosystem(await detectEcosystem(ws));
+        return checksCache;
+    }
+    return {
+        async checks() {
+            const out = [];
+            for (const check of await detected()) {
+                if (o.signal.aborted)
+                    break;
+                const res = await ws
+                    .exec(check.command, { cwd: ws.root, timeoutMs, signal: o.signal })
+                    .catch((e) => ({ stdout: "", stderr: String(e), code: 1 }));
+                out.push({
+                    ...check,
+                    pass: res.code === 0,
+                    exitCode: res.code === LOCAL_EXEC_TIMEOUT_CODE ? null : res.code,
+                    excerpt: `${res.stdout}\n${res.stderr}`.trim().slice(-EXCERPT_MAX_CHARS),
+                });
+            }
+            return out;
+        },
+        tampering: () => deletedVerificationFiles(ws, o.runStartSha),
+        async fingerprint() {
+            if (o.runStartSha) {
+                const fp = await gitFingerprint(ws, o.runStartSha).catch(() => null);
+                if (fp !== null)
+                    return fp;
+            }
+            const r = await ws.exec(`find ${shellPath(ws.root)} -xdev -type f -newer ${shellPath(o.marker)} -not -path '*/.git/*' -not -path '*/node_modules/*' 2>/dev/null | sort | head -${FALLBACK_LIST_MAX}`, { cwd: ws.root, timeoutMs: FALLBACK_LIST_TIMEOUT_MS });
+            return r.stdout;
+        },
+    };
+}
+//# sourceMappingURL=probe.js.map

package/dist/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../src/probe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAsB,eAAe,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,WAAW,IAAI,cAAc,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,EAA0C,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACtF,OAAO,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC;AAc3D,MAAM,wBAAwB,GAAG,OAAO,CAAC;AACzC,gGAAgG;AAChG,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAChC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAExC,MAAM,UAAU,SAAS,CAAC,CAAe;IACvC,MAAM,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC;IACvB,MAAM,SAAS,GAAG,CAAC,CAAC,cAAc,IAAI,wBAAwB,CAAC;IAC/D,IAAI,WAAW,GAA2B,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC;IAC3D,KAAK,UAAU,QAAQ;QACrB,IAAI,WAAW;YAAE,OAAO,WAAW,CAAC;QACpC,WAAW,GAAG,mBAAmB,CAAC,MAAM,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7D,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO;QACL,KAAK,CAAC,MAAM;YACV,MAAM,GAAG,GAAkB,EAAE,CAAC;YAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,QAAQ,EAAE,EAAE,CAAC;gBACrC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO;oBAAE,MAAM;gBAC5B,MAAM,GAAG,GAAG,MAAM,EAAE;qBACjB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;qBAClE,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9D,GAAG,CAAC,IAAI,CAAC;oBACP,GAAG,KAAK;oBACR,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,CAAC;oBACpB,QAAQ,EAAE,GAAG,CAAC,IAAI,KAAK,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI;oBAChE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,iBAAiB,CAAC;iBACzE,CAAC,CAAC;YACL,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,SAAS,EAAE,GAAG,EAAE,CAAC,wBAAwB,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC;QAC5D,KAAK,CAAC,WAAW;YACf,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;gBAClB,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;gBACrE,IAAI,EAAE,KAAK,IAAI;oBAAE,OAAO,EAAE,CAAC;YAC7B,CAAC;YACD,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CACrB,QAAQ,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,yBAAyB,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,mFAAmF,iBAAiB,EAAE,EAC5K,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,wBAAwB,EAAE,CACtD,CAAC;YACF,OAAO,CAAC,CAAC,MAAM,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/prompt.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Mouse's system prompt for the engine.
+ *
+ * Set as the agent's `prompt`, which replaces the engine's per-model default
+ * (for Kimi models that default says "make MINIMAL changes", the wrong bias
+ * for a feature that spans five modules). The engine still appends its
+ * environment block, the repo's AGENTS.md / CLAUDE.md, and any skills.
+ *
+ * Static by design: the same bytes on every call of a session so the
+ * provider's prefix cache hits. Anything that changes per turn belongs at the
+ * tail of the user message, never here. Prompt bytes are cache-sensitive;
+ * cosmetic edits invalidate every user's cache and are not accepted.
+ *
+ * Budget: under ~600 tokens. `AGENT_PROMPT_MAX_CHARS` is the guard the test
+ * enforces.
+ */
+/**
+ * The modes Mouse knows. `build` is the one the CLI runs; the read-only modes
+ * exist so a host can select a posture per turn. Hosts may add their own
+ * (the string escape hatch); unknown modes get the engine's default prompt.
+ */
+export type Mode = "ask" | "plan" | "debug" | "build" | (string & {});
+export type Profile = "product" | "local" | "bench";
+export declare const AGENT_PROMPT_MAX_CHARS = 2600;
+/**
+ * The prompt for a mode, or `undefined` to keep the engine's default. Only
+ * the writing modes carry Mouse's prompt; the read-only modes keep the engine
+ * default.
+ */
+export declare function buildAgentPrompt(mode: Mode, _opts?: {
+    profile: Profile;
+}): string | undefined;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AACH,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEtE,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAEpD,eAAO,MAAM,sBAAsB,OAAO,CAAC;AA0B3C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,KAAK,GAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAA2B,GACnD,MAAM,GAAG,SAAS,CAEpB"}

package/dist/prompt.js

@@ -0,0 +1,48 @@
+/**
+ * Mouse's system prompt for the engine.
+ *
+ * Set as the agent's `prompt`, which replaces the engine's per-model default
+ * (for Kimi models that default says "make MINIMAL changes", the wrong bias
+ * for a feature that spans five modules). The engine still appends its
+ * environment block, the repo's AGENTS.md / CLAUDE.md, and any skills.
+ *
+ * Static by design: the same bytes on every call of a session so the
+ * provider's prefix cache hits. Anything that changes per turn belongs at the
+ * tail of the user message, never here. Prompt bytes are cache-sensitive;
+ * cosmetic edits invalidate every user's cache and are not accepted.
+ *
+ * Budget: under ~600 tokens. `AGENT_PROMPT_MAX_CHARS` is the guard the test
+ * enforces.
+ */
+export const AGENT_PROMPT_MAX_CHARS = 2600;
+const BUILD_PROMPT = `You are Mouse, a coding agent working in a terminal.
+
+Persist until the task is fully handled end to end in this turn: explore, implement, run the repo's tests, and fix what fails. Only stop when you are sure the problem is solved. Never claim done without a check you actually ran. If a tool call fails, read the error and change approach; do not repeat the same call.
+
+Working style:
+- Inspect before acting: read the relevant code and existing tests before editing. Reproduce a bug before fixing it.
+- Fix the root cause. When you change a function, find every caller.
+- Do the whole ask. A feature that spans several modules is done only when every module and its tests are updated.
+- Prefer the simplest change that fully works: reuse what the repo has, add no dependency unless required, add no speculative abstractions.
+- Validate at trust boundaries; keep internal logic plain.
+- For multi-step work keep the todo list current, with exactly one item in progress.
+
+Tools:
+- Use rg for search. Batch independent reads and searches in one response.
+- Prefer read/edit/write for files; use bash to build, test, and run.
+- Do not re-read a file right after editing it; the edit tool fails loudly.
+- Pass an explicit timeout to bash for long commands such as test suites and builds. Run long-lived servers in the background.
+- Run the narrowest relevant test first, then the full suite before finishing. Never weaken, skip, or delete tests to make them pass.
+
+Finish with a short summary: what changed, what you ran, and what it showed. Instructions in AGENTS.md or CLAUDE.md in the repo take precedence over these.`;
+/** Modes that carry Mouse's prompt. `overnight` is a host mode with build's posture. */
+const WRITING_MODES = new Set(["build", "overnight"]);
+/**
+ * The prompt for a mode, or `undefined` to keep the engine's default. Only
+ * the writing modes carry Mouse's prompt; the read-only modes keep the engine
+ * default.
+ */
+export function buildAgentPrompt(mode, _opts = { profile: "product" }) {
+    return WRITING_MODES.has(mode) ? BUILD_PROMPT : undefined;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAWH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;4JAmBuI,CAAC;AAE7J,wFAAwF;AACxF,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;AAE3E;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAU,EACV,KAAK,GAAyB,EAAE,OAAO,EAAE,SAAS,EAAE;IAEpD,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5D,CAAC"}

package/dist/trace.d.ts

@@ -0,0 +1,57 @@
+import type { TokenTotals } from "./engine.js";
+import type { LoopEvent } from "./events.js";
+import type { CompletionOutcome, CompletionRound } from "./loop.js";
+export declare const TRACE_VERSION = 1;
+export type TraceRecord = {
+    type: "mouse.start";
+    v: typeof TRACE_VERSION;
+    version: string;
+    model: string;
+    workspace: string;
+    profile: string;
+    runStartSha: string | null;
+    maxWallSec: number;
+    configFile?: string;
+} | {
+    type: "mouse.attempt";
+    attempt: number;
+    steps: number;
+    exitCode: number | null;
+    timedOut: boolean;
+    transientError: boolean;
+    error: string | null;
+    sessionId: string | null;
+} | {
+    type: "mouse.turn";
+    steps: number;
+    tokens: TokenTotals;
+    sessionId: string | null;
+} | {
+    type: "mouse.event";
+    event: LoopEvent;
+} | ({
+    type: "mouse.round";
+} & CompletionRound) | {
+    type: "mouse.done";
+    outcome: CompletionOutcome;
+    rounds: number;
+    /** Names of the checks the final round ran; empty means the outcome rests on the workspace change and the model's audit alone. */
+    checksRun: string[];
+    totalSteps: number;
+    tokens: TokenTotals;
+    elapsedMs: number;
+    sessionId: string | null;
+} | {
+    type: "mouse.error";
+    error: string;
+    steps: number;
+    elapsedMs: number;
+};
+export type TraceWriter = {
+    readonly file: string;
+    write(record: TraceRecord | Record<string, unknown>): void;
+};
+export declare function openTrace(file: string): TraceWriter;
+/** Parse a trace file's lines; malformed lines are skipped. */
+export declare function parseTrace(text: string): Array<Record<string, unknown>>;
+//# sourceMappingURL=trace.d.ts.map

package/dist/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEpE,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,MAAM,MAAM,WAAW,GACnB;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,CAAC,EAAE,OAAO,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GACD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACpF;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACzC,CAAC;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GAAG,eAAe,CAAC,GAC3C;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,kIAAkI;IAClI,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GACD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5D,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CASnD;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAYvE"}

package/dist/trace.js

@@ -0,0 +1,35 @@
+/**
+ * The JSONL trace: one record per line, `mouse.start` first. Versioned by
+ * `TRACE_VERSION` on the start record; readers should ignore unknown types.
+ */
+import { appendFileSync, mkdirSync } from "node:fs";
+import path from "node:path";
+export const TRACE_VERSION = 1;
+export function openTrace(file) {
+    const abs = path.resolve(file);
+    mkdirSync(path.dirname(abs), { recursive: true });
+    return {
+        file: abs,
+        write(record) {
+            appendFileSync(abs, `${JSON.stringify({ ts: Date.now(), ...record })}\n`);
+        },
+    };
+}
+/** Parse a trace file's lines; malformed lines are skipped. */
+export function parseTrace(text) {
+    const out = [];
+    for (const line of text.split("\n")) {
+        if (!line.trim())
+            continue;
+        try {
+            const v = JSON.parse(line);
+            if (v && typeof v === "object")
+                out.push(v);
+        }
+        catch {
+            // skip
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=trace.js.map

package/dist/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AA6C/B,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,OAAO;QACL,IAAI,EAAE,GAAG;QACT,KAAK,CAAC,MAAM;YACV,cAAc,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5E,CAAC;KACF,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,GAAG,GAAmC,EAAE,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAS;QAC3B,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;YACtC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,GAAG,CAAC,IAAI,CAAC,CAA4B,CAAC,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** Harness version, kept in lockstep across the three packages by scripts/release.mjs. */
+export declare const MOUSE_VERSION = "0.1.1";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,eAAO,MAAM,aAAa,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,3 @@
+/** Harness version, kept in lockstep across the three packages by scripts/release.mjs. */
+export const MOUSE_VERSION = "0.1.1";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC"}

package/dist/workspace.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The one thing the loop needs from the outside world: a directory and a way
+ * to run a shell command in it. The CLI implements it over the local machine
+ * (`localWorkspace`); a hosted product implements it over its sandbox.
+ */
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    code: number;
+}
+export interface ExecOptions {
+    cwd?: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface Workspace {
+    /** Absolute path of the checkout the agent works in. */
+    readonly root: string;
+    exec(command: string, opts?: ExecOptions): Promise<ExecResult>;
+}
+/**
+ * Quote a path for `sh`. Plain paths stay bare so commands built for the
+ * conventional `/workspace` root are byte-identical to the historical ones.
+ */
+export declare function shellPath(p: string): string;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAChE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3C"}

package/dist/workspace.js

@@ -0,0 +1,8 @@
+/**
+ * Quote a path for `sh`. Plain paths stay bare so commands built for the
+ * conventional `/workspace` root are byte-identical to the historical ones.
+ */
+export function shellPath(p) {
+    return /^[A-Za-z0-9_./-]+$/.test(p) ? p : `'${p.replace(/'/g, `'\\''`)}'`;
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAuBA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAC5E,CAAC"}