@librechat/agents 3.2.32 → 3.2.33

package/dist/cjs/tools/local/LocalCodingTools.cjs

@@ -1,1104 +1,844 @@
-'use strict';
-
-var path = require('path');
-var diff = require('diff');
-var tools = require('@langchain/core/tools');
-var LocalProgrammaticToolCalling = require('./LocalProgrammaticToolCalling.cjs');
-var LocalExecutionEngine = require('./LocalExecutionEngine.cjs');
-var LocalExecutionTools = require('./LocalExecutionTools.cjs');
-var CompileCheckTool = require('./CompileCheckTool.cjs');
-var attachments = require('./attachments.cjs');
-var FileCheckpointer = require('./FileCheckpointer.cjs');
-var editStrategies = require('./editStrategies.cjs');
-var textEncoding = require('./textEncoding.cjs');
-var syntaxCheck = require('./syntaxCheck.cjs');
-var _enum = require('../../common/enum.cjs');
-
-const MAX_READ_CHARS = 256000;
+require("../../common/enum.cjs");
+require("../../common/index.cjs");
+const require_LocalExecutionEngine = require("./LocalExecutionEngine.cjs");
+const require_CompileCheckTool = require("./CompileCheckTool.cjs");
+const require_FileCheckpointer = require("./FileCheckpointer.cjs");
+const require_LocalProgrammaticToolCalling = require("./LocalProgrammaticToolCalling.cjs");
+const require_LocalExecutionTools = require("./LocalExecutionTools.cjs");
+const require_attachments = require("./attachments.cjs");
+const require_editStrategies = require("./editStrategies.cjs");
+const require_textEncoding = require("./textEncoding.cjs");
+const require_syntaxCheck = require("./syntaxCheck.cjs");
+let _langchain_core_tools = require("@langchain/core/tools");
+let path = require("path");
+let diff = require("diff");
+//#region src/tools/local/LocalCodingTools.ts
+const MAX_READ_CHARS = 256e3;
 const DEFAULT_MAX_RESULTS = 200;
 const DEFAULT_MAX_READ_BYTES = 10 * 1024 * 1024;
-const BINARY_DETECTION_BYTES = 8000;
+const BINARY_DETECTION_BYTES = 8e3;
 /**
- * Tool name aliases retained for back-compat with consumers that imported
- * the per-file `Local*ToolName` constants. The canonical names live on
- * `Constants.*` (see `src/common/enum.ts`); these aliases just point at
- * them so a typo upstream gets caught at the type level.
- */
-const LocalWriteFileToolName = _enum.Constants.WRITE_FILE;
-const LocalEditFileToolName = _enum.Constants.EDIT_FILE;
-const LocalGrepSearchToolName = _enum.Constants.GREP_SEARCH;
-const LocalGlobSearchToolName = _enum.Constants.GLOB_SEARCH;
-const LocalListDirectoryToolName = _enum.Constants.LIST_DIRECTORY;
+* Tool name aliases retained for back-compat with consumers that imported
+* the per-file `Local*ToolName` constants. The canonical names live on
+* `Constants.*` (see `src/common/enum.ts`); these aliases just point at
+* them so a typo upstream gets caught at the type level.
+*/
+const LocalWriteFileToolName = "write_file";
+const LocalEditFileToolName = "edit_file";
+const LocalGrepSearchToolName = "grep_search";
+const LocalGlobSearchToolName = "glob_search";
+const LocalListDirectoryToolName = "list_directory";
 const LocalReadFileToolSchema = {
-    type: 'object',
-    properties: {
-        file_path: {
-            type: 'string',
-            description: 'Path to a local file, relative to the configured cwd unless absolute paths are allowed.',
-        },
-        offset: {
-            type: 'integer',
-            description: 'Optional 1-indexed line offset for large files.',
-        },
-        limit: {
-            type: 'integer',
-            description: 'Optional maximum number of lines to return.',
-        },
-    },
-    required: ['file_path'],
+	type: "object",
+	properties: {
+		file_path: {
+			type: "string",
+			description: "Path to a local file, relative to the configured cwd unless absolute paths are allowed."
+		},
+		offset: {
+			type: "integer",
+			description: "Optional 1-indexed line offset for large files."
+		},
+		limit: {
+			type: "integer",
+			description: "Optional maximum number of lines to return."
+		}
+	},
+	required: ["file_path"]
 };
 const LocalWriteFileToolSchema = {
-    type: 'object',
-    properties: {
-        file_path: {
-            type: 'string',
-            description: 'Path to write, relative to the configured cwd unless absolute paths are allowed.',
-        },
-        content: {
-            type: 'string',
-            description: 'Complete file contents to write.',
-        },
-    },
-    required: ['file_path', 'content'],
+	type: "object",
+	properties: {
+		file_path: {
+			type: "string",
+			description: "Path to write, relative to the configured cwd unless absolute paths are allowed."
+		},
+		content: {
+			type: "string",
+			description: "Complete file contents to write."
+		}
+	},
+	required: ["file_path", "content"]
 };
 const LocalEditFileToolSchema = {
-    type: 'object',
-    properties: {
-        file_path: {
-            type: 'string',
-            description: 'Path to edit, relative to the configured cwd unless absolute paths are allowed.',
-        },
-        old_text: {
-            type: 'string',
-            description: 'Exact text to replace. Must appear exactly once.',
-        },
-        new_text: {
-            type: 'string',
-            description: 'Replacement text.',
-        },
-        edits: {
-            type: 'array',
-            description: 'Optional batch of exact replacements. Each old_text must appear exactly once in the original file.',
-            items: {
-                type: 'object',
-                properties: {
-                    old_text: { type: 'string' },
-                    new_text: { type: 'string' },
-                },
-                required: ['old_text', 'new_text'],
-            },
-        },
-    },
-    required: ['file_path'],
+	type: "object",
+	properties: {
+		file_path: {
+			type: "string",
+			description: "Path to edit, relative to the configured cwd unless absolute paths are allowed."
+		},
+		old_text: {
+			type: "string",
+			description: "Exact text to replace. Must appear exactly once."
+		},
+		new_text: {
+			type: "string",
+			description: "Replacement text."
+		},
+		edits: {
+			type: "array",
+			description: "Optional batch of exact replacements. Each old_text must appear exactly once in the original file.",
+			items: {
+				type: "object",
+				properties: {
+					old_text: { type: "string" },
+					new_text: { type: "string" }
+				},
+				required: ["old_text", "new_text"]
+			}
+		}
+	},
+	required: ["file_path"]
 };
 const LocalGrepSearchToolSchema = {
-    type: 'object',
-    properties: {
-        pattern: {
-            type: 'string',
-            description: 'Regex pattern to search for.',
-        },
-        path: {
-            type: 'string',
-            description: 'Directory or file to search. Defaults to cwd.',
-        },
-        glob: {
-            type: 'string',
-            description: 'Optional file glob passed to rg -g.',
-        },
-        max_results: {
-            type: 'integer',
-            description: 'Maximum matching lines to return.',
-        },
-    },
-    required: ['pattern'],
+	type: "object",
+	properties: {
+		pattern: {
+			type: "string",
+			description: "Regex pattern to search for."
+		},
+		path: {
+			type: "string",
+			description: "Directory or file to search. Defaults to cwd."
+		},
+		glob: {
+			type: "string",
+			description: "Optional file glob passed to rg -g."
+		},
+		max_results: {
+			type: "integer",
+			description: "Maximum matching lines to return."
+		}
+	},
+	required: ["pattern"]
 };
 const LocalGlobSearchToolSchema = {
-    type: 'object',
-    properties: {
-        pattern: {
-            type: 'string',
-            description: 'File glob pattern, for example "src/**/*.ts".',
-        },
-        path: {
-            type: 'string',
-            description: 'Directory to search. Defaults to cwd.',
-        },
-        max_results: {
-            type: 'integer',
-            description: 'Maximum file paths to return.',
-        },
-    },
-    required: ['pattern'],
+	type: "object",
+	properties: {
+		pattern: {
+			type: "string",
+			description: "File glob pattern, for example \"src/**/*.ts\"."
+		},
+		path: {
+			type: "string",
+			description: "Directory to search. Defaults to cwd."
+		},
+		max_results: {
+			type: "integer",
+			description: "Maximum file paths to return."
+		}
+	},
+	required: ["pattern"]
 };
 const LocalListDirectoryToolSchema = {
-    type: 'object',
-    properties: {
-        path: {
-            type: 'string',
-            description: 'Directory to list. Defaults to cwd.',
-        },
-    },
+	type: "object",
+	properties: { path: {
+		type: "string",
+		description: "Directory to list. Defaults to cwd."
+	} }
 };
 function lineWindow(content, offset, limit) {
-    const start = Math.max((offset ?? 1) - 1, 0);
-    // Avoid splitting the whole file when the caller asked for a small
-    // window. For a 10 MB file with `offset: 1, limit: 10`, the prior
-    // `content.split('\n')` allocated millions of strings to throw all
-    // but 10 away. We walk newline indices directly: O(start + limit)
-    // instead of O(file). When `limit` is omitted, fall back to the
-    // simple split — it's the same amount of work either way.
-    if (limit == null || limit <= 0) {
-        const lines = content.split('\n');
-        const selected = lines.slice(start);
-        const numbered = selected
-            .map((line, index) => `${String(start + index + 1).padStart(6, ' ')}\t${line}`)
-            .join('\n');
-        return {
-            text: LocalExecutionEngine.truncateLocalOutput(numbered, MAX_READ_CHARS),
-            truncated: numbered.length > MAX_READ_CHARS,
-        };
-    }
-    // Walk to the start line by counting newlines.
-    let cursor = 0;
-    for (let i = 0; i < start; i++) {
-        const next = content.indexOf('\n', cursor);
-        if (next === -1) {
-            // File has fewer lines than `offset` — return empty window.
-            return { text: '', truncated: false };
-        }
-        cursor = next + 1;
-    }
-    // Collect up to `limit` lines from `cursor`.
-    const out = [];
-    let pos = cursor;
-    let exhausted = true;
-    for (let k = 0; k < limit; k++) {
-        const next = content.indexOf('\n', pos);
-        if (next === -1) {
-            out.push(content.slice(pos));
-            break;
-        }
-        out.push(content.slice(pos, next));
-        pos = next + 1;
-        if (k === limit - 1 && pos < content.length) {
-            exhausted = false;
-        }
-    }
-    const numbered = out
-        .map((text, index) => `${String(start + index + 1).padStart(6, ' ')}\t${text}`)
-        .join('\n');
-    return {
-        text: LocalExecutionEngine.truncateLocalOutput(numbered, MAX_READ_CHARS),
-        truncated: !exhausted || numbered.length > MAX_READ_CHARS,
-    };
+	const start = Math.max((offset ?? 1) - 1, 0);
+	if (limit == null || limit <= 0) {
+		const numbered = content.split("\n").slice(start).map((line, index) => `${String(start + index + 1).padStart(6, " ")}\t${line}`).join("\n");
+		return {
+			text: require_LocalExecutionEngine.truncateLocalOutput(numbered, MAX_READ_CHARS),
+			truncated: numbered.length > MAX_READ_CHARS
+		};
+	}
+	let cursor = 0;
+	for (let i = 0; i < start; i++) {
+		const next = content.indexOf("\n", cursor);
+		if (next === -1) return {
+			text: "",
+			truncated: false
+		};
+		cursor = next + 1;
+	}
+	const out = [];
+	let pos = cursor;
+	let exhausted = true;
+	for (let k = 0; k < limit; k++) {
+		const next = content.indexOf("\n", pos);
+		if (next === -1) {
+			out.push(content.slice(pos));
+			break;
+		}
+		out.push(content.slice(pos, next));
+		pos = next + 1;
+		if (k === limit - 1 && pos < content.length) exhausted = false;
+	}
+	const numbered = out.map((text, index) => `${String(start + index + 1).padStart(6, " ")}\t${text}`).join("\n");
+	return {
+		text: require_LocalExecutionEngine.truncateLocalOutput(numbered, MAX_READ_CHARS),
+		truncated: !exhausted || numbered.length > MAX_READ_CHARS
+	};
 }
