@graphorin/provider 0.5.0 → 0.6.1

package/dist/counters/anthropic.js.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.js","names":["#modelId","#apiKey","#baseUrl","#fetchImpl","#fallback"],"sources":["../../src/counters/anthropic.ts"],"sourcesContent":["/**\n * `AnthropicAPICounter` — uses Anthropic's native count-tokens\n * endpoint when an API key is configured, otherwise falls back to\n * `JsTiktokenCounter`. The native call is opt-in: the user supplies\n * an explicit `apiKey`. The framework never makes the call without\n * one.\n *\n * @packageDocumentation\n */\n\nimport type { Message, TokenCounter } from '@graphorin/core';\n\nimport { stripTrailingSlashes } from '../internal/url-utils.js';\nimport { JsTiktokenCounter } from './js-tiktoken.js';\n\n/**\n * Options for {@link AnthropicAPICounter}.\n *\n * @stable\n */\nexport interface AnthropicAPICounterOptions {\n  readonly modelId: string;\n  readonly apiKey?: string;\n  readonly baseUrl?: string;\n  readonly fetchImpl?: typeof fetch;\n  /** Identifier carried on the produced counter. */\n  readonly id?: string;\n}\n\n/**\n * Counter that talks to `POST /v1/messages/count_tokens` when an API\n * key is configured. Without an API key, the counter delegates to\n * `JsTiktokenCounter('cl100k_base')` — the closest publicly-available\n * proxy for Anthropic's tokenizer.\n *\n * @stable\n */\nexport class AnthropicAPICounter implements TokenCounter {\n  readonly id: string;\n  readonly version: string;\n  readonly #modelId: string;\n  readonly #apiKey?: string;\n  readonly #baseUrl: string;\n  readonly #fetchImpl: typeof fetch;\n  readonly #fallback: JsTiktokenCounter;\n\n  constructor(options: AnthropicAPICounterOptions) {\n    this.#modelId = options.modelId;\n    if (options.apiKey !== undefined) this.#apiKey = options.apiKey;\n    this.#baseUrl = stripTrailingSlashes(options.baseUrl ?? 'https://api.anthropic.com');\n    this.#fetchImpl = options.fetchImpl ?? globalThis.fetch.bind(globalThis);\n    this.#fallback = new JsTiktokenCounter({ encoding: 'cl100k_base', modelId: options.modelId });\n    this.id = options.id ?? `anthropic-native@${options.modelId}`;\n    this.version = `anthropic-native-${options.modelId}-v1`;\n  }\n\n  async count(messages: ReadonlyArray<Message>): Promise<number> {\n    if (this.#apiKey === undefined) return this.#fallback.count(messages);\n    try {\n      const resp = await this.#fetchImpl(`${this.#baseUrl}/v1/messages/count_tokens`, {\n        method: 'POST',\n        headers: {\n          'content-type': 'application/json',\n          'x-api-key': this.#apiKey,\n          'anthropic-version': '2023-06-01',\n        },\n        body: JSON.stringify({ model: this.#modelId, messages }),\n      });\n      if (!resp.ok) return this.#fallback.count(messages);\n      const json = (await resp.json()) as { input_tokens?: number };\n      if (typeof json.input_tokens === 'number') return json.input_tokens;\n      return this.#fallback.count(messages);\n    } catch {\n      return this.#fallback.count(messages);\n    }\n  }\n\n  async countText(text: string): Promise<number> {\n    return this.#fallback.countText(text);\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAqCA,IAAa,sBAAb,MAAyD;CACvD,AAAS;CACT,AAAS;CACT,CAASA;CACT,CAASC;CACT,CAASC;CACT,CAASC;CACT,CAASC;CAET,YAAY,SAAqC;AAC/C,QAAKJ,UAAW,QAAQ;AACxB,MAAI,QAAQ,WAAW,OAAW,OAAKC,SAAU,QAAQ;AACzD,QAAKC,UAAW,qBAAqB,QAAQ,WAAW,4BAA4B;AACpF,QAAKC,YAAa,QAAQ,aAAa,WAAW,MAAM,KAAK,WAAW;AACxE,QAAKC,WAAY,IAAI,kBAAkB;GAAE,UAAU;GAAe,SAAS,QAAQ;GAAS,CAAC;AAC7F,OAAK,KAAK,QAAQ,MAAM,oBAAoB,QAAQ;AACpD,OAAK,UAAU,oBAAoB,QAAQ,QAAQ;;CAGrD,MAAM,MAAM,UAAmD;AAC7D,MAAI,MAAKH,WAAY,OAAW,QAAO,MAAKG,SAAU,MAAM,SAAS;AACrE,MAAI;GACF,MAAM,OAAO,MAAM,MAAKD,UAAW,GAAG,MAAKD,QAAS,4BAA4B;IAC9E,QAAQ;IACR,SAAS;KACP,gBAAgB;KAChB,aAAa,MAAKD;KAClB,qBAAqB;KACtB;IACD,MAAM,KAAK,UAAU;KAAE,OAAO,MAAKD;KAAU;KAAU,CAAC;IACzD,CAAC;AACF,OAAI,CAAC,KAAK,GAAI,QAAO,MAAKI,SAAU,MAAM,SAAS;GACnD,MAAM,OAAQ,MAAM,KAAK,MAAM;AAC/B,OAAI,OAAO,KAAK,iBAAiB,SAAU,QAAO,KAAK;AACvD,UAAO,MAAKA,SAAU,MAAM,SAAS;UAC/B;AACN,UAAO,MAAKA,SAAU,MAAM,SAAS;;;CAIzC,MAAM,UAAU,MAA+B;AAC7C,SAAO,MAAKA,SAAU,UAAU,KAAK"}
+{"version":3,"file":"anthropic.js","names":["#modelId","#apiKey","#baseUrl","#fetchImpl","#fallback","#logger","#warnFallback","#fallbackWarned"],"sources":["../../src/counters/anthropic.ts"],"sourcesContent":["/**\n * `AnthropicAPICounter` - uses Anthropic's native count-tokens\n * endpoint when an API key is configured, otherwise falls back to\n * `JsTiktokenCounter`. The native call is opt-in: the user supplies\n * an explicit `apiKey`. The framework never makes the call without\n * one.\n *\n * @packageDocumentation\n */\n\nimport type { Message, TokenCounter } from '@graphorin/core';\n\nimport { stripTrailingSlashes } from '../internal/url-utils.js';\nimport { toAnthropicCountPayload } from './anthropic-wire.js';\nimport { JsTiktokenCounter } from './js-tiktoken.js';\n\n/**\n * Options for {@link AnthropicAPICounter}.\n *\n * @stable\n */\nexport interface AnthropicAPICounterOptions {\n  readonly modelId: string;\n  readonly apiKey?: string;\n  readonly baseUrl?: string;\n  readonly fetchImpl?: typeof fetch;\n  /** Identifier carried on the produced counter. */\n  readonly id?: string;\n  /**\n   * Log sink for the WARN emitted (once per counter) when the native\n   * call degrades to the tiktoken fallback. Defaults to `console.warn`.\n   */\n  readonly logger?: (message: string, meta?: object) => void;\n}\n\n/**\n * Counter that talks to `POST /v1/messages/count_tokens` when an API\n * key is configured. Without an API key, the counter delegates to\n * `JsTiktokenCounter('cl100k_base')` - the closest publicly-available\n * proxy for Anthropic's tokenizer.\n *\n * @stable\n */\nexport class AnthropicAPICounter implements TokenCounter {\n  readonly id: string;\n  readonly version: string;\n  readonly #modelId: string;\n  readonly #apiKey?: string;\n  readonly #baseUrl: string;\n  readonly #fetchImpl: typeof fetch;\n  readonly #fallback: JsTiktokenCounter;\n  readonly #logger: (message: string, meta?: object) => void;\n  #fallbackWarned = false;\n\n  constructor(options: AnthropicAPICounterOptions) {\n    this.#modelId = options.modelId;\n    if (options.apiKey !== undefined) this.#apiKey = options.apiKey;\n    this.#baseUrl = stripTrailingSlashes(options.baseUrl ?? 'https://api.anthropic.com');\n    this.#fetchImpl = options.fetchImpl ?? globalThis.fetch.bind(globalThis);\n    this.#fallback = new JsTiktokenCounter({ encoding: 'cl100k_base', modelId: options.modelId });\n    this.#logger = options.logger ?? ((message, meta) => console.warn(message, meta ?? ''));\n    this.id = options.id ?? `anthropic-native@${options.modelId}`;\n    this.version = `anthropic-native-${options.modelId}-v1`;\n  }\n\n  async count(messages: ReadonlyArray<Message>): Promise<number> {\n    if (this.#apiKey === undefined) return this.#fallback.count(messages);\n    // core-provider-04: the endpoint accepts only Anthropic wire-shaped\n    // bodies. Posting Graphorin messages 400s on any transcript with a\n    // system / tool message or `toolCalls`, so convert first.\n    const payload = toAnthropicCountPayload(messages);\n    if (payload === null) return this.#fallback.count(messages);\n    try {\n      const resp = await this.#fetchImpl(`${this.#baseUrl}/v1/messages/count_tokens`, {\n        method: 'POST',\n        headers: {\n          'content-type': 'application/json',\n          'x-api-key': this.#apiKey,\n          'anthropic-version': '2023-06-01',\n        },\n        body: JSON.stringify({ model: this.#modelId, ...payload }),\n      });\n      if (!resp.ok) {\n        this.#warnFallback(`HTTP ${resp.status}`);\n        return this.#fallback.count(messages);\n      }\n      const json = (await resp.json()) as { input_tokens?: number };\n      if (typeof json.input_tokens === 'number') return json.input_tokens;\n      this.#warnFallback('response missing input_tokens');\n      return this.#fallback.count(messages);\n    } catch (cause) {\n      this.#warnFallback((cause as Error).message);\n      return this.#fallback.count(messages);\n    }\n  }\n\n  async countText(text: string): Promise<number> {\n    return this.#fallback.countText(text);\n  }\n\n  /**\n   * WARN once per counter when the native path degrades - a silent\n   * fallback to cl100k tiktoken undercounts Claude tokens by ~15-20%,\n   * so the degradation must be visible.\n   */\n  #warnFallback(reason: string): void {\n    if (this.#fallbackWarned) return;\n    this.#fallbackWarned = true;\n    this.#logger(\n      `[graphorin/provider] AnthropicAPICounter(${this.#modelId}): native count_tokens failed (${reason}); ` +\n        'falling back to cl100k tiktoken (undercounts Claude by ~15-20%). Further fallbacks are silent.',\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AA2CA,IAAa,sBAAb,MAAyD;CACvD,AAAS;CACT,AAAS;CACT,CAASA;CACT,CAASC;CACT,CAASC;CACT,CAASC;CACT,CAASC;CACT,CAASC;CACT,kBAAkB;CAElB,YAAY,SAAqC;AAC/C,QAAKL,UAAW,QAAQ;AACxB,MAAI,QAAQ,WAAW,OAAW,OAAKC,SAAU,QAAQ;AACzD,QAAKC,UAAW,qBAAqB,QAAQ,WAAW,4BAA4B;AACpF,QAAKC,YAAa,QAAQ,aAAa,WAAW,MAAM,KAAK,WAAW;AACxE,QAAKC,WAAY,IAAI,kBAAkB;GAAE,UAAU;GAAe,SAAS,QAAQ;GAAS,CAAC;AAC7F,QAAKC,SAAU,QAAQ,YAAY,SAAS,SAAS,QAAQ,KAAK,SAAS,QAAQ,GAAG;AACtF,OAAK,KAAK,QAAQ,MAAM,oBAAoB,QAAQ;AACpD,OAAK,UAAU,oBAAoB,QAAQ,QAAQ;;CAGrD,MAAM,MAAM,UAAmD;AAC7D,MAAI,MAAKJ,WAAY,OAAW,QAAO,MAAKG,SAAU,MAAM,SAAS;EAIrE,MAAM,UAAU,wBAAwB,SAAS;AACjD,MAAI,YAAY,KAAM,QAAO,MAAKA,SAAU,MAAM,SAAS;AAC3D,MAAI;GACF,MAAM,OAAO,MAAM,MAAKD,UAAW,GAAG,MAAKD,QAAS,4BAA4B;IAC9E,QAAQ;IACR,SAAS;KACP,gBAAgB;KAChB,aAAa,MAAKD;KAClB,qBAAqB;KACtB;IACD,MAAM,KAAK,UAAU;KAAE,OAAO,MAAKD;KAAU,GAAG;KAAS,CAAC;IAC3D,CAAC;AACF,OAAI,CAAC,KAAK,IAAI;AACZ,UAAKM,aAAc,QAAQ,KAAK,SAAS;AACzC,WAAO,MAAKF,SAAU,MAAM,SAAS;;GAEvC,MAAM,OAAQ,MAAM,KAAK,MAAM;AAC/B,OAAI,OAAO,KAAK,iBAAiB,SAAU,QAAO,KAAK;AACvD,SAAKE,aAAc,gCAAgC;AACnD,UAAO,MAAKF,SAAU,MAAM,SAAS;WAC9B,OAAO;AACd,SAAKE,aAAe,MAAgB,QAAQ;AAC5C,UAAO,MAAKF,SAAU,MAAM,SAAS;;;CAIzC,MAAM,UAAU,MAA+B;AAC7C,SAAO,MAAKA,SAAU,UAAU,KAAK;;;;;;;CAQvC,cAAc,QAAsB;AAClC,MAAI,MAAKG,eAAiB;AAC1B,QAAKA,iBAAkB;AACvB,QAAKF,OACH,4CAA4C,MAAKL,QAAS,iCAAiC,OAAO,mGAEnG"}

package/dist/counters/bedrock.js.map

@@ -1 +1 @@
-{"version":3,"file":"bedrock.js","names":["#fallback"],"sources":["../../src/counters/bedrock.ts"],"sourcesContent":["/**\n * `BedrockAPICounter` — placeholder counter that delegates to\n * `JsTiktokenCounter('cl100k_base')` for now (Bedrock's native\n * `count_tokens` API requires AWS Signature v4; full integration\n * lands in Phase 16). The proxy is sufficient for v0.1 within the\n * documented ±5% accuracy envelope.\n *\n * @packageDocumentation\n */\n\nimport type { Message, TokenCounter } from '@graphorin/core';\n\nimport { JsTiktokenCounter } from './js-tiktoken.js';\n\n/**\n * Options for {@link BedrockAPICounter}.\n *\n * @stable\n */\nexport interface BedrockAPICounterOptions {\n  readonly modelId: string;\n  readonly id?: string;\n}\n\n/**\n * @stable\n */\nexport class BedrockAPICounter implements TokenCounter {\n  readonly id: string;\n  readonly version: string;\n  readonly #fallback: JsTiktokenCounter;\n\n  constructor(options: BedrockAPICounterOptions) {\n    this.#fallback = new JsTiktokenCounter({ encoding: 'cl100k_base', modelId: options.modelId });\n    this.id = options.id ?? `bedrock-proxy@${options.modelId}`;\n    this.version = `bedrock-cl100k-proxy-${options.modelId}-v1`;\n  }\n\n  count(messages: ReadonlyArray<Message>): Promise<number> {\n    return this.#fallback.count(messages);\n  }\n\n  countText(text: string): Promise<number> {\n    return this.#fallback.countText(text);\n  }\n}\n"],"mappings":";;;;;;AA2BA,IAAa,oBAAb,MAAuD;CACrD,AAAS;CACT,AAAS;CACT,CAASA;CAET,YAAY,SAAmC;AAC7C,QAAKA,WAAY,IAAI,kBAAkB;GAAE,UAAU;GAAe,SAAS,QAAQ;GAAS,CAAC;AAC7F,OAAK,KAAK,QAAQ,MAAM,iBAAiB,QAAQ;AACjD,OAAK,UAAU,wBAAwB,QAAQ,QAAQ;;CAGzD,MAAM,UAAmD;AACvD,SAAO,MAAKA,SAAU,MAAM,SAAS;;CAGvC,UAAU,MAA+B;AACvC,SAAO,MAAKA,SAAU,UAAU,KAAK"}
+{"version":3,"file":"bedrock.js","names":["#fallback"],"sources":["../../src/counters/bedrock.ts"],"sourcesContent":["/**\n * `BedrockAPICounter` - placeholder counter that delegates to\n * `JsTiktokenCounter('cl100k_base')` for now (Bedrock's native\n * `count_tokens` API requires AWS Signature v4; full integration\n * lands in Phase 16). The proxy is sufficient for v0.1 within the\n * documented ±5% accuracy envelope.\n *\n * @packageDocumentation\n */\n\nimport type { Message, TokenCounter } from '@graphorin/core';\n\nimport { JsTiktokenCounter } from './js-tiktoken.js';\n\n/**\n * Options for {@link BedrockAPICounter}.\n *\n * @stable\n */\nexport interface BedrockAPICounterOptions {\n  readonly modelId: string;\n  readonly id?: string;\n}\n\n/**\n * @stable\n */\nexport class BedrockAPICounter implements TokenCounter {\n  readonly id: string;\n  readonly version: string;\n  readonly #fallback: JsTiktokenCounter;\n\n  constructor(options: BedrockAPICounterOptions) {\n    this.#fallback = new JsTiktokenCounter({ encoding: 'cl100k_base', modelId: options.modelId });\n    this.id = options.id ?? `bedrock-proxy@${options.modelId}`;\n    this.version = `bedrock-cl100k-proxy-${options.modelId}-v1`;\n  }\n\n  count(messages: ReadonlyArray<Message>): Promise<number> {\n    return this.#fallback.count(messages);\n  }\n\n  countText(text: string): Promise<number> {\n    return this.#fallback.countText(text);\n  }\n}\n"],"mappings":";;;;;;AA2BA,IAAa,oBAAb,MAAuD;CACrD,AAAS;CACT,AAAS;CACT,CAASA;CAET,YAAY,SAAmC;AAC7C,QAAKA,WAAY,IAAI,kBAAkB;GAAE,UAAU;GAAe,SAAS,QAAQ;GAAS,CAAC;AAC7F,OAAK,KAAK,QAAQ,MAAM,iBAAiB,QAAQ;AACjD,OAAK,UAAU,wBAAwB,QAAQ,QAAQ;;CAGzD,MAAM,UAAmD;AACvD,SAAO,MAAKA,SAAU,MAAM,SAAS;;CAGvC,UAAU,MAA+B;AACvC,SAAO,MAAKA,SAAU,UAAU,KAAK"}

package/dist/counters/dispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatcher.d.ts","names":[],"sources":["../../src/counters/dispatcher.ts"],"sourcesContent":[],"mappings":";;;;;;;;;UAuBiB,2BAAA;;;;;;;;;;;;;;;;;;;;;iBAuDD,oBAAA,UAA8B,8BAA8B"}
+{"version":3,"file":"dispatcher.d.ts","names":[],"sources":["../../src/counters/dispatcher.ts"],"sourcesContent":[],"mappings":";;;;;;;;;UAuBiB,2BAAA;;;;;;;;;;;;;;;;;;;;;iBA8DD,oBAAA,UAA8B,8BAA8B"}

package/dist/counters/dispatcher.js

@@ -14,13 +14,15 @@ import { HeuristicCounter } from "./heuristic.js";
 */
 function detectProviderFamily(args) {
 	const provider = args.provider?.toLowerCase();
-	const modelLower = args.model.toLowerCase();
-	if (provider === "anthropic" || modelLower.startsWith("claude") || modelLower.startsWith("anthropic.claude")) {
-		if (provider === "bedrock" || modelLower.startsWith("anthropic.claude")) return "bedrock";
+	const modelLower = args.model.toLowerCase().replace(/^(?:us|eu|apac|jp|au|us-gov)\./, "");
+	const providerIsAnthropic = provider?.startsWith("anthropic");
+	const providerIsBedrock = provider?.includes("bedrock");
+	if (providerIsAnthropic || modelLower.startsWith("claude") || modelLower.startsWith("anthropic.claude")) {
+		if (providerIsBedrock || modelLower.startsWith("anthropic.claude")) return "bedrock";
 		return "anthropic";
 	}
 	if (provider === "google" || modelLower.startsWith("gemini")) return "google";
-	if (provider === "bedrock") return "bedrock";
+	if (providerIsBedrock) return "bedrock";
 	if (provider === "openai" || provider === "azure-openai" || /^(gpt-|o1|o3|o4)/.test(modelLower)) return "openai";
 	if (provider === "ollama" || modelLower.startsWith("ollama-")) return "ollama";
 	if (provider === "openai-compatible" || provider === "lmstudio" || provider === "vllm") return "openai-compatible";

package/dist/counters/dispatcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"dispatcher.js","names":[],"sources":["../../src/counters/dispatcher.ts"],"sourcesContent":["/**\n * `createDefaultCounter` — model-id classifier that returns the\n * recommended {@link TokenCounter} for a given `(provider, model)`\n * pair. The same classifier is reused by the model-tier dispatcher\n * (`@graphorin/provider/model-tier`) so provider-family detection\n * lives in exactly one place.\n *\n * @packageDocumentation\n */\n\nimport type { TokenCounter } from '@graphorin/core';\n\nimport { AnthropicAPICounter } from './anthropic.js';\nimport { BedrockAPICounter } from './bedrock.js';\nimport { GoogleAPICounter } from './google.js';\nimport { HeuristicCounter } from './heuristic.js';\nimport { JsTiktokenCounter } from './js-tiktoken.js';\n\n/**\n * Options for {@link createDefaultCounter}.\n *\n * @stable\n */\nexport interface CreateDefaultCounterOptions {\n  /** Concrete model id (e.g. `'gpt-4o'`, `'claude-opus-4-7'`). */\n  readonly model: string;\n  /** Optional provider hint to short-circuit the regex matching. */\n  readonly provider?: string;\n  /** Optional Anthropic API key threaded through to {@link AnthropicAPICounter}. */\n  readonly anthropicApiKey?: string;\n}\n\n/**\n * Detect the provider family for a model id. Exposed for downstream\n * consumers (the model-tier classifier; future per-tool counters) so\n * provider-family detection is centralised here.\n *\n * @stable\n */\nexport function detectProviderFamily(args: {\n  readonly model: string;\n  readonly provider?: string;\n}): 'anthropic' | 'openai' | 'google' | 'bedrock' | 'ollama' | 'openai-compatible' | 'unknown' {\n  const provider = args.provider?.toLowerCase();\n  const modelLower = args.model.toLowerCase();\n  if (\n    provider === 'anthropic' ||\n    modelLower.startsWith('claude') ||\n    modelLower.startsWith('anthropic.claude')\n  ) {\n    if (provider === 'bedrock' || modelLower.startsWith('anthropic.claude')) return 'bedrock';\n    return 'anthropic';\n  }\n  if (provider === 'google' || modelLower.startsWith('gemini')) return 'google';\n  if (provider === 'bedrock') return 'bedrock';\n  if (provider === 'openai' || provider === 'azure-openai' || /^(gpt-|o1|o3|o4)/.test(modelLower)) {\n    return 'openai';\n  }\n  if (provider === 'ollama' || modelLower.startsWith('ollama-')) return 'ollama';\n  if (provider === 'openai-compatible' || provider === 'lmstudio' || provider === 'vllm') {\n    return 'openai-compatible';\n  }\n  return 'unknown';\n}\n\n/**\n * Build the recommended {@link TokenCounter} for the given\n * `(provider, model)` pair. The dispatch table:\n *\n * - Anthropic Claude → `AnthropicAPICounter` (native if `apiKey` set,\n *   otherwise `cl100k_base` proxy).\n * - OpenAI / OpenAI-compatible → `JsTiktokenCounter('cl100k_base')`.\n * - Google Gemini → `GoogleAPICounter` (cl100k_base proxy in v0.1).\n * - Bedrock Claude → `BedrockAPICounter` (cl100k_base proxy in v0.1).\n * - Ollama / unknown → `HeuristicCounter` with one WARN per process.\n *\n * @stable\n */\nexport function createDefaultCounter(options: CreateDefaultCounterOptions): TokenCounter {\n  const family = detectProviderFamily({\n    model: options.model,\n    ...(options.provider !== undefined ? { provider: options.provider } : {}),\n  });\n  switch (family) {\n    case 'anthropic':\n      return new AnthropicAPICounter({\n        modelId: options.model,\n        ...(options.anthropicApiKey !== undefined ? { apiKey: options.anthropicApiKey } : {}),\n      });\n    case 'bedrock':\n      return new BedrockAPICounter({ modelId: options.model });\n    case 'google':\n      return new GoogleAPICounter({ modelId: options.model });\n    case 'openai':\n    case 'openai-compatible':\n      return new JsTiktokenCounter({\n        encoding: defaultOpenAiEncoding(options.model),\n        modelId: options.model,\n      });\n    default:\n      return new HeuristicCounter({ modelId: options.model });\n  }\n}\n\n/**\n * PS-20: pick the fallback tiktoken encoding by model family. `js-tiktoken`'s\n * `encodingForModel` handles ids it recognises; this is the explicit fallback\n * for ids it does not (the 2025/2026 families). gpt-4o / gpt-4.1 / gpt-5+ and\n * the o-series reasoning models use `o200k_base`; legacy gpt-4 / gpt-3.5 stay\n * on `cl100k_base`.\n */\nexport function defaultOpenAiEncoding(model: string | undefined): 'o200k_base' | 'cl100k_base' {\n  if (model === undefined) return 'cl100k_base';\n  const id = model.toLowerCase();\n  const sep = Math.max(id.lastIndexOf('/'), id.lastIndexOf(':'));\n  const bare = sep === -1 ? id : id.slice(sep + 1);\n  return /^(?:gpt-4o|gpt-4\\.1|gpt-[5-9]|gpt-\\d{2}|o[1-9])/.test(bare)\n    ? 'o200k_base'\n    : 'cl100k_base';\n}\n"],"mappings":";;;;;;;;;;;;;;AAuCA,SAAgB,qBAAqB,MAG0D;CAC7F,MAAM,WAAW,KAAK,UAAU,aAAa;CAC7C,MAAM,aAAa,KAAK,MAAM,aAAa;AAC3C,KACE,aAAa,eACb,WAAW,WAAW,SAAS,IAC/B,WAAW,WAAW,mBAAmB,EACzC;AACA,MAAI,aAAa,aAAa,WAAW,WAAW,mBAAmB,CAAE,QAAO;AAChF,SAAO;;AAET,KAAI,aAAa,YAAY,WAAW,WAAW,SAAS,CAAE,QAAO;AACrE,KAAI,aAAa,UAAW,QAAO;AACnC,KAAI,aAAa,YAAY,aAAa,kBAAkB,mBAAmB,KAAK,WAAW,CAC7F,QAAO;AAET,KAAI,aAAa,YAAY,WAAW,WAAW,UAAU,CAAE,QAAO;AACtE,KAAI,aAAa,uBAAuB,aAAa,cAAc,aAAa,OAC9E,QAAO;AAET,QAAO;;;;;;;;;;;;;;;AAgBT,SAAgB,qBAAqB,SAAoD;AAKvF,SAJe,qBAAqB;EAClC,OAAO,QAAQ;EACf,GAAI,QAAQ,aAAa,SAAY,EAAE,UAAU,QAAQ,UAAU,GAAG,EAAE;EACzE,CAAC,EACF;EACE,KAAK,YACH,QAAO,IAAI,oBAAoB;GAC7B,SAAS,QAAQ;GACjB,GAAI,QAAQ,oBAAoB,SAAY,EAAE,QAAQ,QAAQ,iBAAiB,GAAG,EAAE;GACrF,CAAC;EACJ,KAAK,UACH,QAAO,IAAI,kBAAkB,EAAE,SAAS,QAAQ,OAAO,CAAC;EAC1D,KAAK,SACH,QAAO,IAAI,iBAAiB,EAAE,SAAS,QAAQ,OAAO,CAAC;EACzD,KAAK;EACL,KAAK,oBACH,QAAO,IAAI,kBAAkB;GAC3B,UAAU,sBAAsB,QAAQ,MAAM;GAC9C,SAAS,QAAQ;GAClB,CAAC;EACJ,QACE,QAAO,IAAI,iBAAiB,EAAE,SAAS,QAAQ,OAAO,CAAC;;;;;;;;;;AAW7D,SAAgB,sBAAsB,OAAyD;AAC7F,KAAI,UAAU,OAAW,QAAO;CAChC,MAAM,KAAK,MAAM,aAAa;CAC9B,MAAM,MAAM,KAAK,IAAI,GAAG,YAAY,IAAI,EAAE,GAAG,YAAY,IAAI,CAAC;CAC9D,MAAM,OAAO,QAAQ,KAAK,KAAK,GAAG,MAAM,MAAM,EAAE;AAChD,QAAO,kDAAkD,KAAK,KAAK,GAC/D,eACA"}
+{"version":3,"file":"dispatcher.js","names":[],"sources":["../../src/counters/dispatcher.ts"],"sourcesContent":["/**\n * `createDefaultCounter` - model-id classifier that returns the\n * recommended {@link TokenCounter} for a given `(provider, model)`\n * pair. The same classifier is reused by the model-tier dispatcher\n * (`@graphorin/provider/model-tier`) so provider-family detection\n * lives in exactly one place.\n *\n * @packageDocumentation\n */\n\nimport type { TokenCounter } from '@graphorin/core';\n\nimport { AnthropicAPICounter } from './anthropic.js';\nimport { BedrockAPICounter } from './bedrock.js';\nimport { GoogleAPICounter } from './google.js';\nimport { HeuristicCounter } from './heuristic.js';\nimport { JsTiktokenCounter } from './js-tiktoken.js';\n\n/**\n * Options for {@link createDefaultCounter}.\n *\n * @stable\n */\nexport interface CreateDefaultCounterOptions {\n  /** Concrete model id (e.g. `'gpt-4o'`, `'claude-opus-4-7'`). */\n  readonly model: string;\n  /** Optional provider hint to short-circuit the regex matching. */\n  readonly provider?: string;\n  /** Optional Anthropic API key threaded through to {@link AnthropicAPICounter}. */\n  readonly anthropicApiKey?: string;\n}\n\n/**\n * Detect the provider family for a model id. Exposed for downstream\n * consumers (the model-tier classifier; future per-tool counters) so\n * provider-family detection is centralised here.\n *\n * @stable\n */\nexport function detectProviderFamily(args: {\n  readonly model: string;\n  readonly provider?: string;\n}): 'anthropic' | 'openai' | 'google' | 'bedrock' | 'ollama' | 'openai-compatible' | 'unknown' {\n  const provider = args.provider?.toLowerCase();\n  // Strip the Bedrock cross-region inference-profile prefix\n  // (`us.anthropic.claude-…`) so region-qualified ids classify like\n  // their bare form (core-provider-11).\n  const modelLower = args.model.toLowerCase().replace(/^(?:us|eu|apac|jp|au|us-gov)\\./, '');\n  // The AI SDK reports dotted provider ids ('anthropic.messages',\n  // 'amazon-bedrock.messages'), so match by prefix / substring.\n  const providerIsAnthropic = provider?.startsWith('anthropic');\n  const providerIsBedrock = provider?.includes('bedrock');\n  if (\n    providerIsAnthropic ||\n    modelLower.startsWith('claude') ||\n    modelLower.startsWith('anthropic.claude')\n  ) {\n    if (providerIsBedrock || modelLower.startsWith('anthropic.claude')) return 'bedrock';\n    return 'anthropic';\n  }\n  if (provider === 'google' || modelLower.startsWith('gemini')) return 'google';\n  if (providerIsBedrock) return 'bedrock';\n  if (provider === 'openai' || provider === 'azure-openai' || /^(gpt-|o1|o3|o4)/.test(modelLower)) {\n    return 'openai';\n  }\n  if (provider === 'ollama' || modelLower.startsWith('ollama-')) return 'ollama';\n  if (provider === 'openai-compatible' || provider === 'lmstudio' || provider === 'vllm') {\n    return 'openai-compatible';\n  }\n  return 'unknown';\n}\n\n/**\n * Build the recommended {@link TokenCounter} for the given\n * `(provider, model)` pair. The dispatch table:\n *\n * - Anthropic Claude → `AnthropicAPICounter` (native if `apiKey` set,\n *   otherwise `cl100k_base` proxy).\n * - OpenAI / OpenAI-compatible → `JsTiktokenCounter('cl100k_base')`.\n * - Google Gemini → `GoogleAPICounter` (cl100k_base proxy in v0.1).\n * - Bedrock Claude → `BedrockAPICounter` (cl100k_base proxy in v0.1).\n * - Ollama / unknown → `HeuristicCounter` with one WARN per process.\n *\n * @stable\n */\nexport function createDefaultCounter(options: CreateDefaultCounterOptions): TokenCounter {\n  const family = detectProviderFamily({\n    model: options.model,\n    ...(options.provider !== undefined ? { provider: options.provider } : {}),\n  });\n  switch (family) {\n    case 'anthropic':\n      return new AnthropicAPICounter({\n        modelId: options.model,\n        ...(options.anthropicApiKey !== undefined ? { apiKey: options.anthropicApiKey } : {}),\n      });\n    case 'bedrock':\n      return new BedrockAPICounter({ modelId: options.model });\n    case 'google':\n      return new GoogleAPICounter({ modelId: options.model });\n    case 'openai':\n    case 'openai-compatible':\n      return new JsTiktokenCounter({\n        encoding: defaultOpenAiEncoding(options.model),\n        modelId: options.model,\n      });\n    default:\n      return new HeuristicCounter({ modelId: options.model });\n  }\n}\n\n/**\n * PS-20: pick the fallback tiktoken encoding by model family. `js-tiktoken`'s\n * `encodingForModel` handles ids it recognises; this is the explicit fallback\n * for ids it does not (the 2025/2026 families). gpt-4o / gpt-4.1 / gpt-5+ and\n * the o-series reasoning models use `o200k_base`; legacy gpt-4 / gpt-3.5 stay\n * on `cl100k_base`.\n */\nexport function defaultOpenAiEncoding(model: string | undefined): 'o200k_base' | 'cl100k_base' {\n  if (model === undefined) return 'cl100k_base';\n  const id = model.toLowerCase();\n  const sep = Math.max(id.lastIndexOf('/'), id.lastIndexOf(':'));\n  const bare = sep === -1 ? id : id.slice(sep + 1);\n  return /^(?:gpt-4o|gpt-4\\.1|gpt-[5-9]|gpt-\\d{2}|o[1-9])/.test(bare)\n    ? 'o200k_base'\n    : 'cl100k_base';\n}\n"],"mappings":";;;;;;;;;;;;;;AAuCA,SAAgB,qBAAqB,MAG0D;CAC7F,MAAM,WAAW,KAAK,UAAU,aAAa;CAI7C,MAAM,aAAa,KAAK,MAAM,aAAa,CAAC,QAAQ,kCAAkC,GAAG;CAGzF,MAAM,sBAAsB,UAAU,WAAW,YAAY;CAC7D,MAAM,oBAAoB,UAAU,SAAS,UAAU;AACvD,KACE,uBACA,WAAW,WAAW,SAAS,IAC/B,WAAW,WAAW,mBAAmB,EACzC;AACA,MAAI,qBAAqB,WAAW,WAAW,mBAAmB,CAAE,QAAO;AAC3E,SAAO;;AAET,KAAI,aAAa,YAAY,WAAW,WAAW,SAAS,CAAE,QAAO;AACrE,KAAI,kBAAmB,QAAO;AAC9B,KAAI,aAAa,YAAY,aAAa,kBAAkB,mBAAmB,KAAK,WAAW,CAC7F,QAAO;AAET,KAAI,aAAa,YAAY,WAAW,WAAW,UAAU,CAAE,QAAO;AACtE,KAAI,aAAa,uBAAuB,aAAa,cAAc,aAAa,OAC9E,QAAO;AAET,QAAO;;;;;;;;;;;;;;;AAgBT,SAAgB,qBAAqB,SAAoD;AAKvF,SAJe,qBAAqB;EAClC,OAAO,QAAQ;EACf,GAAI,QAAQ,aAAa,SAAY,EAAE,UAAU,QAAQ,UAAU,GAAG,EAAE;EACzE,CAAC,EACF;EACE,KAAK,YACH,QAAO,IAAI,oBAAoB;GAC7B,SAAS,QAAQ;GACjB,GAAI,QAAQ,oBAAoB,SAAY,EAAE,QAAQ,QAAQ,iBAAiB,GAAG,EAAE;GACrF,CAAC;EACJ,KAAK,UACH,QAAO,IAAI,kBAAkB,EAAE,SAAS,QAAQ,OAAO,CAAC;EAC1D,KAAK,SACH,QAAO,IAAI,iBAAiB,EAAE,SAAS,QAAQ,OAAO,CAAC;EACzD,KAAK;EACL,KAAK,oBACH,QAAO,IAAI,kBAAkB;GAC3B,UAAU,sBAAsB,QAAQ,MAAM;GAC9C,SAAS,QAAQ;GAClB,CAAC;EACJ,QACE,QAAO,IAAI,iBAAiB,EAAE,SAAS,QAAQ,OAAO,CAAC;;;;;;;;;;AAW7D,SAAgB,sBAAsB,OAAyD;AAC7F,KAAI,UAAU,OAAW,QAAO;CAChC,MAAM,KAAK,MAAM,aAAa;CAC9B,MAAM,MAAM,KAAK,IAAI,GAAG,YAAY,IAAI,EAAE,GAAG,YAAY,IAAI,CAAC;CAC9D,MAAM,OAAO,QAAQ,KAAK,KAAK,GAAG,MAAM,MAAM,EAAE;AAChD,QAAO,kDAAkD,KAAK,KAAK,GAC/D,eACA"}

package/dist/counters/google.js.map

@@ -1 +1 @@
-{"version":3,"file":"google.js","names":["#fallback"],"sources":["../../src/counters/google.ts"],"sourcesContent":["/**\n * `GoogleAPICounter` — placeholder counter that delegates to\n * `JsTiktokenCounter('cl100k_base')` for now. The full Google `:countTokens`\n * implementation lands in Phase 16 alongside the optional pricing\n * refresher; for v0.1 the proxy is sufficient (verified within ±5% on\n * the standard fixture corpus per the existing DEC-131 acceptance).\n *\n * @packageDocumentation\n */\n\nimport type { Message, TokenCounter } from '@graphorin/core';\n\nimport { JsTiktokenCounter } from './js-tiktoken.js';\n\n/**\n * Options for {@link GoogleAPICounter}.\n *\n * @stable\n */\nexport interface GoogleAPICounterOptions {\n  readonly modelId: string;\n  readonly id?: string;\n}\n\n/**\n * @stable\n */\nexport class GoogleAPICounter implements TokenCounter {\n  readonly id: string;\n  readonly version: string;\n  readonly #fallback: JsTiktokenCounter;\n\n  constructor(options: GoogleAPICounterOptions) {\n    this.#fallback = new JsTiktokenCounter({ encoding: 'cl100k_base', modelId: options.modelId });\n    this.id = options.id ?? `google-proxy@${options.modelId}`;\n    this.version = `google-cl100k-proxy-${options.modelId}-v1`;\n  }\n\n  count(messages: ReadonlyArray<Message>): Promise<number> {\n    return this.#fallback.count(messages);\n  }\n\n  countText(text: string): Promise<number> {\n    return this.#fallback.countText(text);\n  }\n}\n"],"mappings":";;;;;;AA2BA,IAAa,mBAAb,MAAsD;CACpD,AAAS;CACT,AAAS;CACT,CAASA;CAET,YAAY,SAAkC;AAC5C,QAAKA,WAAY,IAAI,kBAAkB;GAAE,UAAU;GAAe,SAAS,QAAQ;GAAS,CAAC;AAC7F,OAAK,KAAK,QAAQ,MAAM,gBAAgB,QAAQ;AAChD,OAAK,UAAU,uBAAuB,QAAQ,QAAQ;;CAGxD,MAAM,UAAmD;AACvD,SAAO,MAAKA,SAAU,MAAM,SAAS;;CAGvC,UAAU,MAA+B;AACvC,SAAO,MAAKA,SAAU,UAAU,KAAK"}
+{"version":3,"file":"google.js","names":["#fallback"],"sources":["../../src/counters/google.ts"],"sourcesContent":["/**\n * `GoogleAPICounter` - placeholder counter that delegates to\n * `JsTiktokenCounter('cl100k_base')` for now. The full Google `:countTokens`\n * implementation lands in Phase 16 alongside the optional pricing\n * refresher; for v0.1 the proxy is sufficient (verified within ±5% on\n * the standard fixture corpus per the existing DEC-131 acceptance).\n *\n * @packageDocumentation\n */\n\nimport type { Message, TokenCounter } from '@graphorin/core';\n\nimport { JsTiktokenCounter } from './js-tiktoken.js';\n\n/**\n * Options for {@link GoogleAPICounter}.\n *\n * @stable\n */\nexport interface GoogleAPICounterOptions {\n  readonly modelId: string;\n  readonly id?: string;\n}\n\n/**\n * @stable\n */\nexport class GoogleAPICounter implements TokenCounter {\n  readonly id: string;\n  readonly version: string;\n  readonly #fallback: JsTiktokenCounter;\n\n  constructor(options: GoogleAPICounterOptions) {\n    this.#fallback = new JsTiktokenCounter({ encoding: 'cl100k_base', modelId: options.modelId });\n    this.id = options.id ?? `google-proxy@${options.modelId}`;\n    this.version = `google-cl100k-proxy-${options.modelId}-v1`;\n  }\n\n  count(messages: ReadonlyArray<Message>): Promise<number> {\n    return this.#fallback.count(messages);\n  }\n\n  countText(text: string): Promise<number> {\n    return this.#fallback.countText(text);\n  }\n}\n"],"mappings":";;;;;;AA2BA,IAAa,mBAAb,MAAsD;CACpD,AAAS;CACT,AAAS;CACT,CAASA;CAET,YAAY,SAAkC;AAC5C,QAAKA,WAAY,IAAI,kBAAkB;GAAE,UAAU;GAAe,SAAS,QAAQ;GAAS,CAAC;AAC7F,OAAK,KAAK,QAAQ,MAAM,gBAAgB,QAAQ;AAChD,OAAK,UAAU,uBAAuB,QAAQ,QAAQ;;CAGxD,MAAM,UAAmD;AACvD,SAAO,MAAKA,SAAU,MAAM,SAAS;;CAGvC,UAAU,MAA+B;AACvC,SAAO,MAAKA,SAAU,UAAU,KAAK"}

package/dist/counters/js-tiktoken.js.map

@@ -1 +1 @@
-{"version":3,"file":"js-tiktoken.js","names":["cachedModule: TiktokenModule | null","#encoding","#modelId","#moduleOverride","#getEncoder","#encoder","mod: TiktokenModule"],"sources":["../../src/counters/js-tiktoken.ts"],"sourcesContent":["/**\n * `JsTiktokenCounter` — default counter for OpenAI / OpenAI-compatible\n * models. The package depends on the `js-tiktoken` peer; when the peer\n * is missing, instantiation throws at first call rather than silently\n * downgrading to a heuristic.\n *\n * @packageDocumentation\n */\n\nimport type { Message, TokenCounter } from '@graphorin/core';\n\nimport { serialiseMessageForCount, serializedToString } from './serialize.js';\n\n/**\n * Loose shape of a `js-tiktoken` encoding. Matches the public\n * `Tiktoken` instance returned by `getEncoding(...)` in the upstream\n * package (we only use `encode` / `name`).\n *\n * @internal\n */\ninterface TiktokenEncoding {\n  readonly name?: string;\n  encode(text: string): { length: number };\n}\n\ninterface TiktokenModule {\n  getEncoding(name: string): TiktokenEncoding;\n  encodingForModel?: (model: string) => TiktokenEncoding;\n}\n\n/**\n * Options for {@link JsTiktokenCounter}.\n *\n * @stable\n */\nexport interface JsTiktokenCounterOptions {\n  /** Encoding name (`'cl100k_base'`, `'o200k_base'`, …). Default `'cl100k_base'`. */\n  readonly encoding?: string;\n  /** Optional model id used by `encodingForModel`. Falls back to the explicit `encoding`. */\n  readonly modelId?: string;\n  /**\n   * Override the dynamically-loaded module. Used by tests to inject a\n   * stub without taking the real `js-tiktoken` peer dependency.\n   */\n  readonly moduleOverride?: TiktokenModule;\n  /** Identifier carried on the produced counter. */\n  readonly id?: string;\n}\n\nlet cachedModule: TiktokenModule | null = null;\n\n/**\n * Counter that delegates to the `js-tiktoken` package. Caches the\n * dynamically-loaded module per process; tests use `moduleOverride`\n * to supply a fixture-shaped substitute.\n *\n * @stable\n */\nexport class JsTiktokenCounter implements TokenCounter {\n  readonly id: string;\n  readonly version: string;\n  readonly #encoding: string;\n  readonly #modelId?: string;\n  readonly #moduleOverride?: TiktokenModule;\n  #encoder: TiktokenEncoding | null = null;\n\n  constructor(options: JsTiktokenCounterOptions = {}) {\n    this.#encoding = options.encoding ?? 'cl100k_base';\n    if (options.modelId !== undefined) this.#modelId = options.modelId;\n    if (options.moduleOverride !== undefined) this.#moduleOverride = options.moduleOverride;\n    this.id = options.id ?? `js-tiktoken@${this.#encoding}`;\n    this.version = `js-tiktoken-${this.#encoding}-v1`;\n  }\n\n  async count(messages: ReadonlyArray<Message>): Promise<number> {\n    const enc = await this.#getEncoder();\n    let total = 0;\n    for (const msg of messages) {\n      const serialised = serialiseMessageForCount(msg);\n      total += enc.encode(serializedToString(serialised)).length;\n    }\n    return total;\n  }\n\n  async countText(text: string): Promise<number> {\n    if (text.length === 0) return 0;\n    const enc = await this.#getEncoder();\n    return enc.encode(text).length;\n  }\n\n  async #getEncoder(): Promise<TiktokenEncoding> {\n    if (this.#encoder !== null) return this.#encoder;\n    const mod = this.#moduleOverride ?? (await loadTiktokenModule());\n    if (this.#modelId !== undefined && mod.encodingForModel !== undefined) {\n      try {\n        this.#encoder = mod.encodingForModel(this.#modelId);\n        return this.#encoder;\n      } catch {\n        // Fall through to the explicit encoding.\n      }\n    }\n    this.#encoder = mod.getEncoding(this.#encoding);\n    return this.#encoder;\n  }\n}\n\nasync function loadTiktokenModule(): Promise<TiktokenModule> {\n  if (cachedModule !== null) return cachedModule;\n  let mod: TiktokenModule;\n  try {\n    mod = (await import('js-tiktoken')) as TiktokenModule;\n  } catch (cause) {\n    throw new Error(\n      \"[graphorin/provider] JsTiktokenCounter requires the 'js-tiktoken' peer dependency. \" +\n        'Install it with `pnpm add js-tiktoken` or pass moduleOverride for tests.',\n      { cause },\n    );\n  }\n  if (typeof mod.getEncoding !== 'function') {\n    throw new Error(\n      '[graphorin/provider] JsTiktokenCounter: installed js-tiktoken does not expose getEncoding().',\n    );\n  }\n  cachedModule = mod;\n  return cachedModule;\n}\n\n/**\n * Test-only hook that resets the cached `js-tiktoken` module loader.\n *\n * @internal\n */\nexport function __resetTiktokenCache(): void {\n  cachedModule = null;\n}\n"],"mappings":";;;AAiDA,IAAIA,eAAsC;;;;;;;;AAS1C,IAAa,oBAAb,MAAuD;CACrD,AAAS;CACT,AAAS;CACT,CAASC;CACT,CAASC;CACT,CAASC;CACT,WAAoC;CAEpC,YAAY,UAAoC,EAAE,EAAE;AAClD,QAAKF,WAAY,QAAQ,YAAY;AACrC,MAAI,QAAQ,YAAY,OAAW,OAAKC,UAAW,QAAQ;AAC3D,MAAI,QAAQ,mBAAmB,OAAW,OAAKC,iBAAkB,QAAQ;AACzE,OAAK,KAAK,QAAQ,MAAM,eAAe,MAAKF;AAC5C,OAAK,UAAU,eAAe,MAAKA,SAAU;;CAG/C,MAAM,MAAM,UAAmD;EAC7D,MAAM,MAAM,MAAM,MAAKG,YAAa;EACpC,IAAI,QAAQ;AACZ,OAAK,MAAM,OAAO,UAAU;GAC1B,MAAM,aAAa,yBAAyB,IAAI;AAChD,YAAS,IAAI,OAAO,mBAAmB,WAAW,CAAC,CAAC;;AAEtD,SAAO;;CAGT,MAAM,UAAU,MAA+B;AAC7C,MAAI,KAAK,WAAW,EAAG,QAAO;AAE9B,UADY,MAAM,MAAKA,YAAa,EACzB,OAAO,KAAK,CAAC;;CAG1B,OAAMA,aAAyC;AAC7C,MAAI,MAAKC,YAAa,KAAM,QAAO,MAAKA;EACxC,MAAM,MAAM,MAAKF,kBAAoB,MAAM,oBAAoB;AAC/D,MAAI,MAAKD,YAAa,UAAa,IAAI,qBAAqB,OAC1D,KAAI;AACF,SAAKG,UAAW,IAAI,iBAAiB,MAAKH,QAAS;AACnD,UAAO,MAAKG;UACN;AAIV,QAAKA,UAAW,IAAI,YAAY,MAAKJ,SAAU;AAC/C,SAAO,MAAKI;;;AAIhB,eAAe,qBAA8C;AAC3D,KAAI,iBAAiB,KAAM,QAAO;CAClC,IAAIC;AACJ,KAAI;AACF,QAAO,MAAM,OAAO;UACb,OAAO;AACd,QAAM,IAAI,MACR,+JAEA,EAAE,OAAO,CACV;;AAEH,KAAI,OAAO,IAAI,gBAAgB,WAC7B,OAAM,IAAI,MACR,+FACD;AAEH,gBAAe;AACf,QAAO;;;;;;;AAQT,SAAgB,uBAA6B;AAC3C,gBAAe"}
+{"version":3,"file":"js-tiktoken.js","names":["cachedModule: TiktokenModule | null","#encoding","#modelId","#moduleOverride","#getEncoder","#encoder","mod: TiktokenModule"],"sources":["../../src/counters/js-tiktoken.ts"],"sourcesContent":["/**\n * `JsTiktokenCounter` - default counter for OpenAI / OpenAI-compatible\n * models. The package depends on the `js-tiktoken` peer; when the peer\n * is missing, instantiation throws at first call rather than silently\n * downgrading to a heuristic.\n *\n * @packageDocumentation\n */\n\nimport type { Message, TokenCounter } from '@graphorin/core';\n\nimport { serialiseMessageForCount, serializedToString } from './serialize.js';\n\n/**\n * Loose shape of a `js-tiktoken` encoding. Matches the public\n * `Tiktoken` instance returned by `getEncoding(...)` in the upstream\n * package (we only use `encode` / `name`).\n *\n * @internal\n */\ninterface TiktokenEncoding {\n  readonly name?: string;\n  encode(text: string): { length: number };\n}\n\ninterface TiktokenModule {\n  getEncoding(name: string): TiktokenEncoding;\n  encodingForModel?: (model: string) => TiktokenEncoding;\n}\n\n/**\n * Options for {@link JsTiktokenCounter}.\n *\n * @stable\n */\nexport interface JsTiktokenCounterOptions {\n  /** Encoding name (`'cl100k_base'`, `'o200k_base'`, …). Default `'cl100k_base'`. */\n  readonly encoding?: string;\n  /** Optional model id used by `encodingForModel`. Falls back to the explicit `encoding`. */\n  readonly modelId?: string;\n  /**\n   * Override the dynamically-loaded module. Used by tests to inject a\n   * stub without taking the real `js-tiktoken` peer dependency.\n   */\n  readonly moduleOverride?: TiktokenModule;\n  /** Identifier carried on the produced counter. */\n  readonly id?: string;\n}\n\nlet cachedModule: TiktokenModule | null = null;\n\n/**\n * Counter that delegates to the `js-tiktoken` package. Caches the\n * dynamically-loaded module per process; tests use `moduleOverride`\n * to supply a fixture-shaped substitute.\n *\n * @stable\n */\nexport class JsTiktokenCounter implements TokenCounter {\n  readonly id: string;\n  readonly version: string;\n  readonly #encoding: string;\n  readonly #modelId?: string;\n  readonly #moduleOverride?: TiktokenModule;\n  #encoder: TiktokenEncoding | null = null;\n\n  constructor(options: JsTiktokenCounterOptions = {}) {\n    this.#encoding = options.encoding ?? 'cl100k_base';\n    if (options.modelId !== undefined) this.#modelId = options.modelId;\n    if (options.moduleOverride !== undefined) this.#moduleOverride = options.moduleOverride;\n    this.id = options.id ?? `js-tiktoken@${this.#encoding}`;\n    this.version = `js-tiktoken-${this.#encoding}-v1`;\n  }\n\n  async count(messages: ReadonlyArray<Message>): Promise<number> {\n    const enc = await this.#getEncoder();\n    let total = 0;\n    for (const msg of messages) {\n      const serialised = serialiseMessageForCount(msg);\n      total += enc.encode(serializedToString(serialised)).length;\n    }\n    return total;\n  }\n\n  async countText(text: string): Promise<number> {\n    if (text.length === 0) return 0;\n    const enc = await this.#getEncoder();\n    return enc.encode(text).length;\n  }\n\n  async #getEncoder(): Promise<TiktokenEncoding> {\n    if (this.#encoder !== null) return this.#encoder;\n    const mod = this.#moduleOverride ?? (await loadTiktokenModule());\n    if (this.#modelId !== undefined && mod.encodingForModel !== undefined) {\n      try {\n        this.#encoder = mod.encodingForModel(this.#modelId);\n        return this.#encoder;\n      } catch {\n        // Fall through to the explicit encoding.\n      }\n    }\n    this.#encoder = mod.getEncoding(this.#encoding);\n    return this.#encoder;\n  }\n}\n\nasync function loadTiktokenModule(): Promise<TiktokenModule> {\n  if (cachedModule !== null) return cachedModule;\n  let mod: TiktokenModule;\n  try {\n    mod = (await import('js-tiktoken')) as TiktokenModule;\n  } catch (cause) {\n    throw new Error(\n      \"[graphorin/provider] JsTiktokenCounter requires the 'js-tiktoken' peer dependency. \" +\n        'Install it with `pnpm add js-tiktoken` or pass moduleOverride for tests.',\n      { cause },\n    );\n  }\n  if (typeof mod.getEncoding !== 'function') {\n    throw new Error(\n      '[graphorin/provider] JsTiktokenCounter: installed js-tiktoken does not expose getEncoding().',\n    );\n  }\n  cachedModule = mod;\n  return cachedModule;\n}\n\n/**\n * Test-only hook that resets the cached `js-tiktoken` module loader.\n *\n * @internal\n */\nexport function __resetTiktokenCache(): void {\n  cachedModule = null;\n}\n"],"mappings":";;;AAiDA,IAAIA,eAAsC;;;;;;;;AAS1C,IAAa,oBAAb,MAAuD;CACrD,AAAS;CACT,AAAS;CACT,CAASC;CACT,CAASC;CACT,CAASC;CACT,WAAoC;CAEpC,YAAY,UAAoC,EAAE,EAAE;AAClD,QAAKF,WAAY,QAAQ,YAAY;AACrC,MAAI,QAAQ,YAAY,OAAW,OAAKC,UAAW,QAAQ;AAC3D,MAAI,QAAQ,mBAAmB,OAAW,OAAKC,iBAAkB,QAAQ;AACzE,OAAK,KAAK,QAAQ,MAAM,eAAe,MAAKF;AAC5C,OAAK,UAAU,eAAe,MAAKA,SAAU;;CAG/C,MAAM,MAAM,UAAmD;EAC7D,MAAM,MAAM,MAAM,MAAKG,YAAa;EACpC,IAAI,QAAQ;AACZ,OAAK,MAAM,OAAO,UAAU;GAC1B,MAAM,aAAa,yBAAyB,IAAI;AAChD,YAAS,IAAI,OAAO,mBAAmB,WAAW,CAAC,CAAC;;AAEtD,SAAO;;CAGT,MAAM,UAAU,MAA+B;AAC7C,MAAI,KAAK,WAAW,EAAG,QAAO;AAE9B,UADY,MAAM,MAAKA,YAAa,EACzB,OAAO,KAAK,CAAC;;CAG1B,OAAMA,aAAyC;AAC7C,MAAI,MAAKC,YAAa,KAAM,QAAO,MAAKA;EACxC,MAAM,MAAM,MAAKF,kBAAoB,MAAM,oBAAoB;AAC/D,MAAI,MAAKD,YAAa,UAAa,IAAI,qBAAqB,OAC1D,KAAI;AACF,SAAKG,UAAW,IAAI,iBAAiB,MAAKH,QAAS;AACnD,UAAO,MAAKG;UACN;AAIV,QAAKA,UAAW,IAAI,YAAY,MAAKJ,SAAU;AAC/C,SAAO,MAAKI;;;AAIhB,eAAe,qBAA8C;AAC3D,KAAI,iBAAiB,KAAM,QAAO;CAClC,IAAIC;AACJ,KAAI;AACF,QAAO,MAAM,OAAO;UACb,OAAO;AACd,QAAM,IAAI,MACR,+JAEA,EAAE,OAAO,CACV;;AAEH,KAAI,OAAO,IAAI,gBAAgB,WAC7B,OAAM,IAAI,MACR,+FACD;AAEH,gBAAe;AACf,QAAO;;;;;;;AAQT,SAAgB,uBAA6B;AAC3C,gBAAe"}

package/dist/errors/errors.d.ts

@@ -1,21 +1,17 @@
+import { ProviderErrorKind } from "@graphorin/core";
+
 //#region src/errors/errors.d.ts
-/**
- * Typed error hierarchy for `@graphorin/provider`. Every error class
- * carries a stable `kind` discriminant (lowercase, kebab-case) plus an
- * optional `hint` string pointing the user at the recommended fix.
- *
- * @packageDocumentation
- */
+
 /**
  * Base class for every error thrown by `@graphorin/provider`. Consumers
- * narrow on the discriminant `kind` rather than `instanceof` — both
+ * narrow on the discriminant `kind` rather than `instanceof` - both
  * work, but discriminants are subclass-friendly.
  *
  * @stable
  */
 declare class GraphorinProviderError extends Error {
   readonly name: string;
-  /** Stable discriminant — `'middleware-ordering'`, `'rate-limit-exceeded'`, … */
+  /** Stable discriminant - `'middleware-ordering'`, `'rate-limit-exceeded'`, … */
   readonly kind: string;
   /** Optional remediation hint shown alongside the message. */
   readonly hint?: string;
@@ -87,7 +83,7 @@ declare class RateLimitExceededError extends GraphorinProviderError {
 /**
  * `withRedaction` detected a hit AND the policy is configured for
  * `failClosed: true`. The matched value is **never** part of the
- * message — only the pattern name and field path.
+ * message - only the pattern name and field path.
  *
  * @stable
  */
@@ -123,6 +119,23 @@ declare class LocalProviderInsecureTransportError extends GraphorinProviderError
  */
 declare const OllamaInsecureTransportError: typeof LocalProviderInsecureTransportError;
 type OllamaInsecureTransportError = LocalProviderInsecureTransportError;
+/**
+ * Map an HTTP status (plus optional error-body text) onto the
+ * canonical {@link import('@graphorin/core').ProviderErrorKind}. One
+ * shared table so `withRetry` / `withFallback` and consumers switching
+ * on the documented kinds see consistent values from every HTTP
+ * adapter:
+ *
+ * - `429` → `'rate-limit'`
+ * - `401` / `403` → `'unauthorized'`
+ * - `400` / `404` / `422` → `'invalid-request'` (or
+ *   `'context-length'` when the body says so)
+ * - `503` / `529` → `'capacity'` (529 is Anthropic's overloaded code)
+ * - other `5xx` and `0` (network failure) → `'transient'`
+ *
+ * @stable
+ */
+declare function classifyHttpStatus(status: number, bodyText?: string): ProviderErrorKind;
 /**
  * Wrapped HTTP error returned by an adapter. Carries the original
  * status code so middleware (`withRetry`, `withFallback`) can decide
@@ -134,11 +147,26 @@ declare class ProviderHttpError extends GraphorinProviderError {
   readonly name = "ProviderHttpError";
   readonly status: number;
   readonly providerName: string;
+  /**
+   * The canonical `ProviderErrorKind` mapped from the HTTP status via
+   * {@link classifyHttpStatus} (the `kind` field keeps its stable
+   * `'provider-http'` discriminant). Middleware predicates consult
+   * this so a 429 fails over / retries as a rate limit.
+   */
+  readonly errorKind: ProviderErrorKind;
+  /**
+   * Backoff-relevant response headers captured from the failed
+   * response (`retry-after`, `x-ratelimit-*`), lowercased.
+   * `withRetry`'s Retry-After hint reader consumes them.
+   */
+  readonly headers?: Readonly<Record<string, string>>;
   constructor(args: {
     providerName: string;
     status: number;
     message: string;
     cause?: unknown;
+    errorKind?: ProviderErrorKind;
+    headers?: Readonly<Record<string, string>>;
   });
 }
 /**
@@ -163,5 +191,5 @@ declare class InvalidProviderError extends GraphorinProviderError {
   constructor(message: string);
 }
 //#endregion
-export { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError };
+export { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError, classifyHttpStatus };
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/errors/errors.ts"],"sourcesContent":[],"mappings":";;AAeA;AAwBA;AAiCA;AAyBA;AA2BA;AAmBA;AA6BA;AAyBA;AACA;AASA;AAoBA;AAkBA;;cAtOa,sBAAA,SAA+B,KAAA;;;;;;;;;;;;;;;;;;;cAwB/B,uBAAA,SAAgC,sBAAA;;;;;;;;;;;;;;;;;cAiChC,gCAAA,SAAyC,sBAAA;;;;;;;;;;;;cAyBzC,uBAAA,SAAgC,sBAAA;;;;;;;;;;;;;;;;;;cA2BhC,sBAAA,SAA+B,sBAAA;;;;;;;;;;;;cAmB/B,oBAAA,SAA6B,sBAAA;;;;;;;;;;;;;;;;;;;cA6B7B,mCAAA,SAA4C,sBAAA;;;;;;;;;;;cAyB5C,qCAA4B;KAC7B,4BAAA,GAA+B;;;;;;;;cAS9B,iBAAA,SAA0B,sBAAA;;;;;;;;;;;;;;;;;cAoB1B,wBAAA,SAAiC,sBAAA;;;;;;;;;;;cAkBjC,oBAAA,SAA6B,sBAAA"}
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/errors/errors.ts"],"sourcesContent":[],"mappings":";;;;AAiJA;AA6BA;AAyBA;AACA;AA4BA;AAmBA;;AAgB8B,cAtPjB,sBAAA,SAA+B,KAAA,CAsPd;EAAT,SAAA,IAAA,EAAA,MAAA;EAOL;EACO,SAAA,IAAA,EAAA,MAAA;EAAT;EAxByB,SAAA,IAAA,CAAA,EAAA,MAAA;EAAsB,WAAA,CAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,EAAA,QAAA,EAAA;IA0ChD,KAAA,CAAA,EAAA,OAAA;IAkBA,IAAA,CAAA,EAAA,MAAA;;;;;;;;;;;cA1QA,uBAAA,SAAgC,sBAAA;;;;;;;;;;;;;;;;;cAiChC,gCAAA,SAAyC,sBAAA;;;;;;;;;;;;cAyBzC,uBAAA,SAAgC,sBAAA;;;;;;;;;;;;;;;;;;cA2BhC,sBAAA,SAA+B,sBAAA;;;;;;;;;;;;cAmB/B,oBAAA,SAA6B,sBAAA;;;;;;;;;;;;;;;;;;;cA6B7B,mCAAA,SAA4C,sBAAA;;;;;;;;;;;cAyB5C,qCAA4B;KAC7B,4BAAA,GAA+B;;;;;;;;;;;;;;;;;iBA4B3B,kBAAA,qCAAuD;;;;;;;;cAmB1D,iBAAA,SAA0B,sBAAA;;;;;;;;;;sBAUjB;;;;;;qBAMD,SAAS;;;;;;gBAOd;cACF,SAAS;;;;;;;;;cAkBV,wBAAA,SAAiC,sBAAA;;;;;;;;;;;cAkBjC,oBAAA,SAA6B,sBAAA"}

package/dist/errors/errors.js

@@ -1,21 +1,14 @@
 //#region src/errors/errors.ts
 /**
-* Typed error hierarchy for `@graphorin/provider`. Every error class
-* carries a stable `kind` discriminant (lowercase, kebab-case) plus an
-* optional `hint` string pointing the user at the recommended fix.
-*
-* @packageDocumentation
-*/
-/**
 * Base class for every error thrown by `@graphorin/provider`. Consumers
-* narrow on the discriminant `kind` rather than `instanceof` — both
+* narrow on the discriminant `kind` rather than `instanceof` - both
 * work, but discriminants are subclass-friendly.
 *
 * @stable
 */
 var GraphorinProviderError = class extends Error {
 	name = "GraphorinProviderError";
-	/** Stable discriminant — `'middleware-ordering'`, `'rate-limit-exceeded'`, … */
+	/** Stable discriminant - `'middleware-ordering'`, `'rate-limit-exceeded'`, … */
 	kind;
 	/** Optional remediation hint shown alongside the message. */
 	hint;
@@ -94,7 +87,7 @@ var RateLimitExceededError = class extends GraphorinProviderError {
 /**
 * `withRedaction` detected a hit AND the policy is configured for
 * `failClosed: true`. The matched value is **never** part of the
-* message — only the pattern name and field path.
+* message - only the pattern name and field path.
 *
 * @stable
 */
@@ -134,6 +127,41 @@ var LocalProviderInsecureTransportError = class extends GraphorinProviderError {
 */
 const OllamaInsecureTransportError = LocalProviderInsecureTransportError;
 /**
+* Body phrasings used by the major providers when the request blew the
+* model's context window. Sniffed by {@link classifyHttpStatus} so a
+* 400 that is really a context overflow surfaces as `'context-length'`
+* (the kind the compaction / emergency tiers key on), not a generic
+* `'invalid-request'`.
+*/
+const CONTEXT_LENGTH_BODY_RE = /context[_ -]?length|context window|prompt is too long|maximum context|too many tokens|exceeds? the (?:model'?s? )?max/i;
+/**
+* Map an HTTP status (plus optional error-body text) onto the
+* canonical {@link import('@graphorin/core').ProviderErrorKind}. One
+* shared table so `withRetry` / `withFallback` and consumers switching
+* on the documented kinds see consistent values from every HTTP
+* adapter:
+*
+* - `429` → `'rate-limit'`
+* - `401` / `403` → `'unauthorized'`
+* - `400` / `404` / `422` → `'invalid-request'` (or
+*   `'context-length'` when the body says so)
+* - `503` / `529` → `'capacity'` (529 is Anthropic's overloaded code)
+* - other `5xx` and `0` (network failure) → `'transient'`
+*
+* @stable
+*/
+function classifyHttpStatus(status, bodyText) {
+	if (status === 429) return "rate-limit";
+	if (status === 401 || status === 403) return "unauthorized";
+	if (status === 400 || status === 404 || status === 422) {
+		if (bodyText !== void 0 && CONTEXT_LENGTH_BODY_RE.test(bodyText)) return "context-length";
+		return "invalid-request";
+	}
+	if (status === 503 || status === 529) return "capacity";
+	if (status >= 500 || status === 0) return "transient";
+	return "unknown";
+}
+/**
 * Wrapped HTTP error returned by an adapter. Carries the original
 * status code so middleware (`withRetry`, `withFallback`) can decide
 * whether the error is retryable.
@@ -144,10 +172,25 @@ var ProviderHttpError = class extends GraphorinProviderError {
 	name = "ProviderHttpError";
 	status;
 	providerName;
+	/**
+	* The canonical `ProviderErrorKind` mapped from the HTTP status via
+	* {@link classifyHttpStatus} (the `kind` field keeps its stable
+	* `'provider-http'` discriminant). Middleware predicates consult
+	* this so a 429 fails over / retries as a rate limit.
+	*/
+	errorKind;
+	/**
+	* Backoff-relevant response headers captured from the failed
+	* response (`retry-after`, `x-ratelimit-*`), lowercased.
+	* `withRetry`'s Retry-After hint reader consumes them.
+	*/
+	headers;
 	constructor(args) {
 		super("provider-http", `[${args.providerName}] HTTP ${args.status}: ${args.message}`, { ...args.cause !== void 0 ? { cause: args.cause } : {} });
 		this.providerName = args.providerName;
 		this.status = args.status;
+		this.errorKind = args.errorKind ?? classifyHttpStatus(args.status, args.message);
+		if (args.headers !== void 0) this.headers = args.headers;
 	}
 };
 /**
@@ -178,5 +221,5 @@ var InvalidProviderError = class extends GraphorinProviderError {
 };
 
 //#endregion
-export { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError };
+export { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError, classifyHttpStatus };
 //# sourceMappingURL=errors.js.map

package/dist/errors/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../../src/errors/errors.ts"],"sourcesContent":["/**\n * Typed error hierarchy for `@graphorin/provider`. Every error class\n * carries a stable `kind` discriminant (lowercase, kebab-case) plus an\n * optional `hint` string pointing the user at the recommended fix.\n *\n * @packageDocumentation\n */\n\n/**\n * Base class for every error thrown by `@graphorin/provider`. Consumers\n * narrow on the discriminant `kind` rather than `instanceof` — both\n * work, but discriminants are subclass-friendly.\n *\n * @stable\n */\nexport class GraphorinProviderError extends Error {\n  override readonly name: string = 'GraphorinProviderError';\n  /** Stable discriminant — `'middleware-ordering'`, `'rate-limit-exceeded'`, … */\n  readonly kind: string;\n  /** Optional remediation hint shown alongside the message. */\n  readonly hint?: string;\n\n  constructor(kind: string, message: string, options?: { cause?: unknown; hint?: string }) {\n    super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);\n    this.kind = kind;\n    if (options?.hint !== undefined) {\n      this.hint = options.hint;\n    }\n  }\n}\n\n/**\n * The middleware composer detected an out-of-order middleware. The\n * `offendingPair` field carries the `[outer, inner]` middleware names\n * that violated the canonical order so consumers can surface a precise\n * fix in IDE diagnostics.\n *\n * @stable\n */\nexport class MiddlewareOrderingError extends GraphorinProviderError {\n  override readonly name = 'MiddlewareOrderingError';\n  readonly offendingPair: readonly [string, string];\n  readonly canonicalOrder: readonly string[];\n\n  constructor(args: {\n    offendingPair: readonly [string, string];\n    canonicalOrder: readonly string[];\n    message?: string;\n  }) {\n    super(\n      'middleware-ordering',\n      args.message ??\n        `Middleware order violation: '${args.offendingPair[0]}' must not wrap '${args.offendingPair[1]}'. ` +\n          `Canonical order (outer → inner): ${args.canonicalOrder.join(' → ')}.`,\n      {\n        hint:\n          'Reorder the middleware array passed to composeProviderMiddleware([...]) to match the canonical order; ' +\n          'see @graphorin/provider/middleware for documentation.',\n      },\n    );\n    this.offendingPair = args.offendingPair;\n    this.canonicalOrder = args.canonicalOrder;\n  }\n}\n\n/**\n * `withRedaction` was missing at production startup. Thrown by the\n * production hook applied to every composed provider when\n * `process.env.NODE_ENV === 'production'`.\n *\n * @stable\n */\nexport class MissingProductionMiddlewareError extends GraphorinProviderError {\n  override readonly name = 'MissingProductionMiddlewareError';\n  readonly missing: string;\n\n  constructor(missing: string) {\n    super(\n      'missing-production-middleware',\n      `Production startup hook: required middleware '${missing}' is missing from the provider chain.`,\n      {\n        hint:\n          `Compose '${missing}' as the innermost layer (closest to the underlying provider) before deploying. ` +\n          'See @graphorin/provider/middleware for the canonical composition order.',\n      },\n    );\n    this.missing = missing;\n  }\n}\n\n/**\n * `withCostLimit` exceeded its configured ceiling. Carries the\n * triggering scope (`session`, `agent`, `run`, …) so the caller can\n * decide how to surface the breach.\n *\n * @stable\n */\nexport class CostBudgetExceededError extends GraphorinProviderError {\n  override readonly name = 'CostBudgetExceededError';\n  readonly scope: string;\n  readonly limit: number;\n  readonly observed: number;\n\n  constructor(args: { scope: string; limit: number; observed: number; currency?: string }) {\n    super(\n      'cost-budget-exceeded',\n      `Cost budget exceeded for '${args.scope}': observed ${args.observed.toFixed(4)} ${args.currency ?? 'USD'} ` +\n        `> limit ${args.limit.toFixed(4)} ${args.currency ?? 'USD'}.`,\n      {\n        hint: 'Raise the limit in withCostLimit({...}), tighten the prompt, or switch to a cheaper model tier.',\n      },\n    );\n    this.scope = args.scope;\n    this.limit = args.limit;\n    this.observed = args.observed;\n  }\n}\n\n/**\n * `withRateLimit` exhausted its bucket and the caller did not opt\n * into `'queue'` mode.\n *\n * @stable\n */\nexport class RateLimitExceededError extends GraphorinProviderError {\n  override readonly name = 'RateLimitExceededError';\n  readonly retryAfterMs: number;\n\n  constructor(retryAfterMs: number) {\n    super('rate-limit-exceeded', `Rate limit exceeded; retry after ${retryAfterMs}ms.`, {\n      hint: 'Slow down the request rate, raise the bucket size in withRateLimit({...}), or switch to mode: \"queue\".',\n    });\n    this.retryAfterMs = retryAfterMs;\n  }\n}\n\n/**\n * `withRedaction` detected a hit AND the policy is configured for\n * `failClosed: true`. The matched value is **never** part of the\n * message — only the pattern name and field path.\n *\n * @stable\n */\nexport class PromptRedactionError extends GraphorinProviderError {\n  override readonly name = 'PromptRedactionError';\n  readonly patternName: string;\n  readonly fieldPath: string;\n  readonly role?: string;\n\n  constructor(args: { patternName: string; fieldPath: string; role?: string }) {\n    super(\n      'prompt-redaction-fail-closed',\n      `Outbound prompt-redaction policy is fail-closed and matched pattern '${args.patternName}' ` +\n        `at '${args.fieldPath}'${args.role ? ` (role: ${args.role})` : ''}.`,\n      {\n        hint: 'Sanitize the prompt before calling the provider, or disable failClosed in withRedaction({...}) for this environment.',\n      },\n    );\n    this.patternName = args.patternName;\n    this.fieldPath = args.fieldPath;\n    if (args.role !== undefined) this.role = args.role;\n  }\n}\n\n/**\n * Raised when a `baseUrl`-driven local adapter is configured against\n * a public host over plaintext HTTP. Adapters refuse to start unless\n * `allowInsecureTransport: true` is supplied (and the override is\n * audit-logged).\n *\n * @stable\n */\nexport class LocalProviderInsecureTransportError extends GraphorinProviderError {\n  override readonly name = 'LocalProviderInsecureTransportError';\n  readonly baseUrl: string;\n\n  constructor(baseUrl: string) {\n    super(\n      'local-provider-insecure-transport',\n      `Refusing to start: the provider baseUrl '${baseUrl}' is public AND plaintext (http://). ` +\n        `Switch to https:// or set allowInsecureTransport: true to acknowledge the risk.`,\n      {\n        hint:\n          'Public local-LLM endpoints must be served over TLS. Acceptable alternatives: terminate TLS in front of the model server, ' +\n          'tunnel through SSH / WireGuard / Tailscale, or pass allowInsecureTransport: true (audit-logged).',\n      },\n    );\n    this.baseUrl = baseUrl;\n  }\n}\n\n/**\n * Legacy alias preserved for one minor; prefer\n * {@link LocalProviderInsecureTransportError}. Removed in v0.2.\n *\n * @deprecated Use {@link LocalProviderInsecureTransportError} instead.\n */\nexport const OllamaInsecureTransportError = LocalProviderInsecureTransportError;\nexport type OllamaInsecureTransportError = LocalProviderInsecureTransportError;\n\n/**\n * Wrapped HTTP error returned by an adapter. Carries the original\n * status code so middleware (`withRetry`, `withFallback`) can decide\n * whether the error is retryable.\n *\n * @stable\n */\nexport class ProviderHttpError extends GraphorinProviderError {\n  override readonly name = 'ProviderHttpError';\n  readonly status: number;\n  readonly providerName: string;\n\n  constructor(args: { providerName: string; status: number; message: string; cause?: unknown }) {\n    super('provider-http', `[${args.providerName}] HTTP ${args.status}: ${args.message}`, {\n      ...(args.cause !== undefined ? { cause: args.cause } : {}),\n    });\n    this.providerName = args.providerName;\n    this.status = args.status;\n  }\n}\n\n/**\n * The streaming response did not match the documented wire format\n * (e.g. malformed SSE chunk, truncated JSON).\n *\n * @stable\n */\nexport class ProviderStreamParseError extends GraphorinProviderError {\n  override readonly name = 'ProviderStreamParseError';\n  readonly providerName: string;\n\n  constructor(providerName: string, message: string, cause?: unknown) {\n    super('provider-stream-parse', `[${providerName}] ${message}`, {\n      ...(cause !== undefined ? { cause } : {}),\n    });\n    this.providerName = providerName;\n  }\n}\n\n/**\n * The classifier dispatcher was given a non-Provider value. Programming\n * error; fail-fast at the boundary.\n *\n * @stable\n */\nexport class InvalidProviderError extends GraphorinProviderError {\n  override readonly name = 'InvalidProviderError';\n\n  constructor(message: string) {\n    super('invalid-provider', message, {\n      hint: 'Pass the value returned by createProvider(...) (or any adapter factory) instead of a raw object.',\n    });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/errors/errors.ts"],"sourcesContent":["/**\n * Typed error hierarchy for `@graphorin/provider`. Every error class\n * carries a stable `kind` discriminant (lowercase, kebab-case) plus an\n * optional `hint` string pointing the user at the recommended fix.\n *\n * @packageDocumentation\n */\n\nimport type { ProviderErrorKind } from '@graphorin/core';\n\n/**\n * Base class for every error thrown by `@graphorin/provider`. Consumers\n * narrow on the discriminant `kind` rather than `instanceof` - both\n * work, but discriminants are subclass-friendly.\n *\n * @stable\n */\nexport class GraphorinProviderError extends Error {\n  override readonly name: string = 'GraphorinProviderError';\n  /** Stable discriminant - `'middleware-ordering'`, `'rate-limit-exceeded'`, … */\n  readonly kind: string;\n  /** Optional remediation hint shown alongside the message. */\n  readonly hint?: string;\n\n  constructor(kind: string, message: string, options?: { cause?: unknown; hint?: string }) {\n    super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);\n    this.kind = kind;\n    if (options?.hint !== undefined) {\n      this.hint = options.hint;\n    }\n  }\n}\n\n/**\n * The middleware composer detected an out-of-order middleware. The\n * `offendingPair` field carries the `[outer, inner]` middleware names\n * that violated the canonical order so consumers can surface a precise\n * fix in IDE diagnostics.\n *\n * @stable\n */\nexport class MiddlewareOrderingError extends GraphorinProviderError {\n  override readonly name = 'MiddlewareOrderingError';\n  readonly offendingPair: readonly [string, string];\n  readonly canonicalOrder: readonly string[];\n\n  constructor(args: {\n    offendingPair: readonly [string, string];\n    canonicalOrder: readonly string[];\n    message?: string;\n  }) {\n    super(\n      'middleware-ordering',\n      args.message ??\n        `Middleware order violation: '${args.offendingPair[0]}' must not wrap '${args.offendingPair[1]}'. ` +\n          `Canonical order (outer → inner): ${args.canonicalOrder.join(' → ')}.`,\n      {\n        hint:\n          'Reorder the middleware array passed to composeProviderMiddleware([...]) to match the canonical order; ' +\n          'see @graphorin/provider/middleware for documentation.',\n      },\n    );\n    this.offendingPair = args.offendingPair;\n    this.canonicalOrder = args.canonicalOrder;\n  }\n}\n\n/**\n * `withRedaction` was missing at production startup. Thrown by the\n * production hook applied to every composed provider when\n * `process.env.NODE_ENV === 'production'`.\n *\n * @stable\n */\nexport class MissingProductionMiddlewareError extends GraphorinProviderError {\n  override readonly name = 'MissingProductionMiddlewareError';\n  readonly missing: string;\n\n  constructor(missing: string) {\n    super(\n      'missing-production-middleware',\n      `Production startup hook: required middleware '${missing}' is missing from the provider chain.`,\n      {\n        hint:\n          `Compose '${missing}' as the innermost layer (closest to the underlying provider) before deploying. ` +\n          'See @graphorin/provider/middleware for the canonical composition order.',\n      },\n    );\n    this.missing = missing;\n  }\n}\n\n/**\n * `withCostLimit` exceeded its configured ceiling. Carries the\n * triggering scope (`session`, `agent`, `run`, …) so the caller can\n * decide how to surface the breach.\n *\n * @stable\n */\nexport class CostBudgetExceededError extends GraphorinProviderError {\n  override readonly name = 'CostBudgetExceededError';\n  readonly scope: string;\n  readonly limit: number;\n  readonly observed: number;\n\n  constructor(args: { scope: string; limit: number; observed: number; currency?: string }) {\n    super(\n      'cost-budget-exceeded',\n      `Cost budget exceeded for '${args.scope}': observed ${args.observed.toFixed(4)} ${args.currency ?? 'USD'} ` +\n        `> limit ${args.limit.toFixed(4)} ${args.currency ?? 'USD'}.`,\n      {\n        hint: 'Raise the limit in withCostLimit({...}), tighten the prompt, or switch to a cheaper model tier.',\n      },\n    );\n    this.scope = args.scope;\n    this.limit = args.limit;\n    this.observed = args.observed;\n  }\n}\n\n/**\n * `withRateLimit` exhausted its bucket and the caller did not opt\n * into `'queue'` mode.\n *\n * @stable\n */\nexport class RateLimitExceededError extends GraphorinProviderError {\n  override readonly name = 'RateLimitExceededError';\n  readonly retryAfterMs: number;\n\n  constructor(retryAfterMs: number) {\n    super('rate-limit-exceeded', `Rate limit exceeded; retry after ${retryAfterMs}ms.`, {\n      hint: 'Slow down the request rate, raise the bucket size in withRateLimit({...}), or switch to mode: \"queue\".',\n    });\n    this.retryAfterMs = retryAfterMs;\n  }\n}\n\n/**\n * `withRedaction` detected a hit AND the policy is configured for\n * `failClosed: true`. The matched value is **never** part of the\n * message - only the pattern name and field path.\n *\n * @stable\n */\nexport class PromptRedactionError extends GraphorinProviderError {\n  override readonly name = 'PromptRedactionError';\n  readonly patternName: string;\n  readonly fieldPath: string;\n  readonly role?: string;\n\n  constructor(args: { patternName: string; fieldPath: string; role?: string }) {\n    super(\n      'prompt-redaction-fail-closed',\n      `Outbound prompt-redaction policy is fail-closed and matched pattern '${args.patternName}' ` +\n        `at '${args.fieldPath}'${args.role ? ` (role: ${args.role})` : ''}.`,\n      {\n        hint: 'Sanitize the prompt before calling the provider, or disable failClosed in withRedaction({...}) for this environment.',\n      },\n    );\n    this.patternName = args.patternName;\n    this.fieldPath = args.fieldPath;\n    if (args.role !== undefined) this.role = args.role;\n  }\n}\n\n/**\n * Raised when a `baseUrl`-driven local adapter is configured against\n * a public host over plaintext HTTP. Adapters refuse to start unless\n * `allowInsecureTransport: true` is supplied (and the override is\n * audit-logged).\n *\n * @stable\n */\nexport class LocalProviderInsecureTransportError extends GraphorinProviderError {\n  override readonly name = 'LocalProviderInsecureTransportError';\n  readonly baseUrl: string;\n\n  constructor(baseUrl: string) {\n    super(\n      'local-provider-insecure-transport',\n      `Refusing to start: the provider baseUrl '${baseUrl}' is public AND plaintext (http://). ` +\n        `Switch to https:// or set allowInsecureTransport: true to acknowledge the risk.`,\n      {\n        hint:\n          'Public local-LLM endpoints must be served over TLS. Acceptable alternatives: terminate TLS in front of the model server, ' +\n          'tunnel through SSH / WireGuard / Tailscale, or pass allowInsecureTransport: true (audit-logged).',\n      },\n    );\n    this.baseUrl = baseUrl;\n  }\n}\n\n/**\n * Legacy alias preserved for one minor; prefer\n * {@link LocalProviderInsecureTransportError}. Removed in v0.2.\n *\n * @deprecated Use {@link LocalProviderInsecureTransportError} instead.\n */\nexport const OllamaInsecureTransportError = LocalProviderInsecureTransportError;\nexport type OllamaInsecureTransportError = LocalProviderInsecureTransportError;\n\n/**\n * Body phrasings used by the major providers when the request blew the\n * model's context window. Sniffed by {@link classifyHttpStatus} so a\n * 400 that is really a context overflow surfaces as `'context-length'`\n * (the kind the compaction / emergency tiers key on), not a generic\n * `'invalid-request'`.\n */\nconst CONTEXT_LENGTH_BODY_RE =\n  /context[_ -]?length|context window|prompt is too long|maximum context|too many tokens|exceeds? the (?:model'?s? )?max/i;\n\n/**\n * Map an HTTP status (plus optional error-body text) onto the\n * canonical {@link import('@graphorin/core').ProviderErrorKind}. One\n * shared table so `withRetry` / `withFallback` and consumers switching\n * on the documented kinds see consistent values from every HTTP\n * adapter:\n *\n * - `429` → `'rate-limit'`\n * - `401` / `403` → `'unauthorized'`\n * - `400` / `404` / `422` → `'invalid-request'` (or\n *   `'context-length'` when the body says so)\n * - `503` / `529` → `'capacity'` (529 is Anthropic's overloaded code)\n * - other `5xx` and `0` (network failure) → `'transient'`\n *\n * @stable\n */\nexport function classifyHttpStatus(status: number, bodyText?: string): ProviderErrorKind {\n  if (status === 429) return 'rate-limit';\n  if (status === 401 || status === 403) return 'unauthorized';\n  if (status === 400 || status === 404 || status === 422) {\n    if (bodyText !== undefined && CONTEXT_LENGTH_BODY_RE.test(bodyText)) return 'context-length';\n    return 'invalid-request';\n  }\n  if (status === 503 || status === 529) return 'capacity';\n  if (status >= 500 || status === 0) return 'transient';\n  return 'unknown';\n}\n\n/**\n * Wrapped HTTP error returned by an adapter. Carries the original\n * status code so middleware (`withRetry`, `withFallback`) can decide\n * whether the error is retryable.\n *\n * @stable\n */\nexport class ProviderHttpError extends GraphorinProviderError {\n  override readonly name = 'ProviderHttpError';\n  readonly status: number;\n  readonly providerName: string;\n  /**\n   * The canonical `ProviderErrorKind` mapped from the HTTP status via\n   * {@link classifyHttpStatus} (the `kind` field keeps its stable\n   * `'provider-http'` discriminant). Middleware predicates consult\n   * this so a 429 fails over / retries as a rate limit.\n   */\n  readonly errorKind: ProviderErrorKind;\n  /**\n   * Backoff-relevant response headers captured from the failed\n   * response (`retry-after`, `x-ratelimit-*`), lowercased.\n   * `withRetry`'s Retry-After hint reader consumes them.\n   */\n  readonly headers?: Readonly<Record<string, string>>;\n\n  constructor(args: {\n    providerName: string;\n    status: number;\n    message: string;\n    cause?: unknown;\n    errorKind?: ProviderErrorKind;\n    headers?: Readonly<Record<string, string>>;\n  }) {\n    super('provider-http', `[${args.providerName}] HTTP ${args.status}: ${args.message}`, {\n      ...(args.cause !== undefined ? { cause: args.cause } : {}),\n    });\n    this.providerName = args.providerName;\n    this.status = args.status;\n    this.errorKind = args.errorKind ?? classifyHttpStatus(args.status, args.message);\n    if (args.headers !== undefined) this.headers = args.headers;\n  }\n}\n\n/**\n * The streaming response did not match the documented wire format\n * (e.g. malformed SSE chunk, truncated JSON).\n *\n * @stable\n */\nexport class ProviderStreamParseError extends GraphorinProviderError {\n  override readonly name = 'ProviderStreamParseError';\n  readonly providerName: string;\n\n  constructor(providerName: string, message: string, cause?: unknown) {\n    super('provider-stream-parse', `[${providerName}] ${message}`, {\n      ...(cause !== undefined ? { cause } : {}),\n    });\n    this.providerName = providerName;\n  }\n}\n\n/**\n * The classifier dispatcher was given a non-Provider value. Programming\n * error; fail-fast at the boundary.\n *\n * @stable\n */\nexport class InvalidProviderError extends GraphorinProviderError {\n  override readonly name = 'InvalidProviderError';\n\n  constructor(message: string) {\n    super('invalid-provider', message, {\n      hint: 'Pass the value returned by createProvider(...) (or any adapter factory) instead of a raw object.',\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/errors/index.d.ts

@@ -1,2 +1,2 @@
-import { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError } from "./errors.js";
-export { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError };
+import { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError, classifyHttpStatus } from "./errors.js";
+export { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError, classifyHttpStatus };

package/dist/errors/index.js

@@ -1,3 +1,3 @@
-import { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError } from "./errors.js";
+import { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError, classifyHttpStatus } from "./errors.js";
 
-export { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError };
+export { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError, classifyHttpStatus };

package/dist/index.d.ts

@@ -11,7 +11,8 @@ import { HeuristicCounter, HeuristicCounterOptions } from "./counters/heuristic.
 import { JsTiktokenCounter, JsTiktokenCounterOptions, __resetTiktokenCache } from "./counters/js-tiktoken.js";
 import { SerializedMessage, serialiseMessageForCount, serializedToString } from "./counters/serialize.js";
 import "./counters/index.js";
-import { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError } from "./errors/errors.js";
+import { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError, classifyHttpStatus } from "./errors/errors.js";
+import "./errors/index.js";
 import "./adapters/index.js";
 import { CANONICAL_MIDDLEWARE_ORDER, MIDDLEWARE_KIND, composeProviderMiddleware, defineProviderMiddleware, getMiddlewareKind, providerHasMiddleware } from "./middleware/compose.js";
 import { ProductionStartupHookOptions, assertProductionMiddleware } from "./middleware/production-hook.js";
@@ -36,7 +37,7 @@ import { LocalProviderTrust, OllamaTrust } from "./trust/index.js";
 
 //#region src/index.d.ts
 /**
- * @graphorin/provider — vendor-neutral LLM provider layer for the
+ * @graphorin/provider - vendor-neutral LLM provider layer for the
  * Graphorin framework.
  *
  * The package owns:
@@ -62,8 +63,7 @@ import { LocalProviderTrust, OllamaTrust } from "./trust/index.js";
  *
  * @packageDocumentation
  */
-/** Canonical version constant. Mirrors the `package.json` version. */
-declare const VERSION = "0.5.0";
+declare const VERSION: string;
 //#endregion
-export { AnthropicAPICounter, AnthropicAPICounterOptions, ApplyReasoningPolicyInput, BedrockAPICounter, BedrockAPICounterOptions, CANONICAL_MIDDLEWARE_ORDER, CLASSIFIER_RULES, ClassifierRule, CostAccumulator, CostBudgetExceededError, CostTrackingTotals, CreateDefaultCounterOptions, CreateProviderOptions, GoogleAPICounter, GoogleAPICounterOptions, GraphorinProviderError, HeuristicCounter, HeuristicCounterOptions, InferReasoningContractInput, InvalidProviderError, JsTiktokenCounter, JsTiktokenCounterOptions, LlamaCppServerAdapterOptions, LocalProviderClassification, LocalProviderInsecureTransportError, LocalProviderTrust, MIDDLEWARE_KIND, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaAdapterOptions, OllamaInsecureTransportError, OllamaTrust, OpenAICompatibleAdapterOptions, PERMANENT_LOOPBACK_CLASSIFICATION, ProductionStartupHookOptions, PromptRedactionError, PromptRedactionPolicy, PromptRedactionScanScope, PromptRedactionViolation, ProviderHttpError, ProviderStreamParseError, REASONING_CONTRACT_RULES, REASONING_RETENTION_DEFAULTS, RateLimitExceededError, ReasoningContractRule, ResolveReasoningRetentionInput, SENSITIVITY_DEFAULTS_PER_TRUST, SerializedMessage, VERSION, VercelAdapterOptions, WithCostLimitOptions, WithCostTrackingOptions, WithFallbackOptions, WithRateLimitOptions, WithRetryOptions, WithTracingOptions, __resetGlobalTokenCounter, __resetTiktokenCache, applyReasoningPolicy, assertProductionMiddleware, classifyLocalProvider, classifyModelTier, composeProviderMiddleware, createCostAccumulator, createDefaultCounter, createProvider, defineProviderMiddleware, foldToolExamples, getGlobalTokenCounter, getMiddlewareKind, inferReasoningContract, llamaCppServerAdapter, ollamaAdapter, openAICompatibleAdapter, providerHasMiddleware, resolveReasoningRetention, serialiseMessageForCount, serializedToString, setGlobalTokenCounter, vercelAdapter, withCostLimit, withCostTracking, withFallback, withRateLimit, withRedaction, withRetry, withTracing };
+export { AnthropicAPICounter, AnthropicAPICounterOptions, ApplyReasoningPolicyInput, BedrockAPICounter, BedrockAPICounterOptions, CANONICAL_MIDDLEWARE_ORDER, CLASSIFIER_RULES, ClassifierRule, CostAccumulator, CostBudgetExceededError, CostTrackingTotals, CreateDefaultCounterOptions, CreateProviderOptions, GoogleAPICounter, GoogleAPICounterOptions, GraphorinProviderError, HeuristicCounter, HeuristicCounterOptions, InferReasoningContractInput, InvalidProviderError, JsTiktokenCounter, JsTiktokenCounterOptions, LlamaCppServerAdapterOptions, LocalProviderClassification, LocalProviderInsecureTransportError, LocalProviderTrust, MIDDLEWARE_KIND, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaAdapterOptions, OllamaInsecureTransportError, OllamaTrust, OpenAICompatibleAdapterOptions, PERMANENT_LOOPBACK_CLASSIFICATION, ProductionStartupHookOptions, PromptRedactionError, PromptRedactionPolicy, PromptRedactionScanScope, PromptRedactionViolation, ProviderHttpError, ProviderStreamParseError, REASONING_CONTRACT_RULES, REASONING_RETENTION_DEFAULTS, RateLimitExceededError, ReasoningContractRule, ResolveReasoningRetentionInput, SENSITIVITY_DEFAULTS_PER_TRUST, SerializedMessage, VERSION, VercelAdapterOptions, WithCostLimitOptions, WithCostTrackingOptions, WithFallbackOptions, WithRateLimitOptions, WithRetryOptions, WithTracingOptions, __resetGlobalTokenCounter, __resetTiktokenCache, applyReasoningPolicy, assertProductionMiddleware, classifyHttpStatus, classifyLocalProvider, classifyModelTier, composeProviderMiddleware, createCostAccumulator, createDefaultCounter, createProvider, defineProviderMiddleware, foldToolExamples, getGlobalTokenCounter, getMiddlewareKind, inferReasoningContract, llamaCppServerAdapter, ollamaAdapter, openAICompatibleAdapter, providerHasMiddleware, resolveReasoningRetention, serialiseMessageForCount, serializedToString, setGlobalTokenCounter, vercelAdapter, withCostLimit, withCostTracking, withFallback, withRateLimit, withRedaction, withRetry, withTracing };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA6Ba,OAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+Ba"}

package/dist/index.js

@@ -1,6 +1,8 @@
-import { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError } from "./errors/errors.js";
+import { version } from "./package.js";
+import { CostBudgetExceededError, GraphorinProviderError, InvalidProviderError, LocalProviderInsecureTransportError, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, RateLimitExceededError, classifyHttpStatus } from "./errors/errors.js";
 import { applyReasoningPolicy } from "./reasoning/apply-policy.js";
 import { REASONING_RETENTION_DEFAULTS, resolveReasoningRetention } from "./reasoning/retention.js";
+import { foldToolExamples } from "./tool-examples.js";
 import { PERMANENT_LOOPBACK_CLASSIFICATION, SENSITIVITY_DEFAULTS_PER_TRUST, classifyLocalProvider } from "./trust/classify-local-provider.js";
 import { llamaCppServerAdapter } from "./adapters/llamacpp-server.js";
 import { ollamaAdapter } from "./adapters/ollama.js";
@@ -29,14 +31,13 @@ import { withTracing } from "./middleware/with-tracing.js";
 import "./middleware/index.js";
 import { CLASSIFIER_RULES, classifyModelTier } from "./model-tier/classify.js";
 import "./model-tier/index.js";
-import { foldToolExamples } from "./tool-examples.js";
 import { createProvider } from "./provider.js";
 import "./reasoning/index.js";
 import "./trust/index.js";
 
 //#region src/index.ts
 /**
-* @graphorin/provider — vendor-neutral LLM provider layer for the
+* @graphorin/provider - vendor-neutral LLM provider layer for the
 * Graphorin framework.
 *
 * The package owns:
@@ -62,9 +63,9 @@ import "./trust/index.js";
 *
 * @packageDocumentation
 */
-/** Canonical version constant. Mirrors the `package.json` version. */
-const VERSION = "0.5.0";
+/** Canonical version constant, derived from `package.json` at build time. */
+const VERSION = version;
 
 //#endregion
-export { AnthropicAPICounter, BedrockAPICounter, CANONICAL_MIDDLEWARE_ORDER, CLASSIFIER_RULES, CostBudgetExceededError, GoogleAPICounter, GraphorinProviderError, HeuristicCounter, InvalidProviderError, JsTiktokenCounter, LocalProviderInsecureTransportError, MIDDLEWARE_KIND, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PERMANENT_LOOPBACK_CLASSIFICATION, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, REASONING_CONTRACT_RULES, REASONING_RETENTION_DEFAULTS, RateLimitExceededError, SENSITIVITY_DEFAULTS_PER_TRUST, VERSION, __resetGlobalTokenCounter, __resetTiktokenCache, applyReasoningPolicy, assertProductionMiddleware, classifyLocalProvider, classifyModelTier, composeProviderMiddleware, createCostAccumulator, createDefaultCounter, createProvider, defineProviderMiddleware, foldToolExamples, getGlobalTokenCounter, getMiddlewareKind, inferReasoningContract, llamaCppServerAdapter, ollamaAdapter, openAICompatibleAdapter, providerHasMiddleware, resolveReasoningRetention, serialiseMessageForCount, serializedToString, setGlobalTokenCounter, vercelAdapter, withCostLimit, withCostTracking, withFallback, withRateLimit, withRedaction, withRetry, withTracing };
+export { AnthropicAPICounter, BedrockAPICounter, CANONICAL_MIDDLEWARE_ORDER, CLASSIFIER_RULES, CostBudgetExceededError, GoogleAPICounter, GraphorinProviderError, HeuristicCounter, InvalidProviderError, JsTiktokenCounter, LocalProviderInsecureTransportError, MIDDLEWARE_KIND, MiddlewareOrderingError, MissingProductionMiddlewareError, OllamaInsecureTransportError, PERMANENT_LOOPBACK_CLASSIFICATION, PromptRedactionError, ProviderHttpError, ProviderStreamParseError, REASONING_CONTRACT_RULES, REASONING_RETENTION_DEFAULTS, RateLimitExceededError, SENSITIVITY_DEFAULTS_PER_TRUST, VERSION, __resetGlobalTokenCounter, __resetTiktokenCache, applyReasoningPolicy, assertProductionMiddleware, classifyHttpStatus, classifyLocalProvider, classifyModelTier, composeProviderMiddleware, createCostAccumulator, createDefaultCounter, createProvider, defineProviderMiddleware, foldToolExamples, getGlobalTokenCounter, getMiddlewareKind, inferReasoningContract, llamaCppServerAdapter, ollamaAdapter, openAICompatibleAdapter, providerHasMiddleware, resolveReasoningRetention, serialiseMessageForCount, serializedToString, setGlobalTokenCounter, vercelAdapter, withCostLimit, withCostTracking, withFallback, withRateLimit, withRedaction, withRetry, withTracing };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @graphorin/provider — vendor-neutral LLM provider layer for the\n * Graphorin framework.\n *\n * The package owns:\n *\n * - The `createProvider(...)` factory for wrapping adapter modules in\n *   a stable `Provider` shape.\n * - Four adapters out of the box: the Vercel AI SDK adapter for the\n *   default cloud path, plus three local-LLM adapters (Ollama HTTP,\n *   llama-server HTTP, and a generic OpenAI-compatible adapter for\n *   LMStudio / LocalAI / vLLM / Together-style endpoints). All three\n *   `baseUrl`-driven adapters share the same {@link LocalProviderTrust}\n *   classifier.\n * - The canonical-order middleware composer\n *   ({@link composeProviderMiddleware}) and the seven built-in\n *   middlewares (`withTracing`, `withRetry`, `withRateLimit`,\n *   `withCostLimit`, `withCostTracking`, `withFallback`,\n *   `withRedaction`).\n * - The pluggable `TokenCounter` dispatcher (`createDefaultCounter`)\n *   plus the per-vendor strategies and a heuristic fallback.\n * - The per-provider model-tier auto-classifier\n *   ({@link classifyModelTier}) that maps a `Provider`'s `modelId` to\n *   one of `'fast' | 'balanced' | 'smart'`.\n *\n * @packageDocumentation\n */\n\n/** Canonical version constant. Mirrors the `package.json` version. */\nexport const VERSION = '0.5.0';\n\nexport * from './adapters/index.js';\nexport * from './counters/index.js';\nexport * from './errors/index.js';\nexport * from './middleware/index.js';\nexport * from './model-tier/index.js';\nexport * from './provider.js';\nexport * from './reasoning/index.js';\nexport { foldToolExamples } from './tool-examples.js';\nexport * from './trust/index.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,UAAU"}
+{"version":3,"file":"index.js","names":["VERSION: string","pkg.version"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @graphorin/provider - vendor-neutral LLM provider layer for the\n * Graphorin framework.\n *\n * The package owns:\n *\n * - The `createProvider(...)` factory for wrapping adapter modules in\n *   a stable `Provider` shape.\n * - Four adapters out of the box: the Vercel AI SDK adapter for the\n *   default cloud path, plus three local-LLM adapters (Ollama HTTP,\n *   llama-server HTTP, and a generic OpenAI-compatible adapter for\n *   LMStudio / LocalAI / vLLM / Together-style endpoints). All three\n *   `baseUrl`-driven adapters share the same {@link LocalProviderTrust}\n *   classifier.\n * - The canonical-order middleware composer\n *   ({@link composeProviderMiddleware}) and the seven built-in\n *   middlewares (`withTracing`, `withRetry`, `withRateLimit`,\n *   `withCostLimit`, `withCostTracking`, `withFallback`,\n *   `withRedaction`).\n * - The pluggable `TokenCounter` dispatcher (`createDefaultCounter`)\n *   plus the per-vendor strategies and a heuristic fallback.\n * - The per-provider model-tier auto-classifier\n *   ({@link classifyModelTier}) that maps a `Provider`'s `modelId` to\n *   one of `'fast' | 'balanced' | 'smart'`.\n *\n * @packageDocumentation\n */\n\n/** Canonical version constant, derived from `package.json` at build time. */\nimport pkg from '../package.json' with { type: 'json' };\n\nexport const VERSION: string = pkg.version;\n\nexport * from './adapters/index.js';\nexport * from './counters/index.js';\nexport * from './errors/index.js';\nexport * from './middleware/index.js';\nexport * from './model-tier/index.js';\nexport * from './provider.js';\nexport * from './reasoning/index.js';\nexport { foldToolExamples } from './tool-examples.js';\nexport * from './trust/index.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAaA,UAAkBC"}

package/dist/internal/abort.js

@@ -3,7 +3,7 @@
 * Abort detection shared by the retry / fallback predicates (PS-2).
 *
 * A network failure surfaces as `ProviderHttpError{ status: 0, cause }`,
-* and a user/agent abort surfaces the same way — the distinguishing
+* and a user/agent abort surfaces the same way - the distinguishing
 * signal is an `AbortError` (DOMException) somewhere on the `cause`
 * chain. Network errors should be retried and failed over; an abort must
 * not be, even though the retry/fallback loops also short-circuit on
@@ -12,7 +12,7 @@
 * @packageDocumentation
 */
 /**
-* True when `err` — or any error on its `cause` chain — is an abort
+* True when `err` - or any error on its `cause` chain - is an abort
 * (`name === 'AbortError'` or Node's `code === 'ABORT_ERR'`). Walks at
 * most a few links so a cyclic / pathological cause chain cannot loop.
 *

package/dist/internal/abort.js.map

@@ -1 +1 @@
-{"version":3,"file":"abort.js","names":["cursor: unknown"],"sources":["../../src/internal/abort.ts"],"sourcesContent":["/**\n * Abort detection shared by the retry / fallback predicates (PS-2).\n *\n * A network failure surfaces as `ProviderHttpError{ status: 0, cause }`,\n * and a user/agent abort surfaces the same way — the distinguishing\n * signal is an `AbortError` (DOMException) somewhere on the `cause`\n * chain. Network errors should be retried and failed over; an abort must\n * not be, even though the retry/fallback loops also short-circuit on\n * `req.signal?.aborted` independently.\n *\n * @packageDocumentation\n */\n\n/**\n * True when `err` — or any error on its `cause` chain — is an abort\n * (`name === 'AbortError'` or Node's `code === 'ABORT_ERR'`). Walks at\n * most a few links so a cyclic / pathological cause chain cannot loop.\n *\n * @internal\n */\nexport function isAbortError(err: unknown): boolean {\n  let cursor: unknown = err;\n  for (let depth = 0; depth < 8 && cursor !== null && typeof cursor === 'object'; depth++) {\n    const e = cursor as { name?: unknown; code?: unknown; cause?: unknown };\n    if (e.name === 'AbortError' || e.code === 'ABORT_ERR') return true;\n    if (e.cause === cursor) break;\n    cursor = e.cause;\n  }\n  return false;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,aAAa,KAAuB;CAClD,IAAIA,SAAkB;AACtB,MAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,WAAW,QAAQ,OAAO,WAAW,UAAU,SAAS;EACvF,MAAM,IAAI;AACV,MAAI,EAAE,SAAS,gBAAgB,EAAE,SAAS,YAAa,QAAO;AAC9D,MAAI,EAAE,UAAU,OAAQ;AACxB,WAAS,EAAE;;AAEb,QAAO"}
+{"version":3,"file":"abort.js","names":["cursor: unknown"],"sources":["../../src/internal/abort.ts"],"sourcesContent":["/**\n * Abort detection shared by the retry / fallback predicates (PS-2).\n *\n * A network failure surfaces as `ProviderHttpError{ status: 0, cause }`,\n * and a user/agent abort surfaces the same way - the distinguishing\n * signal is an `AbortError` (DOMException) somewhere on the `cause`\n * chain. Network errors should be retried and failed over; an abort must\n * not be, even though the retry/fallback loops also short-circuit on\n * `req.signal?.aborted` independently.\n *\n * @packageDocumentation\n */\n\n/**\n * True when `err` - or any error on its `cause` chain - is an abort\n * (`name === 'AbortError'` or Node's `code === 'ABORT_ERR'`). Walks at\n * most a few links so a cyclic / pathological cause chain cannot loop.\n *\n * @internal\n */\nexport function isAbortError(err: unknown): boolean {\n  let cursor: unknown = err;\n  for (let depth = 0; depth < 8 && cursor !== null && typeof cursor === 'object'; depth++) {\n    const e = cursor as { name?: unknown; code?: unknown; cause?: unknown };\n    if (e.name === 'AbortError' || e.code === 'ABORT_ERR') return true;\n    if (e.cause === cursor) break;\n    cursor = e.cause;\n  }\n  return false;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,aAAa,KAAuB;CAClD,IAAIA,SAAkB;AACtB,MAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,WAAW,QAAQ,OAAO,WAAW,UAAU,SAAS;EACvF,MAAM,IAAI;AACV,MAAI,EAAE,SAAS,gBAAgB,EAAE,SAAS,YAAa,QAAO;AAC9D,MAAI,EAAE,UAAU,OAAQ;AACxB,WAAS,EAAE;;AAEb,QAAO"}