promptopskit 0.2.5 → 0.3.0

package/README.md

@@ -1,6 +1,7 @@
 # PromptOpsKit
 
 [![npm version](https://img.shields.io/npm/v/promptopskit.svg)](https://www.npmjs.com/package/promptopskit)
+[![CI](https://github.com/PredictabilityAtScale/promptopskit/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/PredictabilityAtScale/promptopskit/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org)
 
@@ -63,7 +64,8 @@ sampling:
 context:
   inputs:
     - user_message
-    - app_context
+    - name: app_context
+      max_size: 2000
 includes:
   - ./shared/tone.md
 ---
@@ -104,6 +106,19 @@ const response = await fetch('https://api.openai.com/v1/chat/completions', {
 });
 ```
 
+You can control context size warning behavior at the kit level:
+
+```typescript
+const kit = createPromptOpsKit({
+  sourceDir: './prompts',
+  warnings: {
+    contextSize: process.env.NODE_ENV === 'production' ? 'off' : 'console-and-result',
+  },
+});
+```
+
+Supported values for `warnings.contextSize` are `auto`, `off`, `result-only`, `console`, and `console-and-result`.
+
 ## Features
 
 - **Prompts as Markdown** — YAML front matter for settings, H1 headings for sections (`# System instructions`, `# Prompt template`, `# Notes`)
@@ -113,6 +128,8 @@ const response = await fetch('https://api.openai.com/v1/chat/completions', {
 - **Overrides** — Environment and tier-based overrides (base → env → tier → runtime)
 - **4 provider adapters** — OpenAI, Anthropic, Gemini, OpenRouter — body-only output
 - **Validation** — Zod schema validation, Levenshtein-based "did you mean?" for typos, variable usage checks
+- **Context size guardrails** — optional per-input `max_size` metadata with non-blocking render-time warnings
+- **Warning controls** — top-level config can suppress or emit context size warnings differently in dev and prod
 - **Caching** — LRU cache with mtime-based invalidation
 - **CLI** — init, validate, compile, render, inspect, skill
 - **Compiled artifacts** — Pre-compile `.md` → JSON or ESM for production
@@ -165,6 +182,71 @@ import { geminiAdapter } from 'promptopskit/gemini';
 import { openrouterAdapter } from 'promptopskit/openrouter';
 ```
 
+## Optional UsageTap Tracking
+
+PromptOpsKit can also help you track provider calls with UsageTap.com while keeping the core render API body-only.
+
+```typescript
+import { createPromptOpsKit } from 'promptopskit';
+import { createUsageTapClient, runOpenAIWithUsageTap } from 'promptopskit/usagetap';
+
+const kit = createPromptOpsKit({ sourceDir: './prompts' });
+const usageTap = createUsageTapClient({ apiKey: process.env.USAGETAP_API_KEY! });
+
+const { request } = await kit.renderPrompt({
+  path: 'support/reply',
+  provider: 'openai',
+  variables: {
+    user_message: 'How do I reset my password?',
+    app_context: 'Account settings page',
+  },
+});
+
+const tracked = await runOpenAIWithUsageTap(usageTap, {
+  begin: {
+    customerId: 'user_123',
+    feature: 'chat.send',
+    requested: { standard: true, premium: true, search: true },
+    idempotencyKey: 'chat-send-user-123-req-456',
+  },
+  request,
+  entitlementMode: 'apply',
+  modelTiers: {
+    standard: 'gpt-5.4-mini',
+    premium: 'gpt-5.4',
+  },
+  toolEntitlements: {
+    image_tool: 'image',
+    web_lookup: 'search',
+  },
+  invoke: async (requestUsed) => {
+    const response = await fetch('https://api.openai.com/v1/chat/completions', {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${process.env.OPENAI_API_KEY}`,
+      },
+      body: JSON.stringify(requestUsed.body),
+    });
+
+    return response.json();
+  },
+});
+
+// tracked.response      -> vendor JSON response
+// tracked.begin         -> UsageTap call_begin payload
+// tracked.end           -> UsageTap call_end payload
+// tracked.requestUsed   -> effective request after optional entitlement changes
+// tracked.effectiveUsage -> usage sent to UsageTap
+```
+
+Notes:
+- `entitlementMode` defaults to `'off'`. Set it to `'apply'` only when you want UsageTap allowances to mutate a cloned provider request.
+- `runOpenRouterWithUsageTap`, `runAnthropicWithUsageTap`, and `runGeminiWithUsageTap` follow the same pattern.
+- `extractOpenAIUsage`, `extractAnthropicUsage`, and `extractGeminiUsage` are public if you want to manage UsageTap lifecycle yourself.
+
+For explicit lifecycle control, use `beginUsageTapCall`, `endUsageTapCall`, or `withUsageTapCall` from `promptopskit/usagetap`. Full documentation: [docs/usagetap.md](./docs/usagetap.md).
+
 ## Overrides
 
 Define environment and tier overrides in front matter. Precedence: **base → environment → tier → runtime**. Scalars and arrays are replaced, not merged.
@@ -333,6 +415,7 @@ Creates a `PromptOpsKit` instance.
 | `compiledDir` | `string` | — | Path to compiled artifacts |
 | `mode` | `'auto' \| 'compiled-only' \| 'source-only'` | `'auto'` | Resolution strategy |
 | `cache` | `boolean` | `true` | Enable LRU cache with mtime invalidation |
+| `warnings.contextSize` | `'auto' \| 'off' \| 'result-only' \| 'console' \| 'console-and-result'` | `'auto'` | Control whether render-time context size warnings are returned, logged, both, or suppressed |
 
 ### `kit.renderPrompt(options)`
 
@@ -347,6 +430,7 @@ Renders a prompt for a specific provider. Returns `{ resolved, request, warnings
 | `environment` | `string` | Environment override name |
 | `tier` | `string` | Tier override name |
 | `history` | `Array<{ role, content }>` | Conversation history |
+| `toolRegistry` | `Record<string, unknown>` | Tool definitions for resolving string tool references |
 | `strict` | `boolean` | Fail on missing variables |
 
 ### `kit.loadPrompt(path)` / `kit.resolvePrompt(path, options)` / `kit.validatePrompt(path)`
@@ -375,7 +459,7 @@ Prompt files use YAML front matter with these fields:
 | `response` | `object` | `{ format, stream }` |
 | `tools` | `array` | Tool references (string names or inline definitions) |
 | `mcp` | `object` | MCP server references |
-| `context` | `object` | `{ inputs, history }` — declare expected variables |
+| `context` | `object` | `{ inputs, history }` — declare expected variables, with optional per-input `max_size` budgets |
 | `includes` | `string[]` | Paths to included prompt files |
 | `environments` | `object` | Named environment overrides |
 | `tiers` | `object` | Named tier overrides |

package/SKILL.md

@@ -29,7 +29,8 @@ provider: openai
 model: gpt-5.4
 context:
   inputs:
-    - name
+    - name: name
+      max_size: 2000
 ---
 
 # System instructions
@@ -65,7 +66,7 @@ the fields required by that specific file:
 | `response` | object | no | `{ format: text|json|markdown, stream: boolean }` |
 | `tools` | array | no | Tool names (strings) or inline definitions with `{ name, description, input_schema }` |
 | `mcp` | object | no | `{ servers: [string | { name, config }] }` |
-| `context.inputs` | string[] | no | Declared variable names used in templates |
+| `context.inputs` | `Array<string | { name, max_size? }>` | no | Declared variable names used in templates, with optional size budgets |
 | `context.history` | object | no | `{ max_items: number }` |
 | `includes` | string[] | no | Relative paths to other prompt files to include |
 | `environments` | object | no | Per-environment overrides (see Overrides) |
@@ -98,10 +99,23 @@ Rules:
 - Declare all variables in `context.inputs` — validation warns on undeclared usage
 - Before finishing a new prompt file, scan the body for every `{{ variable }}` and
   ensure each exact variable name appears in `context.inputs`
+- Use object-form inputs with `max_size` when a variable is likely to grow large and should trigger early warnings
 - Escape literal braces with `\{{` and `\}}`
 - In strict mode, missing variables throw an error
 - In permissive mode, unresolved placeholders are left intact
 
+Example with a size budget:
+
+```yaml
+context:
+  inputs:
+    - user_message
+    - name: account_summary
+      max_size: 4096
+```
+
+If a rendered value exceeds `max_size`, `renderPrompt()` emits a non-blocking `POK030` warning.
+
 Example: this is the minimal valid shape for a prompt that references
 `{{ pull_request }}` even when provider/model are inherited from defaults:
 
@@ -238,19 +252,32 @@ import { createPromptOpsKit } from 'promptopskit';
 const kit = createPromptOpsKit({ sourceDir: './prompts' });
 
 // Load → resolve includes → apply overrides → render
-const request = await kit.renderPrompt('greeting', {
+const result = await kit.renderPrompt({
+  path: 'greeting',
+  provider: 'openai',
   variables: { name: 'Alice' },
   environment: 'production',
 });
 
-// request.body is ready for the provider's API
+// result.request.body is ready for the provider's API
 const response = await fetch('https://api.openai.com/v1/chat/completions', {
   method: 'POST',
   headers: {
     'Content-Type': 'application/json',
     Authorization: `Bearer ${apiKey}`,
   },
-  body: JSON.stringify(request.body),
+  body: JSON.stringify(result.request.body),
+});
+```
+
+You can control render-time context size warnings at the top level:
+
+```typescript
+const kit = createPromptOpsKit({
+  sourceDir: './prompts',
+  warnings: {
+    contextSize: process.env.NODE_ENV === 'production' ? 'off' : 'console-and-result',
+  },
 });
 ```
 
@@ -307,7 +334,7 @@ const asset = parsePrompt(source);
 const result = validateAsset(asset);
 
 if (!result.valid) {
-  console.error(result.errors); // Error codes: POK001-POK021
+  console.error(result.errors); // Validation error codes: POK001-POK021
 }
 ```
 

package/dist/{chunk-CX6KVBW4.js → chunk-2LK6IILW.js}

@@ -32,8 +32,16 @@ var ResponseSchema = z.object({
 var HistorySchema = z.object({
   max_items: z.number().int().positive().optional()
 });
+var ContextInputDefinitionObjectSchema = z.object({
+  name: z.string(),
+  max_size: z.number().int().positive().optional()
+});
+var ContextInputDefinitionSchema = z.union([
+  z.string(),
+  ContextInputDefinitionObjectSchema
+]);
 var ContextSchema = z.object({
-  inputs: z.array(z.string()).optional(),
+  inputs: z.array(ContextInputDefinitionSchema).optional(),
   history: HistorySchema.optional()
 });
 var MetadataSchema = z.object({
@@ -250,4 +258,4 @@ export {
   parsePrompt,
   loadPromptFile
 };
-//# sourceMappingURL=chunk-CX6KVBW4.js.map
+//# sourceMappingURL=chunk-2LK6IILW.js.map

package/dist/chunk-2LK6IILW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema/schema.ts","../src/parser/sections.ts","../src/parser/parser.ts","../src/parser/loader.ts"],"sourcesContent":["import { z } from 'zod';\n\n// --- Tool definitions ---\n\nexport const InlineToolDefSchema = z.object({\n  name: z.string(),\n  description: z.string().optional(),\n  input_schema: z.record(z.unknown()).optional(),\n});\n\nexport type InlineToolDef = z.infer<typeof InlineToolDefSchema>;\n\nexport const ToolRefSchema = z.union([z.string(), InlineToolDefSchema]);\n\n// --- MCP ---\n\nexport const MCPServerRefSchema = z.union([\n  z.string(),\n  z.object({\n    name: z.string(),\n    config: z.record(z.unknown()).optional(),\n  }),\n]);\n\nexport type MCPServerRef = z.infer<typeof MCPServerRefSchema>;\n\n// --- Reasoning ---\n\nexport const ReasoningSchema = z.object({\n  effort: z.enum(['low', 'medium', 'high']).optional(),\n  budget_tokens: z.number().int().positive().optional(),\n});\n\n// --- Sampling ---\n\nexport const SamplingSchema = z.object({\n  temperature: z.number().min(0).max(2).optional(),\n  top_p: z.number().min(0).max(1).optional(),\n  frequency_penalty: z.number().optional(),\n  presence_penalty: z.number().optional(),\n  stop: z.array(z.string()).optional(),\n  max_output_tokens: z.number().int().positive().optional(),\n});\n\n// --- Response ---\n\nexport const ResponseSchema = z.object({\n  format: z.enum(['text', 'json', 'markdown']).optional(),\n  stream: z.boolean().optional(),\n});\n\n// --- Context ---\n\nexport const HistorySchema = z.object({\n  max_items: z.number().int().positive().optional(),\n});\n\nexport const ContextInputDefinitionObjectSchema = z.object({\n  name: z.string(),\n  max_size: z.number().int().positive().optional(),\n});\n\nexport const ContextInputDefinitionSchema = z.union([\n  z.string(),\n  ContextInputDefinitionObjectSchema,\n]);\n\nexport type ContextInputDefinition = z.infer<typeof ContextInputDefinitionSchema>;\n\nexport const ContextSchema = z.object({\n  inputs: z.array(ContextInputDefinitionSchema).optional(),\n  history: HistorySchema.optional(),\n});\n\n// --- Metadata ---\n\nexport const MetadataSchema = z.object({\n  owner: z.string().optional(),\n  tags: z.array(z.string()).optional(),\n  review_required: z.boolean().optional(),\n  stable: z.boolean().optional(),\n});\n\n// --- MCP block ---\n\nexport const MCPSchema = z.object({\n  servers: z.array(MCPServerRefSchema).optional(),\n});\n\n// --- Overrides (subset allowed in environments/tiers) ---\n\nexport const PromptAssetOverridesSchema = z.object({\n  model: z.string().optional(),\n  fallback_models: z.array(z.string()).optional(),\n  reasoning: ReasoningSchema.optional(),\n  sampling: SamplingSchema.optional(),\n  response: ResponseSchema.optional(),\n  tools: z.array(ToolRefSchema).optional(),\n});\n\nexport type PromptAssetOverrides = z.infer<typeof PromptAssetOverridesSchema>;\n\n// --- Source tracking ---\n\nexport const SourceSchema = z.object({\n  file_path: z.string().optional(),\n  checksum: z.string().optional(),\n});\n\n// --- Sections (populated by parser) ---\n\nexport const SectionsSchema = z.object({\n  system_instructions: z.string().optional(),\n  prompt_template: z.string().optional(),\n  notes: z.string().optional(),\n});\n\n// --- Defaults files (folder-level inheritance) ---\n\nexport const PromptDefaultsSchema = z.object({\n  provider: z.enum(['openai', 'anthropic', 'google', 'gemini', 'openrouter', 'any']).optional(),\n  model: z.string().optional(),\n  metadata: MetadataSchema.optional(),\n  sections: z.object({\n    system_instructions: z.string().optional(),\n  }).optional(),\n});\n\nexport type PromptDefaults = z.infer<typeof PromptDefaultsSchema>;\n\n// --- Top-level PromptAsset ---\n\nexport const PromptAssetSchema = z.object({\n  id: z.string(),\n  schema_version: z.number().int().positive().default(1),\n  description: z.string().optional(),\n\n  provider: z.enum(['openai', 'anthropic', 'google', 'gemini', 'openrouter', 'any']).optional(),\n  model: z.string().optional(),\n  fallback_models: z.array(z.string()).optional(),\n\n  reasoning: ReasoningSchema.optional(),\n  sampling: SamplingSchema.optional(),\n  response: ResponseSchema.optional(),\n\n  tools: z.array(ToolRefSchema).optional(),\n  mcp: MCPSchema.optional(),\n\n  context: ContextSchema.optional(),\n\n  includes: z.array(z.string()).optional(),\n\n  environments: z.record(PromptAssetOverridesSchema).optional(),\n  tiers: z.record(PromptAssetOverridesSchema).optional(),\n\n  metadata: MetadataSchema.optional(),\n\n  // Populated by parser, not authored in YAML\n  sections: SectionsSchema.optional(),\n  source: SourceSchema.optional(),\n});\n\nexport type PromptAsset = z.infer<typeof PromptAssetSchema>;\n\n// --- Resolved asset (after includes, overrides applied) ---\n\nexport interface ResolvedPromptAsset extends PromptAsset {\n  sections: {\n    system_instructions?: string;\n    prompt_template?: string;\n    notes?: string;\n  };\n  source: {\n    file_path?: string;\n    checksum?: string;\n  };\n}\n","export interface Sections {\n  system_instructions?: string;\n  prompt_template?: string;\n  notes?: string;\n}\n\nconst SECTION_MAP: Record<string, keyof Sections> = {\n  'system instructions': 'system_instructions',\n  'prompt template': 'prompt_template',\n  'notes': 'notes',\n};\n\n/**\n * Extract named sections from the markdown body using H1 headings.\n * Case-insensitive. H2+ within a section is treated as content.\n * If no H1 headings are found, the entire body is treated as prompt_template.\n */\nexport function extractSections(body: string): Sections {\n  const lines = body.split(/\\r?\\n/);\n  const sections: Sections = {};\n\n  let currentKey: keyof Sections | null = null;\n  let currentLines: string[] = [];\n  let foundAnyH1 = false;\n\n  for (const line of lines) {\n    const h1Match = line.match(/^#\\s+(.+)$/);\n    if (h1Match) {\n      // Flush previous section\n      if (currentKey) {\n        sections[currentKey] = currentLines.join('\\n').trim();\n      }\n\n      foundAnyH1 = true;\n      const heading = h1Match[1].trim().toLowerCase();\n      currentKey = SECTION_MAP[heading] ?? null;\n      currentLines = [];\n    } else {\n      currentLines.push(line);\n    }\n  }\n\n  // Flush last section\n  if (currentKey) {\n    sections[currentKey] = currentLines.join('\\n').trim();\n  }\n\n  // If no H1 headings found, treat entire body as prompt_template\n  if (!foundAnyH1) {\n    const trimmed = body.trim();\n    if (trimmed) {\n      sections.prompt_template = trimmed;\n    }\n  }\n\n  return sections;\n}\n","import matter from 'gray-matter';\nimport { PromptAssetSchema } from '../schema/index.js';\nimport type { PromptAsset } from '../schema/index.js';\nimport { extractSections } from './sections.js';\n\nexport interface ParseResult {\n  asset: PromptAsset;\n  raw: {\n    frontMatter: Record<string, unknown>;\n    body: string;\n  };\n}\n\n/**\n * Parse a prompt markdown string (YAML front matter + markdown body)\n * into a validated PromptAsset.\n */\nexport function parsePrompt(content: string, filePath?: string): ParseResult {\n  const { data: frontMatter, content: body } = matter(content);\n\n  const sections = extractSections(body);\n\n  const raw = {\n    ...frontMatter,\n    sections,\n    source: filePath ? { file_path: filePath } : undefined,\n  };\n\n  const asset = PromptAssetSchema.parse(raw);\n\n  return {\n    asset,\n    raw: {\n      frontMatter: frontMatter as Record<string, unknown>,\n      body,\n    },\n  };\n}\n","import { readFile } from 'node:fs/promises';\nimport { dirname, join, resolve } from 'node:path';\nimport matter from 'gray-matter';\nimport { parsePrompt } from './parser.js';\nimport type { ParseResult } from './parser.js';\nimport { extractSections } from './sections.js';\nimport { PromptDefaultsSchema } from '../schema/index.js';\nimport type { PromptDefaults } from '../schema/index.js';\n\nconst DEFAULTS_FILE_NAME = 'defaults.md';\n\nexport interface LoadPromptOptions {\n  /**\n   * Optional boundary directory for defaults discovery.\n   * If provided, defaults are loaded from this directory down to the prompt directory.\n   */\n  defaultsRoot?: string;\n}\n\n/**\n * Load and parse a prompt file from disk.\n */\nexport async function loadPromptFile(filePath: string, options: LoadPromptOptions = {}): Promise<ParseResult> {\n  const content = await readFile(filePath, 'utf-8');\n  const parsed = parsePrompt(content, filePath);\n  // Default the boundary to the file's own directory so traversal never\n  // walks above the prompt tree when no explicit root is provided.\n  const root = options.defaultsRoot ?? dirname(filePath);\n  const defaults = await loadDefaultsForPath(filePath, root);\n  const asset = applyDefaults(parsed.asset, defaults);\n\n  return {\n    ...parsed,\n    asset,\n  };\n}\n\nasync function loadDefaultsForPath(filePath: string, defaultsRoot?: string): Promise<PromptDefaults> {\n  const directories = getDirectoriesToCheck(filePath, defaultsRoot);\n  let merged: PromptDefaults = {};\n\n  for (const dir of directories) {\n    const defaultsPath = join(dir, DEFAULTS_FILE_NAME);\n    try {\n      const defaultsContent = await readFile(defaultsPath, 'utf-8');\n      const defaults = parseDefaults(defaultsContent);\n      merged = mergeDefaults(merged, defaults);\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {\n        throw error;\n      }\n    }\n  }\n\n  return merged;\n}\n\nfunction getDirectoriesToCheck(filePath: string, defaultsRoot?: string): string[] {\n  const dirs: string[] = [];\n  let current = resolve(dirname(filePath));\n  const boundary = defaultsRoot ? resolve(defaultsRoot) : undefined;\n\n  while (true) {\n    dirs.unshift(current);\n    if ((boundary && current === boundary) || current === dirname(current)) {\n      break;\n    }\n    current = dirname(current);\n  }\n\n  return dirs;\n}\n\nfunction parseDefaults(content: string): PromptDefaults {\n  const { data: frontMatter, content: body } = matter(content);\n  const sections = extractSections(body);\n\n  return PromptDefaultsSchema.parse({\n    ...frontMatter,\n    sections: {\n      system_instructions: sections.system_instructions,\n    },\n  });\n}\n\nfunction mergeDefaults(base: PromptDefaults, local: PromptDefaults): PromptDefaults {\n  return {\n    provider: local.provider ?? base.provider,\n    model: local.model ?? base.model,\n    metadata: {\n      ...(base.metadata ?? {}),\n      ...(local.metadata ?? {}),\n    },\n    sections: {\n      ...(base.sections ?? {}),\n      ...(local.sections ?? {}),\n    },\n  };\n}\n\nfunction applyDefaults(asset: ParseResult['asset'], defaults: PromptDefaults): ParseResult['asset'] {\n  const hasDefaultMetadata = defaults.metadata && Object.keys(defaults.metadata).length > 0;\n  const hasDefaultSystem = !!defaults.sections?.system_instructions;\n  const hasDefaultScalars = defaults.provider !== undefined\n    || defaults.model !== undefined;\n\n  // Short-circuit: nothing to merge\n  if (!hasDefaultMetadata && !hasDefaultSystem && !hasDefaultScalars) {\n    return asset;\n  }\n\n  const mergedMetadata = {\n    ...(defaults.metadata ?? {}),\n    ...(asset.metadata ?? {}),\n  };\n  const metadata = Object.keys(mergedMetadata).length > 0 ? mergedMetadata : undefined;\n\n  const systemInstructions = asset.sections?.system_instructions ?? defaults.sections?.system_instructions;\n\n  const sections = asset.sections\n    ? { ...asset.sections, system_instructions: systemInstructions }\n    : systemInstructions\n      ? { system_instructions: systemInstructions }\n      : undefined;\n\n  return {\n    ...asset,\n    provider: asset.provider ?? defaults.provider,\n    model: asset.model ?? defaults.model,\n    metadata,\n    sections,\n  };\n}\n"],"mappings":"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","names":["matter","matter"]}

package/dist/chunk-HWEVRBKZ.js

@@ -0,0 +1,387 @@
+// src/usagetap/client.ts
+var DEFAULT_BASE_URL = "https://api.usagetap.com";
+var ACCEPT_HEADER = "application/vnd.usagetap.v1+json";
+function createUsageTapHttpError(status, body) {
+  const error = new Error(`UsageTap request failed with status ${status}`);
+  error.statusCode = status;
+  error.body = body;
+  return error;
+}
+function createUsageTapClient(config) {
+  const fetchImpl = config.fetch ?? globalThis.fetch;
+  if (!fetchImpl) {
+    throw new Error("Fetch API is not available. Provide config.fetch when creating the UsageTap client.");
+  }
+  const baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+  async function request(path, body, init = {}) {
+    const response = await fetchImpl(`${baseUrl}${path}`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${config.apiKey}`,
+        Accept: ACCEPT_HEADER,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body),
+      signal: init.signal
+    });
+    const text = await response.text();
+    const parsed = text ? JSON.parse(text) : {};
+    if (!response.ok) {
+      throw createUsageTapHttpError(response.status, parsed);
+    }
+    return parsed;
+  }
+  return {
+    request,
+    beginCall(begin, init) {
+      return request("/call_begin", begin, init);
+    },
+    endCall(end, init) {
+      return request("/call_end", end, init);
+    }
+  };
+}
+
+// src/usagetap/lifecycle.ts
+function isObject(value) {
+  return typeof value === "object" && value !== null;
+}
+function isInvokeResult(value) {
+  return isObject(value) && "result" in value && "usage" in value;
+}
+function getErrorStatusCode(error) {
+  if (!isObject(error)) {
+    return void 0;
+  }
+  if (typeof error.statusCode === "number") {
+    return error.statusCode;
+  }
+  if (typeof error.status === "number") {
+    return error.status;
+  }
+  if (isObject(error.response) && typeof error.response.status === "number") {
+    return error.response.status;
+  }
+  return void 0;
+}
+function attachEndErrorCause(thrownError, endError) {
+  if (thrownError instanceof Error) {
+    if (thrownError.cause === void 0) {
+      Object.defineProperty(thrownError, "cause", {
+        value: endError,
+        configurable: true,
+        writable: true
+      });
+    }
+    throw thrownError;
+  }
+  throw new AggregateError([thrownError, endError], "Vendor call failed and UsageTap call_end also failed.");
+}
+function defaultUsageTapErrorMapper(error) {
+  return {
+    code: "VENDOR_ERROR",
+    message: String(error)
+  };
+}
+function beginUsageTapCall(client, begin, init) {
+  return client.beginCall(begin, init);
+}
+function endUsageTapCall(client, end, init) {
+  return client.endCall(end, init);
+}
+async function withUsageTapCall(client, options) {
+  const begin = await beginUsageTapCall(client, options.begin, { signal: options.signal });
+  const onError = options.onError ?? defaultUsageTapErrorMapper;
+  let result;
+  let usage;
+  let thrownError;
+  const setUsage = (nextUsage) => {
+    usage = { ...usage, ...nextUsage };
+  };
+  try {
+    const invoked = await options.invoke({
+      begin,
+      setUsage,
+      signal: options.signal
+    });
+    if (isInvokeResult(invoked)) {
+      result = invoked.result;
+      setUsage(invoked.usage);
+    } else {
+      result = invoked;
+    }
+  } catch (error) {
+    thrownError = error;
+  }
+  const effectiveUsage = {
+    ...usage
+  };
+  if (thrownError) {
+    effectiveUsage.error = effectiveUsage.error ?? onError(thrownError);
+    effectiveUsage.responseStatusCode = effectiveUsage.responseStatusCode ?? getErrorStatusCode(thrownError);
+  } else {
+    effectiveUsage.responseStatusCode = effectiveUsage.responseStatusCode ?? 200;
+  }
+  let end;
+  try {
+    end = await endUsageTapCall(client, {
+      callId: begin.data.callId,
+      ...effectiveUsage
+    }, { signal: options.signal });
+  } catch (endError) {
+    if (thrownError) {
+      attachEndErrorCause(thrownError, endError);
+    }
+    throw endError;
+  }
+  if (thrownError) {
+    throw thrownError;
+  }
+  return {
+    result,
+    begin,
+    end,
+    effectiveUsage
+  };
+}
+
+// src/usagetap/providers.ts
+function cloneRequest(request) {
+  return structuredClone(request);
+}
+function isObject2(value) {
+  return typeof value === "object" && value !== null;
+}
+function isRecordArray(value) {
+  return Array.isArray(value) && value.every((item) => isObject2(item));
+}
+function isInvokeResult2(value) {
+  return isObject2(value) && "result" in value && "usage" in value;
+}
+function capabilityAllowed(allowed, capability) {
+  return allowed[capability] !== false;
+}
+function reasoningLevelOrder(level) {
+  switch (level) {
+    case "HIGH":
+      return 3;
+    case "MEDIUM":
+      return 2;
+    case "LOW":
+      return 1;
+    default:
+      return 0;
+  }
+}
+function capOpenAIReasoning(body, allowed) {
+  if (typeof body.reasoning_effort !== "string") {
+    return;
+  }
+  const current = String(body.reasoning_effort).toUpperCase();
+  const allowedLevel = allowed.reasoningLevel ?? "HIGH";
+  if (allowedLevel === "NONE") {
+    delete body.reasoning_effort;
+    return;
+  }
+  if (reasoningLevelOrder(current) > reasoningLevelOrder(allowedLevel)) {
+    body.reasoning_effort = allowedLevel.toLowerCase();
+  }
+}
+function capGeminiReasoning(body, allowed) {
+  if (allowed.reasoningLevel === "NONE") {
+    delete body.thinkingConfig;
+    return;
+  }
+  const budgets = {
+    LOW: 1024,
+    MEDIUM: 4096,
+    HIGH: 8192
+  };
+  const allowedBudget = allowed.reasoningLevel ? budgets[allowed.reasoningLevel] : void 0;
+  if (allowedBudget === void 0) {
+    return;
+  }
+  if (!isObject2(body.thinkingConfig)) {
+    body.thinkingConfig = { thinkingBudget: allowedBudget };
+    return;
+  }
+  const thinkingConfig = body.thinkingConfig;
+  if (typeof thinkingConfig.thinkingBudget === "number") {
+    thinkingConfig.thinkingBudget = Math.min(thinkingConfig.thinkingBudget, allowedBudget);
+    return;
+  }
+  thinkingConfig.thinkingBudget = allowedBudget;
+}
+function applyModelTier(request, allowed, options) {
+  const nextModel = allowed.premium && options.modelTiers?.premium ? options.modelTiers.premium : allowed.standard && options.modelTiers?.standard ? options.modelTiers.standard : void 0;
+  if (!nextModel) {
+    return;
+  }
+  request.model = nextModel;
+  if (isObject2(request.body) && "model" in request.body) {
+    request.body.model = nextModel;
+  }
+}
+function filterOpenAITools(tools, allowed, options) {
+  return tools.filter((tool) => {
+    if (tool.type === "web_search" && allowed.search === false) {
+      return false;
+    }
+    const functionDef = isObject2(tool.function) ? tool.function : void 0;
+    const name = typeof functionDef?.name === "string" ? functionDef.name : typeof tool.name === "string" ? tool.name : typeof tool.type === "string" ? tool.type : void 0;
+    if (!name) {
+      return true;
+    }
+    const capability = options.toolEntitlements?.[name];
+    return capability ? capabilityAllowed(allowed, capability) : true;
+  });
+}
+function filterAnthropicTools(tools, allowed, options) {
+  return tools.filter((tool) => {
+    const name = typeof tool.name === "string" ? tool.name : void 0;
+    if (!name) {
+      return true;
+    }
+    const capability = options.toolEntitlements?.[name];
+    return capability ? capabilityAllowed(allowed, capability) : true;
+  });
+}
+function filterGeminiTools(tools, allowed, options) {
+  return tools.map((tool) => {
+    const declarations = Array.isArray(tool.functionDeclarations) ? tool.functionDeclarations.filter((declaration) => {
+      if (!isObject2(declaration) || typeof declaration.name !== "string") {
+        return true;
+      }
+      const capability = options.toolEntitlements?.[declaration.name];
+      return capability ? capabilityAllowed(allowed, capability) : true;
+    }) : tool.functionDeclarations;
+    return {
+      ...tool,
+      functionDeclarations: declarations
+    };
+  }).filter((tool) => {
+    if (!Array.isArray(tool.functionDeclarations)) {
+      return true;
+    }
+    return tool.functionDeclarations.length > 0;
+  });
+}
+function applyUsageTapEntitlements(request, begin, options = {}) {
+  const nextRequest = cloneRequest(request);
+  const allowed = begin.data.allowed ?? {};
+  applyModelTier(nextRequest, allowed, options);
+  if (!isObject2(nextRequest.body)) {
+    return nextRequest;
+  }
+  if (nextRequest.provider === "openai" || nextRequest.provider === "openrouter") {
+    capOpenAIReasoning(nextRequest.body, allowed);
+    if (isRecordArray(nextRequest.body.tools)) {
+      nextRequest.body.tools = filterOpenAITools(nextRequest.body.tools, allowed, options);
+    }
+    return nextRequest;
+  }
+  if (nextRequest.provider === "gemini") {
+    capGeminiReasoning(nextRequest.body, allowed);
+    if (isRecordArray(nextRequest.body.tools)) {
+      nextRequest.body.tools = filterGeminiTools(nextRequest.body.tools, allowed, options);
+    }
+    return nextRequest;
+  }
+  if (nextRequest.provider === "anthropic" && isRecordArray(nextRequest.body.tools)) {
+    nextRequest.body.tools = filterAnthropicTools(nextRequest.body.tools, allowed, options);
+  }
+  return nextRequest;
+}
+function extractOpenAIUsage(response, meta = {}) {
+  const usage = isObject2(response) && isObject2(response.usage) ? response.usage : {};
+  const promptDetails = isObject2(usage.prompt_tokens_details) ? usage.prompt_tokens_details : {};
+  const completionDetails = isObject2(usage.completion_tokens_details) ? usage.completion_tokens_details : {};
+  return {
+    modelUsed: meta.modelUsed,
+    inputTokens: typeof usage.prompt_tokens === "number" ? usage.prompt_tokens : 0,
+    responseTokens: typeof usage.completion_tokens === "number" ? usage.completion_tokens : 0,
+    cachedInputTokens: typeof promptDetails.cached_tokens === "number" ? promptDetails.cached_tokens : void 0,
+    reasoningTokens: typeof completionDetails.reasoning_tokens === "number" ? completionDetails.reasoning_tokens : void 0,
+    responseStatusCode: meta.responseStatusCode ?? 200
+  };
+}
+function extractAnthropicUsage(response, meta = {}) {
+  const usage = isObject2(response) && isObject2(response.usage) ? response.usage : {};
+  return {
+    modelUsed: meta.modelUsed,
+    inputTokens: typeof usage.input_tokens === "number" ? usage.input_tokens : 0,
+    responseTokens: typeof usage.output_tokens === "number" ? usage.output_tokens : 0,
+    cachedInputTokens: typeof usage.cache_read_input_tokens === "number" ? usage.cache_read_input_tokens : void 0,
+    responseStatusCode: meta.responseStatusCode ?? 200
+  };
+}
+function extractGeminiUsage(response, meta = {}) {
+  const usage = isObject2(response) && isObject2(response.usageMetadata) ? response.usageMetadata : {};
+  return {
+    modelUsed: meta.modelUsed,
+    inputTokens: typeof usage.promptTokenCount === "number" ? usage.promptTokenCount : 0,
+    responseTokens: typeof usage.candidatesTokenCount === "number" ? usage.candidatesTokenCount : 0,
+    cachedInputTokens: typeof usage.cachedContentTokenCount === "number" ? usage.cachedContentTokenCount : void 0,
+    reasoningTokens: typeof usage.thoughtsTokenCount === "number" ? usage.thoughtsTokenCount : void 0,
+    responseStatusCode: meta.responseStatusCode ?? 200
+  };
+}
+async function runProviderWithUsageTap(client, options, defaultExtractor) {
+  let requestUsed = cloneRequest(options.request);
+  const lifecycle = await withUsageTapCall(client, {
+    begin: options.begin,
+    signal: options.signal,
+    onError: options.onError ?? defaultUsageTapErrorMapper,
+    invoke: async ({ begin, setUsage }) => {
+      requestUsed = options.entitlementMode === "apply" ? applyUsageTapEntitlements(options.request, begin, options) : cloneRequest(options.request);
+      const invoked = await options.invoke(requestUsed);
+      if (isInvokeResult2(invoked)) {
+        return invoked;
+      }
+      const response = invoked;
+      const usage = (options.extractUsage ?? defaultExtractor)(response, {
+        modelUsed: requestUsed.model,
+        responseStatusCode: 200
+      });
+      setUsage(usage);
+      return response;
+    }
+  });
+  return {
+    response: lifecycle.result,
+    begin: lifecycle.begin,
+    end: lifecycle.end,
+    requestUsed,
+    effectiveUsage: lifecycle.effectiveUsage,
+    allowed: lifecycle.begin.data.allowed ?? {}
+  };
+}
+function runOpenAIWithUsageTap(client, options) {
+  return runProviderWithUsageTap(client, options, extractOpenAIUsage);
+}
+function runOpenRouterWithUsageTap(client, options) {
+  return runProviderWithUsageTap(client, options, extractOpenAIUsage);
+}
+function runAnthropicWithUsageTap(client, options) {
+  return runProviderWithUsageTap(client, options, extractAnthropicUsage);
+}
+function runGeminiWithUsageTap(client, options) {
+  return runProviderWithUsageTap(client, options, extractGeminiUsage);
+}
+
+export {
+  createUsageTapClient,
+  defaultUsageTapErrorMapper,
+  beginUsageTapCall,
+  endUsageTapCall,
+  withUsageTapCall,
+  applyUsageTapEntitlements,
+  extractOpenAIUsage,
+  extractAnthropicUsage,
+  extractGeminiUsage,
+  runOpenAIWithUsageTap,
+  runOpenRouterWithUsageTap,
+  runAnthropicWithUsageTap,
+  runGeminiWithUsageTap
+};
+//# sourceMappingURL=chunk-HWEVRBKZ.js.map