@nocobase/plugin-ai 2.1.0-beta.24 → 2.1.0-beta.26

package/dist/node_modules/@langchain/xai/dist/index.d.cts

@@ -0,0 +1,5 @@
+import { ChatXAI, ChatXAICallOptions, ChatXAICompletionsInvocationParams, ChatXAIInput, OpenAIToolChoice, XAIAdditionalKwargs, XAIBuiltInTool, XAIResponseMetadata, isXAIBuiltInTool } from "./chat_models/completions.cjs";
+import { ChatXAIResponsesCallOptions, ChatXAIResponsesInput, ChatXAIResponsesInvocationParams, XAIResponse, XAIResponsesAnnotation, XAIResponsesCodeInterpreterResult, XAIResponsesCodeInterpreterTool, XAIResponsesCodeInterpreterToolCall, XAIResponsesCreateParams, XAIResponsesCreateParamsNonStreaming, XAIResponsesCreateParamsStreaming, XAIResponsesDebugOutput, XAIResponsesFileCitationAnnotation, XAIResponsesFileSearchResult, XAIResponsesFileSearchTool, XAIResponsesFunctionTool, XAIResponsesFunctionToolCall, XAIResponsesFunctionToolFunction, XAIResponsesFunctionToolOutput, XAIResponsesInclude, XAIResponsesIncompleteDetails, XAIResponsesIncompleteReason, XAIResponsesInput, XAIResponsesInputContentItem, XAIResponsesInputFileItem, XAIResponsesInputImageItem, XAIResponsesInputItem, XAIResponsesInputTextItem, XAIResponsesLogprobContent, XAIResponsesLogprobToken, XAIResponsesLogprobs, XAIResponsesMcpTool, XAIResponsesMcpToolCall, XAIResponsesMessage, XAIResponsesMessageRole, XAIResponsesObjectType, XAIResponsesOutputCodeInterpreterCall, XAIResponsesOutputContent, XAIResponsesOutputFileSearchCall, XAIResponsesOutputFunctionCall, XAIResponsesOutputItem, XAIResponsesOutputMcpCall, XAIResponsesOutputReasoning, XAIResponsesOutputRefusalContent, XAIResponsesOutputTextContent, XAIResponsesOutputTextItem, XAIResponsesOutputWebSearchCall, XAIResponsesPreviousResponse, XAIResponsesReasoning, XAIResponsesReasoningEffort, XAIResponsesReasoningResponse, XAIResponsesReasoningSummary, XAIResponsesReasoningSummaryItem, XAIResponsesSearchMode, XAIResponsesSearchParameters, XAIResponsesSearchSource, XAIResponsesSearchSourceRss, XAIResponsesSearchSourceWeb, XAIResponsesSearchSourceX, XAIResponsesStatus, XAIResponsesStreamEvent, XAIResponsesStreamEventBase, XAIResponsesStreamEventCompleted, XAIResponsesStreamEventContentPartAdded, XAIResponsesStreamEventContentPartDone, XAIResponsesStreamEventCreated, XAIResponsesStreamEventError, XAIResponsesStreamEventFailed, XAIResponsesStreamEventFunctionCallArgumentsDelta, XAIResponsesStreamEventFunctionCallArgumentsDone, XAIResponsesStreamEventInProgress, XAIResponsesStreamEventIncomplete, XAIResponsesStreamEventOutputItemAdded, XAIResponsesStreamEventOutputItemDone, XAIResponsesStreamEventReasoningSummaryTextDelta, XAIResponsesStreamEventReasoningSummaryTextDone, XAIResponsesStreamEventTextDelta, XAIResponsesStreamEventTextDone, XAIResponsesText, XAIResponsesTextFormat, XAIResponsesTextFormatJsonObject, XAIResponsesTextFormatJsonSchema, XAIResponsesTextFormatText, XAIResponsesTool, XAIResponsesToolCall, XAIResponsesToolChoice, XAIResponsesToolChoiceFunction, XAIResponsesToolChoiceString, XAIResponsesToolOutput, XAIResponsesUrlCitationAnnotation, XAIResponsesUsage, XAIResponsesWebSearchTool, XAIResponsesWebSearchToolCall, XAIResponsesXSearchTool } from "./chat_models/responses-types.cjs";
+import { ChatXAIResponses } from "./chat_models/responses.cjs";
+import { tools } from "./tools/index.cjs";
+export { ChatXAI, ChatXAICallOptions, ChatXAICompletionsInvocationParams, ChatXAIInput, ChatXAIResponses, ChatXAIResponsesCallOptions, ChatXAIResponsesInput, ChatXAIResponsesInvocationParams, OpenAIToolChoice, XAIAdditionalKwargs, XAIBuiltInTool, XAIResponse, XAIResponseMetadata, XAIResponsesAnnotation, XAIResponsesCodeInterpreterResult, XAIResponsesCodeInterpreterTool, XAIResponsesCodeInterpreterToolCall, XAIResponsesCreateParams, XAIResponsesCreateParamsNonStreaming, XAIResponsesCreateParamsStreaming, XAIResponsesDebugOutput, XAIResponsesFileCitationAnnotation, XAIResponsesFileSearchResult, XAIResponsesFileSearchTool, XAIResponsesFunctionTool, XAIResponsesFunctionToolCall, XAIResponsesFunctionToolFunction, XAIResponsesFunctionToolOutput, XAIResponsesInclude, XAIResponsesIncompleteDetails, XAIResponsesIncompleteReason, XAIResponsesInput, XAIResponsesInputContentItem, XAIResponsesInputFileItem, XAIResponsesInputImageItem, XAIResponsesInputItem, XAIResponsesInputTextItem, XAIResponsesLogprobContent, XAIResponsesLogprobToken, XAIResponsesLogprobs, XAIResponsesMcpTool, XAIResponsesMcpToolCall, XAIResponsesMessage, XAIResponsesMessageRole, XAIResponsesObjectType, XAIResponsesOutputCodeInterpreterCall, XAIResponsesOutputContent, XAIResponsesOutputFileSearchCall, XAIResponsesOutputFunctionCall, XAIResponsesOutputItem, XAIResponsesOutputMcpCall, XAIResponsesOutputReasoning, XAIResponsesOutputRefusalContent, XAIResponsesOutputTextContent, XAIResponsesOutputTextItem, XAIResponsesOutputWebSearchCall, XAIResponsesPreviousResponse, XAIResponsesReasoning, XAIResponsesReasoningEffort, XAIResponsesReasoningResponse, XAIResponsesReasoningSummary, XAIResponsesReasoningSummaryItem, XAIResponsesSearchMode, XAIResponsesSearchParameters, XAIResponsesSearchSource, XAIResponsesSearchSourceRss, XAIResponsesSearchSourceWeb, XAIResponsesSearchSourceX, XAIResponsesStatus, XAIResponsesStreamEvent, XAIResponsesStreamEventBase, XAIResponsesStreamEventCompleted, XAIResponsesStreamEventContentPartAdded, XAIResponsesStreamEventContentPartDone, XAIResponsesStreamEventCreated, XAIResponsesStreamEventError, XAIResponsesStreamEventFailed, XAIResponsesStreamEventFunctionCallArgumentsDelta, XAIResponsesStreamEventFunctionCallArgumentsDone, XAIResponsesStreamEventInProgress, XAIResponsesStreamEventIncomplete, XAIResponsesStreamEventOutputItemAdded, XAIResponsesStreamEventOutputItemDone, XAIResponsesStreamEventReasoningSummaryTextDelta, XAIResponsesStreamEventReasoningSummaryTextDone, XAIResponsesStreamEventTextDelta, XAIResponsesStreamEventTextDone, XAIResponsesText, XAIResponsesTextFormat, XAIResponsesTextFormatJsonObject, XAIResponsesTextFormatJsonSchema, XAIResponsesTextFormatText, XAIResponsesTool, XAIResponsesToolCall, XAIResponsesToolChoice, XAIResponsesToolChoiceFunction, XAIResponsesToolChoiceString, XAIResponsesToolOutput, XAIResponsesUrlCitationAnnotation, XAIResponsesUsage, XAIResponsesWebSearchTool, XAIResponsesWebSearchToolCall, XAIResponsesXSearchTool, isXAIBuiltInTool, tools };

