@langchain/anthropic 1.2.3 → 1.3.0-dev-1765432861398

package/dist/tools/textEditor.js

@@ -0,0 +1,78 @@
+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

package/dist/tools/textEditor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textEditor.js","names":["options?: TextEditor20250728Options"],"sources":["../../src/tools/textEditor.ts"],"sourcesContent":["import Anthropic from \"@anthropic-ai/sdk\";\nimport { tool } from \"@langchain/core/tools\";\nimport type { DynamicStructuredTool, ToolRuntime } from \"@langchain/core/tools\";\n\nimport {\n  TextEditor20250728CommandSchema,\n  type TextEditor20250728Command,\n} from \"./types.js\";\n\n/**\n * Options for the text editor tool (Claude 4.x version).\n */\nexport interface TextEditor20250728Options {\n  /**\n   * Optional execute function that handles text editor command execution.\n   * This function receives the command input and should return the result.\n   */\n  execute?: (args: TextEditor20250728Command) => string | Promise<string>;\n  /**\n   * Optional maximum characters to return when viewing files.\n   * If the file content exceeds this limit, it will be truncated.\n   */\n  maxCharacters?: number;\n}\n\n/**\n * Creates an Anthropic text editor tool for Claude 4.x models that can view and modify text files.\n *\n * The text editor tool enables Claude to view and modify text files, helping debug, fix,\n * and improve code or other text documents. Claude can directly interact with files,\n * providing hands-on assistance rather than just suggesting changes.\n *\n * Available commands:\n * - `view`: Examine file contents or list directory contents\n * - `str_replace`: Replace specific text in a file\n * - `create`: Create a new file with specified content\n * - `insert`: Insert text at a specific line number\n *\n * @example\n * ```typescript\n * import { ChatAnthropic, tools } from \"@langchain/anthropic\";\n * import * as fs from \"fs\";\n *\n * const llm = new ChatAnthropic({\n *   model: \"claude-sonnet-4-5-20250929\",\n * });\n *\n * const textEditor = tools.textEditor_20250728({\n *   execute: async (args) => {\n *     if (args.command === \"view\") {\n *       const content = fs.readFileSync(args.path, \"utf-8\");\n *       return content.split(\"\\n\").map((line, i) => `${i + 1}: ${line}`).join(\"\\n\");\n *     }\n *     if (args.command === \"str_replace\") {\n *       let content = fs.readFileSync(args.path, \"utf-8\");\n *       content = content.replace(args.old_str!, args.new_str!);\n *       fs.writeFileSync(args.path, content);\n *       return \"Successfully replaced text.\";\n *     }\n *     // Handle other commands...\n *     return \"Command executed\";\n *   },\n *   maxCharacters: 10000,\n * });\n *\n * const llmWithEditor = llm.bindTools([textEditor]);\n * const response = await llmWithEditor.invoke(\n *   \"There's a syntax error in my primes.py file. Can you help me fix it?\"\n * );\n * ```\n *\n * @param options - Configuration options for the text editor tool\n * @param options.execute - Function that handles text editor command execution\n * @param options.maxCharacters - Maximum characters to return when viewing files\n * @returns The text editor tool object that can be passed to `bindTools`\n *\n * @see https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/text-editor-tool\n */\nexport function textEditor_20250728(options?: TextEditor20250728Options) {\n  const name = \"str_replace_based_edit_tool\";\n  const textEditorTool = tool(\n    options?.execute as (\n      input: unknown,\n      runtime: ToolRuntime<unknown, unknown>\n    ) => string | Promise<string>,\n    {\n      name,\n      description: \"A tool for editing text files\",\n      schema: TextEditor20250728CommandSchema,\n    }\n  );\n\n  textEditorTool.extras = {\n    ...(textEditorTool.extras ?? {}),\n    providerToolDefinition: {\n      type: \"text_editor_20250728\",\n      name,\n      ...(options?.maxCharacters !== undefined && {\n        max_characters: options.maxCharacters,\n      }),\n    } satisfies Anthropic.Beta.Messages.BetaToolTextEditor20250728,\n  };\n\n  return textEditorTool as DynamicStructuredTool<\n    typeof TextEditor20250728CommandSchema,\n    TextEditor20250728Command,\n    unknown,\n    string | Promise<string>\n  >;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8EA,SAAgB,oBAAoBA,SAAqC;CACvE,MAAM,OAAO;CACb,MAAM,iBAAiB,KACrB,SAAS,SAIT;EACE;EACA,aAAa;EACb,QAAQ;CACT,EACF;CAED,eAAe,SAAS;EACtB,GAAI,eAAe,UAAU,CAAE;EAC/B,wBAAwB;GACtB,MAAM;GACN;GACA,GAAI,SAAS,kBAAkB,UAAa,EAC1C,gBAAgB,QAAQ,cACzB;EACF;CACF;AAED,QAAO;AAMR"}

