llm-strings 0.0.1

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/parse.ts","../src/providers.ts","../src/normalize.ts","../src/validate.ts"],"sourcesContent":["export { parse, build } from \"./parse.js\";\nexport type { LlmConnectionConfig } from \"./parse.js\";\n\nexport { normalize } from \"./normalize.js\";\nexport type { NormalizeChange, NormalizeOptions, NormalizeResult } from \"./normalize.js\";\n\nexport { validate } from \"./validate.js\";\nexport type { ValidationIssue } from \"./validate.js\";\n\nexport { detectProvider, detectBedrockModelFamily, ALIASES, PROVIDER_PARAMS } from \"./providers.js\";\nexport type { Provider, BedrockModelFamily } from \"./providers.js\";\n","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","export type Provider =\n  | \"openai\"\n  | \"anthropic\"\n  | \"google\"\n  | \"mistral\"\n  | \"cohere\"\n  | \"bedrock\"\n  | \"openrouter\"\n  | \"vercel\";\n\nexport function detectProvider(host: string): Provider | undefined {\n  // Gateways and aggregators first — they proxy to other providers\n  if (host.includes(\"openrouter\")) return \"openrouter\";\n  if (host.includes(\"gateway.ai.vercel\")) return \"vercel\";\n  // Bedrock before native providers since it hosts models from multiple vendors\n  if (host.includes(\"amazonaws\") || host.includes(\"bedrock\")) return \"bedrock\";\n  if (host.includes(\"openai\")) return \"openai\";\n  if (host.includes(\"anthropic\") || host.includes(\"claude\")) return \"anthropic\";\n  if (host.includes(\"googleapis\") || host.includes(\"google\")) return \"google\";\n  if (host.includes(\"mistral\")) return \"mistral\";\n  if (host.includes(\"cohere\")) return \"cohere\";\n  return undefined;\n}\n\n/**\n * Shorthand aliases → canonical param name.\n * Canonical names use snake_case and follow OpenAI conventions where possible.\n */\nexport const ALIASES: Record<string, string> = {\n  // temperature\n  temp: \"temperature\",\n\n  // max_tokens\n  max: \"max_tokens\",\n  max_out: \"max_tokens\",\n  max_output: \"max_tokens\",\n  max_output_tokens: \"max_tokens\",\n  max_completion_tokens: \"max_tokens\",\n  maxOutputTokens: \"max_tokens\",\n  maxTokens: \"max_tokens\",\n\n  // top_p\n  topp: \"top_p\",\n  topP: \"top_p\",\n  nucleus: \"top_p\",\n\n  // top_k\n  topk: \"top_k\",\n  topK: \"top_k\",\n\n  // frequency_penalty\n  freq: \"frequency_penalty\",\n  freq_penalty: \"frequency_penalty\",\n  frequencyPenalty: \"frequency_penalty\",\n  repetition_penalty: \"frequency_penalty\",\n\n  // presence_penalty\n  pres: \"presence_penalty\",\n  pres_penalty: \"presence_penalty\",\n  presencePenalty: \"presence_penalty\",\n\n  // stop\n  stop_sequences: \"stop\",\n  stopSequences: \"stop\",\n  stop_sequence: \"stop\",\n\n  // seed\n  random_seed: \"seed\",\n  randomSeed: \"seed\",\n\n  // n (completions count)\n  candidateCount: \"n\",\n  candidate_count: \"n\",\n  num_completions: \"n\",\n\n  // effort / reasoning\n  reasoning_effort: \"effort\",\n  reasoning: \"effort\",\n\n  // cache\n  cache_control: \"cache\",\n  cacheControl: \"cache\",\n  cachePoint: \"cache\",\n  cache_point: \"cache\",\n};\n\n/**\n * Canonical param name → provider-specific API param name.\n * Only includes params the provider actually supports.\n */\nexport const PROVIDER_PARAMS: Record<Provider, Record<string, string>> = {\n  openai: {\n    temperature: \"temperature\",\n    max_tokens: \"max_tokens\",\n    top_p: \"top_p\",\n    frequency_penalty: \"frequency_penalty\",\n    presence_penalty: \"presence_penalty\",\n    stop: \"stop\",\n    n: \"n\",\n    seed: \"seed\",\n    stream: \"stream\",\n    effort: \"reasoning_effort\",\n  },\n  anthropic: {\n    temperature: \"temperature\",\n    max_tokens: \"max_tokens\",\n    top_p: \"top_p\",\n    top_k: \"top_k\",\n    stop: \"stop_sequences\",\n    stream: \"stream\",\n    effort: \"effort\",\n    cache: \"cache_control\",\n    cache_ttl: \"cache_ttl\",\n  },\n  google: {\n    temperature: \"temperature\",\n    max_tokens: \"maxOutputTokens\",\n    top_p: \"topP\",\n    top_k: \"topK\",\n    frequency_penalty: \"frequencyPenalty\",\n    presence_penalty: \"presencePenalty\",\n    stop: \"stopSequences\",\n    n: \"candidateCount\",\n    stream: \"stream\",\n    seed: \"seed\",\n    responseMimeType: \"responseMimeType\",\n    responseSchema: \"responseSchema\",\n  },\n  mistral: {\n    temperature: \"temperature\",\n    max_tokens: \"max_tokens\",\n    top_p: \"top_p\",\n    frequency_penalty: \"frequency_penalty\",\n    presence_penalty: \"presence_penalty\",\n    stop: \"stop\",\n    n: \"n\",\n    seed: \"random_seed\",\n    stream: \"stream\",\n    safe_prompt: \"safe_prompt\",\n    min_tokens: \"min_tokens\",\n  },\n  cohere: {\n    temperature: \"temperature\",\n    max_tokens: \"max_tokens\",\n    top_p: \"p\",\n    top_k: \"k\",\n    frequency_penalty: \"frequency_penalty\",\n    presence_penalty: \"presence_penalty\",\n    stop: \"stop_sequences\",\n    stream: \"stream\",\n    seed: \"seed\",\n  },\n  bedrock: {\n    // Bedrock Converse API uses camelCase\n    temperature: \"temperature\",\n    max_tokens: \"maxTokens\",\n    top_p: \"topP\",\n    top_k: \"topK\", // Claude models via additionalModelRequestFields\n    stop: \"stopSequences\",\n    stream: \"stream\",\n    cache: \"cache_control\",\n    cache_ttl: \"cache_ttl\",\n  },\n  openrouter: {\n    // OpenAI-compatible API with extra routing params\n    temperature: \"temperature\",\n    max_tokens: \"max_tokens\",\n    top_p: \"top_p\",\n    top_k: \"top_k\",\n    frequency_penalty: \"frequency_penalty\",\n    presence_penalty: \"presence_penalty\",\n    stop: \"stop\",\n    n: \"n\",\n    seed: \"seed\",\n    stream: \"stream\",\n    effort: \"reasoning_effort\",\n  },\n  vercel: {\n    // OpenAI-compatible gateway\n    temperature: \"temperature\",\n    max_tokens: \"max_tokens\",\n    top_p: \"top_p\",\n    top_k: \"top_k\",\n    frequency_penalty: \"frequency_penalty\",\n    presence_penalty: \"presence_penalty\",\n    stop: \"stop\",\n    n: \"n\",\n    seed: \"seed\",\n    stream: \"stream\",\n    effort: \"reasoning_effort\",\n  },\n};\n\n/**\n * Validation specs per provider, keyed by provider-specific param name.\n */\nexport interface ParamSpec {\n  type: \"number\" | \"string\" | \"boolean\";\n  min?: number;\n  max?: number;\n  values?: string[];\n}\n\nexport const PARAM_SPECS: Record<Provider, Record<string, ParamSpec>> = {\n  openai: {\n    temperature: { type: \"number\", min: 0, max: 2 },\n    max_tokens: { type: \"number\", min: 1 },\n    top_p: { type: \"number\", min: 0, max: 1 },\n    frequency_penalty: { type: \"number\", min: -2, max: 2 },\n    presence_penalty: { type: \"number\", min: -2, max: 2 },\n    stop: { type: \"string\" },\n    n: { type: \"number\", min: 1 },\n    seed: { type: \"number\" },\n    stream: { type: \"boolean\" },\n    reasoning_effort: {\n      type: \"string\",\n      values: [\"none\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\"],\n    },\n  },\n  anthropic: {\n    temperature: { type: \"number\", min: 0, max: 1 },\n    max_tokens: { type: \"number\", min: 1 },\n    top_p: { type: \"number\", min: 0, max: 1 },\n    top_k: { type: \"number\", min: 0 },\n    stop_sequences: { type: \"string\" },\n    stream: { type: \"boolean\" },\n    effort: { type: \"string\", values: [\"low\", \"medium\", \"high\", \"max\"] },\n    cache_control: { type: \"string\", values: [\"ephemeral\"] },\n    cache_ttl: { type: \"string\", values: [\"5m\", \"1h\"] },\n  },\n  google: {\n    temperature: { type: \"number\", min: 0, max: 2 },\n    maxOutputTokens: { type: \"number\", min: 1 },\n    topP: { type: \"number\", min: 0, max: 1 },\n    topK: { type: \"number\", min: 0 },\n    frequencyPenalty: { type: \"number\", min: -2, max: 2 },\n    presencePenalty: { type: \"number\", min: -2, max: 2 },\n    stopSequences: { type: \"string\" },\n    candidateCount: { type: \"number\", min: 1 },\n    stream: { type: \"boolean\" },\n    seed: { type: \"number\" },\n    responseMimeType: { type: \"string\" },\n    responseSchema: { type: \"string\" },\n  },\n  mistral: {\n    temperature: { type: \"number\", min: 0, max: 1 },\n    max_tokens: { type: \"number\", min: 1 },\n    top_p: { type: \"number\", min: 0, max: 1 },\n    frequency_penalty: { type: \"number\", min: -2, max: 2 },\n    presence_penalty: { type: \"number\", min: -2, max: 2 },\n    stop: { type: \"string\" },\n    n: { type: \"number\", min: 1 },\n    random_seed: { type: \"number\" },\n    stream: { type: \"boolean\" },\n    safe_prompt: { type: \"boolean\" },\n    min_tokens: { type: \"number\", min: 0 },\n  },\n  cohere: {\n    temperature: { type: \"number\", min: 0, max: 1 },\n    max_tokens: { type: \"number\", min: 1 },\n    p: { type: \"number\", min: 0, max: 1 },\n    k: { type: \"number\", min: 0, max: 500 },\n    frequency_penalty: { type: \"number\", min: 0, max: 1 },\n    presence_penalty: { type: \"number\", min: 0, max: 1 },\n    stop_sequences: { type: \"string\" },\n    stream: { type: \"boolean\" },\n    seed: { type: \"number\" },\n  },\n  bedrock: {\n    // Converse API inferenceConfig params\n    temperature: { type: \"number\", min: 0, max: 1 },\n    maxTokens: { type: \"number\", min: 1 },\n    topP: { type: \"number\", min: 0, max: 1 },\n    topK: { type: \"number\", min: 0 },\n    stopSequences: { type: \"string\" },\n    stream: { type: \"boolean\" },\n    cache_control: { type: \"string\", values: [\"ephemeral\"] },\n    cache_ttl: { type: \"string\", values: [\"5m\", \"1h\"] },\n  },\n  openrouter: {\n    // Loose validation — proxies to many providers with varying ranges\n    temperature: { type: \"number\", min: 0, max: 2 },\n    max_tokens: { type: \"number\", min: 1 },\n    top_p: { type: \"number\", min: 0, max: 1 },\n    top_k: { type: \"number\", min: 0 },\n    frequency_penalty: { type: \"number\", min: -2, max: 2 },\n    presence_penalty: { type: \"number\", min: -2, max: 2 },\n    stop: { type: \"string\" },\n    n: { type: \"number\", min: 1 },\n    seed: { type: \"number\" },\n    stream: { type: \"boolean\" },\n    reasoning_effort: {\n      type: \"string\",\n      values: [\"none\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\"],\n    },\n  },\n  vercel: {\n    // Loose validation — proxies to many providers with varying ranges\n    temperature: { type: \"number\", min: 0, max: 2 },\n    max_tokens: { type: \"number\", min: 1 },\n    top_p: { type: \"number\", min: 0, max: 1 },\n    top_k: { type: \"number\", min: 0 },\n    frequency_penalty: { type: \"number\", min: -2, max: 2 },\n    presence_penalty: { type: \"number\", min: -2, max: 2 },\n    stop: { type: \"string\" },\n    n: { type: \"number\", min: 1 },\n    seed: { type: \"number\" },\n    stream: { type: \"boolean\" },\n    reasoning_effort: {\n      type: \"string\",\n      values: [\"none\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\"],\n    },\n  },\n};\n\n/** OpenAI reasoning models don't support standard sampling params. */\nexport function isReasoningModel(model: string): boolean {\n  // Strip gateway prefix: \"openai/o3\" → \"o3\"\n  const name = model.includes(\"/\") ? model.split(\"/\").pop()! : model;\n  return /^o[134]/.test(name);\n}\n\n/** Providers that can route to OpenAI models (and need reasoning-model checks). */\nexport function canHostOpenAIModels(provider: Provider): boolean {\n  return provider === \"openai\" || provider === \"openrouter\" || provider === \"vercel\";\n}\n\nexport const REASONING_MODEL_UNSUPPORTED = new Set([\n  \"temperature\",\n  \"top_p\",\n  \"frequency_penalty\",\n  \"presence_penalty\",\n  \"n\",\n]);\n\n/**\n * Bedrock model IDs are prefixed with the vendor name.\n * e.g. \"anthropic.claude-sonnet-4-5-20250929-v1:0\"\n */\nexport type BedrockModelFamily =\n  | \"anthropic\"\n  | \"meta\"\n  | \"amazon\"\n  | \"mistral\"\n  | \"cohere\"\n  | \"ai21\";\n\nexport function detectBedrockModelFamily(\n  model: string,\n): BedrockModelFamily | undefined {\n  // Handle cross-region inference profiles (e.g. \"us.anthropic.claude-sonnet-4-5...\")\n  // and global inference profiles (e.g. \"global.anthropic.claude-sonnet-4-5...\")\n  const parts = model.split(\".\");\n  \n  // If first part is a region prefix (us, eu, apac) or global, skip it\n  let prefix = parts[0];\n  if ([\"us\", \"eu\", \"apac\", \"global\"].includes(prefix) && parts.length > 1) {\n    prefix = parts[1];\n  }\n\n  const families: BedrockModelFamily[] = [\n    \"anthropic\",\n    \"meta\",\n    \"amazon\",\n    \"mistral\",\n    \"cohere\",\n    \"ai21\",\n  ];\n  return families.find((f) => prefix === f);\n}\n\n/** Whether a Bedrock model supports prompt caching (Claude and Nova only). */\nexport function bedrockSupportsCaching(model: string): boolean {\n  const family = detectBedrockModelFamily(model);\n  if (family === \"anthropic\") return true;\n  if (family === \"amazon\" && model.includes(\"nova\")) return true;\n  return false;\n}\n\n/** Cache value normalization per provider. */\nexport const CACHE_VALUES: Record<Provider, string | undefined> = {\n  openai: undefined, // OpenAI auto-caches; no explicit param\n  anthropic: \"ephemeral\",\n  google: undefined, // Google uses explicit caching API, not a param\n  mistral: undefined,\n  cohere: undefined,\n  bedrock: \"ephemeral\", // Supported for Claude models on Bedrock\n  openrouter: undefined, // Depends on underlying provider\n  vercel: undefined, // Depends on underlying provider\n};\n\n/** Valid cache TTL values per provider. */\nexport const CACHE_TTLS: Record<Provider, string[] | undefined> = {\n  openai: undefined,\n  anthropic: [\"5m\", \"1h\"],\n  google: undefined,\n  mistral: undefined,\n  cohere: undefined,\n  bedrock: [\"5m\", \"1h\"], // Claude on Bedrock uses same TTLs as direct Anthropic\n  openrouter: undefined,\n  vercel: undefined,\n};\n\n/** Match a duration expression like \"5m\", \"1h\", \"30m\". */\nexport const DURATION_RE = /^\\d+[mh]$/;\n","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  detectProvider,\n  isReasoningModel,\n  type Provider,\n} from \"./providers.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  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 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    changes,\n  };\n}\n","import { parse } from \"./parse.js\";\nimport { normalize } from \"./normalize.js\";\nimport {\n  PARAM_SPECS,\n  PROVIDER_PARAMS,\n  REASONING_MODEL_UNSUPPORTED,\n  bedrockSupportsCaching,\n  canHostOpenAIModels,\n  detectBedrockModelFamily,\n  detectProvider,\n  isReasoningModel,\n} from \"./providers.js\";\n\nexport interface ValidationIssue {\n  param: string;\n  value: string;\n  message: string;\n  severity: \"error\" | \"warning\";\n}\n\n/**\n * Validate an LLM connection string.\n *\n * Parses and normalizes the string, then checks params against provider specs.\n * Returns a list of issues found. An empty array means all params look valid.\n */\nexport function validate(connectionString: string): ValidationIssue[] {\n  const parsed = parse(connectionString);\n  const { config } = normalize(parsed);\n  const provider = detectProvider(config.host);\n  const issues: ValidationIssue[] = [];\n\n  if (!provider) {\n    issues.push({\n      param: \"host\",\n      value: config.host,\n      message: `Unknown provider for host \"${config.host}\". Validation skipped.`,\n      severity: \"warning\",\n    });\n    return issues;\n  }\n\n  const specs = PARAM_SPECS[provider];\n  const knownParams = new Set(Object.values(PROVIDER_PARAMS[provider]));\n\n  for (const [key, value] of Object.entries(config.params)) {\n    // Check for OpenAI reasoning model restrictions (direct or via gateway)\n    if (\n      canHostOpenAIModels(provider) &&\n      isReasoningModel(config.model) &&\n      REASONING_MODEL_UNSUPPORTED.has(key)\n    ) {\n      issues.push({\n        param: key,\n        value,\n        message: `\"${key}\" is not supported by OpenAI reasoning model \"${config.model}\". Use \"reasoning_effort\" instead of temperature for controlling output.`,\n        severity: \"error\",\n      });\n      continue;\n    }\n\n    // Bedrock model-family-specific checks\n    if (provider === \"bedrock\") {\n      const family = detectBedrockModelFamily(config.model);\n\n      // topK is only supported by Claude, Cohere, and Mistral on Bedrock\n      if (\n        key === \"topK\" &&\n        family &&\n        family !== \"anthropic\" &&\n        family !== \"cohere\" &&\n        family !== \"mistral\"\n      ) {\n        issues.push({\n          param: key,\n          value,\n          message: `\"topK\" is not supported by ${family} models on Bedrock.`,\n          severity: \"error\",\n        });\n        continue;\n      }\n\n      // cache_control is only supported by Claude and Nova on Bedrock\n      if (key === \"cache_control\" && !bedrockSupportsCaching(config.model)) {\n        issues.push({\n          param: key,\n          value,\n          message: `Prompt caching is only supported for Anthropic Claude and Amazon Nova models on Bedrock, not ${family ?? \"unknown\"} models.`,\n          severity: \"error\",\n        });\n        continue;\n      }\n    }\n\n    // Check if param is known for this provider\n    if (!knownParams.has(key) && !specs[key]) {\n      issues.push({\n        param: key,\n        value,\n        message: `Unknown param \"${key}\" for ${provider}.`,\n        severity: \"warning\",\n      });\n      continue;\n    }\n\n    // Validate against spec\n    const spec = specs[key];\n    if (!spec) continue;\n\n    // Anthropic (and Bedrock Claude) mutual exclusion for temperature/top_p\n    if (\n      (provider === \"anthropic\" ||\n        (provider === \"bedrock\" &&\n          detectBedrockModelFamily(config.model) === \"anthropic\")) &&\n      (key === \"temperature\" || key === \"top_p\" || key === \"topP\")\n    ) {\n      const otherKey =\n        key === \"temperature\"\n          ? provider === \"bedrock\"\n            ? \"topP\"\n            : \"top_p\"\n          : \"temperature\";\n      // Only report error once (on the temperature param) to avoid duplicate errors\n      if (key === \"temperature\" && config.params[otherKey] !== undefined) {\n        issues.push({\n          param: key,\n          value,\n          message: `Cannot specify both \"temperature\" and \"${otherKey}\" for Anthropic models.`,\n          severity: \"error\",\n        });\n      }\n    }\n\n    if (spec.type === \"number\") {\n      const num = Number(value);\n      if (isNaN(num)) {\n        issues.push({\n          param: key,\n          value,\n          message: `\"${key}\" should be a number, got \"${value}\".`,\n          severity: \"error\",\n        });\n        continue;\n      }\n      if (spec.min !== undefined && num < spec.min) {\n        issues.push({\n          param: key,\n          value,\n          message: `\"${key}\" must be >= ${spec.min}, got ${num}.`,\n          severity: \"error\",\n        });\n      }\n      if (spec.max !== undefined && num > spec.max) {\n        issues.push({\n          param: key,\n          value,\n          message: `\"${key}\" must be <= ${spec.max}, got ${num}.`,\n          severity: \"error\",\n        });\n      }\n    }\n\n    if (spec.type === \"boolean\") {\n      if (![\"true\", \"false\", \"0\", \"1\"].includes(value)) {\n        issues.push({\n          param: key,\n          value,\n          message: `\"${key}\" should be a boolean (true/false), got \"${value}\".`,\n          severity: \"error\",\n        });\n      }\n    }\n\n    if (spec.type === \"string\" && spec.values) {\n      if (!spec.values.includes(value)) {\n        issues.push({\n          param: key,\n          value,\n          message: `\"${key}\" must be one of [${spec.values.join(\", \")}], got \"${value}\".`,\n          severity: \"error\",\n        });\n      }\n    }\n  }\n\n  return issues;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,92 @@
+interface LlmConnectionConfig {
+    /** The original connection string */
+    raw: string;
+    /** Provider's API base URL (e.g. "api.openai.com") */
+    host: string;
+    /** Model name (e.g. "gpt-5.2") */
+    model: string;
+    /** Optional label or app name */
+    label?: string;
+    /** Optional API key or password */
+    apiKey?: string;
+    /** Additional config parameters (temp, max_tokens, etc.) */
+    params: Record<string, string>;
+}
+/**
+ * Parse an LLM connection string into its component parts.
+ *
+ * Format: `llm://[label[:apiKey]@]host/model[?key=value&...]`
+ *
+ * @example
+ * ```ts
+ * parse("llm://api.openai.com/gpt-5.2?temp=0.7&max_tokens=1500")
+ * parse("llm://app-name:sk-proj-123456@api.openai.com/gpt-5.2?temp=0.7")
+ * ```
+ */
+declare function parse(connectionString: string): LlmConnectionConfig;
+/**
+ * Build an LLM connection string from a config object.
+ */
+declare function build(config: Omit<LlmConnectionConfig, "raw">): string;
+
+type Provider = "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openrouter" | "vercel";
+declare function detectProvider(host: string): Provider | undefined;
+/**
+ * Shorthand aliases → canonical param name.
+ * Canonical names use snake_case and follow OpenAI conventions where possible.
+ */
+declare const ALIASES: Record<string, string>;
+/**
+ * Canonical param name → provider-specific API param name.
+ * Only includes params the provider actually supports.
+ */
+declare const PROVIDER_PARAMS: Record<Provider, Record<string, string>>;
+/**
+ * Bedrock model IDs are prefixed with the vendor name.
+ * e.g. "anthropic.claude-sonnet-4-5-20250929-v1:0"
+ */
+type BedrockModelFamily = "anthropic" | "meta" | "amazon" | "mistral" | "cohere" | "ai21";
+declare function detectBedrockModelFamily(model: string): BedrockModelFamily | undefined;
+
+interface NormalizeChange {
+    from: string;
+    to: string;
+    value: string;
+    reason: string;
+}
+interface NormalizeResult {
+    config: LlmConnectionConfig;
+    provider: Provider | undefined;
+    changes: NormalizeChange[];
+}
+interface NormalizeOptions {
+    /** Include detailed change log in the result. */
+    verbose?: boolean;
+}
+/**
+ * Normalize an LLM connection config's params for its target provider.
+ *
+ * 1. Expands shorthand aliases (e.g. `temp` → `temperature`)
+ * 2. Maps canonical param names to provider-specific names
+ *    (e.g. `max_tokens` → `maxOutputTokens` for Google)
+ * 3. Normalizes special values (e.g. `cache=true` → `cache_control=ephemeral` for Anthropic)
+ * 4. For OpenAI reasoning models, remaps `max_tokens` → `max_completion_tokens`
+ *    and warns about unsupported sampling params
+ */
+declare function normalize(config: LlmConnectionConfig, options?: NormalizeOptions): NormalizeResult;
+
+interface ValidationIssue {
+    param: string;
+    value: string;
+    message: string;
+    severity: "error" | "warning";
+}
+/**
+ * Validate an LLM connection string.
+ *
+ * Parses and normalizes the string, then checks params against provider specs.
+ * Returns a list of issues found. An empty array means all params look valid.
+ */
+declare function validate(connectionString: string): ValidationIssue[];
+
+export { ALIASES, type BedrockModelFamily, type LlmConnectionConfig, type NormalizeChange, type NormalizeOptions, type NormalizeResult, PROVIDER_PARAMS, type Provider, type ValidationIssue, build, detectBedrockModelFamily, detectProvider, normalize, parse, validate };