package/dist/node_modules/@langchain/xai/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { ChatXAI, ChatXAICallOptions, ChatXAICompletionsInvocationParams, ChatXAIInput, OpenAIToolChoice, XAIAdditionalKwargs, XAIBuiltInTool, XAIResponseMetadata, isXAIBuiltInTool } from "./chat_models/completions.js";
+import { ChatXAIResponsesCallOptions, ChatXAIResponsesInput, ChatXAIResponsesInvocationParams, XAIResponse, XAIResponsesAnnotation, XAIResponsesCodeInterpreterResult, XAIResponsesCodeInterpreterTool, XAIResponsesCodeInterpreterToolCall, XAIResponsesCreateParams, XAIResponsesCreateParamsNonStreaming, XAIResponsesCreateParamsStreaming, XAIResponsesDebugOutput, XAIResponsesFileCitationAnnotation, XAIResponsesFileSearchResult, XAIResponsesFileSearchTool, XAIResponsesFunctionTool, XAIResponsesFunctionToolCall, XAIResponsesFunctionToolFunction, XAIResponsesFunctionToolOutput, XAIResponsesInclude, XAIResponsesIncompleteDetails, XAIResponsesIncompleteReason, XAIResponsesInput, XAIResponsesInputContentItem, XAIResponsesInputFileItem, XAIResponsesInputImageItem, XAIResponsesInputItem, XAIResponsesInputTextItem, XAIResponsesLogprobContent, XAIResponsesLogprobToken, XAIResponsesLogprobs, XAIResponsesMcpTool, XAIResponsesMcpToolCall, XAIResponsesMessage, XAIResponsesMessageRole, XAIResponsesObjectType, XAIResponsesOutputCodeInterpreterCall, XAIResponsesOutputContent, XAIResponsesOutputFileSearchCall, XAIResponsesOutputFunctionCall, XAIResponsesOutputItem, XAIResponsesOutputMcpCall, XAIResponsesOutputReasoning, XAIResponsesOutputRefusalContent, XAIResponsesOutputTextContent, XAIResponsesOutputTextItem, XAIResponsesOutputWebSearchCall, XAIResponsesPreviousResponse, XAIResponsesReasoning, XAIResponsesReasoningEffort, XAIResponsesReasoningResponse, XAIResponsesReasoningSummary, XAIResponsesReasoningSummaryItem, XAIResponsesSearchMode, XAIResponsesSearchParameters, XAIResponsesSearchSource, XAIResponsesSearchSourceRss, XAIResponsesSearchSourceWeb, XAIResponsesSearchSourceX, XAIResponsesStatus, XAIResponsesStreamEvent, XAIResponsesStreamEventBase, XAIResponsesStreamEventCompleted, XAIResponsesStreamEventContentPartAdded, XAIResponsesStreamEventContentPartDone, XAIResponsesStreamEventCreated, XAIResponsesStreamEventError, XAIResponsesStreamEventFailed, XAIResponsesStreamEventFunctionCallArgumentsDelta, XAIResponsesStreamEventFunctionCallArgumentsDone, XAIResponsesStreamEventInProgress, XAIResponsesStreamEventIncomplete, XAIResponsesStreamEventOutputItemAdded, XAIResponsesStreamEventOutputItemDone, XAIResponsesStreamEventReasoningSummaryTextDelta, XAIResponsesStreamEventReasoningSummaryTextDone, XAIResponsesStreamEventTextDelta, XAIResponsesStreamEventTextDone, XAIResponsesText, XAIResponsesTextFormat, XAIResponsesTextFormatJsonObject, XAIResponsesTextFormatJsonSchema, XAIResponsesTextFormatText, XAIResponsesTool, XAIResponsesToolCall, XAIResponsesToolChoice, XAIResponsesToolChoiceFunction, XAIResponsesToolChoiceString, XAIResponsesToolOutput, XAIResponsesUrlCitationAnnotation, XAIResponsesUsage, XAIResponsesWebSearchTool, XAIResponsesWebSearchToolCall, XAIResponsesXSearchTool } from "./chat_models/responses-types.js";
+import { ChatXAIResponses } from "./chat_models/responses.js";
+import "./chat_models/index.js";
+import { tools } from "./tools/index.js";
+export { ChatXAI, ChatXAICallOptions, ChatXAICompletionsInvocationParams, ChatXAIInput, ChatXAIResponses, ChatXAIResponsesCallOptions, ChatXAIResponsesInput, ChatXAIResponsesInvocationParams, OpenAIToolChoice, XAIAdditionalKwargs, XAIBuiltInTool, XAIResponse, XAIResponseMetadata, XAIResponsesAnnotation, XAIResponsesCodeInterpreterResult, XAIResponsesCodeInterpreterTool, XAIResponsesCodeInterpreterToolCall, XAIResponsesCreateParams, XAIResponsesCreateParamsNonStreaming, XAIResponsesCreateParamsStreaming, XAIResponsesDebugOutput, XAIResponsesFileCitationAnnotation, XAIResponsesFileSearchResult, XAIResponsesFileSearchTool, XAIResponsesFunctionTool, XAIResponsesFunctionToolCall, XAIResponsesFunctionToolFunction, XAIResponsesFunctionToolOutput, XAIResponsesInclude, XAIResponsesIncompleteDetails, XAIResponsesIncompleteReason, XAIResponsesInput, XAIResponsesInputContentItem, XAIResponsesInputFileItem, XAIResponsesInputImageItem, XAIResponsesInputItem, XAIResponsesInputTextItem, XAIResponsesLogprobContent, XAIResponsesLogprobToken, XAIResponsesLogprobs, XAIResponsesMcpTool, XAIResponsesMcpToolCall, XAIResponsesMessage, XAIResponsesMessageRole, XAIResponsesObjectType, XAIResponsesOutputCodeInterpreterCall, XAIResponsesOutputContent, XAIResponsesOutputFileSearchCall, XAIResponsesOutputFunctionCall, XAIResponsesOutputItem, XAIResponsesOutputMcpCall, XAIResponsesOutputReasoning, XAIResponsesOutputRefusalContent, XAIResponsesOutputTextContent, XAIResponsesOutputTextItem, XAIResponsesOutputWebSearchCall, XAIResponsesPreviousResponse, XAIResponsesReasoning, XAIResponsesReasoningEffort, XAIResponsesReasoningResponse, XAIResponsesReasoningSummary, XAIResponsesReasoningSummaryItem, XAIResponsesSearchMode, XAIResponsesSearchParameters, XAIResponsesSearchSource, XAIResponsesSearchSourceRss, XAIResponsesSearchSourceWeb, XAIResponsesSearchSourceX, XAIResponsesStatus, XAIResponsesStreamEvent, XAIResponsesStreamEventBase, XAIResponsesStreamEventCompleted, XAIResponsesStreamEventContentPartAdded, XAIResponsesStreamEventContentPartDone, XAIResponsesStreamEventCreated, XAIResponsesStreamEventError, XAIResponsesStreamEventFailed, XAIResponsesStreamEventFunctionCallArgumentsDelta, XAIResponsesStreamEventFunctionCallArgumentsDone, XAIResponsesStreamEventInProgress, XAIResponsesStreamEventIncomplete, XAIResponsesStreamEventOutputItemAdded, XAIResponsesStreamEventOutputItemDone, XAIResponsesStreamEventReasoningSummaryTextDelta, XAIResponsesStreamEventReasoningSummaryTextDone, XAIResponsesStreamEventTextDelta, XAIResponsesStreamEventTextDone, XAIResponsesText, XAIResponsesTextFormat, XAIResponsesTextFormatJsonObject, XAIResponsesTextFormatJsonSchema, XAIResponsesTextFormatText, XAIResponsesTool, XAIResponsesToolCall, XAIResponsesToolChoice, XAIResponsesToolChoiceFunction, XAIResponsesToolChoiceString, XAIResponsesToolOutput, XAIResponsesUrlCitationAnnotation, XAIResponsesUsage, XAIResponsesWebSearchTool, XAIResponsesWebSearchToolCall, XAIResponsesXSearchTool, isXAIBuiltInTool, tools };

