@langchain/xai 1.1.0 → 1.2.0

package/dist/chat_models/responses.js

@@ -0,0 +1,227 @@
+import { convertMessagesToResponsesInput, convertResponseToAIMessage, convertStreamEventToChunk, extractTextFromOutput } from "../converters/responses.js";
+import { getEnvironmentVariable } from "@langchain/core/utils/env";
+import { BaseChatModel } from "@langchain/core/language_models/chat_models";
+
+//#region src/chat_models/responses.ts
+/**
+* xAI Responses API chat model integration.
+*
+* This class provides access to xAI's Responses API, which offers enhanced
+* capabilities including built-in tools, reasoning, and search.
+*
+* @example
+* ```typescript
+* import { ChatXAIResponses } from "@langchain/xai";
+*
+* const llm = new ChatXAIResponses({
+*   model: "grok-3",
+*   temperature: 0.7,
+* });
+*
+* const result = await llm.invoke("What is the capital of France?");
+* console.log(result.content);
+* ```
+*/
+var ChatXAIResponses = class extends BaseChatModel {
+	static lc_name() {
+		return "ChatXAIResponses";
+	}
+	lc_serializable = true;
+	lc_namespace = [
+		"langchain",
+		"chat_models",
+		"xai"
+	];
+	get lc_secrets() {
+		return { apiKey: "XAI_API_KEY" };
+	}
+	get lc_aliases() {
+		return { apiKey: "xai_api_key" };
+	}
+	apiKey;
+	model;
+	streaming;
+	temperature;
+	topP;
+	maxOutputTokens;
+	store;
+	user;
+	baseURL;
+	searchParameters;
+	reasoning;
+	constructor(fields) {
+		super(fields ?? {});
+		const apiKey = fields?.apiKey ?? getEnvironmentVariable("XAI_API_KEY");
+		if (!apiKey) throw new Error(`xAI API key not found. Please set the XAI_API_KEY environment variable or provide the key in the "apiKey" field.`);
+		this.apiKey = apiKey;
+		this.model = fields?.model ?? "grok-3";
+		this.streaming = fields?.streaming ?? false;
+		this.temperature = fields?.temperature;
+		this.topP = fields?.topP;
+		this.maxOutputTokens = fields?.maxOutputTokens;
+		this.store = fields?.store;
+		this.user = fields?.user;
+		this.baseURL = fields?.baseURL ?? "https://api.x.ai/v1";
+		this.searchParameters = fields?.searchParameters;
+		this.reasoning = fields?.reasoning;
+	}
+	_llmType() {
+		return "xai-responses";
+	}
+	getLsParams(options) {
+		const params = super.getLsParams(options);
+		params.ls_provider = "xai";
+		params.ls_model_name = this.model;
+		params.ls_model_type = "chat";
+		params.ls_temperature = this.temperature;
+		params.ls_max_tokens = this.maxOutputTokens;
+		return params;
+	}
+	toJSON() {
+		const result = super.toJSON();
+		if ("kwargs" in result && typeof result.kwargs === "object" && result.kwargs != null) delete result.kwargs.apiKey;
+		return result;
+	}
+	invocationParams(options) {
+		return {
+			model: this.model,
+			temperature: this.temperature,
+			top_p: this.topP,
+			max_output_tokens: this.maxOutputTokens,
+			store: this.store,
+			user: this.user,
+			stream: this.streaming,
+			previous_response_id: options?.previous_response_id,
+			include: options?.include,
+			text: options?.text,
+			search_parameters: options?.search_parameters ?? this.searchParameters,
+			reasoning: options?.reasoning ?? this.reasoning,
+			tool_choice: options?.tool_choice,
+			parallel_tool_calls: options?.parallel_tool_calls
+		};
+	}
+	async _makeRequest(request) {
+		const url = `${this.baseURL}/responses`;
+		const headers = {
+			"Content-Type": "application/json",
+			Authorization: `Bearer ${this.apiKey}`
+		};
+		if (request.stream) return this._makeStreamingRequest(url, headers, request);
+		const response = await this.caller.call(async () => {
+			const res = await fetch(url, {
+				method: "POST",
+				headers,
+				body: JSON.stringify(request)
+			});
+			if (!res.ok) {
+				const errorBody = await res.text();
+				throw new Error(`xAI API error: ${res.status} ${res.statusText} - ${errorBody}`);
+			}
+			return res.json();
+		});
+		return response;
+	}
+	/**
+	* Makes a streaming request to the xAI Responses API.
+	*/
+	async *_makeStreamingRequest(url, headers, request) {
+		const response = await this.caller.call(async () => {
+			const res = await fetch(url, {
+				method: "POST",
+				headers,
+				body: JSON.stringify(request)
+			});
+			if (!res.ok) {
+				const errorBody = await res.text();
+				throw new Error(`xAI API error: ${res.status} ${res.statusText} - ${errorBody}`);
+			}
+			return res;
+		});
+		const reader = response.body?.getReader();
+		if (!reader) throw new Error("No response body");
+		const decoder = new TextDecoder();
+		let buffer = "";
+		try {
+			while (true) {
+				const { done, value } = await reader.read();
+				if (done) break;
+				buffer += decoder.decode(value, { stream: true });
+				const lines = buffer.split("\n");
+				buffer = lines.pop() ?? "";
+				for (const line of lines) {
+					const trimmed = line.trim();
+					if (!trimmed || trimmed === "data: [DONE]") continue;
+					if (trimmed.startsWith("data: ")) try {
+						const data = JSON.parse(trimmed.slice(6));
+						yield data;
+					} catch {}
+				}
+			}
+		} finally {
+			reader.releaseLock();
+		}
+	}
+	async _generate(messages, options, runManager) {
+		const invocationParams = this.invocationParams(options);
+		const input = convertMessagesToResponsesInput(messages);
+		if (invocationParams.stream) {
+			const stream = this._streamResponseChunks(messages, options, runManager);
+			let finalChunk;
+			for await (const chunk of stream) {
+				chunk.message.response_metadata = {
+					...chunk.generationInfo,
+					...chunk.message.response_metadata
+				};
+				finalChunk = finalChunk?.concat(chunk) ?? chunk;
+			}
+			return {
+				generations: finalChunk ? [finalChunk] : [],
+				llmOutput: { estimatedTokenUsage: (finalChunk?.message)?.usage_metadata }
+			};
+		}
+		const response = await this._makeRequest({
+			input,
+			...invocationParams,
+			stream: false
+		});
+		const aiMessage = convertResponseToAIMessage(response);
+		const text = extractTextFromOutput(response.output);
+		return {
+			generations: [{
+				text,
+				message: aiMessage
+			}],
+			llmOutput: {
+				id: response.id,
+				estimatedTokenUsage: response.usage ? {
+					promptTokens: response.usage.input_tokens,
+					completionTokens: response.usage.output_tokens,
+					totalTokens: response.usage.total_tokens
+				} : void 0
+			}
+		};
+	}
+	async *_streamResponseChunks(messages, options, runManager) {
+		const invocationParams = this.invocationParams(options);
+		const input = convertMessagesToResponsesInput(messages);
+		const streamIterable = await this._makeRequest({
+			input,
+			...invocationParams,
+			stream: true
+		});
+		for await (const event of streamIterable) {
+			const chunk = convertStreamEventToChunk(event);
+			if (chunk) {
+				yield chunk;
+				await runManager?.handleLLMNewToken(chunk.text || "", {
+					prompt: 0,
+					completion: 0
+				});
+			}
+		}
+	}
+};
+
+//#endregion
+export { ChatXAIResponses };
+//# sourceMappingURL=responses.js.map

