@graphorin/provider 0.5.0

package/dist/counters/bedrock.d.ts

@@ -0,0 +1,27 @@
+import { Message, TokenCounter } from "@graphorin/core";
+
+//#region src/counters/bedrock.d.ts
+
+/**
+ * Options for {@link BedrockAPICounter}.
+ *
+ * @stable
+ */
+interface BedrockAPICounterOptions {
+  readonly modelId: string;
+  readonly id?: string;
+}
+/**
+ * @stable
+ */
+declare class BedrockAPICounter implements TokenCounter {
+  #private;
+  readonly id: string;
+  readonly version: string;
+  constructor(options: BedrockAPICounterOptions);
+  count(messages: ReadonlyArray<Message>): Promise<number>;
+  countText(text: string): Promise<number>;
+}
+//#endregion
+export { BedrockAPICounter, BedrockAPICounterOptions };
+//# sourceMappingURL=bedrock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bedrock.d.ts","names":[],"sources":["../../src/counters/bedrock.ts"],"sourcesContent":[],"mappings":";;;;;;;;;UAmBiB,wBAAA;;;;;;;cAQJ,iBAAA,YAA6B;;;;uBAKnB;kBAML,cAAc,WAAW;2BAIhB"}

package/dist/counters/bedrock.js

@@ -0,0 +1,29 @@
+import { JsTiktokenCounter } from "./js-tiktoken.js";
+
+//#region src/counters/bedrock.ts
+/**
+* @stable
+*/
+var BedrockAPICounter = class {
+	id;
+	version;
+	#fallback;
+	constructor(options) {
+		this.#fallback = new JsTiktokenCounter({
+			encoding: "cl100k_base",
+			modelId: options.modelId
+		});
+		this.id = options.id ?? `bedrock-proxy@${options.modelId}`;
+		this.version = `bedrock-cl100k-proxy-${options.modelId}-v1`;
+	}
+	count(messages) {
+		return this.#fallback.count(messages);
+	}
+	countText(text) {
+		return this.#fallback.countText(text);
+	}
+};
+
+//#endregion
+export { BedrockAPICounter };
+//# sourceMappingURL=bedrock.js.map

package/dist/counters/bedrock.js.map

@@ -0,0 +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"}

package/dist/counters/dispatcher.d.ts

@@ -0,0 +1,34 @@
+import { TokenCounter } from "@graphorin/core";
+
+//#region src/counters/dispatcher.d.ts
+
+/**
+ * Options for {@link createDefaultCounter}.
+ *
+ * @stable
+ */
+interface CreateDefaultCounterOptions {
+  /** Concrete model id (e.g. `'gpt-4o'`, `'claude-opus-4-7'`). */
+  readonly model: string;
+  /** Optional provider hint to short-circuit the regex matching. */
+  readonly provider?: string;
+  /** Optional Anthropic API key threaded through to {@link AnthropicAPICounter}. */
+  readonly anthropicApiKey?: string;
+}
+/**
+ * Build the recommended {@link TokenCounter} for the given
+ * `(provider, model)` pair. The dispatch table:
+ *
+ * - Anthropic Claude → `AnthropicAPICounter` (native if `apiKey` set,
+ *   otherwise `cl100k_base` proxy).
+ * - OpenAI / OpenAI-compatible → `JsTiktokenCounter('cl100k_base')`.
+ * - Google Gemini → `GoogleAPICounter` (cl100k_base proxy in v0.1).
+ * - Bedrock Claude → `BedrockAPICounter` (cl100k_base proxy in v0.1).
+ * - Ollama / unknown → `HeuristicCounter` with one WARN per process.
+ *
+ * @stable
+ */
+declare function createDefaultCounter(options: CreateDefaultCounterOptions): TokenCounter;
+//#endregion
+export { CreateDefaultCounterOptions, createDefaultCounter };
+//# sourceMappingURL=dispatcher.d.ts.map

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

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

package/dist/counters/dispatcher.js

