llm-strings 1.0.1 → 1.1.1

package/README.md

@@ -247,7 +247,8 @@ const url = build({
 ### AWS Bedrock with cross-region inference
 
 ```ts
-import { parse, normalize, detectBedrockModelFamily } from "llm-strings";
+import { parse, normalize } from "llm-strings";
+import { detectBedrockModelFamily } from "llm-strings/providers";
 
 const config = parse(
   "llm://bedrock-runtime.us-east-1.amazonaws.com/us.anthropic.claude-sonnet-4-5-20250929-v1:0?temp=0.5&max=4096"
@@ -289,7 +290,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 +298,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,11 +371,44 @@ 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:
 
 ```ts
+// Core types from the main entry
 import type {
   LlmConnectionConfig,
   NormalizeResult,
@@ -367,9 +416,41 @@ import type {
   NormalizeOptions,
   ValidateOptions,
   ValidationIssue,
+} from "llm-strings";
+
+// Provider types from the providers sub-path
+import type {
   Provider,
   BedrockModelFamily,
-} from "llm-strings";
+  ParamSpec,
+  ProviderMeta,
+  CanonicalParamSpec,
+} from "llm-strings/providers";
+```
+
+## 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/providers";
+
+// 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

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

package/dist/chunk-MPIHGH6L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/normalize.ts"],"sourcesContent":["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"],"mappings":";;;;;;;;;;;;;;;AA8CO,SAAS,UACd,QACA,UAA4B,CAAC,GACZ;AACjB,QAAM,WAAW,eAAe,OAAO,IAAI;AAC3C,QAAM,cACJ,YAAY,kBAAkB,QAAQ,IAClC,yBAAyB,OAAO,KAAK,IACrC;AACN,QAAM,UAA6B,CAAC;AACpC,QAAM,SAAiC,CAAC;AAExC,aAAW,CAAC,QAAQ,KAAK,KAAK,OAAO,QAAQ,OAAO,MAAM,GAAG;AAC3D,QAAI,MAAM;AAGV,QAAI,QAAQ,GAAG,GAAG;AAChB,YAAM,YAAY,QAAQ,GAAG;AAC7B,UAAI,QAAQ,SAAS;AACnB,gBAAQ,KAAK;AAAA,UACX,MAAM;AAAA,UACN,IAAI;AAAA,UACJ;AAAA,UACA,QAAQ,WAAW,GAAG,aAAQ,SAAS;AAAA,QACzC,CAAC;AAAA,MACH;AACA,YAAM;AAAA,IACR;AAGA,QAAI,QAAQ,WAAW,UAAU;AAC/B,UAAI,aAAa,aAAa,QAAQ;AAGtC,UAAI,aAAa,aAAa,CAAC,uBAAuB,OAAO,KAAK,GAAG;AACnE,qBAAa;AAAA,MACf;AAGA,UAAI,CAAC,YAAY;AACf,YAAI,QAAQ,SAAS;AACnB,kBAAQ,KAAK;AAAA,YACX,MAAM;AAAA,YACN,IAAI;AAAA,YACJ;AAAA,YACA,QAAQ,GAAG,QAAQ;AAAA,UACrB,CAAC;AAAA,QACH;AACA;AAAA,MACF;AAEA,YAAM,SAAS,UAAU,UAAU,UAAU,OAAO,UAAU;AAC9D,YAAM,aAAa,YAAY,KAAK,KAAK;AAEzC,UAAI,UAAU,YAAY;AACxB,cAAM,cACJ,gBAAgB,QAAQ,IAAI,OAAO,KAAK;AAC1C,YAAI,QAAQ,SAAS;AACnB,kBAAQ,KAAK;AAAA,YACX,MAAM;AAAA,YACN,IAAI;AAAA,YACJ,OAAO;AAAA,YACP,QAAQ,SAAS,KAAK,WAAM,WAAW,IAAI,UAAU,QAAQ,QAAQ;AAAA,UACvE,CAAC;AAAA,QACH;AACA,eAAO,WAAW,IAAI;AAGtB,YAAI,cAAc,WAAW,QAAQ,GAAG;AACtC,cAAI,QAAQ,SAAS;AACnB,oBAAQ,KAAK;AAAA,cACX,MAAM;AAAA,cACN,IAAI;AAAA,cACJ;AAAA,cACA,QAAQ,SAAS,KAAK,qBAAgB,KAAK,QAAQ,QAAQ;AAAA,YAC7D,CAAC;AAAA,UACH;AACA,iBAAO,WAAW,IAAI;AAAA,QACxB;AACA;AAAA,MACF;AAAA,IACF;AAGA,QAAI,YAAY,gBAAgB,QAAQ,GAAG;AACzC,YAAM,cAAc,gBAAgB,QAAQ,EAAE,GAAG;AACjD,UAAI,eAAe,gBAAgB,KAAK;AACtC,YAAI,QAAQ,SAAS;AACnB,kBAAQ,KAAK;AAAA,YACX,MAAM;AAAA,YACN,IAAI;AAAA,YACJ;AAAA,YACA,QAAQ,GAAG,QAAQ,UAAU,WAAW,iBAAiB,GAAG;AAAA,UAC9D,CAAC;AAAA,QACH;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAGA,QACE,YACA,oBAAoB,QAAQ,KAC5B,iBAAiB,OAAO,KAAK,KAC7B,QAAQ,cACR;AACA,UAAI,QAAQ,SAAS;AACnB,gBAAQ,KAAK;AAAA,UACX,MAAM;AAAA,UACN,IAAI;AAAA,UACJ;AAAA,UACA,QACE;AAAA,QACJ,CAAC;AAAA,MACH;AACA,YAAM;AAAA,IACR;AAEA,WAAO,GAAG,IAAI;AAAA,EAChB;AAEA,SAAO;AAAA,IACL,QAAQ,EAAE,GAAG,QAAQ,OAAO;AAAA,IAC5B;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-N6NVBE43.cjs

@@ -0,0 +1,37 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// 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 ? `${_nullishCoalesce(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}`;
+}
+
+
+
+
+exports.parse = parse; exports.build = build;
+//# sourceMappingURL=chunk-N6NVBE43.cjs.map

package/dist/chunk-N6NVBE43.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/dan/code/oss/llm-strings/dist/chunk-N6NVBE43.cjs","../src/parse.ts"],"names":[],"mappings":"AAAA;AC0BO,SAAS,KAAA,CAAM,gBAAA,EAA+C;AACnE,EAAA,MAAM,IAAA,EAAM,IAAI,GAAA,CAAI,gBAAgB,CAAA;AAEpC,EAAA,GAAA,CAAI,GAAA,CAAI,SAAA,IAAa,MAAA,EAAQ;AAC3B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,wCAAA,EAA2C,GAAA,CAAI,QAAQ,CAAA,GAAA;AAAA,IACzD,CAAA;AAAA,EACF;AAEA,EAAA,MAAM,KAAA,EAAO,GAAA,CAAI,QAAA;AACjB,EAAA,MAAM,MAAA,EAAQ,GAAA,CAAI,QAAA,CAAS,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AAC5C,EAAA,MAAM,MAAA,EAAQ,GAAA,CAAI,SAAA,GAAY,KAAA,CAAA;AAC9B,EAAA,MAAM,OAAA,EAAS,GAAA,CAAI,SAAA,GAAY,KAAA,CAAA;AAE/B,EAAA,MAAM,OAAA,EAAiC,CAAC,CAAA;AACxC,EAAA,IAAA,CAAA,MAAW,CAAC,GAAA,EAAK,KAAK,EAAA,GAAK,GAAA,CAAI,YAAA,EAAc;AAC3C,IAAA,MAAA,CAAO,GAAG,EAAA,EAAI,KAAA;AAAA,EAChB;AAEA,EAAA,OAAO;AAAA,IACL,GAAA,EAAK,gBAAA;AAAA,IACL,IAAA;AAAA,IACA,KAAA;AAAA,IACA,KAAA;AAAA,IACA,MAAA;AAAA,IACA;AAAA,EACF,CAAA;AACF;AAKO,SAAS,KAAA,CAAM,MAAA,EAAkD;AACtE,EAAA,MAAM,KAAA,EACJ,MAAA,CAAO,MAAA,GAAS,MAAA,CAAO,OAAA,EACnB,CAAA,mBAAA;AAGmC,EAAA;AACR,EAAA;AAEY,EAAA;AAC/C;ADrCgD;AACA;AACA;AACA;AACA","file":"/Users/dan/code/oss/llm-strings/dist/chunk-N6NVBE43.cjs","sourcesContent":[null,"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"]}