@langchain/xai 1.3.19 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @langchain/xai
 
+## 1.4.0
+
+### Minor Changes
+
+- [#10924](https://github.com/langchain-ai/langchainjs/pull/10924) [`2e28115`](https://github.com/langchain-ai/langchainjs/commit/2e2811509d75af94f57cedcc3842f178f4c020d1) Thanks [@christian-bromann](https://github.com/christian-bromann)! - feat(xai): add native completions and responses streamEvents events
+
+### Patch Changes
+
+- Updated dependencies [[`2e28115`](https://github.com/langchain-ai/langchainjs/commit/2e2811509d75af94f57cedcc3842f178f4c020d1)]:
+  - @langchain/openai@1.5.0
+
 ## 1.3.19
 
 ### Patch Changes

package/dist/chat_models/completions.cjs

@@ -431,7 +431,7 @@ var ChatXAI = class extends _langchain_openai.ChatOpenAICompletions {
 			apiKey,
 			configuration: { baseURL: fields?.baseURL ?? "https://api.x.ai/v1" }
 		});
-		this._addVersion("@langchain/xai", "1.3.19");
+		this._addVersion("@langchain/xai", "1.4.0");
 		this.searchParameters = fields?.searchParameters;
 	}
 	toJSON() {
@@ -551,6 +551,9 @@ var ChatXAI = class extends _langchain_openai.ChatOpenAICompletions {
 	get profile() {
 		return require_profiles.default[this.model] ?? {};
 	}
+	get streamEventProvider() {
+		return "xai";
+	}
 };
 //#endregion
 exports.ChatXAI = ChatXAI;

package/dist/chat_models/completions.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"completions.cjs","names":["XAI_LIVE_SEARCH_TOOL_TYPE","ChatOpenAICompletions","mergeSearchParams","buildSearchParametersPayload","filterXAIBuiltInTools","PROFILES"],"sources":["../../src/chat_models/completions.ts"],"sourcesContent":["import { BaseLanguageModelInput } from \"@langchain/core/language_models/base\";\nimport {\n  BaseChatModelCallOptions,\n  BindToolsInput,\n  LangSmithParams,\n  type BaseChatModelParams,\n} from \"@langchain/core/language_models/chat_models\";\nimport {\n  isLangChainTool,\n  convertToOpenAITool,\n} from \"@langchain/core/utils/function_calling\";\nimport { ModelProfile } from \"@langchain/core/language_models/profile\";\nimport { Serialized } from \"@langchain/core/load/serializable\";\nimport { AIMessageChunk, type UsageMetadata } from \"@langchain/core/messages\";\nimport { Runnable } from \"@langchain/core/runnables\";\nimport { getEnvironmentVariable } from \"@langchain/core/utils/env\";\nimport {\n  type OpenAICoreRequestOptions,\n  type OpenAIClient,\n  ChatOpenAICompletions,\n} from \"@langchain/openai\";\nimport {\n  buildSearchParametersPayload,\n  filterXAIBuiltInTools,\n  mergeSearchParams,\n  type XAISearchParameters,\n  type XAISearchParametersPayload,\n} from \"../live_search.js\";\nimport PROFILES from \"../profiles.js\";\nimport {\n  XAI_LIVE_SEARCH_TOOL_TYPE,\n  XAILiveSearchTool,\n} from \"../tools/live_search.js\";\n\nexport type OpenAIToolChoice =\n  | OpenAIClient.ChatCompletionToolChoiceOption\n  | \"any\"\n  | string;\n\n/**\n * Union type for all xAI built-in server-side tools.\n */\nexport type XAIBuiltInTool = XAILiveSearchTool;\n\n/**\n * Set of all supported xAI built-in server-side tool types.\n * This allows us to easily extend support for future built-in tools\n * without changing the core detection logic.\n */\nconst XAI_BUILT_IN_TOOL_TYPES = new Set<XAILiveSearchTool[\"type\"] | string>([\n  XAI_LIVE_SEARCH_TOOL_TYPE,\n]);\n\n/**\n * Tool type that includes both standard tools and xAI built-in tools.\n */\ntype ChatXAIToolType =\n  | BindToolsInput\n  | OpenAIClient.ChatCompletionTool\n  | XAIBuiltInTool;\n\n/**\n * xAI-specific invocation parameters that extend the OpenAI completion params\n * with xAI's search_parameters field.\n */\nexport type ChatXAICompletionsInvocationParams = Omit<\n  OpenAIClient.Chat.Completions.ChatCompletionCreateParams,\n  \"messages\"\n> & {\n  /**\n   * Search parameters for xAI's Live Search API.\n   * When present, enables the model to search the web for real-time information.\n   */\n  search_parameters?: XAISearchParametersPayload;\n};\n\n/**\n * xAI-specific additional kwargs that may be present on AI messages.\n * Includes xAI-specific fields like reasoning_content.\n */\nexport interface XAIAdditionalKwargs {\n  /**\n   * The reasoning content from xAI models that support chain-of-thought reasoning.\n   * This contains the model's internal reasoning process.\n   */\n  reasoning_content?: string;\n  /**\n   * Tool calls made by the model.\n   */\n  tool_calls?: OpenAIClient.ChatCompletionMessageToolCall[];\n  /**\n   * Additional properties that may be present.\n   */\n  [key: string]: unknown;\n}\n\n/**\n * xAI-specific response metadata that may include usage information.\n */\nexport interface XAIResponseMetadata {\n  /**\n   * Token usage information.\n   */\n  usage?: UsageMetadata;\n  /**\n   * Additional metadata properties.\n   */\n  [key: string]: unknown;\n}\n\n/**\n * Checks if a tool is an xAI built-in tool (like live_search).\n * Built-in tools are executed server-side by the xAI API.\n *\n * @param tool - The tool to check\n * @returns true if the tool is an xAI built-in tool\n */\nexport function isXAIBuiltInTool(\n  tool: ChatXAIToolType\n): tool is XAIBuiltInTool {\n  return (\n    typeof tool === \"object\" &&\n    tool !== null &&\n    \"type\" in tool &&\n    typeof (tool as { type?: unknown }).type === \"string\" &&\n    XAI_BUILT_IN_TOOL_TYPES.has((tool as { type: string }).type)\n  );\n}\n\nexport interface ChatXAICallOptions extends BaseChatModelCallOptions {\n  headers?: Record<string, string>;\n  /**\n   * A list of tools the model may call.\n   * Can include standard function tools and xAI built-in tools like `{ type: \"live_search\" }`.\n   *\n   * @example\n   * ```typescript\n   * // Using built-in live_search tool\n   * const llm = new ChatXAI().bindTools([{ type: \"live_search\" }]);\n   * const result = await llm.invoke(\"What happened in tech news today?\");\n   * ```\n   */\n  tools?: ChatXAIToolType[];\n  tool_choice?: OpenAIToolChoice | string | \"auto\" | \"any\";\n  /**\n   * Search parameters for xAI's Live Search API.\n   * Enables the model to search the web for real-time information.\n   *\n   * @note This is an alternative to using `tools: [{ type: \"live_search\" }]`.\n   * The Live Search API parameters approach may be deprecated in favor of\n   * the tool-based approach.\n   *\n   * @example\n   * ```typescript\n   * const result = await llm.invoke(\"What's the latest news?\", {\n   *   searchParameters: {\n   *     mode: \"auto\",\n   *     max_search_results: 5,\n   *   }\n   * });\n   * ```\n   */\n  searchParameters?: XAISearchParameters;\n}\n\nexport interface ChatXAIInput extends BaseChatModelParams {\n  /**\n   * The xAI API key to use for requests.\n   * @default process.env.XAI_API_KEY\n   */\n  apiKey?: string;\n  /**\n   * The name of the model to use.\n   * @default \"grok-3-fast\"\n   */\n  model?: string;\n  /**\n   * Up to 4 sequences where the API will stop generating further tokens. The\n   * returned text will not contain the stop sequence.\n   * Alias for `stopSequences`\n   */\n  stop?: Array<string>;\n  /**\n   * Up to 4 sequences where the API will stop generating further tokens. The\n   * returned text will not contain the stop sequence.\n   */\n  stopSequences?: Array<string>;\n  /**\n   * Whether or not to stream responses.\n   */\n  streaming?: boolean;\n  /**\n   * The temperature to use for sampling.\n   * @default 0.7\n   */\n  temperature?: number;\n  /**\n   * The maximum number of tokens that the model can process in a single response.\n   * This limits ensures computational efficiency and resource management.\n   */\n  maxTokens?: number;\n  /**\n   * Default search parameters for xAI's Live Search API.\n   * When set, these parameters will be applied to all requests unless\n   * overridden in the call options.\n   *\n   * @example\n   * ```typescript\n   * const llm = new ChatXAI({\n   *   model: \"grok-3-fast\",\n   *   searchParameters: {\n   *     mode: \"auto\",\n   *     max_search_results: 5,\n   *   }\n   * });\n   * ```\n   */\n  searchParameters?: XAISearchParameters;\n  /**\n   * The base URL for the xAI API.\n   * @default \"https://api.x.ai/v1\"\n   */\n  baseURL?: string;\n}\n\n/**\n * xAI chat model integration.\n *\n * The xAI API is compatible to the OpenAI API with some limitations.\n *\n * Setup:\n * Install `@langchain/xai` and set an environment variable named `XAI_API_KEY`.\n *\n * ```bash\n * npm install @langchain/xai\n * export XAI_API_KEY=\"your-api-key\"\n * ```\n *\n * ## [Constructor args](https://api.js.langchain.com/classes/_langchain_xai.ChatXAI.html#constructor)\n *\n * ## [Runtime args](https://api.js.langchain.com/interfaces/_langchain_xai.ChatXAICallOptions.html)\n *\n * Runtime args can be passed as the second argument to any of the base runnable methods `.invoke`. `.stream`, `.batch`, etc.\n * They can also be passed via `.withConfig`, or the second arg in `.bindTools`, like shown in the examples below:\n *\n * ```typescript\n * // When calling `.withConfig`, call options should be passed via the first argument\n * const llmWithArgsBound = llm.withConfig({\n *   stop: [\"\\n\"],\n *   tools: [...],\n * });\n *\n * // When calling `.bindTools`, call options should be passed via the second argument\n * const llmWithTools = llm.bindTools(\n *   [...],\n *   {\n *     tool_choice: \"auto\",\n *   }\n * );\n * ```\n *\n * ## Examples\n *\n * <details open>\n * <summary><strong>Instantiate</strong></summary>\n *\n * ```typescript\n * import { ChatXAI } from '@langchain/xai';\n *\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   temperature: 0,\n *   // other params...\n * });\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Invoking</strong></summary>\n *\n * ```typescript\n * const input = `Translate \"I love programming\" into French.`;\n *\n * // Models also accept a list of chat messages or a formatted prompt\n * const result = await llm.invoke(input);\n * console.log(result);\n * ```\n *\n * ```txt\n * AIMessage {\n *   \"content\": \"The French translation of \\\"I love programming\\\" is \\\"J'aime programmer\\\". In this sentence, \\\"J'aime\\\" is the first person singular conjugation of the French verb \\\"aimer\\\" which means \\\"to love\\\", and \\\"programmer\\\" is the French infinitive for \\\"to program\\\". I hope this helps! Let me know if you have any other questions.\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"tokenUsage\": {\n *       \"completionTokens\": 82,\n *       \"promptTokens\": 20,\n *       \"totalTokens\": 102\n *     },\n *     \"finish_reason\": \"stop\"\n *   },\n *   \"tool_calls\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Streaming Chunks</strong></summary>\n *\n * ```typescript\n * for await (const chunk of await llm.stream(input)) {\n *   console.log(chunk);\n * }\n * ```\n *\n * ```txt\n * AIMessageChunk {\n *   \"content\": \"\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \"The\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" French\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" translation\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" of\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" \\\"\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \"I\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" love\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ...\n * AIMessageChunk {\n *   \"content\": \".\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \"\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": \"stop\"\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Aggregate Streamed Chunks</strong></summary>\n *\n * ```typescript\n * import { AIMessageChunk } from '@langchain/core/messages';\n * import { concat } from '@langchain/core/utils/stream';\n *\n * const stream = await llm.stream(input);\n * let full: AIMessageChunk | undefined;\n * for await (const chunk of stream) {\n *   full = !full ? chunk : concat(full, chunk);\n * }\n * console.log(full);\n * ```\n *\n * ```txt\n * AIMessageChunk {\n *   \"content\": \"The French translation of \\\"I love programming\\\" is \\\"J'aime programmer\\\". In this sentence, \\\"J'aime\\\" is the first person singular conjugation of the French verb \\\"aimer\\\" which means \\\"to love\\\", and \\\"programmer\\\" is the French infinitive for \\\"to program\\\". I hope this helps! Let me know if you have any other questions.\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": \"stop\"\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Bind tools</strong></summary>\n *\n * ```typescript\n * import { z } from 'zod';\n *\n * const llmForToolCalling = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   temperature: 0,\n *   // other params...\n * });\n *\n * const GetWeather = {\n *   name: \"GetWeather\",\n *   description: \"Get the current weather in a given location\",\n *   schema: z.object({\n *     location: z.string().describe(\"The city and state, e.g. San Francisco, CA\")\n *   }),\n * }\n *\n * const GetPopulation = {\n *   name: \"GetPopulation\",\n *   description: \"Get the current population in a given location\",\n *   schema: z.object({\n *     location: z.string().describe(\"The city and state, e.g. San Francisco, CA\")\n *   }),\n * }\n *\n * const llmWithTools = llmForToolCalling.bindTools([GetWeather, GetPopulation]);\n * const aiMsg = await llmWithTools.invoke(\n *   \"Which city is hotter today and which is bigger: LA or NY?\"\n * );\n * console.log(aiMsg.tool_calls);\n * ```\n *\n * ```txt\n * [\n *   {\n *     name: 'GetWeather',\n *     args: { location: 'Los Angeles, CA' },\n *     type: 'tool_call',\n *     id: 'call_cd34'\n *   },\n *   {\n *     name: 'GetWeather',\n *     args: { location: 'New York, NY' },\n *     type: 'tool_call',\n *     id: 'call_68rf'\n *   },\n *   {\n *     name: 'GetPopulation',\n *     args: { location: 'Los Angeles, CA' },\n *     type: 'tool_call',\n *     id: 'call_f81z'\n *   },\n *   {\n *     name: 'GetPopulation',\n *     args: { location: 'New York, NY' },\n *     type: 'tool_call',\n *     id: 'call_8byt'\n *   }\n * ]\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Structured Output</strong></summary>\n *\n * ```typescript\n * import { z } from 'zod';\n *\n * const Joke = z.object({\n *   setup: z.string().describe(\"The setup of the joke\"),\n *   punchline: z.string().describe(\"The punchline to the joke\"),\n *   rating: z.number().optional().describe(\"How funny the joke is, from 1 to 10\")\n * }).describe('Joke to tell user.');\n *\n * const structuredLlm = llmForToolCalling.withStructuredOutput(Joke, { name: \"Joke\" });\n * const jokeResult = await structuredLlm.invoke(\"Tell me a joke about cats\");\n * console.log(jokeResult);\n * ```\n *\n * ```txt\n * {\n *   setup: \"Why don't cats play poker in the wild?\",\n *   punchline: 'Because there are too many cheetahs.'\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Server Tool Calling (Live Search)</strong></summary>\n *\n * xAI supports server-side tools that are executed by the API rather than\n * requiring client-side execution. The `live_search` tool enables the model\n * to search the web for real-time information.\n *\n * ```typescript\n * // Method 1: Using the built-in live_search tool\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   temperature: 0,\n * });\n *\n * const llmWithSearch = llm.bindTools([{ type: \"live_search\" }]);\n * const result = await llmWithSearch.invoke(\"What happened in tech news today?\");\n * console.log(result.content);\n * // The model will search the web and include real-time information in its response\n * ```\n *\n * ```typescript\n * // Method 2: Using searchParameters for more control\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   searchParameters: {\n *     mode: \"auto\", // \"auto\" | \"on\" | \"off\"\n *     max_search_results: 5,\n *     from_date: \"2024-01-01\", // ISO date string\n *     return_citations: true,\n *   }\n * });\n *\n * const result = await llm.invoke(\"What are the latest AI developments?\");\n * ```\n *\n * ```typescript\n * // Method 3: Override search parameters per request\n * const result = await llm.invoke(\"Find recent news about SpaceX\", {\n *   searchParameters: {\n *     mode: \"on\",\n *     max_search_results: 10,\n *     sources: [\n *       { type: \"web\", allowed_websites: [\"spacex.com\", \"nasa.gov\"] },\n *     ],\n *   }\n * });\n * ```\n * </details>\n *\n * <br />\n */\nexport class ChatXAI extends ChatOpenAICompletions<ChatXAICallOptions> {\n  static lc_name() {\n    return \"ChatXAI\";\n  }\n\n  _llmType() {\n    return \"xai\";\n  }\n\n  get lc_secrets(): { [key: string]: string } | undefined {\n    return {\n      apiKey: \"XAI_API_KEY\",\n    };\n  }\n\n  lc_serializable = true;\n\n  lc_namespace = [\"langchain\", \"chat_models\", \"xai\"];\n\n  /**\n   * Default search parameters for the Live Search API.\n   */\n  searchParameters?: XAISearchParameters;\n\n  constructor(model: string, fields?: Omit<ChatXAIInput, \"model\">);\n  constructor(fields?: Partial<ChatXAIInput>);\n  constructor(\n    modelOrFields?: string | Partial<ChatXAIInput>,\n    fieldsArg?: Omit<ChatXAIInput, \"model\">\n  ) {\n    const fields =\n      typeof modelOrFields === \"string\"\n        ? { ...(fieldsArg ?? {}), model: modelOrFields }\n        : (modelOrFields ?? {});\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 into \"apiKey\" field.`\n      );\n    }\n\n    super({\n      ...fields,\n      model: fields?.model || \"grok-3-fast\",\n      apiKey,\n      configuration: {\n        baseURL: fields?.baseURL ?? \"https://api.x.ai/v1\",\n      },\n    });\n\n    this._addVersion(\"@langchain/xai\", __PKG_VERSION__);\n\n    this.searchParameters = fields?.searchParameters;\n  }\n\n  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.openai_api_key;\n      delete result.kwargs.configuration;\n    }\n\n    return result;\n  }\n\n  getLsParams(options: this[\"ParsedCallOptions\"]): LangSmithParams {\n    const params = super.getLsParams(options);\n    params.ls_provider = \"xai\";\n    return params;\n  }\n\n  /**\n   * Get the effective search parameters, merging defaults with call options.\n   * @param options Call options that may contain search parameters\n   * @returns Merged search parameters or undefined if none are configured\n   */\n  protected _getEffectiveSearchParameters(\n    options?: this[\"ParsedCallOptions\"]\n  ): XAISearchParameters | undefined {\n    return mergeSearchParams(this.searchParameters, options?.searchParameters);\n  }\n\n  /**\n   * Check if any built-in tools (like live_search) are in the tools list.\n   * @param tools List of tools to check\n   * @returns true if any built-in tools are present\n   */\n  protected _hasBuiltInTools(tools?: ChatXAIToolType[]): boolean {\n    return tools?.some(isXAIBuiltInTool) ?? false;\n  }\n\n  /**\n   * Formats tools to xAI/OpenAI format, preserving provider-specific definitions.\n   *\n   * @param tools The tools to format\n   * @returns The formatted tools\n   */\n  formatStructuredToolToXAI(\n    tools: ChatXAIToolType[]\n  ): (OpenAIClient.ChatCompletionTool | XAIBuiltInTool)[] | undefined {\n    if (!tools || !tools.length) {\n      return undefined;\n    }\n    return tools.map((tool) => {\n      // 1. Check for provider definition first (from xaiLiveSearch factory)\n      if (isLangChainTool(tool) && tool.extras?.providerToolDefinition) {\n        return tool.extras.providerToolDefinition as XAIBuiltInTool;\n      }\n      // 2. Check for built-in tools (legacy { type: \"live_search\" })\n      if (isXAIBuiltInTool(tool)) {\n        return tool;\n      }\n      // 3. Convert standard tools to OpenAI format\n      return convertToOpenAITool(tool) as OpenAIClient.ChatCompletionTool;\n    });\n  }\n\n  override bindTools(\n    tools: ChatXAIToolType[],\n    kwargs?: Partial<ChatXAICallOptions>\n  ): Runnable<BaseLanguageModelInput, AIMessageChunk, ChatXAICallOptions> {\n    return this.withConfig({\n      tools: this.formatStructuredToolToXAI(tools),\n      ...kwargs,\n    } as Partial<ChatXAICallOptions>);\n  }\n\n  /** @internal */\n  override invocationParams(\n    options?: this[\"ParsedCallOptions\"],\n    extra?: { streaming?: boolean }\n  ): ChatXAICompletionsInvocationParams {\n    const baseParams = super.invocationParams(options, extra);\n\n    // Cast to xAI-specific params type\n    const params: ChatXAICompletionsInvocationParams = { ...baseParams };\n\n    // Check if live_search tool is being used\n    // We also need to extract params from the tool definition if present\n    const liveSearchTool = options?.tools?.find(isXAIBuiltInTool) as\n      | XAILiveSearchTool\n      | undefined;\n\n    const mergedSearchParams = mergeSearchParams(\n      this.searchParameters,\n      options?.searchParameters,\n      liveSearchTool\n    );\n\n    // Add search_parameters if needed\n    if (mergedSearchParams) {\n      params.search_parameters =\n        buildSearchParametersPayload(mergedSearchParams);\n    }\n\n    return params;\n  }\n\n  async completionWithRetry(\n    request: OpenAIClient.Chat.ChatCompletionCreateParamsStreaming,\n    options?: OpenAICoreRequestOptions\n  ): Promise<AsyncIterable<OpenAIClient.Chat.Completions.ChatCompletionChunk>>;\n\n  async completionWithRetry(\n    request: OpenAIClient.Chat.ChatCompletionCreateParamsNonStreaming,\n    options?: OpenAICoreRequestOptions\n  ): Promise<OpenAIClient.Chat.Completions.ChatCompletion>;\n\n  /**\n   * Calls the xAI API with retry logic in case of failures.\n   * @param request The request to send to the xAI API.\n   * @param options Optional configuration for the API call.\n   * @returns The response from the xAI API.\n   */\n  async completionWithRetry(\n    request:\n      | OpenAIClient.Chat.ChatCompletionCreateParamsStreaming\n      | OpenAIClient.Chat.ChatCompletionCreateParamsNonStreaming,\n    options?: OpenAICoreRequestOptions\n  ): Promise<\n    | AsyncIterable<OpenAIClient.Chat.Completions.ChatCompletionChunk>\n    | OpenAIClient.Chat.Completions.ChatCompletion\n  > {\n    delete request.frequency_penalty;\n    delete request.presence_penalty;\n    delete request.logit_bias;\n    delete request.functions;\n\n    const newRequestMessages = request.messages.map((msg) => {\n      if (!msg.content) {\n        return {\n          ...msg,\n          content: \"\",\n        };\n      }\n      return msg;\n    });\n\n    let filteredTools: OpenAIClient.ChatCompletionTool[] | undefined;\n    if (request.tools) {\n      filteredTools = filterXAIBuiltInTools({\n        tools: request.tools,\n        excludedTypes: [XAI_LIVE_SEARCH_TOOL_TYPE],\n      }) as OpenAIClient.ChatCompletionTool[] | undefined;\n    }\n\n    const newRequest = {\n      ...request,\n      messages: newRequestMessages,\n      tools: filteredTools,\n    };\n\n    if (newRequest.stream === true) {\n      return super.completionWithRetry(newRequest, options);\n    }\n\n    return super.completionWithRetry(newRequest, options);\n  }\n\n  protected override _convertCompletionsDeltaToBaseMessageChunk(\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    delta: Record<string, any>,\n    rawResponse: OpenAIClient.ChatCompletionChunk,\n    defaultRole?:\n      | \"function\"\n      | \"user\"\n      | \"system\"\n      | \"developer\"\n      | \"assistant\"\n      | \"tool\"\n  ): AIMessageChunk {\n    const messageChunk = super._convertCompletionsDeltaToBaseMessageChunk(\n      delta,\n      rawResponse,\n      defaultRole\n    ) as AIMessageChunk;\n\n    // Cast to xAI-specific types for proper typing\n    const responseMetadata =\n      messageChunk.response_metadata as XAIResponseMetadata;\n\n    // Make concatenating chunks work without merge warning\n    if (!rawResponse.choices[0]?.finish_reason) {\n      delete responseMetadata.usage;\n      delete messageChunk.usage_metadata;\n    } else {\n      messageChunk.usage_metadata = responseMetadata.usage;\n    }\n    return messageChunk;\n  }\n\n  /**\n   * Return profiling information for the model.\n   *\n   * Provides information about the model's capabilities and constraints,\n   * including token limits, multimodal support, and advanced features like\n   * tool calling and structured output.\n   *\n   * @returns {ModelProfile} An object describing the model's capabilities and constraints\n   *\n   * @example\n   * ```typescript\n   * const model = new ChatXAI({ model: \"grok-3-fast\" });\n   * const profile = model.profile;\n   * console.log(profile.maxInputTokens); // 128000\n   * console.log(profile.imageInputs); // true\n   * ```\n   */\n  get profile(): ModelProfile {\n    return PROFILES[this.model] ?? {};\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"completions.cjs","names":["XAI_LIVE_SEARCH_TOOL_TYPE","ChatOpenAICompletions","mergeSearchParams","buildSearchParametersPayload","filterXAIBuiltInTools","PROFILES"],"sources":["../../src/chat_models/completions.ts"],"sourcesContent":["import { BaseLanguageModelInput } from \"@langchain/core/language_models/base\";\nimport {\n  BaseChatModelCallOptions,\n  BindToolsInput,\n  LangSmithParams,\n  type BaseChatModelParams,\n} from \"@langchain/core/language_models/chat_models\";\nimport {\n  isLangChainTool,\n  convertToOpenAITool,\n} from \"@langchain/core/utils/function_calling\";\nimport { ModelProfile } from \"@langchain/core/language_models/profile\";\nimport { Serialized } from \"@langchain/core/load/serializable\";\nimport { AIMessageChunk, type UsageMetadata } from \"@langchain/core/messages\";\nimport { Runnable } from \"@langchain/core/runnables\";\nimport { getEnvironmentVariable } from \"@langchain/core/utils/env\";\nimport {\n  type OpenAICoreRequestOptions,\n  type OpenAIClient,\n  ChatOpenAICompletions,\n} from \"@langchain/openai\";\nimport {\n  buildSearchParametersPayload,\n  filterXAIBuiltInTools,\n  mergeSearchParams,\n  type XAISearchParameters,\n  type XAISearchParametersPayload,\n} from \"../live_search.js\";\nimport PROFILES from \"../profiles.js\";\nimport {\n  XAI_LIVE_SEARCH_TOOL_TYPE,\n  XAILiveSearchTool,\n} from \"../tools/live_search.js\";\n\nexport type OpenAIToolChoice =\n  | OpenAIClient.ChatCompletionToolChoiceOption\n  | \"any\"\n  | string;\n\n/**\n * Union type for all xAI built-in server-side tools.\n */\nexport type XAIBuiltInTool = XAILiveSearchTool;\n\n/**\n * Set of all supported xAI built-in server-side tool types.\n * This allows us to easily extend support for future built-in tools\n * without changing the core detection logic.\n */\nconst XAI_BUILT_IN_TOOL_TYPES = new Set<XAILiveSearchTool[\"type\"] | string>([\n  XAI_LIVE_SEARCH_TOOL_TYPE,\n]);\n\n/**\n * Tool type that includes both standard tools and xAI built-in tools.\n */\ntype ChatXAIToolType =\n  | BindToolsInput\n  | OpenAIClient.ChatCompletionTool\n  | XAIBuiltInTool;\n\n/**\n * xAI-specific invocation parameters that extend the OpenAI completion params\n * with xAI's search_parameters field.\n */\nexport type ChatXAICompletionsInvocationParams = Omit<\n  OpenAIClient.Chat.Completions.ChatCompletionCreateParams,\n  \"messages\"\n> & {\n  /**\n   * Search parameters for xAI's Live Search API.\n   * When present, enables the model to search the web for real-time information.\n   */\n  search_parameters?: XAISearchParametersPayload;\n};\n\n/**\n * xAI-specific additional kwargs that may be present on AI messages.\n * Includes xAI-specific fields like reasoning_content.\n */\nexport interface XAIAdditionalKwargs {\n  /**\n   * The reasoning content from xAI models that support chain-of-thought reasoning.\n   * This contains the model's internal reasoning process.\n   */\n  reasoning_content?: string;\n  /**\n   * Tool calls made by the model.\n   */\n  tool_calls?: OpenAIClient.ChatCompletionMessageToolCall[];\n  /**\n   * Additional properties that may be present.\n   */\n  [key: string]: unknown;\n}\n\n/**\n * xAI-specific response metadata that may include usage information.\n */\nexport interface XAIResponseMetadata {\n  /**\n   * Token usage information.\n   */\n  usage?: UsageMetadata;\n  /**\n   * Additional metadata properties.\n   */\n  [key: string]: unknown;\n}\n\n/**\n * Checks if a tool is an xAI built-in tool (like live_search).\n * Built-in tools are executed server-side by the xAI API.\n *\n * @param tool - The tool to check\n * @returns true if the tool is an xAI built-in tool\n */\nexport function isXAIBuiltInTool(\n  tool: ChatXAIToolType\n): tool is XAIBuiltInTool {\n  return (\n    typeof tool === \"object\" &&\n    tool !== null &&\n    \"type\" in tool &&\n    typeof (tool as { type?: unknown }).type === \"string\" &&\n    XAI_BUILT_IN_TOOL_TYPES.has((tool as { type: string }).type)\n  );\n}\n\nexport interface ChatXAICallOptions extends BaseChatModelCallOptions {\n  headers?: Record<string, string>;\n  /**\n   * A list of tools the model may call.\n   * Can include standard function tools and xAI built-in tools like `{ type: \"live_search\" }`.\n   *\n   * @example\n   * ```typescript\n   * // Using built-in live_search tool\n   * const llm = new ChatXAI().bindTools([{ type: \"live_search\" }]);\n   * const result = await llm.invoke(\"What happened in tech news today?\");\n   * ```\n   */\n  tools?: ChatXAIToolType[];\n  tool_choice?: OpenAIToolChoice | string | \"auto\" | \"any\";\n  /**\n   * Search parameters for xAI's Live Search API.\n   * Enables the model to search the web for real-time information.\n   *\n   * @note This is an alternative to using `tools: [{ type: \"live_search\" }]`.\n   * The Live Search API parameters approach may be deprecated in favor of\n   * the tool-based approach.\n   *\n   * @example\n   * ```typescript\n   * const result = await llm.invoke(\"What's the latest news?\", {\n   *   searchParameters: {\n   *     mode: \"auto\",\n   *     max_search_results: 5,\n   *   }\n   * });\n   * ```\n   */\n  searchParameters?: XAISearchParameters;\n}\n\nexport interface ChatXAIInput extends BaseChatModelParams {\n  /**\n   * The xAI API key to use for requests.\n   * @default process.env.XAI_API_KEY\n   */\n  apiKey?: string;\n  /**\n   * The name of the model to use.\n   * @default \"grok-3-fast\"\n   */\n  model?: string;\n  /**\n   * Up to 4 sequences where the API will stop generating further tokens. The\n   * returned text will not contain the stop sequence.\n   * Alias for `stopSequences`\n   */\n  stop?: Array<string>;\n  /**\n   * Up to 4 sequences where the API will stop generating further tokens. The\n   * returned text will not contain the stop sequence.\n   */\n  stopSequences?: Array<string>;\n  /**\n   * Whether or not to stream responses.\n   */\n  streaming?: boolean;\n  /**\n   * The temperature to use for sampling.\n   * @default 0.7\n   */\n  temperature?: number;\n  /**\n   * The maximum number of tokens that the model can process in a single response.\n   * This limits ensures computational efficiency and resource management.\n   */\n  maxTokens?: number;\n  /**\n   * Default search parameters for xAI's Live Search API.\n   * When set, these parameters will be applied to all requests unless\n   * overridden in the call options.\n   *\n   * @example\n   * ```typescript\n   * const llm = new ChatXAI({\n   *   model: \"grok-3-fast\",\n   *   searchParameters: {\n   *     mode: \"auto\",\n   *     max_search_results: 5,\n   *   }\n   * });\n   * ```\n   */\n  searchParameters?: XAISearchParameters;\n  /**\n   * The base URL for the xAI API.\n   * @default \"https://api.x.ai/v1\"\n   */\n  baseURL?: string;\n}\n\n/**\n * xAI chat model integration.\n *\n * The xAI API is compatible to the OpenAI API with some limitations.\n *\n * Setup:\n * Install `@langchain/xai` and set an environment variable named `XAI_API_KEY`.\n *\n * ```bash\n * npm install @langchain/xai\n * export XAI_API_KEY=\"your-api-key\"\n * ```\n *\n * ## [Constructor args](https://api.js.langchain.com/classes/_langchain_xai.ChatXAI.html#constructor)\n *\n * ## [Runtime args](https://api.js.langchain.com/interfaces/_langchain_xai.ChatXAICallOptions.html)\n *\n * Runtime args can be passed as the second argument to any of the base runnable methods `.invoke`. `.stream`, `.batch`, etc.\n * They can also be passed via `.withConfig`, or the second arg in `.bindTools`, like shown in the examples below:\n *\n * ```typescript\n * // When calling `.withConfig`, call options should be passed via the first argument\n * const llmWithArgsBound = llm.withConfig({\n *   stop: [\"\\n\"],\n *   tools: [...],\n * });\n *\n * // When calling `.bindTools`, call options should be passed via the second argument\n * const llmWithTools = llm.bindTools(\n *   [...],\n *   {\n *     tool_choice: \"auto\",\n *   }\n * );\n * ```\n *\n * ## Examples\n *\n * <details open>\n * <summary><strong>Instantiate</strong></summary>\n *\n * ```typescript\n * import { ChatXAI } from '@langchain/xai';\n *\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   temperature: 0,\n *   // other params...\n * });\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Invoking</strong></summary>\n *\n * ```typescript\n * const input = `Translate \"I love programming\" into French.`;\n *\n * // Models also accept a list of chat messages or a formatted prompt\n * const result = await llm.invoke(input);\n * console.log(result);\n * ```\n *\n * ```txt\n * AIMessage {\n *   \"content\": \"The French translation of \\\"I love programming\\\" is \\\"J'aime programmer\\\". In this sentence, \\\"J'aime\\\" is the first person singular conjugation of the French verb \\\"aimer\\\" which means \\\"to love\\\", and \\\"programmer\\\" is the French infinitive for \\\"to program\\\". I hope this helps! Let me know if you have any other questions.\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"tokenUsage\": {\n *       \"completionTokens\": 82,\n *       \"promptTokens\": 20,\n *       \"totalTokens\": 102\n *     },\n *     \"finish_reason\": \"stop\"\n *   },\n *   \"tool_calls\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Streaming Chunks</strong></summary>\n *\n * ```typescript\n * for await (const chunk of await llm.stream(input)) {\n *   console.log(chunk);\n * }\n * ```\n *\n * ```txt\n * AIMessageChunk {\n *   \"content\": \"\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \"The\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" French\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" translation\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" of\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" \\\"\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \"I\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" love\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ...\n * AIMessageChunk {\n *   \"content\": \".\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \"\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": \"stop\"\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Aggregate Streamed Chunks</strong></summary>\n *\n * ```typescript\n * import { AIMessageChunk } from '@langchain/core/messages';\n * import { concat } from '@langchain/core/utils/stream';\n *\n * const stream = await llm.stream(input);\n * let full: AIMessageChunk | undefined;\n * for await (const chunk of stream) {\n *   full = !full ? chunk : concat(full, chunk);\n * }\n * console.log(full);\n * ```\n *\n * ```txt\n * AIMessageChunk {\n *   \"content\": \"The French translation of \\\"I love programming\\\" is \\\"J'aime programmer\\\". In this sentence, \\\"J'aime\\\" is the first person singular conjugation of the French verb \\\"aimer\\\" which means \\\"to love\\\", and \\\"programmer\\\" is the French infinitive for \\\"to program\\\". I hope this helps! Let me know if you have any other questions.\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": \"stop\"\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Bind tools</strong></summary>\n *\n * ```typescript\n * import { z } from 'zod';\n *\n * const llmForToolCalling = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   temperature: 0,\n *   // other params...\n * });\n *\n * const GetWeather = {\n *   name: \"GetWeather\",\n *   description: \"Get the current weather in a given location\",\n *   schema: z.object({\n *     location: z.string().describe(\"The city and state, e.g. San Francisco, CA\")\n *   }),\n * }\n *\n * const GetPopulation = {\n *   name: \"GetPopulation\",\n *   description: \"Get the current population in a given location\",\n *   schema: z.object({\n *     location: z.string().describe(\"The city and state, e.g. San Francisco, CA\")\n *   }),\n * }\n *\n * const llmWithTools = llmForToolCalling.bindTools([GetWeather, GetPopulation]);\n * const aiMsg = await llmWithTools.invoke(\n *   \"Which city is hotter today and which is bigger: LA or NY?\"\n * );\n * console.log(aiMsg.tool_calls);\n * ```\n *\n * ```txt\n * [\n *   {\n *     name: 'GetWeather',\n *     args: { location: 'Los Angeles, CA' },\n *     type: 'tool_call',\n *     id: 'call_cd34'\n *   },\n *   {\n *     name: 'GetWeather',\n *     args: { location: 'New York, NY' },\n *     type: 'tool_call',\n *     id: 'call_68rf'\n *   },\n *   {\n *     name: 'GetPopulation',\n *     args: { location: 'Los Angeles, CA' },\n *     type: 'tool_call',\n *     id: 'call_f81z'\n *   },\n *   {\n *     name: 'GetPopulation',\n *     args: { location: 'New York, NY' },\n *     type: 'tool_call',\n *     id: 'call_8byt'\n *   }\n * ]\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Structured Output</strong></summary>\n *\n * ```typescript\n * import { z } from 'zod';\n *\n * const Joke = z.object({\n *   setup: z.string().describe(\"The setup of the joke\"),\n *   punchline: z.string().describe(\"The punchline to the joke\"),\n *   rating: z.number().optional().describe(\"How funny the joke is, from 1 to 10\")\n * }).describe('Joke to tell user.');\n *\n * const structuredLlm = llmForToolCalling.withStructuredOutput(Joke, { name: \"Joke\" });\n * const jokeResult = await structuredLlm.invoke(\"Tell me a joke about cats\");\n * console.log(jokeResult);\n * ```\n *\n * ```txt\n * {\n *   setup: \"Why don't cats play poker in the wild?\",\n *   punchline: 'Because there are too many cheetahs.'\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Server Tool Calling (Live Search)</strong></summary>\n *\n * xAI supports server-side tools that are executed by the API rather than\n * requiring client-side execution. The `live_search` tool enables the model\n * to search the web for real-time information.\n *\n * ```typescript\n * // Method 1: Using the built-in live_search tool\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   temperature: 0,\n * });\n *\n * const llmWithSearch = llm.bindTools([{ type: \"live_search\" }]);\n * const result = await llmWithSearch.invoke(\"What happened in tech news today?\");\n * console.log(result.content);\n * // The model will search the web and include real-time information in its response\n * ```\n *\n * ```typescript\n * // Method 2: Using searchParameters for more control\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   searchParameters: {\n *     mode: \"auto\", // \"auto\" | \"on\" | \"off\"\n *     max_search_results: 5,\n *     from_date: \"2024-01-01\", // ISO date string\n *     return_citations: true,\n *   }\n * });\n *\n * const result = await llm.invoke(\"What are the latest AI developments?\");\n * ```\n *\n * ```typescript\n * // Method 3: Override search parameters per request\n * const result = await llm.invoke(\"Find recent news about SpaceX\", {\n *   searchParameters: {\n *     mode: \"on\",\n *     max_search_results: 10,\n *     sources: [\n *       { type: \"web\", allowed_websites: [\"spacex.com\", \"nasa.gov\"] },\n *     ],\n *   }\n * });\n * ```\n * </details>\n *\n * <br />\n */\nexport class ChatXAI extends ChatOpenAICompletions<ChatXAICallOptions> {\n  static lc_name() {\n    return \"ChatXAI\";\n  }\n\n  _llmType() {\n    return \"xai\";\n  }\n\n  get lc_secrets(): { [key: string]: string } | undefined {\n    return {\n      apiKey: \"XAI_API_KEY\",\n    };\n  }\n\n  lc_serializable = true;\n\n  lc_namespace = [\"langchain\", \"chat_models\", \"xai\"];\n\n  /**\n   * Default search parameters for the Live Search API.\n   */\n  searchParameters?: XAISearchParameters;\n\n  constructor(model: string, fields?: Omit<ChatXAIInput, \"model\">);\n  constructor(fields?: Partial<ChatXAIInput>);\n  constructor(\n    modelOrFields?: string | Partial<ChatXAIInput>,\n    fieldsArg?: Omit<ChatXAIInput, \"model\">\n  ) {\n    const fields =\n      typeof modelOrFields === \"string\"\n        ? { ...(fieldsArg ?? {}), model: modelOrFields }\n        : (modelOrFields ?? {});\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 into \"apiKey\" field.`\n      );\n    }\n\n    super({\n      ...fields,\n      model: fields?.model || \"grok-3-fast\",\n      apiKey,\n      configuration: {\n        baseURL: fields?.baseURL ?? \"https://api.x.ai/v1\",\n      },\n    });\n\n    this._addVersion(\"@langchain/xai\", __PKG_VERSION__);\n\n    this.searchParameters = fields?.searchParameters;\n  }\n\n  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.openai_api_key;\n      delete result.kwargs.configuration;\n    }\n\n    return result;\n  }\n\n  getLsParams(options: this[\"ParsedCallOptions\"]): LangSmithParams {\n    const params = super.getLsParams(options);\n    params.ls_provider = \"xai\";\n    return params;\n  }\n\n  /**\n   * Get the effective search parameters, merging defaults with call options.\n   * @param options Call options that may contain search parameters\n   * @returns Merged search parameters or undefined if none are configured\n   */\n  protected _getEffectiveSearchParameters(\n    options?: this[\"ParsedCallOptions\"]\n  ): XAISearchParameters | undefined {\n    return mergeSearchParams(this.searchParameters, options?.searchParameters);\n  }\n\n  /**\n   * Check if any built-in tools (like live_search) are in the tools list.\n   * @param tools List of tools to check\n   * @returns true if any built-in tools are present\n   */\n  protected _hasBuiltInTools(tools?: ChatXAIToolType[]): boolean {\n    return tools?.some(isXAIBuiltInTool) ?? false;\n  }\n\n  /**\n   * Formats tools to xAI/OpenAI format, preserving provider-specific definitions.\n   *\n   * @param tools The tools to format\n   * @returns The formatted tools\n   */\n  formatStructuredToolToXAI(\n    tools: ChatXAIToolType[]\n  ): (OpenAIClient.ChatCompletionTool | XAIBuiltInTool)[] | undefined {\n    if (!tools || !tools.length) {\n      return undefined;\n    }\n    return tools.map((tool) => {\n      // 1. Check for provider definition first (from xaiLiveSearch factory)\n      if (isLangChainTool(tool) && tool.extras?.providerToolDefinition) {\n        return tool.extras.providerToolDefinition as XAIBuiltInTool;\n      }\n      // 2. Check for built-in tools (legacy { type: \"live_search\" })\n      if (isXAIBuiltInTool(tool)) {\n        return tool;\n      }\n      // 3. Convert standard tools to OpenAI format\n      return convertToOpenAITool(tool) as OpenAIClient.ChatCompletionTool;\n    });\n  }\n\n  override bindTools(\n    tools: ChatXAIToolType[],\n    kwargs?: Partial<ChatXAICallOptions>\n  ): Runnable<BaseLanguageModelInput, AIMessageChunk, ChatXAICallOptions> {\n    return this.withConfig({\n      tools: this.formatStructuredToolToXAI(tools),\n      ...kwargs,\n    } as Partial<ChatXAICallOptions>);\n  }\n\n  /** @internal */\n  override invocationParams(\n    options?: this[\"ParsedCallOptions\"],\n    extra?: { streaming?: boolean }\n  ): ChatXAICompletionsInvocationParams {\n    const baseParams = super.invocationParams(options, extra);\n\n    // Cast to xAI-specific params type\n    const params: ChatXAICompletionsInvocationParams = { ...baseParams };\n\n    // Check if live_search tool is being used\n    // We also need to extract params from the tool definition if present\n    const liveSearchTool = options?.tools?.find(isXAIBuiltInTool) as\n      | XAILiveSearchTool\n      | undefined;\n\n    const mergedSearchParams = mergeSearchParams(\n      this.searchParameters,\n      options?.searchParameters,\n      liveSearchTool\n    );\n\n    // Add search_parameters if needed\n    if (mergedSearchParams) {\n      params.search_parameters =\n        buildSearchParametersPayload(mergedSearchParams);\n    }\n\n    return params;\n  }\n\n  async completionWithRetry(\n    request: OpenAIClient.Chat.ChatCompletionCreateParamsStreaming,\n    options?: OpenAICoreRequestOptions\n  ): Promise<AsyncIterable<OpenAIClient.Chat.Completions.ChatCompletionChunk>>;\n\n  async completionWithRetry(\n    request: OpenAIClient.Chat.ChatCompletionCreateParamsNonStreaming,\n    options?: OpenAICoreRequestOptions\n  ): Promise<OpenAIClient.Chat.Completions.ChatCompletion>;\n\n  /**\n   * Calls the xAI API with retry logic in case of failures.\n   * @param request The request to send to the xAI API.\n   * @param options Optional configuration for the API call.\n   * @returns The response from the xAI API.\n   */\n  async completionWithRetry(\n    request:\n      | OpenAIClient.Chat.ChatCompletionCreateParamsStreaming\n      | OpenAIClient.Chat.ChatCompletionCreateParamsNonStreaming,\n    options?: OpenAICoreRequestOptions\n  ): Promise<\n    | AsyncIterable<OpenAIClient.Chat.Completions.ChatCompletionChunk>\n    | OpenAIClient.Chat.Completions.ChatCompletion\n  > {\n    delete request.frequency_penalty;\n    delete request.presence_penalty;\n    delete request.logit_bias;\n    delete request.functions;\n\n    const newRequestMessages = request.messages.map((msg) => {\n      if (!msg.content) {\n        return {\n          ...msg,\n          content: \"\",\n        };\n      }\n      return msg;\n    });\n\n    let filteredTools: OpenAIClient.ChatCompletionTool[] | undefined;\n    if (request.tools) {\n      filteredTools = filterXAIBuiltInTools({\n        tools: request.tools,\n        excludedTypes: [XAI_LIVE_SEARCH_TOOL_TYPE],\n      }) as OpenAIClient.ChatCompletionTool[] | undefined;\n    }\n\n    const newRequest = {\n      ...request,\n      messages: newRequestMessages,\n      tools: filteredTools,\n    };\n\n    if (newRequest.stream === true) {\n      return super.completionWithRetry(newRequest, options);\n    }\n\n    return super.completionWithRetry(newRequest, options);\n  }\n\n  protected override _convertCompletionsDeltaToBaseMessageChunk(\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    delta: Record<string, any>,\n    rawResponse: OpenAIClient.ChatCompletionChunk,\n    defaultRole?:\n      | \"function\"\n      | \"user\"\n      | \"system\"\n      | \"developer\"\n      | \"assistant\"\n      | \"tool\"\n  ): AIMessageChunk {\n    const messageChunk = super._convertCompletionsDeltaToBaseMessageChunk(\n      delta,\n      rawResponse,\n      defaultRole\n    ) as AIMessageChunk;\n\n    // Cast to xAI-specific types for proper typing\n    const responseMetadata =\n      messageChunk.response_metadata as XAIResponseMetadata;\n\n    // Make concatenating chunks work without merge warning\n    if (!rawResponse.choices[0]?.finish_reason) {\n      delete responseMetadata.usage;\n      delete messageChunk.usage_metadata;\n    } else {\n      messageChunk.usage_metadata = responseMetadata.usage;\n    }\n    return messageChunk;\n  }\n\n  /**\n   * Return profiling information for the model.\n   *\n   * Provides information about the model's capabilities and constraints,\n   * including token limits, multimodal support, and advanced features like\n   * tool calling and structured output.\n   *\n   * @returns {ModelProfile} An object describing the model's capabilities and constraints\n   *\n   * @example\n   * ```typescript\n   * const model = new ChatXAI({ model: \"grok-3-fast\" });\n   * const profile = model.profile;\n   * console.log(profile.maxInputTokens); // 128000\n   * console.log(profile.imageInputs); // true\n   * ```\n   */\n  get profile(): ModelProfile {\n    return PROFILES[this.model] ?? {};\n  }\n\n  protected override get streamEventProvider(): string {\n    return \"xai\";\n  }\n}\n"],"mappings":"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"}

package/dist/chat_models/completions.d.cts

@@ -601,6 +601,7 @@ declare class ChatXAI extends ChatOpenAICompletions<ChatXAICallOptions> {
    * ```
    */
   get profile(): ModelProfile;
+  protected get streamEventProvider(): string;
 }
 //#endregion
 export { ChatXAI, ChatXAICallOptions, ChatXAICompletionsInvocationParams, ChatXAIInput, OpenAIToolChoice, XAIAdditionalKwargs, XAIBuiltInTool, XAIResponseMetadata, isXAIBuiltInTool };

package/dist/chat_models/completions.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"completions.d.cts","names":[],"sources":["../../src/chat_models/completions.ts"],"mappings":"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"}
+{"version":3,"file":"completions.d.cts","names":[],"sources":["../../src/chat_models/completions.ts"],"mappings":"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"}

package/dist/chat_models/completions.d.ts

@@ -601,6 +601,7 @@ declare class ChatXAI extends ChatOpenAICompletions<ChatXAICallOptions> {
    * ```
    */
   get profile(): ModelProfile;
+  protected get streamEventProvider(): string;
 }
 //#endregion
 export { ChatXAI, ChatXAICallOptions, ChatXAICompletionsInvocationParams, ChatXAIInput, OpenAIToolChoice, XAIAdditionalKwargs, XAIBuiltInTool, XAIResponseMetadata, isXAIBuiltInTool };

package/dist/chat_models/completions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completions.d.ts","names":[],"sources":["../../src/chat_models/completions.ts"],"mappings":"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"}
+{"version":3,"file":"completions.d.ts","names":[],"sources":["../../src/chat_models/completions.ts"],"mappings":"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"}

package/dist/chat_models/completions.js

@@ -431,7 +431,7 @@ var ChatXAI = class extends ChatOpenAICompletions {
 			apiKey,
 			configuration: { baseURL: fields?.baseURL ?? "https://api.x.ai/v1" }
 		});
-		this._addVersion("@langchain/xai", "1.3.19");
+		this._addVersion("@langchain/xai", "1.4.0");
 		this.searchParameters = fields?.searchParameters;
 	}
 	toJSON() {
@@ -551,6 +551,9 @@ var ChatXAI = class extends ChatOpenAICompletions {
 	get profile() {
 		return PROFILES[this.model] ?? {};
 	}
+	get streamEventProvider() {
+		return "xai";
+	}
 };
 //#endregion
 export { ChatXAI, isXAIBuiltInTool };

package/dist/chat_models/completions.js.map

@@ -1 +1 @@
-{"version":3,"file":"completions.js","names":[],"sources":["../../src/chat_models/completions.ts"],"sourcesContent":["import { BaseLanguageModelInput } from \"@langchain/core/language_models/base\";\nimport {\n  BaseChatModelCallOptions,\n  BindToolsInput,\n  LangSmithParams,\n  type BaseChatModelParams,\n} from \"@langchain/core/language_models/chat_models\";\nimport {\n  isLangChainTool,\n  convertToOpenAITool,\n} from \"@langchain/core/utils/function_calling\";\nimport { ModelProfile } from \"@langchain/core/language_models/profile\";\nimport { Serialized } from \"@langchain/core/load/serializable\";\nimport { AIMessageChunk, type UsageMetadata } from \"@langchain/core/messages\";\nimport { Runnable } from \"@langchain/core/runnables\";\nimport { getEnvironmentVariable } from \"@langchain/core/utils/env\";\nimport {\n  type OpenAICoreRequestOptions,\n  type OpenAIClient,\n  ChatOpenAICompletions,\n} from \"@langchain/openai\";\nimport {\n  buildSearchParametersPayload,\n  filterXAIBuiltInTools,\n  mergeSearchParams,\n  type XAISearchParameters,\n  type XAISearchParametersPayload,\n} from \"../live_search.js\";\nimport PROFILES from \"../profiles.js\";\nimport {\n  XAI_LIVE_SEARCH_TOOL_TYPE,\n  XAILiveSearchTool,\n} from \"../tools/live_search.js\";\n\nexport type OpenAIToolChoice =\n  | OpenAIClient.ChatCompletionToolChoiceOption\n  | \"any\"\n  | string;\n\n/**\n * Union type for all xAI built-in server-side tools.\n */\nexport type XAIBuiltInTool = XAILiveSearchTool;\n\n/**\n * Set of all supported xAI built-in server-side tool types.\n * This allows us to easily extend support for future built-in tools\n * without changing the core detection logic.\n */\nconst XAI_BUILT_IN_TOOL_TYPES = new Set<XAILiveSearchTool[\"type\"] | string>([\n  XAI_LIVE_SEARCH_TOOL_TYPE,\n]);\n\n/**\n * Tool type that includes both standard tools and xAI built-in tools.\n */\ntype ChatXAIToolType =\n  | BindToolsInput\n  | OpenAIClient.ChatCompletionTool\n  | XAIBuiltInTool;\n\n/**\n * xAI-specific invocation parameters that extend the OpenAI completion params\n * with xAI's search_parameters field.\n */\nexport type ChatXAICompletionsInvocationParams = Omit<\n  OpenAIClient.Chat.Completions.ChatCompletionCreateParams,\n  \"messages\"\n> & {\n  /**\n   * Search parameters for xAI's Live Search API.\n   * When present, enables the model to search the web for real-time information.\n   */\n  search_parameters?: XAISearchParametersPayload;\n};\n\n/**\n * xAI-specific additional kwargs that may be present on AI messages.\n * Includes xAI-specific fields like reasoning_content.\n */\nexport interface XAIAdditionalKwargs {\n  /**\n   * The reasoning content from xAI models that support chain-of-thought reasoning.\n   * This contains the model's internal reasoning process.\n   */\n  reasoning_content?: string;\n  /**\n   * Tool calls made by the model.\n   */\n  tool_calls?: OpenAIClient.ChatCompletionMessageToolCall[];\n  /**\n   * Additional properties that may be present.\n   */\n  [key: string]: unknown;\n}\n\n/**\n * xAI-specific response metadata that may include usage information.\n */\nexport interface XAIResponseMetadata {\n  /**\n   * Token usage information.\n   */\n  usage?: UsageMetadata;\n  /**\n   * Additional metadata properties.\n   */\n  [key: string]: unknown;\n}\n\n/**\n * Checks if a tool is an xAI built-in tool (like live_search).\n * Built-in tools are executed server-side by the xAI API.\n *\n * @param tool - The tool to check\n * @returns true if the tool is an xAI built-in tool\n */\nexport function isXAIBuiltInTool(\n  tool: ChatXAIToolType\n): tool is XAIBuiltInTool {\n  return (\n    typeof tool === \"object\" &&\n    tool !== null &&\n    \"type\" in tool &&\n    typeof (tool as { type?: unknown }).type === \"string\" &&\n    XAI_BUILT_IN_TOOL_TYPES.has((tool as { type: string }).type)\n  );\n}\n\nexport interface ChatXAICallOptions extends BaseChatModelCallOptions {\n  headers?: Record<string, string>;\n  /**\n   * A list of tools the model may call.\n   * Can include standard function tools and xAI built-in tools like `{ type: \"live_search\" }`.\n   *\n   * @example\n   * ```typescript\n   * // Using built-in live_search tool\n   * const llm = new ChatXAI().bindTools([{ type: \"live_search\" }]);\n   * const result = await llm.invoke(\"What happened in tech news today?\");\n   * ```\n   */\n  tools?: ChatXAIToolType[];\n  tool_choice?: OpenAIToolChoice | string | \"auto\" | \"any\";\n  /**\n   * Search parameters for xAI's Live Search API.\n   * Enables the model to search the web for real-time information.\n   *\n   * @note This is an alternative to using `tools: [{ type: \"live_search\" }]`.\n   * The Live Search API parameters approach may be deprecated in favor of\n   * the tool-based approach.\n   *\n   * @example\n   * ```typescript\n   * const result = await llm.invoke(\"What's the latest news?\", {\n   *   searchParameters: {\n   *     mode: \"auto\",\n   *     max_search_results: 5,\n   *   }\n   * });\n   * ```\n   */\n  searchParameters?: XAISearchParameters;\n}\n\nexport interface ChatXAIInput extends BaseChatModelParams {\n  /**\n   * The xAI API key to use for requests.\n   * @default process.env.XAI_API_KEY\n   */\n  apiKey?: string;\n  /**\n   * The name of the model to use.\n   * @default \"grok-3-fast\"\n   */\n  model?: string;\n  /**\n   * Up to 4 sequences where the API will stop generating further tokens. The\n   * returned text will not contain the stop sequence.\n   * Alias for `stopSequences`\n   */\n  stop?: Array<string>;\n  /**\n   * Up to 4 sequences where the API will stop generating further tokens. The\n   * returned text will not contain the stop sequence.\n   */\n  stopSequences?: Array<string>;\n  /**\n   * Whether or not to stream responses.\n   */\n  streaming?: boolean;\n  /**\n   * The temperature to use for sampling.\n   * @default 0.7\n   */\n  temperature?: number;\n  /**\n   * The maximum number of tokens that the model can process in a single response.\n   * This limits ensures computational efficiency and resource management.\n   */\n  maxTokens?: number;\n  /**\n   * Default search parameters for xAI's Live Search API.\n   * When set, these parameters will be applied to all requests unless\n   * overridden in the call options.\n   *\n   * @example\n   * ```typescript\n   * const llm = new ChatXAI({\n   *   model: \"grok-3-fast\",\n   *   searchParameters: {\n   *     mode: \"auto\",\n   *     max_search_results: 5,\n   *   }\n   * });\n   * ```\n   */\n  searchParameters?: XAISearchParameters;\n  /**\n   * The base URL for the xAI API.\n   * @default \"https://api.x.ai/v1\"\n   */\n  baseURL?: string;\n}\n\n/**\n * xAI chat model integration.\n *\n * The xAI API is compatible to the OpenAI API with some limitations.\n *\n * Setup:\n * Install `@langchain/xai` and set an environment variable named `XAI_API_KEY`.\n *\n * ```bash\n * npm install @langchain/xai\n * export XAI_API_KEY=\"your-api-key\"\n * ```\n *\n * ## [Constructor args](https://api.js.langchain.com/classes/_langchain_xai.ChatXAI.html#constructor)\n *\n * ## [Runtime args](https://api.js.langchain.com/interfaces/_langchain_xai.ChatXAICallOptions.html)\n *\n * Runtime args can be passed as the second argument to any of the base runnable methods `.invoke`. `.stream`, `.batch`, etc.\n * They can also be passed via `.withConfig`, or the second arg in `.bindTools`, like shown in the examples below:\n *\n * ```typescript\n * // When calling `.withConfig`, call options should be passed via the first argument\n * const llmWithArgsBound = llm.withConfig({\n *   stop: [\"\\n\"],\n *   tools: [...],\n * });\n *\n * // When calling `.bindTools`, call options should be passed via the second argument\n * const llmWithTools = llm.bindTools(\n *   [...],\n *   {\n *     tool_choice: \"auto\",\n *   }\n * );\n * ```\n *\n * ## Examples\n *\n * <details open>\n * <summary><strong>Instantiate</strong></summary>\n *\n * ```typescript\n * import { ChatXAI } from '@langchain/xai';\n *\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   temperature: 0,\n *   // other params...\n * });\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Invoking</strong></summary>\n *\n * ```typescript\n * const input = `Translate \"I love programming\" into French.`;\n *\n * // Models also accept a list of chat messages or a formatted prompt\n * const result = await llm.invoke(input);\n * console.log(result);\n * ```\n *\n * ```txt\n * AIMessage {\n *   \"content\": \"The French translation of \\\"I love programming\\\" is \\\"J'aime programmer\\\". In this sentence, \\\"J'aime\\\" is the first person singular conjugation of the French verb \\\"aimer\\\" which means \\\"to love\\\", and \\\"programmer\\\" is the French infinitive for \\\"to program\\\". I hope this helps! Let me know if you have any other questions.\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"tokenUsage\": {\n *       \"completionTokens\": 82,\n *       \"promptTokens\": 20,\n *       \"totalTokens\": 102\n *     },\n *     \"finish_reason\": \"stop\"\n *   },\n *   \"tool_calls\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Streaming Chunks</strong></summary>\n *\n * ```typescript\n * for await (const chunk of await llm.stream(input)) {\n *   console.log(chunk);\n * }\n * ```\n *\n * ```txt\n * AIMessageChunk {\n *   \"content\": \"\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \"The\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" French\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" translation\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" of\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" \\\"\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \"I\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" love\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ...\n * AIMessageChunk {\n *   \"content\": \".\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \"\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": \"stop\"\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Aggregate Streamed Chunks</strong></summary>\n *\n * ```typescript\n * import { AIMessageChunk } from '@langchain/core/messages';\n * import { concat } from '@langchain/core/utils/stream';\n *\n * const stream = await llm.stream(input);\n * let full: AIMessageChunk | undefined;\n * for await (const chunk of stream) {\n *   full = !full ? chunk : concat(full, chunk);\n * }\n * console.log(full);\n * ```\n *\n * ```txt\n * AIMessageChunk {\n *   \"content\": \"The French translation of \\\"I love programming\\\" is \\\"J'aime programmer\\\". In this sentence, \\\"J'aime\\\" is the first person singular conjugation of the French verb \\\"aimer\\\" which means \\\"to love\\\", and \\\"programmer\\\" is the French infinitive for \\\"to program\\\". I hope this helps! Let me know if you have any other questions.\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": \"stop\"\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Bind tools</strong></summary>\n *\n * ```typescript\n * import { z } from 'zod';\n *\n * const llmForToolCalling = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   temperature: 0,\n *   // other params...\n * });\n *\n * const GetWeather = {\n *   name: \"GetWeather\",\n *   description: \"Get the current weather in a given location\",\n *   schema: z.object({\n *     location: z.string().describe(\"The city and state, e.g. San Francisco, CA\")\n *   }),\n * }\n *\n * const GetPopulation = {\n *   name: \"GetPopulation\",\n *   description: \"Get the current population in a given location\",\n *   schema: z.object({\n *     location: z.string().describe(\"The city and state, e.g. San Francisco, CA\")\n *   }),\n * }\n *\n * const llmWithTools = llmForToolCalling.bindTools([GetWeather, GetPopulation]);\n * const aiMsg = await llmWithTools.invoke(\n *   \"Which city is hotter today and which is bigger: LA or NY?\"\n * );\n * console.log(aiMsg.tool_calls);\n * ```\n *\n * ```txt\n * [\n *   {\n *     name: 'GetWeather',\n *     args: { location: 'Los Angeles, CA' },\n *     type: 'tool_call',\n *     id: 'call_cd34'\n *   },\n *   {\n *     name: 'GetWeather',\n *     args: { location: 'New York, NY' },\n *     type: 'tool_call',\n *     id: 'call_68rf'\n *   },\n *   {\n *     name: 'GetPopulation',\n *     args: { location: 'Los Angeles, CA' },\n *     type: 'tool_call',\n *     id: 'call_f81z'\n *   },\n *   {\n *     name: 'GetPopulation',\n *     args: { location: 'New York, NY' },\n *     type: 'tool_call',\n *     id: 'call_8byt'\n *   }\n * ]\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Structured Output</strong></summary>\n *\n * ```typescript\n * import { z } from 'zod';\n *\n * const Joke = z.object({\n *   setup: z.string().describe(\"The setup of the joke\"),\n *   punchline: z.string().describe(\"The punchline to the joke\"),\n *   rating: z.number().optional().describe(\"How funny the joke is, from 1 to 10\")\n * }).describe('Joke to tell user.');\n *\n * const structuredLlm = llmForToolCalling.withStructuredOutput(Joke, { name: \"Joke\" });\n * const jokeResult = await structuredLlm.invoke(\"Tell me a joke about cats\");\n * console.log(jokeResult);\n * ```\n *\n * ```txt\n * {\n *   setup: \"Why don't cats play poker in the wild?\",\n *   punchline: 'Because there are too many cheetahs.'\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Server Tool Calling (Live Search)</strong></summary>\n *\n * xAI supports server-side tools that are executed by the API rather than\n * requiring client-side execution. The `live_search` tool enables the model\n * to search the web for real-time information.\n *\n * ```typescript\n * // Method 1: Using the built-in live_search tool\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   temperature: 0,\n * });\n *\n * const llmWithSearch = llm.bindTools([{ type: \"live_search\" }]);\n * const result = await llmWithSearch.invoke(\"What happened in tech news today?\");\n * console.log(result.content);\n * // The model will search the web and include real-time information in its response\n * ```\n *\n * ```typescript\n * // Method 2: Using searchParameters for more control\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   searchParameters: {\n *     mode: \"auto\", // \"auto\" | \"on\" | \"off\"\n *     max_search_results: 5,\n *     from_date: \"2024-01-01\", // ISO date string\n *     return_citations: true,\n *   }\n * });\n *\n * const result = await llm.invoke(\"What are the latest AI developments?\");\n * ```\n *\n * ```typescript\n * // Method 3: Override search parameters per request\n * const result = await llm.invoke(\"Find recent news about SpaceX\", {\n *   searchParameters: {\n *     mode: \"on\",\n *     max_search_results: 10,\n *     sources: [\n *       { type: \"web\", allowed_websites: [\"spacex.com\", \"nasa.gov\"] },\n *     ],\n *   }\n * });\n * ```\n * </details>\n *\n * <br />\n */\nexport class ChatXAI extends ChatOpenAICompletions<ChatXAICallOptions> {\n  static lc_name() {\n    return \"ChatXAI\";\n  }\n\n  _llmType() {\n    return \"xai\";\n  }\n\n  get lc_secrets(): { [key: string]: string } | undefined {\n    return {\n      apiKey: \"XAI_API_KEY\",\n    };\n  }\n\n  lc_serializable = true;\n\n  lc_namespace = [\"langchain\", \"chat_models\", \"xai\"];\n\n  /**\n   * Default search parameters for the Live Search API.\n   */\n  searchParameters?: XAISearchParameters;\n\n  constructor(model: string, fields?: Omit<ChatXAIInput, \"model\">);\n  constructor(fields?: Partial<ChatXAIInput>);\n  constructor(\n    modelOrFields?: string | Partial<ChatXAIInput>,\n    fieldsArg?: Omit<ChatXAIInput, \"model\">\n  ) {\n    const fields =\n      typeof modelOrFields === \"string\"\n        ? { ...(fieldsArg ?? {}), model: modelOrFields }\n        : (modelOrFields ?? {});\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 into \"apiKey\" field.`\n      );\n    }\n\n    super({\n      ...fields,\n      model: fields?.model || \"grok-3-fast\",\n      apiKey,\n      configuration: {\n        baseURL: fields?.baseURL ?? \"https://api.x.ai/v1\",\n      },\n    });\n\n    this._addVersion(\"@langchain/xai\", __PKG_VERSION__);\n\n    this.searchParameters = fields?.searchParameters;\n  }\n\n  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.openai_api_key;\n      delete result.kwargs.configuration;\n    }\n\n    return result;\n  }\n\n  getLsParams(options: this[\"ParsedCallOptions\"]): LangSmithParams {\n    const params = super.getLsParams(options);\n    params.ls_provider = \"xai\";\n    return params;\n  }\n\n  /**\n   * Get the effective search parameters, merging defaults with call options.\n   * @param options Call options that may contain search parameters\n   * @returns Merged search parameters or undefined if none are configured\n   */\n  protected _getEffectiveSearchParameters(\n    options?: this[\"ParsedCallOptions\"]\n  ): XAISearchParameters | undefined {\n    return mergeSearchParams(this.searchParameters, options?.searchParameters);\n  }\n\n  /**\n   * Check if any built-in tools (like live_search) are in the tools list.\n   * @param tools List of tools to check\n   * @returns true if any built-in tools are present\n   */\n  protected _hasBuiltInTools(tools?: ChatXAIToolType[]): boolean {\n    return tools?.some(isXAIBuiltInTool) ?? false;\n  }\n\n  /**\n   * Formats tools to xAI/OpenAI format, preserving provider-specific definitions.\n   *\n   * @param tools The tools to format\n   * @returns The formatted tools\n   */\n  formatStructuredToolToXAI(\n    tools: ChatXAIToolType[]\n  ): (OpenAIClient.ChatCompletionTool | XAIBuiltInTool)[] | undefined {\n    if (!tools || !tools.length) {\n      return undefined;\n    }\n    return tools.map((tool) => {\n      // 1. Check for provider definition first (from xaiLiveSearch factory)\n      if (isLangChainTool(tool) && tool.extras?.providerToolDefinition) {\n        return tool.extras.providerToolDefinition as XAIBuiltInTool;\n      }\n      // 2. Check for built-in tools (legacy { type: \"live_search\" })\n      if (isXAIBuiltInTool(tool)) {\n        return tool;\n      }\n      // 3. Convert standard tools to OpenAI format\n      return convertToOpenAITool(tool) as OpenAIClient.ChatCompletionTool;\n    });\n  }\n\n  override bindTools(\n    tools: ChatXAIToolType[],\n    kwargs?: Partial<ChatXAICallOptions>\n  ): Runnable<BaseLanguageModelInput, AIMessageChunk, ChatXAICallOptions> {\n    return this.withConfig({\n      tools: this.formatStructuredToolToXAI(tools),\n      ...kwargs,\n    } as Partial<ChatXAICallOptions>);\n  }\n\n  /** @internal */\n  override invocationParams(\n    options?: this[\"ParsedCallOptions\"],\n    extra?: { streaming?: boolean }\n  ): ChatXAICompletionsInvocationParams {\n    const baseParams = super.invocationParams(options, extra);\n\n    // Cast to xAI-specific params type\n    const params: ChatXAICompletionsInvocationParams = { ...baseParams };\n\n    // Check if live_search tool is being used\n    // We also need to extract params from the tool definition if present\n    const liveSearchTool = options?.tools?.find(isXAIBuiltInTool) as\n      | XAILiveSearchTool\n      | undefined;\n\n    const mergedSearchParams = mergeSearchParams(\n      this.searchParameters,\n      options?.searchParameters,\n      liveSearchTool\n    );\n\n    // Add search_parameters if needed\n    if (mergedSearchParams) {\n      params.search_parameters =\n        buildSearchParametersPayload(mergedSearchParams);\n    }\n\n    return params;\n  }\n\n  async completionWithRetry(\n    request: OpenAIClient.Chat.ChatCompletionCreateParamsStreaming,\n    options?: OpenAICoreRequestOptions\n  ): Promise<AsyncIterable<OpenAIClient.Chat.Completions.ChatCompletionChunk>>;\n\n  async completionWithRetry(\n    request: OpenAIClient.Chat.ChatCompletionCreateParamsNonStreaming,\n    options?: OpenAICoreRequestOptions\n  ): Promise<OpenAIClient.Chat.Completions.ChatCompletion>;\n\n  /**\n   * Calls the xAI API with retry logic in case of failures.\n   * @param request The request to send to the xAI API.\n   * @param options Optional configuration for the API call.\n   * @returns The response from the xAI API.\n   */\n  async completionWithRetry(\n    request:\n      | OpenAIClient.Chat.ChatCompletionCreateParamsStreaming\n      | OpenAIClient.Chat.ChatCompletionCreateParamsNonStreaming,\n    options?: OpenAICoreRequestOptions\n  ): Promise<\n    | AsyncIterable<OpenAIClient.Chat.Completions.ChatCompletionChunk>\n    | OpenAIClient.Chat.Completions.ChatCompletion\n  > {\n    delete request.frequency_penalty;\n    delete request.presence_penalty;\n    delete request.logit_bias;\n    delete request.functions;\n\n    const newRequestMessages = request.messages.map((msg) => {\n      if (!msg.content) {\n        return {\n          ...msg,\n          content: \"\",\n        };\n      }\n      return msg;\n    });\n\n    let filteredTools: OpenAIClient.ChatCompletionTool[] | undefined;\n    if (request.tools) {\n      filteredTools = filterXAIBuiltInTools({\n        tools: request.tools,\n        excludedTypes: [XAI_LIVE_SEARCH_TOOL_TYPE],\n      }) as OpenAIClient.ChatCompletionTool[] | undefined;\n    }\n\n    const newRequest = {\n      ...request,\n      messages: newRequestMessages,\n      tools: filteredTools,\n    };\n\n    if (newRequest.stream === true) {\n      return super.completionWithRetry(newRequest, options);\n    }\n\n    return super.completionWithRetry(newRequest, options);\n  }\n\n  protected override _convertCompletionsDeltaToBaseMessageChunk(\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    delta: Record<string, any>,\n    rawResponse: OpenAIClient.ChatCompletionChunk,\n    defaultRole?:\n      | \"function\"\n      | \"user\"\n      | \"system\"\n      | \"developer\"\n      | \"assistant\"\n      | \"tool\"\n  ): AIMessageChunk {\n    const messageChunk = super._convertCompletionsDeltaToBaseMessageChunk(\n      delta,\n      rawResponse,\n      defaultRole\n    ) as AIMessageChunk;\n\n    // Cast to xAI-specific types for proper typing\n    const responseMetadata =\n      messageChunk.response_metadata as XAIResponseMetadata;\n\n    // Make concatenating chunks work without merge warning\n    if (!rawResponse.choices[0]?.finish_reason) {\n      delete responseMetadata.usage;\n      delete messageChunk.usage_metadata;\n    } else {\n      messageChunk.usage_metadata = responseMetadata.usage;\n    }\n    return messageChunk;\n  }\n\n  /**\n   * Return profiling information for the model.\n   *\n   * Provides information about the model's capabilities and constraints,\n   * including token limits, multimodal support, and advanced features like\n   * tool calling and structured output.\n   *\n   * @returns {ModelProfile} An object describing the model's capabilities and constraints\n   *\n   * @example\n   * ```typescript\n   * const model = new ChatXAI({ model: \"grok-3-fast\" });\n   * const profile = model.profile;\n   * console.log(profile.maxInputTokens); // 128000\n   * console.log(profile.imageInputs); // true\n   * ```\n   */\n  get profile(): ModelProfile {\n    return PROFILES[this.model] ?? {};\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"completions.js","names":[],"sources":["../../src/chat_models/completions.ts"],"sourcesContent":["import { BaseLanguageModelInput } from \"@langchain/core/language_models/base\";\nimport {\n  BaseChatModelCallOptions,\n  BindToolsInput,\n  LangSmithParams,\n  type BaseChatModelParams,\n} from \"@langchain/core/language_models/chat_models\";\nimport {\n  isLangChainTool,\n  convertToOpenAITool,\n} from \"@langchain/core/utils/function_calling\";\nimport { ModelProfile } from \"@langchain/core/language_models/profile\";\nimport { Serialized } from \"@langchain/core/load/serializable\";\nimport { AIMessageChunk, type UsageMetadata } from \"@langchain/core/messages\";\nimport { Runnable } from \"@langchain/core/runnables\";\nimport { getEnvironmentVariable } from \"@langchain/core/utils/env\";\nimport {\n  type OpenAICoreRequestOptions,\n  type OpenAIClient,\n  ChatOpenAICompletions,\n} from \"@langchain/openai\";\nimport {\n  buildSearchParametersPayload,\n  filterXAIBuiltInTools,\n  mergeSearchParams,\n  type XAISearchParameters,\n  type XAISearchParametersPayload,\n} from \"../live_search.js\";\nimport PROFILES from \"../profiles.js\";\nimport {\n  XAI_LIVE_SEARCH_TOOL_TYPE,\n  XAILiveSearchTool,\n} from \"../tools/live_search.js\";\n\nexport type OpenAIToolChoice =\n  | OpenAIClient.ChatCompletionToolChoiceOption\n  | \"any\"\n  | string;\n\n/**\n * Union type for all xAI built-in server-side tools.\n */\nexport type XAIBuiltInTool = XAILiveSearchTool;\n\n/**\n * Set of all supported xAI built-in server-side tool types.\n * This allows us to easily extend support for future built-in tools\n * without changing the core detection logic.\n */\nconst XAI_BUILT_IN_TOOL_TYPES = new Set<XAILiveSearchTool[\"type\"] | string>([\n  XAI_LIVE_SEARCH_TOOL_TYPE,\n]);\n\n/**\n * Tool type that includes both standard tools and xAI built-in tools.\n */\ntype ChatXAIToolType =\n  | BindToolsInput\n  | OpenAIClient.ChatCompletionTool\n  | XAIBuiltInTool;\n\n/**\n * xAI-specific invocation parameters that extend the OpenAI completion params\n * with xAI's search_parameters field.\n */\nexport type ChatXAICompletionsInvocationParams = Omit<\n  OpenAIClient.Chat.Completions.ChatCompletionCreateParams,\n  \"messages\"\n> & {\n  /**\n   * Search parameters for xAI's Live Search API.\n   * When present, enables the model to search the web for real-time information.\n   */\n  search_parameters?: XAISearchParametersPayload;\n};\n\n/**\n * xAI-specific additional kwargs that may be present on AI messages.\n * Includes xAI-specific fields like reasoning_content.\n */\nexport interface XAIAdditionalKwargs {\n  /**\n   * The reasoning content from xAI models that support chain-of-thought reasoning.\n   * This contains the model's internal reasoning process.\n   */\n  reasoning_content?: string;\n  /**\n   * Tool calls made by the model.\n   */\n  tool_calls?: OpenAIClient.ChatCompletionMessageToolCall[];\n  /**\n   * Additional properties that may be present.\n   */\n  [key: string]: unknown;\n}\n\n/**\n * xAI-specific response metadata that may include usage information.\n */\nexport interface XAIResponseMetadata {\n  /**\n   * Token usage information.\n   */\n  usage?: UsageMetadata;\n  /**\n   * Additional metadata properties.\n   */\n  [key: string]: unknown;\n}\n\n/**\n * Checks if a tool is an xAI built-in tool (like live_search).\n * Built-in tools are executed server-side by the xAI API.\n *\n * @param tool - The tool to check\n * @returns true if the tool is an xAI built-in tool\n */\nexport function isXAIBuiltInTool(\n  tool: ChatXAIToolType\n): tool is XAIBuiltInTool {\n  return (\n    typeof tool === \"object\" &&\n    tool !== null &&\n    \"type\" in tool &&\n    typeof (tool as { type?: unknown }).type === \"string\" &&\n    XAI_BUILT_IN_TOOL_TYPES.has((tool as { type: string }).type)\n  );\n}\n\nexport interface ChatXAICallOptions extends BaseChatModelCallOptions {\n  headers?: Record<string, string>;\n  /**\n   * A list of tools the model may call.\n   * Can include standard function tools and xAI built-in tools like `{ type: \"live_search\" }`.\n   *\n   * @example\n   * ```typescript\n   * // Using built-in live_search tool\n   * const llm = new ChatXAI().bindTools([{ type: \"live_search\" }]);\n   * const result = await llm.invoke(\"What happened in tech news today?\");\n   * ```\n   */\n  tools?: ChatXAIToolType[];\n  tool_choice?: OpenAIToolChoice | string | \"auto\" | \"any\";\n  /**\n   * Search parameters for xAI's Live Search API.\n   * Enables the model to search the web for real-time information.\n   *\n   * @note This is an alternative to using `tools: [{ type: \"live_search\" }]`.\n   * The Live Search API parameters approach may be deprecated in favor of\n   * the tool-based approach.\n   *\n   * @example\n   * ```typescript\n   * const result = await llm.invoke(\"What's the latest news?\", {\n   *   searchParameters: {\n   *     mode: \"auto\",\n   *     max_search_results: 5,\n   *   }\n   * });\n   * ```\n   */\n  searchParameters?: XAISearchParameters;\n}\n\nexport interface ChatXAIInput extends BaseChatModelParams {\n  /**\n   * The xAI API key to use for requests.\n   * @default process.env.XAI_API_KEY\n   */\n  apiKey?: string;\n  /**\n   * The name of the model to use.\n   * @default \"grok-3-fast\"\n   */\n  model?: string;\n  /**\n   * Up to 4 sequences where the API will stop generating further tokens. The\n   * returned text will not contain the stop sequence.\n   * Alias for `stopSequences`\n   */\n  stop?: Array<string>;\n  /**\n   * Up to 4 sequences where the API will stop generating further tokens. The\n   * returned text will not contain the stop sequence.\n   */\n  stopSequences?: Array<string>;\n  /**\n   * Whether or not to stream responses.\n   */\n  streaming?: boolean;\n  /**\n   * The temperature to use for sampling.\n   * @default 0.7\n   */\n  temperature?: number;\n  /**\n   * The maximum number of tokens that the model can process in a single response.\n   * This limits ensures computational efficiency and resource management.\n   */\n  maxTokens?: number;\n  /**\n   * Default search parameters for xAI's Live Search API.\n   * When set, these parameters will be applied to all requests unless\n   * overridden in the call options.\n   *\n   * @example\n   * ```typescript\n   * const llm = new ChatXAI({\n   *   model: \"grok-3-fast\",\n   *   searchParameters: {\n   *     mode: \"auto\",\n   *     max_search_results: 5,\n   *   }\n   * });\n   * ```\n   */\n  searchParameters?: XAISearchParameters;\n  /**\n   * The base URL for the xAI API.\n   * @default \"https://api.x.ai/v1\"\n   */\n  baseURL?: string;\n}\n\n/**\n * xAI chat model integration.\n *\n * The xAI API is compatible to the OpenAI API with some limitations.\n *\n * Setup:\n * Install `@langchain/xai` and set an environment variable named `XAI_API_KEY`.\n *\n * ```bash\n * npm install @langchain/xai\n * export XAI_API_KEY=\"your-api-key\"\n * ```\n *\n * ## [Constructor args](https://api.js.langchain.com/classes/_langchain_xai.ChatXAI.html#constructor)\n *\n * ## [Runtime args](https://api.js.langchain.com/interfaces/_langchain_xai.ChatXAICallOptions.html)\n *\n * Runtime args can be passed as the second argument to any of the base runnable methods `.invoke`. `.stream`, `.batch`, etc.\n * They can also be passed via `.withConfig`, or the second arg in `.bindTools`, like shown in the examples below:\n *\n * ```typescript\n * // When calling `.withConfig`, call options should be passed via the first argument\n * const llmWithArgsBound = llm.withConfig({\n *   stop: [\"\\n\"],\n *   tools: [...],\n * });\n *\n * // When calling `.bindTools`, call options should be passed via the second argument\n * const llmWithTools = llm.bindTools(\n *   [...],\n *   {\n *     tool_choice: \"auto\",\n *   }\n * );\n * ```\n *\n * ## Examples\n *\n * <details open>\n * <summary><strong>Instantiate</strong></summary>\n *\n * ```typescript\n * import { ChatXAI } from '@langchain/xai';\n *\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   temperature: 0,\n *   // other params...\n * });\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Invoking</strong></summary>\n *\n * ```typescript\n * const input = `Translate \"I love programming\" into French.`;\n *\n * // Models also accept a list of chat messages or a formatted prompt\n * const result = await llm.invoke(input);\n * console.log(result);\n * ```\n *\n * ```txt\n * AIMessage {\n *   \"content\": \"The French translation of \\\"I love programming\\\" is \\\"J'aime programmer\\\". In this sentence, \\\"J'aime\\\" is the first person singular conjugation of the French verb \\\"aimer\\\" which means \\\"to love\\\", and \\\"programmer\\\" is the French infinitive for \\\"to program\\\". I hope this helps! Let me know if you have any other questions.\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"tokenUsage\": {\n *       \"completionTokens\": 82,\n *       \"promptTokens\": 20,\n *       \"totalTokens\": 102\n *     },\n *     \"finish_reason\": \"stop\"\n *   },\n *   \"tool_calls\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Streaming Chunks</strong></summary>\n *\n * ```typescript\n * for await (const chunk of await llm.stream(input)) {\n *   console.log(chunk);\n * }\n * ```\n *\n * ```txt\n * AIMessageChunk {\n *   \"content\": \"\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \"The\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" French\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" translation\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" of\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" \\\"\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \"I\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \" love\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ...\n * AIMessageChunk {\n *   \"content\": \".\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": null\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * AIMessageChunk {\n *   \"content\": \"\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": \"stop\"\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Aggregate Streamed Chunks</strong></summary>\n *\n * ```typescript\n * import { AIMessageChunk } from '@langchain/core/messages';\n * import { concat } from '@langchain/core/utils/stream';\n *\n * const stream = await llm.stream(input);\n * let full: AIMessageChunk | undefined;\n * for await (const chunk of stream) {\n *   full = !full ? chunk : concat(full, chunk);\n * }\n * console.log(full);\n * ```\n *\n * ```txt\n * AIMessageChunk {\n *   \"content\": \"The French translation of \\\"I love programming\\\" is \\\"J'aime programmer\\\". In this sentence, \\\"J'aime\\\" is the first person singular conjugation of the French verb \\\"aimer\\\" which means \\\"to love\\\", and \\\"programmer\\\" is the French infinitive for \\\"to program\\\". I hope this helps! Let me know if you have any other questions.\",\n *   \"additional_kwargs\": {},\n *   \"response_metadata\": {\n *     \"finishReason\": \"stop\"\n *   },\n *   \"tool_calls\": [],\n *   \"tool_call_chunks\": [],\n *   \"invalid_tool_calls\": []\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Bind tools</strong></summary>\n *\n * ```typescript\n * import { z } from 'zod';\n *\n * const llmForToolCalling = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   temperature: 0,\n *   // other params...\n * });\n *\n * const GetWeather = {\n *   name: \"GetWeather\",\n *   description: \"Get the current weather in a given location\",\n *   schema: z.object({\n *     location: z.string().describe(\"The city and state, e.g. San Francisco, CA\")\n *   }),\n * }\n *\n * const GetPopulation = {\n *   name: \"GetPopulation\",\n *   description: \"Get the current population in a given location\",\n *   schema: z.object({\n *     location: z.string().describe(\"The city and state, e.g. San Francisco, CA\")\n *   }),\n * }\n *\n * const llmWithTools = llmForToolCalling.bindTools([GetWeather, GetPopulation]);\n * const aiMsg = await llmWithTools.invoke(\n *   \"Which city is hotter today and which is bigger: LA or NY?\"\n * );\n * console.log(aiMsg.tool_calls);\n * ```\n *\n * ```txt\n * [\n *   {\n *     name: 'GetWeather',\n *     args: { location: 'Los Angeles, CA' },\n *     type: 'tool_call',\n *     id: 'call_cd34'\n *   },\n *   {\n *     name: 'GetWeather',\n *     args: { location: 'New York, NY' },\n *     type: 'tool_call',\n *     id: 'call_68rf'\n *   },\n *   {\n *     name: 'GetPopulation',\n *     args: { location: 'Los Angeles, CA' },\n *     type: 'tool_call',\n *     id: 'call_f81z'\n *   },\n *   {\n *     name: 'GetPopulation',\n *     args: { location: 'New York, NY' },\n *     type: 'tool_call',\n *     id: 'call_8byt'\n *   }\n * ]\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Structured Output</strong></summary>\n *\n * ```typescript\n * import { z } from 'zod';\n *\n * const Joke = z.object({\n *   setup: z.string().describe(\"The setup of the joke\"),\n *   punchline: z.string().describe(\"The punchline to the joke\"),\n *   rating: z.number().optional().describe(\"How funny the joke is, from 1 to 10\")\n * }).describe('Joke to tell user.');\n *\n * const structuredLlm = llmForToolCalling.withStructuredOutput(Joke, { name: \"Joke\" });\n * const jokeResult = await structuredLlm.invoke(\"Tell me a joke about cats\");\n * console.log(jokeResult);\n * ```\n *\n * ```txt\n * {\n *   setup: \"Why don't cats play poker in the wild?\",\n *   punchline: 'Because there are too many cheetahs.'\n * }\n * ```\n * </details>\n *\n * <br />\n *\n * <details>\n * <summary><strong>Server Tool Calling (Live Search)</strong></summary>\n *\n * xAI supports server-side tools that are executed by the API rather than\n * requiring client-side execution. The `live_search` tool enables the model\n * to search the web for real-time information.\n *\n * ```typescript\n * // Method 1: Using the built-in live_search tool\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   temperature: 0,\n * });\n *\n * const llmWithSearch = llm.bindTools([{ type: \"live_search\" }]);\n * const result = await llmWithSearch.invoke(\"What happened in tech news today?\");\n * console.log(result.content);\n * // The model will search the web and include real-time information in its response\n * ```\n *\n * ```typescript\n * // Method 2: Using searchParameters for more control\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n *   searchParameters: {\n *     mode: \"auto\", // \"auto\" | \"on\" | \"off\"\n *     max_search_results: 5,\n *     from_date: \"2024-01-01\", // ISO date string\n *     return_citations: true,\n *   }\n * });\n *\n * const result = await llm.invoke(\"What are the latest AI developments?\");\n * ```\n *\n * ```typescript\n * // Method 3: Override search parameters per request\n * const result = await llm.invoke(\"Find recent news about SpaceX\", {\n *   searchParameters: {\n *     mode: \"on\",\n *     max_search_results: 10,\n *     sources: [\n *       { type: \"web\", allowed_websites: [\"spacex.com\", \"nasa.gov\"] },\n *     ],\n *   }\n * });\n * ```\n * </details>\n *\n * <br />\n */\nexport class ChatXAI extends ChatOpenAICompletions<ChatXAICallOptions> {\n  static lc_name() {\n    return \"ChatXAI\";\n  }\n\n  _llmType() {\n    return \"xai\";\n  }\n\n  get lc_secrets(): { [key: string]: string } | undefined {\n    return {\n      apiKey: \"XAI_API_KEY\",\n    };\n  }\n\n  lc_serializable = true;\n\n  lc_namespace = [\"langchain\", \"chat_models\", \"xai\"];\n\n  /**\n   * Default search parameters for the Live Search API.\n   */\n  searchParameters?: XAISearchParameters;\n\n  constructor(model: string, fields?: Omit<ChatXAIInput, \"model\">);\n  constructor(fields?: Partial<ChatXAIInput>);\n  constructor(\n    modelOrFields?: string | Partial<ChatXAIInput>,\n    fieldsArg?: Omit<ChatXAIInput, \"model\">\n  ) {\n    const fields =\n      typeof modelOrFields === \"string\"\n        ? { ...(fieldsArg ?? {}), model: modelOrFields }\n        : (modelOrFields ?? {});\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 into \"apiKey\" field.`\n      );\n    }\n\n    super({\n      ...fields,\n      model: fields?.model || \"grok-3-fast\",\n      apiKey,\n      configuration: {\n        baseURL: fields?.baseURL ?? \"https://api.x.ai/v1\",\n      },\n    });\n\n    this._addVersion(\"@langchain/xai\", __PKG_VERSION__);\n\n    this.searchParameters = fields?.searchParameters;\n  }\n\n  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.openai_api_key;\n      delete result.kwargs.configuration;\n    }\n\n    return result;\n  }\n\n  getLsParams(options: this[\"ParsedCallOptions\"]): LangSmithParams {\n    const params = super.getLsParams(options);\n    params.ls_provider = \"xai\";\n    return params;\n  }\n\n  /**\n   * Get the effective search parameters, merging defaults with call options.\n   * @param options Call options that may contain search parameters\n   * @returns Merged search parameters or undefined if none are configured\n   */\n  protected _getEffectiveSearchParameters(\n    options?: this[\"ParsedCallOptions\"]\n  ): XAISearchParameters | undefined {\n    return mergeSearchParams(this.searchParameters, options?.searchParameters);\n  }\n\n  /**\n   * Check if any built-in tools (like live_search) are in the tools list.\n   * @param tools List of tools to check\n   * @returns true if any built-in tools are present\n   */\n  protected _hasBuiltInTools(tools?: ChatXAIToolType[]): boolean {\n    return tools?.some(isXAIBuiltInTool) ?? false;\n  }\n\n  /**\n   * Formats tools to xAI/OpenAI format, preserving provider-specific definitions.\n   *\n   * @param tools The tools to format\n   * @returns The formatted tools\n   */\n  formatStructuredToolToXAI(\n    tools: ChatXAIToolType[]\n  ): (OpenAIClient.ChatCompletionTool | XAIBuiltInTool)[] | undefined {\n    if (!tools || !tools.length) {\n      return undefined;\n    }\n    return tools.map((tool) => {\n      // 1. Check for provider definition first (from xaiLiveSearch factory)\n      if (isLangChainTool(tool) && tool.extras?.providerToolDefinition) {\n        return tool.extras.providerToolDefinition as XAIBuiltInTool;\n      }\n      // 2. Check for built-in tools (legacy { type: \"live_search\" })\n      if (isXAIBuiltInTool(tool)) {\n        return tool;\n      }\n      // 3. Convert standard tools to OpenAI format\n      return convertToOpenAITool(tool) as OpenAIClient.ChatCompletionTool;\n    });\n  }\n\n  override bindTools(\n    tools: ChatXAIToolType[],\n    kwargs?: Partial<ChatXAICallOptions>\n  ): Runnable<BaseLanguageModelInput, AIMessageChunk, ChatXAICallOptions> {\n    return this.withConfig({\n      tools: this.formatStructuredToolToXAI(tools),\n      ...kwargs,\n    } as Partial<ChatXAICallOptions>);\n  }\n\n  /** @internal */\n  override invocationParams(\n    options?: this[\"ParsedCallOptions\"],\n    extra?: { streaming?: boolean }\n  ): ChatXAICompletionsInvocationParams {\n    const baseParams = super.invocationParams(options, extra);\n\n    // Cast to xAI-specific params type\n    const params: ChatXAICompletionsInvocationParams = { ...baseParams };\n\n    // Check if live_search tool is being used\n    // We also need to extract params from the tool definition if present\n    const liveSearchTool = options?.tools?.find(isXAIBuiltInTool) as\n      | XAILiveSearchTool\n      | undefined;\n\n    const mergedSearchParams = mergeSearchParams(\n      this.searchParameters,\n      options?.searchParameters,\n      liveSearchTool\n    );\n\n    // Add search_parameters if needed\n    if (mergedSearchParams) {\n      params.search_parameters =\n        buildSearchParametersPayload(mergedSearchParams);\n    }\n\n    return params;\n  }\n\n  async completionWithRetry(\n    request: OpenAIClient.Chat.ChatCompletionCreateParamsStreaming,\n    options?: OpenAICoreRequestOptions\n  ): Promise<AsyncIterable<OpenAIClient.Chat.Completions.ChatCompletionChunk>>;\n\n  async completionWithRetry(\n    request: OpenAIClient.Chat.ChatCompletionCreateParamsNonStreaming,\n    options?: OpenAICoreRequestOptions\n  ): Promise<OpenAIClient.Chat.Completions.ChatCompletion>;\n\n  /**\n   * Calls the xAI API with retry logic in case of failures.\n   * @param request The request to send to the xAI API.\n   * @param options Optional configuration for the API call.\n   * @returns The response from the xAI API.\n   */\n  async completionWithRetry(\n    request:\n      | OpenAIClient.Chat.ChatCompletionCreateParamsStreaming\n      | OpenAIClient.Chat.ChatCompletionCreateParamsNonStreaming,\n    options?: OpenAICoreRequestOptions\n  ): Promise<\n    | AsyncIterable<OpenAIClient.Chat.Completions.ChatCompletionChunk>\n    | OpenAIClient.Chat.Completions.ChatCompletion\n  > {\n    delete request.frequency_penalty;\n    delete request.presence_penalty;\n    delete request.logit_bias;\n    delete request.functions;\n\n    const newRequestMessages = request.messages.map((msg) => {\n      if (!msg.content) {\n        return {\n          ...msg,\n          content: \"\",\n        };\n      }\n      return msg;\n    });\n\n    let filteredTools: OpenAIClient.ChatCompletionTool[] | undefined;\n    if (request.tools) {\n      filteredTools = filterXAIBuiltInTools({\n        tools: request.tools,\n        excludedTypes: [XAI_LIVE_SEARCH_TOOL_TYPE],\n      }) as OpenAIClient.ChatCompletionTool[] | undefined;\n    }\n\n    const newRequest = {\n      ...request,\n      messages: newRequestMessages,\n      tools: filteredTools,\n    };\n\n    if (newRequest.stream === true) {\n      return super.completionWithRetry(newRequest, options);\n    }\n\n    return super.completionWithRetry(newRequest, options);\n  }\n\n  protected override _convertCompletionsDeltaToBaseMessageChunk(\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    delta: Record<string, any>,\n    rawResponse: OpenAIClient.ChatCompletionChunk,\n    defaultRole?:\n      | \"function\"\n      | \"user\"\n      | \"system\"\n      | \"developer\"\n      | \"assistant\"\n      | \"tool\"\n  ): AIMessageChunk {\n    const messageChunk = super._convertCompletionsDeltaToBaseMessageChunk(\n      delta,\n      rawResponse,\n      defaultRole\n    ) as AIMessageChunk;\n\n    // Cast to xAI-specific types for proper typing\n    const responseMetadata =\n      messageChunk.response_metadata as XAIResponseMetadata;\n\n    // Make concatenating chunks work without merge warning\n    if (!rawResponse.choices[0]?.finish_reason) {\n      delete responseMetadata.usage;\n      delete messageChunk.usage_metadata;\n    } else {\n      messageChunk.usage_metadata = responseMetadata.usage;\n    }\n    return messageChunk;\n  }\n\n  /**\n   * Return profiling information for the model.\n   *\n   * Provides information about the model's capabilities and constraints,\n   * including token limits, multimodal support, and advanced features like\n   * tool calling and structured output.\n   *\n   * @returns {ModelProfile} An object describing the model's capabilities and constraints\n   *\n   * @example\n   * ```typescript\n   * const model = new ChatXAI({ model: \"grok-3-fast\" });\n   * const profile = model.profile;\n   * console.log(profile.maxInputTokens); // 128000\n   * console.log(profile.imageInputs); // true\n   * ```\n   */\n  get profile(): ModelProfile {\n    return PROFILES[this.model] ?? {};\n  }\n\n  protected override get streamEventProvider(): string {\n    return \"xai\";\n  }\n}\n"],"mappings":"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"}

package/dist/chat_models/responses.cjs

@@ -1,4 +1,5 @@
 const require_responses = require("../converters/responses.cjs");
+const require_responses_stream_events = require("../utils/responses_stream_events.cjs");
 let _langchain_core_utils_env = require("@langchain/core/utils/env");
 let _langchain_core_language_models_chat_models = require("@langchain/core/language_models/chat_models");
 //#region src/chat_models/responses.ts
@@ -55,7 +56,7 @@ var ChatXAIResponses = class extends _langchain_core_language_models_chat_models
 			model: modelOrFields
 		} : modelOrFields ?? {};
 		super(fields);
-		this._addVersion("@langchain/xai", "1.3.19");
+		this._addVersion("@langchain/xai", "1.4.0");
 		const apiKey = fields?.apiKey ?? (0, _langchain_core_utils_env.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;
@@ -205,6 +206,23 @@ var ChatXAIResponses = class extends _langchain_core_language_models_chat_models
 			}
 		};
 	}
+	async *_streamChatModelEvents(messages, options, _runManager) {
+		const invocationParams = this.invocationParams(options);
+		const input = require_responses.convertMessagesToResponsesInput(messages);
+		const streamIterable = await this._makeRequest({
+			input,
+			...invocationParams,
+			stream: true
+		});
+		const shouldStreamUsage = options.streamUsage ?? true;
+		const abortableStream = async function* (source, signal) {
+			for await (const event of source) {
+				if (signal?.aborted) return;
+				yield event;
+			}
+		};
+		yield* require_responses_stream_events.convertXAIResponsesStream(abortableStream(streamIterable, options.signal), { streamUsage: shouldStreamUsage });
+	}
 	async *_streamResponseChunks(messages, options, runManager) {
 		const invocationParams = this.invocationParams(options);
 		const input = require_responses.convertMessagesToResponsesInput(messages);

package/dist/chat_models/responses.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"responses.cjs","names":["BaseChatModel","convertMessagesToResponsesInput","convertResponseToAIMessage","extractTextFromOutput","convertStreamEventToChunk"],"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  XAIResponsesTool,\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  tools?: XAIResponsesTool[];\n\n  // -------------------------------------------------------------------------\n  // Constructor\n  // -------------------------------------------------------------------------\n\n  constructor(model: string, fields?: Omit<ChatXAIResponsesInput, \"model\">);\n  constructor(fields?: ChatXAIResponsesInput);\n  constructor(\n    modelOrFields?: string | ChatXAIResponsesInput,\n    fieldsArg?: Omit<ChatXAIResponsesInput, \"model\">\n  ) {\n    const fields =\n      typeof modelOrFields === \"string\"\n        ? { ...(fieldsArg ?? {}), model: modelOrFields }\n        : (modelOrFields ?? {});\n    super(fields);\n\n    this._addVersion(\"@langchain/xai\", __PKG_VERSION__);\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    this.tools = fields?.tools;\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      tools: options?.tools ?? this.tools,\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    options.signal?.throwIfAborted();\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      if (options.signal?.aborted) {\n        return;\n      }\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":";;;;;;;;;;;;;;;;;;;;;;;AA6DA,IAAa,mBAAb,cAEUA,4CAAAA,cAA2B;CACnC,OAAO,UAAU;AACf,SAAO;;CAGT,kBAAkB;CAElB,eAAe;EAAC;EAAa;EAAe;EAAM;CAElD,IAAI,aAAoD;AACtD,SAAO,EACL,QAAQ,eACT;;CAGH,IAAI,aAAoD;AACtD,SAAO,EACL,QAAQ,eACT;;CAOH;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAQA,YACE,eACA,WACA;EACA,MAAM,SACJ,OAAO,kBAAkB,WACrB;GAAE,GAAI,aAAa,EAAE;GAAG,OAAO;GAAe,GAC7C,iBAAiB,EAAE;AAC1B,QAAM,OAAO;AAEb,OAAK,YAAY,kBAAA,SAAkC;EAEnD,MAAM,SAAS,QAAQ,WAAA,GAAA,0BAAA,wBAAiC,cAAc;AACtE,MAAI,CAAC,OACH,OAAM,IAAI,MACR,mHACD;AAGH,OAAK,SAAS;AACd,OAAK,QAAQ,QAAQ,SAAS;AAC9B,OAAK,YAAY,QAAQ,aAAa;AACtC,OAAK,cAAc,QAAQ;AAC3B,OAAK,OAAO,QAAQ;AACpB,OAAK,kBAAkB,QAAQ;AAC/B,OAAK,QAAQ,QAAQ;AACrB,OAAK,OAAO,QAAQ;AACpB,OAAK,UAAU,QAAQ,WAAW;AAClC,OAAK,mBAAmB,QAAQ;AAChC,OAAK,YAAY,QAAQ;AACzB,OAAK,QAAQ,QAAQ;;CAOvB,WAAmB;AACjB,SAAO;;CAGT,YAAqB,SAAqD;EACxE,MAAM,SAAS,MAAM,YAAY,QAAQ;AACzC,SAAO,cAAc;AACrB,SAAO,gBAAgB,KAAK;AAC5B,SAAO,gBAAgB;AACvB,SAAO,iBAAiB,KAAK;AAC7B,SAAO,gBAAgB,KAAK;AAC5B,SAAO;;CAGT,SAA8B;EAC5B,MAAM,SAAS,MAAM,QAAQ;AAE7B,MACE,YAAY,UACZ,OAAO,OAAO,WAAW,YACzB,OAAO,UAAU,KAEjB,QAAQ,OAAO,OAAmC;AAGpD,SAAO;;CAOT,iBACE,SACkC;AAClC,SAAO;GACL,OAAO,KAAK;GACZ,aAAa,KAAK;GAClB,OAAO,KAAK;GACZ,mBAAmB,KAAK;GACxB,OAAO,KAAK;GACZ,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,sBAAsB,SAAS;GAC/B,SAAS,SAAS;GAClB,MAAM,SAAS;GACf,mBAAmB,SAAS,qBAAqB,KAAK;GACtD,WAAW,SAAS,aAAa,KAAK;GACtC,OAAO,SAAS,SAAS,KAAK;GAC9B,aAAa,SAAS;GACtB,qBAAqB,SAAS;GAC/B;;CAkBH,MAAgB,aACd,SAC+D;EAC/D,MAAM,MAAM,GAAG,KAAK,QAAQ;EAE5B,MAAM,UAAkC;GACtC,gBAAgB;GAChB,eAAe,UAAU,KAAK;GAC/B;AAED,MAAI,QAAQ,OACV,QAAO,KAAK,sBAAsB,KAAK,SAAS,QAAQ;AAoB1D,SAjBiB,MAAM,KAAK,OAAO,KAAK,YAAY;GAClD,MAAM,MAAM,MAAM,MAAM,KAAK;IAC3B,QAAQ;IACR;IACA,MAAM,KAAK,UAAU,QAAQ;IAC9B,CAAC;AAEF,OAAI,CAAC,IAAI,IAAI;IACX,MAAM,YAAY,MAAM,IAAI,MAAM;AAClC,UAAM,IAAI,MACR,kBAAkB,IAAI,OAAO,GAAG,IAAI,WAAW,KAAK,YACrD;;AAGH,UAAO,IAAI,MAAM;IACjB;;;;;CAQJ,OAAiB,sBACf,KACA,SACA,SACwC;EAkBxC,MAAM,UAjBW,MAAM,KAAK,OAAO,KAAK,YAAY;GAClD,MAAM,MAAM,MAAM,MAAM,KAAK;IAC3B,QAAQ;IACR;IACA,MAAM,KAAK,UAAU,QAAQ;IAC9B,CAAC;AAEF,OAAI,CAAC,IAAI,IAAI;IACX,MAAM,YAAY,MAAM,IAAI,MAAM;AAClC,UAAM,IAAI,MACR,kBAAkB,IAAI,OAAO,GAAG,IAAI,WAAW,KAAK,YACrD;;AAGH,UAAO;IACP,EAEsB,MAAM,WAAW;AACzC,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,mBAAmB;EAGrC,MAAM,UAAU,IAAI,aAAa;EACjC,IAAI,SAAS;AAEb,MAAI;AACF,UAAO,MAAM;IACX,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,MAAM;AAC3C,QAAI,KAAM;AAEV,cAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,MAAM,CAAC;IACjD,MAAM,QAAQ,OAAO,MAAM,KAAK;AAChC,aAAS,MAAM,KAAK,IAAI;AAExB,SAAK,MAAM,QAAQ,OAAO;KACxB,MAAM,UAAU,KAAK,MAAM;AAC3B,SAAI,CAAC,WAAW,YAAY,eAAgB;AAE5C,SAAI,QAAQ,WAAW,SAAS,CAC9B,KAAI;AAEF,YADa,KAAK,MAAM,QAAQ,MAAM,EAAE,CAAC;aAEnC;;;YAMN;AACR,UAAO,aAAa;;;CAQxB,MAAM,UACJ,UACA,SACA,YACqB;AACrB,UAAQ,QAAQ,gBAAgB;EAChC,MAAM,mBAAmB,KAAK,iBAAiB,QAAQ;EACvD,MAAM,QAAQC,kBAAAA,gCAAgC,SAAS;AAEvD,MAAI,iBAAiB,QAAQ;GAC3B,MAAM,SAAS,KAAK,sBAAsB,UAAU,SAAS,WAAW;GACxE,IAAI;AAEJ,cAAW,MAAM,SAAS,QAAQ;AAChC,UAAM,QAAQ,oBAAoB;KAChC,GAAG,MAAM;KACT,GAAG,MAAM,QAAQ;KAClB;AACD,iBAAa,YAAY,OAAO,MAAM,IAAI;;AAG5C,UAAO;IACL,aAAa,aAAa,CAAC,WAAW,GAAG,EAAE;IAC3C,WAAW,EACT,sBAAsB,YAAY,UAC9B,gBACL;IACF;;EAGH,MAAM,WAAW,MAAM,KAAK,aAAa;GACvC;GACA,GAAG;GACH,QAAQ;GACT,CAAyC;EAE1C,MAAM,YAAYC,kBAAAA,2BAA2B,SAAS;AAGtD,SAAO;GACL,aAAa,CACX;IACE,MALOC,kBAAAA,sBAAsB,SAAS,OAAO;IAM7C,SAAS;IACV,CACF;GACD,WAAW;IACT,IAAI,SAAS;IACb,qBAAqB,SAAS,QAC1B;KACE,cAAc,SAAS,MAAM;KAC7B,kBAAkB,SAAS,MAAM;KACjC,aAAa,SAAS,MAAM;KAC7B,GACD,KAAA;IACL;GACF;;CAGH,OAAO,sBACL,UACA,SACA,YACqC;EACrC,MAAM,mBAAmB,KAAK,iBAAiB,QAAQ;EACvD,MAAM,QAAQF,kBAAAA,gCAAgC,SAAS;EAEvD,MAAM,iBAAiB,MAAM,KAAK,aAAa;GAC7C;GACA,GAAG;GACH,QAAQ;GACT,CAAsC;AAEvC,aAAW,MAAM,SAAS,gBAAgB;AACxC,OAAI,QAAQ,QAAQ,QAClB;GAEF,MAAM,QAAQG,kBAAAA,0BAA0B,MAAM;AAC9C,OAAI,OAAO;AACT,UAAM;AACN,UAAM,YAAY,kBAAkB,MAAM,QAAQ,IAAI;KACpD,QAAQ;KACR,YAAY;KACb,CAAC"}
+{"version":3,"file":"responses.cjs","names":["BaseChatModel","convertMessagesToResponsesInput","convertResponseToAIMessage","extractTextFromOutput","convertXAIResponsesStream","convertStreamEventToChunk"],"sources":["../../src/chat_models/responses.ts"],"sourcesContent":["import { CallbackManagerForLLMRun } from \"@langchain/core/callbacks/manager\";\nimport type { ChatModelStreamEvent } from \"@langchain/core/language_models/event\";\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  XAIResponsesTool,\n} from \"./responses-types.js\";\n\nimport {\n  convertMessagesToResponsesInput,\n  convertResponseToAIMessage,\n  convertStreamEventToChunk,\n  extractTextFromOutput,\n} from \"../converters/responses.js\";\nimport { convertXAIResponsesStream } from \"../utils/responses_stream_events.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  tools?: XAIResponsesTool[];\n\n  // -------------------------------------------------------------------------\n  // Constructor\n  // -------------------------------------------------------------------------\n\n  constructor(model: string, fields?: Omit<ChatXAIResponsesInput, \"model\">);\n  constructor(fields?: ChatXAIResponsesInput);\n  constructor(\n    modelOrFields?: string | ChatXAIResponsesInput,\n    fieldsArg?: Omit<ChatXAIResponsesInput, \"model\">\n  ) {\n    const fields =\n      typeof modelOrFields === \"string\"\n        ? { ...(fieldsArg ?? {}), model: modelOrFields }\n        : (modelOrFields ?? {});\n    super(fields);\n\n    this._addVersion(\"@langchain/xai\", __PKG_VERSION__);\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    this.tools = fields?.tools;\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      tools: options?.tools ?? this.tools,\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    options.signal?.throwIfAborted();\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 *_streamChatModelEvents(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    _runManager?: CallbackManagerForLLMRun\n  ): AsyncGenerator<ChatModelStreamEvent> {\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    const shouldStreamUsage = options.streamUsage ?? true;\n\n    const abortableStream = async function* (\n      source: AsyncIterable<XAIResponsesStreamEvent>,\n      signal?: AbortSignal\n    ) {\n      for await (const event of source) {\n        if (signal?.aborted) {\n          return;\n        }\n        yield event;\n      }\n    };\n\n    yield* convertXAIResponsesStream(\n      abortableStream(streamIterable, options.signal),\n      { streamUsage: shouldStreamUsage }\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      if (options.signal?.aborted) {\n        return;\n      }\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":";;;;;;;;;;;;;;;;;;;;;;;;AA+DA,IAAa,mBAAb,cAEUA,4CAAAA,cAA2B;CACnC,OAAO,UAAU;AACf,SAAO;;CAGT,kBAAkB;CAElB,eAAe;EAAC;EAAa;EAAe;EAAM;CAElD,IAAI,aAAoD;AACtD,SAAO,EACL,QAAQ,eACT;;CAGH,IAAI,aAAoD;AACtD,SAAO,EACL,QAAQ,eACT;;CAOH;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA;CAQA,YACE,eACA,WACA;EACA,MAAM,SACJ,OAAO,kBAAkB,WACrB;GAAE,GAAI,aAAa,EAAE;GAAG,OAAO;GAAe,GAC7C,iBAAiB,EAAE;AAC1B,QAAM,OAAO;AAEb,OAAK,YAAY,kBAAA,QAAkC;EAEnD,MAAM,SAAS,QAAQ,WAAA,GAAA,0BAAA,wBAAiC,cAAc;AACtE,MAAI,CAAC,OACH,OAAM,IAAI,MACR,mHACD;AAGH,OAAK,SAAS;AACd,OAAK,QAAQ,QAAQ,SAAS;AAC9B,OAAK,YAAY,QAAQ,aAAa;AACtC,OAAK,cAAc,QAAQ;AAC3B,OAAK,OAAO,QAAQ;AACpB,OAAK,kBAAkB,QAAQ;AAC/B,OAAK,QAAQ,QAAQ;AACrB,OAAK,OAAO,QAAQ;AACpB,OAAK,UAAU,QAAQ,WAAW;AAClC,OAAK,mBAAmB,QAAQ;AAChC,OAAK,YAAY,QAAQ;AACzB,OAAK,QAAQ,QAAQ;;CAOvB,WAAmB;AACjB,SAAO;;CAGT,YAAqB,SAAqD;EACxE,MAAM,SAAS,MAAM,YAAY,QAAQ;AACzC,SAAO,cAAc;AACrB,SAAO,gBAAgB,KAAK;AAC5B,SAAO,gBAAgB;AACvB,SAAO,iBAAiB,KAAK;AAC7B,SAAO,gBAAgB,KAAK;AAC5B,SAAO;;CAGT,SAA8B;EAC5B,MAAM,SAAS,MAAM,QAAQ;AAE7B,MACE,YAAY,UACZ,OAAO,OAAO,WAAW,YACzB,OAAO,UAAU,KAEjB,QAAQ,OAAO,OAAmC;AAGpD,SAAO;;CAOT,iBACE,SACkC;AAClC,SAAO;GACL,OAAO,KAAK;GACZ,aAAa,KAAK;GAClB,OAAO,KAAK;GACZ,mBAAmB,KAAK;GACxB,OAAO,KAAK;GACZ,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,sBAAsB,SAAS;GAC/B,SAAS,SAAS;GAClB,MAAM,SAAS;GACf,mBAAmB,SAAS,qBAAqB,KAAK;GACtD,WAAW,SAAS,aAAa,KAAK;GACtC,OAAO,SAAS,SAAS,KAAK;GAC9B,aAAa,SAAS;GACtB,qBAAqB,SAAS;GAC/B;;CAkBH,MAAgB,aACd,SAC+D;EAC/D,MAAM,MAAM,GAAG,KAAK,QAAQ;EAE5B,MAAM,UAAkC;GACtC,gBAAgB;GAChB,eAAe,UAAU,KAAK;GAC/B;AAED,MAAI,QAAQ,OACV,QAAO,KAAK,sBAAsB,KAAK,SAAS,QAAQ;AAoB1D,SAAO,MAjBgB,KAAK,OAAO,KAAK,YAAY;GAClD,MAAM,MAAM,MAAM,MAAM,KAAK;IAC3B,QAAQ;IACR;IACA,MAAM,KAAK,UAAU,QAAQ;IAC9B,CAAC;AAEF,OAAI,CAAC,IAAI,IAAI;IACX,MAAM,YAAY,MAAM,IAAI,MAAM;AAClC,UAAM,IAAI,MACR,kBAAkB,IAAI,OAAO,GAAG,IAAI,WAAW,KAAK,YACrD;;AAGH,UAAO,IAAI,MAAM;IACjB;;;;;CAQJ,OAAiB,sBACf,KACA,SACA,SACwC;EAkBxC,MAAM,UAAS,MAjBQ,KAAK,OAAO,KAAK,YAAY;GAClD,MAAM,MAAM,MAAM,MAAM,KAAK;IAC3B,QAAQ;IACR;IACA,MAAM,KAAK,UAAU,QAAQ;IAC9B,CAAC;AAEF,OAAI,CAAC,IAAI,IAAI;IACX,MAAM,YAAY,MAAM,IAAI,MAAM;AAClC,UAAM,IAAI,MACR,kBAAkB,IAAI,OAAO,GAAG,IAAI,WAAW,KAAK,YACrD;;AAGH,UAAO;IACP,EAEsB,MAAM,WAAW;AACzC,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,mBAAmB;EAGrC,MAAM,UAAU,IAAI,aAAa;EACjC,IAAI,SAAS;AAEb,MAAI;AACF,UAAO,MAAM;IACX,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,MAAM;AAC3C,QAAI,KAAM;AAEV,cAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,MAAM,CAAC;IACjD,MAAM,QAAQ,OAAO,MAAM,KAAK;AAChC,aAAS,MAAM,KAAK,IAAI;AAExB,SAAK,MAAM,QAAQ,OAAO;KACxB,MAAM,UAAU,KAAK,MAAM;AAC3B,SAAI,CAAC,WAAW,YAAY,eAAgB;AAE5C,SAAI,QAAQ,WAAW,SAAS,CAC9B,KAAI;AAEF,YADa,KAAK,MAAM,QAAQ,MAAM,EAAE,CAC9B;aACJ;;;YAMN;AACR,UAAO,aAAa;;;CAQxB,MAAM,UACJ,UACA,SACA,YACqB;AACrB,UAAQ,QAAQ,gBAAgB;EAChC,MAAM,mBAAmB,KAAK,iBAAiB,QAAQ;EACvD,MAAM,QAAQC,kBAAAA,gCAAgC,SAAS;AAEvD,MAAI,iBAAiB,QAAQ;GAC3B,MAAM,SAAS,KAAK,sBAAsB,UAAU,SAAS,WAAW;GACxE,IAAI;AAEJ,cAAW,MAAM,SAAS,QAAQ;AAChC,UAAM,QAAQ,oBAAoB;KAChC,GAAG,MAAM;KACT,GAAG,MAAM,QAAQ;KAClB;AACD,iBAAa,YAAY,OAAO,MAAM,IAAI;;AAG5C,UAAO;IACL,aAAa,aAAa,CAAC,WAAW,GAAG,EAAE;IAC3C,WAAW,EACT,sBAAsB,YAAY,UAC9B,gBACL;IACF;;EAGH,MAAM,WAAW,MAAM,KAAK,aAAa;GACvC;GACA,GAAG;GACH,QAAQ;GACT,CAAyC;EAE1C,MAAM,YAAYC,kBAAAA,2BAA2B,SAAS;AAGtD,SAAO;GACL,aAAa,CACX;IACE,MALOC,kBAAAA,sBAAsB,SAAS,OAKlC;IACJ,SAAS;IACV,CACF;GACD,WAAW;IACT,IAAI,SAAS;IACb,qBAAqB,SAAS,QAC1B;KACE,cAAc,SAAS,MAAM;KAC7B,kBAAkB,SAAS,MAAM;KACjC,aAAa,SAAS,MAAM;KAC7B,GACD,KAAA;IACL;GACF;;CAGH,OAAO,uBACL,UACA,SACA,aACsC;EACtC,MAAM,mBAAmB,KAAK,iBAAiB,QAAQ;EACvD,MAAM,QAAQF,kBAAAA,gCAAgC,SAAS;EAEvD,MAAM,iBAAiB,MAAM,KAAK,aAAa;GAC7C;GACA,GAAG;GACH,QAAQ;GACT,CAAsC;EAEvC,MAAM,oBAAoB,QAAQ,eAAe;EAEjD,MAAM,kBAAkB,iBACtB,QACA,QACA;AACA,cAAW,MAAM,SAAS,QAAQ;AAChC,QAAI,QAAQ,QACV;AAEF,UAAM;;;AAIV,SAAOG,gCAAAA,0BACL,gBAAgB,gBAAgB,QAAQ,OAAO,EAC/C,EAAE,aAAa,mBAAmB,CACnC;;CAGH,OAAO,sBACL,UACA,SACA,YACqC;EACrC,MAAM,mBAAmB,KAAK,iBAAiB,QAAQ;EACvD,MAAM,QAAQH,kBAAAA,gCAAgC,SAAS;EAEvD,MAAM,iBAAiB,MAAM,KAAK,aAAa;GAC7C;GACA,GAAG;GACH,QAAQ;GACT,CAAsC;AAEvC,aAAW,MAAM,SAAS,gBAAgB;AACxC,OAAI,QAAQ,QAAQ,QAClB;GAEF,MAAM,QAAQI,kBAAAA,0BAA0B,MAAM;AAC9C,OAAI,OAAO;AACT,UAAM;AACN,UAAM,YAAY,kBAAkB,MAAM,QAAQ,IAAI;KACpD,QAAQ;KACR,YAAY;KACb,CAAC"}

package/dist/chat_models/responses.d.cts

@@ -3,6 +3,7 @@ import { BaseChatModel, LangSmithParams } from "@langchain/core/language_models/
 import { Serialized } from "@langchain/core/load/serializable";
 import { BaseMessage } from "@langchain/core/messages";
 import { CallbackManagerForLLMRun } from "@langchain/core/callbacks/manager";
+import { ChatModelStreamEvent } from "@langchain/core/language_models/event";
 import { ChatGenerationChunk, ChatResult } from "@langchain/core/outputs";
 
 //#region src/chat_models/responses.d.ts
@@ -63,6 +64,7 @@ declare class ChatXAIResponses<CallOptions extends ChatXAIResponsesCallOptions =
    */
   protected _makeStreamingRequest(url: string, headers: Record<string, string>, request: XAIResponsesCreateParams): AsyncIterable<XAIResponsesStreamEvent>;
   _generate(messages: BaseMessage[], options: this["ParsedCallOptions"], runManager?: CallbackManagerForLLMRun): Promise<ChatResult>;
+  _streamChatModelEvents(messages: BaseMessage[], options: this["ParsedCallOptions"], _runManager?: CallbackManagerForLLMRun): AsyncGenerator<ChatModelStreamEvent>;
   _streamResponseChunks(messages: BaseMessage[], options: this["ParsedCallOptions"], runManager?: CallbackManagerForLLMRun): AsyncGenerator<ChatGenerationChunk>;
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"responses.d.cts","names":[],"sources":["../../src/chat_models/responses.ts"],"mappings":";;;;;;;;;AA6DA;;;;;;;;;;;;;;;;;;cAAa,gBAAA,qBACS,2BAAA,GAA8B,2BAAA,UAC1C,aAAA,CAAc,WAAA;EAAA,OACf,OAAA,CAAA;EAIP,eAAA;EAEA,YAAA;EAAA,IAEI,UAAA,CAAA;IAAA,CAAiB,GAAA;EAAA;EAAA,IAMjB,UAAA,CAAA;IAAA,CAAiB,GAAA;EAAA;EAUrB,MAAA;EAEA,KAAA;EAEA,SAAA;EAEA,WAAA;EAEA,IAAA;EAEA,eAAA;EAEA,KAAA;EAEA,IAAA;EAEA,OAAA;EAEA,gBAAA,GAAmB,4BAAA;EAEnB,SAAA,GAAY,qBAAA;EAEZ,KAAA,GAAQ,gBAAA;EAMR,WAAA,CAAY,KAAA,UAAe,MAAA,GAAS,IAAA,CAAK,qBAAA;EACzC,WAAA,CAAY,MAAA,GAAS,qBAAA;EAsCrB,QAAA,CAAA;EAIS,WAAA,CAAY,OAAA,8BAAqC,eAAA;EAUjD,MAAA,CAAA,GAAU,UAAA;EAkBnB,gBAAA,CACE,OAAA,+BACC,gCAAA;EArHkB;;;EAAA,UAgJL,YAAA,CACd,OAAA,EAAS,oCAAA,GACR,OAAA,CAAQ,WAAA;EAAA,UAEK,YAAA,CACd,OAAA,EAAS,iCAAA,GACR,OAAA,CAAQ,aAAA,CAAc,uBAAA;EAlIzB;;;EAAA,UAyKiB,qBAAA,CACf,GAAA,UACA,OAAA,EAAS,MAAA,kBACT,OAAA,EAAS,wBAAA,GACR,aAAA,CAAc,uBAAA;EA0DX,SAAA,CACJ,QAAA,EAAU,WAAA,IACV,OAAA,6BACA,UAAA,GAAa,wBAAA,GACZ,OAAA,CAAQ,UAAA;EAuDJ,qBAAA,CACL,QAAA,EAAU,WAAA,IACV,OAAA,6BACA,UAAA,GAAa,wBAAA,GACZ,cAAA,CAAe,mBAAA;AAAA"}
+{"version":3,"file":"responses.d.cts","names":[],"sources":["../../src/chat_models/responses.ts"],"mappings":";;;;;;;;;;AA+DA;;;;;;;;;;;;;;;;;;cAAa,gBAAA,qBACS,2BAAA,GAA8B,2BAAA,UAC1C,aAAA,CAAc,WAAA;EAAA,OACf,OAAA,CAAA;EAIP,eAAA;EAEA,YAAA;EAAA,IAEI,UAAA,CAAA;IAAA,CAAiB,GAAA;EAAA;EAAA,IAMjB,UAAA,CAAA;IAAA,CAAiB,GAAA;EAAA;EAUrB,MAAA;EAEA,KAAA;EAEA,SAAA;EAEA,WAAA;EAEA,IAAA;EAEA,eAAA;EAEA,KAAA;EAEA,IAAA;EAEA,OAAA;EAEA,gBAAA,GAAmB,4BAAA;EAEnB,SAAA,GAAY,qBAAA;EAEZ,KAAA,GAAQ,gBAAA;EAMR,WAAA,CAAY,KAAA,UAAe,MAAA,GAAS,IAAA,CAAK,qBAAA;EACzC,WAAA,CAAY,MAAA,GAAS,qBAAA;EAsCrB,QAAA,CAAA;EAIS,WAAA,CAAY,OAAA,8BAAqC,eAAA;EAUjD,MAAA,CAAA,GAAU,UAAA;EAkBnB,gBAAA,CACE,OAAA,+BACC,gCAAA;EA7HI;;;EAAA,UAwJS,YAAA,CACd,OAAA,EAAS,oCAAA,GACR,OAAA,CAAQ,WAAA;EAAA,UAEK,YAAA,CACd,OAAA,EAAS,iCAAA,GACR,OAAA,CAAQ,aAAA,CAAc,uBAAA;EAhJrB;;;EAAA,UAuLa,qBAAA,CACf,GAAA,UACA,OAAA,EAAS,MAAA,kBACT,OAAA,EAAS,wBAAA,GACR,aAAA,CAAc,uBAAA;EA0DX,SAAA,CACJ,QAAA,EAAU,WAAA,IACV,OAAA,6BACA,UAAA,GAAa,wBAAA,GACZ,OAAA,CAAQ,UAAA;EAuDJ,sBAAA,CACL,QAAA,EAAU,WAAA,IACV,OAAA,6BACA,WAAA,GAAc,wBAAA,GACb,cAAA,CAAe,oBAAA;EA8BX,qBAAA,CACL,QAAA,EAAU,WAAA,IACV,OAAA,6BACA,UAAA,GAAa,wBAAA,GACZ,cAAA,CAAe,mBAAA;AAAA"}

package/dist/chat_models/responses.d.ts

@@ -4,6 +4,7 @@ import { BaseMessage } from "@langchain/core/messages";
 import { ChatGenerationChunk, ChatResult } from "@langchain/core/outputs";
 import { Serialized } from "@langchain/core/load/serializable";
 import { CallbackManagerForLLMRun } from "@langchain/core/callbacks/manager";
+import { ChatModelStreamEvent } from "@langchain/core/language_models/event";
 
 //#region src/chat_models/responses.d.ts
 /**
@@ -63,6 +64,7 @@ declare class ChatXAIResponses<CallOptions extends ChatXAIResponsesCallOptions =
    */
   protected _makeStreamingRequest(url: string, headers: Record<string, string>, request: XAIResponsesCreateParams): AsyncIterable<XAIResponsesStreamEvent>;
   _generate(messages: BaseMessage[], options: this["ParsedCallOptions"], runManager?: CallbackManagerForLLMRun): Promise<ChatResult>;
+  _streamChatModelEvents(messages: BaseMessage[], options: this["ParsedCallOptions"], _runManager?: CallbackManagerForLLMRun): AsyncGenerator<ChatModelStreamEvent>;
   _streamResponseChunks(messages: BaseMessage[], options: this["ParsedCallOptions"], runManager?: CallbackManagerForLLMRun): AsyncGenerator<ChatGenerationChunk>;
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"responses.d.ts","names":[],"sources":["../../src/chat_models/responses.ts"],"mappings":";;;;;;;;;AA6DA;;;;;;;;;;;;;;;;;;cAAa,gBAAA,qBACS,2BAAA,GAA8B,2BAAA,UAC1C,aAAA,CAAc,WAAA;EAAA,OACf,OAAA,CAAA;EAIP,eAAA;EAEA,YAAA;EAAA,IAEI,UAAA,CAAA;IAAA,CAAiB,GAAA;EAAA;EAAA,IAMjB,UAAA,CAAA;IAAA,CAAiB,GAAA;EAAA;EAUrB,MAAA;EAEA,KAAA;EAEA,SAAA;EAEA,WAAA;EAEA,IAAA;EAEA,eAAA;EAEA,KAAA;EAEA,IAAA;EAEA,OAAA;EAEA,gBAAA,GAAmB,4BAAA;EAEnB,SAAA,GAAY,qBAAA;EAEZ,KAAA,GAAQ,gBAAA;EAMR,WAAA,CAAY,KAAA,UAAe,MAAA,GAAS,IAAA,CAAK,qBAAA;EACzC,WAAA,CAAY,MAAA,GAAS,qBAAA;EAsCrB,QAAA,CAAA;EAIS,WAAA,CAAY,OAAA,8BAAqC,eAAA;EAUjD,MAAA,CAAA,GAAU,UAAA;EAkBnB,gBAAA,CACE,OAAA,+BACC,gCAAA;EArHkB;;;EAAA,UAgJL,YAAA,CACd,OAAA,EAAS,oCAAA,GACR,OAAA,CAAQ,WAAA;EAAA,UAEK,YAAA,CACd,OAAA,EAAS,iCAAA,GACR,OAAA,CAAQ,aAAA,CAAc,uBAAA;EAlIzB;;;EAAA,UAyKiB,qBAAA,CACf,GAAA,UACA,OAAA,EAAS,MAAA,kBACT,OAAA,EAAS,wBAAA,GACR,aAAA,CAAc,uBAAA;EA0DX,SAAA,CACJ,QAAA,EAAU,WAAA,IACV,OAAA,6BACA,UAAA,GAAa,wBAAA,GACZ,OAAA,CAAQ,UAAA;EAuDJ,qBAAA,CACL,QAAA,EAAU,WAAA,IACV,OAAA,6BACA,UAAA,GAAa,wBAAA,GACZ,cAAA,CAAe,mBAAA;AAAA"}
+{"version":3,"file":"responses.d.ts","names":[],"sources":["../../src/chat_models/responses.ts"],"mappings":";;;;;;;;;;AA+DA;;;;;;;;;;;;;;;;;;cAAa,gBAAA,qBACS,2BAAA,GAA8B,2BAAA,UAC1C,aAAA,CAAc,WAAA;EAAA,OACf,OAAA,CAAA;EAIP,eAAA;EAEA,YAAA;EAAA,IAEI,UAAA,CAAA;IAAA,CAAiB,GAAA;EAAA;EAAA,IAMjB,UAAA,CAAA;IAAA,CAAiB,GAAA;EAAA;EAUrB,MAAA;EAEA,KAAA;EAEA,SAAA;EAEA,WAAA;EAEA,IAAA;EAEA,eAAA;EAEA,KAAA;EAEA,IAAA;EAEA,OAAA;EAEA,gBAAA,GAAmB,4BAAA;EAEnB,SAAA,GAAY,qBAAA;EAEZ,KAAA,GAAQ,gBAAA;EAMR,WAAA,CAAY,KAAA,UAAe,MAAA,GAAS,IAAA,CAAK,qBAAA;EACzC,WAAA,CAAY,MAAA,GAAS,qBAAA;EAsCrB,QAAA,CAAA;EAIS,WAAA,CAAY,OAAA,8BAAqC,eAAA;EAUjD,MAAA,CAAA,GAAU,UAAA;EAkBnB,gBAAA,CACE,OAAA,+BACC,gCAAA;EA7HI;;;EAAA,UAwJS,YAAA,CACd,OAAA,EAAS,oCAAA,GACR,OAAA,CAAQ,WAAA;EAAA,UAEK,YAAA,CACd,OAAA,EAAS,iCAAA,GACR,OAAA,CAAQ,aAAA,CAAc,uBAAA;EAhJrB;;;EAAA,UAuLa,qBAAA,CACf,GAAA,UACA,OAAA,EAAS,MAAA,kBACT,OAAA,EAAS,wBAAA,GACR,aAAA,CAAc,uBAAA;EA0DX,SAAA,CACJ,QAAA,EAAU,WAAA,IACV,OAAA,6BACA,UAAA,GAAa,wBAAA,GACZ,OAAA,CAAQ,UAAA;EAuDJ,sBAAA,CACL,QAAA,EAAU,WAAA,IACV,OAAA,6BACA,WAAA,GAAc,wBAAA,GACb,cAAA,CAAe,oBAAA;EA8BX,qBAAA,CACL,QAAA,EAAU,WAAA,IACV,OAAA,6BACA,UAAA,GAAa,wBAAA,GACZ,cAAA,CAAe,mBAAA;AAAA"}

