@omnicross/core 0.1.0 → 0.1.1

package/dist/completion/NativeSearchInjector.cjs

@@ -0,0 +1,196 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/completion/NativeSearchInjector.ts
+var NativeSearchInjector_exports = {};
+__export(NativeSearchInjector_exports, {
+  applyAugmentation: () => applyAugmentation,
+  buildNativeSearchAugmentation: () => buildNativeSearchAugmentation,
+  detectNativeSearch: () => detectNativeSearch
+});
+module.exports = __toCommonJS(NativeSearchInjector_exports);
+
+// src/openrouter.ts
+function isOpenRouterProvider(provider) {
+  const baseUrl = (provider.api_base_url || "").toLowerCase();
+  return baseUrl.includes("openrouter.ai");
+}
+
+// src/completion/native-search-types.ts
+var NATIVE_SEARCH_MODEL_PATTERNS = {
+  openai: [/^gpt-4/, /^o[134]/, /^gpt-5/],
+  // Claude 3.x: claude-3-opus-*, claude-3-5-sonnet-*, etc.
+  // Claude 4.x: claude-sonnet-4-*, claude-opus-4-*, claude-haiku-4-*, etc.
+  anthropic: [/^claude-/],
+  google: [/^gemini-(?:2|3|flash|pro)/],
+  xai: [/^grok/],
+  openrouter: []
+  // Detected via provider, not model pattern
+};
+var OPENAI_CHAT_COMPLETION_SEARCH_MODELS = [
+  "gpt-4o-search-preview",
+  "gpt-4o-mini-search-preview",
+  "gpt-5-search-api"
+];
+var NATIVE_SEARCH_EXCLUDED_MODELS = [
+  "gpt-4.1-nano"
+];
+var API_FORMAT_PROVIDER_MAP = {
+  "openai-response": "openai",
+  anthropic: "anthropic",
+  google: "google"
+};
+
+// src/completion/NativeSearchInjector.ts
+function detectNativeSearch(modelId, apiFormat, provider, userExplicit) {
+  if (isOpenRouterProvider(provider)) {
+    return { supported: true, nativeProvider: "openrouter" };
+  }
+  if (isXaiProvider(provider)) {
+    return { supported: true, nativeProvider: "xai" };
+  }
+  if (apiFormat === "openai" && OPENAI_CHAT_COMPLETION_SEARCH_MODELS.some((m) => modelId.startsWith(m))) {
+    return { supported: true, nativeProvider: "openai" };
+  }
+  const formatProvider = API_FORMAT_PROVIDER_MAP[apiFormat];
+  if (formatProvider) {
+    const patterns = NATIVE_SEARCH_MODEL_PATTERNS[formatProvider];
+    if (patterns.some((re) => re.test(modelId))) {
+      if (!NATIVE_SEARCH_EXCLUDED_MODELS.some((m) => modelId.startsWith(m))) {
+        return { supported: true, nativeProvider: formatProvider };
+      }
+    }
+  }
+  if (userExplicit && formatProvider) {
+    return { supported: true, nativeProvider: formatProvider };
+  }
+  return { supported: false, nativeProvider: null };
+}
+function buildNativeSearchAugmentation(nativeProvider, config, _apiFormat, modelId) {
+  if (!config.enabled) return null;
+  switch (nativeProvider) {
+    case "openai":
+      return buildOpenAIAugmentation(config, modelId);
+    case "anthropic":
+      return buildAnthropicAugmentation(config);
+    case "google":
+      return buildGoogleAugmentation(modelId);
+    case "xai":
+      return buildXaiAugmentation(config);
+    case "openrouter":
+      return buildOpenRouterAugmentation(config);
+    default:
+      return null;
+  }
+}
+function applyAugmentation(requestBody, augmentation) {
+  if (augmentation.additionalTools?.length) {
+    const existing = requestBody.tools ?? [];
+    requestBody.tools = [...existing, ...augmentation.additionalTools];
+  }
+  if (augmentation.bodyFields) {
+    Object.assign(requestBody, augmentation.bodyFields);
+  }
+  return requestBody;
+}
+function buildOpenAIAugmentation(config, modelId) {
+  const isChatCompletionSearch = OPENAI_CHAT_COMPLETION_SEARCH_MODELS.some(
+    (m) => modelId.startsWith(m)
+  );
+  if (isChatCompletionSearch) {
+    return {
+      bodyFields: {
+        web_search_options: {
+          search_context_size: config.maxResults ? mapMaxResultsToContextSize(config.maxResults) : "medium"
+        }
+      }
+    };
+  }
+  return {
+    additionalTools: [
+      {
+        type: "web_search",
+        web_search: {
+          search_context_size: config.maxResults ? mapMaxResultsToContextSize(config.maxResults) : "medium"
+        }
+      }
+    ]
+  };
+}
+function buildAnthropicAugmentation(config) {
+  const toolDef = {
+    type: "web_search_20250305",
+    name: "web_search"
+  };
+  if (config.maxResults) {
+    toolDef.max_uses = config.maxResults;
+  }
+  if (config.blockedDomains?.length) {
+    toolDef.blocked_domains = config.blockedDomains;
+  }
+  return { additionalTools: [toolDef] };
+}
+function buildGoogleAugmentation(modelId) {
+  const isLegacy = /gemini-1[._]/.test(modelId);
+  if (isLegacy) {
+    return {
+      additionalTools: [
+        { googleSearchRetrieval: {} }
+      ]
+    };
+  }
+  return {
+    additionalTools: [
+      { google_search: {} }
+    ]
+  };
+}
+function buildXaiAugmentation(config) {
+  const searchParams = {
+    mode: config.searchMode ?? "auto",
+    return_citations: true,
+    max_search_results: config.maxResults ?? 5
+  };
+  if (config.sources?.length) {
+    searchParams.sources = config.sources;
+  }
+  return { bodyFields: { search_parameters: searchParams } };
+}
+function buildOpenRouterAugmentation(config) {
+  const plugin = { id: "web" };
+  if (config.maxResults) {
+    plugin.max_results = config.maxResults;
+  }
+  return { bodyFields: { plugins: [plugin] } };
+}
+function isXaiProvider(provider) {
+  const baseUrl = (provider.api_base_url || "").toLowerCase();
+  return baseUrl.includes("x.ai") || baseUrl.includes("xai.com");
+}
+function mapMaxResultsToContextSize(maxResults) {
+  if (maxResults <= 2) return "low";
+  if (maxResults <= 5) return "medium";
+  return "high";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  applyAugmentation,
+  buildNativeSearchAugmentation,
+  detectNativeSearch
+});

