@langchain/anthropic 1.2.3 → 1.3.0-dev-1765432861398

package/dist/tools/index.js

@@ -0,0 +1,28 @@
+import { memory_20250818 } from "./memory.js";
+import { webSearch_20250305 } from "./webSearch.js";
+import { webFetch_20250910 } from "./webFetch.js";
+import { toolSearchBM25_20251119, toolSearchRegex_20251119 } from "./toolSearch.js";
+import { textEditor_20250728 } from "./textEditor.js";
+import { computer_20250124, computer_20251124 } from "./computer.js";
+import { codeExecution_20250825 } from "./codeExecution.js";
+import { bash_20250124 } from "./bash.js";
+import { mcpToolset_20251120 } from "./mcpToolset.js";
+
+//#region src/tools/index.ts
+const tools = {
+	memory_20250818,
+	webSearch_20250305,
+	webFetch_20250910,
+	toolSearchRegex_20251119,
+	toolSearchBM25_20251119,
+	textEditor_20250728,
+	computer_20251124,
+	computer_20250124,
+	codeExecution_20250825,
+	bash_20250124,
+	mcpToolset_20251120
+};
+
+//#endregion
+export { tools };
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/tools/index.ts"],"sourcesContent":["import { memory_20250818 } from \"./memory.js\";\nimport {\n  webSearch_20250305,\n  type WebSearch20250305Options,\n} from \"./webSearch.js\";\nimport { webFetch_20250910, type WebFetch20250910Options } from \"./webFetch.js\";\nimport {\n  toolSearchRegex_20251119,\n  toolSearchBM25_20251119,\n  type ToolSearchOptions,\n} from \"./toolSearch.js\";\nimport {\n  textEditor_20250728,\n  type TextEditor20250728Options,\n} from \"./textEditor.js\";\nimport {\n  computer_20251124,\n  computer_20250124,\n  type Computer20251124Options,\n  type Computer20250124Options,\n  type ComputerUseReturnType,\n} from \"./computer.js\";\nimport {\n  codeExecution_20250825,\n  type CodeExecution20250825Options,\n} from \"./codeExecution.js\";\nimport { bash_20250124, type Bash20250124Options } from \"./bash.js\";\nimport { mcpToolset_20251120, type MCPToolsetOptions } from \"./mcpToolset.js\";\n\nexport const tools = {\n  memory_20250818,\n  webSearch_20250305,\n  webFetch_20250910,\n  toolSearchRegex_20251119,\n  toolSearchBM25_20251119,\n  textEditor_20250728,\n  computer_20251124,\n  computer_20250124,\n  codeExecution_20250825,\n  bash_20250124,\n  mcpToolset_20251120,\n};\n\nexport type {\n  MCPToolsetOptions,\n  Bash20250124Options,\n  Computer20251124Options,\n  Computer20250124Options,\n  ComputerUseReturnType,\n  CodeExecution20250825Options,\n  TextEditor20250728Options,\n  ToolSearchOptions,\n  WebFetch20250910Options,\n  WebSearch20250305Options,\n};\n\nexport type * from \"./types.js\";\n"],"mappings":";;;;;;;;;;;AA6BA,MAAa,QAAQ;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD"}

package/dist/tools/mcpToolset.cjs

@@ -0,0 +1,111 @@
+
+//#region src/tools/mcpToolset.ts
+/**
+* Creates an MCP toolset that connects to a remote MCP server to access its tools.
+* This enables Claude to use tools from MCP servers without implementing a separate MCP client.
+*
+* @note This tool requires the beta header `mcp-client-2025-11-20` in API requests.
+* The header is automatically added when using this tool.
+*
+* @see {@link https://docs.anthropic.com/en/docs/agents-and-tools/mcp-connector | Anthropic MCP Connector Documentation}
+* @param options - Configuration options for the MCP toolset
+* @returns An MCP toolset definition to be passed to the Anthropic API tools array
+*
+* @example
+* ```typescript
+* import { ChatAnthropic, tools } from "@langchain/anthropic";
+*
+* const model = new ChatAnthropic({
+*   model: "claude-sonnet-4-5-20250929",
+* });
+*
+* // Basic usage - enable all tools from an MCP server
+* const response = await model.invoke("What tools do you have available?", {
+*   mcp_servers: [{
+*     type: "url",
+*     url: "https://example-server.modelcontextprotocol.io/sse",
+*     name: "example-mcp",
+*     authorization_token: "YOUR_TOKEN",
+*   }],
+*   tools: [
+*     tools.mcpToolset_20251120({ serverName: "example-mcp" }),
+*   ],
+* });
+*
+* // Allowlist pattern - enable only specific tools
+* const responseAllowlist = await model.invoke("Search for events", {
+*   mcp_servers: [{
+*     type: "url",
+*     url: "https://calendar.example.com/sse",
+*     name: "google-calendar-mcp",
+*     authorization_token: "YOUR_TOKEN",
+*   }],
+*   tools: [
+*     tools.mcpToolset_20251120({
+*       serverName: "google-calendar-mcp",
+*       defaultConfig: { enabled: false },
+*       configs: {
+*         search_events: { enabled: true },
+*         create_event: { enabled: true },
+*       },
+*     }),
+*   ],
+* });
+*
+* // Denylist pattern - disable specific tools
+* const responseDenylist = await model.invoke("List my events", {
+*   mcp_servers: [{
+*     type: "url",
+*     url: "https://calendar.example.com/sse",
+*     name: "google-calendar-mcp",
+*     authorization_token: "YOUR_TOKEN",
+*   }],
+*   tools: [
+*     tools.mcpToolset_20251120({
+*       serverName: "google-calendar-mcp",
+*       configs: {
+*         delete_all_events: { enabled: false },
+*         share_calendar_publicly: { enabled: false },
+*       },
+*     }),
+*   ],
+* });
+*
+* // With deferred loading for use with Tool Search Tool
+* const responseDeferred = await model.invoke("Search for tools", {
+*   mcp_servers: [{
+*     type: "url",
+*     url: "https://example.com/sse",
+*     name: "example-mcp",
+*   }],
+*   tools: [
+*     tools.toolSearchRegex_20251119(),
+*     tools.mcpToolset_20251120({
+*       serverName: "example-mcp",
+*       defaultConfig: { deferLoading: true },
+*     }),
+*   ],
+* });
+* ```
+*/
+function mcpToolset_20251120(options) {
+	const defaultConfig = options.defaultConfig?.enabled !== void 0 || options.defaultConfig?.deferLoading !== void 0 ? {
+		enabled: options.defaultConfig?.enabled,
+		defer_loading: options.defaultConfig?.deferLoading
+	} : void 0;
+	const configs = options.configs ? Object.fromEntries(Object.entries(options.configs).map(([toolName, config]) => [toolName, {
+		enabled: config.enabled,
+		defer_loading: config.deferLoading
+	}])) : void 0;
+	return {
+		type: "mcp_toolset",
+		mcp_server_name: options.serverName,
+		default_config: defaultConfig,
+		configs,
+		cache_control: options.cacheControl
+	};
+}
+
+//#endregion
+exports.mcpToolset_20251120 = mcpToolset_20251120;
+//# sourceMappingURL=mcpToolset.cjs.map

