@langchain/openai 1.6.1 → 1.6.3

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

@@ -1 +1 @@
-{"version":3,"file":"shell.d.ts","names":[],"sources":["../../src/tools/shell.ts"],"mappings":";;;;;;;;KAQY,cACV,OAAa,UAAU,8BAA8B;cAG1C,mBAAiB,EAAA;;;;GAY5B,EAAA,KAAA;;;;;KAMU,qBACV,OAAa,UAAU;;;;KAKb,mBAAmB;;;;;UAMd;;;;;EAKf,QAAQ;;;;;EAKR;;;;;UAMe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCf,UAAU,QAAQ,gBAAgB,cAAc,QAAQ;;;;;KAM9C,YAAY,OAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqI/B,MAAM,SAAS,eAyBT,6BACX,mBACP"}
+{"version":3,"file":"shell.d.ts","names":["OpenAIClient"],"sources":["../../src/tools/shell.ts"],"mappings":";;;;;;;;YAQY,cACVA,OAAa,UAAU,8BAA8B;qBAG1C,mBAAiB,EAAA;;;;GAY5B,EAAA,KAAA;;;;;YAMU,qBACVA,OAAa,UAAU;;;;YAKb,mBAAmB;;;;;iBAMd;;;;;EAKf,QAAQ;;;;;EAKR;;;;;iBAMe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCf,UAAU,QAAQ,gBAAgB,cAAc,QAAQ;;;;;YAM9C,YAAYA,OAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqI/B,MAAM,SAAS,eAyBT,6BACX,mBACP"}

package/dist/tools/toolSearch.d.cts

@@ -1,7 +1,7 @@
 import { OpenAI } from "openai";
 import { ServerTool } from "@langchain/core/tools";
 //#region src/tools/toolSearch.d.ts
-interface ToolSearchOptions {
+export interface ToolSearchOptions {
   /**
    * Whether tool search is executed by the server or by the client.
    * - `"server"` (default): OpenAI's servers handle the search internally.
@@ -17,7 +17,7 @@ interface ToolSearchOptions {
    */
   parameters?: unknown;
 }
-type ToolSearchTool = OpenAI.Responses.ToolSearchTool;
+export type ToolSearchTool = OpenAI.Responses.ToolSearchTool;
 /**
  * Creates a tool search tool that enables OpenAI models to dynamically discover
  * and load tools on-demand from a large pool, rather than requiring all tool
@@ -72,7 +72,6 @@ type ToolSearchTool = OpenAI.Responses.ToolSearchTool;
  * });
  * ```
  */
-declare function toolSearch(options?: ToolSearchOptions): ServerTool;
+export declare function toolSearch(options?: ToolSearchOptions): ServerTool;
 //#endregion
-export { ToolSearchOptions, ToolSearchTool, toolSearch };
 //# sourceMappingURL=toolSearch.d.cts.map

package/dist/tools/toolSearch.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"toolSearch.d.cts","names":[],"sources":["../../src/tools/toolSearch.ts"],"mappings":";;;UAGiB;;;;;;EAMf;;;;EAIA;;;;EAIA;;KAGU,iBAAiB,OAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwDpC,WAAW,UAAU,oBAAoB"}
+{"version":3,"file":"toolSearch.d.cts","names":["OpenAIClient"],"sources":["../../src/tools/toolSearch.ts"],"mappings":";;;iBAGiB;;;;;;EAMf;;;;EAIA;;;;EAIA;;YAGU,iBAAiBA,OAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAwDpC,WAAW,UAAU,oBAAoB"}

package/dist/tools/toolSearch.d.ts

@@ -1,7 +1,7 @@
 import { OpenAI } from "openai";
 import { ServerTool } from "@langchain/core/tools";
 //#region src/tools/toolSearch.d.ts