package/dist/completion/NativeSearchInjector.d.cts

@@ -0,0 +1,42 @@
+import { LLMProvider } from '@omnicross/contracts/llm-config';
+import { b as NativeSearchAugmentation, d as NativeSearchProvider, e as NativeSearchUserConfig, A as ApiFormat, c as NativeSearchDetectionResult } from '../types-BScIHmPr.cjs';
+import '@omnicross/contracts/message-blocks';
+import '@omnicross/contracts/completion-types';
+
+/**
+ * Native Search Injector
+ *
+ * Detects provider-native web search support and builds request body
+ * augmentations for OpenAI, Anthropic, Google, xAI, and OpenRouter.
+ *
+ * This module does NOT execute searches — it only prepares the request
+ * so the LLM provider's server-side search runs automatically.
+ *
+ * @module completion/NativeSearchInjector
+ */
+
+/**
+ * Detect whether a model supports provider-native web search.
+ *
+ * Detection order:
+ * 1. OpenRouter — detected by provider base URL, not model pattern.
+ * 2. xAI — detected by base URL containing `x.ai` or `grok`.
+ * 3. Model-pattern match against known providers (OpenAI, Anthropic, Google).
+ * 4. If `userExplicit` is true, fall back to API format mapping even
+ *    when the model ID doesn't match known patterns (user opted-in).
+ */
+declare function detectNativeSearch(modelId: string, apiFormat: ApiFormat, provider: LLMProvider, userExplicit?: boolean): NativeSearchDetectionResult;
+/**
+ * Build a {@link NativeSearchAugmentation} for the given provider.
+ * Returns `null` if the provider is unknown or config is disabled.
+ */
+declare function buildNativeSearchAugmentation(nativeProvider: NativeSearchProvider, config: NativeSearchUserConfig, _apiFormat: ApiFormat, modelId: string): NativeSearchAugmentation | null;
+/**
+ * Merge an augmentation into the request body **in-place**.
+ *
+ * - `additionalTools` are appended to the existing `tools` array.
+ * - `bodyFields` are shallow-merged into the top-level body.
+ */
+declare function applyAugmentation(requestBody: Record<string, unknown>, augmentation: NativeSearchAugmentation): Record<string, unknown>;
+
+export { applyAugmentation, buildNativeSearchAugmentation, detectNativeSearch };

