@fgv/ts-extras 5.1.0-55 → 5.1.0-57

package/lib/packlets/ai-assist/listModelsClient.js

@@ -265,10 +265,28 @@ async function callProviderListModels(params) {
  * `POST ${proxyUrl}/api/ai/list-models`. Capability config is not forwarded;
  * `capabilities` is serialized as a string array. Error body `{error: string}`
  * is surfaced as `proxy: ${error}`.
+ *
+ * @remarks
+ * `capabilityConfig` and `endpoint` are both unusable here, but they are not the
+ * same case and are not treated the same way. `capabilityConfig` overrides how a
+ * model id is classified, and the proxy returns models already classified — so a
+ * caller-supplied override could only ever have arrived too late. Ignoring it
+ * yields the default classification: a degraded answer, disclosed above, and
+ * that is where it stays. `endpoint` names *which server answers at all*, so
+ * ignoring it would list the provider's public catalog in place of the host the
+ * caller pinned; it is **refused**, on the same terms as
+ * `callProxiedCompletion`.
+ *
  * @public
  */
 async function callProxiedListModels(proxyUrl, params) {
-    const { descriptor, apiKey, capability, logger, signal } = params;
+    const { descriptor, apiKey, capability, logger, signal, endpoint } = params;
+    if (endpoint !== undefined) {
+        return (0, ts_utils_1.fail)(`callProxiedListModels: endpoint is not supported on the proxied path — a proxy ` +
+            `cannot confirm it honored it, and silently reaching the provider's default ` +
+            `upstream would list a different server's catalog than the caller named. Use ` +
+            `callProviderListModels, or route the proxy itself at the intended upstream.`);
+    }
     const body = {
         providerId: descriptor.id,
         apiKey

package/lib/packlets/ai-assist/listModelsClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"listModelsClient.js","sourceRoot":"","sources":["../../../src/packlets/ai-assist/listModelsClient.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Erik Fortune\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in all\n// copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n// SOFTWARE.\n\n/**\n * Model-listing clients for AI assist. One provider dispatcher over\n * `IAiProviderDescriptor.apiFormat`, its adapters and response validators, the\n * capability-resolution helpers that turn a raw model id into an\n * `IAiModelInfo`, and the proxied variant.\n *\n * @packageDocumentation\n */\n\nimport { fail, type Logging, Result, succeed, type Validator, Validators } from '@fgv/ts-utils';\n\nimport {\n  type AiModelCapability,\n  allModelCapabilities,\n  type IAiModelCapabilityConfig,\n  type IAiModelCapabilityRule,\n  type IAiModelInfo,\n  type IAiProviderDescriptor\n} from './model';\nimport {\n  anthropicAuthHeaders,\n  bearerAuthHeader,\n  geminiAuthHeader,\n  resolveEffectiveBaseUrl\n} from './endpoint';\nimport { type IAiApiConfig, fetchGetJson, fetchJson } from './http';\nimport { DEFAULT_MODEL_CAPABILITY_CONFIG } from './registry';\n\n// ---- Proxied list-models response ----\n\n/**\n * Wire shape for proxy list-models responses. `capabilities` arrives as an\n * array (Sets don't survive JSON), then gets reassembled into a `Set` in\n * {@link callProxiedListModels}.\n * @internal\n */\ninterface IProxiedListModelsEntry {\n  id: string;\n  capabilities: AiModelCapability[];\n  displayName?: string;\n}\n/** @internal */\ninterface IProxiedListModelsBody {\n  models: IProxiedListModelsEntry[];\n}\n\nconst proxiedListModelsEntry: Validator<IProxiedListModelsEntry> = Validators.object<IProxiedListModelsEntry>(\n  {\n    id: Validators.string,\n    capabilities: Validators.arrayOf(Validators.enumeratedValue<AiModelCapability>(allModelCapabilities)),\n    displayName: Validators.string.optional()\n  }\n);\nconst proxiedListModelsResponse: Validator<IProxiedListModelsBody> =\n  Validators.object<IProxiedListModelsBody>({\n    models: Validators.arrayOf(proxiedListModelsEntry)\n  });\n\n// ============================================================================\n// List models — request types\n// ============================================================================\n\n/**\n * Parameters for a list-models request.\n * @public\n */\nexport interface IProviderListModelsParams {\n  /** The provider descriptor */\n  readonly descriptor: IAiProviderDescriptor;\n  /** API key for authentication */\n  readonly apiKey: string;\n  /** Optional capability filter; when set, only models declaring this capability are returned. */\n  readonly capability?: AiModelCapability;\n  /** Optional capability config override (defaults to {@link DEFAULT_MODEL_CAPABILITY_CONFIG}). */\n  readonly capabilityConfig?: IAiModelCapabilityConfig;\n  /** Optional logger for request/response observability. */\n  readonly logger?: Logging.ILogger;\n  /** Optional abort signal for cancelling the in-flight request. */\n  readonly signal?: AbortSignal;\n  /** Optional override of the descriptor's base URL; per-format `/models` route is appended unchanged. */\n  readonly endpoint?: string;\n}\n\n// ============================================================================\n// List models — response validators\n// ============================================================================\n\n// ---- OpenAI / xAI / Groq / Mistral list format ----\n\n/** @internal */\ninterface IOpenAiListEntry {\n  id: string;\n}\n/** @internal */\ninterface IOpenAiListResponse {\n  data: IOpenAiListEntry[];\n}\n\nconst openAiListEntry: Validator<IOpenAiListEntry> = Validators.object<IOpenAiListEntry>({\n  id: Validators.string\n});\nconst openAiListResponse: Validator<IOpenAiListResponse> = Validators.object<IOpenAiListResponse>({\n  data: Validators.arrayOf(openAiListEntry)\n});\n\n// ---- Anthropic list format ----\n\n/** @internal */\ninterface IAnthropicListEntry {\n  id: string;\n  display_name?: string;\n}\n/** @internal */\ninterface IAnthropicListResponse {\n  data: IAnthropicListEntry[];\n}\n\nconst anthropicListEntry: Validator<IAnthropicListEntry> = Validators.object<IAnthropicListEntry>({\n  id: Validators.string,\n  display_name: Validators.string.optional()\n});\nconst anthropicListResponse: Validator<IAnthropicListResponse> = Validators.object<IAnthropicListResponse>({\n  data: Validators.arrayOf(anthropicListEntry)\n});\n\n// ---- Gemini list format ----\n\n/** @internal */\ninterface IGeminiListEntry {\n  name: string;\n  displayName?: string;\n  supportedGenerationMethods?: string[];\n}\n/** @internal */\ninterface IGeminiListResponse {\n  models: IGeminiListEntry[];\n}\n\nconst geminiListEntry: Validator<IGeminiListEntry> = Validators.object<IGeminiListEntry>({\n  name: Validators.string,\n  displayName: Validators.string.optional(),\n  supportedGenerationMethods: Validators.arrayOf(Validators.string).optional()\n});\nconst geminiListResponse: Validator<IGeminiListResponse> = Validators.object<IGeminiListResponse>({\n  models: Validators.arrayOf(geminiListEntry)\n});\n\n// ============================================================================\n// List models — capability resolution\n// ============================================================================\n\n/**\n * Translates Gemini's `supportedGenerationMethods` strings into our abstract\n * capability vocabulary. Methods without a mapping are ignored.\n * @internal\n */\nfunction geminiMethodsToCapabilities(methods: ReadonlyArray<string>): ReadonlyArray<AiModelCapability> {\n  const out: AiModelCapability[] = [];\n  for (const m of methods) {\n    if (m === 'generateContent') {\n      out.push('chat');\n    } else if (m === 'predict') {\n      out.push('image-generation');\n    }\n  }\n  return out;\n}\n\n/**\n * Strips the `models/` prefix Gemini includes on listed model names.\n * @internal\n */\nfunction geminiBareId(name: string): string {\n  /* c8 ignore next 1 - defensive: Gemini API always returns names prefixed with 'models/' */\n  return name.startsWith('models/') ? name.substring('models/'.length) : name;\n}\n\n/**\n * Applies a capability config to a model id. Walks per-provider rules then\n * global rules; unions all matching rules' capabilities. Returns the union\n * and the first matching `displayName` (if any).\n * @internal\n */\nfunction applyCapabilityConfig(\n  config: IAiModelCapabilityConfig,\n  providerId: string,\n  modelId: string\n): { capabilities: AiModelCapability[]; displayName: string | undefined } {\n  const caps = new Set<AiModelCapability>();\n  let displayName: string | undefined;\n\n  const rulesets: ReadonlyArray<ReadonlyArray<IAiModelCapabilityRule>> = [\n    config.perProvider?.[providerId as keyof typeof config.perProvider] ?? [],\n    config.global ?? []\n  ];\n\n  for (const rules of rulesets) {\n    for (const rule of rules) {\n      rule.idPattern.lastIndex = 0;\n      if (rule.idPattern.test(modelId)) {\n        for (const cap of rule.capabilities) {\n          caps.add(cap);\n        }\n        if (displayName === undefined && rule.displayName !== undefined) {\n          displayName = typeof rule.displayName === 'function' ? rule.displayName(modelId) : rule.displayName;\n        }\n      }\n    }\n  }\n  return { capabilities: Array.from(caps), displayName };\n}\n\n/**\n * Combines provider-native capability info (when supplied) and config-derived\n * capability info into a final {@link IAiModelInfo}.\n * @internal\n */\nfunction buildModelInfo(\n  providerId: string,\n  id: string,\n  nativeCapabilities: ReadonlyArray<AiModelCapability>,\n  nativeDisplayName: string | undefined,\n  config: IAiModelCapabilityConfig\n): IAiModelInfo {\n  const fromConfig = applyCapabilityConfig(config, providerId, id);\n  const all = new Set<AiModelCapability>([...nativeCapabilities, ...fromConfig.capabilities]);\n  return {\n    id,\n    capabilities: all,\n    ...(nativeDisplayName !== undefined\n      ? { displayName: nativeDisplayName }\n      : fromConfig.displayName !== undefined\n      ? { displayName: fromConfig.displayName }\n      : {})\n  };\n}\n\n// ============================================================================\n// List models — adapters\n// ============================================================================\n\n/**\n * Calls the OpenAI-style `GET /models` endpoint. Used by openai, xai-grok,\n * groq, and mistral. Provider supplies no capability info — capabilities are\n * derived entirely from the config.\n * @internal\n */\nasync function callOpenAiListModels(\n  config: IAiApiConfig,\n  providerId: string,\n  capabilityConfig: IAiModelCapabilityConfig,\n  logger?: Logging.ILogger,\n  signal?: AbortSignal\n): Promise<Result<ReadonlyArray<IAiModelInfo>>> {\n  const url = `${config.baseUrl}/models`;\n  const headers: Record<string, string> = bearerAuthHeader(config.apiKey);\n  /* c8 ignore next 1 - optional logger */\n  logger?.info(`List models: provider=${providerId}, format=openai`);\n  const jsonResult = await fetchGetJson(url, headers, logger, signal);\n  if (jsonResult.isFailure()) {\n    return fail(jsonResult.message);\n  }\n  return openAiListResponse\n    .validate(jsonResult.value)\n    .withErrorFormat((msg) => `OpenAI models API response: ${msg}`)\n    .onSuccess((response) => {\n      const models = response.data.map((entry) =>\n        buildModelInfo(providerId, entry.id, [], undefined, capabilityConfig)\n      );\n      return succeed(models);\n    });\n}\n\n/**\n * Calls the Anthropic `GET /models` endpoint. Provider supplies a\n * `display_name` but no native capability info.\n * @internal\n */\nasync function callAnthropicListModels(\n  config: IAiApiConfig,\n  providerId: string,\n  capabilityConfig: IAiModelCapabilityConfig,\n  logger?: Logging.ILogger,\n  signal?: AbortSignal\n): Promise<Result<ReadonlyArray<IAiModelInfo>>> {\n  const url = `${config.baseUrl}/models`;\n  const headers: Record<string, string> = anthropicAuthHeaders(config.apiKey);\n  /* c8 ignore next 1 - optional logger */\n  logger?.info(`List models: provider=${providerId}, format=anthropic`);\n  const jsonResult = await fetchGetJson(url, headers, logger, signal);\n  if (jsonResult.isFailure()) {\n    return fail(jsonResult.message);\n  }\n  return anthropicListResponse\n    .validate(jsonResult.value)\n    .withErrorFormat((msg) => `Anthropic models API response: ${msg}`)\n    .onSuccess((response) => {\n      const models = response.data.map((entry) =>\n        buildModelInfo(providerId, entry.id, [], entry.display_name, capabilityConfig)\n      );\n      return succeed(models);\n    });\n}\n\n/**\n * Calls the Gemini `GET /models` endpoint. Provider supplies both a\n * `displayName` and `supportedGenerationMethods` — translated to native\n * capabilities and unioned with config-derived capabilities.\n * @internal\n */\nasync function callGeminiListModels(\n  config: IAiApiConfig,\n  providerId: string,\n  capabilityConfig: IAiModelCapabilityConfig,\n  logger?: Logging.ILogger,\n  signal?: AbortSignal\n): Promise<Result<ReadonlyArray<IAiModelInfo>>> {\n  const url = `${config.baseUrl}/models`;\n  const headers: Record<string, string> = geminiAuthHeader(config.apiKey);\n  /* c8 ignore next 1 - optional logger */\n  logger?.info(`List models: provider=${providerId}, format=gemini`);\n  const jsonResult = await fetchGetJson(url, headers, logger, signal);\n  if (jsonResult.isFailure()) {\n    return fail(jsonResult.message);\n  }\n  return geminiListResponse\n    .validate(jsonResult.value)\n    .withErrorFormat((msg) => `Gemini models API response: ${msg}`)\n    .onSuccess((response) => {\n      const models = response.models.map((entry) => {\n        const id = geminiBareId(entry.name);\n        const native = entry.supportedGenerationMethods\n          ? geminiMethodsToCapabilities(entry.supportedGenerationMethods)\n          : [];\n        return buildModelInfo(providerId, id, native, entry.displayName, capabilityConfig);\n      });\n      return succeed(models);\n    });\n}\n\n// ============================================================================\n// List models — dispatcher\n// ============================================================================\n\n/**\n * Lists models available from a provider, routing by `descriptor.apiFormat`.\n * Capabilities are resolved from native provider info and a configurable rule set.\n * @param params - Request parameters (descriptor, API key, optional capability filter)\n * @public\n */\nexport async function callProviderListModels(\n  params: IProviderListModelsParams\n): Promise<Result<ReadonlyArray<IAiModelInfo>>> {\n  const { descriptor, apiKey, capability, capabilityConfig, logger, signal, endpoint } = params;\n\n  const baseUrlResult = resolveEffectiveBaseUrl(descriptor, endpoint);\n  if (baseUrlResult.isFailure()) {\n    return fail(baseUrlResult.message);\n  }\n\n  const config: IAiApiConfig = {\n    baseUrl: baseUrlResult.value,\n    apiKey,\n    model: '' // unused by listing\n  };\n  const effectiveConfig = capabilityConfig ?? DEFAULT_MODEL_CAPABILITY_CONFIG;\n\n  let listResult: Result<ReadonlyArray<IAiModelInfo>>;\n  switch (descriptor.apiFormat) {\n    case 'openai':\n      listResult = await callOpenAiListModels(config, descriptor.id, effectiveConfig, logger, signal);\n      break;\n    case 'anthropic':\n      listResult = await callAnthropicListModels(config, descriptor.id, effectiveConfig, logger, signal);\n      break;\n    case 'gemini':\n      listResult = await callGeminiListModels(config, descriptor.id, effectiveConfig, logger, signal);\n      break;\n    /* c8 ignore next 4 - defensive coding: exhaustive switch guaranteed by TypeScript */\n    default: {\n      const _exhaustive: never = descriptor.apiFormat;\n      return fail(`unsupported API format: ${String(_exhaustive)}`);\n    }\n  }\n\n  if (listResult.isFailure()) {\n    return listResult;\n  }\n  if (capability === undefined) {\n    return listResult;\n  }\n  return succeed(listResult.value.filter((m) => m.capabilities.has(capability)));\n}\n\n// ============================================================================\n// Proxied list models\n// ============================================================================\n\n/**\n * Calls the model-listing endpoint on a proxy server. Endpoint:\n * `POST ${proxyUrl}/api/ai/list-models`. Capability config is not forwarded;\n * `capabilities` is serialized as a string array. Error body `{error: string}`\n * is surfaced as `proxy: ${error}`.\n * @public\n */\nexport async function callProxiedListModels(\n  proxyUrl: string,\n  params: IProviderListModelsParams\n): Promise<Result<ReadonlyArray<IAiModelInfo>>> {\n  const { descriptor, apiKey, capability, logger, signal } = params;\n\n  const body: Record<string, unknown> = {\n    providerId: descriptor.id,\n    apiKey\n  };\n  if (capability !== undefined) {\n    body.capability = capability;\n  }\n\n  /* c8 ignore next 1 - optional logger */\n  logger?.info(`AI list-models proxy request: provider=${descriptor.id}, proxy=${proxyUrl}`);\n\n  const url = `${proxyUrl}/api/ai/list-models`;\n  const jsonResult = await fetchJson(url, {}, body, logger, signal);\n  if (jsonResult.isFailure()) {\n    return fail(jsonResult.message);\n  }\n\n  const response = jsonResult.value as Record<string, unknown>;\n  if (typeof response.error === 'string') {\n    return fail(`proxy: ${response.error}`);\n  }\n\n  return proxiedListModelsResponse\n    .validate(response)\n    .withErrorFormat((msg) => `proxy returned invalid response: ${msg}`)\n    .onSuccess((parsed) => {\n      const models: IAiModelInfo[] = parsed.models.map((m) => ({\n        id: m.id,\n        capabilities: new Set<AiModelCapability>(m.capabilities),\n        ...(m.displayName !== undefined ? { displayName: m.displayName } : {})\n      }));\n      return succeed(models);\n    });\n}\n"]}
+{"version":3,"file":"listModelsClient.js","sourceRoot":"","sources":["../../../src/packlets/ai-assist/listModelsClient.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Erik Fortune\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in all\n// copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n// SOFTWARE.\n\n/**\n * Model-listing clients for AI assist. One provider dispatcher over\n * `IAiProviderDescriptor.apiFormat`, its adapters and response validators, the\n * capability-resolution helpers that turn a raw model id into an\n * `IAiModelInfo`, and the proxied variant.\n *\n * @packageDocumentation\n */\n\nimport { fail, type Logging, Result, succeed, type Validator, Validators } from '@fgv/ts-utils';\n\nimport {\n  type AiModelCapability,\n  allModelCapabilities,\n  type IAiModelCapabilityConfig,\n  type IAiModelCapabilityRule,\n  type IAiModelInfo,\n  type IAiProviderDescriptor\n} from './model';\nimport {\n  anthropicAuthHeaders,\n  bearerAuthHeader,\n  geminiAuthHeader,\n  resolveEffectiveBaseUrl\n} from './endpoint';\nimport { type IAiApiConfig, fetchGetJson, fetchJson } from './http';\nimport { DEFAULT_MODEL_CAPABILITY_CONFIG } from './registry';\n\n// ---- Proxied list-models response ----\n\n/**\n * Wire shape for proxy list-models responses. `capabilities` arrives as an\n * array (Sets don't survive JSON), then gets reassembled into a `Set` in\n * {@link callProxiedListModels}.\n * @internal\n */\ninterface IProxiedListModelsEntry {\n  id: string;\n  capabilities: AiModelCapability[];\n  displayName?: string;\n}\n/** @internal */\ninterface IProxiedListModelsBody {\n  models: IProxiedListModelsEntry[];\n}\n\nconst proxiedListModelsEntry: Validator<IProxiedListModelsEntry> = Validators.object<IProxiedListModelsEntry>(\n  {\n    id: Validators.string,\n    capabilities: Validators.arrayOf(Validators.enumeratedValue<AiModelCapability>(allModelCapabilities)),\n    displayName: Validators.string.optional()\n  }\n);\nconst proxiedListModelsResponse: Validator<IProxiedListModelsBody> =\n  Validators.object<IProxiedListModelsBody>({\n    models: Validators.arrayOf(proxiedListModelsEntry)\n  });\n\n// ============================================================================\n// List models — request types\n// ============================================================================\n\n/**\n * Parameters for a list-models request.\n * @public\n */\nexport interface IProviderListModelsParams {\n  /** The provider descriptor */\n  readonly descriptor: IAiProviderDescriptor;\n  /** API key for authentication */\n  readonly apiKey: string;\n  /** Optional capability filter; when set, only models declaring this capability are returned. */\n  readonly capability?: AiModelCapability;\n  /** Optional capability config override (defaults to {@link DEFAULT_MODEL_CAPABILITY_CONFIG}). */\n  readonly capabilityConfig?: IAiModelCapabilityConfig;\n  /** Optional logger for request/response observability. */\n  readonly logger?: Logging.ILogger;\n  /** Optional abort signal for cancelling the in-flight request. */\n  readonly signal?: AbortSignal;\n  /** Optional override of the descriptor's base URL; per-format `/models` route is appended unchanged. */\n  readonly endpoint?: string;\n}\n\n// ============================================================================\n// List models — response validators\n// ============================================================================\n\n// ---- OpenAI / xAI / Groq / Mistral list format ----\n\n/** @internal */\ninterface IOpenAiListEntry {\n  id: string;\n}\n/** @internal */\ninterface IOpenAiListResponse {\n  data: IOpenAiListEntry[];\n}\n\nconst openAiListEntry: Validator<IOpenAiListEntry> = Validators.object<IOpenAiListEntry>({\n  id: Validators.string\n});\nconst openAiListResponse: Validator<IOpenAiListResponse> = Validators.object<IOpenAiListResponse>({\n  data: Validators.arrayOf(openAiListEntry)\n});\n\n// ---- Anthropic list format ----\n\n/** @internal */\ninterface IAnthropicListEntry {\n  id: string;\n  display_name?: string;\n}\n/** @internal */\ninterface IAnthropicListResponse {\n  data: IAnthropicListEntry[];\n}\n\nconst anthropicListEntry: Validator<IAnthropicListEntry> = Validators.object<IAnthropicListEntry>({\n  id: Validators.string,\n  display_name: Validators.string.optional()\n});\nconst anthropicListResponse: Validator<IAnthropicListResponse> = Validators.object<IAnthropicListResponse>({\n  data: Validators.arrayOf(anthropicListEntry)\n});\n\n// ---- Gemini list format ----\n\n/** @internal */\ninterface IGeminiListEntry {\n  name: string;\n  displayName?: string;\n  supportedGenerationMethods?: string[];\n}\n/** @internal */\ninterface IGeminiListResponse {\n  models: IGeminiListEntry[];\n}\n\nconst geminiListEntry: Validator<IGeminiListEntry> = Validators.object<IGeminiListEntry>({\n  name: Validators.string,\n  displayName: Validators.string.optional(),\n  supportedGenerationMethods: Validators.arrayOf(Validators.string).optional()\n});\nconst geminiListResponse: Validator<IGeminiListResponse> = Validators.object<IGeminiListResponse>({\n  models: Validators.arrayOf(geminiListEntry)\n});\n\n// ============================================================================\n// List models — capability resolution\n// ============================================================================\n\n/**\n * Translates Gemini's `supportedGenerationMethods` strings into our abstract\n * capability vocabulary. Methods without a mapping are ignored.\n * @internal\n */\nfunction geminiMethodsToCapabilities(methods: ReadonlyArray<string>): ReadonlyArray<AiModelCapability> {\n  const out: AiModelCapability[] = [];\n  for (const m of methods) {\n    if (m === 'generateContent') {\n      out.push('chat');\n    } else if (m === 'predict') {\n      out.push('image-generation');\n    }\n  }\n  return out;\n}\n\n/**\n * Strips the `models/` prefix Gemini includes on listed model names.\n * @internal\n */\nfunction geminiBareId(name: string): string {\n  /* c8 ignore next 1 - defensive: Gemini API always returns names prefixed with 'models/' */\n  return name.startsWith('models/') ? name.substring('models/'.length) : name;\n}\n\n/**\n * Applies a capability config to a model id. Walks per-provider rules then\n * global rules; unions all matching rules' capabilities. Returns the union\n * and the first matching `displayName` (if any).\n * @internal\n */\nfunction applyCapabilityConfig(\n  config: IAiModelCapabilityConfig,\n  providerId: string,\n  modelId: string\n): { capabilities: AiModelCapability[]; displayName: string | undefined } {\n  const caps = new Set<AiModelCapability>();\n  let displayName: string | undefined;\n\n  const rulesets: ReadonlyArray<ReadonlyArray<IAiModelCapabilityRule>> = [\n    config.perProvider?.[providerId as keyof typeof config.perProvider] ?? [],\n    config.global ?? []\n  ];\n\n  for (const rules of rulesets) {\n    for (const rule of rules) {\n      rule.idPattern.lastIndex = 0;\n      if (rule.idPattern.test(modelId)) {\n        for (const cap of rule.capabilities) {\n          caps.add(cap);\n        }\n        if (displayName === undefined && rule.displayName !== undefined) {\n          displayName = typeof rule.displayName === 'function' ? rule.displayName(modelId) : rule.displayName;\n        }\n      }\n    }\n  }\n  return { capabilities: Array.from(caps), displayName };\n}\n\n/**\n * Combines provider-native capability info (when supplied) and config-derived\n * capability info into a final {@link IAiModelInfo}.\n * @internal\n */\nfunction buildModelInfo(\n  providerId: string,\n  id: string,\n  nativeCapabilities: ReadonlyArray<AiModelCapability>,\n  nativeDisplayName: string | undefined,\n  config: IAiModelCapabilityConfig\n): IAiModelInfo {\n  const fromConfig = applyCapabilityConfig(config, providerId, id);\n  const all = new Set<AiModelCapability>([...nativeCapabilities, ...fromConfig.capabilities]);\n  return {\n    id,\n    capabilities: all,\n    ...(nativeDisplayName !== undefined\n      ? { displayName: nativeDisplayName }\n      : fromConfig.displayName !== undefined\n      ? { displayName: fromConfig.displayName }\n      : {})\n  };\n}\n\n// ============================================================================\n// List models — adapters\n// ============================================================================\n\n/**\n * Calls the OpenAI-style `GET /models` endpoint. Used by openai, xai-grok,\n * groq, and mistral. Provider supplies no capability info — capabilities are\n * derived entirely from the config.\n * @internal\n */\nasync function callOpenAiListModels(\n  config: IAiApiConfig,\n  providerId: string,\n  capabilityConfig: IAiModelCapabilityConfig,\n  logger?: Logging.ILogger,\n  signal?: AbortSignal\n): Promise<Result<ReadonlyArray<IAiModelInfo>>> {\n  const url = `${config.baseUrl}/models`;\n  const headers: Record<string, string> = bearerAuthHeader(config.apiKey);\n  /* c8 ignore next 1 - optional logger */\n  logger?.info(`List models: provider=${providerId}, format=openai`);\n  const jsonResult = await fetchGetJson(url, headers, logger, signal);\n  if (jsonResult.isFailure()) {\n    return fail(jsonResult.message);\n  }\n  return openAiListResponse\n    .validate(jsonResult.value)\n    .withErrorFormat((msg) => `OpenAI models API response: ${msg}`)\n    .onSuccess((response) => {\n      const models = response.data.map((entry) =>\n        buildModelInfo(providerId, entry.id, [], undefined, capabilityConfig)\n      );\n      return succeed(models);\n    });\n}\n\n/**\n * Calls the Anthropic `GET /models` endpoint. Provider supplies a\n * `display_name` but no native capability info.\n * @internal\n */\nasync function callAnthropicListModels(\n  config: IAiApiConfig,\n  providerId: string,\n  capabilityConfig: IAiModelCapabilityConfig,\n  logger?: Logging.ILogger,\n  signal?: AbortSignal\n): Promise<Result<ReadonlyArray<IAiModelInfo>>> {\n  const url = `${config.baseUrl}/models`;\n  const headers: Record<string, string> = anthropicAuthHeaders(config.apiKey);\n  /* c8 ignore next 1 - optional logger */\n  logger?.info(`List models: provider=${providerId}, format=anthropic`);\n  const jsonResult = await fetchGetJson(url, headers, logger, signal);\n  if (jsonResult.isFailure()) {\n    return fail(jsonResult.message);\n  }\n  return anthropicListResponse\n    .validate(jsonResult.value)\n    .withErrorFormat((msg) => `Anthropic models API response: ${msg}`)\n    .onSuccess((response) => {\n      const models = response.data.map((entry) =>\n        buildModelInfo(providerId, entry.id, [], entry.display_name, capabilityConfig)\n      );\n      return succeed(models);\n    });\n}\n\n/**\n * Calls the Gemini `GET /models` endpoint. Provider supplies both a\n * `displayName` and `supportedGenerationMethods` — translated to native\n * capabilities and unioned with config-derived capabilities.\n * @internal\n */\nasync function callGeminiListModels(\n  config: IAiApiConfig,\n  providerId: string,\n  capabilityConfig: IAiModelCapabilityConfig,\n  logger?: Logging.ILogger,\n  signal?: AbortSignal\n): Promise<Result<ReadonlyArray<IAiModelInfo>>> {\n  const url = `${config.baseUrl}/models`;\n  const headers: Record<string, string> = geminiAuthHeader(config.apiKey);\n  /* c8 ignore next 1 - optional logger */\n  logger?.info(`List models: provider=${providerId}, format=gemini`);\n  const jsonResult = await fetchGetJson(url, headers, logger, signal);\n  if (jsonResult.isFailure()) {\n    return fail(jsonResult.message);\n  }\n  return geminiListResponse\n    .validate(jsonResult.value)\n    .withErrorFormat((msg) => `Gemini models API response: ${msg}`)\n    .onSuccess((response) => {\n      const models = response.models.map((entry) => {\n        const id = geminiBareId(entry.name);\n        const native = entry.supportedGenerationMethods\n          ? geminiMethodsToCapabilities(entry.supportedGenerationMethods)\n          : [];\n        return buildModelInfo(providerId, id, native, entry.displayName, capabilityConfig);\n      });\n      return succeed(models);\n    });\n}\n\n// ============================================================================\n// List models — dispatcher\n// ============================================================================\n\n/**\n * Lists models available from a provider, routing by `descriptor.apiFormat`.\n * Capabilities are resolved from native provider info and a configurable rule set.\n * @param params - Request parameters (descriptor, API key, optional capability filter)\n * @public\n */\nexport async function callProviderListModels(\n  params: IProviderListModelsParams\n): Promise<Result<ReadonlyArray<IAiModelInfo>>> {\n  const { descriptor, apiKey, capability, capabilityConfig, logger, signal, endpoint } = params;\n\n  const baseUrlResult = resolveEffectiveBaseUrl(descriptor, endpoint);\n  if (baseUrlResult.isFailure()) {\n    return fail(baseUrlResult.message);\n  }\n\n  const config: IAiApiConfig = {\n    baseUrl: baseUrlResult.value,\n    apiKey,\n    model: '' // unused by listing\n  };\n  const effectiveConfig = capabilityConfig ?? DEFAULT_MODEL_CAPABILITY_CONFIG;\n\n  let listResult: Result<ReadonlyArray<IAiModelInfo>>;\n  switch (descriptor.apiFormat) {\n    case 'openai':\n      listResult = await callOpenAiListModels(config, descriptor.id, effectiveConfig, logger, signal);\n      break;\n    case 'anthropic':\n      listResult = await callAnthropicListModels(config, descriptor.id, effectiveConfig, logger, signal);\n      break;\n    case 'gemini':\n      listResult = await callGeminiListModels(config, descriptor.id, effectiveConfig, logger, signal);\n      break;\n    /* c8 ignore next 4 - defensive coding: exhaustive switch guaranteed by TypeScript */\n    default: {\n      const _exhaustive: never = descriptor.apiFormat;\n      return fail(`unsupported API format: ${String(_exhaustive)}`);\n    }\n  }\n\n  if (listResult.isFailure()) {\n    return listResult;\n  }\n  if (capability === undefined) {\n    return listResult;\n  }\n  return succeed(listResult.value.filter((m) => m.capabilities.has(capability)));\n}\n\n// ============================================================================\n// Proxied list models\n// ============================================================================\n\n/**\n * Calls the model-listing endpoint on a proxy server. Endpoint:\n * `POST ${proxyUrl}/api/ai/list-models`. Capability config is not forwarded;\n * `capabilities` is serialized as a string array. Error body `{error: string}`\n * is surfaced as `proxy: ${error}`.\n *\n * @remarks\n * `capabilityConfig` and `endpoint` are both unusable here, but they are not the\n * same case and are not treated the same way. `capabilityConfig` overrides how a\n * model id is classified, and the proxy returns models already classified — so a\n * caller-supplied override could only ever have arrived too late. Ignoring it\n * yields the default classification: a degraded answer, disclosed above, and\n * that is where it stays. `endpoint` names *which server answers at all*, so\n * ignoring it would list the provider's public catalog in place of the host the\n * caller pinned; it is **refused**, on the same terms as\n * `callProxiedCompletion`.\n *\n * @public\n */\nexport async function callProxiedListModels(\n  proxyUrl: string,\n  params: IProviderListModelsParams\n): Promise<Result<ReadonlyArray<IAiModelInfo>>> {\n  const { descriptor, apiKey, capability, logger, signal, endpoint } = params;\n\n  if (endpoint !== undefined) {\n    return fail(\n      `callProxiedListModels: endpoint is not supported on the proxied path — a proxy ` +\n        `cannot confirm it honored it, and silently reaching the provider's default ` +\n        `upstream would list a different server's catalog than the caller named. Use ` +\n        `callProviderListModels, or route the proxy itself at the intended upstream.`\n    );\n  }\n\n  const body: Record<string, unknown> = {\n    providerId: descriptor.id,\n    apiKey\n  };\n  if (capability !== undefined) {\n    body.capability = capability;\n  }\n\n  /* c8 ignore next 1 - optional logger */\n  logger?.info(`AI list-models proxy request: provider=${descriptor.id}, proxy=${proxyUrl}`);\n\n  const url = `${proxyUrl}/api/ai/list-models`;\n  const jsonResult = await fetchJson(url, {}, body, logger, signal);\n  if (jsonResult.isFailure()) {\n    return fail(jsonResult.message);\n  }\n\n  const response = jsonResult.value as Record<string, unknown>;\n  if (typeof response.error === 'string') {\n    return fail(`proxy: ${response.error}`);\n  }\n\n  return proxiedListModelsResponse\n    .validate(response)\n    .withErrorFormat((msg) => `proxy returned invalid response: ${msg}`)\n    .onSuccess((parsed) => {\n      const models: IAiModelInfo[] = parsed.models.map((m) => ({\n        id: m.id,\n        capabilities: new Set<AiModelCapability>(m.capabilities),\n        ...(m.displayName !== undefined ? { displayName: m.displayName } : {})\n      }));\n      return succeed(models);\n    });\n}\n"]}

package/lib/packlets/ai-assist/model.d.ts

@@ -3,8 +3,10 @@
  * @packageDocumentation
  */
 import { type Result } from '@fgv/ts-utils';
-import { type JsonObject, type JsonSchema } from '@fgv/ts-json-base';
+import { type JsonObject } from '@fgv/ts-json-base';
 import type { IAiStructuredOutputCapability, StructuredOutputEnforcement } from './structuredOutputTypes';
+import type { IAiCompletionUsage } from './usageTypes';
+import type { AiServerToolType, IAiStreamToolUseComplete, IAiStreamToolUseDelta, IAiStreamToolUseStart, IAiToolEnablement } from './toolTypes';
 /**
  * Universal image representation used for both image input (vision prompts)
  * and image output (generation responses).
@@ -125,267 +127,7 @@ export interface IChatRequest {
      */
     readonly messages: ReadonlyArray<IChatMessage>;
 }
-/**
- * Built-in server-side tool types supported across providers.
- * @public
- */
-export type AiServerToolType = 'web_search';
-/**
- * Configuration specific to web search tools.
- * @public
- */
-export interface IAiWebSearchToolConfig {
-    readonly type: 'web_search';
-    /** Optional: restrict search to these domains. */
-    readonly allowedDomains?: ReadonlyArray<string>;
-    /** Optional: exclude these domains from search. */
-    readonly blockedDomains?: ReadonlyArray<string>;
-    /** Optional: max number of searches per request. */
-    readonly maxUses?: number;
-    /**
-     * Optional: enable image understanding during web search.
-     * When true, the model can view and analyze images found during search.
-     * Currently supported by xAI only; ignored by other providers.
-     */
-    readonly enableImageUnderstanding?: boolean;
-}
-/**
- * Union of all server-side tool configurations. Discriminated on `type`.
- * @public
- */
-export type AiServerToolConfig = IAiWebSearchToolConfig;
-/**
- * Declares a tool as enabled/disabled in provider settings.
- * Tools are disabled by default — consuming apps must opt in explicitly.
- * @public
- */
-export interface IAiToolEnablement {
-    /** Which tool type. */
-    readonly type: AiServerToolType;
-    /** Whether this tool is enabled by default for this provider. */
-    readonly enabled: boolean;
-    /** Optional tool-specific configuration. */
-    readonly config?: AiServerToolConfig;
-}
-/**
- * Behavior annotations for a client-defined tool.
- *
- * @remarks
- * These are **host-advisory-only hints** describing a tool's side-effect profile.
- * They are consumed by the host's tool loop (e.g. a before-execute gate) and are
- * **never serialized to the model** — the provider wire tool-schemas whitelist
- * `{name, description, parameters}` and ignore this field.
- *
- * Field names mirror MCP's `ToolAnnotations` (`@modelcontextprotocol/sdk`) 1:1 so
- * an MCP tool's annotations pass through unchanged. Per the MCP spec, all fields
- * are hints — a host should never make tool-use decisions based on annotations
- * received from an untrusted server without its own validation.
- *
- * @public
- */
-export interface IAiToolAnnotations {
-    /** Optional human-readable display title for the tool. */
-    readonly title?: string;
-    /** Hint: the tool does not modify its environment (read-only). */
-    readonly readOnlyHint?: boolean;
-    /** Hint: the tool may perform destructive updates (only meaningful when not read-only). */
-    readonly destructiveHint?: boolean;
-    /** Hint: repeated calls with the same arguments have no additional effect. */
-    readonly idempotentHint?: boolean;
-    /** Hint: the tool interacts with an open world of external entities. */
-    readonly openWorldHint?: boolean;
-}
-/**
- * Configuration for a client-defined (harness-supplied) tool.
- *
- * @remarks
- * The `parametersSchema` is the single source of truth for both the wire-format
- * JSON Schema sent to the provider (via `.toJson()`) and the runtime argument
- * validation (via `.validate(rawArgs)`). Use `JsonSchema.object(...)` from
- * `@fgv/ts-json-base` to author the schema as a const (e.g. `const mySchema = JsonSchema.object({...})`);
- * the static type `TParams` is then derived via `JsonSchema.Static<typeof mySchema>` —
- * no drift between wire schema and runtime validation.
- *
- * @public
- */
-export interface IAiClientToolConfig<TParams = unknown> {
-    /** Discriminator — always `'client_tool'`. */
-    readonly type: 'client_tool';
-    /** Tool name sent to the model (must be unique within a call). */
-    readonly name: string;
-    /** Human-readable description of what the tool does, shown to the model. */
-    readonly description: string;
-    /**
-     * JSON Schema validator for the tool's parameters. Emits wire format via
-     * `.toJson()` and validates model-returned args via `.validate(rawArgs)`.
-     */
-    readonly parametersSchema: JsonSchema.ISchemaValidator<TParams>;
-    /**
-     * Optional host-advisory behavior annotations (read-only / destructive /
-     * idempotent / open-world hints + display title). Consumed by the host's
-     * tool loop; never serialized to the model. See {@link IAiToolAnnotations}.
-     */
-    readonly annotations?: IAiToolAnnotations;
-}
-/**
- * A client-defined tool: configuration + execution callback pair.
- *
- * @remarks
- * The `execute` callback receives typed `TParams` (already validated by
- * `config.parametersSchema.validate()`) and returns a `Promise<Result<unknown>>`.
- * Thrown errors are caught via `captureAsyncResult` in the round-trip helper.
- *
- * @public
- */
-export interface IAiClientTool<TParams = unknown> {
-    /** The tool's configuration (name, description, parameters schema). */
-    readonly config: IAiClientToolConfig<TParams>;
-    /**
-     * Execute the tool with validated parameters.
-     * @param args - Typed arguments, already validated against `config.parametersSchema`.
-     * @returns A `Promise<Result<unknown>>` — the result is stringified and sent back to the model.
-     */
-    readonly execute: (args: TParams) => Promise<Result<unknown>>;
-}
-/**
- * Union of all tool configurations: server-side or client-defined.
- * Discriminated on `type`.
- * @public
- */
-export type AiToolConfig = AiServerToolConfig | IAiClientToolConfig;
-/**
- * Emitted when a client-defined tool call begins streaming. Carries the tool name
- * and optional provider-assigned call ID (Anthropic / OpenAI Responses API; absent
- * for Gemini which does not assign call IDs).
- * @public
- */
-export interface IAiStreamToolUseStart {
-    readonly type: 'client-tool-call-start';
-    /** The name of the client tool being called. */
-    readonly toolName: string;
-    /**
-     * Provider-assigned call identifier (Anthropic: `toolu_*`; OpenAI: `call_*`).
-     * Absent for Gemini (correlation by name).
-     */
-    readonly callId?: string;
-}
-/**
- * Emitted when a client-defined tool call is complete and its arguments are fully
- * accumulated. The `args` object is the fully parsed JSON object — no further
- * streaming deltas follow for this call.
- * @public
- */
-export interface IAiStreamToolUseDelta {
-    readonly type: 'client-tool-call-done';
-    /** The name of the client tool being called. */
-    readonly toolName: string;
-    /**
-     * Provider-assigned call identifier. Absent for Gemini.
-     */
-    readonly callId?: string;
-    /** The fully accumulated and parsed tool arguments. */
-    readonly args: JsonObject;
-}
-/**
- * Emitted after a client-defined tool has been executed and the result is ready
- * to be fed back to the model in the round-trip continuation.
- * @public
- */
-export interface IAiStreamToolUseComplete {
-    readonly type: 'client-tool-result';
-    /** The name of the client tool that was executed. */
-    readonly toolName: string;
-    /**
-     * Provider-assigned call identifier. Absent for Gemini.
-     */
-    readonly callId?: string;
-    /** The stringified result returned by the tool's execute callback. */
-    readonly result: string;
-    /** Whether the tool execution failed (schema validation failure, execute error, or unknown tool). */
-    readonly isError: boolean;
-}
-/**
- * Summary of a single client tool call within a turn: the tool name, call ID,
- * raw arguments, execution result, and whether the execution was an error.
- * @public
- */
-export interface IAiClientToolCallSummary {
-    /** The name of the tool that was called. */
-    readonly toolName: string;
-    /** Provider-assigned call identifier (absent for Gemini). */
-    readonly callId?: string;
-    /** The fully accumulated raw arguments object as parsed JSON. */
-    readonly args: JsonObject;
-    /** The stringified result (success value or error message). */
-    readonly result: string;
-    /** Whether execution failed (schema validation failure, execute error, or unknown tool). */
-    readonly isError: boolean;
-}
-/**
- * The provider-specific continuation data needed to build the follow-up request
- * for the next round of the conversation.
- *
- * @remarks
- * `messages` are provider-native request objects (Anthropic: content-block arrays,
- * OpenAI Responses API: input items, Gemini: content parts). The continuation
- * builder in `clientToolContinuationBuilder.ts` populates this.
- *
- * @public
- */
-export interface IAiClientToolContinuation {
-    /**
-     * **Cumulative** provider-native wire-format message objects covering all
-     * tool rounds so far. On each turn, `executeClientToolTurn` prepends the
-     * inbound `continuationMessages` so that this array always contains the
-     * complete wire tail from round 1 through the current round.
-     *
-     * To drive a multi-round loop, simply **replace** `continuationMessages`
-     * with this value — do not manually concatenate:
-     *
-     * ```ts
-     * let tail: JsonObject[] | undefined;
-     * while (true) {
-     *   const { events, nextTurn } = executeClientToolTurn({
-     *     ..., continuationMessages: tail
-     *   }).orThrow();
-     *   for await (const e of events) { /* observe *\/ }
-     *   const outcome = (await nextTurn).orThrow();
-     *   if (!outcome.continuation) break;
-     *   tail = [...outcome.continuation.messages]; // replace — already cumulative
-     * }
-     * ```
-     *
-     * The exact shape is provider-native and may include provider-specific
-     * blocks (e.g. Anthropic thinking/redacted_thinking/tool_use, OpenAI
-     * function_call/function_call_output items, Gemini functionCall/functionResponse
-     * parts). These are NOT `IChatMessage[]` and must NOT be placed in the
-     * `messages` parameter — the normalized-message path strips provider-native
-     * fields (thinking signatures, redacted_thinking data) that the server
-     * requires for continuation validation.
-     *
-     * `toolCallsSummary` is per-round only (the calls executed in the current
-     * turn). Only `messages` is cumulative.
-     */
-    readonly messages: ReadonlyArray<JsonObject>;
-    /** Summary of each tool call executed in this turn (per-round, not cumulative). */
-    readonly toolCallsSummary: ReadonlyArray<IAiClientToolCallSummary>;
-}
-/**
- * The result of a single client-tool turn: the optional continuation for the next
- * call (absent when no tool calls occurred) and whether the stream was truncated.
- * @public
- */
-export interface IAiClientToolTurnResult {
-    /**
-     * The continuation data for the next round-trip. `undefined` when the model
-     * completed without invoking any client tools.
-     */
-    readonly continuation: IAiClientToolContinuation | undefined;
-    /** Whether the stream was truncated (token limit or stop reason). */
-    readonly truncated: boolean;
-    /** The full concatenated text from all `text-delta` events in this turn. */
-    readonly fullText: string;
-}
+export type { AiServerToolType, IAiWebSearchToolConfig, AiServerToolConfig, IAiToolEnablement, IAiToolAnnotations, IAiClientToolConfig, AiToolConfig, IAiClientTool, IAiStreamToolUseStart, IAiStreamToolUseDelta, IAiStreamToolUseComplete, AiToolConflictPolicy, IAiToolConflictReport, IAiClientToolCallSummary, IAiClientToolContinuation, IAiClientToolTurnResult } from './toolTypes';
 /**
  * Known context keys for model specification maps.
  *
@@ -402,17 +144,15 @@ export interface IAiClientToolTurnResult {
  * `'advanced'` / `'frontier'`) and sets the tools / thinking request params
  * independently. Thinking composes with any tier without a tier-level capability
  * check — but that is a statement about the tier axis, not a claim that every
- * provider supports thinking: several descriptors declare
- * `thinkingMode: 'unsupported'` (e.g. `copy-paste`, `groq`, `mistral`, `ollama`,
- * `openai-compat`).
- *
- * Thinking availability is declared **per provider**, on the descriptor's
- * `thinkingMode`; the descriptor does not encode per-model thinking availability at
- * all, so a provider that declares support may still have individual models its own
- * API rejects thinking on. (`adaptiveThinkingModelPrefixes` is per-model but selects
- * a wire *shape*, not availability.) What the tier axis guarantees is therefore
- * narrow and exact: a tier selects a model within one provider and never changes the
- * provider, so it never changes `thinkingMode`.
+ * provider supports thinking, or that every model of a thinking-capable provider
+ * does: the descriptor itself declares no thinking-availability field at all.
+ * `AiModelCapability`'s `'thinking'` entry (per-model, RegExp-matched on model id
+ * in `DEFAULT_MODEL_CAPABILITY_CONFIG`) is a listing/filtering signal only — the
+ * call path does not gate a thinking request on it, so an unlisted model is not
+ * rejected, merely absent from a capability-filtered menu. (`adaptiveThinkingModelPrefixes`
+ * is per-model but selects a wire *shape*, not availability.) What the tier axis
+ * guarantees is therefore narrow and exact: a tier selects a model within one
+ * provider and never changes the provider.
  *
  * Do not add a `'tools'` or `'thinking'` key here, and do not hand-roll a
  * `resolveModel` + `resolveModelAlias` walk to emulate one — call
@@ -694,6 +434,8 @@ export interface IAiCompletionResponse {
      * split.
      */
     readonly structuredOutput: StructuredOutputEnforcement;
+    /** Token usage, when the provider reports it. */
+    readonly usage?: IAiCompletionUsage;
 }
 /**
  * Default `max_tokens` sent to the Anthropic Messages API when the caller does
@@ -764,6 +506,8 @@ export interface IAiStreamDone {
      * reports truncation without a reason).
      */
     readonly incompleteReason?: string;
