@getverbal/cli 0.4.3 → 0.6.0

package/dist/mcp/tools/index.js

@@ -0,0 +1,161 @@
+/**
+ * MCP Tools Registry
+ * Exports all available tools for Claude Desktop integration
+ */
+// Phase 1 Tools
+export { getUsageSummary } from './get-usage-summary.js';
+export { getBudgetStatus } from './get-budget-status.js';
+export { getRecentPrompts } from './get-recent-prompts.js';
+export { listProjects } from './list-projects.js';
+export { getCostBreakdown } from './get-cost-breakdown.js';
+// Phase 2 Tools - ROI Metrics
+export { getRoiMetrics } from './get-roi-metrics.js';
+export { analyzeSpendingTrend } from './analyze-spending-trend.js';
+export { getModelEfficiency } from './get-model-efficiency.js';
+// Phase 3 Tools - Prompt Optimization
+import { optimizePromptTool, OPTIMIZE_PROMPT_TOOL } from './optimize-prompt.js';
+export { optimizePromptTool, OPTIMIZE_PROMPT_TOOL };
+/**
+ * Tool definitions for MCP server registration
+ */
+export const MCP_TOOLS = [
+    {
+        name: 'get_usage_summary',
+        description: 'Get aggregated usage data for your LLM spending with time period filtering',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                timeframe: {
+                    type: 'string',
+                    enum: ['7d', '30d', '90d'],
+                    description: 'Time period to analyze (default: 30d)',
+                },
+                group_by: {
+                    type: 'string',
+                    enum: ['provider', 'model', 'project'],
+                    description: 'How to group the usage data (default: provider)',
+                },
+            },
+        },
+    },
+    {
+        name: 'get_cost_breakdown',
+        description: 'Analyze your LLM spending breakdown by category with trends',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                timeframe: {
+                    type: 'string',
+                    enum: ['7d', '30d', '90d'],
+                    description: 'Time period to analyze (default: 30d)',
+                },
+                break_down_by: {
+                    type: 'string',
+                    enum: ['provider', 'model', 'project'],
+                    description: 'How to break down the costs (default: provider)',
+                },
+            },
+        },
+    },
+    {
+        name: 'get_recent_prompts',
+        description: 'Retrieve your recent LLM prompts and responses with filtering',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Number of prompts to return (1-100, default: 10)',
+                },
+                offset: {
+                    type: 'number',
+                    description: 'Pagination offset (default: 0)',
+                },
+                provider: {
+                    type: 'string',
+                    description: 'Filter by provider (e.g., anthropic, openai)',
+                },
+                model: {
+                    type: 'string',
+                    description: 'Filter by model (e.g., claude-3-5-sonnet)',
+                },
+                include_content: {
+                    type: 'boolean',
+                    description: 'Include full prompt content (default: false for privacy)',
+                },
+            },
+        },
+    },
+    {
+        name: 'get_budget_status',
+        description: 'Check your LLM API budget status and spending alerts',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Check budget for specific project (optional)',
+                },
+            },
+        },
+    },
+    {
+        name: 'list_projects',
+        description: 'List available projects for filtering usage data',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    // Phase 2 Tools
+    {
+        name: 'get_roi_metrics',
+        description: 'Calculate ROI and efficiency metrics with comparison to previous period',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                timeframe: {
+                    type: 'string',
+                    enum: ['7d', '30d', '90d'],
+                    description: 'Time period to analyze (default: 30d)',
+                },
+            },
+        },
+    },
+    {
+        name: 'analyze_spending_trend',
+        description: 'Analyze spending trends and forecast future costs with acceleration/deceleration detection',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                timeframe: {
+                    type: 'string',
+                    enum: ['7d', '30d', '90d'],
+                    description: 'Time period to analyze (default: 30d)',
+                },
+                metric: {
+                    type: 'string',
+                    enum: ['cost', 'tokens'],
+                    description: 'Which metric to analyze (default: cost)',
+                },
+            },
+        },
+    },
+    {
+        name: 'get_model_efficiency',
+        description: 'Compare per-model cost efficiency and get recommendations for best models to use',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                timeframe: {
+                    type: 'string',
+                    enum: ['7d', '30d', '90d'],
+                    description: 'Time period to analyze (default: 30d)',
+                },
+            },
+        },
+    },
+    // Phase 3 Tools
+    OPTIMIZE_PROMPT_TOOL,
+];
+//# sourceMappingURL=index.js.map

