@dimina-kit/devtools 0.1.0-dev.20260422094158

package/dist/main/services/mcp/target-manager.js

@@ -0,0 +1,165 @@
+/**
+ * Dual-target CDP connection manager.
+ *
+ * The MCP server connects to two Chrome DevTools Protocol targets in parallel:
+ *   - `simulator`: the in-app simulator `<webview>` (identified by its URL)
+ *   - `workbench`: the workbench main renderer window
+ *
+ * Each target keeps:
+ *   - a CDP client (reconnected automatically when the target disappears)
+ *   - rolling buffers of console log and network request events
+ */
+import CDP from 'chrome-remote-interface';
+const SIMULATOR_URL_PATTERN = 'localhost:7788';
+const MAX_BUFFER = 500;
+const RECONNECT_INTERVAL_MS = 3000;
+let cdpPort = 9222;
+const targets = {
+    simulator: { client: null, connected: false, timer: null, consoleLogs: [], networkRequests: [] },
+    workbench: { client: null, connected: false, timer: null, consoleLogs: [], networkRequests: [] },
+};
+export function setCdpPort(port) {
+    cdpPort = port;
+}
+export function getTargetState(kind) {
+    return targets[kind];
+}
+async function listCdpTargets() {
+    try {
+        return await CDP.List({ port: cdpPort });
+    }
+    catch {
+        return [];
+    }
+}
+export { listCdpTargets as listTargets };
+function findTarget(allTargets, kind) {
+    if (kind === 'simulator') {
+        return allTargets.find((t) => t.url?.includes(SIMULATOR_URL_PATTERN));
+    }
+    // workbench main window: page target whose URL contains index.html (renderer)
+    return allTargets.find((t) => t.type === 'page' && t.url?.includes('entries/main/index.html') && !t.url?.includes(SIMULATOR_URL_PATTERN));
+}
+export async function connectTarget(kind) {
+    const state = targets[kind];
+    if (state.client) {
+        try {
+            await state.client.close();
+        }
+        catch { }
+        state.client = null;
+    }
+    const allTargets = await listCdpTargets();
+    const target = findTarget(allTargets, kind);
+    if (!target) {
+        state.connected = false;
+        scheduleReconnect(kind);
+        return;
+    }
+    let client = null;
+    try {
+        client = await CDP({ port: cdpPort, target });
+        await Promise.all([
+            client.Page.enable(),
+            client.Runtime.enable(),
+            client.DOM.enable(),
+            client.Network.enable(),
+            client.Console.enable(),
+        ]);
+        // Network buffer
+        const pending = new Map();
+        const pushNetworkRequest = (entry) => {
+            state.networkRequests.push(entry);
+            if (state.networkRequests.length > MAX_BUFFER)
+                state.networkRequests = state.networkRequests.slice(-MAX_BUFFER);
+        };
+        // Console buffer
+        client.Runtime.on('consoleAPICalled', (params) => {
+            const entry = {
+                level: params.type,
+                text: params.args.map((a) => String(a.value ?? a.description ?? JSON.stringify(a))).join(' '),
+                timestamp: new Date(params.timestamp).toISOString(),
+            };
+            state.consoleLogs.push(entry);
+            if (state.consoleLogs.length > MAX_BUFFER)
+                state.consoleLogs = state.consoleLogs.slice(-MAX_BUFFER);
+        });
+        client.Console.on('messageAdded', (params) => {
+            const msg = params.message;
+            state.consoleLogs.push({ level: msg.level, text: msg.text, timestamp: new Date().toISOString() });
+            if (state.consoleLogs.length > MAX_BUFFER)
+                state.consoleLogs = state.consoleLogs.slice(-MAX_BUFFER);
+        });
+        client.Network.on('requestWillBeSent', (params) => {
+            pending.set(params.requestId, { url: params.request.url, method: params.request.method, timestamp: params.timestamp });
+        });
+        client.Network.on('responseReceived', (params) => {
+            const req = pending.get(params.requestId);
+            if (!req)
+                return;
+            pending.delete(params.requestId);
+            pushNetworkRequest({
+                url: req.url, method: req.method,
+                status: params.response.status, mimeType: params.response.mimeType,
+                responseSize: params.response.encodedDataLength || 0,
+                timing: params.response.timing
+                    ? { requestTime: params.response.timing.requestTime, receiveHeadersEnd: params.response.timing.receiveHeadersEnd }
+                    : null,
+            });
+        });
+        client.Network.on('loadingFailed', (params) => {
+            const req = pending.get(params.requestId);
+            if (!req)
+                return;
+            pending.delete(params.requestId);
+            pushNetworkRequest({
+                url: req.url,
+                method: req.method,
+                status: 0,
+                mimeType: '',
+                responseSize: 0,
+                timing: null,
+            });
+        });
+        client.on('disconnect', () => {
+            state.connected = false;
+            state.client = null;
+            scheduleReconnect(kind);
+        });
+        state.client = client;
+        state.connected = true;
+        if (state.timer) {
+            clearTimeout(state.timer);
+            state.timer = null;
+        }
+    }
+    catch {
+        if (client) {
+            try {
+                await client.close();
+            }
+            catch { }
+        }
+        state.client = null;
+        state.connected = false;
+        scheduleReconnect(kind);
+    }
+}
+function scheduleReconnect(kind) {
+    const state = targets[kind];
+    if (state.timer)
+        return;
+    state.timer = setTimeout(async () => {
+        state.timer = null;
+        await connectTarget(kind);
+    }, RECONNECT_INTERVAL_MS);
+}
+export function getClient(kind) {
+    const state = targets[kind];
+    if (!state.connected || !state.client) {
+        const label = kind === 'simulator' ? '模拟器' : '主窗口';
+        throw new Error(`未连接到${label}。请确保 dimina-devtools 正在以开发模式运行。`);
+    }
+    return state.client;
+}
+//# sourceMappingURL=target-manager.js.map