package/dist/completion/NativeSearchInjector.d.ts

@@ -0,0 +1,42 @@
+import { LLMProvider } from '@omnicross/contracts/llm-config';
+import { b as NativeSearchAugmentation, d as NativeSearchProvider, e as NativeSearchUserConfig, A as ApiFormat, c as NativeSearchDetectionResult } from '../types-BScIHmPr.js';
+import '@omnicross/contracts/message-blocks';
+import '@omnicross/contracts/completion-types';
+
+/**
+ * Native Search Injector
+ *
+ * Detects provider-native web search support and builds request body
+ * augmentations for OpenAI, Anthropic, Google, xAI, and OpenRouter.
+ *
+ * This module does NOT execute searches — it only prepares the request
+ * so the LLM provider's server-side search runs automatically.
+ *
+ * @module completion/NativeSearchInjector
+ */
+
+/**
+ * Detect whether a model supports provider-native web search.
+ *
+ * Detection order:
+ * 1. OpenRouter — detected by provider base URL, not model pattern.
+ * 2. xAI — detected by base URL containing `x.ai` or `grok`.
+ * 3. Model-pattern match against known providers (OpenAI, Anthropic, Google).
+ * 4. If `userExplicit` is true, fall back to API format mapping even
+ *    when the model ID doesn't match known patterns (user opted-in).
+ */
+declare function detectNativeSearch(modelId: string, apiFormat: ApiFormat, provider: LLMProvider, userExplicit?: boolean): NativeSearchDetectionResult;
+/**
+ * Build a {@link NativeSearchAugmentation} for the given provider.
+ * Returns `null` if the provider is unknown or config is disabled.
+ */
+declare function buildNativeSearchAugmentation(nativeProvider: NativeSearchProvider, config: NativeSearchUserConfig, _apiFormat: ApiFormat, modelId: string): NativeSearchAugmentation | null;
+/**
+ * Merge an augmentation into the request body **in-place**.
+ *
+ * - `additionalTools` are appended to the existing `tools` array.
+ * - `bodyFields` are shallow-merged into the top-level body.
+ */
+declare function applyAugmentation(requestBody: Record<string, unknown>, augmentation: NativeSearchAugmentation): Record<string, unknown>;
+
+export { applyAugmentation, buildNativeSearchAugmentation, detectNativeSearch };

package/dist/completion/NativeSearchInjector.js

