@langchain/openai 1.7.1 → 1.8.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":["OpenAIClient"],"sources":["../../src/decisions/index.ts"],"mappings":";;;iBAkCiB;;EAEf;;;;;EAKA;;;;;;EAMA,gBAAgB,KAAK;;;;;;;;;;;;;;;;;;;;;;;qBAwBV,wBAAwB,SAAS,iBAAiB;SACtD;EAIP;WAES;YAEC,QAAQA;EAElB,YAAY,eAAe,SAAS,KAAK;EACzC,YAAY,QAAQ;EA8Bd,aAAa,UAAU,WAC3B,SAAS,gBAAgB,IACzB,UAAU,QAAQ,kBACjB,QAAQ,eAAe"}

package/dist/decisions/index.d.ts

@@ -0,0 +1,50 @@
+import { Answer, AnswerFor, Answers, Choice, ChoiceAnswer, DecisionInput, DecisionRequest, DecisionResult, Level, Predicate, PredicateAnswer, Question, Questions, RefusalAnswer, Score, ScoreAnswer } from "./types.js";
+import { ClientOptions, OpenAI } from "openai";
+import { Runnable, RunnableConfig } from "@langchain/core/runnables";
+export interface OpenAIDecisionsFields {
+  /** Decisions model name, such as `gpt-6-luna`. */
+  model: string;
+  /**
+   * Falls back to the LangSmith gateway key when routing through the gateway, then
+   * to the `OPENAI_API_KEY` environment variable.
+   */
+  apiKey?: string;
+  /**
+   * OpenAI SDK client options, such as `baseURL`, `timeout` or `fetch`. Without a
+   * `baseURL`, `OPENAI_API_BASE` or `OPENAI_BASE_URL`, setting `LANGSMITH_GATEWAY`
+   * routes requests through the LangSmith gateway, as with `ChatOpenAI`.
+   */
+  configuration?: Omit<ClientOptions, "apiKey">;
+}
+/**
+ * Ask typed questions about text, messages or JSON state with the OpenAI Decisions
+ * API (beta). Answer types are inferred from the questions passed to `invoke`.
+ *
+ * @example
+ * ```ts
+ * const decisions = new OpenAIDecisions({ model: "gpt-6-luna" });
+ * const { answers } = await decisions.invoke({
+ *   input: "I was charged twice!",
+ *   questions: {
+ *     urgent: { type: "predicate", instructions: "Is this urgent?" },
+ *     team: {
+ *       type: "choice",
+ *       instructions: "Which team should handle this?",
+ *       choices: { billing: "Payments", technical: null },
+ *     },
+ *   },
+ * });
+ * if (answers.team.type === "choice") answers.team.choice; // "billing" | "technical"
+ * ```
+ */
+export declare class OpenAIDecisions extends Runnable<DecisionRequest, DecisionResult> {
+  static lc_name(): string;
+  lc_namespace: string[];
+  readonly model: string;
+  protected client: OpenAI;
+  constructor(model: string, fields?: Omit<OpenAIDecisionsFields, "model">);
+  constructor(fields: OpenAIDecisionsFields);
+  invoke<const Q extends Questions>(request: DecisionRequest<Q>, options?: Partial<RunnableConfig>): Promise<DecisionResult<Q>>;
+}
+export type { Answer, AnswerFor, Answers, Choice, ChoiceAnswer, DecisionInput, DecisionRequest, DecisionResult, Level, Predicate, PredicateAnswer, Question, Questions, RefusalAnswer, Score, ScoreAnswer };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":["OpenAIClient"],"sources":["../../src/decisions/index.ts"],"mappings":";;;iBAkCiB;;EAEf;;;;;EAKA;;;;;;EAMA,gBAAgB,KAAK;;;;;;;;;;;;;;;;;;;;;;;qBAwBV,wBAAwB,SAAS,iBAAiB;SACtD;EAIP;WAES;YAEC,QAAQA;EAElB,YAAY,eAAe,SAAS,KAAK;EACzC,YAAY,QAAQ;EA8Bd,aAAa,UAAU,WAC3B,SAAS,gBAAgB,IACzB,UAAU,QAAQ,kBACjB,QAAQ,eAAe"}

package/dist/decisions/index.js

@@ -0,0 +1,98 @@
+import { wrapOpenAIClientError } from "../utils/client.js";
+import { toDecisionInput } from "./input.js";
+import { convertResponsesUsageToUsageMetadata } from "../converters/responses.js";
+import { toQuestionParam } from "./types.js";
+import { OpenAI } from "openai";
+import { getEnvironmentVariable } from "@langchain/core/utils/env";
+import { resolveLangSmithGatewayConfig } from "@langchain/core/utils/gateway";
+import { Runnable } from "@langchain/core/runnables";
+// src/decisions/index.ts
+/**
+* Ask typed questions about text, messages or JSON state with the OpenAI Decisions
+* API (beta). Answer types are inferred from the questions passed to `invoke`.
+*
+* @example
+* ```ts
+* const decisions = new OpenAIDecisions({ model: "gpt-6-luna" });
+* const { answers } = await decisions.invoke({
+*   input: "I was charged twice!",
+*   questions: {
+*     urgent: { type: "predicate", instructions: "Is this urgent?" },
+*     team: {
+*       type: "choice",
+*       instructions: "Which team should handle this?",
+*       choices: { billing: "Payments", technical: null },
+*     },
+*   },
+* });
+* if (answers.team.type === "choice") answers.team.choice; // "billing" | "technical"
+* ```
+*/
+var OpenAIDecisions = class extends Runnable {
+	static lc_name() {
+		return "OpenAIDecisions";
+	}
+	lc_namespace = [
+		"langchain",
+		"openai",
+		"decisions"
+	];
+	model;
+	client;
+	constructor(modelOrFields, fieldsArg) {
+		const fields = typeof modelOrFields === "string" ? {
+			...fieldsArg,
+			model: modelOrFields
+		} : modelOrFields;
+		const { apiKey, ...kwargs } = fields;
+		super(kwargs);
+		if (!fields.model?.trim()) throw new Error("An OpenAI Decisions model is required.");
+		this.model = fields.model;
+		const gateway = resolveLangSmithGatewayConfig({
+			baseURL: fields.configuration?.baseURL ?? (getEnvironmentVariable("OPENAI_API_BASE") || getEnvironmentVariable("OPENAI_BASE_URL") || void 0),
+			providerPath: "openai/v1"
+		});
+		this.client = new OpenAI({
+			...fields.configuration,
+			baseURL: gateway.baseURL,
+			apiKey: apiKey ?? gateway.apiKey ?? getEnvironmentVariable("OPENAI_API_KEY")
+		});
+	}
+	async invoke(request, options) {
+		return this._callWithConfig(async ({ input, questions }, config) => {
+			const names = Object.keys(questions);
+			if (!names.length) throw new Error("OpenAI Decisions requires at least one question.");
+			let decision;
+			let response;
+			try {
+				({data: decision, response} = await this.client.decisions.create({
+					model: this.model,
+					input: toDecisionInput(input),
+					questions: names.map((name) => toQuestionParam(name, questions[name]))
+				}, { signal: config?.signal }).withResponse());
+			} catch (error) {
+				throw wrapOpenAIClientError(error);
+			}
+			const answers = new Map(decision.answers.map(({ name, ...answer }) => [name, answer]));
+			for (const name of names) if (!answers.has(name)) throw new Error(`OpenAI Decisions returned no answer for question "${name}".`);
+			return {
+				answers: Object.fromEntries(answers),
+				model: decision.model,
+				requestId: response.headers.get("x-request-id") ?? void 0,
+				usage_metadata: convertResponsesUsageToUsageMetadata(decision.usage)
+			};
+		}, request, {
+			...options,
+			runType: "llm",
+			metadata: {
+				...options?.metadata,
+				ls_provider: "openai",
+				ls_model_name: this.model,
+				ls_model_type: "chat"
+			}
+		});
+	}
+};
+export { OpenAIDecisions };
+
+//# sourceMappingURL=index.js.map

