@fgv/ts-extras 5.1.0-5 → 5.1.0-50

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

@@ -0,0 +1,298 @@
+"use strict";
+// Copyright (c) 2026 Erik Fortune
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callProviderListModels = callProviderListModels;
+exports.callProxiedListModels = callProxiedListModels;
+/**
+ * Model-listing clients for AI assist. One provider dispatcher over
+ * `IAiProviderDescriptor.apiFormat`, its adapters and response validators, the
+ * capability-resolution helpers that turn a raw model id into an
+ * `IAiModelInfo`, and the proxied variant.
+ *
+ * @packageDocumentation
+ */
+const ts_utils_1 = require("@fgv/ts-utils");
+const model_1 = require("./model");
+const endpoint_1 = require("./endpoint");
+const http_1 = require("./http");
+const registry_1 = require("./registry");
+const proxiedListModelsEntry = ts_utils_1.Validators.object({
+    id: ts_utils_1.Validators.string,
+    capabilities: ts_utils_1.Validators.arrayOf(ts_utils_1.Validators.enumeratedValue(model_1.allModelCapabilities)),
+    displayName: ts_utils_1.Validators.string.optional()
+});
+const proxiedListModelsResponse = ts_utils_1.Validators.object({
+    models: ts_utils_1.Validators.arrayOf(proxiedListModelsEntry)
+});
+const openAiListEntry = ts_utils_1.Validators.object({
+    id: ts_utils_1.Validators.string
+});
+const openAiListResponse = ts_utils_1.Validators.object({
+    data: ts_utils_1.Validators.arrayOf(openAiListEntry)
+});
+const anthropicListEntry = ts_utils_1.Validators.object({
+    id: ts_utils_1.Validators.string,
+    display_name: ts_utils_1.Validators.string.optional()
+});
+const anthropicListResponse = ts_utils_1.Validators.object({
+    data: ts_utils_1.Validators.arrayOf(anthropicListEntry)
+});
+const geminiListEntry = ts_utils_1.Validators.object({
+    name: ts_utils_1.Validators.string,
+    displayName: ts_utils_1.Validators.string.optional(),
+    supportedGenerationMethods: ts_utils_1.Validators.arrayOf(ts_utils_1.Validators.string).optional()
+});
+const geminiListResponse = ts_utils_1.Validators.object({
+    models: ts_utils_1.Validators.arrayOf(geminiListEntry)
+});
+// ============================================================================
+// List models — capability resolution
+// ============================================================================
+/**
+ * Translates Gemini's `supportedGenerationMethods` strings into our abstract
+ * capability vocabulary. Methods without a mapping are ignored.
+ * @internal
+ */
+function geminiMethodsToCapabilities(methods) {
+    const out = [];
+    for (const m of methods) {
+        if (m === 'generateContent') {
+            out.push('chat');
+        }
+        else if (m === 'predict') {
+            out.push('image-generation');
+        }
+    }
+    return out;
+}
+/**
+ * Strips the `models/` prefix Gemini includes on listed model names.
+ * @internal
+ */
+function geminiBareId(name) {
+    /* c8 ignore next 1 - defensive: Gemini API always returns names prefixed with 'models/' */
+    return name.startsWith('models/') ? name.substring('models/'.length) : name;
+}
+/**
+ * Applies a capability config to a model id. Walks per-provider rules then
+ * global rules; unions all matching rules' capabilities. Returns the union
+ * and the first matching `displayName` (if any).
+ * @internal
+ */
+function applyCapabilityConfig(config, providerId, modelId) {
+    var _a, _b, _c;
+    const caps = new Set();
+    let displayName;
+    const rulesets = [
+        (_b = (_a = config.perProvider) === null || _a === void 0 ? void 0 : _a[providerId]) !== null && _b !== void 0 ? _b : [],
+        (_c = config.global) !== null && _c !== void 0 ? _c : []
+    ];
+    for (const rules of rulesets) {
+        for (const rule of rules) {
+            rule.idPattern.lastIndex = 0;
+            if (rule.idPattern.test(modelId)) {
+                for (const cap of rule.capabilities) {
+                    caps.add(cap);
+                }
+                if (displayName === undefined && rule.displayName !== undefined) {
+                    displayName = typeof rule.displayName === 'function' ? rule.displayName(modelId) : rule.displayName;
+                }
+            }
+        }
+    }
+    return { capabilities: Array.from(caps), displayName };
+}
+/**
+ * Combines provider-native capability info (when supplied) and config-derived
+ * capability info into a final {@link IAiModelInfo}.
+ * @internal
+ */
+function buildModelInfo(providerId, id, nativeCapabilities, nativeDisplayName, config) {
+    const fromConfig = applyCapabilityConfig(config, providerId, id);
+    const all = new Set([...nativeCapabilities, ...fromConfig.capabilities]);
+    return Object.assign({ id, capabilities: all }, (nativeDisplayName !== undefined
+        ? { displayName: nativeDisplayName }
+        : fromConfig.displayName !== undefined
+            ? { displayName: fromConfig.displayName }
+            : {}));
+}
+// ============================================================================
+// List models — adapters
+// ============================================================================
+/**
+ * Calls the OpenAI-style `GET /models` endpoint. Used by openai, xai-grok,
+ * groq, and mistral. Provider supplies no capability info — capabilities are
+ * derived entirely from the config.
+ * @internal
+ */
+async function callOpenAiListModels(config, providerId, capabilityConfig, logger, signal) {
+    const url = `${config.baseUrl}/models`;
+    const headers = (0, endpoint_1.bearerAuthHeader)(config.apiKey);
+    /* c8 ignore next 1 - optional logger */
+    logger === null || logger === void 0 ? void 0 : logger.info(`List models: provider=${providerId}, format=openai`);
+    const jsonResult = await (0, http_1.fetchGetJson)(url, headers, logger, signal);
+    if (jsonResult.isFailure()) {
+        return (0, ts_utils_1.fail)(jsonResult.message);
+    }
+    return openAiListResponse
+        .validate(jsonResult.value)
+        .withErrorFormat((msg) => `OpenAI models API response: ${msg}`)
+        .onSuccess((response) => {
+        const models = response.data.map((entry) => buildModelInfo(providerId, entry.id, [], undefined, capabilityConfig));
+        return (0, ts_utils_1.succeed)(models);
+    });
+}
+/**
+ * Calls the Anthropic `GET /models` endpoint. Provider supplies a
+ * `display_name` but no native capability info.
+ * @internal
+ */
+async function callAnthropicListModels(config, providerId, capabilityConfig, logger, signal) {
+    const url = `${config.baseUrl}/models`;
+    const headers = (0, endpoint_1.anthropicAuthHeaders)(config.apiKey);
+    /* c8 ignore next 1 - optional logger */
+    logger === null || logger === void 0 ? void 0 : logger.info(`List models: provider=${providerId}, format=anthropic`);
+    const jsonResult = await (0, http_1.fetchGetJson)(url, headers, logger, signal);
+    if (jsonResult.isFailure()) {
+        return (0, ts_utils_1.fail)(jsonResult.message);
+    }
+    return anthropicListResponse
+        .validate(jsonResult.value)
+        .withErrorFormat((msg) => `Anthropic models API response: ${msg}`)
+        .onSuccess((response) => {
+        const models = response.data.map((entry) => buildModelInfo(providerId, entry.id, [], entry.display_name, capabilityConfig));
+        return (0, ts_utils_1.succeed)(models);
+    });
+}
+/**
+ * Calls the Gemini `GET /models` endpoint. Provider supplies both a
+ * `displayName` and `supportedGenerationMethods` — translated to native
+ * capabilities and unioned with config-derived capabilities.
+ * @internal
+ */
+async function callGeminiListModels(config, providerId, capabilityConfig, logger, signal) {
+    const url = `${config.baseUrl}/models`;
+    const headers = (0, endpoint_1.geminiAuthHeader)(config.apiKey);
+    /* c8 ignore next 1 - optional logger */
+    logger === null || logger === void 0 ? void 0 : logger.info(`List models: provider=${providerId}, format=gemini`);
+    const jsonResult = await (0, http_1.fetchGetJson)(url, headers, logger, signal);
+    if (jsonResult.isFailure()) {
+        return (0, ts_utils_1.fail)(jsonResult.message);
+    }
+    return geminiListResponse
+        .validate(jsonResult.value)
+        .withErrorFormat((msg) => `Gemini models API response: ${msg}`)
+        .onSuccess((response) => {
+        const models = response.models.map((entry) => {
+            const id = geminiBareId(entry.name);
+            const native = entry.supportedGenerationMethods
+                ? geminiMethodsToCapabilities(entry.supportedGenerationMethods)
+                : [];
+            return buildModelInfo(providerId, id, native, entry.displayName, capabilityConfig);
+        });
+        return (0, ts_utils_1.succeed)(models);
+    });
+}
+// ============================================================================
+// List models — dispatcher
+// ============================================================================
+/**
+ * Lists models available from a provider, routing by `descriptor.apiFormat`.
+ * Capabilities are resolved from native provider info and a configurable rule set.
+ * @param params - Request parameters (descriptor, API key, optional capability filter)
+ * @public
+ */
+async function callProviderListModels(params) {
+    const { descriptor, apiKey, capability, capabilityConfig, logger, signal, endpoint } = params;
+    const baseUrlResult = (0, endpoint_1.resolveEffectiveBaseUrl)(descriptor, endpoint);
+    if (baseUrlResult.isFailure()) {
+        return (0, ts_utils_1.fail)(baseUrlResult.message);
+    }
+    const config = {
+        baseUrl: baseUrlResult.value,
+        apiKey,
+        model: '' // unused by listing
+    };
+    const effectiveConfig = capabilityConfig !== null && capabilityConfig !== void 0 ? capabilityConfig : registry_1.DEFAULT_MODEL_CAPABILITY_CONFIG;
+    let listResult;
+    switch (descriptor.apiFormat) {
+        case 'openai':
+            listResult = await callOpenAiListModels(config, descriptor.id, effectiveConfig, logger, signal);
+            break;
+        case 'anthropic':
+            listResult = await callAnthropicListModels(config, descriptor.id, effectiveConfig, logger, signal);
+            break;
+        case 'gemini':
+            listResult = await callGeminiListModels(config, descriptor.id, effectiveConfig, logger, signal);
+            break;
+        /* c8 ignore next 4 - defensive coding: exhaustive switch guaranteed by TypeScript */
+        default: {
+            const _exhaustive = descriptor.apiFormat;
+            return (0, ts_utils_1.fail)(`unsupported API format: ${String(_exhaustive)}`);
+        }
+    }
+    if (listResult.isFailure()) {
+        return listResult;
+    }
+    if (capability === undefined) {
+        return listResult;
+    }
+    return (0, ts_utils_1.succeed)(listResult.value.filter((m) => m.capabilities.has(capability)));
+}
+// ============================================================================
+// Proxied list models
+// ============================================================================
+/**
+ * Calls the model-listing endpoint on a proxy server. Endpoint:
+ * `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}`.
+ * @public
+ */
+async function callProxiedListModels(proxyUrl, params) {
+    const { descriptor, apiKey, capability, logger, signal } = params;
+    const body = {
+        providerId: descriptor.id,
+        apiKey
+    };
+    if (capability !== undefined) {
+        body.capability = capability;
+    }
+    /* c8 ignore next 1 - optional logger */
+    logger === null || logger === void 0 ? void 0 : logger.info(`AI list-models proxy request: provider=${descriptor.id}, proxy=${proxyUrl}`);
+    const url = `${proxyUrl}/api/ai/list-models`;
+    const jsonResult = await (0, http_1.fetchJson)(url, {}, body, logger, signal);
+    if (jsonResult.isFailure()) {
+        return (0, ts_utils_1.fail)(jsonResult.message);
+    }
+    const response = jsonResult.value;
+    if (typeof response.error === 'string') {
+        return (0, ts_utils_1.fail)(`proxy: ${response.error}`);
+    }
+    return proxiedListModelsResponse
+        .validate(response)
+        .withErrorFormat((msg) => `proxy returned invalid response: ${msg}`)
+        .onSuccess((parsed) => {
+        const models = parsed.models.map((m) => (Object.assign({ id: m.id, capabilities: new Set(m.capabilities) }, (m.displayName !== undefined ? { displayName: m.displayName } : {}))));
+        return (0, ts_utils_1.succeed)(models);
+    });
+}
+//# sourceMappingURL=listModelsClient.js.map

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

@@ -0,0 +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"]}