@langchain/core 0.3.11 → 0.3.13

package/dist/errors/index.cjs

@@ -0,0 +1,11 @@
+"use strict";
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable no-param-reassign */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addLangChainErrorFields = void 0;
+function addLangChainErrorFields(error, lc_error_code) {
+    error.lc_error_code = lc_error_code;
+    error.message = `${error.message}\n\nTroubleshooting URL: https://js.langchain.com/docs/troubleshooting/errors/${lc_error_code}/\n`;
+    return error;
+}
+exports.addLangChainErrorFields = addLangChainErrorFields;

package/dist/errors/index.d.ts

@@ -0,0 +1,2 @@
+export type LangChainErrorCodes = "INVALID_PROMPT_INPUT" | "INVALID_TOOL_RESULTS" | "MESSAGE_COERCION_FAILURE" | "MODEL_AUTHENTICATION" | "MODEL_NOT_FOUND" | "MODEL_RATE_LIMIT" | "OUTPUT_PARSING_FAILURE";
+export declare function addLangChainErrorFields(error: any, lc_error_code: LangChainErrorCodes): any;

package/dist/errors/index.js

@@ -0,0 +1,7 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable no-param-reassign */
+export function addLangChainErrorFields(error, lc_error_code) {
+    error.lc_error_code = lc_error_code;
+    error.message = `${error.message}\n\nTroubleshooting URL: https://js.langchain.com/docs/troubleshooting/errors/${lc_error_code}/\n`;
+    return error;
+}

package/dist/messages/utils.cjs

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.convertToChunk = exports.mapChatMessagesToStoredMessages = exports.mapStoredMessagesToChatMessages = exports.mapStoredMessageToChatMessage = exports.getBufferString = exports.coerceMessageLikeToMessage = void 0;
+const index_js_1 = require("../errors/index.cjs");
 const utils_js_1 = require("../tools/utils.cjs");
 const ai_js_1 = require("./ai.cjs");
 const base_js_1 = require("./base.cjs");
