nestjs-langchain 1.0.2 → 2.0.0

package/dist/langchain.module.js

@@ -1,47 +1,110 @@
-"use strict";
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
     if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LangChainModule = void 0;
-const common_1 = require("@nestjs/common");
-const langchain_module_definition_1 = require("./langchain.module-definition");
-const langchain_service_1 = require("./langchain.service");
-const tool_discovery_service_1 = require("./tool-discovery.service");
-const metadata_scanner_1 = require("@nestjs/core/metadata-scanner");
-const core_1 = require("@nestjs/core");
-let LangChainModule = class LangChainModule extends langchain_module_definition_1.ConfigurableModuleClass {
+import { Module } from '@nestjs/common';
+import { AGENT_NAME_TOKEN, ConfigurableModuleClass, getAgentToken, UNNAMED_AGENT, } from './langchain.module-definition.js';
+import { Agent } from './agent.js';
+import { ToolDiscoveryService } from './tools/index.js';
+import { reservedAgentName } from './errors/messages.js';
+import { DiscoveryModule } from '@nestjs/core';
+/**
+ * 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],
+ *   }),
+ * ],
+ * ```
+ */
+let LangChainModule = 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) {
         const dynamicModule = super.register(options);
         return this.addDynamicAgentProvider(dynamicModule, options.name);
     }
+    /**
+     * 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(options) {
         const dynamicModule = super.registerAsync(options);
         return this.addDynamicAgentProvider(dynamicModule, options.name);
     }
     static addDynamicAgentProvider(dynamicModule, name) {
-        if (!name)
-            return dynamicModule;
-        const agentToken = (0, langchain_module_definition_1.getAgentToken)(name);
-        const agentProvider = {
-            provide: agentToken,
-            useExisting: langchain_service_1.LangChainService,
+        if (name === '' || name === UNNAMED_AGENT) {
+            throw new Error(reservedAgentName(name));
+        }
+        const nameProvider = {
+            provide: AGENT_NAME_TOKEN,
+            useValue: name ?? UNNAMED_AGENT,
         };
+        // The class token belongs to the unnamed agent alone, in every module, so
+        // `overrideProvider(Agent)` and `get(Agent)` never reach a named one.
+        // See #128 and #170.
+        if (!name) {
+            return {
+                ...dynamicModule,
+                providers: [...(dynamicModule.providers ?? []), nameProvider, Agent],
+                exports: [...(dynamicModule.exports ?? []), Agent],
+            };
+        }
+        const agentToken = getAgentToken(name);
         return {
             ...dynamicModule,
-            providers: [...(dynamicModule.providers || []), agentProvider],
-            exports: [agentToken],
+            providers: [
+                ...(dynamicModule.providers ?? []),
+                nameProvider,
+                { provide: agentToken, useClass: Agent },
+            ],
+            exports: [...(dynamicModule.exports ?? []), agentToken],
         };
     }
 };
-exports.LangChainModule = LangChainModule;
-exports.LangChainModule = LangChainModule = __decorate([
-    (0, common_1.Module)({
-        imports: [core_1.DiscoveryModule],
-        providers: [langchain_service_1.LangChainService, tool_discovery_service_1.ToolDiscoveryService, metadata_scanner_1.MetadataScanner],
-        exports: [langchain_service_1.LangChainService],
+LangChainModule = __decorate([
+    Module({
+        imports: [DiscoveryModule],
+        providers: [ToolDiscoveryService],
     })
 ], LangChainModule);
+export { LangChainModule };
+//# sourceMappingURL=langchain.module.js.map

package/dist/langchain.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.module.js","sourceRoot":"","sources":["../lib/langchain.module.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAiB,MAAM,EAAkB,MAAM,gBAAgB,CAAC;AACvE,OAAO,EACL,gBAAgB,EAEhB,uBAAuB,EACvB,aAAa,EAEb,aAAa,GACd,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAKnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;;;;;;;;;;;GAcG;AAKI,IAAM,eAAe,GAArB,MAAM,eAAgB,SAAQ,uBAAuB;IAC1D;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,QAAQ,CAAC,OAA4B;QAC1C,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,uBAAuB,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,aAAa,CAMlB,OAUC;QAED,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,uBAAuB,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAEO,MAAM,CAAC,uBAAuB,CACpC,aAA4B,EAC5B,IAAwB;QAExB,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,YAAY,GAAa;YAC7B,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,IAAI,IAAI,aAAa;SAChC,CAAC;QAEF,0EAA0E;QAC1E,sEAAsE;QACtE,qBAAqB;QACrB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,GAAG,aAAa;gBAChB,SAAS,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC;gBACpE,OAAO,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC;aACnD,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAEvC,OAAO;YACL,GAAG,aAAa;YAChB,SAAS,EAAE;gBACT,GAAG,CAAC,aAAa,CAAC,SAAS,IAAI,EAAE,CAAC;gBAClC,YAAY;gBACZ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE;aACzC;YACD,OAAO,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,UAAU,CAAC;SACxD,CAAC;IACJ,CAAC;CACF,CAAA;AApGY,eAAe;IAJ3B,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,eAAe,CAAC;QAC1B,SAAS,EAAE,CAAC,oBAAoB,CAAC;KAClC,CAAC;GACW,eAAe,CAoG3B"}

package/dist/logging/index.d.ts

@@ -0,0 +1,3 @@
+export { observeToolCall, reportToolError } from './observe-tool-call.util.js';
+export { LOG_CONTEXT, messageOf, RunReporter } from './run-reporter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/logging/index.js

@@ -0,0 +1,3 @@
+export { observeToolCall, reportToolError } from './observe-tool-call.util.js';
+export { LOG_CONTEXT, messageOf, RunReporter } from './run-reporter.js';
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/logging/observe-tool-call.util.d.ts

@@ -0,0 +1,13 @@
+import { ToolErrorEvent } from '../interfaces/agent-observer.interface.js';
+import { RunReporter } from './run-reporter.js';
+interface ToolCall {
+    tool: string;
+    callId: string;
+    args: Record<string, unknown>;
+}
+/** Logs a failed tool call and hands it to the observer. */
+export declare const reportToolError: (reporter: RunReporter, event: Omit<ToolErrorEvent, "agent">) => void;
+/** Runs one tool call, reporting its start, then its end or its failure. */
+export declare const observeToolCall: (reporter: RunReporter, { tool, callId, args }: ToolCall, call: () => unknown) => Promise<unknown>;
+export {};
+//# sourceMappingURL=observe-tool-call.util.d.ts.map