@@ -0,0 +1,78 @@
+import { JsTiktokenCounter } from "./js-tiktoken.js";
+import { AnthropicAPICounter } from "./anthropic.js";
+import { BedrockAPICounter } from "./bedrock.js";
+import { GoogleAPICounter } from "./google.js";
+import { HeuristicCounter } from "./heuristic.js";
+
+//#region src/counters/dispatcher.ts
+/**
+* Detect the provider family for a model id. Exposed for downstream
+* consumers (the model-tier classifier; future per-tool counters) so
+* provider-family detection is centralised here.
+*
+* @stable
+*/
+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";
+		return "anthropic";
+	}
+	if (provider === "google" || modelLower.startsWith("gemini")) return "google";
+	if (provider === "bedrock") 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";
+	return "unknown";
+}
+/**
+* Build the recommended {@link TokenCounter} for the given
+* `(provider, model)` pair. The dispatch table:
+*
+* - Anthropic Claude → `AnthropicAPICounter` (native if `apiKey` set,
+*   otherwise `cl100k_base` proxy).
+* - OpenAI / OpenAI-compatible → `JsTiktokenCounter('cl100k_base')`.
+* - Google Gemini → `GoogleAPICounter` (cl100k_base proxy in v0.1).
+* - Bedrock Claude → `BedrockAPICounter` (cl100k_base proxy in v0.1).
+* - Ollama / unknown → `HeuristicCounter` with one WARN per process.
+*
+* @stable
+*/
+function createDefaultCounter(options) {
+	switch (detectProviderFamily({
+		model: options.model,
+		...options.provider !== void 0 ? { provider: options.provider } : {}
+	})) {
+		case "anthropic": return new AnthropicAPICounter({
+			modelId: options.model,
+			...options.anthropicApiKey !== void 0 ? { apiKey: options.anthropicApiKey } : {}
+		});
+		case "bedrock": return new BedrockAPICounter({ modelId: options.model });
+		case "google": return new GoogleAPICounter({ modelId: options.model });
+		case "openai":
+		case "openai-compatible": return new JsTiktokenCounter({
+			encoding: defaultOpenAiEncoding(options.model),
+			modelId: options.model
+		});
+		default: return new HeuristicCounter({ modelId: options.model });
+	}
+}
+/**
+* PS-20: pick the fallback tiktoken encoding by model family. `js-tiktoken`'s
+* `encodingForModel` handles ids it recognises; this is the explicit fallback
+* for ids it does not (the 2025/2026 families). gpt-4o / gpt-4.1 / gpt-5+ and
+* the o-series reasoning models use `o200k_base`; legacy gpt-4 / gpt-3.5 stay
+* on `cl100k_base`.
+*/
+function defaultOpenAiEncoding(model) {
+	if (model === void 0) return "cl100k_base";
+	const id = model.toLowerCase();
+	const sep = Math.max(id.lastIndexOf("/"), id.lastIndexOf(":"));
+	const bare = sep === -1 ? id : id.slice(sep + 1);
+	return /^(?:gpt-4o|gpt-4\.1|gpt-[5-9]|gpt-\d{2}|o[1-9])/.test(bare) ? "o200k_base" : "cl100k_base";
+}
+
+//#endregion
+export { createDefaultCounter };
+//# sourceMappingURL=dispatcher.js.map

package/dist/counters/dispatcher.js.map

@@ -0,0 +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"}

package/dist/counters/global.d.ts

@@ -0,0 +1,26 @@
+import { TokenCounter } from "@graphorin/core";
+
+//#region src/counters/global.d.ts
+
+/**
+ * Set the process-global counter. Called once at startup by user
+ * code; passing `null` clears the slot.
+ *
+ * @stable
+ */
+declare function setGlobalTokenCounter(counter: TokenCounter | null): void;
+/**
+ * Read the process-global counter, or `null` if unset.
+ *
+ * @stable
+ */
+declare function getGlobalTokenCounter(): TokenCounter | null;
+/**
+ * Test-only hook that resets the global slot to `null` between cases.
+ *
+ * @internal
+ */
+declare function __resetGlobalTokenCounter(): void;
+//#endregion
+export { __resetGlobalTokenCounter, getGlobalTokenCounter, setGlobalTokenCounter };
+//# sourceMappingURL=global.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"global.d.ts","names":[],"sources":["../../src/counters/global.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;iBAkBgB,qBAAA,UAA+B;;;;;;iBAS/B,qBAAA,CAAA,GAAyB;;;;;;iBASzB,yBAAA,CAAA"}

