@chances-ai/engine 24.0.0

package/dist/tools/builtins/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../../src/tools/builtins/glob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAE7D,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,MAAM,CAAC,MAAM,QAAQ,GAAS;IAC5B,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,6JAA6J;IAC/J,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oDAAoD,EAAE;YAC9F,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0EAA0E,EAAE;YACjH,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,kBAAkB,GAAG,EAAE;SAC7F;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;QAClB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnC,OAAO,QAAQ,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACtE,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;QACrB,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,kBAAkB,CAAC;QAE1D,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC;QACxE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,OAAO,EAAE,EAAE,CAAC;QAEtF,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACpG,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;QACxE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,4CAA4C,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;IACvD,CAAC;CACF,CAAC"}

package/dist/tools/builtins/grep.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from "../types.js";
+export declare const grepTool: Tool;
+//# sourceMappingURL=grep.d.ts.map

package/dist/tools/builtins/grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/grep.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,aAAa,CAAC;AAKpD,eAAO,MAAM,QAAQ,EAAE,IAiFtB,CAAC"}

package/dist/tools/builtins/grep.js

@@ -0,0 +1,81 @@
+import { existsSync } from "node:fs";
+import { native } from "@chances-ai/native";
+import { optBool, optNum, optStr, preview, safePath, str } from "./_shared.js";
+const GREP_DEFAULT_HEAD = 100;
+export const grepTool = {
+    name: "grep",
+    description: "Search workspace files for a regex pattern. Returns matching file paths by default; set outputMode to 'content' for line-level matches or 'count' for per-file counts. Use this instead of shelling out to grep/rg.",
+    category: "search",
+    parameters: {
+        type: "object",
+        properties: {
+            pattern: { type: "string", description: "Regular expression to search for." },
+            path: { type: "string", description: "Sub-path within the workspace to search. Defaults to the workspace root." },
+            glob: { type: "string", description: "Optional glob to filter file paths (e.g. '**/*.ts')." },
+            outputMode: {
+                type: "string",
+                enum: ["files_with_matches", "content", "count"],
+                description: "files_with_matches (default): unique paths. content: 'path:line:text'. count: 'path:count'.",
+            },
+            caseInsensitive: { type: "boolean" },
+            multiline: { type: "boolean", description: "Allow . to match newlines." },
+            headLimit: { type: "number", description: `Max rows in the output. Default ${GREP_DEFAULT_HEAD}.` },
+        },
+        required: ["pattern"],
+    },
+    summarize: (args) => {
+        const pattern = str(args, "pattern");
+        const where = optStr(args, "path");
+        return `grep ${preview(pattern)}${where ? ` in ${where}` : ""}`;
+    },
+    async execute(args, ctx) {
+        const pattern = str(args, "pattern");
+        const subPath = optStr(args, "path");
+        const globFilter = optStr(args, "glob");
+        const outputMode = (optStr(args, "outputMode") ?? "files_with_matches");
+        const caseInsensitive = optBool(args, "caseInsensitive");
+        const multiline = optBool(args, "multiline");
+        const headLimit = optNum(args, "headLimit") ?? GREP_DEFAULT_HEAD;
+        const searchRoot = subPath ? safePath(ctx, subPath) : ctx.workspaceRoot;
+        if (!existsSync(searchRoot))
+            return { ok: false, output: `No such path: ${subPath}` };
+        // Per-file cap is chosen so that one dense file can't starve later files:
+        //  - files_with_matches: bail at the first hit per file (we only need presence).
+        //  - count: no cap; aggregating requires every match.
+        //  - content: small cap so output stays diverse across files.
+        const perFileLimit = outputMode === "files_with_matches" ? 1 : outputMode === "count" ? undefined : 50;
+        let matches;
+        try {
+            matches = await native.grep(pattern, searchRoot, {
+                caseInsensitive,
+                multiline,
+                glob: globFilter,
+                perFileLimit,
+                signal: ctx.signal,
+            });
+        }
+        catch (e) {
+            return { ok: false, output: `Invalid pattern: ${e.message}` };
+        }
+        if (matches.length === 0)
+            return { ok: true, output: "No matches found" };
+        if (outputMode === "files_with_matches") {
+            const files = Array.from(new Set(matches.map((m) => m.file)));
+            const shown = files.slice(0, headLimit);
+            const more = files.length > shown.length ? `\n…(${files.length - shown.length} more files)` : "";
+            return { ok: true, output: shown.join("\n") + more };
+        }
+        if (outputMode === "count") {
+            const counts = new Map();
+            for (const m of matches)
+                counts.set(m.file, (counts.get(m.file) ?? 0) + 1);
+            const entries = Array.from(counts.entries()).slice(0, headLimit);
+            const more = counts.size > entries.length ? `\n…(${counts.size - entries.length} more files)` : "";
+            return { ok: true, output: entries.map(([f, c]) => `${f}:${c}`).join("\n") + more };
+        }
+        const shown = matches.slice(0, headLimit);
+        const more = matches.length > shown.length ? `\n…(${matches.length - shown.length} more matches)` : "";
+        return { ok: true, output: shown.map((m) => `${m.file}:${m.line}:${m.text}`).join("\n") + more };
+    },
+};
+//# sourceMappingURL=grep.js.map