@@ -0,0 +1,167 @@
+// src/openrouter.ts
+function isOpenRouterProvider(provider) {
+  const baseUrl = (provider.api_base_url || "").toLowerCase();
+  return baseUrl.includes("openrouter.ai");
+}
+
+// src/completion/native-search-types.ts
+var NATIVE_SEARCH_MODEL_PATTERNS = {
+  openai: [/^gpt-4/, /^o[134]/, /^gpt-5/],
+  // Claude 3.x: claude-3-opus-*, claude-3-5-sonnet-*, etc.
+  // Claude 4.x: claude-sonnet-4-*, claude-opus-4-*, claude-haiku-4-*, etc.
+  anthropic: [/^claude-/],
+  google: [/^gemini-(?:2|3|flash|pro)/],
+  xai: [/^grok/],
+  openrouter: []
+  // Detected via provider, not model pattern
+};
+var OPENAI_CHAT_COMPLETION_SEARCH_MODELS = [
+  "gpt-4o-search-preview",
+  "gpt-4o-mini-search-preview",
+  "gpt-5-search-api"
+];
+var NATIVE_SEARCH_EXCLUDED_MODELS = [
+  "gpt-4.1-nano"
+];
+var API_FORMAT_PROVIDER_MAP = {
+  "openai-response": "openai",
+  anthropic: "anthropic",
+  google: "google"
+};
+
+// src/completion/NativeSearchInjector.ts
+function detectNativeSearch(modelId, apiFormat, provider, userExplicit) {
+  if (isOpenRouterProvider(provider)) {
+    return { supported: true, nativeProvider: "openrouter" };
+  }
+  if (isXaiProvider(provider)) {
+    return { supported: true, nativeProvider: "xai" };
+  }
+  if (apiFormat === "openai" && OPENAI_CHAT_COMPLETION_SEARCH_MODELS.some((m) => modelId.startsWith(m))) {
+    return { supported: true, nativeProvider: "openai" };
+  }
+  const formatProvider = API_FORMAT_PROVIDER_MAP[apiFormat];
+  if (formatProvider) {
+    const patterns = NATIVE_SEARCH_MODEL_PATTERNS[formatProvider];
+    if (patterns.some((re) => re.test(modelId))) {
+      if (!NATIVE_SEARCH_EXCLUDED_MODELS.some((m) => modelId.startsWith(m))) {
+        return { supported: true, nativeProvider: formatProvider };
+      }
+    }
+  }
+  if (userExplicit && formatProvider) {
+    return { supported: true, nativeProvider: formatProvider };
+  }
+  return { supported: false, nativeProvider: null };
+}
+function buildNativeSearchAugmentation(nativeProvider, config, _apiFormat, modelId) {
+  if (!config.enabled) return null;
+  switch (nativeProvider) {
+    case "openai":
+      return buildOpenAIAugmentation(config, modelId);
+    case "anthropic":
+      return buildAnthropicAugmentation(config);
+    case "google":
+      return buildGoogleAugmentation(modelId);
+    case "xai":
+      return buildXaiAugmentation(config);
+    case "openrouter":
+      return buildOpenRouterAugmentation(config);
+    default:
+      return null;
+  }
+}
+function applyAugmentation(requestBody, augmentation) {
+  if (augmentation.additionalTools?.length) {
+    const existing = requestBody.tools ?? [];
+    requestBody.tools = [...existing, ...augmentation.additionalTools];
+  }
+  if (augmentation.bodyFields) {
+    Object.assign(requestBody, augmentation.bodyFields);
+  }
+  return requestBody;
+}
+function buildOpenAIAugmentation(config, modelId) {
+  const isChatCompletionSearch = OPENAI_CHAT_COMPLETION_SEARCH_MODELS.some(
+    (m) => modelId.startsWith(m)
+  );
+  if (isChatCompletionSearch) {
+    return {
+      bodyFields: {
+        web_search_options: {
+          search_context_size: config.maxResults ? mapMaxResultsToContextSize(config.maxResults) : "medium"
+        }
+      }
+    };
+  }
+  return {
+    additionalTools: [
+      {
+        type: "web_search",
+        web_search: {
+          search_context_size: config.maxResults ? mapMaxResultsToContextSize(config.maxResults) : "medium"
+        }
+      }
+    ]
+  };
+}
+function buildAnthropicAugmentation(config) {
+  const toolDef = {
+    type: "web_search_20250305",
+    name: "web_search"
+  };
+  if (config.maxResults) {
+    toolDef.max_uses = config.maxResults;
+  }
+  if (config.blockedDomains?.length) {
+    toolDef.blocked_domains = config.blockedDomains;
+  }
+  return { additionalTools: [toolDef] };
+}
+function buildGoogleAugmentation(modelId) {
+  const isLegacy = /gemini-1[._]/.test(modelId);
+  if (isLegacy) {
+    return {
+      additionalTools: [
+        { googleSearchRetrieval: {} }
+      ]
+    };
+  }
+  return {
+    additionalTools: [
+      { google_search: {} }
+    ]
+  };
+}
+function buildXaiAugmentation(config) {
+  const searchParams = {
+    mode: config.searchMode ?? "auto",
+    return_citations: true,
+    max_search_results: config.maxResults ?? 5
+  };
+  if (config.sources?.length) {
+    searchParams.sources = config.sources;
+  }
+  return { bodyFields: { search_parameters: searchParams } };
+}
+function buildOpenRouterAugmentation(config) {
+  const plugin = { id: "web" };
+  if (config.maxResults) {
+    plugin.max_results = config.maxResults;
+  }
+  return { bodyFields: { plugins: [plugin] } };
+}
+function isXaiProvider(provider) {
+  const baseUrl = (provider.api_base_url || "").toLowerCase();
+  return baseUrl.includes("x.ai") || baseUrl.includes("xai.com");
+}
+function mapMaxResultsToContextSize(maxResults) {
+  if (maxResults <= 2) return "low";
+  if (maxResults <= 5) return "medium";
+  return "high";
+}
+export {
+  applyAugmentation,
+  buildNativeSearchAugmentation,
+  detectNativeSearch
+};

