nestjs-langchain 1.0.2 → 2.0.0

package/dist/errors/messages.js

@@ -0,0 +1,67 @@
+// Message construction, kept together so the wording stays consistent.
+import { UNNAMED_AGENT } from '../langchain.module-definition.js';
+// `'MATH '` for a named agent, empty for the unnamed one: "the MATH agent".
+export const agentPrefix = (agent) => agent === UNNAMED_AGENT ? '' : `${agent} `;
+export const toolProblems = (prefix, problems) => `nestjs-langchain found ${problems.length} ` +
+    `problem${problems.length === 1 ? '' : 's'} ` +
+    `with the tools of the ${prefix}agent:\n` +
+    problems.map((problem) => `  - ${problem}`).join('\n');
+export const notAToolModule = (entry) => `${entry} is listed in \`tools\` but is not a module in the Nest context. ` +
+    'Pass a class decorated with @Module, imported alongside LangChainModule.';
+export const toolModuleNotImported = (entry) => `${entry} is listed in \`tools\` but is not imported into the Nest context. ` +
+    'Add it to the `imports` of the module registering the agent.';
+export const severalToolModuleInstances = (entry, count) => `${entry} is listed in \`tools\`, but the Nest context holds ${count} ` +
+    'instances of it, so their tools cannot be told apart. Import it once, or ' +
+    'give each configuration its own module class.';
+export const toolModuleWithoutTools = (entry) => `${entry} is listed in \`tools\` but declares no @Tool method. ` +
+    'Tools are read from the providers a module declares, not from the ' +
+    'modules it imports.';
+export const toolParamWithoutTool = (where) => `${where} has @ToolParam but no @Tool, so the model never sees it. ` +
+    'Add @Tool({ description }) to expose it, or remove the @ToolParam.';
+export const toolParamOutsideMethod = () => '@ToolParam can only be used on method parameters.';
+export const toolOnNonSingleton = (provider, scope, methods) => `${provider} ${{
+    request: 'is request-scoped',
+    transient: 'is transient',
+    'request-dependency': 'depends on a request-scoped provider',
+}[scope]}, so its @Tool methods (${methods.join(', ')}) cannot be called by an ` +
+    'agent, which is a singleton. Make it a default-scoped provider.';
+export const duplicateToolName = (name, first, second) => `Two tools are named "${name}": ${first} and ${second}. ` +
+    'Give one of them a `name` in @Tool().';
+export const invalidToolName = (where, name, pattern, fromMethodName) => `${where}: "${name}" is not a valid tool name, providers match ${pattern}` +
+    (fromMethodName ? '. Pass a `name` to @Tool().' : '.');
+export const reservedToolName = (where, name, prefix) => `${where}: "${name}" starts with "${prefix}", a prefix LangChain reserves ` +
+    'for structured output, so the agent would never run it. Give it another ' +
+    '`name` in @Tool().';
+export const cannotInferSchema = (where, param, declared) => `${where}: cannot infer a schema for "${param}" declared as ${declared}. ` +
+    '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.';
+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 ` +
+    "`{ model: 'provider:name' }` configuration. Pass a chat model instance " +
+    '(e.g. `new ChatOpenAI(...)`) or a configuration.';
+export const modelNotBuilt = (prefix, cause) => `The ${prefix}agent's model could not be built: ` +
+    (cause instanceof Error ? cause.message : String(cause));
+export const agentNotBootstrapped = (prefix) => `The ${prefix}agent ran before the application bootstrapped. ` +
+    'Call `app.init()` or `app.listen()` first.';
+export const duplicateAgentName = (name) => name === undefined
+    ? 'Two agents are registered without a name. ' +
+        'Give all but one a `name` and inject them with @InjectAgent().'
+    : `Two agents are registered as "${name}". ` +
+        'Give each LangChainModule registration its own `name`.';
+export const reservedAgentName = (name) => name === ''
+    ? "An agent's `name` cannot be empty. " +
+        'Omit it to register the unnamed agent.'
+    : `"${name}" cannot be an agent's \`name\`: it stands for the agent ` +
+        'registered without one. Pick another name.';
+export const agentRunFailed = (prefix, cause) => `The ${prefix}agent's run failed: ` +
+    (cause instanceof Error ? cause.message : String(cause));
+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 unknownTool = () => 'not a tool of this agent';
+//# sourceMappingURL=messages.js.map