+    /** Token usage, when the provider reports it on this stream. */
+    readonly usage?: IAiCompletionUsage;
 }
 /**
  * Terminal failure event for a streaming completion. After this event no
@@ -792,11 +536,6 @@ export interface IAiStreamError {
  * @public
  */
 export type IAiStreamEvent = IAiStreamTextDelta | IAiStreamToolEvent | IAiStreamToolUseStart | IAiStreamToolUseDelta | IAiStreamToolUseComplete | IAiStreamDone | IAiStreamError;
-/**
- * Thinking/reasoning mode support for a provider.
- * @public
- */
-export type AiThinkingMode = 'optional' | 'required' | 'unsupported';
 /**
  * Describes a single AI provider — single source of truth for all metadata.
  * @public
@@ -831,6 +570,29 @@ export interface IAiProviderDescriptor {
     readonly aliases?: IModelAliasMap;
     /** Which server-side tools this provider supports (empty = none). */
     readonly supportedTools: ReadonlyArray<AiServerToolType>;
+    /**
+     * Server tools this provider's API refuses to accept in the *same request* as
+     * client (function) tools. Absent or empty means the provider imposes no such
+     * constraint and any supported server tool may be mixed with client tools.
+     *
+     * @remarks
+     * This is a narrower statement than {@link AiAssist.IAiProviderDescriptor.supportedTools}:
+     * a tool listed here is genuinely supported, just not *together* with function
+     * calling. Only Gemini declares anything today — its `generateContent` API
+     * HTTP-400s (`INVALID_ARGUMENT`) when built-in grounding (`web_search` →
+     * `google_search`) and `function_declarations` appear in one request.
+     *
+     * Declaring the rule here rather than enforcing it at the call site is the
+     * point: {@link AiAssist.resolveToolConflicts} applies it generically, so a host
+     * never writes `if (descriptor.apiFormat === 'gemini')` in its tool assembly,
+     * and the day a provider lifts its limit only this line changes.
+     *
+     * Optional because most providers have nothing to say. The library's own
+     * registry descriptors are the ones that reach the wire and are pinned by test;
+     * a hand-built descriptor that omits this simply gets the unconstrained
+     * behavior, which is the correct reading of "declares no constraint".
+     */
+    readonly serverToolsExclusiveWithClientTools?: ReadonlyArray<AiServerToolType>;
     /** Whether this provider's API enforces CORS restrictions that prevent direct browser calls. */
     readonly corsRestricted: boolean;
     /**
@@ -850,13 +612,6 @@ export interface IAiProviderDescriptor {
      * `prompt.attachments` are rejected up front.
      */
     readonly acceptsImageInput: boolean;