package/dist/main/services/mcp/target-manager.js.map

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

package/dist/main/services/mcp/tool-registry.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Registration helpers for the 5 MCP tools that exist symmetrically for both
+ * simulator and workbench targets (screenshot / console_logs / evaluate /
+ * get_dom / network_log). Wiring the shared set here keeps the handler
+ * definitions in one place while still allowing kind-specific descriptions.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type TargetKind } from './target-manager.js';
+/**
+ * Registers the 5 tools that exist symmetrically for both targets.
+ * Each tool name is prefixed with the kind (e.g. `simulator_screenshot`).
+ */
+export declare function registerCommonTargetTools(server: McpServer, kind: TargetKind): void;
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/main/services/mcp/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../../src/main/services/mcp/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhF;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CA2EnF"}

package/dist/main/services/mcp/tool-registry.js

@@ -0,0 +1,84 @@
+/**
+ * Registration helpers for the 5 MCP tools that exist symmetrically for both
+ * simulator and workbench targets (screenshot / console_logs / evaluate /
+ * get_dom / network_log). Wiring the shared set here keeps the handler
+ * definitions in one place while still allowing kind-specific descriptions.
+ */
+import { z } from 'zod';
+import { getClient, getTargetState } from './target-manager.js';
+/**
+ * Registers the 5 tools that exist symmetrically for both targets.
+ * Each tool name is prefixed with the kind (e.g. `simulator_screenshot`).
+ */
+export function registerCommonTargetTools(server, kind) {
+    const descriptions = kind === 'simulator'
+        ? {
+            screenshot: 'Take a screenshot of the simulator webview',
+            consoleLogs: 'Get recent console output from the simulator (supports level/sinceTimestamp filters)',
+            evaluate: 'Execute JavaScript in the simulator context',
+            getDom: 'Get the DOM tree of the simulator page',
+            networkLog: 'Get recent network requests from the simulator (supports minStatus filter)',
+        }
+        : {
+            screenshot: 'Take a screenshot of the workbench main window',
+            consoleLogs: 'Get recent console output from the workbench main window (supports level/sinceTimestamp filters; warn/warning are treated as aliases)',
+            evaluate: 'Execute JavaScript in the workbench main window renderer',
+            getDom: 'Get the DOM tree of the workbench main window',
+            networkLog: 'Get recent network requests from the workbench main window (supports minStatus filter)',
+        };
+    server.tool(`${kind}_screenshot`, descriptions.screenshot, {}, async () => {
+        const c = getClient(kind);
+        const { data } = await c.Page.captureScreenshot({ format: 'png' });
+        return { content: [{ type: 'image', data, mimeType: 'image/png' }] };
+    });
+    server.tool(`${kind}_console_logs`, descriptions.consoleLogs, {
+        limit: z.number().optional().default(50).describe('Maximum number of log entries'),
+        level: z.enum(['error', 'warning', 'warn', 'info', 'log', 'debug']).optional().describe('Only return entries with this level'),
+        sinceTimestamp: z.string().optional().describe('ISO timestamp; only return entries at or after this time'),
+    }, async ({ limit, level, sinceTimestamp }) => {
+        getClient(kind);
+        let entries = getTargetState(kind).consoleLogs;
+        if (level) {
+            // Runtime.consoleAPICalled uses 'warning'; Console.messageAdded may emit 'warn'
+            const levels = level === 'warning' || level === 'warn' ? ['warning', 'warn'] : [level];
+            entries = entries.filter((e) => levels.includes(e.level));
+        }
+        if (sinceTimestamp) {
+            entries = entries.filter((e) => e.timestamp >= sinceTimestamp);
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(entries.slice(-limit), null, 2) }] };
+    });
+    // workbench has nodeIntegration; evaluate would equal arbitrary local code execution
+    if (kind !== 'workbench') {
+        server.tool(`${kind}_evaluate`, descriptions.evaluate, {
+            expression: z.string().describe('JavaScript expression to evaluate'),
+        }, async ({ expression }) => {
+            const c = getClient(kind);
+            const result = await c.Runtime.evaluate({ expression, returnByValue: true, awaitPromise: true });
+            if (result.exceptionDetails) {
+                return { content: [{ type: 'text', text: `Error: ${result.exceptionDetails.text}\n${JSON.stringify(result.exceptionDetails, null, 2)}` }], isError: true };
+            }
+            const value = result.result.value !== undefined ? result.result.value : result.result.description || result.result.type;
+            return { content: [{ type: 'text', text: JSON.stringify(value, null, 2) }] };
+        });
+    }
+    server.tool(`${kind}_get_dom`, descriptions.getDom, {
+        depth: z.number().optional().default(3).describe('Maximum depth'),
+    }, async ({ depth }) => {
+        const c = getClient(kind);
+        const { root } = await c.DOM.getDocument({ depth });
+        return { content: [{ type: 'text', text: JSON.stringify(root, null, 2) }] };
+    });
+    server.tool(`${kind}_network_log`, descriptions.networkLog, {
+        limit: z.number().optional().default(20).describe('Maximum number of entries'),
+        minStatus: z.number().optional().describe('Only return entries with status >= minStatus (status 0 = failed before response is included when minStatus >= 400)'),
+    }, async ({ limit, minStatus }) => {
+        getClient(kind);
+        let entries = getTargetState(kind).networkRequests;
+        if (minStatus !== undefined) {
+            entries = entries.filter((e) => e.status >= minStatus || (e.status === 0 && minStatus >= 400));
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(entries.slice(-limit), null, 2) }] };
+    });
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/main/services/mcp/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../../../src/main/services/mcp/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAmB,MAAM,qBAAqB,CAAA;AAEhF;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiB,EAAE,IAAgB;IAC3E,MAAM,YAAY,GAAG,IAAI,KAAK,WAAW;QACvC,CAAC,CAAC;YACE,UAAU,EAAE,4CAA4C;YACxD,WAAW,EAAE,sFAAsF;YACnG,QAAQ,EAAE,6CAA6C;YACvD,MAAM,EAAE,wCAAwC;YAChD,UAAU,EAAE,4EAA4E;SACzF;QACH,CAAC,CAAC;YACE,UAAU,EAAE,gDAAgD;YAC5D,WAAW,EAAE,uIAAuI;YACpJ,QAAQ,EAAE,0DAA0D;YACpE,MAAM,EAAE,+CAA+C;YACvD,UAAU,EAAE,wFAAwF;SACrG,CAAA;IAEL,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,aAAa,EAAE,YAAY,CAAC,UAAU,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;QACzB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;QAClE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,CAAA;IAC/E,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,eAAe,EAAE,YAAY,CAAC,WAAW,EAAE;QAC5D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QAClF,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QAC9H,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;KAC3G,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE;QAC5C,SAAS,CAAC,IAAI,CAAC,CAAA;QACf,IAAI,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,WAAW,CAAA;QAC9C,IAAI,KAAK,EAAE,CAAC;YACV,gFAAgF;YAChF,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;YACtF,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;QAC3D,CAAC;QACD,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,cAAc,CAAC,CAAA;QAChE,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;IACvG,CAAC,CAAC,CAAA;IAEF,qFAAqF;IACrF,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,WAAW,EAAE,YAAY,CAAC,QAAQ,EAAE;YACrD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;SACrE,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;YAC1B,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;YACzB,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAA;YAChG,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBAC5B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,MAAM,CAAC,gBAAgB,CAAC,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;YACrK,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAA;YACvH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;QACvF,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,UAAU,EAAE,YAAY,CAAC,MAAM,EAAE;QAClD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;KAClE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QACrB,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;QACzB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QACnD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;IACtF,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,cAAc,EAAE,YAAY,CAAC,UAAU,EAAE;QAC1D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QAC9E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oHAAoH,CAAC;KAChK,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE;QAChC,SAAS,CAAC,IAAI,CAAC,CAAA;QACf,IAAI,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,eAAe,CAAA;QAClD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,SAAS,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,IAAI,GAAG,CAAC,CAAC,CAAA;QAChG,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;IACvG,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/main/services/mcp/tools/context-tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * One-shot MCP orientation tools.
+ *
+ * `simulator_get_overview` / `workbench_get_overview` return a single compact
+ * JSON snapshot so AI clients can orient themselves at session start without
+ * issuing many separate probe calls (page info, storage, console, network).
+ *
+ * Registered as tools rather than MCP resources: the payload is highly
+ * dynamic (CDP state + rolling buffers), current clients invoke tools more
+ * reliably than they read resources, and this keeps the surface consistent
+ * with sibling `*_get_page_info` / `*_connection_status` tools.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerContextTools(server: McpServer): void;
+//# sourceMappingURL=context-tools.d.ts.map

