nestjs-langchain 2.0.0-rc.0 → 2.1.0

package/README.md

@@ -2,8 +2,14 @@
   <a href="http://nestjs.com/" target="blank"><img src="https://nestjs.com/img/logo-small.svg" width="200" alt="Nest Logo" /></a>
 </p>
 
+<h1 align="center">nestjs-langchain</h1>
+
+<p align="center">
+  <strong>AI agents for <a href="https://nestjs.com/">NestJS</a>, powered by <a href="https://www.langchain.com/">LangChain</a>.</strong>
+</p>
+
 <p align="center">
-  A <a href="https://nestjs.com/">Nest</a> module wrapper for building AI agents with <a href="https://www.langchain.com/">LangChain</a>.
+  Declare agents as modules, inject them like any provider, and give them your services as tools.
 </p>
 
 <p align="center">
@@ -26,15 +32,32 @@
 - [Quick start](#quick-start)
 - [Defining tools](#defining-tools)
 - [Multi-agent support](#multi-agent-support)
+- [Structured output](#structured-output)
 - [Async configuration](#async-configuration)
 - [Testing](#testing)
 - [Logging and observing](#logging-and-observing)
+- [Roadmap](#roadmap)
+- [Tutorials](#tutorials)
 - [Contributing](#contributing)
 - [License](#license)
 
 ## Description
 
-**nestjs-langchain** is a powerful, decorator-driven wrapper that integrates LangChain agents seamlessly into the NestJS ecosystem. It allows you to transform standard NestJS services into AI tools and manage multiple isolated agents with distinct roles and configurations.
+**nestjs-langchain** brings AI agents to NestJS. Your app becomes their harness: an agent is a
+module, its tools are your services, and dependency injection, configuration and tests work as
+everywhere else in Nest. LangChain runs the agent loop underneath.
+
+- **[Agents as modules](#quick-start)**: register an agent, inject it, `run()` it.
+- **[Your services as tools](#defining-tools)**: `@Tool()` turns a method into a tool the model
+  can call.
+- **[Several agents, several models](#multi-agent-support)**: each agent has its own prompt,
+  tools and model, from OpenAI, Anthropic, Mistral, Google, Ollama or any LangChain chat model.
+- **[Typed answers](#structured-output)**: structured output parsed from a Zod schema.
+- **[Observable](#logging-and-observing) and [testable](#testing)**: an observer on every run
+  and tool call, LangSmith tracing, and tests on LangChain's `fakeModel()`.
+
+MCP servers, conversation memory and streaming are on the [roadmap](#roadmap). New to it? Start
+with the [tutorials](#tutorials).
 
 ## Installation
 
@@ -186,7 +209,7 @@ Before exposing tools to users, read [docs/security.md](docs/security.md).
 
 ## Multi-Agent Support
 
-Give each agent a `name`, and inject it with `@InjectAgent()`.
+Give each agent a `name`, its own model and tools, and inject it with `@InjectAgent()`.
 
 ### 1. Register a specific agent
 
@@ -202,7 +225,7 @@ Give each agent a `name`, and inject it with `@InjectAgent()`.
     }),
     LangChainModule.register({
       name: 'MONGO_AGENT',
-      model: { model: 'openai:gpt-5-mini' },
+      model: { model: 'anthropic:claude-sonnet-5-5' },
       tools: [MongoModule],
     }),
   ],
@@ -225,6 +248,22 @@ export class AppService {
 
 `Agent` without `@InjectAgent()` is the agent registered without a name.
 
+## Structured output
+
+Pass a Zod schema as `output`, and `run()` returns the object it parses, typed from it:
+
+```ts
+import { z } from 'zod';
+
+const Classification = z.object({
+  category: z.enum(['billing', 'bug', 'other']),
+  priority: z.number().int().min(1).max(3),
+});
+
+const { output } = await this.agent.run(ticket.body, { output: Classification });
+//      ^? { category: 'billing' | 'bug' | 'other'; priority: number }
+```
+
 ## Async Configuration
 
 Build the options from other providers with `registerAsync`:
@@ -318,7 +357,8 @@ Every event, the errors, the log lines and `callbacks`: [docs/observing.md](docs
 ### Errors
 
 Everything `run()` throws is an `AgentRunError`, with the `agent` that failed and the original
-error in `cause`:
+error in `cause`. A structured output that is missing or invalid throws its subclass,
+`StructuredOutputError`:
 
 ```ts
 import { AgentRunError } from 'nestjs-langchain';
@@ -332,6 +372,28 @@ try {
 }
 ```
 
+## Roadmap
+
+What comes next, tracked in the issues:
+
+- Tools from MCP servers and LangChain integrations ([#195](https://github.com/Martin-Bruel/nestjs-langchain/issues/195))
+- Conversation memory ([#149](https://github.com/Martin-Bruel/nestjs-langchain/issues/149))
+- Streaming ([#154](https://github.com/Martin-Bruel/nestjs-langchain/issues/154))
+- Human-in-the-loop approval of tool calls ([#153](https://github.com/Martin-Bruel/nestjs-langchain/issues/153))
+- A per-run context for tools, such as the current user ([#148](https://github.com/Martin-Bruel/nestjs-langchain/issues/148))
+
+## Tutorials
+
+The series [AI agents with NestJS](https://dev.to/martinbruel/series/45463), on DEV:
+
+1. [NestJS + LangChain: Build an AI Agent in 5 Minutes](https://dev.to/martinbruel/nestjs-langchain-build-an-ai-agent-in-5-minutes-1jfd):
+   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.
+
+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.
+
 ## Contributing
 
 Contributions are welcome. Read the

package/dist/agent.d.ts

@@ -1,7 +1,9 @@
 import { OnModuleInit } from '@nestjs/common';
 import { DiscoveryService } from '@nestjs/core';
+import type { z, ZodType } from 'zod';
 import { LangChainModuleOptions } from './interfaces/langchain-module-options.interface.js';
 import { CompletedRun } from './interfaces/completed-run.interface.js';
+import { RunOptions } from './interfaces/run-options.interface.js';
 import { ToolDiscoveryService } from './tools/index.js';
 /**
  * One agent, registered through `LangChainModule`. Inject it directly for the
@@ -51,13 +53,25 @@ export declare class Agent implements OnModuleInit {
      * as an `AgentRunError`, the original error in its `cause`.
      *
      * @param input The user's message.
-     * @returns The model's answer, the tools it called and what the run cost.
+     * @param options With `output`, the schema the answer must match.
+     * @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: ticket } = await agent.run(email, {
+     *   output: z.object({ category: z.enum(['billing', 'bug', 'other']) }),
+     * });
      * ```
      */
-    run(input: string): Promise<CompletedRun>;
+    run<S extends ZodType>(input: string, options: RunOptions & {
+        output: S;
+    }): Promise<CompletedRun<z.output<S>>>;
+    run(input: string, options?: RunOptions & {
+        output?: undefined;
+    }): Promise<CompletedRun>;
+    run(input: string, options?: RunOptions): Promise<CompletedRun<unknown>>;
     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;AAOhD,OAAO,EACL,sBAAsB,EAEvB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EACL,oBAAoB,EAGrB,MAAM,kBAAkB,CAAC;AAsB1B;;;;;;;;;;;;;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;IAwBlB,OAAO,CAAC,gBAAgB;IAiBxB;;;;;;;;OAQG;YACW,YAAY;IA8B1B;;;;;;;;;;OAUG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YAsCjC,QAAQ;CA+BvB"}
+{"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"}

package/dist/agent.js

@@ -17,8 +17,9 @@ 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 } from './run/index.js';
-import { AgentRunError } from './errors/index.js';
+import { 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';
 /**
  * One agent, registered through `LangChainModule`. Inject it directly for the
@@ -80,8 +81,13 @@ let Agent = class Agent {
             model: await this.resolveModel(this.options.model),
             tools,
             systemPrompt: this.options.systemPrompt,
-            // The first wraps the next: `toolErrors` sits right around the tool.
-            middleware: [unknownTools(this.reporter), toolErrors(this.reporter)],
+            // The first wraps the next: `toolErrors` sits right around the tool,
+            // `structuredOutput` right around the model.
+            middleware: [
+                unknownTools(this.reporter, tools.map((tool) => tool.name)),
+                toolErrors(this.reporter),
+                structuredOutput(),
+            ],
         });
         this.logger.log(`${this.prefix}ready with ${tools.length} tool${tools.length === 1 ? '' : 's'}`, LOG_CONTEXT);
     }
@@ -127,33 +133,28 @@ let Agent = class Agent {
         // The same object, typed from the declarations `createAgent` reads.
         return option;
     }
-    /**
-     * Runs the agent to completion on one user message. Every failure is thrown
-     * as an `AgentRunError`, the original error in its `cause`.
-     *
-     * @param input The user's message.
-     * @returns The model's answer, the tools it called and what the run cost.
-     * @example
-     * ```ts
-     * const { output, tools } = await agent.run('What is 6 times 7?');
-     * ```
-     */
-    async run(input) {
+    async run(input, options) {
         const startedAt = Date.now();
         const durationMs = () => Date.now() - startedAt;
         try {
-            const { answer, messages } = await this.complete(input);
+            // 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;
+            const output = schema && new RunOutput(schema, this.agentName);
+            const aside = new UsageAside();
+            const { answer, messages } = await this.complete(input, output, aside);
             const finished = {
                 durationMs: durationMs(),
-                ...summariseRun(messages),
+                ...summariseRun(messages, output?.toolName, aside.usage),
             };
             this.reporter.notify((observer) => observer.onRunFinish?.({ agent: this.agentName, ...finished }));
             return { status: 'completed', output: answer, ...finished };
         }
         catch (thrown) {
-            const error = thrown instanceof AgentRunError
-                ? thrown
-                : new AgentRunError(agentRunFailed(this.prefix, thrown), this.agentName, { cause: thrown });
+            const cause = unwrapMiddlewareError(thrown);
+            const error = cause instanceof AgentRunError
+                ? cause
+                : new AgentRunError(agentRunFailed(this.prefix, cause), this.agentName, { cause });
             this.reporter.notify((observer) => observer.onRunError?.({
                 agent: this.agentName,
                 durationMs: durationMs(),
@@ -162,15 +163,22 @@ let Agent = class Agent {
             throw error;
         }
     }
-    async complete(input) {
+    async complete(input, output, aside) {
         if (!this.#graph) {
             throw new AgentRunError(agentNotBootstrapped(this.prefix), this.agentName);
         }
-        const { messages } = await this.#graph.invoke({ messages: [{ role: 'user', content: input }] }, { callbacks: [this.modelErrors, ...(this.options.callbacks ?? [])] });
+        const state = await this.#graph.invoke({ messages: [{ role: 'user', content: input }] }, {
+            callbacks: [this.modelErrors, ...(this.options.callbacks ?? [])],
+            configurable: { ...outputConfig(output), ...aside.config },
+        });
+        const { messages } = state;
         const last = messages[messages.length - 1];
         if (!last || last.type !== 'ai') {
             throw new AgentRunError(modelNeverReplied(this.prefix, last?.type), this.agentName);
         }
+        if (output) {
+            return { answer: output.read(state.structuredResponse), messages };
+        }
         // `text`, not `content`: block answers are an array.
         if (!last.text) {
             throw new AgentRunError(modelReplyEmpty(this.prefix), this.agentName);

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

@@ -1,5 +1,7 @@
 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";
 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,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,eAAO,MAAM,WAAW,mBAAsC,CAAC;AAI/D,eAAO,MAAM,oBAAoB,UAKhC,CAAC"}

package/dist/constants.js

@@ -3,6 +3,12 @@ export const TOOL_METADATA = 'nestjs-langchain:tool';
 export const TOOL_PARAMS_METADATA = 'nestjs-langchain:tool-params';
 // Emitted by `emitDecoratorMetadata` on every decorated method.
 export const PARAM_TYPES_METADATA = 'design:paramtypes';
+// The agent routes a call with this prefix to structured output, never to the
+// tool. Restated: LangChain does not export it. See #213.
+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.
+export const OUTPUT_TOOL = `${STRUCTURED_OUTPUT_PREFIX}output`;
 // 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,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,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"}

package/dist/errors/index.d.ts

@@ -1,3 +1,5 @@
 export { AgentRunError } from './agent-run.error.js';
+export { StructuredOutputError } from './structured-output.error.js';
 export { ToolConfigurationError } from './tool-configuration.error.js';
+export { unwrapMiddlewareError } from './unwrap-middleware-error.util.js';
 //# sourceMappingURL=index.d.ts.map

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,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}
+{"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"}

package/dist/errors/index.js

@@ -1,3 +1,5 @@
 export { AgentRunError } from './agent-run.error.js';
+export { StructuredOutputError } from './structured-output.error.js';
 export { ToolConfigurationError } from './tool-configuration.error.js';
+export { unwrapMiddlewareError } from './unwrap-middleware-error.util.js';
 //# sourceMappingURL=index.js.map

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,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}
+{"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"}

package/dist/errors/messages.d.ts

@@ -22,5 +22,12 @@ 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 noOutputJsonSchemaForm: (prefix: string, reason: string) => string;
+export declare const outputNotAnObject: (prefix: string) => string;
+export declare const structuredOutputMissing: (prefix: string) => string;
+export declare const structuredOutputInvalid: (prefix: string, reason: string) => string;
+export declare const structuredOutputMultiple: (prefix: string, count: number) => string;
 export declare const unknownTool: () => string;
+export declare const invalidTool: (tool: string, tools: string[]) => string;
+export declare const toolNotRun: (tool: string) => string;
 //# sourceMappingURL=messages.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../lib/errors/messages.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,MACA,CAAC;AAE7C,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,EAAE,KAAG,MAIV,CAAC;AAEzD,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAE6B,CAAC;AAE7E,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,KAAG,MAEU,CAAC;AAEjE,eAAO,MAAM,0BAA0B,GACrC,OAAO,MAAM,EACb,OAAO,MAAM,KACZ,MAG8C,CAAC;AAElD,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,KAAG,MAGhC,CAAC;AAExB,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,MAEiB,CAAC;AAEvE,eAAO,MAAM,sBAAsB,QAAO,MACW,CAAC;AAEtD,eAAO,MAAM,kBAAkB,GAC7B,UAAU,MAAM,EAChB,OAAO,SAAS,GAAG,WAAW,GAAG,oBAAoB,EACrD,SAAS,MAAM,EAAE,KAChB,MAQgE,CAAC;AAEpE,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,OAAO,MAAM,EACb,QAAQ,MAAM,KACb,MAEsC,CAAC;AAE1C,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,EACb,MAAM,MAAM,EACZ,SAAS,MAAM,EACf,gBAAgB,OAAO,KACtB,MAEqD,CAAC;AAEzD,eAAO,MAAM,gBAAgB,GAC3B,OAAO,MAAM,EACb,MAAM,MAAM,EACZ,QAAQ,MAAM,KACb,MAGmB,CAAC;AAEvB,eAAO,MAAM,iBAAiB,GAC5B,OAAO,MAAM,EACb,OAAO,MAAM,EACb,UAAU,MAAM,KACf,MAEiE,CAAC;AAErE,eAAO,MAAM,0BAA0B,GACrC,OAAO,MAAM,EACb,OAAO,MAAM,EACb,UAAU,MAAM,EAAE,EAClB,UAAU,MAAM,KACf,MAEwC,CAAC;AAE5C,eAAO,MAAM,gBAAgB,GAC3B,OAAO,MAAM,EACb,OAAO,MAAM,EACb,QAAQ,MAAM,KACb,MAGqC,CAAC;AAEzC,eAAO,MAAM,kBAAkB,GAC7B,OAAO,MAAM,EACb,MAAM,MAAM,EACZ,OAAO,MAAM,EACb,QAAQ,MAAM,KACb,MAEmC,CAAC;AAEvC,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,KAAG,MAGK,CAAC;AAErD,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,EAAE,OAAO,OAAO,KAAG,MAEL,CAAC;AAE3D,eAAO,MAAM,oBAAoB,GAAI,QAAQ,MAAM,KAAG,MAER,CAAC;AAE/C,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,MAKA,CAAC;AAE/D,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,MAKC,CAAC;AAEnD,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,EAAE,OAAO,OAAO,KAAG,MAEN,CAAC;AAE3D,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,EACd,MAAM,MAAM,GAAG,SAAS,KACvB,MAEuE,CAAC;AAE3E,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MACW,CAAC;AAE7D,eAAO,MAAM,WAAW,QAAO,MAAoC,CAAC"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../lib/errors/messages.ts"],"names":[],"mappings":"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"}

package/dist/errors/messages.js

@@ -36,9 +36,10 @@ export const cannotInferSchema = (where, param, declared) => `${where}: cannot i
     'Pass a `schema` to @ToolParam, or use string, number or boolean.';
 export const schemaContradictsSignature = (where, param, declared, expected) => `${where}: the schema for "${param}" describes ${declared.join(' | ')} ` +
     `but the signature declares ${expected}.`;
-export const noJsonSchemaForm = (where, param, reason) => `${where}: "${param}" has no JSON Schema form (${reason}). ` +
-    'Declare a schema JSON Schema can express and convert it with .transform(), ' +
-    'such as z.iso.datetime() for a date.';
+// The advice of both messages on a schema with no JSON Schema form.
+const jsonSchemaAdvice = 'Declare a schema JSON Schema can express and convert it with .transform(), ' +
+    'such as z.iso.date() or z.iso.datetime() for a date.';
+export const noJsonSchemaForm = (where, param, reason) => `${where}: "${param}" has no JSON Schema form (${reason}). ${jsonSchemaAdvice}`;
 export const duplicateParamName = (where, name, first, second) => `${where}: parameters ${first + 1} and ${second + 1} are both named "${name}". ` +
     'Give each @ToolParam its own name.';
 export const notAChatModel = (prefix) => `The ${prefix}agent's \`model\` is neither a LangChain chat model nor a ` +
@@ -63,5 +64,19 @@ 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 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: ` +
+    "the model fills it in as a tool's parameters. Wrap it, such as " +
+    '`z.object({ items: z.array(...) })`.';
+export const structuredOutputMissing = (prefix) => `The ${prefix}agent's model replied without the requested structured output.`;
+export const structuredOutputInvalid = (prefix, reason) => `The ${prefix}agent's model replied with an output that does not match ` +
+    `the schema: ${reason}`;
+export const structuredOutputMultiple = (prefix, count) => `The ${prefix}agent's model replied with ${count} outputs instead of one.`;
 export const unknownTool = () => 'not a tool of this agent';
+// LangChain's answer to a tool the agent does not have, restated:
+// `getInvalidToolError` is not exported. See #264.
+export const invalidTool = (tool, tools) => `Error: ${tool} is not a valid tool, try one of [${tools.join(', ')}].`;
+export const toolNotRun = (tool) => `Error: '${tool}' was not run: it came with the final answer. ` +
+    'Call it on its own first if it is needed.';
 //# sourceMappingURL=messages.js.map

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/structured-output.error.d.ts

@@ -0,0 +1,22 @@
+import { AgentRunError } from './agent-run.error.js';
+/**
+ * The model's answer to a run with an `output` schema never came, or does not
+ * match the schema. LangChain's or Zod's error, if any, is in `cause`.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   const { output } = await agent.run(ticket, { output: Classification });
+ * } catch (error) {
+ *   if (error instanceof StructuredOutputError) {
+ *     console.error(error.message, error.cause);
+ *   }
+ * }
+ * ```
+ */
+export declare class StructuredOutputError extends AgentRunError {
+    constructor(message: string, agent: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=structured-output.error.d.ts.map

package/dist/errors/structured-output.error.d.ts.map

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

package/dist/errors/structured-output.error.js

@@ -0,0 +1,23 @@
+import { AgentRunError } from './agent-run.error.js';
+/**
+ * The model's answer to a run with an `output` schema never came, or does not
+ * match the schema. LangChain's or Zod's error, if any, is in `cause`.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   const { output } = await agent.run(ticket, { output: Classification });
+ * } catch (error) {
+ *   if (error instanceof StructuredOutputError) {
+ *     console.error(error.message, error.cause);
+ *   }
+ * }
+ * ```
+ */
+export class StructuredOutputError extends AgentRunError {
+    constructor(message, agent, options) {
+        super(message, agent, options);
+        this.name = 'StructuredOutputError';
+    }
+}
+//# sourceMappingURL=structured-output.error.js.map

package/dist/errors/structured-output.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.error.js","sourceRoot":"","sources":["../../lib/errors/structured-output.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,YAAY,OAAe,EAAE,KAAa,EAAE,OAA6B;QACvE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/errors/unwrap-middleware-error.util.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The error as thrown, without the `MiddlewareError` LangChain wraps it in at
+ * each `wrapModelCall` middleware it crosses, a provider error included.
+ *
+ * @internal
+ * @param error What the agent's graph threw.
+ * @returns The innermost error.
+ */
+export declare const unwrapMiddlewareError: (error: unknown) => unknown;
+//# sourceMappingURL=unwrap-middleware-error.util.d.ts.map

package/dist/errors/unwrap-middleware-error.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unwrap-middleware-error.util.d.ts","sourceRoot":"","sources":["../../lib/errors/unwrap-middleware-error.util.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,OAQtD,CAAC"}

package/dist/errors/unwrap-middleware-error.util.js

@@ -0,0 +1,17 @@
+import { MiddlewareError } from 'langchain';
+/**
+ * The error as thrown, without the `MiddlewareError` LangChain wraps it in at
+ * each `wrapModelCall` middleware it crosses, a provider error included.
+ *
+ * @internal
+ * @param error What the agent's graph threw.
+ * @returns The innermost error.
+ */
+export const unwrapMiddlewareError = (error) => {
+    let unwrapped = error;
+    while (MiddlewareError.isInstance(unwrapped) && unwrapped.cause) {
+        unwrapped = unwrapped.cause;
+    }
+    return unwrapped;
+};
+//# sourceMappingURL=unwrap-middleware-error.util.js.map

package/dist/errors/unwrap-middleware-error.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unwrap-middleware-error.util.js","sourceRoot":"","sources":["../../lib/errors/unwrap-middleware-error.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAc,EAAW,EAAE;IAC/D,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,OAAO,eAAe,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QAChE,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC;IAC9B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 export { LangChainModule } from './langchain.module.js';
 export { getAgentToken } from './langchain.module-definition.js';
 export { Agent } from './agent.js';
-export { AgentRunError, ToolConfigurationError } from './errors/index.js';
+export { 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';
 export type { CompletedRun } from './interfaces/completed-run.interface.js';
+export type { RunOptions } from './interfaces/run-options.interface.js';
 export type { AgentCallback, LangChainModuleOptions, LangChainOptionsFactory, ModelConfig, ModelOption, ToolModule, } from './interfaces/langchain-module-options.interface.js';
 //# sourceMappingURL=index.d.ts.map

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,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,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,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,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"}

package/dist/index.js

@@ -3,6 +3,6 @@
 export { LangChainModule } from './langchain.module.js';
 export { getAgentToken } from './langchain.module-definition.js';
 export { Agent } from './agent.js';
-export { AgentRunError, ToolConfigurationError } from './errors/index.js';
+export { 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,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,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,EACL,aAAa,EACb,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/interfaces/completed-run.interface.d.ts

@@ -6,7 +6,7 @@ import type { RunSummary } from '../run/index.js';
 export interface CompletedRun<TOutput = string> extends RunSummary {
     /** Always `'completed'`: a run that fails throws instead. */
     status: 'completed';
-    /** The model's text answer. */
+    /** The model's text answer, or the object the run's `output` schema parsed. */
     output: TOutput;
     /** How long the run took. */
     durationMs: number;

package/dist/interfaces/completed-run.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completed-run.interface.d.ts","sourceRoot":"","sources":["../../lib/interfaces/completed-run.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,OAAO,GAAG,MAAM,CAAE,SAAQ,UAAU;IAChE,6DAA6D;IAC7D,MAAM,EAAE,WAAW,CAAC;IACpB,+BAA+B;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"completed-run.interface.d.ts","sourceRoot":"","sources":["../../lib/interfaces/completed-run.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,OAAO,GAAG,MAAM,CAAE,SAAQ,UAAU;IAChE,6DAA6D;IAC7D,MAAM,EAAE,WAAW,CAAC;IACpB,+EAA+E;IAC/E,MAAM,EAAE,OAAO,CAAC;IAChB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/interfaces/run-options.interface.d.ts

@@ -0,0 +1,21 @@
+import type { ZodType } from 'zod';
+/**
+ * The options of one run. Passed inline, they type `output` from the schema;
+ * typed `RunOptions`, `output` is `unknown`.
+ *
+ * @example
+ * ```ts
+ * const { output } = await agent.run(email, { output: Ticket }); // a Ticket
+ *
+ * const ask = (question: string, options?: RunOptions) =>
+ *   agent.run(question, options); // `output` is unknown
+ * ```
+ */
+export interface RunOptions {
+    /**
+     * The schema the answer must match. `output` is then the object it parses,
+     * typed from it, instead of the model's text.
+     */
+    output?: ZodType;
+}
+//# sourceMappingURL=run-options.interface.d.ts.map