@pentoshi/clai 3.5.1 → 3.6.0

package/dist/tools/command-intent.js

@@ -67,12 +67,43 @@ const LONG_RUNNING_PATTERNS = [
 function backgroundsAProcess(command) {
     return /(?:^|[^&\d>])\s&(?:\s|$)/.test(command);
 }
+/**
+ * One-shot project scaffolders — finish and exit. Must stay in the
+ * foreground even when the command string mentions `vite` / `next`.
+ */
+const SCAFFOLD_FOREGROUND_PATTERNS = [
+    /\bnpm\s+create\b/i,
+    /\bnpm\s+init\b/i,
+    /\byarn\s+create\b/i,
+    /\bpnpm\s+create\b/i,
+    /\bbun\s+create\b/i,
+    /\bnpx\s+(?:--yes\s+)?create-[\w-]+/i,
+    /\bnpmx?\s+create-[\w-]+/i,
+    /\bdeno\s+run\b.*\bcreate\b/i,
+    // Non-JS one-shot project creators (must stay foreground)
+    /\bcargo\s+new\b/i,
+    /\bcargo\s+init\b/i,
+    /\bgo\s+mod\s+init\b/i,
+    /\bpoetry\s+new\b/i,
+    /\bdjango-admin\s+startproject\b/i,
+    /\brails\s+new\b/i,
+    /\bcomposer\s+create-project\b/i,
+    /\bmix\s+new\b/i,
+    /\bflutter\s+create\b/i,
+    /\bdotnet\s+new\b/i,
+];
+export function looksLikeOneShotScaffolder(command) {
+    return SCAFFOLD_FOREGROUND_PATTERNS.some((p) => p.test(command));
+}
 /**
  * Returns true if the command appears to be a long-running process that
  * should not block the foreground shell. This is a heuristic — false
  * negatives are safer than false positives.
  */
 export function looksLongRunning(command) {
+    // X5: npm create vite / create-next-app exit; do not background them.
+    if (looksLikeOneShotScaffolder(command))
+        return false;
     return (backgroundsAProcess(command) ||
         LONG_RUNNING_PATTERNS.some((pattern) => pattern.test(command)));
 }

package/dist/tools/command-intent.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-intent.js","sourceRoot":"","sources":["../../src/tools/command-intent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,qBAAqB,GAAa;IACtC,wEAAwE;IACxE,mDAAmD;IACnD,mCAAmC;IACnC,wBAAwB;IAExB,sBAAsB;IACtB,sCAAsC;IACtC,0CAA0C;IAE1C,sBAAsB;IACtB,sBAAsB;IACtB,iBAAiB;IACjB,iBAAiB;IACjB,gBAAgB;IAChB,oBAAoB;IACpB,oBAAoB;IACpB,cAAc;IACd,uBAAuB;IACvB,iBAAiB;IACjB,iBAAiB;IAEjB,2BAA2B;IAC3B,qBAAqB;IACrB,wBAAwB;IACxB,aAAa;IACb,oBAAoB;IAEpB,SAAS;IACT,2BAA2B;IAC3B,4BAA4B;IAC5B,0BAA0B;IAE1B,yBAAyB;IACzB,cAAc;IACd,eAAe;IACf,kBAAkB;IAClB,2BAA2B;IAC3B,cAAc;IAEd,oBAAoB;IACpB,eAAe;IACf,cAAc;IACd,iBAAiB;IAEjB,iBAAiB;IACjB,mBAAmB;IACnB,sBAAsB;IACtB,+BAA+B;IAE/B,oBAAoB;IACpB,cAAc;IACd,gBAAgB;IAChB,mBAAmB;IAEnB,wEAAwE;IACxE,sBAAsB;IACtB,aAAa;IACb,mBAAmB;IACnB,aAAa;IACb,eAAe;IACf,oBAAoB;IACpB,kBAAkB;CACnB,CAAC;AAEF;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,OAAe;IAC1C,OAAO,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,CACL,mBAAmB,CAAC,OAAO,CAAC;QAC5B,qBAAqB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAC/D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"command-intent.js","sourceRoot":"","sources":["../../src/tools/command-intent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,qBAAqB,GAAa;IACtC,wEAAwE;IACxE,mDAAmD;IACnD,mCAAmC;IACnC,wBAAwB;IAExB,sBAAsB;IACtB,sCAAsC;IACtC,0CAA0C;IAE1C,sBAAsB;IACtB,sBAAsB;IACtB,iBAAiB;IACjB,iBAAiB;IACjB,gBAAgB;IAChB,oBAAoB;IACpB,oBAAoB;IACpB,cAAc;IACd,uBAAuB;IACvB,iBAAiB;IACjB,iBAAiB;IAEjB,2BAA2B;IAC3B,qBAAqB;IACrB,wBAAwB;IACxB,aAAa;IACb,oBAAoB;IAEpB,SAAS;IACT,2BAA2B;IAC3B,4BAA4B;IAC5B,0BAA0B;IAE1B,yBAAyB;IACzB,cAAc;IACd,eAAe;IACf,kBAAkB;IAClB,2BAA2B;IAC3B,cAAc;IAEd,oBAAoB;IACpB,eAAe;IACf,cAAc;IACd,iBAAiB;IAEjB,iBAAiB;IACjB,mBAAmB;IACnB,sBAAsB;IACtB,+BAA+B;IAE/B,oBAAoB;IACpB,cAAc;IACd,gBAAgB;IAChB,mBAAmB;IAEnB,wEAAwE;IACxE,sBAAsB;IACtB,aAAa;IACb,mBAAmB;IACnB,aAAa;IACb,eAAe;IACf,oBAAoB;IACpB,kBAAkB;CACnB,CAAC;AAEF;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,OAAe;IAC1C,OAAO,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,4BAA4B,GAAa;IAC7C,mBAAmB;IACnB,iBAAiB;IACjB,oBAAoB;IACpB,oBAAoB;IACpB,mBAAmB;IACnB,qCAAqC;IACrC,0BAA0B;IAC1B,6BAA6B;IAC7B,0DAA0D;IAC1D,kBAAkB;IAClB,mBAAmB;IACnB,sBAAsB;IACtB,mBAAmB;IACnB,kCAAkC;IAClC,kBAAkB;IAClB,gCAAgC;IAChC,gBAAgB;IAChB,uBAAuB;IACvB,mBAAmB;CACpB,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,OAAe;IACxD,OAAO,4BAA4B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,sEAAsE;IACtE,IAAI,0BAA0B,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACtD,OAAO,CACL,mBAAmB,CAAC,OAAO,CAAC;QAC5B,qBAAqB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAC/D,CAAC;AACJ,CAAC"}

package/dist/tools/definitions.d.ts

@@ -0,0 +1,20 @@
+import type { ToolDefinition } from "../types.js";
+/** Plan tools dispatched specially in the runner (not in toolRegistry). */
+export declare const PLAN_TOOL_NAMES: Set<string>;
+/** Meta tools with no registry handler (plan + ask-mode handoff). */
+export declare const NON_REGISTRY_TOOL_NAMES: Set<string>;
+export declare const TOOL_DEFINITIONS: ToolDefinition[];
+export declare function getToolDefinition(name: string): ToolDefinition | undefined;
+export declare function getToolDefinitions(filter?: {
+    askMode?: boolean;
+    names?: string[];
+    compact?: boolean;
+}): ToolDefinition[];
+export declare function getCompactToolDefinitions(): ToolDefinition[];
+export declare function wireNameFor(canonical: string): string;
+export declare function canonicalNameFor(wire: string): string | undefined;
+/**
+ * Every registry key must have a definition; every definition must have a
+ * handler unless it is a plan meta-tool.
+ */
+export declare function assertDefinitionRegistryConsistency(registryKeys: string[]): void;

package/dist/tools/definitions.js

@@ -0,0 +1,509 @@
+import { registerWireNamesFor, toSnakeWireName, toWireName, } from "../llm/tool-protocol.js";
+function def(name, description, parameters, flags = {}) {
+    // Primary wire keeps camelCase (fs_writeMany); also register snake alias.
+    const wireName = registerWireNamesFor(name);
+    return {
+        name,
+        wireName,
+        description,
+        parameters,
+        ...flags,
+    };
+}
+const emptyObject = {
+    type: "object",
+    properties: {},
+    additionalProperties: false,
+};
+/** Plan tools dispatched specially in the runner (not in toolRegistry). */
+export const PLAN_TOOL_NAMES = new Set(["plan.create", "task.update"]);
+/** Meta tools with no registry handler (plan + ask-mode handoff). */
+export const NON_REGISTRY_TOOL_NAMES = new Set([
+    ...PLAN_TOOL_NAMES,
+    "agent.handoff",
+]);
+export const TOOL_DEFINITIONS = [
+    def("fs.read", "Read a file. Use for inspecting source, configs, or outputs. Prefer offset/limit for large files.", {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                description: "File path (absolute, relative, or ~)",
+            },
+            offset: {
+                type: "integer",
+                description: "1-indexed start line for paging",
+            },
+            limit: { type: "integer", description: "Max lines to return" },
+            maxBytes: { type: "integer", description: "Max bytes to read" },
+        },
+        required: ["path"],
+        additionalProperties: false,
+    }, { readOnly: true, askMode: true }),
+    def("fs.write", "Create or fully overwrite a file with complete content in one call. Prefer this over append for new files.", {
+        type: "object",
+        properties: {
+            path: { type: "string" },
+            content: {
+                type: "string",
+                description: "Full file contents in one call",
+            },
+        },
+        required: ["path", "content"],
+        additionalProperties: false,
+    }, { mutates: true }),
+    def("fs.writeMany", "Write multiple complete files in one call (scaffold). Max 50 files.", {
+        type: "object",
+        properties: {
+            files: {
+                type: "array",
+                maxItems: 50,
+                items: {
+                    type: "object",
+                    properties: {
+                        path: { type: "string" },
+                        content: { type: "string" },
+                    },
+                    required: ["path", "content"],
+                    additionalProperties: false,
+                },
+            },
+        },
+        required: ["files"],
+        additionalProperties: false,
+    }, { mutates: true }),
+    def("fs.list", "List directory entries.", {
+        type: "object",
+        properties: {
+            path: { type: "string" },
+            maxEntries: { type: "integer" },
+        },
+        required: [],
+        additionalProperties: false,
+    }, { readOnly: true, askMode: true }),
+    def("fs.search", "Search file contents by pattern (ripgrep-style).", {
+        type: "object",
+        properties: {
+            pattern: { type: "string" },
+            path: { type: "string" },
+        },
+        required: ["pattern"],
+        additionalProperties: false,
+    }, { readOnly: true, askMode: true }),
+    def("fs.edit", "Surgical in-place edit: replace exact oldText with newText.", {
+        type: "object",
+        properties: {
+            path: { type: "string" },
+            oldText: { type: "string" },
+            newText: { type: "string" },
+            expectedReplacements: { type: "integer" },
+        },
+        required: ["path", "oldText", "newText"],
+        additionalProperties: false,
+    }, { mutates: true }),
+    def("fs.replaceLines", "Replace a 1-indexed inclusive line range after reading the file. Empty content (or delete:true) deletes that range.", {
+        type: "object",
+        properties: {
+            path: { type: "string" },
+            startLine: { type: "integer" },
+            endLine: { type: "integer" },
+            content: {
+                type: "string",
+                description: "Replacement text. Empty string deletes the line range (no space hack).",
+            },
+            delete: {
+                type: "boolean",
+                description: "If true, delete the range (same as content:\"\")",
+            },
+        },
+        required: ["path", "startLine", "endLine"],
+        additionalProperties: false,
+    }, { mutates: true }),
+    def("fs.append", "Append (or prepend) content. Use after truncation notices with expectedPriorBytes.", {
+        type: "object",
+        properties: {
+            path: { type: "string" },
+            content: { type: "string" },
+            position: { type: "string", enum: ["start", "end"] },
+            expectedPriorBytes: {
+                type: "integer",
+                description: "From prior write receipt; required after truncation salvage",
+            },
+        },
+        required: ["path", "content"],
+        additionalProperties: false,
+    }, { mutates: true }),
+    def("fs.delete", "Delete a file or directory.", {
+        type: "object",
+        properties: {
+            path: { type: "string" },
+            recursive: { type: "boolean" },
+        },
+        required: ["path"],
+        additionalProperties: false,
+    }, { mutates: true }),
+    def("shell.exec", "Run a shell command and wait for completion. Use shell.start for long-running servers.", {
+        type: "object",
+        properties: {
+            command: { type: "string" },
+            cwd: { type: "string" },
+            timeoutMs: { type: "integer" },
+        },
+        required: ["command"],
+        additionalProperties: false,
+    }, { mutates: true }),
+    def("shell.start", "Start a long-running command in the background; returns a job id.", {
+        type: "object",
+        properties: {
+            command: { type: "string" },
+            cwd: { type: "string" },
+            name: { type: "string" },
+        },
+        required: ["command"],
+        additionalProperties: false,
+    }, { mutates: true }),
+    def("shell.jobs", "List background jobs.", emptyObject, { readOnly: true }),
+    def("shell.tail", "Read recent output from a background job.", {
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            bytes: { type: "integer" },
+        },
+        required: ["id"],
+        additionalProperties: false,
+    }, { readOnly: true }),
+    def("shell.stop", "Stop a background job.", {
+        type: "object",
+        properties: { id: { type: "string" } },
+        required: ["id"],
+        additionalProperties: false,
+    }, { mutates: true }),
+    def("pkg.install", "Install a package via the OS package manager if the binary is missing.", {
+        type: "object",
+        properties: {
+            tool: { type: "string" },
+            checkBinary: { type: "string" },
+        },
+        required: ["tool"],
+        additionalProperties: false,
+    }, { mutates: true }),
+    def("net.scan", "Port/service scan a target with nmap (confirm required for live scans).", {
+        type: "object",
+        properties: {
+            target: { type: "string" },
+            ports: { type: "string" },
+            profile: {
+                type: "object",
+                description: "Structured nmap profile",
+            },
+            flags: {
+                type: "string",
+                description: "Legacy flags string",
+            },
+        },
+        required: ["target"],
+        additionalProperties: false,
+    }, { mutates: true }),
+    def("net.context", "Local network context (interfaces, routes summary).", emptyObject, { readOnly: true, askMode: true }),
+    def("net.pingSweep", "Discover live hosts on a subnet/CIDR.", {
+        type: "object",
+        properties: {
+            target: { type: "string" },
+            method: {
+                type: "string",
+                enum: ["auto", "nmap", "arp", "native"],
+            },
+            timeoutMs: { type: "integer" },
+        },
+        required: ["target"],
+        additionalProperties: false,
+    }, { readOnly: true }),
+    def("http.fetch", "HTTP request (GET/HEAD preferred). Confirm for mutating methods.", {
+        type: "object",
+        properties: {
+            url: { type: "string" },
+            method: { type: "string" },
+            body: { type: "string" },
+            headers: {
+                type: "object",
+                additionalProperties: { type: "string" },
+            },
+            maxBytes: { type: "integer" },
+            iOwnThis: { type: "boolean" },
+            own: { type: "boolean" },
+            retries: { type: "integer" },
+        },
+        required: ["url"],
+        additionalProperties: false,
+    }, { readOnly: true, askMode: true }),
+    def("dns.lookup", "DNS query for a single record type.", {
+        type: "object",
+        properties: {
+            target: { type: "string" },
+            record: {
+                type: "string",
+                description: "A, AAAA, MX, TXT, ...",
+            },
+        },
+        required: ["target"],
+        additionalProperties: false,
+    }, { readOnly: true, askMode: true }),
+    def("whois.lookup", "WHOIS lookup for domain or IP ownership.", {
+        type: "object",
+        properties: { target: { type: "string" } },
+        required: ["target"],
+        additionalProperties: false,
+    }, { readOnly: true, askMode: true }),
+    def("pentest.recon", "Bundled whois/dns/nmap recon. Prefer discrete tools when only one step is needed.", {
+        type: "object",
+        properties: {
+            target: { type: "string" },
+            whois: { type: "boolean" },
+            dns: { type: "boolean" },
+            nmap: { type: "boolean" },
+        },
+        required: ["target"],
+        additionalProperties: false,
+    }, { mutates: true }),
+    def("web.search", "Search the web for current information. Use for volatile facts and research.", {
+        type: "object",
+        properties: {
+            query: { type: "string" },
+            maxResults: { type: "integer" },
+            fetchTop: {
+                type: "integer",
+                description: "Fetch top N pages (0-3)",
+            },
+        },
+        required: ["query"],
+        additionalProperties: false,
+    }, { readOnly: true, askMode: true }),
+    def("web.fetch", "Fetch a URL as readable text or metadata for research.", {
+        type: "object",
+        properties: {
+            url: { type: "string" },
+            maxBytes: { type: "integer" },
+            includeHeaders: { type: "boolean" },
+            includeTls: { type: "boolean" },
+            includeTiming: { type: "boolean" },
+            includeRedirectChain: { type: "boolean" },
+            responseMode: {
+                type: "string",
+                enum: ["readable", "raw"],
+                description: "Body formatting: readable (default) or raw. Headers/TLS are separate booleans.",
+            },
+            redactSensitive: { type: "boolean" },
+        },
+        required: ["url"],
+        additionalProperties: false,
+    }, { readOnly: true, askMode: true }),
+    def("sysinfo", "OS/environment facts for this machine.", emptyObject, {
+        readOnly: true,
+        askMode: true,
+    }),
+    def("tool.check", 'Check whether binaries/tools are available on PATH (and versions). Pass tools as an array, e.g. {"tools":["nmap","ffuf"]}.', {
+        type: "object",
+        properties: {
+            tools: {
+                type: "array",
+                items: { type: "string" },
+                minItems: 1,
+                maxItems: 20,
+                description: 'Tool names, e.g. ["nmap","ffuf"]',
+            },
+        },
+        required: ["tools"],
+        additionalProperties: false,
+    }, { readOnly: true, askMode: true }),
+    def("tool.batch", "Run multiple read-only tool calls concurrently (max 20).", {
+        type: "object",
+        properties: {
+            calls: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        name: { type: "string" },
+                        args: { type: "object" },
+                    },
+                    required: ["name", "args"],
+                },
+            },
+        },
+        required: ["calls"],
+        additionalProperties: false,
+    }, { readOnly: true, askMode: true }),
+    def("wordlist.find", "Locate wordlists on disk for fuzzing/directory scans.", {
+        type: "object",
+        properties: {
+            query: { type: "string" },
+            expand: { type: "boolean" },
+        },
+        required: ["query"],
+        additionalProperties: false,
+    }, { readOnly: true }),
+    def("image.ocr", "OCR text from an image file (fallback when vision is unavailable).", {
+        type: "object",
+        properties: {
+            path: { type: "string" },
+            lang: { type: "string" },
+            maxBytes: { type: "integer" },
+        },
+        required: ["path"],
+        additionalProperties: false,
+    }, { readOnly: true, askMode: true }),
+    def("pdf.read", "Extract text from a PDF (OCR fallback for scanned pages).", {
+        type: "object",
+        properties: {
+            path: { type: "string" },
+            maxPages: { type: "integer" },
+            maxBytes: { type: "integer" },
+        },
+        required: ["path"],
+        additionalProperties: false,
+    }, { readOnly: true, askMode: true }),
+    def("plan.create", "Create or revise a durable multi-step session plan with task checklist.", {
+        type: "object",
+        properties: {
+            goal: { type: "string" },
+            detail: { type: "string" },
+            tasks: {
+                type: "array",
+                items: {
+                    oneOf: [
+                        { type: "string" },
+                        {
+                            type: "object",
+                            properties: {
+                                title: { type: "string" },
+                                task: { type: "string" },
+                                name: { type: "string" },
+                            },
+                        },
+                    ],
+                },
+            },
+            kind: { type: "string" },
+        },
+        required: ["goal", "tasks"],
+        additionalProperties: true,
+    }, { mutates: true }),
+    def("task.update", "Update a plan task state. taskId MUST be t1, t2, … from the ACTIVE PLAN context (not a free-form title slug).", {
+        type: "object",
+        properties: {
+            taskId: {
+                type: "string",
+                description: "Canonical id from plan context: t1, t2, t3, … (aliases accepted if listed)",
+            },
+            state: {
+                type: "string",
+                enum: ["pending", "in_progress", "done", "failed", "skipped"],
+            },
+            note: { type: "string" },
+        },
+        required: ["taskId", "state"],
+        additionalProperties: true,
+    }, { mutates: true }),
+    def("agent.handoff", "Hand a task that needs agent mode (writes, shell, installs) back to the user. Ask mode cannot execute mutations — use this instead of inventing write tools.", {
+        type: "object",
+        properties: {
+            task: {
+                type: "string",
+                description: "Exact task restatement for agent mode",
+            },
+            reason: {
+                type: "string",
+                description: "Short reason agent mode is required",
+            },
+        },
+        required: ["task", "reason"],
+        additionalProperties: false,
+    }),
+];
+const byName = new Map(TOOL_DEFINITIONS.map((d) => [d.name, d]));
+const byWire = new Map();
+for (const d of TOOL_DEFINITIONS) {
+    byWire.set(d.wireName, d);
+    const snake = toSnakeWireName(d.name);
+    if (snake !== d.wireName)
+        byWire.set(snake, d);
+}
+export function getToolDefinition(name) {
+    return byName.get(name) ?? byWire.get(name);
+}
+export function getToolDefinitions(filter) {
+    let defs = TOOL_DEFINITIONS;
+    if (filter?.askMode) {
+        defs = defs.filter((d) => d.askMode);
+    }
+    if (filter?.names) {
+        const allow = new Set(filter.names);
+        defs = defs.filter((d) => allow.has(d.name));
+    }
+    if (filter?.compact) {
+        // Core set for low-TPM models + recon/network essentials (no net.scan
+        // mutator — that still needs the full set / confirm UX).
+        const core = new Set([
+            "fs.read",
+            "fs.write",
+            "fs.writeMany",
+            "fs.list",
+            "fs.search",
+            "fs.edit",
+            "fs.append",
+            "fs.delete",
+            "shell.exec",
+            "shell.start",
+            "shell.jobs",
+            "shell.tail",
+            "shell.stop",
+            "web.search",
+            "web.fetch",
+            "http.fetch",
+            "dns.lookup",
+            "whois.lookup",
+            "net.context",
+            "pentest.recon",
+            "wordlist.find",
+            "sysinfo",
+            "tool.check",
+            "plan.create",
+            "task.update",
+        ]);
+        defs = defs.filter((d) => core.has(d.name));
+    }
+    return defs.map((d) => ({ ...d }));
+}
+export function getCompactToolDefinitions() {
+    return getToolDefinitions({ compact: true });
+}
+export function wireNameFor(canonical) {
+    return byName.get(canonical)?.wireName ?? toWireName(canonical);
+}
+export function canonicalNameFor(wire) {
+    return byWire.get(wire)?.name;
+}
+/**
+ * Every registry key must have a definition; every definition must have a
+ * handler unless it is a plan meta-tool.
+ */
+export function assertDefinitionRegistryConsistency(registryKeys) {
+    const reg = new Set(registryKeys);
+    const defNames = new Set(TOOL_DEFINITIONS.map((d) => d.name));
+    const wires = new Set();
+    for (const d of TOOL_DEFINITIONS) {
+        if (wires.has(d.wireName)) {
+            throw new Error(`Duplicate wire name: ${d.wireName}`);
+        }
+        wires.add(d.wireName);
+        if (!NON_REGISTRY_TOOL_NAMES.has(d.name) && !reg.has(d.name)) {
+            throw new Error(`Definition "${d.name}" has no toolRegistry handler (and is not a meta tool)`);
+        }
+    }
+    for (const key of registryKeys) {
+        if (!defNames.has(key)) {
+            throw new Error(`toolRegistry key "${key}" has no ToolDefinition`);
+        }
+    }
+}
+//# sourceMappingURL=definitions.js.map