package/dist/main/services/mcp/tools/context-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tools.d.ts","sourceRoot":"","sources":["../../../../../src/main/services/mcp/tools/context-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAuJxE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+H5D"}

package/dist/main/services/mcp/tools/context-tools.js

@@ -0,0 +1,244 @@
+/**
+ * One-shot MCP orientation tools.
+ *
+ * `simulator_get_overview` / `workbench_get_overview` return a single compact
+ * JSON snapshot so AI clients can orient themselves at session start without
+ * issuing many separate probe calls (page info, storage, console, network).
+ *
+ * Registered as tools rather than MCP resources: the payload is highly
+ * dynamic (CDP state + rolling buffers), current clients invoke tools more
+ * reliably than they read resources, and this keeps the surface consistent
+ * with sibling `*_get_page_info` / `*_connection_status` tools.
+ */
+import { getClient, getTargetState } from '../target-manager.js';
+// Truncation thresholds: keep the overview compact — orientation, not data dump.
+const MAX_KEYS = 50;
+const MAX_HINT_TEXT = 200;
+// Evaluated inside the simulator webview. Tolerates missing __simulatorData.
+const SIMULATOR_PROBE_EXPR = `(() => {
+  const out = {
+    url: location.href,
+    title: document.title,
+    viewport: { width: window.innerWidth, height: window.innerHeight },
+    currentRoute: null,
+    pageStackDepth: 0,
+    storageKeys: [],
+    storageCount: 0,
+    appDataKeys: [],
+    bridgeReady: false,
+    simulatorDataPresent: false,
+  };
+  try {
+    const frames = document.querySelectorAll('.dimina-native-webview__window');
+    out.pageStackDepth = frames.length;
+    const active = frames[frames.length - 1];
+    if (active) {
+      out.currentRoute = active.getAttribute('data-route')
+        || active.getAttribute('src')
+        || active.getAttribute('data-path')
+        || null;
+    }
+  } catch (e) {}
+  try {
+    const bridge = window.__simulatorData;
+    if (bridge) {
+      out.simulatorDataPresent = true;
+      if (typeof bridge.getStorageSnapshot === 'function') {
+        const snap = bridge.getStorageSnapshot();
+        out.bridgeReady = !!(snap && snap.ready);
+        const data = (snap && snap.data) || {};
+        out.storageKeys = Object.keys(data).slice(0, ${MAX_KEYS});
+        out.storageCount = Object.keys(data).length;
+      }
+      if (typeof bridge.getAppdata === 'function') {
+        const app = bridge.getAppdata() || {};
+        out.appDataKeys = Object.keys(app).slice(0, ${MAX_KEYS});
+      }
+    }
+  } catch (e) {}
+  return JSON.stringify(out);
+})()`;
+const WORKBENCH_PROBE_EXPR = `(() => JSON.stringify({
+  url: location.href,
+  title: document.title,
+  viewport: { width: window.innerWidth, height: window.innerHeight },
+}))()`;
+function summarizeConsole(kind) {
+    const logs = getTargetState(kind).consoleLogs;
+    let recentErrorCount = 0;
+    let recentWarningCount = 0;
+    let lastError = null;
+    for (const entry of logs) {
+        if (entry.level === 'error') {
+            recentErrorCount++;
+            lastError = { level: entry.level, text: entry.text.slice(0, MAX_HINT_TEXT), timestamp: entry.timestamp };
+        }
+        else if (entry.level === 'warning' || entry.level === 'warn') {
+            recentWarningCount++;
+        }
+    }
+    return { total: logs.length, recentErrorCount, recentWarningCount, lastError };
+}
+function summarizeNetwork(kind) {
+    const reqs = getTargetState(kind).networkRequests;
+    let recentNetworkErrorCount = 0;
+    let lastNetworkError = null;
+    for (const r of reqs) {
+        if (r.status >= 400 || r.status === 0) {
+            recentNetworkErrorCount++;
+            lastNetworkError = { url: r.url, status: r.status, method: r.method };
+        }
+    }
+    return { total: reqs.length, recentNetworkErrorCount, lastNetworkError };
+}
+function buildDisconnectedOverview(kind, hints) {
+    if (kind === 'simulator') {
+        return {
+            connected: false,
+            url: '',
+            title: '',
+            viewport: null,
+            currentRoute: null,
+            pageStackDepth: 0,
+            storageKeys: [],
+            storageCount: 0,
+            appDataKeys: [],
+            recentErrorCount: 0,
+            lastError: null,
+            recentWarningCount: 0,
+            recentNetworkErrorCount: 0,
+            lastNetworkError: null,
+            consoleLogTotal: 0,
+            networkRequestTotal: 0,
+            hints,
+        };
+    }
+    return {
+        connected: false,
+        url: '',
+        title: '',
+        viewport: null,
+        recentErrorCount: 0,
+        lastError: null,
+        recentNetworkErrorCount: 0,
+        lastNetworkError: null,
+        consoleLogTotal: 0,
+        networkRequestTotal: 0,
+        hints,
+    };
+}
+export function registerContextTools(server) {
+    server.tool('simulator_get_overview', 'One-shot orientation snapshot of the simulator (page, storage keys, appdata keys, recent errors). Call at session start to avoid many probe queries.', {}, async () => {
+        const state = getTargetState('simulator');
+        const hints = [];
+        if (!state.connected || !state.client) {
+            const payload = buildDisconnectedOverview('simulator', ['simulator not connected — ensure dimina-devtools is running in dev mode']);
+            return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
+        }
+        let result;
+        try {
+            const c = getClient('simulator');
+            result = await c.Runtime.evaluate({ expression: SIMULATOR_PROBE_EXPR, returnByValue: true });
+        }
+        catch {
+            const payload = buildDisconnectedOverview('simulator', [...hints, 'simulator disconnected before overview could finish']);
+            return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
+        }
+        if (result.exceptionDetails) {
+            return {
+                content: [{ type: 'text', text: `Error: ${result.exceptionDetails.text}` }],
+                isError: true,
+            };
+        }
+        let probe;
+        try {
+            probe = JSON.parse(result.result.value);
+        }
+        catch {
+            return {
+                content: [{ type: 'text', text: 'Error: probe returned non-JSON payload' }],
+                isError: true,
+            };
+        }
+        if (!probe.simulatorDataPresent)
+            hints.push('simulator bridge not ready (window.__simulatorData missing)');
+        else if (!probe.bridgeReady)
+            hints.push('simulator bridge present but storage snapshot not ready');
+        if (probe.pageStackDepth === 0)
+            hints.push('no active miniapp page (empty page stack)');
+        if (probe.storageCount > MAX_KEYS)
+            hints.push(`storageKeys truncated to first ${MAX_KEYS} of ${probe.storageCount}`);
+        const consoleSum = summarizeConsole('simulator');
+        const networkSum = summarizeNetwork('simulator');
+        const payload = {
+            connected: true,
+            url: probe.url,
+            title: probe.title,
+            viewport: probe.viewport,
+            currentRoute: probe.currentRoute,
+            pageStackDepth: probe.pageStackDepth,
+            storageKeys: probe.storageKeys,
+            storageCount: probe.storageCount,
+            appDataKeys: probe.appDataKeys,
+            recentErrorCount: consoleSum.recentErrorCount,
+            lastError: consoleSum.lastError,
+            recentWarningCount: consoleSum.recentWarningCount,
+            recentNetworkErrorCount: networkSum.recentNetworkErrorCount,
+            lastNetworkError: networkSum.lastNetworkError,
+            consoleLogTotal: consoleSum.total,
+            networkRequestTotal: networkSum.total,
+            hints,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
+    });
+    server.tool('workbench_get_overview', 'One-shot orientation snapshot of the workbench main window (url, title, viewport, recent errors, totals).', {}, async () => {
+        const state = getTargetState('workbench');
+        const hints = [];
+        if (!state.connected || !state.client) {
+            const payload = buildDisconnectedOverview('workbench', ['workbench not connected — ensure dimina-devtools is running in dev mode']);
+            return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
+        }
+        let result;
+        try {
+            const c = getClient('workbench');
+            result = await c.Runtime.evaluate({ expression: WORKBENCH_PROBE_EXPR, returnByValue: true });
+        }
+        catch {
+            const payload = buildDisconnectedOverview('workbench', [...hints, 'workbench disconnected before overview could finish']);
+            return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
+        }
+        if (result.exceptionDetails) {
+            return {
+                content: [{ type: 'text', text: `Error: ${result.exceptionDetails.text}` }],
+                isError: true,
+            };
+        }
+        let probe;
+        try {
+            probe = JSON.parse(result.result.value);
+        }
+        catch {
+            return {
+                content: [{ type: 'text', text: 'Error: probe returned non-JSON payload' }],
+                isError: true,
+            };
+        }
+        const consoleSum = summarizeConsole('workbench');
+        const networkSum = summarizeNetwork('workbench');
+        const payload = {
+            connected: true,
+            url: probe.url,
+            title: probe.title,
+            viewport: probe.viewport,
+            recentErrorCount: consoleSum.recentErrorCount,
+            lastError: consoleSum.lastError,
+            recentNetworkErrorCount: networkSum.recentNetworkErrorCount,
+            lastNetworkError: networkSum.lastNetworkError,
+            consoleLogTotal: consoleSum.total,
+            networkRequestTotal: networkSum.total,
+            hints,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
+    });
+}
+//# sourceMappingURL=context-tools.js.map

package/dist/main/services/mcp/tools/context-tools.js.map

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

package/dist/main/services/mcp/tools/simulator-tools.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Simulator-specific MCP tools beyond the shared set (screenshot, console,
+ * evaluate, DOM, network) registered via `registerCommonTargetTools`.
+ *
+ * Two tools live here:
+ *   - `simulator_navigate`: navigate or reload the simulator webview
+ *   - `simulator_input`: unified input dispatcher (tap/type/scroll/key)
+ *
+ * Other simulator inspection use-cases (storage get/set, page info) are
+ * handled via `simulator_evaluate` and `simulator_get_overview`.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSimulatorTools(server: McpServer): void;
+//# sourceMappingURL=simulator-tools.d.ts.map

package/dist/main/services/mcp/tools/simulator-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulator-tools.d.ts","sourceRoot":"","sources":["../../../../../src/main/services/mcp/tools/simulator-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAIxE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiI9D"}