proxitor 0.2.0 → 0.3.0

package/dist/edit.mjs

@@ -0,0 +1,81 @@
+import { g as OpenRouterClient, n as selectProvidersByMode, r as selectRoutingMode, t as fetchProvidersForModel } from "./providers.mjs";
+import { i as setModelOverride, r as requireConfigPath, t as getModelOverrides } from "./config.mjs";
+import * as clack from "@clack/prompts";
+import { isCancel } from "@clack/prompts";
+//#region src/commands/config/edit.ts
+function formatOverrideHint(override) {
+	if (!override?.provider) return "(no provider routing)";
+	return Object.keys(override.provider).map((k) => `${k}: ${JSON.stringify(override.provider?.[k])}`).join(", ");
+}
+function showCurrentConfig(modelKey, current) {
+	clack.log.info(`Current config for "${modelKey}":`);
+	if (current.provider) for (const [field, value] of Object.entries(current.provider)) clack.log.info(`  provider.${field}: ${JSON.stringify(value)}`);
+	if (current.headers) for (const [name, value] of Object.entries(current.headers)) clack.log.info(`  headers.${name}: ${value}`);
+}
+function withoutProvider(current) {
+	return current.headers ? { headers: current.headers } : {};
+}
+async function updateProviderRouting(configPath, modelKey, current, apiKey) {
+	const isPattern = modelKey.includes("*");
+	const client = new OpenRouterClient(apiKey);
+	const mode = await selectRoutingMode("Routing mode");
+	if (isCancel(mode)) return;
+	if (mode === "skip") {
+		setModelOverride(configPath, modelKey, withoutProvider(current));
+		clack.outro("✓ Override updated");
+		return;
+	}
+	const providerOptions = await fetchProvidersForModel(client, modelKey, isPattern);
+	if (!providerOptions) return;
+	const override = await selectProvidersByMode(mode, providerOptions);
+	if (override === null) return;
+	const updated = withoutProvider(current);
+	if (override.provider) updated.provider = override.provider;
+	const save = await clack.confirm({ message: "Save changes?" });
+	if (isCancel(save) || !save) {
+		clack.outro("Cancelled");
+		return;
+	}
+	setModelOverride(configPath, modelKey, updated);
+	clack.outro("✓ Override updated");
+}
+/** Run the interactive "Edit model override" flow. */
+async function editOverrideCommand(apiKey) {
+	clack.intro("Edit Model Override");
+	const configPath = requireConfigPath();
+	const overrides = getModelOverrides(configPath);
+	const keys = Object.keys(overrides);
+	if (keys.length === 0) {
+		clack.log.warn("No model overrides found. Use Add instead.");
+		clack.outro("");
+		return;
+	}
+	const selected = await clack.select({
+		message: "Select override to edit",
+		options: keys.map((k) => ({
+			value: k,
+			label: k,
+			hint: formatOverrideHint(overrides[k])
+		}))
+	});
+	if (isCancel(selected)) return;
+	const modelKey = selected;
+	const current = overrides[modelKey] ?? {};
+	showCurrentConfig(modelKey, current);
+	const target = await clack.select({
+		message: "What to change?",
+		options: [{
+			value: "provider",
+			label: "Provider routing"
+		}, {
+			value: "replace",
+			label: "Replace entirely"
+		}]
+	});
+	if (isCancel(target)) return;
+	if (target === "provider" || target === "replace") await updateProviderRouting(configPath, modelKey, current, apiKey);
+}
+//#endregion
+export { editOverrideCommand };
+
+//# sourceMappingURL=edit.mjs.map