package/dist/tools/mcpToolset.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolset.cjs","names":["options: MCPToolsetOptions"],"sources":["../../src/tools/mcpToolset.ts"],"sourcesContent":["import Anthropic from \"@anthropic-ai/sdk\";\nimport { type ServerTool } from \"@langchain/core/tools\";\n\n/**\n * Configuration for a single tool in the MCP toolset.\n */\nexport interface MCPToolConfig {\n  /**\n   * Whether this tool is enabled.\n   * @default true\n   */\n  enabled?: boolean;\n  /**\n   * If true, tool description is not sent to the model initially.\n   * Used with Tool Search Tool for on-demand loading.\n   * @default false\n   */\n  deferLoading?: boolean;\n}\n\n/**\n * Per-tool configuration overrides.\n * Keys are tool names, values are configuration objects.\n */\nexport type MCPToolConfigs = Record<string, MCPToolConfig>;\n\n/**\n * Options for creating an MCP toolset.\n */\nexport interface MCPToolsetOptions {\n  /**\n   * Must match a server name defined in the `mcp_servers` array in call options.\n   */\n  serverName: string;\n  /**\n   * Default configuration applied to all tools in this toolset.\n   * Individual tool configs will override these defaults.\n   */\n  defaultConfig?: MCPToolConfig;\n  /**\n   * Per-tool configuration overrides.\n   * Keys are tool names, values are configuration objects.\n   */\n  configs?: MCPToolConfigs;\n  /**\n   * Create a cache control breakpoint at this content block.\n   */\n  cacheControl?: Anthropic.Beta.BetaCacheControlEphemeral;\n}\n\n/**\n * Creates an MCP toolset that connects to a remote MCP server to access its tools.\n * This enables Claude to use tools from MCP servers without implementing a separate MCP client.\n *\n * @note This tool requires the beta header `mcp-client-2025-11-20` in API requests.\n * The header is automatically added when using this tool.\n *\n * @see {@link https://docs.anthropic.com/en/docs/agents-and-tools/mcp-connector | Anthropic MCP Connector Documentation}\n * @param options - Configuration options for the MCP toolset\n * @returns An MCP toolset definition to be passed to the Anthropic API tools array\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 * // Basic usage - enable all tools from an MCP server\n * const response = await model.invoke(\"What tools do you have available?\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://example-server.modelcontextprotocol.io/sse\",\n *     name: \"example-mcp\",\n *     authorization_token: \"YOUR_TOKEN\",\n *   }],\n *   tools: [\n *     tools.mcpToolset_20251120({ serverName: \"example-mcp\" }),\n *   ],\n * });\n *\n * // Allowlist pattern - enable only specific tools\n * const responseAllowlist = await model.invoke(\"Search for events\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://calendar.example.com/sse\",\n *     name: \"google-calendar-mcp\",\n *     authorization_token: \"YOUR_TOKEN\",\n *   }],\n *   tools: [\n *     tools.mcpToolset_20251120({\n *       serverName: \"google-calendar-mcp\",\n *       defaultConfig: { enabled: false },\n *       configs: {\n *         search_events: { enabled: true },\n *         create_event: { enabled: true },\n *       },\n *     }),\n *   ],\n * });\n *\n * // Denylist pattern - disable specific tools\n * const responseDenylist = await model.invoke(\"List my events\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://calendar.example.com/sse\",\n *     name: \"google-calendar-mcp\",\n *     authorization_token: \"YOUR_TOKEN\",\n *   }],\n *   tools: [\n *     tools.mcpToolset_20251120({\n *       serverName: \"google-calendar-mcp\",\n *       configs: {\n *         delete_all_events: { enabled: false },\n *         share_calendar_publicly: { enabled: false },\n *       },\n *     }),\n *   ],\n * });\n *\n * // With deferred loading for use with Tool Search Tool\n * const responseDeferred = await model.invoke(\"Search for tools\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://example.com/sse\",\n *     name: \"example-mcp\",\n *   }],\n *   tools: [\n *     tools.toolSearchRegex_20251119(),\n *     tools.mcpToolset_20251120({\n *       serverName: \"example-mcp\",\n *       defaultConfig: { deferLoading: true },\n *     }),\n *   ],\n * });\n * ```\n */\nexport function mcpToolset_20251120(options: MCPToolsetOptions): ServerTool {\n  const defaultConfig =\n    options.defaultConfig?.enabled !== undefined ||\n    options.defaultConfig?.deferLoading !== undefined\n      ? {\n          enabled: options.defaultConfig?.enabled,\n          defer_loading: options.defaultConfig?.deferLoading,\n        }\n      : undefined;\n\n  const configs = options.configs\n    ? Object.fromEntries(\n        Object.entries(options.configs).map(([toolName, config]) => [\n          toolName,\n          {\n            enabled: config.enabled,\n            defer_loading: config.deferLoading,\n          },\n        ])\n      )\n    : undefined;\n\n  return {\n    type: \"mcp_toolset\",\n    mcp_server_name: options.serverName,\n    default_config: defaultConfig,\n    configs,\n    cache_control: options.cacheControl,\n  } satisfies Anthropic.Beta.BetaMCPToolset;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0IA,SAAgB,oBAAoBA,SAAwC;CAC1E,MAAM,gBACJ,QAAQ,eAAe,YAAY,UACnC,QAAQ,eAAe,iBAAiB,SACpC;EACE,SAAS,QAAQ,eAAe;EAChC,eAAe,QAAQ,eAAe;CACvC,IACD;CAEN,MAAM,UAAU,QAAQ,UACpB,OAAO,YACL,OAAO,QAAQ,QAAQ,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,OAAO,KAAK,CAC1D,UACA;EACE,SAAS,OAAO;EAChB,eAAe,OAAO;CACvB,CACF,EAAC,CACH,GACD;AAEJ,QAAO;EACL,MAAM;EACN,iBAAiB,QAAQ;EACzB,gBAAgB;EAChB;EACA,eAAe,QAAQ;CACxB;AACF"}

