nestjs-langchain 2.0.0 → 2.2.0

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,25 @@ export const agentRunFailed = (prefix, cause) => `The ${prefix}agent's run faile
 export const modelNeverReplied = (prefix, last) => `The ${prefix}agent's loop ended before the model replied. ` +
     `The last message was ${last ? `a ${last} message` : 'never produced'}.`;
 export const modelReplyEmpty = (prefix) => `The ${prefix}agent's model replied with no text content.`;
+export const runAborted = (prefix) => `The ${prefix}agent's run was aborted.`;
+export const recursionLimitReached = (prefix, limit) => `The ${prefix}agent's run reached its recursion limit of ${limit} steps ` +
+    'without an answer. Raise `recursionLimit`, or check what makes the model ' +
+    'keep calling tools.';
+export const invalidRecursionLimit = (prefix, limit) => `The ${prefix}agent's \`recursionLimit\` must be an integer of at least 1, ` +
+    `not ${typeof limit === 'string' ? `"${limit}"` : String(limit)}.`;
+export const noOutputJsonSchemaForm = (prefix, reason) => `The ${prefix}agent's \`output\` schema has no JSON Schema form (${reason}). ` +
+    jsonSchemaAdvice;
+export const outputNotAnObject = (prefix) => `The ${prefix}agent's \`output\` schema is not an object with named fields: ` +
+    "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":"AAAA,uEAAuE;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAElE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAU,EAAE,CACnD,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC;AAE7C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAc,EAAE,QAAkB,EAAU,EAAE,CACzE,0BAA0B,QAAQ,CAAC,MAAM,GAAG;IAC5C,UAAU,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG;IAC7C,yBAAyB,MAAM,UAAU;IACzC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAU,EAAE,CACtD,GAAG,KAAK,mEAAmE;IAC3E,0EAA0E,CAAC;AAE7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAa,EAAU,EAAE,CAC7D,GAAG,KAAK,qEAAqE;IAC7E,8DAA8D,CAAC;AAEjE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,KAAa,EACb,KAAa,EACL,EAAE,CACV,GAAG,KAAK,uDAAuD,KAAK,GAAG;IACvE,2EAA2E;IAC3E,+CAA+C,CAAC;AAElD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAa,EAAU,EAAE,CAC9D,GAAG,KAAK,wDAAwD;IAChE,oEAAoE;IACpE,qBAAqB,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAU,EAAE,CAC5D,GAAG,KAAK,4DAA4D;IACpE,oEAAoE,CAAC;AAEvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAW,EAAE,CACjD,mDAAmD,CAAC;AAEtD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,QAAgB,EAChB,KAAqD,EACrD,OAAiB,EACT,EAAE,CACV,GAAG,QAAQ,IACT;IACE,OAAO,EAAE,mBAAmB;IAC5B,SAAS,EAAE,cAAc;IACzB,oBAAoB,EAAE,sCAAsC;CAC7D,CAAC,KAAK,CACT,2BAA2B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B;IACxE,iEAAiE,CAAC;AAEpE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAY,EACZ,KAAa,EACb,MAAc,EACN,EAAE,CACV,wBAAwB,IAAI,MAAM,KAAK,QAAQ,MAAM,IAAI;IACzD,uCAAuC,CAAC;AAE1C,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAAa,EACb,IAAY,EACZ,OAAe,EACf,cAAuB,EACf,EAAE,CACV,GAAG,KAAK,MAAM,IAAI,+CAA+C,OAAO,EAAE;IAC1E,CAAC,cAAc,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,KAAa,EACb,IAAY,EACZ,MAAc,EACN,EAAE,CACV,GAAG,KAAK,MAAM,IAAI,kBAAkB,MAAM,iCAAiC;IAC3E,0EAA0E;IAC1E,oBAAoB,CAAC;AAEvB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,KAAa,EACb,KAAa,EACb,QAAgB,EACR,EAAE,CACV,GAAG,KAAK,gCAAgC,KAAK,iBAAiB,QAAQ,IAAI;IAC1E,kEAAkE,CAAC;AAErE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,KAAa,EACb,KAAa,EACb,QAAkB,EAClB,QAAgB,EACR,EAAE,CACV,GAAG,KAAK,qBAAqB,KAAK,eAAe,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG;IACxE,8BAA8B,QAAQ,GAAG,CAAC;AAE5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,KAAa,EACb,KAAa,EACb,MAAc,EACN,EAAE,CACV,GAAG,KAAK,MAAM,KAAK,8BAA8B,MAAM,KAAK;IAC5D,6EAA6E;IAC7E,sCAAsC,CAAC;AAEzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAa,EACb,IAAY,EACZ,KAAa,EACb,MAAc,EACN,EAAE,CACV,GAAG,KAAK,gBAAgB,KAAK,GAAG,CAAC,QAAQ,MAAM,GAAG,CAAC,oBAAoB,IAAI,KAAK;IAChF,oCAAoC,CAAC;AAEvC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAc,EAAU,EAAE,CACtD,OAAO,MAAM,4DAA4D;IACzE,yEAAyE;IACzE,kDAAkD,CAAC;AAErD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAc,EAAE,KAAc,EAAU,EAAE,CACtE,OAAO,MAAM,oCAAoC;IACjD,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAE3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAc,EAAU,EAAE,CAC7D,OAAO,MAAM,iDAAiD;IAC9D,4CAA4C,CAAC;AAE/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAwB,EAAU,EAAE,CACrE,IAAI,KAAK,SAAS;IAChB,CAAC,CAAC,4CAA4C;QAC5C,gEAAgE;IAClE,CAAC,CAAC,iCAAiC,IAAI,KAAK;QAC1C,wDAAwD,CAAC;AAE/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAU,EAAE,CACxD,IAAI,KAAK,EAAE;IACT,CAAC,CAAC,qCAAqC;QACrC,wCAAwC;IAC1C,CAAC,CAAC,IAAI,IAAI,2DAA2D;QACnE,4CAA4C,CAAC;AAEnD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAE,KAAc,EAAU,EAAE,CACvE,OAAO,MAAM,sBAAsB;IACnC,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAE3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,MAAc,EACd,IAAwB,EAChB,EAAE,CACV,OAAO,MAAM,+CAA+C;IAC5D,wBAAwB,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC;AAE3E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAc,EAAU,EAAE,CACxD,OAAO,MAAM,6CAA6C,CAAC;AAE7D,MAAM,CAAC,MAAM,WAAW,GAAG,GAAW,EAAE,CAAC,0BAA0B,CAAC"}
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../lib/errors/messages.ts"],"names":[],"mappings":"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"}

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

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

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

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

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

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

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

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