-    /**
-     * Whether this provider supports thinking/reasoning mode.
-     * - 'optional': thinking can be enabled but is not required
-     * - 'required': thinking is always active (e.g. o-series models)
-     * - 'unsupported': thinking is not supported
-     */
-    readonly thinkingMode: AiThinkingMode;
     /**
      * Image-generation capabilities, scoped to model id prefixes. Empty or
      * undefined means the provider does not support image generation.
@@ -1382,11 +1137,25 @@ export type XAiThinkingModelNames = 'grok-3-mini' | 'grok-4.3' | 'grok-4' | 'gro
  */
 export interface IAnthropicThinkingConfig {
     /**
-     * Anthropic effort level. The emit-site converts to `thinking.budget_tokens`
-     * (the integer budget the Anthropic API requires). Mapping policy: low = 2048,
-     * medium = 8192, high = 24000, max = 32000.
-     * - 'low' | 'medium' | 'high': all thinking-capable models
-     * - 'max': Opus 4.6 only
+     * Anthropic effort level, emitted as one of **two** wire shapes chosen by
+     * {@link AiAssist.isAdaptiveThinkingModel}:
+     *
+     * - **Claude 5 family** (`claude-sonnet-5`, `claude-opus-5`, `claude-fable-5`
+     *   — which includes the `base` and `advanced` tiers, so this is the default
+     *   path): an adaptive `thinking` block plus an `output_config` block
+     *   carrying `effort`. The effort string goes on the wire verbatim and
+     *   **no token budget is sent**.
+     * - **Older thinking-capable models**: an enabled `thinking` block carrying
+     *   `budget_tokens`, converted by `anthropicEffortToBudgetTokens` — low =
+     *   2048, medium = 8192, high = 24000, max = 32000.
+     *
+     * So the budget mapping is not a description of what a default Anthropic
+     * call sends; size a budget from it only when you have pinned a pre-Claude-5
+     * model.
+     *
+     * `'max'` is accepted on every thinking-capable model here — the library
+     * applies no model restriction of its own, and whether a given model accepts
+     * it is the provider's to enforce.
      */
     readonly effort?: 'low' | 'medium' | 'high' | 'max';
 }