package/dist/chat_models/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","names":["fields?: ChatXAIResponsesInput","options: this[\"ParsedCallOptions\"]","options?: this[\"ParsedCallOptions\"]","request: XAIResponsesCreateParams","headers: Record<string, string>","url: string","messages: BaseMessage[]","runManager?: CallbackManagerForLLMRun","finalChunk: ChatGenerationChunk | undefined"],"sources":["../../src/chat_models/responses.ts"],"sourcesContent":["import { CallbackManagerForLLMRun } from \"@langchain/core/callbacks/manager\";\nimport { AIMessage, BaseMessage } from \"@langchain/core/messages\";\nimport {\n  BaseChatModel,\n  type LangSmithParams,\n} from \"@langchain/core/language_models/chat_models\";\nimport { ChatGenerationChunk, type ChatResult } from \"@langchain/core/outputs\";\nimport { getEnvironmentVariable } from \"@langchain/core/utils/env\";\nimport { Serialized } from \"@langchain/core/load/serializable\";\n\nimport type {\n  ChatXAIResponsesCallOptions,\n  ChatXAIResponsesInput,\n  ChatXAIResponsesInvocationParams,\n  XAIResponse,\n  XAIResponsesCreateParams,\n  XAIResponsesCreateParamsNonStreaming,\n  XAIResponsesCreateParamsStreaming,\n  XAIResponsesReasoning,\n  XAIResponsesSearchParameters,\n  XAIResponsesStreamEvent,\n} from \"./responses-types.js\";\n\nimport {\n  convertMessagesToResponsesInput,\n  convertResponseToAIMessage,\n  convertStreamEventToChunk,\n  extractTextFromOutput,\n} from \"../converters/responses.js\";\n\n// Re-export types for convenience\nexport type {\n  ChatXAIResponsesCallOptions,\n  ChatXAIResponsesInput,\n  ChatXAIResponsesInvocationParams,\n};\n\n// ============================================================================\n// Main Class\n// ============================================================================\n\n/**\n * xAI Responses API chat model integration.\n *\n * This class provides access to xAI's Responses API, which offers enhanced\n * capabilities including built-in tools, reasoning, and search.\n *\n * @example\n * ```typescript\n * import { ChatXAIResponses } from \"@langchain/xai\";\n *\n * const llm = new ChatXAIResponses({\n *   model: \"grok-3\",\n *   temperature: 0.7,\n * });\n *\n * const result = await llm.invoke(\"What is the capital of France?\");\n * console.log(result.content);\n * ```\n */\nexport class ChatXAIResponses<\n  CallOptions extends ChatXAIResponsesCallOptions = ChatXAIResponsesCallOptions,\n> extends BaseChatModel<CallOptions> {\n  static lc_name() {\n    return \"ChatXAIResponses\";\n  }\n\n  lc_serializable = true;\n\n  lc_namespace = [\"langchain\", \"chat_models\", \"xai\"];\n\n  get lc_secrets(): { [key: string]: string } | undefined {\n    return {\n      apiKey: \"XAI_API_KEY\",\n    };\n  }\n\n  get lc_aliases(): { [key: string]: string } | undefined {\n    return {\n      apiKey: \"xai_api_key\",\n    };\n  }\n\n  // -------------------------------------------------------------------------\n  // Instance Properties\n  // -------------------------------------------------------------------------\n\n  apiKey: string;\n\n  model: string;\n\n  streaming: boolean;\n\n  temperature?: number;\n\n  topP?: number;\n\n  maxOutputTokens?: number;\n\n  store?: boolean;\n\n  user?: string;\n\n  baseURL: string;\n\n  searchParameters?: XAIResponsesSearchParameters;\n\n  reasoning?: XAIResponsesReasoning;\n\n  // -------------------------------------------------------------------------\n  // Constructor\n  // -------------------------------------------------------------------------\n\n  constructor(fields?: ChatXAIResponsesInput) {\n    super(fields ?? {});\n\n    const apiKey = fields?.apiKey ?? getEnvironmentVariable(\"XAI_API_KEY\");\n    if (!apiKey) {\n      throw new Error(\n        `xAI API key not found. Please set the XAI_API_KEY environment variable or provide the key in the \"apiKey\" field.`\n      );\n    }\n\n    this.apiKey = apiKey;\n    this.model = fields?.model ?? \"grok-3\";\n    this.streaming = fields?.streaming ?? false;\n    this.temperature = fields?.temperature;\n    this.topP = fields?.topP;\n    this.maxOutputTokens = fields?.maxOutputTokens;\n    this.store = fields?.store;\n    this.user = fields?.user;\n    this.baseURL = fields?.baseURL ?? \"https://api.x.ai/v1\";\n    this.searchParameters = fields?.searchParameters;\n    this.reasoning = fields?.reasoning;\n  }\n\n  // -------------------------------------------------------------------------\n  // Metadata Methods\n  // -------------------------------------------------------------------------\n\n  _llmType(): string {\n    return \"xai-responses\";\n  }\n\n  override getLsParams(options: this[\"ParsedCallOptions\"]): LangSmithParams {\n    const params = super.getLsParams(options);\n    params.ls_provider = \"xai\";\n    params.ls_model_name = this.model;\n    params.ls_model_type = \"chat\";\n    params.ls_temperature = this.temperature;\n    params.ls_max_tokens = this.maxOutputTokens;\n    return params;\n  }\n\n  override toJSON(): Serialized {\n    const result = super.toJSON();\n\n    if (\n      \"kwargs\" in result &&\n      typeof result.kwargs === \"object\" &&\n      result.kwargs != null\n    ) {\n      delete (result.kwargs as Record<string, unknown>).apiKey;\n    }\n\n    return result;\n  }\n\n  // -------------------------------------------------------------------------\n  // Invocation Params\n  // -------------------------------------------------------------------------\n\n  invocationParams(\n    options?: this[\"ParsedCallOptions\"]\n  ): ChatXAIResponsesInvocationParams {\n    return {\n      model: this.model,\n      temperature: this.temperature,\n      top_p: this.topP,\n      max_output_tokens: this.maxOutputTokens,\n      store: this.store,\n      user: this.user,\n      stream: this.streaming,\n      previous_response_id: options?.previous_response_id,\n      include: options?.include,\n      text: options?.text,\n      search_parameters: options?.search_parameters ?? this.searchParameters,\n      reasoning: options?.reasoning ?? this.reasoning,\n      tool_choice: options?.tool_choice,\n      parallel_tool_calls: options?.parallel_tool_calls,\n    };\n  }\n\n  // -------------------------------------------------------------------------\n  // API Call Methods\n  // -------------------------------------------------------------------------\n\n  /**\n   * Makes a request to the xAI Responses API.\n   */\n  protected async _makeRequest(\n    request: XAIResponsesCreateParamsNonStreaming\n  ): Promise<XAIResponse>;\n\n  protected async _makeRequest(\n    request: XAIResponsesCreateParamsStreaming\n  ): Promise<AsyncIterable<XAIResponsesStreamEvent>>;\n\n  protected async _makeRequest(\n    request: XAIResponsesCreateParams\n  ): Promise<XAIResponse | AsyncIterable<XAIResponsesStreamEvent>> {\n    const url = `${this.baseURL}/responses`;\n\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      Authorization: `Bearer ${this.apiKey}`,\n    };\n\n    if (request.stream) {\n      return this._makeStreamingRequest(url, headers, request);\n    }\n\n    const response = await this.caller.call(async () => {\n      const res = await fetch(url, {\n        method: \"POST\",\n        headers,\n        body: JSON.stringify(request),\n      });\n\n      if (!res.ok) {\n        const errorBody = await res.text();\n        throw new Error(\n          `xAI API error: ${res.status} ${res.statusText} - ${errorBody}`\n        );\n      }\n\n      return res.json();\n    });\n\n    return response as XAIResponse;\n  }\n\n  /**\n   * Makes a streaming request to the xAI Responses API.\n   */\n  protected async *_makeStreamingRequest(\n    url: string,\n    headers: Record<string, string>,\n    request: XAIResponsesCreateParams\n  ): AsyncIterable<XAIResponsesStreamEvent> {\n    const response = await this.caller.call(async () => {\n      const res = await fetch(url, {\n        method: \"POST\",\n        headers,\n        body: JSON.stringify(request),\n      });\n\n      if (!res.ok) {\n        const errorBody = await res.text();\n        throw new Error(\n          `xAI API error: ${res.status} ${res.statusText} - ${errorBody}`\n        );\n      }\n\n      return res;\n    });\n\n    const reader = response.body?.getReader();\n    if (!reader) {\n      throw new Error(\"No response body\");\n    }\n\n    const decoder = new TextDecoder();\n    let buffer = \"\";\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split(\"\\n\");\n        buffer = lines.pop() ?? \"\";\n\n        for (const line of lines) {\n          const trimmed = line.trim();\n          if (!trimmed || trimmed === \"data: [DONE]\") continue;\n\n          if (trimmed.startsWith(\"data: \")) {\n            try {\n              const data = JSON.parse(trimmed.slice(6));\n              yield data as XAIResponsesStreamEvent;\n            } catch {\n              // Skip invalid JSON\n            }\n          }\n        }\n      }\n    } finally {\n      reader.releaseLock();\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Generation Methods\n  // -------------------------------------------------------------------------\n\n  async _generate(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    runManager?: CallbackManagerForLLMRun\n  ): Promise<ChatResult> {\n    const invocationParams = this.invocationParams(options);\n    const input = convertMessagesToResponsesInput(messages);\n\n    if (invocationParams.stream) {\n      const stream = this._streamResponseChunks(messages, options, runManager);\n      let finalChunk: ChatGenerationChunk | undefined;\n\n      for await (const chunk of stream) {\n        chunk.message.response_metadata = {\n          ...chunk.generationInfo,\n          ...chunk.message.response_metadata,\n        };\n        finalChunk = finalChunk?.concat(chunk) ?? chunk;\n      }\n\n      return {\n        generations: finalChunk ? [finalChunk] : [],\n        llmOutput: {\n          estimatedTokenUsage: (finalChunk?.message as AIMessage | undefined)\n            ?.usage_metadata,\n        },\n      };\n    }\n\n    const response = await this._makeRequest({\n      input,\n      ...invocationParams,\n      stream: false,\n    } as XAIResponsesCreateParamsNonStreaming);\n\n    const aiMessage = convertResponseToAIMessage(response);\n    const text = extractTextFromOutput(response.output);\n\n    return {\n      generations: [\n        {\n          text,\n          message: aiMessage,\n        },\n      ],\n      llmOutput: {\n        id: response.id,\n        estimatedTokenUsage: response.usage\n          ? {\n              promptTokens: response.usage.input_tokens,\n              completionTokens: response.usage.output_tokens,\n              totalTokens: response.usage.total_tokens,\n            }\n          : undefined,\n      },\n    };\n  }\n\n  async *_streamResponseChunks(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    runManager?: CallbackManagerForLLMRun\n  ): AsyncGenerator<ChatGenerationChunk> {\n    const invocationParams = this.invocationParams(options);\n    const input = convertMessagesToResponsesInput(messages);\n\n    const streamIterable = await this._makeRequest({\n      input,\n      ...invocationParams,\n      stream: true,\n    } as XAIResponsesCreateParamsStreaming);\n\n    for await (const event of streamIterable) {\n      const chunk = convertStreamEventToChunk(event);\n      if (chunk) {\n        yield chunk;\n        await runManager?.handleLLMNewToken(chunk.text || \"\", {\n          prompt: 0,\n          completion: 0,\n        });\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/converters/responses.cjs

@@ -0,0 +1,168 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const __langchain_core_messages = require_rolldown_runtime.__toESM(require("@langchain/core/messages"));
+const __langchain_core_outputs = require_rolldown_runtime.__toESM(require("@langchain/core/outputs"));
+
+//#region src/converters/responses.ts
+/**
+* Converts a single LangChain BaseMessage to xAI Responses API input format.
+*
+* @param message - The LangChain message to convert
+* @returns The xAI Responses API input item
+*/
+function convertMessageToResponsesInput(message) {
+	if (message.type === "human") {
+		const content = typeof message.content === "string" ? message.content : message.content.map((part) => {
+			if (typeof part === "string") return {
+				type: "input_text",
+				text: part
+			};
+			if (part.type === "text") return {
+				type: "input_text",
+				text: part.text
+			};
+			if (part.type === "image_url") {
+				const imageUrlPart = part;
+				const imageUrl = typeof imageUrlPart.image_url === "string" ? imageUrlPart.image_url : imageUrlPart.image_url.url;
+				return {
+					type: "input_image",
+					image_url: imageUrl,
+					detail: "auto"
+				};
+			}
+			return {
+				type: "input_text",
+				text: ""
+			};
+		});
+		return {
+			role: "user",
+			content
+		};
+	}
+	if (message.type === "system") return {
+		role: "system",
+		content: typeof message.content === "string" ? message.content : message.content.map((part) => typeof part === "string" ? part : part.text || "").join("")
+	};
+	if (message.type === "ai") {
+		const aiMessage = message;
+		return {
+			type: "message",
+			role: "assistant",
+			text: typeof aiMessage.content === "string" ? aiMessage.content : ""
+		};
+	}
+	return {
+		role: "user",
+		content: typeof message.content === "string" ? message.content : JSON.stringify(message.content)
+	};
+}
+/**
+* Converts an array of LangChain BaseMessages to xAI Responses API input format.
+*
+* @param messages - Array of LangChain messages to convert
+* @returns Array of xAI Responses API input items
+*/
+function convertMessagesToResponsesInput(messages) {
+	return messages.map(convertMessageToResponsesInput);
+}
+/**
+* Converts xAI usage statistics to LangChain UsageMetadata format.
+*
+* @param usage - The xAI usage statistics
+* @returns LangChain UsageMetadata object
+*/
+function convertUsageToUsageMetadata(usage) {
+	return {
+		input_tokens: usage?.input_tokens ?? 0,
+		output_tokens: usage?.output_tokens ?? 0,
+		total_tokens: usage?.total_tokens ?? 0,
+		input_token_details: { ...usage?.input_tokens_details?.cached_tokens != null && { cache_read: usage.input_tokens_details.cached_tokens } },
+		output_token_details: { ...usage?.output_tokens_details?.reasoning_tokens != null && { reasoning: usage.output_tokens_details.reasoning_tokens } }
+	};
+}
+/**
+* Extracts text content from xAI response output items.
+*
+* @param output - Array of xAI response output items
+* @returns Concatenated text content
+*/
+function extractTextFromOutput(output) {
+	const textParts = [];
+	for (const item of output) if (item.type === "message" && "content" in item) {
+		for (const contentItem of item.content) if (contentItem.type === "output_text") textParts.push(contentItem.text);
+	}
+	return textParts.join("");
+}
+/**
+* Converts an xAI Response to a LangChain AIMessage.
+*
+* @param response - The xAI API response
+* @returns LangChain AIMessage
+*/
+function convertResponseToAIMessage(response) {
+	const text = extractTextFromOutput(response.output);
+	const responseMetadata = {
+		model_provider: "xai",
+		model: response.model,
+		created_at: response.created_at,
+		id: response.id,
+		status: response.status,
+		object: response.object
+	};
+	if (response.incomplete_details) responseMetadata.incomplete_details = response.incomplete_details;
+	return new __langchain_core_messages.AIMessage({
+		content: text,
+		usage_metadata: convertUsageToUsageMetadata(response.usage),
+		response_metadata: responseMetadata,
+		additional_kwargs: { ...response.reasoning && { reasoning: response.reasoning } }
+	});
+}
+/**
+* Converts an xAI streaming event to a LangChain ChatGenerationChunk.
+*
+* @param event - The xAI streaming event
+* @returns ChatGenerationChunk or null if the event doesn't produce a chunk
+*/
+function convertStreamEventToChunk(event) {
+	const responseMetadata = { model_provider: "xai" };
+	if (event.type === "response.output_text.delta") return new __langchain_core_outputs.ChatGenerationChunk({
+		text: event.delta,
+		message: new __langchain_core_messages.AIMessageChunk({
+			content: event.delta,
+			response_metadata: responseMetadata
+		})
+	});
+	if (event.type === "response.created") {
+		responseMetadata.id = event.response.id;
+		responseMetadata.model = event.response.model;
+		return new __langchain_core_outputs.ChatGenerationChunk({
+			text: "",
+			message: new __langchain_core_messages.AIMessageChunk({
+				content: "",
+				response_metadata: responseMetadata
+			})
+		});
+	}
+	if (event.type === "response.completed") {
+		const aiMessage = convertResponseToAIMessage(event.response);
+		return new __langchain_core_outputs.ChatGenerationChunk({
+			text: "",
+			message: new __langchain_core_messages.AIMessageChunk({
+				content: "",
+				usage_metadata: aiMessage.usage_metadata,
+				response_metadata: {
+					...responseMetadata,
+					...aiMessage.response_metadata
+				}
+			})
+		});
+	}
+	return null;
+}
+
+//#endregion
+exports.convertMessagesToResponsesInput = convertMessagesToResponsesInput;
+exports.convertResponseToAIMessage = convertResponseToAIMessage;
+exports.convertStreamEventToChunk = convertStreamEventToChunk;
+exports.extractTextFromOutput = extractTextFromOutput;
+//# sourceMappingURL=responses.cjs.map

package/dist/converters/responses.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.cjs","names":["message: BaseMessage","messages: BaseMessage[]","usage: XAIResponsesUsage | null | undefined","output: XAIResponsesOutputItem[]","textParts: string[]","response: XAIResponse","responseMetadata: Record<string, unknown>","AIMessage","event: XAIResponsesStreamEvent","ChatGenerationChunk","AIMessageChunk"],"sources":["../../src/converters/responses.ts"],"sourcesContent":["import {\n  AIMessage,\n  AIMessageChunk,\n  BaseMessage,\n  type UsageMetadata,\n} from \"@langchain/core/messages\";\nimport { ChatGenerationChunk } from \"@langchain/core/outputs\";\n\nimport type {\n  XAIResponse,\n  XAIResponsesInputItem,\n  XAIResponsesMessage,\n  XAIResponsesOutputContent,\n  XAIResponsesOutputItem,\n  XAIResponsesStreamEvent,\n  XAIResponsesUsage,\n} from \"../chat_models/responses-types.js\";\n\n// ============================================================================\n// Message Converters\n// ============================================================================\n\n/**\n * Converts a single LangChain BaseMessage to xAI Responses API input format.\n *\n * @param message - The LangChain message to convert\n * @returns The xAI Responses API input item\n */\nexport function convertMessageToResponsesInput(\n  message: BaseMessage\n): XAIResponsesInputItem {\n  if (message.type === \"human\") {\n    const content =\n      typeof message.content === \"string\"\n        ? message.content\n        : message.content.map((part) => {\n            if (typeof part === \"string\") {\n              return { type: \"input_text\" as const, text: part };\n            }\n            if (part.type === \"text\") {\n              return { type: \"input_text\" as const, text: part.text };\n            }\n            if (part.type === \"image_url\") {\n              const imageUrlPart = part as {\n                type: \"image_url\";\n                image_url: string | { url: string };\n              };\n              const imageUrl =\n                typeof imageUrlPart.image_url === \"string\"\n                  ? imageUrlPart.image_url\n                  : imageUrlPart.image_url.url;\n              return {\n                type: \"input_image\" as const,\n                image_url: imageUrl,\n                detail: \"auto\" as const,\n              };\n            }\n            return { type: \"input_text\" as const, text: \"\" };\n          });\n\n    return {\n      role: \"user\",\n      content,\n    } as XAIResponsesMessage;\n  }\n\n  if (message.type === \"system\") {\n    return {\n      role: \"system\",\n      content:\n        typeof message.content === \"string\"\n          ? message.content\n          : message.content\n              .map((part) =>\n                typeof part === \"string\" ? part : part.text || \"\"\n              )\n              .join(\"\"),\n    } as XAIResponsesMessage;\n  }\n\n  if (message.type === \"ai\") {\n    const aiMessage = message as AIMessage;\n    return {\n      type: \"message\",\n      role: \"assistant\",\n      text: typeof aiMessage.content === \"string\" ? aiMessage.content : \"\",\n    } as unknown as XAIResponsesInputItem;\n  }\n\n  // Default fallback\n  return {\n    role: \"user\",\n    content:\n      typeof message.content === \"string\"\n        ? message.content\n        : JSON.stringify(message.content),\n  } as XAIResponsesMessage;\n}\n\n/**\n * Converts an array of LangChain BaseMessages to xAI Responses API input format.\n *\n * @param messages - Array of LangChain messages to convert\n * @returns Array of xAI Responses API input items\n */\nexport function convertMessagesToResponsesInput(\n  messages: BaseMessage[]\n): XAIResponsesInputItem[] {\n  return messages.map(convertMessageToResponsesInput);\n}\n\n// ============================================================================\n// Usage Converters\n// ============================================================================\n\n/**\n * Converts xAI usage statistics to LangChain UsageMetadata format.\n *\n * @param usage - The xAI usage statistics\n * @returns LangChain UsageMetadata object\n */\nexport function convertUsageToUsageMetadata(\n  usage: XAIResponsesUsage | null | undefined\n): UsageMetadata {\n  return {\n    input_tokens: usage?.input_tokens ?? 0,\n    output_tokens: usage?.output_tokens ?? 0,\n    total_tokens: usage?.total_tokens ?? 0,\n    input_token_details: {\n      ...(usage?.input_tokens_details?.cached_tokens != null && {\n        cache_read: usage.input_tokens_details.cached_tokens,\n      }),\n    },\n    output_token_details: {\n      ...(usage?.output_tokens_details?.reasoning_tokens != null && {\n        reasoning: usage.output_tokens_details.reasoning_tokens,\n      }),\n    },\n  };\n}\n\n// ============================================================================\n// Output Converters\n// ============================================================================\n\n/**\n * Extracts text content from xAI response output items.\n *\n * @param output - Array of xAI response output items\n * @returns Concatenated text content\n */\nexport function extractTextFromOutput(\n  output: XAIResponsesOutputItem[]\n): string {\n  const textParts: string[] = [];\n\n  for (const item of output) {\n    if (item.type === \"message\" && \"content\" in item) {\n      for (const contentItem of item.content as XAIResponsesOutputContent[]) {\n        if (contentItem.type === \"output_text\") {\n          textParts.push(contentItem.text);\n        }\n      }\n    }\n  }\n\n  return textParts.join(\"\");\n}\n\n/**\n * Converts an xAI Response to a LangChain AIMessage.\n *\n * @param response - The xAI API response\n * @returns LangChain AIMessage\n */\nexport function convertResponseToAIMessage(response: XAIResponse): AIMessage {\n  const text = extractTextFromOutput(response.output);\n\n  const responseMetadata: Record<string, unknown> = {\n    model_provider: \"xai\",\n    model: response.model,\n    created_at: response.created_at,\n    id: response.id,\n    status: response.status,\n    object: response.object,\n  };\n\n  if (response.incomplete_details) {\n    responseMetadata.incomplete_details = response.incomplete_details;\n  }\n\n  return new AIMessage({\n    content: text,\n    usage_metadata: convertUsageToUsageMetadata(response.usage),\n    response_metadata: responseMetadata,\n    additional_kwargs: {\n      ...(response.reasoning && { reasoning: response.reasoning }),\n    },\n  });\n}\n\n// ============================================================================\n// Streaming Converters\n// ============================================================================\n\n/**\n * Converts an xAI streaming event to a LangChain ChatGenerationChunk.\n *\n * @param event - The xAI streaming event\n * @returns ChatGenerationChunk or null if the event doesn't produce a chunk\n */\nexport function convertStreamEventToChunk(\n  event: XAIResponsesStreamEvent\n): ChatGenerationChunk | null {\n  const responseMetadata: Record<string, unknown> = {\n    model_provider: \"xai\",\n  };\n\n  if (event.type === \"response.output_text.delta\") {\n    return new ChatGenerationChunk({\n      text: event.delta,\n      message: new AIMessageChunk({\n        content: event.delta,\n        response_metadata: responseMetadata,\n      }),\n    });\n  }\n\n  if (event.type === \"response.created\") {\n    responseMetadata.id = event.response.id;\n    responseMetadata.model = event.response.model;\n    return new ChatGenerationChunk({\n      text: \"\",\n      message: new AIMessageChunk({\n        content: \"\",\n        response_metadata: responseMetadata,\n      }),\n    });\n  }\n\n  if (event.type === \"response.completed\") {\n    const aiMessage = convertResponseToAIMessage(event.response);\n    return new ChatGenerationChunk({\n      text: \"\",\n      message: new AIMessageChunk({\n        content: \"\",\n        usage_metadata: aiMessage.usage_metadata,\n        response_metadata: {\n          ...responseMetadata,\n          ...aiMessage.response_metadata,\n        },\n      }),\n    });\n  }\n\n  return null;\n}\n"],"mappings":"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"}