package/dist/mcp/tools/index.js.map

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

package/dist/mcp/tools/list-projects.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP Tool: list_projects
+ * List available projects for filtering usage data
+ */
+export declare function listProjects(apiKey: string, apiUrl: string): Promise<string>;
+//# sourceMappingURL=list-projects.d.ts.map

package/dist/mcp/tools/list-projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-projects.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/list-projects.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAwCjB"}

package/dist/mcp/tools/list-projects.js

@@ -0,0 +1,43 @@
+/**
+ * MCP Tool: list_projects
+ * List available projects for filtering usage data
+ */
+export async function listProjects(apiKey, apiUrl) {
+    try {
+        const response = await fetch(`${apiUrl}/api/v1/projects/list`, {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${apiKey}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            return `Error: Failed to fetch projects (${response.status})`;
+        }
+        const data = (await response.json());
+        // Format for natural language display
+        let output = `📋 Projects (${data.total || 0} total)
+
+`;
+        if (data.projects && data.projects.length > 0) {
+            data.projects.forEach((project, idx) => {
+                output += `${idx + 1}. ${project.name}
+`;
+                output += `   ID: ${project.id}
+`;
+                output += `   Current Month: $${project.current_month_spend?.toFixed(2) || '0.00'}
+
+`;
+            });
+        }
+        else {
+            output += 'No projects found.\n';
+        }
+        return output;
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return `Error fetching projects: ${msg}`;
+    }
+}
+//# sourceMappingURL=list-projects.js.map

package/dist/mcp/tools/list-projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-projects.js","sourceRoot":"","sources":["../../../src/mcp/tools/list-projects.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,MAAc;IAEd,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,uBAAuB,EAAE;YAC7D,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,oCAAoC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAChE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAQ,CAAC;QAE5C,sCAAsC;QACtC,IAAI,MAAM,GAAG,gBAAgB,IAAI,CAAC,KAAK,IAAI,CAAC;;CAE/C,CAAC;QAEE,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAY,EAAE,GAAW,EAAE,EAAE;gBAClD,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI;CAC5C,CAAC;gBACM,MAAM,IAAI,UAAU,OAAO,CAAC,EAAE;CACrC,CAAC;gBACM,MAAM,IAAI,sBAAsB,OAAO,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM;;CAExF,CAAC;YACI,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,sBAAsB,CAAC;QACnC,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,4BAA4B,GAAG,EAAE,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/mcp/tools/optimize-prompt.d.ts

@@ -0,0 +1,44 @@
+/**
+ * MCP Tool: optimize_prompt
+ *
+ * Scores the user's prompt and optionally rewrites it using an LLM
+ * before complex tasks. Returns the optimized prompt or null if the
+ * prompt is already strong. Handles 402 gracefully for free-tier users.
+ */
+import type { OptimizePromptToolInput, OptimizePromptToolResult } from '../types.js';
+export declare const OPTIMIZE_PROMPT_TOOL: {
+    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;
+            };
+        };
+    };
+};
+/**
+ * Call the Verbal optimize API and return the optimization result.
+ *
+ * Handles 402 → available: false (free tier, no upgrade nagging).
+ * Throws on other non-OK responses so the MCP server can surface the error.
+ *
+ * @param params    Tool input (prompt, context?, threshold?)
+ * @param apiKey    Verbal API key (Bearer token)
+ * @param endpoint  Verbal API base URL (e.g. https://verbal.run)
+ */
+export declare function optimizePromptTool(params: OptimizePromptToolInput, apiKey: string, endpoint: string): Promise<OptimizePromptToolResult>;
+//# sourceMappingURL=optimize-prompt.d.ts.map