package/dist/logging/observe-tool-call.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-tool-call.util.d.ts","sourceRoot":"","sources":["../../lib/logging/observe-tool-call.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,EAAa,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE3D,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,4DAA4D;AAC5D,eAAO,MAAM,eAAe,GAC1B,UAAU,WAAW,EACrB,OAAO,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,KACnC,IAKF,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,eAAe,GAC1B,UAAU,WAAW,EACrB,wBAAwB,QAAQ,EAChC,MAAM,MAAM,OAAO,KAClB,OAAO,CAAC,OAAO,CAiCjB,CAAC"}

package/dist/logging/observe-tool-call.util.js

@@ -0,0 +1,34 @@
+import { messageOf } from './run-reporter.js';
+/** Logs a failed tool call and hands it to the observer. */
+export const reportToolError = (reporter, event) => {
+    reporter.logError(`${event.tool} failed: ${messageOf(event.error)}`);
+    reporter.notify((observer) => observer.onToolError?.({ agent: reporter.agent, ...event }));
+};
+/** Runs one tool call, reporting its start, then its end or its failure. */
+export const observeToolCall = async (reporter, { tool, callId, args }, call) => {
+    const { agent } = reporter;
+    const startedAt = Date.now();
+    reporter.notify((observer) => observer.onToolStart?.({ agent, tool, callId, args }));
+    try {
+        const output = await call();
+        reporter.notify((observer) => observer.onToolEnd?.({
+            agent,
+            tool,
+            callId,
+            output,
+            durationMs: Date.now() - startedAt,
+        }));
+        return output;
+    }
+    catch (error) {
+        reportToolError(reporter, {
+            tool,
+            callId,
+            reason: 'threw',
+            error,
+            durationMs: Date.now() - startedAt,
+        });
+        throw error;
+    }
+};
+//# sourceMappingURL=observe-tool-call.util.js.map