package/dist/tools/builtins/grep.js.map

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

package/dist/tools/builtins/lsp.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from "../types.js";
+export declare const lspTool: Tool;
+//# sourceMappingURL=lsp.d.ts.map

package/dist/tools/builtins/lsp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/lsp.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,aAAa,CAAC;AAepD,eAAO,MAAM,OAAO,EAAE,IA4ErB,CAAC"}

package/dist/tools/builtins/lsp.js

@@ -0,0 +1,102 @@
+/**
+ * (4.2) `lsp` built-in tool — read-only LSP queries.
+ *
+ * One tool, nine ops, claude-code-shape. The actual host
+ * (`@chances-ai/lsp`) is wired in at boot via `ToolContext.lsp`;
+ * when absent, the tool fails fast so the model sees the install hint.
+ *
+ * Category is `integration` (codex Round-1 MUST-FIX #4) — NOT `search`.
+ * LSP spawns a long-lived user-space binary; that's materially
+ * different from the in-process grep/glob.
+ */
+import { AppError, ErrorCode } from "@chances-ai/runtime";
+import { optNum, optStr, safePath, str } from "./_shared.js";
+const VALID_OPS = new Set([
+    "goToDefinition",
+    "findReferences",
+    "hover",
+    "documentSymbol",
+    "workspaceSymbol",
+    "goToImplementation",
+    "prepareCallHierarchy",
+    "incomingCalls",
+    "outgoingCalls",
+]);
+export const lspTool = {
+    name: "lsp",
+    description: "Language-server-protocol queries (read-only). Ops: goToDefinition, findReferences, hover, documentSymbol, workspaceSymbol, goToImplementation, prepareCallHierarchy, incomingCalls, outgoingCalls. Uses whichever language server you have installed (typescript-language-server, rust-analyzer, pyright, gopls). Coordinates are 1-based.",
+    category: "integration",
+    parameters: {
+        type: "object",
+        properties: {
+            op: {
+                type: "string",
+                enum: [
+                    "goToDefinition",
+                    "findReferences",
+                    "hover",
+                    "documentSymbol",
+                    "workspaceSymbol",
+                    "goToImplementation",
+                    "prepareCallHierarchy",
+                    "incomingCalls",
+                    "outgoingCalls",
+                ],
+                description: "LSP operation to perform.",
+            },
+            filePath: {
+                type: "string",
+                description: "Workspace-relative or absolute path. Required for every op except `workspaceSymbol`.",
+            },
+            line: { type: "number", description: "1-based line number. Required for position-based ops." },
+            character: { type: "number", description: "1-based character offset. Required for position-based ops." },
+            query: {
+                type: "string",
+                description: "Symbol name fragment. Required for `workspaceSymbol`. Must be non-empty.",
+            },
+        },
+        required: ["op"],
+    },
+    summarize(args) {
+        const op = optStr(args, "op") ?? "lsp";
+        const where = optStr(args, "filePath") ?? optStr(args, "query") ?? "";
+        return `lsp ${op}${where ? " " + where : ""}`;
+    },
+    async execute(args, ctx) {
+        const op = str(args, "op");
+        if (!VALID_OPS.has(op)) {
+            return { ok: false, output: `Unknown lsp op: ${op}` };
+        }
+        if (!ctx.lsp) {
+            return {
+                ok: false,
+                output: "LSP not available: install `vscode-jsonrpc` as a peer dep (and a language server like typescript-language-server / rust-analyzer / pyright / gopls), then restart.",
+            };
+        }
+        const filePath = optStr(args, "filePath");
+        const abs = filePath ? safePath(ctx, filePath) : undefined;
+        const line = optNum(args, "line");
+        const character = optNum(args, "character");
+        const query = optStr(args, "query");
+        try {
+            return await ctx.lsp.execute({
+                op,
+                filePath: abs,
+                line,
+                character,
+                query,
+                cwd: ctx.cwd,
+                signal: ctx.signal,
+            });
+        }
+        catch (e) {
+            // codex Round-1 MUST-FIX #5 — cancellation must propagate as
+            // engine-level AppError(Cancelled), not be swallowed into ok:false.
+            if (e instanceof AppError && e.code === ErrorCode.Cancelled)
+                throw e;
+            const msg = e instanceof Error ? e.message : String(e);
+            return { ok: false, output: `LSP ${op} failed: ${msg}` };
+        }
+    },
+};
+//# sourceMappingURL=lsp.js.map

