@harness-fe/mcp-server 3.1.0 → 3.2.0

package/dist/mcp.js

@@ -320,6 +320,48 @@ function registerTools(server, bridge) {
         const out = await bridge.sendCommand(COMMAND.STORAGE_TAIL, { n: n ?? 20, filter, match, which, op, key }, { tabId });
         return ok(out);
     });
+    server.registerTool(COMMAND.NAVIGATION_TAIL, {
+        description: 'Return the last N navigation events captured by the runtime: history.pushState / replaceState, popstate, hashchange, and location.href / location.hash / location.assign() / location.replace(). Each entry has `kind`, `url`, `replace`, and an `initiator.stack` for interceptable kinds. Filter via `filter` (against {kind, url, replace}) or narrow with `kind`. Buffer is in-memory and cleared on navigate — use `session.tail` (type=["navigation"]) for cross-navigate history.',
+        inputSchema: {
+            n: z.number().int().positive().default(20).optional(),
+            filter: filterParam,
+            match: matchParam,
+            kind: z.enum(['push', 'replace', 'pop', 'hash', 'assign']).optional(),
+            tabId: tabIdParam,
+        },
+    }, async ({ n, filter, match, kind, tabId }) => {
+        const out = await bridge.sendCommand(COMMAND.NAVIGATION_TAIL, { n: n ?? 20, filter, match, kind }, { tabId });
+        return ok(out);
+    });
+    server.registerTool(COMMAND.GLOBALS_TAIL, {
+        description: 'Return the last N read/writes to watched window globals. Only fires for keys registered via the install opts `globals.watch` list — global pollution detection or app-state debugging. Each entry has op=get|set|delete, key, value, previousValue (on set), and initiator.stack. Filter via `filter` or narrow with `op` / `key`. Buffer is in-memory; cross-navigate use `session.tail` (type=["globals"]).',
+        inputSchema: {
+            n: z.number().int().positive().default(20).optional(),
+            filter: filterParam,
+            match: matchParam,
+            op: z.enum(['get', 'set', 'delete']).optional(),
+            key: z.string().optional().describe('Exact window key match.'),
+            tabId: tabIdParam,
+        },
+    }, async ({ n, filter, match, op, key, tabId }) => {
+        const out = await bridge.sendCommand(COMMAND.GLOBALS_TAIL, { n: n ?? 20, filter, match, op, key }, { tabId });
+        return ok(out);
+    });
+    server.registerTool(COMMAND.INDEXEDDB_TAIL, {
+        description: 'Return the last N IndexedDB operations: open / put / add / get / getAll / delete / clear / cursor. Each entry has `op`, `store`, `key`, `value`, `db`, `version`, `success` and `initiator.stack`. Useful for tracking who reads/writes which IDB store key. Filter via `filter` (against {op, store, key}) or narrow with `op` / `store` / `db`. Buffer is in-memory; cross-navigate use `session.tail` (type=["indexeddb"]).',
+        inputSchema: {
+            n: z.number().int().positive().default(20).optional(),
+            filter: filterParam,
+            match: matchParam,
+            op: z.enum(['open', 'put', 'add', 'get', 'getAll', 'delete', 'clear', 'cursor']).optional(),
+            store: z.string().optional().describe('Exact object-store name.'),
+            db: z.string().optional().describe('Exact database name (open events only).'),
+            tabId: tabIdParam,
+        },
+    }, async ({ n, filter, match, op, store, db, tabId }) => {
+        const out = await bridge.sendCommand(COMMAND.INDEXEDDB_TAIL, { n: n ?? 20, filter, match, op, store, db }, { tabId });
+        return ok(out);
+    });
     server.registerTool(COMMAND.TAB_LIST, {
         description: 'List all currently connected browser tabs.',
         inputSchema: {},

package/dist/store/types.d.ts

@@ -19,7 +19,7 @@
 import type { Task, VisitorEnv } from '@harness-fe/protocol';
 export type { EventId, EventStore, StreamId, } from '@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js';
 /** Short type codes used in JSONL lines to keep files compact. */
-export type EventType = 'log' | 'err' | 'req' | 'res' | 'cmd' | 'resp' | 'hmr' | 'task' | 'task:claim' | 'task:resolve' | 'rrweb' | 'node:log' | 'node:err' | 'note' | 'load' | 'storage' | 'ws' | 'server-log' | 'server-err' | 'server-action' | 'app-log' | string;
+export type EventType = 'log' | 'err' | 'req' | 'res' | 'cmd' | 'resp' | 'hmr' | 'task' | 'task:claim' | 'task:resolve' | 'rrweb' | 'node:log' | 'node:err' | 'note' | 'load' | 'storage' | 'ws' | 'navigation' | 'globals' | 'indexeddb' | 'server-log' | 'server-err' | 'server-action' | 'app-log' | string;
 /** A single event line in a JSONL file. Carries row-level projectId/buildId tags. */
 export interface StoreEvent {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-fe/mcp-server",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Unified MCP daemon: stdio MCP for AI agents + WS bridge for Vite plugin and runtime client.",
   "type": "module",
   "license": "MIT",
@@ -39,7 +39,7 @@
     "ws": "^8.18.0",
     "zod": "^4.4.3",
     "@harness-fe/dashboard-ui": "0.2.0",
-    "@harness-fe/protocol": "3.1.0"
+    "@harness-fe/protocol": "3.2.0"
   },
   "devDependencies": {
     "@types/ws": "^8.5.10",

package/src/mcp.ts

@@ -505,6 +505,78 @@ function registerTools(server: McpServer, bridge: IBridge): void {
         },
     );
 
+    server.registerTool(
+        COMMAND.NAVIGATION_TAIL,
+        {
+            description:
+                'Return the last N navigation events captured by the runtime: history.pushState / replaceState, popstate, hashchange, and location.href / location.hash / location.assign() / location.replace(). Each entry has `kind`, `url`, `replace`, and an `initiator.stack` for interceptable kinds. Filter via `filter` (against {kind, url, replace}) or narrow with `kind`. Buffer is in-memory and cleared on navigate — use `session.tail` (type=["navigation"]) for cross-navigate history.',
+            inputSchema: {
+                n: z.number().int().positive().default(20).optional(),
+                filter: filterParam,
+                match: matchParam,
+                kind: z.enum(['push', 'replace', 'pop', 'hash', 'assign']).optional(),
+                tabId: tabIdParam,
+            },
+        },
+        async ({ n, filter, match, kind, tabId }) => {
+            const out = await bridge.sendCommand(
+                COMMAND.NAVIGATION_TAIL,
+                { n: n ?? 20, filter, match, kind },
+                { tabId },
+            );
+            return ok(out);
+        },
+    );
+
+    server.registerTool(
+        COMMAND.GLOBALS_TAIL,
+        {
+            description:
+                'Return the last N read/writes to watched window globals. Only fires for keys registered via the install opts `globals.watch` list — global pollution detection or app-state debugging. Each entry has op=get|set|delete, key, value, previousValue (on set), and initiator.stack. Filter via `filter` or narrow with `op` / `key`. Buffer is in-memory; cross-navigate use `session.tail` (type=["globals"]).',
+            inputSchema: {
+                n: z.number().int().positive().default(20).optional(),
+                filter: filterParam,
+                match: matchParam,
+                op: z.enum(['get', 'set', 'delete']).optional(),
+                key: z.string().optional().describe('Exact window key match.'),
+                tabId: tabIdParam,
+            },
+        },
+        async ({ n, filter, match, op, key, tabId }) => {
+            const out = await bridge.sendCommand(
+                COMMAND.GLOBALS_TAIL,
+                { n: n ?? 20, filter, match, op, key },
+                { tabId },
+            );
+            return ok(out);
+        },
+    );
+
+    server.registerTool(
+        COMMAND.INDEXEDDB_TAIL,
+        {
+            description:
+                'Return the last N IndexedDB operations: open / put / add / get / getAll / delete / clear / cursor. Each entry has `op`, `store`, `key`, `value`, `db`, `version`, `success` and `initiator.stack`. Useful for tracking who reads/writes which IDB store key. Filter via `filter` (against {op, store, key}) or narrow with `op` / `store` / `db`. Buffer is in-memory; cross-navigate use `session.tail` (type=["indexeddb"]).',
+            inputSchema: {
+                n: z.number().int().positive().default(20).optional(),
+                filter: filterParam,
+                match: matchParam,
+                op: z.enum(['open', 'put', 'add', 'get', 'getAll', 'delete', 'clear', 'cursor']).optional(),
+                store: z.string().optional().describe('Exact object-store name.'),
+                db: z.string().optional().describe('Exact database name (open events only).'),
+                tabId: tabIdParam,
+            },
+        },
+        async ({ n, filter, match, op, store, db, tabId }) => {
+            const out = await bridge.sendCommand(
+                COMMAND.INDEXEDDB_TAIL,
+                { n: n ?? 20, filter, match, op, store, db },
+                { tabId },
+            );
+            return ok(out);
+        },
+    );
+
     server.registerTool(
         COMMAND.TAB_LIST,
         {

package/src/mcpLayer.e2e.test.ts

@@ -27,6 +27,20 @@ import type {
     WsEntry,
 } from '@harness-fe/protocol';
 
+async function rmDirWithRetry(dir: string, attempts = 5): Promise<void> {
+    for (let i = 0; i < attempts; i++) {
+        try {
+            rmSync(dir, { recursive: true, force: true });
+            return;
+        } catch (err) {
+            const code = (err as NodeJS.ErrnoException).code;
+            if (code !== 'ENOTEMPTY' && code !== 'EBUSY' && code !== 'EPERM') throw err;
+            if (i === attempts - 1) throw err;
+            await new Promise((r) => setTimeout(r, 20 * (i + 1)));
+        }
+    }
+}
+
 interface TestEnv {
     bridge: Bridge;
     store: JsonlStore;
@@ -68,8 +82,8 @@ async function setup(): Promise<TestEnv> {
             await client.close();
             await server.close();
             await bridge.stop();
-            store.close();
-            rmSync(dir, { recursive: true, force: true });
+            await store.close();
+            await rmDirWithRetry(dir);
         },
     };
     envs.push(env);

package/src/newCapabilities.e2e.test.ts

@@ -52,12 +52,26 @@ async function setup(): Promise<TestEnv> {
     return env;
 }
 
+async function rmDirWithRetry(dir: string, attempts = 5): Promise<void> {
+    for (let i = 0; i < attempts; i++) {
+        try {
+            rmSync(dir, { recursive: true, force: true });
+            return;
+        } catch (err) {
+            const code = (err as NodeJS.ErrnoException).code;
+            if (code !== 'ENOTEMPTY' && code !== 'EBUSY' && code !== 'EPERM') throw err;
+            if (i === attempts - 1) throw err;
+            await new Promise((r) => setTimeout(r, 20 * (i + 1)));
+        }
+    }
+}
+
 afterEach(async () => {
     while (envs.length > 0) {
         const env = envs.pop()!;
         await env.bridge.stop();
-        env.store.close();
-        rmSync(env.dir, { recursive: true, force: true });
+        await env.store.close();
+        await rmDirWithRetry(env.dir);
     }
 });
 

package/src/store/types.ts

@@ -49,6 +49,9 @@ export type EventType =
     | 'load'         // page-load initial snapshot
     | 'storage'      // localStorage/sessionStorage/cookie mutation
     | 'ws'           // WebSocket frame (open / send / recv / close)
+    | 'navigation'   // history.pushState/replaceState/popstate/hashchange + location.* setters
+    | 'globals'      // window.X get/set/delete (build-time-watched keys)
+    | 'indexeddb'    // IDB open / put / add / get / delete / clear / cursor
     | 'server-log'   // Node.js console log from node-runtime SDK
     | 'server-err'   // Node.js uncaughtException / unhandledRejection from node-runtime SDK
     | 'server-action'// Route Handler / Server Action timing from withHarnessTracing()