package/dist/edit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.mjs","names":[],"sources":["../src/commands/config/edit.ts"],"sourcesContent":["import * as clack from '@clack/prompts'\nimport { isCancel } from '@clack/prompts'\nimport type { ModelOverride } from '../../config-schema.js'\nimport { OpenRouterClient } from '../../openrouter/client.js'\nimport { getModelOverrides, requireConfigPath, setModelOverride } from './config.js'\nimport {\n  fetchProvidersForModel,\n  selectProvidersByMode,\n  selectRoutingMode,\n} from './providers.js'\n\nfunction formatOverrideHint(override: ModelOverride | undefined): string {\n  if (!override?.provider) return '(no provider routing)'\n  const keys = Object.keys(override.provider)\n  return keys\n    .map(\n      k => `${k}: ${JSON.stringify((override.provider as Record<string, unknown>)?.[k])}`,\n    )\n    .join(', ')\n}\n\nfunction showCurrentConfig(modelKey: string, current: ModelOverride): void {\n  clack.log.info(`Current config for \"${modelKey}\":`)\n  if (current.provider) {\n    for (const [field, value] of Object.entries(current.provider)) {\n      clack.log.info(`  provider.${field}: ${JSON.stringify(value)}`)\n    }\n  }\n  if (current.headers) {\n    for (const [name, value] of Object.entries(current.headers)) {\n      clack.log.info(`  headers.${name}: ${value}`)\n    }\n  }\n}\n\nfunction withoutProvider(current: ModelOverride): ModelOverride {\n  return current.headers ? { headers: current.headers } : {}\n}\n\nasync function updateProviderRouting(\n  configPath: string,\n  modelKey: string,\n  current: ModelOverride,\n  apiKey: string,\n): Promise<void> {\n  const isPattern = modelKey.includes('*')\n  const client = new OpenRouterClient(apiKey)\n\n  const mode = await selectRoutingMode('Routing mode')\n  if (isCancel(mode)) return\n\n  if (mode === 'skip') {\n    setModelOverride(configPath, modelKey, withoutProvider(current))\n    clack.outro('✓ Override updated')\n    return\n  }\n\n  const providerOptions = await fetchProvidersForModel(client, modelKey, isPattern)\n  if (!providerOptions) return\n\n  const override = await selectProvidersByMode(mode as string, providerOptions)\n  if (override === null) return\n\n  const updated = withoutProvider(current)\n  if (override.provider) {\n    updated.provider = override.provider as ModelOverride['provider']\n  }\n\n  const save = await clack.confirm({ message: 'Save changes?' })\n  if (isCancel(save) || !save) {\n    clack.outro('Cancelled')\n    return\n  }\n\n  setModelOverride(configPath, modelKey, updated)\n  clack.outro('✓ Override updated')\n}\n\n/** Run the interactive \"Edit model override\" flow. */\nexport async function editOverrideCommand(apiKey: string): Promise<void> {\n  clack.intro('Edit Model Override')\n\n  const configPath = requireConfigPath()\n  const overrides = getModelOverrides(configPath)\n  const keys = Object.keys(overrides)\n\n  if (keys.length === 0) {\n    clack.log.warn('No model overrides found. Use Add instead.')\n    clack.outro('')\n    return\n  }\n\n  const selected = await clack.select({\n    message: 'Select override to edit',\n    options: keys.map(k => ({\n      value: k,\n      label: k,\n      hint: formatOverrideHint(overrides[k]),\n    })),\n  })\n  if (isCancel(selected)) return\n\n  const modelKey = selected as string\n  const current: ModelOverride = overrides[modelKey] ?? {}\n\n  showCurrentConfig(modelKey, current)\n\n  const target = await clack.select({\n    message: 'What to change?',\n    options: [\n      { value: 'provider', label: 'Provider routing' },\n      { value: 'replace', label: 'Replace entirely' },\n    ],\n  })\n  if (isCancel(target)) return\n\n  if (target === 'provider' || target === 'replace') {\n    await updateProviderRouting(configPath, modelKey, current, apiKey)\n  }\n}\n"],"mappings":";;;;;AAWA,SAAS,mBAAmB,UAA6C;CACvE,IAAI,CAAC,UAAU,UAAU,OAAO;CAEhC,OADa,OAAO,KAAK,SAAS,QACxB,EACP,KACC,MAAK,GAAG,EAAE,IAAI,KAAK,UAAW,SAAS,WAAuC,EAAE,GAClF,EACC,KAAK,IAAI;AACd;AAEA,SAAS,kBAAkB,UAAkB,SAA8B;CACzE,MAAM,IAAI,KAAK,uBAAuB,SAAS,GAAG;CAClD,IAAI,QAAQ,UACV,KAAK,MAAM,CAAC,OAAO,UAAU,OAAO,QAAQ,QAAQ,QAAQ,GAC1D,MAAM,IAAI,KAAK,cAAc,MAAM,IAAI,KAAK,UAAU,KAAK,GAAG;CAGlE,IAAI,QAAQ,SACV,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,QAAQ,OAAO,GACxD,MAAM,IAAI,KAAK,aAAa,KAAK,IAAI,OAAO;AAGlD;AAEA,SAAS,gBAAgB,SAAuC;CAC9D,OAAO,QAAQ,UAAU,EAAE,SAAS,QAAQ,QAAQ,IAAI,CAAC;AAC3D;AAEA,eAAe,sBACb,YACA,UACA,SACA,QACe;CACf,MAAM,YAAY,SAAS,SAAS,GAAG;CACvC,MAAM,SAAS,IAAI,iBAAiB,MAAM;CAE1C,MAAM,OAAO,MAAM,kBAAkB,cAAc;CACnD,IAAI,SAAS,IAAI,GAAG;CAEpB,IAAI,SAAS,QAAQ;EACnB,iBAAiB,YAAY,UAAU,gBAAgB,OAAO,CAAC;EAC/D,MAAM,MAAM,oBAAoB;EAChC;CACF;CAEA,MAAM,kBAAkB,MAAM,uBAAuB,QAAQ,UAAU,SAAS;CAChF,IAAI,CAAC,iBAAiB;CAEtB,MAAM,WAAW,MAAM,sBAAsB,MAAgB,eAAe;CAC5E,IAAI,aAAa,MAAM;CAEvB,MAAM,UAAU,gBAAgB,OAAO;CACvC,IAAI,SAAS,UACX,QAAQ,WAAW,SAAS;CAG9B,MAAM,OAAO,MAAM,MAAM,QAAQ,EAAE,SAAS,gBAAgB,CAAC;CAC7D,IAAI,SAAS,IAAI,KAAK,CAAC,MAAM;EAC3B,MAAM,MAAM,WAAW;EACvB;CACF;CAEA,iBAAiB,YAAY,UAAU,OAAO;CAC9C,MAAM,MAAM,oBAAoB;AAClC;;AAGA,eAAsB,oBAAoB,QAA+B;CACvE,MAAM,MAAM,qBAAqB;CAEjC,MAAM,aAAa,kBAAkB;CACrC,MAAM,YAAY,kBAAkB,UAAU;CAC9C,MAAM,OAAO,OAAO,KAAK,SAAS;CAElC,IAAI,KAAK,WAAW,GAAG;EACrB,MAAM,IAAI,KAAK,4CAA4C;EAC3D,MAAM,MAAM,EAAE;EACd;CACF;CAEA,MAAM,WAAW,MAAM,MAAM,OAAO;EAClC,SAAS;EACT,SAAS,KAAK,KAAI,OAAM;GACtB,OAAO;GACP,OAAO;GACP,MAAM,mBAAmB,UAAU,EAAE;EACvC,EAAE;CACJ,CAAC;CACD,IAAI,SAAS,QAAQ,GAAG;CAExB,MAAM,WAAW;CACjB,MAAM,UAAyB,UAAU,aAAa,CAAC;CAEvD,kBAAkB,UAAU,OAAO;CAEnC,MAAM,SAAS,MAAM,MAAM,OAAO;EAChC,SAAS;EACT,SAAS,CACP;GAAE,OAAO;GAAY,OAAO;EAAmB,GAC/C;GAAE,OAAO;GAAW,OAAO;EAAmB,CAChD;CACF,CAAC;CACD,IAAI,SAAS,MAAM,GAAG;CAEtB,IAAI,WAAW,cAAc,WAAW,WACtC,MAAM,sBAAsB,YAAY,UAAU,SAAS,MAAM;AAErE"}

