muuuuse 2.1.0 → 2.2.0

package/README.md

@@ -6,15 +6,18 @@ It does one job:
 - arm terminal one with `muuuuse 1`
 - arm terminal two with `muuuuse 2`
 - have seat 1 generate a session key and seat 2 sign it
-- watch Codex, Claude, or Gemini for real final answers
-- inject that final answer into the other armed terminal
+- choose per-seat relay mode with `flow on` or `flow off`
+- watch Codex, Claude, or Gemini for local assistant output
+- inject that output into the other armed terminal
 - keep looping until you stop it
 
 The whole surface is:
 
 ```bash
 muuuuse 1
+muuuuse 1 flow on
 muuuuse 2
+muuuuse 2 flow off
 muuuuse status
 muuuuse stop
 ```
@@ -24,17 +27,19 @@ muuuuse stop
 Terminal 1:
 
 ```bash
-muuuuse 1
+muuuuse 1 flow on
 ```
 
 Terminal 2:
 
 ```bash
-muuuuse 2
+muuuuse 2 flow off
 ```
 
 Now both shells are armed. `muuuuse 1` generates the session key, `muuuuse 2` signs it, and only that signed pair relays. Use those shells normally.
 
+`flow on` means that seat sends commentary and final answers. `flow off` means that seat waits for final answers only. Each seat decides what it sends out, so mixed calibration is allowed.
+
 If you want Codex in one and Gemini in the other, start them inside the armed shells:
 
 ```bash
@@ -45,7 +50,7 @@ codex
 gemini
 ```
 
-`🔌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.
+`🔌Muuuuse` tails the local session logs for supported CLIs, relays according to each seat's flow mode, types that output into the other seat, and then sends Enter as a separate keystroke.
 
 Check the live state from any terminal:
 
@@ -64,7 +69,7 @@ muuuuse stop
 - no tmux
 - state lives under `~/.muuuuse`
 - only the signed armed pair can exchange relay events
-- supported final-answer detection is built for Codex, Claude, and Gemini
+- supported relay detection is built for Codex, Claude, and Gemini
 - `codeman` remains the larger transport/control layer; `muuuuse` stays local and minimal
 
 ## Install

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "muuuuse",
-  "version": "2.1.0",
-  "description": "🔌Muuuuse arms two regular terminals and relays final answers between them.",
+  "version": "2.2.0",
+  "description": "🔌Muuuuse arms two regular terminals and relays assistant output between them.",
   "type": "commonjs",
   "bin": {
     "muuuuse": "bin/muuse.js"

package/src/agents.js

@@ -459,14 +459,17 @@ function extractCodexAssistantText(content) {
     .join("\n");
 }
 
-function parseCodexFinalLine(line) {
+function parseCodexAssistantLine(line, options = {}) {
+  const flowMode = options.flowMode === true;
   try {
     const entry = JSON.parse(line);
     if (entry?.type !== "response_item" || entry.payload?.type !== "message" || entry.payload?.role !== "assistant") {
       return null;
     }
 
-    if (entry.payload?.phase !== "final_answer") {
+    const phase = String(entry.payload?.phase || "").trim().toLowerCase();
+    const relayablePhase = phase === "final_answer" || (flowMode && phase === "commentary");
+    if (!relayablePhase) {
       return null;
     }
 
@@ -485,6 +488,10 @@ function parseCodexFinalLine(line) {
   }
 }
 
+function parseCodexFinalLine(line) {
+  return parseCodexAssistantLine(line, { flowMode: false });
+}
+
 function isAnswerNewEnough(answer, sinceMs = null) {
   if (!Number.isFinite(sinceMs)) {
     return true;
@@ -498,13 +505,13 @@ function isAnswerNewEnough(answer, sinceMs = null) {
   return answerMs >= sinceMs;
 }
 
-function readCodexAnswers(filePath, offset, sinceMs = null) {
+function readCodexAnswers(filePath, offset, sinceMs = null, options = {}) {
   const { nextOffset, text } = readAppendedText(filePath, offset);
   const answers = text
     .split("\n")
     .map((line) => line.trim())
     .filter((line) => line.length > 0)
-    .map((line) => parseCodexFinalLine(line))
+    .map((line) => parseCodexAssistantLine(line, options))
     .filter((entry) => entry !== null)
     .filter((entry) => isAnswerNewEnough(entry, sinceMs));
 
@@ -547,7 +554,8 @@ function selectClaudeSessionFile(currentPath, processStartedAtMs, options = {})
   return selectSessionCandidatePath(candidates, currentPath, processStartedAtMs);
 }
 
-function extractClaudeAssistantText(content) {
+function extractClaudeAssistantText(content, options = {}) {
+  const flowMode = options.flowMode === true;
   if (!Array.isArray(content)) {
     return "";
   }
@@ -560,20 +568,28 @@ function extractClaudeAssistantText(content) {
       if (item.type === "text" && typeof item.text === "string") {
         return [item.text.trim()];
       }
+      if (flowMode && item.type === "thinking" && typeof item.thinking === "string") {
+        return [item.thinking.trim()];
+      }
       return [];
     })
     .filter((text) => text.length > 0)
     .join("\n");
 }
 
-function parseClaudeFinalLine(line) {
+function parseClaudeAssistantLine(line, options = {}) {
+  const flowMode = options.flowMode === true;
   try {
     const entry = JSON.parse(line);
-    if (entry?.type !== "assistant" || entry.message?.role !== "assistant" || entry.message?.stop_reason !== "end_turn") {
+    if (entry?.type !== "assistant" || entry.message?.role !== "assistant") {
       return null;
     }
 
-    const text = sanitizeRelayText(extractClaudeAssistantText(entry.message.content));
+    if (!flowMode && entry.message?.stop_reason !== "end_turn") {
+      return null;
+    }
+
+    const text = sanitizeRelayText(extractClaudeAssistantText(entry.message.content, options));
     if (!text) {
       return null;
     }
@@ -588,13 +604,17 @@ function parseClaudeFinalLine(line) {
   }
 }
 
-function readClaudeAnswers(filePath, offset, sinceMs = null) {
+function parseClaudeFinalLine(line) {
+  return parseClaudeAssistantLine(line, { flowMode: false });
+}
+
+function readClaudeAnswers(filePath, offset, sinceMs = null, options = {}) {
   const { nextOffset, text } = readAppendedText(filePath, offset);
   const answers = text
     .split("\n")
     .map((line) => line.trim())
     .filter((line) => line.length > 0)
-    .map((line) => parseClaudeFinalLine(line))
+    .map((line) => parseClaudeAssistantLine(line, options))
     .filter((entry) => entry !== null)
     .filter((entry) => isAnswerNewEnough(entry, sinceMs));
 

package/src/cli.js

@@ -55,12 +55,10 @@ async function main(argv = process.argv.slice(2)) {
   }
 
   if (command === "1" || command === "2") {
-    if (argv.length > 1) {
-      throw new Error(`\`muuuuse ${command}\` takes no extra arguments. Run it directly in the terminal you want to arm.`);
-    }
-
+    const flowMode = parseSeatFlowMode(command, argv.slice(1));
     const seat = new ArmedSeat({
       cwd: process.cwd(),
+      flowMode,
       seatId: Number(command),
     });
     const code = await seat.run();