package/dist/chat_models/responses.js

@@ -1,4 +1,5 @@
 import { convertMessagesToResponsesInput, convertResponseToAIMessage, convertStreamEventToChunk, extractTextFromOutput } from "../converters/responses.js";
+import { convertXAIResponsesStream } from "../utils/responses_stream_events.js";
 import { getEnvironmentVariable } from "@langchain/core/utils/env";
 import { BaseChatModel } from "@langchain/core/language_models/chat_models";
 //#region src/chat_models/responses.ts
@@ -55,7 +56,7 @@ var ChatXAIResponses = class extends BaseChatModel {
 			model: modelOrFields
 		} : modelOrFields ?? {};
 		super(fields);
-		this._addVersion("@langchain/xai", "1.3.19");
+		this._addVersion("@langchain/xai", "1.4.0");
 		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;
@@ -205,6 +206,23 @@ var ChatXAIResponses = class extends BaseChatModel {
 			}
 		};
 	}
+	async *_streamChatModelEvents(messages, options, _runManager) {
+		const invocationParams = this.invocationParams(options);
+		const input = convertMessagesToResponsesInput(messages);
+		const streamIterable = await this._makeRequest({
+			input,
+			...invocationParams,
+			stream: true
+		});
+		const shouldStreamUsage = options.streamUsage ?? true;
+		const abortableStream = async function* (source, signal) {
+			for await (const event of source) {
+				if (signal?.aborted) return;
+				yield event;
+			}
+		};
+		yield* convertXAIResponsesStream(abortableStream(streamIterable, options.signal), { streamUsage: shouldStreamUsage });
+	}
 	async *_streamResponseChunks(messages, options, runManager) {
 		const invocationParams = this.invocationParams(options);
 		const input = convertMessagesToResponsesInput(messages);

package/dist/chat_models/responses.js.map

@@ -1 +1 @@
-{"version":3,"file":"responses.js","names":[],"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  XAIResponsesTool,\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  tools?: XAIResponsesTool[];\n\n  // -------------------------------------------------------------------------\n  // Constructor\n  // -------------------------------------------------------------------------\n\n  constructor(model: string, fields?: Omit<ChatXAIResponsesInput, \"model\">);\n  constructor(fields?: ChatXAIResponsesInput);\n  constructor(\n    modelOrFields?: string | ChatXAIResponsesInput,\n    fieldsArg?: Omit<ChatXAIResponsesInput, \"model\">\n  ) {\n    const fields =\n      typeof modelOrFields === \"string\"\n        ? { ...(fieldsArg ?? {}), model: modelOrFields }\n        : (modelOrFields ?? {});\n    super(fields);\n\n    this._addVersion(\"@langchain/xai\", __PKG_VERSION__);\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    this.tools = fields?.tools;\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      tools: options?.tools ?? this.tools,\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    options.signal?.throwIfAborted();\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      if (options.signal?.aborted) {\n        return;\n      }\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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"}
+{"version":3,"file":"responses.js","names":[],"sources":["../../src/chat_models/responses.ts"],"sourcesContent":["import { CallbackManagerForLLMRun } from \"@langchain/core/callbacks/manager\";\nimport type { ChatModelStreamEvent } from \"@langchain/core/language_models/event\";\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  XAIResponsesTool,\n} from \"./responses-types.js\";\n\nimport {\n  convertMessagesToResponsesInput,\n  convertResponseToAIMessage,\n  convertStreamEventToChunk,\n  extractTextFromOutput,\n} from \"../converters/responses.js\";\nimport { convertXAIResponsesStream } from \"../utils/responses_stream_events.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  tools?: XAIResponsesTool[];\n\n  // -------------------------------------------------------------------------\n  // Constructor\n  // -------------------------------------------------------------------------\n\n  constructor(model: string, fields?: Omit<ChatXAIResponsesInput, \"model\">);\n  constructor(fields?: ChatXAIResponsesInput);\n  constructor(\n    modelOrFields?: string | ChatXAIResponsesInput,\n    fieldsArg?: Omit<ChatXAIResponsesInput, \"model\">\n  ) {\n    const fields =\n      typeof modelOrFields === \"string\"\n        ? { ...(fieldsArg ?? {}), model: modelOrFields }\n        : (modelOrFields ?? {});\n    super(fields);\n\n    this._addVersion(\"@langchain/xai\", __PKG_VERSION__);\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    this.tools = fields?.tools;\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      tools: options?.tools ?? this.tools,\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    options.signal?.throwIfAborted();\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 *_streamChatModelEvents(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    _runManager?: CallbackManagerForLLMRun\n  ): AsyncGenerator<ChatModelStreamEvent> {\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    const shouldStreamUsage = options.streamUsage ?? true;\n\n    const abortableStream = async function* (\n      source: AsyncIterable<XAIResponsesStreamEvent>,\n      signal?: AbortSignal\n    ) {\n      for await (const event of source) {\n        if (signal?.aborted) {\n          return;\n        }\n        yield event;\n      }\n    };\n\n    yield* convertXAIResponsesStream(\n      abortableStream(streamIterable, options.signal),\n      { streamUsage: shouldStreamUsage }\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      if (options.signal?.aborted) {\n        return;\n      }\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/tools/index.cjs

@@ -5,6 +5,7 @@ const require_code_execution = require("./code_execution.cjs");
 const require_collections_search = require("./collections_search.cjs");
 //#region src/tools/index.ts
 const tools = {
+	/** @deprecated Use xaiWebSearch and xaiXSearch instead */
 	xaiLiveSearch: require_live_search.xaiLiveSearch,
 	xaiWebSearch: require_web_search.xaiWebSearch,
 	xaiXSearch: require_x_search.xaiXSearch,

package/dist/tools/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/tools/index.ts"],"sourcesContent":["import { xaiLiveSearch } from \"./live_search.js\";\nimport { xaiWebSearch } from \"./web_search.js\";\nimport { xaiXSearch } from \"./x_search.js\";\nimport { xaiCodeExecution } from \"./code_execution.js\";\nimport { xaiCollectionsSearch } from \"./collections_search.js\";\n\nexport const tools = {\n  /** @deprecated Use xaiWebSearch and xaiXSearch instead */\n  xaiLiveSearch,\n  xaiWebSearch,\n  xaiXSearch,\n  xaiCodeExecution,\n  xaiCollectionsSearch,\n};\n\n// Re-export types for convenience\nexport type {\n  XAILiveSearchTool,\n  XAILiveSearchToolOptions,\n} from \"./live_search.js\";\nexport type {\n  XAIWebSearchTool,\n  XAIWebSearchToolOptions,\n} from \"./web_search.js\";\nexport type { XAIXSearchTool, XAIXSearchToolOptions } from \"./x_search.js\";\nexport type { XAICodeExecutionTool } from \"./code_execution.js\";\nexport type {\n  XAICollectionsSearchTool,\n  XAICollectionsSearchToolOptions,\n} from \"./collections_search.js\";\n\n// Re-export tool type constants\nexport {\n  XAI_LIVE_SEARCH_TOOL_TYPE,\n  XAI_LIVE_SEARCH_TOOL_NAME,\n} from \"./live_search.js\";\nexport { XAI_WEB_SEARCH_TOOL_TYPE } from \"./web_search.js\";\nexport { XAI_X_SEARCH_TOOL_TYPE } from \"./x_search.js\";\nexport { XAI_CODE_EXECUTION_TOOL_TYPE } from \"./code_execution.js\";\nexport { XAI_COLLECTIONS_SEARCH_TOOL_TYPE } from \"./collections_search.js\";\n"],"mappings":";;;;;;AAMA,MAAa,QAAQ;CAEnB,eAAA,oBAAA;CACA,cAAA,mBAAA;CACA,YAAA,iBAAA;CACA,kBAAA,uBAAA;CACA,sBAAA,2BAAA;CACD"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/tools/index.ts"],"sourcesContent":["import { xaiLiveSearch } from \"./live_search.js\";\nimport { xaiWebSearch } from \"./web_search.js\";\nimport { xaiXSearch } from \"./x_search.js\";\nimport { xaiCodeExecution } from \"./code_execution.js\";\nimport { xaiCollectionsSearch } from \"./collections_search.js\";\n\nexport const tools = {\n  /** @deprecated Use xaiWebSearch and xaiXSearch instead */\n  xaiLiveSearch,\n  xaiWebSearch,\n  xaiXSearch,\n  xaiCodeExecution,\n  xaiCollectionsSearch,\n};\n\n// Re-export types for convenience\nexport type {\n  XAILiveSearchTool,\n  XAILiveSearchToolOptions,\n} from \"./live_search.js\";\nexport type {\n  XAIWebSearchTool,\n  XAIWebSearchToolOptions,\n} from \"./web_search.js\";\nexport type { XAIXSearchTool, XAIXSearchToolOptions } from \"./x_search.js\";\nexport type { XAICodeExecutionTool } from \"./code_execution.js\";\nexport type {\n  XAICollectionsSearchTool,\n  XAICollectionsSearchToolOptions,\n} from \"./collections_search.js\";\n\n// Re-export tool type constants\nexport {\n  XAI_LIVE_SEARCH_TOOL_TYPE,\n  XAI_LIVE_SEARCH_TOOL_NAME,\n} from \"./live_search.js\";\nexport { XAI_WEB_SEARCH_TOOL_TYPE } from \"./web_search.js\";\nexport { XAI_X_SEARCH_TOOL_TYPE } from \"./x_search.js\";\nexport { XAI_CODE_EXECUTION_TOOL_TYPE } from \"./code_execution.js\";\nexport { XAI_COLLECTIONS_SEARCH_TOOL_TYPE } from \"./collections_search.js\";\n"],"mappings":";;;;;;AAMA,MAAa,QAAQ;;CAEnB,eAAA,oBAAA;CACA,cAAA,mBAAA;CACA,YAAA,iBAAA;CACA,kBAAA,uBAAA;CACA,sBAAA,2BAAA;CACD"}

package/dist/tools/index.js

@@ -5,6 +5,7 @@ import { xaiCodeExecution } from "./code_execution.js";
 import { xaiCollectionsSearch } from "./collections_search.js";
 //#region src/tools/index.ts
 const tools = {
+	/** @deprecated Use xaiWebSearch and xaiXSearch instead */
 	xaiLiveSearch,
 	xaiWebSearch,
 	xaiXSearch,

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/tools/index.ts"],"sourcesContent":["import { xaiLiveSearch } from \"./live_search.js\";\nimport { xaiWebSearch } from \"./web_search.js\";\nimport { xaiXSearch } from \"./x_search.js\";\nimport { xaiCodeExecution } from \"./code_execution.js\";\nimport { xaiCollectionsSearch } from \"./collections_search.js\";\n\nexport const tools = {\n  /** @deprecated Use xaiWebSearch and xaiXSearch instead */\n  xaiLiveSearch,\n  xaiWebSearch,\n  xaiXSearch,\n  xaiCodeExecution,\n  xaiCollectionsSearch,\n};\n\n// Re-export types for convenience\nexport type {\n  XAILiveSearchTool,\n  XAILiveSearchToolOptions,\n} from \"./live_search.js\";\nexport type {\n  XAIWebSearchTool,\n  XAIWebSearchToolOptions,\n} from \"./web_search.js\";\nexport type { XAIXSearchTool, XAIXSearchToolOptions } from \"./x_search.js\";\nexport type { XAICodeExecutionTool } from \"./code_execution.js\";\nexport type {\n  XAICollectionsSearchTool,\n  XAICollectionsSearchToolOptions,\n} from \"./collections_search.js\";\n\n// Re-export tool type constants\nexport {\n  XAI_LIVE_SEARCH_TOOL_TYPE,\n  XAI_LIVE_SEARCH_TOOL_NAME,\n} from \"./live_search.js\";\nexport { XAI_WEB_SEARCH_TOOL_TYPE } from \"./web_search.js\";\nexport { XAI_X_SEARCH_TOOL_TYPE } from \"./x_search.js\";\nexport { XAI_CODE_EXECUTION_TOOL_TYPE } from \"./code_execution.js\";\nexport { XAI_COLLECTIONS_SEARCH_TOOL_TYPE } from \"./collections_search.js\";\n"],"mappings":";;;;;;AAMA,MAAa,QAAQ;CAEnB;CACA;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/tools/index.ts"],"sourcesContent":["import { xaiLiveSearch } from \"./live_search.js\";\nimport { xaiWebSearch } from \"./web_search.js\";\nimport { xaiXSearch } from \"./x_search.js\";\nimport { xaiCodeExecution } from \"./code_execution.js\";\nimport { xaiCollectionsSearch } from \"./collections_search.js\";\n\nexport const tools = {\n  /** @deprecated Use xaiWebSearch and xaiXSearch instead */\n  xaiLiveSearch,\n  xaiWebSearch,\n  xaiXSearch,\n  xaiCodeExecution,\n  xaiCollectionsSearch,\n};\n\n// Re-export types for convenience\nexport type {\n  XAILiveSearchTool,\n  XAILiveSearchToolOptions,\n} from \"./live_search.js\";\nexport type {\n  XAIWebSearchTool,\n  XAIWebSearchToolOptions,\n} from \"./web_search.js\";\nexport type { XAIXSearchTool, XAIXSearchToolOptions } from \"./x_search.js\";\nexport type { XAICodeExecutionTool } from \"./code_execution.js\";\nexport type {\n  XAICollectionsSearchTool,\n  XAICollectionsSearchToolOptions,\n} from \"./collections_search.js\";\n\n// Re-export tool type constants\nexport {\n  XAI_LIVE_SEARCH_TOOL_TYPE,\n  XAI_LIVE_SEARCH_TOOL_NAME,\n} from \"./live_search.js\";\nexport { XAI_WEB_SEARCH_TOOL_TYPE } from \"./web_search.js\";\nexport { XAI_X_SEARCH_TOOL_TYPE } from \"./x_search.js\";\nexport { XAI_CODE_EXECUTION_TOOL_TYPE } from \"./code_execution.js\";\nexport { XAI_COLLECTIONS_SEARCH_TOOL_TYPE } from \"./collections_search.js\";\n"],"mappings":";;;;;;AAMA,MAAa,QAAQ;;CAEnB;CACA;CACA;CACA;CACA;CACD"}