@@ -1428,8 +1197,9 @@ export interface IGeminiThinkingConfig {
     /**
      * Whether to include thought summaries in the response.
      * @remarks
-     * INERT in phase B. Adapters never send `includeThoughts: true`.
-     * Wired up by the followup stream `ai-assist-thinking-events`.
+     * Reserved for forward compatibility and **currently ignored by every
+     * adapter** — nothing reads this field, so setting it has no effect on the
+     * request. Surfacing thinking output as stream events is not yet built.
      */
     readonly includeThoughts?: boolean;
 }
@@ -1513,11 +1283,27 @@ export type IThinkingProviderConfig = IAnthropicThinkingOptions | IOpenAiThinkin
 export interface IThinkingConfig {
     /**
      * Cross-provider effort level. Common-subset mapping:
+     * - 'none': Anthropic — no thinking param emitted | OpenAI effort:none | Gemini thinkingBudget:0 | xAI reasoning_effort:none
      * - 'low': Anthropic effort:low | OpenAI effort:low | Gemini thinkingBudget:1024 | xAI reasoning_effort:low
-     * - 'medium': effort:medium | effort:medium | thinkingBudget:4096 | reasoning_effort:medium
-     * - 'high': effort:high | effort:high | thinkingBudget:8192 | reasoning_effort:high
+     * - 'medium': Anthropic effort:medium | OpenAI effort:medium | Gemini thinkingBudget:4096 | xAI reasoning_effort:medium
+     * - 'high': Anthropic effort:high | OpenAI effort:high | Gemini thinkingBudget:8192 | xAI reasoning_effort:high
+     *
+     * @remarks
+     * `'none'` is the one cross-provider spelling for "thinking off". Anthropic has no
+     * off value in its own effort vocabulary — off there means omitting the `thinking`
+     * wire param entirely — so `'none'` maps to that omission rather than to a value.
+     * Whichever provider is in play, `'none'` also re-enables `temperature`: see
+     * `checkTemperatureConflict` in `thinkingOptionsResolver.ts`.
+     *
+     * The mapping is not model-aware (same posture as every other entry in this table —
+     * see `ModelSpecKey`'s remarks for why thinking availability isn't gated at the call
+     * path). For Gemini specifically, `thinkingBudget: 0` is documented as valid only on
+     * Flash and Flash-Lite and erroring on Pro (see `IGeminiThinkingConfig.thinkingBudget`);
+     * `'none'` on a Pro-family model inherits that same caveat, exactly as an explicit
+     * `providers: [{ provider: 'google', config: { thinkingBudget: 0 } }]` block already did
+     * before this field existed.
      */
-    readonly effort?: 'low' | 'medium' | 'high';
+    readonly effort?: 'none' | 'low' | 'medium' | 'high';
     /**
      * Optional per-provider precision blocks. Blocks for providers that don't
      * match the resolved model's provider are silently skipped.