package/dist/counters/global.js

@@ -0,0 +1,31 @@
+//#region src/counters/global.ts
+let globalCounter = null;
+/**
+* Set the process-global counter. Called once at startup by user
+* code; passing `null` clears the slot.
+*
+* @stable
+*/
+function setGlobalTokenCounter(counter) {
+	globalCounter = counter;
+}
+/**
+* Read the process-global counter, or `null` if unset.
+*
+* @stable
+*/
+function getGlobalTokenCounter() {
+	return globalCounter;
+}
+/**
+* Test-only hook that resets the global slot to `null` between cases.
+*
+* @internal
+*/
+function __resetGlobalTokenCounter() {
+	globalCounter = null;
+}
+
+//#endregion
+export { __resetGlobalTokenCounter, getGlobalTokenCounter, setGlobalTokenCounter };
+//# sourceMappingURL=global.js.map

package/dist/counters/global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.js","names":["globalCounter: TokenCounter | null"],"sources":["../../src/counters/global.ts"],"sourcesContent":["/**\n * Process-global token counter slot. Components (e.g. the\n * ContextEngine in Phase 10) read the global counter when no\n * per-provider counter is wired explicitly.\n *\n * @packageDocumentation\n */\n\nimport type { TokenCounter } from '@graphorin/core';\n\nlet globalCounter: TokenCounter | null = null;\n\n/**\n * Set the process-global counter. Called once at startup by user\n * code; passing `null` clears the slot.\n *\n * @stable\n */\nexport function setGlobalTokenCounter(counter: TokenCounter | null): void {\n  globalCounter = counter;\n}\n\n/**\n * Read the process-global counter, or `null` if unset.\n *\n * @stable\n */\nexport function getGlobalTokenCounter(): TokenCounter | null {\n  return globalCounter;\n}\n\n/**\n * Test-only hook that resets the global slot to `null` between cases.\n *\n * @internal\n */\nexport function __resetGlobalTokenCounter(): void {\n  globalCounter = null;\n}\n"],"mappings":";AAUA,IAAIA,gBAAqC;;;;;;;AAQzC,SAAgB,sBAAsB,SAAoC;AACxE,iBAAgB;;;;;;;AAQlB,SAAgB,wBAA6C;AAC3D,QAAO;;;;;;;AAQT,SAAgB,4BAAkC;AAChD,iBAAgB"}

package/dist/counters/google.d.ts

@@ -0,0 +1,27 @@
+import { Message, TokenCounter } from "@graphorin/core";
+
+//#region src/counters/google.d.ts
+
+/**
+ * Options for {@link GoogleAPICounter}.
+ *
+ * @stable
+ */
+interface GoogleAPICounterOptions {
+  readonly modelId: string;
+  readonly id?: string;
+}
+/**
+ * @stable
+ */
+declare class GoogleAPICounter implements TokenCounter {
+  #private;
+  readonly id: string;
+  readonly version: string;
+  constructor(options: GoogleAPICounterOptions);
+  count(messages: ReadonlyArray<Message>): Promise<number>;
+  countText(text: string): Promise<number>;
+}
+//#endregion
+export { GoogleAPICounter, GoogleAPICounterOptions };
+//# sourceMappingURL=google.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"google.d.ts","names":[],"sources":["../../src/counters/google.ts"],"sourcesContent":[],"mappings":";;;;;;;;;UAmBiB,uBAAA;;;;;;;cAQJ,gBAAA,YAA4B;;;;uBAKlB;kBAML,cAAc,WAAW;2BAIhB"}