package/dist/tools/toolSearch.cjs

@@ -0,0 +1,110 @@
+
+//#region src/tools/toolSearch.ts
+/**
+* Creates a regex-based tool search tool that enables Claude to work with hundreds
+* or thousands of tools by dynamically discovering and loading them on-demand.
+* Claude constructs regex patterns (using Python's `re.search()` syntax) to search
+* for tools by name, description, argument names, and argument descriptions.
+*
+* @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.
+*
+* @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}
+* @param options - Configuration options for the tool search tool
+* @returns A tool search tool definition to be passed to the Anthropic API
+*
+* @example
+* ```typescript
+* import { ChatAnthropic, tools } from "@langchain/anthropic";
+*
+* const model = new ChatAnthropic({
+*   model: "claude-sonnet-4-5-20250929",
+* });
+*
+* const getWeather = tool(
+*   async (input: { location: string }) => {
+*     return `Weather in ${input.location}`;
+*   },
+*   {
+*     name: "get_weather",
+*     description: "Get the weather at a specific location",
+*     schema: z.object({
+*       location: z.string(),
+*     }),
+*     extras: { defer_loading: true },
+*   },
+* );
+*
+* // Use with deferred tools - Claude will search and discover tools as needed
+* const response = await model.invoke("What is the weather in San Francisco?", {
+*   tools: [
+*     tools.toolSearchRegex_20251119(),
+*     getWeather,
+*   ],
+* });
+* ```
+*/
+function toolSearchRegex_20251119(options) {
+	return {
+		type: "tool_search_tool_regex_20251119",
+		name: "tool_search_tool_regex",
+		cache_control: options?.cacheControl
+	};
+}
+/**
+* Creates a BM25-based tool search tool that enables Claude to work with hundreds
+* or thousands of tools by dynamically discovering and loading them on-demand.
+* Claude uses natural language queries to search for tools by name, description,
+* argument names, and argument descriptions.
+*
+* @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.
+*
+* @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}
+* @param options - Configuration options for the tool search tool
+* @returns A tool search tool definition to be passed to the Anthropic API
+*
+* @example
+* ```typescript
+* import { ChatAnthropic, tools } from "@langchain/anthropic";
+*
+* const model = new ChatAnthropic({
+*   model: "claude-sonnet-4-5-20250929",
+*   clientOptions: {
+*     defaultHeaders: { "anthropic-beta": "advanced-tool-use-2025-11-20" },
+*   },
+* });
+*
+* const getWeather = tool(
+*   async (input: { location: string }) => {
+*     return `Weather in ${input.location}`;
+*   },
+*   {
+*     name: "get_weather",
+*     description: "Get the weather at a specific location",
+*     schema: z.object({
+*       location: z.string(),
+*     }),
+*     extras: { defer_loading: true },
+*   },
+* );
+*
+* // Use with deferred tools - Claude will search using natural language
+* const response = await model.invoke("What is the weather in San Francisco?", {
+*   tools: [
+*     tools.toolSearchBM25_20251119(),
+*     getWeather,
+*   ],
+* });
+* ```
+*/
+function toolSearchBM25_20251119(options) {
+	return {
+		type: "tool_search_tool_bm25_20251119",
+		name: "tool_search_tool_bm25",
+		cache_control: options?.cacheControl
+	};
+}
+
+//#endregion
+exports.toolSearchBM25_20251119 = toolSearchBM25_20251119;
+exports.toolSearchRegex_20251119 = toolSearchRegex_20251119;
+//# sourceMappingURL=toolSearch.cjs.map

