costhawk 1.5.11 → 1.5.12

package/dist/build-info.d.ts

@@ -1,2 +1,2 @@
-export declare const BUILD_COMMIT_SHA = "b4c5b65";
+export declare const BUILD_COMMIT_SHA = "d2dc17c";
 //# sourceMappingURL=build-info.d.ts.map

package/dist/build-info.js

@@ -1,3 +1,3 @@
 // Auto-generated during release builds. Values may be empty in dev.
-export const BUILD_COMMIT_SHA = "b4c5b65";
+export const BUILD_COMMIT_SHA = "d2dc17c";
 //# sourceMappingURL=build-info.js.map

package/dist/cursor-parser.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Cursor Local SQLite Parser (PR1 — dry-run only)
+ *
+ * Parses Cursor IDE chat history from the local SQLite database to extract
+ * token usage data. Read-only. Does not push to any backend.
+ *
+ * Storage:
+ *   macOS:   ~/Library/Application Support/Cursor/User/globalStorage/state.vscdb
+ *   Linux:   ~/.config/Cursor/User/globalStorage/state.vscdb
+ *   Windows: %APPDATA%/Cursor/User/globalStorage/state.vscdb
+ *
+ * Schema:
+ *   Table cursorDiskKV (key TEXT, value BLOB)
+ *   Conversations: composerData:<composerId>
+ *   Messages:      bubbleId:<composerId>:<bubbleId>
+ *
+ * Token data lives at $.tokenCount.inputTokens and $.tokenCount.outputTokens
+ * on bubble rows. Model name at $.modelInfo.modelName. Server-side dedup id
+ * at $.serverBubbleId.
+ *
+ * NOTE (PR1 scope): Cursor message timestamps are not yet verified across
+ * versions, so this dry-run parser does NOT return startTime/endTime/dailyUsage.
+ * PR2 will add timestamp support after verification on real Cursor data.
+ *
+ * Workspace metadata fields (workspaceHash/workspaceName) are also unverified
+ * and return null until PR2 confirms the stable field source.
+ */
+import type { TokenUsage } from "./transcript-parser.js";
+/**
+ * Single Cursor session in dry-run output.
+ *
+ * Shape is intentionally distinct from Claude/Codex SessionUsage because
+ * Cursor message timestamps are not yet verified — startTime/endTime are
+ * deliberately absent until PR2 verifies the stable timestamp source.
+ */
+export interface CursorSessionUsageDryRun {
+    sessionId: string;
+    workspaceHash: string | null;
+    workspaceName: string | null;
+    model: string;
+    tokens: TokenUsage;
+    messageCount: number;
+    filePath: string;
+}
+export interface CursorParserError {
+    code: "CURSOR_DB_NOT_FOUND" | "CURSOR_SQLITE3_NOT_FOUND" | "CURSOR_SQLITE_QUERY_FAILED";
+    message: string;
+}
+export interface CursorParserResult {
+    sessions: CursorSessionUsageDryRun[];
+    filePath: string;
+}
+/**
+ * Get the default Cursor SQLite path for the current platform, honoring
+ * the COSTHAWK_CURSOR_DB_PATH environment override.
+ */
+export declare function getCursorDbPath(): string;
+/**
+ * Check whether the Cursor SQLite database exists at the resolved path.
+ */
+export declare function cursorDbExists(): boolean;
+/**
+ * Type guard — narrows an unknown error to a CursorParserError.
+ */
+declare function isCursorParserError(value: unknown): value is CursorParserError;
+/**
+ * Parse Cursor usage from local SQLite. Read-only dry run — does NOT push
+ * anything to the costcanary backend.
+ *
+ * Returns aggregated session data per composer with per-session token totals
+ * and message counts. Throws CursorParserError on unrecoverable failures
+ * (missing DB, missing sqlite3 binary, malformed SQLite output).
+ *
+ * Dedup strategy: per composer, keep one entry per (serverBubbleId ?? bubbleId).
+ * On collision, keep the candidate with the larger token total.
+ *
+ * Mixed-model handling: if a composer contains multiple non-empty model names,
+ * the returned `model` field is "mixed". If no model info is present on any
+ * bubble, the field is "unknown".
+ *
+ * Sort order: total tokens descending. NOT chronological — message timestamps
+ * are not yet verified for Cursor.
+ */
+export declare function parseCursorUsageDryRun(): CursorParserResult;
+export { isCursorParserError };
+//# sourceMappingURL=cursor-parser.d.ts.map