package/dist/counters/google.js

@@ -0,0 +1,29 @@
+import { JsTiktokenCounter } from "./js-tiktoken.js";
+
+//#region src/counters/google.ts
+/**
+* @stable
+*/
+var GoogleAPICounter = class {
+	id;
+	version;
+	#fallback;
+	constructor(options) {
+		this.#fallback = new JsTiktokenCounter({
+			encoding: "cl100k_base",
+			modelId: options.modelId
+		});
+		this.id = options.id ?? `google-proxy@${options.modelId}`;
+		this.version = `google-cl100k-proxy-${options.modelId}-v1`;
+	}
+	count(messages) {
+		return this.#fallback.count(messages);
+	}
+	countText(text) {
+		return this.#fallback.countText(text);
+	}
+};
+
+//#endregion
+export { GoogleAPICounter };
+//# sourceMappingURL=google.js.map

package/dist/counters/google.js.map

@@ -0,0 +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"}

package/dist/counters/heuristic.d.ts

@@ -0,0 +1,37 @@
+import { Message, TokenCounter } from "@graphorin/core";
+
+//#region src/counters/heuristic.d.ts
+
+/**
+ * Options for {@link HeuristicCounter}.
+ *
+ * @stable
+ */
+interface HeuristicCounterOptions {
+  /** Average characters per token. Defaults to `4` (latin-1 estimate). */
+  readonly charsPerToken?: number;
+  /** Identifier carried on the produced counter. */
+  readonly id?: string;
+  /** Optional model hint surfaced in the WARN message. */
+  readonly modelId?: string;
+  /** Optional sink. Defaults to `console.warn`. */
+  readonly logger?: (message: string, meta?: object) => void;
+}
+/**
+ * Counter that estimates tokens via simple character division. The
+ * estimator is deterministic and side-effect-free apart from the
+ * one-time WARN.
+ *
+ * @stable
+ */
+declare class HeuristicCounter implements TokenCounter {
+  #private;
+  readonly id: string;
+  readonly version: string;
+  constructor(options?: HeuristicCounterOptions);
+  count(messages: ReadonlyArray<Message>): Promise<number>;
+  countText(text: string): Promise<number>;
+}
+//#endregion
+export { HeuristicCounter, HeuristicCounterOptions };
+//# sourceMappingURL=heuristic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heuristic.d.ts","names":[],"sources":["../../src/counters/heuristic.ts"],"sourcesContent":[],"mappings":";;;;;;;;;UAkBiB,uBAAA;;;;;;;;;;;;;;;;;cAoBJ,gBAAA,YAA4B;;;;wBAQlB;kBAYC,cAAc,WAAW;2BAUhB"}

package/dist/counters/heuristic.js

@@ -0,0 +1,64 @@
+import { serialiseMessageForCount, serializedToString } from "./serialize.js";
+
+//#region src/counters/heuristic.ts
+const WARNED = /* @__PURE__ */ new Set();
+/**
+* Counter that estimates tokens via simple character division. The
+* estimator is deterministic and side-effect-free apart from the
+* one-time WARN.
+*
+* @stable
+*/
+var HeuristicCounter = class {
+	id;
+	version;
+	#charsPerToken;
+	#modelId;
+	#logger;
+	#warnedOnce = false;
+	constructor(options = {}) {
+		const charsPerToken = options.charsPerToken ?? 4;
+		if (!(charsPerToken > 0)) throw new RangeError("HeuristicCounter: charsPerToken must be > 0.");
+		this.#charsPerToken = charsPerToken;
+		this.id = options.id ?? `heuristic@${charsPerToken}cpt`;
+		this.version = `heuristic-${charsPerToken}-cpt-v1`;
+		if (options.modelId !== void 0) this.#modelId = options.modelId;
+		this.#logger = options.logger ?? defaultLogger;
+	}
+	async count(messages) {
+		this.#warnIfNeeded();
+		let total = 0;
+		for (const msg of messages) {
+			const serialised = serialiseMessageForCount(msg);
+			total += this.#estimate(serializedToString(serialised));
+		}
+		return total;
+	}
+	async countText(text) {
+		this.#warnIfNeeded();
+		return this.#estimate(text);
+	}
+	#estimate(text) {
+		if (text.length === 0) return 0;
+		return Math.ceil(text.length / this.#charsPerToken);
+	}
+	#warnIfNeeded() {
+		if (this.#warnedOnce) return;
+		const key = `${this.id}::${this.#modelId ?? "unknown"}`;
+		if (WARNED.has(key)) {
+			this.#warnedOnce = true;
+			return;
+		}
+		WARNED.add(key);
+		this.#warnedOnce = true;
+		this.#logger(`[graphorin/provider] heuristic token counter active (${this.id}); accuracy is approximate (~chars/${this.#charsPerToken}).`, this.#modelId !== void 0 ? { modelId: this.#modelId } : {});
+	}
+};
+function defaultLogger(message, meta) {
+	if (meta !== void 0) console.warn(message, meta);
+	else console.warn(message);
+}
+
+//#endregion
+export { HeuristicCounter };
+//# sourceMappingURL=heuristic.js.map

