llm-strings 1.1.1 → 1.1.2

package/dist/chunk-RSUXM42X.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/dan/code/oss/llm-strings/dist/chunk-RSUXM42X.cjs","../src/validate.ts"],"names":[],"mappings":"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","file":"/Users/dan/code/oss/llm-strings/dist/chunk-RSUXM42X.cjs","sourcesContent":[null,"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  isReasoningModel,\n  type ParamSpec,\n  type Provider,\n} from \"./provider-core.js\";\n\nexport interface ValidationIssue {\n  param: string;\n  value: string;\n  message: string;\n  severity: \"error\" | \"warning\";\n}\n\nexport interface ValidateOptions {\n  /** Promote warnings (unknown provider, unknown params) to errors. */\n  strict?: boolean;\n}\n\n/**\n * Build a reverse map from provider-specific param names back to canonical names.\n */\nfunction buildReverseParamMap(\n  provider: Provider,\n): Record<string, string> {\n  const map: Record<string, string> = {};\n  for (const [canonical, specific] of Object.entries(\n    PROVIDER_PARAMS[provider],\n  )) {\n    map[specific] = canonical;\n  }\n  return map;\n}\n\n/**\n * Look up a sub-provider's ParamSpec for a gateway-normalized param name.\n * Maps: gateway param → canonical → sub-provider-specific → spec.\n */\nfunction lookupSubProviderSpec(\n  gatewayParamName: string,\n  gatewayReverseMap: Record<string, string>,\n  subProvider: Provider,\n) {\n  const canonical = gatewayReverseMap[gatewayParamName] ?? gatewayParamName;\n  const subProviderKey = PROVIDER_PARAMS[subProvider]?.[canonical];\n  if (!subProviderKey) return { spec: undefined, canonical };\n  return { spec: PARAM_SPECS[subProvider]?.[subProviderKey], canonical };\n}\n\n/**\n * Build the set of gateway param names that correspond to params the sub-provider supports.\n */\nfunction buildSubProviderKnownParams(\n  gateway: Provider,\n  subProvider: Provider,\n): Set<string> {\n  const known = new Set<string>();\n  const subProviderCanonicals = new Set(\n    Object.keys(PROVIDER_PARAMS[subProvider]),\n  );\n  for (const [canonical, gatewaySpecific] of Object.entries(\n    PROVIDER_PARAMS[gateway],\n  )) {\n    if (subProviderCanonicals.has(canonical)) {\n      known.add(gatewaySpecific);\n    }\n  }\n  return known;\n}\n\n/**\n * Validate an LLM connection string.\n *\n * Parses and normalizes the string, then checks params against provider specs.\n * For gateway providers (OpenRouter, Vercel), detects the sub-provider from the\n * model prefix and validates against the sub-provider's rules when known.\n * Returns a list of issues found. An empty array means all params look valid.\n */\nexport function validate(\n  connectionString: string,\n  options: ValidateOptions = {},\n): ValidationIssue[] {\n  const parsed = parse(connectionString);\n  const { config, provider, subProvider } = normalize(parsed);\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: options.strict ? \"error\" : \"warning\",\n    });\n    return issues;\n  }\n\n  // When routing through a gateway to a known sub-provider, validate against\n  // the sub-provider's specs. Fall back to the gateway's loose specs otherwise.\n  const effectiveProvider = subProvider ?? provider;\n  const specs = PARAM_SPECS[effectiveProvider];\n\n  const gatewayReverseMap = subProvider\n    ? buildReverseParamMap(provider)\n    : undefined;\n\n  const knownParams = subProvider\n    ? buildSubProviderKnownParams(provider, subProvider)\n    : 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 (or sub-provider)\n    if (!knownParams.has(key) && !specs[key]) {\n      issues.push({\n        param: key,\n        value,\n        message: `Unknown param \"${key}\" for ${effectiveProvider}.`,\n        severity: options.strict ? \"error\" : \"warning\",\n      });\n      continue;\n    }\n\n    // Look up the spec — for gateways with a sub-provider, map through\n    // canonical names to find the sub-provider's spec\n    let spec: ParamSpec | undefined = specs[key];\n    if (subProvider && gatewayReverseMap && !spec) {\n      const result = lookupSubProviderSpec(\n        key,\n        gatewayReverseMap,\n        subProvider,\n      );\n      spec = result.spec;\n    }\n    if (!spec) continue;\n\n    // Anthropic (and Bedrock Claude, and Anthropic via gateway) mutual exclusion for temperature/top_p\n    if (\n      (effectiveProvider === \"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"]}