@getverbal/cli 0.5.0 → 0.6.0

package/dist/mcp/tools/get-model-efficiency.js

@@ -0,0 +1,137 @@
+/**
+ * MCP Tool: get_model_efficiency
+ * Per-model cost efficiency comparison and recommendations
+ */
+export async function getModelEfficiency(apiKey, apiUrl, params = {}) {
+    try {
+        const timeframe = params.timeframe || '30d';
+        // Call backend endpoint
+        const response = await fetch(`${apiUrl}/api/v1/roi/model-efficiency?timeframe=${timeframe}`, {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${apiKey}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            return `Error: Failed to fetch model efficiency (${response.status})`;
+        }
+        const data = (await response.json());
+        // Format for natural language display
+        let output = `⚡ Model Efficiency Comparison (${timeframe})
+
+`;
+        // Organization average
+        output += `━━━ Organization Average ━━━
+`;
+        output += `💰 Cost/Token: $${data.organization_average.avg_cost_per_token.toFixed(8)}
+`;
+        output += `🎯 Efficiency Score: ${data.organization_average.avg_efficiency_score}/100
+`;
+        output += `✨ Quality Score: ${data.organization_average.avg_quality_score}/100
+`;
+        output += `📊 Models Used: ${data.organization_average.total_models}
+`;
+        output += `💵 Total Spend: $${data.organization_average.total_cost.toFixed(2)}
+`;
+        output += `🔤 Total Tokens: ${formatLargeNumber(data.organization_average.total_tokens)}
+
+`;
+        // Most efficient models
+        if (data.top_efficient.models.length > 0) {
+            output += `━━━ Most Cost-Efficient Models ━━━
+`;
+            data.top_efficient.models.forEach((model, idx) => {
+                output += `${idx + 1}. ${model.model}
+`;
+                output += `   💰 Cost: $${model.cost_per_token.toFixed(8)}/token
+`;
+                output += `   🎯 Efficiency: ${model.efficiency_score}/100
+`;
+                output += `   ✨ Quality: ${model.quality_score}/100
+`;
+            });
+            output += '\n';
+        }
+        // Least efficient models
+        if (data.bottom_efficient.models.length > 0) {
+            output += `━━━ Least Cost-Efficient Models ━━━
+`;
+            data.bottom_efficient.models.forEach((model, idx) => {
+                output += `${idx + 1}. ${model.model}
+`;
+                output += `   💰 Cost: $${model.cost_per_token.toFixed(8)}/token
+`;
+                output += `   🎯 Efficiency: ${model.efficiency_score}/100
+`;
+                output += `   ✨ Quality: ${model.quality_score}/100
+`;
+            });
+            output += '\n';
+        }
+        // All models ranked
+        output += `━━━ All Models Ranked by Efficiency ━━━
+`;
+        data.models.slice(0, 10).forEach((model, idx) => {
+            const statusIcon = getStatusIcon(model.efficiency_score);
+            output += `${idx + 1}. ${statusIcon} ${model.model}
+`;
+            output += `   Cost: $${model.cost_per_token.toFixed(8)}/token | Quality: ${model.quality_score}/100
+`;
+            output += `   ${model.recommendation}
+`;
+        });
+        if (data.models.length > 10) {
+            output += `
+... and ${data.models.length - 10} more models
+
+`;
+        }
+        else {
+            output += '\n';
+        }
+        // Recommendations
+        if (data.recommendations.length > 0) {
+            output += `━━━ Recommendations ━━━
+`;
+            data.recommendations.forEach((rec) => {
+                output += `${rec}
+`;
+            });
+            output += '\n';
+        }
+        // Insights
+        output += `━━━ Key Insights ━━━
+`;
+        data.insights.forEach((insight) => {
+            output += `${insight}
+`;
+        });
+        return output;
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return `Error fetching model efficiency: ${msg}`;
+    }
+}
+function getStatusIcon(efficiencyScore) {
+    if (efficiencyScore < 20)
+        return '💎';
+    if (efficiencyScore < 40)
+        return '✅';
+    if (efficiencyScore < 60)
+        return '⚠️';
+    if (efficiencyScore < 80)
+        return '❌';
+    return '🚫';
+}
+function formatLargeNumber(num) {
+    if (num >= 1000000) {
+        return `${(num / 1000000).toFixed(2)}M`;
+    }
+    if (num >= 1000) {
+        return `${(num / 1000).toFixed(2)}K`;
+    }
+    return num.toFixed(0);
+}
+//# sourceMappingURL=get-model-efficiency.js.map

package/dist/mcp/tools/get-model-efficiency.js.map

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

package/dist/mcp/tools/get-recent-prompts.d.ts

@@ -0,0 +1,13 @@
+/**
+ * MCP Tool: get_recent_prompts
+ * Retrieve recent prompts with filtering
+ */
+export interface GetRecentPromptsParams {
+    limit?: number;
+    offset?: number;
+    provider?: string;
+    model?: string;
+    include_content?: boolean;
+}
+export declare function getRecentPrompts(apiKey: string, apiUrl: string, params?: GetRecentPromptsParams): Promise<string>;
+//# sourceMappingURL=get-recent-prompts.d.ts.map

package/dist/mcp/tools/get-recent-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-recent-prompts.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/get-recent-prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,sBAA2B,GAClC,OAAO,CAAC,MAAM,CAAC,CAyDjB"}

package/dist/mcp/tools/get-recent-prompts.js

@@ -0,0 +1,56 @@
+/**
+ * MCP Tool: get_recent_prompts
+ * Retrieve recent prompts with filtering
+ */
+export async function getRecentPrompts(apiKey, apiUrl, params = {}) {
+    try {
+        const limit = params.limit || 10;
+        const offset = params.offset || 0;
+        const includeContent = params.include_content ? 'true' : 'false';
+        let url = `${apiUrl}/api/v1/usage/prompts?limit=${limit}&offset=${offset}&include_content=${includeContent}`;
+        if (params.provider) {
+            url += `&provider=${params.provider}`;
+        }
+        if (params.model) {
+            url += `&model=${params.model}`;
+        }
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${apiKey}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            return `Error: Failed to fetch prompts (${response.status})`;
+        }
+        const data = (await response.json());
+        // Format for natural language display
+        let output = `📝 Recent Prompts (${data.prompts?.length || 0} results)
+
+`;
+        if (data.prompts && data.prompts.length > 0) {
+            data.prompts.forEach((prompt, idx) => {
+                output += `[${idx + 1}] ${prompt.provider} / ${prompt.model}
+`;
+                output += `    ${prompt.preview || '(empty)'}
+`;
+                output += `    Cost: $${prompt.cost?.toFixed(4)} | In: ${prompt.tokens_in} | Out: ${prompt.tokens_out}
+`;
+                output += `    ${new Date(prompt.created_at).toLocaleString()}
+
+`;
+            });
+        }
+        if (data.has_more) {
+            output += `... and ${data.total - (offset + limit)} more results available
+`;
+        }
+        return output;
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return `Error fetching recent prompts: ${msg}`;
+    }
+}
+//# sourceMappingURL=get-recent-prompts.js.map