package/dist/logging/observe-tool-call.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-tool-call.util.js","sourceRoot":"","sources":["../../lib/logging/observe-tool-call.util.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAe,MAAM,mBAAmB,CAAC;AAQ3D,4DAA4D;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,QAAqB,EACrB,KAAoC,EAC9B,EAAE;IACR,QAAQ,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,YAAY,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrE,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC3B,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAC5D,CAAC;AACJ,CAAC,CAAC;AAEF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,QAAqB,EACrB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAY,EAChC,IAAmB,EACD,EAAE;IACpB,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC3B,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CACtD,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QAE5B,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC3B,QAAQ,CAAC,SAAS,EAAE,CAAC;YACnB,KAAK;YACL,IAAI;YACJ,MAAM;YACN,MAAM;YACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACnC,CAAC,CACH,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,eAAe,CAAC,QAAQ,EAAE;YACxB,IAAI;YACJ,MAAM;YACN,MAAM,EAAE,OAAO;YACf,KAAK;YACL,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACnC,CAAC,CAAC;QAEH,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC"}

package/dist/logging/run-reporter.d.ts

@@ -0,0 +1,26 @@
+import { LoggerService } from '@nestjs/common';
+import { AgentObserver } from '../interfaces/agent-observer.interface.js';
+export declare const LOG_CONTEXT = "LangChainAgent";
+interface RunReporterInput {
+    logger: LoggerService;
+    agent: string;
+    /** Empty for the unnamed agent, `'MATH '` otherwise. */
+    prefix: string;
+    observer?: AgentObserver;
+}
+export declare const messageOf: (error: unknown) => string;
+/** One agent's error log lines and its observer. */
+export declare class RunReporter {
+    private readonly input;
+    constructor(input: RunReporterInput);
+    get agent(): string;
+    /** One line per error, whatever the message holds. */
+    logError(message: string): void;
+    /**
+     * Hands an event to the observer, if any. Never awaited: a throw or a
+     * rejection is logged and swallowed, never propagated into the run.
+     */
+    notify(call: (observer: AgentObserver) => void | Promise<void>): void;
+}
+export {};
+//# sourceMappingURL=run-reporter.d.ts.map

package/dist/logging/run-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-reporter.d.ts","sourceRoot":"","sources":["../../lib/logging/run-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAE1E,eAAO,MAAM,WAAW,mBAAmB,CAAC;AAE5C,UAAU,gBAAgB;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,MACa,CAAC;AAEzD,oDAAoD;AACpD,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,gBAAgB;IAEpD,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAU/B;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAgBtE"}

package/dist/logging/run-reporter.js

@@ -0,0 +1,39 @@
+export const LOG_CONTEXT = 'LangChainAgent';
+export const messageOf = (error) => error instanceof Error ? error.message : String(error);
+/** One agent's error log lines and its observer. */
+export class RunReporter {
+    input;
+    constructor(input) {
+        this.input = input;
+    }
+    get agent() {
+        return this.input.agent;
+    }
+    /** One line per error, whatever the message holds. */
+    logError(message) {
+        const line = message
+            .split('\n')
+            .map((part) => part.trim())
+            .filter(Boolean)
+            .join(' ');
+        this.input.logger.error(`${this.input.prefix}${line}`, LOG_CONTEXT);
+    }
+    /**
+     * Hands an event to the observer, if any. Never awaited: a throw or a
+     * rejection is logged and swallowed, never propagated into the run.
+     */
+    notify(call) {
+        const { observer } = this.input;
+        if (!observer) {
+            return;
+        }
+        const onFailure = (error) => this.logError(`the observer failed: ${messageOf(error)}`);
+        try {
+            void Promise.resolve(call(observer)).catch(onFailure);
+        }
+        catch (error) {
+            onFailure(error);
+        }
+    }
+}
+//# sourceMappingURL=run-reporter.js.map

package/dist/logging/run-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-reporter.js","sourceRoot":"","sources":["../../lib/logging/run-reporter.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAU5C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAU,EAAE,CAClD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEzD,oDAAoD;AACpD,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,KAAuB;QAAvB,UAAK,GAAL,KAAK,CAAkB;IAAG,CAAC;IAExD,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,sDAAsD;IACtD,QAAQ,CAAC,OAAe;QACtB,MAAM,IAAI,GAAG,OAAO;aACjB,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC1B,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,GAAG,CAAC,CAAC;QAEb,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC;IACtE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,IAAuD;QAC5D,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAEhC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,CAAC,KAAc,EAAE,EAAE,CACnC,IAAI,CAAC,QAAQ,CAAC,wBAAwB,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAE5D,IAAI,CAAC;YACH,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}

package/dist/run/index.d.ts

@@ -0,0 +1,3 @@
+export { summariseRun } from './run-summary.util.js';
+export type { RunSummary } from './run-summary.util.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/run/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/run/index.js