package/dist/errors/messages.js.map

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

package/dist/errors/tool-configuration.error.d.ts

@@ -0,0 +1,23 @@
+/**
+ * An agent's tools are misconfigured, which fails the bootstrap. Lists every
+ * problem found while assembling them, not only the first.
+ *
+ * @example
+ * ```ts
+ * const app = await Test.createTestingModule({ imports: [AppModule] }).compile();
+ *
+ * await expect(app.init()).rejects.toThrow(ToolConfigurationError);
+ * ```
+ */
+export declare class ToolConfigurationError extends Error {
+    /** One message per problem, in the order they were found. */
+    readonly problems: string[];
+    /** `'default'` when the agent was registered without a name. */
+    readonly agent: string;
+    constructor(
+    /** One message per problem, in the order they were found. */
+    problems: string[], 
+    /** `'default'` when the agent was registered without a name. */
+    agent: string);
+}
+//# sourceMappingURL=tool-configuration.error.d.ts.map

package/dist/errors/tool-configuration.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-configuration.error.d.ts","sourceRoot":"","sources":["../../lib/errors/tool-configuration.error.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAE7C,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM;;IAHtB,6DAA6D;IACpD,QAAQ,EAAE,MAAM,EAAE;IAC3B,gEAAgE;IACvD,KAAK,EAAE,MAAM;CAKzB"}

package/dist/errors/tool-configuration.error.js

@@ -0,0 +1,27 @@
+import { agentPrefix, toolProblems } from './messages.js';
+/**
+ * An agent's tools are misconfigured, which fails the bootstrap. Lists every
+ * problem found while assembling them, not only the first.
+ *
+ * @example
+ * ```ts
+ * const app = await Test.createTestingModule({ imports: [AppModule] }).compile();
+ *
+ * await expect(app.init()).rejects.toThrow(ToolConfigurationError);
+ * ```
+ */
+export class ToolConfigurationError extends Error {
+    problems;
+    agent;
+    constructor(
+    /** One message per problem, in the order they were found. */
+    problems, 
+    /** `'default'` when the agent was registered without a name. */
+    agent) {
+        super(toolProblems(agentPrefix(agent), problems));
+        this.problems = problems;
+        this.agent = agent;
+        this.name = 'ToolConfigurationError';
+    }
+}
+//# sourceMappingURL=tool-configuration.error.js.map