package/dist/index.d.ts

@@ -0,0 +1,92 @@
+interface LlmConnectionConfig {
+    /** The original connection string */
+    raw: string;
+    /** Provider's API base URL (e.g. "api.openai.com") */
+    host: string;
+    /** Model name (e.g. "gpt-5.2") */
+    model: string;
+    /** Optional label or app name */
+    label?: string;
+    /** Optional API key or password */
+    apiKey?: string;
+    /** Additional config parameters (temp, max_tokens, etc.) */
+    params: Record<string, string>;
+}
+/**
+ * Parse an LLM connection string into its component parts.
+ *
+ * Format: `llm://[label[:apiKey]@]host/model[?key=value&...]`
+ *
+ * @example
+ * ```ts
+ * parse("llm://api.openai.com/gpt-5.2?temp=0.7&max_tokens=1500")
+ * parse("llm://app-name:sk-proj-123456@api.openai.com/gpt-5.2?temp=0.7")
+ * ```
+ */
+declare function parse(connectionString: string): LlmConnectionConfig;
+/**
+ * Build an LLM connection string from a config object.
+ */
+declare function build(config: Omit<LlmConnectionConfig, "raw">): string;
+
+type Provider = "openai" | "anthropic" | "google" | "mistral" | "cohere" | "bedrock" | "openrouter" | "vercel";
+declare function detectProvider(host: string): Provider | undefined;
+/**
+ * Shorthand aliases → canonical param name.
+ * Canonical names use snake_case and follow OpenAI conventions where possible.
+ */
+declare const ALIASES: Record<string, string>;
+/**
+ * Canonical param name → provider-specific API param name.
+ * Only includes params the provider actually supports.
+ */
+declare const PROVIDER_PARAMS: Record<Provider, Record<string, string>>;
+/**
+ * Bedrock model IDs are prefixed with the vendor name.
+ * e.g. "anthropic.claude-sonnet-4-5-20250929-v1:0"
+ */
+type BedrockModelFamily = "anthropic" | "meta" | "amazon" | "mistral" | "cohere" | "ai21";
+declare function detectBedrockModelFamily(model: string): BedrockModelFamily | undefined;
+
+interface NormalizeChange {
+    from: string;
+    to: string;
+    value: string;
+    reason: string;
+}
+interface NormalizeResult {
+    config: LlmConnectionConfig;
+    provider: Provider | undefined;
+    changes: NormalizeChange[];
+}
+interface NormalizeOptions {
+    /** Include detailed change log in the result. */
+    verbose?: boolean;
+}
+/**
+ * Normalize an LLM connection config's params for its target provider.
+ *
+ * 1. Expands shorthand aliases (e.g. `temp` → `temperature`)
+ * 2. Maps canonical param names to provider-specific names
+ *    (e.g. `max_tokens` → `maxOutputTokens` for Google)
+ * 3. Normalizes special values (e.g. `cache=true` → `cache_control=ephemeral` for Anthropic)
+ * 4. For OpenAI reasoning models, remaps `max_tokens` → `max_completion_tokens`
+ *    and warns about unsupported sampling params
+ */
+declare function normalize(config: LlmConnectionConfig, options?: NormalizeOptions): NormalizeResult;
+
+interface ValidationIssue {
+    param: string;
+    value: string;
+    message: string;
+    severity: "error" | "warning";
+}
+/**
+ * Validate an LLM connection string.
+ *
+ * Parses and normalizes the string, then checks params against provider specs.
+ * Returns a list of issues found. An empty array means all params look valid.
+ */
+declare function validate(connectionString: string): ValidationIssue[];
+
+export { ALIASES, type BedrockModelFamily, type LlmConnectionConfig, type NormalizeChange, type NormalizeOptions, type NormalizeResult, PROVIDER_PARAMS, type Provider, type ValidationIssue, build, detectBedrockModelFamily, detectProvider, normalize, parse, validate };