package/dist/index.cjs

@@ -1,5 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_proxy = require("./proxy.cjs");
+exports.ConfigParseError = require_proxy.ConfigParseError;
+exports.ConfigValidationError = require_proxy.ConfigValidationError;
 exports.buildProviderRouting = require_proxy.buildProviderRouting;
 exports.createProxyServer = require_proxy.createProxyServer;
 exports.extractModel = require_proxy.extractModel;

package/dist/index.d.cts

@@ -1,63 +1,233 @@
+import { z } from "zod";
 import { ServerType } from "@hono/node-server";
 
-//#region src/config.d.ts
-/** Percentile cutoffs for performance thresholds */
-type PercentileCutoffs = {
-  p50?: number;
-  p75?: number;
-  p90?: number;
-  p99?: number;
-};
-/** Provider sorting options */
-type ProviderSort = 'price' | 'throughput' | 'latency' | {
-  by: 'price' | 'throughput' | 'latency';
-  partition?: 'model' | 'none';
-};
-/** Maximum pricing for a request */
-type MaxPrice = {
-  prompt?: number;
-  completion?: number;
-  request?: number;
-  image?: number;
-};
-type ProviderConfig = {
-  /** Allow only these providers (e.g. "deepinfra" or ["anthropic", "openai"]) */only?: string | string[]; /** Try providers in this order (e.g. "anthropic" or ["openai", "together"]) */
-  order?: string | string[]; /** Ignore these providers (mirror of only — skip specific providers) */
-  ignore?: string | string[]; /** Allow fallback to other providers (default: true) */
-  allowFallbacks?: boolean; /** Sort providers by price, throughput, or latency */
-  sort?: ProviderSort; /** Filter by quantization levels (e.g. ["fp8", "int4"]) */
-  quantizations?: string[]; /** Maximum pricing to accept */
-  maxPrice?: MaxPrice; /** Only use providers that support all request parameters (default: false) */
-  requireParameters?: boolean; /** Control data collection policy: "allow" or "deny" (default: "allow") */
-  dataCollection?: 'allow' | 'deny'; /** Restrict routing to Zero Data Retention endpoints */
-  zdr?: boolean; /** Restrict routing to models that allow text distillation */
-  enforceDistillableText?: boolean; /** Preferred minimum throughput (tokens/sec) */
-  preferredMinThroughput?: number | PercentileCutoffs; /** Preferred maximum latency (seconds) */
-  preferredMaxLatency?: number | PercentileCutoffs;
-};
+//#region src/config-schema.d.ts
+/** Provider routing configuration */
+declare const providerConfigSchema: z.ZodObject<{
+  only: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+  order: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+  ignore: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+  allowFallbacks: z.ZodOptional<z.ZodBoolean>;
+  sort: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+    price: "price";
+    throughput: "throughput";
+    latency: "latency";
+  }>, z.ZodObject<{
+    by: z.ZodEnum<{
+      price: "price";
+      throughput: "throughput";
+      latency: "latency";
+    }>;
+    partition: z.ZodOptional<z.ZodEnum<{
+      model: "model";
+      none: "none";
+    }>>;
+  }, z.core.$strict>]>>;
+  quantizations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  maxPrice: z.ZodOptional<z.ZodObject<{
+    prompt: z.ZodOptional<z.ZodNumber>;
+    completion: z.ZodOptional<z.ZodNumber>;
+    request: z.ZodOptional<z.ZodNumber>;
+    image: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>>;
+  requireParameters: z.ZodOptional<z.ZodBoolean>;
+  dataCollection: z.ZodOptional<z.ZodEnum<{
+    allow: "allow";
+    deny: "deny";
+  }>>;
+  zdr: z.ZodOptional<z.ZodBoolean>;
+  enforceDistillableText: z.ZodOptional<z.ZodBoolean>;
+  preferredMinThroughput: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+    p50: z.ZodOptional<z.ZodNumber>;
+    p75: z.ZodOptional<z.ZodNumber>;
+    p90: z.ZodOptional<z.ZodNumber>;
+    p99: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>]>>;
+  preferredMaxLatency: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+    p50: z.ZodOptional<z.ZodNumber>;
+    p75: z.ZodOptional<z.ZodNumber>;
+    p90: z.ZodOptional<z.ZodNumber>;
+    p99: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>]>>;
+}, z.core.$strict>;
 /** Per-model override: layers on top of global config */
