@ai-codebot/daemon 0.1.0

package/dist/spawn/n2-runner.js

@@ -0,0 +1,176 @@
+/**
+ * FALLBACK executor: the N2 local tool-loop (design §4 — ports
+ * `agentic_backend.py` A1/A2/A4/A5/A9 to TS). The fully-working, fully-tested path
+ * used when no verified CLI is available or `--cli` forces N2.
+ *
+ * Loop protocol (mirrors the Python backend):
+ *   1. Record HEAD as the diff base (A2 — workspace is a real repo, no `git init`).
+ *   2. system + user messages → model (through the broker) with the closed toolset.
+ *   3. Append ALL tool results before honoring `finish` (A4); `finish` ends the loop.
+ *   4. On `finish`: capture BASE..worktree diff; map to an outcome.
+ *
+ * `success` (Python) → `succeeded` (wire) happens in result-map.ts; this returns the
+ * internal `ExecOutcome`.
+ */
+import { complete, LlmClientError, } from "./llm-client.js";
+import { captureDiff, headSha } from "./git.js";
+import { log } from "../logging.js";
+import { dispatchTool, N2_TOOL_NAMES, toolSchemas, } from "./n2-tools.js";
+const SYSTEM_PROMPT = `You are a coding agent working inside a single repository checkout.
+You can only act through the provided tools — there is no shell. Workflow:
+1. Explore with list_dir / read_file to understand the code.
+2. Make changes with write_file / replace_in_file (paths are workspace-relative).
+3. Optionally verify with run_tests.
+4. Call finish with a one-line summary when done (it becomes the commit message).
+Make the smallest correct change for the task. If the request is genuinely ambiguous and you
+cannot proceed, call finish with needs_clarification=true and a specific question.
+Do not ask for confirmation; do not explain at length — act through tools.`;
+const MAX_OUTPUT_TOKENS = 4096;
+const DEFAULT_MAX_TURNS = 25;
+const MAX_CONTEXT_CHARS = 200_000;
+function parseCall(call) {
+    const name = call.function?.name ?? "";
+    const raw = call.function?.arguments ?? "{}";
+    try {
+        const parsed = JSON.parse(raw || "{}");
+        if (typeof parsed !== "object" ||
+            parsed === null ||
+            Array.isArray(parsed)) {
+            return {
+                name,
+                args: {},
+                err: "ERROR: tool arguments must be a JSON object.",
+            };
+        }
+        return { name, args: parsed, err: null };
+    }
+    catch {
+        return {
+            name,
+            args: {},
+            err: "ERROR: could not parse tool arguments as JSON.",
+        };
+    }
+}
+function asToolDefs() {
+    return toolSchemas().map((s) => ({
+        type: "function",
+        function: {
+            name: s.name,
+            description: s.description,
+            parameters: s.parameters,
+        },
+    }));
+}
+/**
+ * Run the N2 tool-loop. Returns an internal `ExecOutcome`. NEVER throws on a
+ * model/tool error — that becomes a `failed` outcome (零静默: exactly one outcome).
+ */
+export async function runN2(params) {
+    const { repo, prompt, model, brokerBaseUrl, token, env, testTimeoutMs, signal, } = params;
+    const maxTurns = Math.max(1, params.maxTurns ?? DEFAULT_MAX_TURNS);
+    const base = await headSha(repo);
+    if (base === null) {
+        return { kind: "failed", error: `repo '${repo}' is not a git repository` };
+    }
+    const ctx = { workspace: repo, baseEnv: env, testTimeoutMs };
+    const tools = asToolDefs();
+    const messages = [
+        { role: "system", content: SYSTEM_PROMPT },
+        { role: "user", content: prompt },
+    ];
+    let ctxChars = 0;
+    let finish = null;
+    for (let turn = 1; turn <= maxTurns; turn += 1) {
+        if (signal.aborted)
+            return { kind: "timed_out" };
+        if (ctxChars > MAX_CONTEXT_CHARS) {
+            return {
+                kind: "failed",
+                error: `context budget ${MAX_CONTEXT_CHARS} chars exceeded`,
+            };
+        }
+        let completion;
+        try {
+            completion = await complete({ baseUrl: brokerBaseUrl, token, model, maxTokens: MAX_OUTPUT_TOKENS }, messages, tools, signal);
+        }
+        catch (err) {
+            if (signal.aborted)
+                return { kind: "timed_out" };
+            const msg = err instanceof LlmClientError ? err.message : String(err);
+            // No silent fallback (C8): model unreachable → loud failed.
+            return { kind: "failed", error: `model unreachable: ${msg}` };
+        }
+        if (completion.finishReason === "length" ||
+            completion.finishReason === "content_filter") {
+            return {
+                kind: "failed",
+                error: `model stopped early (finish_reason=${completion.finishReason})`,
+            };
+        }
+        if (completion.toolCalls.length > 0) {
+            messages.push({
+                role: "assistant",
+                content: completion.content,
+                tool_calls: completion.toolCalls,
+            });
+            // Append ALL tool results before honoring finish (A4 — every id needs a reply).
+            for (const call of completion.toolCalls) {
+                const { name, args, err } = parseCall(call);
+                if (name === N2_TOOL_NAMES.FINISH && err === null) {
+                    finish = {
+                        summary: String(args["summary"] ?? "agent changes"),
+                        needsClarification: Boolean(args["needs_clarification"]),
+                        question: args["question"] ? String(args["question"]) : null,
+                    };
+                    messages.push({
+                        role: "tool",
+                        content: "finishing",
+                        tool_call_id: call.id,
+                    });
+                    continue;
+                }
+                if (signal.aborted)
+                    return { kind: "timed_out" };
+                const result = err ?? (await dispatchTool(ctx, name, args));
+                ctxChars += result.length;
+                messages.push({
+                    role: "tool",
+                    content: result,
+                    tool_call_id: call.id,
+                    name,
+                });
+            }
+            if (finish !== null)
+                break;
+            continue;
+        }
+        // No tool calls: the model produced prose and stopped — done talking.
+        break;
+    }
+    const { diff, files } = await captureDiff(repo, base);
+    log.info("spawn.n2.done", { repo, files: files.length });
+    if (finish !== null && finish.needsClarification) {
+        return {
+            kind: "needs_clarification",
+            question: finish.question ?? "Could you clarify the task?",
+        };
+    }
+    if (files.length === 0) {
+        if (finish === null) {
+            // Ran out of turns / stopped without finishing AND produced nothing → cut off.
+            return {
+                kind: "failed",
+                error: `reached max turns (${maxTurns}) without completing the task`,
+            };
+        }
+        return { kind: "no_changes", text: finish.summary };
+    }
+    return {
+        kind: "success",
+        text: finish?.summary ?? "agent changes",
+        diff: diff || null,
+        files,
+    };
+}
+//# sourceMappingURL=n2-runner.js.map

