@langchain/openai 1.2.7 → 1.2.8

package/dist/converters/responses.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"responses.d.cts","names":["OpenAI","OpenAIClient","AIMessage","BaseMessage","UsageMetadata","ChatGenerationChunk","ChatOpenAIReasoningSummary","Converter","ExcludeController","T","ResponsesCreate","Responses","ResponsesParse","ResponsesCreateInvoke","ReturnType","Awaited","ResponsesParseInvoke","ResponsesInputItem","ResponseInputItem","convertResponsesUsageToUsageMetadata","ResponseUsage","convertResponsesMessageToAIMessage","convertReasoningSummaryToResponsesReasoningItem","ResponseReasoningItem","convertResponsesDeltaToChatGenerationChunk","ResponseStreamEvent","convertStandardContentMessageToResponsesInput","convertMessagesToResponsesInput"],"sources":["../../src/converters/responses.d.ts"],"sourcesContent":["import { OpenAI as OpenAIClient } from \"openai\";\nimport { AIMessage, type BaseMessage, type UsageMetadata } from \"@langchain/core/messages\";\nimport { ChatGenerationChunk } from \"@langchain/core/outputs\";\nimport { ChatOpenAIReasoningSummary } from \"../types.js\";\nimport { Converter } from \"@langchain/core/utils/format\";\ntype ExcludeController<T> = T extends {\n    controller: unknown;\n} ? never : T;\nexport type ResponsesCreate = OpenAIClient.Responses[\"create\"];\nexport type ResponsesParse = OpenAIClient.Responses[\"parse\"];\nexport type ResponsesCreateInvoke = ExcludeController<Awaited<ReturnType<ResponsesCreate>>>;\nexport type ResponsesParseInvoke = ExcludeController<Awaited<ReturnType<ResponsesParse>>>;\nexport type ResponsesInputItem = OpenAIClient.Responses.ResponseInputItem;\n/**\n * Converts OpenAI Responses API usage statistics to LangChain's UsageMetadata format.\n *\n * This converter transforms token usage information from OpenAI's Responses API into\n * the standardized UsageMetadata format used throughout LangChain. It handles both\n * basic token counts and detailed token breakdowns including cached tokens and\n * reasoning tokens.\n *\n * @param usage - The usage statistics object from OpenAI's Responses API containing\n *                token counts and optional detailed breakdowns.\n *\n * @returns A UsageMetadata object containing:\n *   - `input_tokens`: Total number of tokens in the input/prompt (defaults to 0 if not provided)\n *   - `output_tokens`: Total number of tokens in the model's output (defaults to 0 if not provided)\n *   - `total_tokens`: Combined total of input and output tokens (defaults to 0 if not provided)\n *   - `input_token_details`: Object containing detailed input token information:\n *     - `cache_read`: Number of tokens read from cache (only included if available)\n *   - `output_token_details`: Object containing detailed output token information:\n *     - `reasoning`: Number of tokens used for reasoning (only included if available)\n *\n * @example\n * ```typescript\n * const usage = {\n *   input_tokens: 100,\n *   output_tokens: 50,\n *   total_tokens: 150,\n *   input_tokens_details: { cached_tokens: 20 },\n *   output_tokens_details: { reasoning_tokens: 10 }\n * };\n *\n * const metadata = convertResponsesUsageToUsageMetadata(usage);\n * // Returns:\n * // {\n * //   input_tokens: 100,\n * //   output_tokens: 50,\n * //   total_tokens: 150,\n * //   input_token_details: { cache_read: 20 },\n * //   output_token_details: { reasoning: 10 }\n * // }\n * ```\n *\n * @remarks\n * - The function safely handles undefined or null values by using optional chaining\n *   and nullish coalescing operators\n * - Detailed token information (cache_read, reasoning) is only included in the result\n *   if the corresponding values are present in the input\n * - Token counts default to 0 if not provided in the usage object\n * - This converter is specifically designed for OpenAI's Responses API format and\n *   may differ from other OpenAI API endpoints\n */\nexport declare const convertResponsesUsageToUsageMetadata: Converter<OpenAIClient.Responses.ResponseUsage | undefined, UsageMetadata>;\n/**\n * Converts an OpenAI Responses API response to a LangChain AIMessage.\n *\n * This converter processes the output from OpenAI's Responses API (both `create` and `parse` methods)\n * and transforms it into a LangChain AIMessage object with all relevant metadata, tool calls, and content.\n *\n * @param response - The response object from OpenAI's Responses API. Can be either:\n *   - ResponsesCreateInvoke: Result from `responses.create()`\n *   - ResponsesParseInvoke: Result from `responses.parse()`\n *\n * @returns An AIMessage containing:\n *   - `id`: The message ID from the response output\n *   - `content`: Array of message content blocks (text, images, etc.)\n *   - `tool_calls`: Array of successfully parsed tool calls\n *   - `invalid_tool_calls`: Array of tool calls that failed to parse\n *   - `usage_metadata`: Token usage information converted to LangChain format\n *   - `additional_kwargs`: Extra data including:\n *     - `refusal`: Refusal text if the model refused to respond\n *     - `reasoning`: Reasoning output for reasoning models\n *     - `tool_outputs`: Results from built-in tools (web search, file search, etc.)\n *     - `parsed`: Parsed structured output when using json_schema format\n *     - Function call ID mappings for tracking\n *   - `response_metadata`: Metadata about the response including model, timestamps, status, etc.\n *\n * @throws Error if the response contains an error object. The error message and code are extracted\n *   from the response.error field.\n *\n * @example\n * ```typescript\n * const response = await client.responses.create({\n *   model: \"gpt-4\",\n *   input: [{ type: \"message\", content: \"Hello\" }]\n * });\n * const message = convertResponsesMessageToAIMessage(response);\n * console.log(message.content); // Message content\n * console.log(message.tool_calls); // Any tool calls made\n * ```\n *\n * @remarks\n * The converter handles multiple output item types:\n * - `message`: Text and structured content from the model\n * - `function_call`: Tool/function calls that need to be executed\n * - `reasoning`: Reasoning traces from reasoning models (o1, o3, etc.)\n * - `custom_tool_call`: Custom tool invocations\n * - Built-in tool outputs: web_search, file_search, code_interpreter, etc.\n *\n * Tool calls are parsed and validated. Invalid tool calls (malformed JSON, etc.) are captured\n * in the `invalid_tool_calls` array rather than throwing errors.\n */\nexport declare const convertResponsesMessageToAIMessage: Converter<ResponsesCreateInvoke | ResponsesParseInvoke, AIMessage>;\n/**\n * Converts a LangChain ChatOpenAI reasoning summary to an OpenAI Responses API reasoning item.\n *\n * This converter transforms reasoning summaries that have been accumulated during streaming\n * (where summary parts may arrive in multiple chunks with the same index) into the final\n * consolidated format expected by OpenAI's Responses API. It combines summary parts that\n * share the same index and removes the index field from the final output.\n *\n * @param reasoning - A ChatOpenAI reasoning summary object containing:\n *   - `id`: The reasoning item ID\n *   - `type`: The type of reasoning (typically \"reasoning\")\n *   - `summary`: Array of summary parts, each with:\n *     - `text`: The summary text content\n *     - `type`: The summary type (e.g., \"summary_text\")\n *     - `index`: The index used to group related summary parts during streaming\n *\n * @returns An OpenAI Responses API ResponseReasoningItem with:\n *   - All properties from the input reasoning object\n *   - `summary`: Consolidated array of summary objects with:\n *     - `text`: Combined text from all parts with the same index\n *     - `type`: The summary type\n *     - No `index` field (removed after consolidation)\n *\n * @example\n * ```typescript\n * // Input: Reasoning summary with multiple parts at the same index\n * const reasoning = {\n *   id: \"reasoning_123\",\n *   type: \"reasoning\",\n *   summary: [\n *     { text: \"First \", type: \"summary_text\", index: 0 },\n *     { text: \"part\", type: \"summary_text\", index: 0 },\n *     { text: \"Second part\", type: \"summary_text\", index: 1 }\n *   ]\n * };\n *\n * const result = convertReasoningSummaryToResponsesReasoningItem(reasoning);\n * // Returns:\n * // {\n * //   id: \"reasoning_123\",\n * //   type: \"reasoning\",\n * //   summary: [\n * //     { text: \"First part\", type: \"summary_text\" },\n * //     { text: \"Second part\", type: \"summary_text\" }\n * //   ]\n * // }\n * ```\n *\n * @remarks\n * - This converter is primarily used when reconstructing complete reasoning items from\n *   streaming chunks, where summary parts may arrive incrementally with index markers\n * - Summary parts with the same index are concatenated in the order they appear\n * - If the reasoning summary contains only one part, no reduction is performed\n * - The index field is used internally during streaming to track which summary parts\n *   belong together, but is removed from the final output as it's not part of the\n *   OpenAI Responses API schema\n * - This is the inverse operation of the streaming accumulation that happens in\n *   `convertResponsesDeltaToChatGenerationChunk`\n */\nexport declare const convertReasoningSummaryToResponsesReasoningItem: Converter<ChatOpenAIReasoningSummary, OpenAIClient.Responses.ResponseReasoningItem>;\n/**\n * Converts OpenAI Responses API stream events to LangChain ChatGenerationChunk objects.\n *\n * This converter processes streaming events from OpenAI's Responses API and transforms them\n * into LangChain ChatGenerationChunk objects that can be used in streaming chat applications.\n * It handles various event types including text deltas, tool calls, reasoning, and metadata updates.\n *\n * @param event - A streaming event from OpenAI's Responses API\n *\n * @returns A ChatGenerationChunk containing:\n *   - `text`: Concatenated text content from all text parts in the event\n *   - `message`: An AIMessageChunk with:\n *     - `id`: Message ID (set when a message output item is added)\n *     - `content`: Array of content blocks (text with optional annotations)\n *     - `tool_call_chunks`: Incremental tool call data (name, args, id)\n *     - `usage_metadata`: Token usage information (only in completion events)\n *     - `additional_kwargs`: Extra data including:\n *       - `refusal`: Refusal text if the model refused to respond\n *       - `reasoning`: Reasoning output for reasoning models (id, type, summary)\n *       - `tool_outputs`: Results from built-in tools (web search, file search, etc.)\n *       - `parsed`: Parsed structured output when using json_schema format\n *       - Function call ID mappings for tracking\n *     - `response_metadata`: Metadata about the response (model, id, etc.)\n *   - `generationInfo`: Additional generation information (e.g., tool output status)\n *\n *   Returns `null` for events that don't produce meaningful chunks:\n *   - Partial image generation events (to avoid storing all partial images in history)\n *   - Unrecognized event types\n *\n * @example\n * ```typescript\n * const stream = await client.responses.create({\n *   model: \"gpt-4\",\n *   input: [{ type: \"message\", content: \"Hello\" }],\n *   stream: true\n * });\n *\n * for await (const event of stream) {\n *   const chunk = convertResponsesDeltaToChatGenerationChunk(event);\n *   if (chunk) {\n *     console.log(chunk.text); // Incremental text\n *     console.log(chunk.message.tool_call_chunks); // Tool call updates\n *   }\n * }\n * ```\n *\n * @remarks\n * - Text content is accumulated in an array with index tracking for proper ordering\n * - Tool call chunks include incremental arguments that need to be concatenated by the consumer\n * - Reasoning summaries are built incrementally across multiple events\n * - Function call IDs are tracked in `additional_kwargs` to map call_id to item id\n * - The `text` field is provided for legacy compatibility with `onLLMNewToken` callbacks\n * - Usage metadata is only available in `response.completed` events\n * - Partial images are intentionally ignored to prevent memory bloat in conversation history\n */\nexport declare const convertResponsesDeltaToChatGenerationChunk: Converter<OpenAIClient.Responses.ResponseStreamEvent, ChatGenerationChunk | null>;\n/**\n * Converts a single LangChain BaseMessage to OpenAI Responses API input format.\n *\n * This converter transforms a LangChain message into one or more ResponseInputItem objects\n * that can be used with OpenAI's Responses API. It handles complex message structures including\n * tool calls, reasoning blocks, multimodal content, and various content block types.\n *\n * @param message - The LangChain BaseMessage to convert. Can be any message type including\n *   HumanMessage, AIMessage, SystemMessage, ToolMessage, etc.\n *\n * @returns An array of ResponseInputItem objects.\n *\n * @example\n * Basic text message conversion:\n * ```typescript\n * const message = new HumanMessage(\"Hello, how are you?\");\n * const items = convertStandardContentMessageToResponsesInput(message);\n * // Returns: [{ type: \"message\", role: \"user\", content: [{ type: \"input_text\", text: \"Hello, how are you?\" }] }]\n * ```\n *\n * @example\n * AI message with tool calls:\n * ```typescript\n * const message = new AIMessage({\n *   content: \"I'll check the weather for you.\",\n *   tool_calls: [{\n *     id: \"call_123\",\n *     name: \"get_weather\",\n *     args: { location: \"San Francisco\" }\n *   }]\n * });\n * const items = convertStandardContentMessageToResponsesInput(message);\n * // Returns:\n * // [\n * //   { type: \"message\", role: \"assistant\", content: [{ type: \"input_text\", text: \"I'll check the weather for you.\" }] },\n * //   { type: \"function_call\", call_id: \"call_123\", name: \"get_weather\", arguments: '{\"location\":\"San Francisco\"}' }\n * // ]\n * ```\n */\nexport declare const convertStandardContentMessageToResponsesInput: Converter<BaseMessage, OpenAIClient.Responses.ResponseInputItem[]>;\n/**\n * - MCP (Model Context Protocol) approval responses\n * - Zero Data Retention (ZDR) mode handling\n *\n * @param params - Conversion parameters\n * @param params.messages - Array of LangChain BaseMessages to convert\n * @param params.zdrEnabled - Whether Zero Data Retention mode is enabled. When true, certain\n *   metadata like message IDs and function call IDs are omitted from the output\n * @param params.model - The model name being used. Used to determine if special role mapping\n *   is needed (e.g., \"system\" -> \"developer\" for reasoning models)\n *\n * @returns Array of ResponsesInputItem objects formatted for the OpenAI Responses API\n *\n * @throws {Error} When a function message is encountered (not supported)\n * @throws {Error} When computer call output format is invalid\n *\n * @example\n * ```typescript\n * const messages = [\n *   new HumanMessage(\"Hello\"),\n *   new AIMessage({ content: \"Hi there!\", tool_calls: [...] })\n * ];\n *\n * const input = convertMessagesToResponsesInput({\n *   messages,\n *   zdrEnabled: false,\n *   model: \"gpt-4\"\n * });\n * ```\n */\nexport declare const convertMessagesToResponsesInput: Converter<{\n    messages: BaseMessage[];\n    zdrEnabled: boolean;\n    model: string;\n}, ResponsesInputItem[]>;\nexport {};\n//# sourceMappingURL=responses.d.ts.map"],"mappings":";;;;;;;KAKKQ,uBAAuBC;;AAD6B,CAAA,GACpDD,KAAAA,GAEOC,CAFPD;AAGOE,KAAAA,eAAAA,GAAkBT,QAAAA,CAAaU,SAAS,CAAA,QAAA,CAAA;AACxCC,KAAAA,cAAAA,GAAiBX,QAAAA,CAAaU,SAAS,CAAA,OAAA,CAAA;AACvCE,KAAAA,qBAAAA,GAAwBL,iBAAH,CAAqBO,OAArB,CAA6BD,UAA7B,CAAwCJ,eAAxC,CAAA,CAAA,CAAA;AAAwCA,KAC7DM,oBAAAA,GAAuBR,iBADsCE,CACpBK,OADoBL,CACZI,UADYJ,CACDE,cADCF,CAAAA,CAAAA,CAAAA;AAAXI,KAElDG,kBAAAA,GAAqBhB,QAAAA,CAAaU,SAAAA,CAAUO,iBAFMJ;;;AAAT;AACrD;;;;;AAAoD;AACpD;AAmDA;;;;AAAoE;AAkDpE;;;;;AAAkE;AA4DlE;;;;AAA+E;AAwD/E;;;;AAA0E;AAwC1E;;;;AAA6E;AA+B7E;;;;AAA+D;;;;;;;;;;cA7O1CK,sCAAsCZ,UAAUN,QAAAA,CAAaU,SAAAA,CAAUS,2BAA2BhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkDlGiB,oCAAoCd,UAAUM,wBAAwBG,sBAAsBd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA4D5FoB,iDAAiDf,UAAUD,4BAA4BL,QAAAA,CAAaU,SAAAA,CAAUY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwD9GC,4CAA4CjB,UAAUN,QAAAA,CAAaU,SAAAA,CAAUc,qBAAqBpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwClGqB,+CAA+CnB,UAAUJ,aAAaF,QAAAA,CAAaU,SAAAA,CAAUO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+B7FS,iCAAiCpB;YACxCJ;;;GAGXc"}
+{"version":3,"file":"responses.d.cts","names":[],"sources":["../../src/converters/responses.ts"],"mappings":";;;;;;;KA+LK,iBAAA,MAAuB,CAAA;EAAY,UAAA;AAAA,YAAgC,CAAA;AAAA,KAE5D,eAAA,GAAkB,QAAA,CAAa,SAAA;AAAA,KAC/B,cAAA,GAAiB,QAAA,CAAa,SAAA;AAAA,KAE9B,qBAAA,GAAwB,iBAAA,CAClC,OAAA,CAAQ,UAAA,CAAW,eAAA;AAAA,KAET,oBAAA,GAAuB,iBAAA,CACjC,OAAA,CAAQ,UAAA,CAAW,cAAA;AAAA,KAGT,kBAAA,GAAqB,QAAA,CAAa,SAAA,CAAU,iBAAA;;;;;AAVxD;;;;;AACA;;;;;AAEA;;;;;;;;;;;;;;;AAGA;;;;;;;;;;;;;;;AAIA;;;;;;cAoDa,oCAAA,EAAsC,SAAA,CACjD,QAAA,CAAa,SAAA,CAAU,aAAA,cACvB,aAAA;;;AAFF;;;;;;;;;;;;;;;AAwEA;;;;;;;;;;;;;;;AAmOA;;;;;;;;;;;;;;;AAsFA;;cAzTa,kCAAA,EAAoC,SAAA,CAC/C,qBAAA,GAAwB,oBAAA,EACxB,SAAA;;;;;;;;;;;;;AAukBF;;;;;;;;;;;;;;;AAgXA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAttBa,+CAAA,EAAiD,SAAA,CAC5D,0BAAA,EACA,QAAA,CAAa,SAAA,CAAU,qBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAoFZ,0CAAA,EAA4C,SAAA,CACvD,QAAA,CAAa,SAAA,CAAU,mBAAA,EACvB,mBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8QW,6CAAA,EAA+C,SAAA,CAC1D,WAAA,EACA,QAAA,CAAa,SAAA,CAAU,iBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8WZ,+BAAA,EAAiC,SAAA;EAC1C,QAAA,EAAU,WAAA;EAAe,UAAA;EAAqB,KAAA;AAAA,GAChD,kBAAA"}