package/dist/tools/live_search.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"live_search.cjs","names":[],"sources":["../../src/tools/live_search.ts"],"sourcesContent":["import type { XAISearchParameters, XAISearchSource } from \"../live_search.js\";\n\n/**\n * xAI's deprecated live_search tool type.\n */\nexport const XAI_LIVE_SEARCH_TOOL_TYPE = \"live_search_deprecated_20251215\";\nexport const XAI_LIVE_SEARCH_TOOL_NAME = \"live_search\";\n\n/**\n * xAI's built-in live_search tool type.\n * Enables the model to search the web for real-time information.\n */\nexport interface XAILiveSearchTool extends XAISearchParameters {\n  /**\n   * The name of the tool. Must be \"live_search\" for xAI's built-in search.\n   */\n  name: typeof XAI_LIVE_SEARCH_TOOL_NAME;\n  /**\n   * The type of the tool. This uses a deprecated Live Search API shape:\n   * the advanced agentic search capabilities powering grok.com are generally\n   * available in the new agentic tool calling API, and the Live Search API\n   * will be deprecated by December 15, 2025.\n   */\n  type: typeof XAI_LIVE_SEARCH_TOOL_TYPE;\n}\n\n/**\n * Web search source configuration for the xAI live search tool (camelCase).\n * This is converted to the snake_case `XAIWebSource` internally.\n */\nexport interface XAIWebSearchToolSource {\n  type: \"web\";\n  country?: string;\n  excludedWebsites?: string[];\n  allowedWebsites?: string[];\n  safeSearch?: boolean;\n}\n\n/**\n * News search source configuration for the xAI live search tool (camelCase).\n * This is converted to the snake_case `XAINewsSource` internally.\n */\nexport interface XAINewsSearchToolSource {\n  type: \"news\";\n  country?: string;\n  excludedWebsites?: string[];\n  safeSearch?: boolean;\n}\n\n/**\n * X (formerly Twitter) search source configuration for the xAI live search tool (camelCase).\n * This is converted to the snake_case `XAIXSource` internally.\n */\nexport interface XAIXSearchToolSource {\n  type: \"x\";\n  includedXHandles?: string[];\n  excludedXHandles?: string[];\n  postFavoriteCount?: number;\n  postViewCount?: number;\n}\n\n/**\n * RSS feed search source configuration for the xAI live search tool.\n * The structure matches `XAIRssSource` (only `links`).\n */\nexport interface XAIRssSearchToolSource {\n  type: \"rss\";\n  links: string[];\n}\n\nexport type XAISearchToolSource =\n  | XAIWebSearchToolSource\n  | XAINewsSearchToolSource\n  | XAIXSearchToolSource\n  | XAIRssSearchToolSource;\n\n/**\n * Options for the xAI live search tool (camelCase).\n * All fields are camel-cased for the TypeScript API and are mapped to the\n * corresponding snake_case fields in the underlying `XAISearchParameters`\n * object that is sent to xAI's deprecated Live Search API.\n */\nexport interface XAILiveSearchToolOptions {\n  /**\n   * Controls when the model should perform a search.\n   * - \"auto\": Let the model decide when to search (default)\n   * - \"on\": Always search for every request\n   * - \"off\": Never search\n   */\n  mode?: \"auto\" | \"on\" | \"off\";\n  /**\n   * Maximum number of search results to return.\n   * @default 20\n   */\n  maxSearchResults?: number;\n  /**\n   * Filter search results to only include content from after this date.\n   * Format: ISO 8601 date string (e.g., \"2024-01-01\")\n   */\n  fromDate?: string;\n  /**\n   * Filter search results to only include content from before this date.\n   * Format: ISO 8601 date string (e.g., \"2024-12-31\")\n   */\n  toDate?: string;\n  /**\n   * Whether to return citations/sources for the search results.\n   * @default true\n   */\n  returnCitations?: boolean;\n  /**\n   * Specific web/news/X/RSS sources that can be used for the search.\n   * These are converted to the snake_case `XAISearchSource` structures\n   * used by the underlying xAI Live Search API.\n   */\n  sources?: XAISearchToolSource[];\n}\n\nfunction mapToolSourceToSearchSource(\n  source: XAISearchToolSource\n): XAISearchSource {\n  switch (source.type) {\n    case \"web\":\n      return {\n        type: \"web\",\n        ...(source.country !== undefined && { country: source.country }),\n        ...(source.allowedWebsites !== undefined && {\n          allowed_websites: source.allowedWebsites,\n        }),\n        ...(source.excludedWebsites !== undefined && {\n          excluded_websites: source.excludedWebsites,\n        }),\n        ...(source.safeSearch !== undefined && {\n          safe_search: source.safeSearch,\n        }),\n      };\n    case \"news\":\n      return {\n        type: \"news\",\n        ...(source.country !== undefined && { country: source.country }),\n        ...(source.excludedWebsites !== undefined && {\n          excluded_websites: source.excludedWebsites,\n        }),\n        ...(source.safeSearch !== undefined && {\n          safe_search: source.safeSearch,\n        }),\n      };\n    case \"x\":\n      return {\n        type: \"x\",\n        ...(source.includedXHandles !== undefined && {\n          included_x_handles: source.includedXHandles,\n        }),\n        ...(source.excludedXHandles !== undefined && {\n          excluded_x_handles: source.excludedXHandles,\n        }),\n        ...(source.postFavoriteCount !== undefined && {\n          post_favorite_count: source.postFavoriteCount,\n        }),\n        ...(source.postViewCount !== undefined && {\n          post_view_count: source.postViewCount,\n        }),\n      };\n    case \"rss\":\n      return {\n        type: \"rss\",\n        links: source.links,\n      };\n    default: {\n      const _exhaustive: never = source;\n      return _exhaustive;\n    }\n  }\n}\n\n/**\n * Creates an xAI built-in live search tool.\n * Enables the model to search the web for real-time information.\n *\n * This tool is executed server-side by the xAI API.\n *\n * @deprecated The Live Search API was deprecated by xAI on December 15, 2025.\n * Use the new agentic tool calling API instead with `xaiWebSearch()` and `xaiXSearch()`.\n *\n * @example Migration to new tools:\n * ```typescript\n * // Old (deprecated):\n * const searchTool = tools.xaiLiveSearch({ maxSearchResults: 5 });\n *\n * // New (recommended):\n * const webSearch = tools.xaiWebSearch({ allowedDomains: [\"example.com\"] });\n * const xSearch = tools.xaiXSearch({ allowedXHandles: [\"elonmusk\"] });\n * ```\n *\n * @example\n * ```typescript\n * import { ChatXAI, tools } from \"@langchain/xai\";\n *\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n * });\n *\n * const searchTool = tools.xaiLiveSearch({\n *   maxSearchResults: 5,\n *   fromDate: \"2024-01-01\",\n *   returnCitations: true\n * });\n *\n * const llmWithSearch = llm.bindTools([searchTool]);\n * const result = await llmWithSearch.invoke(\"What happened in tech today?\");\n * ```\n */\nexport function xaiLiveSearch(\n  options: XAILiveSearchToolOptions = {}\n): XAILiveSearchTool {\n  return {\n    type: XAI_LIVE_SEARCH_TOOL_TYPE,\n    name: XAI_LIVE_SEARCH_TOOL_NAME,\n    mode: options?.mode,\n    max_search_results: options?.maxSearchResults,\n    from_date: options?.fromDate,\n    to_date: options?.toDate,\n    return_citations: options?.returnCitations,\n    sources: options?.sources?.map(mapToolSourceToSearchSource),\n  } satisfies XAILiveSearchTool;\n}\n"],"mappings":";;;;AAKA,MAAa,4BAA4B;AACzC,MAAa,4BAA4B;AAgHzC,SAAS,4BACP,QACiB;AACjB,SAAQ,OAAO,MAAf;EACE,KAAK,MACH,QAAO;GACL,MAAM;GACN,GAAI,OAAO,YAAY,KAAA,KAAa,EAAE,SAAS,OAAO,SAAS;GAC/D,GAAI,OAAO,oBAAoB,KAAA,KAAa,EAC1C,kBAAkB,OAAO,iBAC1B;GACD,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,mBAAmB,OAAO,kBAC3B;GACD,GAAI,OAAO,eAAe,KAAA,KAAa,EACrC,aAAa,OAAO,YACrB;GACF;EACH,KAAK,OACH,QAAO;GACL,MAAM;GACN,GAAI,OAAO,YAAY,KAAA,KAAa,EAAE,SAAS,OAAO,SAAS;GAC/D,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,mBAAmB,OAAO,kBAC3B;GACD,GAAI,OAAO,eAAe,KAAA,KAAa,EACrC,aAAa,OAAO,YACrB;GACF;EACH,KAAK,IACH,QAAO;GACL,MAAM;GACN,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,oBAAoB,OAAO,kBAC5B;GACD,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,oBAAoB,OAAO,kBAC5B;GACD,GAAI,OAAO,sBAAsB,KAAA,KAAa,EAC5C,qBAAqB,OAAO,mBAC7B;GACD,GAAI,OAAO,kBAAkB,KAAA,KAAa,EACxC,iBAAiB,OAAO,eACzB;GACF;EACH,KAAK,MACH,QAAO;GACL,MAAM;GACN,OAAO,OAAO;GACf;EACH,QAEE,QAD2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CjC,SAAgB,cACd,UAAoC,EAAE,EACnB;AACnB,QAAO;EACL,MAAM;EACN,MAAM;EACN,MAAM,SAAS;EACf,oBAAoB,SAAS;EAC7B,WAAW,SAAS;EACpB,SAAS,SAAS;EAClB,kBAAkB,SAAS;EAC3B,SAAS,SAAS,SAAS,IAAI,4BAA4B;EAC5D"}
+{"version":3,"file":"live_search.cjs","names":["_exhaustive"],"sources":["../../src/tools/live_search.ts"],"sourcesContent":["import type { XAISearchParameters, XAISearchSource } from \"../live_search.js\";\n\n/**\n * xAI's deprecated live_search tool type.\n */\nexport const XAI_LIVE_SEARCH_TOOL_TYPE = \"live_search_deprecated_20251215\";\nexport const XAI_LIVE_SEARCH_TOOL_NAME = \"live_search\";\n\n/**\n * xAI's built-in live_search tool type.\n * Enables the model to search the web for real-time information.\n */\nexport interface XAILiveSearchTool extends XAISearchParameters {\n  /**\n   * The name of the tool. Must be \"live_search\" for xAI's built-in search.\n   */\n  name: typeof XAI_LIVE_SEARCH_TOOL_NAME;\n  /**\n   * The type of the tool. This uses a deprecated Live Search API shape:\n   * the advanced agentic search capabilities powering grok.com are generally\n   * available in the new agentic tool calling API, and the Live Search API\n   * will be deprecated by December 15, 2025.\n   */\n  type: typeof XAI_LIVE_SEARCH_TOOL_TYPE;\n}\n\n/**\n * Web search source configuration for the xAI live search tool (camelCase).\n * This is converted to the snake_case `XAIWebSource` internally.\n */\nexport interface XAIWebSearchToolSource {\n  type: \"web\";\n  country?: string;\n  excludedWebsites?: string[];\n  allowedWebsites?: string[];\n  safeSearch?: boolean;\n}\n\n/**\n * News search source configuration for the xAI live search tool (camelCase).\n * This is converted to the snake_case `XAINewsSource` internally.\n */\nexport interface XAINewsSearchToolSource {\n  type: \"news\";\n  country?: string;\n  excludedWebsites?: string[];\n  safeSearch?: boolean;\n}\n\n/**\n * X (formerly Twitter) search source configuration for the xAI live search tool (camelCase).\n * This is converted to the snake_case `XAIXSource` internally.\n */\nexport interface XAIXSearchToolSource {\n  type: \"x\";\n  includedXHandles?: string[];\n  excludedXHandles?: string[];\n  postFavoriteCount?: number;\n  postViewCount?: number;\n}\n\n/**\n * RSS feed search source configuration for the xAI live search tool.\n * The structure matches `XAIRssSource` (only `links`).\n */\nexport interface XAIRssSearchToolSource {\n  type: \"rss\";\n  links: string[];\n}\n\nexport type XAISearchToolSource =\n  | XAIWebSearchToolSource\n  | XAINewsSearchToolSource\n  | XAIXSearchToolSource\n  | XAIRssSearchToolSource;\n\n/**\n * Options for the xAI live search tool (camelCase).\n * All fields are camel-cased for the TypeScript API and are mapped to the\n * corresponding snake_case fields in the underlying `XAISearchParameters`\n * object that is sent to xAI's deprecated Live Search API.\n */\nexport interface XAILiveSearchToolOptions {\n  /**\n   * Controls when the model should perform a search.\n   * - \"auto\": Let the model decide when to search (default)\n   * - \"on\": Always search for every request\n   * - \"off\": Never search\n   */\n  mode?: \"auto\" | \"on\" | \"off\";\n  /**\n   * Maximum number of search results to return.\n   * @default 20\n   */\n  maxSearchResults?: number;\n  /**\n   * Filter search results to only include content from after this date.\n   * Format: ISO 8601 date string (e.g., \"2024-01-01\")\n   */\n  fromDate?: string;\n  /**\n   * Filter search results to only include content from before this date.\n   * Format: ISO 8601 date string (e.g., \"2024-12-31\")\n   */\n  toDate?: string;\n  /**\n   * Whether to return citations/sources for the search results.\n   * @default true\n   */\n  returnCitations?: boolean;\n  /**\n   * Specific web/news/X/RSS sources that can be used for the search.\n   * These are converted to the snake_case `XAISearchSource` structures\n   * used by the underlying xAI Live Search API.\n   */\n  sources?: XAISearchToolSource[];\n}\n\nfunction mapToolSourceToSearchSource(\n  source: XAISearchToolSource\n): XAISearchSource {\n  switch (source.type) {\n    case \"web\":\n      return {\n        type: \"web\",\n        ...(source.country !== undefined && { country: source.country }),\n        ...(source.allowedWebsites !== undefined && {\n          allowed_websites: source.allowedWebsites,\n        }),\n        ...(source.excludedWebsites !== undefined && {\n          excluded_websites: source.excludedWebsites,\n        }),\n        ...(source.safeSearch !== undefined && {\n          safe_search: source.safeSearch,\n        }),\n      };\n    case \"news\":\n      return {\n        type: \"news\",\n        ...(source.country !== undefined && { country: source.country }),\n        ...(source.excludedWebsites !== undefined && {\n          excluded_websites: source.excludedWebsites,\n        }),\n        ...(source.safeSearch !== undefined && {\n          safe_search: source.safeSearch,\n        }),\n      };\n    case \"x\":\n      return {\n        type: \"x\",\n        ...(source.includedXHandles !== undefined && {\n          included_x_handles: source.includedXHandles,\n        }),\n        ...(source.excludedXHandles !== undefined && {\n          excluded_x_handles: source.excludedXHandles,\n        }),\n        ...(source.postFavoriteCount !== undefined && {\n          post_favorite_count: source.postFavoriteCount,\n        }),\n        ...(source.postViewCount !== undefined && {\n          post_view_count: source.postViewCount,\n        }),\n      };\n    case \"rss\":\n      return {\n        type: \"rss\",\n        links: source.links,\n      };\n    default: {\n      const _exhaustive: never = source;\n      return _exhaustive;\n    }\n  }\n}\n\n/**\n * Creates an xAI built-in live search tool.\n * Enables the model to search the web for real-time information.\n *\n * This tool is executed server-side by the xAI API.\n *\n * @deprecated The Live Search API was deprecated by xAI on December 15, 2025.\n * Use the new agentic tool calling API instead with `xaiWebSearch()` and `xaiXSearch()`.\n *\n * @example Migration to new tools:\n * ```typescript\n * // Old (deprecated):\n * const searchTool = tools.xaiLiveSearch({ maxSearchResults: 5 });\n *\n * // New (recommended):\n * const webSearch = tools.xaiWebSearch({ allowedDomains: [\"example.com\"] });\n * const xSearch = tools.xaiXSearch({ allowedXHandles: [\"elonmusk\"] });\n * ```\n *\n * @example\n * ```typescript\n * import { ChatXAI, tools } from \"@langchain/xai\";\n *\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n * });\n *\n * const searchTool = tools.xaiLiveSearch({\n *   maxSearchResults: 5,\n *   fromDate: \"2024-01-01\",\n *   returnCitations: true\n * });\n *\n * const llmWithSearch = llm.bindTools([searchTool]);\n * const result = await llmWithSearch.invoke(\"What happened in tech today?\");\n * ```\n */\nexport function xaiLiveSearch(\n  options: XAILiveSearchToolOptions = {}\n): XAILiveSearchTool {\n  return {\n    type: XAI_LIVE_SEARCH_TOOL_TYPE,\n    name: XAI_LIVE_SEARCH_TOOL_NAME,\n    mode: options?.mode,\n    max_search_results: options?.maxSearchResults,\n    from_date: options?.fromDate,\n    to_date: options?.toDate,\n    return_citations: options?.returnCitations,\n    sources: options?.sources?.map(mapToolSourceToSearchSource),\n  } satisfies XAILiveSearchTool;\n}\n"],"mappings":";;;;AAKA,MAAa,4BAA4B;AACzC,MAAa,4BAA4B;AAgHzC,SAAS,4BACP,QACiB;AACjB,SAAQ,OAAO,MAAf;EACE,KAAK,MACH,QAAO;GACL,MAAM;GACN,GAAI,OAAO,YAAY,KAAA,KAAa,EAAE,SAAS,OAAO,SAAS;GAC/D,GAAI,OAAO,oBAAoB,KAAA,KAAa,EAC1C,kBAAkB,OAAO,iBAC1B;GACD,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,mBAAmB,OAAO,kBAC3B;GACD,GAAI,OAAO,eAAe,KAAA,KAAa,EACrC,aAAa,OAAO,YACrB;GACF;EACH,KAAK,OACH,QAAO;GACL,MAAM;GACN,GAAI,OAAO,YAAY,KAAA,KAAa,EAAE,SAAS,OAAO,SAAS;GAC/D,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,mBAAmB,OAAO,kBAC3B;GACD,GAAI,OAAO,eAAe,KAAA,KAAa,EACrC,aAAa,OAAO,YACrB;GACF;EACH,KAAK,IACH,QAAO;GACL,MAAM;GACN,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,oBAAoB,OAAO,kBAC5B;GACD,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,oBAAoB,OAAO,kBAC5B;GACD,GAAI,OAAO,sBAAsB,KAAA,KAAa,EAC5C,qBAAqB,OAAO,mBAC7B;GACD,GAAI,OAAO,kBAAkB,KAAA,KAAa,EACxC,iBAAiB,OAAO,eACzB;GACF;EACH,KAAK,MACH,QAAO;GACL,MAAM;GACN,OAAO,OAAO;GACf;EACH,QAEE,QAAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0Cb,SAAgB,cACd,UAAoC,EAAE,EACnB;AACnB,QAAO;EACL,MAAM;EACN,MAAM;EACN,MAAM,SAAS;EACf,oBAAoB,SAAS;EAC7B,WAAW,SAAS;EACpB,SAAS,SAAS;EAClB,kBAAkB,SAAS;EAC3B,SAAS,SAAS,SAAS,IAAI,4BAA4B;EAC5D"}