package/dist/mcp/tools/get-recent-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-recent-prompts.js","sourceRoot":"","sources":["../../../src/mcp/tools/get-recent-prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAc,EACd,MAAc,EACd,SAAiC,EAAE;IAEnC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QAClC,MAAM,cAAc,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QAEjE,IAAI,GAAG,GAAG,GAAG,MAAM,+BAA+B,KAAK,WAAW,MAAM,oBAAoB,cAAc,EAAE,CAAC;QAC7G,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,GAAG,IAAI,aAAa,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxC,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,GAAG,IAAI,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,eAAe,EAAE,UAAU,MAAM,EAAE;gBACnC,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,mCAAmC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAC/D,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAQ,CAAC;QAE5C,sCAAsC;QACtC,IAAI,MAAM,GAAG,sBAAsB,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;;CAE/D,CAAC;QAEE,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAW,EAAE,GAAW,EAAE,EAAE;gBAChD,MAAM,IAAI,IAAI,GAAG,GAAG,CAAC,KAAK,MAAM,CAAC,QAAQ,MAAM,MAAM,CAAC,KAAK;CAClE,CAAC;gBACM,MAAM,IAAI,OAAO,MAAM,CAAC,OAAO,IAAI,SAAS;CACnD,CAAC;gBACM,MAAM,IAAI,cAAc,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,SAAS,WAAW,MAAM,CAAC,UAAU;CAC5G,CAAC;gBACM,MAAM,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,cAAc,EAAE;;CAEpE,CAAC;YACI,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,WAAW,IAAI,CAAC,KAAK,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC;CACvD,CAAC;QACE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,OAAO,kCAAkC,GAAG,EAAE,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/mcp/tools/get-roi-metrics.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP Tool: get_roi_metrics
+ * Calculate ROI and efficiency metrics with trend comparison
+ */
+export interface GetRoiMetricsParams {
+    timeframe?: '7d' | '30d' | '90d';
+}
+export declare function getRoiMetrics(apiKey: string, apiUrl: string, params?: GetRoiMetricsParams): Promise<string>;
+//# sourceMappingURL=get-roi-metrics.d.ts.map