package/dist/mcp/tools/optimize-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize-prompt.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/optimize-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAMrF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;CA4BhC,CAAC;AAMF;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,uBAAuB,EAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,CAAC,CAsDnC"}

package/dist/mcp/tools/optimize-prompt.js

@@ -0,0 +1,95 @@
+/**
+ * MCP Tool: optimize_prompt
+ *
+ * Scores the user's prompt and optionally rewrites it using an LLM
+ * before complex tasks. Returns the optimized prompt or null if the
+ * prompt is already strong. Handles 402 gracefully for free-tier users.
+ */
+// ---------------------------------------------------------------------------
+// Tool definition
+// ---------------------------------------------------------------------------
+export const OPTIMIZE_PROMPT_TOOL = {
+    name: 'optimize_prompt',
+    description: 'Score and optionally rewrite a prompt before complex tasks. ' +
+        'Returns an optimized version if the prompt can be improved, or null if it is already strong. ' +
+        'Call this before any multi-step, vague, or underspecified request.',
+    inputSchema: {
+        type: 'object',
+        required: ['prompt'],
+        properties: {
+            prompt: {
+                type: 'string',
+                description: 'The prompt text to analyze and optionally optimize.',
+            },
+            context: {
+                type: 'string',
+                description: 'Optional context about the task (e.g., tech stack, project type) to improve rewrite quality.',
+            },
+            threshold: {
+                type: 'number',
+                description: 'Score threshold (0-100) below which LLM rewrite is triggered. Default: 70.',
+                minimum: 0,
+                maximum: 100,
+            },
+        },
+    },
+};
+// ---------------------------------------------------------------------------
+// Tool implementation
+// ---------------------------------------------------------------------------
+/**
+ * Call the Verbal optimize API and return the optimization result.
+ *
+ * Handles 402 → available: false (free tier, no upgrade nagging).
+ * Throws on other non-OK responses so the MCP server can surface the error.
+ *
+ * @param params    Tool input (prompt, context?, threshold?)
+ * @param apiKey    Verbal API key (Bearer token)
+ * @param endpoint  Verbal API base URL (e.g. https://verbal.run)
+ */
+export async function optimizePromptTool(params, apiKey, endpoint) {
+    const body = { prompt: params.prompt };
+    if (params.context !== undefined)
+        body.context = params.context;
+    if (params.threshold !== undefined)
+        body.threshold = params.threshold;
+    const response = await fetch(`${endpoint}/api/v1/optimize`, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+    // Tier gate: free plan does not have prompt optimization
+    if (response.status === 402) {
+        let upgradeUrl = '/pricing';
+        try {
+            const data = (await response.json());
+            if (typeof data.upgradeUrl === 'string') {
+                upgradeUrl = data.upgradeUrl;
+            }
+        }
+        catch {
+            // ignore parse errors
+        }
+        return {
+            available: false,
+            reason: 'Prompt optimization is not available on your current plan.',
+            upgrade_url: upgradeUrl,
+        };
+    }
+    if (!response.ok) {
+        throw new Error(`optimize_prompt API error: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return {
+        available: true,
+        original_score: data.original_score,
+        optimized_prompt: data.optimized_prompt,
+        improvement_delta: data.improvement_delta,
+        issues: data.issues,
+        rewrite_triggered: data.rewrite_triggered,
+    };
+}
+//# sourceMappingURL=optimize-prompt.js.map

package/dist/mcp/tools/optimize-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize-prompt.js","sourceRoot":"","sources":["../../../src/mcp/tools/optimize-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,8DAA8D;QAC9D,+FAA+F;QAC/F,oEAAoE;IACtE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAiB;gBACvB,WAAW,EAAE,qDAAqD;aACnE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAiB;gBACvB,WAAW,EACT,8FAA8F;aACjG;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAiB;gBACvB,WAAW,EACT,4EAA4E;gBAC9E,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,GAAG;aACb;SACF;KACF;CACF,CAAC;AAEF,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAA+B,EAC/B,MAAc,EACd,QAAgB;IAEhB,MAAM,IAAI,GAA4B,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAChE,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChE,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;QAAE,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IAEtE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,kBAAkB,EAAE;QAC1D,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,eAAe,EAAE,UAAU,MAAM,EAAE;YACnC,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC;IAEH,yDAAyD;IACzD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,IAAI,UAAU,GAAG,UAAU,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAC;YAChE,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACxC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;YAC/B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;QACD,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,4DAA4D;YACpE,WAAW,EAAE,UAAU;SACxB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,8BAA8B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACvE,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAMlC,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;KAC1C,CAAC;AACJ,CAAC"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Shared types for Verbal MCP service
+ */
+export interface UsageEvent {
+    event_id?: string;
+    event_type: 'prompt' | 'usage';
+    timestamp?: string;
+    source?: string;
+    client?: string;
+    org_id?: string;
+    project?: string;
+    user?: string;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+    prompt?: string;
+    response?: string;
+    provider?: string;
+    model?: string;
+    tokens_in?: number;
+    tokens_out?: number;
+    total_tokens?: number;
+    cache_read_tokens?: number;
+    cache_write_tokens?: number;
+    cost?: number;
+    currency?: string;
+    /** Whether this usage is API-billed (per-token) or subscription-covered (flat fee). */
+    billing_type?: 'api' | 'subscription';
+    prompt_name?: string;
+    prompt_version?: string;
+    session_id?: string;
+    request_id?: string;
+    response_id?: string;
+    duration_ms?: number;
+    /** Verbal conversation ID to link this event to. */
+    conversation_id?: string;
+    conversation_title?: string;
+}
+export interface IngestPayload {
+    provider: string;
+    model: string;
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+    cache_read_tokens?: number;
+    cache_write_tokens?: number;
+    estimated_cost?: number;
+    /** Billing type: 'api' for per-token pricing, 'subscription' for flat-rate plans. */
+    billing_type?: 'api' | 'subscription';
+    request_id?: string;
+    user_id?: string;
+    tags?: Record<string, string>;
+    metadata?: Record<string, unknown>;
+    prompt_content?: string;
+    response_content?: string;
+    /** Optional conversation ID for activity graph linkage. */
+    conversation_id?: string;
+    /** Optional session ID for grouping events. */
+    session_id?: string;
+    source?: string;
+    client?: string;
+}
+export interface IngestorConfig {
+    apiKey: string;
+    endpoint: string;
+    hmacSecret?: string;
+    orgId?: string;
+    defaultProject?: string;
+    defaultProvider?: string;
+    defaultModel?: string;
+    source?: string;
+    batchSize?: number;
+    flushIntervalMs?: number;
+    httpTimeoutMs?: number;
+    gitContextEnabled?: boolean;
+    costCalcEnabled?: boolean;
+    /** Default billing type for events captured by this instance. */
+    billingType?: 'api' | 'subscription';
+    maxRetries?: number;
+    retryBaseDelayMs?: number;
+    deadLetterPath?: string;
+}
+export interface IngestResult {
+    ok: boolean;
+    status?: number;
+    statusText?: string;
+    sent?: number;
+    failed?: number;
+}
+export interface ReviewRatings {
+    usefulness_rating: number;
+    effectiveness_rating: number;
+    time_saved_bucket: string;
+    improvement_text?: string;
+}
+export interface PendingSession {
+    session_id: string;
+    session_start: string;
+    session_end: string;
+    event_count: number;
+}
+export interface OptimizePromptToolInput {
+    prompt: string;
+    context?: string;
+    threshold?: number;
+}
+export type OptimizePromptToolResult = {
+    available: true;
+    original_score: number;
+    optimized_prompt: string | null;
+    improvement_delta: number | null;
+    issues: string[];
+    rewrite_triggered: boolean;
+} | {
+    available: false;
+    reason: string;
+    upgrade_url?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

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

package/dist/mcp/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for Verbal MCP service
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,18 @@
+export interface Credentials {
+    api_key: string;
+    org_id: string;
+    user_email: string;
+    api_url: string;
+    ingest_url: string;
+    created_at: string;
+}
+export interface DetectionResult {
+    tool: 'claude-code' | 'claude-desktop' | 'cursor' | 'codex';
+    detected: boolean;
+    version?: string;
+    configPath: string;
+    existingConfig: boolean;
+    details: string;
+}
+export type ToolName = DetectionResult['tool'];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,GAAG,gBAAgB,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5D,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC"}

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/update-check/check.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Non-blocking update check. Fires fetch, writes cache, but does NOT print.
+ * Call printUpdateNotice() after your command completes to render the notice.
+ */
+export declare function checkForUpdate(_currentVersion: string): Promise<void>;
+//# sourceMappingURL=check.d.ts.map

package/dist/update-check/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/update-check/check.ts"],"names":[],"mappings":"AAqCA;;;GAGG;AACH,wBAAsB,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B3E"}

package/dist/update-check/check.js

@@ -0,0 +1,64 @@
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { getCredentialsDir, readCredentials } from '../auth/credentials.js';
+const CACHE_FILE = 'update-check.json';
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
+function getCachePath() {
+    return join(getCredentialsDir(), CACHE_FILE);
+}
+function readCache() {
+    try {
+        const raw = readFileSync(getCachePath(), 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(cache) {
+    try {
+        const dir = getCredentialsDir();
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(getCachePath(), JSON.stringify(cache, null, 2));
+    }
+    catch {
+        // Non-critical — silently ignore write failures
+    }
+}
+/**
+ * Non-blocking update check. Fires fetch, writes cache, but does NOT print.
+ * Call printUpdateNotice() after your command completes to render the notice.
+ */
+export async function checkForUpdate(_currentVersion) {
+    // Skip if user hasn't authenticated yet
+    const creds = await readCredentials();
+    if (!creds)
+        return;
+    // Check cache — skip if checked recently
+    const cache = readCache();
+    if (cache) {
+        const elapsed = Date.now() - new Date(cache.checkedAt).getTime();
+        if (elapsed < CHECK_INTERVAL_MS)
+            return;
+    }
+    // Fire non-blocking fetch
+    try {
+        const apiUrl = creds.api_url || 'https://www.getverbal.ai';
+        const res = await fetch(`${apiUrl}/api/v1/cli/version`, {
+            signal: AbortSignal.timeout(3000), // 3s timeout — don't slow down CLI
+        });
+        if (!res.ok)
+            return;
+        const body = (await res.json());
+        writeCache({
+            checkedAt: new Date().toISOString(),
+            latest: body.latest,
+            min: body.min,
+            message: body.message,
+        });
+    }
+    catch {
+        // Network error — silently ignore
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/update-check/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/update-check/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAS5E,MAAM,UAAU,GAAG,mBAAmB,CAAC;AACvC,MAAM,iBAAiB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW;AAE1D,SAAS,YAAY;IACnB,OAAO,IAAI,CAAC,iBAAiB,EAAE,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,SAAS;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAkB;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;QAChC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,aAAa,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,eAAuB;IAC1D,wCAAwC;IACxC,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,yCAAyC;IACzC,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QACjE,IAAI,OAAO,GAAG,iBAAiB;YAAE,OAAO;IAC1C,CAAC;IAED,0BAA0B;IAC1B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,IAAI,0BAA0B,CAAC;QAC3D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,qBAAqB,EAAE;YACtD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,mCAAmC;SACvE,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO;QAEpB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4D,CAAC;QAC3F,UAAU,CAAC;YACT,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;AACH,CAAC"}

package/dist/update-check/notify.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Reads the update cache and prints a notice if the current version is outdated.
+ * Call this AFTER your command completes.
+ */
+export declare function printUpdateNotice(currentVersion: string): void;
+//# sourceMappingURL=notify.d.ts.map

package/dist/update-check/notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/update-check/notify.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CA8B9D"}