@langchain/core 1.3.7 → 1.4.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @langchain/core
 
+## 1.4.1
+
+### Patch Changes
+
+- [#12230](https://github.com/langchain-ai/langchainjs/pull/12230) [`84e85cc`](https://github.com/langchain-ai/langchainjs/commit/84e85cc8657a6922c9db34ff7a2a1a692e83a503) Thanks [@thushanth-bengre-langchain](https://github.com/thushanth-bengre-langchain)! - Merge streamed `input_json_delta` blocks into the preceding `tool_use` / `server_tool_use` block at the same index
+
+## 1.4.0
+
+### Minor Changes
+
+- [#12178](https://github.com/langchain-ai/langchainjs/pull/12178) [`01e5f2d`](https://github.com/langchain-ai/langchainjs/commit/01e5f2dbbf30823045fc82c69bef7b2c032315f4) Thanks [@thushanth-bengre-langchain](https://github.com/thushanth-bengre-langchain)! - feat(core): add decision models
+
+  - Add `@langchain/core/decisions` with `BaseDecisionModel`, a `Runnable` that answers typed `Noul`, `Choice`, `Score`, and `Box` questions about text, messages, or JSON state
+  - Add question and answer types, `parseQuestions`, and `parseClassifierResponse` for providers
+  - Type `invoke` answers from the questions asked, including `Choice` labels, and reject provider responses that leave a question unanswered or answer it with the wrong type or label
+
+### Patch Changes
+
+- [#12192](https://github.com/langchain-ai/langchainjs/pull/12192) [`9920d4b`](https://github.com/langchain-ai/langchainjs/commit/9920d4b33dee5bc0cfb33d859246edf8973c86eb) Thanks [@jkennedyvz](https://github.com/jkennedyvz)! - Require Zod 4.6.6 or newer for installed dependencies to exclude versions affected by GHSA-mrhx-c7xc-m3w5. Zod v3 schemas remain supported through the bundled `zod/v3` entry point.
+
 ## 1.3.7
 
 ### Patch Changes

package/decisions.cjs

@@ -0,0 +1 @@
+module.exports = require("./dist/decisions/index.cjs");

package/decisions.d.cts

@@ -0,0 +1 @@
+export * from "./dist/decisions/index.js";

package/decisions.d.ts

@@ -0,0 +1 @@
+export * from "./dist/decisions/index.js";

package/decisions.js

@@ -0,0 +1 @@
+export * from "./dist/decisions/index.js";

package/dist/decisions/base.cjs

@@ -0,0 +1,98 @@
+const require_base = require("../runnables/base.cjs");
+const require_config = require("../runnables/config.cjs");
+const require_types = require("./types.cjs");
+// src/decisions/base.ts
+function assertAnswered(questions, response) {
+	for (const [id, question] of Object.entries(questions)) {
+		const answer = Object.hasOwn(response.answers, id) ? response.answers[id] : void 0;
+		if (answer === void 0) throw new Error(`Decision model returned no answer for question "${id}".`);
+		if (answer.type !== question.type) throw new Error(`Decision model returned a ${answer.type} answer for ${question.type} question "${id}".`);
+		if (answer.type === "choice" && question.type === "choice" && !Object.hasOwn(question.criteria, answer.choice)) throw new Error(`Decision model returned a choice for question "${id}" that is not one of its labels.`);
+	}
+}
+/**
+* Answer typed questions about text, messages, or structured state.
+*
+* A decision model evaluates shared state against one or more questions and
+* returns typed answers: a probability for a `Noul`, a selected label for a
+* `Choice`, an expected level for a `Score`, and a location for a `Box`.
+* Answers keep their probability distributions and confidence so applications
+* can choose their own thresholds.
+*
+* Subclasses implement `_classify` to call a provider. This class validates
+* questions and handles callbacks, tracing metadata, and token-usage
+* reporting.
+*
+* @example
+* ```ts
+* import {
+*   BaseDecisionModel,
+*   parseClassifierResponse,
+* } from "@langchain/core/decisions";
+*
+* class MyDecisionModel extends BaseDecisionModel {
+*   lc_namespace = ["my_provider", "decisions"];
+*
+*   get _provider() {
+*     return "my_provider";
+*   }
+*
+*   async _classify(
+*     state: State,
+*     questions: Record<string, Question>,
+*     config?: Partial<RunnableConfig>
+*   ) {
+*     const body = await myClient.classify(
+*       { model: this.model, state, questions },
+*       { signal: config?.signal }
+*     );
+*     return parseClassifierResponse(body);
+*   }
+* }
+* ```
+*/
+var BaseDecisionModel = class extends require_base.Runnable {
+	/** Provider model name used to answer questions. */
+	model;
+	constructor(fields) {
+		super(fields);
+		this.model = fields.model;
+	}
+	/**
+	* Classify one request.
+	*
+	* The run is traced as an LLM run with `ls_provider` and `ls_model_name`
+	* metadata, and its output carries `usage_metadata` when the provider reports
+	* usage.
+	*
+	* @param input State and questions to evaluate.
+	* @param options Callbacks, tags, metadata, and other runnable config.
+	* @returns Answers keyed by answer ID and typed from `questions`, with
+	*   request metadata.
+	* @throws Error if a question is invalid, `questions` is empty, or the
+	*   provider leaves a question unanswered or answers it with the wrong type
+	*   or an unknown `Choice` label.
+	*/
+	async invoke(input, options) {
+		const config = require_config.ensureConfig(options);
+		return await this._callWithConfig(async (request, runConfig, runManager) => {
+			const { runType: _runType, ...childConfig } = runConfig ?? {};
+			const questions = require_types.parseQuestions(request.questions);
+			const answered = await this._classify(request.state, questions, require_config.patchConfig(childConfig, { callbacks: runManager?.getChild() }));
+			assertAnswered(questions, answered);
+			return answered;
+		}, input, {
+			...config,
+			runType: "llm",
+			metadata: {
+				...config.metadata,
+				ls_provider: this._provider,
+				ls_model_name: this.model,
+				ls_model_type: "chat"
+			}
+		});
+	}
+};
+exports.BaseDecisionModel = BaseDecisionModel;
+
+//# sourceMappingURL=base.cjs.map

package/dist/decisions/base.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.cjs","names":["Runnable","ensureConfig","parseQuestions","patchConfig"],"sources":["../../src/decisions/base.ts"],"sourcesContent":["import type { CallbackManagerForChainRun } from \"../callbacks/manager.js\";\nimport { Runnable } from \"../runnables/base.js\";\nimport {\n  ensureConfig,\n  patchConfig,\n  type RunnableConfig,\n} from \"../runnables/config.js\";\nimport {\n  parseQuestions,\n  type ClassifierRequest,\n  type ClassifierResponse,\n  type Question,\n  type State,\n} from \"./types.js\";\n\n// Throws unless every question has an answer of its type, so the response\n// matches its typed answers. Names question IDs only, never answer values.\nfunction assertAnswered(\n  questions: Record<string, Question>,\n  response: ClassifierResponse\n): void {\n  for (const [id, question] of Object.entries(questions)) {\n    const answer = Object.hasOwn(response.answers, id)\n      ? response.answers[id]\n      : undefined;\n    if (answer === undefined) {\n      throw new Error(\n        `Decision model returned no answer for question \"${id}\".`\n      );\n    }\n    if (answer.type !== question.type) {\n      throw new Error(\n        `Decision model returned a ${answer.type} answer for ${question.type} question \"${id}\".`\n      );\n    }\n    if (\n      answer.type === \"choice\" &&\n      question.type === \"choice\" &&\n      !Object.hasOwn(question.criteria, answer.choice)\n    ) {\n      throw new Error(\n        `Decision model returned a choice for question \"${id}\" that is not one of its labels.`\n      );\n    }\n  }\n}\n\n/** Fields shared by every decision model. */\nexport interface BaseDecisionModelFields {\n  /** Provider model name used to answer questions. */\n  model: string;\n}\n\n/**\n * Answer typed questions about text, messages, or structured state.\n *\n * A decision model evaluates shared state against one or more questions and\n * returns typed answers: a probability for a `Noul`, a selected label for a\n * `Choice`, an expected level for a `Score`, and a location for a `Box`.\n * Answers keep their probability distributions and confidence so applications\n * can choose their own thresholds.\n *\n * Subclasses implement `_classify` to call a provider. This class validates\n * questions and handles callbacks, tracing metadata, and token-usage\n * reporting.\n *\n * @example\n * ```ts\n * import {\n *   BaseDecisionModel,\n *   parseClassifierResponse,\n * } from \"@langchain/core/decisions\";\n *\n * class MyDecisionModel extends BaseDecisionModel {\n *   lc_namespace = [\"my_provider\", \"decisions\"];\n *\n *   get _provider() {\n *     return \"my_provider\";\n *   }\n *\n *   async _classify(\n *     state: State,\n *     questions: Record<string, Question>,\n *     config?: Partial<RunnableConfig>\n *   ) {\n *     const body = await myClient.classify(\n *       { model: this.model, state, questions },\n *       { signal: config?.signal }\n *     );\n *     return parseClassifierResponse(body);\n *   }\n * }\n * ```\n */\nexport abstract class BaseDecisionModel extends Runnable<\n  ClassifierRequest,\n  ClassifierResponse\n> {\n  /** Provider model name used to answer questions. */\n  readonly model: string;\n\n  constructor(fields: BaseDecisionModelFields) {\n    super(fields);\n    this.model = fields.model;\n  }\n\n  /** Provider name reported to LangSmith as `ls_provider`. */\n  abstract get _provider(): string;\n\n  /**\n   * Answer one request.\n   *\n   * @param state State to evaluate.\n   * @param questions Validated questions keyed by answer ID.\n   * @param config Runnable config, including the abort `signal`.\n   * @returns Typed answers keyed by answer ID, with request metadata.\n   */\n  abstract _classify(\n    state: State,\n    questions: Record<string, Question>,\n    config?: Partial<RunnableConfig>\n  ): Promise<ClassifierResponse>;\n\n  /**\n   * Classify one request.\n   *\n   * The run is traced as an LLM run with `ls_provider` and `ls_model_name`\n   * metadata, and its output carries `usage_metadata` when the provider reports\n   * usage.\n   *\n   * @param input State and questions to evaluate.\n   * @param options Callbacks, tags, metadata, and other runnable config.\n   * @returns Answers keyed by answer ID and typed from `questions`, with\n   *   request metadata.\n   * @throws Error if a question is invalid, `questions` is empty, or the\n   *   provider leaves a question unanswered or answers it with the wrong type\n   *   or an unknown `Choice` label.\n   */\n  async invoke<const Q extends Record<string, Question>>(\n    input: ClassifierRequest<Q>,\n    options?: Partial<RunnableConfig>\n  ): Promise<ClassifierResponse<Q>> {\n    const config = ensureConfig(options);\n    const response = await this._callWithConfig(\n      async (\n        request: ClassifierRequest,\n        runConfig?: Partial<RunnableConfig & { runType: string }>,\n        runManager?: CallbackManagerForChainRun\n      ) => {\n        const { runType: _runType, ...childConfig } = runConfig ?? {};\n        const questions = parseQuestions(request.questions);\n        const answered = await this._classify(\n          request.state,\n          questions,\n          patchConfig(childConfig, { callbacks: runManager?.getChild() })\n        );\n        assertAnswered(questions, answered);\n        return answered;\n      },\n      input,\n      {\n        ...config,\n        runType: \"llm\",\n        metadata: {\n          ...config.metadata,\n          ls_provider: this._provider,\n          ls_model_name: this.model,\n          ls_model_type: \"chat\",\n        },\n      }\n    );\n    return response as ClassifierResponse<Q>;\n  }\n}\n"],"mappings":";;;;AAiBA,SAAS,eACP,WACA,UACM;CACN,KAAK,MAAM,CAAC,IAAI,aAAa,OAAO,QAAQ,SAAS,GAAG;EACtD,MAAM,SAAS,OAAO,OAAO,SAAS,SAAS,EAAE,IAC7C,SAAS,QAAQ,MACjB,KAAA;EACJ,IAAI,WAAW,KAAA,GACb,MAAM,IAAI,MACR,mDAAmD,GAAG,GACxD;EAEF,IAAI,OAAO,SAAS,SAAS,MAC3B,MAAM,IAAI,MACR,6BAA6B,OAAO,KAAK,cAAc,SAAS,KAAK,aAAa,GAAG,GACvF;EAEF,IACE,OAAO,SAAS,YAChB,SAAS,SAAS,YAClB,CAAC,OAAO,OAAO,SAAS,UAAU,OAAO,MAAM,GAE/C,MAAM,IAAI,MACR,kDAAkD,GAAG,iCACvD;CAEJ;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,IAAsB,oBAAtB,cAAgDA,aAAAA,SAG9C;;CAEA;CAEA,YAAY,QAAiC;EAC3C,MAAM,MAAM;EACZ,KAAK,QAAQ,OAAO;CACtB;;;;;;;;;;;;;;;;CAkCA,MAAM,OACJ,OACA,SACgC;EAChC,MAAM,SAASC,eAAAA,aAAa,OAAO;EA6BnC,OAAO,MA5BgB,KAAK,gBAC1B,OACE,SACA,WACA,eACG;GACH,MAAM,EAAE,SAAS,UAAU,GAAG,gBAAgB,aAAa,CAAC;GAC5D,MAAM,YAAYC,cAAAA,eAAe,QAAQ,SAAS;GAClD,MAAM,WAAW,MAAM,KAAK,UAC1B,QAAQ,OACR,WACAC,eAAAA,YAAY,aAAa,EAAE,WAAW,YAAY,SAAS,EAAE,CAAC,CAChE;GACA,eAAe,WAAW,QAAQ;GAClC,OAAO;EACT,GACA,OACA;GACE,GAAG;GACH,SAAS;GACT,UAAU;IACR,GAAG,OAAO;IACV,aAAa,KAAK;IAClB,eAAe,KAAK;IACpB,eAAe;GACjB;EACF,CACF;CAEF;AACF"}

package/dist/decisions/base.d.cts

@@ -0,0 +1,83 @@
+import { RunnableConfig } from "../runnables/types.cjs";
+import { Runnable } from "../runnables/base.cjs";
+import "../runnables/config.cjs";
+import { ClassifierRequest, ClassifierResponse, Question, State } from "./types.cjs";
+/** Fields shared by every decision model. */
+export interface BaseDecisionModelFields {
+  /** Provider model name used to answer questions. */
+  model: string;
+}
+/**
+ * Answer typed questions about text, messages, or structured state.
+ *
+ * A decision model evaluates shared state against one or more questions and
+ * returns typed answers: a probability for a `Noul`, a selected label for a
+ * `Choice`, an expected level for a `Score`, and a location for a `Box`.
+ * Answers keep their probability distributions and confidence so applications
+ * can choose their own thresholds.
+ *
+ * Subclasses implement `_classify` to call a provider. This class validates
+ * questions and handles callbacks, tracing metadata, and token-usage
+ * reporting.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   BaseDecisionModel,
+ *   parseClassifierResponse,
+ * } from "@langchain/core/decisions";
+ *
+ * class MyDecisionModel extends BaseDecisionModel {
+ *   lc_namespace = ["my_provider", "decisions"];
+ *
+ *   get _provider() {
+ *     return "my_provider";
+ *   }
+ *
+ *   async _classify(
+ *     state: State,
+ *     questions: Record<string, Question>,
+ *     config?: Partial<RunnableConfig>
+ *   ) {
+ *     const body = await myClient.classify(
+ *       { model: this.model, state, questions },
+ *       { signal: config?.signal }
+ *     );
+ *     return parseClassifierResponse(body);
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class BaseDecisionModel extends Runnable<ClassifierRequest, ClassifierResponse> {
+  /** Provider model name used to answer questions. */
+  readonly model: string;
+  constructor(fields: BaseDecisionModelFields);
+  /** Provider name reported to LangSmith as `ls_provider`. */
+  abstract get _provider(): string;
+  /**
+   * Answer one request.
+   *
+   * @param state State to evaluate.
+   * @param questions Validated questions keyed by answer ID.
+   * @param config Runnable config, including the abort `signal`.
+   * @returns Typed answers keyed by answer ID, with request metadata.
+   */
+  abstract _classify(state: State, questions: Record<string, Question>, config?: Partial<RunnableConfig>): Promise<ClassifierResponse>;
+  /**
+   * Classify one request.
+   *
+   * The run is traced as an LLM run with `ls_provider` and `ls_model_name`
+   * metadata, and its output carries `usage_metadata` when the provider reports
+   * usage.
+   *
+   * @param input State and questions to evaluate.
+   * @param options Callbacks, tags, metadata, and other runnable config.
+   * @returns Answers keyed by answer ID and typed from `questions`, with
+   *   request metadata.
+   * @throws Error if a question is invalid, `questions` is empty, or the
+   *   provider leaves a question unanswered or answers it with the wrong type
+   *   or an unknown `Choice` label.
+   */
+  invoke<const Q extends Record<string, Question>>(input: ClassifierRequest<Q>, options?: Partial<RunnableConfig>): Promise<ClassifierResponse<Q>>;
+}
+//# sourceMappingURL=base.d.cts.map