package/dist/tools/live_search.js.map

@@ -1 +1 @@
-{"version":3,"file":"live_search.js","names":[],"sources":["../../src/tools/live_search.ts"],"sourcesContent":["import type { XAISearchParameters, XAISearchSource } from \"../live_search.js\";\n\n/**\n * xAI's deprecated live_search tool type.\n */\nexport const XAI_LIVE_SEARCH_TOOL_TYPE = \"live_search_deprecated_20251215\";\nexport const XAI_LIVE_SEARCH_TOOL_NAME = \"live_search\";\n\n/**\n * xAI's built-in live_search tool type.\n * Enables the model to search the web for real-time information.\n */\nexport interface XAILiveSearchTool extends XAISearchParameters {\n  /**\n   * The name of the tool. Must be \"live_search\" for xAI's built-in search.\n   */\n  name: typeof XAI_LIVE_SEARCH_TOOL_NAME;\n  /**\n   * The type of the tool. This uses a deprecated Live Search API shape:\n   * the advanced agentic search capabilities powering grok.com are generally\n   * available in the new agentic tool calling API, and the Live Search API\n   * will be deprecated by December 15, 2025.\n   */\n  type: typeof XAI_LIVE_SEARCH_TOOL_TYPE;\n}\n\n/**\n * Web search source configuration for the xAI live search tool (camelCase).\n * This is converted to the snake_case `XAIWebSource` internally.\n */\nexport interface XAIWebSearchToolSource {\n  type: \"web\";\n  country?: string;\n  excludedWebsites?: string[];\n  allowedWebsites?: string[];\n  safeSearch?: boolean;\n}\n\n/**\n * News search source configuration for the xAI live search tool (camelCase).\n * This is converted to the snake_case `XAINewsSource` internally.\n */\nexport interface XAINewsSearchToolSource {\n  type: \"news\";\n  country?: string;\n  excludedWebsites?: string[];\n  safeSearch?: boolean;\n}\n\n/**\n * X (formerly Twitter) search source configuration for the xAI live search tool (camelCase).\n * This is converted to the snake_case `XAIXSource` internally.\n */\nexport interface XAIXSearchToolSource {\n  type: \"x\";\n  includedXHandles?: string[];\n  excludedXHandles?: string[];\n  postFavoriteCount?: number;\n  postViewCount?: number;\n}\n\n/**\n * RSS feed search source configuration for the xAI live search tool.\n * The structure matches `XAIRssSource` (only `links`).\n */\nexport interface XAIRssSearchToolSource {\n  type: \"rss\";\n  links: string[];\n}\n\nexport type XAISearchToolSource =\n  | XAIWebSearchToolSource\n  | XAINewsSearchToolSource\n  | XAIXSearchToolSource\n  | XAIRssSearchToolSource;\n\n/**\n * Options for the xAI live search tool (camelCase).\n * All fields are camel-cased for the TypeScript API and are mapped to the\n * corresponding snake_case fields in the underlying `XAISearchParameters`\n * object that is sent to xAI's deprecated Live Search API.\n */\nexport interface XAILiveSearchToolOptions {\n  /**\n   * Controls when the model should perform a search.\n   * - \"auto\": Let the model decide when to search (default)\n   * - \"on\": Always search for every request\n   * - \"off\": Never search\n   */\n  mode?: \"auto\" | \"on\" | \"off\";\n  /**\n   * Maximum number of search results to return.\n   * @default 20\n   */\n  maxSearchResults?: number;\n  /**\n   * Filter search results to only include content from after this date.\n   * Format: ISO 8601 date string (e.g., \"2024-01-01\")\n   */\n  fromDate?: string;\n  /**\n   * Filter search results to only include content from before this date.\n   * Format: ISO 8601 date string (e.g., \"2024-12-31\")\n   */\n  toDate?: string;\n  /**\n   * Whether to return citations/sources for the search results.\n   * @default true\n   */\n  returnCitations?: boolean;\n  /**\n   * Specific web/news/X/RSS sources that can be used for the search.\n   * These are converted to the snake_case `XAISearchSource` structures\n   * used by the underlying xAI Live Search API.\n   */\n  sources?: XAISearchToolSource[];\n}\n\nfunction mapToolSourceToSearchSource(\n  source: XAISearchToolSource\n): XAISearchSource {\n  switch (source.type) {\n    case \"web\":\n      return {\n        type: \"web\",\n        ...(source.country !== undefined && { country: source.country }),\n        ...(source.allowedWebsites !== undefined && {\n          allowed_websites: source.allowedWebsites,\n        }),\n        ...(source.excludedWebsites !== undefined && {\n          excluded_websites: source.excludedWebsites,\n        }),\n        ...(source.safeSearch !== undefined && {\n          safe_search: source.safeSearch,\n        }),\n      };\n    case \"news\":\n      return {\n        type: \"news\",\n        ...(source.country !== undefined && { country: source.country }),\n        ...(source.excludedWebsites !== undefined && {\n          excluded_websites: source.excludedWebsites,\n        }),\n        ...(source.safeSearch !== undefined && {\n          safe_search: source.safeSearch,\n        }),\n      };\n    case \"x\":\n      return {\n        type: \"x\",\n        ...(source.includedXHandles !== undefined && {\n          included_x_handles: source.includedXHandles,\n        }),\n        ...(source.excludedXHandles !== undefined && {\n          excluded_x_handles: source.excludedXHandles,\n        }),\n        ...(source.postFavoriteCount !== undefined && {\n          post_favorite_count: source.postFavoriteCount,\n        }),\n        ...(source.postViewCount !== undefined && {\n          post_view_count: source.postViewCount,\n        }),\n      };\n    case \"rss\":\n      return {\n        type: \"rss\",\n        links: source.links,\n      };\n    default: {\n      const _exhaustive: never = source;\n      return _exhaustive;\n    }\n  }\n}\n\n/**\n * Creates an xAI built-in live search tool.\n * Enables the model to search the web for real-time information.\n *\n * This tool is executed server-side by the xAI API.\n *\n * @deprecated The Live Search API was deprecated by xAI on December 15, 2025.\n * Use the new agentic tool calling API instead with `xaiWebSearch()` and `xaiXSearch()`.\n *\n * @example Migration to new tools:\n * ```typescript\n * // Old (deprecated):\n * const searchTool = tools.xaiLiveSearch({ maxSearchResults: 5 });\n *\n * // New (recommended):\n * const webSearch = tools.xaiWebSearch({ allowedDomains: [\"example.com\"] });\n * const xSearch = tools.xaiXSearch({ allowedXHandles: [\"elonmusk\"] });\n * ```\n *\n * @example\n * ```typescript\n * import { ChatXAI, tools } from \"@langchain/xai\";\n *\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n * });\n *\n * const searchTool = tools.xaiLiveSearch({\n *   maxSearchResults: 5,\n *   fromDate: \"2024-01-01\",\n *   returnCitations: true\n * });\n *\n * const llmWithSearch = llm.bindTools([searchTool]);\n * const result = await llmWithSearch.invoke(\"What happened in tech today?\");\n * ```\n */\nexport function xaiLiveSearch(\n  options: XAILiveSearchToolOptions = {}\n): XAILiveSearchTool {\n  return {\n    type: XAI_LIVE_SEARCH_TOOL_TYPE,\n    name: XAI_LIVE_SEARCH_TOOL_NAME,\n    mode: options?.mode,\n    max_search_results: options?.maxSearchResults,\n    from_date: options?.fromDate,\n    to_date: options?.toDate,\n    return_citations: options?.returnCitations,\n    sources: options?.sources?.map(mapToolSourceToSearchSource),\n  } satisfies XAILiveSearchTool;\n}\n"],"mappings":";;;;AAKA,MAAa,4BAA4B;AACzC,MAAa,4BAA4B;AAgHzC,SAAS,4BACP,QACiB;AACjB,SAAQ,OAAO,MAAf;EACE,KAAK,MACH,QAAO;GACL,MAAM;GACN,GAAI,OAAO,YAAY,KAAA,KAAa,EAAE,SAAS,OAAO,SAAS;GAC/D,GAAI,OAAO,oBAAoB,KAAA,KAAa,EAC1C,kBAAkB,OAAO,iBAC1B;GACD,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,mBAAmB,OAAO,kBAC3B;GACD,GAAI,OAAO,eAAe,KAAA,KAAa,EACrC,aAAa,OAAO,YACrB;GACF;EACH,KAAK,OACH,QAAO;GACL,MAAM;GACN,GAAI,OAAO,YAAY,KAAA,KAAa,EAAE,SAAS,OAAO,SAAS;GAC/D,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,mBAAmB,OAAO,kBAC3B;GACD,GAAI,OAAO,eAAe,KAAA,KAAa,EACrC,aAAa,OAAO,YACrB;GACF;EACH,KAAK,IACH,QAAO;GACL,MAAM;GACN,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,oBAAoB,OAAO,kBAC5B;GACD,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,oBAAoB,OAAO,kBAC5B;GACD,GAAI,OAAO,sBAAsB,KAAA,KAAa,EAC5C,qBAAqB,OAAO,mBAC7B;GACD,GAAI,OAAO,kBAAkB,KAAA,KAAa,EACxC,iBAAiB,OAAO,eACzB;GACF;EACH,KAAK,MACH,QAAO;GACL,MAAM;GACN,OAAO,OAAO;GACf;EACH,QAEE,QAD2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CjC,SAAgB,cACd,UAAoC,EAAE,EACnB;AACnB,QAAO;EACL,MAAM;EACN,MAAM;EACN,MAAM,SAAS;EACf,oBAAoB,SAAS;EAC7B,WAAW,SAAS;EACpB,SAAS,SAAS;EAClB,kBAAkB,SAAS;EAC3B,SAAS,SAAS,SAAS,IAAI,4BAA4B;EAC5D"}
+{"version":3,"file":"live_search.js","names":["_exhaustive"],"sources":["../../src/tools/live_search.ts"],"sourcesContent":["import type { XAISearchParameters, XAISearchSource } from \"../live_search.js\";\n\n/**\n * xAI's deprecated live_search tool type.\n */\nexport const XAI_LIVE_SEARCH_TOOL_TYPE = \"live_search_deprecated_20251215\";\nexport const XAI_LIVE_SEARCH_TOOL_NAME = \"live_search\";\n\n/**\n * xAI's built-in live_search tool type.\n * Enables the model to search the web for real-time information.\n */\nexport interface XAILiveSearchTool extends XAISearchParameters {\n  /**\n   * The name of the tool. Must be \"live_search\" for xAI's built-in search.\n   */\n  name: typeof XAI_LIVE_SEARCH_TOOL_NAME;\n  /**\n   * The type of the tool. This uses a deprecated Live Search API shape:\n   * the advanced agentic search capabilities powering grok.com are generally\n   * available in the new agentic tool calling API, and the Live Search API\n   * will be deprecated by December 15, 2025.\n   */\n  type: typeof XAI_LIVE_SEARCH_TOOL_TYPE;\n}\n\n/**\n * Web search source configuration for the xAI live search tool (camelCase).\n * This is converted to the snake_case `XAIWebSource` internally.\n */\nexport interface XAIWebSearchToolSource {\n  type: \"web\";\n  country?: string;\n  excludedWebsites?: string[];\n  allowedWebsites?: string[];\n  safeSearch?: boolean;\n}\n\n/**\n * News search source configuration for the xAI live search tool (camelCase).\n * This is converted to the snake_case `XAINewsSource` internally.\n */\nexport interface XAINewsSearchToolSource {\n  type: \"news\";\n  country?: string;\n  excludedWebsites?: string[];\n  safeSearch?: boolean;\n}\n\n/**\n * X (formerly Twitter) search source configuration for the xAI live search tool (camelCase).\n * This is converted to the snake_case `XAIXSource` internally.\n */\nexport interface XAIXSearchToolSource {\n  type: \"x\";\n  includedXHandles?: string[];\n  excludedXHandles?: string[];\n  postFavoriteCount?: number;\n  postViewCount?: number;\n}\n\n/**\n * RSS feed search source configuration for the xAI live search tool.\n * The structure matches `XAIRssSource` (only `links`).\n */\nexport interface XAIRssSearchToolSource {\n  type: \"rss\";\n  links: string[];\n}\n\nexport type XAISearchToolSource =\n  | XAIWebSearchToolSource\n  | XAINewsSearchToolSource\n  | XAIXSearchToolSource\n  | XAIRssSearchToolSource;\n\n/**\n * Options for the xAI live search tool (camelCase).\n * All fields are camel-cased for the TypeScript API and are mapped to the\n * corresponding snake_case fields in the underlying `XAISearchParameters`\n * object that is sent to xAI's deprecated Live Search API.\n */\nexport interface XAILiveSearchToolOptions {\n  /**\n   * Controls when the model should perform a search.\n   * - \"auto\": Let the model decide when to search (default)\n   * - \"on\": Always search for every request\n   * - \"off\": Never search\n   */\n  mode?: \"auto\" | \"on\" | \"off\";\n  /**\n   * Maximum number of search results to return.\n   * @default 20\n   */\n  maxSearchResults?: number;\n  /**\n   * Filter search results to only include content from after this date.\n   * Format: ISO 8601 date string (e.g., \"2024-01-01\")\n   */\n  fromDate?: string;\n  /**\n   * Filter search results to only include content from before this date.\n   * Format: ISO 8601 date string (e.g., \"2024-12-31\")\n   */\n  toDate?: string;\n  /**\n   * Whether to return citations/sources for the search results.\n   * @default true\n   */\n  returnCitations?: boolean;\n  /**\n   * Specific web/news/X/RSS sources that can be used for the search.\n   * These are converted to the snake_case `XAISearchSource` structures\n   * used by the underlying xAI Live Search API.\n   */\n  sources?: XAISearchToolSource[];\n}\n\nfunction mapToolSourceToSearchSource(\n  source: XAISearchToolSource\n): XAISearchSource {\n  switch (source.type) {\n    case \"web\":\n      return {\n        type: \"web\",\n        ...(source.country !== undefined && { country: source.country }),\n        ...(source.allowedWebsites !== undefined && {\n          allowed_websites: source.allowedWebsites,\n        }),\n        ...(source.excludedWebsites !== undefined && {\n          excluded_websites: source.excludedWebsites,\n        }),\n        ...(source.safeSearch !== undefined && {\n          safe_search: source.safeSearch,\n        }),\n      };\n    case \"news\":\n      return {\n        type: \"news\",\n        ...(source.country !== undefined && { country: source.country }),\n        ...(source.excludedWebsites !== undefined && {\n          excluded_websites: source.excludedWebsites,\n        }),\n        ...(source.safeSearch !== undefined && {\n          safe_search: source.safeSearch,\n        }),\n      };\n    case \"x\":\n      return {\n        type: \"x\",\n        ...(source.includedXHandles !== undefined && {\n          included_x_handles: source.includedXHandles,\n        }),\n        ...(source.excludedXHandles !== undefined && {\n          excluded_x_handles: source.excludedXHandles,\n        }),\n        ...(source.postFavoriteCount !== undefined && {\n          post_favorite_count: source.postFavoriteCount,\n        }),\n        ...(source.postViewCount !== undefined && {\n          post_view_count: source.postViewCount,\n        }),\n      };\n    case \"rss\":\n      return {\n        type: \"rss\",\n        links: source.links,\n      };\n    default: {\n      const _exhaustive: never = source;\n      return _exhaustive;\n    }\n  }\n}\n\n/**\n * Creates an xAI built-in live search tool.\n * Enables the model to search the web for real-time information.\n *\n * This tool is executed server-side by the xAI API.\n *\n * @deprecated The Live Search API was deprecated by xAI on December 15, 2025.\n * Use the new agentic tool calling API instead with `xaiWebSearch()` and `xaiXSearch()`.\n *\n * @example Migration to new tools:\n * ```typescript\n * // Old (deprecated):\n * const searchTool = tools.xaiLiveSearch({ maxSearchResults: 5 });\n *\n * // New (recommended):\n * const webSearch = tools.xaiWebSearch({ allowedDomains: [\"example.com\"] });\n * const xSearch = tools.xaiXSearch({ allowedXHandles: [\"elonmusk\"] });\n * ```\n *\n * @example\n * ```typescript\n * import { ChatXAI, tools } from \"@langchain/xai\";\n *\n * const llm = new ChatXAI({\n *   model: \"grok-3-fast\",\n * });\n *\n * const searchTool = tools.xaiLiveSearch({\n *   maxSearchResults: 5,\n *   fromDate: \"2024-01-01\",\n *   returnCitations: true\n * });\n *\n * const llmWithSearch = llm.bindTools([searchTool]);\n * const result = await llmWithSearch.invoke(\"What happened in tech today?\");\n * ```\n */\nexport function xaiLiveSearch(\n  options: XAILiveSearchToolOptions = {}\n): XAILiveSearchTool {\n  return {\n    type: XAI_LIVE_SEARCH_TOOL_TYPE,\n    name: XAI_LIVE_SEARCH_TOOL_NAME,\n    mode: options?.mode,\n    max_search_results: options?.maxSearchResults,\n    from_date: options?.fromDate,\n    to_date: options?.toDate,\n    return_citations: options?.returnCitations,\n    sources: options?.sources?.map(mapToolSourceToSearchSource),\n  } satisfies XAILiveSearchTool;\n}\n"],"mappings":";;;;AAKA,MAAa,4BAA4B;AACzC,MAAa,4BAA4B;AAgHzC,SAAS,4BACP,QACiB;AACjB,SAAQ,OAAO,MAAf;EACE,KAAK,MACH,QAAO;GACL,MAAM;GACN,GAAI,OAAO,YAAY,KAAA,KAAa,EAAE,SAAS,OAAO,SAAS;GAC/D,GAAI,OAAO,oBAAoB,KAAA,KAAa,EAC1C,kBAAkB,OAAO,iBAC1B;GACD,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,mBAAmB,OAAO,kBAC3B;GACD,GAAI,OAAO,eAAe,KAAA,KAAa,EACrC,aAAa,OAAO,YACrB;GACF;EACH,KAAK,OACH,QAAO;GACL,MAAM;GACN,GAAI,OAAO,YAAY,KAAA,KAAa,EAAE,SAAS,OAAO,SAAS;GAC/D,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,mBAAmB,OAAO,kBAC3B;GACD,GAAI,OAAO,eAAe,KAAA,KAAa,EACrC,aAAa,OAAO,YACrB;GACF;EACH,KAAK,IACH,QAAO;GACL,MAAM;GACN,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,oBAAoB,OAAO,kBAC5B;GACD,GAAI,OAAO,qBAAqB,KAAA,KAAa,EAC3C,oBAAoB,OAAO,kBAC5B;GACD,GAAI,OAAO,sBAAsB,KAAA,KAAa,EAC5C,qBAAqB,OAAO,mBAC7B;GACD,GAAI,OAAO,kBAAkB,KAAA,KAAa,EACxC,iBAAiB,OAAO,eACzB;GACF;EACH,KAAK,MACH,QAAO;GACL,MAAM;GACN,OAAO,OAAO;GACf;EACH,QAEE,QAAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0Cb,SAAgB,cACd,UAAoC,EAAE,EACnB;AACnB,QAAO;EACL,MAAM;EACN,MAAM;EACN,MAAM,SAAS;EACf,oBAAoB,SAAS;EAC7B,WAAW,SAAS;EACpB,SAAS,SAAS;EAClB,kBAAkB,SAAS;EAC3B,SAAS,SAAS,SAAS,IAAI,4BAA4B;EAC5D"}