package/dist/spawn/n2-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n2-runner.js","sourceRoot":"","sources":["../../src/spawn/n2-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,QAAQ,EACR,cAAc,GAIf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,WAAW,GAEZ,MAAM,eAAe,CAAC;AAGvB,MAAM,aAAa,GAAG;;;;;;;;2EAQqD,CAAC;AAE5E,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAsBlC,SAAS,SAAS,CAAC,IAAc;IAK/B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,IAAI,IAAI,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QACvC,IACE,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,KAAK,IAAI;YACf,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EACrB,CAAC;YACD,OAAO;gBACL,IAAI;gBACJ,IAAI,EAAE,EAAE;gBACR,GAAG,EAAE,8CAA8C;aACpD,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAiC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,IAAI;YACJ,IAAI,EAAE,EAAE;YACR,GAAG,EAAE,gDAAgD;SACtD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/B,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;SACzB;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,MAAmB;IAC7C,MAAM,EACJ,IAAI,EACJ,MAAM,EACN,KAAK,EACL,aAAa,EACb,KAAK,EACL,GAAG,EACH,aAAa,EACb,MAAM,GACP,GAAG,MAAM,CAAC;IACX,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,IAAI,iBAAiB,CAAC,CAAC;IAEnE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,IAAI,2BAA2B,EAAE,CAAC;IAC7E,CAAC;IAED,MAAM,GAAG,GAAgB,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC;IAC1E,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAkB;QAC9B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE;QAC1C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;KAClC,CAAC;IAEF,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,MAAM,GAAwB,IAAI,CAAC;IAEvC,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAC/C,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QACjD,IAAI,QAAQ,GAAG,iBAAiB,EAAE,CAAC;YACjC,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,kBAAkB,iBAAiB,iBAAiB;aAC5D,CAAC;QACJ,CAAC;QAED,IAAI,UAAU,CAAC;QACf,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,QAAQ,CACzB,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,EACtE,QAAQ,EACR,KAAK,EACL,MAAM,CACP,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YACjD,MAAM,GAAG,GAAG,GAAG,YAAY,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtE,4DAA4D;YAC5D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,sBAAsB,GAAG,EAAE,EAAE,CAAC;QAChE,CAAC;QAED,IACE,UAAU,CAAC,YAAY,KAAK,QAAQ;YACpC,UAAU,CAAC,YAAY,KAAK,gBAAgB,EAC5C,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,sCAAsC,UAAU,CAAC,YAAY,GAAG;aACxE,CAAC;QACJ,CAAC;QAED,IAAI,UAAU,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,UAAU,EAAE,UAAU,CAAC,SAAS;aACjC,CAAC,CAAC;YACH,gFAAgF;YAChF,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;gBACxC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC5C,IAAI,IAAI,KAAK,aAAa,CAAC,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;oBAClD,MAAM,GAAG;wBACP,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,eAAe,CAAC;wBACnD,kBAAkB,EAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;wBACxD,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;qBAC7D,CAAC;oBACF,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE,WAAW;wBACpB,YAAY,EAAE,IAAI,CAAC,EAAE;qBACtB,CAAC,CAAC;oBACH,SAAS;gBACX,CAAC;gBACD,IAAI,MAAM,CAAC,OAAO;oBAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBACjD,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;gBAC5D,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC;gBAC1B,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,MAAM;oBACf,YAAY,EAAE,IAAI,CAAC,EAAE;oBACrB,IAAI;iBACL,CAAC,CAAC;YACL,CAAC;YACD,IAAI,MAAM,KAAK,IAAI;gBAAE,MAAM;YAC3B,SAAS;QACX,CAAC;QAED,sEAAsE;QACtE,MAAM;IACR,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtD,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAEzD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;QACjD,OAAO;YACL,IAAI,EAAE,qBAAqB;YAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,6BAA6B;SAC3D,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,+EAA+E;YAC/E,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,sBAAsB,QAAQ,+BAA+B;aACrE,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACtD,CAAC;IACD,OAAO;QACL,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,MAAM,EAAE,OAAO,IAAI,eAAe;QACxC,IAAI,EAAE,IAAI,IAAI,IAAI;QAClB,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/spawn/n2-tools.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Closed, workspace-scoped toolset for the N2 local tool-loop (design §4 FALLBACK).
+ * Ported from the Python `agentic_tools.py` contract: read/write/replace/run-tests/
+ * finish, every recoverable problem returned in-band as a string so the model can
+ * self-correct (A4), every path resolved-then-checked for workspace escape (A8/DR-6).
+ *
+ * The disallowed-tools blacklist is enforced by OMISSION here — none of those tools
+ * are ever registered, so the model literally cannot call them.
+ */
+export declare const MAX_READ_BYTES = 64000;
+export declare const MAX_WRITE_BYTES = 256000;
+export declare const MAX_TEST_OUTPUT = 16000;
+export declare const DEFAULT_TEST_TIMEOUT_MS = 120000;
+export declare const ENV_ALLOWLIST: Set<string>;
+/** True if `name` is a known-safe env var (exact allowlist or an `LC_*` locale var). */
+export declare function isAllowedEnvVar(name: string): boolean;
+/**
+ * Project `base` down to the shared allowlist. The SINGLE scrub used by both the CLI
+ * spawn env and the N2 `run_tests` env — start empty, copy ONLY allowlisted names.
+ */
+export declare function scrubEnv(base: NodeJS.ProcessEnv): Record<string, string>;
+export declare const N2_TOOL_NAMES: {
+    readonly LIST_DIR: "list_dir";
+    readonly READ_FILE: "read_file";
+    readonly WRITE_FILE: "write_file";
+    readonly REPLACE_IN_FILE: "replace_in_file";
+    readonly RUN_TESTS: "run_tests";
+    readonly FINISH: "finish";
+};
+export interface ToolContext {
+    /** MUST be an already-resolved absolute path. */
+    readonly workspace: string;
+    readonly baseEnv: NodeJS.ProcessEnv;
+    readonly testTimeoutMs: number;
+}
+export interface ToolSchema {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+/** The closed N2 toolset advertised to the model (OpenAI function-call shape). */
+export declare function toolSchemas(): ToolSchema[];
+/** Execute one tool call; always returns an in-band string (A4). */
+export declare function dispatchTool(ctx: ToolContext, name: string, args: Record<string, unknown>): Promise<string>;

package/dist/spawn/n2-tools.js

@@ -0,0 +1,374 @@
+/**
+ * Closed, workspace-scoped toolset for the N2 local tool-loop (design §4 FALLBACK).
+ * Ported from the Python `agentic_tools.py` contract: read/write/replace/run-tests/
+ * finish, every recoverable problem returned in-band as a string so the model can
+ * self-correct (A4), every path resolved-then-checked for workspace escape (A8/DR-6).
+ *
+ * The disallowed-tools blacklist is enforced by OMISSION here — none of those tools
+ * are ever registered, so the model literally cannot call them.
+ */
+import { spawn } from "node:child_process";
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync, } from "node:fs";
+import { dirname, relative, resolve, sep } from "node:path";
+// Bounded-output limits (mirror agentic_tools DR-7).
+export const MAX_READ_BYTES = 64_000;
+export const MAX_WRITE_BYTES = 256_000;
+export const MAX_TEST_OUTPUT = 16_000;
+export const DEFAULT_TEST_TIMEOUT_MS = 120_000;
+// Shared env allowlist — the SINGLE source of truth for BOTH the CLI spawn env
+// (`handoff.buildSpawnEnv`) and the N2 `run_tests` env (`scrubEnv` below). The
+// boundary is an ALLOWLIST, never a denylist: a denylist of "known secret vars" is
+// fundamentally incomplete (AWS_*/GOOGLE_APPLICATION_CREDENTIALS/AZURE_*/… leak),
+// so we start from an empty env and copy ONLY these known-safe names. Prefix-matched
+// locale vars (LC_*) are handled by `isAllowedEnvVar`. Any genuinely-needed CLI var
+// is added HERE so both paths inherit it.
+export const ENV_ALLOWLIST = new Set([
+    "PATH",
+    "HOME",
+    "USER",
+    "SHELL",
+    "LANG",
+    "LC_ALL",
+    "LC_CTYPE",
+    "TERM",
+    "TZ",
+    "TMPDIR",
+    "CI",
+    "VIRTUAL_ENV",
+]);
+/** True if `name` is a known-safe env var (exact allowlist or an `LC_*` locale var). */
+export function isAllowedEnvVar(name) {
+    return ENV_ALLOWLIST.has(name) || name.startsWith("LC_");
+}
+/**
+ * Project `base` down to the shared allowlist. The SINGLE scrub used by both the CLI
+ * spawn env and the N2 `run_tests` env — start empty, copy ONLY allowlisted names.
+ */
+export function scrubEnv(base) {
+    const out = {};
+    for (const [k, v] of Object.entries(base)) {
+        if (v !== undefined && isAllowedEnvVar(k))
+            out[k] = v;
+    }
+    return out;
+}
+const SELECTOR_RE = /^[A-Za-z0-9_][A-Za-z0-9_./:[\]-]*$/;
+export const N2_TOOL_NAMES = {
+    LIST_DIR: "list_dir",
+    READ_FILE: "read_file",
+    WRITE_FILE: "write_file",
+    REPLACE_IN_FILE: "replace_in_file",
+    RUN_TESTS: "run_tests",
+    FINISH: "finish",
+};
+/** The closed N2 toolset advertised to the model (OpenAI function-call shape). */
+export function toolSchemas() {
+    return [
+        {
+            name: N2_TOOL_NAMES.LIST_DIR,
+            description: "List files and directories under a path in the repo workspace.",
+            parameters: {
+                type: "object",
+                properties: {
+                    path: {
+                        type: "string",
+                        description: "Workspace-relative directory (default '.').",
+                    },
+                },
+            },
+        },
+        {
+            name: N2_TOOL_NAMES.READ_FILE,
+            description: "Read a UTF-8 text file from the repo workspace.",
+            parameters: {
+                type: "object",
+                properties: {
+                    path: {
+                        type: "string",
+                        description: "Workspace-relative file path.",
+                    },
+                },
+                required: ["path"],
+            },
+        },
+        {
+            name: N2_TOOL_NAMES.WRITE_FILE,
+            description: "Create or overwrite a text file with the given full content.",
+            parameters: {
+                type: "object",
+                properties: {
+                    path: {
+                        type: "string",
+                        description: "Workspace-relative file path.",
+                    },
+                    content: { type: "string", description: "Full new file content." },
+                },
+                required: ["path", "content"],
+            },
+        },
+        {
+            name: N2_TOOL_NAMES.REPLACE_IN_FILE,
+            description: "Replace an exact unique substring in a file ('old' must occur exactly once).",
+            parameters: {
+                type: "object",
+                properties: {
+                    path: {
+                        type: "string",
+                        description: "Workspace-relative file path.",
+                    },
+                    old: {
+                        type: "string",
+                        description: "Exact text to replace (must be unique).",
+                    },
+                    new: { type: "string", description: "Replacement text." },
+                },
+                required: ["path", "old", "new"],
+            },
+        },
+        {
+            name: N2_TOOL_NAMES.RUN_TESTS,
+            description: "Run the repository's test suite (pytest or npm test, auto-detected). " +
+                "Does NOT accept arbitrary shell commands.",
+            parameters: {
+                type: "object",
+                properties: {
+                    selector: {
+                        type: "string",
+                        description: "Optional test file path or pytest node id.",
+                    },
+                },
+            },
+        },
+        {
+            name: N2_TOOL_NAMES.FINISH,
+            description: "Call when the task is complete (or you need the user to clarify).",
+            parameters: {
+                type: "object",
+                properties: {
+                    summary: {
+                        type: "string",
+                        description: "Short summary (used as commit message).",
+                    },
+                    needs_clarification: { type: "boolean" },
+                    question: { type: "string" },
+                },
+                required: ["summary"],
+            },
+        },
+    ];
+}
+/** Resolve `rel` under `workspace`, rejecting escape + the `.git` dir (A8/DR-6). */
+function safePath(workspace, rel) {
+    if (typeof rel !== "string" || rel.includes("\0"))
+        return null;
+    const candidate = resolve(workspace, rel);
+    if (candidate !== workspace) {
+        const relToWs = relative(workspace, candidate);
+        if (relToWs.startsWith("..") ||
+            relToWs.startsWith(sep) ||
+            resolve(workspace, relToWs) !== candidate) {
+            return null;
+        }
+        const parts = relToWs.split(sep);
+        if (parts.some((p) => p.toLowerCase() === ".git"))
+            return null;
+    }
+    return candidate;
+}
+function listDir(ctx, path) {
+    const target = safePath(ctx.workspace, path || ".");
+    if (target === null)
+        return `ERROR: path '${path}' escapes the workspace.`;
+    if (!existsSync(target))
+        return `ERROR: '${path}' does not exist.`;
+    let st;
+    try {
+        st = statSync(target);
+    }
+    catch (err) {
+        return `ERROR: could not stat '${path}': ${err.message}`;
+    }
+    if (!st.isDirectory())
+        return `ERROR: '${path}' is not a directory.`;
+    const entries = readdirSync(target, { withFileTypes: true })
+        .filter((d) => d.name !== ".git")
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .map((d) => d.name + (d.isDirectory() ? "/" : ""));
+    return entries.length ? entries.join("\n") : "(empty)";
+}
+function readFile(ctx, path) {
+    const target = safePath(ctx.workspace, path);
+    if (target === null)
+        return `ERROR: path '${path}' escapes the workspace.`;
+    if (!existsSync(target) || !statSync(target).isFile())
+        return `ERROR: file '${path}' not found.`;
+    let data;
+    try {
+        data = readFileSync(target);
+    }
+    catch (err) {
+        return `ERROR: could not read '${path}': ${err.message}`;
+    }
+    const truncated = data.length > MAX_READ_BYTES;
+    let text = data.subarray(0, MAX_READ_BYTES).toString("utf8");
+    if (truncated)
+        text += `\n... (truncated at ${MAX_READ_BYTES} bytes)`;
+    return text;
+}
+function writeFile(ctx, path, content) {
+    const target = safePath(ctx.workspace, path);
+    if (target === null)
+        return `ERROR: path '${path}' escapes the workspace.`;
+    if (typeof content !== "string")
+        return "ERROR: 'content' must be a string.";
+    if (Buffer.byteLength(content, "utf8") > MAX_WRITE_BYTES) {
+        return `ERROR: content exceeds ${MAX_WRITE_BYTES} bytes.`;
+    }
+    try {
+        mkdirSync(dirname(target), { recursive: true });
+        writeFileSync(target, content, "utf8");
+    }
+    catch (err) {
+        return `ERROR: could not write '${path}': ${err.message}`;
+    }
+    return `wrote ${content.length} chars to ${path}`;
+}
+function replaceInFile(ctx, path, oldText, newText) {
+    const target = safePath(ctx.workspace, path);
+    if (target === null)
+        return `ERROR: path '${path}' escapes the workspace.`;
+    if (!existsSync(target) || !statSync(target).isFile())
+        return `ERROR: file '${path}' not found.`;
+    if (typeof oldText !== "string" ||
+        typeof newText !== "string" ||
+        oldText === "") {
+        return "ERROR: 'old' and 'new' must be strings and 'old' must be non-empty.";
+    }
+    let text;
+    try {
+        text = readFileSync(target, "utf8");
+    }
+    catch (err) {
+        return `ERROR: could not read '${path}': ${err.message}`;
+    }
+    const count = text.split(oldText).length - 1;
+    if (count === 0)
+        return `ERROR: 'old' substring not found in '${path}'.`;
+    if (count > 1)
+        return `ERROR: 'old' occurs ${count} times in '${path}'; make it unique.`;
+    const updated = text.replace(oldText, newText);
+    if (Buffer.byteLength(updated, "utf8") > MAX_WRITE_BYTES) {
+        return `ERROR: result exceeds ${MAX_WRITE_BYTES} bytes.`;
+    }
+    try {
+        writeFileSync(target, updated, "utf8");
+    }
+    catch (err) {
+        return `ERROR: could not write '${path}': ${err.message}`;
+    }
+    return `replaced 1 occurrence in ${path}`;
+}
+function detectTestCommand(workspace) {
+    const has = (f) => existsSync(resolve(workspace, f));
+    if (has("pyproject.toml") ||
+        has("pytest.ini") ||
+        has("setup.py") ||
+        has("tests") ||
+        has("conftest.py")) {
+        return ["pytest", "-q"];
+    }
+    if (has("package.json"))
+        return ["npm", "test", "--silent"];
+    return null;
+}
+async function runTests(ctx, selector) {
+    let cmd = detectTestCommand(ctx.workspace);
+    if (cmd === null)
+        return "ERROR: no recognized test runner (looked for pytest/npm config).";
+    if (selector !== null) {
+        if (typeof selector !== "string" ||
+            !SELECTOR_RE.test(selector) ||
+            selector.includes("..")) {
+            return "ERROR: invalid selector. Use a test file path or pytest node id (no leading '-', no '..').";
+        }
+        cmd = [...cmd, selector];
+    }
+    const env = scrubEnv(ctx.baseEnv);
+    return new Promise((resolvePromise) => {
+        let out = "";
+        let settled = false;
+        const child = spawn(cmd[0], cmd.slice(1), {
+            cwd: ctx.workspace,
+            env,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const onData = (chunk) => {
+            out = (out + chunk.toString("utf8")).slice(0, MAX_TEST_OUTPUT + 1);
+        };
+        child.stdout?.on("data", onData);
+        child.stderr?.on("data", onData);
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            child.kill("SIGKILL");
+            resolvePromise(`ERROR: tests exceeded ${Math.round(ctx.testTimeoutMs / 1000)}s timeout (killed).`);
+        }, ctx.testTimeoutMs);
+        child.on("error", (err) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolvePromise(`ERROR: could not start tests (${cmd[0]}): ${err.message}`);
+        });
+        child.on("close", (code) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            let body = out;
+            if (body.length > MAX_TEST_OUTPUT) {
+                body =
+                    body.slice(0, MAX_TEST_OUTPUT) +
+                        `\n... (truncated at ${MAX_TEST_OUTPUT} chars)`;
+            }
+            const verdict = code === 0 ? "PASSED" : `FAILED (exit ${code})`;
+            resolvePromise(`[${cmd.join(" ")}] ${verdict}\n${body}`);
+        });
+    });
+}
+/** Execute one tool call; always returns an in-band string (A4). */
+export async function dispatchTool(ctx, name, args) {
+    if (typeof args !== "object" || args === null)
+        return "ERROR: tool arguments must be a JSON object.";
+    try {
+        switch (name) {
+            case N2_TOOL_NAMES.LIST_DIR:
+                return listDir(ctx, String(args["path"] ?? "."));
+            case N2_TOOL_NAMES.READ_FILE:
+                if (!("path" in args))
+                    return "ERROR: 'path' is required.";
+                return readFile(ctx, String(args["path"]));
+            case N2_TOOL_NAMES.WRITE_FILE:
+                if (!("path" in args) || !("content" in args))
+                    return "ERROR: 'path' and 'content' are required.";
+                return writeFile(ctx, String(args["path"]), args["content"]);
+            case N2_TOOL_NAMES.REPLACE_IN_FILE:
+                for (const k of ["path", "old", "new"]) {
+                    if (!(k in args))
+                        return `ERROR: '${k}' is required.`;
+                }
+                return replaceInFile(ctx, String(args["path"]), args["old"], args["new"]);
+            case N2_TOOL_NAMES.RUN_TESTS: {
+                const sel = args["selector"];
+                return await runTests(ctx, sel !== undefined && sel !== null ? String(sel) : null);
+            }
+            default:
+                return `ERROR: unknown tool '${name}'.`;
+        }
+    }
+    catch (err) {
+        return `ERROR: tool '${name}' failed unexpectedly: ${err.message}`;
+    }
+}
+//# sourceMappingURL=n2-tools.js.map

