mcp-probe-kit 3.2.0 → 3.6.0

package/build/lib/cursor-history-client.js

@@ -0,0 +1,240 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import sqlite3 from 'sqlite3';
+import { createToolError } from '../utils/error-handler.js';
+function parseJson(value) {
+    if (!value) {
+        return null;
+    }
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+}
+function fileExists(filePath) {
+    try {
+        return fs.existsSync(filePath) && fs.statSync(filePath).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function resolveCursorGlobalDbPath() {
+    const appData = process.env.APPDATA?.trim();
+    const homeDir = os.homedir();
+    const candidates = [
+        appData ? path.join(appData, 'Cursor', 'User', 'globalStorage', 'state.vscdb') : '',
+        path.join(homeDir, '.config', 'Cursor', 'User', 'globalStorage', 'state.vscdb'),
+        path.join(homeDir, 'Library', 'Application Support', 'Cursor', 'User', 'globalStorage', 'state.vscdb'),
+    ].filter(Boolean);
+    const hit = candidates.find(fileExists);
+    if (!hit) {
+        throw createToolError('未找到 Cursor 全局状态库 state.vscdb', undefined, {
+            candidates,
+        });
+    }
+    return hit;
+}
+function openDatabase(dbPath) {
+    return new Promise((resolve, reject) => {
+        const db = new sqlite3.Database(dbPath, sqlite3.OPEN_READONLY, (error) => {
+            if (error) {
+                reject(createToolError(`打开 Cursor 数据库失败: ${error.message}`, error, { dbPath }));
+                return;
+            }
+            resolve(db);
+        });
+    });
+}
+function closeDatabase(db) {
+    return new Promise((resolve, reject) => {
+        db.close((error) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve();
+        });
+    });
+}
+function allRows(db, sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.all(sql, params, (error, rows) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve((rows ?? []));
+        });
+    });
+}
+function getRow(db, sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.get(sql, params, (error, row) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve(row);
+        });
+    });
+}
+function asString(value) {
+    return typeof value === 'string' ? value : '';
+}
+function asNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function asBoolean(value) {
+    return typeof value === 'boolean' ? value : undefined;
+}
+function extractConversationsFromHeaders(payload) {
+    const items = payload?.allComposers ?? [];
+    return items
+        .filter((item) => item?.type === 'head')
+        .map((item) => {
+        const workspace = item.workspaceIdentifier ?? {};
+        const uri = workspace.uri ?? {};
+        return {
+            composerId: asString(item.composerId),
+            name: asString(item.name),
+            createdAt: asNumber(item.createdAt),
+            lastUpdatedAt: asNumber(item.lastUpdatedAt),
+            workspaceId: asString(workspace.id) || undefined,
+            workspacePath: asString(uri.fsPath) || undefined,
+            mode: asString(item.unifiedMode) || undefined,
+            contextUsagePercent: asNumber(item.contextUsagePercent),
+            subtitle: asString(item.subtitle) || undefined,
+            isArchived: asBoolean(item.isArchived) ?? false,
+            source: 'composerHeaders',
+        };
+    });
+}
+function extractBubbleId(key) {
+    const parts = key.split(':');
+    return parts[parts.length - 1] || key;
+}
+function extractComposerId(key) {
+    const parts = key.split(':');
+    return parts.length >= 3 ? parts[1] || '' : '';
+}
+export class CursorHistoryClient {
+    async withDatabase(runner) {
+        const dbPath = resolveCursorGlobalDbPath();
+        const db = await openDatabase(dbPath);
+        try {
+            return await runner(db);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw createToolError(`读取 Cursor 历史失败: ${error.message}`, error, { dbPath });
+            }
+            throw error;
+        }
+        finally {
+            await closeDatabase(db).catch(() => undefined);
+        }
+    }
+    async loadConversationIndex(db) {
+        const row = await getRow(db, "select key, value from ItemTable where key = ?", ['composer.composerHeaders']);
+        const payload = parseJson(row?.value);
+        return extractConversationsFromHeaders(payload);
+    }
+    async listConversations(params = {}) {
+        return this.withDatabase(async (db) => {
+            const titleQuery = (params.titleQuery ?? '').trim().toLowerCase();
+            const workspaceQuery = (params.workspaceQuery ?? '').trim().toLowerCase();
+            const includeArchived = params.includeArchived ?? false;
+            const limit = Math.max(1, Math.min(params.limit ?? 20, 200));
+            const conversations = await this.loadConversationIndex(db);
+            return conversations
+                .filter((item) => includeArchived || !item.isArchived)
+                .filter((item) => !titleQuery || item.name.toLowerCase().includes(titleQuery))
+                .filter((item) => !workspaceQuery || (item.workspacePath ?? '').toLowerCase().includes(workspaceQuery))
+                .sort((a, b) => (b.lastUpdatedAt ?? 0) - (a.lastUpdatedAt ?? 0))
+                .slice(0, limit);
+        });
+    }
+    async searchHistory(params) {
+        return this.withDatabase(async (db) => {
+            const query = (params.query ?? '').trim().toLowerCase();
+            if (!query) {
+                throw new Error('缺少 query');
+            }
+            const limit = Math.max(1, Math.min(params.limit ?? 20, 200));
+            const composerId = (params.composerId ?? '').trim();
+            const index = await this.loadConversationIndex(db);
+            const names = new Map(index.map((item) => [item.composerId, item.name]));
+            const rows = await allRows(db, 'select key, value from cursorDiskKV where key like ?', [composerId ? `bubbleId:${composerId}:%` : 'bubbleId:%']);
+            const matches = rows
+                .map((row) => {
+                const parsed = parseJson(row.value);
+                if (!parsed) {
+                    return null;
+                }
+                const text = asString(parsed.text);
+                const requestId = asString(parsed.requestId);
+                const haystack = `${row.key}\n${text}\n${requestId}`.toLowerCase();
+                if (!haystack.includes(query)) {
+                    return null;
+                }
+                const currentComposerId = extractComposerId(row.key);
+                return {
+                    composerId: currentComposerId,
+                    conversationName: names.get(currentComposerId) ?? '',
+                    bubbleId: extractBubbleId(row.key),
+                    type: asNumber(parsed.type) ?? 0,
+                    text,
+                    createdAt: asString(parsed.createdAt) || undefined,
+                    requestId: requestId || undefined,
+                };
+            })
+                .filter((item) => item !== null)
+                .sort((a, b) => (b.createdAt ?? '').localeCompare(a.createdAt ?? ''))
+                .slice(0, limit);
+            return matches;
+        });
+    }
+    async readConversation(params) {
+        return this.withDatabase(async (db) => {
+            const composerId = (params.composerId ?? '').trim();
+            if (!composerId) {
+                throw new Error('缺少 composer_id');
+            }
+            const limit = Math.max(1, Math.min(params.limit ?? 200, 2000));
+            const includeEmpty = params.includeEmpty ?? false;
+            const rows = await allRows(db, 'select key, value from cursorDiskKV where key like ?', [`bubbleId:${composerId}:%`]);
+            const messages = rows
+                .map((row) => {
+                const parsed = parseJson(row.value);
+                if (!parsed) {
+                    return null;
+                }
+                const text = asString(parsed.text);
+                if (!includeEmpty && !text) {
+                    return null;
+                }
+                return {
+                    bubbleId: extractBubbleId(row.key),
+                    type: asNumber(parsed.type) ?? 0,
+                    text,
+                    createdAt: asString(parsed.createdAt) || undefined,
+                    requestId: asString(parsed.requestId) || undefined,
+                };
+            })
+                .filter((item) => item !== null)
+                .sort((a, b) => (a.createdAt ?? '').localeCompare(b.createdAt ?? ''))
+                .slice(0, limit);
+            return {
+                composerId,
+                messages,
+            };
+        });
+    }
+}
+export function createCursorHistoryClient() {
+    return new CursorHistoryClient();
+}

