@llmtracer/sdk 1.1.0 → 2.0.8

package/package.json

@@ -1,15 +1,43 @@
 {
   "name": "@llmtracer/sdk",
-  "version": "1.1.0",
+  "version": "2.0.8",
   "description": "See where your AI budget goes. Lightweight LLM cost tracking SDK.",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": ["dist"],
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/cjs/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
   "scripts": {
-    "build": "tsc",
-    "test": "node test/test-with-openai.js"
+    "build": "npm run build:cjs && npm run build:esm && npm run build:esm-pkg",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:esm-pkg": "node -e \"require('fs').writeFileSync('dist/esm/package.json', '{\\\"type\\\":\\\"module\\\"}')\"",
+    "test": "node --test test/sdk.test.js"
   },
-  "keywords": ["llm", "openai", "cost", "tracking", "observability"],
+  "keywords": [
+    "llm",
+    "openai",
+    "anthropic",
+    "google",
+    "gemini",
+    "cost",
+    "tracking",
+    "observability",
+    "tracing"
+  ],
   "author": "LLM Tracer <hello@llmtracer.com>",
   "license": "MIT",
   "repository": {
@@ -20,13 +48,26 @@
   "bugs": {
     "url": "https://github.com/llmtracer/sdk/issues"
   },
-  "dependencies": {},
   "devDependencies": {
-    "typescript": "^5.3.0",
-    "openai": "^4.0.0"
+    "@anthropic-ai/sdk": "^0.74.0",
+    "openai": "^4.0.0",
+    "typescript": "^5.3.0"
   },
   "peerDependencies": {
-    "openai": ">=4.0.0"
+    "openai": ">=4.0.0",
+    "@anthropic-ai/sdk": ">=0.30.0",
+    "@google/genai": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "openai": {
+      "optional": true
+    },
+    "@anthropic-ai/sdk": {
+      "optional": true
+    },
+    "@google/genai": {
+      "optional": true
+    }
   },
   "engines": {
     "node": ">=18"

package/dist/index.d.ts

@@ -1,118 +0,0 @@
-/** Configuration for LLMTracer SDK (Section 9.1 of spec) */
-export interface LLMTracerConfig {
-    /** Your LLM Tracer API key (starts with lt_) */
-    apiKey: string;
-    /** Ingestion endpoint URL */
-    endpoint?: string;
-    /** Max events per batch before auto-flush. Default: 50 */
-    maxBatchSize?: number;
-    /** Auto-flush interval in ms. Default: 10000 (10s) */
-    flushIntervalMs?: number;
-    /** Max events in queue before dropping oldest. Default: 10000 */
-    maxQueueSize?: number;
-    /** Max retry attempts for failed flushes. Default: 3 */
-    maxRetries?: number;
-    /** Base delay for exponential backoff in ms. Default: 1000 */
-    retryBaseMs?: number;
-    /** Sampling rate 0.0-1.0. Default: 1.0 (capture everything) */
-    sampleRate?: number;
-    /** Whether to capture full prompt content. Default: false */
-    capturePrompt?: boolean;
-    /** Enable debug logging. Default: false */
-    debug?: boolean;
-    /** Callback after each flush (Section 9.2) */
-    onFlush?: (stats: FlushStats) => void;
-    /** Callback on transport errors (Section 9.2) */
-    onError?: (error: Error) => void;
-}
-/** Stats passed to onFlush callback */
-export interface FlushStats {
-    sent: number;
-    accepted: number;
-    rejected: number;
-    dropped: number;
-    last_error: Error | null;
-}
-/** Tags passed to instrumentOpenAI */
-export interface InstrumentOptions {
-    tags?: Record<string, string>;
-}
-/** Trace context for agentic workflow tracking (Section 3.3) */
-interface TraceContext {
-    traceId: string;
-    currentPhase: string | null;
-    sampled: boolean;
-    phase: (name: string, fn: () => Promise<unknown>) => Promise<unknown>;
-}
-export declare class LLMTracer {
-    private readonly apiKey;
-    private readonly endpoint;
-    private readonly maxBatchSize;
-    private readonly flushIntervalMs;
-    private readonly maxQueueSize;
-    private readonly maxRetries;
-    private readonly retryBaseMs;
-    private readonly sampleRate;
-    private readonly capturePrompt;
-    private readonly debugMode;
-    private readonly onFlushCallback;
-    private readonly onErrorCallback;
-    private queue;
-    private droppedCount;
-    private flushTimer;
-    private circuitState;
-    private consecutiveFailures;
-    private circuitOpenedAt;
-    private lastErrorSummary;
-    private readonly circuitFailureThreshold;
-    private readonly circuitCooldownMs;
-    private activeTraceId;
-    private activePhase;
-    private activeTraceSampled;
-    private flushing;
-    constructor(config: LLMTracerConfig);
-    /**
-     * Wraps an OpenAI client to automatically capture usage events.
-     * Supports both non-streaming and streaming calls.
-     *
-     * Usage:
-     *   tracer.instrumentOpenAI(openai, { tags: { service: "api" } });
-     */
-    instrumentOpenAI(openai: any, options?: InstrumentOptions): void;
-    /**
-     * Flush all buffered events to the backend.
-     * CRITICAL: Call this before returning in serverless environments.
-     *
-     * Usage:
-     *   await tracer.flush();
-     */
-    flush(): Promise<void>;
-    /**
-     * Track an agentic workflow with phases.
-     * All LLM calls within this trace are grouped together.
-     * Sampling is per-trace (Section 11.1).
-     *
-     * Usage:
-     *   await tracer.trace("user-request-123", async (t) => {
-     *     await t.phase("planning", async () => {
-     *       await openai.chat.completions.create(...);
-     *     });
-     *   });
-     */
-    trace(traceId: string, fn: (ctx: TraceContext) => Promise<unknown>): Promise<void>;
-    /**
-     * Flush remaining events and stop the auto-flush timer.
-     */
-    shutdown(): Promise<void>;
-    private handleNonStreamingCall;
-    private handleStreamingCall;
-    private captureEvent;
-    private sendBatch;
-    private handleTransportError;
-    private enforceQueueLimit;
-    private handleInternalError;
-    private log;
-    private sleep;
-}
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}