@runtimescope/mcp-server 0.7.0 → 0.7.2

package/dist/index.js

@@ -18,6 +18,7 @@ import {
   SessionManager,
   HttpServer,
   SqliteStore,
+  isSqliteAvailable,
   AuthManager,
   Redactor,
   resolveTlsConfig,
@@ -35,15 +36,19 @@ function registerNetworkTools(server, store) {
       since_seconds: z.number().optional().describe("Only return requests from the last N seconds"),
       url_pattern: z.string().optional().describe("Filter by URL substring match"),
       status: z.number().optional().describe("Filter by HTTP status code"),
-      method: z.string().optional().describe("Filter by HTTP method (GET, POST, etc.)")
+      method: z.string().optional().describe("Filter by HTTP method (GET, POST, etc.)"),
+      limit: z.number().optional().describe("Max results to return (default 200, max 1000)")
     },
-    async ({ since_seconds, url_pattern, status, method }) => {
-      const events = store.getNetworkRequests({
+    async ({ since_seconds, url_pattern, status, method, limit }) => {
+      const allEvents = store.getNetworkRequests({
         sinceSeconds: since_seconds,
         urlPattern: url_pattern,
         status,
         method
       });
+      const maxLimit = Math.min(limit ?? 200, 1e3);
+      const truncated = allEvents.length > maxLimit;
+      const events = truncated ? allEvents.slice(0, maxLimit) : allEvents;
       const timeRange = events.length > 0 ? { from: events[events.length - 1].timestamp, to: events[0].timestamp } : { from: 0, to: 0 };
       const sessions = store.getSessionInfo();
       const sessionId = sessions[0]?.sessionId ?? null;
@@ -71,7 +76,7 @@ function registerNetworkTools(server, store) {
         }
       }
       const response = {
-        summary: `Found ${events.length} network request(s)${since_seconds ? ` in the last ${since_seconds}s` : ""}. Average duration: ${avgDuration}ms.`,
+        summary: `Found ${events.length} network request(s)${truncated ? ` (showing ${maxLimit} of ${allEvents.length})` : ""}${since_seconds ? ` in the last ${since_seconds}s` : ""}. Average duration: ${avgDuration}ms.`,
         data: events.map((e) => ({
           url: e.url,
           method: e.method,
@@ -84,7 +89,7 @@ function registerNetworkTools(server, store) {
           timestamp: new Date(e.timestamp).toISOString()
         })),
         issues,
-        metadata: { timeRange, eventCount: events.length, sessionId }
+        metadata: { timeRange, eventCount: events.length, totalCount: allEvents.length, truncated, sessionId }
       };
       return {
         content: [{ type: "text", text: JSON.stringify(response, null, 2) }]
@@ -102,14 +107,18 @@ function registerConsoleTools(server, store) {
     {
       level: z2.enum(["log", "warn", "error", "info", "debug", "trace"]).optional().describe("Filter by console level"),
       since_seconds: z2.number().optional().describe("Only return messages from the last N seconds"),
-      search: z2.string().optional().describe("Search message text (case-insensitive substring match)")
+      search: z2.string().optional().describe("Search message text (case-insensitive substring match)"),
+      limit: z2.number().optional().describe("Max results to return (default 200, max 1000)")
     },
-    async ({ level, since_seconds, search }) => {
-      const events = store.getConsoleMessages({
+    async ({ level, since_seconds, search, limit }) => {
+      const allEvents = store.getConsoleMessages({
         level,
         sinceSeconds: since_seconds,
         search
       });
+      const maxLimit = Math.min(limit ?? 200, 1e3);
+      const truncated = allEvents.length > maxLimit;
+      const events = truncated ? allEvents.slice(0, maxLimit) : allEvents;
       const timeRange = events.length > 0 ? { from: events[events.length - 1].timestamp, to: events[0].timestamp } : { from: 0, to: 0 };
       const sessions = store.getSessionInfo();
       const sessionId = sessions[0]?.sessionId ?? null;
@@ -134,12 +143,12 @@ function registerConsoleTools(server, store) {
       }
       for (const [msg, info] of errorMessages) {
         if (info.count > 5 && info.last - info.first < 1e4) {
-          const truncated = msg.length > 80 ? msg.slice(0, 80) + "..." : msg;
-          issues.push(`Error spam: "${truncated}" repeated ${info.count} times in ${((info.last - info.first) / 1e3).toFixed(1)}s`);
+          const truncated2 = msg.length > 80 ? msg.slice(0, 80) + "..." : msg;
+          issues.push(`Error spam: "${truncated2}" repeated ${info.count} times in ${((info.last - info.first) / 1e3).toFixed(1)}s`);
         }
       }
       const response = {
-        summary: `Found ${events.length} console message(s)${since_seconds ? ` in the last ${since_seconds}s` : ""}${levelSummary ? `. Breakdown: ${levelSummary}` : ""}.`,
+        summary: `Found ${events.length} console message(s)${truncated ? ` (showing ${maxLimit} of ${allEvents.length})` : ""}${since_seconds ? ` in the last ${since_seconds}s` : ""}${levelSummary ? `. Breakdown: ${levelSummary}` : ""}.`,
         data: events.map((e) => ({
           level: e.level,
           message: e.message,
@@ -149,7 +158,7 @@ function registerConsoleTools(server, store) {
           timestamp: new Date(e.timestamp).toISOString()
         })),
         issues,
-        metadata: { timeRange, eventCount: events.length, sessionId }
+        metadata: { timeRange, eventCount: events.length, totalCount: allEvents.length, truncated, sessionId }
       };
       return {
         content: [{ type: "text", text: JSON.stringify(response, null, 2) }]
@@ -227,7 +236,7 @@ function registerIssueTools(server, store, apiDiscovery, processMonitor) {
       const allIssues = [...detectIssues(events)];
       if (apiDiscovery) {
         try {
-          allIssues.push(...apiDiscovery.detectIssues(events));
+          allIssues.push(...apiDiscovery.detectIssues());
         } catch {
         }
       }
@@ -437,13 +446,17 @@ function registerStateTools(server, store) {
     "Get state store snapshots and diffs from Zustand or Redux stores. Shows state changes over time with action history, mutation frequency, and shallow diffs showing which keys changed.",
     {
       store_name: z5.string().optional().describe("Filter by store name/ID"),
-      since_seconds: z5.number().optional().describe("Only return events from the last N seconds")
+      since_seconds: z5.number().optional().describe("Only return events from the last N seconds"),
+      limit: z5.number().optional().describe("Max results to return (default 200, max 1000)")
     },
-    async ({ store_name, since_seconds }) => {
-      const events = store.getStateEvents({
+    async ({ store_name, since_seconds, limit }) => {
+      const allEvents = store.getStateEvents({
         storeId: store_name,
         sinceSeconds: since_seconds
       });
+      const maxLimit = Math.min(limit ?? 200, 1e3);
+      const truncated = allEvents.length > maxLimit;
+      const events = truncated ? allEvents.slice(0, maxLimit) : allEvents;
       const sessions = store.getSessionInfo();
       const sessionId = sessions[0]?.sessionId ?? null;
       const issues = [];
@@ -464,7 +477,7 @@ function registerStateTools(server, store) {
         }
       }
       const response = {
-        summary: `Found ${events.length} state event(s)${since_seconds ? ` in the last ${since_seconds}s` : ""}${store_name ? ` for store "${store_name}"` : ""}.`,
+        summary: `Found ${events.length} state event(s)${truncated ? ` (showing ${maxLimit} of ${allEvents.length})` : ""}${since_seconds ? ` in the last ${since_seconds}s` : ""}${store_name ? ` for store "${store_name}"` : ""}.`,
         data: events.map((e) => ({
           storeId: e.storeId,
           library: e.library,
@@ -482,6 +495,8 @@ function registerStateTools(server, store) {
             to: events.length > 0 ? events[events.length - 1].timestamp : 0
           },
           eventCount: events.length,
+          totalCount: allEvents.length,
+          truncated,
           sessionId
         }
       };
@@ -752,17 +767,21 @@ function registerHarTools(server, store) {
     "capture_har",
     "Export captured network requests as a HAR (HTTP Archive) 1.2 JSON file. This is the standard format used by browser DevTools, Charles Proxy, and other tools. Includes request/response headers, body content (if captureBody was enabled in the SDK), and timing data.",
     {
-      since_seconds: z9.number().optional().describe("Only include requests from the last N seconds")
+      since_seconds: z9.number().optional().describe("Only include requests from the last N seconds"),
+      limit: z9.number().optional().describe("Max entries to include (default 200, max 1000)")
     },
-    async ({ since_seconds }) => {
-      const events = store.getNetworkRequests({
+    async ({ since_seconds, limit }) => {
+      const allEvents = store.getNetworkRequests({
         sinceSeconds: since_seconds
       });
+      const maxLimit = Math.min(limit ?? 200, 1e3);
+      const truncated = allEvents.length > maxLimit;
+      const events = truncated ? allEvents.slice(0, maxLimit) : allEvents;
       const sessions = store.getSessionInfo();
       const sessionId = sessions[0]?.sessionId ?? null;
       const har = buildHar(events);
       const response = {
-        summary: `HAR export: ${events.length} request(s)${since_seconds ? ` from the last ${since_seconds}s` : ""}. Import into Chrome DevTools or any HAR viewer.`,
+        summary: `HAR export: ${events.length} request(s)${truncated ? ` (showing ${maxLimit} of ${allEvents.length})` : ""}${since_seconds ? ` from the last ${since_seconds}s` : ""}. Import into Chrome DevTools or any HAR viewer.`,
         data: har,
         issues: [],
         metadata: {
@@ -771,6 +790,8 @@ function registerHarTools(server, store) {
             to: events.length > 0 ? events[events.length - 1].timestamp : 0
           },
           eventCount: events.length,
+          totalCount: allEvents.length,
+          truncated,
           sessionId
         }
       };
@@ -4127,6 +4148,30 @@ function buildReconEvents(url, title, sessionId, techResults, tokens, layout, a1
 }
 
 // src/scanner/index.ts
+var Semaphore = class {
+  constructor(max) {
+    this.max = max;
+  }
+  queue = [];
+  active = 0;
+  async acquire() {
+    if (this.active < this.max) {
+      this.active++;
+      return;
+    }
+    return new Promise((resolve2) => {
+      this.queue.push(resolve2);
+    });
+  }
+  release() {
+    this.active--;
+    const next = this.queue.shift();
+    if (next) {
+      this.active++;
+      next();
+    }
+  }
+};
 var PlaywrightScanner = class _PlaywrightScanner {
   db = null;
   jsGlobalPaths = [];
@@ -4136,6 +4181,7 @@ var PlaywrightScanner = class _PlaywrightScanner {
   static IDLE_TIMEOUT = 6e4;
   // Close browser after 60s idle
   lastScannedUrl = null;
+  contextSemaphore = new Semaphore(2);
   /**
    * Lazily load the technology database.
    */
@@ -4200,12 +4246,14 @@ var PlaywrightScanner = class _PlaywrightScanner {
     const db = this.ensureDb();
     const { browser } = await this.ensureBrowser();
     const br = browser;
-    const context = await br.newContext({
-      viewport: { width: viewportWidth, height: viewportHeight },
-      userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
-    });
-    const page = await context.newPage();
+    await this.contextSemaphore.acquire();
+    let context = null;
     try {
+      context = await br.newContext({
+        viewport: { width: viewportWidth, height: viewportHeight },
+        userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
+      });
+      const page = await context.newPage();
       let mainResponse = null;
       page.on("response", (response) => {
         if (!mainResponse && response.request().resourceType() === "document") {
@@ -4266,7 +4314,9 @@ var PlaywrightScanner = class _PlaywrightScanner {
         scanDurationMs
       };
     } finally {
-      await context.close();
+      if (context) await context.close().catch(() => {
+      });
+      this.contextSemaphore.release();
     }
   }
   /**
@@ -4282,15 +4332,19 @@ var PlaywrightScanner = class _PlaywrightScanner {
   async queryComputedStyles(url, selector, propertyFilter) {
     const { browser } = await this.ensureBrowser();
     const br = browser;
-    const context = await br.newContext({
-      viewport: { width: 1280, height: 720 }
-    });
-    const page = await context.newPage();
+    await this.contextSemaphore.acquire();
+    let context = null;
     try {
+      context = await br.newContext({
+        viewport: { width: 1280, height: 720 }
+      });
+      const page = await context.newPage();
       await page.goto(url, { waitUntil: "networkidle", timeout: 6e4 });
       return await collectComputedStyles(page, selector, propertyFilter);
     } finally {
-      await context.close();
+      if (context) await context.close().catch(() => {
+      });
+      this.contextSemaphore.release();
     }
   }
   /**
@@ -4300,15 +4354,19 @@ var PlaywrightScanner = class _PlaywrightScanner {
   async queryElementSnapshot(url, selector, depth = 5) {
     const { browser } = await this.ensureBrowser();
     const br = browser;
-    const context = await br.newContext({
-      viewport: { width: 1280, height: 720 }
-    });
-    const page = await context.newPage();
+    await this.contextSemaphore.acquire();
+    let context = null;
     try {
+      context = await br.newContext({
+        viewport: { width: 1280, height: 720 }
+      });
+      const page = await context.newPage();
       await page.goto(url, { waitUntil: "networkidle", timeout: 6e4 });
       return await collectElementSnapshot(page, selector, depth);
     } finally {
-      await context.close();
+      if (context) await context.close().catch(() => {
+      });
+      this.contextSemaphore.release();
     }
   }
   /**
@@ -4977,36 +5035,43 @@ async function main() {
       }
     }
   }, AUTO_SNAPSHOT_INTERVAL_MS);
-  const RETENTION_DAYS = parseInt(process.env.RUNTIMESCOPE_RETENTION_DAYS ?? "30", 10);
-  const cutoffMs = Date.now() - RETENTION_DAYS * 24 * 60 * 60 * 1e3;
-  for (const projectName of projectManager.listProjects()) {
-    const dbPath = projectManager.getProjectDbPath(projectName);
-    if (existsSync2(dbPath)) {
-      try {
-        const tempStore = new SqliteStore({ dbPath });
-        const deleted = tempStore.deleteOldEvents(cutoffMs);
-        if (deleted > 0) {
-          console.error(`[RuntimeScope] Pruned ${deleted} events older than ${RETENTION_DAYS}d from "${projectName}"`);
+  if (isSqliteAvailable()) {
+    const RETENTION_DAYS = parseInt(process.env.RUNTIMESCOPE_RETENTION_DAYS ?? "30", 10);
+    const cutoffMs = Date.now() - RETENTION_DAYS * 24 * 60 * 60 * 1e3;
+    for (const projectName of projectManager.listProjects()) {
+      const dbPath = projectManager.getProjectDbPath(projectName);
+      if (existsSync2(dbPath)) {
+        try {
+          const tempStore = new SqliteStore({ dbPath });
+          const deleted = tempStore.deleteOldEvents(cutoffMs);
+          if (deleted > 0) {
+            console.error(`[RuntimeScope] Pruned ${deleted} events older than ${RETENTION_DAYS}d from "${projectName}"`);
+          }
+          tempStore.close();
+        } catch {
         }
-        tempStore.close();
-      } catch {
       }
     }
   }
-  const pmDbPath = join2(projectManager.rootDir, "pm.db");
-  const pmStore = new PmStore({ dbPath: pmDbPath });
-  const discovery = new ProjectDiscovery(pmStore, projectManager);
-  discovery.discoverAll().then((result) => {
-    console.error(`[RuntimeScope] PM: ${result.projectsDiscovered} projects, ${result.sessionsDiscovered} sessions discovered`);
-  }).catch((err) => {
-    console.error("[RuntimeScope] PM discovery error:", err.message);
-  });
+  let pmStore;
+  let discovery;
+  if (isSqliteAvailable()) {
+    const pmDbPath = join2(projectManager.rootDir, "pm.db");
+    pmStore = new PmStore({ dbPath: pmDbPath });
+    discovery = new ProjectDiscovery(pmStore, projectManager);
+    discovery.discoverAll().then((result) => {
+      console.error(`[RuntimeScope] PM: ${result.projectsDiscovered} projects, ${result.sessionsDiscovered} sessions discovered`);
+    }).catch((err) => {
+      console.error("[RuntimeScope] PM discovery error:", err.message);
+    });
+  }
   const httpServer = new HttpServer(store, processMonitor, {
     authManager,
     allowedOrigins: corsOrigins,
     rateLimiter: collector.getRateLimiter(),
     pmStore,
-    discovery
+    discovery,
+    getConnectedSessions: () => collector.getConnectedSessions()
   });
   try {
     await httpServer.start({ port: HTTP_PORT2, tls: tlsConfig });
@@ -5068,7 +5133,7 @@ async function main() {
     await connectionManager.closeAll();
     await httpServer.stop();
     collector.stop();
-    pmStore.close();
+    pmStore?.close();
     process.exit(0);
   };
   process.on("SIGINT", () => {