@tollgateai/sdk 0.1.2 → 0.2.0

package/README.md

@@ -4,7 +4,12 @@ Track **real** LLM model usage and compute live gross margin with
 [Tollgate](https://tollgateai.vercel.app). The SDK reads the actual `usage`
 object off each provider response — you never hand-count tokens.
 
-Published on npm: [@tollgateai/sdk](https://www.npmjs.com/package/@tollgateai/sdk) (v0.1.2).
+Published on npm: [@tollgateai/sdk](https://www.npmjs.com/package/@tollgateai/sdk) (v0.2.0).
+
+Works with **OpenAI**, **Anthropic**, **AWS Bedrock**, and **every OpenAI-compatible
+gateway** (Vercel AI Gateway, OpenRouter, Groq, Together, Nebius, local vLLM, …) —
+streaming and non-streaming. Cost is computed server-side from the token counts the
+wrappers capture, so no provider has to return a dollar figure.
 
 ```bash
 npm install @tollgateai/sdk
@@ -81,9 +86,55 @@ await openai.chat.completions.create({
 `revenueUnitCents` may also be a function of the response, e.g.
 `revenueUnitCents: (res) => res.someField ? 50 : 0`.
 
+### OpenAI-compatible gateways
+
+Point the OpenAI SDK at any compatible endpoint and set `provider:
+'openai_compatible'` so the server prices it from the gateway-echoed model name:
+
+```ts
+const openai = new OpenAI({ apiKey: process.env.GROQ_API_KEY, baseURL: 'https://api.groq.com/openai/v1' });
+const client = wrapOpenAI(openai, tollgate, {
+  customerId: 'cust_A',
+  provider: 'openai_compatible',     // Groq / OpenRouter / Together / Nebius / vLLM …
+});
+await client.chat.completions.create({ model: 'llama-3.3-70b-versatile', messages: [...] });
+```
+
+### Streaming
+
+Streaming is captured automatically. For **OpenAI / compatible**, pass
+`stream_options: { include_usage: true }` (required for a final usage chunk); for
+**Anthropic** no flag is needed. Just iterate the stream as usual:
+
+```ts
+const stream = await client.chat.completions.create({
+  model: 'gpt-4o', stream: true, stream_options: { include_usage: true },
+  messages: [{ role: 'user', content: 'Hello' }],
+});
+for await (const chunk of stream) { /* … */ }   // usage is reported when the stream ends
+```
+
+### AWS Bedrock
+
+Wrap a `BedrockRuntimeClient` so `ConverseCommand` / `ConverseStreamCommand`
+auto-report usage (the model id is read from the command):
+
+```ts
+import { BedrockRuntimeClient, ConverseCommand } from '@aws-sdk/client-bedrock-runtime';
+import { wrapBedrock } from '@tollgateai/sdk';
+
+const bedrock = wrapBedrock(new BedrockRuntimeClient({ region: 'us-east-1' }), tollgate, { customerId: 'cust_A' });
+await bedrock.send(new ConverseCommand({ modelId: 'anthropic.claude-3-5-sonnet-20241022-v2:0', messages: [...] }));
+```
+
+### Already have an exact cost?
+
+Pass `providerCostCents` (a number or a function of the response) and the server
+uses it verbatim, skipping the rate card entirely.
+
 ## Manual tracking
 
-For providers without a wrapper (Bedrock, custom gateways) or full control:
+For full control or unusual providers:
 
 ```ts
 import { createTollgateClient } from '@tollgateai/sdk';
@@ -109,8 +160,10 @@ await tollgate.track({
 - **Idempotent.** Events are deduplicated on `idempotencyKey` (auto-set to the
   provider response id by the wrappers), so retries never double-count.
 - **No prompt content is ever sent** — only token counts and metadata.
-- **Streaming** responses are not auto-tracked yet (the wrappers only report when
-  a non-streaming `usage` object is present). Track those manually for now.
+- **Streaming is auto-tracked** (OpenAI needs `stream_options.include_usage`).
+- **Cost from tokens.** The server prices every event from token counts × a rate
+  card that auto-syncs daily from the public LiteLLM registry — unknown models are
+  priced at $0 and flagged in logs. See [docs/PRICING.md](../../docs/PRICING.md).
 - **Non-blocking.** Auto-instrumented tracking runs in the background; failures
   are passed to `onError` (default `console.warn`) and never break your call.
 
@@ -120,8 +173,12 @@ await tollgate.track({
 - `resolve({ runId, customerId, outcome, revenueUnitCents? })` → close a run with
   its outcome; books revenue once, only when `outcome` is `'resolved'`
 - `wrapAnthropic(client, tollgate, options)` → instrumented Anthropic client
-- `wrapOpenAI(client, tollgate, options)` → instrumented OpenAI client
-- `anthropicEventFrom(msg, options)` / `openAIEventFrom(completion, options)` →
-  build a track payload manually from a provider response
+- `wrapOpenAI(client, tollgate, options)` → instrumented OpenAI / compatible client
+- `wrapBedrock(client, tollgate, options)` → instrumented Bedrock Runtime client
+- `anthropicEventFrom` / `openAIEventFrom` / `bedrockEventFrom` → build a track
+  payload manually from a provider response
+
+`options` accepts `customerId`, `agentId`, `runId`, `revenueUnitCents`,
+`provider` (override; e.g. `'openai_compatible'`), `providerCostCents`, and `onError`.
 
 Licensed for use with Tollgate. Not open source.

package/dist/index.cjs

@@ -96,9 +96,58 @@ function resolveRunId(opts, responseId) {
 function resolveRevenue(opts, response) {
   return typeof opts.revenueUnitCents === "function" ? opts.revenueUnitCents(response) : opts.revenueUnitCents;
 }
+function resolveCost(opts, response) {
+  return typeof opts.providerCostCents === "function" ? opts.providerCostCents(response) : opts.providerCostCents;
+}
+function withCost(event, opts, response) {
+  const cost = resolveCost(opts, response);
+  if (cost !== void 0) event.providerCostCents = cost;
+  return event;
+}
 function fireAndForget(p, onError) {
   p.catch((err) => (onError ?? ((e) => console.warn("[tollgate] track failed:", e)))(err));
 }
+function isAsyncIterable(x) {
+  return x != null && typeof x[Symbol.asyncIterator] === "function";
+}
+function instrumentStream(stream, onChunk, onDone) {
+  let finished = false;
+  const finish = () => {
+    if (finished) return;
+    finished = true;
+    onDone();
+  };
+  return new Proxy(stream, {
+    get(target, prop, recv) {
+      if (prop === Symbol.asyncIterator) {
+        return function instrumentedIterator() {
+          const inner = target[Symbol.asyncIterator]();
+          return {
+            async next(...a) {
+              const r = await inner.next(...a);
+              if (r.done) finish();
+              else onChunk(r.value);
+              return r;
+            },
+            async return(v) {
+              finish();
+              return inner.return ? inner.return(v) : { done: true, value: v };
+            },
+            async throw(e) {
+              finish();
+              if (inner.throw) return inner.throw(e);
+              throw e;
+            },
+            [Symbol.asyncIterator]() {
+              return this;
+            }
+          };
+        };
+      }
+      return Reflect.get(target, prop, recv);
+    }
+  });
+}
 function anthropicEventFrom(msg, opts) {
   const usage = msg?.usage;
   if (!usage) return null;
@@ -106,11 +155,11 @@ function anthropicEventFrom(msg, opts) {
   const fivem = usage.cache_creation?.ephemeral_5m_input_tokens;
   const oneh = usage.cache_creation?.ephemeral_1h_input_tokens;
   const hasSplit = fivem !== void 0 || oneh !== void 0;
-  return {
+  const event = {
     customerId: opts.customerId,
     agentId: opts.agentId,
     runId,
-    provider: "anthropic",
+    provider: opts.provider ?? "anthropic",
     model: msg.model ?? "unknown",
     tokensIn: usage.input_tokens ?? 0,
     tokensOut: usage.output_tokens ?? 0,
@@ -120,12 +169,32 @@ function anthropicEventFrom(msg, opts) {
     revenueUnitCents: resolveRevenue(opts, msg),
     idempotencyKey: msg.id ?? `${runId}#${randomId()}`
   };
+  return withCost(event, opts, msg);
 }
 function wrapAnthropic(client, tollgate, opts) {
   const messages = client.messages;
   const original = messages.create.bind(messages);
   const create = async (...args) => {
     const result = await original(...args);
+    if (isAsyncIterable(result)) {
+      const msg = {};
+      return instrumentStream(
+        result,
+        (ev) => {
+          if (ev.type === "message_start" && ev.message) {
+            msg.id = ev.message.id;
+            msg.model = ev.message.model;
+            msg.usage = { ...ev.message.usage };
+          } else if (ev.type === "message_delta" && ev.usage) {
+            msg.usage = { ...msg.usage ?? {}, output_tokens: ev.usage.output_tokens };
+          }
+        },
+        () => {
+          const event2 = anthropicEventFrom(msg, opts);
+          if (event2) fireAndForget(tollgate.track(event2), opts.onError);
+        }
+      );
+    }
     const event = anthropicEventFrom(result, opts);
     if (event) fireAndForget(tollgate.track(event), opts.onError);
     return result;
@@ -145,11 +214,11 @@ function openAIEventFrom(completion, opts) {
   const usage = completion?.usage;
   if (!usage) return null;
   const runId = resolveRunId(opts, completion.id);
-  return {
+  const event = {
     customerId: opts.customerId,
     agentId: opts.agentId,
     runId,
-    provider: "openai",
+    provider: opts.provider ?? "openai",
     model: completion.model ?? "unknown",
     tokensIn: usage.prompt_tokens ?? 0,
     tokensOut: usage.completion_tokens ?? 0,
@@ -158,12 +227,31 @@ function openAIEventFrom(completion, opts) {
     revenueUnitCents: resolveRevenue(opts, completion),
     idempotencyKey: completion.id ?? `${runId}#${randomId()}`
   };
+  return withCost(event, opts, completion);
 }
 function wrapOpenAI(client, tollgate, opts) {
   const completions = client.chat.completions;
   const original = completions.create.bind(completions);
   const create = async (...args) => {
     const result = await original(...args);
+    if (isAsyncIterable(result)) {
+      let id;
+      let model;
+      let usage;
+      return instrumentStream(
+        result,
+        (chunk) => {
+          if (chunk.id) id = chunk.id;
+          if (chunk.model) model = chunk.model;
+          if (chunk.usage) usage = chunk.usage;
+        },
+        () => {
+          if (!usage) return;
+          const event2 = openAIEventFrom({ id, model, usage }, opts);
+          if (event2) fireAndForget(tollgate.track(event2), opts.onError);
+        }
+      );
+    }
     const event = openAIEventFrom(result, opts);
     if (event) fireAndForget(tollgate.track(event), opts.onError);
     return result;
@@ -182,12 +270,64 @@ function wrapOpenAI(client, tollgate, opts) {
     }
   });
 }
+function bedrockEventFrom(usage, model, opts, response = void 0) {
+  if (!usage) return null;
+  const runId = resolveRunId(opts, void 0);
+  const event = {
+    customerId: opts.customerId,
+    agentId: opts.agentId,
+    runId,
+    provider: opts.provider ?? "bedrock",
+    model,
+    tokensIn: usage.inputTokens ?? 0,
+    tokensOut: usage.outputTokens ?? 0,
+    cachedTokens: usage.cacheReadInputTokens ?? 0,
+    cacheWrite5mTokens: usage.cacheWriteInputTokens ?? 0,
+    revenueUnitCents: resolveRevenue(opts, response),
+    idempotencyKey: `${runId}#${randomId()}`
+  };
+  return withCost(event, opts, response);
+}
+function wrapBedrock(client, tollgate, opts) {
+  const originalSend = client.send.bind(client);
+  const send = async (command, ...rest) => {
+    const result = await originalSend(command, ...rest);
+    const model = command?.input?.modelId ?? "unknown";
+    if (result?.stream && isAsyncIterable(result.stream)) {
+      let usage;
+      result.stream = instrumentStream(
+        result.stream,
+        (ev) => {
+          if (ev.metadata?.usage) usage = ev.metadata.usage;
+        },
+        () => {
+          const event = bedrockEventFrom(usage, model, opts, result);
+          if (event) fireAndForget(tollgate.track(event), opts.onError);
+        }
+      );
+      return result;
+    }
+    if (result?.usage) {
+      const event = bedrockEventFrom(result.usage, model, opts, result);
+      if (event) fireAndForget(tollgate.track(event), opts.onError);
+    }
+    return result;
+  };
+  return new Proxy(client, {
+    get(target, prop, recv) {
+      if (prop === "send") return send;
+      return Reflect.get(target, prop, recv);
+    }
+  });
+}
 
 exports.TollgateError = TollgateError;
 exports.anthropicEventFrom = anthropicEventFrom;
+exports.bedrockEventFrom = bedrockEventFrom;
 exports.createTollgateClient = createTollgateClient;
 exports.openAIEventFrom = openAIEventFrom;
 exports.wrapAnthropic = wrapAnthropic;
+exports.wrapBedrock = wrapBedrock;
 exports.wrapOpenAI = wrapOpenAI;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/instrument.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { Provider, RunOutcome, TrackEventInput, TrackResult } from './types';\n\nexport interface TollgateClientOptions {\n  /** Account API key (`tg_live_…`). Falls back to `process.env.TOLLGATE_API_KEY`. */\n  apiKey?: string;\n  /** Base URL of your Tollgate deployment. Defaults to `TOLLGATE_BASE_URL` or production. */\n  baseUrl?: string;\n  /** Per-request timeout in ms. Default 10_000. */\n  timeoutMs?: number;\n  /** Retry attempts on network error / 5xx / 429. Default 2. */\n  maxRetries?: number;\n  /** Custom fetch (for testing or non-standard runtimes). Defaults to global fetch. */\n  fetch?: typeof fetch;\n}\n\nexport class TollgateError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number,\n    readonly body?: unknown,\n  ) {\n    super(message);\n    this.name = 'TollgateError';\n  }\n}\n\nconst DEFAULT_BASE_URL = 'https://tollgateai.vercel.app';\n\n/** Close out a run with its outcome (and, if resolved, the revenue it earns).\n *  A resolution carries no provider usage, so `provider`/`model` are optional. */\nexport interface ResolveInput {\n  /** The run being closed (must match the runId your usage events used). */\n  runId: string;\n  customerId: string;\n  /** 'resolved' books revenue; 'escalated'/'failed' book none (cost still counts). */\n  outcome: RunOutcome;\n  /** Revenue in cents for a resolved run (e.g. 50 for $0.50). Ignored if not resolved. */\n  revenueUnitCents?: number;\n  agentId?: string;\n  /** Idempotency key for the closing event. Defaults to `${runId}#resolve`. */\n  idempotencyKey?: string;\n  ts?: string;\n  /** Rarely needed — a resolution isn't a provider call. Default 'anthropic'/'resolution'. */\n  provider?: Provider;\n  model?: string;\n}\n\nexport interface TollgateClient {\n  /** Report a single usage event. Idempotent on `idempotencyKey`. */\n  track(event: TrackEventInput): Promise<TrackResult>;\n  /** Close a run with its outcome — book revenue once, only if resolved.\n   *  Convenience over `track()`: sends a zero-usage terminal event. */\n  resolve(input: ResolveInput): Promise<TrackResult>;\n}\n\nfunction getEnv(key: string): string | undefined {\n  // Guarded so the SDK works in browsers/edge runtimes without `process`.\n  return typeof process !== 'undefined' ? process.env?.[key] : undefined;\n}\n\nconst sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));\n\nexport function createTollgateClient(opts: TollgateClientOptions = {}): TollgateClient {\n  const apiKey = opts.apiKey ?? getEnv('TOLLGATE_API_KEY');\n  const baseUrl = (opts.baseUrl ?? getEnv('TOLLGATE_BASE_URL') ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n  const timeoutMs = opts.timeoutMs ?? 10_000;\n  const maxRetries = opts.maxRetries ?? 2;\n  const doFetch = opts.fetch ?? globalThis.fetch;\n\n  if (typeof doFetch !== 'function') {\n    throw new TollgateError('No fetch implementation available — pass `fetch` in options.');\n  }\n\n  async function track(event: TrackEventInput): Promise<TrackResult> {\n    if (!apiKey) {\n      throw new TollgateError('Missing API key — set opts.apiKey or TOLLGATE_API_KEY.');\n    }\n\n    let lastErr: unknown;\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      const controller = new AbortController();\n      const timer = setTimeout(() => controller.abort(), timeoutMs);\n      try {\n        const res = await doFetch(`${baseUrl}/api/track`, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${apiKey}`,\n          },\n          body: JSON.stringify(event),\n          signal: controller.signal,\n        });\n\n        // 200 = idempotent duplicate, 201 = created. Both are success.\n        if (res.ok) {\n          return (await res.json()) as TrackResult;\n        }\n\n        // Retry transient failures; fail fast on 4xx (except 429).\n        if (res.status >= 500 || res.status === 429) {\n          lastErr = new TollgateError(`Tollgate track failed (${res.status})`, res.status);\n        } else {\n          const body = await res.json().catch(() => ({}));\n          throw new TollgateError(`Tollgate track failed (${res.status})`, res.status, body);\n        }\n      } catch (err) {\n        // Don't retry deterministic client errors.\n        if (err instanceof TollgateError && err.status && err.status < 500 && err.status !== 429) {\n          throw err;\n        }\n        lastErr = err;\n      } finally {\n        clearTimeout(timer);\n      }\n\n      if (attempt < maxRetries) {\n        await sleep(2 ** attempt * 200); // 200ms, 400ms, …\n      }\n    }\n\n    throw lastErr instanceof Error\n      ? lastErr\n      : new TollgateError('Tollgate track failed after retries');\n  }\n\n  function resolve(input: ResolveInput): Promise<TrackResult> {\n    return track({\n      customerId: input.customerId,\n      runId: input.runId,\n      agentId: input.agentId,\n      // A resolution isn't a provider call; zero usage ⇒ zero cost.\n      provider: input.provider ?? 'anthropic',\n      model: input.model ?? 'resolution',\n      tokensIn: 0,\n      tokensOut: 0,\n      outcome: input.outcome,\n      revenueUnitCents: input.revenueUnitCents,\n      idempotencyKey: input.idempotencyKey ?? `${input.runId}#resolve`,\n      ts: input.ts,\n    });\n  }\n\n  return { track, resolve };\n}\n","// Auto-instrumentation: wrap a provider client so every completion reports its\n// REAL usage to Tollgate — no manual token counting. Wrappers are structurally\n// typed, so this package never has to depend on the provider SDKs.\n\nimport type { TollgateClient } from './client';\nimport type { TrackEventInput } from './types';\n\nexport interface InstrumentOptions {\n  /** Your end customer's stable id. Required for margin attribution. */\n  customerId: string;\n  /** Optional agent/workflow id. */\n  agentId?: string;\n  /** Revenue per call in cents (or a function of the response). */\n  revenueUnitCents?: number | ((response: unknown) => number | undefined);\n  /** Override the run id; defaults to the provider response id. */\n  runId?: string | (() => string);\n  /** Called if a background track() fails. Defaults to console.warn. */\n  onError?: (err: unknown) => void;\n}\n\nfunction randomId(): string {\n  const c = (globalThis as { crypto?: Crypto }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  return `${Date.now()}-${Math.random().toString(36).slice(2)}`;\n}\n\nfunction resolveRunId(opts: InstrumentOptions, responseId?: string): string {\n  if (typeof opts.runId === 'function') return opts.runId();\n  return opts.runId ?? responseId ?? randomId();\n}\n\nfunction resolveRevenue(opts: InstrumentOptions, response: unknown): number | undefined {\n  return typeof opts.revenueUnitCents === 'function'\n    ? opts.revenueUnitCents(response)\n    : opts.revenueUnitCents;\n}\n\nfunction fireAndForget(p: Promise<unknown>, onError?: InstrumentOptions['onError']): void {\n  p.catch((err) => (onError ?? ((e) => console.warn('[tollgate] track failed:', e)))(err));\n}\n\n// --- Anthropic ------------------------------------------------------------\n\ninterface AnthropicUsage {\n  input_tokens?: number;\n  output_tokens?: number;\n  cache_read_input_tokens?: number;\n  // Cache CREATION (writes) bill above the input rate. Newer responses break the\n  // total down by TTL; older ones only return the aggregate cache_creation count.\n  cache_creation_input_tokens?: number;\n  cache_creation?: {\n    ephemeral_5m_input_tokens?: number;\n    ephemeral_1h_input_tokens?: number;\n  };\n}\ninterface AnthropicMessage {\n  id?: string;\n  model?: string;\n  usage?: AnthropicUsage;\n}\n\n/** Map a non-streaming Anthropic message to a track payload (or null if no usage). */\nexport function anthropicEventFrom(\n  msg: AnthropicMessage,\n  opts: InstrumentOptions,\n): TrackEventInput | null {\n  const usage = msg?.usage;\n  if (!usage) return null;\n  const runId = resolveRunId(opts, msg.id);\n  // Split cache-creation tokens by TTL when the response provides the breakdown;\n  // otherwise attribute the whole cache_creation total to the default 5-minute TTL.\n  const fivem = usage.cache_creation?.ephemeral_5m_input_tokens;\n  const oneh = usage.cache_creation?.ephemeral_1h_input_tokens;\n  const hasSplit = fivem !== undefined || oneh !== undefined;\n  return {\n    customerId: opts.customerId,\n    agentId: opts.agentId,\n    runId,\n    provider: 'anthropic',\n    model: msg.model ?? 'unknown',\n    tokensIn: usage.input_tokens ?? 0,\n    tokensOut: usage.output_tokens ?? 0,\n    cachedTokens: usage.cache_read_input_tokens ?? 0,\n    cacheWrite5mTokens: hasSplit ? fivem ?? 0 : usage.cache_creation_input_tokens ?? 0,\n    cacheWrite1hTokens: hasSplit ? oneh ?? 0 : 0,\n    revenueUnitCents: resolveRevenue(opts, msg),\n    idempotencyKey: msg.id ?? `${runId}#${randomId()}`,\n  };\n}\n\ninterface AnthropicLike {\n  messages: { create: (...args: never[]) => Promise<unknown> };\n}\n\n/** Wrap an Anthropic client so `messages.create` auto-reports usage. */\nexport function wrapAnthropic<T extends AnthropicLike>(\n  client: T,\n  tollgate: TollgateClient,\n  opts: InstrumentOptions,\n): T {\n  const messages = client.messages;\n  const original = messages.create.bind(messages) as (...a: never[]) => Promise<unknown>;\n\n  const create = async (...args: never[]): Promise<unknown> => {\n    const result = await original(...args);\n    const event = anthropicEventFrom(result as AnthropicMessage, opts);\n    if (event) fireAndForget(tollgate.track(event), opts.onError);\n    return result;\n  };\n\n  return new Proxy(client, {\n    get(target, prop, recv) {\n      if (prop === 'messages') {\n        return new Proxy(messages, {\n          get: (m, p, r) => (p === 'create' ? create : Reflect.get(m, p, r)),\n        });\n      }\n      return Reflect.get(target, prop, recv);\n    },\n  });\n}\n\n// --- OpenAI ---------------------------------------------------------------\n\ninterface OpenAIUsage {\n  prompt_tokens?: number;\n  completion_tokens?: number;\n  completion_tokens_details?: { reasoning_tokens?: number };\n  prompt_tokens_details?: { cached_tokens?: number };\n}\ninterface OpenAICompletion {\n  id?: string;\n  model?: string;\n  usage?: OpenAIUsage;\n}\n\n/** Map a non-streaming OpenAI chat completion to a track payload (or null). */\nexport function openAIEventFrom(\n  completion: OpenAICompletion,\n  opts: InstrumentOptions,\n): TrackEventInput | null {\n  const usage = completion?.usage;\n  if (!usage) return null;\n  const runId = resolveRunId(opts, completion.id);\n  return {\n    customerId: opts.customerId,\n    agentId: opts.agentId,\n    runId,\n    provider: 'openai',\n    model: completion.model ?? 'unknown',\n    tokensIn: usage.prompt_tokens ?? 0,\n    tokensOut: usage.completion_tokens ?? 0,\n    reasoningTokens: usage.completion_tokens_details?.reasoning_tokens ?? 0,\n    cachedTokens: usage.prompt_tokens_details?.cached_tokens ?? 0,\n    revenueUnitCents: resolveRevenue(opts, completion),\n    idempotencyKey: completion.id ?? `${runId}#${randomId()}`,\n  };\n}\n\ninterface OpenAILike {\n  chat: { completions: { create: (...args: never[]) => Promise<unknown> } };\n}\n\n/** Wrap an OpenAI client so `chat.completions.create` auto-reports usage. */\nexport function wrapOpenAI<T extends OpenAILike>(\n  client: T,\n  tollgate: TollgateClient,\n  opts: InstrumentOptions,\n): T {\n  const completions = client.chat.completions;\n  const original = completions.create.bind(completions) as (...a: never[]) => Promise<unknown>;\n\n  const create = async (...args: never[]): Promise<unknown> => {\n    const result = await original(...args);\n    const event = openAIEventFrom(result as OpenAICompletion, opts);\n    if (event) fireAndForget(tollgate.track(event), opts.onError);\n    return result;\n  };\n\n  return new Proxy(client, {\n    get(target, prop, recv) {\n      if (prop === 'chat') {\n        const chat = Reflect.get(target, prop, recv) as OpenAILike['chat'];\n        return new Proxy(chat, {\n          get: (c, p, r) =>\n            p === 'completions'\n              ? new Proxy(completions, {\n                  get: (co, pp, rr) => (pp === 'create' ? create : Reflect.get(co, pp, rr)),\n                })\n              : Reflect.get(c, p, r),\n        });\n      }\n      return Reflect.get(target, prop, recv);\n    },\n  });\n}\n"]}
+{"version":3,"sources":["../src/client.ts","../src/instrument.ts"],"names":["event"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { Provider, RunOutcome, TrackEventInput, TrackResult } from './types';\n\nexport interface TollgateClientOptions {\n  /** Account API key (`tg_live_…`). Falls back to `process.env.TOLLGATE_API_KEY`. */\n  apiKey?: string;\n  /** Base URL of your Tollgate deployment. Defaults to `TOLLGATE_BASE_URL` or production. */\n  baseUrl?: string;\n  /** Per-request timeout in ms. Default 10_000. */\n  timeoutMs?: number;\n  /** Retry attempts on network error / 5xx / 429. Default 2. */\n  maxRetries?: number;\n  /** Custom fetch (for testing or non-standard runtimes). Defaults to global fetch. */\n  fetch?: typeof fetch;\n}\n\nexport class TollgateError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number,\n    readonly body?: unknown,\n  ) {\n    super(message);\n    this.name = 'TollgateError';\n  }\n}\n\nconst DEFAULT_BASE_URL = 'https://tollgateai.vercel.app';\n\n/** Close out a run with its outcome (and, if resolved, the revenue it earns).\n *  A resolution carries no provider usage, so `provider`/`model` are optional. */\nexport interface ResolveInput {\n  /** The run being closed (must match the runId your usage events used). */\n  runId: string;\n  customerId: string;\n  /** 'resolved' books revenue; 'escalated'/'failed' book none (cost still counts). */\n  outcome: RunOutcome;\n  /** Revenue in cents for a resolved run (e.g. 50 for $0.50). Ignored if not resolved. */\n  revenueUnitCents?: number;\n  agentId?: string;\n  /** Idempotency key for the closing event. Defaults to `${runId}#resolve`. */\n  idempotencyKey?: string;\n  ts?: string;\n  /** Rarely needed — a resolution isn't a provider call. Default 'anthropic'/'resolution'. */\n  provider?: Provider;\n  model?: string;\n}\n\nexport interface TollgateClient {\n  /** Report a single usage event. Idempotent on `idempotencyKey`. */\n  track(event: TrackEventInput): Promise<TrackResult>;\n  /** Close a run with its outcome — book revenue once, only if resolved.\n   *  Convenience over `track()`: sends a zero-usage terminal event. */\n  resolve(input: ResolveInput): Promise<TrackResult>;\n}\n\nfunction getEnv(key: string): string | undefined {\n  // Guarded so the SDK works in browsers/edge runtimes without `process`.\n  return typeof process !== 'undefined' ? process.env?.[key] : undefined;\n}\n\nconst sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));\n\nexport function createTollgateClient(opts: TollgateClientOptions = {}): TollgateClient {\n  const apiKey = opts.apiKey ?? getEnv('TOLLGATE_API_KEY');\n  const baseUrl = (opts.baseUrl ?? getEnv('TOLLGATE_BASE_URL') ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n  const timeoutMs = opts.timeoutMs ?? 10_000;\n  const maxRetries = opts.maxRetries ?? 2;\n  const doFetch = opts.fetch ?? globalThis.fetch;\n\n  if (typeof doFetch !== 'function') {\n    throw new TollgateError('No fetch implementation available — pass `fetch` in options.');\n  }\n\n  async function track(event: TrackEventInput): Promise<TrackResult> {\n    if (!apiKey) {\n      throw new TollgateError('Missing API key — set opts.apiKey or TOLLGATE_API_KEY.');\n    }\n\n    let lastErr: unknown;\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      const controller = new AbortController();\n      const timer = setTimeout(() => controller.abort(), timeoutMs);\n      try {\n        const res = await doFetch(`${baseUrl}/api/track`, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${apiKey}`,\n          },\n          body: JSON.stringify(event),\n          signal: controller.signal,\n        });\n\n        // 200 = idempotent duplicate, 201 = created. Both are success.\n        if (res.ok) {\n          return (await res.json()) as TrackResult;\n        }\n\n        // Retry transient failures; fail fast on 4xx (except 429).\n        if (res.status >= 500 || res.status === 429) {\n          lastErr = new TollgateError(`Tollgate track failed (${res.status})`, res.status);\n        } else {\n          const body = await res.json().catch(() => ({}));\n          throw new TollgateError(`Tollgate track failed (${res.status})`, res.status, body);\n        }\n      } catch (err) {\n        // Don't retry deterministic client errors.\n        if (err instanceof TollgateError && err.status && err.status < 500 && err.status !== 429) {\n          throw err;\n        }\n        lastErr = err;\n      } finally {\n        clearTimeout(timer);\n      }\n\n      if (attempt < maxRetries) {\n        await sleep(2 ** attempt * 200); // 200ms, 400ms, …\n      }\n    }\n\n    throw lastErr instanceof Error\n      ? lastErr\n      : new TollgateError('Tollgate track failed after retries');\n  }\n\n  function resolve(input: ResolveInput): Promise<TrackResult> {\n    return track({\n      customerId: input.customerId,\n      runId: input.runId,\n      agentId: input.agentId,\n      // A resolution isn't a provider call; zero usage ⇒ zero cost.\n      provider: input.provider ?? 'anthropic',\n      model: input.model ?? 'resolution',\n      tokensIn: 0,\n      tokensOut: 0,\n      outcome: input.outcome,\n      revenueUnitCents: input.revenueUnitCents,\n      idempotencyKey: input.idempotencyKey ?? `${input.runId}#resolve`,\n      ts: input.ts,\n    });\n  }\n\n  return { track, resolve };\n}\n","// Auto-instrumentation: wrap a provider client so every completion reports its\n// REAL usage to Tollgate — no manual token counting. Wrappers are structurally\n// typed, so this package never has to depend on the provider SDKs.\n//\n// Coverage is universal: OpenAI + Anthropic native, every OpenAI-compatible\n// gateway (set `provider: 'openai_compatible'`), and AWS Bedrock — each in both\n// non-streaming and streaming modes. Cost is always derived server-side from the\n// token counts these wrappers capture, so no provider needs to return a dollar\n// figure (pass `providerCostCents` only if you already have one).\n\nimport type { TollgateClient } from './client';\nimport type { Provider, TrackEventInput } from './types';\n\nexport interface InstrumentOptions {\n  /** Your end customer's stable id. Required for margin attribution. */\n  customerId: string;\n  /** Optional agent/workflow id. */\n  agentId?: string;\n  /** Override the reported provider. Defaults per wrapper ('openai' /\n   *  'anthropic' / 'bedrock'). Set to 'openai_compatible' when the client points\n   *  at an OpenAI-shaped gateway (Vercel AI Gateway, OpenRouter, Groq, Together,\n   *  Nebius, local vLLM, …) so the server prices it by the gateway-echoed model. */\n  provider?: Provider;\n  /** Revenue per call in cents (or a function of the response). */\n  revenueUnitCents?: number | ((response: unknown) => number | undefined);\n  /** Provider/gateway-reported cost in cents (or a function of the response).\n   *  When present and > 0, the server uses it verbatim and skips the rate card —\n   *  the authoritative escape hatch when you already have an exact cost. */\n  providerCostCents?: number | ((response: unknown) => number | undefined);\n  /** Override the run id; defaults to the provider response id. */\n  runId?: string | (() => string);\n  /** Called if a background track() fails. Defaults to console.warn. */\n  onError?: (err: unknown) => void;\n}\n\nfunction randomId(): string {\n  const c = (globalThis as { crypto?: Crypto }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  return `${Date.now()}-${Math.random().toString(36).slice(2)}`;\n}\n\nfunction resolveRunId(opts: InstrumentOptions, responseId?: string): string {\n  if (typeof opts.runId === 'function') return opts.runId();\n  return opts.runId ?? responseId ?? randomId();\n}\n\nfunction resolveRevenue(opts: InstrumentOptions, response: unknown): number | undefined {\n  return typeof opts.revenueUnitCents === 'function'\n    ? opts.revenueUnitCents(response)\n    : opts.revenueUnitCents;\n}\n\nfunction resolveCost(opts: InstrumentOptions, response: unknown): number | undefined {\n  return typeof opts.providerCostCents === 'function'\n    ? opts.providerCostCents(response)\n    : opts.providerCostCents;\n}\n\n/** Attach providerCostCents to an event only when a (non-undefined) value resolves. */\nfunction withCost(\n  event: TrackEventInput,\n  opts: InstrumentOptions,\n  response: unknown,\n): TrackEventInput {\n  const cost = resolveCost(opts, response);\n  if (cost !== undefined) event.providerCostCents = cost;\n  return event;\n}\n\nfunction fireAndForget(p: Promise<unknown>, onError?: InstrumentOptions['onError']): void {\n  p.catch((err) => (onError ?? ((e) => console.warn('[tollgate] track failed:', e)))(err));\n}\n\nfunction isAsyncIterable(x: unknown): x is AsyncIterable<unknown> {\n  return x != null && typeof (x as Record<symbol, unknown>)[Symbol.asyncIterator] === 'function';\n}\n\n/**\n * Wrap an async iterable (a provider stream) so each chunk is observed and a\n * finalizer runs once the stream is exhausted — without disturbing the stream's\n * other methods (`.tee()`, `.controller`, …), which are proxied through. If the\n * consumer abandons the stream early the finalizer still fires on `.return()`.\n */\nfunction instrumentStream<TChunk>(\n  stream: AsyncIterable<TChunk>,\n  onChunk: (chunk: TChunk) => void,\n  onDone: () => void,\n): AsyncIterable<TChunk> {\n  let finished = false;\n  const finish = () => {\n    if (finished) return;\n    finished = true;\n    onDone();\n  };\n  return new Proxy(stream, {\n    get(target, prop, recv) {\n      if (prop === Symbol.asyncIterator) {\n        return function instrumentedIterator() {\n          const inner = (target as AsyncIterable<TChunk>)[Symbol.asyncIterator]();\n          return {\n            async next(...a: []) {\n              const r = await inner.next(...a);\n              if (r.done) finish();\n              else onChunk(r.value);\n              return r;\n            },\n            async return(v?: unknown) {\n              finish();\n              return inner.return ? inner.return(v) : { done: true, value: v as TChunk };\n            },\n            async throw(e?: unknown) {\n              finish();\n              if (inner.throw) return inner.throw(e);\n              throw e;\n            },\n            [Symbol.asyncIterator]() {\n              return this;\n            },\n          };\n        };\n      }\n      return Reflect.get(target, prop, recv);\n    },\n  });\n}\n\n// --- Anthropic ------------------------------------------------------------\n\ninterface AnthropicUsage {\n  input_tokens?: number;\n  output_tokens?: number;\n  cache_read_input_tokens?: number;\n  // Cache CREATION (writes) bill above the input rate. Newer responses break the\n  // total down by TTL; older ones only return the aggregate cache_creation count.\n  cache_creation_input_tokens?: number;\n  cache_creation?: {\n    ephemeral_5m_input_tokens?: number;\n    ephemeral_1h_input_tokens?: number;\n  };\n}\ninterface AnthropicMessage {\n  id?: string;\n  model?: string;\n  usage?: AnthropicUsage;\n}\n// Streaming event shapes we read usage from (message_start carries inputs +\n// cache, message_delta carries the cumulative output token count).\ninterface AnthropicStreamEvent {\n  type?: string;\n  message?: AnthropicMessage;\n  usage?: AnthropicUsage;\n}\n\n/** Map a non-streaming Anthropic message to a track payload (or null if no usage). */\nexport function anthropicEventFrom(\n  msg: AnthropicMessage,\n  opts: InstrumentOptions,\n): TrackEventInput | null {\n  const usage = msg?.usage;\n  if (!usage) return null;\n  const runId = resolveRunId(opts, msg.id);\n  // Split cache-creation tokens by TTL when the response provides the breakdown;\n  // otherwise attribute the whole cache_creation total to the default 5-minute TTL.\n  const fivem = usage.cache_creation?.ephemeral_5m_input_tokens;\n  const oneh = usage.cache_creation?.ephemeral_1h_input_tokens;\n  const hasSplit = fivem !== undefined || oneh !== undefined;\n  const event: TrackEventInput = {\n    customerId: opts.customerId,\n    agentId: opts.agentId,\n    runId,\n    provider: opts.provider ?? 'anthropic',\n    model: msg.model ?? 'unknown',\n    tokensIn: usage.input_tokens ?? 0,\n    tokensOut: usage.output_tokens ?? 0,\n    cachedTokens: usage.cache_read_input_tokens ?? 0,\n    cacheWrite5mTokens: hasSplit ? fivem ?? 0 : usage.cache_creation_input_tokens ?? 0,\n    cacheWrite1hTokens: hasSplit ? oneh ?? 0 : 0,\n    revenueUnitCents: resolveRevenue(opts, msg),\n    idempotencyKey: msg.id ?? `${runId}#${randomId()}`,\n  };\n  return withCost(event, opts, msg);\n}\n\ninterface AnthropicLike {\n  messages: { create: (...args: never[]) => Promise<unknown> };\n}\n\n/** Wrap an Anthropic client so `messages.create` auto-reports usage (streaming\n *  and non-streaming). */\nexport function wrapAnthropic<T extends AnthropicLike>(\n  client: T,\n  tollgate: TollgateClient,\n  opts: InstrumentOptions,\n): T {\n  const messages = client.messages;\n  const original = messages.create.bind(messages) as (...a: never[]) => Promise<unknown>;\n\n  const create = async (...args: never[]): Promise<unknown> => {\n    const result = await original(...args);\n    if (isAsyncIterable(result)) {\n      // Reconstruct a message from the event stream, then reuse the non-stream\n      // mapper. input/cache tokens arrive in message_start; the final cumulative\n      // output token count arrives in the last message_delta.\n      const msg: AnthropicMessage = {};\n      return instrumentStream(\n        result as AsyncIterable<AnthropicStreamEvent>,\n        (ev) => {\n          if (ev.type === 'message_start' && ev.message) {\n            msg.id = ev.message.id;\n            msg.model = ev.message.model;\n            msg.usage = { ...ev.message.usage };\n          } else if (ev.type === 'message_delta' && ev.usage) {\n            msg.usage = { ...(msg.usage ?? {}), output_tokens: ev.usage.output_tokens };\n          }\n        },\n        () => {\n          const event = anthropicEventFrom(msg, opts);\n          if (event) fireAndForget(tollgate.track(event), opts.onError);\n        },\n      );\n    }\n    const event = anthropicEventFrom(result as AnthropicMessage, opts);\n    if (event) fireAndForget(tollgate.track(event), opts.onError);\n    return result;\n  };\n\n  return new Proxy(client, {\n    get(target, prop, recv) {\n      if (prop === 'messages') {\n        return new Proxy(messages, {\n          get: (m, p, r) => (p === 'create' ? create : Reflect.get(m, p, r)),\n        });\n      }\n      return Reflect.get(target, prop, recv);\n    },\n  });\n}\n\n// --- OpenAI (and OpenAI-compatible gateways) ------------------------------\n\ninterface OpenAIUsage {\n  prompt_tokens?: number;\n  completion_tokens?: number;\n  completion_tokens_details?: { reasoning_tokens?: number };\n  prompt_tokens_details?: { cached_tokens?: number };\n}\ninterface OpenAICompletion {\n  id?: string;\n  model?: string;\n  usage?: OpenAIUsage;\n}\n\n/** Map a non-streaming OpenAI chat completion to a track payload (or null). */\nexport function openAIEventFrom(\n  completion: OpenAICompletion,\n  opts: InstrumentOptions,\n): TrackEventInput | null {\n  const usage = completion?.usage;\n  if (!usage) return null;\n  const runId = resolveRunId(opts, completion.id);\n  const event: TrackEventInput = {\n    customerId: opts.customerId,\n    agentId: opts.agentId,\n    runId,\n    provider: opts.provider ?? 'openai',\n    model: completion.model ?? 'unknown',\n    tokensIn: usage.prompt_tokens ?? 0,\n    tokensOut: usage.completion_tokens ?? 0,\n    reasoningTokens: usage.completion_tokens_details?.reasoning_tokens ?? 0,\n    cachedTokens: usage.prompt_tokens_details?.cached_tokens ?? 0,\n    revenueUnitCents: resolveRevenue(opts, completion),\n    idempotencyKey: completion.id ?? `${runId}#${randomId()}`,\n  };\n  return withCost(event, opts, completion);\n}\n\ninterface OpenAILike {\n  chat: { completions: { create: (...args: never[]) => Promise<unknown> } };\n}\n\n/** Wrap an OpenAI (or OpenAI-compatible) client so `chat.completions.create`\n *  auto-reports usage. Streaming works when the caller sets\n *  `stream_options: { include_usage: true }` (required for OpenAI to emit a final\n *  usage chunk); without it there are no token counts to report and the call is\n *  passed through untouched. */\nexport function wrapOpenAI<T extends OpenAILike>(\n  client: T,\n  tollgate: TollgateClient,\n  opts: InstrumentOptions,\n): T {\n  const completions = client.chat.completions;\n  const original = completions.create.bind(completions) as (...a: never[]) => Promise<unknown>;\n\n  const create = async (...args: never[]): Promise<unknown> => {\n    const result = await original(...args);\n    if (isAsyncIterable(result)) {\n      let id: string | undefined;\n      let model: string | undefined;\n      let usage: OpenAIUsage | undefined;\n      return instrumentStream(\n        result as AsyncIterable<OpenAICompletion>,\n        (chunk) => {\n          if (chunk.id) id = chunk.id;\n          if (chunk.model) model = chunk.model;\n          if (chunk.usage) usage = chunk.usage; // only the final chunk carries it\n        },\n        () => {\n          if (!usage) return; // caller didn't request include_usage — nothing to report\n          const event = openAIEventFrom({ id, model, usage }, opts);\n          if (event) fireAndForget(tollgate.track(event), opts.onError);\n        },\n      );\n    }\n    const event = openAIEventFrom(result as OpenAICompletion, opts);\n    if (event) fireAndForget(tollgate.track(event), opts.onError);\n    return result;\n  };\n\n  return new Proxy(client, {\n    get(target, prop, recv) {\n      if (prop === 'chat') {\n        const chat = Reflect.get(target, prop, recv) as OpenAILike['chat'];\n        return new Proxy(chat, {\n          get: (c, p, r) =>\n            p === 'completions'\n              ? new Proxy(completions, {\n                  get: (co, pp, rr) => (pp === 'create' ? create : Reflect.get(co, pp, rr)),\n                })\n              : Reflect.get(c, p, r),\n        });\n      }\n      return Reflect.get(target, prop, recv);\n    },\n  });\n}\n\n// --- AWS Bedrock ----------------------------------------------------------\n// Bedrock's Converse API is command-based: the model id lives on the REQUEST,\n// not the response, so we read it from the command input. Usage is reported in\n// camelCase (inputTokens/outputTokens) plus optional cache token counts.\n\ninterface BedrockUsage {\n  inputTokens?: number;\n  outputTokens?: number;\n  cacheReadInputTokens?: number;\n  cacheWriteInputTokens?: number;\n}\ninterface BedrockConverseResponse {\n  usage?: BedrockUsage;\n  // ConverseStream returns an async-iterable `stream` of events; the final\n  // `metadata` event carries the usage totals.\n  stream?: AsyncIterable<{ metadata?: { usage?: BedrockUsage } }>;\n}\n\n/** Map a Bedrock Converse response (model from the request) to a track payload. */\nexport function bedrockEventFrom(\n  usage: BedrockUsage | undefined,\n  model: string,\n  opts: InstrumentOptions,\n  response: unknown = undefined,\n): TrackEventInput | null {\n  if (!usage) return null;\n  const runId = resolveRunId(opts, undefined);\n  const event: TrackEventInput = {\n    customerId: opts.customerId,\n    agentId: opts.agentId,\n    runId,\n    provider: opts.provider ?? 'bedrock',\n    model,\n    tokensIn: usage.inputTokens ?? 0,\n    tokensOut: usage.outputTokens ?? 0,\n    cachedTokens: usage.cacheReadInputTokens ?? 0,\n    cacheWrite5mTokens: usage.cacheWriteInputTokens ?? 0,\n    revenueUnitCents: resolveRevenue(opts, response),\n    idempotencyKey: `${runId}#${randomId()}`,\n  };\n  return withCost(event, opts, response);\n}\n\ninterface BedrockLike {\n  send: (command: unknown, ...rest: never[]) => Promise<unknown>;\n}\n\n/** Wrap a Bedrock Runtime client so `send(ConverseCommand)` /\n *  `send(ConverseStreamCommand)` auto-report usage. Non-Converse commands (no\n *  usage in the response) pass through untouched. */\nexport function wrapBedrock<T extends BedrockLike>(\n  client: T,\n  tollgate: TollgateClient,\n  opts: InstrumentOptions,\n): T {\n  const originalSend = client.send.bind(client) as BedrockLike['send'];\n\n  const send = async (command: unknown, ...rest: never[]): Promise<unknown> => {\n    const result = (await originalSend(command, ...rest)) as BedrockConverseResponse;\n    const model =\n      ((command as { input?: { modelId?: string } })?.input?.modelId) ?? 'unknown';\n\n    if (result?.stream && isAsyncIterable(result.stream)) {\n      let usage: BedrockUsage | undefined;\n      result.stream = instrumentStream(\n        result.stream,\n        (ev) => {\n          if (ev.metadata?.usage) usage = ev.metadata.usage;\n        },\n        () => {\n          const event = bedrockEventFrom(usage, model, opts, result);\n          if (event) fireAndForget(tollgate.track(event), opts.onError);\n        },\n      );\n      return result;\n    }\n\n    if (result?.usage) {\n      const event = bedrockEventFrom(result.usage, model, opts, result);\n      if (event) fireAndForget(tollgate.track(event), opts.onError);\n    }\n    return result;\n  };\n\n  return new Proxy(client, {\n    get(target, prop, recv) {\n      if (prop === 'send') return send;\n      return Reflect.get(target, prop, recv);\n    },\n  });\n}\n"]}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-type Provider = 'anthropic' | 'openai' | 'bedrock';
+type Provider = 'anthropic' | 'openai' | 'openai_compatible' | 'bedrock';
 type EventType = 'llm' | 'tool' | 'retrieval';
 /** Terminal outcome of a run, reported on its closing event (see `resolve()`).
  *  Under outcome-based pricing only a `resolved` run books revenue — an
@@ -33,6 +33,9 @@ interface TrackEventInput {
     outcome?: RunOutcome;
     /** Per-event revenue contribution in cents (e.g. 50 for a $0.50 unit). */
     revenueUnitCents?: number;
+    /** Provider/gateway-reported cost in cents. When present and > 0 the server
+     *  uses it verbatim and skips the rate card (fractional cents accepted). */
+    providerCostCents?: number;
     /** Required for exactly-once ingestion (e.g. "run_12345#step_1"). */
     idempotencyKey: string;
     /** ISO timestamp; defaults to server receive time. */
@@ -92,8 +95,17 @@ interface InstrumentOptions {
     customerId: string;
     /** Optional agent/workflow id. */
     agentId?: string;
+    /** Override the reported provider. Defaults per wrapper ('openai' /
+     *  'anthropic' / 'bedrock'). Set to 'openai_compatible' when the client points
+     *  at an OpenAI-shaped gateway (Vercel AI Gateway, OpenRouter, Groq, Together,
+     *  Nebius, local vLLM, …) so the server prices it by the gateway-echoed model. */
+    provider?: Provider;
     /** Revenue per call in cents (or a function of the response). */
     revenueUnitCents?: number | ((response: unknown) => number | undefined);
+    /** Provider/gateway-reported cost in cents (or a function of the response).
+     *  When present and > 0, the server uses it verbatim and skips the rate card —
+     *  the authoritative escape hatch when you already have an exact cost. */
+    providerCostCents?: number | ((response: unknown) => number | undefined);
     /** Override the run id; defaults to the provider response id. */
     runId?: string | (() => string);
     /** Called if a background track() fails. Defaults to console.warn. */
@@ -121,7 +133,8 @@ interface AnthropicLike {
         create: (...args: never[]) => Promise<unknown>;
     };
 }
-/** Wrap an Anthropic client so `messages.create` auto-reports usage. */
+/** Wrap an Anthropic client so `messages.create` auto-reports usage (streaming
+ *  and non-streaming). */
 declare function wrapAnthropic<T extends AnthropicLike>(client: T, tollgate: TollgateClient, opts: InstrumentOptions): T;
 interface OpenAIUsage {
     prompt_tokens?: number;
@@ -147,7 +160,26 @@ interface OpenAILike {
         };
     };
 }
-/** Wrap an OpenAI client so `chat.completions.create` auto-reports usage. */
+/** Wrap an OpenAI (or OpenAI-compatible) client so `chat.completions.create`
+ *  auto-reports usage. Streaming works when the caller sets
+ *  `stream_options: { include_usage: true }` (required for OpenAI to emit a final
+ *  usage chunk); without it there are no token counts to report and the call is
+ *  passed through untouched. */
 declare function wrapOpenAI<T extends OpenAILike>(client: T, tollgate: TollgateClient, opts: InstrumentOptions): T;
+interface BedrockUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheReadInputTokens?: number;
+    cacheWriteInputTokens?: number;
+}
+/** Map a Bedrock Converse response (model from the request) to a track payload. */
+declare function bedrockEventFrom(usage: BedrockUsage | undefined, model: string, opts: InstrumentOptions, response?: unknown): TrackEventInput | null;
+interface BedrockLike {
+    send: (command: unknown, ...rest: never[]) => Promise<unknown>;
+}
+/** Wrap a Bedrock Runtime client so `send(ConverseCommand)` /
+ *  `send(ConverseStreamCommand)` auto-report usage. Non-Converse commands (no
+ *  usage in the response) pass through untouched. */
+declare function wrapBedrock<T extends BedrockLike>(client: T, tollgate: TollgateClient, opts: InstrumentOptions): T;
 
-export { type EventType, type InstrumentOptions, type Provider, type ResolveInput, type RunOutcome, type TollgateClient, type TollgateClientOptions, TollgateError, type TrackEventInput, type TrackResult, anthropicEventFrom, createTollgateClient, openAIEventFrom, wrapAnthropic, wrapOpenAI };
+export { type EventType, type InstrumentOptions, type Provider, type ResolveInput, type RunOutcome, type TollgateClient, type TollgateClientOptions, TollgateError, type TrackEventInput, type TrackResult, anthropicEventFrom, bedrockEventFrom, createTollgateClient, openAIEventFrom, wrapAnthropic, wrapBedrock, wrapOpenAI };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-type Provider = 'anthropic' | 'openai' | 'bedrock';
+type Provider = 'anthropic' | 'openai' | 'openai_compatible' | 'bedrock';
 type EventType = 'llm' | 'tool' | 'retrieval';
 /** Terminal outcome of a run, reported on its closing event (see `resolve()`).
  *  Under outcome-based pricing only a `resolved` run books revenue — an
@@ -33,6 +33,9 @@ interface TrackEventInput {
     outcome?: RunOutcome;
     /** Per-event revenue contribution in cents (e.g. 50 for a $0.50 unit). */
     revenueUnitCents?: number;
+    /** Provider/gateway-reported cost in cents. When present and > 0 the server
+     *  uses it verbatim and skips the rate card (fractional cents accepted). */
+    providerCostCents?: number;
     /** Required for exactly-once ingestion (e.g. "run_12345#step_1"). */
     idempotencyKey: string;
     /** ISO timestamp; defaults to server receive time. */
@@ -92,8 +95,17 @@ interface InstrumentOptions {
     customerId: string;
     /** Optional agent/workflow id. */
     agentId?: string;
+    /** Override the reported provider. Defaults per wrapper ('openai' /
+     *  'anthropic' / 'bedrock'). Set to 'openai_compatible' when the client points
+     *  at an OpenAI-shaped gateway (Vercel AI Gateway, OpenRouter, Groq, Together,
+     *  Nebius, local vLLM, …) so the server prices it by the gateway-echoed model. */
+    provider?: Provider;
     /** Revenue per call in cents (or a function of the response). */
     revenueUnitCents?: number | ((response: unknown) => number | undefined);
+    /** Provider/gateway-reported cost in cents (or a function of the response).
+     *  When present and > 0, the server uses it verbatim and skips the rate card —
+     *  the authoritative escape hatch when you already have an exact cost. */
+    providerCostCents?: number | ((response: unknown) => number | undefined);
     /** Override the run id; defaults to the provider response id. */
     runId?: string | (() => string);
     /** Called if a background track() fails. Defaults to console.warn. */
@@ -121,7 +133,8 @@ interface AnthropicLike {
         create: (...args: never[]) => Promise<unknown>;
     };
 }
-/** Wrap an Anthropic client so `messages.create` auto-reports usage. */
+/** Wrap an Anthropic client so `messages.create` auto-reports usage (streaming
+ *  and non-streaming). */
 declare function wrapAnthropic<T extends AnthropicLike>(client: T, tollgate: TollgateClient, opts: InstrumentOptions): T;
 interface OpenAIUsage {
     prompt_tokens?: number;
@@ -147,7 +160,26 @@ interface OpenAILike {
         };
     };
 }
-/** Wrap an OpenAI client so `chat.completions.create` auto-reports usage. */
+/** Wrap an OpenAI (or OpenAI-compatible) client so `chat.completions.create`
+ *  auto-reports usage. Streaming works when the caller sets
+ *  `stream_options: { include_usage: true }` (required for OpenAI to emit a final
+ *  usage chunk); without it there are no token counts to report and the call is
+ *  passed through untouched. */
 declare function wrapOpenAI<T extends OpenAILike>(client: T, tollgate: TollgateClient, opts: InstrumentOptions): T;
+interface BedrockUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheReadInputTokens?: number;
+    cacheWriteInputTokens?: number;
+}
+/** Map a Bedrock Converse response (model from the request) to a track payload. */
+declare function bedrockEventFrom(usage: BedrockUsage | undefined, model: string, opts: InstrumentOptions, response?: unknown): TrackEventInput | null;
+interface BedrockLike {
+    send: (command: unknown, ...rest: never[]) => Promise<unknown>;
+}
+/** Wrap a Bedrock Runtime client so `send(ConverseCommand)` /
+ *  `send(ConverseStreamCommand)` auto-report usage. Non-Converse commands (no
+ *  usage in the response) pass through untouched. */
+declare function wrapBedrock<T extends BedrockLike>(client: T, tollgate: TollgateClient, opts: InstrumentOptions): T;
 
-export { type EventType, type InstrumentOptions, type Provider, type ResolveInput, type RunOutcome, type TollgateClient, type TollgateClientOptions, TollgateError, type TrackEventInput, type TrackResult, anthropicEventFrom, createTollgateClient, openAIEventFrom, wrapAnthropic, wrapOpenAI };
+export { type EventType, type InstrumentOptions, type Provider, type ResolveInput, type RunOutcome, type TollgateClient, type TollgateClientOptions, TollgateError, type TrackEventInput, type TrackResult, anthropicEventFrom, bedrockEventFrom, createTollgateClient, openAIEventFrom, wrapAnthropic, wrapBedrock, wrapOpenAI };

package/dist/index.js

@@ -94,9 +94,58 @@ function resolveRunId(opts, responseId) {
 function resolveRevenue(opts, response) {
   return typeof opts.revenueUnitCents === "function" ? opts.revenueUnitCents(response) : opts.revenueUnitCents;
 }
+function resolveCost(opts, response) {
+  return typeof opts.providerCostCents === "function" ? opts.providerCostCents(response) : opts.providerCostCents;
+}
+function withCost(event, opts, response) {
+  const cost = resolveCost(opts, response);
+  if (cost !== void 0) event.providerCostCents = cost;
+  return event;
+}
 function fireAndForget(p, onError) {
   p.catch((err) => (onError ?? ((e) => console.warn("[tollgate] track failed:", e)))(err));
 }
+function isAsyncIterable(x) {
+  return x != null && typeof x[Symbol.asyncIterator] === "function";
+}
+function instrumentStream(stream, onChunk, onDone) {
+  let finished = false;
+  const finish = () => {
+    if (finished) return;
+    finished = true;
+    onDone();
+  };
+  return new Proxy(stream, {
+    get(target, prop, recv) {
+      if (prop === Symbol.asyncIterator) {
+        return function instrumentedIterator() {
+          const inner = target[Symbol.asyncIterator]();
+          return {
+            async next(...a) {
+              const r = await inner.next(...a);
+              if (r.done) finish();
+              else onChunk(r.value);
+              return r;
+            },
+            async return(v) {
+              finish();
+              return inner.return ? inner.return(v) : { done: true, value: v };
+            },
+            async throw(e) {
+              finish();
+              if (inner.throw) return inner.throw(e);
+              throw e;
+            },
+            [Symbol.asyncIterator]() {
+              return this;
+            }
+          };
+        };
+      }
+      return Reflect.get(target, prop, recv);
+    }
+  });
+}
 function anthropicEventFrom(msg, opts) {
   const usage = msg?.usage;
   if (!usage) return null;
@@ -104,11 +153,11 @@ function anthropicEventFrom(msg, opts) {
   const fivem = usage.cache_creation?.ephemeral_5m_input_tokens;
   const oneh = usage.cache_creation?.ephemeral_1h_input_tokens;
   const hasSplit = fivem !== void 0 || oneh !== void 0;
-  return {
+  const event = {
     customerId: opts.customerId,
     agentId: opts.agentId,
     runId,
-    provider: "anthropic",
+    provider: opts.provider ?? "anthropic",
     model: msg.model ?? "unknown",
     tokensIn: usage.input_tokens ?? 0,
     tokensOut: usage.output_tokens ?? 0,
@@ -118,12 +167,32 @@ function anthropicEventFrom(msg, opts) {
     revenueUnitCents: resolveRevenue(opts, msg),
     idempotencyKey: msg.id ?? `${runId}#${randomId()}`
   };
+  return withCost(event, opts, msg);
 }
 function wrapAnthropic(client, tollgate, opts) {
   const messages = client.messages;
   const original = messages.create.bind(messages);
   const create = async (...args) => {
     const result = await original(...args);
+    if (isAsyncIterable(result)) {
+      const msg = {};
+      return instrumentStream(
+        result,
+        (ev) => {
+          if (ev.type === "message_start" && ev.message) {
+            msg.id = ev.message.id;
+            msg.model = ev.message.model;
+            msg.usage = { ...ev.message.usage };
+          } else if (ev.type === "message_delta" && ev.usage) {
+            msg.usage = { ...msg.usage ?? {}, output_tokens: ev.usage.output_tokens };
+          }
+        },
+        () => {
+          const event2 = anthropicEventFrom(msg, opts);
+          if (event2) fireAndForget(tollgate.track(event2), opts.onError);
+        }
+      );
+    }
     const event = anthropicEventFrom(result, opts);
     if (event) fireAndForget(tollgate.track(event), opts.onError);
     return result;
@@ -143,11 +212,11 @@ function openAIEventFrom(completion, opts) {
   const usage = completion?.usage;
   if (!usage) return null;
   const runId = resolveRunId(opts, completion.id);
-  return {
+  const event = {
     customerId: opts.customerId,
     agentId: opts.agentId,
     runId,
-    provider: "openai",
+    provider: opts.provider ?? "openai",
     model: completion.model ?? "unknown",
     tokensIn: usage.prompt_tokens ?? 0,
     tokensOut: usage.completion_tokens ?? 0,
@@ -156,12 +225,31 @@ function openAIEventFrom(completion, opts) {
     revenueUnitCents: resolveRevenue(opts, completion),
     idempotencyKey: completion.id ?? `${runId}#${randomId()}`
   };
+  return withCost(event, opts, completion);
 }
 function wrapOpenAI(client, tollgate, opts) {
   const completions = client.chat.completions;
   const original = completions.create.bind(completions);
   const create = async (...args) => {
     const result = await original(...args);
+    if (isAsyncIterable(result)) {
+      let id;
+      let model;
+      let usage;
+      return instrumentStream(
+        result,
+        (chunk) => {
+          if (chunk.id) id = chunk.id;
+          if (chunk.model) model = chunk.model;
+          if (chunk.usage) usage = chunk.usage;
+        },
+        () => {
+          if (!usage) return;
+          const event2 = openAIEventFrom({ id, model, usage }, opts);
+          if (event2) fireAndForget(tollgate.track(event2), opts.onError);
+        }
+      );
+    }
     const event = openAIEventFrom(result, opts);
     if (event) fireAndForget(tollgate.track(event), opts.onError);
     return result;
@@ -180,7 +268,57 @@ function wrapOpenAI(client, tollgate, opts) {
     }
   });
 }
+function bedrockEventFrom(usage, model, opts, response = void 0) {
+  if (!usage) return null;
+  const runId = resolveRunId(opts, void 0);
+  const event = {
+    customerId: opts.customerId,
+    agentId: opts.agentId,
+    runId,
+    provider: opts.provider ?? "bedrock",
+    model,
+    tokensIn: usage.inputTokens ?? 0,
+    tokensOut: usage.outputTokens ?? 0,
+    cachedTokens: usage.cacheReadInputTokens ?? 0,
+    cacheWrite5mTokens: usage.cacheWriteInputTokens ?? 0,
+    revenueUnitCents: resolveRevenue(opts, response),
+    idempotencyKey: `${runId}#${randomId()}`
+  };
+  return withCost(event, opts, response);
+}
+function wrapBedrock(client, tollgate, opts) {
+  const originalSend = client.send.bind(client);
+  const send = async (command, ...rest) => {
+    const result = await originalSend(command, ...rest);
+    const model = command?.input?.modelId ?? "unknown";
+    if (result?.stream && isAsyncIterable(result.stream)) {
+      let usage;
+      result.stream = instrumentStream(
+        result.stream,
+        (ev) => {
+          if (ev.metadata?.usage) usage = ev.metadata.usage;
+        },
+        () => {
+          const event = bedrockEventFrom(usage, model, opts, result);
+          if (event) fireAndForget(tollgate.track(event), opts.onError);
+        }
+      );
+      return result;
+    }
+    if (result?.usage) {
+      const event = bedrockEventFrom(result.usage, model, opts, result);
+      if (event) fireAndForget(tollgate.track(event), opts.onError);
+    }
+    return result;
+  };
+  return new Proxy(client, {
+    get(target, prop, recv) {
+      if (prop === "send") return send;
+      return Reflect.get(target, prop, recv);
+    }
+  });
+}
 
-export { TollgateError, anthropicEventFrom, createTollgateClient, openAIEventFrom, wrapAnthropic, wrapOpenAI };
+export { TollgateError, anthropicEventFrom, bedrockEventFrom, createTollgateClient, openAIEventFrom, wrapAnthropic, wrapBedrock, wrapOpenAI };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/instrument.ts"],"names":[],"mappings":";AAeO,IAAM,aAAA,GAAN,cAA4B,KAAA,CAAM;AAAA,EACvC,WAAA,CACE,OAAA,EACS,MAAA,EACA,IAAA,EACT;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AAHJ,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AACA,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAGT,IAAA,IAAA,CAAK,IAAA,GAAO,eAAA;AAAA,EACd;AACF;AAEA,IAAM,gBAAA,GAAmB,+BAAA;AA6BzB,SAAS,OAAO,GAAA,EAAiC;AAE/C,EAAA,OAAO,OAAO,OAAA,KAAY,WAAA,GAAc,OAAA,CAAQ,GAAA,GAAM,GAAG,CAAA,GAAI,MAAA;AAC/D;AAEA,IAAM,KAAA,GAAQ,CAAC,EAAA,KAAe,IAAI,OAAA,CAAQ,CAAC,CAAA,KAAM,UAAA,CAAW,CAAA,EAAG,EAAE,CAAC,CAAA;AAE3D,SAAS,oBAAA,CAAqB,IAAA,GAA8B,EAAC,EAAmB;AACrF,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,MAAA,IAAU,MAAA,CAAO,kBAAkB,CAAA;AACvD,EAAA,MAAM,OAAA,GAAA,CAAW,KAAK,OAAA,IAAW,MAAA,CAAO,mBAAmB,CAAA,IAAK,gBAAA,EAAkB,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AACnG,EAAA,MAAM,SAAA,GAAY,KAAK,SAAA,IAAa,GAAA;AACpC,EAAA,MAAM,UAAA,GAAa,KAAK,UAAA,IAAc,CAAA;AACtC,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,KAAA,IAAS,UAAA,CAAW,KAAA;AAEzC,EAAA,IAAI,OAAO,YAAY,UAAA,EAAY;AACjC,IAAA,MAAM,IAAI,cAAc,mEAA8D,CAAA;AAAA,EACxF;AAEA,EAAA,eAAe,MAAM,KAAA,EAA8C;AACjE,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,IAAI,cAAc,6DAAwD,CAAA;AAAA,IAClF;AAEA,IAAA,IAAI,OAAA;AACJ,IAAA,KAAA,IAAS,OAAA,GAAU,CAAA,EAAG,OAAA,IAAW,UAAA,EAAY,OAAA,EAAA,EAAW;AACtD,MAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,MAAA,MAAM,QAAQ,UAAA,CAAW,MAAM,UAAA,CAAW,KAAA,IAAS,SAAS,CAAA;AAC5D,MAAA,IAAI;AACF,QAAA,MAAM,GAAA,GAAM,MAAM,OAAA,CAAQ,CAAA,EAAG,OAAO,CAAA,UAAA,CAAA,EAAc;AAAA,UAChD,MAAA,EAAQ,MAAA;AAAA,UACR,OAAA,EAAS;AAAA,YACP,cAAA,EAAgB,kBAAA;AAAA,YAChB,aAAA,EAAe,UAAU,MAAM,CAAA;AAAA,WACjC;AAAA,UACA,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,KAAK,CAAA;AAAA,UAC1B,QAAQ,UAAA,CAAW;AAAA,SACpB,CAAA;AAGD,QAAA,IAAI,IAAI,EAAA,EAAI;AACV,UAAA,OAAQ,MAAM,IAAI,IAAA,EAAK;AAAA,QACzB;AAGA,QAAA,IAAI,GAAA,CAAI,MAAA,IAAU,GAAA,IAAO,GAAA,CAAI,WAAW,GAAA,EAAK;AAC3C,UAAA,OAAA,GAAU,IAAI,aAAA,CAAc,CAAA,uBAAA,EAA0B,IAAI,MAAM,CAAA,CAAA,CAAA,EAAK,IAAI,MAAM,CAAA;AAAA,QACjF,CAAA,MAAO;AACL,UAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,GAAO,KAAA,CAAM,OAAO,EAAC,CAAE,CAAA;AAC9C,UAAA,MAAM,IAAI,cAAc,CAAA,uBAAA,EAA0B,GAAA,CAAI,MAAM,CAAA,CAAA,CAAA,EAAK,GAAA,CAAI,QAAQ,IAAI,CAAA;AAAA,QACnF;AAAA,MACF,SAAS,GAAA,EAAK;AAEZ,QAAA,IAAI,GAAA,YAAe,iBAAiB,GAAA,CAAI,MAAA,IAAU,IAAI,MAAA,GAAS,GAAA,IAAO,GAAA,CAAI,MAAA,KAAW,GAAA,EAAK;AACxF,UAAA,MAAM,GAAA;AAAA,QACR;AACA,QAAA,OAAA,GAAU,GAAA;AAAA,MACZ,CAAA,SAAE;AACA,QAAA,YAAA,CAAa,KAAK,CAAA;AAAA,MACpB;AAEA,MAAA,IAAI,UAAU,UAAA,EAAY;AACxB,QAAA,MAAM,KAAA,CAAM,CAAA,IAAK,OAAA,GAAU,GAAG,CAAA;AAAA,MAChC;AAAA,IACF;AAEA,IAAA,MAAM,OAAA,YAAmB,KAAA,GACrB,OAAA,GACA,IAAI,cAAc,qCAAqC,CAAA;AAAA,EAC7D;AAEA,EAAA,SAAS,QAAQ,KAAA,EAA2C;AAC1D,IAAA,OAAO,KAAA,CAAM;AAAA,MACX,YAAY,KAAA,CAAM,UAAA;AAAA,MAClB,OAAO,KAAA,CAAM,KAAA;AAAA,MACb,SAAS,KAAA,CAAM,OAAA;AAAA;AAAA,MAEf,QAAA,EAAU,MAAM,QAAA,IAAY,WAAA;AAAA,MAC5B,KAAA,EAAO,MAAM,KAAA,IAAS,YAAA;AAAA,MACtB,QAAA,EAAU,CAAA;AAAA,MACV,SAAA,EAAW,CAAA;AAAA,MACX,SAAS,KAAA,CAAM,OAAA;AAAA,MACf,kBAAkB,KAAA,CAAM,gBAAA;AAAA,MACxB,cAAA,EAAgB,KAAA,CAAM,cAAA,IAAkB,CAAA,EAAG,MAAM,KAAK,CAAA,QAAA,CAAA;AAAA,MACtD,IAAI,KAAA,CAAM;AAAA,KACX,CAAA;AAAA,EACH;AAEA,EAAA,OAAO,EAAE,OAAO,OAAA,EAAQ;AAC1B;;;AC3HA,SAAS,QAAA,GAAmB;AAC1B,EAAA,MAAM,IAAK,UAAA,CAAmC,MAAA;AAC9C,EAAA,IAAI,CAAA,EAAG,UAAA,EAAY,OAAO,CAAA,CAAE,UAAA,EAAW;AACvC,EAAA,OAAO,CAAA,EAAG,IAAA,CAAK,GAAA,EAAK,CAAA,CAAA,EAAI,IAAA,CAAK,MAAA,EAAO,CAAE,QAAA,CAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AAC7D;AAEA,SAAS,YAAA,CAAa,MAAyB,UAAA,EAA6B;AAC1E,EAAA,IAAI,OAAO,IAAA,CAAK,KAAA,KAAU,UAAA,EAAY,OAAO,KAAK,KAAA,EAAM;AACxD,EAAA,OAAO,IAAA,CAAK,KAAA,IAAS,UAAA,IAAc,QAAA,EAAS;AAC9C;AAEA,SAAS,cAAA,CAAe,MAAyB,QAAA,EAAuC;AACtF,EAAA,OAAO,OAAO,KAAK,gBAAA,KAAqB,UAAA,GACpC,KAAK,gBAAA,CAAiB,QAAQ,IAC9B,IAAA,CAAK,gBAAA;AACX;AAEA,SAAS,aAAA,CAAc,GAAqB,OAAA,EAA8C;AACxF,EAAA,CAAA,CAAE,KAAA,CAAM,CAAC,GAAA,KAAA,CAAS,OAAA,KAAY,CAAC,CAAA,KAAM,OAAA,CAAQ,IAAA,CAAK,0BAAA,EAA4B,CAAC,CAAA,CAAA,EAAI,GAAG,CAAC,CAAA;AACzF;AAuBO,SAAS,kBAAA,CACd,KACA,IAAA,EACwB;AACxB,EAAA,MAAM,QAAQ,GAAA,EAAK,KAAA;AACnB,EAAA,IAAI,CAAC,OAAO,OAAO,IAAA;AACnB,EAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,IAAA,EAAM,GAAA,CAAI,EAAE,CAAA;AAGvC,EAAA,MAAM,KAAA,GAAQ,MAAM,cAAA,EAAgB,yBAAA;AACpC,EAAA,MAAM,IAAA,GAAO,MAAM,cAAA,EAAgB,yBAAA;AACnC,EAAA,MAAM,QAAA,GAAW,KAAA,KAAU,MAAA,IAAa,IAAA,KAAS,MAAA;AACjD,EAAA,OAAO;AAAA,IACL,YAAY,IAAA,CAAK,UAAA;AAAA,IACjB,SAAS,IAAA,CAAK,OAAA;AAAA,IACd,KAAA;AAAA,IACA,QAAA,EAAU,WAAA;AAAA,IACV,KAAA,EAAO,IAAI,KAAA,IAAS,SAAA;AAAA,IACpB,QAAA,EAAU,MAAM,YAAA,IAAgB,CAAA;AAAA,IAChC,SAAA,EAAW,MAAM,aAAA,IAAiB,CAAA;AAAA,IAClC,YAAA,EAAc,MAAM,uBAAA,IAA2B,CAAA;AAAA,IAC/C,kBAAA,EAAoB,QAAA,GAAW,KAAA,IAAS,CAAA,GAAI,MAAM,2BAAA,IAA+B,CAAA;AAAA,IACjF,kBAAA,EAAoB,QAAA,GAAW,IAAA,IAAQ,CAAA,GAAI,CAAA;AAAA,IAC3C,gBAAA,EAAkB,cAAA,CAAe,IAAA,EAAM,GAAG,CAAA;AAAA,IAC1C,gBAAgB,GAAA,CAAI,EAAA,IAAM,GAAG,KAAK,CAAA,CAAA,EAAI,UAAU,CAAA;AAAA,GAClD;AACF;AAOO,SAAS,aAAA,CACd,MAAA,EACA,QAAA,EACA,IAAA,EACG;AACH,EAAA,MAAM,WAAW,MAAA,CAAO,QAAA;AACxB,EAAA,MAAM,QAAA,GAAW,QAAA,CAAS,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAA;AAE9C,EAAA,MAAM,MAAA,GAAS,UAAU,IAAA,KAAoC;AAC3D,IAAA,MAAM,MAAA,GAAS,MAAM,QAAA,CAAS,GAAG,IAAI,CAAA;AACrC,IAAA,MAAM,KAAA,GAAQ,kBAAA,CAAmB,MAAA,EAA4B,IAAI,CAAA;AACjE,IAAA,IAAI,OAAO,aAAA,CAAc,QAAA,CAAS,MAAM,KAAK,CAAA,EAAG,KAAK,OAAO,CAAA;AAC5D,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO,IAAI,MAAM,MAAA,EAAQ;AAAA,IACvB,GAAA,CAAI,MAAA,EAAQ,IAAA,EAAM,IAAA,EAAM;AACtB,MAAA,IAAI,SAAS,UAAA,EAAY;AACvB,QAAA,OAAO,IAAI,MAAM,QAAA,EAAU;AAAA,UACzB,GAAA,EAAK,CAAC,CAAA,EAAG,CAAA,EAAG,CAAA,KAAO,CAAA,KAAM,QAAA,GAAW,MAAA,GAAS,OAAA,CAAQ,GAAA,CAAI,CAAA,EAAG,CAAA,EAAG,CAAC;AAAA,SACjE,CAAA;AAAA,MACH;AACA,MAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,MAAA,EAAQ,IAAA,EAAM,IAAI,CAAA;AAAA,IACvC;AAAA,GACD,CAAA;AACH;AAiBO,SAAS,eAAA,CACd,YACA,IAAA,EACwB;AACxB,EAAA,MAAM,QAAQ,UAAA,EAAY,KAAA;AAC1B,EAAA,IAAI,CAAC,OAAO,OAAO,IAAA;AACnB,EAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,IAAA,EAAM,UAAA,CAAW,EAAE,CAAA;AAC9C,EAAA,OAAO;AAAA,IACL,YAAY,IAAA,CAAK,UAAA;AAAA,IACjB,SAAS,IAAA,CAAK,OAAA;AAAA,IACd,KAAA;AAAA,IACA,QAAA,EAAU,QAAA;AAAA,IACV,KAAA,EAAO,WAAW,KAAA,IAAS,SAAA;AAAA,IAC3B,QAAA,EAAU,MAAM,aAAA,IAAiB,CAAA;AAAA,IACjC,SAAA,EAAW,MAAM,iBAAA,IAAqB,CAAA;AAAA,IACtC,eAAA,EAAiB,KAAA,CAAM,yBAAA,EAA2B,gBAAA,IAAoB,CAAA;AAAA,IACtE,YAAA,EAAc,KAAA,CAAM,qBAAA,EAAuB,aAAA,IAAiB,CAAA;AAAA,IAC5D,gBAAA,EAAkB,cAAA,CAAe,IAAA,EAAM,UAAU,CAAA;AAAA,IACjD,gBAAgB,UAAA,CAAW,EAAA,IAAM,GAAG,KAAK,CAAA,CAAA,EAAI,UAAU,CAAA;AAAA,GACzD;AACF;AAOO,SAAS,UAAA,CACd,MAAA,EACA,QAAA,EACA,IAAA,EACG;AACH,EAAA,MAAM,WAAA,GAAc,OAAO,IAAA,CAAK,WAAA;AAChC,EAAA,MAAM,QAAA,GAAW,WAAA,CAAY,MAAA,CAAO,IAAA,CAAK,WAAW,CAAA;AAEpD,EAAA,MAAM,MAAA,GAAS,UAAU,IAAA,KAAoC;AAC3D,IAAA,MAAM,MAAA,GAAS,MAAM,QAAA,CAAS,GAAG,IAAI,CAAA;AACrC,IAAA,MAAM,KAAA,GAAQ,eAAA,CAAgB,MAAA,EAA4B,IAAI,CAAA;AAC9D,IAAA,IAAI,OAAO,aAAA,CAAc,QAAA,CAAS,MAAM,KAAK,CAAA,EAAG,KAAK,OAAO,CAAA;AAC5D,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO,IAAI,MAAM,MAAA,EAAQ;AAAA,IACvB,GAAA,CAAI,MAAA,EAAQ,IAAA,EAAM,IAAA,EAAM;AACtB,MAAA,IAAI,SAAS,MAAA,EAAQ;AACnB,QAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,GAAA,CAAI,MAAA,EAAQ,MAAM,IAAI,CAAA;AAC3C,QAAA,OAAO,IAAI,MAAM,IAAA,EAAM;AAAA,UACrB,GAAA,EAAK,CAAC,CAAA,EAAG,CAAA,EAAG,MACV,CAAA,KAAM,aAAA,GACF,IAAI,KAAA,CAAM,WAAA,EAAa;AAAA,YACrB,GAAA,EAAK,CAAC,EAAA,EAAI,EAAA,EAAI,EAAA,KAAQ,EAAA,KAAO,QAAA,GAAW,MAAA,GAAS,OAAA,CAAQ,GAAA,CAAI,EAAA,EAAI,EAAA,EAAI,EAAE;AAAA,WACxE,CAAA,GACD,OAAA,CAAQ,GAAA,CAAI,CAAA,EAAG,GAAG,CAAC;AAAA,SAC1B,CAAA;AAAA,MACH;AACA,MAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,MAAA,EAAQ,IAAA,EAAM,IAAI,CAAA;AAAA,IACvC;AAAA,GACD,CAAA;AACH","file":"index.js","sourcesContent":["import type { Provider, RunOutcome, TrackEventInput, TrackResult } from './types';\n\nexport interface TollgateClientOptions {\n  /** Account API key (`tg_live_…`). Falls back to `process.env.TOLLGATE_API_KEY`. */\n  apiKey?: string;\n  /** Base URL of your Tollgate deployment. Defaults to `TOLLGATE_BASE_URL` or production. */\n  baseUrl?: string;\n  /** Per-request timeout in ms. Default 10_000. */\n  timeoutMs?: number;\n  /** Retry attempts on network error / 5xx / 429. Default 2. */\n  maxRetries?: number;\n  /** Custom fetch (for testing or non-standard runtimes). Defaults to global fetch. */\n  fetch?: typeof fetch;\n}\n\nexport class TollgateError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number,\n    readonly body?: unknown,\n  ) {\n    super(message);\n    this.name = 'TollgateError';\n  }\n}\n\nconst DEFAULT_BASE_URL = 'https://tollgateai.vercel.app';\n\n/** Close out a run with its outcome (and, if resolved, the revenue it earns).\n *  A resolution carries no provider usage, so `provider`/`model` are optional. */\nexport interface ResolveInput {\n  /** The run being closed (must match the runId your usage events used). */\n  runId: string;\n  customerId: string;\n  /** 'resolved' books revenue; 'escalated'/'failed' book none (cost still counts). */\n  outcome: RunOutcome;\n  /** Revenue in cents for a resolved run (e.g. 50 for $0.50). Ignored if not resolved. */\n  revenueUnitCents?: number;\n  agentId?: string;\n  /** Idempotency key for the closing event. Defaults to `${runId}#resolve`. */\n  idempotencyKey?: string;\n  ts?: string;\n  /** Rarely needed — a resolution isn't a provider call. Default 'anthropic'/'resolution'. */\n  provider?: Provider;\n  model?: string;\n}\n\nexport interface TollgateClient {\n  /** Report a single usage event. Idempotent on `idempotencyKey`. */\n  track(event: TrackEventInput): Promise<TrackResult>;\n  /** Close a run with its outcome — book revenue once, only if resolved.\n   *  Convenience over `track()`: sends a zero-usage terminal event. */\n  resolve(input: ResolveInput): Promise<TrackResult>;\n}\n\nfunction getEnv(key: string): string | undefined {\n  // Guarded so the SDK works in browsers/edge runtimes without `process`.\n  return typeof process !== 'undefined' ? process.env?.[key] : undefined;\n}\n\nconst sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));\n\nexport function createTollgateClient(opts: TollgateClientOptions = {}): TollgateClient {\n  const apiKey = opts.apiKey ?? getEnv('TOLLGATE_API_KEY');\n  const baseUrl = (opts.baseUrl ?? getEnv('TOLLGATE_BASE_URL') ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n  const timeoutMs = opts.timeoutMs ?? 10_000;\n  const maxRetries = opts.maxRetries ?? 2;\n  const doFetch = opts.fetch ?? globalThis.fetch;\n\n  if (typeof doFetch !== 'function') {\n    throw new TollgateError('No fetch implementation available — pass `fetch` in options.');\n  }\n\n  async function track(event: TrackEventInput): Promise<TrackResult> {\n    if (!apiKey) {\n      throw new TollgateError('Missing API key — set opts.apiKey or TOLLGATE_API_KEY.');\n    }\n\n    let lastErr: unknown;\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      const controller = new AbortController();\n      const timer = setTimeout(() => controller.abort(), timeoutMs);\n      try {\n        const res = await doFetch(`${baseUrl}/api/track`, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${apiKey}`,\n          },\n          body: JSON.stringify(event),\n          signal: controller.signal,\n        });\n\n        // 200 = idempotent duplicate, 201 = created. Both are success.\n        if (res.ok) {\n          return (await res.json()) as TrackResult;\n        }\n\n        // Retry transient failures; fail fast on 4xx (except 429).\n        if (res.status >= 500 || res.status === 429) {\n          lastErr = new TollgateError(`Tollgate track failed (${res.status})`, res.status);\n        } else {\n          const body = await res.json().catch(() => ({}));\n          throw new TollgateError(`Tollgate track failed (${res.status})`, res.status, body);\n        }\n      } catch (err) {\n        // Don't retry deterministic client errors.\n        if (err instanceof TollgateError && err.status && err.status < 500 && err.status !== 429) {\n          throw err;\n        }\n        lastErr = err;\n      } finally {\n        clearTimeout(timer);\n      }\n\n      if (attempt < maxRetries) {\n        await sleep(2 ** attempt * 200); // 200ms, 400ms, …\n      }\n    }\n\n    throw lastErr instanceof Error\n      ? lastErr\n      : new TollgateError('Tollgate track failed after retries');\n  }\n\n  function resolve(input: ResolveInput): Promise<TrackResult> {\n    return track({\n      customerId: input.customerId,\n      runId: input.runId,\n      agentId: input.agentId,\n      // A resolution isn't a provider call; zero usage ⇒ zero cost.\n      provider: input.provider ?? 'anthropic',\n      model: input.model ?? 'resolution',\n      tokensIn: 0,\n      tokensOut: 0,\n      outcome: input.outcome,\n      revenueUnitCents: input.revenueUnitCents,\n      idempotencyKey: input.idempotencyKey ?? `${input.runId}#resolve`,\n      ts: input.ts,\n    });\n  }\n\n  return { track, resolve };\n}\n","// Auto-instrumentation: wrap a provider client so every completion reports its\n// REAL usage to Tollgate — no manual token counting. Wrappers are structurally\n// typed, so this package never has to depend on the provider SDKs.\n\nimport type { TollgateClient } from './client';\nimport type { TrackEventInput } from './types';\n\nexport interface InstrumentOptions {\n  /** Your end customer's stable id. Required for margin attribution. */\n  customerId: string;\n  /** Optional agent/workflow id. */\n  agentId?: string;\n  /** Revenue per call in cents (or a function of the response). */\n  revenueUnitCents?: number | ((response: unknown) => number | undefined);\n  /** Override the run id; defaults to the provider response id. */\n  runId?: string | (() => string);\n  /** Called if a background track() fails. Defaults to console.warn. */\n  onError?: (err: unknown) => void;\n}\n\nfunction randomId(): string {\n  const c = (globalThis as { crypto?: Crypto }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  return `${Date.now()}-${Math.random().toString(36).slice(2)}`;\n}\n\nfunction resolveRunId(opts: InstrumentOptions, responseId?: string): string {\n  if (typeof opts.runId === 'function') return opts.runId();\n  return opts.runId ?? responseId ?? randomId();\n}\n\nfunction resolveRevenue(opts: InstrumentOptions, response: unknown): number | undefined {\n  return typeof opts.revenueUnitCents === 'function'\n    ? opts.revenueUnitCents(response)\n    : opts.revenueUnitCents;\n}\n\nfunction fireAndForget(p: Promise<unknown>, onError?: InstrumentOptions['onError']): void {\n  p.catch((err) => (onError ?? ((e) => console.warn('[tollgate] track failed:', e)))(err));\n}\n\n// --- Anthropic ------------------------------------------------------------\n\ninterface AnthropicUsage {\n  input_tokens?: number;\n  output_tokens?: number;\n  cache_read_input_tokens?: number;\n  // Cache CREATION (writes) bill above the input rate. Newer responses break the\n  // total down by TTL; older ones only return the aggregate cache_creation count.\n  cache_creation_input_tokens?: number;\n  cache_creation?: {\n    ephemeral_5m_input_tokens?: number;\n    ephemeral_1h_input_tokens?: number;\n  };\n}\ninterface AnthropicMessage {\n  id?: string;\n  model?: string;\n  usage?: AnthropicUsage;\n}\n\n/** Map a non-streaming Anthropic message to a track payload (or null if no usage). */\nexport function anthropicEventFrom(\n  msg: AnthropicMessage,\n  opts: InstrumentOptions,\n): TrackEventInput | null {\n  const usage = msg?.usage;\n  if (!usage) return null;\n  const runId = resolveRunId(opts, msg.id);\n  // Split cache-creation tokens by TTL when the response provides the breakdown;\n  // otherwise attribute the whole cache_creation total to the default 5-minute TTL.\n  const fivem = usage.cache_creation?.ephemeral_5m_input_tokens;\n  const oneh = usage.cache_creation?.ephemeral_1h_input_tokens;\n  const hasSplit = fivem !== undefined || oneh !== undefined;\n  return {\n    customerId: opts.customerId,\n    agentId: opts.agentId,\n    runId,\n    provider: 'anthropic',\n    model: msg.model ?? 'unknown',\n    tokensIn: usage.input_tokens ?? 0,\n    tokensOut: usage.output_tokens ?? 0,\n    cachedTokens: usage.cache_read_input_tokens ?? 0,\n    cacheWrite5mTokens: hasSplit ? fivem ?? 0 : usage.cache_creation_input_tokens ?? 0,\n    cacheWrite1hTokens: hasSplit ? oneh ?? 0 : 0,\n    revenueUnitCents: resolveRevenue(opts, msg),\n    idempotencyKey: msg.id ?? `${runId}#${randomId()}`,\n  };\n}\n\ninterface AnthropicLike {\n  messages: { create: (...args: never[]) => Promise<unknown> };\n}\n\n/** Wrap an Anthropic client so `messages.create` auto-reports usage. */\nexport function wrapAnthropic<T extends AnthropicLike>(\n  client: T,\n  tollgate: TollgateClient,\n  opts: InstrumentOptions,\n): T {\n  const messages = client.messages;\n  const original = messages.create.bind(messages) as (...a: never[]) => Promise<unknown>;\n\n  const create = async (...args: never[]): Promise<unknown> => {\n    const result = await original(...args);\n    const event = anthropicEventFrom(result as AnthropicMessage, opts);\n    if (event) fireAndForget(tollgate.track(event), opts.onError);\n    return result;\n  };\n\n  return new Proxy(client, {\n    get(target, prop, recv) {\n      if (prop === 'messages') {\n        return new Proxy(messages, {\n          get: (m, p, r) => (p === 'create' ? create : Reflect.get(m, p, r)),\n        });\n      }\n      return Reflect.get(target, prop, recv);\n    },\n  });\n}\n\n// --- OpenAI ---------------------------------------------------------------\n\ninterface OpenAIUsage {\n  prompt_tokens?: number;\n  completion_tokens?: number;\n  completion_tokens_details?: { reasoning_tokens?: number };\n  prompt_tokens_details?: { cached_tokens?: number };\n}\ninterface OpenAICompletion {\n  id?: string;\n  model?: string;\n  usage?: OpenAIUsage;\n}\n\n/** Map a non-streaming OpenAI chat completion to a track payload (or null). */\nexport function openAIEventFrom(\n  completion: OpenAICompletion,\n  opts: InstrumentOptions,\n): TrackEventInput | null {\n  const usage = completion?.usage;\n  if (!usage) return null;\n  const runId = resolveRunId(opts, completion.id);\n  return {\n    customerId: opts.customerId,\n    agentId: opts.agentId,\n    runId,\n    provider: 'openai',\n    model: completion.model ?? 'unknown',\n    tokensIn: usage.prompt_tokens ?? 0,\n    tokensOut: usage.completion_tokens ?? 0,\n    reasoningTokens: usage.completion_tokens_details?.reasoning_tokens ?? 0,\n    cachedTokens: usage.prompt_tokens_details?.cached_tokens ?? 0,\n    revenueUnitCents: resolveRevenue(opts, completion),\n    idempotencyKey: completion.id ?? `${runId}#${randomId()}`,\n  };\n}\n\ninterface OpenAILike {\n  chat: { completions: { create: (...args: never[]) => Promise<unknown> } };\n}\n\n/** Wrap an OpenAI client so `chat.completions.create` auto-reports usage. */\nexport function wrapOpenAI<T extends OpenAILike>(\n  client: T,\n  tollgate: TollgateClient,\n  opts: InstrumentOptions,\n): T {\n  const completions = client.chat.completions;\n  const original = completions.create.bind(completions) as (...a: never[]) => Promise<unknown>;\n\n  const create = async (...args: never[]): Promise<unknown> => {\n    const result = await original(...args);\n    const event = openAIEventFrom(result as OpenAICompletion, opts);\n    if (event) fireAndForget(tollgate.track(event), opts.onError);\n    return result;\n  };\n\n  return new Proxy(client, {\n    get(target, prop, recv) {\n      if (prop === 'chat') {\n        const chat = Reflect.get(target, prop, recv) as OpenAILike['chat'];\n        return new Proxy(chat, {\n          get: (c, p, r) =>\n            p === 'completions'\n              ? new Proxy(completions, {\n                  get: (co, pp, rr) => (pp === 'create' ? create : Reflect.get(co, pp, rr)),\n                })\n              : Reflect.get(c, p, r),\n        });\n      }\n      return Reflect.get(target, prop, recv);\n    },\n  });\n}\n"]}
+{"version":3,"sources":["../src/client.ts","../src/instrument.ts"],"names":["event"],"mappings":"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","file":"index.js","sourcesContent":["import type { Provider, RunOutcome, TrackEventInput, TrackResult } from './types';\n\nexport interface TollgateClientOptions {\n  /** Account API key (`tg_live_…`). Falls back to `process.env.TOLLGATE_API_KEY`. */\n  apiKey?: string;\n  /** Base URL of your Tollgate deployment. Defaults to `TOLLGATE_BASE_URL` or production. */\n  baseUrl?: string;\n  /** Per-request timeout in ms. Default 10_000. */\n  timeoutMs?: number;\n  /** Retry attempts on network error / 5xx / 429. Default 2. */\n  maxRetries?: number;\n  /** Custom fetch (for testing or non-standard runtimes). Defaults to global fetch. */\n  fetch?: typeof fetch;\n}\n\nexport class TollgateError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number,\n    readonly body?: unknown,\n  ) {\n    super(message);\n    this.name = 'TollgateError';\n  }\n}\n\nconst DEFAULT_BASE_URL = 'https://tollgateai.vercel.app';\n\n/** Close out a run with its outcome (and, if resolved, the revenue it earns).\n *  A resolution carries no provider usage, so `provider`/`model` are optional. */\nexport interface ResolveInput {\n  /** The run being closed (must match the runId your usage events used). */\n  runId: string;\n  customerId: string;\n  /** 'resolved' books revenue; 'escalated'/'failed' book none (cost still counts). */\n  outcome: RunOutcome;\n  /** Revenue in cents for a resolved run (e.g. 50 for $0.50). Ignored if not resolved. */\n  revenueUnitCents?: number;\n  agentId?: string;\n  /** Idempotency key for the closing event. Defaults to `${runId}#resolve`. */\n  idempotencyKey?: string;\n  ts?: string;\n  /** Rarely needed — a resolution isn't a provider call. Default 'anthropic'/'resolution'. */\n  provider?: Provider;\n  model?: string;\n}\n\nexport interface TollgateClient {\n  /** Report a single usage event. Idempotent on `idempotencyKey`. */\n  track(event: TrackEventInput): Promise<TrackResult>;\n  /** Close a run with its outcome — book revenue once, only if resolved.\n   *  Convenience over `track()`: sends a zero-usage terminal event. */\n  resolve(input: ResolveInput): Promise<TrackResult>;\n}\n\nfunction getEnv(key: string): string | undefined {\n  // Guarded so the SDK works in browsers/edge runtimes without `process`.\n  return typeof process !== 'undefined' ? process.env?.[key] : undefined;\n}\n\nconst sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));\n\nexport function createTollgateClient(opts: TollgateClientOptions = {}): TollgateClient {\n  const apiKey = opts.apiKey ?? getEnv('TOLLGATE_API_KEY');\n  const baseUrl = (opts.baseUrl ?? getEnv('TOLLGATE_BASE_URL') ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n  const timeoutMs = opts.timeoutMs ?? 10_000;\n  const maxRetries = opts.maxRetries ?? 2;\n  const doFetch = opts.fetch ?? globalThis.fetch;\n\n  if (typeof doFetch !== 'function') {\n    throw new TollgateError('No fetch implementation available — pass `fetch` in options.');\n  }\n\n  async function track(event: TrackEventInput): Promise<TrackResult> {\n    if (!apiKey) {\n      throw new TollgateError('Missing API key — set opts.apiKey or TOLLGATE_API_KEY.');\n    }\n\n    let lastErr: unknown;\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      const controller = new AbortController();\n      const timer = setTimeout(() => controller.abort(), timeoutMs);\n      try {\n        const res = await doFetch(`${baseUrl}/api/track`, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${apiKey}`,\n          },\n          body: JSON.stringify(event),\n          signal: controller.signal,\n        });\n\n        // 200 = idempotent duplicate, 201 = created. Both are success.\n        if (res.ok) {\n          return (await res.json()) as TrackResult;\n        }\n\n        // Retry transient failures; fail fast on 4xx (except 429).\n        if (res.status >= 500 || res.status === 429) {\n          lastErr = new TollgateError(`Tollgate track failed (${res.status})`, res.status);\n        } else {\n          const body = await res.json().catch(() => ({}));\n          throw new TollgateError(`Tollgate track failed (${res.status})`, res.status, body);\n        }\n      } catch (err) {\n        // Don't retry deterministic client errors.\n        if (err instanceof TollgateError && err.status && err.status < 500 && err.status !== 429) {\n          throw err;\n        }\n        lastErr = err;\n      } finally {\n        clearTimeout(timer);\n      }\n\n      if (attempt < maxRetries) {\n        await sleep(2 ** attempt * 200); // 200ms, 400ms, …\n      }\n    }\n\n    throw lastErr instanceof Error\n      ? lastErr\n      : new TollgateError('Tollgate track failed after retries');\n  }\n\n  function resolve(input: ResolveInput): Promise<TrackResult> {\n    return track({\n      customerId: input.customerId,\n      runId: input.runId,\n      agentId: input.agentId,\n      // A resolution isn't a provider call; zero usage ⇒ zero cost.\n      provider: input.provider ?? 'anthropic',\n      model: input.model ?? 'resolution',\n      tokensIn: 0,\n      tokensOut: 0,\n      outcome: input.outcome,\n      revenueUnitCents: input.revenueUnitCents,\n      idempotencyKey: input.idempotencyKey ?? `${input.runId}#resolve`,\n      ts: input.ts,\n    });\n  }\n\n  return { track, resolve };\n}\n","// Auto-instrumentation: wrap a provider client so every completion reports its\n// REAL usage to Tollgate — no manual token counting. Wrappers are structurally\n// typed, so this package never has to depend on the provider SDKs.\n//\n// Coverage is universal: OpenAI + Anthropic native, every OpenAI-compatible\n// gateway (set `provider: 'openai_compatible'`), and AWS Bedrock — each in both\n// non-streaming and streaming modes. Cost is always derived server-side from the\n// token counts these wrappers capture, so no provider needs to return a dollar\n// figure (pass `providerCostCents` only if you already have one).\n\nimport type { TollgateClient } from './client';\nimport type { Provider, TrackEventInput } from './types';\n\nexport interface InstrumentOptions {\n  /** Your end customer's stable id. Required for margin attribution. */\n  customerId: string;\n  /** Optional agent/workflow id. */\n  agentId?: string;\n  /** Override the reported provider. Defaults per wrapper ('openai' /\n   *  'anthropic' / 'bedrock'). Set to 'openai_compatible' when the client points\n   *  at an OpenAI-shaped gateway (Vercel AI Gateway, OpenRouter, Groq, Together,\n   *  Nebius, local vLLM, …) so the server prices it by the gateway-echoed model. */\n  provider?: Provider;\n  /** Revenue per call in cents (or a function of the response). */\n  revenueUnitCents?: number | ((response: unknown) => number | undefined);\n  /** Provider/gateway-reported cost in cents (or a function of the response).\n   *  When present and > 0, the server uses it verbatim and skips the rate card —\n   *  the authoritative escape hatch when you already have an exact cost. */\n  providerCostCents?: number | ((response: unknown) => number | undefined);\n  /** Override the run id; defaults to the provider response id. */\n  runId?: string | (() => string);\n  /** Called if a background track() fails. Defaults to console.warn. */\n  onError?: (err: unknown) => void;\n}\n\nfunction randomId(): string {\n  const c = (globalThis as { crypto?: Crypto }).crypto;\n  if (c?.randomUUID) return c.randomUUID();\n  return `${Date.now()}-${Math.random().toString(36).slice(2)}`;\n}\n\nfunction resolveRunId(opts: InstrumentOptions, responseId?: string): string {\n  if (typeof opts.runId === 'function') return opts.runId();\n  return opts.runId ?? responseId ?? randomId();\n}\n\nfunction resolveRevenue(opts: InstrumentOptions, response: unknown): number | undefined {\n  return typeof opts.revenueUnitCents === 'function'\n    ? opts.revenueUnitCents(response)\n    : opts.revenueUnitCents;\n}\n\nfunction resolveCost(opts: InstrumentOptions, response: unknown): number | undefined {\n  return typeof opts.providerCostCents === 'function'\n    ? opts.providerCostCents(response)\n    : opts.providerCostCents;\n}\n\n/** Attach providerCostCents to an event only when a (non-undefined) value resolves. */\nfunction withCost(\n  event: TrackEventInput,\n  opts: InstrumentOptions,\n  response: unknown,\n): TrackEventInput {\n  const cost = resolveCost(opts, response);\n  if (cost !== undefined) event.providerCostCents = cost;\n  return event;\n}\n\nfunction fireAndForget(p: Promise<unknown>, onError?: InstrumentOptions['onError']): void {\n  p.catch((err) => (onError ?? ((e) => console.warn('[tollgate] track failed:', e)))(err));\n}\n\nfunction isAsyncIterable(x: unknown): x is AsyncIterable<unknown> {\n  return x != null && typeof (x as Record<symbol, unknown>)[Symbol.asyncIterator] === 'function';\n}\n\n/**\n * Wrap an async iterable (a provider stream) so each chunk is observed and a\n * finalizer runs once the stream is exhausted — without disturbing the stream's\n * other methods (`.tee()`, `.controller`, …), which are proxied through. If the\n * consumer abandons the stream early the finalizer still fires on `.return()`.\n */\nfunction instrumentStream<TChunk>(\n  stream: AsyncIterable<TChunk>,\n  onChunk: (chunk: TChunk) => void,\n  onDone: () => void,\n): AsyncIterable<TChunk> {\n  let finished = false;\n  const finish = () => {\n    if (finished) return;\n    finished = true;\n    onDone();\n  };\n  return new Proxy(stream, {\n    get(target, prop, recv) {\n      if (prop === Symbol.asyncIterator) {\n        return function instrumentedIterator() {\n          const inner = (target as AsyncIterable<TChunk>)[Symbol.asyncIterator]();\n          return {\n            async next(...a: []) {\n              const r = await inner.next(...a);\n              if (r.done) finish();\n              else onChunk(r.value);\n              return r;\n            },\n            async return(v?: unknown) {\n              finish();\n              return inner.return ? inner.return(v) : { done: true, value: v as TChunk };\n            },\n            async throw(e?: unknown) {\n              finish();\n              if (inner.throw) return inner.throw(e);\n              throw e;\n            },\n            [Symbol.asyncIterator]() {\n              return this;\n            },\n          };\n        };\n      }\n      return Reflect.get(target, prop, recv);\n    },\n  });\n}\n\n// --- Anthropic ------------------------------------------------------------\n\ninterface AnthropicUsage {\n  input_tokens?: number;\n  output_tokens?: number;\n  cache_read_input_tokens?: number;\n  // Cache CREATION (writes) bill above the input rate. Newer responses break the\n  // total down by TTL; older ones only return the aggregate cache_creation count.\n  cache_creation_input_tokens?: number;\n  cache_creation?: {\n    ephemeral_5m_input_tokens?: number;\n    ephemeral_1h_input_tokens?: number;\n  };\n}\ninterface AnthropicMessage {\n  id?: string;\n  model?: string;\n  usage?: AnthropicUsage;\n}\n// Streaming event shapes we read usage from (message_start carries inputs +\n// cache, message_delta carries the cumulative output token count).\ninterface AnthropicStreamEvent {\n  type?: string;\n  message?: AnthropicMessage;\n  usage?: AnthropicUsage;\n}\n\n/** Map a non-streaming Anthropic message to a track payload (or null if no usage). */\nexport function anthropicEventFrom(\n  msg: AnthropicMessage,\n  opts: InstrumentOptions,\n): TrackEventInput | null {\n  const usage = msg?.usage;\n  if (!usage) return null;\n  const runId = resolveRunId(opts, msg.id);\n  // Split cache-creation tokens by TTL when the response provides the breakdown;\n  // otherwise attribute the whole cache_creation total to the default 5-minute TTL.\n  const fivem = usage.cache_creation?.ephemeral_5m_input_tokens;\n  const oneh = usage.cache_creation?.ephemeral_1h_input_tokens;\n  const hasSplit = fivem !== undefined || oneh !== undefined;\n  const event: TrackEventInput = {\n    customerId: opts.customerId,\n    agentId: opts.agentId,\n    runId,\n    provider: opts.provider ?? 'anthropic',\n    model: msg.model ?? 'unknown',\n    tokensIn: usage.input_tokens ?? 0,\n    tokensOut: usage.output_tokens ?? 0,\n    cachedTokens: usage.cache_read_input_tokens ?? 0,\n    cacheWrite5mTokens: hasSplit ? fivem ?? 0 : usage.cache_creation_input_tokens ?? 0,\n    cacheWrite1hTokens: hasSplit ? oneh ?? 0 : 0,\n    revenueUnitCents: resolveRevenue(opts, msg),\n    idempotencyKey: msg.id ?? `${runId}#${randomId()}`,\n  };\n  return withCost(event, opts, msg);\n}\n\ninterface AnthropicLike {\n  messages: { create: (...args: never[]) => Promise<unknown> };\n}\n\n/** Wrap an Anthropic client so `messages.create` auto-reports usage (streaming\n *  and non-streaming). */\nexport function wrapAnthropic<T extends AnthropicLike>(\n  client: T,\n  tollgate: TollgateClient,\n  opts: InstrumentOptions,\n): T {\n  const messages = client.messages;\n  const original = messages.create.bind(messages) as (...a: never[]) => Promise<unknown>;\n\n  const create = async (...args: never[]): Promise<unknown> => {\n    const result = await original(...args);\n    if (isAsyncIterable(result)) {\n      // Reconstruct a message from the event stream, then reuse the non-stream\n      // mapper. input/cache tokens arrive in message_start; the final cumulative\n      // output token count arrives in the last message_delta.\n      const msg: AnthropicMessage = {};\n      return instrumentStream(\n        result as AsyncIterable<AnthropicStreamEvent>,\n        (ev) => {\n          if (ev.type === 'message_start' && ev.message) {\n            msg.id = ev.message.id;\n            msg.model = ev.message.model;\n            msg.usage = { ...ev.message.usage };\n          } else if (ev.type === 'message_delta' && ev.usage) {\n            msg.usage = { ...(msg.usage ?? {}), output_tokens: ev.usage.output_tokens };\n          }\n        },\n        () => {\n          const event = anthropicEventFrom(msg, opts);\n          if (event) fireAndForget(tollgate.track(event), opts.onError);\n        },\n      );\n    }\n    const event = anthropicEventFrom(result as AnthropicMessage, opts);\n    if (event) fireAndForget(tollgate.track(event), opts.onError);\n    return result;\n  };\n\n  return new Proxy(client, {\n    get(target, prop, recv) {\n      if (prop === 'messages') {\n        return new Proxy(messages, {\n          get: (m, p, r) => (p === 'create' ? create : Reflect.get(m, p, r)),\n        });\n      }\n      return Reflect.get(target, prop, recv);\n    },\n  });\n}\n\n// --- OpenAI (and OpenAI-compatible gateways) ------------------------------\n\ninterface OpenAIUsage {\n  prompt_tokens?: number;\n  completion_tokens?: number;\n  completion_tokens_details?: { reasoning_tokens?: number };\n  prompt_tokens_details?: { cached_tokens?: number };\n}\ninterface OpenAICompletion {\n  id?: string;\n  model?: string;\n  usage?: OpenAIUsage;\n}\n\n/** Map a non-streaming OpenAI chat completion to a track payload (or null). */\nexport function openAIEventFrom(\n  completion: OpenAICompletion,\n  opts: InstrumentOptions,\n): TrackEventInput | null {\n  const usage = completion?.usage;\n  if (!usage) return null;\n  const runId = resolveRunId(opts, completion.id);\n  const event: TrackEventInput = {\n    customerId: opts.customerId,\n    agentId: opts.agentId,\n    runId,\n    provider: opts.provider ?? 'openai',\n    model: completion.model ?? 'unknown',\n    tokensIn: usage.prompt_tokens ?? 0,\n    tokensOut: usage.completion_tokens ?? 0,\n    reasoningTokens: usage.completion_tokens_details?.reasoning_tokens ?? 0,\n    cachedTokens: usage.prompt_tokens_details?.cached_tokens ?? 0,\n    revenueUnitCents: resolveRevenue(opts, completion),\n    idempotencyKey: completion.id ?? `${runId}#${randomId()}`,\n  };\n  return withCost(event, opts, completion);\n}\n\ninterface OpenAILike {\n  chat: { completions: { create: (...args: never[]) => Promise<unknown> } };\n}\n\n/** Wrap an OpenAI (or OpenAI-compatible) client so `chat.completions.create`\n *  auto-reports usage. Streaming works when the caller sets\n *  `stream_options: { include_usage: true }` (required for OpenAI to emit a final\n *  usage chunk); without it there are no token counts to report and the call is\n *  passed through untouched. */\nexport function wrapOpenAI<T extends OpenAILike>(\n  client: T,\n  tollgate: TollgateClient,\n  opts: InstrumentOptions,\n): T {\n  const completions = client.chat.completions;\n  const original = completions.create.bind(completions) as (...a: never[]) => Promise<unknown>;\n\n  const create = async (...args: never[]): Promise<unknown> => {\n    const result = await original(...args);\n    if (isAsyncIterable(result)) {\n      let id: string | undefined;\n      let model: string | undefined;\n      let usage: OpenAIUsage | undefined;\n      return instrumentStream(\n        result as AsyncIterable<OpenAICompletion>,\n        (chunk) => {\n          if (chunk.id) id = chunk.id;\n          if (chunk.model) model = chunk.model;\n          if (chunk.usage) usage = chunk.usage; // only the final chunk carries it\n        },\n        () => {\n          if (!usage) return; // caller didn't request include_usage — nothing to report\n          const event = openAIEventFrom({ id, model, usage }, opts);\n          if (event) fireAndForget(tollgate.track(event), opts.onError);\n        },\n      );\n    }\n    const event = openAIEventFrom(result as OpenAICompletion, opts);\n    if (event) fireAndForget(tollgate.track(event), opts.onError);\n    return result;\n  };\n\n  return new Proxy(client, {\n    get(target, prop, recv) {\n      if (prop === 'chat') {\n        const chat = Reflect.get(target, prop, recv) as OpenAILike['chat'];\n        return new Proxy(chat, {\n          get: (c, p, r) =>\n            p === 'completions'\n              ? new Proxy(completions, {\n                  get: (co, pp, rr) => (pp === 'create' ? create : Reflect.get(co, pp, rr)),\n                })\n              : Reflect.get(c, p, r),\n        });\n      }\n      return Reflect.get(target, prop, recv);\n    },\n  });\n}\n\n// --- AWS Bedrock ----------------------------------------------------------\n// Bedrock's Converse API is command-based: the model id lives on the REQUEST,\n// not the response, so we read it from the command input. Usage is reported in\n// camelCase (inputTokens/outputTokens) plus optional cache token counts.\n\ninterface BedrockUsage {\n  inputTokens?: number;\n  outputTokens?: number;\n  cacheReadInputTokens?: number;\n  cacheWriteInputTokens?: number;\n}\ninterface BedrockConverseResponse {\n  usage?: BedrockUsage;\n  // ConverseStream returns an async-iterable `stream` of events; the final\n  // `metadata` event carries the usage totals.\n  stream?: AsyncIterable<{ metadata?: { usage?: BedrockUsage } }>;\n}\n\n/** Map a Bedrock Converse response (model from the request) to a track payload. */\nexport function bedrockEventFrom(\n  usage: BedrockUsage | undefined,\n  model: string,\n  opts: InstrumentOptions,\n  response: unknown = undefined,\n): TrackEventInput | null {\n  if (!usage) return null;\n  const runId = resolveRunId(opts, undefined);\n  const event: TrackEventInput = {\n    customerId: opts.customerId,\n    agentId: opts.agentId,\n    runId,\n    provider: opts.provider ?? 'bedrock',\n    model,\n    tokensIn: usage.inputTokens ?? 0,\n    tokensOut: usage.outputTokens ?? 0,\n    cachedTokens: usage.cacheReadInputTokens ?? 0,\n    cacheWrite5mTokens: usage.cacheWriteInputTokens ?? 0,\n    revenueUnitCents: resolveRevenue(opts, response),\n    idempotencyKey: `${runId}#${randomId()}`,\n  };\n  return withCost(event, opts, response);\n}\n\ninterface BedrockLike {\n  send: (command: unknown, ...rest: never[]) => Promise<unknown>;\n}\n\n/** Wrap a Bedrock Runtime client so `send(ConverseCommand)` /\n *  `send(ConverseStreamCommand)` auto-report usage. Non-Converse commands (no\n *  usage in the response) pass through untouched. */\nexport function wrapBedrock<T extends BedrockLike>(\n  client: T,\n  tollgate: TollgateClient,\n  opts: InstrumentOptions,\n): T {\n  const originalSend = client.send.bind(client) as BedrockLike['send'];\n\n  const send = async (command: unknown, ...rest: never[]): Promise<unknown> => {\n    const result = (await originalSend(command, ...rest)) as BedrockConverseResponse;\n    const model =\n      ((command as { input?: { modelId?: string } })?.input?.modelId) ?? 'unknown';\n\n    if (result?.stream && isAsyncIterable(result.stream)) {\n      let usage: BedrockUsage | undefined;\n      result.stream = instrumentStream(\n        result.stream,\n        (ev) => {\n          if (ev.metadata?.usage) usage = ev.metadata.usage;\n        },\n        () => {\n          const event = bedrockEventFrom(usage, model, opts, result);\n          if (event) fireAndForget(tollgate.track(event), opts.onError);\n        },\n      );\n      return result;\n    }\n\n    if (result?.usage) {\n      const event = bedrockEventFrom(result.usage, model, opts, result);\n      if (event) fireAndForget(tollgate.track(event), opts.onError);\n    }\n    return result;\n  };\n\n  return new Proxy(client, {\n    get(target, prop, recv) {\n      if (prop === 'send') return send;\n      return Reflect.get(target, prop, recv);\n    },\n  });\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tollgateai/sdk",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Track real LLM model usage and compute live gross margin with Tollgate.",
   "license": "UNLICENSED",
   "type": "module",