@costwise/sdk 0.0.1 → 0.0.3

package/dist/esm/src/tracker.d.ts

@@ -0,0 +1,23 @@
+import { CostwiseOptions, ModelCapacity, CliComparisonFormat, ModelComparison, ModelComparisonByCapacity, UsageSnapshot } from "./types.js";
+type ModelRates = {
+    input: number;
+    output: number;
+};
+declare const PRICING: Record<string, ModelRates>;
+declare const MODEL_CAPACITIES: Record<string, ModelCapacity>;
+export declare class CostwiseTracker {
+    private readonly apiKey?;
+    private readonly tag?;
+    private readonly localUsagePath?;
+    constructor(options?: CostwiseOptions);
+    trackUsage(snapshot: UsageSnapshot): void;
+    compareCosts(snapshot: UsageSnapshot): ModelComparison[];
+    compareCostsByCapacity(snapshot: UsageSnapshot): ModelComparisonByCapacity;
+    summarizeComparison(snapshot: UsageSnapshot): string;
+    formatComparisonForCli(snapshot: UsageSnapshot): CliComparisonFormat;
+    private createPayload;
+    private estimateCost;
+    private calculateCost;
+}
+export { MODEL_CAPACITIES, PRICING };
+//# sourceMappingURL=tracker.d.ts.map

package/dist/esm/src/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../../src/tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAGf,aAAa,EAEb,mBAAmB,EACnB,eAAe,EACf,yBAAyB,EACzB,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,KAAK,UAAU,GAAG;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AA6BF,QAAA,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAGvC,CAAC;AAEF,QAAA,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAsBnD,CAAC;AAIF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAS;gBAE7B,OAAO,GAAE,eAAoB;IAMzC,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IA8BzC,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,eAAe,EAAE;IAqBxD,sBAAsB,CAAC,QAAQ,EAAE,aAAa,GAAG,yBAAyB;IAgC1E,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM;IAWpD,sBAAsB,CAAC,QAAQ,EAAE,aAAa,GAAG,mBAAmB;IA+BpE,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;CAKtB;AAED,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC"}

package/dist/esm/src/tracker.js