package/dist/errors/tool-configuration.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-configuration.error.js","sourceRoot":"","sources":["../../lib/errors/tool-configuration.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAGpC;IAEA;IAJX;IACE,6DAA6D;IACpD,QAAkB;IAC3B,gEAAgE;IACvD,KAAa;QAEtB,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;QAJzC,aAAQ,GAAR,QAAQ,CAAU;QAElB,UAAK,GAAL,KAAK,CAAQ;QAGtB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,3 +1,10 @@
-export * from './langchain.module';
-export * from './decorators';
-export * from './langchain.service';
+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 { 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 { AgentCallback, LangChainModuleOptions, LangChainOptionsFactory, ModelConfig, ModelOption, ToolModule, } from './interfaces/langchain-module-options.interface.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -1,19 +1,8 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./langchain.module"), exports);
-__exportStar(require("./decorators"), exports);
-__exportStar(require("./langchain.service"), exports);
+// The public surface, the one path `exports` opens. Named, so each export is
+// a decision. See #82.
+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 { InjectAgent, Tool, ToolParam } from './decorators/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/interfaces/agent-observer.interface.d.ts

@@ -0,0 +1,107 @@
+import type { AgentRunError } from '../errors/agent-run.error.js';
+import type { RunSummary } from '../run/index.js';
+interface ToolEvent {
+    /** `'default'` when the agent was registered without a name. */
+    agent: string;
+    /** The tool's name, as the model called it. */
+    tool: string;
+    /**
+     * The id the model gave this call. Pairs a start with its end or error. A
+     * call that never reached the tool has an error and no start.
+     */
+    callId: string;
+}
+/** A tool call about to run, its arguments validated. */
+export interface ToolStartEvent extends ToolEvent {
+    /** The arguments, parsed and validated against the tool's schema. */
+    args: Record<string, unknown>;
+}
+/** A tool call that returned. */
+export interface ToolEndEvent extends ToolEvent {
+    /** What the method returned, before it is serialised for the model. */
+    output: unknown;
+    /** How long the method took. */
+    durationMs: number;
+}
+/** A tool call that failed, or never reached its tool. */
+export interface ToolErrorEvent extends ToolEvent {
+    /**
+     * Why the call failed: the agent has no such tool, the schema rejected the
+     * arguments, or the tool threw. Only `'threw'` follows an `onToolStart`.
+     * May gain values in a minor release: keep a `default` branch when
+     * switching on it.
+     */
+    reason: 'unknown-tool' | 'invalid-arguments' | 'threw';
+    /** What the tool threw, or why the call never reached it. */
+    error: unknown;
+    /** `0` when the tool never ran. */
+    durationMs: number;
+}
+/** A model call that failed. The run may still retry or fail. */
+export interface ModelErrorEvent {
+    /** `'default'` when the agent was registered without a name. */
+    agent: string;
+    /** What the provider threw. */
+    error: unknown;
+}
+/** A run that returned, with what it cost. */
+export interface RunFinishEvent extends RunSummary {
+    /** `'default'` when the agent was registered without a name. */
+    agent: string;
+    /** How long the run took. */
+    durationMs: number;
+}
+/** A run that threw. */
+export interface RunErrorEvent {
+    /** `'default'` when the agent was registered without a name. */
+    agent: string;
+    /** How long the run took before it failed. */
+    durationMs: number;
+    /** The same error the caller of `run()` receives. */
+    error: AgentRunError;
+}
+/**
+ * Called as a run goes. Every method is optional and may be async. It is
+ * never awaited, and a throw or a rejection is logged and swallowed, never
+ * propagated into the run.
+ */
+export interface AgentObserver {
+    /**
+     * Before a tool runs, once its arguments are validated.
+     *
+     * @param event The call and its arguments.
+     */
+    onToolStart?(event: ToolStartEvent): void | Promise<void>;
+    /**
+     * After a tool returns.
+     *
+     * @param event The call, its output and its duration.
+     */
+    onToolEnd?(event: ToolEndEvent): void | Promise<void>;
+    /**
+     * After a tool call fails: the tool threw, or the call never reached it.
+     *
+     * @param event The call, why it failed and the error.
+     */
+    onToolError?(event: ToolErrorEvent): void | Promise<void>;
+    /**
+     * After a model call fails.
+     *
+     * @param event The error the provider threw.
+     */
+    onModelError?(event: ModelErrorEvent): void | Promise<void>;
+    /**
+     * Only for a run that returns.
+     *
+     * @param event The run's duration, tools and tokens.
+     */
+    onRunFinish?(event: RunFinishEvent): void | Promise<void>;
+    /**
+     * For every run that throws, whatever the cause.
+     *
+     * @param event The run's duration and the error its caller receives.
+     */
+    onRunError?(event: RunErrorEvent): void | Promise<void>;
+}
+export {};
+//# sourceMappingURL=agent-observer.interface.d.ts.map

package/dist/interfaces/agent-observer.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-observer.interface.d.ts","sourceRoot":"","sources":["../../lib/interfaces/agent-observer.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,UAAU,SAAS;IACjB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yDAAyD;AACzD,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,iCAAiC;AACjC,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,uEAAuE;IACvE,MAAM,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,0DAA0D;AAC1D,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C;;;;;OAKG;IACH,MAAM,EAAE,cAAc,GAAG,mBAAmB,GAAG,OAAO,CAAC;IACvD,6DAA6D;IAC7D,KAAK,EAAE,OAAO,CAAC;IACf,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAwB;AACxB,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,KAAK,EAAE,aAAa,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,WAAW,CAAC,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D;;;;OAIG;IACH,SAAS,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD;;;;OAIG;IACH,WAAW,CAAC,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D;;;;OAIG;IACH,YAAY,CAAC,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D;;;;OAIG;IACH,WAAW,CAAC,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D;;;;OAIG;IACH,UAAU,CAAC,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD"}

package/dist/interfaces/agent-observer.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-observer.interface.js.map

package/dist/interfaces/agent-observer.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-observer.interface.js","sourceRoot":"","sources":["../../lib/interfaces/agent-observer.interface.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,14 @@
+import type { RunSummary } from '../run/index.js';
+/**
+ * A run that went to completion. `status` may gain values in a minor release:
+ * keep a `default` branch when switching on it.
+ */
+export interface CompletedRun<TOutput = string> extends RunSummary {
+    /** Always `'completed'`: a run that fails throws instead. */
+    status: 'completed';
+    /** The model's text answer. */
+    output: TOutput;
+    /** How long the run took. */
+    durationMs: number;
+}
+//# sourceMappingURL=completed-run.interface.d.ts.map

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

@@ -0,0 +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"}

package/dist/interfaces/completed-run.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=completed-run.interface.js.map

package/dist/interfaces/completed-run.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completed-run.interface.js","sourceRoot":"","sources":["../../lib/interfaces/completed-run.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/langchain-module-options.interface.d.ts

@@ -1,14 +1,82 @@
-import { Type } from '@nestjs/common/interfaces/type.interface';
-export type Model = {
+import { ModuleMetadata } from '@nestjs/common';
+import type { BaseCallbackHandler, CallbackHandlerMethods } from '@langchain/core/callbacks/base';
+import type { AgentObserver } from './agent-observer.interface.js';
+/**
+ * Model configuration, resolved at bootstrap through `initChatModel`. Its
+ * fields go as they are to the provider class, and a provider that names one
+ * differently ignores it (`ChatOllama` reads `numPredict`, not `maxTokens`):
+ * pass a model instance then.
+ */
+export type ModelConfig = {
+    /** Provider-qualified name, e.g. `openai:gpt-5-mini`. */
     model: string;
-    apiKey: string;
+    /** Omit it to let the provider read its own env var, or to use IAM/ADC. */
+    apiKey?: string;
+    /** The sampling temperature. */
     temperature?: number;
+    /** The longest answer, in tokens. */
     maxTokens?: number;
+    /** How long one model call may take, in milliseconds. */
     timeout?: number;
+    /** How many times a failed model call is retried. */
     maxRetries?: number;
 };
+/**
+ * A LangChain chat model instance, by the members `createAgent` checks for.
+ * Structural rather than `BaseChatModel`: a CommonJS application types its
+ * model from `@langchain/core`'s other declaration files. See #169.
+ */
+interface ChatModelLike {
+    /** Calls the model. */
+    invoke(...args: never[]): Promise<unknown>;
+    /** Optional, as on `BaseChatModel`; required at bootstrap. */
+    bindTools?(...args: never[]): unknown;
+    /** Streams the model's answer. */
+    _streamResponseChunks(...args: never[]): unknown;
+}
+/**
+ * A configuration to resolve, or a model that is already built. The instance
+ * form takes anything {@link ModelConfig} cannot express.
+ */
+export type ModelOption = ModelConfig | ChatModelLike;
+/**
+ * What Nest's own `imports` accepts: a module class, a dynamic module, a
+ * promise of one, or a forward reference.
+ */
+export type ToolModule = NonNullable<ModuleMetadata['imports']>[number];
+/**
+ * Anything LangChain accepts as a run callback. Every method is optional, so a
+ * plain object of the `handle*` you care about is enough.
+ */
+export type AgentCallback = BaseCallbackHandler | CallbackHandlerMethods;
+/** The options of one agent, for `register` or `registerAsync`. */
 export interface LangChainModuleOptions {
-    model: Model;
+    /** The chat model: a `provider:model` configuration, or an instance. */
+    model: ModelOption;
+    /** The instructions the model receives before every run. */
     systemPrompt?: string;
-    tools?: Type<any>[];
+    /**
+     * The modules declaring this agent's `@Tool()` providers. Each must also be
+     * imported into the Nest context, as a single instance.
+     */
+    tools?: ToolModule[];
+    /** Called as a run goes, so you decide what is worth recording. */
+    observer?: AgentObserver;
+    /** LangChain-native run callbacks, for handlers written against its API. */
+    callbacks?: AgentCallback[];
+}
+/**
+ * A class building an agent's options, for `registerAsync({ useClass })` or
+ * `useExisting`. Declare the method's return type, so that a key the options
+ * do not declare is rejected.
+ */
+export interface LangChainOptionsFactory {
+    /**
+     * Builds the agent's options.
+     *
+     * @returns The options, or a promise of them.
+     */
+    createLangChainOptions(): LangChainModuleOptions | Promise<LangChainModuleOptions>;
 }
+export {};
+//# sourceMappingURL=langchain-module-options.interface.d.ts.map

package/dist/interfaces/langchain-module-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain-module-options.interface.d.ts","sourceRoot":"","sources":["../../lib/interfaces/langchain-module-options.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;GAIG;AACH,UAAU,aAAa;IACrB,uBAAuB;IACvB,MAAM,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,8DAA8D;IAC9D,SAAS,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACtC,kCAAkC;IAClC,qBAAqB,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;CAClD;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,sBAAsB,CAAC;AAEzE,mEAAmE;AACnE,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,KAAK,EAAE,WAAW,CAAC;IACnB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,sBAAsB,IACpB,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC5D"}

package/dist/interfaces/langchain-module-options.interface.js

@@ -1,2 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
+//# sourceMappingURL=langchain-module-options.interface.js.map

package/dist/interfaces/langchain-module-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain-module-options.interface.js","sourceRoot":"","sources":["../../lib/interfaces/langchain-module-options.interface.ts"],"names":[],"mappings":""}

package/dist/langchain.module-definition.d.ts

@@ -1,9 +1,29 @@
-import { LangChainModuleOptions } from './interfaces/langchain-module-options.interface';
-export declare const ConfigurableModuleClass: import("@nestjs/common").ConfigurableModuleCls<LangChainModuleOptions, "register", "create", {
-    name: string;
+import { LangChainModuleOptions } from './interfaces/langchain-module-options.interface.js';
+/** The base class and tokens Nest generates for `LangChainModule`. */
+export declare const ConfigurableModuleClass: import("@nestjs/common").ConfigurableModuleCls<LangChainModuleOptions, "register", "createLangChainOptions", {
+    name?: string;
 }>, MODULE_OPTIONS_TOKEN: string | symbol, OPTIONS_TYPE: LangChainModuleOptions & Partial<{
-    name: string;
-}>, ASYNC_OPTIONS_TYPE: import("@nestjs/common").ConfigurableModuleAsyncOptions<LangChainModuleOptions, "create"> & Partial<{
-    name: string;
+    name?: string;
+}>, ASYNC_OPTIONS_TYPE: import("@nestjs/common").ConfigurableModuleAsyncOptions<LangChainModuleOptions, "createLangChainOptions"> & Partial<{
+    name?: string;
 }>;
+/** The agent's own name. */
+export declare const AGENT_NAME_TOKEN = "nestjs-langchain:agent-name";
+/** The name the unnamed agent carries in logs and observer events. */
+export declare const UNNAMED_AGENT = "default";
+/**
+ * The injection token of the agent registered under `name`, for the places
+ * `@InjectAgent` cannot go: `overrideProvider` in a test, a factory's
+ * `inject`. The string it returns is not part of the API.
+ *
+ * @param name The `name` the agent was registered with.
+ * @returns The agent's injection token.
+ * @example
+ * ```ts
+ * Test.createTestingModule({ imports: [AppModule] })
+ *   .overrideProvider(getAgentToken('MATH_AGENT'))
+ *   .useValue({ run: async () => ({ status: 'completed', output: '42' }) });
+ * ```
+ */
 export declare const getAgentToken: (name: string) => string;
+//# sourceMappingURL=langchain.module-definition.d.ts.map

package/dist/langchain.module-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.module-definition.d.ts","sourceRoot":"","sources":["../lib/langchain.module-definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oDAAoD,CAAC;AAE5F,sEAAsE;AACtE,eAAO,MACL,uBAAuB;WAKH,MAAM;IAJ1B,oBAAoB,mBACpB,YAAY;WAGQ,MAAM;IAF1B,kBAAkB;WAEE,MAAM;EAElB,CAAC;AAEX,4BAA4B;AAC5B,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAE9D,sEAAsE;AACtE,eAAO,MAAM,aAAa,YAAY,CAAC;AAEvC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MACX,CAAC"}

package/dist/langchain.module-definition.js

@@ -1,13 +1,26 @@
-"use strict";
-var _a;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAgentToken = exports.ASYNC_OPTIONS_TYPE = exports.OPTIONS_TYPE = exports.MODULE_OPTIONS_TOKEN = exports.ConfigurableModuleClass = void 0;
-const common_1 = require("@nestjs/common");
-_a = new common_1.ConfigurableModuleBuilder()
-    .setExtras({ name: 'default' }, (definition, extras) => ({
-    ...definition,
-    tag: extras.name,
-}))
-    .build(), exports.ConfigurableModuleClass = _a.ConfigurableModuleClass, exports.MODULE_OPTIONS_TOKEN = _a.MODULE_OPTIONS_TOKEN, exports.OPTIONS_TYPE = _a.OPTIONS_TYPE, exports.ASYNC_OPTIONS_TYPE = _a.ASYNC_OPTIONS_TYPE;
-const getAgentToken = (name) => `LANGCHAIN_AGENT_${name.toUpperCase()}`;
-exports.getAgentToken = getAgentToken;
+import { ConfigurableModuleBuilder } from '@nestjs/common';
+/** The base class and tokens Nest generates for `LangChainModule`. */
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE, ASYNC_OPTIONS_TYPE, } = new ConfigurableModuleBuilder()
+    .setExtras({ name: undefined })
+    .setFactoryMethodName('createLangChainOptions')
+    .build();
+/** The agent's own name. */
+export const AGENT_NAME_TOKEN = 'nestjs-langchain:agent-name';
+/** The name the unnamed agent carries in logs and observer events. */
+export const UNNAMED_AGENT = 'default';
+/**
+ * The injection token of the agent registered under `name`, for the places
+ * `@InjectAgent` cannot go: `overrideProvider` in a test, a factory's
+ * `inject`. The string it returns is not part of the API.
+ *
+ * @param name The `name` the agent was registered with.
+ * @returns The agent's injection token.
+ * @example
+ * ```ts
+ * Test.createTestingModule({ imports: [AppModule] })
+ *   .overrideProvider(getAgentToken('MATH_AGENT'))
+ *   .useValue({ run: async () => ({ status: 'completed', output: '42' }) });
+ * ```
+ */
+export const getAgentToken = (name) => `nestjs-langchain:agent:${name}`;
+//# sourceMappingURL=langchain.module-definition.js.map

package/dist/langchain.module-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.module-definition.js","sourceRoot":"","sources":["../lib/langchain.module-definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAG3D,sEAAsE;AACtE,MAAM,CAAC,MAAM,EACX,uBAAuB,EACvB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,GACnB,GAAG,IAAI,yBAAyB,EAA0B;KACxD,SAAS,CAAoB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KACjD,oBAAoB,CAAC,wBAAwB,CAAC;KAC9C,KAAK,EAAE,CAAC;AAEX,4BAA4B;AAC5B,MAAM,CAAC,MAAM,gBAAgB,GAAG,6BAA6B,CAAC;AAE9D,sEAAsE;AACtE,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AAEvC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAU,EAAE,CACpD,0BAA0B,IAAI,EAAE,CAAC"}

package/dist/langchain.module.d.ts

@@ -1,7 +1,64 @@
-import { DynamicModule } from '@nestjs/common';
-import { ASYNC_OPTIONS_TYPE, ConfigurableModuleClass, OPTIONS_TYPE } from './langchain.module-definition';
+import { DynamicModule, Type } from '@nestjs/common';
+import { ASYNC_OPTIONS_TYPE, ConfigurableModuleClass, OPTIONS_TYPE } from './langchain.module-definition.js';
+import { LangChainModuleOptions, LangChainOptionsFactory } from './interfaces/langchain-module-options.interface.js';
+/**
+ * Registers agents as Nest providers: each `register` or `registerAsync`
+ * adds one. Give each a `name` when there are several.
+ *
+ * @example
+ * ```ts
+ * imports: [
+ *   MathModule,
+ *   LangChainModule.register({
+ *     model: { model: 'openai:gpt-5-mini' },
+ *     tools: [MathModule],
+ *   }),
+ * ],
+ * ```
+ */
 export declare class LangChainModule extends ConfigurableModuleClass {
+    /**
+     * Registers an agent from its options.
+     *
+     * @param options The agent's options, with its `name` when there are several.
+     * @returns The module providing the agent.
+     * @example
+     * ```ts
+     * LangChainModule.register({
+     *   name: 'MATH_AGENT',
+     *   model: { model: 'openai:gpt-5-mini' },
+     *   tools: [MathModule],
+     * });
+     * ```
+     */
     static register(options: typeof OPTIONS_TYPE): DynamicModule;
-    static registerAsync(options: typeof ASYNC_OPTIONS_TYPE): DynamicModule;
+    /**
+     * Registers an agent whose options other providers build, through
+     * `useFactory`, `useClass` or `useExisting`. `name` stays outside the
+     * factory: it names the token `@InjectAgent()` resolves.
+     *
+     * @param options How to build the agent's options, and its `name`.
+     * @returns The module providing the agent.
+     * @example
+     * ```ts
+     * LangChainModule.registerAsync({
+     *   name: 'MATH_AGENT',
+     *   imports: [ConfigModule],
+     *   inject: [ConfigService],
+     *   useFactory: (config: ConfigService) => ({
+     *     model: {
+     *       model: 'openai:gpt-5-mini',
+     *       apiKey: config.getOrThrow<string>('OPENAI_API_KEY'),
+     *     },
+     *   }),
+     * });
+     * ```
+     */
+    static registerAsync<T extends LangChainModuleOptions & Record<Exclude<keyof T, keyof LangChainModuleOptions>, never>>(options: Omit<typeof ASYNC_OPTIONS_TYPE, 'useFactory' | 'useClass' | 'useExisting'> & {
+        useFactory?: (...args: any[]) => T | Promise<T>;
+        useClass?: Type<LangChainOptionsFactory>;
+        useExisting?: Type<LangChainOptionsFactory>;
+    }): DynamicModule;
     private static addDynamicAgentProvider;
 }
+//# sourceMappingURL=langchain.module.d.ts.map

package/dist/langchain.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.module.d.ts","sourceRoot":"","sources":["../lib/langchain.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoB,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAEL,kBAAkB,EAClB,uBAAuB,EAEvB,YAAY,EAEb,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,oDAAoD,CAAC;AAK5D;;;;;;;;;;;;;;GAcG;AACH,qBAIa,eAAgB,SAAQ,uBAAuB;IAC1D;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,YAAY,GAAG,aAAa;IAK5D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,aAAa,CAGlB,CAAC,SAAS,sBAAsB,GAC9B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,sBAAsB,CAAC,EAAE,KAAK,CAAC,EAE/D,OAAO,EAAE,IAAI,CACX,OAAO,kBAAkB,EACzB,YAAY,GAAG,UAAU,GAAG,aAAa,CAC1C,GAAG;QAIF,UAAU,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAChD,QAAQ,CAAC,EAAE,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACzC,WAAW,CAAC,EAAE,IAAI,CAAC,uBAAuB,CAAC,CAAC;KAC7C,GACA,aAAa;IAKhB,OAAO,CAAC,MAAM,CAAC,uBAAuB;CAoCvC"}