@tokentop/agent-cursor 1.0.0 → 1.2.0

package/dist/parser.d.ts

@@ -0,0 +1,33 @@
+import type { Database } from 'bun:sqlite';
+import type { AgentFetchContext, SessionParseOptions, SessionUsageData } from '@tokentop/plugin-sdk';
+import type { CursorBubbleData, CursorComposerData } from './types.ts';
+interface ComposerWithMeta {
+    composerId: string;
+    lastUpdatedAt: number;
+    projectPath: string | undefined;
+    sessionName: string | undefined;
+}
+export declare function toTimestamp(isoString: string | undefined, fallback: number): number;
+/**
+ * Validates that a bubble is an assistant response worth tracking.
+ *
+ * Cursor populates tokenCount asynchronously via server polling (getTokenUsage).
+ * In newer agent-mode conversations the server often doesn't provide a usageUuid,
+ * leaving tokenCount at {inputTokens:0, outputTokens:0}. We accept assistant
+ * bubbles with either real token counts OR non-empty text content (for estimation).
+ */
+export declare function isAssistantBubble(bubble: unknown): bubble is CursorBubbleData;
+/**
+ * @deprecated Use {@link isAssistantBubble} instead.
+ */
+export declare const isTokenBearingBubble: typeof isAssistantBubble;
+/**
+ * Estimates output token count from response text length.
+ * Returns 0 when text is empty/missing. Used as fallback when Cursor's
+ * async token polling didn't populate the actual counts.
+ */
+export declare function estimateOutputTokens(text: string | undefined): number;
+export declare function parseComposerBubbles(db: Database, meta: ComposerWithMeta, composer: CursorComposerData, shouldEstimate?: boolean): SessionUsageData[];
+export declare function parseSessionsFromWorkspaces(options: SessionParseOptions, ctx: AgentFetchContext): Promise<SessionUsageData[]>;
+export {};
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AASrG,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAuB,MAAM,YAAY,CAAC;AAwB5F,UAAU,gBAAgB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAInF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,gBAAgB,CAgB7E;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,0BAAoB,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGrE;AAgBD,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,kBAAkB,EAC5B,cAAc,UAAO,GACpB,gBAAgB,EAAE,CA0CpB;AAgCD,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,mBAAmB,EAC5B,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAwK7B"}

package/dist/paths.d.ts

@@ -0,0 +1,6 @@
+export declare const CURSOR_HOME: string;
+export declare const CURSOR_GLOBAL_STORAGE_PATH: string;
+export declare const CURSOR_WORKSPACE_STORAGE_PATH: string;
+export declare const CURSOR_STATE_DB_PATH: string;
+export declare function getWorkspaceDirs(): Promise<string[]>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,WAAW,QAA6B,CAAC;AAetD,eAAO,MAAM,0BAA0B,QAA+C,CAAC;AACvF,eAAO,MAAM,6BAA6B,QAAkD,CAAC;AAC7F,eAAO,MAAM,oBAAoB,QAAuD,CAAC;AAEzF,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAe1D"}

package/dist/storage.d.ts

@@ -0,0 +1,15 @@
+import type { PluginStorage } from '@tokentop/plugin-sdk';
+import type { SessionUsageData } from '@tokentop/plugin-sdk';
+/** Capture the storage reference from a PluginContext. Safe to call multiple times. */
+export declare function setPluginStorage(storage: PluginStorage): void;
+/**
+ * Load the enrichment cache from persistent storage.
+ * Returns a Map of sessionId → enriched rows, or null if nothing is stored.
+ */
+export declare function loadEnrichmentCache(): Promise<Map<string, SessionUsageData[]> | null>;
+/**
+ * Save the enrichment cache to persistent storage.
+ * Fire-and-forget — errors are silently ignored.
+ */
+export declare function saveEnrichmentCache(cache: Map<string, SessionUsageData[]>): void;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAa7D,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAE7D;AAUD;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,GAAG,IAAI,CAAC,CAqB3F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,GAAG,IAAI,CAShF"}

package/dist/types.d.ts

