@langchain/anthropic/dist/tools/textEditor.js

Anthropic integrations for LangChain.js

import { TextEditor20250728CommandSchema } from "./types.js";
import { tool } from "@langchain/core/tools";

//#region src/tools/textEditor.ts
/**
* Creates an Anthropic text editor tool for Claude 4.x models that can view and modify text files.
*
* The text editor tool enables Claude to view and modify text files, helping debug, fix,
* and improve code or other text documents. Claude can directly interact with files,
* providing hands-on assistance rather than just suggesting changes.
*
* Available commands:
* - `view`: Examine file contents or list directory contents
* - `str_replace`: Replace specific text in a file
* - `create`: Create a new file with specified content
* - `insert`: Insert text at a specific line number
*
* @example
* ```typescript
* import { ChatAnthropic, tools } from "@langchain/anthropic";
* import * as fs from "fs";
*
* const llm = new ChatAnthropic({
*   model: "claude-sonnet-4-5-20250929",
* });
*
* const textEditor = tools.textEditor_20250728({
*   execute: async (args) => {
*     if (args.command === "view") {
*       const content = fs.readFileSync(args.path, "utf-8");
*       return content.split("\n").map((line, i) => `${i + 1}: ${line}`).join("\n");
*     }
*     if (args.command === "str_replace") {
*       let content = fs.readFileSync(args.path, "utf-8");
*       content = content.replace(args.old_str!, args.new_str!);
*       fs.writeFileSync(args.path, content);
*       return "Successfully replaced text.";
*     }
*     // Handle other commands...
*     return "Command executed";
*   },
*   maxCharacters: 10000,
* });
*
* const llmWithEditor = llm.bindTools([textEditor]);
* const response = await llmWithEditor.invoke(
*   "There's a syntax error in my primes.py file. Can you help me fix it?"
* );
* ```
*
* @param options - Configuration options for the text editor tool
* @param options.execute - Function that handles text editor command execution
* @param options.maxCharacters - Maximum characters to return when viewing files
* @returns The text editor tool object that can be passed to `bindTools`
*
* @see https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/text-editor-tool
*/
function textEditor_20250728(options) {
	const name = "str_replace_based_edit_tool";
	const textEditorTool = tool(options?.execute, {
		name,
		description: "A tool for editing text files",
		schema: TextEditor20250728CommandSchema
	});
	textEditorTool.extras = {
		...textEditorTool.extras ?? {},
		providerToolDefinition: {
			type: "text_editor_20250728",
			name,
			...options?.maxCharacters !== void 0 && { max_characters: options.maxCharacters }
		}
	};
	return textEditorTool;
}

//#endregion
export { textEditor_20250728 };
//# sourceMappingURL=textEditor.js.map