package/dist/utils/responses_stream_events.cjs

@@ -0,0 +1,15 @@
+let _langchain_openai = require("@langchain/openai");
+//#region src/utils/responses_stream_events.ts
+async function* convertXAIResponsesStream(source, options = {}) {
+	async function* mapped() {
+		for await (const event of source) yield event;
+	}
+	yield* (0, _langchain_openai.convertOpenAIResponsesStream)(mapped(), {
+		...options,
+		provider: "xai"
+	});
+}
+//#endregion
+exports.convertXAIResponsesStream = convertXAIResponsesStream;
+
+//# sourceMappingURL=responses_stream_events.cjs.map

package/dist/utils/responses_stream_events.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses_stream_events.cjs","names":[],"sources":["../../src/utils/responses_stream_events.ts"],"sourcesContent":["/**\n * Converts xAI Responses API stream events into LangChain ChatModelStreamEvents.\n *\n * xAI Responses events are wire-compatible with OpenAI Responses stream events.\n *\n * @module\n */\n\nimport { OpenAI as OpenAIClient } from \"openai\";\nimport type { ChatModelStreamEvent } from \"@langchain/core/language_models/event\";\nimport { convertOpenAIResponsesStream } from \"@langchain/openai\";\nimport type { XAIResponsesStreamEvent } from \"../chat_models/responses-types.js\";\n\nexport interface ConvertXAIResponsesStreamOptions {\n  streamUsage?: boolean;\n}\n\nexport async function* convertXAIResponsesStream(\n  source: AsyncIterable<XAIResponsesStreamEvent>,\n  options: ConvertXAIResponsesStreamOptions = {}\n): AsyncGenerator<ChatModelStreamEvent> {\n  async function* mapped() {\n    for await (const event of source) {\n      yield event as unknown as OpenAIClient.Responses.ResponseStreamEvent;\n    }\n  }\n  yield* convertOpenAIResponsesStream(mapped(), {\n    ...options,\n    provider: \"xai\",\n  });\n}\n"],"mappings":";;AAiBA,gBAAuB,0BACrB,QACA,UAA4C,EAAE,EACR;CACtC,gBAAgB,SAAS;AACvB,aAAW,MAAM,SAAS,OACxB,OAAM;;AAGV,SAAA,GAAA,kBAAA,8BAAoC,QAAQ,EAAE;EAC5C,GAAG;EACH,UAAU;EACX,CAAC"}