@@ -0,0 +1,120 @@
+import type { SessionUsageData } from '@tokentop/plugin-sdk';
+/**
+ * Cursor stores conversations as "composers" in its SQLite state database.
+ * Each composer has metadata plus a list of bubble IDs that reference
+ * individual messages stored separately in the same KV table.
+ */
+/** Bubble type: 1 = user message, 2 = assistant message. */
+export type CursorBubbleType = 1 | 2;
+/** Bubble header stored in composerData.fullConversationHeadersOnly. */
+export interface CursorBubbleHeader {
+    bubbleId: string;
+    type: CursorBubbleType;
+    serverBubbleId?: string;
+}
+/** Model config stored at the composer level (conversation default). */
+export interface CursorModelConfig {
+    modelName: string;
+    maxMode?: boolean;
+}
+/** Token count stored per-bubble. */
+export interface CursorTokenCount {
+    inputTokens: number;
+    outputTokens: number;
+}
+/** Model info stored per-bubble (may be null if not resolved). */
+export interface CursorModelInfo {
+    modelName: string;
+}
+/**
+ * Composer data from cursorDiskKV `composerData:{composerId}`.
+ * Only the fields we need for session parsing are typed here.
+ */
+export interface CursorComposerData {
+    _v: number;
+    composerId: string;
+    name?: string;
+    status: string;
+    modelConfig: CursorModelConfig;
+    usageData: Record<string, unknown>;
+    fullConversationHeadersOnly: CursorBubbleHeader[];
+    lastUpdatedAt: number;
+    createdAt: number;
+    isAgentic?: boolean;
+    unifiedMode?: string;
+    forceMode?: string;
+}
+/**
+ * Individual bubble (message) from cursorDiskKV `bubbleId:{composerId}:{bubbleId}`.
+ * Only the fields we need for token extraction are typed here.
+ *
+ * Note: Cursor populates tokenCount asynchronously by polling its server via
+ * getTokenUsage({usageUuid}). When the server doesn't return a usageUuid (common
+ * in newer agent-mode conversations), tokenCount remains {inputTokens:0, outputTokens:0}.
+ * In that case we estimate output tokens from the bubble's text content.
+ */
+export interface CursorBubbleData {
+    _v: number;
+    type: CursorBubbleType;
+    bubbleId: string;
+    tokenCount: CursorTokenCount;
+    modelInfo: CursorModelInfo | null;
+    requestId: string;
+    createdAt: string;
+    isAgentic?: boolean;
+    /** The assistant's response text content. Used for token estimation when tokenCount is zero. */
+    text?: string;
+    /** Server-assigned UUID for fetching token usage. Absent in newer agent-mode conversations. */
+    usageUuid?: string;
+}
+/** Composer entry in the workspace-level `composer.composerData` list. */
+export interface CursorWorkspaceComposerEntry {
+    type: string;
+    composerId: string;
+    lastUpdatedAt?: number;
+    createdAt: number;
+    unifiedMode?: string;
+    forceMode?: string;
+    name?: string;
+    subtitle?: string;
+    isArchived?: boolean;
+    isDraft?: boolean;
+}
+/** Workspace-level composer index from ItemTable `composer.composerData`. */
+export interface CursorWorkspaceComposerIndex {
+    allComposers: CursorWorkspaceComposerEntry[];
+    selectedComposerIds: string[];
+    lastFocusedComposerIds: string[];
+    hasMigratedComposerData?: boolean;
+    hasMigratedMultipleComposers?: boolean;
+}
+/** Workspace metadata from workspace.json. */
+export interface CursorWorkspaceJson {
+    folder: string;
+}
+/** Resolved workspace: project path + associated composer IDs. */
+export interface CursorWorkspaceInfo {
+    workspaceHash: string;
+    projectPath: string;
+    composerIds: string[];
+}
+/** Aggregate cache entry for parsed session data. */
+export interface SessionAggregateCacheEntry {
+    updatedAt: number;
+    usageRows: SessionUsageData[];
+    lastAccessed: number;
+}
+/** A single row from Cursor's CSV usage export (`/api/dashboard/export-usage-events-csv`). */
+export interface CursorCsvUsageRow {
+    timestamp: number;
+    kind: string;
+    model: string;
+    maxMode: boolean;
+    inputTokensWithCacheWrite: number;
+    inputTokensWithoutCacheWrite: number;
+    cacheReadTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    cost: number;
+}
+//# 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":"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"}