package/dist/cursor-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-parser.d.ts","sourceRoot":"","sources":["../src/cursor-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAOzD;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EACA,qBAAqB,GACrB,0BAA0B,GAC1B,4BAA4B,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,wBAAwB,EAAE,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAmCxC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAUD;;GAEG;AACH,iBAAS,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAYvE;AA+KD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,IAAI,kBAAkB,CAuH3D;AAID,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/cursor-parser.js

@@ -0,0 +1,355 @@
+/**
+ * Cursor Local SQLite Parser (PR1 — dry-run only)
+ *
+ * Parses Cursor IDE chat history from the local SQLite database to extract
+ * token usage data. Read-only. Does not push to any backend.
+ *
+ * Storage:
+ *   macOS:   ~/Library/Application Support/Cursor/User/globalStorage/state.vscdb
+ *   Linux:   ~/.config/Cursor/User/globalStorage/state.vscdb
+ *   Windows: %APPDATA%/Cursor/User/globalStorage/state.vscdb
+ *
+ * Schema:
+ *   Table cursorDiskKV (key TEXT, value BLOB)
+ *   Conversations: composerData:<composerId>
+ *   Messages:      bubbleId:<composerId>:<bubbleId>
+ *
+ * Token data lives at $.tokenCount.inputTokens and $.tokenCount.outputTokens
+ * on bubble rows. Model name at $.modelInfo.modelName. Server-side dedup id
+ * at $.serverBubbleId.
+ *
+ * NOTE (PR1 scope): Cursor message timestamps are not yet verified across
+ * versions, so this dry-run parser does NOT return startTime/endTime/dailyUsage.
+ * PR2 will add timestamp support after verification on real Cursor data.
+ *
+ * Workspace metadata fields (workspaceHash/workspaceName) are also unverified
+ * and return null until PR2 confirms the stable field source.
+ */
+import { execFileSync } from "child_process";
+import { existsSync } from "fs";
+import { homedir, platform } from "os";
+import { join } from "path";
+// Defaults — overridable via env vars
+const DEFAULT_SQLITE3_PATH = "/usr/bin/sqlite3";
+const SQLITE_TIMEOUT_MS = 10_000;
+const SQLITE_MAX_BUFFER_BYTES = 32 * 1024 * 1024;
+/**
+ * Get the default Cursor SQLite path for the current platform, honoring
+ * the COSTHAWK_CURSOR_DB_PATH environment override.
+ */
+export function getCursorDbPath() {
+    const envOverride = process.env.COSTHAWK_CURSOR_DB_PATH;
+    if (envOverride && envOverride.length > 0) {
+        return envOverride;
+    }
+    const home = homedir();
+    if (platform() === "darwin") {
+        return join(home, "Library", "Application Support", "Cursor", "User", "globalStorage", "state.vscdb");
+    }
+    if (platform() === "win32") {
+        const appData = process.env.APPDATA;
+        if (appData) {
+            return join(appData, "Cursor", "User", "globalStorage", "state.vscdb");
+        }
+        return join(home, "AppData", "Roaming", "Cursor", "User", "globalStorage", "state.vscdb");
+    }
+    // Linux and other unix-likes
+    return join(home, ".config", "Cursor", "User", "globalStorage", "state.vscdb");
+}
+/**
+ * Check whether the Cursor SQLite database exists at the resolved path.
+ */
+export function cursorDbExists() {
+    return existsSync(getCursorDbPath());
+}
+/**
+ * Resolve the sqlite3 binary path. Defaults to /usr/bin/sqlite3, honoring
+ * the COSTHAWK_SQLITE3_PATH environment override.
+ */
+function getSqlite3Path() {
+    return process.env.COSTHAWK_SQLITE3_PATH ?? DEFAULT_SQLITE3_PATH;
+}
+/**
+ * Type guard — narrows an unknown error to a CursorParserError.
+ */
+function isCursorParserError(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.code === "string" &&
+        (obj.code === "CURSOR_DB_NOT_FOUND" ||
+            obj.code === "CURSOR_SQLITE3_NOT_FOUND" ||
+            obj.code === "CURSOR_SQLITE_QUERY_FAILED") &&
+        typeof obj.message === "string");
+}
+/**
+ * Run a SQL query against the Cursor SQLite via shell-out to the system
+ * sqlite3 binary. Returns parsed rows as an array of {key, value} objects,
+ * or throws CursorParserError on unrecoverable failures.
+ *
+ * Uses execFileSync with an arg array (not shell strings) to avoid shell
+ * injection. Sets explicit timeout and maxBuffer to defend against runaway
+ * queries or oversized state.vscdb files.
+ */
+function runCursorQuery(sql) {
+    const sqlite3Path = getSqlite3Path();
+    const dbPath = getCursorDbPath();
+    if (!existsSync(dbPath)) {
+        const error = {
+            code: "CURSOR_DB_NOT_FOUND",
+            message: `Cursor SQLite database not found at ${dbPath}. Make sure Cursor is installed and you have used it at least once. Set COSTHAWK_CURSOR_DB_PATH to override.`,
+        };
+        throw error;
+    }
+    let stdout;
+    try {
+        stdout = execFileSync(sqlite3Path, ["-readonly", "-batch", "-json", "--", dbPath, sql], {
+            encoding: "utf8",
+            timeout: SQLITE_TIMEOUT_MS,
+            maxBuffer: SQLITE_MAX_BUFFER_BYTES,
+        });
+    }
+    catch (err) {
+        const errno = err.code;
+        if (errno === "ENOENT") {
+            const error = {
+                code: "CURSOR_SQLITE3_NOT_FOUND",
+                message: `sqlite3 binary not found at ${sqlite3Path}. Set COSTHAWK_SQLITE3_PATH to override the default path.`,
+            };
+            throw error;
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        const error = {
+            code: "CURSOR_SQLITE_QUERY_FAILED",
+            message,
+        };
+        throw error;
+    }
+    if (!stdout || stdout.trim().length === 0) {
+        return [];
+    }
+    // sqlite3 -json output is a JSON array of objects when rows exist,
+    // or empty / whitespace when no rows. Anything else is a real failure
+    // and must surface as CURSOR_SQLITE_QUERY_FAILED — silently returning
+    // [] would mask a parser failure as "no sessions found".
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch {
+        const error = {
+            code: "CURSOR_SQLITE_QUERY_FAILED",
+            message: "sqlite3 returned invalid JSON output",
+        };
+        throw error;
+    }
+    if (!Array.isArray(parsed)) {
+        const error = {
+            code: "CURSOR_SQLITE_QUERY_FAILED",
+            message: "sqlite3 returned a non-array JSON payload",
+        };
+        throw error;
+    }
+    return parsed.filter((row) => typeof row === "object" &&
+        row !== null &&
+        "key" in row &&
+        "value" in row &&
+        typeof row.key === "string" &&
+        typeof row.value === "string");
+}
+function hasTokenUsage(bubble) {
+    return bubble.inputTokens > 0 || bubble.outputTokens > 0;
+}
+const BUBBLE_KEY_REGEX = /^bubbleId:([^:]+):(.+)$/;
+/**
+ * Parse a single bubbleId row into structured BubbleData.
+ *
+ * Returns null if the row key is malformed, the value is not parseable JSON,
+ * or the row contains neither a non-empty model name nor any positive token
+ * counts. Cursor can store model metadata and token usage on different rows
+ * (model name typically lives on user-prompt bubbles, token counts live on
+ * assistant-response bubbles), so the parser must accept either signal in
+ * isolation and let the per-composer aggregation merge them.
+ */
+function parseBubble(row) {
+    const match = BUBBLE_KEY_REGEX.exec(row.key);
+    if (!match) {
+        return null;
+    }
+    const [, composerId, bubbleId] = match;
+    let value;
+    try {
+        value = JSON.parse(row.value);
+    }
+    catch {
+        return null;
+    }
+    if (typeof value !== "object" || value === null) {
+        return null;
+    }
+    const obj = value;
+    let inputTokens = 0;
+    let outputTokens = 0;
+    const tokenCount = obj.tokenCount;
+    if (typeof tokenCount === "object" && tokenCount !== null) {
+        const tc = tokenCount;
+        inputTokens = typeof tc.inputTokens === "number" ? tc.inputTokens : 0;
+        outputTokens = typeof tc.outputTokens === "number" ? tc.outputTokens : 0;
+    }
+    let modelName;
+    const modelInfo = obj.modelInfo;
+    if (typeof modelInfo === "object" && modelInfo !== null) {
+        const mi = modelInfo;
+        if (typeof mi.modelName === "string" && mi.modelName.length > 0) {
+            modelName = mi.modelName;
+        }
+    }
+    // Skip rows with no usable signal at all — neither model metadata nor
+    // positive token counts. These are typically system messages, empty
+    // bubbles, or tool-call bookkeeping rows.
+    if (!modelName && inputTokens === 0 && outputTokens === 0) {
+        return null;
+    }
+    let serverBubbleId;
+    if (typeof obj.serverBubbleId === "string" &&
+        obj.serverBubbleId.length > 0) {
+        serverBubbleId = obj.serverBubbleId;
+    }
+    return {
+        composerId,
+        bubbleId,
+        serverBubbleId,
+        modelName,
+        inputTokens,
+        outputTokens,
+    };
+}
+/**
+ * Parse Cursor usage from local SQLite. Read-only dry run — does NOT push
+ * anything to the costcanary backend.
+ *
+ * Returns aggregated session data per composer with per-session token totals
+ * and message counts. Throws CursorParserError on unrecoverable failures
+ * (missing DB, missing sqlite3 binary, malformed SQLite output).
+ *
+ * Dedup strategy: per composer, keep one entry per (serverBubbleId ?? bubbleId).
+ * On collision, keep the candidate with the larger token total.
+ *
+ * Mixed-model handling: if a composer contains multiple non-empty model names,
+ * the returned `model` field is "mixed". If no model info is present on any
+ * bubble, the field is "unknown".
+ *
+ * Sort order: total tokens descending. NOT chronological — message timestamps
+ * are not yet verified for Cursor.
+ */
+export function parseCursorUsageDryRun() {
+    const dbPath = getCursorDbPath();
+    // Throws CursorParserError on missing DB / missing sqlite3 / query failure
+    const rows = runCursorQuery("SELECT key, value FROM cursorDiskKV WHERE key LIKE 'bubbleId:%'");
+    // Cursor splits model metadata and token usage across different bubble
+    // rows: model names typically live on user-prompt bubbles (type 1) with
+    // zero token counts, and token counts live on assistant-response bubbles
+    // (type 2) with no model info. We collect them separately and merge per
+    // composer.
+    //
+    // - tokenBubblesByComposer: per-composer dedup map for bubbles that carry
+    //   positive token counts. Dedup key is (serverBubbleId ?? bubbleId).
+    //   Collision rule: keep the candidate with the larger token total.
+    // - modelsByComposer: per-composer set of all distinct non-empty model
+    //   names found on ANY bubble row in the composer. No dedup needed since
+    //   models are categorical, not additive.
+    //
+    // Model harvesting is intentionally not gated on type or on token presence
+    // — if Cursor ever stores model names on assistant rows in a future
+    // schema, this code already supports it.
+    const tokenBubblesByComposer = new Map();
+    const modelsByComposer = new Map();
+    for (const row of rows) {
+        const bubble = parseBubble(row);
+        if (!bubble) {
+            continue;
+        }
+        if (bubble.modelName) {
+            let composerModels = modelsByComposer.get(bubble.composerId);
+            if (!composerModels) {
+                composerModels = new Set();
+                modelsByComposer.set(bubble.composerId, composerModels);
+            }
+            composerModels.add(bubble.modelName);
+        }
+        if (!hasTokenUsage(bubble)) {
+            continue;
+        }
+        let composerMap = tokenBubblesByComposer.get(bubble.composerId);
+        if (!composerMap) {
+            composerMap = new Map();
+            tokenBubblesByComposer.set(bubble.composerId, composerMap);
+        }
+        const dedupKey = bubble.serverBubbleId ?? bubble.bubbleId;
+        const existing = composerMap.get(dedupKey);
+        if (existing) {
+            const existingTotal = existing.inputTokens + existing.outputTokens;
+            const newTotal = bubble.inputTokens + bubble.outputTokens;
+            if (newTotal > existingTotal) {
+                composerMap.set(dedupKey, bubble);
+            }
+            continue;
+        }
+        composerMap.set(dedupKey, bubble);
+    }
+    // Aggregate per composer into the dry-run output shape.
+    const sessions = [];
+    for (const [composerId, composerMap] of tokenBubblesByComposer) {
+        let inputTokens = 0;
+        let outputTokens = 0;
+        let messageCount = 0;
+        const modelsSeen = modelsByComposer.get(composerId) ?? new Set();
+        for (const bubble of composerMap.values()) {
+            inputTokens += bubble.inputTokens;
+            outputTokens += bubble.outputTokens;
+            messageCount += 1;
+        }
+        if (messageCount === 0) {
+            continue;
+        }
+        let model;
+        if (modelsSeen.size === 0) {
+            model = "unknown";
+        }
+        else if (modelsSeen.size === 1) {
+            model = Array.from(modelsSeen)[0];
+        }
+        else {
+            model = "mixed";
+        }
+        sessions.push({
+            sessionId: composerId,
+            workspaceHash: null, // Unverified in PR1 — set in PR2
+            workspaceName: null, // Unverified in PR1 — set in PR2
+            model,
+            tokens: {
+                inputTokens,
+                outputTokens,
+                cacheCreationTokens: 0, // Cursor does not have prompt cache tokens
+                cacheReadTokens: 0,
+            },
+            messageCount,
+            filePath: dbPath,
+        });
+    }
+    // Sort by total tokens descending. NOT recency — no verified timestamps.
+    sessions.sort((a, b) => {
+        const aTotal = a.tokens.inputTokens + a.tokens.outputTokens;
+        const bTotal = b.tokens.inputTokens + b.tokens.outputTokens;
+        return bTotal - aTotal;
+    });
+    return {
+        sessions,
+        filePath: dbPath,
+    };
+}
+// Re-export the type guard so the MCP tool registration in index.ts can
+// distinguish CursorParserError from generic Error in its catch block.
+export { isCursorParserError };
+//# sourceMappingURL=cursor-parser.js.map

package/dist/cursor-parser.js.map

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

package/dist/index.js

@@ -10,6 +10,7 @@ import { homedir, hostname, platform } from "os";
 // Claude Code local transcript parsing
 import { claudeCodeDirectoryExists, discoverTranscripts, getClaudeProjectsDir, parseAllTranscriptsDetailed, } from "./transcript-parser.js";
 import { codexDirectoryExists, discoverCodexSessions, getCodexSessionsDir, parseAllCodexSessionsDetailed, } from "./codex-parser.js";
+import { cursorDbExists, getCursorDbPath, isCursorParserError, parseCursorUsageDryRun, } from "./cursor-parser.js";
 import { calculateCost, formatCost, formatTokens, calculateSavings, CLAUDE_SUBSCRIPTIONS, getClaudeCodePricing, getLLMPricing, } from "./pricing-constants.js";
 import { BUILD_COMMIT_SHA } from "./build-info.js";
 // Constants
@@ -1360,6 +1361,35 @@ function formatUsageByTagMarkdown(data, tagKey) {
     }
     return truncateResponse(output);
 }