package/dist/tools/mcpToolset.d.cts

@@ -0,0 +1,141 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { ServerTool } from "@langchain/core/tools";
+
+//#region src/tools/mcpToolset.d.ts
+
+/**
+ * Configuration for a single tool in the MCP toolset.
+ */
+interface MCPToolConfig {
+  /**
+   * Whether this tool is enabled.
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * If true, tool description is not sent to the model initially.
+   * Used with Tool Search Tool for on-demand loading.
+   * @default false
+   */
+  deferLoading?: boolean;
+}
+/**
+ * Per-tool configuration overrides.
+ * Keys are tool names, values are configuration objects.
+ */
+type MCPToolConfigs = Record<string, MCPToolConfig>;
+/**
+ * Options for creating an MCP toolset.
+ */
+interface MCPToolsetOptions {
+  /**
+   * Must match a server name defined in the `mcp_servers` array in call options.
+   */
+  serverName: string;
+  /**
+   * Default configuration applied to all tools in this toolset.
+   * Individual tool configs will override these defaults.
+   */
+  defaultConfig?: MCPToolConfig;
+  /**
+   * Per-tool configuration overrides.
+   * Keys are tool names, values are configuration objects.
+   */
+  configs?: MCPToolConfigs;
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cacheControl?: Anthropic.Beta.BetaCacheControlEphemeral;
+}
+/**
+ * Creates an MCP toolset that connects to a remote MCP server to access its tools.
+ * This enables Claude to use tools from MCP servers without implementing a separate MCP client.
+ *
+ * @note This tool requires the beta header `mcp-client-2025-11-20` in API requests.
+ * The header is automatically added when using this tool.
+ *
+ * @see {@link https://docs.anthropic.com/en/docs/agents-and-tools/mcp-connector | Anthropic MCP Connector Documentation}
+ * @param options - Configuration options for the MCP toolset
+ * @returns An MCP toolset definition to be passed to the Anthropic API tools array
+ *
+ * @example
+ * ```typescript
+ * import { ChatAnthropic, tools } from "@langchain/anthropic";
+ *
+ * const model = new ChatAnthropic({
+ *   model: "claude-sonnet-4-5-20250929",
+ * });
+ *
+ * // Basic usage - enable all tools from an MCP server
+ * const response = await model.invoke("What tools do you have available?", {
+ *   mcp_servers: [{
+ *     type: "url",
+ *     url: "https://example-server.modelcontextprotocol.io/sse",
+ *     name: "example-mcp",
+ *     authorization_token: "YOUR_TOKEN",
+ *   }],
+ *   tools: [
+ *     tools.mcpToolset_20251120({ serverName: "example-mcp" }),
+ *   ],
+ * });
+ *
+ * // Allowlist pattern - enable only specific tools
+ * const responseAllowlist = await model.invoke("Search for events", {
+ *   mcp_servers: [{
+ *     type: "url",
+ *     url: "https://calendar.example.com/sse",
+ *     name: "google-calendar-mcp",
+ *     authorization_token: "YOUR_TOKEN",
+ *   }],
+ *   tools: [
+ *     tools.mcpToolset_20251120({
+ *       serverName: "google-calendar-mcp",
+ *       defaultConfig: { enabled: false },
+ *       configs: {
+ *         search_events: { enabled: true },
+ *         create_event: { enabled: true },
+ *       },
+ *     }),
+ *   ],
+ * });
+ *
+ * // Denylist pattern - disable specific tools
+ * const responseDenylist = await model.invoke("List my events", {
+ *   mcp_servers: [{
+ *     type: "url",
+ *     url: "https://calendar.example.com/sse",
+ *     name: "google-calendar-mcp",
+ *     authorization_token: "YOUR_TOKEN",
+ *   }],
+ *   tools: [
+ *     tools.mcpToolset_20251120({
+ *       serverName: "google-calendar-mcp",
+ *       configs: {
+ *         delete_all_events: { enabled: false },
+ *         share_calendar_publicly: { enabled: false },
+ *       },
+ *     }),
+ *   ],
+ * });
+ *
+ * // With deferred loading for use with Tool Search Tool
+ * const responseDeferred = await model.invoke("Search for tools", {
+ *   mcp_servers: [{
+ *     type: "url",
+ *     url: "https://example.com/sse",
+ *     name: "example-mcp",
+ *   }],
+ *   tools: [
+ *     tools.toolSearchRegex_20251119(),
+ *     tools.mcpToolset_20251120({
+ *       serverName: "example-mcp",
+ *       defaultConfig: { deferLoading: true },
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+declare function mcpToolset_20251120(options: MCPToolsetOptions): ServerTool;
+//#endregion
+export { MCPToolsetOptions, mcpToolset_20251120 };
+//# sourceMappingURL=mcpToolset.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolset.d.cts","names":["Anthropic","ServerTool","MCPToolConfig","MCPToolConfigs","Record","MCPToolsetOptions","Beta","BetaCacheControlEphemeral","mcpToolset_20251120"],"sources":["../../src/tools/mcpToolset.d.ts"],"sourcesContent":["import Anthropic from \"@anthropic-ai/sdk\";\nimport { type ServerTool } from \"@langchain/core/tools\";\n/**\n * Configuration for a single tool in the MCP toolset.\n */\nexport interface MCPToolConfig {\n    /**\n     * Whether this tool is enabled.\n     * @default true\n     */\n    enabled?: boolean;\n    /**\n     * If true, tool description is not sent to the model initially.\n     * Used with Tool Search Tool for on-demand loading.\n     * @default false\n     */\n    deferLoading?: boolean;\n}\n/**\n * Per-tool configuration overrides.\n * Keys are tool names, values are configuration objects.\n */\nexport type MCPToolConfigs = Record<string, MCPToolConfig>;\n/**\n * Options for creating an MCP toolset.\n */\nexport interface MCPToolsetOptions {\n    /**\n     * Must match a server name defined in the `mcp_servers` array in call options.\n     */\n    serverName: string;\n    /**\n     * Default configuration applied to all tools in this toolset.\n     * Individual tool configs will override these defaults.\n     */\n    defaultConfig?: MCPToolConfig;\n    /**\n     * Per-tool configuration overrides.\n     * Keys are tool names, values are configuration objects.\n     */\n    configs?: MCPToolConfigs;\n    /**\n     * Create a cache control breakpoint at this content block.\n     */\n    cacheControl?: Anthropic.Beta.BetaCacheControlEphemeral;\n}\n/**\n * Creates an MCP toolset that connects to a remote MCP server to access its tools.\n * This enables Claude to use tools from MCP servers without implementing a separate MCP client.\n *\n * @note This tool requires the beta header `mcp-client-2025-11-20` in API requests.\n * The header is automatically added when using this tool.\n *\n * @see {@link https://docs.anthropic.com/en/docs/agents-and-tools/mcp-connector | Anthropic MCP Connector Documentation}\n * @param options - Configuration options for the MCP toolset\n * @returns An MCP toolset definition to be passed to the Anthropic API tools array\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 * // Basic usage - enable all tools from an MCP server\n * const response = await model.invoke(\"What tools do you have available?\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://example-server.modelcontextprotocol.io/sse\",\n *     name: \"example-mcp\",\n *     authorization_token: \"YOUR_TOKEN\",\n *   }],\n *   tools: [\n *     tools.mcpToolset_20251120({ serverName: \"example-mcp\" }),\n *   ],\n * });\n *\n * // Allowlist pattern - enable only specific tools\n * const responseAllowlist = await model.invoke(\"Search for events\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://calendar.example.com/sse\",\n *     name: \"google-calendar-mcp\",\n *     authorization_token: \"YOUR_TOKEN\",\n *   }],\n *   tools: [\n *     tools.mcpToolset_20251120({\n *       serverName: \"google-calendar-mcp\",\n *       defaultConfig: { enabled: false },\n *       configs: {\n *         search_events: { enabled: true },\n *         create_event: { enabled: true },\n *       },\n *     }),\n *   ],\n * });\n *\n * // Denylist pattern - disable specific tools\n * const responseDenylist = await model.invoke(\"List my events\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://calendar.example.com/sse\",\n *     name: \"google-calendar-mcp\",\n *     authorization_token: \"YOUR_TOKEN\",\n *   }],\n *   tools: [\n *     tools.mcpToolset_20251120({\n *       serverName: \"google-calendar-mcp\",\n *       configs: {\n *         delete_all_events: { enabled: false },\n *         share_calendar_publicly: { enabled: false },\n *       },\n *     }),\n *   ],\n * });\n *\n * // With deferred loading for use with Tool Search Tool\n * const responseDeferred = await model.invoke(\"Search for tools\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://example.com/sse\",\n *     name: \"example-mcp\",\n *   }],\n *   tools: [\n *     tools.toolSearchRegex_20251119(),\n *     tools.mcpToolset_20251120({\n *       serverName: \"example-mcp\",\n *       defaultConfig: { deferLoading: true },\n *     }),\n *   ],\n * });\n * ```\n */\nexport declare function mcpToolset_20251120(options: MCPToolsetOptions): ServerTool;\n//# sourceMappingURL=mcpToolset.d.ts.map"],"mappings":";;;;;;;AAKA;AAiBYG,UAjBKD,aAAAA,CAiBS;EAITG;;;;EAkB0C,OAAA,CAAA,EAAA,OAAA;EA0FnCG;;;;;;;;;;;KAhHZL,cAAAA,GAAiBC,eAAeF;;;;UAI3BG,iBAAAA;;;;;;;;;kBASGH;;;;;YAKNC;;;;iBAIKH,SAAAA,CAAUM,IAAAA,CAAKC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0FVC,mBAAAA,UAA6BH,oBAAoBJ"}