package/dist/converters/responses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"responses.d.ts","names":["OpenAI","OpenAIClient","AIMessage","BaseMessage","UsageMetadata","ChatGenerationChunk","ChatOpenAIReasoningSummary","Converter","ExcludeController","T","ResponsesCreate","Responses","ResponsesParse","ResponsesCreateInvoke","ReturnType","Awaited","ResponsesParseInvoke","ResponsesInputItem","ResponseInputItem","convertResponsesUsageToUsageMetadata","ResponseUsage","convertResponsesMessageToAIMessage","convertReasoningSummaryToResponsesReasoningItem","ResponseReasoningItem","convertResponsesDeltaToChatGenerationChunk","ResponseStreamEvent","convertStandardContentMessageToResponsesInput","convertMessagesToResponsesInput"],"sources":["../../src/converters/responses.d.ts"],"sourcesContent":["import { OpenAI as OpenAIClient } from \"openai\";\nimport { AIMessage, type BaseMessage, type UsageMetadata } from \"@langchain/core/messages\";\nimport { ChatGenerationChunk } from \"@langchain/core/outputs\";\nimport { ChatOpenAIReasoningSummary } from \"../types.js\";\nimport { Converter } from \"@langchain/core/utils/format\";\ntype ExcludeController<T> = T extends {\n    controller: unknown;\n} ? never : T;\nexport type ResponsesCreate = OpenAIClient.Responses[\"create\"];\nexport type ResponsesParse = OpenAIClient.Responses[\"parse\"];\nexport type ResponsesCreateInvoke = ExcludeController<Awaited<ReturnType<ResponsesCreate>>>;\nexport type ResponsesParseInvoke = ExcludeController<Awaited<ReturnType<ResponsesParse>>>;\nexport type ResponsesInputItem = OpenAIClient.Responses.ResponseInputItem;\n/**\n * Converts OpenAI Responses API usage statistics to LangChain's UsageMetadata format.\n *\n * This converter transforms token usage information from OpenAI's Responses API into\n * the standardized UsageMetadata format used throughout LangChain. It handles both\n * basic token counts and detailed token breakdowns including cached tokens and\n * reasoning tokens.\n *\n * @param usage - The usage statistics object from OpenAI's Responses API containing\n *                token counts and optional detailed breakdowns.\n *\n * @returns A UsageMetadata object containing:\n *   - `input_tokens`: Total number of tokens in the input/prompt (defaults to 0 if not provided)\n *   - `output_tokens`: Total number of tokens in the model's output (defaults to 0 if not provided)\n *   - `total_tokens`: Combined total of input and output tokens (defaults to 0 if not provided)\n *   - `input_token_details`: Object containing detailed input token information:\n *     - `cache_read`: Number of tokens read from cache (only included if available)\n *   - `output_token_details`: Object containing detailed output token information:\n *     - `reasoning`: Number of tokens used for reasoning (only included if available)\n *\n * @example\n * ```typescript\n * const usage = {\n *   input_tokens: 100,\n *   output_tokens: 50,\n *   total_tokens: 150,\n *   input_tokens_details: { cached_tokens: 20 },\n *   output_tokens_details: { reasoning_tokens: 10 }\n * };\n *\n * const metadata = convertResponsesUsageToUsageMetadata(usage);\n * // Returns:\n * // {\n * //   input_tokens: 100,\n * //   output_tokens: 50,\n * //   total_tokens: 150,\n * //   input_token_details: { cache_read: 20 },\n * //   output_token_details: { reasoning: 10 }\n * // }\n * ```\n *\n * @remarks\n * - The function safely handles undefined or null values by using optional chaining\n *   and nullish coalescing operators\n * - Detailed token information (cache_read, reasoning) is only included in the result\n *   if the corresponding values are present in the input\n * - Token counts default to 0 if not provided in the usage object\n * - This converter is specifically designed for OpenAI's Responses API format and\n *   may differ from other OpenAI API endpoints\n */\nexport declare const convertResponsesUsageToUsageMetadata: Converter<OpenAIClient.Responses.ResponseUsage | undefined, UsageMetadata>;\n/**\n * Converts an OpenAI Responses API response to a LangChain AIMessage.\n *\n * This converter processes the output from OpenAI's Responses API (both `create` and `parse` methods)\n * and transforms it into a LangChain AIMessage object with all relevant metadata, tool calls, and content.\n *\n * @param response - The response object from OpenAI's Responses API. Can be either:\n *   - ResponsesCreateInvoke: Result from `responses.create()`\n *   - ResponsesParseInvoke: Result from `responses.parse()`\n *\n * @returns An AIMessage containing:\n *   - `id`: The message ID from the response output\n *   - `content`: Array of message content blocks (text, images, etc.)\n *   - `tool_calls`: Array of successfully parsed tool calls\n *   - `invalid_tool_calls`: Array of tool calls that failed to parse\n *   - `usage_metadata`: Token usage information converted to LangChain format\n *   - `additional_kwargs`: Extra data including:\n *     - `refusal`: Refusal text if the model refused to respond\n *     - `reasoning`: Reasoning output for reasoning models\n *     - `tool_outputs`: Results from built-in tools (web search, file search, etc.)\n *     - `parsed`: Parsed structured output when using json_schema format\n *     - Function call ID mappings for tracking\n *   - `response_metadata`: Metadata about the response including model, timestamps, status, etc.\n *\n * @throws Error if the response contains an error object. The error message and code are extracted\n *   from the response.error field.\n *\n * @example\n * ```typescript\n * const response = await client.responses.create({\n *   model: \"gpt-4\",\n *   input: [{ type: \"message\", content: \"Hello\" }]\n * });\n * const message = convertResponsesMessageToAIMessage(response);\n * console.log(message.content); // Message content\n * console.log(message.tool_calls); // Any tool calls made\n * ```\n *\n * @remarks\n * The converter handles multiple output item types:\n * - `message`: Text and structured content from the model\n * - `function_call`: Tool/function calls that need to be executed\n * - `reasoning`: Reasoning traces from reasoning models (o1, o3, etc.)\n * - `custom_tool_call`: Custom tool invocations\n * - Built-in tool outputs: web_search, file_search, code_interpreter, etc.\n *\n * Tool calls are parsed and validated. Invalid tool calls (malformed JSON, etc.) are captured\n * in the `invalid_tool_calls` array rather than throwing errors.\n */\nexport declare const convertResponsesMessageToAIMessage: Converter<ResponsesCreateInvoke | ResponsesParseInvoke, AIMessage>;\n/**\n * Converts a LangChain ChatOpenAI reasoning summary to an OpenAI Responses API reasoning item.\n *\n * This converter transforms reasoning summaries that have been accumulated during streaming\n * (where summary parts may arrive in multiple chunks with the same index) into the final\n * consolidated format expected by OpenAI's Responses API. It combines summary parts that\n * share the same index and removes the index field from the final output.\n *\n * @param reasoning - A ChatOpenAI reasoning summary object containing:\n *   - `id`: The reasoning item ID\n *   - `type`: The type of reasoning (typically \"reasoning\")\n *   - `summary`: Array of summary parts, each with:\n *     - `text`: The summary text content\n *     - `type`: The summary type (e.g., \"summary_text\")\n *     - `index`: The index used to group related summary parts during streaming\n *\n * @returns An OpenAI Responses API ResponseReasoningItem with:\n *   - All properties from the input reasoning object\n *   - `summary`: Consolidated array of summary objects with:\n *     - `text`: Combined text from all parts with the same index\n *     - `type`: The summary type\n *     - No `index` field (removed after consolidation)\n *\n * @example\n * ```typescript\n * // Input: Reasoning summary with multiple parts at the same index\n * const reasoning = {\n *   id: \"reasoning_123\",\n *   type: \"reasoning\",\n *   summary: [\n *     { text: \"First \", type: \"summary_text\", index: 0 },\n *     { text: \"part\", type: \"summary_text\", index: 0 },\n *     { text: \"Second part\", type: \"summary_text\", index: 1 }\n *   ]\n * };\n *\n * const result = convertReasoningSummaryToResponsesReasoningItem(reasoning);\n * // Returns:\n * // {\n * //   id: \"reasoning_123\",\n * //   type: \"reasoning\",\n * //   summary: [\n * //     { text: \"First part\", type: \"summary_text\" },\n * //     { text: \"Second part\", type: \"summary_text\" }\n * //   ]\n * // }\n * ```\n *\n * @remarks\n * - This converter is primarily used when reconstructing complete reasoning items from\n *   streaming chunks, where summary parts may arrive incrementally with index markers\n * - Summary parts with the same index are concatenated in the order they appear\n * - If the reasoning summary contains only one part, no reduction is performed\n * - The index field is used internally during streaming to track which summary parts\n *   belong together, but is removed from the final output as it's not part of the\n *   OpenAI Responses API schema\n * - This is the inverse operation of the streaming accumulation that happens in\n *   `convertResponsesDeltaToChatGenerationChunk`\n */\nexport declare const convertReasoningSummaryToResponsesReasoningItem: Converter<ChatOpenAIReasoningSummary, OpenAIClient.Responses.ResponseReasoningItem>;\n/**\n * Converts OpenAI Responses API stream events to LangChain ChatGenerationChunk objects.\n *\n * This converter processes streaming events from OpenAI's Responses API and transforms them\n * into LangChain ChatGenerationChunk objects that can be used in streaming chat applications.\n * It handles various event types including text deltas, tool calls, reasoning, and metadata updates.\n *\n * @param event - A streaming event from OpenAI's Responses API\n *\n * @returns A ChatGenerationChunk containing:\n *   - `text`: Concatenated text content from all text parts in the event\n *   - `message`: An AIMessageChunk with:\n *     - `id`: Message ID (set when a message output item is added)\n *     - `content`: Array of content blocks (text with optional annotations)\n *     - `tool_call_chunks`: Incremental tool call data (name, args, id)\n *     - `usage_metadata`: Token usage information (only in completion events)\n *     - `additional_kwargs`: Extra data including:\n *       - `refusal`: Refusal text if the model refused to respond\n *       - `reasoning`: Reasoning output for reasoning models (id, type, summary)\n *       - `tool_outputs`: Results from built-in tools (web search, file search, etc.)\n *       - `parsed`: Parsed structured output when using json_schema format\n *       - Function call ID mappings for tracking\n *     - `response_metadata`: Metadata about the response (model, id, etc.)\n *   - `generationInfo`: Additional generation information (e.g., tool output status)\n *\n *   Returns `null` for events that don't produce meaningful chunks:\n *   - Partial image generation events (to avoid storing all partial images in history)\n *   - Unrecognized event types\n *\n * @example\n * ```typescript\n * const stream = await client.responses.create({\n *   model: \"gpt-4\",\n *   input: [{ type: \"message\", content: \"Hello\" }],\n *   stream: true\n * });\n *\n * for await (const event of stream) {\n *   const chunk = convertResponsesDeltaToChatGenerationChunk(event);\n *   if (chunk) {\n *     console.log(chunk.text); // Incremental text\n *     console.log(chunk.message.tool_call_chunks); // Tool call updates\n *   }\n * }\n * ```\n *\n * @remarks\n * - Text content is accumulated in an array with index tracking for proper ordering\n * - Tool call chunks include incremental arguments that need to be concatenated by the consumer\n * - Reasoning summaries are built incrementally across multiple events\n * - Function call IDs are tracked in `additional_kwargs` to map call_id to item id\n * - The `text` field is provided for legacy compatibility with `onLLMNewToken` callbacks\n * - Usage metadata is only available in `response.completed` events\n * - Partial images are intentionally ignored to prevent memory bloat in conversation history\n */\nexport declare const convertResponsesDeltaToChatGenerationChunk: Converter<OpenAIClient.Responses.ResponseStreamEvent, ChatGenerationChunk | null>;\n/**\n * Converts a single LangChain BaseMessage to OpenAI Responses API input format.\n *\n * This converter transforms a LangChain message into one or more ResponseInputItem objects\n * that can be used with OpenAI's Responses API. It handles complex message structures including\n * tool calls, reasoning blocks, multimodal content, and various content block types.\n *\n * @param message - The LangChain BaseMessage to convert. Can be any message type including\n *   HumanMessage, AIMessage, SystemMessage, ToolMessage, etc.\n *\n * @returns An array of ResponseInputItem objects.\n *\n * @example\n * Basic text message conversion:\n * ```typescript\n * const message = new HumanMessage(\"Hello, how are you?\");\n * const items = convertStandardContentMessageToResponsesInput(message);\n * // Returns: [{ type: \"message\", role: \"user\", content: [{ type: \"input_text\", text: \"Hello, how are you?\" }] }]\n * ```\n *\n * @example\n * AI message with tool calls:\n * ```typescript\n * const message = new AIMessage({\n *   content: \"I'll check the weather for you.\",\n *   tool_calls: [{\n *     id: \"call_123\",\n *     name: \"get_weather\",\n *     args: { location: \"San Francisco\" }\n *   }]\n * });\n * const items = convertStandardContentMessageToResponsesInput(message);\n * // Returns:\n * // [\n * //   { type: \"message\", role: \"assistant\", content: [{ type: \"input_text\", text: \"I'll check the weather for you.\" }] },\n * //   { type: \"function_call\", call_id: \"call_123\", name: \"get_weather\", arguments: '{\"location\":\"San Francisco\"}' }\n * // ]\n * ```\n */\nexport declare const convertStandardContentMessageToResponsesInput: Converter<BaseMessage, OpenAIClient.Responses.ResponseInputItem[]>;\n/**\n * - MCP (Model Context Protocol) approval responses\n * - Zero Data Retention (ZDR) mode handling\n *\n * @param params - Conversion parameters\n * @param params.messages - Array of LangChain BaseMessages to convert\n * @param params.zdrEnabled - Whether Zero Data Retention mode is enabled. When true, certain\n *   metadata like message IDs and function call IDs are omitted from the output\n * @param params.model - The model name being used. Used to determine if special role mapping\n *   is needed (e.g., \"system\" -> \"developer\" for reasoning models)\n *\n * @returns Array of ResponsesInputItem objects formatted for the OpenAI Responses API\n *\n * @throws {Error} When a function message is encountered (not supported)\n * @throws {Error} When computer call output format is invalid\n *\n * @example\n * ```typescript\n * const messages = [\n *   new HumanMessage(\"Hello\"),\n *   new AIMessage({ content: \"Hi there!\", tool_calls: [...] })\n * ];\n *\n * const input = convertMessagesToResponsesInput({\n *   messages,\n *   zdrEnabled: false,\n *   model: \"gpt-4\"\n * });\n * ```\n */\nexport declare const convertMessagesToResponsesInput: Converter<{\n    messages: BaseMessage[];\n    zdrEnabled: boolean;\n    model: string;\n}, ResponsesInputItem[]>;\nexport {};\n//# sourceMappingURL=responses.d.ts.map"],"mappings":";;;;;;;KAKKQ,uBAAuBC;;AAD6B,CAAA,GACpDD,KAAAA,GAEOC,CAFPD;AAGOE,KAAAA,eAAAA,GAAkBT,QAAAA,CAAaU,SAAS,CAAA,QAAA,CAAA;AACxCC,KAAAA,cAAAA,GAAiBX,QAAAA,CAAaU,SAAS,CAAA,OAAA,CAAA;AACvCE,KAAAA,qBAAAA,GAAwBL,iBAAH,CAAqBO,OAArB,CAA6BD,UAA7B,CAAwCJ,eAAxC,CAAA,CAAA,CAAA;AAAwCA,KAC7DM,oBAAAA,GAAuBR,iBADsCE,CACpBK,OADoBL,CACZI,UADYJ,CACDE,cADCF,CAAAA,CAAAA,CAAAA;AAAXI,KAElDG,kBAAAA,GAAqBhB,QAAAA,CAAaU,SAAAA,CAAUO,iBAFMJ;;;AAAT;AACrD;;;;;AAAoD;AACpD;AAmDA;;;;AAAoE;AAkDpE;;;;;AAAkE;AA4DlE;;;;AAA+E;AAwD/E;;;;AAA0E;AAwC1E;;;;AAA6E;AA+B7E;;;;AAA+D;;;;;;;;;;cA7O1CK,sCAAsCZ,UAAUN,QAAAA,CAAaU,SAAAA,CAAUS,2BAA2BhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkDlGiB,oCAAoCd,UAAUM,wBAAwBG,sBAAsBd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA4D5FoB,iDAAiDf,UAAUD,4BAA4BL,QAAAA,CAAaU,SAAAA,CAAUY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwD9GC,4CAA4CjB,UAAUN,QAAAA,CAAaU,SAAAA,CAAUc,qBAAqBpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwClGqB,+CAA+CnB,UAAUJ,aAAaF,QAAAA,CAAaU,SAAAA,CAAUO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+B7FS,iCAAiCpB;YACxCJ;;;GAGXc"}
+{"version":3,"file":"responses.d.ts","names":[],"sources":["../../src/converters/responses.ts"],"mappings":";;;;;;;KA+LK,iBAAA,MAAuB,CAAA;EAAY,UAAA;AAAA,YAAgC,CAAA;AAAA,KAE5D,eAAA,GAAkB,QAAA,CAAa,SAAA;AAAA,KAC/B,cAAA,GAAiB,QAAA,CAAa,SAAA;AAAA,KAE9B,qBAAA,GAAwB,iBAAA,CAClC,OAAA,CAAQ,UAAA,CAAW,eAAA;AAAA,KAET,oBAAA,GAAuB,iBAAA,CACjC,OAAA,CAAQ,UAAA,CAAW,cAAA;AAAA,KAGT,kBAAA,GAAqB,QAAA,CAAa,SAAA,CAAU,iBAAA;;;;;AAVxD;;;;;AACA;;;;;AAEA;;;;;;;;;;;;;;;AAGA;;;;;;;;;;;;;;;AAIA;;;;;;cAoDa,oCAAA,EAAsC,SAAA,CACjD,QAAA,CAAa,SAAA,CAAU,aAAA,cACvB,aAAA;;;AAFF;;;;;;;;;;;;;;;AAwEA;;;;;;;;;;;;;;;AAmOA;;;;;;;;;;;;;;;AAsFA;;cAzTa,kCAAA,EAAoC,SAAA,CAC/C,qBAAA,GAAwB,oBAAA,EACxB,SAAA;;;;;;;;;;;;;AAukBF;;;;;;;;;;;;;;;AAgXA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAttBa,+CAAA,EAAiD,SAAA,CAC5D,0BAAA,EACA,QAAA,CAAa,SAAA,CAAU,qBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAoFZ,0CAAA,EAA4C,SAAA,CACvD,QAAA,CAAa,SAAA,CAAU,mBAAA,EACvB,mBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8QW,6CAAA,EAA+C,SAAA,CAC1D,WAAA,EACA,QAAA,CAAa,SAAA,CAAU,iBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8WZ,+BAAA,EAAiC,SAAA;EAC1C,QAAA,EAAU,WAAA;EAAe,UAAA;EAAqB,KAAA;AAAA,GAChD,kBAAA"}