package/dist/tools/toolSearch.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolSearch.cjs","names":["options?: ToolSearchOptions"],"sources":["../../src/tools/toolSearch.ts"],"sourcesContent":["import Anthropic from \"@anthropic-ai/sdk\";\nimport { type ServerTool } from \"@langchain/core/tools\";\n\n/**\n * Options for the tool search tool.\n */\nexport interface ToolSearchOptions {\n  /**\n   * Create a cache control breakpoint at this content block.\n   */\n  cacheControl?: Anthropic.Beta.BetaCacheControlEphemeral;\n}\n\n/**\n * Creates a regex-based tool search tool that enables Claude to work with hundreds\n * or thousands of tools by dynamically discovering and loading them on-demand.\n * Claude constructs regex patterns (using Python's `re.search()` syntax) to search\n * for tools by name, description, argument names, and argument descriptions.\n *\n * @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.\n *\n * @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}\n * @param options - Configuration options for the tool search tool\n * @returns A tool search tool definition to be passed to the Anthropic API\n *\n * @example\n * ```typescript\n * import { ChatAnthropic, tools } from \"@langchain/anthropic\";\n *\n * const model = new ChatAnthropic({\n *   model: \"claude-sonnet-4-5-20250929\",\n * });\n *\n * const getWeather = tool(\n *   async (input: { location: string }) => {\n *     return `Weather in ${input.location}`;\n *   },\n *   {\n *     name: \"get_weather\",\n *     description: \"Get the weather at a specific location\",\n *     schema: z.object({\n *       location: z.string(),\n *     }),\n *     extras: { defer_loading: true },\n *   },\n * );\n *\n * // Use with deferred tools - Claude will search and discover tools as needed\n * const response = await model.invoke(\"What is the weather in San Francisco?\", {\n *   tools: [\n *     tools.toolSearchRegex_20251119(),\n *     getWeather,\n *   ],\n * });\n * ```\n */\nexport function toolSearchRegex_20251119(\n  options?: ToolSearchOptions\n): ServerTool {\n  return {\n    type: \"tool_search_tool_regex_20251119\",\n    name: \"tool_search_tool_regex\",\n    cache_control: options?.cacheControl,\n  } satisfies Anthropic.Beta.Messages.BetaToolSearchToolRegex20251119;\n}\n\n/**\n * Creates a BM25-based tool search tool that enables Claude to work with hundreds\n * or thousands of tools by dynamically discovering and loading them on-demand.\n * Claude uses natural language queries to search for tools by name, description,\n * argument names, and argument descriptions.\n *\n * @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.\n *\n * @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}\n * @param options - Configuration options for the tool search tool\n * @returns A tool search tool definition to be passed to the Anthropic API\n *\n * @example\n * ```typescript\n * import { ChatAnthropic, tools } from \"@langchain/anthropic\";\n *\n * const model = new ChatAnthropic({\n *   model: \"claude-sonnet-4-5-20250929\",\n *   clientOptions: {\n *     defaultHeaders: { \"anthropic-beta\": \"advanced-tool-use-2025-11-20\" },\n *   },\n * });\n *\n * const getWeather = tool(\n *   async (input: { location: string }) => {\n *     return `Weather in ${input.location}`;\n *   },\n *   {\n *     name: \"get_weather\",\n *     description: \"Get the weather at a specific location\",\n *     schema: z.object({\n *       location: z.string(),\n *     }),\n *     extras: { defer_loading: true },\n *   },\n * );\n *\n * // Use with deferred tools - Claude will search using natural language\n * const response = await model.invoke(\"What is the weather in San Francisco?\", {\n *   tools: [\n *     tools.toolSearchBM25_20251119(),\n *     getWeather,\n *   ],\n * });\n * ```\n */\nexport function toolSearchBM25_20251119(\n  options?: ToolSearchOptions\n): ServerTool {\n  return {\n    type: \"tool_search_tool_bm25_20251119\",\n    name: \"tool_search_tool_bm25\",\n    cache_control: options?.cacheControl,\n  } satisfies Anthropic.Beta.Messages.BetaToolSearchToolBm25_20251119;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDA,SAAgB,yBACdA,SACY;AACZ,QAAO;EACL,MAAM;EACN,MAAM;EACN,eAAe,SAAS;CACzB;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDD,SAAgB,wBACdA,SACY;AACZ,QAAO;EACL,MAAM;EACN,MAAM;EACN,eAAe,SAAS;CACzB;AACF"}

package/dist/tools/toolSearch.d.cts

