Function normalizeToCanonical

src/common/utils/ai/models.ts:36–63

(modelString: string)

 * For gateway-only vendor/model IDs, keep the original gateway-scoped identity.
 */
export function normalizeToCanonical(modelString: string): string {
  const colonIndex = modelString.indexOf(":");
  if (colonIndex === -1) {
    return modelString;
  }

  const providerName = modelString.slice(0, colonIndex) as ProviderName;
  const gatewayModelId = modelString.slice(colonIndex + 1);

  const def = PROVIDER_DEFINITIONS[providerName];
  if (def?.kind !== "gateway" || !("fromGatewayModelId" in def) || !def.fromGatewayModelId) {
    return modelString; // direct/local provider or unknown — already canonical
  }

  const parsed = def.fromGatewayModelId(gatewayModelId);
  if (!parsed) {
    return modelString; // couldn't parse
  }

  // Only normalize if the origin is a known direct provider.
  // Gateway-only models like "meta-llama/llama-3.1-405b" stay gateway-scoped.
  const originDef = PROVIDER_DEFINITIONS[parsed.origin as ProviderName];
  if (originDef?.kind !== "direct") {
    return modelString; // origin is not a known direct provider
  }

  return `${parsed.origin}:${parsed.modelId}`;
}

/**
 * Return the explicitly requested gateway provider prefix from a raw model string.