package/dist/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,12 @@
 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 { OUTPUT_TOOL } from './constants.js';
+export { AgentAbortedError, AgentRecursionLimitError, AgentRunError, StructuredOutputError, ToolConfigurationError, } from './errors/index.js';
 export { InjectAgent, Tool, ToolParam } from './decorators/index.js';
 export type { ToolOptions, ToolParamOptions } from './decorators/index.js';
 export type { AgentObserver, ModelErrorEvent, RunErrorEvent, RunFinishEvent, ToolEndEvent, ToolErrorEvent, ToolStartEvent, } from './interfaces/agent-observer.interface.js';
 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,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,EACb,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,YAAY,EACV,aAAa,EACb,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,0CAA0C,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAC5E,YAAY,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,YAAY,EACV,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACvB,WAAW,EACX,WAAW,EACX,UAAU,GACX,MAAM,oDAAoD,CAAC"}

package/dist/index.js

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

package/dist/index.js.map

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

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/langchain-module-options.interface.d.ts

@@ -64,6 +64,12 @@ export interface LangChainModuleOptions {
     observer?: AgentObserver;
     /** LangChain-native run callbacks, for handlers written against its API. */
     callbacks?: AgentCallback[];
+    /**
+     * The most steps a run may take, each model call and each round of tool
+     * calls counting as one: LangGraph's 25 when omitted. A run's own
+     * `recursionLimit` overrides it.
+     */
+    recursionLimit?: number;
 }
 /**
  * A class building an agent's options, for `registerAsync({ useClass })` or

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

@@ -1 +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"}
+{"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;IAC5B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,sBAAsB,IACpB,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC5D"}

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

@@ -0,0 +1,34 @@
+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
+ * await agent.run(question, { signal: AbortSignal.timeout(30_000) });
+ *
+ * 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;
+    /**
+     * Aborts the run: `run()` throws an `AgentAbortedError`, the signal's
+     * `reason` in `cause`. A tool already running ends in the background, its
+     * result dropped.
+     */
+    signal?: AbortSignal;
+    /**
+     * The most steps the run may take, each model call and each round of tool
+     * calls counting as one, instead of the agent's `recursionLimit`. Past it,
+     * `run()` throws an `AgentRecursionLimitError`.
+     */
+    recursionLimit?: number;
+}
+//# sourceMappingURL=run-options.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-options.interface.d.ts","sourceRoot":"","sources":["../../lib/interfaces/run-options.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

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

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

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

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