package/dist/decisions/base.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.cts","names":[],"sources":["../../src/decisions/base.ts"],"mappings":";;;;;iBAgDiB;;EAEf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BA4CoB,0BAA0B,SAC9C,mBACA;;WAGS;EAET,YAAY,QAAQ;;eAMP;;;;;;;;;WAUJ,UACP,OAAO,OACP,WAAW,eAAe,WAC1B,SAAS,QAAQ,kBAChB,QAAQ;;;;;;;;;;;;;;;;EAiBL,aAAa,UAAU,eAAe,WAC1C,OAAO,kBAAkB,IACzB,UAAU,QAAQ,kBACjB,QAAQ,mBAAmB"}

package/dist/decisions/base.d.ts

@@ -0,0 +1,83 @@
+import { RunnableConfig } from "../runnables/types.js";
+import { Runnable } from "../runnables/base.js";
+import "../runnables/config.js";
+import { ClassifierRequest, ClassifierResponse, Question, State } from "./types.js";
+/** Fields shared by every decision model. */
+export interface BaseDecisionModelFields {
+  /** Provider model name used to answer questions. */
+  model: string;
+}
+/**
+ * Answer typed questions about text, messages, or structured state.
+ *
+ * A decision model evaluates shared state against one or more questions and
+ * returns typed answers: a probability for a `Noul`, a selected label for a
+ * `Choice`, an expected level for a `Score`, and a location for a `Box`.
+ * Answers keep their probability distributions and confidence so applications
+ * can choose their own thresholds.
+ *
+ * Subclasses implement `_classify` to call a provider. This class validates
+ * questions and handles callbacks, tracing metadata, and token-usage
+ * reporting.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   BaseDecisionModel,
+ *   parseClassifierResponse,
+ * } from "@langchain/core/decisions";
+ *
+ * class MyDecisionModel extends BaseDecisionModel {
+ *   lc_namespace = ["my_provider", "decisions"];
+ *
+ *   get _provider() {
+ *     return "my_provider";
+ *   }
+ *
+ *   async _classify(
+ *     state: State,
+ *     questions: Record<string, Question>,
+ *     config?: Partial<RunnableConfig>
+ *   ) {
+ *     const body = await myClient.classify(
+ *       { model: this.model, state, questions },
+ *       { signal: config?.signal }
+ *     );
+ *     return parseClassifierResponse(body);
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class BaseDecisionModel extends Runnable<ClassifierRequest, ClassifierResponse> {
+  /** Provider model name used to answer questions. */
+  readonly model: string;
+  constructor(fields: BaseDecisionModelFields);
+  /** Provider name reported to LangSmith as `ls_provider`. */
+  abstract get _provider(): string;
+  /**
+   * Answer one request.
+   *
+   * @param state State to evaluate.
+   * @param questions Validated questions keyed by answer ID.
+   * @param config Runnable config, including the abort `signal`.
+   * @returns Typed answers keyed by answer ID, with request metadata.
+   */
+  abstract _classify(state: State, questions: Record<string, Question>, config?: Partial<RunnableConfig>): Promise<ClassifierResponse>;
+  /**
+   * Classify one request.
+   *
+   * The run is traced as an LLM run with `ls_provider` and `ls_model_name`
+   * metadata, and its output carries `usage_metadata` when the provider reports
+   * usage.
+   *
+   * @param input State and questions to evaluate.
+   * @param options Callbacks, tags, metadata, and other runnable config.
+   * @returns Answers keyed by answer ID and typed from `questions`, with
+   *   request metadata.
+   * @throws Error if a question is invalid, `questions` is empty, or the
+   *   provider leaves a question unanswered or answers it with the wrong type
+   *   or an unknown `Choice` label.
+   */
+  invoke<const Q extends Record<string, Question>>(input: ClassifierRequest<Q>, options?: Partial<RunnableConfig>): Promise<ClassifierResponse<Q>>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/decisions/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","names":[],"sources":["../../src/decisions/base.ts"],"mappings":";;;;;iBAgDiB;;EAEf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BA4CoB,0BAA0B,SAC9C,mBACA;;WAGS;EAET,YAAY,QAAQ;;eAMP;;;;;;;;;WAUJ,UACP,OAAO,OACP,WAAW,eAAe,WAC1B,SAAS,QAAQ,kBAChB,QAAQ;;;;;;;;;;;;;;;;EAiBL,aAAa,UAAU,eAAe,WAC1C,OAAO,kBAAkB,IACzB,UAAU,QAAQ,kBACjB,QAAQ,mBAAmB"}

