llm-strings 1.0.1 → 1.1.0

package/README.md

@@ -289,7 +289,7 @@ const issues = validate("llm://openrouter.ai/openai/o3?temp=0.7");
 | Cohere      | `api.cohere.com`                         | snake_case  |
 | AWS Bedrock | `bedrock-runtime.{region}.amazonaws.com` | camelCase   |
 | OpenRouter  | `openrouter.ai`                          | snake_case  |
-| Vercel AI   | `gateway.ai.vercel.sh`                   | snake_case  |
+| Vercel AI   | `gateway.ai.vercel.app`                  | snake_case  |
 
 Gateways like OpenRouter and Vercel route to any upstream provider. Bedrock hosts models from multiple families (Anthropic, Meta, Amazon, Mistral, Cohere, AI21) with cross-region inference support. Each provider's parameter names differ — normalization handles the translation automatically.
 
@@ -297,17 +297,32 @@ Gateways like OpenRouter and Vercel route to any upstream provider. Bedrock host
 
 Use these shortcuts in your connection strings — they expand automatically during normalization:
 
-| Shorthand                                  | Canonical            |
-| ------------------------------------------ | -------------------- |
-| `temp`                                     | `temperature`        |
-| `max`, `max_out`, `maxTokens`              | `max_tokens`         |
-| `topp`, `topP`, `nucleus`                  | `top_p`              |
-| `topk`, `topK`                             | `top_k`              |
-| `freq`, `freq_penalty`                     | `frequency_penalty`  |
-| `pres`, `pres_penalty`                     | `presence_penalty`   |
-| `stop_sequences`, `stopSequences`          | `stop`               |
-| `reasoning`, `reasoning_effort`            | `effort`             |
-| `cache_control`, `cacheControl`            | `cache`              |
+| Shorthand                                                            | Canonical            |
+| -------------------------------------------------------------------- | -------------------- |
+| `temp`                                                               | `temperature`        |
+| `max`, `max_out`, `max_output`, `max_output_tokens`, `maxTokens`, `maxOutputTokens`, `max_completion_tokens` | `max_tokens`         |
+| `topp`, `topP`, `nucleus`                                            | `top_p`              |
+| `topk`, `topK`                                                       | `top_k`              |
+| `freq`, `freq_penalty`, `frequencyPenalty`, `repetition_penalty`     | `frequency_penalty`  |
+| `pres`, `pres_penalty`, `presencePenalty`                            | `presence_penalty`   |
+| `stop_sequences`, `stopSequences`, `stop_sequence`                   | `stop`               |
+| `random_seed`, `randomSeed`                                          | `seed`               |
+| `candidateCount`, `candidate_count`, `num_completions`               | `n`                  |
+| `reasoning`, `reasoning_effort`                                      | `effort`             |
+| `cache_control`, `cacheControl`, `cachePoint`, `cache_point`         | `cache`              |
+
+## Sub-path Imports
+
+For smaller bundles, import only what you need:
+
+```ts
+import { parse, build } from "llm-strings/parse";
+import { normalize } from "llm-strings/normalize";
+import { validate } from "llm-strings/validate";
+import { detectProvider, ALIASES, PROVIDER_PARAMS, PARAM_SPECS } from "llm-strings/providers";
+```
+
+All sub-paths ship ESM + CJS with full type declarations.
 
 ## API Reference
 
@@ -355,6 +370,38 @@ Identifies the provider from a hostname string.
 
 Identifies the model family (anthropic, meta, amazon, mistral, cohere, ai21) from a Bedrock model ID. Handles cross-region (`us.`, `eu.`, `apac.`) and global inference profiles.
 
+### `detectGatewaySubProvider(model): Provider | undefined`
+
+Extracts the underlying provider from a gateway model string (e.g. `"anthropic/claude-sonnet-4-5"` → `"anthropic"`). Returns `undefined` for unknown prefixes or models without a `/`.
+
+### `isReasoningModel(model): boolean`
+
+Returns `true` for OpenAI reasoning models (o1, o3, o4 families). Handles gateway prefixes like `"openai/o3"`.
+
+### `isGatewayProvider(provider): boolean`
+
+Returns `true` for gateway providers (`openrouter`, `vercel`) that proxy to other providers.
+
+### `canHostOpenAIModels(provider): boolean`
+
+Returns `true` for providers that can route to OpenAI models and need reasoning-model checks (`openai`, `openrouter`, `vercel`).
+
+### `bedrockSupportsCaching(model): boolean`
+
+Returns `true` if the Bedrock model supports prompt caching (Claude and Nova models only).
+
+### Constants
+
+| Export | Description |
+| --- | --- |
+| `ALIASES` | Shorthand → canonical param name mapping |
+| `PROVIDER_PARAMS` | Canonical → provider-specific param names, per provider |
+| `PARAM_SPECS` | Validation rules (type, min/max, enum) per provider, keyed by provider-specific param name |
+| `REASONING_MODEL_UNSUPPORTED` | Set of canonical params unsupported by reasoning models |
+| `PROVIDER_META` | Array of provider metadata (id, name, host, brand color) for UI integrations |
+| `MODELS` | Suggested model IDs per provider |
+| `CANONICAL_PARAM_SPECS` | Canonical param specs per provider with descriptions — useful for building UIs |
+
 ## TypeScript
 
 Full type definitions ship with the package:
