agentradar-cli 0.3.8 → 0.3.10

package/dist/vendor-runner/terminal-bridge.mjs

@@ -169,6 +169,41 @@ function tmux(argv) {
   return r;
 }
 
+/**
+ * An engagement ended or began: wipe what the next client's snapshot (capture-pane -S) would show. `send-keys -R`
+ * resets tmux's own screen (nothing is typed into the app, which repaints on its next output) and clear-history
+ * drops the scrollback.
+ */
+function clearPane() {
+  tmux(["send-keys", "-R", "-t", TMUX_SESSION]);
+  tmux(["clear-history", "-t", TMUX_SESSION]);
+}
+
+const epochFile = () => process.env.BRIDGE_EPOCH_FILE ?? `${process.env.HOME ?? "/tmp"}/.agentradar-terminal-epoch-${TMUX_SESSION}`;
+
+/**
+ * The server sends a fingerprint of the agent's active engagements on every connect. A different one than the last
+ * seen (or none stored) means the clients changed while this bridge was offline or the server restarted: wipe.
+ * Exported for the unit test.
+ */
+export function applyEpoch(file, value, clear) {
+  if (typeof value !== "string" || !value || value.length > 64) return false;
+  let prev = null;
+  try {
+    prev = fs.readFileSync(file, "utf8").trim();
+  } catch {
+    /* first run */
+  }
+  if (prev === value) return false;
+  clear();
+  try {
+    fs.writeFileSync(file, value, { mode: 0o600 });
+  } catch (e) {
+    console.error(`[bridge] cannot store the terminal epoch (${file}): ${e.message}`);
+  }
+  return true;
+}
+
 /**
  * #9: the CURRENT pane geometry, or null if tmux could not answer.
  *
@@ -352,9 +387,10 @@ class TerminalBridge {
         this.stopPipe();
         break;
       case "clear":
-        // An engagement ended or changed: drop the scrollback so the next client's snapshot (capture-pane -S)
-        // cannot replay the previous one's. The visible screen of the live session is not touched.
-        tmux(["clear-history", "-t", TMUX_SESSION]);
+        clearPane();
+        break;
+      case "epoch":
+        applyEpoch(epochFile(), obj.value, clearPane);
         break;
       case "input":
         if (typeof obj.data === "string") tmux(["send-keys", "-t", TMUX_SESSION, "-l", obj.data]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentradar-cli",
-  "version": "0.3.8",
+  "version": "0.3.10",
   "engines": {
     "node": ">=20"
   },
@@ -22,6 +22,8 @@
     "dist/vault-clone.js",
     "dist/secrets.js",
     "dist/admin.js",
+    "dist/asset-get.js",
+    "dist/github.js",
     "dist/vendor-runner/**",
     "dist/agentradar-vendor/SKILL.md",
     "dist/agent-guard",
@@ -39,7 +41,7 @@
     "test": "vitest run"
   },
   "devDependencies": {
-    "@types/node": "^22.19.21",
+    "@types/node": "^22.20.5",
     "typescript": "^5.7.3",
     "vitest": "^4.1.8"
   }