package/dist/node_modules/@langchain/xai/dist/index.js

@@ -0,0 +1,6 @@
+import { ChatXAI, isXAIBuiltInTool } from "./chat_models/completions.js";
+import { ChatXAIResponses } from "./chat_models/responses.js";
+import "./chat_models/index.js";
+import { tools } from "./tools/index.js";
+
+export { ChatXAI, ChatXAIResponses, isXAIBuiltInTool, tools };

package/dist/node_modules/@langchain/xai/dist/live_search.cjs

@@ -0,0 +1,54 @@
+
+//#region src/live_search.ts
+/**
+* Merge search parameters from instance defaults, tool definition
+* and per-call overrides.
+*
+* Precedence (lowest → highest):
+*   1. tool-level configuration (e.g. from xaiLiveSearch)
+*   2. instance-level defaults
+*   3. per-call overrides passed via `searchParameters`
+*/
+function mergeSearchParams(instanceParams, callParams, toolParams) {
+	if (!instanceParams && !callParams && !toolParams) return void 0;
+	return {
+		...toolParams ?? {},
+		...instanceParams ?? {},
+		...callParams ?? {}
+	};
+}
+/**
+* Build the `search_parameters` payload to send to the xAI API
+* from high-level `XAISearchParameters`.
+*/
+function buildSearchParametersPayload(params) {
+	if (!params) return void 0;
+	const payload = { mode: params.mode ?? "auto" };
+	if (params.max_search_results !== void 0) payload.max_search_results = params.max_search_results;
+	if (params.from_date !== void 0) payload.from_date = params.from_date;
+	if (params.to_date !== void 0) payload.to_date = params.to_date;
+	if (params.return_citations !== void 0) payload.return_citations = params.return_citations;
+	if (params.sources && params.sources.length > 0) payload.sources = params.sources;
+	return payload;
+}
+/**
+* Filter out xAI built-in tools (like `live_search`) from a tools array.
+* Used before sending the request to the xAI API, since built-in tools
+* are controlled via `search_parameters` instead.
+*/
+function filterXAIBuiltInTools(payload) {
+	if (!payload?.tools) return void 0;
+	const filtered = payload.tools.filter((tool) => {
+		if (tool == null || typeof tool !== "object") return true;
+		if (!("type" in tool)) return true;
+		if (!payload?.excludedTypes?.length) return true;
+		return !payload.excludedTypes.includes(tool.type);
+	});
+	return filtered.length > 0 ? filtered : void 0;
+}
+
+//#endregion
+exports.buildSearchParametersPayload = buildSearchParametersPayload;
+exports.filterXAIBuiltInTools = filterXAIBuiltInTools;
+exports.mergeSearchParams = mergeSearchParams;
+//# sourceMappingURL=live_search.cjs.map

