muuuuse 1.3.2 → 1.4.1

package/README.md

@@ -1,105 +1,72 @@
 # 🔌Muuuuse
 
-`muuuuse` installs one CLI:
+`🔌Muuuuse` is a tiny no-tmux terminal relay.
 
-- `muuuuse`
+It does one job:
+- arm terminal one with `muuuuse 1`
+- arm terminal two with `muuuuse 2`
+- watch Codex, Claude, or Gemini for real final answers
+- inject that final answer into the other armed terminal
+- keep looping until you stop it
 
-The public brand stays `🔌Muuuuse`. The terminal command stays `muuuuse`.
-
-## What It Is Now
-
-`🔌Muuuuse` no longer expects you to arm a terminal first and launch something later.
-
-The main flow is:
+The whole surface is:
 
 ```bash
-muuuuse 1 <program...>
-muuuuse 2 <program...>
+muuuuse 1
+muuuuse 2
+muuuuse status
 muuuuse stop
 ```
 
-Seat `1` and seat `2` each launch and own a real local program under a PTY wrapper. Once both seats are alive in the same lane, they automatically bounce final blocks between each other by typing the partner answer plus `Enter` into the wrapped program.
-
-`muuuuse stop` is the real cleanup command. With no flags it force-stops every tracked lane. Use `--session <name>` if you only want one explicit lane.
-
-## Install
-
-```bash
-npm install -g muuuuse
-```
-
-## Fastest AI Flow
+## Flow
 
 Terminal 1:
 
 ```bash
-muuuuse 1 codex
+muuuuse 1
 ```
 
 Terminal 2:
 
 ```bash
-muuuuse 2 gemini
+muuuuse 2
 ```
 
-Terminal 3:
-
-```bash
-muuuuse stop
-```
-
-Known presets expand to recommended flags automatically:
-
-- `codex`
-- `claude`
-- `gemini`
+Now both shells are armed. Use them normally.
 
-So `muuuuse 1 codex` launches the fuller Codex command, not just bare `codex`.
-
-## Generic Program Flow
-
-This is not AI-only. Any local program can be wrapped directly.
-
-Example:
+If you want Codex in one and Gemini in the other, start them inside the armed shells:
 
 ```bash
-muuuuse 1 bash -lc 'while read line; do printf "left: %s\n\n" "$line"; done'
-muuuuse 2 bash -lc 'while read line; do printf "right: %s\n\n" "$line"; done'
+codex
 ```
 
-Type into one seat and the other seat will receive the relayed block.
-
-For Codex, Claude, and Gemini, `🔌Muuuuse` waits for their structured final-answer logs instead of relaying transient screen chatter. For anything else, it first looks for an explicit `(answer)` block and otherwise falls back to the last stable output block after a turn goes idle.
-
-## Sessions
-
-Seats auto-pair by current working directory by default.
-
-If you want an explicit lane name, use:
-
 ```bash
-muuuuse 1 --session demo codex
-muuuuse 2 --session demo gemini
-muuuuse stop --session demo
+gemini
 ```
 
-You can also inspect the lane:
+`🔌Muuuuse` tails the local session logs for supported CLIs, detects the final answer, types that answer into the other seat, and then sends Enter as a separate keystroke.
+
+Check the live state from any terminal:
 
 ```bash
 muuuuse status
 ```
 
-## Doctor
+Stop the loop from any terminal, including one of the armed shells once it is back at a prompt:
 
 ```bash
-muuuuse doctor
+muuuuse stop
 ```
 
-This checks the local runtime plus common agent binaries if you use them.
-
 ## Notes
 