-const MAX_DIFF_CHARS = 4000;
-async function maybeRunSyntaxCheck(path, config) {
-    const mode = config.postEditSyntaxCheck ?? 'off';
-    if (mode === 'off')
-        return undefined;
-    const outcome = await syntaxCheck.runPostEditSyntaxCheck(path, config);
-    if (outcome == null)
-        return undefined;
-    return { mode, outcome };
+const MAX_DIFF_CHARS = 4e3;
+async function maybeRunSyntaxCheck(path$1, config) {
+	const mode = config.postEditSyntaxCheck ?? "off";
+	if (mode === "off") return void 0;
+	const outcome = await require_syntaxCheck.runPostEditSyntaxCheck(path$1, config);
+	if (outcome == null) return void 0;
+	return {
+		mode,
+		outcome
+	};
 }
 function appendSyntaxCheckSummary(base, run) {
-    if (run == null)
-        return base;
-    if (run.outcome.ok)
-        return base;
-    const banner = run.mode === 'strict'
-        ? `\n\n[syntax-check FAILED via ${run.outcome.checker}]\n`
-        : `\n\n[syntax-check warning via ${run.outcome.checker}]\n`;
-    return `${base}${banner}${run.outcome.output}`;
+	if (run == null) return base;
+	if (run.outcome.ok) return base;
+	return `${base}${run.mode === "strict" ? `\n\n[syntax-check FAILED via ${run.outcome.checker}]\n` : `\n\n[syntax-check warning via ${run.outcome.checker}]\n`}${run.outcome.output}`;
 }
 /**
- * Revert a write_file/edit_file mutation in `postEditSyntaxCheck:
- * 'strict'` mode after the post-write syntax check failed. Strict
- * mode advertises a safety gate, so leaving the corrupted file on
- * disk + throwing is a half-broken contract — the model "reacts" to
- * the error but the next call sees broken on-disk state. Codex P2
- * [49]. Best-effort: a swallowed error here means the workspace is
- * still in the bad post-write state, but we still throw the
- * original syntax-check error so the caller knows.
- *
- * - If the file existed pre-write: restore the previous bytes with
- *   the original encoding.
- * - If the file is brand-new: unlink it.
- */
-async function revertStrictWrite(fs, path, existed, before, encoding) {
-    try {
-        if (existed) {
-            // encodeFile uses encoding.{hasBom,newline} to restore the
-            // on-disk shape; the `text` field is overridden by the
-            // explicit `before` arg we pass in.
-            await fs.writeFile(path, textEncoding.encodeFile(before, { ...encoding, text: before }), 'utf8');
-        }
-        else {
-            await fs.unlink(path);
-        }
-    }
-    catch {
-        /* best-effort: caller still sees the original syntax error */
-    }
+* Revert a write_file/edit_file mutation in `postEditSyntaxCheck:
+* 'strict'` mode after the post-write syntax check failed. Strict
+* mode advertises a safety gate, so leaving the corrupted file on
+* disk + throwing is a half-broken contract — the model "reacts" to
+* the error but the next call sees broken on-disk state. Codex P2
+* [49]. Best-effort: a swallowed error here means the workspace is
+* still in the bad post-write state, but we still throw the
+* original syntax-check error so the caller knows.
+*
+* - If the file existed pre-write: restore the previous bytes with
+*   the original encoding.
+* - If the file is brand-new: unlink it.
+*/
+async function revertStrictWrite(fs, path$2, existed, before, encoding) {
+	try {
+		if (existed) await fs.writeFile(path$2, require_textEncoding.encodeFile(before, {
+			...encoding,
+			text: before
+		}), "utf8");
+		else await fs.unlink(path$2);
+	} catch {}
 }
 function summariseDiff(filePath, before, after) {
-    if (before === after) {
-        return '(no textual changes)';
-    }
-    const name = path.basename(filePath);
-    const patch = diff.createTwoFilesPatch(name, name, before, after, '', '', {
-        context: 3,
-    });
-    if (patch.length <= MAX_DIFF_CHARS) {
-        return patch;
-    }
-    return (patch.slice(0, MAX_DIFF_CHARS) +
-        `\n[... diff truncated, ${patch.length - MAX_DIFF_CHARS} more chars ...]`);
+	if (before === after) return "(no textual changes)";
+	const name = (0, path.basename)(filePath);
+	const patch = (0, diff.createTwoFilesPatch)(name, name, before, after, "", "", { context: 3 });
+	if (patch.length <= MAX_DIFF_CHARS) return patch;
+	return patch.slice(0, MAX_DIFF_CHARS) + `\n[... diff truncated, ${patch.length - MAX_DIFF_CHARS} more chars ...]`;
 }
 function normalizeEdits(input) {
-    const edits = Array.isArray(input.edits)
-        ? input.edits.map((edit) => ({
-            oldText: edit.old_text ?? '',
-            newText: edit.new_text ?? '',
-        }))
-        : [];
-    if (input.old_text != null || input.new_text != null) {
-        edits.push({
-            oldText: input.old_text ?? '',
-            newText: input.new_text ?? '',
-        });
-    }
-    return edits;
+	const edits = Array.isArray(input.edits) ? input.edits.map((edit) => ({
+		oldText: edit.old_text ?? "",
+		newText: edit.new_text ?? ""
+	})) : [];
+	if (input.old_text != null || input.new_text != null) edits.push({
+		oldText: input.old_text ?? "",
+		newText: input.new_text ?? ""
+	});
+	return edits;
 }
 function toolDefinition(name, description, parameters) {
-    return {
-        name,
-        description,
-        parameters,
-        allowed_callers: ['direct', 'code_execution'],
-        responseFormat: _enum.Constants.CONTENT_AND_ARTIFACT,
-        toolType: 'builtin',
-    };
+	return {
+		name,
+		description,
+		parameters,
+		allowed_callers: ["direct", "code_execution"],
+		responseFormat: "content_and_artifact",
+		toolType: "builtin"
+	};
 }
-async function looksBinary(path, fs) {
-    let handle;
-    try {
-        handle = await fs.open(path, 'r');
-        const sample = Buffer.alloc(BINARY_DETECTION_BYTES);
-        const { bytesRead } = await handle.read(sample, 0, BINARY_DETECTION_BYTES, 0);
-        for (let i = 0; i < bytesRead; i++) {
-            if (sample[i] === 0) {
-                return true;
-            }
-        }
-        return false;
-    }
-    finally {
-        await handle?.close();
-    }
+async function looksBinary(path$3, fs) {
+	let handle;
+	try {
+		handle = await fs.open(path$3, "r");
+		const sample = Buffer.alloc(BINARY_DETECTION_BYTES);
+		const { bytesRead } = await handle.read(sample, 0, BINARY_DETECTION_BYTES, 0);
+		for (let i = 0; i < bytesRead; i++) if (sample[i] === 0) return true;
+		return false;
+	} finally {
+		await handle?.close();
+	}
 }
 const DEFAULT_MAX_ATTACHMENT_BYTES = 5 * 1024 * 1024;
 function createLocalReadFileTool(config = {}) {
-    const fs = LocalExecutionEngine.getWorkspaceFS(config);
-    return tools.tool(async (rawInput) => {
-        const input = rawInput;
-        const path = await LocalExecutionEngine.resolveWorkspacePathSafe(input.file_path, config, 'read');
-        const fileStat = await fs.stat(path);
-        if (!fileStat.isFile()) {
-            throw new Error(`Path is not a file: ${input.file_path}`);
-        }
-        const maxBytes = Math.max(config.maxReadBytes ?? DEFAULT_MAX_READ_BYTES, 1);
-        if (fileStat.size > maxBytes) {
-            const stub = `File is ${fileStat.size} bytes, exceeds the ${maxBytes}-byte read cap. Read a slice via bash (e.g. head/sed) or raise local.maxReadBytes.`;
-            return [stub, { path, bytes: fileStat.size, truncated: true }];
-        }
-        if (await looksBinary(path, fs)) {
-            const attachmentMode = config.attachReadAttachments ?? 'off';
-            if (attachmentMode !== 'off') {
-                const attachment = await attachments.classifyAttachment({
-                    path,
-                    bytes: fileStat.size,
-                    mode: attachmentMode,
-                    maxBytes: config.maxAttachmentBytes ?? DEFAULT_MAX_ATTACHMENT_BYTES,
-                    // Route through the configured WorkspaceFS so a custom
-                    // engine sees the same path semantics as `read_file`
-                    // itself (manual review finding F).
-                    fs,
-                });
-                if (attachment.kind === 'image') {
-                    return [
-                        attachments.imageAttachmentContent(path, attachment),
-                        {
-                            path,
-                            bytes: fileStat.size,
-                            mime: attachment.mime,
-                            attachment: 'image',
-                        },
-                    ];
-                }
-                if (attachment.kind === 'pdf') {
-                    return [
-                        [
-                            {
-                                type: 'text',
-                                text: `Read ${path} (application/pdf, ${fileStat.size} bytes). PDF attached as base64 data URL; vision-capable models that accept PDF will render it.`,
-                            },
-                            {
-                                type: 'image_url',
-                                image_url: { url: attachment.dataUrl },
-                            },
-                        ],
-                        {
-                            path,
-                            bytes: fileStat.size,
-                            mime: attachment.mime,
-                            attachment: 'pdf',
-                        },
-                    ];
-                }
-                if (attachment.kind === 'oversize') {
-                    return [
-                        `Refusing to embed ${attachment.mime} attachment (${attachment.bytes} bytes exceeds ${attachment.maxBytes}-byte cap).`,
-                        {
-                            path,
-                            bytes: fileStat.size,
-                            mime: attachment.mime,
-                            attachment: 'oversize',
-                        },
-                    ];
-                }
-                if (attachment.kind === 'binary') {
-                    return [
-                        `Refusing to read binary file (${fileStat.size} bytes, ${attachment.mime}): ${path}`,
-                        {
-                            path,
-                            bytes: fileStat.size,
-                            mime: attachment.mime,
-                            binary: true,
-                        },
-                    ];
-                }
-                // text-or-unknown falls through to the text-read path below.
-            }
-            else {
-                return [
-                    `Refusing to read binary file (${fileStat.size} bytes): ${path}`,
-                    { path, bytes: fileStat.size, binary: true },
-                ];
-            }
-        }
-        const content = await fs.readFile(path, 'utf8');
-        const result = lineWindow(content, input.offset, input.limit);
-        return [
-            result.truncated ? `${result.text}\n[truncated]` : result.text,
-            { path, bytes: fileStat.size },
-        ];
-    }, {
-        name: _enum.Constants.READ_FILE,
-        description: 'Read a local text file from the configured working directory with line numbers. ' +
-            'When `attachReadAttachments` is enabled (e.g. images-only), reading an image returns an ' +
-            '`image_url` content block so vision-capable models can see the file directly.',
-        schema: LocalReadFileToolSchema,
-        responseFormat: _enum.Constants.CONTENT_AND_ARTIFACT,
-    });
+	const fs = require_LocalExecutionEngine.getWorkspaceFS(config);
+	return (0, _langchain_core_tools.tool)(async (rawInput) => {
+		const input = rawInput;
+		const path$4 = await require_LocalExecutionEngine.resolveWorkspacePathSafe(input.file_path, config, "read");
+		const fileStat = await fs.stat(path$4);
+		if (!fileStat.isFile()) throw new Error(`Path is not a file: ${input.file_path}`);
+		const maxBytes = Math.max(config.maxReadBytes ?? DEFAULT_MAX_READ_BYTES, 1);
+		if (fileStat.size > maxBytes) return [`File is ${fileStat.size} bytes, exceeds the ${maxBytes}-byte read cap. Read a slice via bash (e.g. head/sed) or raise local.maxReadBytes.`, {
+			path: path$4,
+			bytes: fileStat.size,
+			truncated: true
+		}];
+		if (await looksBinary(path$4, fs)) {
+			const attachmentMode = config.attachReadAttachments ?? "off";
+			if (attachmentMode !== "off") {
+				const attachment = await require_attachments.classifyAttachment({
+					path: path$4,
+					bytes: fileStat.size,
+					mode: attachmentMode,
+					maxBytes: config.maxAttachmentBytes ?? DEFAULT_MAX_ATTACHMENT_BYTES,
+					fs
+				});
+				if (attachment.kind === "image") return [require_attachments.imageAttachmentContent(path$4, attachment), {
+					path: path$4,
+					bytes: fileStat.size,
+					mime: attachment.mime,
+					attachment: "image"
+				}];
+				if (attachment.kind === "pdf") return [[{
+					type: "text",
+					text: `Read ${path$4} (application/pdf, ${fileStat.size} bytes). PDF attached as base64 data URL; vision-capable models that accept PDF will render it.`
+				}, {
+					type: "image_url",
+					image_url: { url: attachment.dataUrl }
+				}], {
+					path: path$4,
+					bytes: fileStat.size,
+					mime: attachment.mime,
+					attachment: "pdf"
+				}];
+				if (attachment.kind === "oversize") return [`Refusing to embed ${attachment.mime} attachment (${attachment.bytes} bytes exceeds ${attachment.maxBytes}-byte cap).`, {
+					path: path$4,
+					bytes: fileStat.size,
+					mime: attachment.mime,
+					attachment: "oversize"
+				}];
+				if (attachment.kind === "binary") return [`Refusing to read binary file (${fileStat.size} bytes, ${attachment.mime}): ${path$4}`, {
+					path: path$4,
+					bytes: fileStat.size,
+					mime: attachment.mime,
+					binary: true
+				}];
+			} else return [`Refusing to read binary file (${fileStat.size} bytes): ${path$4}`, {
+				path: path$4,
+				bytes: fileStat.size,
+				binary: true
+			}];
+		}
+		const result = lineWindow(await fs.readFile(path$4, "utf8"), input.offset, input.limit);
+		return [result.truncated ? `${result.text}\n[truncated]` : result.text, {
+			path: path$4,
+			bytes: fileStat.size
+		}];
+	}, {
+		name: "read_file",
+		description: "Read a local text file from the configured working directory with line numbers. When `attachReadAttachments` is enabled (e.g. images-only), reading an image returns an `image_url` content block so vision-capable models can see the file directly.",
+		schema: LocalReadFileToolSchema,
+		responseFormat: "content_and_artifact"
+	});
 }
 function createLocalWriteFileTool(config = {}, checkpointer) {
-    const fs = LocalExecutionEngine.getWorkspaceFS(config);
-    return tools.tool(async (rawInput) => {
-        const input = rawInput;
-        if (config.readOnly === true) {
-            throw new Error('write_file is blocked in read-only local mode.');
-        }
-        const path$1 = await LocalExecutionEngine.resolveWorkspacePathSafe(input.file_path, config, 'write');
-        if (checkpointer != null) {
-            await checkpointer.captureBeforeWrite(path$1);
-        }
-        let before = '';
-        let encoding = { text: '', hasBom: false, newline: '\n' };
-        let existed = false;
-        try {
-            const raw = await fs.readFile(path$1, 'utf8');
-            const decoded = textEncoding.decodeFile(raw);
-            before = decoded.text;
-            encoding = decoded;
-            existed = true;
-        }
-        catch {
-            existed = false;
-        }
-        await fs.mkdir(path.dirname(path$1), { recursive: true });
-        const finalText = textEncoding.encodeFile(input.content, encoding);
-        await fs.writeFile(path$1, finalText, 'utf8');
-        const syntax = await maybeRunSyntaxCheck(path$1, config);
-        const diff = existed
-            ? summariseDiff(path$1, before, input.content)
-            : `(new file, ${input.content.length} chars)`;
-        const baseSummary = existed
-            ? `Overwrote ${path$1} (${input.content.length} chars). Diff:\n${diff}`
-            : `Created ${path$1} (${input.content.length} chars).`;
-        const summary = appendSyntaxCheckSummary(baseSummary, syntax);
-        if (syntax?.outcome.ok === false && syntax.mode === 'strict') {
-            // Roll back the write so strict mode is an actual gate, not
-            // "fail the call AND leave the corrupted file on disk".
-            // Codex P2 [49].
-            await revertStrictWrite(fs, path$1, existed, before, encoding);
-            throw new Error(`write_file syntax check failed (${syntax.outcome.checker}); reverted to pre-write state.\n${syntax.outcome.output}`);
-        }
-        return [
-            summary,
-            {
-                path: path$1,
-                bytes: finalText.length,
-                new_file: !existed,
-                newline: encoding.newline === '\r\n' ? 'CRLF' : 'LF',
-                had_bom: encoding.hasBom,
-                ...(syntax != null && syntax.outcome.ok === false
-                    ? { syntax_error: syntax.outcome.checker }
-                    : {}),
-            },
-        ];
-    }, {
-        name: LocalWriteFileToolName,
-        description: 'Create or overwrite a local text file in the configured working directory. ' +
-            'Preserves the existing BOM and line endings when overwriting; defaults to LF without BOM for new files. ' +
-            'Returns a unified diff of the changes when overwriting.',
-        schema: LocalWriteFileToolSchema,
-        responseFormat: _enum.Constants.CONTENT_AND_ARTIFACT,
-    });
+	const fs = require_LocalExecutionEngine.getWorkspaceFS(config);
+	return (0, _langchain_core_tools.tool)(async (rawInput) => {
+		const input = rawInput;
+		if (config.readOnly === true) throw new Error("write_file is blocked in read-only local mode.");
+		const path$5 = await require_LocalExecutionEngine.resolveWorkspacePathSafe(input.file_path, config, "write");
+		if (checkpointer != null) await checkpointer.captureBeforeWrite(path$5);
+		let before = "";
+		let encoding = {
+			text: "",
+			hasBom: false,
+			newline: "\n"
+		};
+		let existed = false;
+		try {
+			const decoded = require_textEncoding.decodeFile(await fs.readFile(path$5, "utf8"));
+			before = decoded.text;
+			encoding = decoded;
+			existed = true;
+		} catch {
+			existed = false;
+		}
+		await fs.mkdir((0, path.dirname)(path$5), { recursive: true });
+		const finalText = require_textEncoding.encodeFile(input.content, encoding);
+		await fs.writeFile(path$5, finalText, "utf8");
+		const syntax = await maybeRunSyntaxCheck(path$5, config);
+		const diff$1 = existed ? summariseDiff(path$5, before, input.content) : `(new file, ${input.content.length} chars)`;
+		const summary = appendSyntaxCheckSummary(existed ? `Overwrote ${path$5} (${input.content.length} chars). Diff:\n${diff$1}` : `Created ${path$5} (${input.content.length} chars).`, syntax);
+		if (syntax?.outcome.ok === false && syntax.mode === "strict") {
+			await revertStrictWrite(fs, path$5, existed, before, encoding);
+			throw new Error(`write_file syntax check failed (${syntax.outcome.checker}); reverted to pre-write state.\n${syntax.outcome.output}`);
+		}
+		return [summary, {
+			path: path$5,
+			bytes: finalText.length,
+			new_file: !existed,
+			newline: encoding.newline === "\r\n" ? "CRLF" : "LF",
+			had_bom: encoding.hasBom,
+			...syntax != null && syntax.outcome.ok === false ? { syntax_error: syntax.outcome.checker } : {}
+		}];
+	}, {
+		name: LocalWriteFileToolName,
+		description: "Create or overwrite a local text file in the configured working directory. Preserves the existing BOM and line endings when overwriting; defaults to LF without BOM for new files. Returns a unified diff of the changes when overwriting.",
+		schema: LocalWriteFileToolSchema,
+		responseFormat: "content_and_artifact"
+	});
 }
 function createLocalEditFileTool(config = {}, checkpointer) {
-    const fs = LocalExecutionEngine.getWorkspaceFS(config);
-    return tools.tool(async (rawInput) => {
-        const input = rawInput;
-        if (config.readOnly === true) {
-            throw new Error('edit_file is blocked in read-only local mode.');
-        }
-        const edits = normalizeEdits(input);
-        if (edits.length === 0) {
-            throw new Error('edit_file requires old_text/new_text or edits[].');
-        }
-        const path = await LocalExecutionEngine.resolveWorkspacePathSafe(input.file_path, config, 'write');
-        const raw = await fs.readFile(path, 'utf8');
-        const encoding = textEncoding.decodeFile(raw);
-        const original = encoding.text;
-        let next = original;
-        const strategiesUsed = [];
-        for (let i = 0; i < edits.length; i++) {
-            const edit = edits[i];
-            const match = editStrategies.locateEdit(next, edit.oldText);
-            if (match == null) {
-                throw new Error(`Edit ${i + 1}/${edits.length}: could not locate old_text in ${input.file_path}. ` +
-                    'Tried exact, line-trimmed, whitespace-normalized, and indentation-flexible matching. ' +
-                    'Re-read the file and copy the literal lines.');
-            }
-            strategiesUsed.push(match.strategy);
-            next = editStrategies.applyEdit(next, match, edit.newText);
-        }
-        if (checkpointer != null) {
-            await checkpointer.captureBeforeWrite(path);
-        }
-        const finalText = textEncoding.encodeFile(next, encoding);
-        await fs.writeFile(path, finalText, 'utf8');
-        const syntax = await maybeRunSyntaxCheck(path, config);
-        const diff = summariseDiff(path, original, next);
-        const fuzzy = strategiesUsed.some((s) => s !== 'exact');
-        const baseSummary = `Applied ${edits.length} edit(s) to ${path}` +
-            (fuzzy ? ` (strategies: ${strategiesUsed.join(', ')})` : '') +
-            `. Diff:\n${diff}`;
-        const summary = appendSyntaxCheckSummary(baseSummary, syntax);
-        if (syntax?.outcome.ok === false && syntax.mode === 'strict') {
-            // Restore the pre-edit bytes so strict mode is an actual
-            // gate (Codex P2 [49]). edit_file always operates on an
-            // existing file, so `existed = true` here.
-            await revertStrictWrite(fs, path, true, original, encoding);
-            throw new Error(`edit_file syntax check failed (${syntax.outcome.checker}); reverted to pre-edit state.\n${syntax.outcome.output}`);
-        }
-        return [
-            summary,
-            {
-                path,
-                edits: edits.length,
-                strategies: strategiesUsed,
-                newline: encoding.newline === '\r\n' ? 'CRLF' : 'LF',
-                had_bom: encoding.hasBom,
-                ...(syntax != null && syntax.outcome.ok === false
-                    ? { syntax_error: syntax.outcome.checker }
-                    : {}),
-            },
-        ];
-    }, {
-        name: LocalEditFileToolName,
-        description: 'Apply exact text replacements to a local file. The matcher tries exact, line-trimmed, whitespace-normalized, and indentation-flexible strategies in order so common LLM whitespace mistakes are recoverable. Each old_text must still match exactly one location. Returns a unified diff of the changes.',
-        schema: LocalEditFileToolSchema,
-        responseFormat: _enum.Constants.CONTENT_AND_ARTIFACT,
-    });
+	const fs = require_LocalExecutionEngine.getWorkspaceFS(config);
+	return (0, _langchain_core_tools.tool)(async (rawInput) => {
+		const input = rawInput;
+		if (config.readOnly === true) throw new Error("edit_file is blocked in read-only local mode.");
+		const edits = normalizeEdits(input);
+		if (edits.length === 0) throw new Error("edit_file requires old_text/new_text or edits[].");
+		const path$6 = await require_LocalExecutionEngine.resolveWorkspacePathSafe(input.file_path, config, "write");
+		const encoding = require_textEncoding.decodeFile(await fs.readFile(path$6, "utf8"));
+		const original = encoding.text;
+		let next = original;
+		const strategiesUsed = [];
+		for (let i = 0; i < edits.length; i++) {
+			const edit = edits[i];
+			const match = require_editStrategies.locateEdit(next, edit.oldText);
+			if (match == null) throw new Error(`Edit ${i + 1}/${edits.length}: could not locate old_text in ${input.file_path}. Tried exact, line-trimmed, whitespace-normalized, and indentation-flexible matching. Re-read the file and copy the literal lines.`);
+			strategiesUsed.push(match.strategy);
+			next = require_editStrategies.applyEdit(next, match, edit.newText);
+		}
+		if (checkpointer != null) await checkpointer.captureBeforeWrite(path$6);
+		const finalText = require_textEncoding.encodeFile(next, encoding);
+		await fs.writeFile(path$6, finalText, "utf8");
+		const syntax = await maybeRunSyntaxCheck(path$6, config);
+		const diff$2 = summariseDiff(path$6, original, next);
+		const fuzzy = strategiesUsed.some((s) => s !== "exact");
+		const summary = appendSyntaxCheckSummary(`Applied ${edits.length} edit(s) to ${path$6}` + (fuzzy ? ` (strategies: ${strategiesUsed.join(", ")})` : "") + `. Diff:\n${diff$2}`, syntax);
+		if (syntax?.outcome.ok === false && syntax.mode === "strict") {
+			await revertStrictWrite(fs, path$6, true, original, encoding);
+			throw new Error(`edit_file syntax check failed (${syntax.outcome.checker}); reverted to pre-edit state.\n${syntax.outcome.output}`);
+		}
+		return [summary, {
+			path: path$6,
+			edits: edits.length,
+			strategies: strategiesUsed,
+			newline: encoding.newline === "\r\n" ? "CRLF" : "LF",
+			had_bom: encoding.hasBom,
+			...syntax != null && syntax.outcome.ok === false ? { syntax_error: syntax.outcome.checker } : {}
+		}];
+	}, {
+		name: LocalEditFileToolName,
+		description: "Apply exact text replacements to a local file. The matcher tries exact, line-trimmed, whitespace-normalized, and indentation-flexible strategies in order so common LLM whitespace mistakes are recoverable. Each old_text must still match exactly one location. Returns a unified diff of the changes.",
+		schema: LocalEditFileToolSchema,
+		responseFormat: "content_and_artifact"
+	});
 }
 /**
- * Ripgrep availability cache, keyed on the *effective execution
- * backend* — whatever function `getSpawn(config)` returns. Without
- * the backend key, a Run that probes `rg` over Node's
- * `child_process.spawn` would poison subsequent Runs whose
- * `local.exec.spawn` routes to a remote sandbox or container that
- * doesn't have rg installed: the cached `true` would skip the probe,
- * the rg invocation would throw, and the Node fallback wouldn't be
- * reached. Per-backend caching avoids that without paying for a
- * spawn-per-search.
- */
-// Per-backend × per-env cache. Codex P1 #34 — keying by spawn
-// backend alone misses the case where two Runs share a backend but
-// vary `local.env` (especially PATH). Stale cache then claims `rg`
-// is available, the rg path runs, and the spawn fails with ENOENT
-// instead of falling back to the Node walker. The inner Map is
-// keyed by a stable JSON hash of the effective env so each unique
-// env gets its own probe.
-let ripgrepAvailabilityByBackend = new WeakMap();
+* Ripgrep availability cache, keyed on the *effective execution
+* backend* — whatever function `getSpawn(config)` returns. Without
+* the backend key, a Run that probes `rg` over Node's
+* `child_process.spawn` would poison subsequent Runs whose
+* `local.exec.spawn` routes to a remote sandbox or container that
+* doesn't have rg installed: the cached `true` would skip the probe,
+* the rg invocation would throw, and the Node fallback wouldn't be
+* reached. Per-backend caching avoids that without paying for a
+* spawn-per-search.
+*/
+let ripgrepAvailabilityByBackend = /* @__PURE__ */ new WeakMap();
 function envCacheKey(env) {
-    // PATH is the only env entry that affects command lookup, but
-    // hashing the whole env keeps the key correct for hosts that
-    // vary anything else relevant. Stable JSON via sorted keys so
-    // {A:1,B:2} and {B:2,A:1} produce the same hash.
-    if (env == null)
-        return '';
-    const sorted = {};
-    for (const k of Object.keys(env).sort()) {
-        sorted[k] = env[k];
-    }
-    return JSON.stringify(sorted);
+	if (env == null) return "";
+	const sorted = {};
+	for (const k of Object.keys(env).sort()) sorted[k] = env[k];
+	return JSON.stringify(sorted);
 }
 async function isRipgrepAvailable(config) {
-    const backend = LocalExecutionEngine.getSpawn(config);
-    let envMap = ripgrepAvailabilityByBackend.get(backend);
-    if (envMap == null) {
-        envMap = new Map();
-        ripgrepAvailabilityByBackend.set(backend, envMap);
-    }
-    const envKey = envCacheKey(config.env);
-    let probePromise = envMap.get(envKey);
-    if (probePromise == null) {
-        probePromise = LocalExecutionEngine.spawnLocalProcess('rg', ['--version'], { ...config, timeoutMs: 5000, sandbox: { enabled: false } }, { internal: true })
-            .then((probe) => probe.exitCode === 0)
-            .catch(() => false);
-        envMap.set(envKey, probePromise);
-    }
-    return probePromise;
+	const backend = require_LocalExecutionEngine.getSpawn(config);
+	let envMap = ripgrepAvailabilityByBackend.get(backend);
+	if (envMap == null) {
+		envMap = /* @__PURE__ */ new Map();
+		ripgrepAvailabilityByBackend.set(backend, envMap);
+	}
+	const envKey = envCacheKey(config.env);
+	let probePromise = envMap.get(envKey);
+	if (probePromise == null) {
+		probePromise = require_LocalExecutionEngine.spawnLocalProcess("rg", ["--version"], {
+			...config,
+			timeoutMs: 5e3,
+			sandbox: { enabled: false }
+		}, { internal: true }).then((probe) => probe.exitCode === 0).catch(() => false);
+		envMap.set(envKey, probePromise);
+	}
+	return probePromise;
 }
 /**
- * Test-only reset hook. Clears the ripgrep-availability cache so
- * tests can swap in mocked spawn backends and reprobe deterministically.
- *
- * @internal Not part of the public SDK surface; the leading underscore
- *   and `@internal` tag together signal that consumers should not call
- *   this. Tests import it via the module path directly.
- */
+* Test-only reset hook. Clears the ripgrep-availability cache so
+* tests can swap in mocked spawn backends and reprobe deterministically.
+*
+* @internal Not part of the public SDK surface; the leading underscore
+*   and `@internal` tag together signal that consumers should not call
+*   this. Tests import it via the module path directly.
+*/
 function _resetRipgrepCacheForTests() {
-    ripgrepAvailabilityByBackend = new WeakMap();
+	ripgrepAvailabilityByBackend = /* @__PURE__ */ new WeakMap();
 }
-// Skipped by the Node-fallback walker (used when ripgrep is
-// unavailable). Covers common build outputs, virtualenvs, and
-// caches so a `grep_search`/`glob_search` on a large monorepo or a
-// Python project with `.venv/` doesn't read every file under those
-// trees. ripgrep itself respects .gitignore so it doesn't need this
-// list. Audit follow-up from the comprehensive review (finding #3).
 const SKIP_DIRS = new Set([
-    '.git',
-    '.svn',
-    '.hg',
-    'node_modules',
-    '.next',
-    '.nuxt',
-    '.cache',
-    '.parcel-cache',
-    '.turbo',
-    'dist',
-    'build',
-    'out',
-    'target',
-    'vendor',
-    'coverage',
-    '.nyc_output',
-    '__pycache__',
-    '.venv',
-    'venv',
-    'env',
-    '.tox',
-    '.mypy_cache',
-    '.pytest_cache',
-    '.ruff_cache',
+	".git",
+	".svn",
+	".hg",
+	"node_modules",
+	".next",
+	".nuxt",
+	".cache",
+	".parcel-cache",
+	".turbo",
+	"dist",
+	"build",
+	"out",
+	"target",
+	"vendor",
+	"coverage",
+	".nyc_output",
+	"__pycache__",
+	".venv",
+	"venv",
+	"env",
+	".tox",
+	".mypy_cache",
+	".pytest_cache",
+	".ruff_cache"
 ]);
 function globToRegExp(pattern) {
-    let result = '^';
-    for (let i = 0; i < pattern.length; i++) {
-        const c = pattern[i];
-        if (c === '*') {
-            if (pattern[i + 1] === '*') {
-                result += '.*';
-                i += 1;
-                if (pattern[i + 1] === '/') {
-                    i += 1;
-                }
-            }
-            else {
-                result += '[^/]*';
-            }
-        }
-        else if (c === '?') {
-            result += '[^/]';
-        }
-        else if ('.+^$|(){}[]\\'.includes(c)) {
-            result += '\\' + c;
-        }
-        else {
-            result += c;
-        }
-    }
-    result += '$';
-    return new RegExp(result);
+	let result = "^";
+	for (let i = 0; i < pattern.length; i++) {
+		const c = pattern[i];
+		if (c === "*") if (pattern[i + 1] === "*") {
+			result += ".*";
+			i += 1;
+			if (pattern[i + 1] === "/") i += 1;
+		} else result += "[^/]*";
+		else if (c === "?") result += "[^/]";
+		else if (".+^$|(){}[]\\".includes(c)) result += "\\" + c;
+		else result += c;
+	}
+	result += "$";
+	return new RegExp(result);
 }
 async function* walkFiles(root, fs) {
-    const stack = [root];
-    while (stack.length > 0) {
-        const dir = stack.pop();
-        let entries;
-        try {
-            entries = await fs.readdir(dir, { withFileTypes: true });
-        }
-        catch {
-            continue;
-        }
-        for (const entry of entries) {
-            if (entry.name.startsWith('.git') || SKIP_DIRS.has(entry.name)) {
-                continue;
-            }
-            const full = `${dir}/${entry.name}`;
-            if (entry.isDirectory()) {
-                stack.push(full);
-            }
-            else if (entry.isFile()) {
-                yield full;
-            }
-        }
-    }
+	const stack = [root];
+	while (stack.length > 0) {
+		const dir = stack.pop();
+		let entries;
+		try {
+			entries = await fs.readdir(dir, { withFileTypes: true });
+		} catch {
+			continue;
+		}
+		for (const entry of entries) {
+			if (entry.name.startsWith(".git") || SKIP_DIRS.has(entry.name)) continue;
+			const full = `${dir}/${entry.name}`;
+			if (entry.isDirectory()) stack.push(full);
+			else if (entry.isFile()) yield full;
+		}
+	}
 }
 /**
- * Catastrophic-backtracking guardrails for the fallback grep path.
- *
- * Without ripgrep we run the model-supplied pattern through Node's
- * `RegExp` engine, which uses a backtracking implementation. Patterns
- * with nested unbounded quantifiers (`(a+)+`, `(.*)*`, etc.) can
- * monopolise the event loop for arbitrary wall-clock time on
- * pathological input, and `setTimeout` cannot interrupt a synchronous
- * `RegExp.exec`. Manual review (finding D) flagged this as a real DoS.
- *
- * Mitigations applied here, in order of severity:
- *   1. Cap pattern length so an obviously oversize regex is rejected
- *      before compile.
- *   2. Reject patterns that contain a nested unbounded quantifier of
- *      the form `(...+|*)([+*]|{n,})` — the standard pathological
- *      shape. Still a heuristic (not a full safety proof), but blocks
- *      every common DoS construction we've seen in coding-agent logs.
- *   3. Wall-clock budget for the overall search: each file's regex
- *      pass is checked against a deadline; once exceeded the search
- *      bails with a partial result. Doesn't interrupt a stuck
- *      `exec()` call, but stops a slow pattern from making the whole
- *      Run hang once the first hung file finishes.
- *
- * Hosts that need bulletproof regex safety should install `rg` —
- * ripgrep uses RE2 internally and has no backtracking.
- */
+* Catastrophic-backtracking guardrails for the fallback grep path.
+*
+* Without ripgrep we run the model-supplied pattern through Node's
+* `RegExp` engine, which uses a backtracking implementation. Patterns
+* with nested unbounded quantifiers (`(a+)+`, `(.*)*`, etc.) can
+* monopolise the event loop for arbitrary wall-clock time on
+* pathological input, and `setTimeout` cannot interrupt a synchronous
+* `RegExp.exec`. Manual review (finding D) flagged this as a real DoS.
+*
+* Mitigations applied here, in order of severity:
+*   1. Cap pattern length so an obviously oversize regex is rejected
+*      before compile.
+*   2. Reject patterns that contain a nested unbounded quantifier of
+*      the form `(...+|*)([+*]|{n,})` — the standard pathological
+*      shape. Still a heuristic (not a full safety proof), but blocks
+*      every common DoS construction we've seen in coding-agent logs.
+*   3. Wall-clock budget for the overall search: each file's regex
+*      pass is checked against a deadline; once exceeded the search
+*      bails with a partial result. Doesn't interrupt a stuck
+*      `exec()` call, but stops a slow pattern from making the whole
+*      Run hang once the first hung file finishes.
+*
+* Hosts that need bulletproof regex safety should install `rg` —
+* ripgrep uses RE2 internally and has no backtracking.
+*/
 const MAX_FALLBACK_PATTERN_LENGTH = 1024;
-const FALLBACK_GREP_BUDGET_MS = 5000;
-// Per-file byte cap. Codex P2 #41 — without it, the whole-file
-// `readFile` + `split('\n')` for a multi-GB log is an unbounded
-// allocation that the wall-clock budget (checked between files)
-// can't interrupt. Hosts that need to grep large files should
-// install ripgrep.
+const FALLBACK_GREP_BUDGET_MS = 5e3;
 const FALLBACK_GREP_MAX_FILE_BYTES = 5 * 1024 * 1024;
 /**
- * Heuristic: walks `pattern` to find any `(<contents>)<quant>` where
- * `<contents>` itself has an unbounded quantifier. Catches the
- * classic `(a+)+` form AND the double-nested `((a+)+)` form (which a
- * single-pass regex misses because `[^)]*` stops at the first inner
- * close-paren). Misses sufficiently obfuscated cases — bulletproof
- * ReDoS detection requires a real parser. The 5 s wall-clock budget
- * is the hard backstop for anything this slip past.
- */
+* Heuristic: walks `pattern` to find any `(<contents>)<quant>` where
+* `<contents>` itself has an unbounded quantifier. Catches the
+* classic `(a+)+` form AND the double-nested `((a+)+)` form (which a
+* single-pass regex misses because `[^)]*` stops at the first inner
+* close-paren). Misses sufficiently obfuscated cases — bulletproof
+* ReDoS detection requires a real parser. The 5 s wall-clock budget
+* is the hard backstop for anything this slip past.
+*/
 function hasNestedUnboundedQuantifier(pattern) {
-    for (let i = 1; i < pattern.length - 1; i++) {
-        if (pattern[i] !== ')')
-            continue;
-        if (pattern[i - 1] === '\\')
-            continue;
-        const next = pattern[i + 1];
-        if (next !== '+' && next !== '*' && next !== '{')
-            continue;
-        // Walk back to find the matching opening paren (respecting depth
-        // and `\(` escapes).
-        let depth = 1;
-        let j = i - 1;
-        while (j >= 0) {
-            const c = pattern[j];
-            const escaped = j > 0 && pattern[j - 1] === '\\';
-            if (!escaped) {
-                if (c === ')')
-                    depth++;
-                else if (c === '(') {
-                    depth--;
-                    if (depth === 0)
-                        break;
-                }
-            }
-            j--;
-        }
-        if (j < 0)
-            continue;
-        const inner = pattern.slice(j + 1, i);
-        if (/(?<!\\)[+*]/.test(inner))
-            return true;
-    }
-    return false;
-}
-class FallbackGrepError extends Error {
-    kind;
-    constructor(kind, message) {
-        super(message);
-        this.kind = kind;
-    }
+	for (let i = 1; i < pattern.length - 1; i++) {
+		if (pattern[i] !== ")") continue;
+		if (pattern[i - 1] === "\\") continue;
+		const next = pattern[i + 1];
+		if (next !== "+" && next !== "*" && next !== "{") continue;
+		let depth = 1;
+		let j = i - 1;
+		while (j >= 0) {
+			const c = pattern[j];
+			if (!(j > 0 && pattern[j - 1] === "\\")) {
+				if (c === ")") depth++;
+				else if (c === "(") {
+					depth--;
+					if (depth === 0) break;
+				}
+			}
+			j--;
+		}
+		if (j < 0) continue;
+		const inner = pattern.slice(j + 1, i);
+		if (/(?<!\\)[+*]/.test(inner)) return true;
+	}
+	return false;
 }
+var FallbackGrepError = class extends Error {
+	kind;
+	constructor(kind, message) {
+		super(message);
+		this.kind = kind;
+	}
+};
 function compileFallbackRegex(pattern) {
-    if (pattern.length > MAX_FALLBACK_PATTERN_LENGTH) {
-        throw new FallbackGrepError('pattern-too-long', `Pattern exceeds ${MAX_FALLBACK_PATTERN_LENGTH}-char fallback cap (install ripgrep for unbounded patterns).`);
-    }
-    if (hasNestedUnboundedQuantifier(pattern)) {
-        throw new FallbackGrepError('unsafe-pattern', 'Pattern contains a nested unbounded quantifier (e.g. `(a+)+` or `((a+)+)`) which can cause catastrophic backtracking in the Node fallback. Install ripgrep for RE2-safe matching.');
-    }
-    try {
-        return new RegExp(pattern);
-    }
-    catch (e) {
-        throw new FallbackGrepError('invalid-pattern', `Invalid regex: ${e.message}`);
-    }
+	if (pattern.length > MAX_FALLBACK_PATTERN_LENGTH) throw new FallbackGrepError("pattern-too-long", `Pattern exceeds ${MAX_FALLBACK_PATTERN_LENGTH}-char fallback cap (install ripgrep for unbounded patterns).`);
+	if (hasNestedUnboundedQuantifier(pattern)) throw new FallbackGrepError("unsafe-pattern", "Pattern contains a nested unbounded quantifier (e.g. `(a+)+` or `((a+)+)`) which can cause catastrophic backtracking in the Node fallback. Install ripgrep for RE2-safe matching.");
+	try {
+		return new RegExp(pattern);
+	} catch (e) {
+		throw new FallbackGrepError("invalid-pattern", `Invalid regex: ${e.message}`);
+	}
 }
 /** Renders fallback-grep output: real matches first, skip diagnostics appended. */
 function formatFallbackGrepDisplay(result) {
-    if (result.matches.length > 0) {
-        return [...result.matches, ...result.skipped].join('\n');
-    }
-    if (result.skipped.length > 0) {
-        return result.skipped.join('\n');
-    }
-    return 'No matches found.';
+	if (result.matches.length > 0) return [...result.matches, ...result.skipped].join("\n");
+	if (result.skipped.length > 0) return result.skipped.join("\n");
+	return "No matches found.";
 }
 async function fallbackGrep(root, pattern, globFilter, maxResults, fs) {
-    const rx = compileFallbackRegex(pattern);
-    const deadline = Date.now() + FALLBACK_GREP_BUDGET_MS;
-    const globRx = globFilter != null && globFilter !== ''
-        ? globToRegExp(globFilter)
-        : undefined;
-    const matches = [];
-    // Track skipped (oversize) files separately so they don't consume
-    // the maxResults budget. Codex P2 [43]: round 14's fix pushed skip
-    // sentinels into `matches`, so a directory of one oversize non-
-    // matching file falsely reported `matches: 1`, and enough
-    // oversize files could fill the budget before any real match was
-    // scanned. Now diagnostics are appended after real matches and
-    // independent of the budget.
-    const skippedDiagnostics = [];
-    for await (const file of walkFiles(root, fs)) {
-        if (Date.now() > deadline) {
-            // Wall-clock budget exceeded — return partial results rather
-            // than letting a slow pattern hang the Run.
-            return { matches, skipped: skippedDiagnostics };
-        }
-        if (globRx != null) {
-            const rel = file.startsWith(root + '/')
-                ? file.slice(root.length + 1)
-                : file;
-            if (!globRx.test(rel)) {
-                continue;
-            }
-        }
-        // Skip files larger than the per-file cap and remember them as
-        // diagnostics (NOT as matches). Codex P2 [41]: pre-fix
-        // `fs.readFile` then `.split('\n')` allocated the whole file +
-        // an array of every line, which a single multi-GB log could
-        // turn into an OOM even after the regex DoS guards.
-        let stat;
-        try {
-            stat = await fs.stat(file);
-        }
-        catch {
-            continue;
-        }
-        if (stat.size > FALLBACK_GREP_MAX_FILE_BYTES) {
-            skippedDiagnostics.push(`${file}:0:[skipped: file > ${FALLBACK_GREP_MAX_FILE_BYTES} bytes; install ripgrep for unbounded grep]`);
-            continue;
-        }
-        let content;
-        try {
-            content = await fs.readFile(file, 'utf8');
-        }
-        catch {
-            continue;
-        }
-        if (content.includes('\0')) {
-            continue;
-        }
-        // Re-check the deadline AFTER the read — a slow disk on one
-        // file can blow the budget without us noticing.
-        if (Date.now() > deadline) {
-            return { matches, skipped: skippedDiagnostics };
-        }
-        const lines = content.split('\n');
-        for (let i = 0; i < lines.length; i++) {
-            if (rx.test(lines[i])) {
-                matches.push(`${file}:${i + 1}:${lines[i]}`);
-                if (matches.length >= maxResults) {
-                    return { matches, skipped: skippedDiagnostics };
-                }
-            }
-        }
-    }
-    return { matches, skipped: skippedDiagnostics };
+	const rx = compileFallbackRegex(pattern);
+	const deadline = Date.now() + FALLBACK_GREP_BUDGET_MS;
+	const globRx = globFilter != null && globFilter !== "" ? globToRegExp(globFilter) : void 0;
+	const matches = [];
+	const skippedDiagnostics = [];
+	for await (const file of walkFiles(root, fs)) {
+		if (Date.now() > deadline) return {
+			matches,
+			skipped: skippedDiagnostics
+		};
+		if (globRx != null) {
+			const rel = file.startsWith(root + "/") ? file.slice(root.length + 1) : file;
+			if (!globRx.test(rel)) continue;
+		}
+		let stat;
+		try {
+			stat = await fs.stat(file);
+		} catch {
+			continue;
+		}
+		if (stat.size > FALLBACK_GREP_MAX_FILE_BYTES) {
+			skippedDiagnostics.push(`${file}:0:[skipped: file > ${FALLBACK_GREP_MAX_FILE_BYTES} bytes; install ripgrep for unbounded grep]`);
+			continue;
+		}
+		let content;
+		try {
+			content = await fs.readFile(file, "utf8");
+		} catch {
+			continue;
+		}
+		if (content.includes("\0")) continue;
+		if (Date.now() > deadline) return {
+			matches,
+			skipped: skippedDiagnostics
+		};
+		const lines = content.split("\n");
+		for (let i = 0; i < lines.length; i++) if (rx.test(lines[i])) {
+			matches.push(`${file}:${i + 1}:${lines[i]}`);
+			if (matches.length >= maxResults) return {
+				matches,
+				skipped: skippedDiagnostics
+			};
+		}
+	}
+	return {
+		matches,
+		skipped: skippedDiagnostics
+	};
 }
 async function fallbackGlob(root, pattern, maxResults, fs) {
-    const rx = globToRegExp(pattern);
-    const out = [];
-    for await (const file of walkFiles(root, fs)) {
-        const rel = file.startsWith(root + '/')
-            ? file.slice(root.length + 1)
-            : file;
-        if (rx.test(rel)) {
-            out.push(file);
-            if (out.length >= maxResults) {
-                break;
-            }
-        }
-    }
-    return out;
+	const rx = globToRegExp(pattern);
+	const out = [];
+	for await (const file of walkFiles(root, fs)) {
+		const rel = file.startsWith(root + "/") ? file.slice(root.length + 1) : file;
+		if (rx.test(rel)) {
+			out.push(file);
+			if (out.length >= maxResults) break;
+		}
+	}
+	return out;
 }
 function createLocalGrepSearchTool(config = {}) {
-    const fs = LocalExecutionEngine.getWorkspaceFS(config);
-    return tools.tool(async (rawInput) => {
-        const input = rawInput;
-        const target = await LocalExecutionEngine.resolveWorkspacePathSafe(input.path ?? '.', config, 'read');
-        const maxResults = Math.max(input.max_results ?? DEFAULT_MAX_RESULTS, 1);
-        if (await isRipgrepAvailable(config)) {
-            // Pass the pattern through `-e` so dash-prefixed patterns
-            // like `-foo` are treated as the search regex, not as a
-            // (probably-unknown) flag. `rg --help` explicitly requires
-            // `-e/--regexp` (or `--`) for that case. Same trick avoids
-            // any future flag-conflict if a user query happens to look
-            // like an rg long option.
-            const args = [
-                '--line-number',
-                '--column',
-                '--hidden',
-                '--glob',
-                '!.git/**',
-                ...(input.glob != null && input.glob !== ''
-                    ? ['--glob', input.glob]
-                    : []),
-                '-e',
-                input.pattern,
-                target,
-            ];
-            const result = await LocalExecutionEngine.spawnLocalProcess('rg', args, {
-                ...config,
-                timeoutMs: config.timeoutMs ?? 30000,
-            });
-            // ripgrep exit codes:
-            //   0  → at least one match
-            //   1  → no matches (clean — "No matches found.")
-            //   2  → real error (bad regex, unreadable target, etc.)
-            // Without this branch (Codex P2 #23 — same fix shape glob_search
-            // got from P2 #13), exit-2 errors silently mapped to
-            // `matches: 0`, so the agent treated tooling failures as a
-            // genuine absence of matches.
-            if (result.timedOut ||
-                (result.exitCode != null && result.exitCode > 1)) {
-                const detail = result.stderr.trim() || `rg exited ${result.exitCode}`;
-                return [
-                    `grep_search failed: ${detail}`,
-                    {
-                        matches: 0,
-                        engine: 'ripgrep',
-                        error: detail,
-                        exitCode: result.exitCode,
-                    },
-                ];
-            }
-            const lines = result.stdout
-                .split('\n')
-                .filter(Boolean)
-                .slice(0, maxResults);
-            const output = lines.length > 0
-                ? lines.join('\n')
-                : result.stderr.trim() || 'No matches found.';
-            return [output, { matches: lines.length, engine: 'ripgrep' }];
-        }
-        try {
-            const { matches, skipped } = await fallbackGrep(target, input.pattern, input.glob, maxResults, fs);
-            // Artifact count: ONLY real matches (Codex P2 [43] —
-            // skip sentinels used to inflate the count and the budget).
-            const display = formatFallbackGrepDisplay({ matches, skipped });
-            return [
-                display,
-                {
-                    matches: matches.length,
-                    skipped: skipped.length,
-                    engine: 'node-fallback',
-                },
-            ];
-        }
-        catch (e) {
-            if (e instanceof FallbackGrepError) {
-                return [
-                    `grep_search refused the pattern: ${e.message}`,
-                    {
-                        matches: 0,
-                        engine: 'node-fallback',
-                        error: e.message,
-                        kind: e.kind,
-                    },
-                ];
-            }
-            throw e;
-        }
-    }, {
-        name: LocalGrepSearchToolName,
-        description: 'Search local files for a regex pattern (ripgrep when available, Node fallback otherwise).',
-        schema: LocalGrepSearchToolSchema,
-        responseFormat: _enum.Constants.CONTENT_AND_ARTIFACT,
-    });
+	const fs = require_LocalExecutionEngine.getWorkspaceFS(config);
+	return (0, _langchain_core_tools.tool)(async (rawInput) => {
+		const input = rawInput;
+		const target = await require_LocalExecutionEngine.resolveWorkspacePathSafe(input.path ?? ".", config, "read");
+		const maxResults = Math.max(input.max_results ?? DEFAULT_MAX_RESULTS, 1);
+		if (await isRipgrepAvailable(config)) {
+			const result = await require_LocalExecutionEngine.spawnLocalProcess("rg", [
+				"--line-number",
+				"--column",
+				"--hidden",
+				"--glob",
+				"!.git/**",
+				...input.glob != null && input.glob !== "" ? ["--glob", input.glob] : [],
+				"-e",
+				input.pattern,
+				target
+			], {
+				...config,
+				timeoutMs: config.timeoutMs ?? 3e4
+			});
+			if (result.timedOut || result.exitCode != null && result.exitCode > 1) {
+				const detail = result.stderr.trim() || `rg exited ${result.exitCode}`;
+				return [`grep_search failed: ${detail}`, {
+					matches: 0,
+					engine: "ripgrep",
+					error: detail,
+					exitCode: result.exitCode
+				}];
+			}
+			const lines = result.stdout.split("\n").filter(Boolean).slice(0, maxResults);
+			return [lines.length > 0 ? lines.join("\n") : result.stderr.trim() || "No matches found.", {
+				matches: lines.length,
+				engine: "ripgrep"
+			}];
+		}
+		try {
+			const { matches, skipped } = await fallbackGrep(target, input.pattern, input.glob, maxResults, fs);
+			return [formatFallbackGrepDisplay({
+				matches,
+				skipped
+			}), {
+				matches: matches.length,
+				skipped: skipped.length,
+				engine: "node-fallback"
+			}];
+		} catch (e) {
+			if (e instanceof FallbackGrepError) return [`grep_search refused the pattern: ${e.message}`, {
+				matches: 0,
+				engine: "node-fallback",
+				error: e.message,
+				kind: e.kind
+			}];
+			throw e;
+		}
+	}, {
+		name: LocalGrepSearchToolName,
+		description: "Search local files for a regex pattern (ripgrep when available, Node fallback otherwise).",
+		schema: LocalGrepSearchToolSchema,
+		responseFormat: "content_and_artifact"
+	});
 }
 function createLocalGlobSearchTool(config = {}) {
-    const fs = LocalExecutionEngine.getWorkspaceFS(config);
-    return tools.tool(async (rawInput) => {
-        const input = rawInput;
-        const target = await LocalExecutionEngine.resolveWorkspacePathSafe(input.path ?? '.', config, 'read');
-        const maxResults = Math.max(input.max_results ?? DEFAULT_MAX_RESULTS, 1);
-        if (await isRipgrepAvailable(config)) {
-            const result = await LocalExecutionEngine.spawnLocalProcess('rg', [
-                '--files',
-                '--hidden',
-                '--glob',
-                '!.git/**',
-                '--glob',
-                input.pattern,
-                target,
-            ], { ...config, timeoutMs: config.timeoutMs ?? 30000 });
-            // rg --files exit codes:
-            //   0  → at least one file matched
-            //   1  → no files matched (clean — "No files found.")
-            //   2  → real error (bad glob, unreadable target, etc.)
-            // Without this branch, exit-2 errors used to silently map to
-            // "No files found." — the agent then treats a tooling failure
-            // as a real absence of matches.
-            if (result.timedOut ||
-                (result.exitCode != null && result.exitCode > 1)) {
-                const detail = result.stderr.trim() || `rg exited ${result.exitCode}`;
-                return [
-                    `glob_search failed: ${detail}`,
-                    {
-                        files: [],
-                        engine: 'ripgrep',
-                        error: detail,
-                        exitCode: result.exitCode,
-                    },
-                ];
-            }
-            const lines = result.stdout
-                .split('\n')
-                .filter(Boolean)
-                .slice(0, maxResults);
-            return [
-                lines.length > 0 ? lines.join('\n') : 'No files found.',
-                { files: lines, engine: 'ripgrep' },
-            ];
-        }
-        const files = await fallbackGlob(target, input.pattern, maxResults, fs);
-        return [
-            files.length > 0 ? files.join('\n') : 'No files found.',
-            { files, engine: 'node-fallback' },
-        ];
-    }, {
-        name: LocalGlobSearchToolName,
-        description: 'Find local files matching a glob pattern (ripgrep when available, Node fallback otherwise).',
-        schema: LocalGlobSearchToolSchema,
-        responseFormat: _enum.Constants.CONTENT_AND_ARTIFACT,
-    });
+	const fs = require_LocalExecutionEngine.getWorkspaceFS(config);
+	return (0, _langchain_core_tools.tool)(async (rawInput) => {
+		const input = rawInput;
+		const target = await require_LocalExecutionEngine.resolveWorkspacePathSafe(input.path ?? ".", config, "read");
+		const maxResults = Math.max(input.max_results ?? DEFAULT_MAX_RESULTS, 1);
+		if (await isRipgrepAvailable(config)) {
+			const result = await require_LocalExecutionEngine.spawnLocalProcess("rg", [
+				"--files",
+				"--hidden",
+				"--glob",
+				"!.git/**",
+				"--glob",
+				input.pattern,
+				target
+			], {
+				...config,
+				timeoutMs: config.timeoutMs ?? 3e4
+			});
+			if (result.timedOut || result.exitCode != null && result.exitCode > 1) {
+				const detail = result.stderr.trim() || `rg exited ${result.exitCode}`;
+				return [`glob_search failed: ${detail}`, {
+					files: [],
+					engine: "ripgrep",
+					error: detail,
+					exitCode: result.exitCode
+				}];
+			}
+			const lines = result.stdout.split("\n").filter(Boolean).slice(0, maxResults);
+			return [lines.length > 0 ? lines.join("\n") : "No files found.", {
+				files: lines,
+				engine: "ripgrep"
+			}];
+		}
+		const files = await fallbackGlob(target, input.pattern, maxResults, fs);
+		return [files.length > 0 ? files.join("\n") : "No files found.", {
+			files,
+			engine: "node-fallback"
+		}];
+	}, {
+		name: LocalGlobSearchToolName,
+		description: "Find local files matching a glob pattern (ripgrep when available, Node fallback otherwise).",
+		schema: LocalGlobSearchToolSchema,
+		responseFormat: "content_and_artifact"
+	});
 }
 function createLocalListDirectoryTool(config = {}) {
-    const fs = LocalExecutionEngine.getWorkspaceFS(config);
-    return tools.tool(async (rawInput) => {
-        const input = rawInput;
-        const path = await LocalExecutionEngine.resolveWorkspacePathSafe(input.path ?? '.', config, 'read');
-        const entries = await fs.readdir(path, { withFileTypes: true });
-        const output = entries
-            .map((entry) => `${entry.isDirectory() ? 'dir ' : 'file'}\t${entry.name}`)
-            .join('\n');
-        return [output || 'Directory is empty.', { path, count: entries.length }];
-    }, {
-        name: LocalListDirectoryToolName,
-        description: 'List files and directories in a local directory.',
-        schema: LocalListDirectoryToolSchema,
-        responseFormat: _enum.Constants.CONTENT_AND_ARTIFACT,
-    });
+	const fs = require_LocalExecutionEngine.getWorkspaceFS(config);
+	return (0, _langchain_core_tools.tool)(async (rawInput) => {
+		const path$7 = await require_LocalExecutionEngine.resolveWorkspacePathSafe(rawInput.path ?? ".", config, "read");
+		const entries = await fs.readdir(path$7, { withFileTypes: true });
+		return [entries.map((entry) => `${entry.isDirectory() ? "dir " : "file"}\t${entry.name}`).join("\n") || "Directory is empty.", {
+			path: path$7,
+			count: entries.length
+		}];
+	}, {
+		name: LocalListDirectoryToolName,
+		description: "List files and directories in a local directory.",
+		schema: LocalListDirectoryToolSchema,
+		responseFormat: "content_and_artifact"
+	});
 }
 function createLocalCodingTools(config = {}, options = {}) {
-    const checkpointer = options.checkpointer ??
-        (config.fileCheckpointing === true
-            ? FileCheckpointer.createLocalFileCheckpointer({ fs: config.exec?.fs })
-            : undefined);
-    return [
-        createLocalReadFileTool(config),
-        createLocalWriteFileTool(config, checkpointer),
-        createLocalEditFileTool(config, checkpointer),
-        createLocalGrepSearchTool(config),
-        createLocalGlobSearchTool(config),
-        createLocalListDirectoryTool(config),
-        CompileCheckTool.createCompileCheckTool(config),
-        LocalExecutionTools.createLocalBashExecutionTool({ config }),
-        LocalExecutionTools.createLocalCodeExecutionTool(config),
-        LocalProgrammaticToolCalling.createLocalProgrammaticToolCallingTool(config),
-        LocalProgrammaticToolCalling.createLocalBashProgrammaticToolCallingTool(config),
-    ];
+	const checkpointer = options.checkpointer ?? (config.fileCheckpointing === true ? require_FileCheckpointer.createLocalFileCheckpointer({ fs: config.exec?.fs }) : void 0);
+	return [
+		createLocalReadFileTool(config),
+		createLocalWriteFileTool(config, checkpointer),
+		createLocalEditFileTool(config, checkpointer),
+		createLocalGrepSearchTool(config),
+		createLocalGlobSearchTool(config),
+		createLocalListDirectoryTool(config),
+		require_CompileCheckTool.createCompileCheckTool(config),
+		require_LocalExecutionTools.createLocalBashExecutionTool({ config }),
+		require_LocalExecutionTools.createLocalCodeExecutionTool(config),
+		require_LocalProgrammaticToolCalling.createLocalProgrammaticToolCallingTool(config),
+		require_LocalProgrammaticToolCalling.createLocalBashProgrammaticToolCallingTool(config)
+	];
 }
 /**
- * Variant of `createLocalCodingTools` that returns the bundle alongside
- * the file checkpointer so callers can later call
- * `bundle.checkpointer?.rewind()`.
- */
+* Variant of `createLocalCodingTools` that returns the bundle alongside
+* the file checkpointer so callers can later call
+* `bundle.checkpointer?.rewind()`.
+*/
 function createLocalCodingToolBundle(config = {}, options = {}) {
-    const checkpointer = options.checkpointer ??
-        (config.fileCheckpointing === true
-            ? FileCheckpointer.createLocalFileCheckpointer({ fs: config.exec?.fs })
-            : undefined);
-    return {
-        tools: createLocalCodingTools(config, { checkpointer }),
-        checkpointer,
-    };
+	const checkpointer = options.checkpointer ?? (config.fileCheckpointing === true ? require_FileCheckpointer.createLocalFileCheckpointer({ fs: config.exec?.fs }) : void 0);
+	return {
+		tools: createLocalCodingTools(config, { checkpointer }),
+		checkpointer
+	};
 }
 function createLocalCodingToolDefinitions() {
-    return [
-        toolDefinition(_enum.Constants.READ_FILE, 'Read a local text file from the configured working directory with line numbers.', LocalReadFileToolSchema),
-        toolDefinition(LocalWriteFileToolName, 'Create or overwrite a local text file in the configured working directory.', LocalWriteFileToolSchema),
-        toolDefinition(LocalEditFileToolName, 'Apply exact text replacements to a local file.', LocalEditFileToolSchema),
-        toolDefinition(LocalGrepSearchToolName, 'Search local files with ripgrep and return matching lines.', LocalGrepSearchToolSchema),
-        toolDefinition(LocalGlobSearchToolName, 'Find local files matching a glob pattern.', LocalGlobSearchToolSchema),
-        toolDefinition(LocalListDirectoryToolName, 'List files and directories in a local directory.', LocalListDirectoryToolSchema),
-        CompileCheckTool.createCompileCheckToolDefinition(),
-    ];
+	return [
+		toolDefinition("read_file", "Read a local text file from the configured working directory with line numbers.", LocalReadFileToolSchema),
+		toolDefinition(LocalWriteFileToolName, "Create or overwrite a local text file in the configured working directory.", LocalWriteFileToolSchema),
+		toolDefinition(LocalEditFileToolName, "Apply exact text replacements to a local file.", LocalEditFileToolSchema),
+		toolDefinition(LocalGrepSearchToolName, "Search local files with ripgrep and return matching lines.", LocalGrepSearchToolSchema),
+		toolDefinition(LocalGlobSearchToolName, "Find local files matching a glob pattern.", LocalGlobSearchToolSchema),
+		toolDefinition(LocalListDirectoryToolName, "List files and directories in a local directory.", LocalListDirectoryToolSchema),
+		require_CompileCheckTool.createCompileCheckToolDefinition()
+	];
 }
 function createLocalCodingToolRegistry() {
-    return new Map(createLocalCodingToolDefinitions().map((definition) => [
-        definition.name,
-        definition,
-    ]));
+	return new Map(createLocalCodingToolDefinitions().map((definition) => [definition.name, definition]));
 }
-
+//#endregion
 exports.LocalEditFileToolName = LocalEditFileToolName;
 exports.LocalEditFileToolSchema = LocalEditFileToolSchema;
 exports.LocalGlobSearchToolName = LocalGlobSearchToolName;
@@ -1121,4 +861,5 @@ exports.createLocalGrepSearchTool = createLocalGrepSearchTool;
 exports.createLocalListDirectoryTool = createLocalListDirectoryTool;
 exports.createLocalReadFileTool = createLocalReadFileTool;
 exports.createLocalWriteFileTool = createLocalWriteFileTool;
-//# sourceMappingURL=LocalCodingTools.cjs.map
+
+//# sourceMappingURL=LocalCodingTools.cjs.map