@@ -0,0 +1,2 @@
+export { summariseRun } from './run-summary.util.js';
+//# sourceMappingURL=index.js.map

package/dist/run/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/run/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/run/run-summary.util.d.ts

@@ -0,0 +1,31 @@
+import { UsageMetadata } from '@langchain/core/messages';
+interface MessageLike {
+    usage_metadata?: UsageMetadata;
+    tool_calls?: {
+        name: string;
+    }[];
+}
+/** What a run did and cost. */
+export interface RunSummary {
+    /** Every tool call the model made, failed and unknown ones included. */
+    tools: string[];
+    /**
+     * Summed over the run's model calls; absent when the provider reports no
+     * usage.
+     */
+    tokens?: {
+        input: number;
+        output: number;
+        total: number;
+    };
+}
+/**
+ * What a finished run cost, read off the messages it returned.
+ *
+ * @internal
+ * @param messages The messages of the finished run.
+ * @returns The tool calls the model made, and the tokens if reported.
+ */
+export declare const summariseRun: (messages: readonly MessageLike[]) => RunSummary;
+export {};
+//# sourceMappingURL=run-summary.util.d.ts.map

package/dist/run/run-summary.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-summary.util.d.ts","sourceRoot":"","sources":["../../lib/run/run-summary.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG7E,UAAU,WAAW;IACnB,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjC;AAED,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,UAAU,SAAS,WAAW,EAAE,KAAG,UAwB/D,CAAC"}

package/dist/run/run-summary.util.js

@@ -0,0 +1,28 @@
+import { mergeUsageMetadata } from '@langchain/core/messages';
+/**
+ * What a finished run cost, read off the messages it returned.
+ *
+ * @internal
+ * @param messages The messages of the finished run.
+ * @returns The tool calls the model made, and the tokens if reported.
+ */
+export const summariseRun = (messages) => {
+    const tools = messages.flatMap((message) => (message.tool_calls ?? []).map((call) => call.name));
+    const reported = messages
+        .map((message) => message.usage_metadata)
+        .filter((usage) => usage !== undefined);
+    if (reported.length === 0) {
+        return { tools };
+    }
+    // Seeded with zeros, so a field a provider left out counts as zero.
+    const usage = reported.reduce(mergeUsageMetadata, mergeUsageMetadata());
+    return {
+        tools,
+        tokens: {
+            input: usage.input_tokens,
+            output: usage.output_tokens,
+            total: usage.total_tokens,
+        },
+    };
+};
+//# sourceMappingURL=run-summary.util.js.map

package/dist/run/run-summary.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-summary.util.js","sourceRoot":"","sources":["../../lib/run/run-summary.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAiB,MAAM,0BAA0B,CAAC;AAmB7E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAgC,EAAc,EAAE;IAC3E,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CACzC,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CACpD,CAAC;IAEF,MAAM,QAAQ,GAAG,QAAQ;SACtB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC;SACxC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAE1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,oEAAoE;IACpE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAExE,OAAO;QACL,KAAK;QACL,MAAM,EAAE;YACN,KAAK,EAAE,KAAK,CAAC,YAAY;YACzB,MAAM,EAAE,KAAK,CAAC,aAAa;YAC3B,KAAK,EAAE,KAAK,CAAC,YAAY;SAC1B;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+export { ToolDiscoveryService } from './tool-discovery.service.js';
+export { toolErrors, unknownTools } from './tool-errors.middleware.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,3 @@
+export { ToolDiscoveryService } from './tool-discovery.service.js';
+export { toolErrors, unknownTools } from './tool-errors.middleware.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/tools/tool-discovery.service.d.ts

@@ -0,0 +1,31 @@
+import { DynamicStructuredTool } from 'langchain';
+import { DiscoveryService, MetadataScanner, ModulesContainer } from '@nestjs/core';
+import { ToolModule } from '../interfaces/langchain-module-options.interface.js';
+import { RunReporter } from '../logging/index.js';
+/** Finds the `@Tool()` methods of an agent's tool modules and builds their tools. */
+export declare class ToolDiscoveryService {
+    private readonly discoveryService;
+    private readonly metadataScanner;
+    private readonly modulesContainer;
+    constructor(discoveryService: DiscoveryService, metadataScanner: MetadataScanner, modulesContainer: ModulesContainer);
+    private modulesInContext;
+    /**
+     * Every `@Tool()` method of the providers that `modules` host. Adds to
+     * `declaring` each module declaring one, accepted or not.
+     */
+    private toolMethods;
+    /** One tool per method, each reporting its calls to `reporter`. */
+    private buildTools;
+    /**
+     * The tools of the modules listed in an agent's `tools` option, each one
+     * reporting its calls to `reporter`. Throws a `ToolConfigurationError`
+     * listing every problem found: a module that is not imported, imported
+     * several times or declaring no tool, a name or a schema that is invalid,
+     * two tools sharing a name.
+     *
+     * Async because an entry may be a `Promise<DynamicModule>`, which Nest's
+     * own `imports` accepts.
+     */
+    getToolsFromModules(entries: ToolModule[], reporter: RunReporter): Promise<DynamicStructuredTool[]>;
+}
+//# sourceMappingURL=tool-discovery.service.d.ts.map