@@ -369,9 +416,37 @@ import type {
   ValidationIssue,
   Provider,
   BedrockModelFamily,
+  ParamSpec,
+  ProviderMeta,
+  CanonicalParamSpec,
 } from "llm-strings";
 ```
 
+## Provider Metadata (for UI integrations)
+
+The library exports metadata useful for building UIs — provider names, brand colors, suggested models, and canonical parameter specs:
+
+```ts
+import { PROVIDER_META, MODELS, CANONICAL_PARAM_SPECS } from "llm-strings";
+
+// Provider display info
+PROVIDER_META.forEach((p) => console.log(`${p.name}: ${p.host} (${p.color})`));
+// OpenAI: api.openai.com (#10a37f)
+// Anthropic: api.anthropic.com (#e8956a)
+// ...
+
+// Suggested models per provider
+MODELS.openai;    // → ["gpt-5.2", "gpt-5.2-pro", "gpt-4.1", "gpt-4.1-mini", ...]
+MODELS.anthropic; // → ["claude-opus-4-6", "claude-sonnet-4-6", "claude-sonnet-4-5", ...]
+
+// Canonical param specs — useful for building config forms
+CANONICAL_PARAM_SPECS.openai.temperature;
+// → { type: "number", min: 0, max: 2, default: 0.7, description: "Controls randomness" }
+
+CANONICAL_PARAM_SPECS.anthropic.effort;
+// → { type: "enum", values: ["low", "medium", "high", "max"], default: "medium", description: "Thinking effort" }
+```
+
 ## Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.

package/dist/chunk-6P5GSSNW.js

@@ -0,0 +1,176 @@
+// src/provider-meta.ts
+var PROVIDER_META = [
+  { id: "openai", name: "OpenAI", host: "api.openai.com", color: "#10a37f" },
+  { id: "anthropic", name: "Anthropic", host: "api.anthropic.com", color: "#e8956a" },
+  { id: "google", name: "Google", host: "generativelanguage.googleapis.com", color: "#4285f4" },
+  { id: "mistral", name: "Mistral", host: "api.mistral.ai", color: "#ff7000" },
+  { id: "cohere", name: "Cohere", host: "api.cohere.com", color: "#39594d" },
+  { id: "bedrock", name: "Bedrock", host: "bedrock-runtime.us-east-1.amazonaws.com", color: "#ff9900" },
+  { id: "openrouter", name: "OpenRouter", host: "openrouter.ai", color: "#818cf8" },
+  { id: "vercel", name: "Vercel", host: "gateway.ai.vercel.app", color: "#ededed" }
+];
+var MODELS = {
+  openai: [
+    "gpt-5.2",
+    "gpt-5.2-pro",
+    "gpt-4.1",
+    "gpt-4.1-mini",
+    "gpt-4.1-nano",
+    "o3",
+    "o3-mini",
+    "o4-mini",
+    "o1-pro"
+  ],
+  anthropic: [
+    "claude-opus-4-6",
+    "claude-sonnet-4-6",
+    "claude-sonnet-4-5",
+    "claude-haiku-4-5"
+  ],
+  google: [
+    "gemini-3-pro-preview",
+    "gemini-3-flash-preview",
+    "gemini-2.5-pro",
+    "gemini-2.5-flash"
+  ],
+  mistral: [
+    "mistral-large-latest",
+    "mistral-medium-latest",
+    "mistral-small-latest",
+    "codestral-latest",
+    "magistral-medium-latest"
+  ],
+  cohere: [
+    "command-a-03-2025",
+    "command-r-plus-08-2024",
+    "command-r-08-2024",
+    "command-r7b-12-2024"
+  ],
+  bedrock: [
+    "anthropic.claude-opus-4-6-v1",
+    "anthropic.claude-sonnet-4-6-v1",
+    "anthropic.claude-haiku-4-5-v1",
+    "amazon.nova-pro-v1",
+    "amazon.nova-lite-v1",
+    "meta.llama3-70b-instruct-v1:0"
+  ],
+  openrouter: [
+    "openai/gpt-5.2",
+    "anthropic/claude-opus-4-6",
+    "google/gemini-2.5-pro",
+    "mistral/mistral-large-latest"
+  ],
+  vercel: [
+    "openai/gpt-5.2",
+    "anthropic/claude-opus-4-6",
+    "google/gemini-2.5-pro",
+    "google/gemini-3-pro-preview",
+    "google/gemini-3-flash-preview",
+    "mistral/mistral-large-latest",
+    "qwen/qwen2.5-pro"
+  ]
+};
+var CANONICAL_PARAM_SPECS = {
+  openai: {
+    temperature: { type: "number", min: 0, max: 2, default: 0.7, description: "Controls randomness" },
+    max_tokens: { type: "number", min: 1, default: 4096, description: "Maximum output tokens" },
+    top_p: { type: "number", min: 0, max: 1, default: 1, description: "Nucleus sampling" },
+    frequency_penalty: { type: "number", min: -2, max: 2, default: 0, description: "Penalize frequent tokens" },
+    presence_penalty: { type: "number", min: -2, max: 2, default: 0, description: "Penalize repeated topics" },
+    stop: { type: "string", default: "", description: "Stop sequences" },
+    n: { type: "number", min: 1, default: 1, description: "Completions count" },
+    seed: { type: "number", default: "", description: "Random seed" },
+    stream: { type: "boolean", default: false, description: "Stream response" },
+    effort: { type: "enum", values: ["none", "minimal", "low", "medium", "high", "xhigh"], default: "medium", description: "Reasoning effort" }
+  },
+  anthropic: {
+    temperature: { type: "number", min: 0, max: 1, default: 0.7, description: "Controls randomness" },
+    max_tokens: { type: "number", min: 1, default: 4096, description: "Maximum output tokens" },
+    top_p: { type: "number", min: 0, max: 1, default: 1, description: "Nucleus sampling" },
+    top_k: { type: "number", min: 0, default: 40, description: "Top-K sampling" },
+    stop: { type: "string", default: "", description: "Stop sequences" },
+    stream: { type: "boolean", default: false, description: "Stream response" },
+    effort: { type: "enum", values: ["low", "medium", "high", "max"], default: "medium", description: "Thinking effort" },
+    cache: { type: "enum", values: ["ephemeral"], default: "ephemeral", description: "Cache control" },
+    cache_ttl: { type: "enum", values: ["5m", "1h"], default: "5m", description: "Cache TTL" }
+  },
+  google: {
+    temperature: { type: "number", min: 0, max: 2, default: 0.7, description: "Controls randomness" },
+    max_tokens: { type: "number", min: 1, default: 4096, description: "Maximum output tokens" },
+    top_p: { type: "number", min: 0, max: 1, default: 1, description: "Nucleus sampling" },
+    top_k: { type: "number", min: 0, default: 40, description: "Top-K sampling" },
+    frequency_penalty: { type: "number", min: -2, max: 2, default: 0, description: "Penalize frequent tokens" },
+    presence_penalty: { type: "number", min: -2, max: 2, default: 0, description: "Penalize repeated topics" },
+    stop: { type: "string", default: "", description: "Stop sequences" },
+    n: { type: "number", min: 1, default: 1, description: "Candidate count" },
+    stream: { type: "boolean", default: false, description: "Stream response" },
+    seed: { type: "number", default: "", description: "Random seed" }
+  },
+  mistral: {
+    temperature: { type: "number", min: 0, max: 1, default: 0.7, description: "Controls randomness" },
+    max_tokens: { type: "number", min: 1, default: 4096, description: "Maximum output tokens" },
+    top_p: { type: "number", min: 0, max: 1, default: 1, description: "Nucleus sampling" },
+    frequency_penalty: { type: "number", min: -2, max: 2, default: 0, description: "Penalize frequent tokens" },
+    presence_penalty: { type: "number", min: -2, max: 2, default: 0, description: "Penalize repeated topics" },
+    stop: { type: "string", default: "", description: "Stop sequences" },
+    n: { type: "number", min: 1, default: 1, description: "Completions count" },
+    seed: { type: "number", default: "", description: "Random seed" },
+    stream: { type: "boolean", default: false, description: "Stream response" },
+    safe_prompt: { type: "boolean", default: false, description: "Enable safe prompt" },
+    min_tokens: { type: "number", min: 0, default: 0, description: "Minimum tokens" }
+  },
+  cohere: {
+    temperature: { type: "number", min: 0, max: 1, default: 0.7, description: "Controls randomness" },
+    max_tokens: { type: "number", min: 1, default: 4096, description: "Maximum output tokens" },
+    top_p: { type: "number", min: 0, max: 1, default: 1, description: "Nucleus sampling (p)" },
+    top_k: { type: "number", min: 0, max: 500, default: 40, description: "Top-K sampling (k)" },
+    frequency_penalty: { type: "number", min: 0, max: 1, default: 0, description: "Penalize frequent tokens" },
+    presence_penalty: { type: "number", min: 0, max: 1, default: 0, description: "Penalize repeated topics" },
+    stop: { type: "string", default: "", description: "Stop sequences" },
+    stream: { type: "boolean", default: false, description: "Stream response" },
+    seed: { type: "number", default: "", description: "Random seed" }
+  },
+  bedrock: {
+    temperature: { type: "number", min: 0, max: 1, default: 0.7, description: "Controls randomness" },
+    max_tokens: { type: "number", min: 1, default: 4096, description: "Maximum output tokens" },
+    top_p: { type: "number", min: 0, max: 1, default: 1, description: "Nucleus sampling" },
+    top_k: { type: "number", min: 0, default: 40, description: "Top-K sampling" },
+    stop: { type: "string", default: "", description: "Stop sequences" },
+    stream: { type: "boolean", default: false, description: "Stream response" },
+    cache: { type: "enum", values: ["ephemeral"], default: "ephemeral", description: "Cache control" },
+    cache_ttl: { type: "enum", values: ["5m", "1h"], default: "5m", description: "Cache TTL" }
+  },
+  openrouter: {
+    temperature: { type: "number", min: 0, max: 2, default: 0.7, description: "Controls randomness" },
+    max_tokens: { type: "number", min: 1, default: 4096, description: "Maximum output tokens" },
+    top_p: { type: "number", min: 0, max: 1, default: 1, description: "Nucleus sampling" },
+    top_k: { type: "number", min: 0, default: 40, description: "Top-K sampling" },
+    frequency_penalty: { type: "number", min: -2, max: 2, default: 0, description: "Penalize frequent tokens" },
+    presence_penalty: { type: "number", min: -2, max: 2, default: 0, description: "Penalize repeated topics" },
+    stop: { type: "string", default: "", description: "Stop sequences" },
+    n: { type: "number", min: 1, default: 1, description: "Completions count" },
+    seed: { type: "number", default: "", description: "Random seed" },
+    stream: { type: "boolean", default: false, description: "Stream response" },
+    effort: { type: "enum", values: ["none", "minimal", "low", "medium", "high", "xhigh"], default: "medium", description: "Reasoning effort" }
+  },
+  vercel: {
+    temperature: { type: "number", min: 0, max: 2, default: 0.7, description: "Controls randomness" },
+    max_tokens: { type: "number", min: 1, default: 4096, description: "Maximum output tokens" },
+    top_p: { type: "number", min: 0, max: 1, default: 1, description: "Nucleus sampling" },
+    top_k: { type: "number", min: 0, default: 40, description: "Top-K sampling" },
+    frequency_penalty: { type: "number", min: -2, max: 2, default: 0, description: "Penalize frequent tokens" },
+    presence_penalty: { type: "number", min: -2, max: 2, default: 0, description: "Penalize repeated topics" },
+    stop: { type: "string", default: "", description: "Stop sequences" },
+    n: { type: "number", min: 1, default: 1, description: "Completions count" },
+    seed: { type: "number", default: "", description: "Random seed" },
+    stream: { type: "boolean", default: false, description: "Stream response" },
+    effort: { type: "enum", values: ["none", "minimal", "low", "medium", "high", "xhigh"], default: "medium", description: "Reasoning effort" }
+  }
+};
+
+export {
+  PROVIDER_META,
+  MODELS,
+  CANONICAL_PARAM_SPECS
+};
+//# sourceMappingURL=chunk-6P5GSSNW.js.map

package/dist/chunk-6P5GSSNW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/provider-meta.ts"],"sourcesContent":["import type { Provider } from \"./provider-core.js\";\n\n/* ------------------------------------------------------------------ */\n/*  UI-consumable metadata for 3rd-party integrations                 */\n/* ------------------------------------------------------------------ */\n\nexport interface ProviderMeta {\n  /** Provider identifier — matches the Provider union type. */\n  id: Provider;\n  /** Human-readable display name. */\n  name: string;\n  /** Default / canonical API hostname. */\n  host: string;\n  /** Brand color as a CSS hex value. */\n  color: string;\n}\n\nexport const PROVIDER_META: ProviderMeta[] = [\n  { id: \"openai\",     name: \"OpenAI\",     host: \"api.openai.com\",                          color: \"#10a37f\" },\n  { id: \"anthropic\",  name: \"Anthropic\",   host: \"api.anthropic.com\",                       color: \"#e8956a\" },\n  { id: \"google\",     name: \"Google\",      host: \"generativelanguage.googleapis.com\",        color: \"#4285f4\" },\n  { id: \"mistral\",    name: \"Mistral\",     host: \"api.mistral.ai\",                          color: \"#ff7000\" },\n  { id: \"cohere\",     name: \"Cohere\",      host: \"api.cohere.com\",                          color: \"#39594d\" },\n  { id: \"bedrock\",    name: \"Bedrock\",     host: \"bedrock-runtime.us-east-1.amazonaws.com\", color: \"#ff9900\" },\n  { id: \"openrouter\", name: \"OpenRouter\",  host: \"openrouter.ai\",                           color: \"#818cf8\" },\n  { id: \"vercel\",     name: \"Vercel\",      host: \"gateway.ai.vercel.app\",                   color: \"#ededed\" },\n];\n\n/**\n * Suggested / common model IDs per provider, ordered by recency.\n * Not exhaustive — providers add models frequently.\n */\nexport const MODELS: Record<Provider, string[]> = {\n  openai: [\n    \"gpt-5.2\", \"gpt-5.2-pro\",\n    \"gpt-4.1\", \"gpt-4.1-mini\", \"gpt-4.1-nano\",\n    \"o3\", \"o3-mini\", \"o4-mini\", \"o1-pro\",\n  ],\n  anthropic: [\n    \"claude-opus-4-6\", \"claude-sonnet-4-6\",\n    \"claude-sonnet-4-5\", \"claude-haiku-4-5\",\n  ],\n  google: [\n    \"gemini-3-pro-preview\", \"gemini-3-flash-preview\",\n    \"gemini-2.5-pro\", \"gemini-2.5-flash\",\n  ],\n  mistral: [\n    \"mistral-large-latest\", \"mistral-medium-latest\",\n    \"mistral-small-latest\", \"codestral-latest\",\n    \"magistral-medium-latest\",\n  ],\n  cohere: [\n    \"command-a-03-2025\",\n    \"command-r-plus-08-2024\", \"command-r-08-2024\",\n    \"command-r7b-12-2024\",\n  ],\n  bedrock: [\n    \"anthropic.claude-opus-4-6-v1\", \"anthropic.claude-sonnet-4-6-v1\",\n    \"anthropic.claude-haiku-4-5-v1\",\n    \"amazon.nova-pro-v1\", \"amazon.nova-lite-v1\",\n    \"meta.llama3-70b-instruct-v1:0\",\n  ],\n  openrouter: [\n    \"openai/gpt-5.2\", \"anthropic/claude-opus-4-6\",\n    \"google/gemini-2.5-pro\", \"mistral/mistral-large-latest\",\n  ],\n  vercel: [\n    \"openai/gpt-5.2\", \"anthropic/claude-opus-4-6\",\n    \"google/gemini-2.5-pro\", \"google/gemini-3-pro-preview\",\n    \"google/gemini-3-flash-preview\", \"mistral/mistral-large-latest\",\n    \"qwen/qwen2.5-pro\",\n  ],\n};\n\n/**\n * Canonical parameter spec — keyed by canonical (snake_case) param names\n * with defaults and descriptions for UI consumption.\n */\nexport interface CanonicalParamSpec {\n  type: \"number\" | \"string\" | \"boolean\" | \"enum\";\n  min?: number;\n  max?: number;\n  values?: string[];\n  default?: string | number | boolean;\n  description?: string;\n}\n\nexport const CANONICAL_PARAM_SPECS: Record<Provider, Record<string, CanonicalParamSpec>> = {\n  openai: {\n    temperature:       { type: \"number\",  min: 0, max: 2,  default: 0.7,  description: \"Controls randomness\" },\n    max_tokens:        { type: \"number\",  min: 1,          default: 4096, description: \"Maximum output tokens\" },\n    top_p:             { type: \"number\",  min: 0, max: 1,  default: 1,    description: \"Nucleus sampling\" },\n    frequency_penalty: { type: \"number\",  min: -2, max: 2, default: 0,    description: \"Penalize frequent tokens\" },\n    presence_penalty:  { type: \"number\",  min: -2, max: 2, default: 0,    description: \"Penalize repeated topics\" },\n    stop:              { type: \"string\",                    default: \"\",   description: \"Stop sequences\" },\n    n:                 { type: \"number\",  min: 1,           default: 1,    description: \"Completions count\" },\n    seed:              { type: \"number\",                    default: \"\",   description: \"Random seed\" },\n    stream:            { type: \"boolean\",                   default: false, description: \"Stream response\" },\n    effort:            { type: \"enum\", values: [\"none\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\"], default: \"medium\", description: \"Reasoning effort\" },\n  },\n  anthropic: {\n    temperature: { type: \"number\",  min: 0, max: 1, default: 0.7,  description: \"Controls randomness\" },\n    max_tokens:  { type: \"number\",  min: 1,         default: 4096, description: \"Maximum output tokens\" },\n    top_p:       { type: \"number\",  min: 0, max: 1, default: 1,    description: \"Nucleus sampling\" },\n    top_k:       { type: \"number\",  min: 0,         default: 40,   description: \"Top-K sampling\" },\n    stop:        { type: \"string\",                   default: \"\",   description: \"Stop sequences\" },\n    stream:      { type: \"boolean\",                  default: false, description: \"Stream response\" },\n    effort:      { type: \"enum\", values: [\"low\", \"medium\", \"high\", \"max\"], default: \"medium\", description: \"Thinking effort\" },\n    cache:       { type: \"enum\", values: [\"ephemeral\"],   default: \"ephemeral\", description: \"Cache control\" },\n    cache_ttl:   { type: \"enum\", values: [\"5m\", \"1h\"],    default: \"5m\",        description: \"Cache TTL\" },\n  },\n  google: {\n    temperature:       { type: \"number\",  min: 0, max: 2,  default: 0.7,  description: \"Controls randomness\" },\n    max_tokens:        { type: \"number\",  min: 1,          default: 4096, description: \"Maximum output tokens\" },\n    top_p:             { type: \"number\",  min: 0, max: 1,  default: 1,    description: \"Nucleus sampling\" },\n    top_k:             { type: \"number\",  min: 0,          default: 40,   description: \"Top-K sampling\" },\n    frequency_penalty: { type: \"number\",  min: -2, max: 2, default: 0,    description: \"Penalize frequent tokens\" },\n    presence_penalty:  { type: \"number\",  min: -2, max: 2, default: 0,    description: \"Penalize repeated topics\" },\n    stop:              { type: \"string\",                    default: \"\",   description: \"Stop sequences\" },\n    n:                 { type: \"number\",  min: 1,           default: 1,    description: \"Candidate count\" },\n    stream:            { type: \"boolean\",                   default: false, description: \"Stream response\" },\n    seed:              { type: \"number\",                    default: \"\",   description: \"Random seed\" },\n  },\n  mistral: {\n    temperature:       { type: \"number\",  min: 0, max: 1,  default: 0.7,  description: \"Controls randomness\" },\n    max_tokens:        { type: \"number\",  min: 1,          default: 4096, description: \"Maximum output tokens\" },\n    top_p:             { type: \"number\",  min: 0, max: 1,  default: 1,    description: \"Nucleus sampling\" },\n    frequency_penalty: { type: \"number\",  min: -2, max: 2, default: 0,    description: \"Penalize frequent tokens\" },\n    presence_penalty:  { type: \"number\",  min: -2, max: 2, default: 0,    description: \"Penalize repeated topics\" },\n    stop:              { type: \"string\",                    default: \"\",   description: \"Stop sequences\" },\n    n:                 { type: \"number\",  min: 1,           default: 1,    description: \"Completions count\" },\n    seed:              { type: \"number\",                    default: \"\",   description: \"Random seed\" },\n    stream:            { type: \"boolean\",                   default: false, description: \"Stream response\" },\n    safe_prompt:       { type: \"boolean\",                   default: false, description: \"Enable safe prompt\" },\n    min_tokens:        { type: \"number\",  min: 0,          default: 0,    description: \"Minimum tokens\" },\n  },\n  cohere: {\n    temperature:       { type: \"number\",  min: 0, max: 1,       default: 0.7,  description: \"Controls randomness\" },\n    max_tokens:        { type: \"number\",  min: 1,               default: 4096, description: \"Maximum output tokens\" },\n    top_p:             { type: \"number\",  min: 0, max: 1,       default: 1,    description: \"Nucleus sampling (p)\" },\n    top_k:             { type: \"number\",  min: 0, max: 500,     default: 40,   description: \"Top-K sampling (k)\" },\n    frequency_penalty: { type: \"number\",  min: 0, max: 1,       default: 0,    description: \"Penalize frequent tokens\" },\n    presence_penalty:  { type: \"number\",  min: 0, max: 1,       default: 0,    description: \"Penalize repeated topics\" },\n    stop:              { type: \"string\",                         default: \"\",   description: \"Stop sequences\" },\n    stream:            { type: \"boolean\",                        default: false, description: \"Stream response\" },\n    seed:              { type: \"number\",                         default: \"\",   description: \"Random seed\" },\n  },\n  bedrock: {\n    temperature: { type: \"number\",  min: 0, max: 1, default: 0.7,  description: \"Controls randomness\" },\n    max_tokens:  { type: \"number\",  min: 1,         default: 4096, description: \"Maximum output tokens\" },\n    top_p:       { type: \"number\",  min: 0, max: 1, default: 1,    description: \"Nucleus sampling\" },\n    top_k:       { type: \"number\",  min: 0,         default: 40,   description: \"Top-K sampling\" },\n    stop:        { type: \"string\",                   default: \"\",   description: \"Stop sequences\" },\n    stream:      { type: \"boolean\",                  default: false, description: \"Stream response\" },\n    cache:       { type: \"enum\", values: [\"ephemeral\"],   default: \"ephemeral\", description: \"Cache control\" },\n    cache_ttl:   { type: \"enum\", values: [\"5m\", \"1h\"],    default: \"5m\",        description: \"Cache TTL\" },\n  },\n  openrouter: {\n    temperature:       { type: \"number\",  min: 0, max: 2,  default: 0.7,  description: \"Controls randomness\" },\n    max_tokens:        { type: \"number\",  min: 1,          default: 4096, description: \"Maximum output tokens\" },\n    top_p:             { type: \"number\",  min: 0, max: 1,  default: 1,    description: \"Nucleus sampling\" },\n    top_k:             { type: \"number\",  min: 0,          default: 40,   description: \"Top-K sampling\" },\n    frequency_penalty: { type: \"number\",  min: -2, max: 2, default: 0,    description: \"Penalize frequent tokens\" },\n    presence_penalty:  { type: \"number\",  min: -2, max: 2, default: 0,    description: \"Penalize repeated topics\" },\n    stop:              { type: \"string\",                    default: \"\",   description: \"Stop sequences\" },\n    n:                 { type: \"number\",  min: 1,           default: 1,    description: \"Completions count\" },\n    seed:              { type: \"number\",                    default: \"\",   description: \"Random seed\" },\n    stream:            { type: \"boolean\",                   default: false, description: \"Stream response\" },\n    effort:            { type: \"enum\", values: [\"none\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\"], default: \"medium\", description: \"Reasoning effort\" },\n  },\n  vercel: {\n    temperature:       { type: \"number\",  min: 0, max: 2,  default: 0.7,  description: \"Controls randomness\" },\n    max_tokens:        { type: \"number\",  min: 1,          default: 4096, description: \"Maximum output tokens\" },\n    top_p:             { type: \"number\",  min: 0, max: 1,  default: 1,    description: \"Nucleus sampling\" },\n    top_k:             { type: \"number\",  min: 0,          default: 40,   description: \"Top-K sampling\" },\n    frequency_penalty: { type: \"number\",  min: -2, max: 2, default: 0,    description: \"Penalize frequent tokens\" },\n    presence_penalty:  { type: \"number\",  min: -2, max: 2, default: 0,    description: \"Penalize repeated topics\" },\n    stop:              { type: \"string\",                    default: \"\",   description: \"Stop sequences\" },\n    n:                 { type: \"number\",  min: 1,           default: 1,    description: \"Completions count\" },\n    seed:              { type: \"number\",                    default: \"\",   description: \"Random seed\" },\n    stream:            { type: \"boolean\",                   default: false, description: \"Stream response\" },\n    effort:            { type: \"enum\", values: [\"none\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\"], default: \"medium\", description: \"Reasoning effort\" },\n  },\n};\n"],"mappings":"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","names":[]}

package/dist/chunk-FCEV23OT.js

@@ -0,0 +1,37 @@
+// src/parse.ts
+function parse(connectionString) {
+  const url = new URL(connectionString);
+  if (url.protocol !== "llm:") {
+    throw new Error(
+      `Invalid scheme: expected "llm://", got "${url.protocol}//"`
+    );
+  }
+  const host = url.hostname;
+  const model = url.pathname.replace(/^\//, "");
+  const label = url.username || void 0;
+  const apiKey = url.password || void 0;
+  const params = {};
+  for (const [key, value] of url.searchParams) {
+    params[key] = value;
+  }
+  return {
+    raw: connectionString,
+    host,
+    model,
+    label,
+    apiKey,
+    params
+  };
+}
+function build(config) {
+  const auth = config.label || config.apiKey ? `${config.label ?? ""}${config.apiKey ? `:${config.apiKey}` : ""}@` : "";
+  const query = new URLSearchParams(config.params).toString();
+  const qs = query ? `?${query}` : "";
+  return `llm://${auth}${config.host}/${config.model}${qs}`;
+}
+
+export {
+  parse,
+  build
+};
+//# sourceMappingURL=chunk-FCEV23OT.js.map

