@langchain/anthropic 0.3.0-rc.0 → 0.3.0

package/README.md

@@ -5,7 +5,7 @@ This package contains the LangChain.js integrations for Anthropic through their
 ## Installation
 
 ```bash npm2yarn
-npm install @langchain/anthropic
+npm install @langchain/anthropic @langchain/core
 ```
 
 This package, along with the main LangChain package, depends on [`@langchain/core`](https://npmjs.com/package/@langchain/core/).

package/dist/chat_models.cjs

@@ -553,7 +553,7 @@ class ChatAnthropicMessages extends chat_models_1.BaseChatModel {
             fields?.apiKey ??
                 fields?.anthropicApiKey ??
                 (0, env_1.getEnvironmentVariable)("ANTHROPIC_API_KEY");
-        if (!this.anthropicApiKey) {
+        if (!this.anthropicApiKey && !fields?.createClient) {
             throw new Error("Anthropic API key not found");
         }
         this.clientOptions = fields?.clientOptions ?? {};
@@ -593,38 +593,31 @@ class ChatAnthropicMessages extends chat_models_1.BaseChatModel {
      *
      * @param {ChatAnthropicCallOptions["tools"]} tools The tools to format
      * @returns {AnthropicTool[] | undefined} The formatted tools, or undefined if none are passed.
-     * @throws {Error} If a mix of AnthropicTools and StructuredTools are passed.
      */
     formatStructuredToolToAnthropic(tools) {
         if (!tools || !tools.length) {
             return undefined;
         }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        if (tools.every((tool) => isAnthropicTool(tool))) {
-            // If the tool is already an anthropic tool, return it
-            return tools;
-        }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        if (tools.every((tool) => (0, base_1.isOpenAITool)(tool))) {
-            // Formatted as OpenAI tool, convert to Anthropic tool
-            return tools.map((tc) => ({
-                name: tc.function.name,
-                description: tc.function.description,
-                input_schema: tc.function.parameters,
-            }));
-        }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        if (tools.some((tool) => isAnthropicTool(tool))) {
-            throw new Error(`Can not pass in a mix of tool schemas to ChatAnthropic`);
-        }
-        if (tools.every(function_calling_1.isLangChainTool)) {
-            return tools.map((t) => ({
-                name: t.name,
-                description: t.description,
-                input_schema: (0, zod_to_json_schema_1.zodToJsonSchema)(t.schema),
-            }));
-        }
-        throw new Error("Unsupported tool type passed to ChatAnthropic");
+        return tools.map((tool) => {
+            if (isAnthropicTool(tool)) {
+                return tool;
+            }
+            if ((0, base_1.isOpenAITool)(tool)) {
+                return {
+                    name: tool.function.name,
+                    description: tool.function.description,
+                    input_schema: tool.function.parameters,
+                };
+            }
+            if ((0, function_calling_1.isLangChainTool)(tool)) {
+                return {
+                    name: tool.name,
+                    description: tool.description,
+                    input_schema: (0, zod_to_json_schema_1.zodToJsonSchema)(tool.schema),
+                };
+            }
+            throw new Error(`Unknown tool type passed to ChatAnthropic: ${JSON.stringify(tool, null, 2)}`);
+        });
     }
     bindTools(tools, kwargs) {
         return this.bind({
@@ -791,9 +784,6 @@ class ChatAnthropicMessages extends chat_models_1.BaseChatModel {
     async completionWithRetry(request, options) {
         if (!this.batchClient) {
             const options = this.apiUrl ? { baseURL: this.apiUrl } : undefined;
-            if (!this.apiKey) {
-                throw new Error("Missing Anthropic API key.");
-            }
             this.batchClient = this.createClient({
                 ...this.clientOptions,
                 ...options,

package/dist/chat_models.d.ts

@@ -507,7 +507,6 @@ export declare class ChatAnthropicMessages<CallOptions extends ChatAnthropicCall
      *
      * @param {ChatAnthropicCallOptions["tools"]} tools The tools to format
      * @returns {AnthropicTool[] | undefined} The formatted tools, or undefined if none are passed.
-     * @throws {Error} If a mix of AnthropicTools and StructuredTools are passed.
      */
     formatStructuredToolToAnthropic(tools: ChatAnthropicCallOptions["tools"]): AnthropicTool[] | undefined;
     bindTools(tools: ChatAnthropicToolType[], kwargs?: Partial<CallOptions>): Runnable<BaseLanguageModelInput, AIMessageChunk, CallOptions>;
@@ -553,8 +552,17 @@ export declare class ChatAnthropicMessages<CallOptions extends ChatAnthropicCall
         generations: import("@langchain/core/outputs").ChatGeneration[];
         llmOutput: {
             id: string;
+            /** Does nucleus sampling, in which we compute the
+             * cumulative distribution over all the options for each
+             * subsequent token in decreasing probability order and
+             * cut it off once it reaches a particular probability
+             * specified by top_p. Defaults to -1, which disables it.
+             * Note that you should either alter temperature or top_p,
+             * but not both.
+             */
             model: Anthropic.Messages.Model;
             stop_reason: "tool_use" | "stop_sequence" | "end_turn" | "max_tokens" | null;
+            /** Anthropic API URL */
             stop_sequence: string | null;
             usage: Anthropic.Messages.Usage;
         };

package/dist/chat_models.js

@@ -550,7 +550,7 @@ export class ChatAnthropicMessages extends BaseChatModel {
             fields?.apiKey ??
                 fields?.anthropicApiKey ??
                 getEnvironmentVariable("ANTHROPIC_API_KEY");
-        if (!this.anthropicApiKey) {
+        if (!this.anthropicApiKey && !fields?.createClient) {
             throw new Error("Anthropic API key not found");
         }
         this.clientOptions = fields?.clientOptions ?? {};
@@ -590,38 +590,31 @@ export class ChatAnthropicMessages extends BaseChatModel {
      *
      * @param {ChatAnthropicCallOptions["tools"]} tools The tools to format
      * @returns {AnthropicTool[] | undefined} The formatted tools, or undefined if none are passed.
-     * @throws {Error} If a mix of AnthropicTools and StructuredTools are passed.
      */
     formatStructuredToolToAnthropic(tools) {
         if (!tools || !tools.length) {
             return undefined;
         }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        if (tools.every((tool) => isAnthropicTool(tool))) {
-            // If the tool is already an anthropic tool, return it
-            return tools;
-        }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        if (tools.every((tool) => isOpenAITool(tool))) {
-            // Formatted as OpenAI tool, convert to Anthropic tool
-            return tools.map((tc) => ({
-                name: tc.function.name,
-                description: tc.function.description,
-                input_schema: tc.function.parameters,
-            }));
-        }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        if (tools.some((tool) => isAnthropicTool(tool))) {
-            throw new Error(`Can not pass in a mix of tool schemas to ChatAnthropic`);
-        }
-        if (tools.every(isLangChainTool)) {
-            return tools.map((t) => ({
-                name: t.name,
-                description: t.description,
-                input_schema: zodToJsonSchema(t.schema),
-            }));
-        }
-        throw new Error("Unsupported tool type passed to ChatAnthropic");
+        return tools.map((tool) => {
+            if (isAnthropicTool(tool)) {
+                return tool;
+            }
+            if (isOpenAITool(tool)) {
+                return {
+                    name: tool.function.name,
+                    description: tool.function.description,
+                    input_schema: tool.function.parameters,
+                };
+            }
+            if (isLangChainTool(tool)) {
+                return {
+                    name: tool.name,
+                    description: tool.description,
+                    input_schema: zodToJsonSchema(tool.schema),
+                };
+            }
+            throw new Error(`Unknown tool type passed to ChatAnthropic: ${JSON.stringify(tool, null, 2)}`);
+        });
     }
     bindTools(tools, kwargs) {
         return this.bind({
@@ -788,9 +781,6 @@ export class ChatAnthropicMessages extends BaseChatModel {
     async completionWithRetry(request, options) {
         if (!this.batchClient) {
             const options = this.apiUrl ? { baseURL: this.apiUrl } : undefined;
-            if (!this.apiKey) {
-                throw new Error("Missing Anthropic API key.");
-            }
             this.batchClient = this.createClient({
                 ...this.clientOptions,
                 ...options,

package/dist/utils/message_inputs.cjs

@@ -103,6 +103,7 @@ function _formatContent(content) {
     }
     else {
         const contentBlocks = content.map((contentPart) => {
+            const cacheControl = "cache_control" in contentPart ? contentPart.cache_control : undefined;
             if (contentPart.type === "image_url") {
                 let source;
                 if (typeof contentPart.image_url === "string") {
@@ -114,6 +115,7 @@ function _formatContent(content) {
                 return {
                     type: "image",
                     source,
+                    ...(cacheControl ? { cache_control: cacheControl } : {}),
                 };
             }
             else if (textTypes.find((t) => t === contentPart.type) &&
@@ -122,6 +124,7 @@ function _formatContent(content) {
                 return {
                     type: "text",
                     text: contentPart.text,
+                    ...(cacheControl ? { cache_control: cacheControl } : {}),
                 };
             }
             else if (toolTypes.find((t) => t === contentPart.type)) {
@@ -147,6 +150,7 @@ function _formatContent(content) {
                 // TODO: Fix when SDK types are fixed
                 return {
                     ...contentPartCopy,
+                    ...(cacheControl ? { cache_control: cacheControl } : {}),
                     // eslint-disable-next-line @typescript-eslint/no-explicit-any
                 };
             }

package/dist/utils/message_inputs.js

@@ -99,6 +99,7 @@ function _formatContent(content) {
     }
     else {
         const contentBlocks = content.map((contentPart) => {
+            const cacheControl = "cache_control" in contentPart ? contentPart.cache_control : undefined;
             if (contentPart.type === "image_url") {
                 let source;
                 if (typeof contentPart.image_url === "string") {
@@ -110,6 +111,7 @@ function _formatContent(content) {
                 return {
                     type: "image",
                     source,
+                    ...(cacheControl ? { cache_control: cacheControl } : {}),
                 };
             }
             else if (textTypes.find((t) => t === contentPart.type) &&
@@ -118,6 +120,7 @@ function _formatContent(content) {
                 return {
                     type: "text",
                     text: contentPart.text,
+                    ...(cacheControl ? { cache_control: cacheControl } : {}),
                 };
             }
             else if (toolTypes.find((t) => t === contentPart.type)) {
@@ -143,6 +146,7 @@ function _formatContent(content) {
                 // TODO: Fix when SDK types are fixed
                 return {
                     ...contentPartCopy,
+                    ...(cacheControl ? { cache_control: cacheControl } : {}),
                     // eslint-disable-next-line @typescript-eslint/no-explicit-any
                 };
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/anthropic",
-  "version": "0.3.0-rc.0",
+  "version": "0.3.0",
   "description": "Anthropic integrations for LangChain.js",
   "type": "module",
   "engines": {
@@ -41,7 +41,7 @@
     "zod-to-json-schema": "^3.22.4"
   },
   "peerDependencies": {
-    "@langchain/core": ">=0.2.21 <0.4.0 || 0.3.0-rc.0"
+    "@langchain/core": ">=0.2.21 <0.4.0"
   },
   "devDependencies": {
     "@anthropic-ai/vertex-sdk": "^0.4.1",