@@ -0,0 +1,108 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { ServerTool } from "@langchain/core/tools";
+
+//#region src/tools/toolSearch.d.ts
+
+/**
+ * Options for the tool search tool.
+ */
+interface ToolSearchOptions {
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cacheControl?: Anthropic.Beta.BetaCacheControlEphemeral;
+}
+/**
+ * Creates a regex-based tool search tool that enables Claude to work with hundreds
+ * or thousands of tools by dynamically discovering and loading them on-demand.
+ * Claude constructs regex patterns (using Python's `re.search()` syntax) to search
+ * for tools by name, description, argument names, and argument descriptions.
+ *
+ * @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.
+ *
+ * @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}
+ * @param options - Configuration options for the tool search tool
+ * @returns A tool search tool definition to be passed to the Anthropic API
+ *
+ * @example
+ * ```typescript
+ * import { ChatAnthropic, tools } from "@langchain/anthropic";
+ *
+ * const model = new ChatAnthropic({
+ *   model: "claude-sonnet-4-5-20250929",
+ * });
+ *
+ * const getWeather = tool(
+ *   async (input: { location: string }) => {
+ *     return `Weather in ${input.location}`;
+ *   },
+ *   {
+ *     name: "get_weather",
+ *     description: "Get the weather at a specific location",
+ *     schema: z.object({
+ *       location: z.string(),
+ *     }),
+ *     extras: { defer_loading: true },
+ *   },
+ * );
+ *
+ * // Use with deferred tools - Claude will search and discover tools as needed
+ * const response = await model.invoke("What is the weather in San Francisco?", {
+ *   tools: [
+ *     tools.toolSearchRegex_20251119(),
+ *     getWeather,
+ *   ],
+ * });
+ * ```
+ */
+declare function toolSearchRegex_20251119(options?: ToolSearchOptions): ServerTool;
+/**
+ * Creates a BM25-based tool search tool that enables Claude to work with hundreds
+ * or thousands of tools by dynamically discovering and loading them on-demand.
+ * Claude uses natural language queries to search for tools by name, description,
+ * argument names, and argument descriptions.
+ *
+ * @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.
+ *
+ * @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}
+ * @param options - Configuration options for the tool search tool
+ * @returns A tool search tool definition to be passed to the Anthropic API
+ *
+ * @example
+ * ```typescript
+ * import { ChatAnthropic, tools } from "@langchain/anthropic";
+ *
+ * const model = new ChatAnthropic({
+ *   model: "claude-sonnet-4-5-20250929",
+ *   clientOptions: {
+ *     defaultHeaders: { "anthropic-beta": "advanced-tool-use-2025-11-20" },
+ *   },
+ * });
+ *
+ * const getWeather = tool(
+ *   async (input: { location: string }) => {
+ *     return `Weather in ${input.location}`;
+ *   },
+ *   {
+ *     name: "get_weather",
+ *     description: "Get the weather at a specific location",
+ *     schema: z.object({
+ *       location: z.string(),
+ *     }),
+ *     extras: { defer_loading: true },
+ *   },
+ * );
+ *
+ * // Use with deferred tools - Claude will search using natural language
+ * const response = await model.invoke("What is the weather in San Francisco?", {
+ *   tools: [
+ *     tools.toolSearchBM25_20251119(),
+ *     getWeather,
+ *   ],
+ * });
+ * ```
+ */
+declare function toolSearchBM25_20251119(options?: ToolSearchOptions): ServerTool;
+//#endregion
+export { ToolSearchOptions, toolSearchBM25_20251119, toolSearchRegex_20251119 };
+//# sourceMappingURL=toolSearch.d.cts.map