package/dist/tools/mcpToolset.d.ts

@@ -0,0 +1,141 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { ServerTool } from "@langchain/core/tools";
+
+//#region src/tools/mcpToolset.d.ts
+
+/**
+ * Configuration for a single tool in the MCP toolset.
+ */
+interface MCPToolConfig {
+  /**
+   * Whether this tool is enabled.
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * If true, tool description is not sent to the model initially.
+   * Used with Tool Search Tool for on-demand loading.
+   * @default false
+   */
+  deferLoading?: boolean;
+}
+/**
+ * Per-tool configuration overrides.
+ * Keys are tool names, values are configuration objects.
+ */
+type MCPToolConfigs = Record<string, MCPToolConfig>;
+/**
+ * Options for creating an MCP toolset.
+ */
+interface MCPToolsetOptions {
+  /**
+   * Must match a server name defined in the `mcp_servers` array in call options.
+   */
+  serverName: string;
+  /**
+   * Default configuration applied to all tools in this toolset.
+   * Individual tool configs will override these defaults.
+   */
+  defaultConfig?: MCPToolConfig;
+  /**
+   * Per-tool configuration overrides.
+   * Keys are tool names, values are configuration objects.
+   */
+  configs?: MCPToolConfigs;
+  /**
+   * Create a cache control breakpoint at this content block.
+   */
+  cacheControl?: Anthropic.Beta.BetaCacheControlEphemeral;
+}
+/**
+ * Creates an MCP toolset that connects to a remote MCP server to access its tools.
+ * This enables Claude to use tools from MCP servers without implementing a separate MCP client.
+ *
+ * @note This tool requires the beta header `mcp-client-2025-11-20` in API requests.
+ * The header is automatically added when using this tool.
+ *
+ * @see {@link https://docs.anthropic.com/en/docs/agents-and-tools/mcp-connector | Anthropic MCP Connector Documentation}
+ * @param options - Configuration options for the MCP toolset
+ * @returns An MCP toolset definition to be passed to the Anthropic API tools array
+ *
+ * @example
+ * ```typescript
+ * import { ChatAnthropic, tools } from "@langchain/anthropic";
+ *
+ * const model = new ChatAnthropic({
+ *   model: "claude-sonnet-4-5-20250929",
+ * });
+ *
+ * // Basic usage - enable all tools from an MCP server
+ * const response = await model.invoke("What tools do you have available?", {
+ *   mcp_servers: [{
+ *     type: "url",
+ *     url: "https://example-server.modelcontextprotocol.io/sse",
+ *     name: "example-mcp",
+ *     authorization_token: "YOUR_TOKEN",
+ *   }],
+ *   tools: [
+ *     tools.mcpToolset_20251120({ serverName: "example-mcp" }),
+ *   ],
+ * });
+ *
+ * // Allowlist pattern - enable only specific tools
+ * const responseAllowlist = await model.invoke("Search for events", {
+ *   mcp_servers: [{
+ *     type: "url",
+ *     url: "https://calendar.example.com/sse",
+ *     name: "google-calendar-mcp",
+ *     authorization_token: "YOUR_TOKEN",
+ *   }],
+ *   tools: [
+ *     tools.mcpToolset_20251120({
+ *       serverName: "google-calendar-mcp",
+ *       defaultConfig: { enabled: false },
+ *       configs: {
+ *         search_events: { enabled: true },
+ *         create_event: { enabled: true },
+ *       },
+ *     }),
+ *   ],
+ * });
+ *
+ * // Denylist pattern - disable specific tools
+ * const responseDenylist = await model.invoke("List my events", {
+ *   mcp_servers: [{
+ *     type: "url",
+ *     url: "https://calendar.example.com/sse",
+ *     name: "google-calendar-mcp",
+ *     authorization_token: "YOUR_TOKEN",
+ *   }],
+ *   tools: [
+ *     tools.mcpToolset_20251120({
+ *       serverName: "google-calendar-mcp",
+ *       configs: {
+ *         delete_all_events: { enabled: false },
+ *         share_calendar_publicly: { enabled: false },
+ *       },
+ *     }),
+ *   ],
+ * });
+ *
+ * // With deferred loading for use with Tool Search Tool
+ * const responseDeferred = await model.invoke("Search for tools", {
+ *   mcp_servers: [{
+ *     type: "url",
+ *     url: "https://example.com/sse",
+ *     name: "example-mcp",
+ *   }],
+ *   tools: [
+ *     tools.toolSearchRegex_20251119(),
+ *     tools.mcpToolset_20251120({
+ *       serverName: "example-mcp",
+ *       defaultConfig: { deferLoading: true },
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+declare function mcpToolset_20251120(options: MCPToolsetOptions): ServerTool;
+//#endregion
+export { MCPToolsetOptions, mcpToolset_20251120 };
+//# sourceMappingURL=mcpToolset.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolset.d.ts","names":["Anthropic","ServerTool","MCPToolConfig","MCPToolConfigs","Record","MCPToolsetOptions","Beta","BetaCacheControlEphemeral","mcpToolset_20251120"],"sources":["../../src/tools/mcpToolset.d.ts"],"sourcesContent":["import Anthropic from \"@anthropic-ai/sdk\";\nimport { type ServerTool } from \"@langchain/core/tools\";\n/**\n * Configuration for a single tool in the MCP toolset.\n */\nexport interface MCPToolConfig {\n    /**\n     * Whether this tool is enabled.\n     * @default true\n     */\n    enabled?: boolean;\n    /**\n     * If true, tool description is not sent to the model initially.\n     * Used with Tool Search Tool for on-demand loading.\n     * @default false\n     */\n    deferLoading?: boolean;\n}\n/**\n * Per-tool configuration overrides.\n * Keys are tool names, values are configuration objects.\n */\nexport type MCPToolConfigs = Record<string, MCPToolConfig>;\n/**\n * Options for creating an MCP toolset.\n */\nexport interface MCPToolsetOptions {\n    /**\n     * Must match a server name defined in the `mcp_servers` array in call options.\n     */\n    serverName: string;\n    /**\n     * Default configuration applied to all tools in this toolset.\n     * Individual tool configs will override these defaults.\n     */\n    defaultConfig?: MCPToolConfig;\n    /**\n     * Per-tool configuration overrides.\n     * Keys are tool names, values are configuration objects.\n     */\n    configs?: MCPToolConfigs;\n    /**\n     * Create a cache control breakpoint at this content block.\n     */\n    cacheControl?: Anthropic.Beta.BetaCacheControlEphemeral;\n}\n/**\n * Creates an MCP toolset that connects to a remote MCP server to access its tools.\n * This enables Claude to use tools from MCP servers without implementing a separate MCP client.\n *\n * @note This tool requires the beta header `mcp-client-2025-11-20` in API requests.\n * The header is automatically added when using this tool.\n *\n * @see {@link https://docs.anthropic.com/en/docs/agents-and-tools/mcp-connector | Anthropic MCP Connector Documentation}\n * @param options - Configuration options for the MCP toolset\n * @returns An MCP toolset definition to be passed to the Anthropic API tools array\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 * // Basic usage - enable all tools from an MCP server\n * const response = await model.invoke(\"What tools do you have available?\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://example-server.modelcontextprotocol.io/sse\",\n *     name: \"example-mcp\",\n *     authorization_token: \"YOUR_TOKEN\",\n *   }],\n *   tools: [\n *     tools.mcpToolset_20251120({ serverName: \"example-mcp\" }),\n *   ],\n * });\n *\n * // Allowlist pattern - enable only specific tools\n * const responseAllowlist = await model.invoke(\"Search for events\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://calendar.example.com/sse\",\n *     name: \"google-calendar-mcp\",\n *     authorization_token: \"YOUR_TOKEN\",\n *   }],\n *   tools: [\n *     tools.mcpToolset_20251120({\n *       serverName: \"google-calendar-mcp\",\n *       defaultConfig: { enabled: false },\n *       configs: {\n *         search_events: { enabled: true },\n *         create_event: { enabled: true },\n *       },\n *     }),\n *   ],\n * });\n *\n * // Denylist pattern - disable specific tools\n * const responseDenylist = await model.invoke(\"List my events\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://calendar.example.com/sse\",\n *     name: \"google-calendar-mcp\",\n *     authorization_token: \"YOUR_TOKEN\",\n *   }],\n *   tools: [\n *     tools.mcpToolset_20251120({\n *       serverName: \"google-calendar-mcp\",\n *       configs: {\n *         delete_all_events: { enabled: false },\n *         share_calendar_publicly: { enabled: false },\n *       },\n *     }),\n *   ],\n * });\n *\n * // With deferred loading for use with Tool Search Tool\n * const responseDeferred = await model.invoke(\"Search for tools\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://example.com/sse\",\n *     name: \"example-mcp\",\n *   }],\n *   tools: [\n *     tools.toolSearchRegex_20251119(),\n *     tools.mcpToolset_20251120({\n *       serverName: \"example-mcp\",\n *       defaultConfig: { deferLoading: true },\n *     }),\n *   ],\n * });\n * ```\n */\nexport declare function mcpToolset_20251120(options: MCPToolsetOptions): ServerTool;\n//# sourceMappingURL=mcpToolset.d.ts.map"],"mappings":";;;;;;;AAKA;AAiBYG,UAjBKD,aAAAA,CAiBS;EAITG;;;;EAkB0C,OAAA,CAAA,EAAA,OAAA;EA0FnCG;;;;;;;;;;;KAhHZL,cAAAA,GAAiBC,eAAeF;;;;UAI3BG,iBAAAA;;;;;;;;;kBASGH;;;;;YAKNC;;;;iBAIKH,SAAAA,CAAUM,IAAAA,CAAKC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0FVC,mBAAAA,UAA6BH,oBAAoBJ"}