package/dist/decisions/base.js

@@ -0,0 +1,98 @@
+import { Runnable } from "../runnables/base.js";
+import { ensureConfig, patchConfig } from "../runnables/config.js";
+import { parseQuestions } from "./types.js";
+// src/decisions/base.ts
+function assertAnswered(questions, response) {
+	for (const [id, question] of Object.entries(questions)) {
+		const answer = Object.hasOwn(response.answers, id) ? response.answers[id] : void 0;
+		if (answer === void 0) throw new Error(`Decision model returned no answer for question "${id}".`);
+		if (answer.type !== question.type) throw new Error(`Decision model returned a ${answer.type} answer for ${question.type} question "${id}".`);
+		if (answer.type === "choice" && question.type === "choice" && !Object.hasOwn(question.criteria, answer.choice)) throw new Error(`Decision model returned a choice for question "${id}" that is not one of its labels.`);
+	}
+}
+/**
+* Answer typed questions about text, messages, or structured state.
+*
+* A decision model evaluates shared state against one or more questions and
+* returns typed answers: a probability for a `Noul`, a selected label for a
+* `Choice`, an expected level for a `Score`, and a location for a `Box`.
+* Answers keep their probability distributions and confidence so applications
+* can choose their own thresholds.
+*
+* Subclasses implement `_classify` to call a provider. This class validates
+* questions and handles callbacks, tracing metadata, and token-usage
+* reporting.
+*
+* @example
+* ```ts
+* import {
+*   BaseDecisionModel,
+*   parseClassifierResponse,
+* } from "@langchain/core/decisions";
+*
+* class MyDecisionModel extends BaseDecisionModel {
+*   lc_namespace = ["my_provider", "decisions"];
+*
+*   get _provider() {
+*     return "my_provider";
+*   }
+*
+*   async _classify(
+*     state: State,
+*     questions: Record<string, Question>,
+*     config?: Partial<RunnableConfig>
+*   ) {
+*     const body = await myClient.classify(
+*       { model: this.model, state, questions },
+*       { signal: config?.signal }
+*     );
+*     return parseClassifierResponse(body);
+*   }
+* }
+* ```
+*/
+var BaseDecisionModel = class extends Runnable {
+	/** Provider model name used to answer questions. */
+	model;
+	constructor(fields) {
+		super(fields);
+		this.model = fields.model;
+	}
+	/**
+	* Classify one request.
+	*
+	* The run is traced as an LLM run with `ls_provider` and `ls_model_name`
+	* metadata, and its output carries `usage_metadata` when the provider reports
+	* usage.
+	*
+	* @param input State and questions to evaluate.
+	* @param options Callbacks, tags, metadata, and other runnable config.
+	* @returns Answers keyed by answer ID and typed from `questions`, with
+	*   request metadata.
+	* @throws Error if a question is invalid, `questions` is empty, or the
+	*   provider leaves a question unanswered or answers it with the wrong type
+	*   or an unknown `Choice` label.
+	*/
+	async invoke(input, options) {
+		const config = ensureConfig(options);
+		return await this._callWithConfig(async (request, runConfig, runManager) => {
+			const { runType: _runType, ...childConfig } = runConfig ?? {};
+			const questions = parseQuestions(request.questions);
+			const answered = await this._classify(request.state, questions, patchConfig(childConfig, { callbacks: runManager?.getChild() }));
+			assertAnswered(questions, answered);
+			return answered;
+		}, input, {
+			...config,
+			runType: "llm",
+			metadata: {
+				...config.metadata,
+				ls_provider: this._provider,
+				ls_model_name: this.model,
+				ls_model_type: "chat"
+			}
+		});
+	}
+};
+export { BaseDecisionModel };
+
+//# sourceMappingURL=base.js.map