package/dist/counters/heuristic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heuristic.js","names":["#charsPerToken","#modelId","#logger","#warnIfNeeded","#estimate","#warnedOnce"],"sources":["../../src/counters/heuristic.ts"],"sourcesContent":["/**\n * Conservative `chars / N` token-count estimator. Used as the fallback\n * for unknown providers; emits exactly one WARN per unique\n * `(provider, model)` tuple per process so operators are nudged\n * toward a precise counter.\n *\n * @packageDocumentation\n */\n\nimport type { Message, TokenCounter } from '@graphorin/core';\n\nimport { serialiseMessageForCount, serializedToString } from './serialize.js';\n\n/**\n * Options for {@link HeuristicCounter}.\n *\n * @stable\n */\nexport interface HeuristicCounterOptions {\n  /** Average characters per token. Defaults to `4` (latin-1 estimate). */\n  readonly charsPerToken?: number;\n  /** Identifier carried on the produced counter. */\n  readonly id?: string;\n  /** Optional model hint surfaced in the WARN message. */\n  readonly modelId?: string;\n  /** Optional sink. Defaults to `console.warn`. */\n  readonly logger?: (message: string, meta?: object) => void;\n}\n\nconst WARNED = new Set<string>();\n\n/**\n * Counter that estimates tokens via simple character division. The\n * estimator is deterministic and side-effect-free apart from the\n * one-time WARN.\n *\n * @stable\n */\nexport class HeuristicCounter implements TokenCounter {\n  readonly id: string;\n  readonly version: string;\n  readonly #charsPerToken: number;\n  readonly #modelId?: string;\n  readonly #logger: (message: string, meta?: object) => void;\n  #warnedOnce = false;\n\n  constructor(options: HeuristicCounterOptions = {}) {\n    const charsPerToken = options.charsPerToken ?? 4;\n    if (!(charsPerToken > 0)) {\n      throw new RangeError('HeuristicCounter: charsPerToken must be > 0.');\n    }\n    this.#charsPerToken = charsPerToken;\n    this.id = options.id ?? `heuristic@${charsPerToken}cpt`;\n    this.version = `heuristic-${charsPerToken}-cpt-v1`;\n    if (options.modelId !== undefined) this.#modelId = options.modelId;\n    this.#logger = options.logger ?? defaultLogger;\n  }\n\n  async count(messages: ReadonlyArray<Message>): Promise<number> {\n    this.#warnIfNeeded();\n    let total = 0;\n    for (const msg of messages) {\n      const serialised = serialiseMessageForCount(msg);\n      total += this.#estimate(serializedToString(serialised));\n    }\n    return total;\n  }\n\n  async countText(text: string): Promise<number> {\n    this.#warnIfNeeded();\n    return this.#estimate(text);\n  }\n\n  #estimate(text: string): number {\n    if (text.length === 0) return 0;\n    return Math.ceil(text.length / this.#charsPerToken);\n  }\n\n  #warnIfNeeded(): void {\n    if (this.#warnedOnce) return;\n    const key = `${this.id}::${this.#modelId ?? 'unknown'}`;\n    if (WARNED.has(key)) {\n      this.#warnedOnce = true;\n      return;\n    }\n    WARNED.add(key);\n    this.#warnedOnce = true;\n    this.#logger(\n      `[graphorin/provider] heuristic token counter active (${this.id}); accuracy is approximate (~chars/${this.#charsPerToken}).`,\n      this.#modelId !== undefined ? { modelId: this.#modelId } : {},\n    );\n  }\n}\n\nfunction defaultLogger(message: string, meta?: object): void {\n  if (meta !== undefined) console.warn(message, meta);\n  else console.warn(message);\n}\n\n/**\n * Test-only hook that resets the per-process WARN cache.\n *\n * @internal\n */\nexport function __resetHeuristicWarnCache(): void {\n  WARNED.clear();\n}\n"],"mappings":";;;AA6BA,MAAM,yBAAS,IAAI,KAAa;;;;;;;;AAShC,IAAa,mBAAb,MAAsD;CACpD,AAAS;CACT,AAAS;CACT,CAASA;CACT,CAASC;CACT,CAASC;CACT,cAAc;CAEd,YAAY,UAAmC,EAAE,EAAE;EACjD,MAAM,gBAAgB,QAAQ,iBAAiB;AAC/C,MAAI,EAAE,gBAAgB,GACpB,OAAM,IAAI,WAAW,+CAA+C;AAEtE,QAAKF,gBAAiB;AACtB,OAAK,KAAK,QAAQ,MAAM,aAAa,cAAc;AACnD,OAAK,UAAU,aAAa,cAAc;AAC1C,MAAI,QAAQ,YAAY,OAAW,OAAKC,UAAW,QAAQ;AAC3D,QAAKC,SAAU,QAAQ,UAAU;;CAGnC,MAAM,MAAM,UAAmD;AAC7D,QAAKC,cAAe;EACpB,IAAI,QAAQ;AACZ,OAAK,MAAM,OAAO,UAAU;GAC1B,MAAM,aAAa,yBAAyB,IAAI;AAChD,YAAS,MAAKC,SAAU,mBAAmB,WAAW,CAAC;;AAEzD,SAAO;;CAGT,MAAM,UAAU,MAA+B;AAC7C,QAAKD,cAAe;AACpB,SAAO,MAAKC,SAAU,KAAK;;CAG7B,UAAU,MAAsB;AAC9B,MAAI,KAAK,WAAW,EAAG,QAAO;AAC9B,SAAO,KAAK,KAAK,KAAK,SAAS,MAAKJ,cAAe;;CAGrD,gBAAsB;AACpB,MAAI,MAAKK,WAAa;EACtB,MAAM,MAAM,GAAG,KAAK,GAAG,IAAI,MAAKJ,WAAY;AAC5C,MAAI,OAAO,IAAI,IAAI,EAAE;AACnB,SAAKI,aAAc;AACnB;;AAEF,SAAO,IAAI,IAAI;AACf,QAAKA,aAAc;AACnB,QAAKH,OACH,wDAAwD,KAAK,GAAG,qCAAqC,MAAKF,cAAe,KACzH,MAAKC,YAAa,SAAY,EAAE,SAAS,MAAKA,SAAU,GAAG,EAAE,CAC9D;;;AAIL,SAAS,cAAc,SAAiB,MAAqB;AAC3D,KAAI,SAAS,OAAW,SAAQ,KAAK,SAAS,KAAK;KAC9C,SAAQ,KAAK,QAAQ"}