package/dist/tools/mcpToolset.js

@@ -0,0 +1,110 @@
+//#region src/tools/mcpToolset.ts
+/**
+* Creates an MCP toolset that connects to a remote MCP server to access its tools.
+* This enables Claude to use tools from MCP servers without implementing a separate MCP client.
+*
+* @note This tool requires the beta header `mcp-client-2025-11-20` in API requests.
+* The header is automatically added when using this tool.
+*
+* @see {@link https://docs.anthropic.com/en/docs/agents-and-tools/mcp-connector | Anthropic MCP Connector Documentation}
+* @param options - Configuration options for the MCP toolset
+* @returns An MCP toolset definition to be passed to the Anthropic API tools array
+*
+* @example
+* ```typescript
+* import { ChatAnthropic, tools } from "@langchain/anthropic";
+*
+* const model = new ChatAnthropic({
+*   model: "claude-sonnet-4-5-20250929",
+* });
+*
+* // Basic usage - enable all tools from an MCP server
+* const response = await model.invoke("What tools do you have available?", {
+*   mcp_servers: [{
+*     type: "url",
+*     url: "https://example-server.modelcontextprotocol.io/sse",
+*     name: "example-mcp",
+*     authorization_token: "YOUR_TOKEN",
+*   }],
+*   tools: [
+*     tools.mcpToolset_20251120({ serverName: "example-mcp" }),
+*   ],
+* });
+*
+* // Allowlist pattern - enable only specific tools
+* const responseAllowlist = await model.invoke("Search for events", {
+*   mcp_servers: [{
+*     type: "url",
+*     url: "https://calendar.example.com/sse",
+*     name: "google-calendar-mcp",
+*     authorization_token: "YOUR_TOKEN",
+*   }],
+*   tools: [
+*     tools.mcpToolset_20251120({
+*       serverName: "google-calendar-mcp",
+*       defaultConfig: { enabled: false },
+*       configs: {
+*         search_events: { enabled: true },
+*         create_event: { enabled: true },
+*       },
+*     }),
+*   ],
+* });
+*
+* // Denylist pattern - disable specific tools
+* const responseDenylist = await model.invoke("List my events", {
+*   mcp_servers: [{
+*     type: "url",
+*     url: "https://calendar.example.com/sse",
+*     name: "google-calendar-mcp",
+*     authorization_token: "YOUR_TOKEN",
+*   }],
+*   tools: [
+*     tools.mcpToolset_20251120({
+*       serverName: "google-calendar-mcp",
+*       configs: {
+*         delete_all_events: { enabled: false },
+*         share_calendar_publicly: { enabled: false },
+*       },
+*     }),
+*   ],
+* });
+*
+* // With deferred loading for use with Tool Search Tool
+* const responseDeferred = await model.invoke("Search for tools", {
+*   mcp_servers: [{
+*     type: "url",
+*     url: "https://example.com/sse",
+*     name: "example-mcp",
+*   }],
+*   tools: [
+*     tools.toolSearchRegex_20251119(),
+*     tools.mcpToolset_20251120({
+*       serverName: "example-mcp",
+*       defaultConfig: { deferLoading: true },
+*     }),
+*   ],
+* });
+* ```
+*/
+function mcpToolset_20251120(options) {
+	const defaultConfig = options.defaultConfig?.enabled !== void 0 || options.defaultConfig?.deferLoading !== void 0 ? {
+		enabled: options.defaultConfig?.enabled,
+		defer_loading: options.defaultConfig?.deferLoading
+	} : void 0;
+	const configs = options.configs ? Object.fromEntries(Object.entries(options.configs).map(([toolName, config]) => [toolName, {
+		enabled: config.enabled,
+		defer_loading: config.deferLoading
+	}])) : void 0;
+	return {
+		type: "mcp_toolset",
+		mcp_server_name: options.serverName,
+		default_config: defaultConfig,
+		configs,
+		cache_control: options.cacheControl
+	};
+}
+
+//#endregion
+export { mcpToolset_20251120 };
+//# sourceMappingURL=mcpToolset.js.map