package/dist/converters/responses.js

@@ -0,0 +1,164 @@
+import { AIMessage, AIMessageChunk } from "@langchain/core/messages";
+import { ChatGenerationChunk } from "@langchain/core/outputs";
+
+//#region src/converters/responses.ts
+/**
+* Converts a single LangChain BaseMessage to xAI Responses API input format.
+*
+* @param message - The LangChain message to convert
+* @returns The xAI Responses API input item
+*/
+function convertMessageToResponsesInput(message) {
+	if (message.type === "human") {
+		const content = typeof message.content === "string" ? message.content : message.content.map((part) => {
+			if (typeof part === "string") return {
+				type: "input_text",
+				text: part
+			};
+			if (part.type === "text") return {
+				type: "input_text",
+				text: part.text
+			};
+			if (part.type === "image_url") {
+				const imageUrlPart = part;
+				const imageUrl = typeof imageUrlPart.image_url === "string" ? imageUrlPart.image_url : imageUrlPart.image_url.url;
+				return {
+					type: "input_image",
+					image_url: imageUrl,
+					detail: "auto"
+				};
+			}
+			return {
+				type: "input_text",
+				text: ""
+			};
+		});
+		return {
+			role: "user",
+			content
+		};
+	}
+	if (message.type === "system") return {
+		role: "system",
+		content: typeof message.content === "string" ? message.content : message.content.map((part) => typeof part === "string" ? part : part.text || "").join("")
+	};
+	if (message.type === "ai") {
+		const aiMessage = message;
+		return {
+			type: "message",
+			role: "assistant",
+			text: typeof aiMessage.content === "string" ? aiMessage.content : ""
+		};
+	}
+	return {
+		role: "user",
+		content: typeof message.content === "string" ? message.content : JSON.stringify(message.content)
+	};
+}
+/**
+* Converts an array of LangChain BaseMessages to xAI Responses API input format.
+*
+* @param messages - Array of LangChain messages to convert
+* @returns Array of xAI Responses API input items
+*/
+function convertMessagesToResponsesInput(messages) {
+	return messages.map(convertMessageToResponsesInput);
+}
+/**
+* Converts xAI usage statistics to LangChain UsageMetadata format.
+*
+* @param usage - The xAI usage statistics
+* @returns LangChain UsageMetadata object
+*/
+function convertUsageToUsageMetadata(usage) {
+	return {
+		input_tokens: usage?.input_tokens ?? 0,
+		output_tokens: usage?.output_tokens ?? 0,
+		total_tokens: usage?.total_tokens ?? 0,
+		input_token_details: { ...usage?.input_tokens_details?.cached_tokens != null && { cache_read: usage.input_tokens_details.cached_tokens } },
+		output_token_details: { ...usage?.output_tokens_details?.reasoning_tokens != null && { reasoning: usage.output_tokens_details.reasoning_tokens } }
+	};
+}
+/**
+* Extracts text content from xAI response output items.
+*
+* @param output - Array of xAI response output items
+* @returns Concatenated text content
+*/
+function extractTextFromOutput(output) {
+	const textParts = [];
+	for (const item of output) if (item.type === "message" && "content" in item) {
+		for (const contentItem of item.content) if (contentItem.type === "output_text") textParts.push(contentItem.text);
+	}
+	return textParts.join("");
+}
+/**
+* Converts an xAI Response to a LangChain AIMessage.
+*
+* @param response - The xAI API response
+* @returns LangChain AIMessage
+*/
+function convertResponseToAIMessage(response) {
+	const text = extractTextFromOutput(response.output);
+	const responseMetadata = {
+		model_provider: "xai",
+		model: response.model,
+		created_at: response.created_at,
+		id: response.id,
+		status: response.status,
+		object: response.object
+	};
+	if (response.incomplete_details) responseMetadata.incomplete_details = response.incomplete_details;
+	return new AIMessage({
+		content: text,
+		usage_metadata: convertUsageToUsageMetadata(response.usage),
+		response_metadata: responseMetadata,
+		additional_kwargs: { ...response.reasoning && { reasoning: response.reasoning } }
+	});
+}
+/**
+* Converts an xAI streaming event to a LangChain ChatGenerationChunk.
+*
+* @param event - The xAI streaming event
+* @returns ChatGenerationChunk or null if the event doesn't produce a chunk
+*/
+function convertStreamEventToChunk(event) {
+	const responseMetadata = { model_provider: "xai" };
+	if (event.type === "response.output_text.delta") return new ChatGenerationChunk({
+		text: event.delta,
+		message: new AIMessageChunk({
+			content: event.delta,
+			response_metadata: responseMetadata
+		})
+	});
+	if (event.type === "response.created") {
+		responseMetadata.id = event.response.id;
+		responseMetadata.model = event.response.model;
+		return new ChatGenerationChunk({
+			text: "",
+			message: new AIMessageChunk({
+				content: "",
+				response_metadata: responseMetadata
+			})
+		});
+	}
+	if (event.type === "response.completed") {
+		const aiMessage = convertResponseToAIMessage(event.response);
+		return new ChatGenerationChunk({
+			text: "",
+			message: new AIMessageChunk({
+				content: "",
+				usage_metadata: aiMessage.usage_metadata,
+				response_metadata: {
+					...responseMetadata,
+					...aiMessage.response_metadata
+				}
+			})
+		});
+	}
+	return null;
+}
+
+//#endregion
+export { convertMessagesToResponsesInput, convertResponseToAIMessage, convertStreamEventToChunk, extractTextFromOutput };
+//# sourceMappingURL=responses.js.map