@@ -74,6 +72,7 @@ function renderSeatStatus(seat) {
   const bits = [
     `seat ${seat.seatId}: ${seat.state}`,
     `agent ${seat.agent || "idle"}`,
+    `flow ${seat.flowMode || "off"}`,
     `relays ${seat.relayCount}`,
     `wrapper ${seat.wrapperPid || "-"}`,
     `child ${seat.childPid || "-"}`,
@@ -99,6 +98,23 @@ function renderSeatStatus(seat) {
   return output;
 }
 
+function parseSeatFlowMode(command, args) {
+  if (args.length === 0) {
+    return "off";
+  }
+
+  if (args.length === 2 && String(args[0]).trim().toLowerCase() === "flow") {
+    const flowMode = String(args[1]).trim().toLowerCase();
+    if (flowMode === "on" || flowMode === "off") {
+      return flowMode;
+    }
+  }
+
+  throw new Error(
+    `\`muuuuse ${command}\` accepts either no extra arguments or \`flow on\` / \`flow off\`. Run it directly in the terminal you want to arm.`
+  );
+}
+
 module.exports = {
   main,
 };

package/src/runtime.js

@@ -51,6 +51,10 @@ const CHILD_ENV_DROP_KEYS = [
   "CODEX_THREAD_ID",
 ];
 
+function normalizeFlowMode(flowMode) {
+  return String(flowMode || "").trim().toLowerCase() === "on" ? "on" : "off";
+}
+
 function resolveShell() {
   const shell = String(process.env.SHELL || "").trim();
   return shell || "/bin/bash";
@@ -214,6 +218,51 @@ function parseAnswerEntries(text) {
     .filter((entry) => entry && entry.type === "answer" && typeof entry.text === "string");
 }
 
+function readSessionHeaderText(filePath, maxBytes = 16384) {
+  try {
+    const fd = fs.openSync(filePath, "r");
+    try {
+      const buffer = Buffer.alloc(maxBytes);
+      const bytesRead = fs.readSync(fd, buffer, 0, buffer.length, 0);
+      return buffer.toString("utf8", 0, bytesRead);
+    } finally {
+      fs.closeSync(fd);
+    }
+  } catch {
+    return "";
+  }
+}
+
+function readSessionFileStartedAtMs(agentType, filePath) {
+  try {
+    if (agentType === "gemini") {
+      const entry = JSON.parse(fs.readFileSync(filePath, "utf8"));
+      return Date.parse(entry.startTime || entry.lastUpdated || "");
+    }
+
+    const header = readSessionHeaderText(filePath);
+    const lines = header
+      .split("\n")
+      .map((line) => line.trim())
+      .filter(Boolean);
+
+    for (const line of lines) {
+      const entry = JSON.parse(line);
+      if (agentType === "codex" && entry?.type === "session_meta") {
+        return Date.parse(entry.payload?.timestamp || "");
+      }
+
+      if (agentType === "claude") {
+        return Date.parse(entry.timestamp || entry.message?.timestamp || "");
+      }
+    }
+  } catch {
+    return Number.NaN;
+  }
+
+  return Number.NaN;
+}
+
 function readProcessCwd(pid) {
   if (!Number.isInteger(pid) || pid <= 0) {
     return null;
@@ -387,35 +436,23 @@ function readSeatChallenge(paths, sessionName) {
 }
 
 async function sendTextAndEnter(child, text, shouldAbort = () => false) {
-  const lines = String(text || "").replace(/\r/g, "").split("\n");
+  const payload = String(text || "")
+    .replace(/\r/g, "")
+    .replace(/\s*\n+\s*/g, " ")
+    .replace(/[ \t]{2,}/g, " ")
+    .trim();
 
-  for (let index = 0; index < lines.length; index += 1) {
+  if (payload.length > 0) {
     if (shouldAbort() || !child) {
       return false;
     }
 
-    const line = lines[index];
-    if (line.length > 0) {
-      try {
-        child.write(line);
-      } catch {
-        return false;
-      }
-      await sleep(TYPE_DELAY_MS);
-    }
-
-    if (index < lines.length - 1) {
-      if (shouldAbort()) {
-        return false;
-      }
-
-      try {
-        child.write("\r");
-      } catch {
-        return false;
-      }
-      await sleep(TYPE_DELAY_MS);
+    try {
+      child.write(payload);
+    } catch {
+      return false;
     }
+    await sleep(TYPE_DELAY_MS);
   }
 
   if (shouldAbort() || !child) {
@@ -435,6 +472,7 @@ class ArmedSeat {
   constructor(options) {
     this.seatId = options.seatId;
     this.partnerSeatId = options.seatId === 1 ? 2 : 1;
+    this.flowMode = normalizeFlowMode(options.flowMode);
     this.cwd = normalizeWorkingPath(options.cwd);
     this.sessionName = resolveSessionName(this.cwd, this.seatId);
     if (!this.sessionName) {
@@ -503,6 +541,7 @@ class ArmedSeat {
       seatId: this.seatId,
       partnerSeatId: this.partnerSeatId,
       sessionName: this.sessionName,
+      flowMode: this.flowMode,
       cwd: this.cwd,
       pid: process.pid,
       childPid: this.childPid,
@@ -517,6 +556,7 @@ class ArmedSeat {
       seatId: this.seatId,
       partnerSeatId: this.partnerSeatId,
       sessionName: this.sessionName,
+      flowMode: this.flowMode,
       cwd: this.cwd,
       pid: process.pid,
       childPid: this.childPid,
@@ -1079,6 +1119,10 @@ class ArmedSeat {
       this.liveState.sessionFile = resolvedSessionFile;
       this.liveState.offset = 0;
       this.liveState.lastMessageId = null;
+      const sessionStartedAtMs = readSessionFileStartedAtMs(detectedAgent.type, resolvedSessionFile);
+      if (Number.isFinite(sessionStartedAtMs)) {
+        this.liveState.captureSinceMs = Math.min(this.liveState.captureSinceMs, sessionStartedAtMs);
+      }
     }
 
     if (!this.liveState.sessionFile) {
@@ -1096,7 +1140,8 @@ class ArmedSeat {
       const result = readCodexAnswers(
         this.liveState.sessionFile,
         this.liveState.offset,
-        this.liveState.captureSinceMs
+        this.liveState.captureSinceMs,
+        { flowMode: this.flowMode === "on" }
       );
       this.liveState.offset = result.nextOffset;
       answers.push(...result.answers);
@@ -1104,7 +1149,8 @@ class ArmedSeat {
       const result = readClaudeAnswers(
         this.liveState.sessionFile,
         this.liveState.offset,
-        this.liveState.captureSinceMs
+        this.liveState.captureSinceMs,
+        { flowMode: this.flowMode === "on" }
       );
       this.liveState.offset = result.nextOffset;
       answers.push(...result.answers);
@@ -1112,7 +1158,8 @@ class ArmedSeat {
       const result = readGeminiAnswers(
         this.liveState.sessionFile,
         this.liveState.lastMessageId,
-        this.liveState.captureSinceMs
+        this.liveState.captureSinceMs,
+        { flowMode: this.flowMode === "on" }
       );
       this.liveState.lastMessageId = result.lastMessageId;
       this.liveState.offset = result.fileSize;
@@ -1161,7 +1208,7 @@ class ArmedSeat {
     }
 
     const pendingInboundContext = this.getPendingInboundContext();
-    if (pendingInboundContext && pendingInboundContext.hop >= MAX_RELAY_CHAIN_HOP) {
+    if (this.flowMode !== "on" && pendingInboundContext && pendingInboundContext.hop >= MAX_RELAY_CHAIN_HOP) {
       this.log(`[${this.seatId}] suppressed relay loop: ${previewText(payload)}`);
       return;
     }
@@ -1223,6 +1270,7 @@ class ArmedSeat {
     this.writeStatus({
       state: live.state,
       agent: live.agent,
+      flowMode: this.flowMode,
       cwd: live.cwd,
       log: live.log,
       lastAnswerAt: live.lastAnswerAt,
@@ -1239,7 +1287,8 @@ class ArmedSeat {
     this.installResizeHandler();
 
     this.log(`${BRAND} seat ${this.seatId} armed for ${this.sessionName}.`);
-    this.log("Use this shell normally. Codex, Claude, and Gemini final answers relay automatically from their local session logs.");
+    this.log("Use this shell normally. Codex, Claude, and Gemini relay automatically from their local session logs.");
+    this.log(`Seat ${this.seatId} relay mode is flow ${this.flowMode}.`);
     if (this.seatId === 1) {
       this.log("Seat 1 generated the session key and is waiting for seat 2 to sign it.");
     } else {
@@ -1339,6 +1388,7 @@ function buildSeatReport(sessionName, seatId) {
   return {
     seatId,
     state: wrapperLive ? status?.state || "running" : "orphaned_child",
+    flowMode: status?.flowMode || meta?.flowMode || "off",
     wrapperPid,
     childPid,
     wrapperLive,

package/src/util.js

@@ -245,11 +245,15 @@ function listSessionNames() {
 
 function usage() {
   return [
-    `${BRAND} arms two regular terminals and relays final answers between them.`,
+    `${BRAND} arms two regular terminals and relays assistant output between them.`,
     "",
     "Usage:",
     "  muuuuse 1",
+    "  muuuuse 1 flow on",
+    "  muuuuse 1 flow off",
     "  muuuuse 2",
+    "  muuuuse 2 flow on",
+    "  muuuuse 2 flow off",
     "  muuuuse stop",
     "  muuuuse status",
     "",
@@ -257,9 +261,10 @@ function usage() {
     "  1. Run `muuuuse 1` in terminal one.",
     "  2. Run `muuuuse 2` in terminal two.",
     "  3. Seat 1 generates the session key and seat 2 signs it automatically.",
-    "  4. Use those armed shells normally.",
-    "  5. Codex, Claude, and Gemini final answers relay automatically from their local session logs.",
-    "  6. Run `muuuuse status` or `muuuuse stop` from any shell.",
+    "  4. Optional: arm each seat with `flow on` or `flow off`.",
+    "  5. Use those armed shells normally.",
+    "  6. `flow off` sends final answers only. `flow on` keeps assistant commentary bouncing.",
+    "  7. Run `muuuuse status` or `muuuuse stop` from any shell.",
     "",
     "Notes:",
     "  - No tmux.",