package/dist/tools/toolSearch.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolSearch.d.cts","names":["Anthropic","ServerTool","ToolSearchOptions","Beta","BetaCacheControlEphemeral","toolSearchRegex_20251119","toolSearchBM25_20251119"],"sources":["../../src/tools/toolSearch.d.ts"],"sourcesContent":["import Anthropic from \"@anthropic-ai/sdk\";\nimport { type ServerTool } from \"@langchain/core/tools\";\n/**\n * Options for the tool search tool.\n */\nexport interface ToolSearchOptions {\n    /**\n     * Create a cache control breakpoint at this content block.\n     */\n    cacheControl?: Anthropic.Beta.BetaCacheControlEphemeral;\n}\n/**\n * Creates a regex-based tool search tool that enables Claude to work with hundreds\n * or thousands of tools by dynamically discovering and loading them on-demand.\n * Claude constructs regex patterns (using Python's `re.search()` syntax) to search\n * for tools by name, description, argument names, and argument descriptions.\n *\n * @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.\n *\n * @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}\n * @param options - Configuration options for the tool search tool\n * @returns A tool search tool definition to be passed to the Anthropic API\n *\n * @example\n * ```typescript\n * import { ChatAnthropic, tools } from \"@langchain/anthropic\";\n *\n * const model = new ChatAnthropic({\n *   model: \"claude-sonnet-4-5-20250929\",\n * });\n *\n * const getWeather = tool(\n *   async (input: { location: string }) => {\n *     return `Weather in ${input.location}`;\n *   },\n *   {\n *     name: \"get_weather\",\n *     description: \"Get the weather at a specific location\",\n *     schema: z.object({\n *       location: z.string(),\n *     }),\n *     extras: { defer_loading: true },\n *   },\n * );\n *\n * // Use with deferred tools - Claude will search and discover tools as needed\n * const response = await model.invoke(\"What is the weather in San Francisco?\", {\n *   tools: [\n *     tools.toolSearchRegex_20251119(),\n *     getWeather,\n *   ],\n * });\n * ```\n */\nexport declare function toolSearchRegex_20251119(options?: ToolSearchOptions): ServerTool;\n/**\n * Creates a BM25-based tool search tool that enables Claude to work with hundreds\n * or thousands of tools by dynamically discovering and loading them on-demand.\n * Claude uses natural language queries to search for tools by name, description,\n * argument names, and argument descriptions.\n *\n * @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.\n *\n * @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}\n * @param options - Configuration options for the tool search tool\n * @returns A tool search tool definition to be passed to the Anthropic API\n *\n * @example\n * ```typescript\n * import { ChatAnthropic, tools } from \"@langchain/anthropic\";\n *\n * const model = new ChatAnthropic({\n *   model: \"claude-sonnet-4-5-20250929\",\n *   clientOptions: {\n *     defaultHeaders: { \"anthropic-beta\": \"advanced-tool-use-2025-11-20\" },\n *   },\n * });\n *\n * const getWeather = tool(\n *   async (input: { location: string }) => {\n *     return `Weather in ${input.location}`;\n *   },\n *   {\n *     name: \"get_weather\",\n *     description: \"Get the weather at a specific location\",\n *     schema: z.object({\n *       location: z.string(),\n *     }),\n *     extras: { defer_loading: true },\n *   },\n * );\n *\n * // Use with deferred tools - Claude will search using natural language\n * const response = await model.invoke(\"What is the weather in San Francisco?\", {\n *   tools: [\n *     tools.toolSearchBM25_20251119(),\n *     getWeather,\n *   ],\n * });\n * ```\n */\nexport declare function toolSearchBM25_20251119(options?: ToolSearchOptions): ServerTool;\n//# sourceMappingURL=toolSearch.d.ts.map"],"mappings":";;;;;;;AAKA;AAiDwBK,UAjDPH,iBAAAA,CAiD+B;EA+CxBI;;;iBA5FLN,SAAAA,CAAUG,IAAAA,CAAKC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6CVC,wBAAAA,WAAmCH,oBAAoBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+CvDK,uBAAAA,WAAkCJ,oBAAoBD"}

package/dist/tools/toolSearch.d.ts

@@ -0,0 +1,108 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { ServerTool } from "@langchain/core/tools";
+
+//#region src/tools/toolSearch.d.ts
+
+/**
+ * Options for the tool search tool.
+ */
+interface ToolSearchOptions {
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cacheControl?: Anthropic.Beta.BetaCacheControlEphemeral;
+}
+/**
+ * Creates a regex-based tool search tool that enables Claude to work with hundreds
+ * or thousands of tools by dynamically discovering and loading them on-demand.
+ * Claude constructs regex patterns (using Python's `re.search()` syntax) to search
+ * for tools by name, description, argument names, and argument descriptions.
+ *
+ * @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.
+ *
+ * @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}
+ * @param options - Configuration options for the tool search tool
+ * @returns A tool search tool definition to be passed to the Anthropic API
+ *
+ * @example
+ * ```typescript
+ * import { ChatAnthropic, tools } from "@langchain/anthropic";
+ *
+ * const model = new ChatAnthropic({
+ *   model: "claude-sonnet-4-5-20250929",
+ * });
+ *
+ * const getWeather = tool(
+ *   async (input: { location: string }) => {
+ *     return `Weather in ${input.location}`;
+ *   },
+ *   {
+ *     name: "get_weather",
+ *     description: "Get the weather at a specific location",
+ *     schema: z.object({
+ *       location: z.string(),
+ *     }),
+ *     extras: { defer_loading: true },
+ *   },
+ * );
+ *
+ * // Use with deferred tools - Claude will search and discover tools as needed
+ * const response = await model.invoke("What is the weather in San Francisco?", {
+ *   tools: [
+ *     tools.toolSearchRegex_20251119(),
+ *     getWeather,
+ *   ],
+ * });
+ * ```
+ */
+declare function toolSearchRegex_20251119(options?: ToolSearchOptions): ServerTool;
+/**
+ * Creates a BM25-based tool search tool that enables Claude to work with hundreds
+ * or thousands of tools by dynamically discovering and loading them on-demand.
+ * Claude uses natural language queries to search for tools by name, description,
+ * argument names, and argument descriptions.
+ *
+ * @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.
+ *
+ * @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}
+ * @param options - Configuration options for the tool search tool
+ * @returns A tool search tool definition to be passed to the Anthropic API
+ *
+ * @example
+ * ```typescript
+ * import { ChatAnthropic, tools } from "@langchain/anthropic";
+ *
+ * const model = new ChatAnthropic({
+ *   model: "claude-sonnet-4-5-20250929",
+ *   clientOptions: {
+ *     defaultHeaders: { "anthropic-beta": "advanced-tool-use-2025-11-20" },
+ *   },
+ * });
+ *
+ * const getWeather = tool(
+ *   async (input: { location: string }) => {
+ *     return `Weather in ${input.location}`;
+ *   },
+ *   {
+ *     name: "get_weather",
+ *     description: "Get the weather at a specific location",
+ *     schema: z.object({
+ *       location: z.string(),
+ *     }),
+ *     extras: { defer_loading: true },
+ *   },
+ * );
+ *
+ * // Use with deferred tools - Claude will search using natural language
+ * const response = await model.invoke("What is the weather in San Francisco?", {
+ *   tools: [
+ *     tools.toolSearchBM25_20251119(),
+ *     getWeather,
+ *   ],
+ * });
+ * ```
+ */
+declare function toolSearchBM25_20251119(options?: ToolSearchOptions): ServerTool;
+//#endregion
+export { ToolSearchOptions, toolSearchBM25_20251119, toolSearchRegex_20251119 };
+//# sourceMappingURL=toolSearch.d.ts.map