@@ -91,7 +92,8 @@ function _constructMessageFromParams(params) {
         });
     }
     else {
-        throw new Error(`Unable to coerce message from array: only human, AI, or system message coercion is currently supported.\n\nReceived: ${JSON.stringify(params, null, 2)}`);
+        const error = (0, index_js_1.addLangChainErrorFields)(new Error(`Unable to coerce message from array: only human, AI, system, or tool message coercion is currently supported.\n\nReceived: ${JSON.stringify(params, null, 2)}`), "MESSAGE_COERCION_FAILURE");
+        throw error;
     }
 }
 function coerceMessageLikeToMessage(messageLike) {

package/dist/messages/utils.js

@@ -1,3 +1,4 @@
+import { addLangChainErrorFields } from "../errors/index.js";
 import { _isToolCall } from "../tools/utils.js";
 import { AIMessage, AIMessageChunk } from "./ai.js";
 import { isBaseMessage, _isMessageFieldWithRole, } from "./base.js";
@@ -88,7 +89,8 @@ function _constructMessageFromParams(params) {
         });
     }
     else {
-        throw new Error(`Unable to coerce message from array: only human, AI, or system message coercion is currently supported.\n\nReceived: ${JSON.stringify(params, null, 2)}`);
+        const error = addLangChainErrorFields(new Error(`Unable to coerce message from array: only human, AI, system, or tool message coercion is currently supported.\n\nReceived: ${JSON.stringify(params, null, 2)}`), "MESSAGE_COERCION_FAILURE");
+        throw error;
     }
 }
 export function coerceMessageLikeToMessage(messageLike) {

package/dist/output_parsers/base.cjs

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OutputParserException = exports.BaseOutputParser = exports.BaseLLMOutputParser = void 0;
 const index_js_1 = require("../runnables/index.cjs");
+const index_js_2 = require("../errors/index.cjs");
 /**
  * Abstract base class for parsing the output of a Large Language Model
  * (LLM) call. It provides methods for parsing the result of an LLM call
@@ -117,6 +118,7 @@ class OutputParserException extends Error {
                 throw new Error("Arguments 'observation' & 'llmOutput' are required if 'sendToLlm' is true");
             }
         }
+        (0, index_js_2.addLangChainErrorFields)(this, "OUTPUT_PARSING_FAILURE");
     }
 }
 exports.OutputParserException = OutputParserException;

package/dist/output_parsers/base.js

@@ -1,4 +1,5 @@
 import { Runnable } from "../runnables/index.js";
+import { addLangChainErrorFields } from "../errors/index.js";
 /**
  * Abstract base class for parsing the output of a Large Language Model
  * (LLM) call. It provides methods for parsing the result of an LLM call
@@ -112,5 +113,6 @@ export class OutputParserException extends Error {
                 throw new Error("Arguments 'observation' & 'llmOutput' are required if 'sendToLlm' is true");
             }
         }
+        addLangChainErrorFields(this, "OUTPUT_PARSING_FAILURE");
     }
 }

package/dist/prompts/chat.cjs

@@ -11,6 +11,7 @@ const base_js_2 = require("./base.cjs");
 const prompt_js_1 = require("./prompt.cjs");
 const image_js_1 = require("./image.cjs");
 const template_js_1 = require("./template.cjs");
+const index_js_2 = require("../errors/index.cjs");
 /**
  * Abstract class that serves as a base for creating message prompt
  * templates. It defines how to format messages for different roles in a
@@ -103,6 +104,8 @@ class MessagesPlaceholder extends BaseMessagePromptTemplate {
                 `Additional message: ${e.message}`,
             ].join("\n\n"));
             error.name = "InputFormatError";
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            error.lc_error_code = e.lc_error_code;
             throw error;
         }
         return formattedMessages;
@@ -674,7 +677,8 @@ class ChatPromptTemplate extends BaseChatPromptTemplate {
                 const inputValues = promptMessage.inputVariables.reduce((acc, inputVariable) => {
                     if (!(inputVariable in allValues) &&
                         !(isMessagesPlaceholder(promptMessage) && promptMessage.optional)) {
-                        throw new Error(`Missing value for input variable \`${inputVariable.toString()}\``);
+                        const error = (0, index_js_2.addLangChainErrorFields)(new Error(`Missing value for input variable \`${inputVariable.toString()}\``), "INVALID_PROMPT_INPUT");
+                        throw error;
                     }
                     acc[inputVariable] = allValues[inputVariable];
                     return acc;

package/dist/prompts/chat.js

@@ -8,6 +8,7 @@ import { BasePromptTemplate, } from "./base.js";
 import { PromptTemplate, } from "./prompt.js";
 import { ImagePromptTemplate } from "./image.js";
 import { parseFString, parseMustache, } from "./template.js";
+import { addLangChainErrorFields } from "../errors/index.js";
 /**
  * Abstract class that serves as a base for creating message prompt
  * templates. It defines how to format messages for different roles in a
@@ -99,6 +100,8 @@ export class MessagesPlaceholder extends BaseMessagePromptTemplate {
                 `Additional message: ${e.message}`,
             ].join("\n\n"));
             error.name = "InputFormatError";
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            error.lc_error_code = e.lc_error_code;
             throw error;
         }
         return formattedMessages;
@@ -663,7 +666,8 @@ export class ChatPromptTemplate extends BaseChatPromptTemplate {
                 const inputValues = promptMessage.inputVariables.reduce((acc, inputVariable) => {
                     if (!(inputVariable in allValues) &&
                         !(isMessagesPlaceholder(promptMessage) && promptMessage.optional)) {
-                        throw new Error(`Missing value for input variable \`${inputVariable.toString()}\``);
+                        const error = addLangChainErrorFields(new Error(`Missing value for input variable \`${inputVariable.toString()}\``), "INVALID_PROMPT_INPUT");
+                        throw error;
                     }
                     acc[inputVariable] = allValues[inputVariable];
                     return acc;

package/dist/prompts/template.cjs

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkValidTemplate = exports.parseTemplate = exports.renderTemplate = exports.DEFAULT_PARSER_MAPPING = exports.DEFAULT_FORMATTER_MAPPING = exports.interpolateMustache = exports.interpolateFString = exports.parseMustache = exports.parseFString = void 0;
 const mustache_1 = __importDefault(require("mustache"));
+const index_js_1 = require("../errors/index.cjs");
 function configureMustache() {
     // Use unescaped HTML
     // https://github.com/janl/mustache.js?tab=readme-ov-file#variables
@@ -114,7 +115,15 @@ exports.DEFAULT_PARSER_MAPPING = {
     "f-string": exports.parseFString,
     mustache: exports.parseMustache,
 };
-const renderTemplate = (template, templateFormat, inputValues) => exports.DEFAULT_FORMATTER_MAPPING[templateFormat](template, inputValues);
+const renderTemplate = (template, templateFormat, inputValues) => {
+    try {
+        return exports.DEFAULT_FORMATTER_MAPPING[templateFormat](template, inputValues);
+    }
+    catch (e) {
+        const error = (0, index_js_1.addLangChainErrorFields)(e, "INVALID_PROMPT_INPUT");
+        throw error;
+    }
+};
 exports.renderTemplate = renderTemplate;
 const parseTemplate = (template, templateFormat) => exports.DEFAULT_PARSER_MAPPING[templateFormat](template);
 exports.parseTemplate = parseTemplate;

package/dist/prompts/template.js

@@ -1,4 +1,5 @@
 import mustache from "mustache";
+import { addLangChainErrorFields } from "../errors/index.js";
 function configureMustache() {
     // Use unescaped HTML
     // https://github.com/janl/mustache.js?tab=readme-ov-file#variables
@@ -104,7 +105,15 @@ export const DEFAULT_PARSER_MAPPING = {
     "f-string": parseFString,
     mustache: parseMustache,
 };
-export const renderTemplate = (template, templateFormat, inputValues) => DEFAULT_FORMATTER_MAPPING[templateFormat](template, inputValues);
+export const renderTemplate = (template, templateFormat, inputValues) => {
+    try {
+        return DEFAULT_FORMATTER_MAPPING[templateFormat](template, inputValues);
+    }
+    catch (e) {
+        const error = addLangChainErrorFields(e, "INVALID_PROMPT_INPUT");
+        throw error;
+    }
+};
 export const parseTemplate = (template, templateFormat) => DEFAULT_PARSER_MAPPING[templateFormat](template);
 export const checkValidTemplate = (template, templateFormat, inputVariables) => {
     if (!(templateFormat in DEFAULT_FORMATTER_MAPPING)) {

package/package.json

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