package/dist/node_modules/@langchain/xai/dist/live_search.d.cts

@@ -0,0 +1,145 @@
+//#region src/live_search.d.ts
+/**
+ * Web search source configuration for xAI Live Search.
+ * Corresponds to a `{"type": "web", ...}` entry in `search_parameters.sources`.
+ */
+interface XAIWebSource {
+  type: "web";
+  /**
+   * Optional ISO alpha-2 country code used to bias results
+   * towards a specific country/region.
+   */
+  country?: string;
+  /**
+   * Websites that should be excluded from the search results.
+   * Maximum of 5 entries.
+   */
+  excluded_websites?: string[];
+  /**
+   * Websites that should be exclusively included in the search results.
+   * Maximum of 5 entries.
+   */
+  allowed_websites?: string[];
+  /**
+   * Whether to enable safe search filtering for this source.
+   */
+  safe_search?: boolean;
+}
+/**
+ * News search source configuration for xAI Live Search.
+ * Corresponds to a `{"type": "news", ...}` entry in `search_parameters.sources`.
+ */
+interface XAINewsSource {
+  type: "news";
+  /**
+   * Optional ISO alpha-2 country code used to bias results
+   * towards a specific country/region.
+   */
+  country?: string;
+  /**
+   * Websites that should be excluded from the search results.
+   * Maximum of 5 entries.
+   */
+  excluded_websites?: string[];
+  /**
+   * Whether to enable safe search filtering for this source.
+   */
+  safe_search?: boolean;
+}
+/**
+ * X (formerly Twitter) search source configuration for xAI Live Search.
+ * Corresponds to a `{"type": "x", ...}` entry in `search_parameters.sources`.
+ */
+interface XAIXSource {
+  type: "x";
+  /**
+   * X handles that should be explicitly included in the search.
+   * Maximum of 10 entries.
+   */
+  included_x_handles?: string[];
+  /**
+   * X handles that should be excluded from the search.
+   * Maximum of 10 entries.
+   */
+  excluded_x_handles?: string[];
+  /**
+   * Minimum number of favorites a post must have to be included.
+   */
+  post_favorite_count?: number;
+  /**
+   * Minimum number of views a post must have to be included.
+   */
+  post_view_count?: number;
+}
+/**
+ * RSS feed search source configuration for xAI Live Search.
+ * Corresponds to a `{"type": "rss", ...}` entry in `search_parameters.sources`.
+ */
+interface XAIRssSource {
+  type: "rss";
+  /**
+   * Links to RSS feeds to be used as a data source.
+   * The API currently expects a single URL.
+   */
+  links: string[];
+}
+type XAISearchSource = XAIWebSource | XAINewsSource | XAIXSource | XAIRssSource;
+/**
+ * Search parameters for xAI's Live Search API.
+ * Controls how the model searches for and retrieves real-time information.
+ *
+ * @note The Live Search API is being deprecated by xAI in favor of
+ * the agentic tool calling approach. Consider using `tools: [{ type: "live_search" }]`
+ * for future compatibility.
+ */
+interface XAISearchParameters {
+  /**
+   * Controls when the model should perform a search.
+   * - "auto": Let the model decide when to search (default)
+   * - "on": Always search for every request
+   * - "off": Never search
+   */
+  mode?: "auto" | "on" | "off";
+  /**
+   * Maximum number of search results to return.
+   * @default 20
+   */
+  max_search_results?: number;
+  /**
+   * Filter search results to only include content from after this date.
+   * Format: ISO 8601 date string (e.g., "2024-01-01")
+   */
+  from_date?: string;
+  /**
+   * Filter search results to only include content from before this date.
+   * Format: ISO 8601 date string (e.g., "2024-12-31")
+   */
+  to_date?: string;
+  /**
+   * Whether to return citations/sources for the search results.
+   * @default true
+   */
+  return_citations?: boolean;
+  /**
+   * Specific web/news/X/RSS sources that can be used for the search.
+   * Each entry corresponds to a `{"type": "...", ...}` object in
+   * `search_parameters.sources` as documented in the xAI Live Search docs.
+   *
+   * If omitted, xAI will default to enabling `web`, `news` and `x` sources.
+   */
+  sources?: XAISearchSource[];
+}
+/**
+ * Concrete payload shape sent as `search_parameters` to the xAI API.
+ */
+interface XAISearchParametersPayload {
+  mode: "auto" | "on" | "off";
+  max_search_results?: number;
+  from_date?: string;
+  to_date?: string;
+  return_citations?: boolean;
+  sources?: XAISearchSource[];
+}
+//#endregion
+export { XAISearchParameters, XAISearchParametersPayload };
+//# sourceMappingURL=live_search.d.cts.map