-type ModelOverride = {
-  /** Override provider routing for matching models */provider?: ProviderConfig; /** Additional headers to merge for matching models */
-  headers?: Record<string, string>;
-};
+declare const modelOverrideSchema: z.ZodObject<{
+  provider: z.ZodOptional<z.ZodObject<{
+    only: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    order: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    ignore: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    allowFallbacks: z.ZodOptional<z.ZodBoolean>;
+    sort: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+      price: "price";
+      throughput: "throughput";
+      latency: "latency";
+    }>, z.ZodObject<{
+      by: z.ZodEnum<{
+        price: "price";
+        throughput: "throughput";
+        latency: "latency";
+      }>;
+      partition: z.ZodOptional<z.ZodEnum<{
+        model: "model";
+        none: "none";
+      }>>;
+    }, z.core.$strict>]>>;
+    quantizations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    maxPrice: z.ZodOptional<z.ZodObject<{
+      prompt: z.ZodOptional<z.ZodNumber>;
+      completion: z.ZodOptional<z.ZodNumber>;
+      request: z.ZodOptional<z.ZodNumber>;
+      image: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    requireParameters: z.ZodOptional<z.ZodBoolean>;
+    dataCollection: z.ZodOptional<z.ZodEnum<{
+      allow: "allow";
+      deny: "deny";
+    }>>;
+    zdr: z.ZodOptional<z.ZodBoolean>;
+    enforceDistillableText: z.ZodOptional<z.ZodBoolean>;
+    preferredMinThroughput: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+      p50: z.ZodOptional<z.ZodNumber>;
+      p75: z.ZodOptional<z.ZodNumber>;
+      p90: z.ZodOptional<z.ZodNumber>;
+      p99: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>]>>;
+    preferredMaxLatency: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+      p50: z.ZodOptional<z.ZodNumber>;
+      p75: z.ZodOptional<z.ZodNumber>;
+      p90: z.ZodOptional<z.ZodNumber>;
+      p99: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>]>>;
+  }, z.core.$strict>>;
+  headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+/** Full proxy configuration */
+declare const proxyConfigSchema: z.ZodObject<{
+  host: z.ZodString;
+  port: z.ZodNumber;
+  openrouterKey: z.ZodString;
+  openrouterBaseUrl: z.ZodString;
+  verbose: z.ZodBoolean;
+  bodyLimit: z.ZodString;
+  provider: z.ZodOptional<z.ZodObject<{
+    only: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    order: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    ignore: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    allowFallbacks: z.ZodOptional<z.ZodBoolean>;
+    sort: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+      price: "price";
+      throughput: "throughput";
+      latency: "latency";
+    }>, z.ZodObject<{
+      by: z.ZodEnum<{
+        price: "price";
+        throughput: "throughput";
+        latency: "latency";
+      }>;
+      partition: z.ZodOptional<z.ZodEnum<{
+        model: "model";
+        none: "none";
+      }>>;
+    }, z.core.$strict>]>>;
+    quantizations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    maxPrice: z.ZodOptional<z.ZodObject<{
+      prompt: z.ZodOptional<z.ZodNumber>;
+      completion: z.ZodOptional<z.ZodNumber>;
+      request: z.ZodOptional<z.ZodNumber>;
+      image: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    requireParameters: z.ZodOptional<z.ZodBoolean>;
+    dataCollection: z.ZodOptional<z.ZodEnum<{
+      allow: "allow";
+      deny: "deny";
+    }>>;
+    zdr: z.ZodOptional<z.ZodBoolean>;
+    enforceDistillableText: z.ZodOptional<z.ZodBoolean>;
+    preferredMinThroughput: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+      p50: z.ZodOptional<z.ZodNumber>;
+      p75: z.ZodOptional<z.ZodNumber>;
+      p90: z.ZodOptional<z.ZodNumber>;
+      p99: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>]>>;
+    preferredMaxLatency: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+      p50: z.ZodOptional<z.ZodNumber>;
+      p75: z.ZodOptional<z.ZodNumber>;
+      p90: z.ZodOptional<z.ZodNumber>;
+      p99: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>]>>;
+  }, z.core.$strict>>;
+  attributionReferer: z.ZodString;
+  attributionTitle: z.ZodString;
+  headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  modelOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    provider: z.ZodOptional<z.ZodObject<{
+      only: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+      order: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+      ignore: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+      allowFallbacks: z.ZodOptional<z.ZodBoolean>;
+      sort: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        price: "price";
+        throughput: "throughput";
+        latency: "latency";
+      }>, z.ZodObject<{
+        by: z.ZodEnum<{
+          price: "price";
+          throughput: "throughput";
+          latency: "latency";
+        }>;
+        partition: z.ZodOptional<z.ZodEnum<{
+          model: "model";
+          none: "none";
+        }>>;
+      }, z.core.$strict>]>>;
+      quantizations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      maxPrice: z.ZodOptional<z.ZodObject<{
+        prompt: z.ZodOptional<z.ZodNumber>;
+        completion: z.ZodOptional<z.ZodNumber>;
+        request: z.ZodOptional<z.ZodNumber>;
+        image: z.ZodOptional<z.ZodNumber>;
+      }, z.core.$strict>>;
+      requireParameters: z.ZodOptional<z.ZodBoolean>;
+      dataCollection: z.ZodOptional<z.ZodEnum<{
+        allow: "allow";
+        deny: "deny";
+      }>>;
+      zdr: z.ZodOptional<z.ZodBoolean>;
+      enforceDistillableText: z.ZodOptional<z.ZodBoolean>;
+      preferredMinThroughput: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+        p50: z.ZodOptional<z.ZodNumber>;
+        p75: z.ZodOptional<z.ZodNumber>;
+        p90: z.ZodOptional<z.ZodNumber>;
+        p99: z.ZodOptional<z.ZodNumber>;
+      }, z.core.$strict>]>>;
+      preferredMaxLatency: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+        p50: z.ZodOptional<z.ZodNumber>;
+        p75: z.ZodOptional<z.ZodNumber>;
+        p90: z.ZodOptional<z.ZodNumber>;
+        p99: z.ZodOptional<z.ZodNumber>;
+      }, z.core.$strict>]>>;
+    }, z.core.$strict>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  }, z.core.$strict>>>;
+}, z.core.$strict>;
+type ProxyConfig = z.infer<typeof proxyConfigSchema>;
+type ProviderConfig = z.infer<typeof providerConfigSchema>;
+type ModelOverride = z.infer<typeof modelOverrideSchema>;
+/** Wraps YAML/JSON parse errors with the config file path */
+declare class ConfigParseError extends Error {
+  constructor(filePath: string, cause?: Error);
+}
+/** Formats zod validation issues into a readable multi-line message */
+declare class ConfigValidationError extends Error {
+  constructor(filePath: string, zodError: z.ZodError);
+}
+//#endregion
+//#region src/config.d.ts
 /** Result of merging global config with a model-specific override */
 type ResolvedModelConfig = {
   provider?: ProviderConfig;
   headers?: Record<string, string>;
 };
