@omnicross/core 0.1.0 → 0.1.1

package/dist/outbound-api/routeResolver.cjs

@@ -0,0 +1,221 @@
+"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/outbound-api/routeResolver.ts
+var routeResolver_exports = {};
+__export(routeResolver_exports, {
+  isSubscriptionProviderId: () => isSubscriptionProviderId,
+  parseModelRef: () => parseModelRef,
+  resolveRoute: () => resolveRoute
+});
+module.exports = __toCommonJS(routeResolver_exports);
+
+// src/outbound-api/subscriptionRegistryPort.ts
+var _registry = null;
+function getSubscriptionRegistryForOutbound() {
+  return _registry;
+}
+
+// src/outbound-api/subscriptionSupport.ts
+var SUBSCRIPTION_PROVIDER_IDS = [
+  "claude",
+  "codex",
+  "gemini",
+  "opencodego"
+];
+var SUBSCRIPTION_ID_SET = new Set(SUBSCRIPTION_PROVIDER_IDS);
+function isSubscriptionProviderId(providerId) {
+  if (SUBSCRIPTION_ID_SET.has(providerId)) return true;
+  const registry = getSubscriptionRegistryForOutbound();
+  return registry?.getProfile(providerId) != null;
+}
+var SUBSCRIPTION_SUPPORTED_ENDPOINTS = /* @__PURE__ */ new Set([
+  "messages",
+  "responses"
+]);
+function endpointSupportsSubscription(endpoint) {
+  return SUBSCRIPTION_SUPPORTED_ENDPOINTS.has(endpoint);
+}
+
+// src/outbound-api/routeResolver.ts
+function parseModelRef(ref) {
+  if (!ref) return null;
+  const idx = ref.indexOf(",");
+  if (idx <= 0) return null;
+  const providerId = ref.slice(0, idx).trim();
+  const modelId = ref.slice(idx + 1).trim();
+  if (!providerId || !modelId) return null;
+  return { providerId, modelId };
+}
+function pickModelRefForRole(config, role) {
+  if (role === "vision") {
+    if (config.visionModel && config.visionModel.trim()) {
+      return { ref: config.visionModel, effectiveRole: "vision" };
+    }
+    return { ref: config.defaultModel, effectiveRole: "default" };
+  }
+  if (role === "background") {
+    return { ref: config.backgroundModel, effectiveRole: "background" };
+  }
+  return { ref: config.defaultModel, effectiveRole: "default" };
+}
+async function resolveRoute(args) {
+  const { config, role, ingressFormat, llmConfig } = args;
+  const sessionId = args.sessionId ?? null;
+  const { ref, effectiveRole } = pickModelRefForRole(config, role);
+  if (!ref || !ref.trim()) {
+    return {
+      ok: false,
+      error: {
+        status: 503,
+        message: `endpoint '${config.endpoint}' has no ${effectiveRole} model configured`
+      }
+    };
+  }
+  const parsed = parseModelRef(ref);
+  if (!parsed) {
+    return {
+      ok: false,
+      error: {
+        status: 503,
+        message: `endpoint '${config.endpoint}' ${effectiveRole} model ref is malformed: '${ref}'`
+      }
+    };
+  }
+  const { providerId, modelId } = parsed;
+  const provider = await llmConfig.getProvider(providerId);
+  if (!provider) {
+    if (isSubscriptionProviderId(providerId)) {
+      return await resolveSubscriptionRoute({
+        config,
+        providerId,
+        modelId,
+        ingressFormat,
+        sessionId,
+        effectiveRole
+      });
+    }
+    return {
+      ok: false,
+      error: {
+        status: 503,
+        message: `provider '${providerId}' not found for endpoint '${config.endpoint}'`
+      }
+    };
+  }
+  const isOfficialProvider = provider.isOfficial === true || provider.id === "anthropic";
+  const targetProviderFormat = isOfficialProvider ? "anthropic" : "transform";
+  let anthropicSdkHints = null;
+  if (ingressFormat === "anthropic-messages") {
+    anthropicSdkHints = {
+      apiKey: resolveApiKey(provider.api_key),
+      isOfficialProvider,
+      passThrough: false,
+      attribution: { sessionId, apiKeyId: null }
+    };
+  }
+  const route = {
+    sessionId,
+    targetProviderFormat,
+    model: modelId,
+    ingressFormat,
+    authMode: "byo",
+    providerId,
+    anthropicSdkHints
+  };
+  return { ok: true, route, usedRole: effectiveRole };
+}
+async function resolveSubscriptionRoute(args) {
+  const { config, providerId, modelId, ingressFormat, sessionId, effectiveRole } = args;
+  if (!config.useSubscription) {
+    return {
+      ok: false,
+      error: {
+        status: 503,
+        message: `subscription routing disabled for endpoint '${config.endpoint}'`
+      }
+    };
+  }
+  if (!endpointSupportsSubscription(config.endpoint)) {
+    return {
+      ok: false,
+      error: {
+        status: 503,
+        message: `subscription routing is not supported on the '${config.endpoint}' endpoint; use a BYO API-key provider, or the /v1/messages or /v1/responses endpoint`
+      }
+    };
+  }
+  const registry = getSubscriptionRegistryForOutbound();
+  const profile = registry?.getProfile(providerId) ?? null;
+  if (!profile) {
+    return {
+      ok: false,
+      error: {
+        status: 503,
+        message: `subscription provider '${providerId}' is not available`
+      }
+    };
+  }
+  const hints = {
+    apiKey: "",
+    isOfficialProvider: false,
+    passThrough: false,
+    subscriptionProfile: profile,
+    attribution: { sessionId, apiKeyId: null }
+  };
+  const subscriptionConfig = providerId === "opencodego" ? await registry?.getOpenCodeGoConfig?.() : void 0;
+  const route = {
+    sessionId,
+    targetProviderFormat: "transform",
+    model: modelId,
+    ingressFormat,
+    authMode: "subscription",
+    providerId,
+    // Anthropic delegation carries the dispatch profile inside
+    // `anthropicSdkHints.subscriptionProfile`. The Responses ingress reads the
+    // TOP-LEVEL `route.subscriptionProfile`, and so does the built-in
+    // (factory-absent) `/v1/messages` subscription path (RT2.1) — the registry's
+    // `SubscriptionDispatchProfile` structurally satisfies `SubscriptionAuthProfile`
+    // ({ authStrategy, resolveUpstreamUrl, providerTransformerNames }), so set it
+    // for BOTH. This is INERT when an Anthropic ingress factory is present: that
+    // delegation reads the hint-bundle field above (and uses a different
+    // route-minting path), never the top-level field. (chat/gemini never reach
+    // here — Gate 2 rejected them.)
+    subscriptionProfile: ingressFormat === "openai-responses" || ingressFormat === "anthropic-messages" ? profile : void 0,
+    // Opaque per-account config (opencodego-only; `undefined` otherwise). Read by
+    // the built-in `/v1/messages` plan builder; INERT for the factory-present
+    // delegation path + non-opencodego.
+    subscriptionConfig,
+    anthropicSdkHints: hints
+  };
+  return { ok: true, route, usedRole: effectiveRole };
+}
+function resolveApiKey(apiKey) {
+  if (!apiKey) return "";
+  if (apiKey.startsWith("$")) {
+    return process.env[apiKey.slice(1)] || "";
+  }
+  return apiKey;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isSubscriptionProviderId,
+  parseModelRef,
+  resolveRoute
+});