package/dist/tools/mcpToolset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolset.js","names":["options: MCPToolsetOptions"],"sources":["../../src/tools/mcpToolset.ts"],"sourcesContent":["import Anthropic from \"@anthropic-ai/sdk\";\nimport { type ServerTool } from \"@langchain/core/tools\";\n\n/**\n * Configuration for a single tool in the MCP toolset.\n */\nexport interface MCPToolConfig {\n  /**\n   * Whether this tool is enabled.\n   * @default true\n   */\n  enabled?: boolean;\n  /**\n   * If true, tool description is not sent to the model initially.\n   * Used with Tool Search Tool for on-demand loading.\n   * @default false\n   */\n  deferLoading?: boolean;\n}\n\n/**\n * Per-tool configuration overrides.\n * Keys are tool names, values are configuration objects.\n */\nexport type MCPToolConfigs = Record<string, MCPToolConfig>;\n\n/**\n * Options for creating an MCP toolset.\n */\nexport interface MCPToolsetOptions {\n  /**\n   * Must match a server name defined in the `mcp_servers` array in call options.\n   */\n  serverName: string;\n  /**\n   * Default configuration applied to all tools in this toolset.\n   * Individual tool configs will override these defaults.\n   */\n  defaultConfig?: MCPToolConfig;\n  /**\n   * Per-tool configuration overrides.\n   * Keys are tool names, values are configuration objects.\n   */\n  configs?: MCPToolConfigs;\n  /**\n   * Create a cache control breakpoint at this content block.\n   */\n  cacheControl?: Anthropic.Beta.BetaCacheControlEphemeral;\n}\n\n/**\n * Creates an MCP toolset that connects to a remote MCP server to access its tools.\n * This enables Claude to use tools from MCP servers without implementing a separate MCP client.\n *\n * @note This tool requires the beta header `mcp-client-2025-11-20` in API requests.\n * The header is automatically added when using this tool.\n *\n * @see {@link https://docs.anthropic.com/en/docs/agents-and-tools/mcp-connector | Anthropic MCP Connector Documentation}\n * @param options - Configuration options for the MCP toolset\n * @returns An MCP toolset definition to be passed to the Anthropic API tools array\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 * // Basic usage - enable all tools from an MCP server\n * const response = await model.invoke(\"What tools do you have available?\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://example-server.modelcontextprotocol.io/sse\",\n *     name: \"example-mcp\",\n *     authorization_token: \"YOUR_TOKEN\",\n *   }],\n *   tools: [\n *     tools.mcpToolset_20251120({ serverName: \"example-mcp\" }),\n *   ],\n * });\n *\n * // Allowlist pattern - enable only specific tools\n * const responseAllowlist = await model.invoke(\"Search for events\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://calendar.example.com/sse\",\n *     name: \"google-calendar-mcp\",\n *     authorization_token: \"YOUR_TOKEN\",\n *   }],\n *   tools: [\n *     tools.mcpToolset_20251120({\n *       serverName: \"google-calendar-mcp\",\n *       defaultConfig: { enabled: false },\n *       configs: {\n *         search_events: { enabled: true },\n *         create_event: { enabled: true },\n *       },\n *     }),\n *   ],\n * });\n *\n * // Denylist pattern - disable specific tools\n * const responseDenylist = await model.invoke(\"List my events\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://calendar.example.com/sse\",\n *     name: \"google-calendar-mcp\",\n *     authorization_token: \"YOUR_TOKEN\",\n *   }],\n *   tools: [\n *     tools.mcpToolset_20251120({\n *       serverName: \"google-calendar-mcp\",\n *       configs: {\n *         delete_all_events: { enabled: false },\n *         share_calendar_publicly: { enabled: false },\n *       },\n *     }),\n *   ],\n * });\n *\n * // With deferred loading for use with Tool Search Tool\n * const responseDeferred = await model.invoke(\"Search for tools\", {\n *   mcp_servers: [{\n *     type: \"url\",\n *     url: \"https://example.com/sse\",\n *     name: \"example-mcp\",\n *   }],\n *   tools: [\n *     tools.toolSearchRegex_20251119(),\n *     tools.mcpToolset_20251120({\n *       serverName: \"example-mcp\",\n *       defaultConfig: { deferLoading: true },\n *     }),\n *   ],\n * });\n * ```\n */\nexport function mcpToolset_20251120(options: MCPToolsetOptions): ServerTool {\n  const defaultConfig =\n    options.defaultConfig?.enabled !== undefined ||\n    options.defaultConfig?.deferLoading !== undefined\n      ? {\n          enabled: options.defaultConfig?.enabled,\n          defer_loading: options.defaultConfig?.deferLoading,\n        }\n      : undefined;\n\n  const configs = options.configs\n    ? Object.fromEntries(\n        Object.entries(options.configs).map(([toolName, config]) => [\n          toolName,\n          {\n            enabled: config.enabled,\n            defer_loading: config.deferLoading,\n          },\n        ])\n      )\n    : undefined;\n\n  return {\n    type: \"mcp_toolset\",\n    mcp_server_name: options.serverName,\n    default_config: defaultConfig,\n    configs,\n    cache_control: options.cacheControl,\n  } satisfies Anthropic.Beta.BetaMCPToolset;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0IA,SAAgB,oBAAoBA,SAAwC;CAC1E,MAAM,gBACJ,QAAQ,eAAe,YAAY,UACnC,QAAQ,eAAe,iBAAiB,SACpC;EACE,SAAS,QAAQ,eAAe;EAChC,eAAe,QAAQ,eAAe;CACvC,IACD;CAEN,MAAM,UAAU,QAAQ,UACpB,OAAO,YACL,OAAO,QAAQ,QAAQ,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,OAAO,KAAK,CAC1D,UACA;EACE,SAAS,OAAO;EAChB,eAAe,OAAO;CACvB,CACF,EAAC,CACH,GACD;AAEJ,QAAO;EACL,MAAM;EACN,iBAAiB,QAAQ;EACzB,gBAAgB;EAChB;EACA,eAAe,QAAQ;CACxB;AACF"}