package/dist/spawn/n2-tools.js.map

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

package/dist/spawn/result-map.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Outcome → `Result` frame mapping (design §4 — DR-6, OQ-6).
+ *
+ * Maps the internal executor outcome (CLI exit code / N2 loop status) to the closed
+ * `Result.status` set `succeeded | failed | timed_out`, mirroring the Python
+ * `agentic_backend` contract (`success` → `succeeded`).
+ *
+ *   - CLI exit 0 / N2 `success`        → succeeded (text=summary, diff, files)
+ *   - N2 `no_changes`                  → succeeded (diff null)
+ *   - N2 `needs_clarification`         → succeeded (text=question)
+ *   - CLI nonzero / N2 `error`/crash   → failed (error, NO secrets)
+ *   - deadline                         → timed_out
+ *
+ * `cost_usd` is ALWAYS `null` (the tenant runs their own model — cost is unknown,
+ * NOT 0; OQ-6).
+ */
+import type { Result } from "../frames.js";
+/** Internal executor outcome, before mapping to a wire Result. */
+export type ExecOutcome = {
+    kind: "success";
+    text: string | null;
+    diff: string | null;
+    files: string[];
+} | {
+    kind: "no_changes";
+    text: string | null;
+} | {
+    kind: "needs_clarification";
+    question: string;
+} | {
+    kind: "failed";
+    error: string;
+} | {
+    kind: "timed_out";
+    error?: string;
+};
+/** Trailing chars of stderr kept on a failure result (no full dump). */
+export declare const ERROR_TAIL_CHARS = 4000;
+/** Map an internal outcome to the wire `Result` frame for a launch. */
+export declare function toResult(launchId: string, outcome: ExecOutcome): Result;