@@ -0,0 +1,207 @@
+import { appendFile } from "node:fs/promises";
+const OPENAI_PRICING = {
+    "gpt-5.4": { input: 2.5, output: 15 },
+    "gpt-5.4-mini": { input: 0.75, output: 4.5 },
+    "gpt-5.4-nano": { input: 0.2, output: 1.25 },
+    "gpt-5.4-pro": { input: 30, output: 180 },
+    "gpt-5.2": { input: 1.75, output: 14 },
+    "gpt-5.2-pro": { input: 21, output: 168 },
+    "o1": { input: 15, output: 60 },
+    "o1-pro": { input: 150, output: 600 },
+    "o3-mini": { input: 1.1, output: 4.4 },
+    "gpt-4o": { input: 2.5, output: 10 },
+    "gpt-4o-mini": { input: 0.15, output: 0.6 }
+};
+const ANTHROPIC_PRICING = {
+    "claude-opus-4.6": { input: 5, output: 25 },
+    "claude-opus-4.5": { input: 5, output: 25 },
+    "claude-opus-4.1": { input: 15, output: 75 },
+    "claude-opus-4": { input: 15, output: 75 },
+    "claude-sonnet-4.6": { input: 3, output: 15 },
+    "claude-sonnet-4.5": { input: 3, output: 15 },
+    "claude-sonnet-4": { input: 3, output: 15 },
+    "claude-haiku-4.5": { input: 1, output: 5 },
+    "claude-haiku-3.5": { input: 0.8, output: 4 },
+    "claude-haiku-3": { input: 0.25, output: 1.25 }
+};
+const PRICING = {
+    ...OPENAI_PRICING,
+    ...ANTHROPIC_PRICING
+};
+const MODEL_CAPACITIES = {
+    "gpt-5.4": { contextWindowTokens: 270_000, capacityClass: "frontier" },
+    "gpt-5.4-mini": { contextWindowTokens: 270_000, capacityClass: "high" },
+    "gpt-5.4-nano": { contextWindowTokens: 270_000, capacityClass: "nano" },
+    "gpt-5.4-pro": { contextWindowTokens: 270_000, capacityClass: "frontier" },
+    "gpt-5.2": { contextWindowTokens: 270_000, capacityClass: "high" },
+    "gpt-5.2-pro": { contextWindowTokens: 270_000, capacityClass: "frontier" },
+    o1: { capacityClass: "frontier" },
+    "o1-pro": { capacityClass: "frontier" },
+    "o3-mini": { capacityClass: "mini" },
+    "gpt-4o": { capacityClass: "high" },
+    "gpt-4o-mini": { capacityClass: "mini" },
+    "claude-opus-4.6": { contextWindowTokens: 1_000_000, capacityClass: "frontier" },
+    "claude-opus-4.5": { contextWindowTokens: 200_000, capacityClass: "frontier" },
+    "claude-opus-4.1": { contextWindowTokens: 200_000, capacityClass: "frontier" },
+    "claude-opus-4": { contextWindowTokens: 200_000, capacityClass: "frontier" },
+    "claude-sonnet-4.6": { contextWindowTokens: 1_000_000, capacityClass: "high" },
+    "claude-sonnet-4.5": { contextWindowTokens: 1_000_000, capacityClass: "high" },
+    "claude-sonnet-4": { contextWindowTokens: 1_000_000, capacityClass: "high" },
+    "claude-haiku-4.5": { contextWindowTokens: 200_000, capacityClass: "mini" },
+    "claude-haiku-3.5": { contextWindowTokens: 200_000, capacityClass: "mini" },
+    "claude-haiku-3": { contextWindowTokens: 200_000, capacityClass: "mini" }
+};
+const INGEST_URL = "https://api.costwise.dev/ingest";
+export class CostwiseTracker {
+    apiKey;
+    tag;
+    localUsagePath;
+    constructor(options = {}) {
+        this.apiKey = options.costwiseKey ?? options.costswiseKey ?? options.apiKey ?? process.env.COSTWISE_API_KEY;
+        this.tag = options.tag;
+        this.localUsagePath = options.localUsagePath ?? process.env.COSTWISE_LOCAL_USAGE_PATH;
+    }
+    trackUsage(snapshot) {
+        const payload = this.createPayload(snapshot);
+        if (!payload) {
+            return;
+        }
+        if (this.apiKey) {
+            void fetch(INGEST_URL, {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    authorization: `Bearer ${this.apiKey}`
+                },
+                body: JSON.stringify(payload)
+            }).catch(() => { });
+        }
+        if (this.localUsagePath) {
+            const localEvent = {
+                model: payload.model,
+                input_tokens: payload.input_tokens,
+                output_tokens: payload.output_tokens,
+                estimated_cost: payload.estimated_cost,
+                tag: payload.tag,
+                timestamp: payload.timestamp
+            };
+            void appendFile(this.localUsagePath, `${JSON.stringify(localEvent)}\n`, "utf8").catch(() => { });
+        }
+    }
+    compareCosts(snapshot) {
+        const currentCost = this.estimateCost(snapshot.model, snapshot.inputTokens, snapshot.outputTokens);
+        if (currentCost === null) {
+            return [];
+        }
+        return Object.entries(PRICING)
+            .map(([model, rates]) => {
+            const estimatedCost = this.calculateCost(snapshot.inputTokens, snapshot.outputTokens, rates);
+            return {
+                model,
+                inputRatePerMTok: rates.input,
+                outputRatePerMTok: rates.output,
+                estimatedCost,
+                deltaFromCurrentCost: estimatedCost - currentCost,
+                capacity: MODEL_CAPACITIES[model] ?? { capacityClass: "standard" }
+            };
+        })
+            .sort((a, b) => a.estimatedCost - b.estimatedCost);
+    }
+    compareCostsByCapacity(snapshot) {
+        const all = this.compareCosts(snapshot);
+        if (all.length === 0) {
+            return { byClass: {}, cheapestPerClass: {} };
+        }
+        const byClass = {};
+        for (const c of all) {
+            const cls = c.capacity.capacityClass;
+            const list = byClass[cls] ?? [];
+            list.push(c);
+            byClass[cls] = list;
+        }
+        for (const cls of Object.keys(byClass)) {
+            const list = byClass[cls];
+            if (list) {
+                list.sort((a, b) => a.estimatedCost - b.estimatedCost);
+            }
+        }
+        const cheapestPerClass = {};
+        for (const cls of Object.keys(byClass)) {
+            const list = byClass[cls];
+            if (list?.[0]) {
+                cheapestPerClass[cls] = list[0];
+            }
+        }
+        return { byClass, cheapestPerClass };
+    }
+    summarizeComparison(snapshot) {
+        const comparisons = this.compareCosts(snapshot);
+        if (comparisons.length === 0) {
+            return `No pricing entry found for model ${snapshot.model}.`;
+        }
+        const cheapest = comparisons[0];
+        const priciest = comparisons[comparisons.length - 1];
+        return `For ${snapshot.inputTokens} input + ${snapshot.outputTokens} output tokens, cheapest is ${cheapest.model} ($${cheapest.estimatedCost.toFixed(6)}), priciest is ${priciest.model} ($${priciest.estimatedCost.toFixed(6)}).`;
+    }
+    formatComparisonForCli(snapshot) {
+        const comparisons = this.compareCosts(snapshot);
+        if (comparisons.length === 0) {
+            const text = `Costwise: no pricing entry found for model ${snapshot.model}.`;
+            return { text, lines: [text] };
+        }
+        const byCapacity = this.compareCostsByCapacity(snapshot);
+        const cheapest = comparisons[0];
+        const current = comparisons.find((c) => c.model === snapshot.model) ?? null;
+        const delta = current ? current.estimatedCost - cheapest.estimatedCost : 0;
+        const lines = [
+            `Costwise comparison for ${snapshot.model}`,
+            `Usage: ${snapshot.inputTokens} input / ${snapshot.outputTokens} output tokens`,
+            `Current model cost: $${(current?.estimatedCost ?? 0).toFixed(6)}`,
+            `Cheapest overall: ${cheapest.model} ($${cheapest.estimatedCost.toFixed(6)})`,
+            `Potential savings: $${Math.max(0, delta).toFixed(6)}`
+        ];
+        const classes = ["nano", "mini", "standard", "high", "frontier"];
+        for (const cls of classes) {
+            const best = byCapacity.cheapestPerClass[cls];
+            if (best) {
+                lines.push(`Best ${cls}: ${best.model} ($${best.estimatedCost.toFixed(6)})`);
+            }
+        }
+        return { text: lines.join("\n"), lines };
+    }
+    createPayload(snapshot) {
+        const cost = this.estimateCost(snapshot.model, snapshot.inputTokens, snapshot.outputTokens);
+        if (cost === null) {
+            return null;
+        }
+        const input_tokens = Math.max(0, snapshot.inputTokens || 0);
+        const output_tokens = Math.max(0, snapshot.outputTokens || 0);
+        const tag = snapshot.tag ?? this.tag;
+        const timestamp = new Date().toISOString();
+        return {
+            model: snapshot.model,
+            input_tokens,
+            output_tokens,
+            cost,
+            estimated_cost: cost,
+            tag,
+            endpoint_tag: tag,
+            ts: timestamp,
+            timestamp
+        };
+    }
+    estimateCost(model, inputTokens, outputTokens) {
+        const rates = PRICING[model];
+        if (!rates) {
+            return null;
+        }
+        return this.calculateCost(inputTokens, outputTokens, rates);
+    }
+    calculateCost(inputTokens, outputTokens, rates) {
+        const input = Math.max(0, inputTokens || 0);
+        const output = Math.max(0, outputTokens || 0);
+        return (input / 1_000_000) * rates.input + (output / 1_000_000) * rates.output;
+    }
+}
+export { MODEL_CAPACITIES, PRICING };
+//# sourceMappingURL=tracker.js.map

