@langchain/core 0.3.67 → 0.3.68

package/dist/messages/tool.cjs

@@ -51,6 +51,12 @@ class ToolMessage extends base_js_1.BaseMessage {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "metadata", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         /**
          * Artifact of the Tool execution which is not meant to be sent to the model.
          *
@@ -68,6 +74,7 @@ class ToolMessage extends base_js_1.BaseMessage {
         this.tool_call_id = fields.tool_call_id;
         this.artifact = fields.artifact;
         this.status = fields.status;
+        this.metadata = fields.metadata;
     }
     _getType() {
         return "tool";

package/dist/messages/tool.d.ts

@@ -18,6 +18,7 @@ export interface ToolMessageFieldsWithToolCallId extends ToolMessageFields {
      * @version 0.2.19
      */
     status?: "success" | "error";
+    metadata?: Record<string, unknown>;
 }
 /**
  * Marker parameter for objects that tools can return directly.
@@ -44,6 +45,7 @@ export declare class ToolMessage extends BaseMessage implements DirectToolOutput
      */
     status?: "success" | "error";
     tool_call_id: string;
+    metadata?: Record<string, unknown>;
     /**
      * Artifact of the Tool execution which is not meant to be sent to the model.
      *

package/dist/messages/tool.js

@@ -44,6 +44,12 @@ export class ToolMessage extends BaseMessage {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "metadata", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         /**
          * Artifact of the Tool execution which is not meant to be sent to the model.
          *
@@ -61,6 +67,7 @@ export class ToolMessage extends BaseMessage {
         this.tool_call_id = fields.tool_call_id;
         this.artifact = fields.artifact;
         this.status = fields.status;
+        this.metadata = fields.metadata;
     }
     _getType() {
         return "tool";

package/dist/tools/index.cjs

@@ -73,6 +73,7 @@ class StructuredTool extends base_js_1.BaseLangChain {
             fields?.verboseParsingErrors ?? this.verboseParsingErrors;
         this.responseFormat = fields?.responseFormat ?? this.responseFormat;
         this.defaultConfig = fields?.defaultConfig ?? this.defaultConfig;
+        this.metadata = fields?.metadata ?? this.metadata;
     }
     /**
      * Invokes the tool with the provided input and configuration.
@@ -185,6 +186,7 @@ class StructuredTool extends base_js_1.BaseLangChain {
             artifact,
             toolCallId,
             name: this.name,
+            metadata: this.metadata,
         });
         await runManager?.handleToolEnd(formattedOutput);
         return formattedOutput;
@@ -360,7 +362,7 @@ function tool(func, fields) {
         return new DynamicTool({
             ...fields,
             description: fields.description ??
-                fields.schema?.description ??
+                (fields.schema && (0, zod_js_1.getSchemaDescription)(fields.schema)) ??
                 `${fields.name} tool`,
             func: async (input, runManager, config) => {
                 return new Promise((resolve, reject) => {
@@ -407,7 +409,7 @@ function tool(func, fields) {
     });
 }
 function _formatToolOutput(params) {
-    const { content, artifact, toolCallId } = params;
+    const { content, artifact, toolCallId, metadata } = params;
     if (toolCallId && !(0, tool_js_1.isDirectToolOutput)(content)) {
         if (typeof content === "string" ||
             (Array.isArray(content) &&
@@ -417,6 +419,7 @@ function _formatToolOutput(params) {
                 artifact,
                 tool_call_id: toolCallId,
                 name: params.name,
+                metadata,
             });
         }
         else {
@@ -425,6 +428,7 @@ function _formatToolOutput(params) {
                 artifact,
                 tool_call_id: toolCallId,
                 name: params.name,
+                metadata,
             });
         }
     }

package/dist/tools/index.js

@@ -6,7 +6,7 @@ import { mergeConfigs, ensureConfig, patchConfig, pickRunnableConfigKeys, } from
 import { isDirectToolOutput, ToolMessage } from "../messages/tool.js";
 import { AsyncLocalStorageProviderSingleton } from "../singletons/index.js";
 import { _configHasToolCallId, _isToolCall, ToolInputParsingException, } from "./utils.js";
-import { interopParseAsync, isSimpleStringZodSchema, isInteropZodSchema, } from "../utils/types/zod.js";
+import { interopParseAsync, isSimpleStringZodSchema, isInteropZodSchema, getSchemaDescription, } from "../utils/types/zod.js";
 import { validatesOnlyStrings } from "../utils/json_schema.js";
 export { isLangChainTool, isRunnableToolLike, isStructuredTool, isStructuredToolParams, } from "./types.js";
 export { ToolInputParsingException };
@@ -65,6 +65,7 @@ export class StructuredTool extends BaseLangChain {
             fields?.verboseParsingErrors ?? this.verboseParsingErrors;
         this.responseFormat = fields?.responseFormat ?? this.responseFormat;
         this.defaultConfig = fields?.defaultConfig ?? this.defaultConfig;
+        this.metadata = fields?.metadata ?? this.metadata;
     }
     /**
      * Invokes the tool with the provided input and configuration.
@@ -177,6 +178,7 @@ export class StructuredTool extends BaseLangChain {
             artifact,
             toolCallId,
             name: this.name,
+            metadata: this.metadata,
         });
         await runManager?.handleToolEnd(formattedOutput);
         return formattedOutput;
@@ -347,7 +349,7 @@ export function tool(func, fields) {
         return new DynamicTool({
             ...fields,
             description: fields.description ??
-                fields.schema?.description ??
+                (fields.schema && getSchemaDescription(fields.schema)) ??
                 `${fields.name} tool`,
             func: async (input, runManager, config) => {
                 return new Promise((resolve, reject) => {
@@ -394,7 +396,7 @@ export function tool(func, fields) {
     });
 }
 function _formatToolOutput(params) {
-    const { content, artifact, toolCallId } = params;
+    const { content, artifact, toolCallId, metadata } = params;
     if (toolCallId && !isDirectToolOutput(content)) {
         if (typeof content === "string" ||
             (Array.isArray(content) &&
@@ -404,6 +406,7 @@ function _formatToolOutput(params) {
                 artifact,
                 tool_call_id: toolCallId,
                 name: params.name,
+                metadata,
             });
         }
         else {
@@ -412,6 +415,7 @@ function _formatToolOutput(params) {
                 artifact,
                 tool_call_id: toolCallId,
                 name: params.name,
+                metadata,
             });
         }
     }

package/dist/tools/types.d.ts

@@ -58,6 +58,10 @@ export interface ToolParams extends BaseLangChainParams {
      * @default false
      */
     verboseParsingErrors?: boolean;
+    /**
+     * Metadata for the tool.
+     */
+    metadata?: Record<string, unknown>;
 }
 export type ToolRunnableConfig<ConfigurableFieldType extends Record<string, any> = Record<string, any>> = RunnableConfig<ConfigurableFieldType> & {
     toolCall?: ToolCall;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/core",
-  "version": "0.3.67",
+  "version": "0.3.68",
   "description": "Core LangChain.js abstractions and schemas",
   "type": "module",
   "engines": {