package/dist/counters/index.d.ts

@@ -0,0 +1,9 @@
+import { AnthropicAPICounter, AnthropicAPICounterOptions } from "./anthropic.js";
+import { BedrockAPICounter, BedrockAPICounterOptions } from "./bedrock.js";
+import { CreateDefaultCounterOptions, createDefaultCounter } from "./dispatcher.js";
+import { __resetGlobalTokenCounter, getGlobalTokenCounter, setGlobalTokenCounter } from "./global.js";
+import { GoogleAPICounter, GoogleAPICounterOptions } from "./google.js";
+import { HeuristicCounter, HeuristicCounterOptions } from "./heuristic.js";
+import { JsTiktokenCounter, JsTiktokenCounterOptions, __resetTiktokenCache } from "./js-tiktoken.js";
+import { SerializedMessage, serialiseMessageForCount, serializedToString } from "./serialize.js";
+export { AnthropicAPICounter, type AnthropicAPICounterOptions, BedrockAPICounter, type BedrockAPICounterOptions, type CreateDefaultCounterOptions, GoogleAPICounter, type GoogleAPICounterOptions, HeuristicCounter, type HeuristicCounterOptions, JsTiktokenCounter, type JsTiktokenCounterOptions, type SerializedMessage, __resetGlobalTokenCounter, __resetTiktokenCache, createDefaultCounter, getGlobalTokenCounter, serialiseMessageForCount, serializedToString, setGlobalTokenCounter };