package/dist/mcp/tools/get-roi-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-roi-metrics.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/get-roi-metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;CAClC;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,mBAAwB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAqEjB"}

package/dist/mcp/tools/get-roi-metrics.js

@@ -0,0 +1,84 @@
+/**
+ * MCP Tool: get_roi_metrics
+ * Calculate ROI and efficiency metrics with trend comparison
+ */
+export async function getRoiMetrics(apiKey, apiUrl, params = {}) {
+    try {
+        const timeframe = params.timeframe || '30d';
+        // Call backend endpoint
+        const response = await fetch(`${apiUrl}/api/v1/roi/metrics?timeframe=${timeframe}`, {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${apiKey}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            return `Error: Failed to fetch ROI metrics (${response.status})`;
+        }
+        const data = (await response.json());
+        // Format for natural language display
+        let output = `📊 ROI & Efficiency Metrics (Last ${timeframe})
+
+`;
+        // Current metrics
+        output += `━━━ Current Period ━━━
+`;
+        output += `💰 Total Spend: $${data.current.totalCost.toFixed(2)}
+`;
+        output += `📈 Total Tokens: ${formatLargeNumber(data.current.totalTokens)}
+`;
+        output += `⚡ Cost/Token: $${data.current.costPerToken.toFixed(8)}
+`;
+        output += `📊 Daily Average: $${data.current.costPerDay.toFixed(2)}
+`;
+        output += `🎯 Efficiency Score: ${data.current.efficiencyScore}/100${getEfficiencyLabel(data.current.efficiencyScore)}
+
+`;
+        // Previous period comparison
+        output += `━━━ Previous Period Comparison ━━━
+`;
+        const costChangeSymbol = data.trends.costChange > 0 ? '📈' : data.trends.costChange < 0 ? '📉' : '→';
+        const efficiencyChangeSymbol = data.trends.efficiencyChange > 0 ? '⬆️' : data.trends.efficiencyChange < 0 ? '⬇️' : '→';
+        output += `${costChangeSymbol} Cost Change: ${Math.abs(data.trends.costChange).toFixed(1)}% (${data.trends.costDirection})
+`;
+        output += `${efficiencyChangeSymbol} Efficiency: ${Math.abs(data.trends.efficiencyChange).toFixed(1)}% (${data.trends.efficiencyDirection})
+`;
+        output += `Cost/Token: $${data.previous.costPerToken.toFixed(8)}
+
+`;
+        // Insights
+        output += `━━━ Insights ━━━
+`;
+        data.insights.forEach((insight) => {
+            output += `${insight}
+`;
+        });
+        return output;
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return `Error fetching ROI metrics: ${msg}`;
+    }
+}
+function getEfficiencyLabel(score) {
+    if (score < 20)
+        return ' (Excellent)';
+    if (score < 40)
+        return ' (Good)';
+    if (score < 60)
+        return ' (Fair)';
+    if (score < 80)
+        return ' (Poor)';
+    return ' (Very Poor)';
+}
+function formatLargeNumber(num) {
+    if (num >= 1000000) {
+        return `${(num / 1000000).toFixed(2)}M`;
+    }
+    if (num >= 1000) {
+        return `${(num / 1000).toFixed(2)}K`;
+    }
+    return num.toFixed(0);
+}
+//# sourceMappingURL=get-roi-metrics.js.map

package/dist/mcp/tools/get-roi-metrics.js.map

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

package/dist/mcp/tools/get-usage-summary.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP Tool: get_usage_summary
+ * Get aggregated usage data for LLM spending
+ */
+export interface GetUsageSummaryParams {
+    timeframe?: '7d' | '30d' | '90d';
+    group_by?: 'provider' | 'model' | 'project';
+}
+export declare function getUsageSummary(apiKey: string, apiUrl: string, params?: GetUsageSummaryParams): Promise<string>;
+//# sourceMappingURL=get-usage-summary.d.ts.map

package/dist/mcp/tools/get-usage-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-usage-summary.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/get-usage-summary.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;IACjC,QAAQ,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;CAC7C;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,qBAA0B,GACjC,OAAO,CAAC,MAAM,CAAC,CAkDjB"}

package/dist/mcp/tools/get-usage-summary.js

@@ -0,0 +1,47 @@
+/**
+ * MCP Tool: get_usage_summary
+ * Get aggregated usage data for LLM spending
+ */
+export async function getUsageSummary(apiKey, apiUrl, params = {}) {
+    try {
+        const timeframe = params.timeframe || '30d';
+        const groupBy = params.group_by || 'provider';
+        // Call backend endpoint
+        const response = await fetch(`${apiUrl}/api/v1/usage/breakdown?timeframe=${timeframe}&group_by=${groupBy}`, {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${apiKey}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            return `Error: Failed to fetch usage summary (${response.status})`;
+        }
+        const data = (await response.json());
+        // Format for natural language display
+        let output = `📊 Usage Summary (Last ${timeframe})
+
+`;
+        output += `Total Spend: $${data.total_cost.toFixed(2)}
+
+`;
+        if (data.breakdown && data.breakdown.length > 0) {
+            output += `Breakdown by ${groupBy}:
+`;
+            data.breakdown.slice(0, 5).forEach((item) => {
+                output += `• ${item.name}: $${item.cost.toFixed(2)} (${item.percentage.toFixed(1)}%)
+`;
+            });
+            if (data.breakdown.length > 5) {
+                output += `... and ${data.breakdown.length - 5} more
+`;
+            }
+        }
+        return output;
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return `Error fetching usage summary: ${msg}`;
+    }
+}
+//# sourceMappingURL=get-usage-summary.js.map

package/dist/mcp/tools/get-usage-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-usage-summary.js","sourceRoot":"","sources":["../../../src/mcp/tools/get-usage-summary.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,MAAc,EACd,SAAgC,EAAE;IAElC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,IAAI,UAAU,CAAC;QAE9C,wBAAwB;QACxB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,MAAM,qCAAqC,SAAS,aAAa,OAAO,EAAE,EAC7E;YACE,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,eAAe,EAAE,UAAU,MAAM,EAAE;gBACnC,cAAc,EAAE,kBAAkB;aACnC;SACF,CACF,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,yCAAyC,QAAQ,CAAC,MAAM,GAAG,CAAC;QACrE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAQ,CAAC;QAE5C,sCAAsC;QACtC,IAAI,MAAM,GAAG,0BAA0B,SAAS;;CAEnD,CAAC;QACE,MAAM,IAAI,iBAAiB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;;CAExD,CAAC;QAEE,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,gBAAgB,OAAO;CACtC,CAAC;YACI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAS,EAAE,EAAE;gBAC/C,MAAM,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;CACxF,CAAC;YACI,CAAC,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;CACrD,CAAC;YACI,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,OAAO,iCAAiC,GAAG,EAAE,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/mcp/tools/index.d.ts

@@ -0,0 +1,221 @@
+/**
+ * MCP Tools Registry
+ * Exports all available tools for Claude Desktop integration
+ */
+export { getUsageSummary } from './get-usage-summary.js';
+export type { GetUsageSummaryParams } from './get-usage-summary.js';
+export { getBudgetStatus } from './get-budget-status.js';
+export type { GetBudgetStatusParams } from './get-budget-status.js';
+export { getRecentPrompts } from './get-recent-prompts.js';
+export type { GetRecentPromptsParams } from './get-recent-prompts.js';
+export { listProjects } from './list-projects.js';
+export { getCostBreakdown } from './get-cost-breakdown.js';
+export type { GetCostBreakdownParams } from './get-cost-breakdown.js';
+export { getRoiMetrics } from './get-roi-metrics.js';
+export type { GetRoiMetricsParams } from './get-roi-metrics.js';
+export { analyzeSpendingTrend } from './analyze-spending-trend.js';
+export type { AnalyzeSpendingTrendParams } from './analyze-spending-trend.js';
+export { getModelEfficiency } from './get-model-efficiency.js';
+export type { GetModelEfficiencyParams } from './get-model-efficiency.js';
+import { optimizePromptTool, OPTIMIZE_PROMPT_TOOL } from './optimize-prompt.js';
+export { optimizePromptTool, OPTIMIZE_PROMPT_TOOL };
+/**
+ * Tool definitions for MCP server registration
+ */
+export declare const MCP_TOOLS: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        required: string[];
+        properties: {
+            prompt: {
+                type: "string";
+                description: string;
+            };
+            context: {
+                type: "string";
+                description: string;
+            };
+            threshold: {
+                type: "number";
+                description: string;
+                minimum: number;
+                maximum: number;
+            };
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            timeframe: {
+                type: "string";
+                enum: string[];
+                description: string;
+            };
+            group_by: {
+                type: "string";
+                enum: string[];
+                description: string;
+            };
+            break_down_by?: undefined;
+            limit?: undefined;
+            offset?: undefined;
+            provider?: undefined;
+            model?: undefined;
+            include_content?: undefined;
+            project_id?: undefined;
+            metric?: undefined;
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            timeframe: {
+                type: "string";
+                enum: string[];
+                description: string;
+            };
+            break_down_by: {
+                type: "string";
+                enum: string[];
+                description: string;
+            };
+            group_by?: undefined;
+            limit?: undefined;
+            offset?: undefined;
+            provider?: undefined;
+            model?: undefined;
+            include_content?: undefined;
+            project_id?: undefined;
+            metric?: undefined;
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            limit: {
+                type: "number";
+                description: string;
+            };
+            offset: {
+                type: "number";
+                description: string;
+            };
+            provider: {
+                type: "string";
+                description: string;
+            };
+            model: {
+                type: "string";
+                description: string;
+            };
+            include_content: {
+                type: "boolean";
+                description: string;
+            };
+            timeframe?: undefined;
+            group_by?: undefined;
+            break_down_by?: undefined;
+            project_id?: undefined;
+            metric?: undefined;
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            project_id: {
+                type: "string";
+                description: string;
+            };
+            timeframe?: undefined;
+            group_by?: undefined;
+            break_down_by?: undefined;
+            limit?: undefined;
+            offset?: undefined;
+            provider?: undefined;
+            model?: undefined;
+            include_content?: undefined;
+            metric?: undefined;
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            timeframe?: undefined;
+            group_by?: undefined;
+            break_down_by?: undefined;
+            limit?: undefined;
+            offset?: undefined;
+            provider?: undefined;
+            model?: undefined;
+            include_content?: undefined;
+            project_id?: undefined;
+            metric?: undefined;
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            timeframe: {
+                type: "string";
+                enum: string[];
+                description: string;
+            };
+            group_by?: undefined;
+            break_down_by?: undefined;
+            limit?: undefined;
+            offset?: undefined;
+            provider?: undefined;
+            model?: undefined;
+            include_content?: undefined;
+            project_id?: undefined;
+            metric?: undefined;
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            timeframe: {
+                type: "string";
+                enum: string[];
+                description: string;
+            };
+            metric: {
+                type: "string";
+                enum: string[];
+                description: string;
+            };
+            group_by?: undefined;
+            break_down_by?: undefined;
+            limit?: undefined;
+            offset?: undefined;
+            provider?: undefined;
+            model?: undefined;
+            include_content?: undefined;
+            project_id?: undefined;
+        };
+    };
+})[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAGtE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAE9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAG1E,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2IrB,CAAC"}