package/dist/chunk-FCEV23OT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/parse.ts"],"sourcesContent":["export interface LlmConnectionConfig {\n  /** The original connection string */\n  raw: string;\n  /** Provider's API base URL (e.g. \"api.openai.com\") */\n  host: string;\n  /** Model name (e.g. \"gpt-5.2\") */\n  model: string;\n  /** Optional label or app name */\n  label?: string;\n  /** Optional API key or password */\n  apiKey?: string;\n  /** Additional config parameters (temp, max_tokens, etc.) */\n  params: Record<string, string>;\n}\n\n/**\n * Parse an LLM connection string into its component parts.\n *\n * Format: `llm://[label[:apiKey]@]host/model[?key=value&...]`\n *\n * @example\n * ```ts\n * parse(\"llm://api.openai.com/gpt-5.2?temp=0.7&max_tokens=1500\")\n * parse(\"llm://app-name:sk-proj-123456@api.openai.com/gpt-5.2?temp=0.7\")\n * ```\n */\nexport function parse(connectionString: string): LlmConnectionConfig {\n  const url = new URL(connectionString);\n\n  if (url.protocol !== \"llm:\") {\n    throw new Error(\n      `Invalid scheme: expected \"llm://\", got \"${url.protocol}//\"`,\n    );\n  }\n\n  const host = url.hostname;\n  const model = url.pathname.replace(/^\\//, \"\");\n  const label = url.username || undefined;\n  const apiKey = url.password || undefined;\n\n  const params: Record<string, string> = {};\n  for (const [key, value] of url.searchParams) {\n    params[key] = value;\n  }\n\n  return {\n    raw: connectionString,\n    host,\n    model,\n    label,\n    apiKey,\n    params,\n  };\n}\n\n/**\n * Build an LLM connection string from a config object.\n */\nexport function build(config: Omit<LlmConnectionConfig, \"raw\">): string {\n  const auth =\n    config.label || config.apiKey\n      ? `${config.label ?? \"\"}${config.apiKey ? `:${config.apiKey}` : \"\"}@`\n      : \"\";\n\n  const query = new URLSearchParams(config.params).toString();\n  const qs = query ? `?${query}` : \"\";\n\n  return `llm://${auth}${config.host}/${config.model}${qs}`;\n}\n"],"mappings":";AA0BO,SAAS,MAAM,kBAA+C;AACnE,QAAM,MAAM,IAAI,IAAI,gBAAgB;AAEpC,MAAI,IAAI,aAAa,QAAQ;AAC3B,UAAM,IAAI;AAAA,MACR,2CAA2C,IAAI,QAAQ;AAAA,IACzD;AAAA,EACF;AAEA,QAAM,OAAO,IAAI;AACjB,QAAM,QAAQ,IAAI,SAAS,QAAQ,OAAO,EAAE;AAC5C,QAAM,QAAQ,IAAI,YAAY;AAC9B,QAAM,SAAS,IAAI,YAAY;AAE/B,QAAM,SAAiC,CAAC;AACxC,aAAW,CAAC,KAAK,KAAK,KAAK,IAAI,cAAc;AAC3C,WAAO,GAAG,IAAI;AAAA,EAChB;AAEA,SAAO;AAAA,IACL,KAAK;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAKO,SAAS,MAAM,QAAkD;AACtE,QAAM,OACJ,OAAO,SAAS,OAAO,SACnB,GAAG,OAAO,SAAS,EAAE,GAAG,OAAO,SAAS,IAAI,OAAO,MAAM,KAAK,EAAE,MAChE;AAEN,QAAM,QAAQ,IAAI,gBAAgB,OAAO,MAAM,EAAE,SAAS;AAC1D,QAAM,KAAK,QAAQ,IAAI,KAAK,KAAK;AAEjC,SAAO,SAAS,IAAI,GAAG,OAAO,IAAI,IAAI,OAAO,KAAK,GAAG,EAAE;AACzD;","names":[]}