package/dist/completion/ProviderSearchInjector.cjs

@@ -0,0 +1,87 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/completion/ProviderSearchInjector.ts
+var ProviderSearchInjector_exports = {};
+__export(ProviderSearchInjector_exports, {
+  applyProviderSearchAugmentation: () => applyProviderSearchAugmentation,
+  buildProviderSearchAugmentation: () => buildProviderSearchAugmentation,
+  getSearchConfig: () => getSearchConfig
+});
+module.exports = __toCommonJS(ProviderSearchInjector_exports);
+var import_provider_presets = require("@omnicross/contracts/provider-presets");
+function getSearchConfig(provider) {
+  const presetId = provider.presetId || provider.id;
+  if (presetId in import_provider_presets.PROVIDER_SEARCH_CONFIGS) {
+    return import_provider_presets.PROVIDER_SEARCH_CONFIGS[presetId];
+  }
+  return null;
+}
+function buildProviderSearchAugmentation(provider, modelId, hasOtherTools) {
+  const config = getSearchConfig(provider);
+  if (!config) return null;
+  if (config.applicableModels && !config.applicableModels.includes(modelId)) {
+    return null;
+  }
+  switch (config.type) {
+    case "model-param": {
+      const bodyFields = {};
+      if (config.paramName) {
+        bodyFields[config.paramName] = config.paramValue ?? true;
+      }
+      if (config.extraParams) {
+        Object.assign(bodyFields, config.extraParams);
+      }
+      return { bodyFields };
+    }
+    case "builtin-tool": {
+      if (config.conflictsWithFC && hasOtherTools) {
+        return {
+          warning: `${provider.name} search conflicts with function calling. Search disabled for this request.`
+        };
+      }
+      if (config.toolDefinition) {
+        return { additionalTools: [config.toolDefinition] };
+      }
+      return null;
+    }
+    case "mcp":
+    case "sdk-native":
+    case "none":
+      return null;
+    default:
+      return null;
+  }
+}
+function applyProviderSearchAugmentation(requestBody, augmentation) {
+  if (augmentation.bodyFields) {
+    Object.assign(requestBody, augmentation.bodyFields);
+  }
+  if (augmentation.additionalTools?.length) {
+    const existing = requestBody.tools ?? [];
+    requestBody.tools = [...existing, ...augmentation.additionalTools];
+  }
+  return requestBody;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  applyProviderSearchAugmentation,
+  buildProviderSearchAugmentation,
+  getSearchConfig
+});

package/dist/completion/ProviderSearchInjector.d.cts

@@ -0,0 +1,47 @@
+import { LLMProvider } from '@omnicross/contracts/llm-config';
+import { ProviderSearchConfig } from '@omnicross/contracts/provider-presets';
+
+/**
+ * Provider Search Injector
+ *
+ * Handles provider-specific search parameter injection for Chinese cloud
+ * providers that don't use SDK-native search (which is handled by
+ * NativeSearchInjector).
+ *
+ * Supports:
+ * - model-param: Adds search parameters to request body (DashScope, Baidu)
+ * - builtin-tool: Adds provider-specific tool definitions (Kimi, Volcengine)
+ *
+ * MCP-based search is handled externally by the MCP tool system.
+ * SDK-native search is handled by NativeSearchInjector.
+ *
+ * @module completion/ProviderSearchInjector
+ */
+
+interface SearchAugmentation {
+    /** Parameters to merge into the request body */
+    bodyFields?: Record<string, unknown>;
+    /** Tool definitions to append to the tools array */
+    additionalTools?: unknown[];
+    /** Warning message if search has limitations */
+    warning?: string;
+}
+/**
+ * Get the search config for a provider.
+ */
+declare function getSearchConfig(provider: LLMProvider): ProviderSearchConfig | null;
+/**
+ * Build search augmentation for a provider request.
+ *
+ * @param provider The LLM provider
+ * @param modelId The model being used
+ * @param hasOtherTools Whether the request already has tool definitions (for FC conflict detection)
+ * @returns Search augmentation to apply, or null if no search is available
+ */
+declare function buildProviderSearchAugmentation(provider: LLMProvider, modelId: string, hasOtherTools: boolean): SearchAugmentation | null;
+/**
+ * Apply search augmentation to a request body.
+ */
+declare function applyProviderSearchAugmentation(requestBody: Record<string, unknown>, augmentation: SearchAugmentation): Record<string, unknown>;
+
+export { type SearchAugmentation, applyProviderSearchAugmentation, buildProviderSearchAugmentation, getSearchConfig };