package/dist/tools/toolSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolSearch.d.ts","names":["Anthropic","ServerTool","ToolSearchOptions","Beta","BetaCacheControlEphemeral","toolSearchRegex_20251119","toolSearchBM25_20251119"],"sources":["../../src/tools/toolSearch.d.ts"],"sourcesContent":["import Anthropic from \"@anthropic-ai/sdk\";\nimport { type ServerTool } from \"@langchain/core/tools\";\n/**\n * Options for the tool search tool.\n */\nexport interface ToolSearchOptions {\n    /**\n     * Create a cache control breakpoint at this content block.\n     */\n    cacheControl?: Anthropic.Beta.BetaCacheControlEphemeral;\n}\n/**\n * Creates a regex-based tool search tool that enables Claude to work with hundreds\n * or thousands of tools by dynamically discovering and loading them on-demand.\n * Claude constructs regex patterns (using Python's `re.search()` syntax) to search\n * for tools by name, description, argument names, and argument descriptions.\n *\n * @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.\n *\n * @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}\n * @param options - Configuration options for the tool search tool\n * @returns A tool search tool definition to be passed to the Anthropic API\n *\n * @example\n * ```typescript\n * import { ChatAnthropic, tools } from \"@langchain/anthropic\";\n *\n * const model = new ChatAnthropic({\n *   model: \"claude-sonnet-4-5-20250929\",\n * });\n *\n * const getWeather = tool(\n *   async (input: { location: string }) => {\n *     return `Weather in ${input.location}`;\n *   },\n *   {\n *     name: \"get_weather\",\n *     description: \"Get the weather at a specific location\",\n *     schema: z.object({\n *       location: z.string(),\n *     }),\n *     extras: { defer_loading: true },\n *   },\n * );\n *\n * // Use with deferred tools - Claude will search and discover tools as needed\n * const response = await model.invoke(\"What is the weather in San Francisco?\", {\n *   tools: [\n *     tools.toolSearchRegex_20251119(),\n *     getWeather,\n *   ],\n * });\n * ```\n */\nexport declare function toolSearchRegex_20251119(options?: ToolSearchOptions): ServerTool;\n/**\n * Creates a BM25-based tool search tool that enables Claude to work with hundreds\n * or thousands of tools by dynamically discovering and loading them on-demand.\n * Claude uses natural language queries to search for tools by name, description,\n * argument names, and argument descriptions.\n *\n * @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.\n *\n * @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}\n * @param options - Configuration options for the tool search tool\n * @returns A tool search tool definition to be passed to the Anthropic API\n *\n * @example\n * ```typescript\n * import { ChatAnthropic, tools } from \"@langchain/anthropic\";\n *\n * const model = new ChatAnthropic({\n *   model: \"claude-sonnet-4-5-20250929\",\n *   clientOptions: {\n *     defaultHeaders: { \"anthropic-beta\": \"advanced-tool-use-2025-11-20\" },\n *   },\n * });\n *\n * const getWeather = tool(\n *   async (input: { location: string }) => {\n *     return `Weather in ${input.location}`;\n *   },\n *   {\n *     name: \"get_weather\",\n *     description: \"Get the weather at a specific location\",\n *     schema: z.object({\n *       location: z.string(),\n *     }),\n *     extras: { defer_loading: true },\n *   },\n * );\n *\n * // Use with deferred tools - Claude will search using natural language\n * const response = await model.invoke(\"What is the weather in San Francisco?\", {\n *   tools: [\n *     tools.toolSearchBM25_20251119(),\n *     getWeather,\n *   ],\n * });\n * ```\n */\nexport declare function toolSearchBM25_20251119(options?: ToolSearchOptions): ServerTool;\n//# sourceMappingURL=toolSearch.d.ts.map"],"mappings":";;;;;;;AAKA;AAiDwBK,UAjDPH,iBAAAA,CAiD+B;EA+CxBI;;;iBA5FLN,SAAAA,CAAUG,IAAAA,CAAKC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6CVC,wBAAAA,WAAmCH,oBAAoBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+CvDK,uBAAAA,WAAkCJ,oBAAoBD"}