+function formatUsageBreakdownMarkdown(projectData, featureData) {
+    let output = `# Cost Breakdown\n\n`;
+    output += `## By Project\n\n`;
+    if (projectData.length === 0) {
+        output += `No project attribution data found.\n\n`;
+    }
+    else {
+        output += `| Project | Cost | Calls | % of Total |\n`;
+        output += `|---------|------|-------|------------|\n`;
+        for (const item of projectData) {
+            output += `| ${item.value} | ${formatCurrency(item.cost)} | ${formatNumber(item.calls)} | ${item.percentage.toFixed(1)}% |\n`;
+        }
+        output += `\n`;
+    }
+    output += `## By Feature\n\n`;
+    if (featureData.length === 0) {
+        output += `No feature attribution data found.\n\n`;
+    }
+    else {
+        output += `| Feature | Cost | Calls | % of Total |\n`;
+        output += `|---------|------|-------|------------|\n`;
+        for (const item of featureData) {
+            output += `| ${item.value} | ${formatCurrency(item.cost)} | ${formatNumber(item.calls)} | ${item.percentage.toFixed(1)}% |\n`;
+        }
+        output += `\n`;
+    }
+    output += `---\n*Use tagKey "project" or "feature" to drill into a specific dimension.*\n`;
+    return truncateResponse(output);
+}
 function formatAnomaliesMarkdown(anomalies) {
     if (anomalies.length === 0) {
         return "# Anomaly Detection\n\nNo anomalies detected. Your usage patterns appear normal.";
@@ -2289,7 +2319,7 @@ const UsageByTagSchema = {
         .string()
         .optional()
         .describe("Your CostHawk API key. If not provided, uses COSTHAWK_API_KEY environment variable."),
-    tagKey: z.string().describe("Tag key to group by. Examples: user_id, feature, environment, team"),
+    tagKey: z.string().describe('Tag key to group by. Use "breakdown" for a full project + feature cost breakdown. Other options: project, feature, user_id, environment, team, provider, model'),
     startDate: z.string().optional().describe("Start date (ISO 8601). Defaults to 30 days ago"),
     endDate: z.string().optional().describe("End date (ISO 8601). Defaults to now"),
     limit: z.number().min(1).max(100).optional().default(20).describe("Maximum number of results (1-100)"),
@@ -2549,6 +2579,18 @@ const GetLocalCodexUsageSchema = {
         .describe("Only include sessions modified within this many hours (1-720, default 24)"),
     format: z.enum(["markdown", "json"]).optional().default("markdown").describe("Response format"),
 };
+// PR1 dry-run schema for Cursor: no maxAgeHours (Cursor message timestamps
+// are unverified across versions — adding an age filter would be misleading
+// until PR2 confirms the stable timestamp source). No apiKey or pricing
+// (PR1 defers cost calculation entirely). Format is JSON-only in PR1;
+// markdown formatter parity will be added in PR2 if needed.
+const GetLocalCursorUsageSchema = {
+    format: z
+        .enum(["json"])
+        .optional()
+        .default("json")
+        .describe("Response format. Only json is supported in this PR1 dry-run release."),
+};
 const ListCodexSessionsSchema = {
     maxAgeHours: z
         .number()
@@ -2609,7 +2651,7 @@ server.registerTool("costhawk_get_usage_summary", {
     }
 });
 server.registerTool("costhawk_get_usage_by_tag", {
-    description: `Get usage costs grouped by a specific tag/attribute. Use this to see which features, users, or environments are driving costs.\n\nIMPORTANT: Always display the COMPLETE output in your response using markdown tables. Never summarize or truncate.`,
+    description: `Get usage costs grouped by a specific tag/attribute. Use tagKey "breakdown" for a full project + feature cost breakdown. Other tagKey options: project, feature, user_id, environment, team, provider, model.\n\nIMPORTANT: Always display the COMPLETE output in your response using markdown tables. Never summarize or truncate.`,
     inputSchema: UsageByTagSchema,
     annotations: READ_ONLY_ANNOTATIONS,
 }, async (args, _extra) => {
@@ -2626,6 +2668,29 @@ server.registerTool("costhawk_get_usage_by_tag", {
         };
     }
     try {
+        if (args.tagKey === "breakdown") {
+            const baseParams = new URLSearchParams();
+            if (args.startDate)
+                baseParams.set("startDate", args.startDate);
+            if (args.endDate)
+                baseParams.set("endDate", args.endDate);
+            if (args.limit)
+                baseParams.set("limit", String(args.limit));
+            const projectParams = new URLSearchParams(baseParams);
+            projectParams.set("tagKey", "project");
+            const featureParams = new URLSearchParams(baseParams);
+            featureParams.set("tagKey", "feature");
+            const [projectData, featureData] = await Promise.all([
+                apiRequest(`/api/mcp/usage/by-tag?${projectParams}`, { apiKey }),
+                apiRequest(`/api/mcp/usage/by-tag?${featureParams}`, { apiKey }),
+            ]);
+            const text = args.format === "json"
+                ? JSON.stringify({ project: projectData, feature: featureData }, null, 2)
+                : formatUsageBreakdownMarkdown(projectData, featureData);
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
         const queryParams = new URLSearchParams();
         queryParams.set("tagKey", args.tagKey);
         if (args.startDate)
@@ -3832,6 +3897,90 @@ server.registerTool("costhawk_list_codex_sessions", {
         };
     }
 });
+// ─── Cursor Local Usage (PR1 dry-run only) ───
+//
+// Reads Cursor IDE chat history from local SQLite via shell-out to the system
+// sqlite3 binary. Read-only. Does NOT push to costcanary backend. Does NOT
+// modify any state. Returns aggregated per-conversation token counts.
+//
+// Cursor message timestamps are not yet verified across versions, so this PR1
+// release does not return startTime/endTime/dailyUsage. PR2 will add timestamp
+// support after verification on real Cursor data.
+server.registerTool("costhawk_get_local_cursor_usage", {
+    description: `Get Cursor IDE usage from local SQLite WITHOUT uploading to CostHawk. Read-only dry run. Shows per-conversation token counts and models from the user's local Cursor database.
+
+NOTE: This is an early dry-run preview. It does not include per-message timestamps yet — those will be added in a future release after verification on real Cursor data. It does not push any data to CostHawk.
+
+IMPORTANT: Always display the COMPLETE output in your response. Never summarize or truncate.`,
+    inputSchema: GetLocalCursorUsageSchema,
+    annotations: READ_ONLY_ANNOTATIONS,
+}, async (_args, _extra) => {
+    // Precheck the SQLite file before invoking sqlite3 so the user gets a
+    // helpful "install Cursor first" message instead of an opaque ENOENT.
+    if (!cursorDbExists()) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: Cursor SQLite database not found at ${getCursorDbPath()}. Make sure Cursor is installed and you have used it at least once. Set COSTHAWK_CURSOR_DB_PATH to override the default path.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        const result = parseCursorUsageDryRun();
+        if (result.sessions.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No Cursor sessions with token data found at ${result.filePath}. The database exists but no token-bearing bubbles were detected. Try having a few real conversations in Cursor first.`,
+                    },
+                ],
+            };
+        }
+        const totalSessions = result.sessions.length;
+        const totalInputTokens = result.sessions.reduce((acc, s) => acc + s.tokens.inputTokens, 0);
+        const totalOutputTokens = result.sessions.reduce((acc, s) => acc + s.tokens.outputTokens, 0);
+        const totalMessages = result.sessions.reduce((acc, s) => acc + s.messageCount, 0);
+        const response = {
+            dryRun: true,
+            filePath: result.filePath,
+            totals: {
+                sessions: totalSessions,
+                messages: totalMessages,
+                inputTokens: totalInputTokens,
+                outputTokens: totalOutputTokens,
+                totalTokens: totalInputTokens + totalOutputTokens,
+            },
+            sessions: result.sessions,
+        };
+        const text = JSON.stringify(response, null, 2);
+        return {
+            content: [{ type: "text", text }],
+        };
+    }
+    catch (err) {
+        // CursorParserError carries a typed code; generic errors fall back
+        // to a plain message. Both are surfaced to the MCP host with isError.
+        const code = isCursorParserError(err) ? err.code : "UNKNOWN";
+        const message = err instanceof Error
+            ? err.message
+            : typeof err === "object" && err !== null && "message" in err
+                ? String(err.message)
+                : "Unknown error";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error [${code}]: ${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
 // ─── Proxy Guide & Integrations Tools ───
 server.registerTool("costhawk_get_proxy_guide", {
     description: `Get the complete CostHawk API proxy setup guide. Learn how to route your OpenAI, Anthropic, or Google Gemini API calls through CostHawk for automatic cost tracking, token counting, and latency monitoring. Covers SDK configuration (Python + TypeScript), wrapped key management, response headers, error codes, and rate limits. No API key required.\n\nIMPORTANT: Always display the COMPLETE output in your response using markdown tables. Never summarize or truncate.`,