package/dist/tools/tool-discovery.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-discovery.service.d.ts","sourceRoot":"","sources":["../../lib/tools/tool-discovery.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAMtB,OAAO,EAAE,UAAU,EAAE,MAAM,qDAAqD,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAgDlD,qFAAqF;AACrF,qBACa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAFhB,gBAAgB,EAAE,gBAAgB,EAClC,eAAe,EAAE,eAAe,EAChC,gBAAgB,EAAE,gBAAgB;IAGrD,OAAO,CAAC,gBAAgB;IAUxB;;;OAGG;IACH,OAAO,CAAC,WAAW;IA+CnB,mEAAmE;IACnE,OAAO,CAAC,UAAU;IAYlB;;;;;;;;;OASG;IACG,mBAAmB,CACvB,OAAO,EAAE,UAAU,EAAE,EACrB,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,qBAAqB,EAAE,CAAC;CA+BpC"}

package/dist/tools/tool-discovery.service.js

@@ -0,0 +1,132 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Injectable, Scope } from '@nestjs/common';
+import { DiscoveryService, MetadataScanner, ModulesContainer, } from '@nestjs/core';
+import { ToolConfigurationError } from '../errors/index.js';
+import { toolModuleWithoutTools, toolOnNonSingleton, } from '../errors/messages.js';
+import { buildTool } from './tool.factory.js';
+import { readToolMethod } from './tool-method.util.js';
+import { findDuplicateToolNames } from './tool-name.util.js';
+import { resolveToolModules } from './tool-modules.util.js';
+/**
+ * Maps each item, skipping `undefined`. An item that throws adds its message
+ * to `problems` rather than stopping the others, so one bad tool does not hide
+ * the next.
+ */
+const collect = (items, map, problems) => items.flatMap((item) => {
+    try {
+        const result = map(item);
+        return result === undefined ? [] : [result];
+    }
+    catch (error) {
+        problems.push(error instanceof Error ? error.message : String(error));
+        return [];
+    }
+});
+/**
+ * Why a provider is not a singleton, or `undefined` when it is. An agent is
+ * one, and a provider built per request or per consumer leaves only an
+ * unconstructed placeholder in `instance`. See #127.
+ */
+const nonSingletonScope = (wrapper) => {
+    // `TRANSIENT` reports a static dependency tree.
+    if (wrapper.isTransient) {
+        return 'transient';
+    }
+    if (wrapper.isDependencyTreeStatic()) {
+        return undefined;
+    }
+    return wrapper.scope === Scope.REQUEST ? 'request' : 'request-dependency';
+};
+/** Finds the `@Tool()` methods of an agent's tool modules and builds their tools. */
+let ToolDiscoveryService = class ToolDiscoveryService {
+    discoveryService;
+    metadataScanner;
+    modulesContainer;
+    constructor(discoveryService, metadataScanner, modulesContainer) {
+        this.discoveryService = discoveryService;
+        this.metadataScanner = metadataScanner;
+        this.modulesContainer = modulesContainer;
+    }
+    modulesInContext() {
+        const modules = new Map();
+        this.modulesContainer.forEach(({ metatype }) => modules.set(metatype, (modules.get(metatype) ?? 0) + 1));
+        return modules;
+    }
+    /**
+     * Every `@Tool()` method of the providers that `modules` host. Adds to
+     * `declaring` each module declaring one, accepted or not.
+     */
+    toolMethods(modules, declaring, problems) {
+        return this.discoveryService.getProviders().flatMap((wrapper) => {
+            const { instance, host } = wrapper;
+            // A `useValue` primitive carries no decorator, nor metadata to read.
+            if (typeof instance !== 'object' ||
+                !instance ||
+                !host ||
+                !modules.has(host.metatype)) {
+                return [];
+            }
+            const reported = problems.length;
+            const methods = collect(this.metadataScanner.getAllMethodNames(Object.getPrototypeOf(instance)), (method) => readToolMethod(instance, method), problems);
+            // A method already reported as a problem is one this module declares.
+            if (methods.length > 0 || problems.length > reported) {
+                declaring.add(host.metatype);
+            }
+            const scope = nonSingletonScope(wrapper);
+            if (scope && methods.length > 0) {
+                problems.push(toolOnNonSingleton(instance.constructor.name, scope, methods.map(({ method }) => method)));
+                return [];
+            }
+            return methods;
+        });
+    }
+    /** One tool per method, each reporting its calls to `reporter`. */
+    buildTools(methods, reporter, problems) {
+        return collect(methods, (method) => ({ tool: buildTool(method, reporter), where: method.where }), problems);
+    }
+    /**
+     * The tools of the modules listed in an agent's `tools` option, each one
+     * reporting its calls to `reporter`. Throws a `ToolConfigurationError`
+     * listing every problem found: a module that is not imported, imported
+     * several times or declaring no tool, a name or a schema that is invalid,
+     * two tools sharing a name.
+     *
+     * Async because an entry may be a `Promise<DynamicModule>`, which Nest's
+     * own `imports` accepts.
+     */
+    async getToolsFromModules(entries, reporter) {
+        // By constructor, not `host.name`: two modules may share a class name.
+        // See #58.
+        const { modules, problems } = await resolveToolModules(entries, this.modulesInContext());
+        const declaring = new Set();
+        const methods = this.toolMethods(modules, declaring, problems);
+        modules.forEach((module) => {
+            if (!declaring.has(module)) {
+                problems.push(toolModuleWithoutTools(module.name));
+            }
+        });
+        const built = this.buildTools(methods, reporter, problems);
+        // Per agent: the same name in two agents is legitimate.
+        problems.push(...findDuplicateToolNames(built.map(({ tool, where }) => ({ name: tool.name, where }))));
+        if (problems.length > 0) {
+            throw new ToolConfigurationError(problems, reporter.agent);
+        }
+        return built.map(({ tool }) => tool);
+    }
+};
+ToolDiscoveryService = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [DiscoveryService,
+        MetadataScanner,
+        ModulesContainer])
+], ToolDiscoveryService);
+export { ToolDiscoveryService };
+//# sourceMappingURL=tool-discovery.service.js.map