package/dist/decisions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["OpenAIClient"],"sources":["../../src/decisions/index.ts"],"sourcesContent":["import { OpenAI as OpenAIClient, type ClientOptions } from \"openai\";\nimport { Runnable, type RunnableConfig } from \"@langchain/core/runnables\";\nimport { getEnvironmentVariable } from \"@langchain/core/utils/env\";\nimport { resolveLangSmithGatewayConfig } from \"@langchain/core/utils/gateway\";\nimport { wrapOpenAIClientError } from \"../utils/client.js\";\nimport { toDecisionInput } from \"./input.js\";\nimport { convertResponsesUsageToUsageMetadata } from \"../converters/responses.js\";\nimport {\n  toQuestionParam,\n  type Answers,\n  type DecisionRequest,\n  type DecisionResult,\n  type Questions,\n} from \"./types.js\";\n\nexport type {\n  Answer,\n  AnswerFor,\n  Answers,\n  Choice,\n  ChoiceAnswer,\n  DecisionInput,\n  DecisionRequest,\n  DecisionResult,\n  Level,\n  Predicate,\n  PredicateAnswer,\n  Question,\n  Questions,\n  RefusalAnswer,\n  Score,\n  ScoreAnswer,\n} from \"./types.js\";\n\nexport interface OpenAIDecisionsFields {\n  /** Decisions model name, such as `gpt-6-luna`. */\n  model: string;\n  /**\n   * Falls back to the LangSmith gateway key when routing through the gateway, then\n   * to the `OPENAI_API_KEY` environment variable.\n   */\n  apiKey?: string;\n  /**\n   * OpenAI SDK client options, such as `baseURL`, `timeout` or `fetch`. Without a\n   * `baseURL`, `OPENAI_API_BASE` or `OPENAI_BASE_URL`, setting `LANGSMITH_GATEWAY`\n   * routes requests through the LangSmith gateway, as with `ChatOpenAI`.\n   */\n  configuration?: Omit<ClientOptions, \"apiKey\">;\n}\n\n/**\n * Ask typed questions about text, messages or JSON state with the OpenAI Decisions\n * API (beta). Answer types are inferred from the questions passed to `invoke`.\n *\n * @example\n * ```ts\n * const decisions = new OpenAIDecisions({ model: \"gpt-6-luna\" });\n * const { answers } = await decisions.invoke({\n *   input: \"I was charged twice!\",\n *   questions: {\n *     urgent: { type: \"predicate\", instructions: \"Is this urgent?\" },\n *     team: {\n *       type: \"choice\",\n *       instructions: \"Which team should handle this?\",\n *       choices: { billing: \"Payments\", technical: null },\n *     },\n *   },\n * });\n * if (answers.team.type === \"choice\") answers.team.choice; // \"billing\" | \"technical\"\n * ```\n */\nexport class OpenAIDecisions extends Runnable<DecisionRequest, DecisionResult> {\n  static lc_name() {\n    return \"OpenAIDecisions\";\n  }\n\n  lc_namespace = [\"langchain\", \"openai\", \"decisions\"];\n\n  readonly model: string;\n\n  protected client: OpenAIClient;\n\n  constructor(model: string, fields?: Omit<OpenAIDecisionsFields, \"model\">);\n  constructor(fields: OpenAIDecisionsFields);\n  constructor(\n    modelOrFields: string | OpenAIDecisionsFields,\n    fieldsArg?: Omit<OpenAIDecisionsFields, \"model\">\n  ) {\n    const fields =\n      typeof modelOrFields === \"string\"\n        ? { ...fieldsArg, model: modelOrFields }\n        : modelOrFields;\n    const { apiKey, ...kwargs } = fields;\n    super(kwargs);\n    if (!fields.model?.trim())\n      throw new Error(\"An OpenAI Decisions model is required.\");\n    this.model = fields.model;\n    const gateway = resolveLangSmithGatewayConfig({\n      baseURL:\n        fields.configuration?.baseURL ??\n        (getEnvironmentVariable(\"OPENAI_API_BASE\") ||\n          getEnvironmentVariable(\"OPENAI_BASE_URL\") ||\n          undefined),\n      providerPath: \"openai/v1\",\n    });\n    this.client = new OpenAIClient({\n      ...fields.configuration,\n      baseURL: gateway.baseURL,\n      apiKey:\n        apiKey ?? gateway.apiKey ?? getEnvironmentVariable(\"OPENAI_API_KEY\"),\n    });\n  }\n\n  async invoke<const Q extends Questions>(\n    request: DecisionRequest<Q>,\n    options?: Partial<RunnableConfig>\n  ): Promise<DecisionResult<Q>> {\n    return this._callWithConfig(\n      async (\n        { input, questions }: DecisionRequest<Q>,\n        config?: Partial<RunnableConfig>\n      ): Promise<DecisionResult<Q>> => {\n        const names = Object.keys(questions);\n        if (!names.length)\n          throw new Error(\"OpenAI Decisions requires at least one question.\");\n        let decision: OpenAIClient.Decision;\n        let response: Response;\n        try {\n          ({ data: decision, response } = await this.client.decisions\n            .create(\n              {\n                model: this.model,\n                input: toDecisionInput(input),\n                questions: names.map((name) =>\n                  toQuestionParam(name, questions[name])\n                ),\n              },\n              { signal: config?.signal }\n            )\n            .withResponse());\n        } catch (error) {\n          throw wrapOpenAIClientError(error);\n        }\n        const answers = new Map(\n          decision.answers.map(({ name, ...answer }) => [name, answer])\n        );\n        for (const name of names)\n          if (!answers.has(name))\n            throw new Error(\n              `OpenAI Decisions returned no answer for question \"${name}\".`\n            );\n        return {\n          answers: Object.fromEntries(answers) as Answers<Q>,\n          model: decision.model,\n          requestId: response.headers.get(\"x-request-id\") ?? undefined,\n          usage_metadata: convertResponsesUsageToUsageMetadata(decision.usage),\n        };\n      },\n      request,\n      {\n        ...options,\n        runType: \"llm\",\n        metadata: {\n          ...options?.metadata,\n          ls_provider: \"openai\",\n          ls_model_name: this.model,\n          ls_model_type: \"chat\",\n        },\n      }\n    ) as Promise<DecisionResult<Q>>;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuEA,IAAa,kBAAb,cAAqC,SAA0C;CAC7E,OAAO,UAAU;EACf,OAAO;CACT;CAEA,eAAe;EAAC;EAAa;EAAU;CAAW;CAElD;CAEA;CAIA,YACE,eACA,WACA;EACA,MAAM,SACJ,OAAO,kBAAkB,WACrB;GAAE,GAAG;GAAW,OAAO;EAAc,IACrC;EACN,MAAM,EAAE,QAAQ,GAAG,WAAW;EAC9B,MAAM,MAAM;EACZ,IAAI,CAAC,OAAO,OAAO,KAAK,GACtB,MAAM,IAAI,MAAM,wCAAwC;EAC1D,KAAK,QAAQ,OAAO;EACpB,MAAM,UAAU,8BAA8B;GAC5C,SACE,OAAO,eAAe,YACrB,uBAAuB,iBAAiB,KACvC,uBAAuB,iBAAiB,KACxC,KAAA;GACJ,cAAc;EAChB,CAAC;EACD,KAAK,SAAS,IAAIA,OAAa;GAC7B,GAAG,OAAO;GACV,SAAS,QAAQ;GACjB,QACE,UAAU,QAAQ,UAAU,uBAAuB,gBAAgB;EACvE,CAAC;CACH;CAEA,MAAM,OACJ,SACA,SAC4B;EAC5B,OAAO,KAAK,gBACV,OACE,EAAE,OAAO,aACT,WAC+B;GAC/B,MAAM,QAAQ,OAAO,KAAK,SAAS;GACnC,IAAI,CAAC,MAAM,QACT,MAAM,IAAI,MAAM,kDAAkD;GACpE,IAAI;GACJ,IAAI;GACJ,IAAI;IACF,CAAC,CAAE,MAAM,UAAU,YAAa,MAAM,KAAK,OAAO,UAC/C,OACC;KACE,OAAO,KAAK;KACZ,OAAO,gBAAgB,KAAK;KAC5B,WAAW,MAAM,KAAK,SACpB,gBAAgB,MAAM,UAAU,KAAK,CACvC;IACF,GACA,EAAE,QAAQ,QAAQ,OAAO,CAC3B,CAAC,CACA,aAAa;GAClB,SAAS,OAAO;IACd,MAAM,sBAAsB,KAAK;GACnC;GACA,MAAM,UAAU,IAAI,IAClB,SAAS,QAAQ,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,MAAM,CAAC,CAC9D;GACA,KAAK,MAAM,QAAQ,OACjB,IAAI,CAAC,QAAQ,IAAI,IAAI,GACnB,MAAM,IAAI,MACR,qDAAqD,KAAK,GAC5D;GACJ,OAAO;IACL,SAAS,OAAO,YAAY,OAAO;IACnC,OAAO,SAAS;IAChB,WAAW,SAAS,QAAQ,IAAI,cAAc,KAAK,KAAA;IACnD,gBAAgB,qCAAqC,SAAS,KAAK;GACrE;EACF,GACA,SACA;GACE,GAAG;GACH,SAAS;GACT,UAAU;IACR,GAAG,SAAS;IACZ,aAAa;IACb,eAAe,KAAK;IACpB,eAAe;GACjB;EACF,CACF;CACF;AACF"}

