@spooky-sync/devtools-mcp 0.0.1-canary.69 → 0.0.1-canary.71

package/AGENTS.md

@@ -26,7 +26,8 @@ Wire into Claude / your agent via the MCP server config (`.mcp.json` at the repo
 - **`list_connections`** — which browser tabs are currently bridged.
 - **`get_state` `[tabId]`** — full devtools state: events, queries, auth, database tables (extension only).
 - **`get_auth_state` `[tabId]`** — current auth subject + scope (extension only).
-- **`get_active_queries` `[tabId]`** — registered live queries and their last result hashes.
+- **`get_active_queries` `[tabId]`** — registered live queries, their last result hashes, and a per-query `timings` breakdown.
+- **`get_query_timings` `[tabId]`** — per-query processing-time breakdown (SSP parse/plan/snapshot + store-apply/circuit-step/transform, local & remote record fetch, frontend reconcile; each as last/p50/p90/p99), sorted slowest-first. For debugging perf.
 - **`get_events` `[eventType] [limit]`** — recent event log, optionally filtered.
 - **`clear_history` `[tabId]`** — wipe the in-tab event log (extension only).
 

package/dist/server.js

@@ -106,6 +106,35 @@ export function createServer(bridge, surreal) {
         }
         throw new Error('No extension connected and no direct database configured.');
     });
+    server.tool('get_query_timings', 'Per-query processing-time breakdown for debugging: SSP phases (parse/plan/snapshot at registration; store-apply/circuit-step/transform per ingest, plus whole-ingest `ssp` wall time), local & remote record-fetch, and frontend reconcile — each as { lastMs, p50, p90, p99, count } — sorted slowest-first. Requires the Sp00ky DevTools browser extension. The SurrealDB fallback only exposes persisted materialization percentiles (the per-phase samples are in-memory).', { tabId: z.number().optional().describe('Browser tab ID') }, async ({ tabId }) => {
+        if (bridge.isConnected) {
+            const state = (await bridge.request(BRIDGE_METHODS.GET_STATE, {}, tabId));
+            const queries = state?.activeQueries
+                ? Object.values(state.activeQueries)
+                : [];
+            // Rank by the dominant phases' p90 (fall back to last) so the slowest
+            // query/phase surfaces first.
+            const scoreOf = (t) => ['ssp', 'localFetch', 'remoteFetch', 'frontend'].reduce((s, k) => s + (t?.[k]?.p90 ?? t?.[k]?.lastMs ?? 0), 0);
+            const rows = queries
+                .map((q) => ({
+                queryHash: q.queryHash,
+                query: q.query,
+                updateCount: q.timings?.updateCount ?? q.updateCount,
+                errorCount: q.timings?.errorCount,
+                timings: q.timings ?? null,
+                _score: scoreOf(q.timings),
+            }))
+                .sort((a, b) => b._score - a._score)
+                // oxlint-disable-next-line no-unused-vars -- strip the internal sort key
+                .map(({ _score, ...rest }) => rest);
+            return json(rows);
+        }
+        if (surreal) {
+            const result = await surreal.query('SELECT * FROM _00_query;');
+            return json(result);
+        }
+        throw new Error('No extension connected and no direct database configured.');
+    });
     server.tool('get_events', 'Get event history, optionally filtered by type', {
         eventType: z.string().optional().describe('Filter by event type'),
         limit: z.number().optional().default(50).describe('Max number of events to return'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spooky-sync/devtools-mcp",
-  "version": "0.0.1-canary.69",
+  "version": "0.0.1-canary.71",
   "description": "MCP server for Sp00ky Sync devtools",
   "license": "MIT",
   "type": "module",