package/dist/outbound-api/routeResolver.d.cts

@@ -0,0 +1,18 @@
+import '../ports/provider-config-source.cjs';
+import '../provider-proxy/types.cjs';
+import './types.cjs';
+export { R as RouteResolveError, a as RouteResolveResult, i as isSubscriptionProviderId, p as parseModelRef, r as resolveRoute } from '../routeResolver-BrbK6ja9.cjs';
+import '@omnicross/contracts/llm-config';
+import '../transformer/types.cjs';
+import '../transformer/TransformerService.cjs';
+import 'node:http';
+import '@omnicross/contracts/completion-types';
+import '@omnicross/contracts/subscription-types';
+import '@omnicross/contracts/usage-types';
+import '../ApiKeyPoolService-BmMkau07.cjs';
+import '../pipeline/AuthSource.cjs';
+import '../pipeline/SubscriptionAuthSource.cjs';
+import '../pipeline/SubscriptionAuthStrategy.cjs';
+import '../ports/web-search-backend.cjs';
+import '@omnicross/contracts/websearch-types';
+import '../ProviderProxy-CnMQYN59.cjs';

package/dist/outbound-api/routeResolver.d.ts

@@ -0,0 +1,18 @@
+import '../ports/provider-config-source.js';
+import '../provider-proxy/types.js';
+import './types.js';
+export { R as RouteResolveError, a as RouteResolveResult, i as isSubscriptionProviderId, p as parseModelRef, r as resolveRoute } from '../routeResolver-HE-ZO0fO.js';
+import '@omnicross/contracts/llm-config';
+import '../transformer/types.js';
+import '../transformer/TransformerService.js';
+import 'node:http';
+import '@omnicross/contracts/completion-types';
+import '@omnicross/contracts/subscription-types';
+import '@omnicross/contracts/usage-types';
+import '../ApiKeyPoolService-BmMkau07.js';
+import '../pipeline/AuthSource.js';
+import '../pipeline/SubscriptionAuthSource.js';
+import '../pipeline/SubscriptionAuthStrategy.js';
+import '../ports/web-search-backend.js';
+import '@omnicross/contracts/websearch-types';
+import '../ProviderProxy-C-xqrkKi.js';