package/dist/chunk-MGWGNZDJ.cjs

@@ -0,0 +1,116 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+
+
+
+
+
+
+
+
+
+var _chunkNSCBY4VDcjs = require('./chunk-NSCBY4VD.cjs');
+
+// src/normalize.ts
+function normalize(config, options = {}) {
+  const provider = _chunkNSCBY4VDcjs.detectProvider.call(void 0, config.host);
+  const subProvider = provider && _chunkNSCBY4VDcjs.isGatewayProvider.call(void 0, provider) ? _chunkNSCBY4VDcjs.detectGatewaySubProvider.call(void 0, config.model) : void 0;
+  const changes = [];
+  const params = {};
+  for (const [rawKey, value] of Object.entries(config.params)) {
+    let key = rawKey;
+    if (_chunkNSCBY4VDcjs.ALIASES[key]) {
+      const canonical = _chunkNSCBY4VDcjs.ALIASES[key];
+      if (options.verbose) {
+        changes.push({
+          from: key,
+          to: canonical,
+          value,
+          reason: `alias: "${key}" \u2192 "${canonical}"`
+        });
+      }
+      key = canonical;
+    }
+    if (key === "cache" && provider) {
+      let cacheValue = _chunkNSCBY4VDcjs.CACHE_VALUES[provider];
+      if (provider === "bedrock" && !_chunkNSCBY4VDcjs.bedrockSupportsCaching.call(void 0, config.model)) {
+        cacheValue = void 0;
+      }
+      if (!cacheValue) {
+        if (options.verbose) {
+          changes.push({
+            from: "cache",
+            to: "(dropped)",
+            value,
+            reason: `${provider} does not use a cache param for this model (caching is automatic or unsupported)`
+          });
+        }
+        continue;
+      }
+      const isBool = value === "true" || value === "1" || value === "yes";
+      const isDuration = _chunkNSCBY4VDcjs.DURATION_RE.test(value);
+      if (isBool || isDuration) {
+        const providerKey = _nullishCoalesce(_optionalChain([_chunkNSCBY4VDcjs.PROVIDER_PARAMS, 'access', _ => _[provider], 'optionalAccess', _2 => _2["cache"]]), () => ( "cache"));
+        if (options.verbose) {
+          changes.push({
+            from: "cache",
+            to: providerKey,
+            value: cacheValue,
+            reason: `cache=${value} \u2192 ${providerKey}=${cacheValue} for ${provider}`
+          });
+        }
+        params[providerKey] = cacheValue;
+        if (isDuration && _chunkNSCBY4VDcjs.CACHE_TTLS[provider]) {
+          if (options.verbose) {
+            changes.push({
+              from: "cache",
+              to: "cache_ttl",
+              value,
+              reason: `cache=${value} \u2192 cache_ttl=${value} for ${provider}`
+            });
+          }
+          params["cache_ttl"] = value;
+        }
+        continue;
+      }
+    }
+    if (provider && _chunkNSCBY4VDcjs.PROVIDER_PARAMS[provider]) {
+      const providerKey = _chunkNSCBY4VDcjs.PROVIDER_PARAMS[provider][key];
+      if (providerKey && providerKey !== key) {
+        if (options.verbose) {
+          changes.push({
+            from: key,
+            to: providerKey,
+            value,
+            reason: `${provider} uses "${providerKey}" instead of "${key}"`
+          });
+        }
+        key = providerKey;
+      }
+    }
+    if (provider && _chunkNSCBY4VDcjs.canHostOpenAIModels.call(void 0, provider) && _chunkNSCBY4VDcjs.isReasoningModel.call(void 0, config.model) && key === "max_tokens") {
+      if (options.verbose) {
+        changes.push({
+          from: "max_tokens",
+          to: "max_completion_tokens",
+          value,
+          reason: "OpenAI reasoning models use max_completion_tokens instead of max_tokens"
+        });
+      }
+      key = "max_completion_tokens";
+    }
+    params[key] = value;
+  }
+  return {
+    config: { ...config, params },
+    provider,
+    subProvider,
+    changes
+  };
+}
+
+
+
+exports.normalize = normalize;
+//# sourceMappingURL=chunk-MGWGNZDJ.cjs.map

