nestjs-langchain 2.1.0 → 2.2.0

package/README.md

@@ -350,15 +350,16 @@ LangChainModule.register({
 });
 ```
 
-With `LANGSMITH_TRACING=true` and `LANGSMITH_API_KEY` set, every run is also traced in LangSmith.
+With `LANGSMITH_TRACING=true` and `LANGSMITH_API_KEY` set, every run is also traced in LangSmith,
+named after its agent.
 
 Every event, the errors, the log lines and `callbacks`: [docs/observing.md](docs/observing.md).
 
 ### Errors
 
 Everything `run()` throws is an `AgentRunError`, with the `agent` that failed and the original
-error in `cause`. A structured output that is missing or invalid throws its subclass,
-`StructuredOutputError`:
+error in `cause`. Its subclasses tell some failures apart: `StructuredOutputError`,
+`AgentAbortedError` and `AgentRecursionLimitError`.
 
 ```ts
 import { AgentRunError } from 'nestjs-langchain';
@@ -390,6 +391,8 @@ The series [AI agents with NestJS](https://dev.to/martinbruel/series/45463), on
    from `nest new` to a `POST /ask` endpoint.
 2. [NestJS Tool Calling: Turn Services into LLM Tools](https://dev.to/martinbruel/nestjs-tool-calling-turn-services-into-llm-tools-2ac4):
    `@Tool()`, Zod arguments and what the model sees when a tool fails.
+3. [LangChain Structured Output in NestJS: Typed with Zod](https://dev.to/martinbruel/langchain-structured-output-in-nestjs-typed-with-zod-12a1):
+   an object instead of text from `run()`, and what happens when the model gets it wrong.
 
 In French: [Gouvernez votre agent IA : NestJS et Mistral en 30 lignes](https://dev.to/martinbruel/gouvernez-votre-agent-ia-nestjs-et-mistral-en-30-lignes-11ad),
 a Mistral model, through its API or on your own servers with Ollama.

package/dist/agent.d.ts

@@ -28,7 +28,6 @@ export declare class Agent implements OnModuleInit {
     private readonly logger;
     private readonly prefix;
     private readonly reporter;
-    private readonly modelErrors;
     /** @internal Built by `LangChainModule`, never by hand. */
     constructor(options: LangChainModuleOptions, agentName: string, toolDiscovery: ToolDiscoveryService, discovery: DiscoveryService);
     /**
@@ -53,12 +52,15 @@ export declare class Agent implements OnModuleInit {
      * as an `AgentRunError`, the original error in its `cause`.
      *
      * @param input The user's message.
-     * @param options With `output`, the schema the answer must match.
+     * @param options With `output`, the schema the answer must match; with
+     * `signal`, what aborts the run; with `recursionLimit`, its most steps.
      * @returns The model's answer, the object `output` parses when given, the
      * tools it called and what the run cost.
      * @example
      * ```ts
-     * const { output, tools } = await agent.run('What is 6 times 7?');
+     * const { output, tools } = await agent.run('What is 6 times 7?', {
+     *   signal: AbortSignal.timeout(30_000),
+     * });
      *
      * const { output: ticket } = await agent.run(email, {
      *   output: z.object({ category: z.enum(['billing', 'bug', 'other']) }),
@@ -72,6 +74,7 @@ export declare class Agent implements OnModuleInit {
         output?: undefined;
     }): Promise<CompletedRun>;
     run(input: string, options?: RunOptions): Promise<CompletedRun<unknown>>;
+    private modelErrors;
     private complete;
 }
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../lib/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAMtC,OAAO,EACL,sBAAsB,EAEvB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACnE,OAAO,EACL,oBAAoB,EAGrB,MAAM,kBAAkB,CAAC;AAuB1B;;;;;;;;;;;;;GAaG;AACH,qBACa,KAAM,YAAW,YAAY;;IActC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAd5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IAGvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAElD,2DAA2D;gBAGxC,OAAO,EAAE,sBAAsB,EAE/B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,oBAAoB,EACnC,SAAS,EAAE,gBAAgB;IAmB9C;;;;OAIG;IACG,YAAY;IAgClB,OAAO,CAAC,gBAAgB;IAiBxB;;;;;;;;OAQG;YACW,YAAY;IA8B1B;;;;;;;;;;;;;;;;OAgBG;IACH,GAAG,CAAC,CAAC,SAAS,OAAO,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,GAAG;QAAE,MAAM,EAAE,CAAC,CAAA;KAAE,GAClC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,GAAG,CACD,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,UAAU,GAAG;QAAE,MAAM,CAAC,EAAE,SAAS,CAAA;KAAE,GAC5C,OAAO,CAAC,YAAY,CAAC;IAExB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAgD1D,QAAQ;CAyCvB"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../lib/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAMtC,OAAO,EACL,sBAAsB,EAEvB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACnE,OAAO,EACL,oBAAoB,EAGrB,MAAM,kBAAkB,CAAC;AAwB1B;;;;;;;;;;;;;GAaG;AACH,qBACa,KAAM,YAAW,YAAY;;IAWtC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAX5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IAEvC,2DAA2D;gBAGxC,OAAO,EAAE,sBAAsB,EAE/B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,oBAAoB,EACnC,SAAS,EAAE,gBAAgB;IAW9C;;;;OAIG;IACG,YAAY;IA2ClB,OAAO,CAAC,gBAAgB;IAiBxB;;;;;;;;OAQG;YACW,YAAY;IA8B1B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,GAAG,CAAC,CAAC,SAAS,OAAO,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,GAAG;QAAE,MAAM,EAAE,CAAC,CAAA;KAAE,GAClC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,GAAG,CACD,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,UAAU,GAAG;QAAE,MAAM,CAAC,EAAE,SAAS,CAAA;KAAE,GAC5C,OAAO,CAAC,YAAY,CAAC;IAExB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAiExE,OAAO,CAAC,WAAW;YAeL,QAAQ;CA8CvB"}

package/dist/agent.js

@@ -17,10 +17,11 @@ import { AGENT_NAME_TOKEN, MODULE_OPTIONS_TOKEN, UNNAMED_AGENT, } from './langch
 import { ToolDiscoveryService, toolErrors, unknownTools, } from './tools/index.js';
 import { BaseCallbackHandler } from '@langchain/core/callbacks/base';
 import { LOG_CONTEXT, messageOf, RunReporter } from './logging/index.js';
-import { summariseRun, UsageAside } from './run/index.js';
+import { DEFAULT_RECURSION_LIMIT } from './constants.js';
+import { isRecursionLimit, summariseRun, UsageAside } from './run/index.js';
 import { outputConfig, RunOutput, structuredOutput } from './output/index.js';
-import { AgentRunError, unwrapMiddlewareError } from './errors/index.js';
-import { agentNotBootstrapped, agentPrefix, agentRunFailed, duplicateAgentName, modelNeverReplied, modelNotBuilt, modelReplyEmpty, notAChatModel, } from './errors/messages.js';
+import { AgentRunError, toRunError } from './errors/index.js';
+import { agentNotBootstrapped, agentPrefix, duplicateAgentName, invalidRecursionLimit, modelNeverReplied, modelNotBuilt, modelReplyEmpty, notAChatModel, } from './errors/messages.js';
 /**
  * One agent, registered through `LangChainModule`. Inject it directly for the
  * unnamed agent, or with `@InjectAgent(name)` for a named one.
@@ -46,9 +47,6 @@ let Agent = class Agent {
     logger = new Logger();
     prefix;
     reporter;
-    // Model failures, which only LangChain's callbacks see. Tool calls are
-    // reported by their wrapper and the tool middlewares.
-    modelErrors;
     /** @internal Built by `LangChainModule`, never by hand. */
     constructor(options, agentName, toolDiscovery, discovery) {
         this.options = options;
@@ -62,12 +60,6 @@ let Agent = class Agent {
             prefix: this.prefix,
             observer: options.observer,
         });
-        this.modelErrors = BaseCallbackHandler.fromMethods({
-            handleLLMError: (error) => {
-                this.reporter.logError(`the model failed: ${messageOf(error)}`);
-                this.reporter.notify((observer) => observer.onModelError?.({ agent: agentName, error }));
-            },
-        });
     }
     /**
      * Called by Nest: builds the agent, once the tool modules' providers exist.
@@ -76,6 +68,10 @@ let Agent = class Agent {
      */
     async onModuleInit() {
         this.assertUniqueName();
+        const { recursionLimit } = this.options;
+        if (!isRecursionLimit(recursionLimit)) {
+            throw new Error(invalidRecursionLimit(this.prefix, recursionLimit));
+        }
         const tools = await this.toolDiscovery.getToolsFromModules(this.options.tools ?? [], this.reporter);
         this.#graph = createAgent({
             model: await this.resolveModel(this.options.model),
@@ -88,6 +84,11 @@ let Agent = class Agent {
                 toolErrors(this.reporter),
                 structuredOutput(),
             ],
+        }).withConfig({
+            // Traces and callbacks tell agents apart; the unnamed one keeps
+            // LangGraph's name. See #235.
+            runName: this.agentName === UNNAMED_AGENT ? undefined : this.agentName,
+            metadata: { agent: this.agentName },
         });
         this.logger.log(`${this.prefix}ready with ${tools.length} tool${tools.length === 1 ? '' : 's'}`, LOG_CONTEXT);
     }
@@ -136,13 +137,24 @@ let Agent = class Agent {
     async run(input, options) {
         const startedAt = Date.now();
         const durationMs = () => Date.now() - startedAt;
+        // Always passed: left out, a run from another agent's tool would take
+        // that run's limit. See #315.
+        const recursionLimit = options?.recursionLimit ??
+            this.options.recursionLimit ??
+            DEFAULT_RECURSION_LIMIT;
         try {
             // Read in the `try`, and `null` from untyped JavaScript taken as no
             // options, as LangChain takes a `null` config. See #291.
             const schema = options?.output;
+            if (!isRecursionLimit(recursionLimit)) {
+                throw new AgentRunError(invalidRecursionLimit(this.prefix, recursionLimit), this.agentName);
+            }
             const output = schema && new RunOutput(schema, this.agentName);
             const aside = new UsageAside();
-            const { answer, messages } = await this.complete(input, output, aside);
+            const { answer, messages } = await this.complete(input, output, aside, {
+                signal: options?.signal,
+                recursionLimit,
+            });
             const finished = {
                 durationMs: durationMs(),
                 ...summariseRun(messages, output?.toolName, aside.usage),
@@ -151,10 +163,12 @@ let Agent = class Agent {
             return { status: 'completed', output: answer, ...finished };
         }
         catch (thrown) {
-            const cause = unwrapMiddlewareError(thrown);
-            const error = cause instanceof AgentRunError
-                ? cause
-                : new AgentRunError(agentRunFailed(this.prefix, cause), this.agentName, { cause });
+            const error = toRunError(thrown, {
+                agent: this.agentName,
+                prefix: this.prefix,
+                signal: options?.signal,
+                recursionLimit,
+            });
             this.reporter.notify((observer) => observer.onRunError?.({
                 agent: this.agentName,
                 durationMs: durationMs(),
@@ -163,13 +177,31 @@ let Agent = class Agent {
             throw error;
         }
     }
-    async complete(input, output, aside) {
+    // Model failures, which only LangChain's callbacks see; tool calls are
+    // reported by their wrapper and the tool middlewares. One handler per run:
+    // a call the run's signal cuts short is no failure. See #318.
+    modelErrors(signal) {
+        return BaseCallbackHandler.fromMethods({
+            handleLLMError: (error) => {
+                if (signal?.aborted) {
+                    return;
+                }
+                this.reporter.logError(`the model failed: ${messageOf(error)}`);
+                this.reporter.notify((observer) => observer.onModelError?.({ agent: this.agentName, error }));
+            },
+        });
+    }
+    async complete(input, output, aside, run) {
         if (!this.#graph) {
             throw new AgentRunError(agentNotBootstrapped(this.prefix), this.agentName);
         }
         const state = await this.#graph.invoke({ messages: [{ role: 'user', content: input }] }, {
-            callbacks: [this.modelErrors, ...(this.options.callbacks ?? [])],
+            callbacks: [
+                this.modelErrors(run.signal),
+                ...(this.options.callbacks ?? []),
+            ],
             configurable: { ...outputConfig(output), ...aside.config },
+            ...run,
         });
         const { messages } = state;
         const last = messages[messages.length - 1];

package/dist/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../lib/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../lib/agent.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -2,6 +2,20 @@ export declare const TOOL_METADATA = "nestjs-langchain:tool";
 export declare const TOOL_PARAMS_METADATA = "nestjs-langchain:tool-params";
 export declare const PARAM_TYPES_METADATA = "design:paramtypes";
 export declare const STRUCTURED_OUTPUT_PREFIX = "extract-";
-export declare const OUTPUT_TOOL = "extract-output";
+/**
+ * The name of the tool a run with an `output` schema answers through: a test
+ * faking the model queues a call to it.
+ *
+ * @example
+ * ```ts
+ * const model = fakeModel().respondWithTools([
+ *   { name: OUTPUT_TOOL, args: { category: 'bug' } },
+ * ]);
+ *
+ * const { output } = await agent.run(email, { output: Ticket });
+ * ```
+ */
+export declare const OUTPUT_TOOL: "extract-output";
+export declare const DEFAULT_RECURSION_LIMIT = 25;
 export declare const MODULE_METADATA_KEYS: string[];
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../lib/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,aAAa,0BAA0B,CAAC;AACrD,eAAO,MAAM,oBAAoB,iCAAiC,CAAC;AAGnE,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAIxD,eAAO,MAAM,wBAAwB,aAAa,CAAC;AAInD,eAAO,MAAM,WAAW,mBAAsC,CAAC;AAI/D,eAAO,MAAM,oBAAoB,UAKhC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../lib/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,aAAa,0BAA0B,CAAC;AACrD,eAAO,MAAM,oBAAoB,iCAAiC,CAAC;AAGnE,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAIxD,eAAO,MAAM,wBAAwB,aAAa,CAAC;AAInD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,kBAA+C,CAAC;AAGxE,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAI1C,eAAO,MAAM,oBAAoB,UAKhC,CAAC"}

package/dist/constants.js

@@ -8,7 +8,22 @@ export const PARAM_TYPES_METADATA = 'design:paramtypes';
 export const STRUCTURED_OUTPUT_PREFIX = 'extract-';
 // Ours rather than LangChain's counter or the schema's title: the same tool on
 // every run, under the prefix no `@Tool` can take. See #281.
+/**
+ * The name of the tool a run with an `output` schema answers through: a test
+ * faking the model queues a call to it.
+ *
+ * @example
+ * ```ts
+ * const model = fakeModel().respondWithTools([
+ *   { name: OUTPUT_TOOL, args: { category: 'bug' } },
+ * ]);
+ *
+ * const { output } = await agent.run(email, { output: Ticket });
+ * ```
+ */
 export const OUTPUT_TOOL = `${STRUCTURED_OUTPUT_PREFIX}output`;
+// LangChain's default, restated: it does not export it.
+export const DEFAULT_RECURSION_LIMIT = 25;
 // The keys `@Module()` writes, restated: `@nestjs/common/constants` is
 // internal. See #97.
 export const MODULE_METADATA_KEYS = [

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../lib/constants.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,aAAa,GAAG,uBAAuB,CAAC;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,8BAA8B,CAAC;AAEnE,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAExD,8EAA8E;AAC9E,0DAA0D;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAC;AAEnD,+EAA+E;AAC/E,6DAA6D;AAC7D,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,wBAAwB,QAAQ,CAAC;AAE/D,uEAAuE;AACvE,qBAAqB;AACrB,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS;IACT,WAAW;IACX,aAAa;IACb,SAAS;CACV,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../lib/constants.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,aAAa,GAAG,uBAAuB,CAAC;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,8BAA8B,CAAC;AAEnE,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAExD,8EAA8E;AAC9E,0DAA0D;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAC;AAEnD,+EAA+E;AAC/E,6DAA6D;AAC7D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,wBAAwB,QAAiB,CAAC;AAExE,wDAAwD;AACxD,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAE1C,uEAAuE;AACvE,qBAAqB;AACrB,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS;IACT,WAAW;IACX,aAAa;IACb,SAAS;CACV,CAAC"}

package/dist/errors/agent-aborted.error.d.ts

@@ -0,0 +1,21 @@
+import { AgentRunError } from './agent-run.error.js';
+/**
+ * The run's `signal` was aborted. Its `reason` is in `cause`.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await agent.run(question, { signal: AbortSignal.timeout(30_000) });
+ * } catch (error) {
+ *   if (error instanceof AgentAbortedError) {
+ *     console.warn('gave up:', error.cause);
+ *   }
+ * }
+ * ```
+ */
+export declare class AgentAbortedError extends AgentRunError {
+    constructor(message: string, agent: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=agent-aborted.error.d.ts.map

package/dist/errors/agent-aborted.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-aborted.error.d.ts","sourceRoot":"","sources":["../../lib/errors/agent-aborted.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI1E"}

package/dist/errors/agent-aborted.error.js

@@ -0,0 +1,22 @@
+import { AgentRunError } from './agent-run.error.js';
+/**
+ * The run's `signal` was aborted. Its `reason` is in `cause`.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await agent.run(question, { signal: AbortSignal.timeout(30_000) });
+ * } catch (error) {
+ *   if (error instanceof AgentAbortedError) {
+ *     console.warn('gave up:', error.cause);
+ *   }
+ * }
+ * ```
+ */
+export class AgentAbortedError extends AgentRunError {
+    constructor(message, agent, options) {
+        super(message, agent, options);
+        this.name = 'AgentAbortedError';
+    }
+}
+//# sourceMappingURL=agent-aborted.error.js.map

package/dist/errors/agent-aborted.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-aborted.error.js","sourceRoot":"","sources":["../../lib/errors/agent-aborted.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD,YAAY,OAAe,EAAE,KAAa,EAAE,OAA6B;QACvE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}

package/dist/errors/agent-recursion-limit.error.d.ts

@@ -0,0 +1,23 @@
+import { AgentRunError } from './agent-run.error.js';
+/**
+ * The run took its `recursionLimit` of steps without an answer: the model kept
+ * calling tools. LangGraph's error is in `cause`.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await agent.run(question, { recursionLimit: 10 });
+ * } catch (error) {
+ *   if (error instanceof AgentRecursionLimitError) {
+ *     return 'This question needs too many steps.';
+ *   }
+ *   throw error;
+ * }
+ * ```
+ */
+export declare class AgentRecursionLimitError extends AgentRunError {
+    constructor(message: string, agent: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=agent-recursion-limit.error.d.ts.map

package/dist/errors/agent-recursion-limit.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-recursion-limit.error.d.ts","sourceRoot":"","sources":["../../lib/errors/agent-recursion-limit.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI1E"}

package/dist/errors/agent-recursion-limit.error.js

@@ -0,0 +1,24 @@
+import { AgentRunError } from './agent-run.error.js';
+/**
+ * The run took its `recursionLimit` of steps without an answer: the model kept
+ * calling tools. LangGraph's error is in `cause`.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await agent.run(question, { recursionLimit: 10 });
+ * } catch (error) {
+ *   if (error instanceof AgentRecursionLimitError) {
+ *     return 'This question needs too many steps.';
+ *   }
+ *   throw error;
+ * }
+ * ```
+ */
+export class AgentRecursionLimitError extends AgentRunError {
+    constructor(message, agent, options) {
+        super(message, agent, options);
+        this.name = 'AgentRecursionLimitError';
+    }
+}
+//# sourceMappingURL=agent-recursion-limit.error.js.map

package/dist/errors/agent-recursion-limit.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-recursion-limit.error.js","sourceRoot":"","sources":["../../lib/errors/agent-recursion-limit.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,wBAAyB,SAAQ,aAAa;IACzD,YAAY,OAAe,EAAE,KAAa,EAAE,OAA6B;QACvE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF"}

package/dist/errors/index.d.ts

@@ -1,4 +1,7 @@
+export { AgentAbortedError } from './agent-aborted.error.js';
+export { AgentRecursionLimitError } from './agent-recursion-limit.error.js';
 export { AgentRunError } from './agent-run.error.js';
+export { toRunError } from './run-error.util.js';
 export { StructuredOutputError } from './structured-output.error.js';
 export { ToolConfigurationError } from './tool-configuration.error.js';
 export { unwrapMiddlewareError } from './unwrap-middleware-error.util.js';

package/dist/errors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/errors/index.js

@@ -1,4 +1,7 @@
+export { AgentAbortedError } from './agent-aborted.error.js';
+export { AgentRecursionLimitError } from './agent-recursion-limit.error.js';
 export { AgentRunError } from './agent-run.error.js';
+export { toRunError } from './run-error.util.js';
 export { StructuredOutputError } from './structured-output.error.js';
 export { ToolConfigurationError } from './tool-configuration.error.js';
 export { unwrapMiddlewareError } from './unwrap-middleware-error.util.js';

package/dist/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/errors/messages.d.ts

@@ -22,6 +22,9 @@ export declare const reservedAgentName: (name: string) => string;
 export declare const agentRunFailed: (prefix: string, cause: unknown) => string;
 export declare const modelNeverReplied: (prefix: string, last: string | undefined) => string;
 export declare const modelReplyEmpty: (prefix: string) => string;
+export declare const runAborted: (prefix: string) => string;
+export declare const recursionLimitReached: (prefix: string, limit: number) => string;
+export declare const invalidRecursionLimit: (prefix: string, limit: unknown) => string;
 export declare const noOutputJsonSchemaForm: (prefix: string, reason: string) => string;
 export declare const outputNotAnObject: (prefix: string) => string;
 export declare const structuredOutputMissing: (prefix: string) => string;

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

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../lib/errors/messages.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../lib/errors/messages.ts"],"names":[],"mappings":"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"}

package/dist/errors/messages.js

@@ -64,6 +64,12 @@ export const agentRunFailed = (prefix, cause) => `The ${prefix}agent's run faile
 export const modelNeverReplied = (prefix, last) => `The ${prefix}agent's loop ended before the model replied. ` +
     `The last message was ${last ? `a ${last} message` : 'never produced'}.`;
 export const modelReplyEmpty = (prefix) => `The ${prefix}agent's model replied with no text content.`;
+export const runAborted = (prefix) => `The ${prefix}agent's run was aborted.`;
+export const recursionLimitReached = (prefix, limit) => `The ${prefix}agent's run reached its recursion limit of ${limit} steps ` +
+    'without an answer. Raise `recursionLimit`, or check what makes the model ' +
+    'keep calling tools.';
+export const invalidRecursionLimit = (prefix, limit) => `The ${prefix}agent's \`recursionLimit\` must be an integer of at least 1, ` +
+    `not ${typeof limit === 'string' ? `"${limit}"` : String(limit)}.`;
 export const noOutputJsonSchemaForm = (prefix, reason) => `The ${prefix}agent's \`output\` schema has no JSON Schema form (${reason}). ` +
     jsonSchemaAdvice;
 export const outputNotAnObject = (prefix) => `The ${prefix}agent's \`output\` schema is not an object with named fields: ` +

package/dist/errors/messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../lib/errors/messages.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../lib/errors/messages.ts"],"names":[],"mappings":"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"}

package/dist/errors/run-error.util.d.ts

@@ -0,0 +1,21 @@
+import { AgentRunError } from './agent-run.error.js';
+interface FailedRun {
+    agent: string;
+    /** Empty for the unnamed agent, `'MATH '` otherwise. */
+    prefix: string;
+    signal?: AbortSignal;
+    /** The limit the run was given. */
+    recursionLimit: number;
+}
+/**
+ * The `AgentRunError` `run()` throws for what the agent's graph threw.
+ *
+ * @internal
+ * @param thrown What the graph threw.
+ * @param run The run that failed.
+ * @returns The error itself when it is one already, else the subclass of its
+ * kind, the original in `cause`.
+ */
+export declare const toRunError: (thrown: unknown, { agent, prefix, signal, recursionLimit }: FailedRun) => AgentRunError;
+export {};
+//# sourceMappingURL=run-error.util.d.ts.map

package/dist/errors/run-error.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-error.util.d.ts","sourceRoot":"","sources":["../../lib/errors/run-error.util.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAQrD,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACrB,QAAQ,OAAO,EACf,2CAA2C,SAAS,KACnD,aAyBF,CAAC"}

package/dist/errors/run-error.util.js

@@ -0,0 +1,33 @@
+import { AgentAbortedError } from './agent-aborted.error.js';
+import { AgentRecursionLimitError } from './agent-recursion-limit.error.js';
+import { AgentRunError } from './agent-run.error.js';
+import { agentRunFailed, recursionLimitReached, runAborted, } from './messages.js';
+import { unwrapMiddlewareError } from './unwrap-middleware-error.util.js';
+/**
+ * The `AgentRunError` `run()` throws for what the agent's graph threw.
+ *
+ * @internal
+ * @param thrown What the graph threw.
+ * @param run The run that failed.
+ * @returns The error itself when it is one already, else the subclass of its
+ * kind, the original in `cause`.
+ */
+export const toRunError = (thrown, { agent, prefix, signal, recursionLimit }) => {
+    const cause = unwrapMiddlewareError(thrown);
+    if (cause instanceof AgentRunError) {
+        return cause;
+    }
+    // The reason itself, which LangChain may have wrapped on its way out.
+    if (signal?.aborted) {
+        return new AgentAbortedError(runAborted(prefix), agent, {
+            cause: signal.reason,
+        });
+    }
+    // By name, as LangGraph tells its errors apart; it is not a dependency of
+    // ours. See #194.
+    if (cause instanceof Error && cause.name === 'GraphRecursionError') {
+        return new AgentRecursionLimitError(recursionLimitReached(prefix, recursionLimit), agent, { cause });
+    }
+    return new AgentRunError(agentRunFailed(prefix, cause), agent, { cause });
+};
+//# sourceMappingURL=run-error.util.js.map

package/dist/errors/run-error.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-error.util.js","sourceRoot":"","sources":["../../lib/errors/run-error.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAW1E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,MAAe,EACf,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAa,EACrC,EAAE;IACjB,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE5C,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sEAAsE;IACtE,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,OAAO,IAAI,iBAAiB,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE;YACtD,KAAK,EAAE,MAAM,CAAC,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED,0EAA0E;IAC1E,kBAAkB;IAClB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;QACnE,OAAO,IAAI,wBAAwB,CACjC,qBAAqB,CAAC,MAAM,EAAE,cAAc,CAAC,EAC7C,KAAK,EACL,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5E,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 export { LangChainModule } from './langchain.module.js';
 export { getAgentToken } from './langchain.module-definition.js';
 export { Agent } from './agent.js';
-export { AgentRunError, StructuredOutputError, ToolConfigurationError, } from './errors/index.js';
+export { OUTPUT_TOOL } from './constants.js';
+export { AgentAbortedError, AgentRecursionLimitError, AgentRunError, StructuredOutputError, ToolConfigurationError, } from './errors/index.js';
 export { InjectAgent, Tool, ToolParam } from './decorators/index.js';
 export type { ToolOptions, ToolParamOptions } from './decorators/index.js';
 export type { AgentObserver, ModelErrorEvent, RunErrorEvent, RunFinishEvent, ToolEndEvent, ToolErrorEvent, ToolStartEvent, } from './interfaces/agent-observer.interface.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,YAAY,EACV,aAAa,EACb,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,0CAA0C,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAC5E,YAAY,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,YAAY,EACV,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACvB,WAAW,EACX,WAAW,EACX,UAAU,GACX,MAAM,oDAAoD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,EACb,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,YAAY,EACV,aAAa,EACb,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,0CAA0C,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAC5E,YAAY,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,YAAY,EACV,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACvB,WAAW,EACX,WAAW,EACX,UAAU,GACX,MAAM,oDAAoD,CAAC"}

package/dist/index.js

@@ -3,6 +3,7 @@
 export { LangChainModule } from './langchain.module.js';
 export { getAgentToken } from './langchain.module-definition.js';
 export { Agent } from './agent.js';
-export { AgentRunError, StructuredOutputError, ToolConfigurationError, } from './errors/index.js';
+export { OUTPUT_TOOL } from './constants.js';
+export { AgentAbortedError, AgentRecursionLimitError, AgentRunError, StructuredOutputError, ToolConfigurationError, } from './errors/index.js';
 export { InjectAgent, Tool, ToolParam } from './decorators/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,uBAAuB;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,uBAAuB;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,EACb,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC"}