package/dist/output/index.d.ts

@@ -0,0 +1,3 @@
+export { RunOutput } from './run-output.js';
+export { outputConfig, structuredOutput, } from './structured-output.middleware.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/output/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,gBAAgB,GACjB,MAAM,mCAAmC,CAAC"}

package/dist/output/index.js

@@ -0,0 +1,3 @@
+export { RunOutput } from './run-output.js';
+export { outputConfig, structuredOutput, } from './structured-output.middleware.js';
+//# sourceMappingURL=index.js.map

package/dist/output/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/output/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,gBAAgB,GACjB,MAAM,mCAAmC,CAAC"}

package/dist/output/run-output.d.ts

@@ -0,0 +1,43 @@
+import { TypedToolStrategy } from 'langchain';
+import { ZodType } from 'zod';
+/**
+ * The structured output one run asked for: the strategy its model calls use,
+ * and the answer parsed by the schema.
+ *
+ * @internal
+ */
+export declare class RunOutput {
+    #private;
+    private readonly schema;
+    private readonly agent;
+    /**
+     * Through a tool, whatever the model (see #274). One per run, which counts
+     * its own retries (see #151).
+     */
+    readonly strategy: TypedToolStrategy;
+    /** The tool the model answers through. */
+    readonly toolName: "extract-output";
+    private readonly prefix;
+    /**
+     * @param schema The run's `output` schema.
+     * @param agent The agent's name, for the errors.
+     * @throws AgentRunError when the schema has no JSON Schema form, or is not
+     * an object with named fields.
+     */
+    constructor(schema: ZodType, agent: string);
+    private retry;
+    /**
+     * @param error What a model call threw.
+     * @returns A `StructuredOutputError` for LangChain's parsing failures, the
+     * error itself otherwise.
+     */
+    failure(error: unknown): unknown;
+    /**
+     * @param structuredResponse What the run left in `structuredResponse`.
+     * @returns The answer, as the schema parses it.
+     * @throws StructuredOutputError when the answer is missing or invalid.
+     */
+    read(structuredResponse: unknown): unknown;
+    private invalid;
+}
+//# sourceMappingURL=run-output.d.ts.map

package/dist/output/run-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-output.d.ts","sourceRoot":"","sources":["../../lib/output/run-output.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,iBAAiB,EAClB,MAAM,WAAW,CAAC;AACnB,OAAU,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAqBjC;;;;;GAKG;AACH,qBAAa,SAAS;;IAkBlB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAlBxB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,mBAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC;;;;;OAKG;gBAEgB,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,MAAM;IAqChC,OAAO,CAAC,KAAK;IAUb;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAiBhC;;;;OAIG;IACH,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,OAAO;IAmB1C,OAAO,CAAC,OAAO;CAOhB"}

package/dist/output/run-output.js