package/dist/utils/responses_stream_events.js

@@ -0,0 +1,15 @@
+import { convertOpenAIResponsesStream } from "@langchain/openai";
+//#region src/utils/responses_stream_events.ts
+async function* convertXAIResponsesStream(source, options = {}) {
+	async function* mapped() {
+		for await (const event of source) yield event;
+	}
+	yield* convertOpenAIResponsesStream(mapped(), {
+		...options,
+		provider: "xai"
+	});
+}
+//#endregion
+export { convertXAIResponsesStream };
+
+//# sourceMappingURL=responses_stream_events.js.map

package/dist/utils/responses_stream_events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses_stream_events.js","names":[],"sources":["../../src/utils/responses_stream_events.ts"],"sourcesContent":["/**\n * Converts xAI Responses API stream events into LangChain ChatModelStreamEvents.\n *\n * xAI Responses events are wire-compatible with OpenAI Responses stream events.\n *\n * @module\n */\n\nimport { OpenAI as OpenAIClient } from \"openai\";\nimport type { ChatModelStreamEvent } from \"@langchain/core/language_models/event\";\nimport { convertOpenAIResponsesStream } from \"@langchain/openai\";\nimport type { XAIResponsesStreamEvent } from \"../chat_models/responses-types.js\";\n\nexport interface ConvertXAIResponsesStreamOptions {\n  streamUsage?: boolean;\n}\n\nexport async function* convertXAIResponsesStream(\n  source: AsyncIterable<XAIResponsesStreamEvent>,\n  options: ConvertXAIResponsesStreamOptions = {}\n): AsyncGenerator<ChatModelStreamEvent> {\n  async function* mapped() {\n    for await (const event of source) {\n      yield event as unknown as OpenAIClient.Responses.ResponseStreamEvent;\n    }\n  }\n  yield* convertOpenAIResponsesStream(mapped(), {\n    ...options,\n    provider: \"xai\",\n  });\n}\n"],"mappings":";;AAiBA,gBAAuB,0BACrB,QACA,UAA4C,EAAE,EACR;CACtC,gBAAgB,SAAS;AACvB,aAAW,MAAM,SAAS,OACxB,OAAM;;AAGV,QAAO,6BAA6B,QAAQ,EAAE;EAC5C,GAAG;EACH,UAAU;EACX,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/xai",
-  "version": "1.3.19",
+  "version": "1.4.0",
   "description": "xAI integration for LangChain.js",
   "author": "LangChain",
   "license": "MIT",
@@ -14,21 +14,21 @@
   },
   "homepage": "https://github.com/langchain-ai/langchainjs/tree/main/libs/providers/langchain-xai/",
   "dependencies": {
-    "@langchain/openai": "1.4.7"
+    "@langchain/openai": "1.5.0"
   },
   "peerDependencies": {
     "@langchain/core": "^1.0.0"
   },
   "devDependencies": {
     "@tsconfig/recommended": "^1.0.3",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/coverage-v8": "^4.1.8",
     "dotenv": "^17.4.0",
     "dpdm": "^3.14.0",
-    "typescript": "~5.8.3",
-    "vitest": "^4.1.2",
+    "typescript": "~6.0.3",
+    "vitest": "^4.1.8",
     "zod": "^3.25.76",
-    "@langchain/openai": "^1.4.7",
-    "@langchain/core": "^1.1.48",
+    "@langchain/core": "^1.2.0",
+    "@langchain/openai": "^1.5.0",
     "@langchain/standard-tests": "0.0.23",
     "@langchain/tsconfig": "0.0.1"
   },