package/dist/tools/memory.cjs

@@ -0,0 +1,56 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_types = require('./types.cjs');
+const __langchain_core_tools = require_rolldown_runtime.__toESM(require("@langchain/core/tools"));
+
+//#region src/tools/memory.ts
+/**
+* Creates an Anthropic memory tool that can be used with ChatAnthropic.
+*
+* The memory tool enables Claude to store and retrieve information across conversations
+* through a memory file directory. Claude can create, read, update, and delete files that
+* persist between sessions, allowing it to build knowledge over time without keeping
+* everything in the context window.
+*
+* @example
+* ```typescript
+* import { ChatAnthropic, memory_20250818 } from "@langchain/anthropic";
+*
+* const llm = new ChatAnthropic({
+*   model: "claude-sonnet-4-5-20250929"
+* });
+*
+* const memory = memory_20250818({
+*   execute: async (args) => {
+*     // handle memory command execution
+*     // ...
+*   },
+* });
+* const llmWithMemory = llm.bindTools([memory]);
+*
+* const response = await llmWithMemory.invoke("Remember that I like Python");
+* ```
+*
+* @param options - Optional configuration for the memory tool (currently unused)
+* @param options.execute - Optional execute function that handles memory command execution.
+* @returns The memory tool object that can be passed to `bindTools`
+*
+* @see https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/memory-tool
+*/
+function memory_20250818(options) {
+	const memoryTool = (0, __langchain_core_tools.tool)(options?.execute, {
+		name: "memory",
+		schema: require_types.Memory20250818CommandSchema
+	});
+	memoryTool.extras = {
+		...memoryTool.extras ?? {},
+		providerToolDefinition: {
+			type: "memory_20250818",
+			name: "memory"
+		}
+	};
+	return memoryTool;
+}
+
+//#endregion
+exports.memory_20250818 = memory_20250818;
+//# sourceMappingURL=memory.cjs.map