@@ -0,0 +1,107 @@
+import { toJsonSchema } from '@langchain/core/utils/json_schema';
+import { MultipleStructuredOutputsError, StructuredOutputParsingError, toolStrategy, } from 'langchain';
+import z from 'zod';
+import { OUTPUT_TOOL } from '../constants.js';
+import { AgentRunError, StructuredOutputError } from '../errors/index.js';
+import { agentPrefix, noOutputJsonSchemaForm, outputNotAnObject, structuredOutputInvalid, structuredOutputMissing, structuredOutputMultiple, } from '../errors/messages.js';
+import { messageOf } from '../logging/index.js';
+// The default of LangChain's own retry middlewares. See #151.
+const MAX_RETRIES = 2;
+// LangChain's default for a Zod schema, which its JSON Schema path leaves
+// empty. See #282.
+const OUTPUT_DESCRIPTION = "Tool for extracting structured output from the model's response.";
+/**
+ * The structured output one run asked for: the strategy its model calls use,
+ * and the answer parsed by the schema.
+ *
+ * @internal
+ */
+export class RunOutput {
+    schema;
+    agent;
+    /**
+     * Through a tool, whatever the model (see #274). One per run, which counts
+     * its own retries (see #151).
+     */
+    strategy;
+    /** The tool the model answers through. */
+    toolName = OUTPUT_TOOL;
+    #retries = 0;
+    prefix;
+    /**
+     * @param schema The run's `output` schema.
+     * @param agent The agent's name, for the errors.
+     * @throws AgentRunError when the schema has no JSON Schema form, or is not
+     * an object with named fields.
+     */
+    constructor(schema, agent) {
+        this.schema = schema;
+        this.agent = agent;
+        this.prefix = agentPrefix(agent);
+        // LangChain's own conversion, run before any model call.
+        let json;
+        try {
+            json = toJsonSchema(schema);
+        }
+        catch (error) {
+            throw new AgentRunError(noOutputJsonSchemaForm(this.prefix, messageOf(error)), agent, { cause: error });
+        }
+        // A tool's parameters. LangChain takes them as a JSON Schema with
+        // `properties` at every version, as a Zod schema other than an object at
+        // recent ones only. See #282.
+        if (json.type !== 'object' || !('properties' in json)) {
+            throw new AgentRunError(outputNotAnObject(this.prefix), agent);
+        }
+        // LangChain names the tool after the title.
+        this.strategy = toolStrategy({
+            ...json,
+            type: 'object',
+            title: OUTPUT_TOOL,
+            description: json.description ?? OUTPUT_DESCRIPTION,
+        }, { handleError: (error) => this.retry(error) });
+    }
+    // What LangChain sends back by default, until the retries run out.
+    retry(error) {
+        this.#retries += 1;
+        if (this.#retries > MAX_RETRIES) {
+            throw error;
+        }
+        return error.message;
+    }
+    /**
+     * @param error What a model call threw.
+     * @returns A `StructuredOutputError` for LangChain's parsing failures, the
+     * error itself otherwise.
+     */
+    failure(error) {
+        // Never LangChain's messages, which name the internal tool.
+        if (error instanceof StructuredOutputParsingError) {
+            return this.invalid(error.errors.join(' '), error);
+        }
+        if (error instanceof MultipleStructuredOutputsError) {
+            return new StructuredOutputError(structuredOutputMultiple(this.prefix, error.toolNames.length), this.agent, { cause: error });
+        }
+        return error;
+    }
+    /**
+     * @param structuredResponse What the run left in `structuredResponse`.
+     * @returns The answer, as the schema parses it.
+     * @throws StructuredOutputError when the answer is missing or invalid.
+     */
+    read(structuredResponse) {
+        if (structuredResponse === undefined) {
+            throw new StructuredOutputError(structuredOutputMissing(this.prefix), this.agent);
+        }
+        // LangChain checks the JSON Schema only: Zod also applies transforms and
+        // refinements. See #151.
+        const parsed = this.schema.safeParse(structuredResponse);
+        if (!parsed.success) {
+            throw this.invalid(z.prettifyError(parsed.error), parsed.error);
+        }
+        return parsed.data;
+    }
+    invalid(reason, cause) {
+        return new StructuredOutputError(structuredOutputInvalid(this.prefix, reason), this.agent, { cause });
+    }
+}
+//# sourceMappingURL=run-output.js.map

package/dist/output/run-output.js.map

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

package/dist/output/structured-output.middleware.d.ts