package/dist/decisions/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","names":[],"sources":["../../src/decisions/base.ts"],"sourcesContent":["import type { CallbackManagerForChainRun } from \"../callbacks/manager.js\";\nimport { Runnable } from \"../runnables/base.js\";\nimport {\n  ensureConfig,\n  patchConfig,\n  type RunnableConfig,\n} from \"../runnables/config.js\";\nimport {\n  parseQuestions,\n  type ClassifierRequest,\n  type ClassifierResponse,\n  type Question,\n  type State,\n} from \"./types.js\";\n\n// Throws unless every question has an answer of its type, so the response\n// matches its typed answers. Names question IDs only, never answer values.\nfunction assertAnswered(\n  questions: Record<string, Question>,\n  response: ClassifierResponse\n): void {\n  for (const [id, question] of Object.entries(questions)) {\n    const answer = Object.hasOwn(response.answers, id)\n      ? response.answers[id]\n      : undefined;\n    if (answer === undefined) {\n      throw new Error(\n        `Decision model returned no answer for question \"${id}\".`\n      );\n    }\n    if (answer.type !== question.type) {\n      throw new Error(\n        `Decision model returned a ${answer.type} answer for ${question.type} question \"${id}\".`\n      );\n    }\n    if (\n      answer.type === \"choice\" &&\n      question.type === \"choice\" &&\n      !Object.hasOwn(question.criteria, answer.choice)\n    ) {\n      throw new Error(\n        `Decision model returned a choice for question \"${id}\" that is not one of its labels.`\n      );\n    }\n  }\n}\n\n/** Fields shared by every decision model. */\nexport interface BaseDecisionModelFields {\n  /** Provider model name used to answer questions. */\n  model: string;\n}\n\n/**\n * Answer typed questions about text, messages, or structured state.\n *\n * A decision model evaluates shared state against one or more questions and\n * returns typed answers: a probability for a `Noul`, a selected label for a\n * `Choice`, an expected level for a `Score`, and a location for a `Box`.\n * Answers keep their probability distributions and confidence so applications\n * can choose their own thresholds.\n *\n * Subclasses implement `_classify` to call a provider. This class validates\n * questions and handles callbacks, tracing metadata, and token-usage\n * reporting.\n *\n * @example\n * ```ts\n * import {\n *   BaseDecisionModel,\n *   parseClassifierResponse,\n * } from \"@langchain/core/decisions\";\n *\n * class MyDecisionModel extends BaseDecisionModel {\n *   lc_namespace = [\"my_provider\", \"decisions\"];\n *\n *   get _provider() {\n *     return \"my_provider\";\n *   }\n *\n *   async _classify(\n *     state: State,\n *     questions: Record<string, Question>,\n *     config?: Partial<RunnableConfig>\n *   ) {\n *     const body = await myClient.classify(\n *       { model: this.model, state, questions },\n *       { signal: config?.signal }\n *     );\n *     return parseClassifierResponse(body);\n *   }\n * }\n * ```\n */\nexport abstract class BaseDecisionModel extends Runnable<\n  ClassifierRequest,\n  ClassifierResponse\n> {\n  /** Provider model name used to answer questions. */\n  readonly model: string;\n\n  constructor(fields: BaseDecisionModelFields) {\n    super(fields);\n    this.model = fields.model;\n  }\n\n  /** Provider name reported to LangSmith as `ls_provider`. */\n  abstract get _provider(): string;\n\n  /**\n   * Answer one request.\n   *\n   * @param state State to evaluate.\n   * @param questions Validated questions keyed by answer ID.\n   * @param config Runnable config, including the abort `signal`.\n   * @returns Typed answers keyed by answer ID, with request metadata.\n   */\n  abstract _classify(\n    state: State,\n    questions: Record<string, Question>,\n    config?: Partial<RunnableConfig>\n  ): Promise<ClassifierResponse>;\n\n  /**\n   * Classify one request.\n   *\n   * The run is traced as an LLM run with `ls_provider` and `ls_model_name`\n   * metadata, and its output carries `usage_metadata` when the provider reports\n   * usage.\n   *\n   * @param input State and questions to evaluate.\n   * @param options Callbacks, tags, metadata, and other runnable config.\n   * @returns Answers keyed by answer ID and typed from `questions`, with\n   *   request metadata.\n   * @throws Error if a question is invalid, `questions` is empty, or the\n   *   provider leaves a question unanswered or answers it with the wrong type\n   *   or an unknown `Choice` label.\n   */\n  async invoke<const Q extends Record<string, Question>>(\n    input: ClassifierRequest<Q>,\n    options?: Partial<RunnableConfig>\n  ): Promise<ClassifierResponse<Q>> {\n    const config = ensureConfig(options);\n    const response = await this._callWithConfig(\n      async (\n        request: ClassifierRequest,\n        runConfig?: Partial<RunnableConfig & { runType: string }>,\n        runManager?: CallbackManagerForChainRun\n      ) => {\n        const { runType: _runType, ...childConfig } = runConfig ?? {};\n        const questions = parseQuestions(request.questions);\n        const answered = await this._classify(\n          request.state,\n          questions,\n          patchConfig(childConfig, { callbacks: runManager?.getChild() })\n        );\n        assertAnswered(questions, answered);\n        return answered;\n      },\n      input,\n      {\n        ...config,\n        runType: \"llm\",\n        metadata: {\n          ...config.metadata,\n          ls_provider: this._provider,\n          ls_model_name: this.model,\n          ls_model_type: \"chat\",\n        },\n      }\n    );\n    return response as ClassifierResponse<Q>;\n  }\n}\n"],"mappings":";;;;AAiBA,SAAS,eACP,WACA,UACM;CACN,KAAK,MAAM,CAAC,IAAI,aAAa,OAAO,QAAQ,SAAS,GAAG;EACtD,MAAM,SAAS,OAAO,OAAO,SAAS,SAAS,EAAE,IAC7C,SAAS,QAAQ,MACjB,KAAA;EACJ,IAAI,WAAW,KAAA,GACb,MAAM,IAAI,MACR,mDAAmD,GAAG,GACxD;EAEF,IAAI,OAAO,SAAS,SAAS,MAC3B,MAAM,IAAI,MACR,6BAA6B,OAAO,KAAK,cAAc,SAAS,KAAK,aAAa,GAAG,GACvF;EAEF,IACE,OAAO,SAAS,YAChB,SAAS,SAAS,YAClB,CAAC,OAAO,OAAO,SAAS,UAAU,OAAO,MAAM,GAE/C,MAAM,IAAI,MACR,kDAAkD,GAAG,iCACvD;CAEJ;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,IAAsB,oBAAtB,cAAgD,SAG9C;;CAEA;CAEA,YAAY,QAAiC;EAC3C,MAAM,MAAM;EACZ,KAAK,QAAQ,OAAO;CACtB;;;;;;;;;;;;;;;;CAkCA,MAAM,OACJ,OACA,SACgC;EAChC,MAAM,SAAS,aAAa,OAAO;EA6BnC,OAAO,MA5BgB,KAAK,gBAC1B,OACE,SACA,WACA,eACG;GACH,MAAM,EAAE,SAAS,UAAU,GAAG,gBAAgB,aAAa,CAAC;GAC5D,MAAM,YAAY,eAAe,QAAQ,SAAS;GAClD,MAAM,WAAW,MAAM,KAAK,UAC1B,QAAQ,OACR,WACA,YAAY,aAAa,EAAE,WAAW,YAAY,SAAS,EAAE,CAAC,CAChE;GACA,eAAe,WAAW,QAAQ;GAClC,OAAO;EACT,GACA,OACA;GACE,GAAG;GACH,SAAS;GACT,UAAU;IACR,GAAG,OAAO;IACV,aAAa,KAAK;IAClB,eAAe,KAAK;IACpB,eAAe;GACjB;EACF,CACF;CAEF;AACF"}