package/dist/outbound-api/routeResolver.js

@@ -0,0 +1,192 @@
+// src/outbound-api/subscriptionRegistryPort.ts
+var _registry = null;
+function getSubscriptionRegistryForOutbound() {
+  return _registry;
+}
+
+// src/outbound-api/subscriptionSupport.ts
+var SUBSCRIPTION_PROVIDER_IDS = [
+  "claude",
+  "codex",
+  "gemini",
+  "opencodego"
+];
+var SUBSCRIPTION_ID_SET = new Set(SUBSCRIPTION_PROVIDER_IDS);
+function isSubscriptionProviderId(providerId) {
+  if (SUBSCRIPTION_ID_SET.has(providerId)) return true;
+  const registry = getSubscriptionRegistryForOutbound();
+  return registry?.getProfile(providerId) != null;
+}
+var SUBSCRIPTION_SUPPORTED_ENDPOINTS = /* @__PURE__ */ new Set([
+  "messages",
+  "responses"
+]);
+function endpointSupportsSubscription(endpoint) {
+  return SUBSCRIPTION_SUPPORTED_ENDPOINTS.has(endpoint);
+}
+
+// src/outbound-api/routeResolver.ts
+function parseModelRef(ref) {
+  if (!ref) return null;
+  const idx = ref.indexOf(",");
+  if (idx <= 0) return null;
+  const providerId = ref.slice(0, idx).trim();
+  const modelId = ref.slice(idx + 1).trim();
+  if (!providerId || !modelId) return null;
+  return { providerId, modelId };
+}
+function pickModelRefForRole(config, role) {
+  if (role === "vision") {
+    if (config.visionModel && config.visionModel.trim()) {
+      return { ref: config.visionModel, effectiveRole: "vision" };
+    }
+    return { ref: config.defaultModel, effectiveRole: "default" };
+  }
+  if (role === "background") {
+    return { ref: config.backgroundModel, effectiveRole: "background" };
+  }
+  return { ref: config.defaultModel, effectiveRole: "default" };
+}
+async function resolveRoute(args) {
+  const { config, role, ingressFormat, llmConfig } = args;
+  const sessionId = args.sessionId ?? null;
+  const { ref, effectiveRole } = pickModelRefForRole(config, role);
+  if (!ref || !ref.trim()) {
+    return {
+      ok: false,
+      error: {
+        status: 503,
+        message: `endpoint '${config.endpoint}' has no ${effectiveRole} model configured`
+      }
+    };
+  }
+  const parsed = parseModelRef(ref);
+  if (!parsed) {
+    return {
+      ok: false,
+      error: {
+        status: 503,
+        message: `endpoint '${config.endpoint}' ${effectiveRole} model ref is malformed: '${ref}'`
+      }
+    };
+  }
+  const { providerId, modelId } = parsed;
+  const provider = await llmConfig.getProvider(providerId);
+  if (!provider) {
+    if (isSubscriptionProviderId(providerId)) {
+      return await resolveSubscriptionRoute({
+        config,
+        providerId,
+        modelId,
+        ingressFormat,
+        sessionId,
+        effectiveRole
+      });
+    }
+    return {
+      ok: false,
+      error: {
+        status: 503,
+        message: `provider '${providerId}' not found for endpoint '${config.endpoint}'`
+      }
+    };
+  }
+  const isOfficialProvider = provider.isOfficial === true || provider.id === "anthropic";
+  const targetProviderFormat = isOfficialProvider ? "anthropic" : "transform";
+  let anthropicSdkHints = null;
+  if (ingressFormat === "anthropic-messages") {
+    anthropicSdkHints = {
+      apiKey: resolveApiKey(provider.api_key),
+      isOfficialProvider,
+      passThrough: false,
+      attribution: { sessionId, apiKeyId: null }
+    };
+  }
+  const route = {
+    sessionId,
+    targetProviderFormat,
+    model: modelId,
+    ingressFormat,
+    authMode: "byo",
+    providerId,
+    anthropicSdkHints
+  };
+  return { ok: true, route, usedRole: effectiveRole };
+}
+async function resolveSubscriptionRoute(args) {
+  const { config, providerId, modelId, ingressFormat, sessionId, effectiveRole } = args;
+  if (!config.useSubscription) {
+    return {
+      ok: false,
+      error: {
+        status: 503,
+        message: `subscription routing disabled for endpoint '${config.endpoint}'`
+      }
+    };
+  }
+  if (!endpointSupportsSubscription(config.endpoint)) {
+    return {
+      ok: false,
+      error: {
+        status: 503,
+        message: `subscription routing is not supported on the '${config.endpoint}' endpoint; use a BYO API-key provider, or the /v1/messages or /v1/responses endpoint`
+      }
+    };
+  }
+  const registry = getSubscriptionRegistryForOutbound();
+  const profile = registry?.getProfile(providerId) ?? null;
+  if (!profile) {
+    return {
+      ok: false,
+      error: {
+        status: 503,
+        message: `subscription provider '${providerId}' is not available`
+      }
+    };
+  }
+  const hints = {
+    apiKey: "",
+    isOfficialProvider: false,
+    passThrough: false,
+    subscriptionProfile: profile,
+    attribution: { sessionId, apiKeyId: null }
+  };
+  const subscriptionConfig = providerId === "opencodego" ? await registry?.getOpenCodeGoConfig?.() : void 0;
+  const route = {
+    sessionId,
+    targetProviderFormat: "transform",
+    model: modelId,
+    ingressFormat,
+    authMode: "subscription",
+    providerId,
+    // Anthropic delegation carries the dispatch profile inside
+    // `anthropicSdkHints.subscriptionProfile`. The Responses ingress reads the
+    // TOP-LEVEL `route.subscriptionProfile`, and so does the built-in
+    // (factory-absent) `/v1/messages` subscription path (RT2.1) — the registry's
+    // `SubscriptionDispatchProfile` structurally satisfies `SubscriptionAuthProfile`
+    // ({ authStrategy, resolveUpstreamUrl, providerTransformerNames }), so set it
+    // for BOTH. This is INERT when an Anthropic ingress factory is present: that
+    // delegation reads the hint-bundle field above (and uses a different
+    // route-minting path), never the top-level field. (chat/gemini never reach
+    // here — Gate 2 rejected them.)
+    subscriptionProfile: ingressFormat === "openai-responses" || ingressFormat === "anthropic-messages" ? profile : void 0,
+    // Opaque per-account config (opencodego-only; `undefined` otherwise). Read by
+    // the built-in `/v1/messages` plan builder; INERT for the factory-present
+    // delegation path + non-opencodego.
+    subscriptionConfig,
+    anthropicSdkHints: hints
+  };
+  return { ok: true, route, usedRole: effectiveRole };
+}
+function resolveApiKey(apiKey) {
+  if (!apiKey) return "";
+  if (apiKey.startsWith("$")) {
+    return process.env[apiKey.slice(1)] || "";
+  }
+  return apiKey;
+}
+export {
+  isSubscriptionProviderId,
+  parseModelRef,
+  resolveRoute
+};