package/dist/converters/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","names":["message: BaseMessage","messages: BaseMessage[]","usage: XAIResponsesUsage | null | undefined","output: XAIResponsesOutputItem[]","textParts: string[]","response: XAIResponse","responseMetadata: Record<string, unknown>","event: XAIResponsesStreamEvent"],"sources":["../../src/converters/responses.ts"],"sourcesContent":["import {\n  AIMessage,\n  AIMessageChunk,\n  BaseMessage,\n  type UsageMetadata,\n} from \"@langchain/core/messages\";\nimport { ChatGenerationChunk } from \"@langchain/core/outputs\";\n\nimport type {\n  XAIResponse,\n  XAIResponsesInputItem,\n  XAIResponsesMessage,\n  XAIResponsesOutputContent,\n  XAIResponsesOutputItem,\n  XAIResponsesStreamEvent,\n  XAIResponsesUsage,\n} from \"../chat_models/responses-types.js\";\n\n// ============================================================================\n// Message Converters\n// ============================================================================\n\n/**\n * Converts a single LangChain BaseMessage to xAI Responses API input format.\n *\n * @param message - The LangChain message to convert\n * @returns The xAI Responses API input item\n */\nexport function convertMessageToResponsesInput(\n  message: BaseMessage\n): XAIResponsesInputItem {\n  if (message.type === \"human\") {\n    const content =\n      typeof message.content === \"string\"\n        ? message.content\n        : message.content.map((part) => {\n            if (typeof part === \"string\") {\n              return { type: \"input_text\" as const, text: part };\n            }\n            if (part.type === \"text\") {\n              return { type: \"input_text\" as const, text: part.text };\n            }\n            if (part.type === \"image_url\") {\n              const imageUrlPart = part as {\n                type: \"image_url\";\n                image_url: string | { url: string };\n              };\n              const imageUrl =\n                typeof imageUrlPart.image_url === \"string\"\n                  ? imageUrlPart.image_url\n                  : imageUrlPart.image_url.url;\n              return {\n                type: \"input_image\" as const,\n                image_url: imageUrl,\n                detail: \"auto\" as const,\n              };\n            }\n            return { type: \"input_text\" as const, text: \"\" };\n          });\n\n    return {\n      role: \"user\",\n      content,\n    } as XAIResponsesMessage;\n  }\n\n  if (message.type === \"system\") {\n    return {\n      role: \"system\",\n      content:\n        typeof message.content === \"string\"\n          ? message.content\n          : message.content\n              .map((part) =>\n                typeof part === \"string\" ? part : part.text || \"\"\n              )\n              .join(\"\"),\n    } as XAIResponsesMessage;\n  }\n\n  if (message.type === \"ai\") {\n    const aiMessage = message as AIMessage;\n    return {\n      type: \"message\",\n      role: \"assistant\",\n      text: typeof aiMessage.content === \"string\" ? aiMessage.content : \"\",\n    } as unknown as XAIResponsesInputItem;\n  }\n\n  // Default fallback\n  return {\n    role: \"user\",\n    content:\n      typeof message.content === \"string\"\n        ? message.content\n        : JSON.stringify(message.content),\n  } as XAIResponsesMessage;\n}\n\n/**\n * Converts an array of LangChain BaseMessages to xAI Responses API input format.\n *\n * @param messages - Array of LangChain messages to convert\n * @returns Array of xAI Responses API input items\n */\nexport function convertMessagesToResponsesInput(\n  messages: BaseMessage[]\n): XAIResponsesInputItem[] {\n  return messages.map(convertMessageToResponsesInput);\n}\n\n// ============================================================================\n// Usage Converters\n// ============================================================================\n\n/**\n * Converts xAI usage statistics to LangChain UsageMetadata format.\n *\n * @param usage - The xAI usage statistics\n * @returns LangChain UsageMetadata object\n */\nexport function convertUsageToUsageMetadata(\n  usage: XAIResponsesUsage | null | undefined\n): UsageMetadata {\n  return {\n    input_tokens: usage?.input_tokens ?? 0,\n    output_tokens: usage?.output_tokens ?? 0,\n    total_tokens: usage?.total_tokens ?? 0,\n    input_token_details: {\n      ...(usage?.input_tokens_details?.cached_tokens != null && {\n        cache_read: usage.input_tokens_details.cached_tokens,\n      }),\n    },\n    output_token_details: {\n      ...(usage?.output_tokens_details?.reasoning_tokens != null && {\n        reasoning: usage.output_tokens_details.reasoning_tokens,\n      }),\n    },\n  };\n}\n\n// ============================================================================\n// Output Converters\n// ============================================================================\n\n/**\n * Extracts text content from xAI response output items.\n *\n * @param output - Array of xAI response output items\n * @returns Concatenated text content\n */\nexport function extractTextFromOutput(\n  output: XAIResponsesOutputItem[]\n): string {\n  const textParts: string[] = [];\n\n  for (const item of output) {\n    if (item.type === \"message\" && \"content\" in item) {\n      for (const contentItem of item.content as XAIResponsesOutputContent[]) {\n        if (contentItem.type === \"output_text\") {\n          textParts.push(contentItem.text);\n        }\n      }\n    }\n  }\n\n  return textParts.join(\"\");\n}\n\n/**\n * Converts an xAI Response to a LangChain AIMessage.\n *\n * @param response - The xAI API response\n * @returns LangChain AIMessage\n */\nexport function convertResponseToAIMessage(response: XAIResponse): AIMessage {\n  const text = extractTextFromOutput(response.output);\n\n  const responseMetadata: Record<string, unknown> = {\n    model_provider: \"xai\",\n    model: response.model,\n    created_at: response.created_at,\n    id: response.id,\n    status: response.status,\n    object: response.object,\n  };\n\n  if (response.incomplete_details) {\n    responseMetadata.incomplete_details = response.incomplete_details;\n  }\n\n  return new AIMessage({\n    content: text,\n    usage_metadata: convertUsageToUsageMetadata(response.usage),\n    response_metadata: responseMetadata,\n    additional_kwargs: {\n      ...(response.reasoning && { reasoning: response.reasoning }),\n    },\n  });\n}\n\n// ============================================================================\n// Streaming Converters\n// ============================================================================\n\n/**\n * Converts an xAI streaming event to a LangChain ChatGenerationChunk.\n *\n * @param event - The xAI streaming event\n * @returns ChatGenerationChunk or null if the event doesn't produce a chunk\n */\nexport function convertStreamEventToChunk(\n  event: XAIResponsesStreamEvent\n): ChatGenerationChunk | null {\n  const responseMetadata: Record<string, unknown> = {\n    model_provider: \"xai\",\n  };\n\n  if (event.type === \"response.output_text.delta\") {\n    return new ChatGenerationChunk({\n      text: event.delta,\n      message: new AIMessageChunk({\n        content: event.delta,\n        response_metadata: responseMetadata,\n      }),\n    });\n  }\n\n  if (event.type === \"response.created\") {\n    responseMetadata.id = event.response.id;\n    responseMetadata.model = event.response.model;\n    return new ChatGenerationChunk({\n      text: \"\",\n      message: new AIMessageChunk({\n        content: \"\",\n        response_metadata: responseMetadata,\n      }),\n    });\n  }\n\n  if (event.type === \"response.completed\") {\n    const aiMessage = convertResponseToAIMessage(event.response);\n    return new ChatGenerationChunk({\n      text: \"\",\n      message: new AIMessageChunk({\n        content: \"\",\n        usage_metadata: aiMessage.usage_metadata,\n        response_metadata: {\n          ...responseMetadata,\n          ...aiMessage.response_metadata,\n        },\n      }),\n    });\n  }\n\n  return null;\n}\n"],"mappings":";;;;;;;;;;AA4BA,SAAgB,+BACdA,SACuB;AACvB,KAAI,QAAQ,SAAS,SAAS;EAC5B,MAAM,UACJ,OAAO,QAAQ,YAAY,WACvB,QAAQ,UACR,QAAQ,QAAQ,IAAI,CAAC,SAAS;AAC5B,OAAI,OAAO,SAAS,SAClB,QAAO;IAAE,MAAM;IAAuB,MAAM;GAAM;AAEpD,OAAI,KAAK,SAAS,OAChB,QAAO;IAAE,MAAM;IAAuB,MAAM,KAAK;GAAM;AAEzD,OAAI,KAAK,SAAS,aAAa;IAC7B,MAAM,eAAe;IAIrB,MAAM,WACJ,OAAO,aAAa,cAAc,WAC9B,aAAa,YACb,aAAa,UAAU;AAC7B,WAAO;KACL,MAAM;KACN,WAAW;KACX,QAAQ;IACT;GACF;AACD,UAAO;IAAE,MAAM;IAAuB,MAAM;GAAI;EACjD,EAAC;AAER,SAAO;GACL,MAAM;GACN;EACD;CACF;AAED,KAAI,QAAQ,SAAS,SACnB,QAAO;EACL,MAAM;EACN,SACE,OAAO,QAAQ,YAAY,WACvB,QAAQ,UACR,QAAQ,QACL,IAAI,CAAC,SACJ,OAAO,SAAS,WAAW,OAAO,KAAK,QAAQ,GAChD,CACA,KAAK,GAAG;CAClB;AAGH,KAAI,QAAQ,SAAS,MAAM;EACzB,MAAM,YAAY;AAClB,SAAO;GACL,MAAM;GACN,MAAM;GACN,MAAM,OAAO,UAAU,YAAY,WAAW,UAAU,UAAU;EACnE;CACF;AAGD,QAAO;EACL,MAAM;EACN,SACE,OAAO,QAAQ,YAAY,WACvB,QAAQ,UACR,KAAK,UAAU,QAAQ,QAAQ;CACtC;AACF;;;;;;;AAQD,SAAgB,gCACdC,UACyB;AACzB,QAAO,SAAS,IAAI,+BAA+B;AACpD;;;;;;;AAYD,SAAgB,4BACdC,OACe;AACf,QAAO;EACL,cAAc,OAAO,gBAAgB;EACrC,eAAe,OAAO,iBAAiB;EACvC,cAAc,OAAO,gBAAgB;EACrC,qBAAqB,EACnB,GAAI,OAAO,sBAAsB,iBAAiB,QAAQ,EACxD,YAAY,MAAM,qBAAqB,cACxC,EACF;EACD,sBAAsB,EACpB,GAAI,OAAO,uBAAuB,oBAAoB,QAAQ,EAC5D,WAAW,MAAM,sBAAsB,iBACxC,EACF;CACF;AACF;;;;;;;AAYD,SAAgB,sBACdC,QACQ;CACR,MAAMC,YAAsB,CAAE;AAE9B,MAAK,MAAM,QAAQ,OACjB,KAAI,KAAK,SAAS,aAAa,aAAa,MAC1C;OAAK,MAAM,eAAe,KAAK,QAC7B,KAAI,YAAY,SAAS,eACvB,UAAU,KAAK,YAAY,KAAK;CAEnC;AAIL,QAAO,UAAU,KAAK,GAAG;AAC1B;;;;;;;AAQD,SAAgB,2BAA2BC,UAAkC;CAC3E,MAAM,OAAO,sBAAsB,SAAS,OAAO;CAEnD,MAAMC,mBAA4C;EAChD,gBAAgB;EAChB,OAAO,SAAS;EAChB,YAAY,SAAS;EACrB,IAAI,SAAS;EACb,QAAQ,SAAS;EACjB,QAAQ,SAAS;CAClB;AAED,KAAI,SAAS,oBACX,iBAAiB,qBAAqB,SAAS;AAGjD,QAAO,IAAI,UAAU;EACnB,SAAS;EACT,gBAAgB,4BAA4B,SAAS,MAAM;EAC3D,mBAAmB;EACnB,mBAAmB,EACjB,GAAI,SAAS,aAAa,EAAE,WAAW,SAAS,UAAW,EAC5D;CACF;AACF;;;;;;;AAYD,SAAgB,0BACdC,OAC4B;CAC5B,MAAMD,mBAA4C,EAChD,gBAAgB,MACjB;AAED,KAAI,MAAM,SAAS,6BACjB,QAAO,IAAI,oBAAoB;EAC7B,MAAM,MAAM;EACZ,SAAS,IAAI,eAAe;GAC1B,SAAS,MAAM;GACf,mBAAmB;EACpB;CACF;AAGH,KAAI,MAAM,SAAS,oBAAoB;EACrC,iBAAiB,KAAK,MAAM,SAAS;EACrC,iBAAiB,QAAQ,MAAM,SAAS;AACxC,SAAO,IAAI,oBAAoB;GAC7B,MAAM;GACN,SAAS,IAAI,eAAe;IAC1B,SAAS;IACT,mBAAmB;GACpB;EACF;CACF;AAED,KAAI,MAAM,SAAS,sBAAsB;EACvC,MAAM,YAAY,2BAA2B,MAAM,SAAS;AAC5D,SAAO,IAAI,oBAAoB;GAC7B,MAAM;GACN,SAAS,IAAI,eAAe;IAC1B,SAAS;IACT,gBAAgB,UAAU;IAC1B,mBAAmB;KACjB,GAAG;KACH,GAAG,UAAU;IACd;GACF;EACF;CACF;AAED,QAAO;AACR"}

package/dist/index.cjs

@@ -1,6 +1,9 @@
-const require_chat_models = require('./chat_models.cjs');
-const require_index = require('./tools/index.cjs');
+const require_completions = require('./chat_models/completions.cjs');
+const require_responses = require('./chat_models/responses.cjs');
+require('./chat_models/index.cjs');
+const require_index$1 = require('./tools/index.cjs');
 
-exports.ChatXAI = require_chat_models.ChatXAI;
-exports.isXAIBuiltInTool = require_chat_models.isXAIBuiltInTool;
-exports.tools = require_index.tools;
+exports.ChatXAI = require_completions.ChatXAI;
+exports.ChatXAIResponses = require_responses.ChatXAIResponses;
+exports.isXAIBuiltInTool = require_completions.isXAIBuiltInTool;
+exports.tools = require_index$1.tools;