-type ProxyConfig = {
-  host: string;
-  port: number;
-  openrouterKey: string;
-  openrouterBaseUrl: string;
-  verbose: boolean; /** Request body size limit (default: "50mb") */
-  bodyLimit: string; /** Provider routing configuration (global default) */
-  provider?: ProviderConfig; /** HTTP-Referer for OpenRouter attribution */
-  attributionReferer: string; /** X-Title for OpenRouter attribution */
-  attributionTitle: string; /** Custom headers to add to proxied requests (global default) */
-  headers?: Record<string, string>; /** Per-model config overrides. Keys are exact model names or prefix patterns (e.g. "claude-*") */
-  modelOverrides?: Record<string, ModelOverride>;
-};
 type LoadConfigOptions = {
   configPath?: string;
   noConfig?: boolean;
@@ -87,5 +257,5 @@ declare function toArray(value: string | string[] | undefined): string[] | undef
 /** Try to parse an ArrayBuffer as JSON. Returns undefined on failure or empty body. */
 declare function tryParseBody(raw: ArrayBuffer): Record<string, unknown> | undefined;
 //#endregion
-export { type ModelOverride, type ProviderConfig, type ProxyConfig, type ResolvedModelConfig, buildProviderRouting, createProxyServer, extractModel, loadConfig, matchScore, resolveModelConfig, toArray, tryParseBody };
+export { ConfigParseError, ConfigValidationError, type ModelOverride, type ProviderConfig, type ProxyConfig, type ResolvedModelConfig, buildProviderRouting, createProxyServer, extractModel, loadConfig, matchScore, resolveModelConfig, toArray, tryParseBody };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/config.ts","../src/proxy/inject.ts","../src/proxy.ts","../src/utils.ts"],"mappings":";;;;KAOY,iBAAA;EACV,GAAA;EACA,GAAA;EACA,GAAA;EACA,GAAA;AAAA;;KAIU,YAAA;EAIN,EAAA;EAAwC,SAAS;AAAA;AARlD;AAAA,KAWO,QAAA;EACV,MAAA;EACA,UAAA;EACA,OAAA;EACA,KAAA;AAAA;AAAA,KAGU,cAAA;iFAEV,IAAA,sBARA;EAUA,KAAA,sBARA;EAUA,MAAA,sBATK;EAWL,cAAA,YARU;EAUV,IAAA,GAAO,YAAA;EAEP,aAAA,aAEW;EAAX,QAAA,GAAW,QAAA,EAYoB;EAV/B,iBAAA,YAUgD;EARhD,cAAA,qBAdA;EAgBA,GAAA,YAZA;EAcA,sBAAA,YAZO;EAcP,sBAAA,YAAkC,iBAAA,EAVlC;EAYA,mBAAA,YAA+B,iBAAA;AAAA;;KAIrB,aAAA;EARV,oDAUA,QAAA,GAAW,cAAA,EARuB;EAUlC,OAAA,GAAU,MAAM;AAAA;;KAIN,mBAAA;EACV,QAAA,GAAW,cAAA;EACX,OAAA,GAAU,MAAM;AAAA;AAAA,KAGN,WAAA;EACV,IAAA;EACA,IAAA;EACA,aAAA;EACA,iBAAA;EACA,OAAA,WAdgB;EAgBhB,SAAA,UAZ6B;EAc7B,QAAA,GAAW,cAAA,EAZK;EAchB,kBAAA,UAfW;EAiBX,gBAAA,UAhBU;EAkBV,OAAA,GAAU,MAAA,kBAlBM;EAoBhB,cAAA,GAAiB,MAAA,SAAe,aAAA;AAAA;AAAA,KAc7B,iBAAA;EACH,UAAA;EACA,QAAA;EACA,IAAA;EACA,aAAA;EACA,IAAA;EACA,OAAA;AAAA;;iBAwBc,oBAAA,CACd,QAAA,GAAW,cAAA,GACV,MAAM;;iBA0BO,UAAA,CAAW,OAAA,UAAiB,SAAiB;;iBAW7C,kBAAA,CACd,MAAA,EAAQ,WAAA,EACR,SAAA,YACC,mBAAmB;AAAA,iBAgCA,UAAA,CAAW,OAAA,EAAS,iBAAA,GAAoB,OAAA,CAAQ,WAAA;;;;iBC5MtD,YAAA,CAAa,OAAoB,EAAX,WAAW;;;iBC0JjC,iBAAA,CAAkB,MAAA,EAAQ,WAAA,EAAa,OAAA,gBAAuB,UAAU;;;;iBC5JxE,OAAA,CAAQ,KAAoC;;iBAO5C,YAAA,CAAa,GAAA,EAAK,WAAA,GAAc,MAAM"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/config-schema.ts","../src/config.ts","../src/proxy/inject.ts","../src/proxy.ts","../src/utils.ts"],"mappings":";;;;;cAsCa,oBAAA,EAAoB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuBpB,mBAAA,EAAmB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAQnB,iBAAA,EAAiB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAuBlB,WAAA,GAAc,CAAA,CAAE,KAAK,QAAQ,iBAAA;AAAA,KAC7B,cAAA,GAAiB,CAAA,CAAE,KAAK,QAAQ,oBAAA;AAAA,KAChC,aAAA,GAAgB,CAAA,CAAE,KAAK,QAAQ,mBAAA;;cAU9B,gBAAA,SAAyB,KAAK;cAC7B,QAAA,UAAkB,KAAA,GAAQ,KAAA;AAAA;;cAU3B,qBAAA,SAA8B,KAAK;cAClC,QAAA,UAAkB,QAAA,EAAU,CAAA,CAAE,QAAA;AAAA;;;;KC5FhC,mBAAA;EACV,QAAA,GAAW,cAAA;EACX,OAAA,GAAU,MAAM;AAAA;AAAA,KAcb,iBAAA;EACH,UAAA;EACA,QAAA;EACA,IAAA;EACA,aAAA;EACA,IAAA;EACA,OAAA;AAAA;;iBAwBc,oBAAA,CACd,QAAA,GAAW,cAAA,GACV,MAAM;;iBA0BO,UAAA,CAAW,OAAA,UAAiB,SAAiB;;iBAW7C,kBAAA,CACd,MAAA,EAAQ,WAAA,EACR,SAAA,YACC,mBAAmB;AAAA,iBAgCA,UAAA,CAAW,OAAA,EAAS,iBAAA,GAAoB,OAAA,CAAQ,WAAA;;;;iBC7ItD,YAAA,CAAa,OAAoB,EAAX,WAAW;;;iBC0JjC,iBAAA,CAAkB,MAAA,EAAQ,WAAA,EAAa,OAAA,gBAAuB,UAAU;;;;iBC5JxE,OAAA,CAAQ,KAAoC;;iBAO5C,YAAA,CAAa,GAAA,EAAK,WAAA,GAAc,MAAM"}