package/build/lib/dev-workflow.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 开发工作流路由：根据用户意图生成「何时调哪个 MCP 工具」的委托式指南。
+ * 解决 Agent 直接写代码、跳过 start_* / code_insight / check_spec 的问题。
+ */
+export type WorkflowScenario = 'feature' | 'bugfix' | 'ui' | 'explore' | 'commit' | 'review' | 'refactor' | 'onboard' | 'spec' | 'memory' | 'unknown';
+export interface WorkflowToolStep {
+    tool: string;
+    required: boolean;
+    when: string;
+    note?: string;
+}
+export interface WorkflowPhase {
+    id: string;
+    title: string;
+    when: string;
+    steps: WorkflowToolStep[];
+}
+export interface DevWorkflowPlan {
+    scenario: WorkflowScenario;
+    scenarioLabel: string;
+    confidence: 'high' | 'medium' | 'low';
+    summary: string;
+    firstTool: string;
+    firstToolArgsHint?: Record<string, unknown>;
+    phases: WorkflowPhase[];
+    avoid: string[];
+    memoryNotes: string[];
+}
+export declare function detectWorkflowScenario(intent: string, explicit?: string): {
+    scenario: WorkflowScenario;
+    confidence: 'high' | 'medium' | 'low';
+};
+export declare function buildDevWorkflow(intent: string, options?: {
+    scenario?: string;
+}): DevWorkflowPlan;
+export declare function renderWorkflowMarkdown(plan: DevWorkflowPlan, intent: string): string;