package/dist/decisions/input.cjs

@@ -0,0 +1,122 @@
+const require_responses = require("../converters/responses.cjs");
+let _langchain_core_messages = require("@langchain/core/messages");
+// src/decisions/input.ts
+/**
+* Keeps text and image parts, which is all user messages and tool outputs accept,
+* and replaces anything else, such as `input_file`, with a placeholder.
+*/
+function toInputParts(content) {
+	return content.map((part) => part.type === "input_text" && typeof part.text === "string" ? {
+		type: "input_text",
+		text: part.text
+	} : part.type === "input_image" && typeof part.image_url === "string" ? {
+		type: "input_image",
+		image_url: part.image_url
+	} : {
+		type: "input_text",
+		text: `[${part.type} omitted]`
+	});
+}
+/** System and developer messages accept only text parts. */
+function toTextParts(content) {
+	return toInputParts(content).map((part) => part.type === "input_text" ? part : {
+		type: "input_text",
+		text: "[input_image omitted]"
+	});
+}
+/** Assistant messages accept `output_text` and `refusal` parts, without `annotations`. */
+function toAssistantParts(content) {
+	return content.flatMap((part) => {
+		if (part.type === "output_text" && typeof part.text === "string") return [{
+			type: "output_text",
+			text: part.text
+		}];
+		if (part.type === "refusal" && typeof part.refusal === "string") return [{
+			type: "refusal",
+			refusal: part.refusal
+		}];
+		return [];
+	});
+}
+/**
+* Rebuilds one Responses item with only the fields the Decisions API accepts.
+* Items it has no equivalent for, such as reasoning, are dropped.
+*/
+function toDecisionItem(item) {
+	if ("role" in item && (!("type" in item) || item.type === "message")) {
+		const { role, content } = item;
+		if (typeof content === "string") return role === "user" || role === "system" || role === "developer" || role === "assistant" ? [{
+			role,
+			content
+		}] : [];
+		if (role === "user") return [{
+			role,
+			content: toInputParts(content)
+		}];
+		if (role === "system" || role === "developer") return [{
+			role,
+			content: toTextParts(content)
+		}];
+		if (role === "assistant") return [{
+			role,
+			content: toAssistantParts(content)
+		}];
+		return [];
+	}
+	if (!("type" in item)) return [];
+	switch (item.type) {
+		case "function_call": return [{
+			type: item.type,
+			call_id: item.call_id,
+			name: item.name,
+			arguments: item.arguments
+		}];
+		case "custom_tool_call": return [{
+			type: item.type,
+			call_id: item.call_id,
+			name: item.name,
+			input: item.input
+		}];
+		case "function_call_output":
+		case "custom_tool_call_output": return [{
+			type: item.type,
+			call_id: item.call_id ?? "",
+			output: typeof item.output === "string" ? item.output : toInputParts(item.output)
+		}];
+		default: return [];
+	}
+}
+/** Converts LangChain messages to Decisions input items. */
+function toDecisionItems(messages) {
+	return require_responses.convertMessagesToResponsesInput({
+		messages,
+		zdrEnabled: true,
+		model: ""
+	}).flatMap(toDecisionItem);
+}
+/** Replaces messages nested in JSON state with their Decisions input items. */
+function toJSONValue(value) {
+	if (_langchain_core_messages.BaseMessage.isInstance(value)) return toDecisionItems([value]);
+	if (Array.isArray(value)) return value.flatMap((item) => _langchain_core_messages.BaseMessage.isInstance(item) ? toDecisionItems([item]) : [toJSONValue(item)]);
+	if (typeof value === "object" && value?.constructor === Object) return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, toJSONValue(item)]));
+	return value;
+}
+/**
+* Converts input to the Decisions API `input` field: strings as they are, messages
+* as a native conversation, and anything else as an `input_json` part.
+*/
+function toDecisionInput(input) {
+	if (typeof input === "string") return input;
+	const values = Array.isArray(input) ? input : [input];
+	if (values.length > 0 && values.every((value) => _langchain_core_messages.BaseMessage.isInstance(value))) return toDecisionItems(values);
+	return [{
+		role: "user",
+		content: [{
+			type: "input_json",
+			data: toJSONValue(input)
+		}]
+	}];
+}
+exports.toDecisionInput = toDecisionInput;
+
+//# sourceMappingURL=input.cjs.map

