ai-cost-analyzer 1.0.0

package/dist/tools/analyze.js

@@ -0,0 +1,210 @@
+/**
+ * analyze_usage tool -- accepts API usage data and returns cost analysis.
+ */
+import { resolveModelId, computeCost, MODEL_PRICING } from "./pricing.js";
+// ---------------------------------------------------------------------------
+// Constants for waste estimation
+// ---------------------------------------------------------------------------
+/** Average tokens per tool definition (name + description + schema). */
+const AVG_TOKENS_PER_TOOL_DEF = 350;
+/** Threshold above which a system prompt is considered "oversized". */
+const SYSTEM_PROMPT_OVERSIZE_THRESHOLD = 2000;
+// ---------------------------------------------------------------------------
+// Main handler
+// ---------------------------------------------------------------------------
+export function handleAnalyzeUsage(records) {
+    if (records.length === 0) {
+        return "No usage records provided. Please supply at least one record.";
+    }
+    const analysis = analyzeRecords(records);
+    return formatAnalysis(analysis);
+}
+// ---------------------------------------------------------------------------
+// Core analysis logic
+// ---------------------------------------------------------------------------
+function analyzeRecords(records) {
+    // ---- cost by model ----
+    const byModel = new Map();
+    for (const r of records) {
+        const key = r.model;
+        if (!byModel.has(key))
+            byModel.set(key, []);
+        byModel.get(key).push(r);
+    }
+    const costByModel = [];
+    for (const [model, recs] of byModel) {
+        const modelId = resolveModelId(model);
+        let totalInput = 0;
+        let totalOutput = 0;
+        let totalCached = 0;
+        let inputCost = 0;
+        let outputCost = 0;
+        let cacheSavings = 0;
+        for (const r of recs) {
+            totalInput += r.input_tokens;
+            totalOutput += r.output_tokens;
+            totalCached += r.cached_tokens ?? 0;
+            if (modelId) {
+                const c = computeCost(modelId, r.input_tokens, r.output_tokens, r.cached_tokens ?? 0);
+                inputCost += c.inputCost;
+                outputCost += c.outputCost;
+                cacheSavings += c.cacheSavings;
+            }
+        }
+        costByModel.push({
+            model,
+            requestCount: recs.length,
+            totalInputTokens: totalInput,
+            totalOutputTokens: totalOutput,
+            totalCachedTokens: totalCached,
+            inputCost,
+            outputCost,
+            cacheSavings,
+            totalCost: inputCost + outputCost,
+        });
+    }
+    // ---- aggregates ----
+    const totalRequests = records.length;
+    const totalCost = costByModel.reduce((s, m) => s + m.totalCost, 0);
+    const totalInputTokens = costByModel.reduce((s, m) => s + m.totalInputTokens, 0);
+    const totalOutputTokens = costByModel.reduce((s, m) => s + m.totalOutputTokens, 0);
+    const totalCachedTokens = costByModel.reduce((s, m) => s + m.totalCachedTokens, 0);
+    const avgCostPerRequest = totalRequests > 0 ? totalCost / totalRequests : 0;
+    // ---- waste estimation ----
+    let unusedToolTokens = 0;
+    let oversizedPromptTokens = 0;
+    for (const r of records) {
+        if (r.tool_definitions && r.tool_definitions > 5) {
+            // Estimate ~40% of tool tokens are typically unused per request
+            unusedToolTokens += Math.round(r.tool_definitions * AVG_TOKENS_PER_TOOL_DEF * 0.4);
+        }
+        if (r.system_prompt_tokens && r.system_prompt_tokens > SYSTEM_PROMPT_OVERSIZE_THRESHOLD) {
+            oversizedPromptTokens += r.system_prompt_tokens - SYSTEM_PROMPT_OVERSIZE_THRESHOLD;
+        }
+    }
+    // Estimate waste cost using a blended average input price
+    const avgInputPrice = totalInputTokens > 0 ? costByModel.reduce((s, m) => {
+        const mid = resolveModelId(m.model);
+        if (!mid)
+            return s;
+        return s + (m.totalInputTokens / totalInputTokens) * MODEL_PRICING[mid].inputPerMillion;
+    }, 0) : 3; // default to Sonnet-class pricing
+    const wasteTokens = unusedToolTokens + oversizedPromptTokens;
+    const wasteCost = (wasteTokens / 1_000_000) * avgInputPrice;
+    const wastePercentage = totalCost > 0 ? (wasteCost / totalCost) * 100 : 0;
+    // ---- trends ----
+    const daily = computeTrends(records, "day");
+    const weekly = computeTrends(records, "week");
+    return {
+        summary: {
+            totalRequests,
+            totalCost,
+            avgCostPerRequest,
+            totalInputTokens,
+            totalOutputTokens,
+            totalCachedTokens,
+        },
+        costByModel,
+        wasteEstimation: {
+            unusedToolDefinitionTokens: unusedToolTokens,
+            oversizedSystemPromptTokens: oversizedPromptTokens,
+            estimatedWasteCost: wasteCost,
+            wastePercentage,
+        },
+        trends: { daily, weekly },
+    };
+}
+// ---------------------------------------------------------------------------
+// Trend helpers
+// ---------------------------------------------------------------------------
+function computeTrends(records, granularity) {
+    const buckets = new Map();
+    for (const r of records) {
+        const d = new Date(r.timestamp);
+        if (isNaN(d.getTime()))
+            continue;
+        let key;
+        if (granularity === "day") {
+            key = d.toISOString().slice(0, 10);
+        }
+        else {
+            // ISO week: use Monday of the week
+            const day = d.getDay();
+            const diff = d.getDate() - day + (day === 0 ? -6 : 1);
+            const monday = new Date(d);
+            monday.setDate(diff);
+            key = `Week of ${monday.toISOString().slice(0, 10)}`;
+        }
+        if (!buckets.has(key))
+            buckets.set(key, []);
+        buckets.get(key).push(r);
+    }
+    const points = [];
+    for (const [period, recs] of [...buckets].sort((a, b) => a[0].localeCompare(b[0]))) {
+        let totalCost = 0;
+        for (const r of recs) {
+            const mid = resolveModelId(r.model);
+            if (mid) {
+                totalCost += computeCost(mid, r.input_tokens, r.output_tokens, r.cached_tokens ?? 0).totalCost;
+            }
+        }
+        points.push({
+            period,
+            requestCount: recs.length,
+            totalCost,
+            avgCostPerRequest: recs.length > 0 ? totalCost / recs.length : 0,
+        });
+    }
+    return points;
+}
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+function formatAnalysis(a) {
+    const lines = [];
+    lines.push("# AI API Usage Analysis\n");
+    // Summary
+    lines.push("## Summary");
+    lines.push(`- **Total Requests:** ${a.summary.totalRequests.toLocaleString()}`);
+    lines.push(`- **Total Cost:** $${a.summary.totalCost.toFixed(4)}`);
+    lines.push(`- **Avg Cost/Request:** $${a.summary.avgCostPerRequest.toFixed(6)}`);
+    lines.push(`- **Total Input Tokens:** ${a.summary.totalInputTokens.toLocaleString()}`);
+    lines.push(`- **Total Output Tokens:** ${a.summary.totalOutputTokens.toLocaleString()}`);
+    lines.push(`- **Total Cached Tokens:** ${a.summary.totalCachedTokens.toLocaleString()}`);
+    lines.push("");
+    // Cost by model
+    lines.push("## Cost Breakdown by Model");
+    lines.push("| Model | Requests | Input Cost | Output Cost | Cache Savings | Total Cost |");
+    lines.push("|-------|----------|------------|-------------|---------------|------------|");
+    for (const m of a.costByModel) {
+        lines.push(`| ${m.model} | ${m.requestCount} | $${m.inputCost.toFixed(4)} | $${m.outputCost.toFixed(4)} | $${m.cacheSavings.toFixed(4)} | $${m.totalCost.toFixed(4)} |`);
+    }
+    lines.push("");
+    // Waste
+    lines.push("## Token Waste Estimation");
+    lines.push(`- **Unused Tool Definition Tokens:** ~${a.wasteEstimation.unusedToolDefinitionTokens.toLocaleString()}`);
+    lines.push(`- **Oversized System Prompt Tokens:** ~${a.wasteEstimation.oversizedSystemPromptTokens.toLocaleString()}`);
+    lines.push(`- **Estimated Waste Cost:** $${a.wasteEstimation.estimatedWasteCost.toFixed(4)} (${a.wasteEstimation.wastePercentage.toFixed(1)}% of total)`);
+    lines.push("");
+    // Trends
+    if (a.trends.daily.length > 0) {
+        lines.push("## Daily Trends");
+        lines.push("| Date | Requests | Total Cost | Avg Cost/Req |");
+        lines.push("|------|----------|------------|--------------|");
+        for (const t of a.trends.daily) {
+            lines.push(`| ${t.period} | ${t.requestCount} | $${t.totalCost.toFixed(4)} | $${t.avgCostPerRequest.toFixed(6)} |`);
+        }
+        lines.push("");
+    }
+    if (a.trends.weekly.length > 0) {
+        lines.push("## Weekly Trends");
+        lines.push("| Week | Requests | Total Cost | Avg Cost/Req |");
+        lines.push("|------|----------|------------|--------------|");
+        for (const t of a.trends.weekly) {
+            lines.push(`| ${t.period} | ${t.requestCount} | $${t.totalCost.toFixed(4)} | $${t.avgCostPerRequest.toFixed(6)} |`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=analyze.js.map

package/dist/tools/analyze.js.map

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

package/dist/tools/compare.d.ts

@@ -0,0 +1,6 @@
+/**
+ * compare_models tool -- compares cost and quality across LLM models
+ * for a given task description.
+ */
+export declare function handleCompareModels(taskDescription: string, estimatedInputTokens?: number, estimatedOutputTokens?: number): string;
+//# sourceMappingURL=compare.d.ts.map

package/dist/tools/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/tools/compare.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgKH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,MAAM,EACvB,oBAAoB,CAAC,EAAE,MAAM,EAC7B,qBAAqB,CAAC,EAAE,MAAM,GAC7B,MAAM,CA8GR"}

package/dist/tools/compare.js

@@ -0,0 +1,212 @@
+/**
+ * compare_models tool -- compares cost and quality across LLM models
+ * for a given task description.
+ */
+import { MODEL_PRICING } from "./pricing.js";
+const SIMPLE_KEYWORDS = [
+    "classify", "classification", "categorize", "label", "tag",
+    "extract", "extraction", "parse", "format", "convert",
+    "summarize", "summary", "tldr", "translate", "translation",
+    "sentiment", "detect", "filter", "validate", "check",
+    "yes/no", "true/false", "simple",
+];
+const COMPLEX_KEYWORDS = [
+    "analyze", "analysis", "research", "write", "essay", "article",
+    "code", "implement", "build", "create", "design", "architect",
+    "debug", "refactor", "review", "reason", "explain", "teach",
+    "creative", "novel", "brainstorm", "strategy", "plan",
+    "math", "proof", "complex", "multi-step", "nuanced",
+];
+function classifyTask(description) {
+    const lower = description.toLowerCase();
+    const words = lower.split(/\s+/);
+    const wordCount = words.length;
+    let simpleScore = 0;
+    let complexScore = 0;
+    for (const kw of SIMPLE_KEYWORDS) {
+        if (lower.includes(kw))
+            simpleScore++;
+    }
+    for (const kw of COMPLEX_KEYWORDS) {
+        if (lower.includes(kw))
+            complexScore++;
+    }
+    let complexity;
+    let estimatedInputTokens;
+    let estimatedOutputTokens;
+    if (complexScore > simpleScore || wordCount > 50) {
+        complexity = "complex";
+        estimatedInputTokens = 4000;
+        estimatedOutputTokens = 2000;
+    }
+    else if (simpleScore > complexScore) {
+        complexity = "simple";
+        estimatedInputTokens = 500;
+        estimatedOutputTokens = 200;
+    }
+    else {
+        complexity = "moderate";
+        estimatedInputTokens = 1500;
+        estimatedOutputTokens = 800;
+    }
+    return { complexity, estimatedInputTokens, estimatedOutputTokens, description };
+}
+const MODEL_INFO = {
+    "claude-opus": {
+        modelId: "claude-opus",
+        qualityLabel: "Frontier",
+        recommendation: "Best-in-class for complex reasoning, research, and agentic tasks. Premium pricing.",
+        bestFor: [
+            "Complex multi-step reasoning",
+            "Research and analysis",
+            "Agentic coding workflows",
+            "Nuanced creative writing",
+            "Tasks requiring highest accuracy",
+        ],
+    },
+    "claude-sonnet": {
+        modelId: "claude-sonnet",
+        qualityLabel: "Strong",
+        recommendation: "Best balance of quality and cost. Ideal default for most production workloads.",
+        bestFor: [
+            "General-purpose AI applications",
+            "Code generation and review",
+            "Content creation",
+            "Data analysis",
+            "Customer-facing chatbots",
+        ],
+    },
+    "claude-haiku": {
+        modelId: "claude-haiku",
+        qualityLabel: "Fast / Economy",
+        recommendation: "Fastest and most affordable Claude model. Great for high-volume, simpler tasks.",
+        bestFor: [
+            "Classification and tagging",
+            "Data extraction",
+            "Simple Q&A",
+            "Content moderation",
+            "High-volume batch processing",
+        ],
+    },
+    "gpt-4o": {
+        modelId: "gpt-4o",
+        qualityLabel: "Strong",
+        recommendation: "Strong multimodal model with good cost efficiency. Competitive with Sonnet.",
+        bestFor: [
+            "Multimodal tasks (image + text)",
+            "General-purpose applications",
+            "Structured data extraction",
+            "Code generation",
+            "Function calling",
+        ],
+    },
+    "gpt-4o-mini": {
+        modelId: "gpt-4o-mini",
+        qualityLabel: "Fast / Economy",
+        recommendation: "Very affordable for simple tasks. Good alternative to Haiku for OpenAI users.",
+        bestFor: [
+            "Simple classification",
+            "Text extraction",
+            "Lightweight summarization",
+            "Batch processing on budget",
+            "Prototyping and testing",
+        ],
+    },
+    "gemini-2.0-flash": {
+        modelId: "gemini-2.0-flash",
+        qualityLabel: "Fast / Economy",
+        recommendation: "Cheapest option with massive 1M context window. Best for long-context budget tasks.",
+        bestFor: [
+            "Long document processing",
+            "Large context window needs (1M tokens)",
+            "Budget-conscious batch jobs",
+            "Simple extraction from large docs",
+            "High-volume low-complexity tasks",
+        ],
+    },
+};
+// ---------------------------------------------------------------------------
+// Main handler
+// ---------------------------------------------------------------------------
+export function handleCompareModels(taskDescription, estimatedInputTokens, estimatedOutputTokens) {
+    const task = classifyTask(taskDescription);
+    // Allow user overrides for token estimates
+    if (estimatedInputTokens !== undefined)
+        task.estimatedInputTokens = estimatedInputTokens;
+    if (estimatedOutputTokens !== undefined)
+        task.estimatedOutputTokens = estimatedOutputTokens;
+    const lines = [];
+    lines.push("# Model Comparison\n");
+    lines.push(`**Task:** ${taskDescription}`);
+    lines.push(`**Estimated Complexity:** ${capitalize(task.complexity)}`);
+    lines.push(`**Estimated Tokens:** ~${task.estimatedInputTokens.toLocaleString()} input, ~${task.estimatedOutputTokens.toLocaleString()} output`);
+    lines.push("");
+    // Cost comparison table
+    lines.push("## Cost Comparison\n");
+    lines.push("| Model | Provider | Tier | Cost/Request | Cost/1K Requests | Monthly (10K req) |");
+    lines.push("|-------|----------|------|-------------|------------------|-------------------|");
+    const entries = [];
+    for (const [id, pricing] of Object.entries(MODEL_PRICING)) {
+        const mid = id;
+        const inputCost = (task.estimatedInputTokens / 1_000_000) * pricing.inputPerMillion;
+        const outputCost = (task.estimatedOutputTokens / 1_000_000) * pricing.outputPerMillion;
+        const costPerReq = inputCost + outputCost;
+        const per1k = costPerReq * 1000;
+        const monthly = costPerReq * 10_000;
+        entries.push({ id: mid, costPerReq, per1k, monthly });
+        const info = MODEL_INFO[mid];
+        lines.push(`| ${pricing.name} | ${pricing.provider} | ${info.qualityLabel} | $${costPerReq.toFixed(6)} | $${per1k.toFixed(2)} | $${monthly.toFixed(2)} |`);
+    }
+    lines.push("");
+    // Sort by cost for ranking
+    entries.sort((a, b) => a.costPerReq - b.costPerReq);
+    const cheapest = entries[0];
+    const mostExpensive = entries[entries.length - 1];
+    const ratio = mostExpensive.costPerReq / cheapest.costPerReq;
+    lines.push("## Cost Spread");
+    lines.push(`- **Cheapest:** ${MODEL_PRICING[cheapest.id].name} at $${cheapest.costPerReq.toFixed(6)}/request`);
+    lines.push(`- **Most Expensive:** ${MODEL_PRICING[mostExpensive.id].name} at $${mostExpensive.costPerReq.toFixed(6)}/request`);
+    lines.push(`- **Price Ratio:** ${ratio.toFixed(0)}x difference between cheapest and most expensive`);
+    lines.push("");
+    // Recommendations by task complexity
+    lines.push("## Recommendations\n");
+    if (task.complexity === "simple") {
+        lines.push(`For this **simple** task, we recommend **${MODEL_PRICING["claude-haiku"].name}** or **${MODEL_PRICING["gemini-2.0-flash"].name}**.`);
+        lines.push("");
+        lines.push("Simple tasks (classification, extraction, formatting) rarely benefit from frontier models. " +
+            "Using an economy-tier model can save 90%+ without meaningful quality loss.");
+    }
+    else if (task.complexity === "moderate") {
+        lines.push(`For this **moderate** task, we recommend **${MODEL_PRICING["claude-sonnet"].name}** or **${MODEL_PRICING["gpt-4o"].name}**.`);
+        lines.push("");
+        lines.push("Moderate tasks benefit from strong reasoning but don't require frontier-tier models. " +
+            "Sonnet and GPT-4o offer an excellent quality-to-cost ratio.");
+    }
+    else {
+        lines.push(`For this **complex** task, we recommend **${MODEL_PRICING["claude-opus"].name}** for best quality, ` +
+            `or **${MODEL_PRICING["claude-sonnet"].name}** for a cost-effective alternative.`);
+        lines.push("");
+        lines.push("Complex reasoning, multi-step analysis, and creative tasks benefit most from frontier models. " +
+            "Consider using Opus for critical tasks and Sonnet for iterations/drafts.");
+    }
+    lines.push("");
+    // Per-model details
+    lines.push("## Model Details\n");
+    for (const [id, info] of Object.entries(MODEL_INFO)) {
+        const mid = id;
+        const pricing = MODEL_PRICING[mid];
+        lines.push(`### ${pricing.name} (${pricing.provider})`);
+        lines.push(`> ${info.recommendation}`);
+        lines.push("");
+        lines.push("**Best for:**");
+        for (const b of info.bestFor) {
+            lines.push(`- ${b}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=compare.js.map

package/dist/tools/compare.js.map

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

package/dist/tools/optimize.d.ts

@@ -0,0 +1,6 @@
+/**
+ * optimize_prompt tool -- analyzes system prompts and tool definitions,
+ * returns an optimized version with recommendations.
+ */
+export declare function handleOptimizePrompt(systemPrompt: string, toolDefinitions: string[], requestsPerMonth?: number, model?: string): string;
+//# sourceMappingURL=optimize.d.ts.map

package/dist/tools/optimize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize.d.ts","sourceRoot":"","sources":["../../src/tools/optimize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EAAE,EACzB,gBAAgB,CAAC,EAAE,MAAM,EACzB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAsGR"}