package/dist/tools/builtins/lsp.js.map

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

package/dist/tools/builtins/pty.d.ts

@@ -0,0 +1,64 @@
+/**
+ * (5.1) `pty` — interactive bidirectional PTY tool.
+ *
+ * Op-enum surface (mirrors 4.2 LSP pattern):
+ *   start | write | read | resize | kill | interrupt | adopt | list
+ *
+ * Per-op permission via `Tool.permission(args, ctx)` hook (5.1 API
+ * surface change). Each op returns either:
+ *   - a `PermissionRequest` with a per-op `cacheKey` (`start` re-prompts
+ *     per `(command, cwd, shell, env)`; `kill` per `(session_id, signal)`;
+ *     `write` per `(session_id, sha256(line))` for command-class input,
+ *     etc.), or
+ *   - `null` to bypass the gate entirely (`read`, `resize`, `list`).
+ *
+ * Codex Round-1 MUST-FIX #3 — `write` containing `\n`/`\r`/control bytes
+ * is "command-class" input that executes a line in the underlying
+ * shell/REPL; re-prompt required.
+ *
+ * Codex Round-1 MUST-FIX #7 — `start` permission summary includes
+ * resolved `cwd`, allowlisted `shell` (or rejected with `PTY_BAD_SHELL`),
+ * and non-default env keys (values redacted past 8 chars).
+ *
+ * Codex Round-1 Q4/Q7 — shell allowlist + dedicated `interrupt` op
+ * (separate gate from `kill`).
+ */
+import type { PtyHandleFactory, PtySessionRegistry } from "@chances-ai/runtime";
+import type { Tool } from "../types.js";
+export interface CreatePtyToolDeps {
+    registry: PtySessionRegistry;
+    /** The agent owning sessions created through this tool instance.
+     * Parent engine uses `createId("agent")` minted at buildEngine; sync
+     * subagents use a synthetic id; background subagents use the registry
+     * handle's `taskId`. */
+    agentId: string;
+    agentName?: string;
+    /** Parent workspace root — informational, used as a fallback when
+     * `defaultCwd` is unset. The registry uses ITS OWN workspaceRoot for
+     * read-overflow persistence (always parent), independent of this. */
+    workspaceRoot: string;
+    /** (5.1 codex Round-2 MUST-FIX #3) Default cwd for `pty.start` when
+     * the model omits one. For parent engines this is `workspaceRoot`;
+     * for isolated subagents it MUST be the worktree path so commands
+     * run inside the worktree, not against the parent checkout. Falls
+     * back to `workspaceRoot` when undefined. */
+    defaultCwd?: string;
+    /** Default shell when the model omits one. POSIX: `/bin/sh`;
+     * Windows: `cmd.exe`. Caller may override via config. */
+    defaultShell?: string;
+    /** Absolute paths the user explicitly allowed via
+     * `config.pty.shellAllowlist`. Anything not in the basename allowlist
+     * AND not in this list is rejected with `PTY_BAD_SHELL`. */
+    shellAllowlistExtra?: readonly string[];
+    /** When set, the spawning engine is running inside a 4.1 worktree;
+     * sessions inherit this so the registry can refresh the active
+     * marker. */
+    worktreeCwd?: string;
+    /** Handle factory injected from outside — the engine wires this to
+     * `native.createPtySession.bind(native)`. Threaded through the deps
+     * object rather than imported so `@chances-ai/tools` stays free of a
+     * `@chances-ai/native` runtime import. */
+    createHandle: PtyHandleFactory;
+}
+export declare function createPtyTool(deps: CreatePtyToolDeps): Tool;
+//# sourceMappingURL=pty.d.ts.map

package/dist/tools/builtins/pty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/pty.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,KAAK,EAAa,gBAAgB,EAAkB,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE3G,OAAO,KAAK,EAAqB,IAAI,EAA2B,MAAM,aAAa,CAAC;AAwKpF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B;;;4BAGwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;yEAEqE;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB;;;;iDAI6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;6DACyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;gEAE4D;IAC5D,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC;;iBAEa;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;8CAG0C;IAC1C,YAAY,EAAE,gBAAgB,CAAC;CAChC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAgX3D"}