package/dist/decisions/input.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.cjs","names":["convertMessagesToResponsesInput","BaseMessage"],"sources":["../../src/decisions/input.ts"],"sourcesContent":["import type { OpenAI as OpenAIClient } from \"openai\";\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport { convertMessagesToResponsesInput } from \"../converters/responses.js\";\nimport type { DecisionInput } from \"./types.js\";\n\n/**\n * How LangChain input becomes the Decisions API `input` field.\n *\n * The Decisions API accepts a string, or a list of items using a subset of the\n * Responses API input format: `user`, `system`, `developer` and `assistant` messages,\n * plus function and custom tool calls and their outputs. Rather than writing a second\n * LangChain message converter, messages go through the Responses converter\n * (`convertMessagesToResponsesInput`), which already handles roles, content blocks,\n * tool calls and tool results. The Decisions API is strict about what it accepts,\n * though, and Responses items carry things it rejects: reasoning items, item `id`s,\n * `annotations` and `phase` on assistant text, and content parts such as\n * `input_file`. So each Responses item is rebuilt with only the fields the Decisions\n * API accepts (`toDecisionItem`), and unsupported content parts are replaced by a\n * text placeholder so the model knows something was there.\n *\n * Input that is not messages, such as application state, is sent as an `input_json`\n * part, which the API reads as structured data. Messages nested in that state are\n * converted to the same items, because a `BaseMessage` instance would otherwise be\n * serialized as LangChain's internal constructor format.\n */\n\ntype ResponsesItem = ReturnType<typeof convertMessagesToResponsesInput>[number];\ntype DecisionItem = Exclude<\n  OpenAIClient.DecisionCreateParams[\"input\"],\n  string\n>[number];\ntype InputPart =\n  | OpenAIClient.DecisionInputText\n  | OpenAIClient.DecisionInputImage;\ntype AssistantPart = Exclude<\n  OpenAIClient.DecisionInputMessage.DecisionInputAssistantMessage[\"content\"],\n  string\n>[number];\n\n/** A Responses content part, loosely typed because roles and tool outputs use different part unions. */\ntype ResponsesPart = {\n  type: string;\n  text?: unknown;\n  image_url?: unknown;\n  refusal?: unknown;\n};\n\n/**\n * Keeps text and image parts, which is all user messages and tool outputs accept,\n * and replaces anything else, such as `input_file`, with a placeholder.\n */\nfunction toInputParts(content: unknown): InputPart[] {\n  return (content as ResponsesPart[]).map((part) =>\n    part.type === \"input_text\" && typeof part.text === \"string\"\n      ? { type: \"input_text\", text: part.text }\n      : part.type === \"input_image\" && typeof part.image_url === \"string\"\n        ? { type: \"input_image\", image_url: part.image_url }\n        : { type: \"input_text\", text: `[${part.type} omitted]` }\n  );\n}\n\n/** System and developer messages accept only text parts. */\nfunction toTextParts(content: unknown): OpenAIClient.DecisionInputText[] {\n  return toInputParts(content).map((part) =>\n    part.type === \"input_text\"\n      ? part\n      : { type: \"input_text\", text: \"[input_image omitted]\" }\n  );\n}\n\n/** Assistant messages accept `output_text` and `refusal` parts, without `annotations`. */\nfunction toAssistantParts(content: unknown): AssistantPart[] {\n  return (content as ResponsesPart[]).flatMap((part): AssistantPart[] => {\n    if (part.type === \"output_text\" && typeof part.text === \"string\")\n      return [{ type: \"output_text\", text: part.text }];\n    if (part.type === \"refusal\" && typeof part.refusal === \"string\")\n      return [{ type: \"refusal\", refusal: part.refusal }];\n    return [];\n  });\n}\n\n/**\n * Rebuilds one Responses item with only the fields the Decisions API accepts.\n * Items it has no equivalent for, such as reasoning, are dropped.\n */\nfunction toDecisionItem(item: ResponsesItem): DecisionItem[] {\n  if (\"role\" in item && (!(\"type\" in item) || item.type === \"message\")) {\n    const { role, content } = item;\n    if (typeof content === \"string\")\n      return role === \"user\" ||\n        role === \"system\" ||\n        role === \"developer\" ||\n        role === \"assistant\"\n        ? [{ role, content }]\n        : [];\n    if (role === \"user\") return [{ role, content: toInputParts(content) }];\n    if (role === \"system\" || role === \"developer\")\n      return [{ role, content: toTextParts(content) }];\n    if (role === \"assistant\")\n      return [{ role, content: toAssistantParts(content) }];\n    return [];\n  }\n  if (!(\"type\" in item)) return [];\n  switch (item.type) {\n    case \"function_call\":\n      return [\n        {\n          type: item.type,\n          call_id: item.call_id,\n          name: item.name,\n          arguments: item.arguments,\n        },\n      ];\n    case \"custom_tool_call\":\n      return [\n        {\n          type: item.type,\n          call_id: item.call_id,\n          name: item.name,\n          input: item.input,\n        },\n      ];\n    case \"function_call_output\":\n    case \"custom_tool_call_output\":\n      return [\n        {\n          type: item.type,\n          call_id: item.call_id ?? \"\",\n          output:\n            typeof item.output === \"string\"\n              ? item.output\n              : toInputParts(item.output),\n        },\n      ];\n    default:\n      return [];\n  }\n}\n\n/** Converts LangChain messages to Decisions input items. */\nfunction toDecisionItems(messages: BaseMessage[]): DecisionItem[] {\n  return convertMessagesToResponsesInput({\n    messages,\n    zdrEnabled: true,\n    model: \"\",\n  }).flatMap(toDecisionItem);\n}\n\n/** Replaces messages nested in JSON state with their Decisions input items. */\nfunction toJSONValue(value: unknown): unknown {\n  if (BaseMessage.isInstance(value)) return toDecisionItems([value]);\n  if (Array.isArray(value))\n    return value.flatMap((item) =>\n      BaseMessage.isInstance(item)\n        ? toDecisionItems([item])\n        : [toJSONValue(item)]\n    );\n  if (typeof value === \"object\" && value?.constructor === Object)\n    return Object.fromEntries(\n      Object.entries(value).map(([key, item]) => [key, toJSONValue(item)])\n    );\n  return value;\n}\n\n/**\n * Converts input to the Decisions API `input` field: strings as they are, messages\n * as a native conversation, and anything else as an `input_json` part.\n */\nexport function toDecisionInput(\n  input: DecisionInput\n): OpenAIClient.DecisionCreateParams[\"input\"] {\n  if (typeof input === \"string\") return input;\n  const values = Array.isArray(input) ? input : [input];\n  if (\n    values.length > 0 &&\n    values.every((value) => BaseMessage.isInstance(value))\n  )\n    return toDecisionItems(values);\n  return [\n    {\n      role: \"user\",\n      content: [\n        {\n          type: \"input_json\",\n          data: toJSONValue(input) as OpenAIClient.DecisionInputJSON[\"data\"],\n        },\n      ],\n    },\n  ];\n}\n"],"mappings":"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"}

