muuuuse 2.2.5 → 2.3.0

package/README.md

@@ -6,6 +6,7 @@ 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
+- additional isolated pairs work the same way: `3/4`, `5/6`, `7/8`, ...
 - 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
@@ -16,8 +17,15 @@ The whole surface is:
 ```bash
 muuuuse 1
 muuuuse 1 flow on
+muuuuse 1 flow off
+muuuuse 1 flow off continue 5
 muuuuse 2
 muuuuse 2 flow off
+muuuuse 2 flow on continue 3
+muuuuse 3
+muuuuse 3 flow on
+muuuuse 4
+muuuuse 4 flow off continue 1
 muuuuse status
 muuuuse stop
 ```
@@ -36,10 +44,12 @@ Terminal 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.
+Now both shells are armed. `muuuuse 1` generates the session key, `muuuuse 2` signs it, and only that signed pair relays. Every odd/even adjacent pair works the same way in parallel: `3/4`, `5/6`, `7/8`, and so on. 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.
 
+`continue <seat>` forwards that seat's relayed output into another armed seat without changing the signed odd/even pair law. This lets you build local loops like `1 -> 2 -> 3 -> 4 -> 1` while every adjacent pair still keeps its own session keypair.
+
 If you want Codex in one and Gemini in the other, start them inside the armed shells:
 
 ```bash
@@ -69,6 +79,7 @@ muuuuse stop
 - no tmux
 - state lives under `~/.muuuuse`
 - only the signed armed pair can exchange relay events
+- `continue <seat>` is a separate local forwarding lane and can target any armed seat number
 - supported relay detection is built for Codex, Claude, and Gemini
 - `codeman` remains the larger transport/control layer; `muuuuse` stays local and minimal
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "muuuuse",
-  "version": "2.2.5",
-  "description": "🔌Muuuuse arms two regular terminals and relays assistant output between them.",
+  "version": "2.3.0",
+  "description": "🔌Muuuuse arms regular terminals in isolated pairs and can continue relay output into any other armed seat.",
   "type": "commonjs",
   "bin": {
     "muuuuse": "bin/muuse.js"

package/src/cli.js

@@ -1,4 +1,4 @@
-const { BRAND, usage } = require("./util");
+const { BRAND, normalizeSeatId, usage } = require("./util");
 const { ArmedSeat, getStatusReport, stopAllSessions } = require("./runtime");
 
 async function main(argv = process.argv.slice(2)) {
@@ -54,12 +54,14 @@ async function main(argv = process.argv.slice(2)) {
     return;
   }
 
-  if (command === "1" || command === "2") {
-    const flowMode = parseSeatFlowMode(command, argv.slice(1));
+  const seatId = normalizeSeatId(command);
+  if (seatId) {
+    const { flowMode, continueSeatId } = parseSeatOptions(command, argv.slice(1));
     const seat = new ArmedSeat({
       cwd: process.cwd(),
+      continueSeatId,
       flowMode,
-      seatId: Number(command),
+      seatId,
     });
     const code = await seat.run();
     process.exit(code);
@@ -81,6 +83,9 @@ function renderSeatStatus(seat) {
   if (seat.partnerLive) {
     bits.push("peer live");
   }
+  if (seat.continueSeatId) {
+    bits.push(`continue ${seat.continueSeatId}`);
+  }
   if (seat.trust) {
     bits.push(`trust ${seat.trust}`);
   }
@@ -98,23 +103,57 @@ function renderSeatStatus(seat) {
   return output;
 }
 
-function parseSeatFlowMode(command, args) {
-  if (args.length === 0) {
-    return "off";
-  }
+function parseSeatOptions(command, args) {
+  let flowMode = "off";
+  let continueSeatId = null;
 
-  if (args.length === 2 && String(args[0]).trim().toLowerCase() === "flow") {
-    const flowMode = String(args[1]).trim().toLowerCase();
-    if (flowMode === "on" || flowMode === "off") {
-      return flowMode;
+  for (let index = 0; index < args.length;) {
+    const token = String(args[index] || "").trim().toLowerCase();
+
+    if (token === "flow") {
+      const flowToken = String(args[index + 1] || "").trim().toLowerCase();
+      if (flowToken === "on" || flowToken === "off") {
+        flowMode = flowToken;
+        index += 2;
+        continue;
+      }
+      break;
+    }
+
+    if (token === "continue") {
+      const targetSeatId = normalizeSeatId(args[index + 1]);
+      if (targetSeatId) {
+        continueSeatId = targetSeatId;
+        index += 2;
+        continue;
+      }
+      break;
     }
+
+    break;
+  }
+
+  if (args.length === 0 || (flowMode || continueSeatId !== null) && consumedAllArgs(args, flowMode, continueSeatId)) {
+    return { flowMode, continueSeatId };
   }
 
   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.`