package/dist/decisions/index.cjs

@@ -0,0 +1,21 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_base = require("./base.cjs");
+const require_types = require("./types.cjs");
+// src/decisions/index.ts
+var decisions_exports = /* @__PURE__ */ require_runtime.__exportAll({
+	BaseDecisionModel: () => require_base.BaseDecisionModel,
+	parseClassifierResponse: () => require_types.parseClassifierResponse,
+	parseQuestions: () => require_types.parseQuestions
+});
+exports.BaseDecisionModel = require_base.BaseDecisionModel;
+Object.defineProperty(exports, "decisions_exports", {
+	enumerable: true,
+	get: function() {
+		return decisions_exports;
+	}
+});
+exports.parseClassifierResponse = require_types.parseClassifierResponse;
+exports.parseQuestions = require_types.parseQuestions;
+
+//# sourceMappingURL=index.cjs.map

package/dist/decisions/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/decisions/index.ts"],"sourcesContent":["export { BaseDecisionModel, type BaseDecisionModelFields } from \"./base.js\";\nexport {\n  parseClassifierResponse,\n  parseQuestions,\n  type Answer,\n  type AnswerFor,\n  type Answers,\n  type Box,\n  type BoxAnswer,\n  type BoxCoordinates,\n  type Choice,\n  type ChoiceAnswer,\n  type ClassifierRequest,\n  type ClassifierResponse,\n  type ClassifierResponseFields,\n  type Content,\n  type JsonValue,\n  type Noul,\n  type NoulAnswer,\n  type NoulCriteria,\n  type Question,\n  type Score,\n  type ScoreAnswer,\n  type State,\n  type StateValue,\n} from \"./types.js\";\n"],"mappings":""}