package/dist/esm/src/tracker.js.map

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

package/dist/esm/src/types.d.ts

@@ -0,0 +1,56 @@
+export type CostwiseOptions = {
+    apiKey?: string;
+    costwiseKey?: string;
+    costswiseKey?: string;
+    tag?: string;
+    localUsagePath?: string;
+};
+export type IngestPayload = {
+    model: string;
+    input_tokens: number;
+    output_tokens: number;
+    cost: number;
+    estimated_cost: number;
+    tag?: string;
+    endpoint_tag?: string;
+    ts: string;
+    timestamp: string;
+};
+export type UsageSnapshot = {
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    tag?: string;
+};
+export type ModelCapacity = {
+    contextWindowTokens?: number;
+    outputLimitTokens?: number;
+    capacityClass: "nano" | "mini" | "standard" | "high" | "frontier";
+};
+export type ModelComparison = {
+    model: string;
+    inputRatePerMTok: number;
+    outputRatePerMTok: number;
+    estimatedCost: number;
+    deltaFromCurrentCost: number;
+    capacity: ModelCapacity;
+};
+export type ModelCapacityClass = ModelCapacity["capacityClass"];
+/** Grouped comparisons: each class lists models cheapest-first; cheapestPerClass picks one model per class. */
+export type ModelComparisonByCapacity = {
+    byClass: Partial<Record<ModelCapacityClass, ModelComparison[]>>;
+    cheapestPerClass: Partial<Record<ModelCapacityClass, ModelComparison>>;
+};
+export type CliComparisonFormat = {
+    text: string;
+    lines: string[];
+};
+export type LocalUsageEvent = {
+    model: string;
+    input_tokens: number;
+    output_tokens: number;
+    estimated_cost: number;
+    tag?: string;
+    timestamp: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,aAAa,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;AAEhE,+GAA+G;AAC/G,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;IAChE,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC,CAAC;CACxE,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/dist/esm/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,9 +1,43 @@
 {
   "name": "@costwise/sdk",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "AI API cost tracking for developers",
-  "main": "index.js",
   "license": "MIT",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "bin": {
+    "costwise": "./dist/esm/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json && node -e \"require('node:fs').writeFileSync('dist/cjs/package.json', '{\\\"type\\\":\\\"commonjs\\\"}\\n')\"",
+    "smoke": "npm run build && node smoke-test.mjs",
+    "test": "npm run build && node --test tests/**/*.test.mjs",
+    "cli:usage": "npm run build && node dist/esm/cli.js usage",
+    "cli:compare": "npm run build && node dist/esm/cli.js compare-actual"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": ">=0.58.0",
+    "openai": ">=6.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "typescript": "^5.9.2"
+  },
   "publishConfig": {
     "access": "public"
   }

package/index.js

@@ -1,3 +0,0 @@
-// costwise/index.js
-module.exports = {}
-// Coming soon