package/dist/node_modules/@langchain/xai/dist/live_search.d.ts

@@ -0,0 +1,145 @@
+//#region src/live_search.d.ts
+/**
+ * Web search source configuration for xAI Live Search.
+ * Corresponds to a `{"type": "web", ...}` entry in `search_parameters.sources`.
+ */
+interface XAIWebSource {
+  type: "web";
+  /**
+   * Optional ISO alpha-2 country code used to bias results
+   * towards a specific country/region.
+   */
+  country?: string;
+  /**
+   * Websites that should be excluded from the search results.
+   * Maximum of 5 entries.
+   */
+  excluded_websites?: string[];
+  /**
+   * Websites that should be exclusively included in the search results.
+   * Maximum of 5 entries.
+   */
+  allowed_websites?: string[];
+  /**
+   * Whether to enable safe search filtering for this source.
+   */
+  safe_search?: boolean;
+}
+/**
+ * News search source configuration for xAI Live Search.
+ * Corresponds to a `{"type": "news", ...}` entry in `search_parameters.sources`.
+ */
+interface XAINewsSource {
+  type: "news";
+  /**
+   * Optional ISO alpha-2 country code used to bias results
+   * towards a specific country/region.
+   */
+  country?: string;
+  /**
+   * Websites that should be excluded from the search results.
+   * Maximum of 5 entries.
+   */
+  excluded_websites?: string[];
+  /**
+   * Whether to enable safe search filtering for this source.
+   */
+  safe_search?: boolean;
+}
+/**
+ * X (formerly Twitter) search source configuration for xAI Live Search.
+ * Corresponds to a `{"type": "x", ...}` entry in `search_parameters.sources`.
+ */
+interface XAIXSource {
+  type: "x";
+  /**
+   * X handles that should be explicitly included in the search.
+   * Maximum of 10 entries.
+   */
+  included_x_handles?: string[];
+  /**
+   * X handles that should be excluded from the search.
+   * Maximum of 10 entries.
+   */
+  excluded_x_handles?: string[];
+  /**
+   * Minimum number of favorites a post must have to be included.
+   */
+  post_favorite_count?: number;
+  /**
+   * Minimum number of views a post must have to be included.
+   */
+  post_view_count?: number;
+}
+/**
+ * RSS feed search source configuration for xAI Live Search.
+ * Corresponds to a `{"type": "rss", ...}` entry in `search_parameters.sources`.
+ */
+interface XAIRssSource {
+  type: "rss";
+  /**
+   * Links to RSS feeds to be used as a data source.
+   * The API currently expects a single URL.
+   */
+  links: string[];
+}
+type XAISearchSource = XAIWebSource | XAINewsSource | XAIXSource | XAIRssSource;
+/**
+ * Search parameters for xAI's Live Search API.
+ * Controls how the model searches for and retrieves real-time information.
+ *
+ * @note The Live Search API is being deprecated by xAI in favor of
+ * the agentic tool calling approach. Consider using `tools: [{ type: "live_search" }]`
+ * for future compatibility.
+ */
+interface XAISearchParameters {
+  /**
+   * Controls when the model should perform a search.
+   * - "auto": Let the model decide when to search (default)
+   * - "on": Always search for every request
+   * - "off": Never search
+   */
+  mode?: "auto" | "on" | "off";
+  /**
+   * Maximum number of search results to return.
+   * @default 20
+   */
+  max_search_results?: number;
+  /**
+   * Filter search results to only include content from after this date.
+   * Format: ISO 8601 date string (e.g., "2024-01-01")
+   */
+  from_date?: string;
+  /**
+   * Filter search results to only include content from before this date.
+   * Format: ISO 8601 date string (e.g., "2024-12-31")
+   */
+  to_date?: string;
+  /**
+   * Whether to return citations/sources for the search results.
+   * @default true
+   */
+  return_citations?: boolean;
+  /**
+   * Specific web/news/X/RSS sources that can be used for the search.
+   * Each entry corresponds to a `{"type": "...", ...}` object in
+   * `search_parameters.sources` as documented in the xAI Live Search docs.
+   *
+   * If omitted, xAI will default to enabling `web`, `news` and `x` sources.
+   */
+  sources?: XAISearchSource[];
+}
+/**
+ * Concrete payload shape sent as `search_parameters` to the xAI API.
+ */
+interface XAISearchParametersPayload {
+  mode: "auto" | "on" | "off";
+  max_search_results?: number;
+  from_date?: string;
+  to_date?: string;
+  return_citations?: boolean;
+  sources?: XAISearchSource[];
+}
+//#endregion
+export { XAISearchParameters, XAISearchParametersPayload };
+//# sourceMappingURL=live_search.d.ts.map