package/dist/decisions/index.d.cts

@@ -0,0 +1,3 @@
+import { BaseDecisionModel, BaseDecisionModelFields } from "./base.cjs";
+import { Answer, AnswerFor, Answers, Box, BoxAnswer, BoxCoordinates, Choice, ChoiceAnswer, ClassifierRequest, ClassifierResponse, ClassifierResponseFields, Content, JsonValue, Noul, NoulAnswer, NoulCriteria, Question, Score, ScoreAnswer, State, StateValue, parseClassifierResponse, parseQuestions } from "./types.cjs";
+export { type Answer, type AnswerFor, type Answers, BaseDecisionModel, type BaseDecisionModelFields, type Box, type BoxAnswer, type BoxCoordinates, type Choice, type ChoiceAnswer, type ClassifierRequest, type ClassifierResponse, type ClassifierResponseFields, type Content, type JsonValue, type Noul, type NoulAnswer, type NoulCriteria, type Question, type Score, type ScoreAnswer, type State, type StateValue, parseClassifierResponse, parseQuestions };

package/dist/decisions/index.d.ts

@@ -0,0 +1,3 @@
+import { BaseDecisionModel, BaseDecisionModelFields } from "./base.js";
+import { Answer, AnswerFor, Answers, Box, BoxAnswer, BoxCoordinates, Choice, ChoiceAnswer, ClassifierRequest, ClassifierResponse, ClassifierResponseFields, Content, JsonValue, Noul, NoulAnswer, NoulCriteria, Question, Score, ScoreAnswer, State, StateValue, parseClassifierResponse, parseQuestions } from "./types.js";
+export { type Answer, type AnswerFor, type Answers, BaseDecisionModel, type BaseDecisionModelFields, type Box, type BoxAnswer, type BoxCoordinates, type Choice, type ChoiceAnswer, type ClassifierRequest, type ClassifierResponse, type ClassifierResponseFields, type Content, type JsonValue, type Noul, type NoulAnswer, type NoulCriteria, type Question, type Score, type ScoreAnswer, type State, type StateValue, parseClassifierResponse, parseQuestions };