+    `\`muuuuse ${command}\` accepts no extra arguments, \`flow on\` / \`flow off\`, optional \`continue <seat>\`, or both in sequence. Run it directly in the terminal you want to arm.`
   );
 }
 
+function consumedAllArgs(args, flowMode, continueSeatId) {
+  const expected = [];
+  if (flowMode !== "off" || args.includes("flow")) {
+    expected.push("flow", flowMode);
+  }
+  if (continueSeatId !== null || args.includes("continue")) {
+    expected.push("continue", String(continueSeatId));
+  }
+  return expected.length === args.length &&
+    expected.every((value, index) => String(args[index]).trim().toLowerCase() === String(value).trim().toLowerCase());
+}
+
 module.exports = {
   main,
 };

package/src/runtime.js

@@ -20,12 +20,17 @@ const {
   ensureDir,
   getDefaultSessionName,
   getFileSize,
+  getPartnerSeatId,
   getSeatPaths,
   getSessionPaths,
+  getStateRoot,
   hashText,
+  isAnchorSeat,
   isPidAlive,
+  listSeatIds,
   loadOrCreateSeatIdentity,
   listSessionNames,
+  normalizeSeatId,
   readAppendedText,
   readJson,
   sanitizeRelayText,
@@ -55,6 +60,11 @@ function normalizeFlowMode(flowMode) {
   return String(flowMode || "").trim().toLowerCase() === "on" ? "on" : "off";
 }
 
+function normalizeContinueSeatId(value) {
+  const seatId = normalizeSeatId(value);
+  return seatId || null;
+}
+
 function resolveShell() {
   const shell = String(process.env.SHELL || "").trim();
   return shell || "/bin/bash";
@@ -132,34 +142,40 @@ function sleepSync(ms) {
   Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
 }
 
-function findJoinableSessionName(currentPath = process.cwd()) {
+function findJoinableSessionName(currentPath = process.cwd(), seatId = 2) {
+  const normalizedSeatId = normalizeSeatId(seatId);
+  const anchorSeatId = getPartnerSeatId(normalizedSeatId);
+  if (!normalizedSeatId || !anchorSeatId || isAnchorSeat(normalizedSeatId)) {
+    return null;
+  }
+
   const candidates = listSessionNames()
     .map((sessionName) => {
       const sessionPaths = getSessionPaths(sessionName);
       const controller = readJson(sessionPaths.controllerPath, null);
-      const seat1Paths = getSeatPaths(sessionName, 1);
-      const seat2Paths = getSeatPaths(sessionName, 2);
-      const seat1Meta = readJson(seat1Paths.metaPath, null);
-      const seat1Status = readJson(seat1Paths.statusPath, null);
-      const seat2Meta = readJson(seat2Paths.metaPath, null);
-      const seat2Status = readJson(seat2Paths.statusPath, null);
+      const anchorPaths = getSeatPaths(sessionName, anchorSeatId);
+      const seatPaths = getSeatPaths(sessionName, normalizedSeatId);
+      const anchorMeta = readJson(anchorPaths.metaPath, null);
+      const anchorStatus = readJson(anchorPaths.statusPath, null);
+      const seatMeta = readJson(seatPaths.metaPath, null);
+      const seatStatus = readJson(seatPaths.statusPath, null);
       const stopRequest = readJson(sessionPaths.stopPath, null);
 
-      const cwd = controller?.cwd || seat1Status?.cwd || seat1Meta?.cwd || seat2Status?.cwd || seat2Meta?.cwd || null;
+      const cwd = controller?.cwd || anchorStatus?.cwd || anchorMeta?.cwd || seatStatus?.cwd || seatMeta?.cwd || null;
       if (!matchesWorkingPath(cwd, currentPath)) {
         return null;
       }
 
-      const seat1WrapperPid = seat1Status?.pid || seat1Meta?.pid || null;
-      const seat1ChildPid = seat1Status?.childPid || seat1Meta?.childPid || null;
-      const seat2WrapperPid = seat2Status?.pid || seat2Meta?.pid || null;
-      const seat2ChildPid = seat2Status?.childPid || seat2Meta?.childPid || null;
-      const seat1Live = isPidAlive(seat1WrapperPid) || isPidAlive(seat1ChildPid);
-      const seat2Live = isPidAlive(seat2WrapperPid) || isPidAlive(seat2ChildPid);
+      const anchorWrapperPid = anchorStatus?.pid || anchorMeta?.pid || null;
+      const anchorChildPid = anchorStatus?.childPid || anchorMeta?.childPid || null;
+      const seatWrapperPid = seatStatus?.pid || seatMeta?.pid || null;
+      const seatChildPid = seatStatus?.childPid || seatMeta?.childPid || null;
+      const anchorLive = isPidAlive(anchorWrapperPid) || isPidAlive(anchorChildPid);
+      const seatLive = isPidAlive(seatWrapperPid) || isPidAlive(seatChildPid);
       const stopRequestedAtMs = Date.parse(stopRequest?.requestedAt || "");
-      const createdAtMs = Date.parse(controller?.createdAt || seat1Meta?.startedAt || seat1Status?.updatedAt || "");
+      const createdAtMs = Date.parse(controller?.createdAt || anchorMeta?.startedAt || anchorStatus?.updatedAt || "");
 
-      if (!seat1Live || seat2Live) {
+      if (!anchorLive || seatLive) {
         return null;
       }
 
@@ -178,10 +194,10 @@ function findJoinableSessionName(currentPath = process.cwd()) {
   return candidates[0]?.sessionName || null;
 }
 
-function waitForJoinableSessionName(currentPath = process.cwd(), timeoutMs = SEAT_JOIN_WAIT_MS) {
+function waitForJoinableSessionName(currentPath = process.cwd(), seatId = 2, timeoutMs = SEAT_JOIN_WAIT_MS) {
   const deadline = Date.now() + timeoutMs;
   while (Date.now() <= deadline) {
-    const sessionName = findJoinableSessionName(currentPath);
+    const sessionName = findJoinableSessionName(currentPath, seatId);
     if (sessionName) {
       return sessionName;
     }
@@ -192,15 +208,11 @@ function waitForJoinableSessionName(currentPath = process.cwd(), timeoutMs = SEA
 }
 
 function resolveSessionName(currentPath = process.cwd(), seatId = 1) {
-  if (seatId === 1) {
+  if (isAnchorSeat(seatId)) {
     return createSessionName(currentPath);
   }
 
-  if (seatId === 2) {
-    return waitForJoinableSessionName(currentPath);
-  }
-
-  return createSessionName(currentPath);
+  return waitForJoinableSessionName(currentPath, seatId);
 }
 
 function parseAnswerEntries(text) {
@@ -218,6 +230,26 @@ function parseAnswerEntries(text) {
     .filter((entry) => entry && entry.type === "answer" && typeof entry.text === "string");
 }
 
+function parseContinueEntries(text, targetSeatId) {
+  return String(text || "")
+    .split("\n")
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .map((line) => {
+      try {
+        return JSON.parse(line);
+      } catch {
+        return null;
+      }
+    })
+    .filter((entry) => (
+      entry &&
+      entry.type === "continue" &&
+      typeof entry.text === "string" &&
+      normalizeSeatId(entry.targetSeatId) === targetSeatId
+    ));
+}
+
 function readSessionHeaderText(filePath, maxBytes = 16384) {
   try {
     const fd = fs.openSync(filePath, "r");
@@ -417,6 +449,36 @@ function buildAnswerSignaturePayload(sessionName, challenge, entry) {
   });
 }
 
+function buildContinuationEntry(sourceSessionName, targetSeatId, entry) {
+  return {
+    id: createId(12),
+    type: "continue",
+    sourceSessionName,
+    sourceSeatId: entry.seatId,
+    targetSeatId,
+    origin: entry.origin || "unknown",
+    text: entry.text,
+    createdAt: entry.createdAt || new Date().toISOString(),
+    chainId: entry.chainId,
+    hop: entry.hop,
+    sourceAnswerId: entry.id,
+    publicKey: entry.publicKey || null,
+    signature: entry.signature || null,
+  };
+}
+
+function getSeatDirIfExists(sessionName, seatId) {
+  const dir = path.join(getStateRoot(), "sessions", sessionName, `seat-${seatId}`);
+  try {
+    if (fs.statSync(dir).isDirectory()) {
+      return dir;
+    }
+  } catch {
+    return null;
+  }
+  return null;
+}
+
 function readSeatChallenge(paths, sessionName) {
   const record = readJson(paths.challengePath, null);
   if (
@@ -511,16 +573,24 @@ async function sendTextAndEnter(child, text, shouldAbort = () => false) {
 class ArmedSeat {
   constructor(options) {
     this.seatId = options.seatId;
-    this.partnerSeatId = options.seatId === 1 ? 2 : 1;
+    this.partnerSeatId = getPartnerSeatId(options.seatId);
+    this.anchorSeatId = isAnchorSeat(options.seatId) ? options.seatId : this.partnerSeatId;
     this.flowMode = normalizeFlowMode(options.flowMode);
+    this.continueSeatId = normalizeContinueSeatId(options.continueSeatId);
     this.cwd = normalizeWorkingPath(options.cwd);
+    if (this.continueSeatId === this.seatId) {
+      throw new Error(`\`muuuuse ${this.seatId}\` cannot continue to itself.`);
+    }
     this.sessionName = resolveSessionName(this.cwd, this.seatId);
     if (!this.sessionName) {
-      throw new Error("No armed `muuuuse 1` seat is waiting in this cwd. Run `muuuuse 1` first.");
+      throw new Error(
+        `No armed \`muuuuse ${this.partnerSeatId}\` seat is waiting in this cwd. Run \`muuuuse ${this.partnerSeatId}\` first.`
+      );
     }
     this.sessionPaths = getSessionPaths(this.sessionName);
     this.paths = getSeatPaths(this.sessionName, this.seatId);
     this.partnerPaths = getSeatPaths(this.sessionName, this.partnerSeatId);
+    this.continueOffset = getFileSize(this.paths.continuePath);
     this.partnerOffset = getFileSize(this.partnerPaths.eventsPath);
 
     this.child = null;
@@ -542,7 +612,7 @@ class ArmedSeat {
     this.trustState = {
       challenge: null,
       peerPublicKey: null,
-      phase: this.seatId === 1 ? "waiting_for_peer_signature" : "waiting_for_seat1_key",
+      phase: isAnchorSeat(this.seatId) ? "waiting_for_peer_signature" : "waiting_for_anchor_key",
       pairedAt: null,
     };
     this.liveState = {
@@ -565,9 +635,11 @@ class ArmedSeat {
       cwd: this.cwd,
       createdAt: current.createdAt || this.startedAt,
       updatedAt: new Date().toISOString(),
-      seat1Pid: this.seatId === 1 ? process.pid : current.seat1Pid || null,
-      seat2Pid: this.seatId === 2 ? process.pid : current.seat2Pid || null,
-      pid: this.seatId === 1 ? process.pid : current.pid || null,
+      anchorSeatId: this.anchorSeatId,
+      partnerSeatId: this.partnerSeatId,
+      anchorSeatPid: this.seatId === this.anchorSeatId ? process.pid : current.anchorSeatPid || null,
+      partnerSeatPid: this.seatId === this.partnerSeatId ? process.pid : current.partnerSeatPid || null,
+      pid: this.seatId === this.anchorSeatId ? process.pid : current.pid || null,
       ...extra,
     });
   }
@@ -582,6 +654,7 @@ class ArmedSeat {
       partnerSeatId: this.partnerSeatId,
       sessionName: this.sessionName,
       flowMode: this.flowMode,
+      continueSeatId: this.continueSeatId,
       cwd: this.cwd,
       pid: process.pid,
       childPid: this.childPid,
@@ -597,6 +670,7 @@ class ArmedSeat {
       partnerSeatId: this.partnerSeatId,
       sessionName: this.sessionName,
       flowMode: this.flowMode,
+      continueSeatId: this.continueSeatId,
       cwd: this.cwd,
       pid: process.pid,
       childPid: this.childPid,
@@ -609,7 +683,7 @@ class ArmedSeat {
   initializeTrustMaterial() {
     this.identity = loadOrCreateSeatIdentity(this.paths);
 
-    if (this.seatId !== 1) {
+    if (!isAnchorSeat(this.seatId)) {
       return;
     }
 
@@ -632,7 +706,7 @@ class ArmedSeat {
       this.initializeTrustMaterial();
     }
 
-    if (this.seatId === 1) {
+    if (isAnchorSeat(this.seatId)) {
       this.syncSeatOneTrust();
       return;
     }
@@ -713,7 +787,7 @@ class ArmedSeat {
       this.trustState = {
         challenge: null,
         peerPublicKey: null,
-        phase: "waiting_for_seat1_key",
+        phase: "waiting_for_anchor_key",
         pairedAt: null,
       };
       return;
@@ -941,6 +1015,44 @@ class ArmedSeat {
     return Number.isFinite(requestedAtMs) && requestedAtMs > this.startedAtMs;
   }
 
+  findContinuationTarget() {
+    if (!this.continueSeatId) {
+      return null;
+    }
+
+    const candidates = listSessionNames()
+      .map((sessionName) => {
+        if (!getSeatDirIfExists(sessionName, this.continueSeatId)) {
+          return null;
+        }
+
+        const seat = buildSeatReport(sessionName, this.continueSeatId);
+        if (!seat || !matchesWorkingPath(seat.cwd, this.cwd)) {
+          return null;
+        }
+
+        const updatedAtMs = Date.parse(seat.updatedAt || seat.startedAt || "");
+        return {
+          seat,
+          sessionName,
+          updatedAtMs: Number.isFinite(updatedAtMs) ? updatedAtMs : 0,
+        };
+      })
+      .filter((entry) => entry !== null)
+      .sort((left, right) => right.updatedAtMs - left.updatedAtMs);
+
+    if (candidates.length === 0) {
+      return null;
+    }
+
+    const target = candidates[0];
+    return {
+      seatId: target.seat.seatId,
+      sessionName: target.sessionName,
+      paths: getSeatPaths(target.sessionName, target.seat.seatId),
+    };
+  }
+
   async pullPartnerEvents() {
     const { nextOffset, text } = readAppendedText(this.partnerPaths.eventsPath, this.partnerOffset);
     this.partnerOffset = nextOffset;
@@ -1003,6 +1115,53 @@ class ArmedSeat {
     }
   }
 
+  async pullContinuationEvents() {
+    const { nextOffset, text } = readAppendedText(this.paths.continuePath, this.continueOffset);
+    this.continueOffset = nextOffset;
+    if (!text.trim() || !this.child || this.stopped) {
+      return;
+    }
+
+    const entries = parseContinueEntries(text, this.seatId);
+    for (const entry of entries) {
+      if (this.stopped || this.stopRequested()) {
+        this.requestStop("stop_requested");
+        return;
+      }
+
+      const payload = sanitizeRelayText(entry.text);
+      if (!payload) {
+        continue;
+      }
+
+      const delivered = await sendTextAndEnter(
+        this.child,
+        payload,
+        () => this.stopped || this.stopRequested() || !this.child || Boolean(this.childExit)
+      );
+      if (!delivered) {
+        this.requestStop("relay_aborted");
+        return;
+      }
+
+      if (this.stopped || this.stopRequested()) {
+        this.requestStop("stop_requested");
+        return;
+      }
+
+      const deliveredAtMs = Date.now();
+      this.pendingInboundContext = {
+        chainId: entry.chainId || entry.sourceAnswerId || entry.id,
+        deliveredAtMs,
+        expiresAtMs: deliveredAtMs + PENDING_RELAY_CONTEXT_TTL_MS,
+        hop: Number.isInteger(entry.hop) ? entry.hop : 0,
+      };
+      this.relayCount += 1;
+      this.rememberInboundRelay(payload);
+      this.log(`[${entry.sourceSeatId} => ${this.seatId}] ${previewText(payload)}`);
+    }
+  }
+
   rememberInboundRelay(text) {
     const payload = sanitizeRelayText(text);
     if (!payload) {
@@ -1269,11 +1428,28 @@ class ArmedSeat {
       this.identity.privateKey
     );
     appendJsonl(this.paths.eventsPath, signedEntry);
+    this.forwardContinuation(signedEntry);
     this.rememberEmittedAnswer(answerKey);
 
     this.log(`[${this.seatId}] ${previewText(payload)}`);
   }
 
+  forwardContinuation(signedEntry) {
+    if (!this.continueSeatId) {
+      return;
+    }
+
+    const target = this.findContinuationTarget();
+    if (!target) {
+      this.log(`[${this.seatId}] continue ${this.continueSeatId} unavailable`);
+      return;
+    }
+
+    const continuationEntry = buildContinuationEntry(this.sessionName, target.seatId, signedEntry);
+    appendJsonl(target.paths.continuePath, continuationEntry);
+    this.log(`[${this.seatId} => ${target.seatId}] ${previewText(continuationEntry.text)}`);
+  }
+
   async tick() {
     if (this.stopRequested()) {
       this.writeStatus({
@@ -1287,6 +1463,7 @@ class ArmedSeat {
 
     this.syncTrustState();
     await this.pullPartnerEvents();
+    await this.pullContinuationEvents();
     if (this.stopped || this.stopRequested()) {
       this.requestStop("stop_requested");
       return;
@@ -1319,10 +1496,13 @@ class ArmedSeat {
     this.log(`${BRAND} seat ${this.seatId} armed for ${this.sessionName}.`);
     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.");
+    if (this.continueSeatId) {
+      this.log(`Seat ${this.seatId} continues to seat ${this.continueSeatId}.`);
+    }
+    if (isAnchorSeat(this.seatId)) {
+      this.log(`Seat ${this.seatId} generated the session key and is waiting for seat ${this.partnerSeatId} to sign it.`);
     } else {
-      this.log("Seat 2 will sign the session key from seat 1, then relay goes live.");
+      this.log(`Seat ${this.seatId} will sign the session key from seat ${this.partnerSeatId}, then relay goes live.`);
     }
     this.log("Run `muuuuse status` or `muuuuse stop` from any terminal.");
 
@@ -1420,6 +1600,7 @@ function buildSeatReport(sessionName, seatId) {
     seatId,
     state: wrapperLive ? status?.state || "running" : "orphaned_child",
     flowMode: status?.flowMode || meta?.flowMode || "off",
+    continueSeatId: status?.continueSeatId || meta?.continueSeatId || null,
     wrapperPid,
     childPid,
     wrapperLive,
@@ -1443,7 +1624,7 @@ function getStatusReport() {
       const sessionPaths = getSessionPaths(sessionName);
       const controller = readJson(sessionPaths.controllerPath, null);
       const stopRequest = readJson(sessionPaths.stopPath, null);
-      const seats = [1, 2]
+      const seats = listSeatIds(sessionName)
         .map((seatId) => buildSeatReport(sessionName, seatId))
         .filter((entry) => entry !== null);
 

package/src/util.js

@@ -167,6 +167,42 @@ function getSessionPaths(sessionName) {
   };
 }
 
+function normalizeSeatId(value) {
+  const seatId = Number.parseInt(String(value || "").trim(), 10);
+  if (!Number.isInteger(seatId) || seatId <= 0) {
+    return null;
+  }
+  return seatId;
+}
+
+function isAnchorSeat(seatId) {
+  return normalizeSeatId(seatId) % 2 === 1;
+}
+
+function getPartnerSeatId(seatId) {
+  const normalized = normalizeSeatId(seatId);
+  if (!normalized) {
+    return null;
+  }
+  return isAnchorSeat(normalized) ? normalized + 1 : normalized - 1;
+}
+
+function listSeatIds(sessionName) {
+  const sessionDir = getSessionDir(sessionName);
+  try {
+    return fs.readdirSync(sessionDir, { withFileTypes: true })
+      .filter((entry) => entry.isDirectory())
+      .map((entry) => {
+        const match = entry.name.match(/^seat-(\d+)$/);
+        return match ? Number.parseInt(match[1], 10) : null;
+      })
+      .filter((seatId) => Number.isInteger(seatId))
+      .sort((left, right) => left - right);
+  } catch {
+    return [];
+  }
+}
+
 function getSeatDir(sessionName, seatId) {
   return ensureDir(path.join(getSessionDir(sessionName), `seat-${seatId}`));
 }
@@ -177,6 +213,7 @@ function getSeatPaths(sessionName, seatId) {
     ackPath: path.join(dir, "ack.json"),
     challengePath: path.join(dir, "challenge.json"),
     claimPath: path.join(dir, "claim.json"),
+    continuePath: path.join(dir, "continue.jsonl"),
     dir,
     daemonPath: path.join(dir, "daemon.json"),
     eventsPath: path.join(dir, "events.jsonl"),
@@ -245,26 +282,33 @@ function listSessionNames() {
 
 function usage() {
   return [
-    `${BRAND} arms two regular terminals and relays assistant output between them.`,
+    `${BRAND} arms regular terminals in isolated odd/even pairs and relays assistant output between each pair.`,
     "",
     "Usage:",
     "  muuuuse 1",
     "  muuuuse 1 flow on",
     "  muuuuse 1 flow off",
+    "  muuuuse 1 flow on continue 3",
     "  muuuuse 2",
     "  muuuuse 2 flow on",
     "  muuuuse 2 flow off",
+    "  muuuuse 2 flow on continue 3",
+    "  muuuuse 3",
+    "  muuuuse 4",
+    "  muuuuse 4 flow on continue 1",
     "  muuuuse stop",
     "  muuuuse status",
     "",
     "Flow:",
     "  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. 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.",
+    "  3. The odd seat generates the session key and the matching even seat signs it automatically.",
+    "  4. Additional pairs work the same way: `3/4`, `5/6`, `7/8`...",
+    "  5. Optional: arm each seat with `flow on` or `flow off`.",
+    "  6. Optional: add `continue <seat>` to forward that seat's relayed output into another armed seat.",
+    "  7. Use those armed shells normally.",
+    "  8. `flow off` sends final answers only. `flow on` keeps assistant commentary bouncing.",
+    "  9. Run `muuuuse status` or `muuuuse stop` from any shell.",
     "",
     "Notes:",
     "  - No tmux.",
@@ -282,13 +326,17 @@ module.exports = {
   ensureDir,
   getDefaultSessionName,
   getFileSize,
+  getPartnerSeatId,
   loadOrCreateSeatIdentity,
+  isAnchorSeat,
   getSeatPaths,
   getSessionPaths,
   getStateRoot,
   hashText,
   isPidAlive,
+  listSeatIds,
   listSessionNames,
+  normalizeSeatId,
   readAppendedText,
   readJson,
   sanitizeRelayText,