langchain
Version:
Typescript bindings for langchain
1 lines • 6.63 kB
Source Map (JSON)
{"version":3,"file":"errors.cjs","names":["isGraphBubbleUp","ModelRefusalError"],"sources":["../../src/agents/errors.ts"],"sourcesContent":["/* oxlint-disable no-instanceof/no-instanceof */\nimport type { AIMessage } from \"@langchain/core/messages\";\nimport type { ToolCall } from \"@langchain/core/messages/tool\";\nimport { ModelRefusalError } from \"@langchain/core/errors\";\nimport { isGraphBubbleUp } from \"@langchain/langgraph\";\n\nexport class MultipleToolsBoundError extends Error {\n constructor() {\n super(\n \"The provided LLM already has bound tools. \" +\n \"Please provide an LLM without bound tools to createAgent. \" +\n \"The agent will bind the tools provided in the 'tools' parameter.\"\n );\n }\n}\n\n/**\n * Raised when model returns multiple structured output tool calls when only one is expected.\n */\nexport class MultipleStructuredOutputsError extends Error {\n public readonly toolNames: string[];\n\n constructor(toolNames: string[]) {\n super(\n `The model has called multiple tools: ${toolNames.join(\n \", \"\n )} to return a structured output. ` +\n \"This is not supported. Please provide a single structured output.\"\n );\n this.toolNames = toolNames;\n }\n}\n\n/**\n * Raised when structured output tool call arguments fail to parse according to the schema.\n */\nexport class StructuredOutputParsingError extends Error {\n public readonly toolName: string;\n\n public readonly errors: string[];\n\n /**\n * The model response that failed to parse, when available.\n */\n public readonly aiMessage?: AIMessage;\n\n constructor(toolName: string, errors: string[], aiMessage?: AIMessage) {\n super(\n `Failed to parse structured output for tool '${toolName}':${errors\n .map((e) => `\\n - ${e}`)\n .join(\"\")}.`\n );\n this.toolName = toolName;\n this.errors = errors;\n this.aiMessage = aiMessage;\n }\n}\n\n/**\n * Raised when a tool call is throwing an error.\n */\nexport class ToolInvocationError extends Error {\n readonly \"~brand\" = \"ToolInvocationError\";\n\n public readonly toolCall: ToolCall;\n\n public readonly toolError: Error;\n\n constructor(toolError: unknown, toolCall: ToolCall) {\n const error =\n toolError instanceof Error ? toolError : new Error(String(toolError));\n const toolArgs = JSON.stringify(toolCall.args);\n super(\n `Error invoking tool '${toolCall.name}' with kwargs ${toolArgs} with error: ${error.stack}\\n Please fix the error and try again.`\n );\n\n this.toolCall = toolCall;\n this.toolError = error;\n }\n\n /**\n * Check if the error is a ToolInvocationError.\n * @param error - The error to check\n * @returns Whether the error is a ToolInvocationError\n */\n static isInstance(error: unknown): error is ToolInvocationError {\n return (\n error instanceof Error &&\n \"~brand\" in error &&\n error[\"~brand\"] === \"ToolInvocationError\"\n );\n }\n\n static [Symbol.hasInstance](obj: unknown) {\n return this.isInstance(obj);\n }\n}\n\n/**\n * Error thrown when a middleware fails.\n *\n * Use `MiddlewareError.wrap()` to create instances. The constructor is private\n * to ensure that GraphBubbleUp errors (like GraphInterrupt) are never wrapped.\n */\nexport class MiddlewareError extends Error {\n readonly \"~brand\" = \"MiddlewareError\";\n\n private constructor(error: unknown, middlewareName: string) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n super(errorMessage);\n this.name =\n error instanceof Error\n ? error.name\n : `${middlewareName[0].toUpperCase() + middlewareName.slice(1)}Error`;\n\n if (error instanceof Error) {\n this.cause = error;\n }\n }\n\n /**\n * Wrap an error in a MiddlewareError, unless it's a GraphBubbleUp error\n * (like GraphInterrupt) or a {@link ModelRefusalError}, which propagate unchanged.\n *\n * @param error - The error to wrap\n * @param middlewareName - The name of the middleware that threw the error\n * @returns The original error if it's a GraphBubbleUp or a ModelRefusalError,\n * otherwise a new MiddlewareError\n */\n static wrap(error: unknown, middlewareName: string): Error {\n // Don't wrap GraphBubbleUp errors (GraphInterrupt, NodeInterrupt, etc.)\n // These are control flow mechanisms that need to bubble up unchanged\n if (isGraphBubbleUp(error)) {\n return error;\n }\n // Pass through so callers can catch it by type and retry middleware sees\n // its non-retryable flag.\n if (ModelRefusalError.isInstance(error)) {\n return error;\n }\n return new MiddlewareError(error, middlewareName);\n }\n\n /**\n * Check if the error is a MiddlewareError.\n * @param error - The error to check\n * @returns Whether the error is a MiddlewareError\n */\n static isInstance(error: unknown): error is MiddlewareError {\n return (\n error instanceof Error &&\n \"~brand\" in error &&\n error[\"~brand\"] === \"MiddlewareError\"\n );\n }\n\n static [Symbol.hasInstance](obj: unknown) {\n return this.isInstance(obj);\n }\n}\n"],"mappings":";;;AAMA,IAAa,0BAAb,cAA6C,MAAM;CACjD,cAAc;EACZ,MACE,sKAGF;CACF;AACF;;;;AAKA,IAAa,iCAAb,cAAoD,MAAM;CACxD;CAEA,YAAY,WAAqB;EAC/B,MACE,wCAAwC,UAAU,KAChD,IACF,EAAE,kGAEJ;EACA,KAAK,YAAY;CACnB;AACF;;;;AAKA,IAAa,+BAAb,cAAkD,MAAM;CACtD;CAEA;;;;CAKA;CAEA,YAAY,UAAkB,QAAkB,WAAuB;EACrE,MACE,+CAA+C,SAAS,IAAI,OACzD,KAAK,MAAM,SAAS,GAAG,CAAC,CACxB,KAAK,EAAE,EAAE,EACd;EACA,KAAK,WAAW;EAChB,KAAK,SAAS;EACd,KAAK,YAAY;CACnB;AACF;;;;AAKA,IAAa,sBAAb,cAAyC,MAAM;CAC7C,WAAoB;CAEpB;CAEA;CAEA,YAAY,WAAoB,UAAoB;EAClD,MAAM,QACJ,qBAAqB,QAAQ,YAAY,IAAI,MAAM,OAAO,SAAS,CAAC;EACtE,MAAM,WAAW,KAAK,UAAU,SAAS,IAAI;EAC7C,MACE,wBAAwB,SAAS,KAAK,gBAAgB,SAAS,eAAe,MAAM,MAAM,uCAC5F;EAEA,KAAK,WAAW;EAChB,KAAK,YAAY;CACnB;;;;;;CAOA,OAAO,WAAW,OAA8C;EAC9D,OACE,iBAAiB,SACjB,YAAY,SACZ,MAAM,cAAc;CAExB;CAEA,QAAQ,OAAO,aAAa,KAAc;EACxC,OAAO,KAAK,WAAW,GAAG;CAC5B;AACF;;;;;;;AAQA,IAAa,kBAAb,MAAa,wBAAwB,MAAM;CACzC,WAAoB;CAEpB,YAAoB,OAAgB,gBAAwB;EAC1D,MAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EAC1E,MAAM,YAAY;EAClB,KAAK,OACH,iBAAiB,QACb,MAAM,OACN,GAAG,eAAe,EAAE,CAAC,YAAY,IAAI,eAAe,MAAM,CAAC,EAAE;EAEnE,IAAI,iBAAiB,OACnB,KAAK,QAAQ;CAEjB;;;;;;;;;;CAWA,OAAO,KAAK,OAAgB,gBAA+B;EAGzD,KAAA,GAAIA,qBAAAA,gBAAAA,CAAgB,KAAK,GACvB,OAAO;EAIT,IAAIC,uBAAAA,kBAAkB,WAAW,KAAK,GACpC,OAAO;EAET,OAAO,IAAI,gBAAgB,OAAO,cAAc;CAClD;;;;;;CAOA,OAAO,WAAW,OAA0C;EAC1D,OACE,iBAAiB,SACjB,YAAY,SACZ,MAAM,cAAc;CAExB;CAEA,QAAQ,OAAO,aAAa,KAAc;EACxC,OAAO,KAAK,WAAW,GAAG;CAC5B;AACF"}