package/dist/outbound-api/subscriptionRegistryPort.d.cts

@@ -1,14 +1,17 @@
-import { S as SubscriptionDispatchProfile } from '../types-DZIQbgp0.cjs';
+import { SubscriptionDispatchProfile } from '../provider-proxy/types.cjs';
 import 'node:http';
 import '@omnicross/contracts/completion-types';
 import '@omnicross/contracts/subscription-types';
 import '@omnicross/contracts/usage-types';
 import '../ApiKeyPoolService-BmMkau07.cjs';
 import '@omnicross/contracts/llm-config';
-import '../SubscriptionAuthSource-Cr4fVEYY.cjs';
+import '../pipeline/AuthSource.cjs';
+import '../pipeline/SubscriptionAuthSource.cjs';
 import '../pipeline/SubscriptionAuthStrategy.cjs';
+import '../ports/provider-config-source.cjs';
 import '../transformer/types.cjs';
 import '../transformer/TransformerService.cjs';
+import '../ports/web-search-backend.cjs';
 import '@omnicross/contracts/websearch-types';
 
 /**

package/dist/outbound-api/subscriptionRegistryPort.d.ts

@@ -1,14 +1,17 @@
-import { S as SubscriptionDispatchProfile } from '../types-DCzHkhJt.js';
+import { SubscriptionDispatchProfile } from '../provider-proxy/types.js';
 import 'node:http';
 import '@omnicross/contracts/completion-types';
 import '@omnicross/contracts/subscription-types';
 import '@omnicross/contracts/usage-types';
 import '../ApiKeyPoolService-BmMkau07.js';
 import '@omnicross/contracts/llm-config';
-import '../SubscriptionAuthSource-D89zmiSS.js';
+import '../pipeline/AuthSource.js';
+import '../pipeline/SubscriptionAuthSource.js';
 import '../pipeline/SubscriptionAuthStrategy.js';
+import '../ports/provider-config-source.js';
 import '../transformer/types.js';
 import '../transformer/TransformerService.js';
+import '../ports/web-search-backend.js';
 import '@omnicross/contracts/websearch-types';
 
 /**

package/dist/outbound-api/types.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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/outbound-api/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/{types-CbCN2NQP.d.ts → outbound-api/types.d.cts}

@@ -1,5 +1,19 @@
-import { P as ProviderConfigSource, a as ProviderProxyDeps } from './types-DCzHkhJt.js';
-import { P as ProviderProxy } from './ProviderProxy-vjt8sQQk.js';
+import { ProviderConfigSource } from '../ports/provider-config-source.cjs';
+import { P as ProviderProxy } from '../ProviderProxy-CnMQYN59.cjs';
+import { ProviderProxyDeps } from '../provider-proxy/types.cjs';
+import '@omnicross/contracts/llm-config';
+import '../transformer/types.cjs';
+import '../transformer/TransformerService.cjs';
+import 'node:http';
+import '@omnicross/contracts/completion-types';
+import '@omnicross/contracts/subscription-types';
+import '@omnicross/contracts/usage-types';
+import '../ApiKeyPoolService-BmMkau07.cjs';
+import '../pipeline/AuthSource.cjs';
+import '../pipeline/SubscriptionAuthSource.cjs';
+import '../pipeline/SubscriptionAuthStrategy.cjs';
+import '../ports/web-search-backend.cjs';
+import '@omnicross/contracts/websearch-types';
 
 /**
  * Shared contract types for the outbound API server (`outbound-api-server`).
@@ -139,4 +153,4 @@ interface OutboundApiDeps {
     readonly proxyDeps: ProviderProxyDeps;
 }
 
-export type { EndpointRoutingConfig as E, OutboundKeyDb as O, RequestRole as R, OutboundApiDeps as a, OutboundApiKeyCreated as b, OutboundApiKeyInfo as c, OutboundApiServerConfig as d, OutboundApiServerStatus as e, OutboundEndpoint as f, OutboundFormatUrls as g, OutboundKeyDbRow as h };
+export type { EndpointRoutingConfig, ModelRef, OutboundApiDeps, OutboundApiKeyCreated, OutboundApiKeyInfo, OutboundApiServerConfig, OutboundApiServerStatus, OutboundEndpoint, OutboundFormatUrls, OutboundKeyDb, OutboundKeyDbRow, RequestRole };

package/dist/{types-CGGrKqC_.d.cts → outbound-api/types.d.ts}

@@ -1,5 +1,19 @@
-import { P as ProviderConfigSource, a as ProviderProxyDeps } from './types-DZIQbgp0.cjs';
-import { P as ProviderProxy } from './ProviderProxy-f_8ziIhW.cjs';
+import { ProviderConfigSource } from '../ports/provider-config-source.js';
+import { P as ProviderProxy } from '../ProviderProxy-C-xqrkKi.js';
+import { ProviderProxyDeps } from '../provider-proxy/types.js';
+import '@omnicross/contracts/llm-config';
+import '../transformer/types.js';
+import '../transformer/TransformerService.js';
+import 'node:http';
+import '@omnicross/contracts/completion-types';
+import '@omnicross/contracts/subscription-types';
+import '@omnicross/contracts/usage-types';
+import '../ApiKeyPoolService-BmMkau07.js';
+import '../pipeline/AuthSource.js';
+import '../pipeline/SubscriptionAuthSource.js';
+import '../pipeline/SubscriptionAuthStrategy.js';
+import '../ports/web-search-backend.js';
+import '@omnicross/contracts/websearch-types';
 
 /**
  * Shared contract types for the outbound API server (`outbound-api-server`).
@@ -139,4 +153,4 @@ interface OutboundApiDeps {
     readonly proxyDeps: ProviderProxyDeps;
 }
 
-export type { EndpointRoutingConfig as E, OutboundKeyDb as O, RequestRole as R, OutboundApiDeps as a, OutboundApiKeyCreated as b, OutboundApiKeyInfo as c, OutboundApiServerConfig as d, OutboundApiServerStatus as e, OutboundEndpoint as f, OutboundFormatUrls as g, OutboundKeyDbRow as h };
+export type { EndpointRoutingConfig, ModelRef, OutboundApiDeps, OutboundApiKeyCreated, OutboundApiKeyInfo, OutboundApiServerConfig, OutboundApiServerStatus, OutboundEndpoint, OutboundFormatUrls, OutboundKeyDb, OutboundKeyDbRow, RequestRole };

package/dist/outbound-api.cjs

@@ -3836,6 +3836,7 @@ async function handleAnthropicMessagesRequest(req, res, route, deps) {
     extendedContext: hints.extendedContext ?? null,
     passThrough: hints.passThrough,
     passThroughAuthToken: hints.passThroughAuthToken ?? null,
+    resolvePassThroughAuthToken: hints.resolvePassThroughAuthToken ?? null,
     subscriptionProfile: hints.subscriptionProfile ?? null,
     maxConcurrency: hints.maxConcurrency,
     webSearchService: hints.webSearchService ?? null,