@@ -0,0 +1,22 @@
+import { RunOutput } from './run-output.js';
+/**
+ * The `configurable` entry that hands a run's output to the middleware. A
+ * text run sets it to `null`, or it would inherit the output of the run it is
+ * nested in, which LangChain hands down. See #295.
+ *
+ * @internal
+ * @param output The run's output, if it asked for one.
+ * @returns The entry to put in `configurable`.
+ */
+export declare const outputConfig: (output: RunOutput | undefined) => {
+    "nestjs-langchain:output": RunOutput | null;
+};
+/**
+ * Sets the `responseFormat` of each model call of a run that asked for an
+ * `output`, so that one compiled agent serves text and structured runs.
+ * LangChain's parsing failures come out as a `StructuredOutputError`.
+ *
+ * @internal
+ */
+export declare const structuredOutput: () => import("langchain").AgentMiddleware<undefined, undefined, unknown, readonly (import("@langchain/core/tools").ServerTool | import("@langchain/core/tools").ClientTool)[], readonly []>;
+//# sourceMappingURL=structured-output.middleware.d.ts.map

package/dist/output/structured-output.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.middleware.d.ts","sourceRoot":"","sources":["../../lib/output/structured-output.middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAM5C;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,SAAS,GAAG,SAAS;;CAExD,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,6LAgBzB,CAAC"}

package/dist/output/structured-output.middleware.js

@@ -0,0 +1,40 @@
+import { createMiddleware } from 'langchain';
+import { RunOutput } from './run-output.js';
+// The run's output travels under our own key in `configurable`, which
+// LangGraph keeps out of the trace metadata and checkpoints. See #151.
+const OUTPUT_KEY = 'nestjs-langchain:output';
+/**
+ * The `configurable` entry that hands a run's output to the middleware. A
+ * text run sets it to `null`, or it would inherit the output of the run it is
+ * nested in, which LangChain hands down. See #295.
+ *
+ * @internal
+ * @param output The run's output, if it asked for one.
+ * @returns The entry to put in `configurable`.
+ */
+export const outputConfig = (output) => ({
+    [OUTPUT_KEY]: output ?? null,
+});
+/**
+ * Sets the `responseFormat` of each model call of a run that asked for an
+ * `output`, so that one compiled agent serves text and structured runs.
+ * LangChain's parsing failures come out as a `StructuredOutputError`.
+ *
+ * @internal
+ */
+export const structuredOutput = () => createMiddleware({
+    name: 'structuredOutput',
+    wrapModelCall: async (request, handler) => {
+        const output = request.runtime.configurable?.[OUTPUT_KEY];
+        if (!(output instanceof RunOutput)) {
+            return handler(request);
+        }
+        try {
+            return await handler({ ...request, responseFormat: output.strategy });
+        }
+        catch (error) {
+            throw output.failure(error);
+        }
+    },
+});
+//# sourceMappingURL=structured-output.middleware.js.map

package/dist/output/structured-output.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.middleware.js","sourceRoot":"","sources":["../../lib/output/structured-output.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,sEAAsE;AACtE,uEAAuE;AACvE,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAA6B,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC,UAAU,CAAC,EAAE,MAAM,IAAI,IAAI;CAC7B,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,EAAE,CACnC,gBAAgB,CAAC;IACf,IAAI,EAAE,kBAAkB;IACxB,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QACxC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,CAAC;QAE1D,IAAI,CAAC,CAAC,MAAM,YAAY,SAAS,CAAC,EAAE,CAAC;YACnC,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/run/answered-calls.util.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The ids of the tool calls the messages answer: the tool node answers every
+ * call it runs. Structural rather than `BaseMessage`. See #52.
+ *
+ * @internal
+ * @param messages A run's messages.
+ * @returns The ids their `tool_call_id`s answer.
+ */
+export declare const answeredCalls: (messages: readonly object[]) => Set<string>;
+//# sourceMappingURL=answered-calls.util.d.ts.map

package/dist/run/answered-calls.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answered-calls.util.d.ts","sourceRoot":"","sources":["../../lib/run/answered-calls.util.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU,SAAS,MAAM,EAAE,KAAG,GAAG,CAAC,MAAM,CAOnE,CAAC"}