package/dist/decisions/input.js

@@ -0,0 +1,122 @@
+import { convertMessagesToResponsesInput } from "../converters/responses.js";
+import { BaseMessage } from "@langchain/core/messages";
+// src/decisions/input.ts
+/**
+* Keeps text and image parts, which is all user messages and tool outputs accept,
+* and replaces anything else, such as `input_file`, with a placeholder.
+*/
+function toInputParts(content) {
+	return content.map((part) => part.type === "input_text" && typeof part.text === "string" ? {
+		type: "input_text",
+		text: part.text
+	} : part.type === "input_image" && typeof part.image_url === "string" ? {
+		type: "input_image",
+		image_url: part.image_url
+	} : {
+		type: "input_text",
+		text: `[${part.type} omitted]`
+	});
+}
+/** System and developer messages accept only text parts. */
+function toTextParts(content) {
+	return toInputParts(content).map((part) => part.type === "input_text" ? part : {
+		type: "input_text",
+		text: "[input_image omitted]"
+	});
+}
+/** Assistant messages accept `output_text` and `refusal` parts, without `annotations`. */
+function toAssistantParts(content) {
+	return content.flatMap((part) => {
+		if (part.type === "output_text" && typeof part.text === "string") return [{
+			type: "output_text",
+			text: part.text
+		}];
+		if (part.type === "refusal" && typeof part.refusal === "string") return [{
+			type: "refusal",
+			refusal: part.refusal
+		}];
+		return [];
+	});
+}
+/**
+* Rebuilds one Responses item with only the fields the Decisions API accepts.
+* Items it has no equivalent for, such as reasoning, are dropped.
+*/
+function toDecisionItem(item) {
+	if ("role" in item && (!("type" in item) || item.type === "message")) {
+		const { role, content } = item;
+		if (typeof content === "string") return role === "user" || role === "system" || role === "developer" || role === "assistant" ? [{
+			role,
+			content
+		}] : [];
+		if (role === "user") return [{
+			role,
+			content: toInputParts(content)
+		}];
+		if (role === "system" || role === "developer") return [{
+			role,
+			content: toTextParts(content)
+		}];
+		if (role === "assistant") return [{
+			role,
+			content: toAssistantParts(content)
+		}];
+		return [];
+	}
+	if (!("type" in item)) return [];
+	switch (item.type) {
+		case "function_call": return [{
+			type: item.type,
+			call_id: item.call_id,
+			name: item.name,
+			arguments: item.arguments
+		}];
+		case "custom_tool_call": return [{
+			type: item.type,
+			call_id: item.call_id,
+			name: item.name,
+			input: item.input
+		}];
+		case "function_call_output":
+		case "custom_tool_call_output": return [{
+			type: item.type,
+			call_id: item.call_id ?? "",
+			output: typeof item.output === "string" ? item.output : toInputParts(item.output)
+		}];
+		default: return [];
+	}
+}
+/** Converts LangChain messages to Decisions input items. */
+function toDecisionItems(messages) {
+	return convertMessagesToResponsesInput({
+		messages,
+		zdrEnabled: true,
+		model: ""
+	}).flatMap(toDecisionItem);
+}
+/** Replaces messages nested in JSON state with their Decisions input items. */
+function toJSONValue(value) {
+	if (BaseMessage.isInstance(value)) return toDecisionItems([value]);
+	if (Array.isArray(value)) return value.flatMap((item) => BaseMessage.isInstance(item) ? toDecisionItems([item]) : [toJSONValue(item)]);
+	if (typeof value === "object" && value?.constructor === Object) return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, toJSONValue(item)]));
+	return value;
+}
+/**
+* Converts input to the Decisions API `input` field: strings as they are, messages
+* as a native conversation, and anything else as an `input_json` part.
+*/
+function toDecisionInput(input) {
+	if (typeof input === "string") return input;
+	const values = Array.isArray(input) ? input : [input];
+	if (values.length > 0 && values.every((value) => BaseMessage.isInstance(value))) return toDecisionItems(values);
+	return [{
+		role: "user",
+		content: [{
+			type: "input_json",
+			data: toJSONValue(input)
+		}]
+	}];
+}
+export { toDecisionInput };
+
+//# sourceMappingURL=input.js.map