package/dist/utils.d.ts

@@ -0,0 +1,19 @@
+import { Database } from 'bun:sqlite';
+import type { CursorBubbleData, CursorComposerData, CursorWorkspaceComposerIndex, CursorWorkspaceJson } from './types.ts';
+export declare function openDatabase(dbPath: string): Database | null;
+/**
+ * Open a database WITHOUT readonly mode. Used by the activity watcher to
+ * avoid WAL snapshot isolation — bun:sqlite in readonly mode may not see
+ * rows that exist only in the WAL file (not yet checkpointed).
+ * Read-write connections in WAL mode always read the latest WAL state.
+ */
+export declare function openDatabaseForWatcher(dbPath: string): Database | null;
+export declare function readComposerData(db: Database, composerId: string): CursorComposerData | null;
+export declare function readBubbleData(db: Database, composerId: string, bubbleId: string): CursorBubbleData | null;
+export declare function readAllComposerIds(db: Database): string[];
+export declare function readAllBubbleKeys(db: Database, composerId: string): string[];
+export declare function readWorkspaceComposerIndex(workspaceDirPath: string): CursorWorkspaceComposerIndex | null;
+export declare function readWorkspaceJson(workspaceDirPath: string): Promise<CursorWorkspaceJson | null>;
+export declare function parseWorkspaceFolderUri(folderUri: string): string;
+export declare function resolveProviderId(modelName: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,4BAA4B,EAC5B,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAM5D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAMtE;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAQ5F;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAQ1G;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,EAAE,CAQzD;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ5E;AAED,wBAAgB,0BAA0B,CAAC,gBAAgB,EAAE,MAAM,GAAG,4BAA4B,GAAG,IAAI,CAcxG;AAED,wBAAsB,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAOrG;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CASjE;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAS3D"}

package/dist/watcher.d.ts

@@ -0,0 +1,17 @@
+import * as fsSync from 'fs';
+import type { ActivityCallback } from '@tokentop/plugin-sdk';
+export interface SessionWatcherState {
+    watchers: fsSync.FSWatcher[];
+    dirty: boolean;
+    reconciliationTimer: ReturnType<typeof setInterval> | null;
+    started: boolean;
+}
+export declare const RECONCILIATION_INTERVAL_MS: number;
+export declare const sessionWatcher: SessionWatcherState;
+export declare let forceFullReconciliation: boolean;
+export declare function startSessionWatcher(): void;
+export declare function stopSessionWatcher(): void;
+export declare function consumeForceFullReconciliation(): boolean;
+export declare function startActivityWatch(callback: ActivityCallback): void;
+export declare function stopActivityWatch(): void;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,IAAI,CAAC;AAC7B,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,sBAAsB,CAAC;AAK7E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,mBAAmB,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,IAAI,CAAC;IAC3D,OAAO,EAAE,OAAO,CAAC;CAClB;AAeD,eAAO,MAAM,0BAA0B,QAAiB,CAAC;AAEzD,eAAO,MAAM,cAAc,EAAE,mBAK5B,CAAC;AAaF,eAAO,IAAI,uBAAuB,SAAQ,CAAC;AA+K3C,wBAAgB,mBAAmB,IAAI,IAAI,CAuB1C;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAczC;AAED,wBAAgB,8BAA8B,IAAI,OAAO,CAMxD;AAoBD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAmCnE;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAoBxC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokentop/agent-cursor",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Cursor AI editor session tracking",
   "type": "module",
   "main": "dist/index.js",
@@ -49,12 +49,11 @@
     "bun": ">=1.0.0"
   },
   "peerDependencies": {
-    "@tokentop/plugin-sdk": "^1.0.0"
+    "@tokentop/plugin-sdk": "^1.3.0"
   },
   "devDependencies": {
-    "@tokentop/plugin-sdk": "^1.0.1",
+    "@tokentop/plugin-sdk": "^1.3.0",
     "@types/bun": "latest",
-    "semantic-release": "^25.0.3",
     "typescript": "^5.7.0"
   }
 }