package/dist/completion/ProviderSearchInjector.d.ts

@@ -0,0 +1,47 @@
+import { LLMProvider } from '@omnicross/contracts/llm-config';
+import { ProviderSearchConfig } from '@omnicross/contracts/provider-presets';
+
+/**
+ * Provider Search Injector
+ *
+ * Handles provider-specific search parameter injection for Chinese cloud
+ * providers that don't use SDK-native search (which is handled by
+ * NativeSearchInjector).
+ *
+ * Supports:
+ * - model-param: Adds search parameters to request body (DashScope, Baidu)
+ * - builtin-tool: Adds provider-specific tool definitions (Kimi, Volcengine)
+ *
+ * MCP-based search is handled externally by the MCP tool system.
+ * SDK-native search is handled by NativeSearchInjector.
+ *
+ * @module completion/ProviderSearchInjector
+ */
+
+interface SearchAugmentation {
+    /** Parameters to merge into the request body */
+    bodyFields?: Record<string, unknown>;
+    /** Tool definitions to append to the tools array */
+    additionalTools?: unknown[];
+    /** Warning message if search has limitations */
+    warning?: string;
+}
+/**
+ * Get the search config for a provider.
+ */
+declare function getSearchConfig(provider: LLMProvider): ProviderSearchConfig | null;
+/**
+ * Build search augmentation for a provider request.
+ *
+ * @param provider The LLM provider
+ * @param modelId The model being used
+ * @param hasOtherTools Whether the request already has tool definitions (for FC conflict detection)
+ * @returns Search augmentation to apply, or null if no search is available
+ */
+declare function buildProviderSearchAugmentation(provider: LLMProvider, modelId: string, hasOtherTools: boolean): SearchAugmentation | null;
+/**
+ * Apply search augmentation to a request body.
+ */
+declare function applyProviderSearchAugmentation(requestBody: Record<string, unknown>, augmentation: SearchAugmentation): Record<string, unknown>;
+
+export { type SearchAugmentation, applyProviderSearchAugmentation, buildProviderSearchAugmentation, getSearchConfig };

package/dist/completion/ProviderSearchInjector.js

@@ -0,0 +1,60 @@
+// src/completion/ProviderSearchInjector.ts
+import { PROVIDER_SEARCH_CONFIGS } from "@omnicross/contracts/provider-presets";
+function getSearchConfig(provider) {
+  const presetId = provider.presetId || provider.id;
+  if (presetId in PROVIDER_SEARCH_CONFIGS) {
+    return PROVIDER_SEARCH_CONFIGS[presetId];
+  }
+  return null;
+}
+function buildProviderSearchAugmentation(provider, modelId, hasOtherTools) {
+  const config = getSearchConfig(provider);
+  if (!config) return null;
+  if (config.applicableModels && !config.applicableModels.includes(modelId)) {
+    return null;
+  }
+  switch (config.type) {
+    case "model-param": {
+      const bodyFields = {};
+      if (config.paramName) {
+        bodyFields[config.paramName] = config.paramValue ?? true;
+      }
+      if (config.extraParams) {
+        Object.assign(bodyFields, config.extraParams);
+      }
+      return { bodyFields };
+    }
+    case "builtin-tool": {
+      if (config.conflictsWithFC && hasOtherTools) {
+        return {
+          warning: `${provider.name} search conflicts with function calling. Search disabled for this request.`
+        };
+      }
+      if (config.toolDefinition) {
+        return { additionalTools: [config.toolDefinition] };
+      }
+      return null;
+    }
+    case "mcp":
+    case "sdk-native":
+    case "none":
+      return null;
+    default:
+      return null;
+  }
+}
+function applyProviderSearchAugmentation(requestBody, augmentation) {
+  if (augmentation.bodyFields) {
+    Object.assign(requestBody, augmentation.bodyFields);
+  }
+  if (augmentation.additionalTools?.length) {
+    const existing = requestBody.tools ?? [];
+    requestBody.tools = [...existing, ...augmentation.additionalTools];
+  }
+  return requestBody;
+}
+export {
+  applyProviderSearchAugmentation,
+  buildProviderSearchAugmentation,
+  getSearchConfig
+};