@langchain/core 1.0.0-alpha.2 → 1.0.0-alpha.4

package/dist/messages/tool.d.cts

@@ -1,8 +1,8 @@
-import { BaseMessage, BaseMessageChunk, BaseMessageFields, MessageContent, MessageType } from "./base.cjs";
+import { BaseMessage, BaseMessageChunk, BaseMessageFields } from "./base.cjs";
+import { $InferMessageContent, MessageStructure } from "./message.cjs";
 
 //#region src/messages/tool.d.ts
-type ToolMessageFields = BaseMessageFields;
-interface ToolMessageFieldsWithToolCallId extends ToolMessageFields {
+interface ToolMessageFields<TStructure extends MessageStructure = MessageStructure> extends BaseMessageFields<TStructure, "tool"> {
   /**
    * Artifact of the Tool execution which is not meant to be sent to the model.
    *
@@ -13,10 +13,6 @@ interface ToolMessageFieldsWithToolCallId extends ToolMessageFields {
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   artifact?: any;
   tool_call_id: string;
-  /**
-   * Status of the tool invocation.
-   * @version 0.2.19
-   */
   status?: "success" | "error";
 }
 /**
@@ -33,11 +29,11 @@ declare function isDirectToolOutput(x: unknown): x is DirectToolOutput;
 /**
  * Represents a tool message in a conversation.
  */
-declare class ToolMessage extends BaseMessage implements DirectToolOutput {
-  content: MessageContent;
+declare class ToolMessage<TStructure extends MessageStructure = MessageStructure> extends BaseMessage<TStructure, "tool"> implements DirectToolOutput {
   static lc_name(): string;
   get lc_aliases(): Record<string, string>;
   lc_direct_tool_output: true;
+  readonly type: "tool";
   /**
    * Status of the tool invocation.
    * @version 0.2.19
@@ -53,18 +49,17 @@ declare class ToolMessage extends BaseMessage implements DirectToolOutput {
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   artifact?: any;
-  constructor(fields: ToolMessageFieldsWithToolCallId);
-  constructor(fields: string | ToolMessageFields, tool_call_id: string, name?: string);
-  _getType(): MessageType;
-  static isInstance(message: BaseMessage): message is ToolMessage;
+  constructor(fields: $InferMessageContent<TStructure, "tool"> | ToolMessageFields, tool_call_id: string, name?: string);
+  constructor(fields: ToolMessageFields<TStructure>);
+  static isInstance(message: unknown): message is ToolMessage;
   get _printableFields(): Record<string, unknown>;
 }
 /**
  * Represents a chunk of a tool message, which can be concatenated
  * with other tool message chunks.
  */
-declare class ToolMessageChunk extends BaseMessageChunk {
-  content: MessageContent;
+declare class ToolMessageChunk<TStructure extends MessageStructure = MessageStructure> extends BaseMessageChunk<TStructure, "tool"> {
+  readonly type: "tool";
   tool_call_id: string;
   /**
    * Status of the tool invocation.
@@ -80,25 +75,26 @@ declare class ToolMessageChunk extends BaseMessageChunk {
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   artifact?: any;
-  constructor(fields: ToolMessageFieldsWithToolCallId);
+  constructor(fields: ToolMessageFields<TStructure>);
   static lc_name(): string;
-  _getType(): MessageType;
-  concat(chunk: ToolMessageChunk): ToolMessageChunk;
+  concat(chunk: ToolMessageChunk<TStructure>): this;
   get _printableFields(): Record<string, unknown>;
 }
-/**
- * A call to a tool.
- * @property {string} name - The name of the tool to be called
- * @property {Record<string, any>} args - The arguments to the tool call
- * @property {string} [id] - If provided, an identifier associated with the tool call
- */
-type ToolCall = {
-  name: string;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  args: Record<string, any>;
+interface ToolCall<TName extends string = string, TArgs extends Record<string, unknown> = Record<string, unknown>> {
+  readonly type?: "tool_call";
+  /**
+   * If provided, an identifier associated with the tool call
+   */
   id?: string;
-  type?: "tool_call";
-};
+  /**
+   * The name of the tool being called
+   */
+  name: TName;
+  /**
+   * The arguments to the tool call
+   */
+  args: TArgs;
+}
 /**
  * A chunk of a tool call (e.g., as part of a stream).
  * When merging ToolCallChunks (e.g., via AIMessageChunk.__add__),
@@ -143,31 +139,61 @@ type ToolCall = {
  * //   }
  * // ]
  * ```
- *
- * @property {string} [name] - If provided, a substring of the name of the tool to be called
- * @property {string} [args] - If provided, a JSON substring of the arguments to the tool call
- * @property {string} [id] - If provided, a substring of an identifier for the tool call
- * @property {number} [index] - If provided, the index of the tool call in a sequence
  */
-type ToolCallChunk = {
-  name?: string;
-  args?: string;
+interface ToolCallChunk<TName extends string = string> {
+  readonly type?: "tool_call_chunk";
+  /**
+   * If provided, a substring of an identifier for the tool call
+   */
   id?: string;
-  index?: number;
-  type?: "tool_call_chunk";
-};
-type InvalidToolCall = {
-  name?: string;
+  /**
+   * If provided, a substring of the name of the tool to be called
+   */
+  name?: TName;
+  /**
+   * If provided, a JSON substring of the arguments to the tool call
+   */
   args?: string;
+  /**
+   * If provided, the index of the tool call in a sequence
+   */
+  index?: number;
+}
+interface InvalidToolCall<TName extends string = string> {
+  readonly type?: "invalid_tool_call";
+  /**
+   * If provided, an identifier associated with the tool call
+   */
   id?: string;
+  /**
+      /**
+     * The name of the tool being called
+     */
+  name?: TName;
+  /**
+   * The arguments to the tool call
+   */
+  args?: string;
+  /**
+   * An error message associated with the tool call
+   */
   error?: string;
-  type?: "invalid_tool_call";
-};
+  /**
+   * Index of block in aggregate response
+   */
+  index?: string | number;
+}
 declare function defaultToolCallParser(
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 rawToolCalls: Record<string, any>[]): [ToolCall[], InvalidToolCall[]];
+/**
+ * @deprecated Use {@link ToolMessage.isInstance} instead
+ */
 declare function isToolMessage(x: unknown): x is ToolMessage;
+/**
+ * @deprecated Use {@link ToolMessageChunk.isInstance} instead
+ */
 declare function isToolMessageChunk(x: BaseMessageChunk): x is ToolMessageChunk;
 //#endregion
-export { DirectToolOutput, InvalidToolCall, ToolCall, ToolCallChunk, ToolMessage, ToolMessageChunk, ToolMessageFields, ToolMessageFieldsWithToolCallId, defaultToolCallParser, isDirectToolOutput, isToolMessage, isToolMessageChunk };
+export { DirectToolOutput, InvalidToolCall, ToolCall, ToolCallChunk, ToolMessage, ToolMessageChunk, ToolMessageFields, defaultToolCallParser, isDirectToolOutput, isToolMessage, isToolMessageChunk };
 //# sourceMappingURL=tool.d.cts.map

package/dist/messages/tool.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.cts","names":["BaseMessage","BaseMessageChunk","BaseMessageFields","MessageType","MessageContent","ToolMessageFields","ToolMessageFieldsWithToolCallId","DirectToolOutput","isDirectToolOutput","ToolMessage","Record","ToolMessageChunk","ToolCall","ToolCallChunk","InvalidToolCall","defaultToolCallParser","isToolMessage","isToolMessageChunk"],"sources":["../../src/messages/tool.d.ts"],"sourcesContent":["import { BaseMessage, BaseMessageChunk, type BaseMessageFields, type MessageType, type MessageContent } from \"./base.js\";\nexport type ToolMessageFields = BaseMessageFields;\nexport interface ToolMessageFieldsWithToolCallId extends ToolMessageFields {\n    /**\n     * Artifact of the Tool execution which is not meant to be sent to the model.\n     *\n     * Should only be specified if it is different from the message content, e.g. if only\n     * a subset of the full tool output is being passed as message content but the full\n     * output is needed in other parts of the code.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    artifact?: any;\n    tool_call_id: string;\n    /**\n     * Status of the tool invocation.\n     * @version 0.2.19\n     */\n    status?: \"success\" | \"error\";\n}\n/**\n * Marker parameter for objects that tools can return directly.\n *\n * If a custom BaseTool is invoked with a ToolCall and the output of custom code is\n * not an instance of DirectToolOutput, the output will automatically be coerced to\n * a string and wrapped in a ToolMessage.\n */\nexport interface DirectToolOutput {\n    readonly lc_direct_tool_output: true;\n}\nexport declare function isDirectToolOutput(x: unknown): x is DirectToolOutput;\n/**\n * Represents a tool message in a conversation.\n */\nexport declare class ToolMessage extends BaseMessage implements DirectToolOutput {\n    content: MessageContent;\n    static lc_name(): string;\n    get lc_aliases(): Record<string, string>;\n    lc_direct_tool_output: true;\n    /**\n     * Status of the tool invocation.\n     * @version 0.2.19\n     */\n    status?: \"success\" | \"error\";\n    tool_call_id: string;\n    /**\n     * Artifact of the Tool execution which is not meant to be sent to the model.\n     *\n     * Should only be specified if it is different from the message content, e.g. if only\n     * a subset of the full tool output is being passed as message content but the full\n     * output is needed in other parts of the code.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    artifact?: any;\n    constructor(fields: ToolMessageFieldsWithToolCallId);\n    constructor(fields: string | ToolMessageFields, tool_call_id: string, name?: string);\n    _getType(): MessageType;\n    static isInstance(message: BaseMessage): message is ToolMessage;\n    get _printableFields(): Record<string, unknown>;\n}\n/**\n * Represents a chunk of a tool message, which can be concatenated\n * with other tool message chunks.\n */\nexport declare class ToolMessageChunk extends BaseMessageChunk {\n    content: MessageContent;\n    tool_call_id: string;\n    /**\n     * Status of the tool invocation.\n     * @version 0.2.19\n     */\n    status?: \"success\" | \"error\";\n    /**\n     * Artifact of the Tool execution which is not meant to be sent to the model.\n     *\n     * Should only be specified if it is different from the message content, e.g. if only\n     * a subset of the full tool output is being passed as message content but the full\n     * output is needed in other parts of the code.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    artifact?: any;\n    constructor(fields: ToolMessageFieldsWithToolCallId);\n    static lc_name(): string;\n    _getType(): MessageType;\n    concat(chunk: ToolMessageChunk): ToolMessageChunk;\n    get _printableFields(): Record<string, unknown>;\n}\n/**\n * A call to a tool.\n * @property {string} name - The name of the tool to be called\n * @property {Record<string, any>} args - The arguments to the tool call\n * @property {string} [id] - If provided, an identifier associated with the tool call\n */\nexport type ToolCall = {\n    name: string;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    args: Record<string, any>;\n    id?: string;\n    type?: \"tool_call\";\n};\n/**\n * A chunk of a tool call (e.g., as part of a stream).\n * When merging ToolCallChunks (e.g., via AIMessageChunk.__add__),\n * all string attributes are concatenated. Chunks are only merged if their\n * values of `index` are equal and not None.\n *\n * @example\n * ```ts\n * const leftChunks = [\n *   {\n *     name: \"foo\",\n *     args: '{\"a\":',\n *     index: 0\n *   }\n * ];\n *\n * const leftAIMessageChunk = new AIMessageChunk({\n *   content: \"\",\n *   tool_call_chunks: leftChunks\n * });\n *\n * const rightChunks = [\n *   {\n *     name: undefined,\n *     args: '1}',\n *     index: 0\n *   }\n * ];\n *\n * const rightAIMessageChunk = new AIMessageChunk({\n *   content: \"\",\n *   tool_call_chunks: rightChunks\n * });\n *\n * const result = leftAIMessageChunk.concat(rightAIMessageChunk);\n * // result.tool_call_chunks is equal to:\n * // [\n * //   {\n * //     name: \"foo\",\n * //     args: '{\"a\":1}'\n * //     index: 0\n * //   }\n * // ]\n * ```\n *\n * @property {string} [name] - If provided, a substring of the name of the tool to be called\n * @property {string} [args] - If provided, a JSON substring of the arguments to the tool call\n * @property {string} [id] - If provided, a substring of an identifier for the tool call\n * @property {number} [index] - If provided, the index of the tool call in a sequence\n */\nexport type ToolCallChunk = {\n    name?: string;\n    args?: string;\n    id?: string;\n    index?: number;\n    type?: \"tool_call_chunk\";\n};\nexport type InvalidToolCall = {\n    name?: string;\n    args?: string;\n    id?: string;\n    error?: string;\n    type?: \"invalid_tool_call\";\n};\nexport declare function defaultToolCallParser(\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nrawToolCalls: Record<string, any>[]): [ToolCall[], InvalidToolCall[]];\nexport declare function isToolMessage(x: unknown): x is ToolMessage;\nexport declare function isToolMessageChunk(x: BaseMessageChunk): x is ToolMessageChunk;\n"],"mappings":";;;KACYK,iBAAAA,GAAoBH;UACfI,+BAAAA,SAAwCD;EAD7CA;AACZ;AAwBA;AAGA;AAIA;;;EAC2B;EAEC,QAiBJC,CAAAA,EAAAA,GAAAA;EAA+B,YACtBD,EAAAA,MAAAA;EAAiB;;;;EAGhB,MAxBOL,CAAAA,EAAAA,SAAAA,GAAAA,OAAAA;;AAAuC;AA8BhF;;;;;;AAoBqCW,UAzDpBJ,gBAAAA,CAyDoBI;EAAgB,SACzBD,qBAAAA,EAAAA,IAAAA;;AArBkC,iBAlCtCF,kBAAAA,CAkCsC,CAAA,EAAA,OAAA,CAAA,EAAA,CAAA,IAlCDD,gBAkCC;AA6B9D;AAyDA;AAOA;AAOwBQ,cAlIHN,WAAAA,SAAoBT,WAAAA,YAAuBO,gBAkInB,CAAA;EAAA,OAAA,EAjIhCH,cAiIgC;EAAA,OAE/BM,OAAAA,CAAAA,CAAAA,EAAAA,MAAAA;EAAM,IAAmBE,UAAAA,CAAAA,CAAAA,EAjIjBF,MAiIiBE,CAAAA,MAAAA,EAAAA,MAAAA,CAAAA;EAAQ,qBAAIE,EAAAA,IAAAA;EAAe;AAClE;AACA;;EAA0C,MAAIb,CAAAA,EAAAA,SAAAA,GAAAA,OAAAA;EAAgB,YAAQU,EAAAA,MAAAA;EAAgB;;;;;;;;;sBAlH9DL;+BACSD;cACjBF;6BACeH,yBAAyBS;0BAC5BC;;;;;;cAMPC,gBAAAA,SAAyBV,gBAAAA;WACjCG;;;;;;;;;;;;;;;;sBAgBWE;;cAERH;gBACEQ,mBAAmBA;0BACTD;;;;;;;;KAQhBE,QAAAA;;;QAGFF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsDEG,aAAAA;;;;;;;KAOAC,eAAAA;;;;;;;iBAOYC,qBAAAA;;cAEVL,yBAAyBE,YAAYE;iBAC3BE,aAAAA,mBAAgCP;iBAChCQ,kBAAAA,IAAsBhB,wBAAwBU"}
+{"version":3,"file":"tool.d.cts","names":["BaseMessage","BaseMessageChunk","BaseMessageFields","$InferMessageContent","MessageStructure","ToolMessageFields","TStructure","DirectToolOutput","isDirectToolOutput","ToolMessage","Record","ToolMessageChunk","ToolCall","TName","TArgs","ToolCallChunk","InvalidToolCall","defaultToolCallParser","isToolMessage","isToolMessageChunk"],"sources":["../../src/messages/tool.d.ts"],"sourcesContent":["import { BaseMessage, BaseMessageChunk, type BaseMessageFields } from \"./base.js\";\nimport { $InferMessageContent, MessageStructure } from \"./message.js\";\nexport interface ToolMessageFields<TStructure extends MessageStructure = MessageStructure> extends BaseMessageFields<TStructure, \"tool\"> {\n    /**\n     * Artifact of the Tool execution which is not meant to be sent to the model.\n     *\n     * Should only be specified if it is different from the message content, e.g. if only\n     * a subset of the full tool output is being passed as message content but the full\n     * output is needed in other parts of the code.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    artifact?: any;\n    tool_call_id: string;\n    status?: \"success\" | \"error\";\n}\n/**\n * Marker parameter for objects that tools can return directly.\n *\n * If a custom BaseTool is invoked with a ToolCall and the output of custom code is\n * not an instance of DirectToolOutput, the output will automatically be coerced to\n * a string and wrapped in a ToolMessage.\n */\nexport interface DirectToolOutput {\n    readonly lc_direct_tool_output: true;\n}\nexport declare function isDirectToolOutput(x: unknown): x is DirectToolOutput;\n/**\n * Represents a tool message in a conversation.\n */\nexport declare class ToolMessage<TStructure extends MessageStructure = MessageStructure> extends BaseMessage<TStructure, \"tool\"> implements DirectToolOutput {\n    static lc_name(): string;\n    get lc_aliases(): Record<string, string>;\n    lc_direct_tool_output: true;\n    readonly type: \"tool\";\n    /**\n     * Status of the tool invocation.\n     * @version 0.2.19\n     */\n    status?: \"success\" | \"error\";\n    tool_call_id: string;\n    /**\n     * Artifact of the Tool execution which is not meant to be sent to the model.\n     *\n     * Should only be specified if it is different from the message content, e.g. if only\n     * a subset of the full tool output is being passed as message content but the full\n     * output is needed in other parts of the code.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    artifact?: any;\n    constructor(fields: $InferMessageContent<TStructure, \"tool\"> | ToolMessageFields, tool_call_id: string, name?: string);\n    constructor(fields: ToolMessageFields<TStructure>);\n    static isInstance(message: unknown): message is ToolMessage;\n    get _printableFields(): Record<string, unknown>;\n}\n/**\n * Represents a chunk of a tool message, which can be concatenated\n * with other tool message chunks.\n */\nexport declare class ToolMessageChunk<TStructure extends MessageStructure = MessageStructure> extends BaseMessageChunk<TStructure, \"tool\"> {\n    readonly type: \"tool\";\n    tool_call_id: string;\n    /**\n     * Status of the tool invocation.\n     * @version 0.2.19\n     */\n    status?: \"success\" | \"error\";\n    /**\n     * Artifact of the Tool execution which is not meant to be sent to the model.\n     *\n     * Should only be specified if it is different from the message content, e.g. if only\n     * a subset of the full tool output is being passed as message content but the full\n     * output is needed in other parts of the code.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    artifact?: any;\n    constructor(fields: ToolMessageFields<TStructure>);\n    static lc_name(): string;\n    concat(chunk: ToolMessageChunk<TStructure>): this;\n    get _printableFields(): Record<string, unknown>;\n}\nexport interface ToolCall<TName extends string = string, TArgs extends Record<string, unknown> = Record<string, unknown>> {\n    readonly type?: \"tool_call\";\n    /**\n     * If provided, an identifier associated with the tool call\n     */\n    id?: string;\n    /**\n     * The name of the tool being called\n     */\n    name: TName;\n    /**\n     * The arguments to the tool call\n     */\n    args: TArgs;\n}\n/**\n * A chunk of a tool call (e.g., as part of a stream).\n * When merging ToolCallChunks (e.g., via AIMessageChunk.__add__),\n * all string attributes are concatenated. Chunks are only merged if their\n * values of `index` are equal and not None.\n *\n * @example\n * ```ts\n * const leftChunks = [\n *   {\n *     name: \"foo\",\n *     args: '{\"a\":',\n *     index: 0\n *   }\n * ];\n *\n * const leftAIMessageChunk = new AIMessageChunk({\n *   content: \"\",\n *   tool_call_chunks: leftChunks\n * });\n *\n * const rightChunks = [\n *   {\n *     name: undefined,\n *     args: '1}',\n *     index: 0\n *   }\n * ];\n *\n * const rightAIMessageChunk = new AIMessageChunk({\n *   content: \"\",\n *   tool_call_chunks: rightChunks\n * });\n *\n * const result = leftAIMessageChunk.concat(rightAIMessageChunk);\n * // result.tool_call_chunks is equal to:\n * // [\n * //   {\n * //     name: \"foo\",\n * //     args: '{\"a\":1}'\n * //     index: 0\n * //   }\n * // ]\n * ```\n */\nexport interface ToolCallChunk<TName extends string = string> {\n    readonly type?: \"tool_call_chunk\";\n    /**\n     * If provided, a substring of an identifier for the tool call\n     */\n    id?: string;\n    /**\n     * If provided, a substring of the name of the tool to be called\n     */\n    name?: TName;\n    /**\n     * If provided, a JSON substring of the arguments to the tool call\n     */\n    args?: string;\n    /**\n     * If provided, the index of the tool call in a sequence\n     */\n    index?: number;\n}\nexport interface InvalidToolCall<TName extends string = string> {\n    readonly type?: \"invalid_tool_call\";\n    /**\n     * If provided, an identifier associated with the tool call\n     */\n    id?: string;\n    /**\n        /**\n       * The name of the tool being called\n       */\n    name?: TName;\n    /**\n     * The arguments to the tool call\n     */\n    args?: string;\n    /**\n     * An error message associated with the tool call\n     */\n    error?: string;\n    /**\n     * Index of block in aggregate response\n     */\n    index?: string | number;\n}\nexport declare function defaultToolCallParser(\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nrawToolCalls: Record<string, any>[]): [ToolCall[], InvalidToolCall[]];\n/**\n * @deprecated Use {@link ToolMessage.isInstance} instead\n */\nexport declare function isToolMessage(x: unknown): x is ToolMessage;\n/**\n * @deprecated Use {@link ToolMessageChunk.isInstance} instead\n */\nexport declare function isToolMessageChunk(x: BaseMessageChunk): x is ToolMessageChunk;\n"],"mappings":";;;;UAEiBK,qCAAqCD,mBAAmBA,0BAA0BF,kBAAkBI;;AAArH;;;;;;EAAoH;EAoBnGC,QAAAA,CAAAA,EAAAA,GAAAA;EAGOC,YAAAA,EAAAA,MAAAA;EAIHC,MAAAA,CAAAA,EAAAA,SAAW,GAAA,OAAA;;;;;;;;;AAqBUH,UA5BzBC,gBAAAA,CA4ByBD;EAAU,SAA5BD,qBAAAA,EAAAA,IAAAA;;AAEIK,iBA3BJF,kBAAAA,CA2BIE,CAAAA,EAAAA,OAAAA,CAAAA,EAAAA,CAAAA,IA3BiCH,gBA2BjCG;;;AAvBgI;AA6BvIC,cA7BAF,WA6BgB,CAAA,mBA7BeL,gBA6Bf,GA7BkCA,gBA6BlC,CAAA,SA7B4DJ,WA6B5D,CA7BwEM,UA6BxE,EAAA,MAAA,CAAA,YA7BuGC,gBA6BvG,CAAA;EAAA,OAAA,OAAA,CAAA,CAAA,EAAA,MAAA;EAAA,IAAoBH,UAAAA,CAAAA,CAAAA,EA3BnCM,MA2BmCN,CAAAA,MAAAA,EAAAA,MAAAA,CAAAA;EAAgB,qBAAGA,EAAAA,IAAAA;EAAgB,SAA2BE,IAAAA,EAAAA,MAAAA;EAAU;;;;EAmB/F,MACNI,CAAAA,EAAAA,SAAAA,GAAAA,OAAAA;EAAM,YApBoET,EAAAA,MAAAA;EAAgB;AAsBtH;;;;;;EAae;EA+CEc,QAAAA,CAAAA,EAAAA,GAAAA;EAmBAC,WAAAA,CAAAA,MAAe,EA9GRb,oBAwHR,CAxH6BG,UAwH7B,EAAA,MAAA,CAAA,GAxHmDD,iBAwHnD,EAAA,YAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAAA,MAAA;EAcQY,WAAAA,CAAAA,MAAAA,EArIAZ,iBAqIqB,CArIHC,UAqIG,CAAA;EAAA,OAAA,UAAA,CAAA,OAAA,EAAA,OAAA,CAAA,EAAA,OAAA,IApIOG,WAoIP;EAAA,IAE/BC,gBAAAA,CAAAA,CAAAA,EArIcA,MAqIdA,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA;;;AAAoD;AAIlE;AAIA;AAA0C,cAvIrBC,gBAuIqB,CAAA,mBAvIeP,gBAuIf,GAvIkCA,gBAuIlC,CAAA,SAvI4DH,gBAuI5D,CAvI6EK,UAuI7E,EAAA,MAAA,CAAA,CAAA;EAAA,SAAIL,IAAAA,EAAAA,MAAAA;EAAgB,YAAQU,EAAAA,MAAAA;EAAgB;;;;;;;;;;;;;;sBAtH9DN,kBAAkBC;;gBAExBK,iBAAiBL;0BACPI;;UAEXE,sDAAsDF,0BAA0BA;;;;;;;;;QASvFG;;;;QAIAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA+COC;;;;;;;;;SASNF;;;;;;;;;;UAUMG;;;;;;;;;;SAUNH;;;;;;;;;;;;;;iBAcaI,qBAAAA;;cAEVP,yBAAyBE,YAAYI;;;;iBAI3BE,aAAAA,mBAAgCT;;;;iBAIhCU,kBAAAA,IAAsBlB,wBAAwBU"}

package/dist/messages/tool.d.ts

@@ -1,8 +1,8 @@
-import { BaseMessage, BaseMessageChunk, BaseMessageFields, MessageContent, MessageType } from "./base.js";
+import { BaseMessage, BaseMessageChunk, BaseMessageFields } from "./base.js";
+import { $InferMessageContent, MessageStructure } from "./message.js";
 
 //#region src/messages/tool.d.ts
-type ToolMessageFields = BaseMessageFields;
-interface ToolMessageFieldsWithToolCallId extends ToolMessageFields {
+interface ToolMessageFields<TStructure extends MessageStructure = MessageStructure> extends BaseMessageFields<TStructure, "tool"> {
   /**
    * Artifact of the Tool execution which is not meant to be sent to the model.
    *
@@ -13,10 +13,6 @@ interface ToolMessageFieldsWithToolCallId extends ToolMessageFields {
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   artifact?: any;
   tool_call_id: string;
-  /**
-   * Status of the tool invocation.
-   * @version 0.2.19
-   */
   status?: "success" | "error";
 }
 /**
@@ -33,11 +29,11 @@ declare function isDirectToolOutput(x: unknown): x is DirectToolOutput;
 /**
  * Represents a tool message in a conversation.
  */
-declare class ToolMessage extends BaseMessage implements DirectToolOutput {
-  content: MessageContent;
+declare class ToolMessage<TStructure extends MessageStructure = MessageStructure> extends BaseMessage<TStructure, "tool"> implements DirectToolOutput {
   static lc_name(): string;
   get lc_aliases(): Record<string, string>;
   lc_direct_tool_output: true;
+  readonly type: "tool";
   /**
    * Status of the tool invocation.
    * @version 0.2.19
@@ -53,18 +49,17 @@ declare class ToolMessage extends BaseMessage implements DirectToolOutput {
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   artifact?: any;
-  constructor(fields: ToolMessageFieldsWithToolCallId);
-  constructor(fields: string | ToolMessageFields, tool_call_id: string, name?: string);
-  _getType(): MessageType;
-  static isInstance(message: BaseMessage): message is ToolMessage;
+  constructor(fields: $InferMessageContent<TStructure, "tool"> | ToolMessageFields, tool_call_id: string, name?: string);
+  constructor(fields: ToolMessageFields<TStructure>);
+  static isInstance(message: unknown): message is ToolMessage;
   get _printableFields(): Record<string, unknown>;
 }
 /**
  * Represents a chunk of a tool message, which can be concatenated
  * with other tool message chunks.
  */
-declare class ToolMessageChunk extends BaseMessageChunk {
-  content: MessageContent;
+declare class ToolMessageChunk<TStructure extends MessageStructure = MessageStructure> extends BaseMessageChunk<TStructure, "tool"> {
+  readonly type: "tool";
   tool_call_id: string;
   /**
    * Status of the tool invocation.
@@ -80,25 +75,26 @@ declare class ToolMessageChunk extends BaseMessageChunk {
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   artifact?: any;
-  constructor(fields: ToolMessageFieldsWithToolCallId);
+  constructor(fields: ToolMessageFields<TStructure>);
   static lc_name(): string;
-  _getType(): MessageType;
-  concat(chunk: ToolMessageChunk): ToolMessageChunk;
+  concat(chunk: ToolMessageChunk<TStructure>): this;
   get _printableFields(): Record<string, unknown>;
 }
-/**
- * A call to a tool.
- * @property {string} name - The name of the tool to be called
- * @property {Record<string, any>} args - The arguments to the tool call
- * @property {string} [id] - If provided, an identifier associated with the tool call
- */
-type ToolCall = {
-  name: string;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  args: Record<string, any>;
+interface ToolCall<TName extends string = string, TArgs extends Record<string, unknown> = Record<string, unknown>> {
+  readonly type?: "tool_call";
+  /**
+   * If provided, an identifier associated with the tool call
+   */
   id?: string;
-  type?: "tool_call";
-};
+  /**
+   * The name of the tool being called
+   */
+  name: TName;
+  /**
+   * The arguments to the tool call
+   */
+  args: TArgs;
+}
 /**
  * A chunk of a tool call (e.g., as part of a stream).
  * When merging ToolCallChunks (e.g., via AIMessageChunk.__add__),
@@ -143,31 +139,61 @@ type ToolCall = {
  * //   }
  * // ]
  * ```
- *
- * @property {string} [name] - If provided, a substring of the name of the tool to be called
- * @property {string} [args] - If provided, a JSON substring of the arguments to the tool call
- * @property {string} [id] - If provided, a substring of an identifier for the tool call
- * @property {number} [index] - If provided, the index of the tool call in a sequence
  */
-type ToolCallChunk = {
-  name?: string;
-  args?: string;
+interface ToolCallChunk<TName extends string = string> {
+  readonly type?: "tool_call_chunk";
+  /**
+   * If provided, a substring of an identifier for the tool call
+   */
   id?: string;
-  index?: number;
-  type?: "tool_call_chunk";
-};
-type InvalidToolCall = {
-  name?: string;
+  /**
+   * If provided, a substring of the name of the tool to be called
+   */
+  name?: TName;
+  /**
+   * If provided, a JSON substring of the arguments to the tool call
+   */
   args?: string;
+  /**
+   * If provided, the index of the tool call in a sequence
+   */
+  index?: number;
+}
+interface InvalidToolCall<TName extends string = string> {
+  readonly type?: "invalid_tool_call";
+  /**
+   * If provided, an identifier associated with the tool call
+   */
   id?: string;
+  /**
+      /**
+     * The name of the tool being called
+     */
+  name?: TName;
+  /**
+   * The arguments to the tool call
+   */
+  args?: string;
+  /**
+   * An error message associated with the tool call
+   */
   error?: string;
-  type?: "invalid_tool_call";
-};
+  /**
+   * Index of block in aggregate response
+   */
+  index?: string | number;
+}
 declare function defaultToolCallParser(
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 rawToolCalls: Record<string, any>[]): [ToolCall[], InvalidToolCall[]];
+/**
+ * @deprecated Use {@link ToolMessage.isInstance} instead
+ */
 declare function isToolMessage(x: unknown): x is ToolMessage;
+/**
+ * @deprecated Use {@link ToolMessageChunk.isInstance} instead
+ */
 declare function isToolMessageChunk(x: BaseMessageChunk): x is ToolMessageChunk;
 //#endregion
-export { DirectToolOutput, InvalidToolCall, ToolCall, ToolCallChunk, ToolMessage, ToolMessageChunk, ToolMessageFields, ToolMessageFieldsWithToolCallId, defaultToolCallParser, isDirectToolOutput, isToolMessage, isToolMessageChunk };
+export { DirectToolOutput, InvalidToolCall, ToolCall, ToolCallChunk, ToolMessage, ToolMessageChunk, ToolMessageFields, defaultToolCallParser, isDirectToolOutput, isToolMessage, isToolMessageChunk };
 //# sourceMappingURL=tool.d.ts.map

package/dist/messages/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","names":["BaseMessage","BaseMessageChunk","BaseMessageFields","MessageType","MessageContent","ToolMessageFields","ToolMessageFieldsWithToolCallId","DirectToolOutput","isDirectToolOutput","ToolMessage","Record","ToolMessageChunk","ToolCall","ToolCallChunk","InvalidToolCall","defaultToolCallParser","isToolMessage","isToolMessageChunk"],"sources":["../../src/messages/tool.d.ts"],"sourcesContent":["import { BaseMessage, BaseMessageChunk, type BaseMessageFields, type MessageType, type MessageContent } from \"./base.js\";\nexport type ToolMessageFields = BaseMessageFields;\nexport interface ToolMessageFieldsWithToolCallId extends ToolMessageFields {\n    /**\n     * Artifact of the Tool execution which is not meant to be sent to the model.\n     *\n     * Should only be specified if it is different from the message content, e.g. if only\n     * a subset of the full tool output is being passed as message content but the full\n     * output is needed in other parts of the code.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    artifact?: any;\n    tool_call_id: string;\n    /**\n     * Status of the tool invocation.\n     * @version 0.2.19\n     */\n    status?: \"success\" | \"error\";\n}\n/**\n * Marker parameter for objects that tools can return directly.\n *\n * If a custom BaseTool is invoked with a ToolCall and the output of custom code is\n * not an instance of DirectToolOutput, the output will automatically be coerced to\n * a string and wrapped in a ToolMessage.\n */\nexport interface DirectToolOutput {\n    readonly lc_direct_tool_output: true;\n}\nexport declare function isDirectToolOutput(x: unknown): x is DirectToolOutput;\n/**\n * Represents a tool message in a conversation.\n */\nexport declare class ToolMessage extends BaseMessage implements DirectToolOutput {\n    content: MessageContent;\n    static lc_name(): string;\n    get lc_aliases(): Record<string, string>;\n    lc_direct_tool_output: true;\n    /**\n     * Status of the tool invocation.\n     * @version 0.2.19\n     */\n    status?: \"success\" | \"error\";\n    tool_call_id: string;\n    /**\n     * Artifact of the Tool execution which is not meant to be sent to the model.\n     *\n     * Should only be specified if it is different from the message content, e.g. if only\n     * a subset of the full tool output is being passed as message content but the full\n     * output is needed in other parts of the code.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    artifact?: any;\n    constructor(fields: ToolMessageFieldsWithToolCallId);\n    constructor(fields: string | ToolMessageFields, tool_call_id: string, name?: string);\n    _getType(): MessageType;\n    static isInstance(message: BaseMessage): message is ToolMessage;\n    get _printableFields(): Record<string, unknown>;\n}\n/**\n * Represents a chunk of a tool message, which can be concatenated\n * with other tool message chunks.\n */\nexport declare class ToolMessageChunk extends BaseMessageChunk {\n    content: MessageContent;\n    tool_call_id: string;\n    /**\n     * Status of the tool invocation.\n     * @version 0.2.19\n     */\n    status?: \"success\" | \"error\";\n    /**\n     * Artifact of the Tool execution which is not meant to be sent to the model.\n     *\n     * Should only be specified if it is different from the message content, e.g. if only\n     * a subset of the full tool output is being passed as message content but the full\n     * output is needed in other parts of the code.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    artifact?: any;\n    constructor(fields: ToolMessageFieldsWithToolCallId);\n    static lc_name(): string;\n    _getType(): MessageType;\n    concat(chunk: ToolMessageChunk): ToolMessageChunk;\n    get _printableFields(): Record<string, unknown>;\n}\n/**\n * A call to a tool.\n * @property {string} name - The name of the tool to be called\n * @property {Record<string, any>} args - The arguments to the tool call\n * @property {string} [id] - If provided, an identifier associated with the tool call\n */\nexport type ToolCall = {\n    name: string;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    args: Record<string, any>;\n    id?: string;\n    type?: \"tool_call\";\n};\n/**\n * A chunk of a tool call (e.g., as part of a stream).\n * When merging ToolCallChunks (e.g., via AIMessageChunk.__add__),\n * all string attributes are concatenated. Chunks are only merged if their\n * values of `index` are equal and not None.\n *\n * @example\n * ```ts\n * const leftChunks = [\n *   {\n *     name: \"foo\",\n *     args: '{\"a\":',\n *     index: 0\n *   }\n * ];\n *\n * const leftAIMessageChunk = new AIMessageChunk({\n *   content: \"\",\n *   tool_call_chunks: leftChunks\n * });\n *\n * const rightChunks = [\n *   {\n *     name: undefined,\n *     args: '1}',\n *     index: 0\n *   }\n * ];\n *\n * const rightAIMessageChunk = new AIMessageChunk({\n *   content: \"\",\n *   tool_call_chunks: rightChunks\n * });\n *\n * const result = leftAIMessageChunk.concat(rightAIMessageChunk);\n * // result.tool_call_chunks is equal to:\n * // [\n * //   {\n * //     name: \"foo\",\n * //     args: '{\"a\":1}'\n * //     index: 0\n * //   }\n * // ]\n * ```\n *\n * @property {string} [name] - If provided, a substring of the name of the tool to be called\n * @property {string} [args] - If provided, a JSON substring of the arguments to the tool call\n * @property {string} [id] - If provided, a substring of an identifier for the tool call\n * @property {number} [index] - If provided, the index of the tool call in a sequence\n */\nexport type ToolCallChunk = {\n    name?: string;\n    args?: string;\n    id?: string;\n    index?: number;\n    type?: \"tool_call_chunk\";\n};\nexport type InvalidToolCall = {\n    name?: string;\n    args?: string;\n    id?: string;\n    error?: string;\n    type?: \"invalid_tool_call\";\n};\nexport declare function defaultToolCallParser(\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nrawToolCalls: Record<string, any>[]): [ToolCall[], InvalidToolCall[]];\nexport declare function isToolMessage(x: unknown): x is ToolMessage;\nexport declare function isToolMessageChunk(x: BaseMessageChunk): x is ToolMessageChunk;\n"],"mappings":";;;KACYK,iBAAAA,GAAoBH;UACfI,+BAAAA,SAAwCD;EAD7CA;AACZ;AAwBA;AAGA;AAIA;;;EAC2B;EAEC,QAiBJC,CAAAA,EAAAA,GAAAA;EAA+B,YACtBD,EAAAA,MAAAA;EAAiB;;;;EAGhB,MAxBOL,CAAAA,EAAAA,SAAAA,GAAAA,OAAAA;;AAAuC;AA8BhF;;;;;;AAoBqCW,UAzDpBJ,gBAAAA,CAyDoBI;EAAgB,SACzBD,qBAAAA,EAAAA,IAAAA;;AArBkC,iBAlCtCF,kBAAAA,CAkCsC,CAAA,EAAA,OAAA,CAAA,EAAA,CAAA,IAlCDD,gBAkCC;AA6B9D;AAyDA;AAOA;AAOwBQ,cAlIHN,WAAAA,SAAoBT,WAAAA,YAAuBO,gBAkInB,CAAA;EAAA,OAAA,EAjIhCH,cAiIgC;EAAA,OAE/BM,OAAAA,CAAAA,CAAAA,EAAAA,MAAAA;EAAM,IAAmBE,UAAAA,CAAAA,CAAAA,EAjIjBF,MAiIiBE,CAAAA,MAAAA,EAAAA,MAAAA,CAAAA;EAAQ,qBAAIE,EAAAA,IAAAA;EAAe;AAClE;AACA;;EAA0C,MAAIb,CAAAA,EAAAA,SAAAA,GAAAA,OAAAA;EAAgB,YAAQU,EAAAA,MAAAA;EAAgB;;;;;;;;;sBAlH9DL;+BACSD;cACjBF;6BACeH,yBAAyBS;0BAC5BC;;;;;;cAMPC,gBAAAA,SAAyBV,gBAAAA;WACjCG;;;;;;;;;;;;;;;;sBAgBWE;;cAERH;gBACEQ,mBAAmBA;0BACTD;;;;;;;;KAQhBE,QAAAA;;;QAGFF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsDEG,aAAAA;;;;;;;KAOAC,eAAAA;;;;;;;iBAOYC,qBAAAA;;cAEVL,yBAAyBE,YAAYE;iBAC3BE,aAAAA,mBAAgCP;iBAChCQ,kBAAAA,IAAsBhB,wBAAwBU"}
+{"version":3,"file":"tool.d.ts","names":["BaseMessage","BaseMessageChunk","BaseMessageFields","$InferMessageContent","MessageStructure","ToolMessageFields","TStructure","DirectToolOutput","isDirectToolOutput","ToolMessage","Record","ToolMessageChunk","ToolCall","TName","TArgs","ToolCallChunk","InvalidToolCall","defaultToolCallParser","isToolMessage","isToolMessageChunk"],"sources":["../../src/messages/tool.d.ts"],"sourcesContent":["import { BaseMessage, BaseMessageChunk, type BaseMessageFields } from \"./base.js\";\nimport { $InferMessageContent, MessageStructure } from \"./message.js\";\nexport interface ToolMessageFields<TStructure extends MessageStructure = MessageStructure> extends BaseMessageFields<TStructure, \"tool\"> {\n    /**\n     * Artifact of the Tool execution which is not meant to be sent to the model.\n     *\n     * Should only be specified if it is different from the message content, e.g. if only\n     * a subset of the full tool output is being passed as message content but the full\n     * output is needed in other parts of the code.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    artifact?: any;\n    tool_call_id: string;\n    status?: \"success\" | \"error\";\n}\n/**\n * Marker parameter for objects that tools can return directly.\n *\n * If a custom BaseTool is invoked with a ToolCall and the output of custom code is\n * not an instance of DirectToolOutput, the output will automatically be coerced to\n * a string and wrapped in a ToolMessage.\n */\nexport interface DirectToolOutput {\n    readonly lc_direct_tool_output: true;\n}\nexport declare function isDirectToolOutput(x: unknown): x is DirectToolOutput;\n/**\n * Represents a tool message in a conversation.\n */\nexport declare class ToolMessage<TStructure extends MessageStructure = MessageStructure> extends BaseMessage<TStructure, \"tool\"> implements DirectToolOutput {\n    static lc_name(): string;\n    get lc_aliases(): Record<string, string>;\n    lc_direct_tool_output: true;\n    readonly type: \"tool\";\n    /**\n     * Status of the tool invocation.\n     * @version 0.2.19\n     */\n    status?: \"success\" | \"error\";\n    tool_call_id: string;\n    /**\n     * Artifact of the Tool execution which is not meant to be sent to the model.\n     *\n     * Should only be specified if it is different from the message content, e.g. if only\n     * a subset of the full tool output is being passed as message content but the full\n     * output is needed in other parts of the code.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    artifact?: any;\n    constructor(fields: $InferMessageContent<TStructure, \"tool\"> | ToolMessageFields, tool_call_id: string, name?: string);\n    constructor(fields: ToolMessageFields<TStructure>);\n    static isInstance(message: unknown): message is ToolMessage;\n    get _printableFields(): Record<string, unknown>;\n}\n/**\n * Represents a chunk of a tool message, which can be concatenated\n * with other tool message chunks.\n */\nexport declare class ToolMessageChunk<TStructure extends MessageStructure = MessageStructure> extends BaseMessageChunk<TStructure, \"tool\"> {\n    readonly type: \"tool\";\n    tool_call_id: string;\n    /**\n     * Status of the tool invocation.\n     * @version 0.2.19\n     */\n    status?: \"success\" | \"error\";\n    /**\n     * Artifact of the Tool execution which is not meant to be sent to the model.\n     *\n     * Should only be specified if it is different from the message content, e.g. if only\n     * a subset of the full tool output is being passed as message content but the full\n     * output is needed in other parts of the code.\n     */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    artifact?: any;\n    constructor(fields: ToolMessageFields<TStructure>);\n    static lc_name(): string;\n    concat(chunk: ToolMessageChunk<TStructure>): this;\n    get _printableFields(): Record<string, unknown>;\n}\nexport interface ToolCall<TName extends string = string, TArgs extends Record<string, unknown> = Record<string, unknown>> {\n    readonly type?: \"tool_call\";\n    /**\n     * If provided, an identifier associated with the tool call\n     */\n    id?: string;\n    /**\n     * The name of the tool being called\n     */\n    name: TName;\n    /**\n     * The arguments to the tool call\n     */\n    args: TArgs;\n}\n/**\n * A chunk of a tool call (e.g., as part of a stream).\n * When merging ToolCallChunks (e.g., via AIMessageChunk.__add__),\n * all string attributes are concatenated. Chunks are only merged if their\n * values of `index` are equal and not None.\n *\n * @example\n * ```ts\n * const leftChunks = [\n *   {\n *     name: \"foo\",\n *     args: '{\"a\":',\n *     index: 0\n *   }\n * ];\n *\n * const leftAIMessageChunk = new AIMessageChunk({\n *   content: \"\",\n *   tool_call_chunks: leftChunks\n * });\n *\n * const rightChunks = [\n *   {\n *     name: undefined,\n *     args: '1}',\n *     index: 0\n *   }\n * ];\n *\n * const rightAIMessageChunk = new AIMessageChunk({\n *   content: \"\",\n *   tool_call_chunks: rightChunks\n * });\n *\n * const result = leftAIMessageChunk.concat(rightAIMessageChunk);\n * // result.tool_call_chunks is equal to:\n * // [\n * //   {\n * //     name: \"foo\",\n * //     args: '{\"a\":1}'\n * //     index: 0\n * //   }\n * // ]\n * ```\n */\nexport interface ToolCallChunk<TName extends string = string> {\n    readonly type?: \"tool_call_chunk\";\n    /**\n     * If provided, a substring of an identifier for the tool call\n     */\n    id?: string;\n    /**\n     * If provided, a substring of the name of the tool to be called\n     */\n    name?: TName;\n    /**\n     * If provided, a JSON substring of the arguments to the tool call\n     */\n    args?: string;\n    /**\n     * If provided, the index of the tool call in a sequence\n     */\n    index?: number;\n}\nexport interface InvalidToolCall<TName extends string = string> {\n    readonly type?: \"invalid_tool_call\";\n    /**\n     * If provided, an identifier associated with the tool call\n     */\n    id?: string;\n    /**\n        /**\n       * The name of the tool being called\n       */\n    name?: TName;\n    /**\n     * The arguments to the tool call\n     */\n    args?: string;\n    /**\n     * An error message associated with the tool call\n     */\n    error?: string;\n    /**\n     * Index of block in aggregate response\n     */\n    index?: string | number;\n}\nexport declare function defaultToolCallParser(\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nrawToolCalls: Record<string, any>[]): [ToolCall[], InvalidToolCall[]];\n/**\n * @deprecated Use {@link ToolMessage.isInstance} instead\n */\nexport declare function isToolMessage(x: unknown): x is ToolMessage;\n/**\n * @deprecated Use {@link ToolMessageChunk.isInstance} instead\n */\nexport declare function isToolMessageChunk(x: BaseMessageChunk): x is ToolMessageChunk;\n"],"mappings":";;;;UAEiBK,qCAAqCD,mBAAmBA,0BAA0BF,kBAAkBI;;AAArH;;;;;;EAAoH;EAoBnGC,QAAAA,CAAAA,EAAAA,GAAAA;EAGOC,YAAAA,EAAAA,MAAAA;EAIHC,MAAAA,CAAAA,EAAAA,SAAW,GAAA,OAAA;;;;;;;;;AAqBUH,UA5BzBC,gBAAAA,CA4ByBD;EAAU,SAA5BD,qBAAAA,EAAAA,IAAAA;;AAEIK,iBA3BJF,kBAAAA,CA2BIE,CAAAA,EAAAA,OAAAA,CAAAA,EAAAA,CAAAA,IA3BiCH,gBA2BjCG;;;AAvBgI;AA6BvIC,cA7BAF,WA6BgB,CAAA,mBA7BeL,gBA6Bf,GA7BkCA,gBA6BlC,CAAA,SA7B4DJ,WA6B5D,CA7BwEM,UA6BxE,EAAA,MAAA,CAAA,YA7BuGC,gBA6BvG,CAAA;EAAA,OAAA,OAAA,CAAA,CAAA,EAAA,MAAA;EAAA,IAAoBH,UAAAA,CAAAA,CAAAA,EA3BnCM,MA2BmCN,CAAAA,MAAAA,EAAAA,MAAAA,CAAAA;EAAgB,qBAAGA,EAAAA,IAAAA;EAAgB,SAA2BE,IAAAA,EAAAA,MAAAA;EAAU;;;;EAmB/F,MACNI,CAAAA,EAAAA,SAAAA,GAAAA,OAAAA;EAAM,YApBoET,EAAAA,MAAAA;EAAgB;AAsBtH;;;;;;EAae;EA+CEc,QAAAA,CAAAA,EAAAA,GAAAA;EAmBAC,WAAAA,CAAAA,MAAe,EA9GRb,oBAwHR,CAxH6BG,UAwH7B,EAAA,MAAA,CAAA,GAxHmDD,iBAwHnD,EAAA,YAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAAA,MAAA;EAcQY,WAAAA,CAAAA,MAAAA,EArIAZ,iBAqIqB,CArIHC,UAqIG,CAAA;EAAA,OAAA,UAAA,CAAA,OAAA,EAAA,OAAA,CAAA,EAAA,OAAA,IApIOG,WAoIP;EAAA,IAE/BC,gBAAAA,CAAAA,CAAAA,EArIcA,MAqIdA,CAAAA,MAAAA,EAAAA,OAAAA,CAAAA;;;AAAoD;AAIlE;AAIA;AAA0C,cAvIrBC,gBAuIqB,CAAA,mBAvIeP,gBAuIf,GAvIkCA,gBAuIlC,CAAA,SAvI4DH,gBAuI5D,CAvI6EK,UAuI7E,EAAA,MAAA,CAAA,CAAA;EAAA,SAAIL,IAAAA,EAAAA,MAAAA;EAAgB,YAAQU,EAAAA,MAAAA;EAAgB;;;;;;;;;;;;;;sBAtH9DN,kBAAkBC;;gBAExBK,iBAAiBL;0BACPI;;UAEXE,sDAAsDF,0BAA0BA;;;;;;;;;QASvFG;;;;QAIAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA+COC;;;;;;;;;SASNF;;;;;;;;;;UAUMG;;;;;;;;;;SAUNH;;;;;;;;;;;;;;iBAcaI,qBAAAA;;cAEVP,yBAAyBE,YAAYI;;;;iBAI3BE,aAAAA,mBAAgCT;;;;iBAIhCU,kBAAAA,IAAsBlB,wBAAwBU"}

package/dist/messages/tool.js

@@ -25,6 +25,7 @@ var ToolMessage = class extends BaseMessage {
 		return { tool_call_id: "tool_call_id" };
 	}
 	lc_direct_tool_output = true;
+	type = "tool";
 	/**
 	* Status of the tool invocation.
 	* @version 0.2.19
@@ -40,21 +41,18 @@ var ToolMessage = class extends BaseMessage {
 	*/
 	artifact;
 	constructor(fields, tool_call_id, name) {
-		if (typeof fields === "string") fields = {
+		const toolMessageFields = typeof fields === "string" || Array.isArray(fields) ? {
 			content: fields,
 			name,
 			tool_call_id
-		};
-		super(fields);
-		this.tool_call_id = fields.tool_call_id;
-		this.artifact = fields.artifact;
-		this.status = fields.status;
-	}
-	_getType() {
-		return "tool";
+		} : fields;
+		super(toolMessageFields);
+		this.tool_call_id = toolMessageFields.tool_call_id;
+		this.artifact = toolMessageFields.artifact;
+		this.status = toolMessageFields.status;
 	}
 	static isInstance(message) {
-		return message._getType() === "tool";
+		return super.isInstance(message) && message.type === "tool";
 	}
 	get _printableFields() {
 		return {
@@ -68,7 +66,8 @@ var ToolMessage = class extends BaseMessage {
 * Represents a chunk of a tool message, which can be concatenated
 * with other tool message chunks.
 */
-var ToolMessageChunk = class ToolMessageChunk extends BaseMessageChunk {
+var ToolMessageChunk = class extends BaseMessageChunk {
+	type = "tool";
 	tool_call_id;
 	/**
 	* Status of the tool invocation.
@@ -92,11 +91,9 @@ var ToolMessageChunk = class ToolMessageChunk extends BaseMessageChunk {
 	static lc_name() {
 		return "ToolMessageChunk";
 	}
-	_getType() {
-		return "tool";
-	}
 	concat(chunk) {
-		return new ToolMessageChunk({
+		const Cls = this.constructor;
+		return new Cls({
 			content: mergeContent(this.content, chunk.content),
 			additional_kwargs: _mergeDicts(this.additional_kwargs, chunk.additional_kwargs),
 			response_metadata: _mergeDicts(this.response_metadata, chunk.response_metadata),
@@ -122,13 +119,12 @@ function defaultToolCallParser(rawToolCalls) {
 		const functionName = toolCall.function.name;
 		try {
 			const functionArgs = JSON.parse(toolCall.function.arguments);
-			const parsed = {
+			toolCalls.push({
 				name: functionName || "",
 				args: functionArgs || {},
 				id: toolCall.id
-			};
-			toolCalls.push(parsed);
-		} catch (error) {
+			});
+		} catch {
 			invalidToolCalls.push({
 				name: functionName,
 				args: toolCall.function.arguments,
@@ -139,9 +135,15 @@ function defaultToolCallParser(rawToolCalls) {
 	}
 	return [toolCalls, invalidToolCalls];
 }
+/**
+* @deprecated Use {@link ToolMessage.isInstance} instead
+*/
 function isToolMessage(x) {
 	return typeof x === "object" && x !== null && "getType" in x && typeof x.getType === "function" && x.getType() === "tool";
 }
+/**
+* @deprecated Use {@link ToolMessageChunk.isInstance} instead
+*/
 function isToolMessageChunk(x) {
 	return x._getType() === "tool";
 }

package/dist/messages/tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.js","names":["x: unknown","fields: string | ToolMessageFieldsWithToolCallId","tool_call_id?: string","name?: string","message: BaseMessage","fields: ToolMessageFieldsWithToolCallId","chunk: ToolMessageChunk","rawToolCalls: Record<string, any>[]","toolCalls: ToolCall[]","invalidToolCalls: InvalidToolCall[]","x: BaseMessageChunk"],"sources":["../../src/messages/tool.ts"],"sourcesContent":["import {\n  BaseMessage,\n  BaseMessageChunk,\n  type BaseMessageFields,\n  mergeContent,\n  _mergeDicts,\n  type MessageType,\n  _mergeObj,\n  _mergeStatus,\n  type MessageContent,\n} from \"./base.js\";\n\nexport type ToolMessageFields = BaseMessageFields;\n\nexport interface ToolMessageFieldsWithToolCallId extends ToolMessageFields {\n  /**\n   * Artifact of the Tool execution which is not meant to be sent to the model.\n   *\n   * Should only be specified if it is different from the message content, e.g. if only\n   * a subset of the full tool output is being passed as message content but the full\n   * output is needed in other parts of the code.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  artifact?: any;\n  tool_call_id: string;\n  /**\n   * Status of the tool invocation.\n   * @version 0.2.19\n   */\n  status?: \"success\" | \"error\";\n}\n\n/**\n * Marker parameter for objects that tools can return directly.\n *\n * If a custom BaseTool is invoked with a ToolCall and the output of custom code is\n * not an instance of DirectToolOutput, the output will automatically be coerced to\n * a string and wrapped in a ToolMessage.\n */\nexport interface DirectToolOutput {\n  readonly lc_direct_tool_output: true;\n}\n\nexport function isDirectToolOutput(x: unknown): x is DirectToolOutput {\n  return (\n    x != null &&\n    typeof x === \"object\" &&\n    \"lc_direct_tool_output\" in x &&\n    x.lc_direct_tool_output === true\n  );\n}\n\n/**\n * Represents a tool message in a conversation.\n */\nexport class ToolMessage extends BaseMessage implements DirectToolOutput {\n  declare content: MessageContent;\n\n  static lc_name() {\n    return \"ToolMessage\";\n  }\n\n  get lc_aliases(): Record<string, string> {\n    // exclude snake case conversion to pascal case\n    return { tool_call_id: \"tool_call_id\" };\n  }\n\n  lc_direct_tool_output = true as const;\n\n  /**\n   * Status of the tool invocation.\n   * @version 0.2.19\n   */\n  status?: \"success\" | \"error\";\n\n  tool_call_id: string;\n\n  /**\n   * Artifact of the Tool execution which is not meant to be sent to the model.\n   *\n   * Should only be specified if it is different from the message content, e.g. if only\n   * a subset of the full tool output is being passed as message content but the full\n   * output is needed in other parts of the code.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  artifact?: any;\n\n  constructor(fields: ToolMessageFieldsWithToolCallId);\n\n  constructor(\n    fields: string | ToolMessageFields,\n    tool_call_id: string,\n    name?: string\n  );\n\n  constructor(\n    fields: string | ToolMessageFieldsWithToolCallId,\n    tool_call_id?: string,\n    name?: string\n  ) {\n    if (typeof fields === \"string\") {\n      // eslint-disable-next-line no-param-reassign, @typescript-eslint/no-non-null-assertion\n      fields = { content: fields, name, tool_call_id: tool_call_id! };\n    }\n    super(fields);\n    this.tool_call_id = fields.tool_call_id;\n    this.artifact = fields.artifact;\n    this.status = fields.status;\n  }\n\n  _getType(): MessageType {\n    return \"tool\";\n  }\n\n  static isInstance(message: BaseMessage): message is ToolMessage {\n    return message._getType() === \"tool\";\n  }\n\n  override get _printableFields(): Record<string, unknown> {\n    return {\n      ...super._printableFields,\n      tool_call_id: this.tool_call_id,\n      artifact: this.artifact,\n    };\n  }\n}\n\n/**\n * Represents a chunk of a tool message, which can be concatenated\n * with other tool message chunks.\n */\nexport class ToolMessageChunk extends BaseMessageChunk {\n  declare content: MessageContent;\n\n  tool_call_id: string;\n\n  /**\n   * Status of the tool invocation.\n   * @version 0.2.19\n   */\n  status?: \"success\" | \"error\";\n\n  /**\n   * Artifact of the Tool execution which is not meant to be sent to the model.\n   *\n   * Should only be specified if it is different from the message content, e.g. if only\n   * a subset of the full tool output is being passed as message content but the full\n   * output is needed in other parts of the code.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  artifact?: any;\n\n  constructor(fields: ToolMessageFieldsWithToolCallId) {\n    super(fields);\n    this.tool_call_id = fields.tool_call_id;\n    this.artifact = fields.artifact;\n    this.status = fields.status;\n  }\n\n  static lc_name() {\n    return \"ToolMessageChunk\";\n  }\n\n  _getType(): MessageType {\n    return \"tool\";\n  }\n\n  concat(chunk: ToolMessageChunk) {\n    return new ToolMessageChunk({\n      content: mergeContent(this.content, chunk.content),\n      additional_kwargs: _mergeDicts(\n        this.additional_kwargs,\n        chunk.additional_kwargs\n      ),\n      response_metadata: _mergeDicts(\n        this.response_metadata,\n        chunk.response_metadata\n      ),\n      artifact: _mergeObj(this.artifact, chunk.artifact),\n      tool_call_id: this.tool_call_id,\n      id: this.id ?? chunk.id,\n      status: _mergeStatus(this.status, chunk.status),\n    });\n  }\n\n  override get _printableFields(): Record<string, unknown> {\n    return {\n      ...super._printableFields,\n      tool_call_id: this.tool_call_id,\n      artifact: this.artifact,\n    };\n  }\n}\n\n/**\n * A call to a tool.\n * @property {string} name - The name of the tool to be called\n * @property {Record<string, any>} args - The arguments to the tool call\n * @property {string} [id] - If provided, an identifier associated with the tool call\n */\nexport type ToolCall = {\n  name: string;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  args: Record<string, any>;\n\n  id?: string;\n\n  type?: \"tool_call\";\n};\n\n/**\n * A chunk of a tool call (e.g., as part of a stream).\n * When merging ToolCallChunks (e.g., via AIMessageChunk.__add__),\n * all string attributes are concatenated. Chunks are only merged if their\n * values of `index` are equal and not None.\n *\n * @example\n * ```ts\n * const leftChunks = [\n *   {\n *     name: \"foo\",\n *     args: '{\"a\":',\n *     index: 0\n *   }\n * ];\n *\n * const leftAIMessageChunk = new AIMessageChunk({\n *   content: \"\",\n *   tool_call_chunks: leftChunks\n * });\n *\n * const rightChunks = [\n *   {\n *     name: undefined,\n *     args: '1}',\n *     index: 0\n *   }\n * ];\n *\n * const rightAIMessageChunk = new AIMessageChunk({\n *   content: \"\",\n *   tool_call_chunks: rightChunks\n * });\n *\n * const result = leftAIMessageChunk.concat(rightAIMessageChunk);\n * // result.tool_call_chunks is equal to:\n * // [\n * //   {\n * //     name: \"foo\",\n * //     args: '{\"a\":1}'\n * //     index: 0\n * //   }\n * // ]\n * ```\n *\n * @property {string} [name] - If provided, a substring of the name of the tool to be called\n * @property {string} [args] - If provided, a JSON substring of the arguments to the tool call\n * @property {string} [id] - If provided, a substring of an identifier for the tool call\n * @property {number} [index] - If provided, the index of the tool call in a sequence\n */\nexport type ToolCallChunk = {\n  name?: string;\n\n  args?: string;\n\n  id?: string;\n\n  index?: number;\n\n  type?: \"tool_call_chunk\";\n};\n\nexport type InvalidToolCall = {\n  name?: string;\n  args?: string;\n  id?: string;\n  error?: string;\n  type?: \"invalid_tool_call\";\n};\n\nexport function defaultToolCallParser(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  rawToolCalls: Record<string, any>[]\n): [ToolCall[], InvalidToolCall[]] {\n  const toolCalls: ToolCall[] = [];\n  const invalidToolCalls: InvalidToolCall[] = [];\n  for (const toolCall of rawToolCalls) {\n    if (!toolCall.function) {\n      continue;\n    } else {\n      const functionName = toolCall.function.name;\n      try {\n        const functionArgs = JSON.parse(toolCall.function.arguments);\n        const parsed = {\n          name: functionName || \"\",\n          args: functionArgs || {},\n          id: toolCall.id,\n        };\n        toolCalls.push(parsed);\n      } catch (error) {\n        invalidToolCalls.push({\n          name: functionName,\n          args: toolCall.function.arguments,\n          id: toolCall.id,\n          error: \"Malformed args.\",\n        });\n      }\n    }\n  }\n  return [toolCalls, invalidToolCalls];\n}\n\nexport function isToolMessage(x: unknown): x is ToolMessage {\n  return (\n    typeof x === \"object\" &&\n    x !== null &&\n    \"getType\" in x &&\n    typeof x.getType === \"function\" &&\n    x.getType() === \"tool\"\n  );\n}\n\nexport function isToolMessageChunk(x: BaseMessageChunk): x is ToolMessageChunk {\n  return x._getType() === \"tool\";\n}\n"],"mappings":";;;;;;;;;;;;;AA2CA,SAAgB,mBAAmBA,GAAmC;AACpE,QACE,KAAK,QACL,OAAO,MAAM,YACb,2BAA2B,KAC3B,EAAE,0BAA0B;AAE/B;;;;AAKD,IAAa,cAAb,cAAiC,YAAwC;CAGvE,OAAO,UAAU;AACf,SAAO;CACR;CAED,IAAI,aAAqC;AAEvC,SAAO,EAAE,cAAc,eAAgB;CACxC;CAED,wBAAwB;;;;;CAMxB;CAEA;;;;;;;;CAUA;CAUA,YACEC,QACAC,cACAC,MACA;AACA,MAAI,OAAO,WAAW,UAEpB,SAAS;GAAE,SAAS;GAAQ;GAAoB;EAAe;EAEjE,MAAM,OAAO;EACb,KAAK,eAAe,OAAO;EAC3B,KAAK,WAAW,OAAO;EACvB,KAAK,SAAS,OAAO;CACtB;CAED,WAAwB;AACtB,SAAO;CACR;CAED,OAAO,WAAWC,SAA8C;AAC9D,SAAO,QAAQ,UAAU,KAAK;CAC/B;CAED,IAAa,mBAA4C;AACvD,SAAO;GACL,GAAG,MAAM;GACT,cAAc,KAAK;GACnB,UAAU,KAAK;EAChB;CACF;AACF;;;;;AAMD,IAAa,mBAAb,MAAa,yBAAyB,iBAAiB;CAGrD;;;;;CAMA;;;;;;;;CAUA;CAEA,YAAYC,QAAyC;EACnD,MAAM,OAAO;EACb,KAAK,eAAe,OAAO;EAC3B,KAAK,WAAW,OAAO;EACvB,KAAK,SAAS,OAAO;CACtB;CAED,OAAO,UAAU;AACf,SAAO;CACR;CAED,WAAwB;AACtB,SAAO;CACR;CAED,OAAOC,OAAyB;AAC9B,SAAO,IAAI,iBAAiB;GAC1B,SAAS,aAAa,KAAK,SAAS,MAAM,QAAQ;GAClD,mBAAmB,YACjB,KAAK,mBACL,MAAM,kBACP;GACD,mBAAmB,YACjB,KAAK,mBACL,MAAM,kBACP;GACD,UAAU,UAAU,KAAK,UAAU,MAAM,SAAS;GAClD,cAAc,KAAK;GACnB,IAAI,KAAK,MAAM,MAAM;GACrB,QAAQ,aAAa,KAAK,QAAQ,MAAM,OAAO;EAChD;CACF;CAED,IAAa,mBAA4C;AACvD,SAAO;GACL,GAAG,MAAM;GACT,cAAc,KAAK;GACnB,UAAU,KAAK;EAChB;CACF;AACF;AAyFD,SAAgB,sBAEdC,cACiC;CACjC,MAAMC,YAAwB,CAAE;CAChC,MAAMC,mBAAsC,CAAE;AAC9C,MAAK,MAAM,YAAY,aACrB,KAAI,CAAC,SAAS,SACZ;MACK;EACL,MAAM,eAAe,SAAS,SAAS;AACvC,MAAI;GACF,MAAM,eAAe,KAAK,MAAM,SAAS,SAAS,UAAU;GAC5D,MAAM,SAAS;IACb,MAAM,gBAAgB;IACtB,MAAM,gBAAgB,CAAE;IACxB,IAAI,SAAS;GACd;GACD,UAAU,KAAK,OAAO;EACvB,SAAQ,OAAO;GACd,iBAAiB,KAAK;IACpB,MAAM;IACN,MAAM,SAAS,SAAS;IACxB,IAAI,SAAS;IACb,OAAO;GACR,EAAC;EACH;CACF;AAEH,QAAO,CAAC,WAAW,gBAAiB;AACrC;AAED,SAAgB,cAAcT,GAA8B;AAC1D,QACE,OAAO,MAAM,YACb,MAAM,QACN,aAAa,KACb,OAAO,EAAE,YAAY,cACrB,EAAE,SAAS,KAAK;AAEnB;AAED,SAAgB,mBAAmBU,GAA4C;AAC7E,QAAO,EAAE,UAAU,KAAK;AACzB"}
+{"version":3,"file":"tool.js","names":["x: unknown","fields:\n      | $InferMessageContent<TStructure, \"tool\">\n      | ToolMessageFields<TStructure>","tool_call_id?: string","name?: string","toolMessageFields: ToolMessageFields<TStructure>","message: unknown","fields: ToolMessageFields<TStructure>","chunk: ToolMessageChunk<TStructure>","rawToolCalls: Record<string, any>[]","toolCalls: ToolCall[]","invalidToolCalls: InvalidToolCall[]","x: BaseMessageChunk"],"sources":["../../src/messages/tool.ts"],"sourcesContent":["import {\n  BaseMessage,\n  BaseMessageChunk,\n  type BaseMessageFields,\n  mergeContent,\n  _mergeDicts,\n  _mergeObj,\n  _mergeStatus,\n} from \"./base.js\";\nimport { $InferMessageContent, MessageStructure } from \"./message.js\";\nimport { Constructor } from \"./utils.js\";\n\nexport interface ToolMessageFields<\n  TStructure extends MessageStructure = MessageStructure\n> extends BaseMessageFields<TStructure, \"tool\"> {\n  /**\n   * Artifact of the Tool execution which is not meant to be sent to the model.\n   *\n   * Should only be specified if it is different from the message content, e.g. if only\n   * a subset of the full tool output is being passed as message content but the full\n   * output is needed in other parts of the code.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  artifact?: any;\n  tool_call_id: string;\n  status?: \"success\" | \"error\";\n}\n\n/**\n * Marker parameter for objects that tools can return directly.\n *\n * If a custom BaseTool is invoked with a ToolCall and the output of custom code is\n * not an instance of DirectToolOutput, the output will automatically be coerced to\n * a string and wrapped in a ToolMessage.\n */\nexport interface DirectToolOutput {\n  readonly lc_direct_tool_output: true;\n}\n\nexport function isDirectToolOutput(x: unknown): x is DirectToolOutput {\n  return (\n    x != null &&\n    typeof x === \"object\" &&\n    \"lc_direct_tool_output\" in x &&\n    x.lc_direct_tool_output === true\n  );\n}\n\n/**\n * Represents a tool message in a conversation.\n */\nexport class ToolMessage<TStructure extends MessageStructure = MessageStructure>\n  extends BaseMessage<TStructure, \"tool\">\n  implements DirectToolOutput\n{\n  static lc_name() {\n    return \"ToolMessage\";\n  }\n\n  get lc_aliases(): Record<string, string> {\n    // exclude snake case conversion to pascal case\n    return { tool_call_id: \"tool_call_id\" };\n  }\n\n  lc_direct_tool_output = true as const;\n\n  readonly type = \"tool\" as const;\n\n  /**\n   * Status of the tool invocation.\n   * @version 0.2.19\n   */\n  status?: \"success\" | \"error\";\n\n  tool_call_id: string;\n\n  /**\n   * Artifact of the Tool execution which is not meant to be sent to the model.\n   *\n   * Should only be specified if it is different from the message content, e.g. if only\n   * a subset of the full tool output is being passed as message content but the full\n   * output is needed in other parts of the code.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  artifact?: any;\n\n  constructor(\n    fields: $InferMessageContent<TStructure, \"tool\"> | ToolMessageFields,\n    tool_call_id: string,\n    name?: string\n  );\n\n  constructor(fields: ToolMessageFields<TStructure>);\n\n  constructor(\n    fields:\n      | $InferMessageContent<TStructure, \"tool\">\n      | ToolMessageFields<TStructure>,\n    tool_call_id?: string,\n    name?: string\n  ) {\n    const toolMessageFields: ToolMessageFields<TStructure> =\n      typeof fields === \"string\" || Array.isArray(fields)\n        ? { content: fields, name, tool_call_id: tool_call_id! }\n        : fields;\n    super(toolMessageFields);\n    this.tool_call_id = toolMessageFields.tool_call_id;\n    this.artifact = toolMessageFields.artifact;\n    this.status = toolMessageFields.status;\n  }\n\n  static isInstance(message: unknown): message is ToolMessage {\n    return super.isInstance(message) && message.type === \"tool\";\n  }\n\n  override get _printableFields(): Record<string, unknown> {\n    return {\n      ...super._printableFields,\n      tool_call_id: this.tool_call_id,\n      artifact: this.artifact,\n    };\n  }\n}\n\n/**\n * Represents a chunk of a tool message, which can be concatenated\n * with other tool message chunks.\n */\nexport class ToolMessageChunk<\n  TStructure extends MessageStructure = MessageStructure\n> extends BaseMessageChunk<TStructure, \"tool\"> {\n  readonly type = \"tool\" as const;\n\n  tool_call_id: string;\n\n  /**\n   * Status of the tool invocation.\n   * @version 0.2.19\n   */\n  status?: \"success\" | \"error\";\n\n  /**\n   * Artifact of the Tool execution which is not meant to be sent to the model.\n   *\n   * Should only be specified if it is different from the message content, e.g. if only\n   * a subset of the full tool output is being passed as message content but the full\n   * output is needed in other parts of the code.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  artifact?: any;\n\n  constructor(fields: ToolMessageFields<TStructure>) {\n    super(fields);\n    this.tool_call_id = fields.tool_call_id;\n    this.artifact = fields.artifact;\n    this.status = fields.status;\n  }\n\n  static lc_name() {\n    return \"ToolMessageChunk\";\n  }\n\n  concat(chunk: ToolMessageChunk<TStructure>) {\n    const Cls = this.constructor as Constructor<this>;\n    return new Cls({\n      content: mergeContent(this.content, chunk.content),\n      additional_kwargs: _mergeDicts(\n        this.additional_kwargs,\n        chunk.additional_kwargs\n      ),\n      response_metadata: _mergeDicts(\n        this.response_metadata,\n        chunk.response_metadata\n      ),\n      artifact: _mergeObj(this.artifact, chunk.artifact),\n      tool_call_id: this.tool_call_id,\n      id: this.id ?? chunk.id,\n      status: _mergeStatus(this.status, chunk.status),\n    });\n  }\n\n  override get _printableFields(): Record<string, unknown> {\n    return {\n      ...super._printableFields,\n      tool_call_id: this.tool_call_id,\n      artifact: this.artifact,\n    };\n  }\n}\n\nexport interface ToolCall<\n  TName extends string = string,\n  TArgs extends Record<string, unknown> = Record<string, unknown>\n> {\n  readonly type?: \"tool_call\";\n  /**\n   * If provided, an identifier associated with the tool call\n   */\n  id?: string;\n  /**\n   * The name of the tool being called\n   */\n  name: TName;\n  /**\n   * The arguments to the tool call\n   */\n  args: TArgs;\n}\n\n/**\n * A chunk of a tool call (e.g., as part of a stream).\n * When merging ToolCallChunks (e.g., via AIMessageChunk.__add__),\n * all string attributes are concatenated. Chunks are only merged if their\n * values of `index` are equal and not None.\n *\n * @example\n * ```ts\n * const leftChunks = [\n *   {\n *     name: \"foo\",\n *     args: '{\"a\":',\n *     index: 0\n *   }\n * ];\n *\n * const leftAIMessageChunk = new AIMessageChunk({\n *   content: \"\",\n *   tool_call_chunks: leftChunks\n * });\n *\n * const rightChunks = [\n *   {\n *     name: undefined,\n *     args: '1}',\n *     index: 0\n *   }\n * ];\n *\n * const rightAIMessageChunk = new AIMessageChunk({\n *   content: \"\",\n *   tool_call_chunks: rightChunks\n * });\n *\n * const result = leftAIMessageChunk.concat(rightAIMessageChunk);\n * // result.tool_call_chunks is equal to:\n * // [\n * //   {\n * //     name: \"foo\",\n * //     args: '{\"a\":1}'\n * //     index: 0\n * //   }\n * // ]\n * ```\n */\nexport interface ToolCallChunk<TName extends string = string> {\n  readonly type?: \"tool_call_chunk\";\n  /**\n   * If provided, a substring of an identifier for the tool call\n   */\n  id?: string;\n  /**\n   * If provided, a substring of the name of the tool to be called\n   */\n  name?: TName;\n  /**\n   * If provided, a JSON substring of the arguments to the tool call\n   */\n  args?: string;\n  /**\n   * If provided, the index of the tool call in a sequence\n   */\n  index?: number;\n}\n\nexport interface InvalidToolCall<TName extends string = string> {\n  readonly type?: \"invalid_tool_call\";\n  /**\n   * If provided, an identifier associated with the tool call\n   */\n  id?: string;\n  /**\n      /**\n     * The name of the tool being called\n     */\n  name?: TName;\n  /**\n   * The arguments to the tool call\n   */\n  args?: string;\n  /**\n   * An error message associated with the tool call\n   */\n  error?: string;\n  /**\n   * Index of block in aggregate response\n   */\n  index?: string | number;\n}\n\nexport function defaultToolCallParser(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  rawToolCalls: Record<string, any>[]\n): [ToolCall[], InvalidToolCall[]] {\n  const toolCalls: ToolCall[] = [];\n  const invalidToolCalls: InvalidToolCall[] = [];\n  for (const toolCall of rawToolCalls) {\n    if (!toolCall.function) {\n      continue;\n    } else {\n      const functionName = toolCall.function.name;\n      try {\n        const functionArgs = JSON.parse(toolCall.function.arguments);\n        toolCalls.push({\n          name: functionName || \"\",\n          args: functionArgs || {},\n          id: toolCall.id,\n        });\n      } catch {\n        invalidToolCalls.push({\n          name: functionName,\n          args: toolCall.function.arguments,\n          id: toolCall.id,\n          error: \"Malformed args.\",\n        });\n      }\n    }\n  }\n  return [toolCalls, invalidToolCalls];\n}\n\n/**\n * @deprecated Use {@link ToolMessage.isInstance} instead\n */\nexport function isToolMessage(x: unknown): x is ToolMessage {\n  return (\n    typeof x === \"object\" &&\n    x !== null &&\n    \"getType\" in x &&\n    typeof x.getType === \"function\" &&\n    x.getType() === \"tool\"\n  );\n}\n\n/**\n * @deprecated Use {@link ToolMessageChunk.isInstance} instead\n */\nexport function isToolMessageChunk(x: BaseMessageChunk): x is ToolMessageChunk {\n  return x._getType() === \"tool\";\n}\n"],"mappings":";;;;;;;;;;;;;AAuCA,SAAgB,mBAAmBA,GAAmC;AACpE,QACE,KAAK,QACL,OAAO,MAAM,YACb,2BAA2B,KAC3B,EAAE,0BAA0B;AAE/B;;;;AAKD,IAAa,cAAb,cACU,YAEV;CACE,OAAO,UAAU;AACf,SAAO;CACR;CAED,IAAI,aAAqC;AAEvC,SAAO,EAAE,cAAc,eAAgB;CACxC;CAED,wBAAwB;CAExB,AAAS,OAAO;;;;;CAMhB;CAEA;;;;;;;;CAUA;CAUA,YACEC,QAGAC,cACAC,MACA;EACA,MAAMC,oBACJ,OAAO,WAAW,YAAY,MAAM,QAAQ,OAAO,GAC/C;GAAE,SAAS;GAAQ;GAAoB;EAAe,IACtD;EACN,MAAM,kBAAkB;EACxB,KAAK,eAAe,kBAAkB;EACtC,KAAK,WAAW,kBAAkB;EAClC,KAAK,SAAS,kBAAkB;CACjC;CAED,OAAO,WAAWC,SAA0C;AAC1D,SAAO,MAAM,WAAW,QAAQ,IAAI,QAAQ,SAAS;CACtD;CAED,IAAa,mBAA4C;AACvD,SAAO;GACL,GAAG,MAAM;GACT,cAAc,KAAK;GACnB,UAAU,KAAK;EAChB;CACF;AACF;;;;;AAMD,IAAa,mBAAb,cAEU,iBAAqC;CAC7C,AAAS,OAAO;CAEhB;;;;;CAMA;;;;;;;;CAUA;CAEA,YAAYC,QAAuC;EACjD,MAAM,OAAO;EACb,KAAK,eAAe,OAAO;EAC3B,KAAK,WAAW,OAAO;EACvB,KAAK,SAAS,OAAO;CACtB;CAED,OAAO,UAAU;AACf,SAAO;CACR;CAED,OAAOC,OAAqC;EAC1C,MAAM,MAAM,KAAK;AACjB,SAAO,IAAI,IAAI;GACb,SAAS,aAAa,KAAK,SAAS,MAAM,QAAQ;GAClD,mBAAmB,YACjB,KAAK,mBACL,MAAM,kBACP;GACD,mBAAmB,YACjB,KAAK,mBACL,MAAM,kBACP;GACD,UAAU,UAAU,KAAK,UAAU,MAAM,SAAS;GAClD,cAAc,KAAK;GACnB,IAAI,KAAK,MAAM,MAAM;GACrB,QAAQ,aAAa,KAAK,QAAQ,MAAM,OAAO;EAChD;CACF;CAED,IAAa,mBAA4C;AACvD,SAAO;GACL,GAAG,MAAM;GACT,cAAc,KAAK;GACnB,UAAU,KAAK;EAChB;CACF;AACF;AA+GD,SAAgB,sBAEdC,cACiC;CACjC,MAAMC,YAAwB,CAAE;CAChC,MAAMC,mBAAsC,CAAE;AAC9C,MAAK,MAAM,YAAY,aACrB,KAAI,CAAC,SAAS,SACZ;MACK;EACL,MAAM,eAAe,SAAS,SAAS;AACvC,MAAI;GACF,MAAM,eAAe,KAAK,MAAM,SAAS,SAAS,UAAU;GAC5D,UAAU,KAAK;IACb,MAAM,gBAAgB;IACtB,MAAM,gBAAgB,CAAE;IACxB,IAAI,SAAS;GACd,EAAC;EACH,QAAO;GACN,iBAAiB,KAAK;IACpB,MAAM;IACN,MAAM,SAAS,SAAS;IACxB,IAAI,SAAS;IACb,OAAO;GACR,EAAC;EACH;CACF;AAEH,QAAO,CAAC,WAAW,gBAAiB;AACrC;;;;AAKD,SAAgB,cAAcV,GAA8B;AAC1D,QACE,OAAO,MAAM,YACb,MAAM,QACN,aAAa,KACb,OAAO,EAAE,YAAY,cACrB,EAAE,SAAS,KAAK;AAEnB;;;;AAKD,SAAgB,mBAAmBW,GAA4C;AAC7E,QAAO,EAAE,UAAU,KAAK;AACzB"}

package/dist/messages/transformers.cjs

@@ -5,9 +5,9 @@ const require_chat = require('./chat.cjs');
 const require_function = require('./function.cjs');
 const require_human = require('./human.cjs');
 const require_system = require('./system.cjs');
+const require_modifier = require('./modifier.cjs');
 const require_utils = require('./utils.cjs');
 const require_base$1 = require('../runnables/base.cjs');
-const require_modifier = require('./modifier.cjs');
 
 //#region src/messages/transformers.ts
 const _isMessageType = (msg, types) => {
@@ -114,7 +114,7 @@ async function _firstMaxTokens(messages, options) {
 			break;
 		}
 	}
-	if (idx < messagesCopy.length - 1 && partialStrategy) {
+	if (idx < messagesCopy.length && partialStrategy) {
 		let includedPartial = false;
 		if (Array.isArray(messagesCopy[idx].content)) {
 			const excluded = messagesCopy[idx];