package/dist/counters/index.js

@@ -0,0 +1,10 @@
+import { serialiseMessageForCount, serializedToString } from "./serialize.js";
+import { JsTiktokenCounter, __resetTiktokenCache } from "./js-tiktoken.js";
+import { AnthropicAPICounter } from "./anthropic.js";
+import { BedrockAPICounter } from "./bedrock.js";
+import { GoogleAPICounter } from "./google.js";
+import { HeuristicCounter } from "./heuristic.js";
+import { createDefaultCounter } from "./dispatcher.js";
+import { __resetGlobalTokenCounter, getGlobalTokenCounter, setGlobalTokenCounter } from "./global.js";
+
+export { AnthropicAPICounter, BedrockAPICounter, GoogleAPICounter, HeuristicCounter, JsTiktokenCounter, __resetGlobalTokenCounter, __resetTiktokenCache, createDefaultCounter, getGlobalTokenCounter, serialiseMessageForCount, serializedToString, setGlobalTokenCounter };

package/dist/counters/js-tiktoken.d.ts

@@ -0,0 +1,63 @@
+import { Message, TokenCounter } from "@graphorin/core";
+
+//#region src/counters/js-tiktoken.d.ts
+
+/**
+ * Loose shape of a `js-tiktoken` encoding. Matches the public
+ * `Tiktoken` instance returned by `getEncoding(...)` in the upstream
+ * package (we only use `encode` / `name`).
+ *
+ * @internal
+ */
+interface TiktokenEncoding {
+  readonly name?: string;
+  encode(text: string): {
+    length: number;
+  };
+}
+interface TiktokenModule {
+  getEncoding(name: string): TiktokenEncoding;
+  encodingForModel?: (model: string) => TiktokenEncoding;
+}
+/**
+ * Options for {@link JsTiktokenCounter}.
+ *
+ * @stable
+ */
+interface JsTiktokenCounterOptions {
+  /** Encoding name (`'cl100k_base'`, `'o200k_base'`, …). Default `'cl100k_base'`. */
+  readonly encoding?: string;
+  /** Optional model id used by `encodingForModel`. Falls back to the explicit `encoding`. */
+  readonly modelId?: string;
+  /**
+   * Override the dynamically-loaded module. Used by tests to inject a
+   * stub without taking the real `js-tiktoken` peer dependency.
+   */
+  readonly moduleOverride?: TiktokenModule;
+  /** Identifier carried on the produced counter. */
+  readonly id?: string;
+}
+/**
+ * Counter that delegates to the `js-tiktoken` package. Caches the
+ * dynamically-loaded module per process; tests use `moduleOverride`
+ * to supply a fixture-shaped substitute.
+ *
+ * @stable
+ */
+declare class JsTiktokenCounter implements TokenCounter {
+  #private;
+  readonly id: string;
+  readonly version: string;
+  constructor(options?: JsTiktokenCounterOptions);
+  count(messages: ReadonlyArray<Message>): Promise<number>;
+  countText(text: string): Promise<number>;
+}
+/**
+ * Test-only hook that resets the cached `js-tiktoken` module loader.
+ *
+ * @internal
+ */
+declare function __resetTiktokenCache(): void;
+//#endregion
+export { JsTiktokenCounter, JsTiktokenCounterOptions, __resetTiktokenCache };
+//# sourceMappingURL=js-tiktoken.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"js-tiktoken.d.ts","names":[],"sources":["../../src/counters/js-tiktoken.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAoIA;;UAhHU,gBAAA;;;;;;UAKA,cAAA;6BACmB;wCACW;;;;;;;UAQvB,wBAAA;;;;;;;;;4BASW;;;;;;;;;;;cAcf,iBAAA,YAA6B;;;;wBAQnB;kBAQC,cAAc,WAAW;2BAUhB;;;;;;;iBAgDjB,oBAAA,CAAA"}