package/dist/converters/responses.js

@@ -1,5 +1,5 @@
 import { isComputerToolCall, isCustomToolCall, parseComputerCall, parseCustomToolCall } from "../utils/tools.js";
-import { getFilenameFromMetadata, getRequiredFilenameFromMetadata, iife, isReasoningModel, messageToOpenAIRole } from "../utils/misc.js";
+import { getFilenameFromMetadata, getRequiredFilenameFromMetadata, iife as iife$1, isReasoningModel, messageToOpenAIRole } from "../utils/misc.js";
 import { completionsApiContentBlockConverter } from "./completions.js";
 import { AIMessage, AIMessageChunk, convertToProviderContentBlock, isDataContentBlock } from "@langchain/core/messages";
 import { ChatGenerationChunk } from "@langchain/core/outputs";
@@ -616,7 +616,7 @@ const convertResponsesDeltaToChatGenerationChunk = (event) => {
 const convertStandardContentMessageToResponsesInput = (message) => {
 	const isResponsesMessage = AIMessage.isInstance(message) && message.response_metadata?.model_provider === "openai";
 	function* iterateItems() {
-		const messageRole = iife(() => {
+		const messageRole = iife$1(() => {
 			try {
 				const role = messageToOpenAIRole(message);
 				if (role === "system" || role === "developer" || role === "assistant" || role === "user") return role;
@@ -657,7 +657,7 @@ const convertStandardContentMessageToResponsesInput = (message) => {
 			}
 		};
 		const resolveImageItem = (block) => {
-			const detail = iife(() => {
+			const detail = iife$1(() => {
 				const raw = block.metadata?.detail;
 				if (raw === "low" || raw === "high" || raw === "auto") return raw;
 				return "auto";
@@ -674,14 +674,12 @@ const convertStandardContentMessageToResponsesInput = (message) => {
 			};
 			if (block.data) {
 				const base64Data = typeof block.data === "string" ? block.data : Buffer.from(block.data).toString("base64");
-				const mimeType = block.mimeType ?? "image/png";
 				return {
 					type: "input_image",
 					detail,
-					image_url: `data:${mimeType};base64,${base64Data}`
+					image_url: `data:${block.mimeType ?? "image/png"};base64,${base64Data}`
 				};
 			}
-			return void 0;
 		};
 		const resolveFileItem = (block) => {
 			if (block.fileId) {
@@ -703,20 +701,17 @@ const convertStandardContentMessageToResponsesInput = (message) => {
 			if (block.data) {
 				const filename = getRequiredFilenameFromMetadata(block);
 				const encoded = typeof block.data === "string" ? block.data : Buffer.from(block.data).toString("base64");
-				const mimeType = block.mimeType ?? "application/octet-stream";
 				return {
 					type: "input_file",
-					file_data: `data:${mimeType};base64,${encoded}`,
+					file_data: `data:${block.mimeType ?? "application/octet-stream"};base64,${encoded}`,
 					...filename ? { filename } : {}
 				};
 			}
-			return void 0;
 		};
 		const convertReasoningBlock = (block) => {
-			const summaryEntries = iife(() => {
+			const summaryEntries = iife$1(() => {
 				if (Array.isArray(block.summary)) {
-					const candidate = block.summary;
-					const mapped = candidate?.map((item) => item?.text).filter((text) => typeof text === "string") ?? [];
+					const mapped = block.summary?.map((item) => item?.text).filter((text) => typeof text === "string") ?? [];
 					if (mapped.length > 0) return mapped;
 				}
 				return block.reasoning ? [block.reasoning] : [];
@@ -885,8 +880,14 @@ const convertMessagesToResponsesInput = ({ messages, zdrEnabled, model }) => {
 		if (role === "function") throw new Error("Function messages are not supported in Responses API");
 		if (role === "tool") {
 			const toolMessage = lcMsg;
-			if (additional_kwargs?.type === "computer_call_output") {
-				const output = (() => {
+			if (additional_kwargs?.type === "computer_call_output")
+ /**
+			* Cast needed because OpenAI SDK types don't yet include input_image
+			* for computer-use-preview model output format
+			*/
+			return {
+				type: "computer_call_output",
+				output: (() => {
 					if (typeof toolMessage.content === "string") return {
 						type: "input_image",
 						image_url: toolMessage.content
@@ -912,17 +913,9 @@ const convertMessagesToResponsesInput = ({ messages, zdrEnabled, model }) => {
 						};
 					}
 					throw new Error("Invalid computer call output");
-				})();
-				/**
-				* Cast needed because OpenAI SDK types don't yet include input_image
-				* for computer-use-preview model output format
-				*/
-				return {
-					type: "computer_call_output",
-					output,
-					call_id: toolMessage.tool_call_id
-				};
-			}
+				})(),
+				call_id: toolMessage.tool_call_id
+			};
 			if (toolMessage.additional_kwargs?.customTool) return {
 				type: "custom_tool_call_output",
 				call_id: toolMessage.tool_call_id,
@@ -966,7 +959,7 @@ const convertMessagesToResponsesInput = ({ messages, zdrEnabled, model }) => {
 				type: "message",
 				role: "assistant",
 				...lcMsg.id && !zdrEnabled && lcMsg.id.startsWith("msg_") ? { id: lcMsg.id } : {},
-				content: iife(() => {
+				content: iife$1(() => {
 					if (typeof content === "string") return content;
 					return content.flatMap((item) => {
 						if (item.type === "text") return {
@@ -1019,8 +1012,7 @@ const convertMessagesToResponsesInput = ({ messages, zdrEnabled, model }) => {
 				"local_shell_call"
 			];
 			if (toolOutputs != null) {
-				const castToolOutputs = toolOutputs;
-				const fallthroughCalls = castToolOutputs?.filter((item) => fallthroughCallTypes.includes(item.type));
+				const fallthroughCalls = toolOutputs?.filter((item) => fallthroughCallTypes.includes(item.type));
 				if (fallthroughCalls.length > 0) input.push(...fallthroughCalls);
 			}
 			return input;
@@ -1031,9 +1023,9 @@ const convertMessagesToResponsesInput = ({ messages, zdrEnabled, model }) => {
 				role,
 				content: lcMsg.content
 			};
-			const messages$1 = [];
+			const messages = [];
 			const content = lcMsg.content.flatMap((item) => {
-				if (item.type === "mcp_approval_response") messages$1.push({
+				if (item.type === "mcp_approval_response") messages.push({
 					type: "mcp_approval_response",
 					approval_request_id: item.approval_request_id,
 					approve: item.approve
@@ -1043,32 +1035,26 @@ const convertMessagesToResponsesInput = ({ messages, zdrEnabled, model }) => {
 					type: "input_text",
 					text: item.text
 				};
-				if (item.type === "image_url") {
-					const imageUrl = iife(() => {
+				if (item.type === "image_url") return {
+					type: "input_image",
+					image_url: iife$1(() => {
 						if (typeof item.image_url === "string") return item.image_url;
 						else if (typeof item.image_url === "object" && item.image_url !== null && "url" in item.image_url) return item.image_url.url;
-						return void 0;
-					});
-					const detail = iife(() => {
+					}),
+					detail: iife$1(() => {
 						if (typeof item.image_url === "string") return "auto";
 						else if (typeof item.image_url === "object" && item.image_url !== null && "detail" in item.image_url) return item.image_url.detail;
-						return void 0;
-					});
-					return {
-						type: "input_image",
-						image_url: imageUrl,
-						detail
-					};
-				}
+					})
+				};
 				if (item.type === "input_text" || item.type === "input_image" || item.type === "input_file") return item;
 				return [];
 			});
-			if (content.length > 0) messages$1.push({
+			if (content.length > 0) messages.push({
 				type: "message",
 				role,
 				content
 			});
-			return messages$1;
+			return messages;
 		}
 		console.warn(`Unsupported role found when converting to OpenAI Responses API: ${role}`);
 		return [];