package/dist/tools/toolSearch.js

@@ -0,0 +1,108 @@
+//#region src/tools/toolSearch.ts
+/**
+* Creates a regex-based tool search tool that enables Claude to work with hundreds
+* or thousands of tools by dynamically discovering and loading them on-demand.
+* Claude constructs regex patterns (using Python's `re.search()` syntax) to search
+* for tools by name, description, argument names, and argument descriptions.
+*
+* @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.
+*
+* @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}
+* @param options - Configuration options for the tool search tool
+* @returns A tool search tool definition to be passed to the Anthropic API
+*
+* @example
+* ```typescript
+* import { ChatAnthropic, tools } from "@langchain/anthropic";
+*
+* const model = new ChatAnthropic({
+*   model: "claude-sonnet-4-5-20250929",
+* });
+*
+* const getWeather = tool(
+*   async (input: { location: string }) => {
+*     return `Weather in ${input.location}`;
+*   },
+*   {
+*     name: "get_weather",
+*     description: "Get the weather at a specific location",
+*     schema: z.object({
+*       location: z.string(),
+*     }),
+*     extras: { defer_loading: true },
+*   },
+* );
+*
+* // Use with deferred tools - Claude will search and discover tools as needed
+* const response = await model.invoke("What is the weather in San Francisco?", {
+*   tools: [
+*     tools.toolSearchRegex_20251119(),
+*     getWeather,
+*   ],
+* });
+* ```
+*/
+function toolSearchRegex_20251119(options) {
+	return {
+		type: "tool_search_tool_regex_20251119",
+		name: "tool_search_tool_regex",
+		cache_control: options?.cacheControl
+	};
+}
+/**
+* Creates a BM25-based tool search tool that enables Claude to work with hundreds
+* or thousands of tools by dynamically discovering and loading them on-demand.
+* Claude uses natural language queries to search for tools by name, description,
+* argument names, and argument descriptions.
+*
+* @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.
+*
+* @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}
+* @param options - Configuration options for the tool search tool
+* @returns A tool search tool definition to be passed to the Anthropic API
+*
+* @example
+* ```typescript
+* import { ChatAnthropic, tools } from "@langchain/anthropic";
+*
+* const model = new ChatAnthropic({
+*   model: "claude-sonnet-4-5-20250929",
+*   clientOptions: {
+*     defaultHeaders: { "anthropic-beta": "advanced-tool-use-2025-11-20" },
+*   },
+* });
+*
+* const getWeather = tool(
+*   async (input: { location: string }) => {
+*     return `Weather in ${input.location}`;
+*   },
+*   {
+*     name: "get_weather",
+*     description: "Get the weather at a specific location",
+*     schema: z.object({
+*       location: z.string(),
+*     }),
+*     extras: { defer_loading: true },
+*   },
+* );
+*
+* // Use with deferred tools - Claude will search using natural language
+* const response = await model.invoke("What is the weather in San Francisco?", {
+*   tools: [
+*     tools.toolSearchBM25_20251119(),
+*     getWeather,
+*   ],
+* });
+* ```
+*/
+function toolSearchBM25_20251119(options) {
+	return {
+		type: "tool_search_tool_bm25_20251119",
+		name: "tool_search_tool_bm25",
+		cache_control: options?.cacheControl
+	};
+}
+
+//#endregion
+export { toolSearchBM25_20251119, toolSearchRegex_20251119 };
+//# sourceMappingURL=toolSearch.js.map