package/dist/tools/memory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.cjs","names":["options?: MemoryTool20250818Options","Memory20250818CommandSchema"],"sources":["../../src/tools/memory.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  Memory20250818CommandSchema,\n  type MemoryTool20250818Options,\n  type Memory20250818Command,\n} from \"./types.js\";\n\n/**\n * Creates an Anthropic memory tool that can be used with ChatAnthropic.\n *\n * The memory tool enables Claude to store and retrieve information across conversations\n * through a memory file directory. Claude can create, read, update, and delete files that\n * persist between sessions, allowing it to build knowledge over time without keeping\n * everything in the context window.\n *\n * @example\n * ```typescript\n * import { ChatAnthropic, memory_20250818 } from \"@langchain/anthropic\";\n *\n * const llm = new ChatAnthropic({\n *   model: \"claude-sonnet-4-5-20250929\"\n * });\n *\n * const memory = memory_20250818({\n *   execute: async (args) => {\n *     // handle memory command execution\n *     // ...\n *   },\n * });\n * const llmWithMemory = llm.bindTools([memory]);\n *\n * const response = await llmWithMemory.invoke(\"Remember that I like Python\");\n * ```\n *\n * @param options - Optional configuration for the memory tool (currently unused)\n * @param options.execute - Optional execute function that handles memory command execution.\n * @returns The memory tool object that can be passed to `bindTools`\n *\n * @see https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/memory-tool\n */\nexport function memory_20250818(options?: MemoryTool20250818Options) {\n  const memoryTool = tool(\n    options?.execute as (\n      input: unknown,\n      runtime: ToolRuntime<unknown, unknown>\n    ) => string | Promise<string>,\n    {\n      name: \"memory\",\n      schema: Memory20250818CommandSchema,\n    }\n  );\n\n  memoryTool.extras = {\n    ...(memoryTool.extras ?? {}),\n    providerToolDefinition: {\n      type: \"memory_20250818\",\n      name: \"memory\",\n    } satisfies Anthropic.Beta.BetaMemoryTool20250818,\n  };\n\n  return memoryTool as DynamicStructuredTool<\n    typeof Memory20250818CommandSchema,\n    Memory20250818Command,\n    unknown,\n    string | Promise<string>\n  >;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,SAAgB,gBAAgBA,SAAqC;CACnE,MAAM,8CACJ,SAAS,SAIT;EACE,MAAM;EACN,QAAQC;CACT,EACF;CAED,WAAW,SAAS;EAClB,GAAI,WAAW,UAAU,CAAE;EAC3B,wBAAwB;GACtB,MAAM;GACN,MAAM;EACP;CACF;AAED,QAAO;AAMR"}