package/dist/decisions/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","names":[],"sources":["../../src/decisions/input.ts"],"sourcesContent":["import type { OpenAI as OpenAIClient } from \"openai\";\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport { convertMessagesToResponsesInput } from \"../converters/responses.js\";\nimport type { DecisionInput } from \"./types.js\";\n\n/**\n * How LangChain input becomes the Decisions API `input` field.\n *\n * The Decisions API accepts a string, or a list of items using a subset of the\n * Responses API input format: `user`, `system`, `developer` and `assistant` messages,\n * plus function and custom tool calls and their outputs. Rather than writing a second\n * LangChain message converter, messages go through the Responses converter\n * (`convertMessagesToResponsesInput`), which already handles roles, content blocks,\n * tool calls and tool results. The Decisions API is strict about what it accepts,\n * though, and Responses items carry things it rejects: reasoning items, item `id`s,\n * `annotations` and `phase` on assistant text, and content parts such as\n * `input_file`. So each Responses item is rebuilt with only the fields the Decisions\n * API accepts (`toDecisionItem`), and unsupported content parts are replaced by a\n * text placeholder so the model knows something was there.\n *\n * Input that is not messages, such as application state, is sent as an `input_json`\n * part, which the API reads as structured data. Messages nested in that state are\n * converted to the same items, because a `BaseMessage` instance would otherwise be\n * serialized as LangChain's internal constructor format.\n */\n\ntype ResponsesItem = ReturnType<typeof convertMessagesToResponsesInput>[number];\ntype DecisionItem = Exclude<\n  OpenAIClient.DecisionCreateParams[\"input\"],\n  string\n>[number];\ntype InputPart =\n  | OpenAIClient.DecisionInputText\n  | OpenAIClient.DecisionInputImage;\ntype AssistantPart = Exclude<\n  OpenAIClient.DecisionInputMessage.DecisionInputAssistantMessage[\"content\"],\n  string\n>[number];\n\n/** A Responses content part, loosely typed because roles and tool outputs use different part unions. */\ntype ResponsesPart = {\n  type: string;\n  text?: unknown;\n  image_url?: unknown;\n  refusal?: unknown;\n};\n\n/**\n * Keeps text and image parts, which is all user messages and tool outputs accept,\n * and replaces anything else, such as `input_file`, with a placeholder.\n */\nfunction toInputParts(content: unknown): InputPart[] {\n  return (content as ResponsesPart[]).map((part) =>\n    part.type === \"input_text\" && typeof part.text === \"string\"\n      ? { type: \"input_text\", text: part.text }\n      : part.type === \"input_image\" && typeof part.image_url === \"string\"\n        ? { type: \"input_image\", image_url: part.image_url }\n        : { type: \"input_text\", text: `[${part.type} omitted]` }\n  );\n}\n\n/** System and developer messages accept only text parts. */\nfunction toTextParts(content: unknown): OpenAIClient.DecisionInputText[] {\n  return toInputParts(content).map((part) =>\n    part.type === \"input_text\"\n      ? part\n      : { type: \"input_text\", text: \"[input_image omitted]\" }\n  );\n}\n\n/** Assistant messages accept `output_text` and `refusal` parts, without `annotations`. */\nfunction toAssistantParts(content: unknown): AssistantPart[] {\n  return (content as ResponsesPart[]).flatMap((part): AssistantPart[] => {\n    if (part.type === \"output_text\" && typeof part.text === \"string\")\n      return [{ type: \"output_text\", text: part.text }];\n    if (part.type === \"refusal\" && typeof part.refusal === \"string\")\n      return [{ type: \"refusal\", refusal: part.refusal }];\n    return [];\n  });\n}\n\n/**\n * Rebuilds one Responses item with only the fields the Decisions API accepts.\n * Items it has no equivalent for, such as reasoning, are dropped.\n */\nfunction toDecisionItem(item: ResponsesItem): DecisionItem[] {\n  if (\"role\" in item && (!(\"type\" in item) || item.type === \"message\")) {\n    const { role, content } = item;\n    if (typeof content === \"string\")\n      return role === \"user\" ||\n        role === \"system\" ||\n        role === \"developer\" ||\n        role === \"assistant\"\n        ? [{ role, content }]\n        : [];\n    if (role === \"user\") return [{ role, content: toInputParts(content) }];\n    if (role === \"system\" || role === \"developer\")\n      return [{ role, content: toTextParts(content) }];\n    if (role === \"assistant\")\n      return [{ role, content: toAssistantParts(content) }];\n    return [];\n  }\n  if (!(\"type\" in item)) return [];\n  switch (item.type) {\n    case \"function_call\":\n      return [\n        {\n          type: item.type,\n          call_id: item.call_id,\n          name: item.name,\n          arguments: item.arguments,\n        },\n      ];\n    case \"custom_tool_call\":\n      return [\n        {\n          type: item.type,\n          call_id: item.call_id,\n          name: item.name,\n          input: item.input,\n        },\n      ];\n    case \"function_call_output\":\n    case \"custom_tool_call_output\":\n      return [\n        {\n          type: item.type,\n          call_id: item.call_id ?? \"\",\n          output:\n            typeof item.output === \"string\"\n              ? item.output\n              : toInputParts(item.output),\n        },\n      ];\n    default:\n      return [];\n  }\n}\n\n/** Converts LangChain messages to Decisions input items. */\nfunction toDecisionItems(messages: BaseMessage[]): DecisionItem[] {\n  return convertMessagesToResponsesInput({\n    messages,\n    zdrEnabled: true,\n    model: \"\",\n  }).flatMap(toDecisionItem);\n}\n\n/** Replaces messages nested in JSON state with their Decisions input items. */\nfunction toJSONValue(value: unknown): unknown {\n  if (BaseMessage.isInstance(value)) return toDecisionItems([value]);\n  if (Array.isArray(value))\n    return value.flatMap((item) =>\n      BaseMessage.isInstance(item)\n        ? toDecisionItems([item])\n        : [toJSONValue(item)]\n    );\n  if (typeof value === \"object\" && value?.constructor === Object)\n    return Object.fromEntries(\n      Object.entries(value).map(([key, item]) => [key, toJSONValue(item)])\n    );\n  return value;\n}\n\n/**\n * Converts input to the Decisions API `input` field: strings as they are, messages\n * as a native conversation, and anything else as an `input_json` part.\n */\nexport function toDecisionInput(\n  input: DecisionInput\n): OpenAIClient.DecisionCreateParams[\"input\"] {\n  if (typeof input === \"string\") return input;\n  const values = Array.isArray(input) ? input : [input];\n  if (\n    values.length > 0 &&\n    values.every((value) => BaseMessage.isInstance(value))\n  )\n    return toDecisionItems(values);\n  return [\n    {\n      role: \"user\",\n      content: [\n        {\n          type: \"input_json\",\n          data: toJSONValue(input) as OpenAIClient.DecisionInputJSON[\"data\"],\n        },\n      ],\n    },\n  ];\n}\n"],"mappings":"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"}

package/dist/decisions/types.cjs

@@ -0,0 +1,28 @@
+// src/decisions/types.ts
+/** Converts a named question to the shape the Decisions API expects. */
+function toQuestionParam(name, question) {
+	const { type, instructions } = question;
+	if (type === "predicate") return {
+		type,
+		name,
+		instructions
+	};
+	if (type === "choice") return {
+		type,
+		name,
+		instructions,
+		choices: Object.entries(question.choices).map(([value, description]) => description == null ? { value } : {
+			value,
+			description
+		})
+	};
+	return {
+		type,
+		name,
+		instructions,
+		levels: question.levels.map((level) => typeof level === "string" ? { label: level } : level)
+	};
+}
+exports.toQuestionParam = toQuestionParam;
+
+//# sourceMappingURL=types.cjs.map

