vibezcheck 0.4.1 → 0.5.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 VibezCheck <dev@vibezcheck.xyz> (https://vibezcheck.xyz)
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 VibezCheck <dev@vibezcheck.xyz> (https://vibezcheck.xyz)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,29 +1,38 @@
-# ⚡ vibezcheck
+# ✦ VibezCheck
 
-> **Give your AI app a financial mind.**  
-> The declarative 1-line Stripe Billing and Token Metering engine for LLMs. Measure tokens, compute real-time dollar costs, and bill customers with **0ms added latency**.
+> **The 1-Line Token Meter & Real-Time Billing Engine for AI.**  
+> Track tokens, compute real-time dollar costs, set profit margins, and bill customers with **0ms added latency**.
 
 [![npm version](https://img.shields.io/npm/v/vibezcheck.svg)](https://npmjs.org/package/vibezcheck)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Strict-blue.svg)](https://www.typescriptlang.org/)
-[![Tests](https://img.shields.io/badge/Tests-31%20Passed-brightgreen.svg)]()
+[![Tests](https://img.shields.io/badge/Tests-62%20Passed-brightgreen.svg)]()
 
 ---
 
-## 🍌 The Electric Meter for Artificial Intelligence
+### The 2-Line Promise
 
-When you turn on the lights in your bedroom, your electric meter spins. When users prompt your AI, **VibezCheck** is the smart meter that counts every word and hidden thought — converting it into pennies with Stripe so your app actually looks out for your margins.
+```typescript
+// 1. Server: Wrap your model with automated billing
+const model = vibezcheck('openai/gpt-4o', { customer: 'cus_alex' });
+
+// 2. Client: Drop in the financial HUD
+<VibezCheck messages={messages} />
+```
+
+---
+
+## 🚀 Features
 
-### 🛡️ Sane Defaults (Zero Configuration Required)
-* **⚡ 0ms Added Latency**: Streams pass directly to your user's browser with zero intermediate proxy buffering.
-* **🛡️ Default $0.50 Fuse Box**: Automatically prevents runaway loops without requiring manual ceilings.
-* **🛟 In-Flight Abort Trapper**: Captures and bills partial tokens even if a user closes their browser tab mid-stream.
-* **🏷️ Automatic 85% Prompt Cache Discounts**: Detects cache hits on Claude 3.7, GPT-4o, and DeepSeek and passes real savings through.
-* **🚀 Serverless Lifecycle Protection**: Seamlessly keeps serverless containers alive until telemetry is acknowledged.
-* **💰 1-Line Profit Margins**: Turn wholesale provider costs into guaranteed net profit with `pricing: { margin: 1.5 }`.
-* **💳 Prepaid & Postpaid**: Choose between monthly metered invoices or zero-debt credit wallets.
-* **🧠 Reasoning Token Aware**: Captures hidden thinking tokens in o3-mini and Claude 3.7 Thinking.
-* **🆓 Free Vibe Mode**: Works 100% out of the box in local development with no Stripe account required.
+* **⚡ 0ms Added Latency**: Direct transparent proxy stream; no external server redirects or buffering.
+* **🛡️ Built-in $0.50 Circuit Breaker**: Prevents infinite loops and runaway bills automatically.
+* **🛟 In-Flight Abort Trapper**: Catches and bills tokens even if the customer closes their tab mid-stream.
+* **🪙 BigInt Nano-USD Precision**: Sub-cent financial math ($1 = $10^9$ Nano-USD) eliminating IEEE 754 float drift.
+* **💰 1-Line Profit Margins**: Turn wholesale API costs into retail profits with `pricing: { margin: 1.5 }` (+50% profit).
+* **🆓 Zero-DB Dev Mode**: Run locally on `localhost:3000` with NO database and NO Stripe keys required.
+* **💳 Pluggable SaaS Billing**: Top-ups, checkout sessions, customer portal, and user API keys (`vz_live_...`).
+* **🤖 Multi-Tool Agent Sessions**: Cumulative session budgets across models, Python sandboxes, and web scrapers.
+* **🔄 100% Drop-In Polyfills**: Direct replacement for `@stripe/ai-sdk/meter`, `@stripe/ai-sdk/provider`, and `@stripe/token-meter`.
 
 ---
 
@@ -35,45 +44,49 @@ npm install vibezcheck ai @ai-sdk/openai stripe
 
 ---
 
-## ⚡ 1. The 60-Second Quickstart
+## ⚡ Quickstart: Zero-DB Dev Mode to Production
+
+### 1. Next.js 15 API Route (`app/api/chat/route.ts`)
 
-### Backend API Route (`app/api/chat/route.ts`)
 ```typescript
 import { streamText } from 'ai';
+import { openai } from '@ai-sdk/openai';
 import { vibezcheck } from 'vibezcheck';
 
 export async function POST(req: Request) {
-  const { messages, userEmail = 'alex@company.com' } = await req.json();
-
-  return streamText({
-    // ⚡ 1 Line. All 6 sane defaults run automatically.
-    model: vibezcheck('openai/gpt-4o-mini', { customer: userEmail }),
+  const { messages } = await req.json();
+
+  const result = streamText({
+    // Wrap any AI SDK model or use string identifier
+    model: vibezcheck(openai('gpt-4o-mini'), {
+      customer: 'user_alex@example.com', // Stripe customer ID or user email
+      pricing: { margin: 1.3 },         // +30% profit margin
+      maxCostPerCallUSD: 0.50,          // Safety fuse box
+    }),
     messages,
-  }).toDataStreamResponse();
+  });
+
+  return result.toDataStreamResponse();
 }
 ```
 
-### Frontend Chat UI (`app/page.tsx`)
+### 2. Frontend React Client (`app/page.tsx`)
+
 ```tsx
 'use client';
-import { useVibezChat, VibezReceipt, VibezSessionWidget } from 'vibezcheck/react';
+import { useChat } from 'ai/react';
+import { VibezCheck } from 'vibezcheck/ui';
 
 export default function ChatPage() {
-  const { messages, input, handleInputChange, handleSubmit } = useVibezChat();
+  const { messages, input, handleInputChange, handleSubmit } = useChat();
 
   return (
-    <main className="max-w-xl mx-auto py-10 px-4 space-y-6">
-      {/* 1. Floating live token & dollar counter */}
-      <VibezSessionWidget position="bottom-right" />
-
-      {/* 2. Messages with micro-receipts */}
-      <div className="space-y-4">
+    <main className="max-w-2xl mx-auto p-6 space-y-4">
+      <div className="space-y-3">
         {messages.map((m) => (
-          <div key={m.id} className="p-4 rounded-2xl bg-white border border-slate-200">
-            <p className="text-slate-900 text-sm">{m.content}</p>
-
-            {/* Micro-Receipt under assistant answers */}
-            {m.role === 'assistant' && <VibezReceipt message={m} />}
+          <div key={m.id} className="p-3 rounded-lg bg-slate-100 dark:bg-slate-800">
+            <strong>{m.role}: </strong>
+            <span>{m.content}</span>
           </div>
         ))}
       </div>
@@ -82,13 +95,16 @@ export default function ChatPage() {
         <input
           value={input}
           onChange={handleInputChange}
-          placeholder="Ask a question..."
-          className="flex-1 px-4 py-2 rounded-xl border border-slate-200 text-sm"
+          placeholder="Ask anything..."
+          className="flex-1 p-2 border rounded-lg"
         />
-        <button type="submit" className="px-5 py-2 rounded-xl bg-slate-950 text-white font-bold text-sm">
+        <button type="submit" className="px-4 py-2 bg-blue-600 text-white rounded-lg">
           Send
         </button>
       </form>
+
+      {/* ✦ 1-Line HUD: Works with zero database & zero Stripe in Dev Mode */}
+      <VibezCheck messages={messages} model="gpt-4o-mini" margin={1.3} />
     </main>
   );
 }
@@ -96,108 +112,119 @@ export default function ChatPage() {
 
 ---
 
-## 🛠️ Real-World Implementation Patterns
+## 💳 Commercial SaaS Use Cases
 
-### Pattern A: 50% Profit Margin Engine
-Turn wholesale provider costs into guaranteed net profit:
+### 1. Credit Wallet Top-Ups & Checkout (`BillingHelper`)
 
 ```typescript
-model: vibezcheck('openai/gpt-4o-mini', {
-  customer: 'sarah@acme.com',
-  pricing: {
-    margin: 1.5,           // 👈 Cost + 50% margin automatically billed to Stripe!
-    minimumChargeUSD: 0.01, // 👈 Minimum charge 1 cent per question
-  },
-})
-```
+import { BillingHelper } from 'vibezcheck';
 
----
+const billing = new BillingHelper({ apiKey: process.env.STRIPE_SECRET_KEY });
 
-### Pattern B: Prepaid Credit Wallets (Zero Debt Risk)
-User pre-purchases $10; stream cleanly halts when balance hits $0 without invoice debt:
+// Customer purchases $20 in AI usage credits
+export async function POST(req: Request) {
+  const { customerId } = await req.json();
 
-```typescript
-model: vibezcheck('openai/gpt-4o-mini', {
-  customer: 'alex@gmail.com',
-  billing: {
-    mode: 'prepaid', // 👈 Deducts from prepaid credit balance in real time
-  },
-  // Gracefully downshift when credits run low instead of crashing
-  fallbackModelOnBudget: 'openai/gpt-4o-mini',
-})
+  const checkoutUrl = await billing.createTopUpSession({
+    customerId,
+    amountCents: 2000, // $20.00
+    returnUrl: 'https://myapp.com/dashboard',
+  });
+
+  return Response.json({ url: checkoutUrl });
+}
 ```
 
----
+### 2. Customer API Keys (`ApiKeyAuth`)
 
-### Pattern C: Frontier Reasoning Models (Claude 3.7 & o3-mini)
-Automatically extracts hidden thinking tokens and applies 85% prompt cache discounts:
+Issue customer API keys (`vz_live_...`) backed by Stripe customer metadata—zero database required:
 
 ```typescript
-model: vibezcheck('anthropic/claude-3-7-sonnet', {
-  customer: 'alex@company.com',
-  maxCostPerCallUSD: 0.75, // Extended ceiling for multi-minute deep reasoning
-})
-```
+import { ApiKeyAuth } from 'vibezcheck';
+import Stripe from 'stripe';
 
----
+const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);
+const auth = new ApiKeyAuth(stripe);
 
-### Pattern D: Unified Agent Tool Call Metering
-Bill external tools (web searches, scrapers, Python sandboxes) and LLM streams into one invoice:
+// 1. Generate key for customer
+const { apiKey } = await auth.createKey({
+  customerId: 'cus_123',
+  name: 'Production Worker Key',
+});
+// => "vz_live_9f83b2..."
 
-```typescript
-// app/api/agent/route.ts
-import { generateText, tool } from 'ai';
-import { vibezcheck } from 'vibezcheck';
-import { z } from 'zod';
+// 2. Authenticate API requests in middleware
+export async function middleware(req: Request) {
+  const token = req.headers.get('Authorization')?.replace('Bearer ', '');
+  const verification = await auth.verifyKey(token);
 
-export async function POST(req: Request) {
-  const { prompt, customer = 'alex@company.com' } = await req.json();
-
-  // Create unified customer session
-  const session = vibezcheck.session({ customer });
-
-  const result = await generateText({
-    model: session.model('openai/gpt-4o-mini'),
-    tools: {
-      searchGoogle: tool({
-        description: 'Live Google Search',
-        parameters: z.object({ query: z.string() }),
-        execute: async ({ query }) => {
-          // ⚡ Bill non-LLM tool execution ($0.01) into the same customer balance
-          await session.trackTool('google_search', { costUSD: 0.01 });
-          return `Search results for: ${query}`;
-        },
-      }),
-    },
-    prompt,
-  });
+  if (!verification.valid) {
+    return new Response('Unauthorized', { status: 401 });
+  }
 
-  return Response.json(result);
+  // verification.customerId is verified against Stripe!
 }
 ```
 
+### 3. Multi-Tool Agent Sessions (`AgentSession`)
+
+Set a hard $1.00 session budget across multiple LLM steps and external tools:
+
+```typescript
+import { AgentSession, wrapTool } from 'vibezcheck';
+import { openai } from '@ai-sdk/openai';
+
+const session = new AgentSession({
+  customer: 'cus_agent_user',
+  sessionBudgetUSD: 1.00, // Hard ceiling for entire session
+});
+
+// Wrap external tools with financial tracking
+const webSearchTool = wrapTool({
+  name: 'web_search',
+  costUSD: 0.01,
+  execute: async ({ query }) => fetchSearch(query),
+});
+
+// Run LLM model bound to this session
+const sessionModel = session.model(openai('gpt-4o'));
+```
+
 ---
 
-### Pattern E: Brand-New Model (1-Line Inline Rate Card)
-Use newly released or fine-tuned models with zero wait for package updates:
+## 🔄 100% Drop-In Compatibility with `@stripe/ai-sdk`
+
+If you are migrating from `@stripe/ai-sdk` or `@stripe/token-meter`, swap your imports:
 
 ```typescript
-model: vibezcheck('deepseek/deepseek-r2', {
-  rate: { in: 0.20, out: 0.80 }, // $0.20/M in, $0.80/M out
-})
+// Replace: import { meteredModel } from '@stripe/ai-sdk/meter';
+import { meteredModel } from 'vibezcheck/stripe/meter';
+
+// Replace: import { stripe } from '@stripe/ai-sdk/provider';
+import { stripe } from 'vibezcheck/stripe/provider';
+
+// Replace: import { createTokenMeter } from '@stripe/token-meter';
+import { createTokenMeter } from 'vibezcheck/stripe/token-meter';
 ```
 
 ---
 
-## 🎨 React UI Suite (`vibezcheck/react`)
+## 🛡️ Route Auditor CLI
+
+Audit your codebase to detect unmetered AI endpoints before shipping to production:
 
-* **`useVibezChat`**: 1-hook drop-in chat streaming with live session cost sync.
-* **`<VibezReceipt />`**: Micro-badge rendered below assistant responses (*"⚡ gpt-4o-mini • 342 tokens • $0.0005 • Verified by VibezCheck"*).
-* **`<VibezSessionWidget />`**: Floating live token & dollar speedometer in the screen corner.
-* **`<VibezBillingModal />`**: Drop-in 1-click Stripe Checkout top-up modal.
+```bash
+npx vibezcheck audit
+```
+
+### CI/CD Mode
+Fail the build if unmetered AI routes are detected:
+```bash
+npx vibezcheck audit --ci
+```
 
 ---
 
 ## 📄 License
 
-MIT © [VibezCheck](https://vibezcheck.app)
+MIT © [VibezCheck](https://vibezcheck.xyz)

package/bin/vibezcheck.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
-
-// Forward execution to compiled CLI entrypoint
-require('../dist/cli/index.js');
+#!/usr/bin/env node
+
+// Forward execution to compiled CLI entrypoint
+require('../dist/cli/index.js');

package/dist/ai-sdk/index.d.mts

@@ -1,52 +1,13 @@
-import { c as CircuitBreakerOptions, C as CustomerParam, B as BillingConfig, P as PricingConfig, d as InlineRateConfig, U as UsageEvent } from '../types-Zbzxg-Ka.mjs';
-import { V as VibezMeter } from '../client--iq93FQg.mjs';
+import { W as WithBillingOptions } from '../with-billing-mci2vtFS.mjs';
+export { m as meteredModel, w as withBilling } from '../with-billing-mci2vtFS.mjs';
+import { C as CustomerParam } from '../types-BVGqbKnY.mjs';
+import { V as VibezMeter } from '../client-Dmwb3hQt.mjs';
 import 'stripe';
 
-interface WithBillingOptions extends CircuitBreakerOptions {
-    /** Customer email, user ID, or Stripe customer ID */
-    customer?: CustomerParam;
-    /** Direct Stripe customer ID */
-    customerId?: string;
-    /** Billing mode configuration (postpaid vs prepaid) */
-    billing?: BillingConfig;
-    /** Profit margin & minimum charge configuration */
-    pricing?: PricingConfig;
-    /** 1-line inline pricing rate card */
-    rate?: InlineRateConfig;
-    /** Whether to capture tokens if the client aborts or closes tab mid-stream (default: true) */
-    captureOnAbort?: boolean;
-    /** Execution runtime environment (default: 'auto') */
-    runtime?: 'auto' | 'serverless' | 'edge' | 'node';
-    /** Stripe API Key override (uses STRIPE_SECRET_KEY env by default) */
-    stripeApiKey?: string;
-    /** Existing VibezMeter instance (optional) */
-    meter?: VibezMeter;
-    /** Custom meter event name */
-    eventName?: string;
-    /** Usage callback fired upon generation/stream completion */
-    onUsage?: (event: UsageEvent) => void | Promise<void>;
-    /** Custom developer metadata */
-    metadata?: Record<string, string | number | boolean>;
-}
-/**
- * Wraps any Vercel AI SDK LanguageModel (v2 or v3) with automated Stripe billing, token metering, and agent circuit breakers.
- *
- * Sane Defaults Built-In:
- * - $0.50 safety ceiling per call (overridable)
- * - Automatic in-flight token capture on abort
- * - Automatic prompt caching discount parsing
- * - Serverless lifecycle preservation
- */
-declare function withBilling<T extends object>(model: T, options?: WithBillingOptions): T;
-/**
- * Convenient alias for withBilling
- */
-declare const meteredModel: typeof withBilling;
-
 interface VibezCheckModelOptions extends WithBillingOptions {
-    /** OpenAI / AI Gateway API Key override */
+    /** OpenAI / Anthropic / AI Gateway API Key override */
     apiKey?: string;
-    /** AI Gateway / OpenAI Base URL override */
+    /** AI Gateway / Provider Base URL override */
     baseURL?: string;
 }
 interface VibezSessionOptions {
@@ -70,23 +31,33 @@ interface VibezSession {
 /**
  * Creates or resolves an AI SDK compatible LanguageModel with built-in VibezCheck billing & metering.
  *
+ * Supports:
+ * - Direct instances: `vibezcheck(openai('gpt-4o'))`, `vibezcheck(anthropic('claude-3-7-sonnet'))`
+ * - String identifiers: `vibezcheck('openai/gpt-4o-mini')`, `vibezcheck('anthropic/claude-3-5-sonnet')`, `vibezcheck('gpt-4o')`
+ * - Vercel AI SDK primitives: `generateText`, `streamText`, `generateObject`, `streamObject`
+ *
  * @example
  * ```typescript
- * import { generateText, streamText } from 'ai';
+ * import { streamText } from 'ai';
+ * import { openai } from '@ai-sdk/openai';
+ * import { anthropic } from '@ai-sdk/anthropic';
  * import { vibezcheck } from 'vibezcheck';
  *
- * // 1. Declarative string model identifier:
- * const { text } = await generateText({
- *   model: vibezcheck('openai/gpt-4o-mini', { customer: 'alex@example.com' }),
- *   prompt: 'What is love?',
+ * // 1. Pass wrapped OpenAI instance:
+ * const result = streamText({
+ *   model: vibezcheck(openai('gpt-4o-mini'), { customer: 'alex@example.com' }),
+ *   messages,
  * });
  *
- * // 2. Works with all Vercel AI SDK primitives (streamText, generateObject, streamObject):
- * const result = streamText({
- *   model: vibezcheck('gpt-4o', {
- *     customer: 'alex@example.com',
- *     pricing: { margin: 1.5 }, // 50% profit margin
- *   }),
+ * // 2. Pass wrapped Anthropic instance:
+ * const result2 = streamText({
+ *   model: vibezcheck(anthropic('claude-3-7-sonnet'), { customer: 'alex@example.com' }),
+ *   messages,
+ * });
+ *
+ * // 3. Use 1-line string identifier:
+ * const result3 = streamText({
+ *   model: vibezcheck('openai/gpt-4o-mini', { customer: 'alex@example.com' }),
  *   messages,
  * });
  * ```
@@ -100,4 +71,4 @@ declare const vibezcheck: typeof createVibezModel & {
     session: typeof createVibezSession;
 };
 
-export { type VibezCheckModelOptions, type VibezSession, type VibezSessionOptions, type WithBillingOptions, createVibezModel, createVibezSession, meteredModel, vibezcheck, withBilling };
+export { type VibezCheckModelOptions, type VibezSession, type VibezSessionOptions, WithBillingOptions, createVibezModel, createVibezSession, vibezcheck };

package/dist/ai-sdk/index.d.ts

@@ -1,52 +1,13 @@
-import { c as CircuitBreakerOptions, C as CustomerParam, B as BillingConfig, P as PricingConfig, d as InlineRateConfig, U as UsageEvent } from '../types-Zbzxg-Ka.js';
-import { V as VibezMeter } from '../client-kJN_Znan.js';
+import { W as WithBillingOptions } from '../with-billing-CDqKIAQ6.js';
+export { m as meteredModel, w as withBilling } from '../with-billing-CDqKIAQ6.js';
+import { C as CustomerParam } from '../types-BVGqbKnY.js';
+import { V as VibezMeter } from '../client-CJ2Dj8ID.js';
 import 'stripe';
 
-interface WithBillingOptions extends CircuitBreakerOptions {
-    /** Customer email, user ID, or Stripe customer ID */
-    customer?: CustomerParam;
-    /** Direct Stripe customer ID */
-    customerId?: string;
-    /** Billing mode configuration (postpaid vs prepaid) */
-    billing?: BillingConfig;
-    /** Profit margin & minimum charge configuration */
-    pricing?: PricingConfig;
-    /** 1-line inline pricing rate card */
-    rate?: InlineRateConfig;
-    /** Whether to capture tokens if the client aborts or closes tab mid-stream (default: true) */
-    captureOnAbort?: boolean;
-    /** Execution runtime environment (default: 'auto') */
-    runtime?: 'auto' | 'serverless' | 'edge' | 'node';
-    /** Stripe API Key override (uses STRIPE_SECRET_KEY env by default) */
-    stripeApiKey?: string;
-    /** Existing VibezMeter instance (optional) */
-    meter?: VibezMeter;
-    /** Custom meter event name */
-    eventName?: string;
-    /** Usage callback fired upon generation/stream completion */
-    onUsage?: (event: UsageEvent) => void | Promise<void>;
-    /** Custom developer metadata */
-    metadata?: Record<string, string | number | boolean>;
-}
-/**
- * Wraps any Vercel AI SDK LanguageModel (v2 or v3) with automated Stripe billing, token metering, and agent circuit breakers.
- *
- * Sane Defaults Built-In:
- * - $0.50 safety ceiling per call (overridable)
- * - Automatic in-flight token capture on abort
- * - Automatic prompt caching discount parsing
- * - Serverless lifecycle preservation
- */
-declare function withBilling<T extends object>(model: T, options?: WithBillingOptions): T;
-/**
- * Convenient alias for withBilling
- */
-declare const meteredModel: typeof withBilling;
-
 interface VibezCheckModelOptions extends WithBillingOptions {
-    /** OpenAI / AI Gateway API Key override */
+    /** OpenAI / Anthropic / AI Gateway API Key override */
     apiKey?: string;
-    /** AI Gateway / OpenAI Base URL override */
+    /** AI Gateway / Provider Base URL override */
     baseURL?: string;
 }
 interface VibezSessionOptions {
@@ -70,23 +31,33 @@ interface VibezSession {
 /**
  * Creates or resolves an AI SDK compatible LanguageModel with built-in VibezCheck billing & metering.
  *
+ * Supports:
+ * - Direct instances: `vibezcheck(openai('gpt-4o'))`, `vibezcheck(anthropic('claude-3-7-sonnet'))`
+ * - String identifiers: `vibezcheck('openai/gpt-4o-mini')`, `vibezcheck('anthropic/claude-3-5-sonnet')`, `vibezcheck('gpt-4o')`
+ * - Vercel AI SDK primitives: `generateText`, `streamText`, `generateObject`, `streamObject`
+ *
  * @example
  * ```typescript
- * import { generateText, streamText } from 'ai';
+ * import { streamText } from 'ai';
+ * import { openai } from '@ai-sdk/openai';
+ * import { anthropic } from '@ai-sdk/anthropic';
  * import { vibezcheck } from 'vibezcheck';
  *
- * // 1. Declarative string model identifier:
- * const { text } = await generateText({
- *   model: vibezcheck('openai/gpt-4o-mini', { customer: 'alex@example.com' }),
- *   prompt: 'What is love?',
+ * // 1. Pass wrapped OpenAI instance:
+ * const result = streamText({
+ *   model: vibezcheck(openai('gpt-4o-mini'), { customer: 'alex@example.com' }),
+ *   messages,
  * });
  *
- * // 2. Works with all Vercel AI SDK primitives (streamText, generateObject, streamObject):
- * const result = streamText({
- *   model: vibezcheck('gpt-4o', {
- *     customer: 'alex@example.com',
- *     pricing: { margin: 1.5 }, // 50% profit margin
- *   }),
+ * // 2. Pass wrapped Anthropic instance:
+ * const result2 = streamText({
+ *   model: vibezcheck(anthropic('claude-3-7-sonnet'), { customer: 'alex@example.com' }),
+ *   messages,
+ * });
+ *
+ * // 3. Use 1-line string identifier:
+ * const result3 = streamText({
+ *   model: vibezcheck('openai/gpt-4o-mini', { customer: 'alex@example.com' }),
  *   messages,
  * });
  * ```
@@ -100,4 +71,4 @@ declare const vibezcheck: typeof createVibezModel & {
     session: typeof createVibezSession;
 };
 
-export { type VibezCheckModelOptions, type VibezSession, type VibezSessionOptions, type WithBillingOptions, createVibezModel, createVibezSession, meteredModel, vibezcheck, withBilling };
+export { type VibezCheckModelOptions, type VibezSession, type VibezSessionOptions, WithBillingOptions, createVibezModel, createVibezSession, vibezcheck };