package/dist/tools/tool-discovery.service.js.map

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

package/dist/tools/tool-errors.middleware.d.ts

@@ -0,0 +1,21 @@
+import { RunReporter } from '../logging/index.js';
+/**
+ * Turns a failed tool call into the text the model receives, LangChain's own,
+ * without the stack (and its server paths) LangChain puts in a schema failure.
+ * Every error is answered: past a middleware, LangChain's tool node rethrows
+ * any error left unhandled and fails the run. See #176.
+ *
+ * Also the only place that sees arguments the schema rejects, which never
+ * reach the `@Tool` wrapper: they are reported here. See #177.
+ *
+ * Once langchain-ai/langchainjs#11830 ships, LangChain's own text has no stack
+ * and `tool-errors.middleware.spec.ts` fails: the schema text can be left to
+ * LangChain, the reporting stays.
+ */
+export declare const toolErrors: (reporter: RunReporter) => import("langchain").AgentMiddleware<undefined, undefined, unknown, readonly (import("@langchain/core/tools").ServerTool | import("@langchain/core/tools").ClientTool)[], readonly []>;
+/**
+ * Reports a call to a tool the agent does not have. LangChain's tool node
+ * answers the model itself, without throwing, so `toolErrors` never sees it.
+ */
+export declare const unknownTools: (reporter: RunReporter) => import("langchain").AgentMiddleware<undefined, undefined, unknown, readonly (import("@langchain/core/tools").ServerTool | import("@langchain/core/tools").ClientTool)[], readonly []>;
+//# sourceMappingURL=tool-errors.middleware.d.ts.map

package/dist/tools/tool-errors.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-errors.middleware.d.ts","sourceRoot":"","sources":["../../lib/tools/tool-errors.middleware.ts"],"names":[],"mappings":"AAMA,OAAO,EAAmB,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEnE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,WAAW,0LAwB5C,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,UAAU,WAAW,0LAgB9C,CAAC"}