package/dist/decisions/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","names":[],"sources":["../../src/decisions/types.ts"],"sourcesContent":["import type { OpenAI as OpenAIClient } from \"openai\";\nimport type { BaseMessage, UsageMetadata } from \"@langchain/core/messages\";\n\ntype QuestionParam = OpenAIClient.DecisionCreateParams[\"questions\"][number];\n\n/** Estimate the probability that a condition is true. */\nexport interface Predicate {\n  type: \"predicate\";\n  instructions: string;\n}\n\n/** Select one option. Keys are the option values; values describe when each applies. */\nexport interface Choice<K extends string = string> {\n  type: \"choice\";\n  instructions: string;\n  choices: Record<K, string | null>;\n}\n\n/** One level of a `Score` rubric. */\nexport type Level = OpenAIClient.DecisionCreateParams.QuestionParamScore.Level;\n\n/** Rate the input against two or more levels, ordered lowest to highest. */\nexport interface Score {\n  type: \"score\";\n  instructions: string;\n  levels: readonly (string | Level)[];\n}\n\nexport type Question = Predicate | Choice | Score;\n\nexport type Questions = Record<string, Question>;\n\nexport type PredicateAnswer = Omit<\n  OpenAIClient.Decision.AnswerResourcePredicate,\n  \"name\"\n>;\n\nexport type ChoiceAnswer<K extends string = string> = Omit<\n  OpenAIClient.Decision.AnswerResourceChoice,\n  \"name\" | \"choice\" | \"probabilities\"\n> & {\n  choice: K;\n  probabilities: { value: K; probability: number }[];\n};\n\n/** `score` is the probability-weighted average of the zero-based level indices. */\nexport type ScoreAnswer = Omit<\n  OpenAIClient.Decision.AnswerResourceScore,\n  \"name\"\n>;\n\nexport type RefusalAnswer = Omit<\n  OpenAIClient.Decision.AnswerResourceRefusal,\n  \"name\"\n>;\n\nexport type Answer =\n  | PredicateAnswer\n  | ChoiceAnswer\n  | ScoreAnswer\n  | RefusalAnswer;\n\n/** The answer type a question produces. */\nexport type AnswerFor<T extends Question> = T extends Predicate\n  ? PredicateAnswer\n  : T extends Choice\n    ? ChoiceAnswer<Extract<keyof T[\"choices\"], string>>\n    : T extends Score\n      ? ScoreAnswer\n      : never;\n\n/** Answers keyed by question name, typed from the questions that were asked. */\nexport type Answers<Q extends Questions> = {\n  -readonly [K in keyof Q]: AnswerFor<Q[K]> | RefusalAnswer;\n};\n\n/**\n * Text, LangChain messages, or JSON state to evaluate. Messages are sent as a native\n * conversation; JSON objects, which may contain messages, as an `input_json` part.\n */\nexport type DecisionInput =\n  | string\n  | BaseMessage\n  | BaseMessage[]\n  | Record<string, unknown>\n  | Record<string, unknown>[];\n\n/** One Decisions request: what to evaluate and the named questions to ask. */\nexport interface DecisionRequest<Q extends Questions = Questions> {\n  input: DecisionInput;\n  questions: Q;\n}\n\nexport interface DecisionResult<Q extends Questions = Questions> {\n  answers: Answers<Q>;\n  /** The model that answered, as reported by the API. */\n  model: string;\n  requestId?: string;\n  /** Read by LangSmith to record token usage on the traced run. */\n  usage_metadata: UsageMetadata;\n}\n\n/** Converts a named question to the shape the Decisions API expects. */\nexport function toQuestionParam(\n  name: string,\n  question: Question\n): QuestionParam {\n  const { type, instructions } = question;\n  if (type === \"predicate\") return { type, name, instructions };\n  if (type === \"choice\") {\n    return {\n      type,\n      name,\n      instructions,\n      choices: Object.entries(question.choices).map(([value, description]) =>\n        description == null ? { value } : { value, description }\n      ),\n    };\n  }\n  return {\n    type,\n    name,\n    instructions,\n    levels: question.levels.map((level) =>\n      typeof level === \"string\" ? { label: level } : level\n    ),\n  };\n}\n"],"mappings":";;AAuGA,SAAgB,gBACd,MACA,UACe;CACf,MAAM,EAAE,MAAM,iBAAiB;CAC/B,IAAI,SAAS,aAAa,OAAO;EAAE;EAAM;EAAM;CAAa;CAC5D,IAAI,SAAS,UACX,OAAO;EACL;EACA;EACA;EACA,SAAS,OAAO,QAAQ,SAAS,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,iBACrD,eAAe,OAAO,EAAE,MAAM,IAAI;GAAE;GAAO;EAAY,CACzD;CACF;CAEF,OAAO;EACL;EACA;EACA;EACA,QAAQ,SAAS,OAAO,KAAK,UAC3B,OAAO,UAAU,WAAW,EAAE,OAAO,MAAM,IAAI,KACjD;CACF;AACF"}

package/dist/decisions/types.d.cts