package/dist/tools/toolSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolSearch.js","names":["options?: ToolSearchOptions"],"sources":["../../src/tools/toolSearch.ts"],"sourcesContent":["import Anthropic from \"@anthropic-ai/sdk\";\nimport { type ServerTool } from \"@langchain/core/tools\";\n\n/**\n * Options for the tool search tool.\n */\nexport interface ToolSearchOptions {\n  /**\n   * Create a cache control breakpoint at this content block.\n   */\n  cacheControl?: Anthropic.Beta.BetaCacheControlEphemeral;\n}\n\n/**\n * Creates a regex-based tool search tool that enables Claude to work with hundreds\n * or thousands of tools by dynamically discovering and loading them on-demand.\n * Claude constructs regex patterns (using Python's `re.search()` syntax) to search\n * for tools by name, description, argument names, and argument descriptions.\n *\n * @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.\n *\n * @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}\n * @param options - Configuration options for the tool search tool\n * @returns A tool search tool definition to be passed to the Anthropic API\n *\n * @example\n * ```typescript\n * import { ChatAnthropic, tools } from \"@langchain/anthropic\";\n *\n * const model = new ChatAnthropic({\n *   model: \"claude-sonnet-4-5-20250929\",\n * });\n *\n * const getWeather = tool(\n *   async (input: { location: string }) => {\n *     return `Weather in ${input.location}`;\n *   },\n *   {\n *     name: \"get_weather\",\n *     description: \"Get the weather at a specific location\",\n *     schema: z.object({\n *       location: z.string(),\n *     }),\n *     extras: { defer_loading: true },\n *   },\n * );\n *\n * // Use with deferred tools - Claude will search and discover tools as needed\n * const response = await model.invoke(\"What is the weather in San Francisco?\", {\n *   tools: [\n *     tools.toolSearchRegex_20251119(),\n *     getWeather,\n *   ],\n * });\n * ```\n */\nexport function toolSearchRegex_20251119(\n  options?: ToolSearchOptions\n): ServerTool {\n  return {\n    type: \"tool_search_tool_regex_20251119\",\n    name: \"tool_search_tool_regex\",\n    cache_control: options?.cacheControl,\n  } satisfies Anthropic.Beta.Messages.BetaToolSearchToolRegex20251119;\n}\n\n/**\n * Creates a BM25-based tool search tool that enables Claude to work with hundreds\n * or thousands of tools by dynamically discovering and loading them on-demand.\n * Claude uses natural language queries to search for tools by name, description,\n * argument names, and argument descriptions.\n *\n * @note This tool requires the beta header `advanced-tool-use-2025-11-20` in API requests.\n *\n * @see {@link https://docs.anthropic.com/en/docs/build-with-claude/tool-use/tool-search-tool | Anthropic Tool Search Documentation}\n * @param options - Configuration options for the tool search tool\n * @returns A tool search tool definition to be passed to the Anthropic API\n *\n * @example\n * ```typescript\n * import { ChatAnthropic, tools } from \"@langchain/anthropic\";\n *\n * const model = new ChatAnthropic({\n *   model: \"claude-sonnet-4-5-20250929\",\n *   clientOptions: {\n *     defaultHeaders: { \"anthropic-beta\": \"advanced-tool-use-2025-11-20\" },\n *   },\n * });\n *\n * const getWeather = tool(\n *   async (input: { location: string }) => {\n *     return `Weather in ${input.location}`;\n *   },\n *   {\n *     name: \"get_weather\",\n *     description: \"Get the weather at a specific location\",\n *     schema: z.object({\n *       location: z.string(),\n *     }),\n *     extras: { defer_loading: true },\n *   },\n * );\n *\n * // Use with deferred tools - Claude will search using natural language\n * const response = await model.invoke(\"What is the weather in San Francisco?\", {\n *   tools: [\n *     tools.toolSearchBM25_20251119(),\n *     getWeather,\n *   ],\n * });\n * ```\n */\nexport function toolSearchBM25_20251119(\n  options?: ToolSearchOptions\n): ServerTool {\n  return {\n    type: \"tool_search_tool_bm25_20251119\",\n    name: \"tool_search_tool_bm25\",\n    cache_control: options?.cacheControl,\n  } satisfies Anthropic.Beta.Messages.BetaToolSearchToolBm25_20251119;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDA,SAAgB,yBACdA,SACY;AACZ,QAAO;EACL,MAAM;EACN,MAAM;EACN,eAAe,SAAS;CACzB;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDD,SAAgB,wBACdA,SACY;AACZ,QAAO;EACL,MAAM;EACN,MAAM;EACN,eAAe,SAAS;CACzB;AACF"}