package/dist/chunk-MGWGNZDJ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/dan/code/oss/llm-strings/dist/chunk-MGWGNZDJ.cjs","../src/normalize.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACA;ACgCO,SAAS,SAAA,CACd,MAAA,EACA,QAAA,EAA4B,CAAC,CAAA,EACZ;AACjB,EAAA,MAAM,SAAA,EAAW,8CAAA,MAAe,CAAO,IAAI,CAAA;AAC3C,EAAA,MAAM,YAAA,EACJ,SAAA,GAAY,iDAAA,QAA0B,EAAA,EAClC,wDAAA,MAAyB,CAAO,KAAK,EAAA,EACrC,KAAA,CAAA;AACN,EAAA,MAAM,QAAA,EAA6B,CAAC,CAAA;AACpC,EAAA,MAAM,OAAA,EAAiC,CAAC,CAAA;AAExC,EAAA,IAAA,CAAA,MAAW,CAAC,MAAA,EAAQ,KAAK,EAAA,GAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,CAAO,MAAM,CAAA,EAAG;AAC3D,IAAA,IAAI,IAAA,EAAM,MAAA;AAGV,IAAA,GAAA,CAAI,yBAAA,CAAQ,GAAG,CAAA,EAAG;AAChB,MAAA,MAAM,UAAA,EAAY,yBAAA,CAAQ,GAAG,CAAA;AAC7B,MAAA,GAAA,CAAI,OAAA,CAAQ,OAAA,EAAS;AACnB,QAAA,OAAA,CAAQ,IAAA,CAAK;AAAA,UACX,IAAA,EAAM,GAAA;AAAA,UACN,EAAA,EAAI,SAAA;AAAA,UACJ,KAAA;AAAA,UACA,MAAA,EAAQ,CAAA,QAAA,EAAW,GAAG,CAAA,UAAA,EAAQ,SAAS,CAAA,CAAA;AAAA,QACzC,CAAC,CAAA;AAAA,MACH;AACA,MAAA,IAAA,EAAM,SAAA;AAAA,IACR;AAGA,IAAA,GAAA,CAAI,IAAA,IAAQ,QAAA,GAAW,QAAA,EAAU;AAC/B,MAAA,IAAI,WAAA,EAAa,8BAAA,CAAa,QAAQ,CAAA;AAGtC,MAAA,GAAA,CAAI,SAAA,IAAa,UAAA,GAAa,CAAC,sDAAA,MAAuB,CAAO,KAAK,CAAA,EAAG;AACnE,QAAA,WAAA,EAAa,KAAA,CAAA;AAAA,MACf;AAGA,MAAA,GAAA,CAAI,CAAC,UAAA,EAAY;AACf,QAAA,GAAA,CAAI,OAAA,CAAQ,OAAA,EAAS;AACnB,UAAA,OAAA,CAAQ,IAAA,CAAK;AAAA,YACX,IAAA,EAAM,OAAA;AAAA,YACN,EAAA,EAAI,WAAA;AAAA,YACJ,KAAA;AAAA,YACA,MAAA,EAAQ,CAAA,EAAA;AACT,UAAA;AACH,QAAA;AACA,QAAA;AACF,MAAA;AAEe,MAAA;AACT,MAAA;AAEQ,MAAA;AACN,QAAA;AAEM,QAAA;AACF,UAAA;AACA,YAAA;AACF,YAAA;AACG,YAAA;AACC,YAAA;AACT,UAAA;AACH,QAAA;AACO,QAAA;AAGH,QAAA;AACE,UAAA;AACM,YAAA;AACA,cAAA;AACF,cAAA;AACJ,cAAA;AACA,cAAA;AACD,YAAA;AACH,UAAA;AACO,UAAA;AACT,QAAA;AACA,QAAA;AACF,MAAA;AACF,IAAA;AAGgB,IAAA;AACR,MAAA;AACF,MAAA;AACU,QAAA;AACF,UAAA;AACA,YAAA;AACF,YAAA;AACJ,YAAA;AACQ,YAAA;AACT,UAAA;AACH,QAAA;AACM,QAAA;AACR,MAAA;AACF,IAAA;AAKE,IAAA;AAIY,MAAA;AACG,QAAA;AACL,UAAA;AACF,UAAA;AACJ,UAAA;AAEE,UAAA;AACH,QAAA;AACH,MAAA;AACM,MAAA;AACR,IAAA;AAEc,IAAA;AAChB,EAAA;AAEO,EAAA;AACQ,IAAA;AACb,IAAA;AACA,IAAA;AACA,IAAA;AACF,EAAA;AACF;AD9DqB;AACA;AACA;AACA","file":"/Users/dan/code/oss/llm-strings/dist/chunk-MGWGNZDJ.cjs","sourcesContent":[null,"import type { LlmConnectionConfig } from \"./parse.js\";\nimport {\n  ALIASES,\n  CACHE_TTLS,\n  CACHE_VALUES,\n  DURATION_RE,\n  PROVIDER_PARAMS,\n  bedrockSupportsCaching,\n  canHostOpenAIModels,\n  detectGatewaySubProvider,\n  detectProvider,\n  isGatewayProvider,\n  isReasoningModel,\n  type Provider,\n} from \"./provider-core.js\";\n\nexport interface NormalizeChange {\n  from: string;\n  to: string;\n  value: string;\n  reason: string;\n}\n\nexport interface NormalizeResult {\n  config: LlmConnectionConfig;\n  provider: Provider | undefined;\n  /** Underlying provider extracted from gateway model prefix (e.g. \"anthropic\" from \"anthropic/claude-sonnet-4-5\"). */\n  subProvider: Provider | undefined;\n  changes: NormalizeChange[];\n}\n\nexport interface NormalizeOptions {\n  /** Include detailed change log in the result. */\n  verbose?: boolean;\n}\n\n/**\n * Normalize an LLM connection config's params for its target provider.\n *\n * 1. Expands shorthand aliases (e.g. `temp` → `temperature`)\n * 2. Maps canonical param names to provider-specific names\n *    (e.g. `max_tokens` → `maxOutputTokens` for Google)\n * 3. Normalizes special values (e.g. `cache=true` → `cache_control=ephemeral` for Anthropic)\n * 4. For OpenAI reasoning models, remaps `max_tokens` → `max_completion_tokens`\n *    and warns about unsupported sampling params\n */\nexport function normalize(\n  config: LlmConnectionConfig,\n  options: NormalizeOptions = {},\n): NormalizeResult {\n  const provider = detectProvider(config.host);\n  const subProvider =\n    provider && isGatewayProvider(provider)\n      ? detectGatewaySubProvider(config.model)\n      : undefined;\n  const changes: NormalizeChange[] = [];\n  const params: Record<string, string> = {};\n\n  for (const [rawKey, value] of Object.entries(config.params)) {\n    let key = rawKey;\n\n    // Step 1: Expand aliases to canonical name\n    if (ALIASES[key]) {\n      const canonical = ALIASES[key];\n      if (options.verbose) {\n        changes.push({\n          from: key,\n          to: canonical,\n          value,\n          reason: `alias: \"${key}\" → \"${canonical}\"`,\n        });\n      }\n      key = canonical;\n    }\n\n    // Step 2: Handle special \"cache\" param\n    if (key === \"cache\" && provider) {\n      let cacheValue = CACHE_VALUES[provider];\n\n      // Bedrock supports cache for Anthropic Claude and Amazon Nova models\n      if (provider === \"bedrock\" && !bedrockSupportsCaching(config.model)) {\n        cacheValue = undefined;\n      }\n\n      // Provider/model doesn't support cache — drop it\n      if (!cacheValue) {\n        if (options.verbose) {\n          changes.push({\n            from: \"cache\",\n            to: \"(dropped)\",\n            value,\n            reason: `${provider} does not use a cache param for this model (caching is automatic or unsupported)`,\n          });\n        }\n        continue;\n      }\n\n      const isBool = value === \"true\" || value === \"1\" || value === \"yes\";\n      const isDuration = DURATION_RE.test(value);\n\n      if (isBool || isDuration) {\n        const providerKey =\n          PROVIDER_PARAMS[provider]?.[\"cache\"] ?? \"cache\";\n        if (options.verbose) {\n          changes.push({\n            from: \"cache\",\n            to: providerKey,\n            value: cacheValue,\n            reason: `cache=${value} → ${providerKey}=${cacheValue} for ${provider}`,\n          });\n        }\n        params[providerKey] = cacheValue;\n\n        // Emit cache_ttl when a duration is specified\n        if (isDuration && CACHE_TTLS[provider]) {\n          if (options.verbose) {\n            changes.push({\n              from: \"cache\",\n              to: \"cache_ttl\",\n              value,\n              reason: `cache=${value} → cache_ttl=${value} for ${provider}`,\n            });\n          }\n          params[\"cache_ttl\"] = value;\n        }\n        continue;\n      }\n    }\n\n    // Step 3: Map canonical → provider-specific param name\n    if (provider && PROVIDER_PARAMS[provider]) {\n      const providerKey = PROVIDER_PARAMS[provider][key];\n      if (providerKey && providerKey !== key) {\n        if (options.verbose) {\n          changes.push({\n            from: key,\n            to: providerKey,\n            value,\n            reason: `${provider} uses \"${providerKey}\" instead of \"${key}\"`,\n          });\n        }\n        key = providerKey;\n      }\n    }\n\n    // Step 4: OpenAI reasoning model adjustments (direct or via gateway)\n    if (\n      provider &&\n      canHostOpenAIModels(provider) &&\n      isReasoningModel(config.model) &&\n      key === \"max_tokens\"\n    ) {\n      if (options.verbose) {\n        changes.push({\n          from: \"max_tokens\",\n          to: \"max_completion_tokens\",\n          value,\n          reason:\n            \"OpenAI reasoning models use max_completion_tokens instead of max_tokens\",\n        });\n      }\n      key = \"max_completion_tokens\";\n    }\n\n    params[key] = value;\n  }\n\n  return {\n    config: { ...config, params },\n    provider,\n    subProvider,\n    changes,\n  };\n}\n"]}

