@spooky-sync/cli 0.0.1-canary.290 → 0.0.1-canary.291

package/devtools-mcp/index.js

@@ -9166,7 +9166,8 @@ const BRIDGE_METHODS = {
   GET_QUERY_ROWS: "getQueryRows",
   UPDATE_TABLE_ROW: "updateTableRow",
   DELETE_TABLE_ROW: "deleteTableRow",
-  CLEAR_HISTORY: "clearHistory"
+  /** `{ method: 'mutationOp' | 'logOp', op, args }`: the Mutations / Logs dispatchers. */
+  PAGE_OP: "pageOp"
 };
 const BRIDGE_PORT = 9315;
 function isBridgeResponse(msg) {
@@ -12962,6 +12963,7 @@ var ZodFirstPartyTypeKind;
 })(ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {}));
 const stringType = ZodString.create;
 const numberType = ZodNumber.create;
+const booleanType = ZodBoolean.create;
 const unknownType = ZodUnknown.create;
 ZodNever.create;
 ZodArray.create;
@@ -23593,6 +23595,22 @@ const EMPTY_COMPLETION_RESULT = {
 function json(data) {
   return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
 }
+const LOG_LEVELS = { trace: 10, debug: 20, info: 30, warn: 40, error: 50, fatal: 60 };
+const LEVEL_NAMES = Object.keys(LOG_LEVELS);
+const levelName = (level) => Object.entries(LOG_LEVELS).reduce(
+  (name, [n, v]) => level >= v ? n : name,
+  "trace"
+);
+function readableLog(e) {
+  let data;
+  try {
+    const { time: _time, level: _level, msg: _msg, ...rest } = JSON.parse(e.line);
+    data = Object.keys(rest).length ? rest : void 0;
+  } catch {
+    data = { truncated: e.line };
+  }
+  return { seq: e.seq, time: new Date(e.time).toISOString(), level: levelName(e.level), msg: e.msg, data };
+}
 function createServer(bridge, surreal) {
   const server = new McpServer({
     name: "sp00ky-devtools",
@@ -23608,7 +23626,7 @@ function createServer(bridge, surreal) {
   );
   server.tool(
     "get_state",
-    "Get the full Sp00ky DevTools state (events, queries, auth, database)",
+    "Get the full Sp00ky DevTools state (queries, mutations, auth, database, versions)",
     { tabId: numberType().optional().describe("Browser tab ID (uses first connected tab if omitted)") },
     async ({ tabId }) => {
       if (!bridge.isConnected) {
@@ -23787,32 +23805,70 @@ function createServer(bridge, surreal) {
     }
   );
   server.tool(
-    "get_events",
-    "Get event history, optionally filtered by type",
+    "get_mutations",
+    `The client's writes: the outbox (pending / retrying with attempt counts), what left it since DevTools attached (synced with the server latency, or rolled back with the server error), debounced updates, the tab role and connection (a follower tab never drains), and the rows of the persistent failed-writes tray with their payload and before image. Answers "did my write reach the server?" and "why was it rolled back?".`,
     {
-      eventType: stringType().optional().describe("Filter by event type"),
-      limit: numberType().optional().default(50).describe("Max number of events to return"),
+      status: enumType(["pending", "retrying", "synced", "rolled-back", "dropped"]).optional().describe("Only entries with this status"),
+      includeTray: booleanType().optional().default(true).describe("Also read the failed-writes tray rows"),
       tabId: numberType().optional().describe("Browser tab ID")
     },
-    async ({ eventType, limit: limit2, tabId }) => {
-      if (bridge.isConnected) {
-        const state = await bridge.request(BRIDGE_METHODS.GET_STATE, {}, tabId);
-        let events = state?.eventsHistory ?? [];
-        if (eventType) {
-          events = events.filter((e) => e.eventType === eventType);
-        }
-        if (limit2) {
-          events = events.slice(-limit2);
-        }
-        return json(events);
+    async ({ status, includeTray, tabId }) => {
+      if (!bridge.isConnected) {
+        throw new Error("No extension connected. get_mutations requires the Sp00ky DevTools browser extension.");
       }
-      if (surreal) {
-        const result = await surreal.query(
-          `SELECT * FROM _00_events ORDER BY timestamp DESC LIMIT ${limit2};`
+      const state = await bridge.request(BRIDGE_METHODS.GET_STATE, {}, tabId);
+      const mutations = state?.mutations;
+      if (!mutations) {
+        throw new Error("This client does not report its mutations; update @spooky-sync/core.");
+      }
+      const entries = status ? (mutations.entries ?? []).filter((e) => e.status === status) : mutations.entries;
+      const failed = includeTray ? (await bridge.request(
+        BRIDGE_METHODS.PAGE_OP,
+        { method: "mutationOp", op: "listFailed", args: {} },
+        tabId
+      ))?.failed : void 0;
+      return json({ ...mutations, entries, failed });
+    }
+  );
+  server.tool(
+    "get_logs",
+    "Recent lines from the client's own logger (the page keeps its last 500), oldest first, each with its structured fields. Pass `after` = a previous call's `head` to read only what is new. `captureLevel` changes what the page records (e.g. 'debug') without printing more to the console; it holds for the tab's session, so a reload records its boot at that level.",
+    {
+      minLevel: enumType(LEVEL_NAMES).optional().describe("Only lines at or above this level"),
+      contains: stringType().optional().describe("Only lines whose JSON contains this text (case-insensitive)"),
+      after: numberType().optional().describe("Only lines after this seq (a previous `head`)"),
+      limit: numberType().optional().default(100).describe("Max lines, newest kept"),
+      captureLevel: enumType(LEVEL_NAMES).optional().describe("Set what the page records from now on"),
+      tabId: numberType().optional().describe("Browser tab ID")
+    },
+    async ({ minLevel, contains: contains2, after, limit: limit2, captureLevel, tabId }) => {
+      if (!bridge.isConnected) {
+        throw new Error("No extension connected. get_logs requires the Sp00ky DevTools browser extension.");
+      }
+      if (captureLevel) {
+        await bridge.request(
+          BRIDGE_METHODS.PAGE_OP,
+          { method: "logOp", op: "setCaptureLevel", args: { level: captureLevel } },
+          tabId
         );
-        return json(result);
       }
-      throw new Error("No extension connected and no direct database configured.");
+      const read = await bridge.request(
+        BRIDGE_METHODS.PAGE_OP,
+        { method: "logOp", op: "read", args: { after: after ?? 0 } },
+        tabId
+      );
+      const floor = minLevel ? LOG_LEVELS[minLevel] : 0;
+      const term = contains2?.toLowerCase();
+      const entries = (read?.entries ?? []).filter(
+        (e) => e.level >= floor && (!term || String(e.line).toLowerCase().includes(term))
+      );
+      return json({
+        head: read?.head,
+        dropped: read?.dropped,
+        consoleLevel: read?.consoleLevel,
+        captureLevel: read?.captureLevel,
+        entries: entries.slice(Math.max(0, entries.length - (limit2 ?? 100))).map(readableLog)
+      });
     }
   );
   server.tool(
@@ -23827,18 +23883,6 @@ function createServer(bridge, surreal) {
       return json(state?.auth ?? null);
     }
   );
-  server.tool(
-    "clear_history",
-    "Clear the event history",
-    { tabId: numberType().optional().describe("Browser tab ID") },
-    async ({ tabId }) => {
-      if (!bridge.isConnected) {
-        throw new Error("No extension connected. clear_history requires the Sp00ky DevTools browser extension.");
-      }
-      await bridge.request(BRIDGE_METHODS.CLEAR_HISTORY, {}, tabId);
-      return { content: [{ type: "text", text: "History cleared." }] };
-    }
-  );
   server.tool(
     "describe_schema",
     "Describe all tables with columns, types, and sp00ky annotations (@crdt, @parent). Stitches INFO FOR DB with parsed schema metadata. With the browser extension this returns @crdt/@parent semantics; direct-DB mode returns raw column info only.",
@@ -23983,18 +24027,6 @@ function createServer(bridge, surreal) {
     }
     throw new Error("No extension connected and no direct database configured.");
   });
-  server.resource("events", "sp00ky://events", { description: "Event history" }, async (uri2) => {
-    if (bridge.isConnected) {
-      const state = await bridge.request(BRIDGE_METHODS.GET_STATE);
-      const events = state?.eventsHistory ?? [];
-      return { contents: [{ uri: uri2.href, mimeType: "application/json", text: JSON.stringify(events, null, 2) }] };
-    }
-    if (surreal) {
-      const result = await surreal.query("SELECT * FROM _00_events ORDER BY timestamp DESC LIMIT 50;");
-      return { contents: [{ uri: uri2.href, mimeType: "application/json", text: JSON.stringify(result, null, 2) }] };
-    }
-    throw new Error("No extension connected and no direct database configured.");
-  });
   return server;
 }
 async function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spooky-sync/cli",
-  "version": "0.0.1-canary.290",
+  "version": "0.0.1-canary.291",
   "description": "Generate TypeScript/Dart types from SurrealDB schema files",
   "type": "module",
   "main": "./dist/syncgen.cjs",
@@ -62,10 +62,10 @@
     "vitest": "^1.0.0"
   },
   "optionalDependencies": {
-    "@spooky-sync/cli-darwin-arm64": "0.0.1-canary.290",
-    "@spooky-sync/cli-darwin-x64": "0.0.1-canary.290",
-    "@spooky-sync/cli-linux-arm64": "0.0.1-canary.290",
-    "@spooky-sync/cli-linux-x64": "0.0.1-canary.290",
-    "@spooky-sync/cli-win32-x64": "0.0.1-canary.290"
+    "@spooky-sync/cli-darwin-arm64": "0.0.1-canary.291",
+    "@spooky-sync/cli-darwin-x64": "0.0.1-canary.291",
+    "@spooky-sync/cli-linux-arm64": "0.0.1-canary.291",
+    "@spooky-sync/cli-linux-x64": "0.0.1-canary.291",
+    "@spooky-sync/cli-win32-x64": "0.0.1-canary.291"
   }
 }