package/dist/decisions/index.js

@@ -0,0 +1,12 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import { BaseDecisionModel } from "./base.js";
+import { parseClassifierResponse, parseQuestions } from "./types.js";
+// src/decisions/index.ts
+var decisions_exports = /* @__PURE__ */ __exportAll({
+	BaseDecisionModel: () => BaseDecisionModel,
+	parseClassifierResponse: () => parseClassifierResponse,
+	parseQuestions: () => parseQuestions
+});
+export { BaseDecisionModel, decisions_exports, parseClassifierResponse, parseQuestions };
+
+//# sourceMappingURL=index.js.map

package/dist/decisions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/decisions/index.ts"],"sourcesContent":["export { BaseDecisionModel, type BaseDecisionModelFields } from \"./base.js\";\nexport {\n  parseClassifierResponse,\n  parseQuestions,\n  type Answer,\n  type AnswerFor,\n  type Answers,\n  type Box,\n  type BoxAnswer,\n  type BoxCoordinates,\n  type Choice,\n  type ChoiceAnswer,\n  type ClassifierRequest,\n  type ClassifierResponse,\n  type ClassifierResponseFields,\n  type Content,\n  type JsonValue,\n  type Noul,\n  type NoulAnswer,\n  type NoulCriteria,\n  type Question,\n  type Score,\n  type ScoreAnswer,\n  type State,\n  type StateValue,\n} from \"./types.js\";\n"],"mappings":""}