-- local only
-- no tmux requirement for the main path
-- no remote control surface here; that belongs to `codeman`
-- best with programs that naturally produce turn-shaped output
+- no tmux
+- state lives under `~/.muuuuse`
+- supported final-answer detection is built for Codex, Claude, and Gemini
+- `codeman` remains the larger transport/control layer; `muuuuse` stays local and minimal
+
+## Install
+
+```bash
+npm install -g muuuuse
+```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "muuuuse",
-  "version": "1.3.2",
-  "description": "🔌Muuuuse wraps two local programs and bounces final blocks between them from the terminal you launched.",
+  "version": "1.4.1",
+  "description": "🔌Muuuuse arms two regular terminals and relays final answers between them.",
   "type": "commonjs",
   "bin": {
     "muuuuse": "bin/muuse.js"
@@ -34,7 +34,6 @@
     "relay",
     "local",
     "automation",
-    "script",
     "codex",
     "claude",
     "gemini"

package/src/agents.js

@@ -4,79 +4,17 @@ const os = require("node:os");
 const path = require("node:path");
 
 const {
-  SESSION_MATCH_WINDOW_MS,
   getFileSize,
   hashText,
   readAppendedText,
   sanitizeRelayText,
+  SESSION_MATCH_WINDOW_MS,
 } = require("./util");
 
-const PRESETS = {
-  codex: {
-    label: "Codex",
-    command: [
-      "codex",
-      "-m",
-      "gpt-5.4",
-      "-c",
-      "model_reasoning_effort=low",
-      "--dangerously-bypass-approvals-and-sandbox",
-      "--no-alt-screen",
-    ],
-  },
-  claude: {
-    label: "Claude Code",
-    command: [
-      "claude",
-      "--dangerously-skip-permissions",
-      "--permission-mode",
-      "bypassPermissions",
-    ],
-  },
-  gemini: {
-    label: "Gemini CLI",
-    command: [
-      "gemini",
-      "--approval-mode",
-      "yolo",
-      "--sandbox=false",
-    ],
-  },
-};
-
-function expandPresetCommand(commandTokens, usePresets = true) {
-  if (!usePresets || !Array.isArray(commandTokens) || commandTokens.length !== 1) {
-    return Array.isArray(commandTokens) ? [...commandTokens] : [];
-  }
-
-  const preset = PRESETS[String(commandTokens[0] || "").toLowerCase()];
-  return preset ? [...preset.command] : [...commandTokens];
-}
-
-function detectAgentTypeFromCommand(commandTokens) {
-  const executable = path.basename(String(commandTokens?.[0] || "")).toLowerCase();
-  if (!executable) {
-    return null;
-  }
-
-  if (executable === "codex") {
-    return "codex";
-  }
-  if (executable === "claude") {
-    return "claude";
-  }
-  if (executable === "gemini") {
-    return "gemini";
-  }
-  return null;
-}
-
 const CODEX_ROOT = path.join(os.homedir(), ".codex", "sessions");
 const CLAUDE_ROOT = path.join(os.homedir(), ".claude", "projects");
 const GEMINI_ROOT = path.join(os.homedir(), ".gemini", "tmp");
-const CODEX_SNAPSHOT_ROOT = path.join(os.homedir(), ".codex", "shell_snapshots");
-const codexSnapshotPaneCache = new Map();
-const codexSnapshotExportsCache = new Map();
+const SESSION_START_EARLY_TOLERANCE_MS = 2 * 1000;
 
 function walkFiles(rootPath, predicate, results = []) {
   try {
@@ -89,7 +27,7 @@ function walkFiles(rootPath, predicate, results = []) {
         results.push(absolutePath);
       }
     }
-  } catch (error) {
+  } catch {
     return results;
   }
 
@@ -101,6 +39,17 @@ function commandMatches(args, command) {
   return pattern.test(args);
 }
 
+function buildDetectedAgent(type, process) {
+  return {
+    type,
+    pid: process.pid,
+    args: process.args,
+    cwd: process.cwd || null,
+    elapsedSeconds: process.elapsedSeconds,
+    processStartedAtMs: Date.now() - process.elapsedSeconds * 1000,
+  };
+}
+
 function detectAgent(processes) {
   const ordered = [...processes].sort((left, right) => left.elapsedSeconds - right.elapsedSeconds);
   for (const process of ordered) {
@@ -117,19 +66,10 @@ function detectAgent(processes) {
   return null;
 }
 
-function buildDetectedAgent(type, process) {
-  return {
-    type,
-    pid: process.pid,
-    args: process.args,
-    elapsedSeconds: process.elapsedSeconds,
-    processStartedAtMs: Date.now() - process.elapsedSeconds * 1000,
-  };
-}
-
 function readFirstLines(filePath, maxLines = 20) {
   const lines = [];
   const fd = fs.openSync(filePath, "r");
+
   try {
     const buffer = Buffer.alloc(16384);
     const bytesRead = fs.readSync(fd, buffer, 0, buffer.length, 0);
@@ -146,13 +86,14 @@ function readFirstLines(filePath, maxLines = 20) {
         break;
       }
     }
+
     return lines;
   } finally {
     fs.closeSync(fd);
   }
 }
 
-function chooseCandidate(candidates, currentPath, processStartedAtMs) {
+function selectSessionCandidatePath(candidates, currentPath, processStartedAtMs) {
   const cwdMatches = candidates.filter((candidate) => candidate.cwd === currentPath);
   if (cwdMatches.length === 0) {
     return null;
@@ -162,91 +103,29 @@ function chooseCandidate(candidates, currentPath, processStartedAtMs) {
     return cwdMatches[0].path;
   }
 
-  if (processStartedAtMs !== null) {
-    const preciseMatches = cwdMatches
-      .map((candidate) => ({
-        ...candidate,
-        diffMs: Math.abs(candidate.startedAtMs - processStartedAtMs),
-      }))
-      .filter((candidate) => Number.isFinite(candidate.diffMs) && candidate.diffMs <= SESSION_MATCH_WINDOW_MS)
-      .sort((left, right) => left.diffMs - right.diffMs || right.mtimeMs - left.mtimeMs);
-
-    if (preciseMatches.length === 1) {
-      return preciseMatches[0].path;
-    }
-  }
-
-  return null;
-}
-
-function extractThreadId(filePath) {
-  const match = path.basename(filePath).match(/([0-9a-f]{8}-[0-9a-f-]{27})\.jsonl$/i);
-  return match ? match[1] : null;
-}
-
-function readCodexSnapshotPane(threadId) {
-  if (!threadId) {
-    return null;
-  }
-
-  if (codexSnapshotPaneCache.has(threadId)) {
-    return codexSnapshotPaneCache.get(threadId);
-  }
-
-  const snapshotPath = path.join(CODEX_SNAPSHOT_ROOT, `${threadId}.sh`);
-  try {
-    const contents = fs.readFileSync(snapshotPath, "utf8");
-    const match = contents.match(/declare -x TMUX_PANE="([^"]+)"/);
-    const paneId = match ? match[1] : null;
-    codexSnapshotPaneCache.set(threadId, paneId);
-    return paneId;
-  } catch (error) {
-    codexSnapshotPaneCache.set(threadId, null);
+  if (!Number.isFinite(processStartedAtMs)) {
     return null;
   }
-}
-
-function readCodexSnapshotExports(threadId) {
-  if (!threadId) {
-    return {};
-  }
-
-  if (codexSnapshotExportsCache.has(threadId)) {
-    return codexSnapshotExportsCache.get(threadId);
-  }
-
-  const snapshotPath = path.join(CODEX_SNAPSHOT_ROOT, `${threadId}.sh`);
-  try {
-    const contents = fs.readFileSync(snapshotPath, "utf8");
-    const exportsMap = {};
-    const pattern = /^declare -x ([A-Z0-9_]+)="((?:[^"\\]|\\.)*)"$/gm;
-
-    for (const match of contents.matchAll(pattern)) {
-      const [, key = "", rawValue = ""] = match;
-      exportsMap[key] = rawValue
-        .replace(/\\"/g, "\"")
-        .replace(/\\\\/g, "\\");
-    }
-
-    codexSnapshotExportsCache.set(threadId, exportsMap);
-    return exportsMap;
-  } catch (error) {
-    codexSnapshotExportsCache.set(threadId, {});
-    return {};
-  }
-}
 
-function snapshotEnvMatches(exportsMap, expectedEnv = null) {
-  if (!expectedEnv || typeof expectedEnv !== "object") {
-    return true;
+  const preciseMatches = cwdMatches
+    .map((candidate) => ({
+      ...candidate,
+      diffMs: Math.abs(candidate.startedAtMs - processStartedAtMs),
+      relativeStartMs: candidate.startedAtMs - processStartedAtMs,
+    }))
+    .filter((candidate) => (
+      Number.isFinite(candidate.diffMs) &&
+      Number.isFinite(candidate.relativeStartMs) &&
+      candidate.relativeStartMs >= -SESSION_START_EARLY_TOLERANCE_MS &&
+      candidate.relativeStartMs <= SESSION_MATCH_WINDOW_MS
+    ))
+    .sort((left, right) => left.diffMs - right.diffMs || right.mtimeMs - left.mtimeMs);
+
+  if (preciseMatches.length === 1) {
+    return preciseMatches[0].path;
   }
 
-  return Object.entries(expectedEnv).every(([key, value]) => {
-    if (value === undefined || value === null) {
-      return true;
-    }
-    return exportsMap[key] === String(value);
-  });
+  return null;
 }
 
 function readCodexCandidate(filePath) {
@@ -255,6 +134,7 @@ function readCodexCandidate(filePath) {
     if (!firstLine) {
       return null;
     }
+
     const entry = JSON.parse(firstLine);
     if (entry?.type !== "session_meta" || typeof entry.payload?.cwd !== "string") {
       return null;
@@ -262,46 +142,21 @@ function readCodexCandidate(filePath) {
 
     return {
       path: filePath,
-      threadId: extractThreadId(filePath),
-      snapshotExports: readCodexSnapshotExports(extractThreadId(filePath)),
-      snapshotPaneId: readCodexSnapshotPane(extractThreadId(filePath)),
       cwd: entry.payload.cwd,
       startedAtMs: Date.parse(entry.payload.timestamp),
       mtimeMs: fs.statSync(filePath).mtimeMs,
     };
-  } catch (error) {
+  } catch {
     return null;
   }
 }
 
-function selectCodexSessionFile(currentPath, processStartedAtMs, options = {}) {
-  const paneId = options.paneId || null;
-  const snapshotEnv = options.snapshotEnv || null;
+function selectCodexSessionFile(currentPath, processStartedAtMs) {
   const candidates = walkFiles(CODEX_ROOT, (filePath) => filePath.endsWith(".jsonl"))
     .map((filePath) => readCodexCandidate(filePath))
     .filter((candidate) => candidate !== null);
 
-  let scopedCandidates = candidates;
-  if (snapshotEnv) {
-    const exactEnvMatches = scopedCandidates.filter((candidate) => snapshotEnvMatches(candidate.snapshotExports, snapshotEnv));
-    if (exactEnvMatches.length === 1) {
-      return exactEnvMatches[0].path;
-    }
-    if (exactEnvMatches.length > 1) {
-      scopedCandidates = exactEnvMatches;
-    }
-  }
-
-  if (paneId) {
-    const exactPaneMatches = scopedCandidates.filter((candidate) => candidate.snapshotPaneId === paneId);
-    if (exactPaneMatches.length > 0) {
-      scopedCandidates = exactPaneMatches;
-    } else {
-      scopedCandidates = scopedCandidates.filter((candidate) => candidate.snapshotPaneId === null);
-    }
-  }
-
-  return chooseCandidate(scopedCandidates, currentPath, processStartedAtMs);
+  return selectSessionCandidatePath(candidates, currentPath, processStartedAtMs);
 }
 
 function extractCodexAssistantText(content) {
@@ -330,6 +185,10 @@ function parseCodexFinalLine(line) {
       return null;
     }
 
+    if (entry.payload?.phase !== "final_answer") {
+      return null;
+    }
+
     const text = sanitizeRelayText(extractCodexAssistantText(entry.payload.content));
     if (!text) {
       return null;
@@ -340,19 +199,33 @@ function parseCodexFinalLine(line) {
       text,
       timestamp: entry.timestamp || entry.payload.timestamp || new Date().toISOString(),
     };
-  } catch (error) {
+  } catch {
     return null;
   }
 }
 
-function readCodexAnswers(filePath, offset) {
+function isAnswerNewEnough(answer, sinceMs = null) {
+  if (!Number.isFinite(sinceMs)) {
+    return true;
+  }
+
+  const answerMs = Date.parse(answer?.timestamp || "");
+  if (!Number.isFinite(answerMs)) {
+    return true;
+  }
+
+  return answerMs >= sinceMs;
+}
+
+function readCodexAnswers(filePath, offset, sinceMs = null) {
   const { nextOffset, text } = readAppendedText(filePath, offset);
   const answers = text
     .split("\n")
     .map((line) => line.trim())
     .filter((line) => line.length > 0)
     .map((line) => parseCodexFinalLine(line))
-    .filter((entry) => entry !== null);
+    .filter((entry) => entry !== null)
+    .filter((entry) => isAnswerNewEnough(entry, sinceMs));
 
   return { nextOffset, answers };
 }
@@ -365,6 +238,7 @@ function readClaudeCandidate(filePath) {
       if (typeof entry.cwd !== "string") {
         continue;
       }
+
       return {
         path: filePath,
         cwd: entry.cwd,
@@ -373,7 +247,7 @@ function readClaudeCandidate(filePath) {
       };
     }
     return null;
-  } catch (error) {
+  } catch {
     return null;
   }
 }
@@ -383,7 +257,7 @@ function selectClaudeSessionFile(currentPath, processStartedAtMs) {
     .map((filePath) => readClaudeCandidate(filePath))
     .filter((candidate) => candidate !== null);
 
-  return chooseCandidate(candidates, currentPath, processStartedAtMs);
+  return selectSessionCandidatePath(candidates, currentPath, processStartedAtMs);
 }
 
 function extractClaudeAssistantText(content) {
@@ -422,19 +296,20 @@ function parseClaudeFinalLine(line) {
       text,
       timestamp: entry.timestamp || new Date().toISOString(),
     };
-  } catch (error) {
+  } catch {
     return null;
   }
 }
 
-function readClaudeAnswers(filePath, offset) {
+function readClaudeAnswers(filePath, offset, sinceMs = null) {
   const { nextOffset, text } = readAppendedText(filePath, offset);
   const answers = text
     .split("\n")
     .map((line) => line.trim())
     .filter((line) => line.length > 0)
     .map((line) => parseClaudeFinalLine(line))
-    .filter((entry) => entry !== null);
+    .filter((entry) => entry !== null)
+    .filter((entry) => isAnswerNewEnough(entry, sinceMs));
 
   return { nextOffset, answers };
 }
@@ -446,12 +321,12 @@ function readGeminiCandidate(filePath) {
     return {
       path: filePath,
       projectHash: entry.projectHash,
-      cwdHash: entry.projectHash,
+      cwd: entry.projectHash,
       startedAtMs: Date.parse(entry.startTime),
       mtimeMs: fs.statSync(filePath).mtimeMs,
       lastUpdatedMs: Date.parse(entry.lastUpdated),
     };
-  } catch (error) {
+  } catch {
     return null;
   }
 }
@@ -462,32 +337,10 @@ function selectGeminiSessionFile(currentPath, processStartedAtMs) {
     .map((filePath) => readGeminiCandidate(filePath))
     .filter((candidate) => candidate !== null && candidate.projectHash === projectHash);
 
-  if (candidates.length === 0) {
-    return null;
-  }
-
-  if (processStartedAtMs !== null) {
-    const preciseMatches = candidates
-      .map((candidate) => ({
-        ...candidate,
-        diffMs: Math.abs(candidate.startedAtMs - processStartedAtMs),
-      }))
-      .filter((candidate) => Number.isFinite(candidate.diffMs) && candidate.diffMs <= SESSION_MATCH_WINDOW_MS)
-      .sort((left, right) => left.diffMs - right.diffMs || right.lastUpdatedMs - left.lastUpdatedMs);
-
-    if (preciseMatches.length === 1) {
-      return preciseMatches[0].path;
-    }
-  }
-
-  if (candidates.length === 1) {
-    return candidates[0].path;
-  }
-
-  return null;
+  return selectSessionCandidatePath(candidates, projectHash, processStartedAtMs);
 }
 
-function readGeminiAnswers(filePath, lastMessageId = null) {
+function readGeminiAnswers(filePath, lastMessageId = null, sinceMs = null) {
   try {
     const entry = JSON.parse(fs.readFileSync(filePath, "utf8"));
     const messages = Array.isArray(entry.messages) ? entry.messages : [];
@@ -509,11 +362,13 @@ function readGeminiAnswers(filePath, lastMessageId = null) {
     }));
 
     return {
-      answers: answers.filter((answer) => answer.text.length > 0),
+      answers: answers
+        .filter((answer) => answer.text.length > 0)
+        .filter((answer) => isAnswerNewEnough(answer, sinceMs)),
       lastMessageId: finalMessages.length > 0 ? finalMessages[finalMessages.length - 1].id : lastMessageId,
       fileSize: getFileSize(filePath),
     };
-  } catch (error) {
+  } catch {
     return {
       answers: [],
       lastMessageId,
@@ -523,16 +378,13 @@ function readGeminiAnswers(filePath, lastMessageId = null) {
 }
 
 module.exports = {
-  PRESETS,
-  chooseCandidate,
   detectAgent,
-  detectAgentTypeFromCommand,
-  expandPresetCommand,
   parseClaudeFinalLine,
   parseCodexFinalLine,
   readClaudeAnswers,
   readCodexAnswers,
   readGeminiAnswers,
+  selectSessionCandidatePath,
   selectClaudeSessionFile,
   selectCodexSessionFile,
   selectGeminiSessionFile,