@@ -0,0 +1,58 @@
+import { OpenAI } from "openai";
+import { BaseMessage, UsageMetadata } from "@langchain/core/messages";
+/** Estimate the probability that a condition is true. */
+export interface Predicate {
+  type: "predicate";
+  instructions: string;
+}
+/** Select one option. Keys are the option values; values describe when each applies. */
+export interface Choice<K extends string = string> {
+  type: "choice";
+  instructions: string;
+  choices: Record<K, string | null>;
+}
+/** One level of a `Score` rubric. */
+export type Level = OpenAI.DecisionCreateParams.QuestionParamScore.Level;
+/** Rate the input against two or more levels, ordered lowest to highest. */
+export interface Score {
+  type: "score";
+  instructions: string;
+  levels: readonly (string | Level)[];
+}
+export type Question = Predicate | Choice | Score;
+export type Questions = Record<string, Question>;
+export type PredicateAnswer = Omit<OpenAI.Decision.AnswerResourcePredicate, "name">;
+export type ChoiceAnswer<K extends string = string> = Omit<OpenAI.Decision.AnswerResourceChoice, "name" | "choice" | "probabilities"> & {
+  choice: K;
+  probabilities: {
+    value: K;
+    probability: number;
+  }[];
+};
+/** `score` is the probability-weighted average of the zero-based level indices. */
+export type ScoreAnswer = Omit<OpenAI.Decision.AnswerResourceScore, "name">;
+export type RefusalAnswer = Omit<OpenAI.Decision.AnswerResourceRefusal, "name">;
+export type Answer = PredicateAnswer | ChoiceAnswer | ScoreAnswer | RefusalAnswer;
+/** The answer type a question produces. */
+export type AnswerFor<T extends Question> = T extends Predicate ? PredicateAnswer : T extends Choice ? ChoiceAnswer<Extract<keyof T["choices"], string>> : T extends Score ? ScoreAnswer : never;
+/** Answers keyed by question name, typed from the questions that were asked. */
+export type Answers<Q extends Questions> = { -readonly [K in keyof Q]: AnswerFor<Q[K]> | RefusalAnswer; };
+/**
+ * Text, LangChain messages, or JSON state to evaluate. Messages are sent as a native
+ * conversation; JSON objects, which may contain messages, as an `input_json` part.
+ */
+export type DecisionInput = string | BaseMessage | BaseMessage[] | Record<string, unknown> | Record<string, unknown>[];
+/** One Decisions request: what to evaluate and the named questions to ask. */
+export interface DecisionRequest<Q extends Questions = Questions> {
+  input: DecisionInput;
+  questions: Q;
+}
+export interface DecisionResult<Q extends Questions = Questions> {
+  answers: Answers<Q>;
+  /** The model that answered, as reported by the API. */
+  model: string;
+  requestId?: string;
+  /** Read by LangSmith to record token usage on the traced run. */
+  usage_metadata: UsageMetadata;
+}
+//# sourceMappingURL=types.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":["OpenAIClient"],"sources":["../../src/decisions/types.ts"],"mappings":";;;iBAMiB;EACf;EACA;;;iBAIe,OAAO;EACtB;EACA;EACA,SAAS,OAAO;;;YAIN,QAAQA,OAAa,qBAAqB,mBAAmB;;iBAGxD;EACf;EACA;EACA,2BAA2B;;YAGjB,WAAW,YAAY,SAAS;YAEhC,YAAY,eAAe;YAE3B,kBAAkB,KAC5BA,OAAa,SAAS;YAIZ,aAAa,6BAA6B,KACpDA,OAAa,SAAS;EAGtB,QAAQ;EACR;IAAiB,OAAO;IAAG;;;;YAIjB,cAAc,KACxBA,OAAa,SAAS;YAIZ,gBAAgB,KAC1BA,OAAa,SAAS;YAIZ,SACR,kBACA,eACA,cACA;;YAGQ,UAAU,UAAU,YAAY,UAAU,YAClD,kBACA,UAAU,SACR,aAAa,cAAc,yBAC3B,UAAU,QACR;;YAII,QAAQ,UAAU,0BACjB,WAAW,IAAI,UAAU,EAAE,MAAM;;;;;YAOlC,yBAER,cACA,gBACA,0BACA;;iBAGa,gBAAgB,UAAU,YAAY;EACrD,OAAO;EACP,WAAW;;iBAGI,eAAe,UAAU,YAAY;EACpD,SAAS,QAAQ;;EAEjB;EACA;;EAEA,gBAAgB"}

package/dist/decisions/types.d.ts

@@ -0,0 +1,58 @@
+import { OpenAI } from "openai";
+import { BaseMessage, UsageMetadata } from "@langchain/core/messages";
+/** Estimate the probability that a condition is true. */
+export interface Predicate {
+  type: "predicate";
+  instructions: string;
+}
+/** Select one option. Keys are the option values; values describe when each applies. */
+export interface Choice<K extends string = string> {
+  type: "choice";
+  instructions: string;
+  choices: Record<K, string | null>;
+}
+/** One level of a `Score` rubric. */
+export type Level = OpenAI.DecisionCreateParams.QuestionParamScore.Level;
+/** Rate the input against two or more levels, ordered lowest to highest. */
+export interface Score {
+  type: "score";
+  instructions: string;
+  levels: readonly (string | Level)[];
+}
+export type Question = Predicate | Choice | Score;
+export type Questions = Record<string, Question>;
+export type PredicateAnswer = Omit<OpenAI.Decision.AnswerResourcePredicate, "name">;
+export type ChoiceAnswer<K extends string = string> = Omit<OpenAI.Decision.AnswerResourceChoice, "name" | "choice" | "probabilities"> & {
+  choice: K;
+  probabilities: {
+    value: K;
+    probability: number;
+  }[];
+};
+/** `score` is the probability-weighted average of the zero-based level indices. */
+export type ScoreAnswer = Omit<OpenAI.Decision.AnswerResourceScore, "name">;
+export type RefusalAnswer = Omit<OpenAI.Decision.AnswerResourceRefusal, "name">;
+export type Answer = PredicateAnswer | ChoiceAnswer | ScoreAnswer | RefusalAnswer;
+/** The answer type a question produces. */
+export type AnswerFor<T extends Question> = T extends Predicate ? PredicateAnswer : T extends Choice ? ChoiceAnswer<Extract<keyof T["choices"], string>> : T extends Score ? ScoreAnswer : never;
+/** Answers keyed by question name, typed from the questions that were asked. */
+export type Answers<Q extends Questions> = { -readonly [K in keyof Q]: AnswerFor<Q[K]> | RefusalAnswer; };
+/**
+ * Text, LangChain messages, or JSON state to evaluate. Messages are sent as a native
+ * conversation; JSON objects, which may contain messages, as an `input_json` part.
+ */
+export type DecisionInput = string | BaseMessage | BaseMessage[] | Record<string, unknown> | Record<string, unknown>[];
+/** One Decisions request: what to evaluate and the named questions to ask. */
+export interface DecisionRequest<Q extends Questions = Questions> {
+  input: DecisionInput;
+  questions: Q;
+}
+export interface DecisionResult<Q extends Questions = Questions> {
+  answers: Answers<Q>;
+  /** The model that answered, as reported by the API. */
+  model: string;
+  requestId?: string;
+  /** Read by LangSmith to record token usage on the traced run. */
+  usage_metadata: UsageMetadata;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":["OpenAIClient"],"sources":["../../src/decisions/types.ts"],"mappings":";;;iBAMiB;EACf;EACA;;;iBAIe,OAAO;EACtB;EACA;EACA,SAAS,OAAO;;;YAIN,QAAQA,OAAa,qBAAqB,mBAAmB;;iBAGxD;EACf;EACA;EACA,2BAA2B;;YAGjB,WAAW,YAAY,SAAS;YAEhC,YAAY,eAAe;YAE3B,kBAAkB,KAC5BA,OAAa,SAAS;YAIZ,aAAa,6BAA6B,KACpDA,OAAa,SAAS;EAGtB,QAAQ;EACR;IAAiB,OAAO;IAAG;;;;YAIjB,cAAc,KACxBA,OAAa,SAAS;YAIZ,gBAAgB,KAC1BA,OAAa,SAAS;YAIZ,SACR,kBACA,eACA,cACA;;YAGQ,UAAU,UAAU,YAAY,UAAU,YAClD,kBACA,UAAU,SACR,aAAa,cAAc,yBAC3B,UAAU,QACR;;YAII,QAAQ,UAAU,0BACjB,WAAW,IAAI,UAAU,EAAE,MAAM;;;;;YAOlC,yBAER,cACA,gBACA,0BACA;;iBAGa,gBAAgB,UAAU,YAAY;EACrD,OAAO;EACP,WAAW;;iBAGI,eAAe,UAAU,YAAY;EACpD,SAAS,QAAQ;;EAEjB;EACA;;EAEA,gBAAgB"}