tracegist-mcp-bridge 0.2.8 → 0.2.11

package/README.md

@@ -43,6 +43,10 @@ Set `TRACEGIST_DIR` to change where the bridge looks for packages (defaults to `
 - `read_tracegist_package_file` — read any text file from inside the ZIP without writing to disk (e.g. `network/api-requests.jsonl`, the Playwright repro script)
 - `extract_tracegist_package_file` — write a binary or text file from the ZIP to a local directory
 - `transcribe_tracegist_package_voice_notes` — transcribe voice notes using local Python Whisper
+- `watch_live_session` — poll real-time session events while recording is active
+- `get_live_screenshot` — request and retrieve a screenshot of the current tab
+- `ask_tester_question` — send a question to the tester (shown as a browser toast, max 200 chars)
+- `get_tester_response` — retrieve the tester's voice + screenshot answer
 
 ## Package contents
 

package/bin/lib.mjs

@@ -89,6 +89,14 @@ const SECTION_HINTS = {
   "marker visual evidence": "Screenshot references for each marker",
   "environment at marker time": "Environment snapshot at a specific marker",
   "marker timeline logs (context window)": "Logs within the ±5 s marker window",
+  "webapp testing reproduction":
+    "Server setup, Python repro script, verification points, key selectors",
+  "tester intent summary": "Classified intent: specifications, issues found, observations",
+  "iterative context": "Previous session reference, verification checklist for build-test cycle",
+  "tier 0: quick summary": "Session overview, intent, reproduction command (~200 tokens)",
+  "tier 1: findings": "Marker timeline with structured findings (~500 tokens)",
+  "tier 2: full context": "Interaction timeline, network/console context, environment",
+  "tier 3: deep diagnostics": "Full session timelines (deep profile only)",
 };
 
 function getSectionHint(sectionName) {

package/bin/tracegist-mcp-bridge.mjs

@@ -928,7 +928,9 @@ async function transcribeLiveVoice(voiceBlobDataUrl) {
       const text = result.choices?.[0]?.message?.content?.trim();
       return text ? { transcription: text } : { error: "Empty transcription response" };
     } catch (err) {
-      return { error: `OpenRouter transcription failed: ${err instanceof Error ? err.message : String(err)}` };
+      return {
+        error: `OpenRouter transcription failed: ${err instanceof Error ? err.message : String(err)}`,
+      };
     }
   }
 
@@ -950,7 +952,9 @@ async function transcribeLiveVoice(voiceBlobDataUrl) {
         await fs.rm(tmpDir, { recursive: true, force: true });
       }
     } catch (err) {
-      return { error: `Whisper transcription failed: ${err instanceof Error ? err.message : String(err)}` };
+      return {
+        error: `Whisper transcription failed: ${err instanceof Error ? err.message : String(err)}`,
+      };
     }
   }
 
@@ -1273,7 +1277,11 @@ server.tool(
       }
     }
     const enrichedEvents = events.map((e) => {
-      if (e.eventType === "marker" && e.data?.markerId && transcriptionsByMarkerId.has(e.data.markerId)) {
+      if (
+        e.eventType === "marker" &&
+        e.data?.markerId &&
+        transcriptionsByMarkerId.has(e.data.markerId)
+      ) {
         return {
           ...e,
           data: {
@@ -1306,8 +1314,7 @@ server.tool(
         },
         {
           tool: "get_live_screenshot",
-          description:
-            "Capture a screenshot of the tester's current browser tab.",
+          description: "Capture a screenshot of the tester's current browser tab.",
         },
       ];
       if (pendingQuestions.length > 0) {
@@ -1319,7 +1326,10 @@ server.tool(
       }
     } else {
       // Session ended — include full interaction log and voice transcriptions
-      if (liveInteractions.length > 0 || liveEvents.some((e) => e.eventType === "voice-transcription")) {
+      if (
+        liveInteractions.length > 0 ||
+        liveEvents.some((e) => e.eventType === "voice-transcription")
+      ) {
         responseData.sessionEndedNote =
           "Session has ended. The interactionLog and voiceMarkerTranscriptions below contain all agent-tester exchanges from this session. " +
           "Include these in your analysis — they represent collaborative context between agent and tester. " +
@@ -1448,8 +1458,7 @@ server.tool(
           {
             type: "text",
             text: [
-              "No response yet." +
-                (waitingSec !== null ? ` Waiting for ${waitingSec}s.` : ""),
+              "No response yet." + (waitingSec !== null ? ` Waiting for ${waitingSec}s.` : ""),
               "The tester may still be recording their voice answer.",
               "",
               "TIP: Instead of polling this tool, go back to polling watch_live_session — " +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tracegist-mcp-bridge",
-  "version": "0.2.8",
+  "version": "0.2.11",
   "description": "Local-first MCP bridge for reading and transcribing TraceGist package zips.",
   "type": "module",
   "bin": {