package/dist/counters/js-tiktoken.js

@@ -0,0 +1,73 @@
+import { serialiseMessageForCount, serializedToString } from "./serialize.js";
+
+//#region src/counters/js-tiktoken.ts
+let cachedModule = null;
+/**
+* Counter that delegates to the `js-tiktoken` package. Caches the
+* dynamically-loaded module per process; tests use `moduleOverride`
+* to supply a fixture-shaped substitute.
+*
+* @stable
+*/
+var JsTiktokenCounter = class {
+	id;
+	version;
+	#encoding;
+	#modelId;
+	#moduleOverride;
+	#encoder = null;
+	constructor(options = {}) {
+		this.#encoding = options.encoding ?? "cl100k_base";
+		if (options.modelId !== void 0) this.#modelId = options.modelId;
+		if (options.moduleOverride !== void 0) this.#moduleOverride = options.moduleOverride;
+		this.id = options.id ?? `js-tiktoken@${this.#encoding}`;
+		this.version = `js-tiktoken-${this.#encoding}-v1`;
+	}
+	async count(messages) {
+		const enc = await this.#getEncoder();
+		let total = 0;
+		for (const msg of messages) {
+			const serialised = serialiseMessageForCount(msg);
+			total += enc.encode(serializedToString(serialised)).length;
+		}
+		return total;
+	}
+	async countText(text) {
+		if (text.length === 0) return 0;
+		return (await this.#getEncoder()).encode(text).length;
+	}
+	async #getEncoder() {
+		if (this.#encoder !== null) return this.#encoder;
+		const mod = this.#moduleOverride ?? await loadTiktokenModule();
+		if (this.#modelId !== void 0 && mod.encodingForModel !== void 0) try {
+			this.#encoder = mod.encodingForModel(this.#modelId);
+			return this.#encoder;
+		} catch {}
+		this.#encoder = mod.getEncoding(this.#encoding);
+		return this.#encoder;
+	}
+};
+async function loadTiktokenModule() {
+	if (cachedModule !== null) return cachedModule;
+	let mod;
+	try {
+		mod = await import("js-tiktoken");
+	} catch (cause) {
+		throw new Error("[graphorin/provider] JsTiktokenCounter requires the 'js-tiktoken' peer dependency. Install it with `pnpm add js-tiktoken` or pass moduleOverride for tests.", { cause });
+	}
+	if (typeof mod.getEncoding !== "function") throw new Error("[graphorin/provider] JsTiktokenCounter: installed js-tiktoken does not expose getEncoding().");
+	cachedModule = mod;
+	return cachedModule;
+}
+/**
+* Test-only hook that resets the cached `js-tiktoken` module loader.
+*
+* @internal
+*/
+function __resetTiktokenCache() {
+	cachedModule = null;
+}
+
+//#endregion
+export { JsTiktokenCounter, __resetTiktokenCache };
+//# sourceMappingURL=js-tiktoken.js.map

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

@@ -0,0 +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"}