-interface ToolSearchOptions {
+export interface ToolSearchOptions {
   /**
    * Whether tool search is executed by the server or by the client.
    * - `"server"` (default): OpenAI's servers handle the search internally.
@@ -17,7 +17,7 @@ interface ToolSearchOptions {
    */
   parameters?: unknown;
 }
-type ToolSearchTool = OpenAI.Responses.ToolSearchTool;
+export type ToolSearchTool = OpenAI.Responses.ToolSearchTool;
 /**
  * Creates a tool search tool that enables OpenAI models to dynamically discover
  * and load tools on-demand from a large pool, rather than requiring all tool
@@ -72,7 +72,6 @@ type ToolSearchTool = OpenAI.Responses.ToolSearchTool;
  * });
  * ```
  */
-declare function toolSearch(options?: ToolSearchOptions): ServerTool;
+export declare function toolSearch(options?: ToolSearchOptions): ServerTool;
 //#endregion
-export { ToolSearchOptions, ToolSearchTool, toolSearch };
 //# sourceMappingURL=toolSearch.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"toolSearch.d.ts","names":[],"sources":["../../src/tools/toolSearch.ts"],"mappings":";;;UAGiB;;;;;;EAMf;;;;EAIA;;;;EAIA;;KAGU,iBAAiB,OAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwDpC,WAAW,UAAU,oBAAoB"}
+{"version":3,"file":"toolSearch.d.ts","names":["OpenAIClient"],"sources":["../../src/tools/toolSearch.ts"],"mappings":";;;iBAGiB;;;;;;EAMf;;;;EAIA;;;;EAIA;;YAGU,iBAAiBA,OAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAwDpC,WAAW,UAAU,oBAAoB"}

package/dist/tools/webSearch.d.cts

@@ -4,7 +4,7 @@ import { ServerTool } from "@langchain/core/tools";
 /**
  * User location configuration for geographic search refinement.
  */
-interface WebSearchUserLocation {
+export interface WebSearchUserLocation {
   /**
    * The type of location. Currently only "approximate" is supported.
    */
@@ -31,7 +31,7 @@ interface WebSearchUserLocation {
 /**
  * Domain filtering configuration for web search.
  */
-interface WebSearchFilters {
+export interface WebSearchFilters {
   /**
    * Allow-list of up to 100 domains to limit search results.
    * Omit the HTTP/HTTPS prefix (e.g., "openai.com" instead of "https://openai.com/").
@@ -42,7 +42,7 @@ interface WebSearchFilters {
 /**
  * Options for the OpenAI web search tool.
  */
-interface WebSearchOptions {
+export interface WebSearchOptions {
   /**
    * Domain filtering configuration.
    * Limit results to a specific set of up to 100 domains.
@@ -62,7 +62,7 @@ interface WebSearchOptions {
 /**
  * OpenAI web search tool type for the Responses API.
  */
-type WebSearchTool = OpenAI.Responses.WebSearchTool;
+export type WebSearchTool = OpenAI.Responses.WebSearchTool;
 /**
  * Creates a web search tool that allows OpenAI models to search the web
  * for up-to-date information before generating a response.
@@ -122,7 +122,6 @@ type WebSearchTool = OpenAI.Responses.WebSearchTool;
  * });
  * ```
  */
-declare function webSearch(options?: WebSearchOptions): ServerTool;
+export declare function webSearch(options?: WebSearchOptions): ServerTool;
 //#endregion
-export { WebSearchFilters, WebSearchOptions, WebSearchTool, WebSearchUserLocation, webSearch };
 //# sourceMappingURL=webSearch.d.cts.map

package/dist/tools/webSearch.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"webSearch.d.cts","names":[],"sources":["../../src/tools/webSearch.ts"],"mappings":";;;;;;UAMiB;;;;EAIf;;;;;EAKA;;;;EAIA;;;;EAIA;;;;;EAKA;;;;;UAMe;;;;;;EAMf;;;;;UAMe;;;;;EAKf,UAAU;;;;;EAKV,eAAe;;;;;EAKf;;;;;KAMU,gBAAgB,OAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6DnC,UAAU,UAAU,mBAAmB"}
+{"version":3,"file":"webSearch.d.cts","names":["OpenAIClient"],"sources":["../../src/tools/webSearch.ts"],"mappings":";;;;;;iBAMiB;;;;EAIf;;;;;EAKA;;;;EAIA;;;;EAIA;;;;;EAKA;;;;;iBAMe;;;;;;EAMf;;;;;iBAMe;;;;;EAKf,UAAU;;;;;EAKV,eAAe;;;;;EAKf;;;;;YAMU,gBAAgBA,OAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA6DnC,UAAU,UAAU,mBAAmB"}

package/dist/tools/webSearch.d.ts

@@ -4,7 +4,7 @@ import { ServerTool } from "@langchain/core/tools";
 /**
  * User location configuration for geographic search refinement.
  */
-interface WebSearchUserLocation {
+export interface WebSearchUserLocation {
   /**
    * The type of location. Currently only "approximate" is supported.
    */
@@ -31,7 +31,7 @@ interface WebSearchUserLocation {
 /**
  * Domain filtering configuration for web search.
  */
-interface WebSearchFilters {
+export interface WebSearchFilters {
   /**
    * Allow-list of up to 100 domains to limit search results.
    * Omit the HTTP/HTTPS prefix (e.g., "openai.com" instead of "https://openai.com/").
@@ -42,7 +42,7 @@ interface WebSearchFilters {
 /**
  * Options for the OpenAI web search tool.
  */
-interface WebSearchOptions {
+export interface WebSearchOptions {
   /**
    * Domain filtering configuration.
    * Limit results to a specific set of up to 100 domains.
@@ -62,7 +62,7 @@ interface WebSearchOptions {
 /**
  * OpenAI web search tool type for the Responses API.
  */
-type WebSearchTool = OpenAI.Responses.WebSearchTool;
+export type WebSearchTool = OpenAI.Responses.WebSearchTool;
 /**
  * Creates a web search tool that allows OpenAI models to search the web
  * for up-to-date information before generating a response.
@@ -122,7 +122,6 @@ type WebSearchTool = OpenAI.Responses.WebSearchTool;
  * });
  * ```
  */
-declare function webSearch(options?: WebSearchOptions): ServerTool;
+export declare function webSearch(options?: WebSearchOptions): ServerTool;
 //#endregion
-export { WebSearchFilters, WebSearchOptions, WebSearchTool, WebSearchUserLocation, webSearch };
 //# sourceMappingURL=webSearch.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"webSearch.d.ts","names":[],"sources":["../../src/tools/webSearch.ts"],"mappings":";;;;;;UAMiB;;;;EAIf;;;;;EAKA;;;;EAIA;;;;EAIA;;;;;EAKA;;;;;UAMe;;;;;;EAMf;;;;;UAMe;;;;;EAKf,UAAU;;;;;EAKV,eAAe;;;;;EAKf;;;;;KAMU,gBAAgB,OAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6DnC,UAAU,UAAU,mBAAmB"}
+{"version":3,"file":"webSearch.d.ts","names":["OpenAIClient"],"sources":["../../src/tools/webSearch.ts"],"mappings":";;;;;;iBAMiB;;;;EAIf;;;;;EAKA;;;;EAIA;;;;EAIA;;;;;EAKA;;;;;iBAMe;;;;;;EAMf;;;;;iBAMe;;;;;EAKf,UAAU;;;;;EAKV,eAAe;;;;;EAKf;;;;;YAMU,gBAAgBA,OAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA6DnC,UAAU,UAAU,mBAAmB"}

package/dist/types.d.cts

@@ -7,12 +7,12 @@ import { TiktokenModel } from "js-tiktoken/lite";
 /**
  * @see https://platform.openai.com/docs/models
  */
-type OpenAIChatModelId = OpenAI.ChatModel | (string & NonNullable<unknown>);
-type OpenAIVerbosityParam = "low" | "medium" | "high" | null;
-type OpenAICacheRetentionParam = "in_memory" | "in-memory" | "24h" | null;
-type OpenAIPromptCacheOptions = OpenAI.Responses.ResponseCreateParams["prompt_cache_options"];
-type OpenAIApiKey = ClientOptions["apiKey"];
-declare interface OpenAIBaseInput {
+export type OpenAIChatModelId = OpenAI.ChatModel | (string & NonNullable<unknown>);
+export type OpenAIVerbosityParam = "low" | "medium" | "high" | null;
+export type OpenAICacheRetentionParam = "in_memory" | "in-memory" | "24h" | null;
+export type OpenAIPromptCacheOptions = OpenAI.Responses.ResponseCreateParams["prompt_cache_options"];
+export type OpenAIApiKey = ClientOptions["apiKey"];
+export declare interface OpenAIBaseInput {
   /** Sampling temperature to use */
   temperature: number;
   /**
@@ -85,8 +85,8 @@ declare interface OpenAIBaseInput {
    */
   verbosity?: OpenAIVerbosityParam;
 }
-type OpenAICoreRequestOptions = OpenAI.RequestOptions;
-interface OpenAICallOptions extends BaseLanguageModelCallOptions {
+export type OpenAICoreRequestOptions = OpenAI.RequestOptions;
+export interface OpenAICallOptions extends BaseLanguageModelCallOptions {
   /**
    * Additional options to pass to the underlying axios request.
    */
@@ -95,13 +95,13 @@ interface OpenAICallOptions extends BaseLanguageModelCallOptions {
 /**
  * Input to OpenAI class.
  */
-declare interface OpenAIInput extends OpenAIBaseInput {
+export declare interface OpenAIInput extends OpenAIBaseInput {
   /** Generates `bestOf` completions server side and returns the "best" */
   bestOf?: number;
   /** Batch size to use when passing multiple documents to generate */
   batchSize: number;
 }
-interface OpenAIChatInput extends OpenAIBaseInput {
+export interface OpenAIChatInput extends OpenAIBaseInput {
   /**
    * Whether to return log probabilities of the output tokens or not.
    * If true, returns the log probabilities of each output token returned in the content of message.
@@ -177,7 +177,7 @@ interface OpenAIChatInput extends OpenAIBaseInput {
    */
   promptCacheOptions?: OpenAIPromptCacheOptions;
 }
-interface AzureOpenAIInput {
+export interface AzureOpenAIInput {
   /**
    * API version to use when making requests to Azure OpenAI.
    */
@@ -235,7 +235,7 @@ interface AzureOpenAIInput {
    */
   azureADTokenProvider?: () => Promise<string>;
 }
-interface AzureOpenAIChatInput extends OpenAIChatInput, AzureOpenAIInput {
+export interface AzureOpenAIChatInput extends OpenAIChatInput, AzureOpenAIInput {
   openAIApiVersion?: string;
   openAIBasePath?: string;
   deploymentName?: string;
@@ -252,7 +252,7 @@ type ChatOpenAIResponseFormatJSONSchema = Omit<ResponseFormatJSONSchema, "json_s
 /**
  * The summary of a model's reasoning step.
  */
-type ChatOpenAIReasoningSummary = Omit<OpenAI.Responses.ResponseReasoningItem, "summary"> & {
+export type ChatOpenAIReasoningSummary = Omit<OpenAI.Responses.ResponseReasoningItem, "summary"> & {
   /**
    * The summary of the reasoning step. The index field will be populated if the response was
    * streamed. This allows LangChain to recompose the reasoning summary output correctly when the
@@ -262,8 +262,8 @@ type ChatOpenAIReasoningSummary = Omit<OpenAI.Responses.ResponseReasoningItem, "
     index?: number;
   }>;
 };
-type ChatOpenAIResponseFormat = ResponseFormatText | ResponseFormatJSONObject | ResponseFormatTextGrammar | ResponseFormatTextPython | ChatOpenAIResponseFormatJSONSchema;
-type ResponseFormatConfiguration = ResponseFormatText | ResponseFormatJSONObject | ResponseFormatJSONSchema;
+export type ChatOpenAIResponseFormat = ResponseFormatText | ResponseFormatJSONObject | ResponseFormatTextGrammar | ResponseFormatTextPython | ChatOpenAIResponseFormatJSONSchema;
+export type ResponseFormatConfiguration = ResponseFormatText | ResponseFormatJSONObject | ResponseFormatJSONSchema;
 //#endregion
-export { AzureOpenAIChatInput, AzureOpenAIInput, ChatOpenAIReasoningSummary, ChatOpenAIResponseFormat, OpenAIApiKey, OpenAIBaseInput, OpenAICacheRetentionParam, OpenAICallOptions, OpenAIChatInput, OpenAIChatModelId, OpenAICoreRequestOptions, OpenAIInput, OpenAIPromptCacheOptions, OpenAIVerbosityParam, ResponseFormatConfiguration, type TiktokenModel };
+export type { TiktokenModel };
 //# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;;;KAoBY,oBACR,OAAa,sBACH;KAEF;KAEA;KAKA,2BACV,OAAa,UAAU;KAEb,eAAe;kBAEF;;EAEvB;;;;;EAMA;;;;;;EAOA;;EAGA;;EAGA;;EAGA;;EAGA;;EAGA,YAAY;;EAGZ;;EAGA;;;;;EAMA;;;;;;EAOA;;EAGA,OAAO;;;;;EAOP,cAAc;;;;;EAMd;;EAEA;;;;EAKA;;;;;;EAOA,eAAe;;;;;EAKf,SAAS;;;;EAKT,YAAY;;KAGF,2BAA2B,OAAa;UAEnC,0BAA0B;;;;EAIzC,UAAU;;;;;kBAMa,oBAAoB;;EAE3C;;EAGA;;UAGe,wBAAwB;;;;;EAKvC;;;;;EAMA;;EAGA,iBAAiB,OAAa,KAAK;;;;;EAMnC;;;;;EAMA;;;;;;;;;;;;;EAcA,aAAa,MAAM,OAAa,KAAK;;;;;;EAOrC,QAAQ,OAAa,KAAK;;;;;;;EAQ1B,YAAY,OAAa;;;;;;;EAQzB;;;;;EAMA,eAAe,OAAa,UAAU;;;;;;EAOtC;;;;EAKA,uBAAuB;;;;EAKvB,qBAAqB;;UAGN;;;;EAIf;;;;EAKA;;;;;;;EAQA;;;;;;;EAQA;;;;;;;;EASA;;;;;;;;;EAUA;;;;;;EAOA;;;;;;EAOA;;;;;EAMA,6BAA6B;;UAGd,6BACP,iBAAiB;EACzB;EACA;EACA;;KAGG,qCAAqC,KACxC;EAGA,aAAa,KAAK;;;;;IAMhB,QAAQ,sBAAsB;;;;;;KAOtB,6BAA6B,KACvC,OAAa,UAAU;;;;;;EAQvB,SAAS,MACP,OAAa,UAAU,sBAAsB;IAAY;;;KAIjD,2BACR,qBACA,2BACA,4BACA,2BACA;KAEQ,8BACR,qBACA,2BACA"}
+{"version":3,"file":"types.d.cts","names":["OpenAIClient"],"sources":["../src/types.ts"],"mappings":";;;;;;;;;YAoBY,oBACRA,OAAa,sBACH;YAEF;YAEA;YAKA,2BACVA,OAAa,UAAU;YAEb,eAAe;yBAEF;;EAEvB;;;;;EAMA;;;;;;EAOA;;EAGA;;EAGA;;EAGA;;EAGA;;EAGA,YAAY;;EAGZ;;EAGA;;;;;EAMA;;;;;;EAOA;;EAGA,OAAO;;;;;EAOP,cAAc;;;;;EAMd;;EAEA;;;;EAKA;;;;;;EAOA,eAAe;;;;;EAKf,SAAS;;;;EAKT,YAAY;;YAGF,2BAA2BA,OAAa;iBAEnC,0BAA0B;;;;EAIzC,UAAU;;;;;yBAMa,oBAAoB;;EAE3C;;EAGA;;iBAGe,wBAAwB;;;;;EAKvC;;;;;EAMA;;EAGA,iBAAiBA,OAAa,KAAK;;;;;EAMnC;;;;;EAMA;;;;;;;;;;;;;EAcA,aAAa,MAAMA,OAAa,KAAK;;;;;;EAOrC,QAAQA,OAAa,KAAK;;;;;;;EAQ1B,YAAYA,OAAa;;;;;;;EAQzB;;;;;EAMA,eAAeA,OAAa,UAAU;;;;;;EAOtC;;;;EAKA,uBAAuB;;;;EAKvB,qBAAqB;;iBAGN;;;;EAIf;;;;EAKA;;;;;;;EAQA;;;;;;;EAQA;;;;;;;;EASA;;;;;;;;;EAUA;;;;;;EAOA;;;;;;EAOA;;;;;EAMA,6BAA6B;;iBAGd,6BACP,iBAAiB;EACzB;EACA;EACA;;KAGG,qCAAqC,KACxC;EAGA,aAAa,KAAK;;;;;IAMhB,QAAQ,sBAAsB;;;;;;YAOtB,6BAA6B,KACvCA,OAAa,UAAU;;;;;;EAQvB,SAAS,MACPA,OAAa,UAAU,sBAAsB;IAAY;;;YAIjD,2BACR,qBACA,2BACA,4BACA,2BACA;YAEQ,8BACR,qBACA,2BACA"}

package/dist/types.d.ts

@@ -7,12 +7,12 @@ import { TiktokenModel } from "js-tiktoken/lite";
 /**
  * @see https://platform.openai.com/docs/models
  */
-type OpenAIChatModelId = OpenAI.ChatModel | (string & NonNullable<unknown>);
-type OpenAIVerbosityParam = "low" | "medium" | "high" | null;
-type OpenAICacheRetentionParam = "in_memory" | "in-memory" | "24h" | null;
-type OpenAIPromptCacheOptions = OpenAI.Responses.ResponseCreateParams["prompt_cache_options"];
-type OpenAIApiKey = ClientOptions["apiKey"];
-declare interface OpenAIBaseInput {
+export type OpenAIChatModelId = OpenAI.ChatModel | (string & NonNullable<unknown>);
+export type OpenAIVerbosityParam = "low" | "medium" | "high" | null;
+export type OpenAICacheRetentionParam = "in_memory" | "in-memory" | "24h" | null;
+export type OpenAIPromptCacheOptions = OpenAI.Responses.ResponseCreateParams["prompt_cache_options"];
+export type OpenAIApiKey = ClientOptions["apiKey"];
+export declare interface OpenAIBaseInput {
   /** Sampling temperature to use */
   temperature: number;
   /**
@@ -85,8 +85,8 @@ declare interface OpenAIBaseInput {
    */
   verbosity?: OpenAIVerbosityParam;
 }
-type OpenAICoreRequestOptions = OpenAI.RequestOptions;
-interface OpenAICallOptions extends BaseLanguageModelCallOptions {
+export type OpenAICoreRequestOptions = OpenAI.RequestOptions;
+export interface OpenAICallOptions extends BaseLanguageModelCallOptions {
   /**
    * Additional options to pass to the underlying axios request.
    */
@@ -95,13 +95,13 @@ interface OpenAICallOptions extends BaseLanguageModelCallOptions {
 /**
  * Input to OpenAI class.
  */
-declare interface OpenAIInput extends OpenAIBaseInput {
+export declare interface OpenAIInput extends OpenAIBaseInput {
   /** Generates `bestOf` completions server side and returns the "best" */
   bestOf?: number;
   /** Batch size to use when passing multiple documents to generate */
   batchSize: number;
 }
-interface OpenAIChatInput extends OpenAIBaseInput {
+export interface OpenAIChatInput extends OpenAIBaseInput {
   /**
    * Whether to return log probabilities of the output tokens or not.
    * If true, returns the log probabilities of each output token returned in the content of message.
@@ -177,7 +177,7 @@ interface OpenAIChatInput extends OpenAIBaseInput {
    */
   promptCacheOptions?: OpenAIPromptCacheOptions;
 }
-interface AzureOpenAIInput {
+export interface AzureOpenAIInput {
   /**
    * API version to use when making requests to Azure OpenAI.
    */
@@ -235,7 +235,7 @@ interface AzureOpenAIInput {
    */
   azureADTokenProvider?: () => Promise<string>;
 }
-interface AzureOpenAIChatInput extends OpenAIChatInput, AzureOpenAIInput {
+export interface AzureOpenAIChatInput extends OpenAIChatInput, AzureOpenAIInput {
   openAIApiVersion?: string;
   openAIBasePath?: string;
   deploymentName?: string;
@@ -252,7 +252,7 @@ type ChatOpenAIResponseFormatJSONSchema = Omit<ResponseFormatJSONSchema, "json_s
 /**
  * The summary of a model's reasoning step.
  */
-type ChatOpenAIReasoningSummary = Omit<OpenAI.Responses.ResponseReasoningItem, "summary"> & {
+export type ChatOpenAIReasoningSummary = Omit<OpenAI.Responses.ResponseReasoningItem, "summary"> & {
   /**
    * The summary of the reasoning step. The index field will be populated if the response was
    * streamed. This allows LangChain to recompose the reasoning summary output correctly when the
@@ -262,8 +262,8 @@ type ChatOpenAIReasoningSummary = Omit<OpenAI.Responses.ResponseReasoningItem, "
     index?: number;
   }>;
 };
-type ChatOpenAIResponseFormat = ResponseFormatText | ResponseFormatJSONObject | ResponseFormatTextGrammar | ResponseFormatTextPython | ChatOpenAIResponseFormatJSONSchema;
-type ResponseFormatConfiguration = ResponseFormatText | ResponseFormatJSONObject | ResponseFormatJSONSchema;
+export type ChatOpenAIResponseFormat = ResponseFormatText | ResponseFormatJSONObject | ResponseFormatTextGrammar | ResponseFormatTextPython | ChatOpenAIResponseFormatJSONSchema;
+export type ResponseFormatConfiguration = ResponseFormatText | ResponseFormatJSONObject | ResponseFormatJSONSchema;
 //#endregion
-export { AzureOpenAIChatInput, AzureOpenAIInput, ChatOpenAIReasoningSummary, ChatOpenAIResponseFormat, OpenAIApiKey, OpenAIBaseInput, OpenAICacheRetentionParam, OpenAICallOptions, OpenAIChatInput, OpenAIChatModelId, OpenAICoreRequestOptions, OpenAIInput, OpenAIPromptCacheOptions, OpenAIVerbosityParam, ResponseFormatConfiguration, type TiktokenModel };
+export type { TiktokenModel };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;;;KAoBY,oBACR,OAAa,sBACH;KAEF;KAEA;KAKA,2BACV,OAAa,UAAU;KAEb,eAAe;kBAEF;;EAEvB;;;;;EAMA;;;;;;EAOA;;EAGA;;EAGA;;EAGA;;EAGA;;EAGA,YAAY;;EAGZ;;EAGA;;;;;EAMA;;;;;;EAOA;;EAGA,OAAO;;;;;EAOP,cAAc;;;;;EAMd;;EAEA;;;;EAKA;;;;;;EAOA,eAAe;;;;;EAKf,SAAS;;;;EAKT,YAAY;;KAGF,2BAA2B,OAAa;UAEnC,0BAA0B;;;;EAIzC,UAAU;;;;;kBAMa,oBAAoB;;EAE3C;;EAGA;;UAGe,wBAAwB;;;;;EAKvC;;;;;EAMA;;EAGA,iBAAiB,OAAa,KAAK;;;;;EAMnC;;;;;EAMA;;;;;;;;;;;;;EAcA,aAAa,MAAM,OAAa,KAAK;;;;;;EAOrC,QAAQ,OAAa,KAAK;;;;;;;EAQ1B,YAAY,OAAa;;;;;;;EAQzB;;;;;EAMA,eAAe,OAAa,UAAU;;;;;;EAOtC;;;;EAKA,uBAAuB;;;;EAKvB,qBAAqB;;UAGN;;;;EAIf;;;;EAKA;;;;;;;EAQA;;;;;;;EAQA;;;;;;;;EASA;;;;;;;;;EAUA;;;;;;EAOA;;;;;;EAOA;;;;;EAMA,6BAA6B;;UAGd,6BACP,iBAAiB;EACzB;EACA;EACA;;KAGG,qCAAqC,KACxC;EAGA,aAAa,KAAK;;;;;IAMhB,QAAQ,sBAAsB;;;;;;KAOtB,6BAA6B,KACvC,OAAa,UAAU;;;;;;EAQvB,SAAS,MACP,OAAa,UAAU,sBAAsB;IAAY;;;KAIjD,2BACR,qBACA,2BACA,4BACA,2BACA;KAEQ,8BACR,qBACA,2BACA"}
+{"version":3,"file":"types.d.ts","names":["OpenAIClient"],"sources":["../src/types.ts"],"mappings":";;;;;;;;;YAoBY,oBACRA,OAAa,sBACH;YAEF;YAEA;YAKA,2BACVA,OAAa,UAAU;YAEb,eAAe;yBAEF;;EAEvB;;;;;EAMA;;;;;;EAOA;;EAGA;;EAGA;;EAGA;;EAGA;;EAGA,YAAY;;EAGZ;;EAGA;;;;;EAMA;;;;;;EAOA;;EAGA,OAAO;;;;;EAOP,cAAc;;;;;EAMd;;EAEA;;;;EAKA;;;;;;EAOA,eAAe;;;;;EAKf,SAAS;;;;EAKT,YAAY;;YAGF,2BAA2BA,OAAa;iBAEnC,0BAA0B;;;;EAIzC,UAAU;;;;;yBAMa,oBAAoB;;EAE3C;;EAGA;;iBAGe,wBAAwB;;;;;EAKvC;;;;;EAMA;;EAGA,iBAAiBA,OAAa,KAAK;;;;;EAMnC;;;;;EAMA;;;;;;;;;;;;;EAcA,aAAa,MAAMA,OAAa,KAAK;;;;;;EAOrC,QAAQA,OAAa,KAAK;;;;;;;EAQ1B,YAAYA,OAAa;;;;;;;EAQzB;;;;;EAMA,eAAeA,OAAa,UAAU;;;;;;EAOtC;;;;EAKA,uBAAuB;;;;EAKvB,qBAAqB;;iBAGN;;;;EAIf;;;;EAKA;;;;;;;EAQA;;;;;;;EAQA;;;;;;;;EASA;;;;;;;;;EAUA;;;;;;EAOA;;;;;;EAOA;;;;;EAMA,6BAA6B;;iBAGd,6BACP,iBAAiB;EACzB;EACA;EACA;;KAGG,qCAAqC,KACxC;EAGA,aAAa,KAAK;;;;;IAMhB,QAAQ,sBAAsB;;;;;;YAOtB,6BAA6B,KACvCA,OAAa,UAAU;;;;;;EAQvB,SAAS,MACPA,OAAa,UAAU,sBAAsB;IAAY;;;YAIjD,2BACR,qBACA,2BACA,4BACA,2BACA;YAEQ,8BACR,qBACA,2BACA"}

package/dist/utils/azure.d.cts

@@ -1,5 +1,5 @@
 //#region src/utils/azure.d.ts
-interface OpenAIEndpointConfig {
+export interface OpenAIEndpointConfig {
   azureOpenAIApiDeploymentName?: string;
   azureOpenAIApiInstanceName?: string;
   azureOpenAIApiKey?: string;
@@ -32,13 +32,13 @@ interface OpenAIEndpointConfig {
  *
  * @returns {string | undefined} The generated (Azure) OpenAI endpoint URL.
  */
-declare function getEndpoint(config: OpenAIEndpointConfig): string | null | undefined;
+export declare function getEndpoint(config: OpenAIEndpointConfig): string | null | undefined;
 type HeaderValue = string | undefined | null;
-type HeadersLike = Headers | readonly HeaderValue[][] | Record<string, HeaderValue | readonly HeaderValue[]> | undefined | null | {
+export type HeadersLike = Headers | readonly HeaderValue[][] | Record<string, HeaderValue | readonly HeaderValue[]> | undefined | null | {
   values: Headers;
   [key: string]: unknown;
 };
-declare function isHeaders(headers: unknown): headers is Headers;
+export declare function isHeaders(headers: unknown): headers is Headers;
 /**
  * Normalizes various header formats into a consistent Record format.
  *
@@ -68,9 +68,8 @@ declare function isHeaders(headers: unknown): headers is Headers;
  * const normalized3 = normalizeHeaders(headers3);
  * ```
  */
-declare function normalizeHeaders(headers: HeadersLike): Record<string, HeaderValue | readonly HeaderValue[]>;
-declare function getFormattedEnv(): string;
-declare function getHeadersWithUserAgent(headers: HeadersLike, isAzure?: boolean, version?: string): Record<string, string>;
+export declare function normalizeHeaders(headers: HeadersLike): Record<string, HeaderValue | readonly HeaderValue[]>;
+export declare function getFormattedEnv(): string;
+export declare function getHeadersWithUserAgent(headers: HeadersLike, isAzure?: boolean, version?: string): Record<string, string>;
 //#endregion
-export { HeadersLike, OpenAIEndpointConfig, getEndpoint, getFormattedEnv, getHeadersWithUserAgent, isHeaders, normalizeHeaders };
 //# sourceMappingURL=azure.d.cts.map

package/dist/utils/azure.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"azure.d.cts","names":[],"sources":["../../src/utils/azure.ts"],"mappings":";UAGiB;EACf;EACA;EACA;EACA,6BAA6B;EAC7B;EACA;EACA;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2Bc,YAAY,QAAQ;KA2C/B;KACO,cACR,mBACS,kBACT,eAAe,uBAAuB;EAIpC,QAAQ;GAAU;;iBAER,UAAU,mBAAmB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsCxC,iBACd,SAAS,cACR,eAAe,uBAAuB;iBAgCzB;iBAUA,wBACd,SAAS,aACT,mBACA,mBACC"}
+{"version":3,"file":"azure.d.cts","names":[],"sources":["../../src/utils/azure.ts"],"mappings":";iBAGiB;EACf;EACA;EACA;EACA,6BAA6B;EAC7B;EACA;EACA;;;;;;;;;;;;;;;;;;;;;;;;;;wBA2Bc,YAAY,QAAQ;KA2C/B;YACO,cACR,mBACS,kBACT,eAAe,uBAAuB;EAIpC,QAAQ;GAAU;;wBAER,UAAU,mBAAmB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAsCxC,iBACd,SAAS,cACR,eAAe,uBAAuB;wBAgCzB;wBAUA,wBACd,SAAS,aACT,mBACA,mBACC"}

package/dist/utils/azure.d.ts

@@ -1,5 +1,5 @@
 //#region src/utils/azure.d.ts
-interface OpenAIEndpointConfig {
+export interface OpenAIEndpointConfig {
   azureOpenAIApiDeploymentName?: string;
   azureOpenAIApiInstanceName?: string;
   azureOpenAIApiKey?: string;
@@ -32,13 +32,13 @@ interface OpenAIEndpointConfig {
  *
  * @returns {string | undefined} The generated (Azure) OpenAI endpoint URL.
  */
-declare function getEndpoint(config: OpenAIEndpointConfig): string | null | undefined;
+export declare function getEndpoint(config: OpenAIEndpointConfig): string | null | undefined;
 type HeaderValue = string | undefined | null;
-type HeadersLike = Headers | readonly HeaderValue[][] | Record<string, HeaderValue | readonly HeaderValue[]> | undefined | null | {
+export type HeadersLike = Headers | readonly HeaderValue[][] | Record<string, HeaderValue | readonly HeaderValue[]> | undefined | null | {
   values: Headers;
   [key: string]: unknown;
 };
-declare function isHeaders(headers: unknown): headers is Headers;
+export declare function isHeaders(headers: unknown): headers is Headers;
 /**
  * Normalizes various header formats into a consistent Record format.
  *
@@ -68,9 +68,8 @@ declare function isHeaders(headers: unknown): headers is Headers;
  * const normalized3 = normalizeHeaders(headers3);
  * ```
  */
-declare function normalizeHeaders(headers: HeadersLike): Record<string, HeaderValue | readonly HeaderValue[]>;
-declare function getFormattedEnv(): string;
-declare function getHeadersWithUserAgent(headers: HeadersLike, isAzure?: boolean, version?: string): Record<string, string>;
+export declare function normalizeHeaders(headers: HeadersLike): Record<string, HeaderValue | readonly HeaderValue[]>;
+export declare function getFormattedEnv(): string;
+export declare function getHeadersWithUserAgent(headers: HeadersLike, isAzure?: boolean, version?: string): Record<string, string>;
 //#endregion
-export { HeadersLike, OpenAIEndpointConfig, getEndpoint, getFormattedEnv, getHeadersWithUserAgent, isHeaders, normalizeHeaders };
 //# sourceMappingURL=azure.d.ts.map

package/dist/utils/azure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"azure.d.ts","names":[],"sources":["../../src/utils/azure.ts"],"mappings":";UAGiB;EACf;EACA;EACA;EACA,6BAA6B;EAC7B;EACA;EACA;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2Bc,YAAY,QAAQ;KA2C/B;KACO,cACR,mBACS,kBACT,eAAe,uBAAuB;EAIpC,QAAQ;GAAU;;iBAER,UAAU,mBAAmB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsCxC,iBACd,SAAS,cACR,eAAe,uBAAuB;iBAgCzB;iBAUA,wBACd,SAAS,aACT,mBACA,mBACC"}
+{"version":3,"file":"azure.d.ts","names":[],"sources":["../../src/utils/azure.ts"],"mappings":";iBAGiB;EACf;EACA;EACA;EACA,6BAA6B;EAC7B;EACA;EACA;;;;;;;;;;;;;;;;;;;;;;;;;;wBA2Bc,YAAY,QAAQ;KA2C/B;YACO,cACR,mBACS,kBACT,eAAe,uBAAuB;EAIpC,QAAQ;GAAU;;wBAER,UAAU,mBAAmB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAsCxC,iBACd,SAAS,cACR,eAAe,uBAAuB;wBAgCzB;wBAUA,wBACd,SAAS,aACT,mBACA,mBACC"}

package/dist/utils/client.d.cts

@@ -1,5 +1,4 @@
 //#region src/utils/client.d.ts
-declare function wrapOpenAIClientError(e: unknown): any;
+export declare function wrapOpenAIClientError(e: unknown): any;
 //#endregion
-export { wrapOpenAIClientError };
 //# sourceMappingURL=client.d.cts.map

package/dist/utils/client.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.cts","names":[],"sources":["../../src/utils/client.ts"],"mappings":";iBAqBgB,sBAAsB"}
+{"version":3,"file":"client.d.cts","names":[],"sources":["../../src/utils/client.ts"],"mappings":";wBAqBgB,sBAAsB"}

package/dist/utils/client.d.ts

@@ -1,5 +1,4 @@
 //#region src/utils/client.d.ts
-declare function wrapOpenAIClientError(e: unknown): any;
+export declare function wrapOpenAIClientError(e: unknown): any;
 //#endregion
-export { wrapOpenAIClientError };
 //# sourceMappingURL=client.d.ts.map

package/dist/utils/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","names":[],"sources":["../../src/utils/client.ts"],"mappings":";iBAqBgB,sBAAsB"}
+{"version":3,"file":"client.d.ts","names":[],"sources":["../../src/utils/client.ts"],"mappings":";wBAqBgB,sBAAsB"}

package/dist/utils/misc.cjs

@@ -1,6 +1,30 @@
 let _langchain_core_messages = require("@langchain/core/messages");
 //#region src/utils/misc.ts
 const iife = (fn) => fn();
+/**
+* Returns the provider payload a content block carries: the `value` of a
+* `non_standard` wrapper, or the block itself.
+*/
+function unwrapNonStandard(block) {
+	if (block.type === "non_standard" && typeof block.value === "object" && block.value !== null) return block.value;
+	return block;
+}
+const ADDITIONAL_TOOLS_PLACEMENT_ERROR = "`additional_tools` must be carried on a `SystemMessage`. OpenAI restricts the input item to `role: \"developer\"`, so it cannot be sent on any other message.";
+const ADDITIONAL_TOOLS_TRANSPORT_ERROR = "`additional_tools` requires the Responses API and cannot be sent via Chat Completions. Set `useResponsesApi: true`.";
+/**
+* Throws if `message` carries an `additional_tools` block, in either spelling,
+* that cannot reach the wire.
+*
+* OpenAI takes `additional_tools` only as a Responses API input item with
+* `role: "developer"`, so only a `SystemMessage` sent via the Responses API
+* can carry it. Assistant messages are exempt: their content is replayed model
+* output, not an instruction from the caller.
+*/
+function assertAdditionalToolsPlacement(message, api) {
+	if (_langchain_core_messages.AIMessage.isInstance(message) || !Array.isArray(message.content) || !message.content.some((block) => unwrapNonStandard(block).type === "additional_tools")) return;
+	if (!_langchain_core_messages.SystemMessage.isInstance(message)) throw new Error(ADDITIONAL_TOOLS_PLACEMENT_ERROR);
+	if (api === "chat/completions") throw new Error(ADDITIONAL_TOOLS_TRANSPORT_ERROR);
+}
 function normalizePromptCacheRetention(retention) {
 	return retention === "in-memory" ? "in_memory" : retention;
 }
@@ -74,6 +98,7 @@ function _modelPrefersResponsesAPI(model) {
 exports.LC_AUTOGENERATED_FILENAME = LC_AUTOGENERATED_FILENAME;
 exports._modelPrefersResponsesAPI = _modelPrefersResponsesAPI;
 exports.applyPromptCacheBreakpoint = applyPromptCacheBreakpoint;
+exports.assertAdditionalToolsPlacement = assertAdditionalToolsPlacement;
 exports.extractGenericMessageCustomRole = extractGenericMessageCustomRole;
 exports.getFilenameFromMetadata = getFilenameFromMetadata;
 exports.getRequiredFilenameFromMetadata = getRequiredFilenameFromMetadata;
@@ -83,5 +108,6 @@ exports.isReasoningModel = isReasoningModel;
 exports.liftExtrasPromptCacheBreakpoint = liftExtrasPromptCacheBreakpoint;
 exports.messageToOpenAIRole = messageToOpenAIRole;
 exports.normalizePromptCacheRetention = normalizePromptCacheRetention;
+exports.unwrapNonStandard = unwrapNonStandard;
 
 //# sourceMappingURL=misc.cjs.map

package/dist/utils/misc.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"misc.cjs","names":["ChatMessage"],"sources":["../../src/utils/misc.ts"],"sourcesContent":["import type { OpenAI as OpenAIClient } from \"openai\";\nimport type { OpenAICacheRetentionParam } from \"../types.js\";\nimport {\n  BaseMessage,\n  ChatMessage,\n  ContentBlock,\n  Data,\n} from \"@langchain/core/messages\";\n\nexport const iife = <T>(fn: () => T) => fn();\n\nexport function normalizePromptCacheRetention(\n  retention: OpenAICacheRetentionParam | undefined\n): Exclude<OpenAICacheRetentionParam, \"in-memory\"> | undefined {\n  return retention === \"in-memory\" ? \"in_memory\" : retention;\n}\n\nexport function applyPromptCacheBreakpoint<T extends object>(\n  source: Record<string, unknown>,\n  target: T\n): T {\n  if (\"prompt_cache_breakpoint\" in source) {\n    return {\n      ...target,\n      prompt_cache_breakpoint: source.prompt_cache_breakpoint,\n    };\n  }\n  if (hasExtrasPromptCacheBreakpoint(source)) {\n    return {\n      ...target,\n      prompt_cache_breakpoint: source.extras.prompt_cache_breakpoint,\n    };\n  }\n  return target;\n}\n\nexport function hasExtrasPromptCacheBreakpoint(\n  block: Record<string, unknown>\n): block is { extras: { prompt_cache_breakpoint: unknown } } {\n  const { extras } = block;\n  return (\n    typeof extras === \"object\" &&\n    extras !== null &&\n    \"prompt_cache_breakpoint\" in extras\n  );\n}\n\nexport function liftExtrasPromptCacheBreakpoint<T extends object>(block: T): T {\n  const source = block as Record<string, unknown>;\n  if (!hasExtrasPromptCacheBreakpoint(source)) {\n    return block;\n  }\n  const { extras: _extras, ...rest } = source;\n  return applyPromptCacheBreakpoint(source, rest) as T;\n}\n\nexport function isReasoningModel(model?: string) {\n  if (!model) return false;\n  if (/^o\\d/.test(model ?? \"\")) return true;\n  if (model.startsWith(\"gpt-5\") && !model.startsWith(\"gpt-5-chat\")) return true;\n  if (model.startsWith(\"gpt-6\") && !model.startsWith(\"gpt-6-chat\")) return true;\n  return false;\n}\n\nexport function extractGenericMessageCustomRole(message: ChatMessage) {\n  if (\n    message.role !== \"system\" &&\n    message.role !== \"developer\" &&\n    message.role !== \"assistant\" &&\n    message.role !== \"user\" &&\n    message.role !== \"function\" &&\n    message.role !== \"tool\"\n  ) {\n    console.warn(`Unknown message role: ${message.role}`);\n  }\n\n  return message.role as OpenAIClient.ChatCompletionRole;\n}\n\nexport function getFilenameFromMetadata(\n  block:\n    | ContentBlock.Multimodal.File\n    | ContentBlock.Multimodal.Video\n    | Data.StandardFileBlock\n): string | undefined {\n  return (block.metadata?.filename ??\n    block.metadata?.name ??\n    block.metadata?.title) as string;\n}\n\nexport const LC_AUTOGENERATED_FILENAME = \"LC_AUTOGENERATED\";\n\nexport function getRequiredFilenameFromMetadata(\n  block:\n    | ContentBlock.Multimodal.File\n    | ContentBlock.Multimodal.Video\n    | Data.StandardFileBlock\n): string {\n  const filename = (block.metadata?.filename ??\n    block.metadata?.name ??\n    block.metadata?.title) as string;\n\n  if (!filename) {\n    console.warn(\n      \"OpenAI may require a filename for file uploads. Specify a filename \" +\n        \"in the content block metadata, e.g.: { type: 'file', mimeType: \" +\n        \"'...', data: '...', metadata: { filename: 'my-file.pdf' } }. \" +\n        \"Using placeholder filename 'LC_AUTOGENERATED'.\"\n    );\n    return LC_AUTOGENERATED_FILENAME;\n  }\n\n  return filename;\n}\nexport function messageToOpenAIRole(\n  message: BaseMessage\n): OpenAIClient.ChatCompletionRole {\n  const type = message._getType();\n  switch (type) {\n    case \"system\":\n      return \"system\";\n    case \"ai\":\n      return \"assistant\";\n    case \"human\":\n      return \"user\";\n    case \"function\":\n      return \"function\";\n    case \"tool\":\n      return \"tool\";\n    case \"generic\": {\n      if (!ChatMessage.isInstance(message))\n        throw new Error(\"Invalid generic chat message\");\n      return extractGenericMessageCustomRole(message);\n    }\n    default:\n      throw new Error(`Unknown message type: ${type}`);\n  }\n}\n\nexport function _modelPrefersResponsesAPI(model: string): boolean {\n  if (model.includes(\"gpt-5.2-pro\")) return true;\n  if (model.includes(\"gpt-5.4-pro\")) return true;\n  if (model.includes(\"gpt-5.5-pro\")) return true;\n  if (model.includes(\"gpt-5.6\")) return true;\n  // Codex models are Responses API only\n  if (model.includes(\"codex\")) return true;\n  return false;\n}\n"],"mappings":";;AASA,MAAa,QAAW,OAAgB,GAAG;AAE3C,SAAgB,8BACd,WAC6D;CAC7D,OAAO,cAAc,cAAc,cAAc;AACnD;AAEA,SAAgB,2BACd,QACA,QACG;CACH,IAAI,6BAA6B,QAC/B,OAAO;EACL,GAAG;EACH,yBAAyB,OAAO;CAClC;CAEF,IAAI,+BAA+B,MAAM,GACvC,OAAO;EACL,GAAG;EACH,yBAAyB,OAAO,OAAO;CACzC;CAEF,OAAO;AACT;AAEA,SAAgB,+BACd,OAC2D;CAC3D,MAAM,EAAE,WAAW;CACnB,OACE,OAAO,WAAW,YAClB,WAAW,QACX,6BAA6B;AAEjC;AAEA,SAAgB,gCAAkD,OAAa;CAC7E,MAAM,SAAS;CACf,IAAI,CAAC,+BAA+B,MAAM,GACxC,OAAO;CAET,MAAM,EAAE,QAAQ,SAAS,GAAG,SAAS;CACrC,OAAO,2BAA2B,QAAQ,IAAI;AAChD;AAEA,SAAgB,iBAAiB,OAAgB;CAC/C,IAAI,CAAC,OAAO,OAAO;CACnB,IAAI,OAAO,KAAK,SAAS,EAAE,GAAG,OAAO;CACrC,IAAI,MAAM,WAAW,OAAO,KAAK,CAAC,MAAM,WAAW,YAAY,GAAG,OAAO;CACzE,IAAI,MAAM,WAAW,OAAO,KAAK,CAAC,MAAM,WAAW,YAAY,GAAG,OAAO;CACzE,OAAO;AACT;AAEA,SAAgB,gCAAgC,SAAsB;CACpE,IACE,QAAQ,SAAS,YACjB,QAAQ,SAAS,eACjB,QAAQ,SAAS,eACjB,QAAQ,SAAS,UACjB,QAAQ,SAAS,cACjB,QAAQ,SAAS,QAEjB,QAAQ,KAAK,yBAAyB,QAAQ,MAAM;CAGtD,OAAO,QAAQ;AACjB;AAEA,SAAgB,wBACd,OAIoB;CACpB,OAAQ,MAAM,UAAU,YACtB,MAAM,UAAU,QAChB,MAAM,UAAU;AACpB;AAEA,MAAa,4BAA4B;AAEzC,SAAgB,gCACd,OAIQ;CACR,MAAM,WAAY,MAAM,UAAU,YAChC,MAAM,UAAU,QAChB,MAAM,UAAU;CAElB,IAAI,CAAC,UAAU;EACb,QAAQ,KACN,+OAIF;EACA,OAAO;CACT;CAEA,OAAO;AACT;AACA,SAAgB,oBACd,SACiC;CACjC,MAAM,OAAO,QAAQ,SAAS;CAC9B,QAAQ,MAAR;EACE,KAAK,UACH,OAAO;EACT,KAAK,MACH,OAAO;EACT,KAAK,SACH,OAAO;EACT,KAAK,YACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,KAAK;GACH,IAAI,CAACA,yBAAAA,YAAY,WAAW,OAAO,GACjC,MAAM,IAAI,MAAM,8BAA8B;GAChD,OAAO,gCAAgC,OAAO;EAEhD,SACE,MAAM,IAAI,MAAM,yBAAyB,MAAM;CACnD;AACF;AAEA,SAAgB,0BAA0B,OAAwB;CAChE,IAAI,MAAM,SAAS,aAAa,GAAG,OAAO;CAC1C,IAAI,MAAM,SAAS,aAAa,GAAG,OAAO;CAC1C,IAAI,MAAM,SAAS,aAAa,GAAG,OAAO;CAC1C,IAAI,MAAM,SAAS,SAAS,GAAG,OAAO;CAEtC,IAAI,MAAM,SAAS,OAAO,GAAG,OAAO;CACpC,OAAO;AACT"}
+{"version":3,"file":"misc.cjs","names":["AIMessage","SystemMessage","ChatMessage"],"sources":["../../src/utils/misc.ts"],"sourcesContent":["import type { OpenAI as OpenAIClient } from \"openai\";\nimport type { OpenAICacheRetentionParam } from \"../types.js\";\nimport {\n  AIMessage,\n  BaseMessage,\n  ChatMessage,\n  ContentBlock,\n  Data,\n  SystemMessage,\n} from \"@langchain/core/messages\";\n\nexport const iife = <T>(fn: () => T) => fn();\n\n/**\n * Returns the provider payload a content block carries: the `value` of a\n * `non_standard` wrapper, or the block itself.\n */\nexport function unwrapNonStandard(block: ContentBlock): ContentBlock {\n  if (\n    block.type === \"non_standard\" &&\n    typeof block.value === \"object\" &&\n    block.value !== null\n  ) {\n    return block.value as ContentBlock;\n  }\n  return block;\n}\n\nconst ADDITIONAL_TOOLS_PLACEMENT_ERROR =\n  \"`additional_tools` must be carried on a `SystemMessage`. OpenAI restricts \" +\n  'the input item to `role: \"developer\"`, so it cannot be sent on any other ' +\n  \"message.\";\n\nconst ADDITIONAL_TOOLS_TRANSPORT_ERROR =\n  \"`additional_tools` requires the Responses API and cannot be sent via Chat \" +\n  \"Completions. Set `useResponsesApi: true`.\";\n\n/**\n * Throws if `message` carries an `additional_tools` block, in either spelling,\n * that cannot reach the wire.\n *\n * OpenAI takes `additional_tools` only as a Responses API input item with\n * `role: \"developer\"`, so only a `SystemMessage` sent via the Responses API\n * can carry it. Assistant messages are exempt: their content is replayed model\n * output, not an instruction from the caller.\n */\nexport function assertAdditionalToolsPlacement(\n  message: BaseMessage,\n  api: \"responses\" | \"chat/completions\"\n): void {\n  if (\n    AIMessage.isInstance(message) ||\n    !Array.isArray(message.content) ||\n    !message.content.some(\n      (block) => unwrapNonStandard(block).type === \"additional_tools\"\n    )\n  ) {\n    return;\n  }\n  if (!SystemMessage.isInstance(message)) {\n    throw new Error(ADDITIONAL_TOOLS_PLACEMENT_ERROR);\n  }\n  if (api === \"chat/completions\") {\n    throw new Error(ADDITIONAL_TOOLS_TRANSPORT_ERROR);\n  }\n}\n\nexport function normalizePromptCacheRetention(\n  retention: OpenAICacheRetentionParam | undefined\n): Exclude<OpenAICacheRetentionParam, \"in-memory\"> | undefined {\n  return retention === \"in-memory\" ? \"in_memory\" : retention;\n}\n\nexport function applyPromptCacheBreakpoint<T extends object>(\n  source: Record<string, unknown>,\n  target: T\n): T {\n  if (\"prompt_cache_breakpoint\" in source) {\n    return {\n      ...target,\n      prompt_cache_breakpoint: source.prompt_cache_breakpoint,\n    };\n  }\n  if (hasExtrasPromptCacheBreakpoint(source)) {\n    return {\n      ...target,\n      prompt_cache_breakpoint: source.extras.prompt_cache_breakpoint,\n    };\n  }\n  return target;\n}\n\nexport function hasExtrasPromptCacheBreakpoint(\n  block: Record<string, unknown>\n): block is { extras: { prompt_cache_breakpoint: unknown } } {\n  const { extras } = block;\n  return (\n    typeof extras === \"object\" &&\n    extras !== null &&\n    \"prompt_cache_breakpoint\" in extras\n  );\n}\n\nexport function liftExtrasPromptCacheBreakpoint<T extends object>(block: T): T {\n  const source = block as Record<string, unknown>;\n  if (!hasExtrasPromptCacheBreakpoint(source)) {\n    return block;\n  }\n  const { extras: _extras, ...rest } = source;\n  return applyPromptCacheBreakpoint(source, rest) as T;\n}\n\nexport function isReasoningModel(model?: string) {\n  if (!model) return false;\n  if (/^o\\d/.test(model ?? \"\")) return true;\n  if (model.startsWith(\"gpt-5\") && !model.startsWith(\"gpt-5-chat\")) return true;\n  if (model.startsWith(\"gpt-6\") && !model.startsWith(\"gpt-6-chat\")) return true;\n  return false;\n}\n\nexport function extractGenericMessageCustomRole(message: ChatMessage) {\n  if (\n    message.role !== \"system\" &&\n    message.role !== \"developer\" &&\n    message.role !== \"assistant\" &&\n    message.role !== \"user\" &&\n    message.role !== \"function\" &&\n    message.role !== \"tool\"\n  ) {\n    console.warn(`Unknown message role: ${message.role}`);\n  }\n\n  return message.role as OpenAIClient.ChatCompletionRole;\n}\n\nexport function getFilenameFromMetadata(\n  block:\n    | ContentBlock.Multimodal.File\n    | ContentBlock.Multimodal.Video\n    | Data.StandardFileBlock\n): string | undefined {\n  return (block.metadata?.filename ??\n    block.metadata?.name ??\n    block.metadata?.title) as string;\n}\n\nexport const LC_AUTOGENERATED_FILENAME = \"LC_AUTOGENERATED\";\n\nexport function getRequiredFilenameFromMetadata(\n  block:\n    | ContentBlock.Multimodal.File\n    | ContentBlock.Multimodal.Video\n    | Data.StandardFileBlock\n): string {\n  const filename = (block.metadata?.filename ??\n    block.metadata?.name ??\n    block.metadata?.title) as string;\n\n  if (!filename) {\n    console.warn(\n      \"OpenAI may require a filename for file uploads. Specify a filename \" +\n        \"in the content block metadata, e.g.: { type: 'file', mimeType: \" +\n        \"'...', data: '...', metadata: { filename: 'my-file.pdf' } }. \" +\n        \"Using placeholder filename 'LC_AUTOGENERATED'.\"\n    );\n    return LC_AUTOGENERATED_FILENAME;\n  }\n\n  return filename;\n}\nexport function messageToOpenAIRole(\n  message: BaseMessage\n): OpenAIClient.ChatCompletionRole {\n  const type = message._getType();\n  switch (type) {\n    case \"system\":\n      return \"system\";\n    case \"ai\":\n      return \"assistant\";\n    case \"human\":\n      return \"user\";\n    case \"function\":\n      return \"function\";\n    case \"tool\":\n      return \"tool\";\n    case \"generic\": {\n      if (!ChatMessage.isInstance(message))\n        throw new Error(\"Invalid generic chat message\");\n      return extractGenericMessageCustomRole(message);\n    }\n    default:\n      throw new Error(`Unknown message type: ${type}`);\n  }\n}\n\nexport function _modelPrefersResponsesAPI(model: string): boolean {\n  if (model.includes(\"gpt-5.2-pro\")) return true;\n  if (model.includes(\"gpt-5.4-pro\")) return true;\n  if (model.includes(\"gpt-5.5-pro\")) return true;\n  if (model.includes(\"gpt-5.6\")) return true;\n  // Codex models are Responses API only\n  if (model.includes(\"codex\")) return true;\n  return false;\n}\n"],"mappings":"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"}

package/dist/utils/misc.d.cts

@@ -2,7 +2,6 @@ import "../types.cjs";
 import { OpenAI } from "openai";
 import { BaseMessage, ContentBlock } from "@langchain/core/messages";
 //#region src/utils/misc.d.ts
-declare function messageToOpenAIRole(message: BaseMessage): OpenAI.ChatCompletionRole;
+export declare function messageToOpenAIRole(message: BaseMessage): OpenAI.ChatCompletionRole;
 //#endregion
-export { messageToOpenAIRole };
 //# sourceMappingURL=misc.d.cts.map

package/dist/utils/misc.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"misc.d.cts","names":[],"sources":["../../src/utils/misc.ts"],"mappings":";;;;iBAkHgB,oBACd,SAAS,cACR,OAAa"}
+{"version":3,"file":"misc.d.cts","names":["OpenAIClient"],"sources":["../../src/utils/misc.ts"],"mappings":";;;;wBA0KgB,oBACd,SAAS,cACRA,OAAa"}

package/dist/utils/misc.d.ts

@@ -2,7 +2,6 @@ import "../types.js";
 import { OpenAI } from "openai";
 import { BaseMessage, ChatMessage, ContentBlock } from "@langchain/core/messages";
 //#region src/utils/misc.d.ts
-declare function messageToOpenAIRole(message: BaseMessage): OpenAI.ChatCompletionRole;
+export declare function messageToOpenAIRole(message: BaseMessage): OpenAI.ChatCompletionRole;
 //#endregion
-export { messageToOpenAIRole };
 //# sourceMappingURL=misc.d.ts.map

package/dist/utils/misc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"misc.d.ts","names":[],"sources":["../../src/utils/misc.ts"],"mappings":";;;;iBAkHgB,oBACd,SAAS,cACR,OAAa"}
+{"version":3,"file":"misc.d.ts","names":["OpenAIClient"],"sources":["../../src/utils/misc.ts"],"mappings":";;;;wBA0KgB,oBACd,SAAS,cACRA,OAAa"}

package/dist/utils/misc.js

@@ -1,6 +1,30 @@
-import { ChatMessage } from "@langchain/core/messages";
+import { AIMessage, ChatMessage, SystemMessage } from "@langchain/core/messages";
 //#region src/utils/misc.ts
 const iife$1 = (fn) => fn();
+/**
+* Returns the provider payload a content block carries: the `value` of a
+* `non_standard` wrapper, or the block itself.
+*/
+function unwrapNonStandard(block) {
+	if (block.type === "non_standard" && typeof block.value === "object" && block.value !== null) return block.value;
+	return block;
+}
+const ADDITIONAL_TOOLS_PLACEMENT_ERROR = "`additional_tools` must be carried on a `SystemMessage`. OpenAI restricts the input item to `role: \"developer\"`, so it cannot be sent on any other message.";
+const ADDITIONAL_TOOLS_TRANSPORT_ERROR = "`additional_tools` requires the Responses API and cannot be sent via Chat Completions. Set `useResponsesApi: true`.";
+/**
+* Throws if `message` carries an `additional_tools` block, in either spelling,
+* that cannot reach the wire.
+*
+* OpenAI takes `additional_tools` only as a Responses API input item with
+* `role: "developer"`, so only a `SystemMessage` sent via the Responses API
+* can carry it. Assistant messages are exempt: their content is replayed model
+* output, not an instruction from the caller.
+*/
+function assertAdditionalToolsPlacement(message, api) {
+	if (AIMessage.isInstance(message) || !Array.isArray(message.content) || !message.content.some((block) => unwrapNonStandard(block).type === "additional_tools")) return;
+	if (!SystemMessage.isInstance(message)) throw new Error(ADDITIONAL_TOOLS_PLACEMENT_ERROR);
+	if (api === "chat/completions") throw new Error(ADDITIONAL_TOOLS_TRANSPORT_ERROR);
+}
 function normalizePromptCacheRetention(retention) {
 	return retention === "in-memory" ? "in_memory" : retention;
 }
@@ -71,6 +95,6 @@ function _modelPrefersResponsesAPI(model) {
 	return false;
 }
 //#endregion
-export { LC_AUTOGENERATED_FILENAME, _modelPrefersResponsesAPI, applyPromptCacheBreakpoint, extractGenericMessageCustomRole, getFilenameFromMetadata, getRequiredFilenameFromMetadata, hasExtrasPromptCacheBreakpoint, iife$1 as iife, isReasoningModel, liftExtrasPromptCacheBreakpoint, messageToOpenAIRole, normalizePromptCacheRetention };
+export { LC_AUTOGENERATED_FILENAME, _modelPrefersResponsesAPI, applyPromptCacheBreakpoint, assertAdditionalToolsPlacement, extractGenericMessageCustomRole, getFilenameFromMetadata, getRequiredFilenameFromMetadata, hasExtrasPromptCacheBreakpoint, iife$1 as iife, isReasoningModel, liftExtrasPromptCacheBreakpoint, messageToOpenAIRole, normalizePromptCacheRetention, unwrapNonStandard };
 
 //# sourceMappingURL=misc.js.map