package/dist/node_modules/@langchain/xai/dist/live_search.js

@@ -0,0 +1,51 @@
+//#region src/live_search.ts
+/**
+* Merge search parameters from instance defaults, tool definition
+* and per-call overrides.
+*
+* Precedence (lowest → highest):
+*   1. tool-level configuration (e.g. from xaiLiveSearch)
+*   2. instance-level defaults
+*   3. per-call overrides passed via `searchParameters`
+*/
+function mergeSearchParams(instanceParams, callParams, toolParams) {
+	if (!instanceParams && !callParams && !toolParams) return void 0;
+	return {
+		...toolParams ?? {},
+		...instanceParams ?? {},
+		...callParams ?? {}
+	};
+}
+/**
+* Build the `search_parameters` payload to send to the xAI API
+* from high-level `XAISearchParameters`.
+*/
+function buildSearchParametersPayload(params) {
+	if (!params) return void 0;
+	const payload = { mode: params.mode ?? "auto" };
+	if (params.max_search_results !== void 0) payload.max_search_results = params.max_search_results;
+	if (params.from_date !== void 0) payload.from_date = params.from_date;
+	if (params.to_date !== void 0) payload.to_date = params.to_date;
+	if (params.return_citations !== void 0) payload.return_citations = params.return_citations;
+	if (params.sources && params.sources.length > 0) payload.sources = params.sources;
+	return payload;
+}
+/**
+* Filter out xAI built-in tools (like `live_search`) from a tools array.
+* Used before sending the request to the xAI API, since built-in tools
+* are controlled via `search_parameters` instead.
+*/
+function filterXAIBuiltInTools(payload) {
+	if (!payload?.tools) return void 0;
+	const filtered = payload.tools.filter((tool) => {
+		if (tool == null || typeof tool !== "object") return true;
+		if (!("type" in tool)) return true;
+		if (!payload?.excludedTypes?.length) return true;
+		return !payload.excludedTypes.includes(tool.type);
+	});
+	return filtered.length > 0 ? filtered : void 0;
+}
+
+//#endregion
+export { buildSearchParametersPayload, filterXAIBuiltInTools, mergeSearchParams };
+//# sourceMappingURL=live_search.js.map