package/dist/chunk-MPIHGH6L.js

@@ -0,0 +1,116 @@
+import {
+  ALIASES,
+  CACHE_TTLS,
+  CACHE_VALUES,
+  DURATION_RE,
+  PROVIDER_PARAMS,
+  bedrockSupportsCaching,
+  canHostOpenAIModels,
+  detectGatewaySubProvider,
+  detectProvider,
+  isGatewayProvider,
+  isReasoningModel
+} from "./chunk-XID353H7.js";
+
+// src/normalize.ts
+function normalize(config, options = {}) {
+  const provider = detectProvider(config.host);
+  const subProvider = provider && isGatewayProvider(provider) ? detectGatewaySubProvider(config.model) : void 0;
+  const changes = [];
+  const params = {};
+  for (const [rawKey, value] of Object.entries(config.params)) {
+    let key = rawKey;
+    if (ALIASES[key]) {
+      const canonical = ALIASES[key];
+      if (options.verbose) {
+        changes.push({
+          from: key,
+          to: canonical,
+          value,
+          reason: `alias: "${key}" \u2192 "${canonical}"`
+        });
+      }
+      key = canonical;
+    }
+    if (key === "cache" && provider) {
+      let cacheValue = CACHE_VALUES[provider];
+      if (provider === "bedrock" && !bedrockSupportsCaching(config.model)) {
+        cacheValue = void 0;
+      }
+      if (!cacheValue) {
+        if (options.verbose) {
+          changes.push({
+            from: "cache",
+            to: "(dropped)",
+            value,
+            reason: `${provider} does not use a cache param for this model (caching is automatic or unsupported)`
+          });
+        }
+        continue;
+      }
+      const isBool = value === "true" || value === "1" || value === "yes";
+      const isDuration = DURATION_RE.test(value);
+      if (isBool || isDuration) {
+        const providerKey = PROVIDER_PARAMS[provider]?.["cache"] ?? "cache";
+        if (options.verbose) {
+          changes.push({
+            from: "cache",
+            to: providerKey,
+            value: cacheValue,
+            reason: `cache=${value} \u2192 ${providerKey}=${cacheValue} for ${provider}`
+          });
+        }
+        params[providerKey] = cacheValue;
+        if (isDuration && CACHE_TTLS[provider]) {
+          if (options.verbose) {
+            changes.push({
+              from: "cache",
+              to: "cache_ttl",
+              value,
+              reason: `cache=${value} \u2192 cache_ttl=${value} for ${provider}`
+            });
+          }
+          params["cache_ttl"] = value;
+        }
+        continue;
+      }
+    }
+    if (provider && PROVIDER_PARAMS[provider]) {
+      const providerKey = PROVIDER_PARAMS[provider][key];
+      if (providerKey && providerKey !== key) {
+        if (options.verbose) {
+          changes.push({
+            from: key,
+            to: providerKey,
+            value,
+            reason: `${provider} uses "${providerKey}" instead of "${key}"`
+          });
+        }
+        key = providerKey;
+      }
+    }
+    if (provider && canHostOpenAIModels(provider) && isReasoningModel(config.model) && key === "max_tokens") {
+      if (options.verbose) {
+        changes.push({
+          from: "max_tokens",
+          to: "max_completion_tokens",
+          value,
+          reason: "OpenAI reasoning models use max_completion_tokens instead of max_tokens"
+        });
+      }
+      key = "max_completion_tokens";
+    }
+    params[key] = value;
+  }
+  return {
+    config: { ...config, params },
+    provider,
+    subProvider,
+    changes
+  };
+}
+
+export {
+  normalize
+};
+//# sourceMappingURL=chunk-MPIHGH6L.js.map