package/dist/tools/definitions.js.map

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

package/dist/tools/fs.js

@@ -6,6 +6,7 @@ import { execa } from "execa";
 import { getConfig } from "../store/config.js";
 import { isSecretPath } from "../safety/patterns.js";
 import { safeCwd } from "../os/cwd.js";
+import { remapAgentCwdWrite, resolveToolPath, } from "../agent/project-root.js";
 /** Compact integrity footer so the model trusts a write without re-reading. */
 function describeWrite(path, content, verb) {
     const bytes = Buffer.byteLength(content, "utf8");
@@ -41,9 +42,10 @@ function expandHome(path) {
     }
     return path;
 }
-/** Resolve path with tilde expansion. */
+/** Resolve path with tilde expansion + sticky plan project root for relatives. */
 function resolvePath(path) {
-    return resolve(expandHome(path));
+    const resolved = resolveToolPath(path);
+    return remapAgentCwdWrite(resolved, path);
 }
 function ensureNotSecret(resolved) {
     if (isSecretPath(resolved)) {
@@ -208,7 +210,14 @@ export async function fsReplaceLines(path, startLine, endLine, content, options
         await unlink(temp).catch(() => undefined);
         throw error;
     }
-    return { ok: true, output: `Replaced lines ${startLine}-${endLine} in ${resolved}` };
+    // X10: receipt with line count + hash so the model notices size changes.
+    const verb = content === ""
+        ? `Deleted lines ${startLine}-${endLine} in`
+        : `Replaced lines ${startLine}-${endLine} in`;
+    return {
+        ok: true,
+        output: describeWrite(resolved, next, verb),
+    };
 }
 const WRITE_MANY_MAX_FILES = 50;
 /**