@vincentkoc/multicodex 0.1.0 → 0.2.0

package/README.md

@@ -6,8 +6,9 @@ their own Codex installation, authentication, repository, tools, and local
 terminal.
 
 The browser shows a live structured view of each lane and gives the host
-visible, policy-controlled coordination actions. It does not proxy a raw
-terminal or answer local Codex approvals.
+visible, policy-controlled coordination actions. Participants can additionally
+opt into an ephemeral, read-only Ghostty terminal mirror. Browser viewers
+cannot type into the terminal or answer local Codex approvals.
 
 ## Quickstart
 
@@ -24,19 +25,21 @@ npx --yes @vincentkoc/multicodex@latest doctor
 npx --yes @vincentkoc/multicodex@latest host --repo . --title "OpenAI event build"
 ```
 
-Open the printed control URL. Use **add a person** to copy a named invite
-command:
+Open the printed control URL. Use **invite teammate** to create a visible,
+single-use named invite command:
 
 ```bash
 npx --yes @vincentkoc/multicodex@latest join '<invite-url>' \
   --repo . \
   --name Queenie \
-  --policy suggest
+  --policy suggest \
+  --terminal-mirror
 ```
 
 The join command launches a normal local Codex TUI. Running the same command
 again resumes the same MultiCodex lane and Codex thread. Add `--fresh` only to
-create a new lane intentionally.
+create a new lane intentionally. Remove `--terminal-mirror` to publish only
+structured activity.
 
 ## Multi-Machine Rooms
 
@@ -58,8 +61,8 @@ room server and conductor still run on the host machine.
 The control room keeps the team rail, selected lane activity, and conductor
 conversation visible together.
 
-- add people with named copyable invite commands;
-- remove a lane and revoke its capability;
+- create, recopy, and revoke named single-use teammate invites;
+- remove a participant lane and revoke its capability;
 - inspect coalesced messages, plans, commands, file changes, approvals, and
   turn state;
 - ask the host-local conductor a room question;
@@ -88,11 +91,18 @@ invite, and each lane.
 - The invite capability creates new lanes.
 - A lane capability resumes one lane, publishes its events, and receives its
   permitted commands.
+- `--terminal-mirror` explicitly shares that lane's rendered terminal output
+  with the host and every active room participant.
+- Terminal bytes are held in a bounded in-memory replay buffer and are never
+  written into room state or persisted to disk.
+- Terminal mirrors are read-only. Conductor steering still uses visible,
+  policy-checked Codex app-server commands.
 - Removing a lane revokes its capability and disconnects its managed bridge.
 - Capabilities do not appear in public room snapshots.
 - The participant's Codex app-server always binds to loopback.
-- Repository contents, credentials, hidden reasoning, and complete terminal
-  streams are not published.
+- Repository contents, credentials, and hidden reasoning are not published.
+  Terminal output can contain sensitive text, so participants should only use
+  `--terminal-mirror` in rooms they trust.
 
 Room and lane state is written under `.multicodex/` with owner-only
 permissions.
@@ -130,24 +140,9 @@ multicodex join -> lane capability -> room server
       |
       |- local event spool and policy enforcement
       |- loopback Codex app-server
-      `- normal local Codex TUI
+      |- normal local Codex TUI
+      `- optional ephemeral read-only PTY mirror
 ```
 
 Crabfleet, Crabbox, server OpenAI keys, server GitHub tokens, and hosted
 terminals are not required by the self-contained product.
-
-The repository still contains the earlier Cloudflare/Crabfleet event-room
-implementation while the local-first replacement lands. It is not the default
-MultiCodex runtime.
-
-## Legacy Worker Development
-
-The earlier Worker product remains testable during replacement:
-
-```bash
-pnpm db:local
-pnpm dev
-```
-
-`pnpm dev` enables simulation only for the local Wrangler process. Production
-keeps simulation explicitly disabled.

package/dist/cli.mjs

@@ -273,6 +273,188 @@ function safeName(value) {
   return value.toLowerCase().replaceAll(/[^a-z0-9]+/g, "-").replaceAll(/^-|-$/g, "") || "builder";
 }
 
+// packages/cli/src/pty-tui.ts
+import process2 from "node:process";
+import { attachLocalStdio, spawnLocalPty } from "@openclaw/libterminal/node";
+async function startMirroredTui(input) {
+  const outputDecoder = new TextDecoder();
+  const terminal = await spawnLocalPty({
+    command: input.command,
+    args: input.args,
+    cwd: input.cwd,
+    size: { columns: terminalColumns(), rows: terminalRows() },
+    onOutput: (bytes) => input.onOutput(outputDecoder.decode(bytes, { stream: true }))
+  });
+  const attached = attachLocalStdio(terminal, {
+    onResize: ({ columns, rows }) => input.onResize(columns, rows)
+  });
+  const done = Promise.all([terminal.exit, attached]).then(([exit]) => {
+    const trailingOutput = outputDecoder.decode();
+    if (trailingOutput) input.onOutput(trailingOutput);
+    if (exit.code !== 0 && exit.signal === null) {
+      throw new Error(`Codex TUI exited with ${exit.code}`);
+    }
+  }).catch((error) => {
+    terminal.kill();
+    throw error;
+  });
+  return { done, kill: () => terminal.kill() };
+}
+function terminalColumns() {
+  return Math.max(20, process2.stdout.columns || 120);
+}
+function terminalRows() {
+  return Math.max(10, process2.stdout.rows || 34);
+}
+
+// packages/cli/src/terminal-mirror.ts
+import {
+  BatchPublisher,
+  TerminalFanout
+} from "@openclaw/libterminal/stream";
+var MAX_REPLAY_BYTES = 512 * 1024;
+var MAX_VIEWER_BUFFER_BYTES = 1024 * 1024;
+var PUBLISH_INTERVAL_MS = 40;
+var PUBLISH_BATCH_BYTES = 64 * 1024;
+var TerminalMirrorHub = class {
+  lanes = /* @__PURE__ */ new Map();
+  viewers = /* @__PURE__ */ new Map();
+  publish(laneId, data) {
+    this.lane(laneId).publish(data);
+  }
+  subscribe(laneId, viewerToken, response) {
+    response.writeHead(200, {
+      "content-type": "application/octet-stream",
+      "cache-control": "no-store",
+      "x-content-type-options": "nosniff",
+      "x-accel-buffering": "no"
+    });
+    response.flushHeaders();
+    const subscription = this.lane(laneId).subscribe(crypto.randomUUID());
+    this.viewer(viewerToken).add(subscription);
+    response.once("close", () => subscription.close("viewer disconnected"));
+    void streamSubscription(subscription, response).catch(() => response.destroy()).finally(() => this.removeViewerSubscription(viewerToken, subscription));
+  }
+  closeViewer(viewerToken) {
+    const subscriptions = this.viewers.get(viewerToken);
+    if (!subscriptions) return;
+    this.viewers.delete(viewerToken);
+    for (const subscription of subscriptions) subscription.close("viewer capability revoked");
+  }
+  closeLane(laneId) {
+    const lane = this.lanes.get(laneId);
+    if (!lane) return;
+    lane.close("terminal mirror closed");
+    this.lanes.delete(laneId);
+  }
+  closeAll() {
+    for (const laneId of this.lanes.keys()) this.closeLane(laneId);
+    this.viewers.clear();
+  }
+  lane(laneId) {
+    let lane = this.lanes.get(laneId);
+    if (!lane) {
+      lane = new TerminalFanout({
+        replayBytes: MAX_REPLAY_BYTES,
+        subscriberBufferBytes: MAX_VIEWER_BUFFER_BYTES,
+        slowSubscriberPolicy: "disconnect"
+      });
+      this.lanes.set(laneId, lane);
+    }
+    return lane;
+  }
+  viewer(viewerToken) {
+    let subscriptions = this.viewers.get(viewerToken);
+    if (!subscriptions) {
+      subscriptions = /* @__PURE__ */ new Set();
+      this.viewers.set(viewerToken, subscriptions);
+    }
+    return subscriptions;
+  }
+  removeViewerSubscription(viewerToken, subscription) {
+    const subscriptions = this.viewers.get(viewerToken);
+    if (!subscriptions) return;
+    subscriptions.delete(subscription);
+    if (subscriptions.size === 0) this.viewers.delete(viewerToken);
+  }
+};
+var TerminalMirrorPublisher = class {
+  endpoint;
+  sizeEndpoint;
+  token;
+  publisher;
+  stopped = false;
+  publisherStopped = false;
+  constructor(server, laneId, token) {
+    this.endpoint = new URL(`/api/lanes/${encodeURIComponent(laneId)}/terminal`, server);
+    this.sizeEndpoint = new URL(`/api/lanes/${encodeURIComponent(laneId)}/terminal-size`, server);
+    this.token = token;
+    this.publisher = new BatchPublisher((bytes) => this.publish(bytes), {
+      flushIntervalMs: PUBLISH_INTERVAL_MS,
+      maxBatchBytes: PUBLISH_BATCH_BYTES,
+      onError: () => void 0
+    });
+  }
+  write(data) {
+    if (this.stopped) return;
+    this.publisher.write(typeof data === "string" ? new TextEncoder().encode(data) : data);
+  }
+  async stop() {
+    if (this.publisherStopped) return;
+    this.stopped = true;
+    this.publisherStopped = true;
+    await this.publisher.stop().catch(() => void 0);
+    await fetch(this.endpoint, {
+      method: "DELETE",
+      headers: { authorization: `Bearer ${this.token}` }
+    }).catch(() => void 0);
+  }
+  resize(columns, rows) {
+    if (this.stopped) return;
+    void fetch(this.sizeEndpoint, {
+      method: "POST",
+      headers: {
+        authorization: `Bearer ${this.token}`,
+        "content-type": "application/json"
+      },
+      body: JSON.stringify({ columns, rows })
+    }).catch(() => void 0);
+  }
+  async publish(bytes) {
+    const response = await fetch(this.endpoint, {
+      method: "POST",
+      headers: {
+        authorization: `Bearer ${this.token}`,
+        "content-type": "application/octet-stream"
+      },
+      body: Buffer.from(bytes)
+    });
+    if (response.status === 410) this.stopped = true;
+  }
+};
+async function streamSubscription(subscription, response) {
+  try {
+    for await (const chunk of subscription) {
+      if (response.destroyed || response.writableEnded) return;
+      if (!response.write(chunk)) await waitForDrainOrClose(response);
+    }
+    if (!response.destroyed && !response.writableEnded) response.end();
+  } finally {
+    subscription.close("viewer stream ended");
+  }
+}
+function waitForDrainOrClose(response) {
+  return new Promise((resolve) => {
+    const done = () => {
+      response.off("drain", done);
+      response.off("close", done);
+      resolve();
+    };
+    response.once("drain", done);
+    response.once("close", done);
+  });
+}
+
 // packages/cli/src/builder.ts
 var BuilderBridge = class {
   input;
@@ -369,7 +551,7 @@ var BuilderBridge = class {
     this.resolveStopped = null;
     this.client?.close();
     this.appServerStop?.();
-    if (this.tuiChild && !this.tuiChild.killed) this.tuiChild.kill("SIGTERM");
+    this.tuiChild?.kill();
   }
   async joinOrResume() {
     if (this.input.fresh) await this.stateStore.clear();
@@ -387,7 +569,8 @@ var BuilderBridge = class {
           body: JSON.stringify({
             displayName: this.input.displayName,
             repo: this.input.repo,
-            policy: this.input.policy
+            policy: this.input.policy,
+            terminalMirror: this.input.terminalMirror
           })
         }
       );
@@ -416,7 +599,8 @@ var BuilderBridge = class {
       body: JSON.stringify({
         displayName: this.input.displayName,
         repo: this.input.repo,
-        policy: this.input.policy
+        policy: this.input.policy,
+        terminalMirror: this.input.terminalMirror
       })
     });
     const payload = await response.json();
@@ -601,14 +785,30 @@ policy: ${this.input.policy}
     );
     const args2 = this.threadId ? ["resume", "--remote", endpoint, "-C", this.input.repo, this.threadId] : ["--remote", endpoint, "-C", this.input.repo];
     if (this.input.prompt) args2.push(this.input.prompt);
-    const child = spawn2(this.input.codexPath, args2, {
-      stdio: "inherit"
+    if (!this.input.terminalMirror) {
+      const child = spawn2(this.input.codexPath, args2, { stdio: "inherit" });
+      this.tuiChild = child;
+      try {
+        await waitForChild(child);
+      } finally {
+        this.tuiChild = null;
+      }
+      return;
+    }
+    const publisher = new TerminalMirrorPublisher(this.input.server, this.laneId, this.token);
+    const tui = await startMirroredTui({
+      command: this.input.codexPath,
+      args: args2,
+      cwd: this.input.repo,
+      onOutput: (data) => publisher.write(data),
+      onResize: (columns, rows) => publisher.resize(columns, rows)
     });
-    this.tuiChild = child;
+    this.tuiChild = tui;
     try {
-      await waitForChild(child);
+      await tui.done;
     } finally {
       this.tuiChild = null;
+      await publisher.stop();
     }
   }
   participantViewUrl() {
@@ -862,24 +1062,46 @@ function compactSnapshot(snapshot) {
 }
 
 // packages/cli/src/local-room.ts
-import fs3 from "node:fs/promises";
+import fs4 from "node:fs/promises";
 import http from "node:http";
 import path5 from "node:path";
 
+// packages/cli/src/terminal-assets.ts
+import fs3 from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { readGhosttyAsset } from "@openclaw/libterminal/node";
+var libterminalBrowserPath = fileURLToPath(import.meta.resolve("@openclaw/libterminal/browser"));
+var libterminalIndexPath = fileURLToPath(import.meta.resolve("@openclaw/libterminal"));
+var libterminalAssets = /* @__PURE__ */ new Map([
+  ["/vendor/libterminal/browser.js", libterminalBrowserPath],
+  ["/vendor/libterminal/index.js", libterminalIndexPath]
+]);
+async function readTerminalAsset(pathname) {
+  const libterminalAsset = libterminalAssets.get(pathname);
+  if (libterminalAsset) {
+    return {
+      body: await fs3.readFile(libterminalAsset),
+      contentType: "text/javascript; charset=utf-8"
+    };
+  }
+  return readGhosttyAsset(pathname);
+}
+
 // packages/cli/src/ui.ts
+import { GHOSTTY_ASSET_PATHS } from "@openclaw/libterminal/node";
 function localRoomHtml() {
   return `<!doctype html>
 <html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
 <title>MultiCodex control room</title><style>
-:root{font-family:"Avenir Next","Segoe UI",sans-serif;color:#19211e;background:#e9ede8;--paper:#fbfcf8;--soft:#eef2ec;--line:#d4dbd4;--ink-soft:#65716b;--red:#dd503c;--green:#16825d;--blue:#3267d6;--yellow:#d59b18;--terminal:#171d1a;--terminal-line:#2c3731;--terminal-copy:#d9e4dc;--role:#16825d}*{box-sizing:border-box}body{margin:0;min-width:320px;min-height:100vh}button,input,select{font:inherit;letter-spacing:0}button{cursor:pointer}button:disabled{cursor:not-allowed;opacity:.42}h1,h2,h3,p{margin:0}.mono,code,.eyebrow,.status,.event-time,.event-kind,.policy,.terminal-meta{font-family:"SFMono-Regular",Consolas,"Liberation Mono",monospace}.topbar{align-items:center;background:var(--paper);border-bottom:1px solid var(--line);display:grid;gap:18px;grid-template-columns:auto minmax(180px,1fr) auto;padding:0 18px;min-height:64px;position:sticky;top:0;z-index:10}.brand{align-items:center;display:flex;gap:10px}.brand-mark{background:#19211e;color:#f9fbf7;display:grid;font-weight:850;height:34px;place-items:center;position:relative;width:34px}.brand-mark:after{background:var(--red);bottom:-3px;content:"";height:9px;position:absolute;right:-3px;width:9px}.brand strong{font-size:17px}.room-title{min-width:0}.room-title strong,.room-title span{display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.room-title strong{font-size:13px}.room-title span{color:var(--ink-soft);font-size:10px;margin-top:2px}.top-actions{align-items:center;display:flex;gap:7px}.button,.icon-button{align-items:center;border:1px solid var(--line);border-radius:4px;display:inline-flex;justify-content:center}.button{background:var(--paper);font-size:12px;font-weight:700;gap:6px;min-height:34px;padding:0 11px}.button.primary{background:#19211e;border-color:#19211e;color:#f9fbf7}.button.danger{background:#fff2ef;border-color:#efb8af;color:#9f3020}.button:hover,.icon-button:hover{border-color:#96a39b}.icon-button{background:var(--paper);color:#3d4943;font-size:17px;height:32px;padding:0;width:32px}.live-pill{align-items:center;color:var(--ink-soft);display:flex;font-size:10px;gap:7px;white-space:nowrap}.live-dot{background:var(--green);border-radius:50%;box-shadow:0 0 0 4px rgba(22,130,93,.1);height:7px;width:7px}.shell{display:grid;grid-template-columns:minmax(225px,260px) minmax(440px,1fr) minmax(300px,365px);margin:0 auto;max-width:1900px;min-height:calc(100vh - 64px)}.team,.conductor{background:var(--paper);height:calc(100vh - 64px);position:sticky;top:64px}.team{border-right:1px solid var(--line);display:flex;flex-direction:column}.conductor{border-left:1px solid var(--line);display:grid;grid-template-rows:auto minmax(160px,1fr) auto auto;min-width:0}.panel-heading{align-items:center;border-bottom:1px solid var(--line);display:flex;justify-content:space-between;min-height:66px;padding:12px 14px}.eyebrow{color:var(--ink-soft);display:block;font-size:9px;font-weight:700;text-transform:uppercase}.panel-heading h2{font-size:15px;margin-top:3px}.conductor-seat{align-items:center;background:#e6eee8;border-bottom:1px solid var(--line);display:grid;gap:9px;grid-template-columns:auto 1fr auto;padding:11px 14px}.avatar{align-items:center;background:var(--role);border-radius:50%;color:#fff;display:flex;flex:0 0 auto;font-size:10px;font-weight:800;height:31px;justify-content:center;width:31px}.conductor-seat .avatar{background:#19211e}.seat-copy{display:grid;min-width:0}.person .seat-copy{background:transparent;border:0;padding:0;text-align:left}.seat-copy strong{font-size:11px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.seat-copy span{color:var(--ink-soft);font-size:9px;margin-top:2px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.presence{background:#a5aea9;border-radius:50%;height:7px;width:7px}.presence.on{background:var(--green);box-shadow:0 0 0 3px rgba(22,130,93,.1)}.people{flex:1;overflow:auto}.person{align-items:center;background:transparent;border:0;border-bottom:1px solid var(--line);border-left:3px solid var(--role);display:grid;gap:8px;grid-template-columns:auto minmax(0,1fr) auto;padding:10px 9px;text-align:left;width:100%}.person:hover,.person.selected{background:#eef3ee}.person.removed{filter:saturate(.25);opacity:.65}.person-actions{display:flex;gap:3px}.person-actions .icon-button{height:25px;width:25px}.policy{background:#e4ebe5;color:#526059;display:inline-block;font-size:8px;margin-top:5px;padding:2px 4px;width:max-content}.add-person{border-top:1px solid var(--line);display:grid;gap:7px;padding:11px}.add-person-row{display:grid;gap:6px;grid-template-columns:minmax(0,1fr) 86px}.field,input,select{background:#fff;border:1px solid var(--line);border-radius:4px;color:inherit;min-width:0;outline:none}.field,input,select{height:36px;padding:0 9px}input:focus,select:focus{border-color:var(--blue);box-shadow:0 0 0 2px rgba(50,103,214,.12)}.stage{min-width:0;padding:18px}.stage-heading{align-items:flex-start;display:flex;gap:16px;justify-content:space-between;margin-bottom:14px}.stage-heading h1{font-size:clamp(19px,2.1vw,29px);line-height:1.05;margin-top:5px}.stage-heading p{color:var(--ink-soft);font-size:10px;margin-top:7px}.lane-state{align-items:center;background:var(--paper);border:1px solid var(--line);display:flex;gap:8px;padding:7px 9px}.lane-state .presence{background:var(--yellow)}.lane-state .presence.on{background:var(--green)}.terminal{background:var(--terminal);border:1px solid #111613;box-shadow:9px 9px 0 rgba(25,33,30,.1);color:var(--terminal-copy);min-height:470px;overflow:hidden}.terminal-bar{align-items:center;background:#222b26;border-bottom:1px solid var(--terminal-line);display:grid;gap:10px;grid-template-columns:auto minmax(0,1fr) auto;padding:10px 12px}.traffic{display:flex;gap:5px}.traffic i{background:#617068;border-radius:50%;height:7px;width:7px}.traffic i:first-child{background:var(--red)}.traffic i:nth-child(2){background:var(--yellow)}.traffic i:last-child{background:var(--green)}.terminal-title{color:#aebdb3;font-size:10px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.terminal-meta{color:#819188;font-size:8px}.terminal-stream{height:min(66vh,680px);min-height:420px;overflow:auto;padding:8px 0 28px}.terminal-empty{align-items:center;color:#78877e;display:flex;font-size:11px;justify-content:center;min-height:390px;padding:35px;text-align:center}.event{border-bottom:1px solid rgba(255,255,255,.035);display:grid;gap:10px;grid-template-columns:62px 116px minmax(0,1fr);padding:8px 12px}.event:hover{background:rgba(255,255,255,.025)}.event-time{color:#738179;font-size:8px}.event-kind{color:#84a490;font-size:8px;overflow-wrap:anywhere}.event-copy{color:#d3ded6;font-size:11px;line-height:1.5;overflow-wrap:anywhere;white-space:pre-wrap}.event.agent-message .event-copy{color:#f1f6f2}.event.agent-plan .event-kind{color:#dbb95d}.event.command-started .event-kind,.event.command-completed .event-kind{color:#77a8ee}.event.files-changed .event-kind{color:#e28d7f}.event.turn-started .event-kind,.event.turn-completed .event-kind{color:#71c99e}.event.command-result .event-kind{color:#d5a557}.cursor-line{align-items:center;color:#91a198;display:flex;font:10px "SFMono-Regular",Consolas,monospace;gap:8px;padding:12px}.cursor{animation:blink 1s steps(1,end) infinite;background:#72bd93;height:13px;width:7px}@keyframes blink{50%{opacity:0}}.activity-band{display:grid;gap:8px;grid-template-columns:repeat(3,minmax(0,1fr));margin-top:18px}.metric{border-top:3px solid var(--role);padding:9px 2px}.metric strong{display:block;font-size:16px}.metric span{color:var(--ink-soft);font-size:9px}.messages{overflow:auto;padding:8px 12px}.message{border-bottom:1px solid #e6eae5;padding:11px 3px}.message.conductor-message{background:#eaf1eb;border-left:3px solid var(--green);margin:5px -4px;padding:11px 8px}.message strong{font-size:9px;text-transform:uppercase}.message p{font-size:11px;line-height:1.45;margin-top:4px;white-space:pre-wrap}.message time{color:var(--ink-soft);font-size:8px;margin-left:5px}.form{border-top:1px solid var(--line);display:grid;gap:7px;padding:11px}.command-grid{display:grid;gap:6px;grid-template-columns:1fr 1fr}.form input,.form select{font-size:11px}.form .button{width:100%}.connection{border-top:1px solid var(--line);color:var(--ink-soft);font-size:9px;padding:9px 12px}.readonly{background:#fff3d8;border-bottom:1px solid #e6cf91;color:#76580a;font-size:10px;padding:9px 12px}.toast{background:#19211e;bottom:16px;color:#fff;font-size:11px;left:50%;opacity:0;padding:9px 12px;pointer-events:none;position:fixed;transform:translate(-50%,10px);transition:opacity .15s ease,transform .15s ease;z-index:30}.toast.show{opacity:1;transform:translate(-50%,0)}@media(max-width:1120px){.shell{grid-template-columns:230px minmax(0,1fr)}.conductor{border-left:0;border-top:1px solid var(--line);grid-column:1/-1;height:auto;position:static}.messages{max-height:320px}.terminal-stream{height:58vh}}@media(max-width:740px){.topbar{gap:9px;grid-template-columns:auto 1fr;padding:0 10px}.brand strong,.top-actions .button{display:none}.shell{display:block}.team,.conductor{height:auto;position:static}.team{border-right:0}.people{max-height:260px}.stage{padding:13px 10px}.stage-heading{align-items:flex-start;display:grid}.terminal{box-shadow:none}.terminal-stream{height:60vh;min-height:360px}.event{gap:5px;grid-template-columns:48px 88px minmax(0,1fr);padding:7px 8px}.activity-band{grid-template-columns:1fr 1fr 1fr}.command-grid{grid-template-columns:1fr}.top-actions{justify-self:end}.live-pill{display:none}}
-</style></head><body>
-<header class="topbar"><div class="brand"><span class="brand-mark">M</span><strong>multicodex</strong></div><div class="room-title"><strong id="room-title">loading room</strong><span id="room-meta">connecting to host-local room</span></div><div class="top-actions"><span class="live-pill"><i class="live-dot"></i><span id="top-status">connecting</span></span><button class="button" id="copy-invite">copy invite</button></div></header>
-<div class="shell"><aside class="team"><div class="panel-heading"><div><span class="eyebrow">team</span><h2 id="seat-count">0 active lanes</h2></div><button class="icon-button" id="quick-copy" title="copy invite command">+</button></div><div class="conductor-seat"><span class="avatar">AI</span><div class="seat-copy"><strong>conductor</strong><span>host-local coordination</span></div><i class="presence on"></i></div><div class="people" id="people"></div><form class="add-person" id="add-person"><span class="eyebrow">add a person</span><div class="add-person-row"><input name="name" placeholder="name" required maxlength="80"><select name="policy"><option value="suggest">suggest</option><option value="steer">steer</option><option value="observe">observe</option></select></div><button class="button primary">copy join command</button></form></aside>
-<main class="stage"><div class="stage-heading"><div><span class="eyebrow">live lane</span><h1 id="lane-title">waiting for a builder</h1><p id="lane-detail">copy an invite command to connect a normal local Codex TUI.</p></div><div class="lane-state"><i class="presence" id="lane-presence"></i><span class="status" id="lane-state">idle</span></div></div><section class="terminal"><div class="terminal-bar"><span class="traffic"><i></i><i></i><i></i></span><span class="terminal-title" id="terminal-title">multicodex://room/lane</span><span class="terminal-meta" id="terminal-meta">structured activity</span></div><div class="terminal-stream" id="terminal-stream"></div></section><section class="activity-band"><div class="metric" style="--role:var(--green)"><strong id="metric-active">0</strong><span>connected lanes</span></div><div class="metric" style="--role:var(--blue)"><strong id="metric-turns">0</strong><span>turns completed</span></div><div class="metric" style="--role:var(--yellow)"><strong id="metric-actions">0</strong><span>conductor actions</span></div></section></main>
+:root{font-family:"Avenir Next","Segoe UI",sans-serif;color:#19211e;background:#e9ede8;--paper:#fbfcf8;--soft:#eef2ec;--line:#d4dbd4;--ink-soft:#65716b;--red:#dd503c;--green:#16825d;--blue:#3267d6;--yellow:#d59b18;--terminal:#171d1a;--terminal-line:#2c3731;--terminal-copy:#d9e4dc;--role:#16825d}*{box-sizing:border-box}[hidden]{display:none!important}body{margin:0;min-width:320px;min-height:100vh;overflow-x:hidden}button,input,select{font:inherit;letter-spacing:0}button{cursor:pointer}button:disabled{cursor:not-allowed;opacity:.42}h1,h2,h3,p{margin:0}.mono,code,.eyebrow,.status,.event-time,.event-kind,.policy,.terminal-meta{font-family:"SFMono-Regular",Consolas,"Liberation Mono",monospace}.topbar{align-items:center;background:var(--paper);border-bottom:1px solid var(--line);display:grid;gap:18px;grid-template-columns:auto minmax(180px,1fr) auto;padding:0 18px;min-height:64px;position:sticky;top:0;z-index:10}.brand{align-items:center;display:flex;gap:10px}.brand-mark{background:#19211e;color:#f9fbf7;display:grid;font-weight:850;height:34px;place-items:center;position:relative;width:34px}.brand-mark:after{background:var(--red);bottom:-3px;content:"";height:9px;position:absolute;right:-3px;width:9px}.brand strong{font-size:17px}.room-title{min-width:0}.room-title strong,.room-title span{display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.room-title strong{font-size:13px}.room-title span{color:var(--ink-soft);font-size:10px;margin-top:2px}.top-actions{align-items:center;display:flex;gap:7px}.button,.icon-button{align-items:center;border:1px solid var(--line);border-radius:4px;display:inline-flex;justify-content:center}.button{background:var(--paper);font-size:12px;font-weight:700;gap:6px;min-height:34px;padding:0 11px}.button.primary{background:#19211e;border-color:#19211e;color:#f9fbf7}.button.danger{background:#fff2ef;border-color:#efb8af;color:#9f3020}.button:hover,.icon-button:hover{border-color:#96a39b}.icon-button{background:var(--paper);color:#3d4943;font-size:17px;height:32px;padding:0;width:32px}.live-pill{align-items:center;color:var(--ink-soft);display:flex;font-size:10px;gap:7px;white-space:nowrap}.live-dot{background:var(--green);border-radius:50%;box-shadow:0 0 0 4px rgba(22,130,93,.1);height:7px;width:7px}.shell{display:grid;grid-template-columns:minmax(225px,260px) minmax(440px,1fr) minmax(300px,365px);margin:0 auto;max-width:1900px;min-height:calc(100vh - 64px)}.team,.conductor{background:var(--paper);height:calc(100vh - 64px);position:sticky;top:64px}.team{border-right:1px solid var(--line);display:flex;flex-direction:column}.conductor{border-left:1px solid var(--line);display:grid;grid-template-rows:auto minmax(160px,1fr) auto auto;min-width:0}.panel-heading{align-items:center;border-bottom:1px solid var(--line);display:flex;justify-content:space-between;min-height:66px;padding:12px 14px}.eyebrow{color:var(--ink-soft);display:block;font-size:9px;font-weight:700;text-transform:uppercase}.panel-heading h2{font-size:15px;margin-top:3px}.conductor-seat{align-items:center;background:#e6eee8;border-bottom:1px solid var(--line);display:grid;gap:9px;grid-template-columns:auto 1fr auto;padding:11px 14px}.avatar{align-items:center;background:var(--role);border-radius:50%;color:#fff;display:flex;flex:0 0 auto;font-size:10px;font-weight:800;height:31px;justify-content:center;width:31px}.conductor-seat .avatar{background:#19211e}.seat-copy{display:grid;min-width:0}.person .seat-copy{background:transparent;border:0;padding:0;text-align:left}.seat-copy strong{font-size:11px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.seat-copy span{color:var(--ink-soft);font-size:9px;margin-top:2px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.presence{background:#a5aea9;border-radius:50%;height:7px;width:7px}.presence.on{background:var(--green);box-shadow:0 0 0 3px rgba(22,130,93,.1)}.people{flex:1;overflow:auto}.person{align-items:center;background:transparent;border:0;border-bottom:1px solid var(--line);border-left:3px solid var(--role);display:grid;gap:8px;grid-template-columns:auto minmax(0,1fr) auto;padding:10px 9px;text-align:left;width:100%}.person:hover,.person.selected{background:#eef3ee}.person.pending{background:#f5f7f3;border-left-style:dashed}.person.pending .avatar{background:#78877e}.person-actions{display:flex;gap:3px}.person-actions .icon-button{font-size:13px;height:25px;width:25px}.policy{background:#e4ebe5;color:#526059;display:inline-block;font-size:8px;margin-top:5px;padding:2px 4px;width:max-content}.team-empty{background:transparent;border:0;color:inherit;display:grid;gap:4px;padding:18px 14px;text-align:left;width:100%}.team-empty strong{font-size:11px}.team-empty span{color:var(--ink-soft);font-size:9px;line-height:1.45}.add-person{border-top:1px solid var(--line);display:grid;gap:7px;padding:11px}.invite-heading{align-items:center;display:flex;justify-content:space-between}.invite-feedback{color:var(--green);font-size:8px}.add-person-row{align-items:stretch;display:grid;gap:6px;grid-template-columns:88px minmax(0,1fr)}.mirror-option{align-items:center;background:#eef2ec;border:1px solid var(--line);border-radius:4px;color:#526059;display:flex;font-size:9px;gap:6px;min-width:0;padding:0 7px}.mirror-option input{accent-color:var(--green);height:14px;margin:0;padding:0;width:14px}.field,input,select{background:#fff;border:1px solid var(--line);border-radius:4px;color:inherit;min-width:0;outline:none}.field,input,select{height:36px;padding:0 9px}input:focus,select:focus{border-color:var(--blue);box-shadow:0 0 0 2px rgba(50,103,214,.12)}.stage{min-width:0;padding:18px}.stage-heading{align-items:flex-start;display:flex;gap:16px;justify-content:space-between;margin-bottom:14px}.stage-heading h1{font-size:clamp(19px,2.1vw,29px);line-height:1.05;margin-top:5px}.stage-heading p{color:var(--ink-soft);font-size:10px;margin-top:7px}.lane-state{align-items:center;background:var(--paper);border:1px solid var(--line);display:flex;gap:8px;padding:7px 9px}.lane-state .presence{background:var(--yellow)}.lane-state .presence.on{background:var(--green)}.terminal{background:var(--terminal);border:1px solid #111613;box-shadow:9px 9px 0 rgba(25,33,30,.1);color:var(--terminal-copy);min-height:470px;overflow:hidden}.terminal-bar{align-items:center;background:#222b26;border-bottom:1px solid var(--terminal-line);display:grid;gap:10px;grid-template-columns:auto minmax(0,1fr) auto auto;padding:8px 10px}.traffic{display:flex;gap:5px}.traffic i{background:#617068;border-radius:50%;height:7px;width:7px}.traffic i:first-child{background:var(--red)}.traffic i:nth-child(2){background:var(--yellow)}.traffic i:last-child{background:var(--green)}.terminal-title{color:#aebdb3;font-size:10px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.terminal-meta{color:#819188;font-size:8px}.terminal-modes{background:#151b18;border:1px solid #354239;display:flex;gap:2px;padding:2px}.mode-button{background:transparent;border:0;color:#819188;font-size:8px;font-weight:800;height:22px;padding:0 7px;text-transform:uppercase}.mode-button.active{background:#344139;color:#eff6f0}.terminal-view{display:none;height:min(66vh,680px);min-height:420px}.terminal-view.active{display:block}.terminal-live{contain:layout paint;max-width:100%;overflow:auto;padding:7px}.ghostty-terminal{height:100%;max-width:100%;min-height:406px;min-width:0;outline:none;width:100%}.ghostty-terminal canvas{display:block}.terminal-stream{overflow:auto;padding:8px 0 28px}.terminal-empty{align-items:center;color:#78877e;display:flex;font-size:11px;justify-content:center;min-height:390px;padding:35px;text-align:center}.event{border-bottom:1px solid rgba(255,255,255,.035);display:grid;gap:10px;grid-template-columns:62px 116px minmax(0,1fr);padding:8px 12px}.event:hover{background:rgba(255,255,255,.025)}.event-time{color:#738179;font-size:8px}.event-kind{color:#84a490;font-size:8px;overflow-wrap:anywhere}.event-copy{color:#d3ded6;font-size:11px;line-height:1.5;overflow-wrap:anywhere;white-space:pre-wrap}.event.agent-message .event-copy{color:#f1f6f2}.event.agent-plan .event-kind{color:#dbb95d}.event.command-started .event-kind,.event.command-completed .event-kind{color:#77a8ee}.event.files-changed .event-kind{color:#e28d7f}.event.turn-started .event-kind,.event.turn-completed .event-kind{color:#71c99e}.event.command-result .event-kind{color:#d5a557}.cursor-line{align-items:center;color:#91a198;display:flex;font:10px "SFMono-Regular",Consolas,monospace;gap:8px;padding:12px}.cursor{animation:blink 1s steps(1,end) infinite;background:#72bd93;height:13px;width:7px}@keyframes blink{50%{opacity:0}}.activity-band{display:grid;gap:8px;grid-template-columns:repeat(3,minmax(0,1fr));margin-top:18px}.metric{border-top:3px solid var(--role);padding:9px 2px}.metric strong{display:block;font-size:16px}.metric span{color:var(--ink-soft);font-size:9px}.messages{overflow:auto;padding:8px 12px}.message{border-bottom:1px solid #e6eae5;padding:11px 3px}.message.conductor-message{background:#eaf1eb;border-left:3px solid var(--green);margin:5px -4px;padding:11px 8px}.message strong{font-size:9px;text-transform:uppercase}.message p{font-size:11px;line-height:1.45;margin-top:4px;white-space:pre-wrap}.message time{color:var(--ink-soft);font-size:8px;margin-left:5px}.form{border-top:1px solid var(--line);display:grid;gap:7px;padding:11px}.command-grid{display:grid;gap:6px;grid-template-columns:1fr 1fr}.form input,.form select{font-size:11px}.form .button{width:100%}.connection{border-top:1px solid var(--line);color:var(--ink-soft);font-size:9px;padding:9px 12px}.readonly{background:#fff3d8;border-bottom:1px solid #e6cf91;color:#76580a;font-size:10px;padding:9px 12px}.toast{background:#19211e;bottom:16px;color:#fff;font-size:11px;left:50%;opacity:0;padding:9px 12px;pointer-events:none;position:fixed;transform:translate(-50%,10px);transition:opacity .15s ease,transform .15s ease;z-index:30}.toast.show{opacity:1;transform:translate(-50%,0)}@media(max-width:1120px){.shell{grid-template-columns:230px minmax(0,1fr)}.conductor{border-left:0;border-top:1px solid var(--line);grid-column:1/-1;height:auto;position:static}.messages{max-height:320px}.terminal-view{height:58vh}}@media(max-width:740px){.topbar{gap:9px;grid-template-columns:auto 1fr;padding:0 10px}.brand strong,.top-actions .button{display:none}.shell{display:block}.team,.conductor{height:auto;position:static}.team{border-right:0}.people{max-height:300px}.stage{padding:13px 10px}.stage-heading{align-items:flex-start;display:grid}.terminal{box-shadow:none}.terminal-bar{grid-template-columns:auto minmax(0,1fr) auto}.terminal-meta{display:none}.terminal-view{height:60vh;min-height:360px}.ghostty-terminal{min-height:346px}.event{gap:5px;grid-template-columns:48px 88px minmax(0,1fr);padding:7px 8px}.activity-band{grid-template-columns:1fr 1fr 1fr}.command-grid{grid-template-columns:1fr}.top-actions{justify-self:end}.live-pill{display:none}}
+</style><script type="importmap">{"imports":{"ghostty-web":"${GHOSTTY_ASSET_PATHS.module}"}}</script></head><body>
+<header class="topbar"><div class="brand"><span class="brand-mark">M</span><strong>multicodex</strong></div><div class="room-title"><strong id="room-title">loading room</strong><span id="room-meta">connecting to host-local room</span></div><div class="top-actions"><span class="live-pill"><i class="live-dot"></i><span id="top-status">connecting</span></span><button class="button" id="copy-invite">invite teammate</button></div></header>
+<div class="shell"><aside class="team"><div class="panel-heading"><div><span class="eyebrow">team</span><h2 id="seat-count">0 active - 0 invited</h2></div><button class="icon-button" id="quick-copy" title="invite teammate">+</button></div><div class="conductor-seat"><span class="avatar">AI</span><div class="seat-copy"><strong>conductor</strong><span>host-local coordination</span></div><i class="presence on"></i></div><div class="people" id="people"></div><form class="add-person" id="add-person"><div class="invite-heading"><span class="eyebrow">invite teammate</span><span class="invite-feedback" id="invite-feedback"></span></div><input id="invite-name" name="name" placeholder="teammate name" required maxlength="80"><div class="add-person-row"><select name="policy"><option value="suggest">suggest</option><option value="steer">steer</option><option value="observe">observe</option></select><label class="mirror-option"><input name="terminalMirror" type="checkbox" checked><span>share live terminal</span></label></div><button class="button primary">create &amp; copy invite</button></form></aside>
+<main class="stage"><div class="stage-heading"><div><span class="eyebrow">live lane</span><h1 id="lane-title">waiting for a builder</h1><p id="lane-detail">copy an invite command to connect a normal local Codex TUI.</p></div><div class="lane-state"><i class="presence" id="lane-presence"></i><span class="status" id="lane-state">idle</span></div></div><section class="terminal"><div class="terminal-bar"><span class="traffic"><i></i><i></i><i></i></span><span class="terminal-title" id="terminal-title">multicodex://room/lane</span><span class="terminal-meta" id="terminal-meta">structured activity</span><span class="terminal-modes"><button class="mode-button active" id="mode-live" type="button">live</button><button class="mode-button" id="mode-activity" type="button">activity</button></span></div><div class="terminal-view terminal-live active" id="terminal-live"><div class="ghostty-terminal" id="ghostty-terminal"></div></div><div class="terminal-view terminal-stream" id="terminal-stream"></div></section><section class="activity-band"><div class="metric" style="--role:var(--green)"><strong id="metric-active">0</strong><span>connected lanes</span></div><div class="metric" style="--role:var(--blue)"><strong id="metric-turns">0</strong><span>turns completed</span></div><div class="metric" style="--role:var(--yellow)"><strong id="metric-actions">0</strong><span>conductor actions</span></div></section></main>
 <aside class="conductor"><div class="panel-heading"><div><span class="eyebrow">conductor</span><h2>visible control</h2></div><span class="status" id="host-mode">host</span></div><div class="messages" id="messages"></div><form class="form" id="message-form"><input name="text" placeholder="message the conductor" required maxlength="2000"><button class="button primary">send to conductor</button></form><form class="form" id="command-form"><span class="eyebrow">coordinate selected lane</span><div class="command-grid"><select name="laneId" id="lane-select" required></select><select name="kind" id="kind-select"><option value="suggest">suggest</option><option value="request_status">request status</option><option value="start_followup">start follow-up</option><option value="steer_active_turn">steer active turn</option><option value="request_interrupt">interrupt active turn</option></select></div><input name="text" id="command-text" placeholder="what should the lane know or do?" required maxlength="2000"><button class="button">send visible action</button></form><div class="connection status" id="connection">connecting...</div></aside></div><div class="toast" id="toast"></div>
 <script>
 const esc=value=>String(value??'').replace(/[&<>"']/g,char=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[char]));
-const ui={roomTitle:document.querySelector('#room-title'),roomMeta:document.querySelector('#room-meta'),topStatus:document.querySelector('#top-status'),seatCount:document.querySelector('#seat-count'),people:document.querySelector('#people'),laneTitle:document.querySelector('#lane-title'),laneDetail:document.querySelector('#lane-detail'),lanePresence:document.querySelector('#lane-presence'),laneState:document.querySelector('#lane-state'),terminalTitle:document.querySelector('#terminal-title'),terminalMeta:document.querySelector('#terminal-meta'),terminalStream:document.querySelector('#terminal-stream'),messages:document.querySelector('#messages'),laneSelect:document.querySelector('#lane-select'),kindSelect:document.querySelector('#kind-select'),commandText:document.querySelector('#command-text'),connection:document.querySelector('#connection'),hostMode:document.querySelector('#host-mode'),metricActive:document.querySelector('#metric-active'),metricTurns:document.querySelector('#metric-turns'),metricActions:document.querySelector('#metric-actions'),toast:document.querySelector('#toast')};
+const ui={roomTitle:document.querySelector('#room-title'),roomMeta:document.querySelector('#room-meta'),topStatus:document.querySelector('#top-status'),seatCount:document.querySelector('#seat-count'),people:document.querySelector('#people'),inviteName:document.querySelector('#invite-name'),inviteFeedback:document.querySelector('#invite-feedback'),laneTitle:document.querySelector('#lane-title'),laneDetail:document.querySelector('#lane-detail'),lanePresence:document.querySelector('#lane-presence'),laneState:document.querySelector('#lane-state'),terminalTitle:document.querySelector('#terminal-title'),terminalMeta:document.querySelector('#terminal-meta'),terminalLive:document.querySelector('#terminal-live'),ghosttyTerminal:document.querySelector('#ghostty-terminal'),terminalStream:document.querySelector('#terminal-stream'),modeLive:document.querySelector('#mode-live'),modeActivity:document.querySelector('#mode-activity'),messages:document.querySelector('#messages'),laneSelect:document.querySelector('#lane-select'),kindSelect:document.querySelector('#kind-select'),commandText:document.querySelector('#command-text'),connection:document.querySelector('#connection'),hostMode:document.querySelector('#host-mode'),metricActive:document.querySelector('#metric-active'),metricTurns:document.querySelector('#metric-turns'),metricActions:document.querySelector('#metric-actions'),toast:document.querySelector('#toast')};
 const roleColors=['#dd503c','#3267d6','#16825d','#d59b18','#835bb5'];
 const fragment=new URLSearchParams(location.hash.replace(/^#/,''));
 const hostToken=fragment.get('host')||sessionStorage.getItem('multicodex-host-token')||'';
@@ -888,34 +1110,45 @@ const viewerLaneId=fragment.get('lane')||sessionStorage.getItem('multicodex-lane
 if(hostToken)sessionStorage.setItem('multicodex-host-token',hostToken);
 if(laneToken)sessionStorage.setItem('multicodex-lane-token',laneToken);
 if(viewerLaneId)sessionStorage.setItem('multicodex-lane-id',viewerLaneId);
-let snapshot=null,hostConfig=null,selectedLaneId='',refreshing=false;
+let snapshot=null,hostConfig=null,selectedLaneId='',refreshing=false,terminalMode='live',terminalSession=null,terminalGeneration=0,libterminalBrowserPromise=null;
 async function api(path,options={}){const headers={...(options.body?{'content-type':'application/json'}:{}),...(options.host&&hostToken?{authorization:'Bearer '+hostToken}:{}),...(options.lane&&laneToken?{authorization:'Bearer '+laneToken}:{})};const response=await fetch(path,{method:options.method||'GET',headers,body:options.body?JSON.stringify(options.body):undefined});const payload=await response.json();if(!response.ok)throw new Error(payload.error||response.statusText);return payload}
 function initials(name){return String(name||'?').split(/\\s+/).map(part=>part[0]).join('').slice(0,2).toUpperCase()}
 function shellQuote(value){const quote=String.fromCharCode(39),double=String.fromCharCode(34);return quote+String(value).replaceAll(quote,quote+double+quote+double+quote)+quote}
 function toast(message){ui.toast.textContent=message;ui.toast.classList.add('show');setTimeout(()=>ui.toast.classList.remove('show'),1700)}
 async function copy(value,message='copied'){await navigator.clipboard.writeText(value);toast(message)}
 function activeLanes(){return snapshot?snapshot.lanes.filter(lane=>!lane.removedAt):[]}
+function pendingInvites(){return snapshot?snapshot.invites.filter(invite=>!invite.claimedAt&&!invite.revokedAt):[]}
 function selectedLane(){const lanes=activeLanes();return lanes.find(lane=>lane.id===selectedLaneId)||lanes[0]||snapshot?.lanes[0]||null}
 function laneEvents(laneId){const source=(snapshot?.events||[]).filter(event=>event.laneId===laneId);const collapsed=[];for(const event of source){const previous=collapsed.at(-1);if(previous&&event.kind==='agent.message'&&previous.kind===event.kind){previous.summary+=event.summary;previous.at=event.at}else collapsed.push({...event})}return collapsed.slice(-100)}
 function eventClass(kind){return kind.replaceAll('.','-')}
 function eventLabel(kind){return kind.replace('agent.','ai.').replace('command.','cmd.').replace('turn.','turn.').replace('lane.','lane.').replace('files.changed','files')}
 function time(at){return new Date(at).toLocaleTimeString([],{hour:'2-digit',minute:'2-digit',second:'2-digit'})}
-function renderPeople(){const lanes=snapshot?.lanes||[];const active=lanes.filter(lane=>!lane.removedAt);ui.seatCount.textContent=active.length+' active '+(active.length===1?'lane':'lanes');ui.people.innerHTML=lanes.length?lanes.map((lane,index)=>'<div class="person '+(lane.id===selectedLaneId?'selected ':'')+(lane.removedAt?'removed':'')+'" style="--role:'+roleColors[index%roleColors.length]+'" data-lane="'+esc(lane.id)+'"><span class="avatar">'+esc(initials(lane.displayName))+'</span><button class="seat-copy" data-select="'+esc(lane.id)+'"><strong>'+esc(lane.displayName)+'</strong><span>'+esc(lane.status)+'</span><i class="policy">'+esc(lane.removedAt?'removed':lane.policy)+'</i></button><span class="person-actions">'+(!lane.removedAt&&hostToken?'<button class="icon-button" data-remove="'+esc(lane.id)+'" title="remove '+esc(lane.displayName)+'">x</button>':'')+'</span></div>').join(''):'<div class="terminal-empty">add a person to connect the first local Codex lane.</div>';ui.people.querySelectorAll('[data-select]').forEach(button=>button.onclick=()=>{selectedLaneId=button.dataset.select;render()});ui.people.querySelectorAll('[data-remove]').forEach(button=>button.onclick=()=>removeLane(button.dataset.remove))}
-function renderTerminal(){const lane=selectedLane();if(!lane){ui.laneTitle.textContent='waiting for a builder';ui.laneDetail.textContent='copy an invite command to connect a normal local Codex TUI.';ui.laneState.textContent='idle';ui.lanePresence.className='presence';ui.terminalStream.innerHTML='<div class="terminal-empty">no lane selected<br>the real Codex terminal stays on each participant machine.</div>';return}selectedLaneId=lane.id;ui.laneTitle.textContent=lane.displayName;ui.laneDetail.textContent=lane.repo+' \xB7 '+lane.policy+' policy \xB7 '+(lane.threadId?'thread '+lane.threadId:'thread pending');ui.laneState.textContent=lane.removedAt?'removed':lane.currentTurnId?'active turn':lane.connected?'connected':'disconnected';ui.lanePresence.className='presence '+(lane.connected&&!lane.removedAt?'on':'');ui.terminalTitle.textContent='multicodex://'+snapshot.id+'/'+lane.displayName.toLowerCase().replaceAll(/[^a-z0-9]+/g,'-');ui.terminalMeta.textContent=lane.policy+' \xB7 '+(lane.threadId?'attached':'pending');const events=laneEvents(lane.id);ui.terminalStream.innerHTML=(events.length?events.map(event=>'<div class="event '+eventClass(event.kind)+'"><time class="event-time">'+time(event.at)+'</time><code class="event-kind">'+esc(eventLabel(event.kind))+'</code><div class="event-copy">'+esc(event.summary)+'</div></div>').join(''):'<div class="terminal-empty">lane connected; waiting for meaningful Codex activity.</div>')+(lane.currentTurnId?'<div class="cursor-line"><span>&gt;</span><i class="cursor"></i><span>Codex turn in progress</span></div>':'');ui.terminalStream.scrollTop=ui.terminalStream.scrollHeight}
+function terminalToken(){return hostToken||laneToken}
+function stopLiveTerminal(){terminalGeneration+=1;terminalSession?.controller?.abort();try{terminalSession?.terminal?.dispose?.()}catch{}terminalSession=null;ui.ghosttyTerminal.innerHTML=''}
+function terminalEmpty(message){ui.ghosttyTerminal.innerHTML='<div class="terminal-empty">'+esc(message)+'</div>'}
+async function libterminalBrowser(){libterminalBrowserPromise||=import('/vendor/libterminal/browser.js');return libterminalBrowserPromise}
+async function connectLiveTerminal(lane){if(terminalSession?.laneId===lane.id)return;stopLiveTerminal();const generation=terminalGeneration;const controller=new AbortController();terminalSession={laneId:lane.id,controller,terminal:null};terminalEmpty('connecting read-only terminal mirror...');try{const module=await libterminalBrowser();if(generation!==terminalGeneration)return;ui.ghosttyTerminal.innerHTML='';const columns=lane.terminalColumns||120,rows=lane.terminalRows||34;const terminal=await module.createGhosttyTerminal({parent:ui.ghosttyTerminal,runtimeOptions:{wasmUrl:'${GHOSTTY_ASSET_PATHS.wasm}'},readOnly:true,autoFit:false,size:{columns,rows},signal:controller.signal,terminalOptions:{fontSize:13,theme:{background:'#171d1a',foreground:'#d9e4dc',cursor:'#72bd93',selectionBackground:'#435047',black:'#171d1a',red:'#ed7868',green:'#72bd93',yellow:'#ddb85c',blue:'#77a8ee',magenta:'#b89bd6',cyan:'#73b7ad',white:'#d9e4dc',brightBlack:'#78877e',brightRed:'#f29b8f',brightGreen:'#9bd2ae',brightYellow:'#ead18d',brightBlue:'#a1c2ef',brightMagenta:'#ccb8df',brightCyan:'#9dd0c8',brightWhite:'#f1f6f2'}}});terminalSession={laneId:lane.id,controller,terminal,columns,rows};const response=await fetch('/api/lanes/'+encodeURIComponent(lane.id)+'/terminal',{headers:{authorization:'Bearer '+terminalToken()},signal:controller.signal});if(!response.ok)throw new Error('mirror unavailable ('+response.status+')');if(!response.body)throw new Error('mirror stream unavailable');ui.terminalMeta.textContent='live mirror - read-only';await terminal.attach(response.body,controller.signal);if(generation===terminalGeneration)ui.terminalMeta.textContent='live mirror ended'}catch(error){if(generation!==terminalGeneration||error.name==='AbortError')return;terminalEmpty(error.message||'live terminal unavailable');ui.terminalMeta.textContent='structured activity available'}}
+function syncTerminalMode(lane){const canLive=Boolean(lane?.terminalMirror&&(hostToken||laneToken));const live=terminalMode==='live'&&canLive;ui.modeLive.disabled=!canLive;ui.modeLive.classList.toggle('active',live);ui.modeActivity.classList.toggle('active',!live);ui.terminalLive.classList.toggle('active',live);ui.terminalStream.classList.toggle('active',!live);if(live){const columns=lane.terminalColumns||120,rows=lane.terminalRows||34;if(terminalSession?.terminal&&(terminalSession.columns!==columns||terminalSession.rows!==rows)){terminalSession.terminal.resize({columns,rows});terminalSession.columns=columns;terminalSession.rows=rows}void connectLiveTerminal(lane)}else stopLiveTerminal()}
+function renderPeople(){const active=activeLanes(),pending=pendingInvites();ui.seatCount.textContent=active.length+' active - '+pending.length+' invited';const people=active.map((lane,index)=>'<div class="person '+(lane.id===selectedLaneId?'selected ':'')+'" style="--role:'+roleColors[index%roleColors.length]+'"><span class="avatar">'+esc(initials(lane.displayName))+'</span><button class="seat-copy" data-select="'+esc(lane.id)+'"><strong>'+esc(lane.displayName)+'</strong><span>'+esc(lane.connected?lane.status:'offline - '+lane.status)+'</span><i class="policy">'+esc(lane.policy)+'</i></button><span class="person-actions">'+(hostToken?'<button class="icon-button" data-remove="'+esc(lane.id)+'" title="remove '+esc(lane.displayName)+'">&times;</button>':'')+'</span></div>').join('');const invites=pending.map(invite=>'<div class="person pending"><span class="avatar">+</span><div class="seat-copy"><strong>'+esc(invite.displayName)+'</strong><span>invite ready - waiting to join</span><i class="policy">'+esc(invite.policy)+(invite.terminalMirror?' - terminal':'')+'</i></div><span class="person-actions">'+(hostToken?'<button class="icon-button" data-copy-invite="'+esc(invite.id)+'" title="copy invite for '+esc(invite.displayName)+'">&#x29c9;</button><button class="icon-button" data-revoke-invite="'+esc(invite.id)+'" title="revoke invite for '+esc(invite.displayName)+'">&times;</button>':'')+'</span></div>').join('');ui.people.innerHTML=people+invites||(hostToken?'<button class="team-empty" data-focus-invite><strong>invite the first teammate</strong><span>create a named command they can run in their own repo</span></button>':'<div class="team-empty"><strong>waiting for teammates</strong><span>the host has not invited anyone yet</span></div>');ui.people.querySelectorAll('[data-select]').forEach(button=>button.onclick=()=>{selectedLaneId=button.dataset.select;render()});ui.people.querySelectorAll('[data-remove]').forEach(button=>button.onclick=()=>removeLane(button.dataset.remove));ui.people.querySelectorAll('[data-copy-invite]').forEach(button=>button.onclick=()=>copy(inviteCommand(button.dataset.copyInvite),'invite copied'));ui.people.querySelectorAll('[data-revoke-invite]').forEach(button=>button.onclick=()=>revokeInvite(button.dataset.revokeInvite));ui.people.querySelector('[data-focus-invite]')?.addEventListener('click',focusInvite)}
+function renderTerminal(){const lane=selectedLane();if(!lane){ui.laneTitle.textContent='waiting for a builder';ui.laneDetail.textContent='copy an invite command to connect a normal local Codex TUI.';ui.laneState.textContent='idle';ui.lanePresence.className='presence';ui.terminalMeta.textContent='structured activity';ui.terminalStream.innerHTML='<div class="terminal-empty">no lane selected<br>the real Codex terminal stays on each participant machine.</div>';syncTerminalMode(null);return}selectedLaneId=lane.id;ui.laneTitle.textContent=lane.displayName;ui.laneDetail.textContent=lane.repo+' - '+lane.policy+' policy - '+(lane.threadId?'thread '+lane.threadId:'thread pending')+(lane.terminalMirror?' - terminal mirrored':'');ui.laneState.textContent=lane.removedAt?'removed':lane.currentTurnId?'active turn':lane.connected?'connected':'disconnected';ui.lanePresence.className='presence '+(lane.connected&&!lane.removedAt?'on':'');ui.terminalTitle.textContent='multicodex://'+snapshot.id+'/'+lane.displayName.toLowerCase().replaceAll(/[^a-z0-9]+/g,'-');ui.terminalMeta.textContent=lane.terminalMirror?'live mirror - read-only':lane.policy+' - structured activity';const events=laneEvents(lane.id);ui.terminalStream.innerHTML=(events.length?events.map(event=>'<div class="event '+eventClass(event.kind)+'"><time class="event-time">'+time(event.at)+'</time><code class="event-kind">'+esc(eventLabel(event.kind))+'</code><div class="event-copy">'+esc(event.summary)+'</div></div>').join(''):'<div class="terminal-empty">lane connected; waiting for meaningful Codex activity.</div>')+(lane.currentTurnId?'<div class="cursor-line"><span>&gt;</span><i class="cursor"></i><span>Codex turn in progress</span></div>':'');ui.terminalStream.scrollTop=ui.terminalStream.scrollHeight;syncTerminalMode(lane)}
 function renderMessages(){const messages=snapshot?.conductorMessages||[];ui.messages.innerHTML=messages.length?messages.slice(-80).map(message=>'<div class="message '+(message.author==='conductor'?'conductor-message':'')+'"><strong>'+esc(message.authorName||message.author)+'</strong><time>'+time(message.at)+'</time><p>'+esc(message.body)+'</p></div>').join(''):'<div class="terminal-empty">message the conductor to begin visible coordination.</div>';ui.messages.scrollTop=ui.messages.scrollHeight}
-function renderControls(){const lanes=activeLanes();const previous=ui.laneSelect.value||selectedLaneId;ui.laneSelect.innerHTML=lanes.map(lane=>'<option value="'+esc(lane.id)+'">'+esc(lane.displayName)+'</option>').join('');ui.laneSelect.value=lanes.some(lane=>lane.id===previous)?previous:(lanes[0]?.id||'');const hostLocked=!hostToken;document.querySelectorAll('#add-person input,#add-person select,#add-person button,#command-form input,#command-form select,#command-form button,#copy-invite,#quick-copy').forEach(element=>element.disabled=hostLocked);document.querySelectorAll('#message-form input,#message-form button').forEach(element=>element.disabled=!hostToken&&!laneToken);const mode=hostToken?'host':laneToken?'participant':'observer';ui.hostMode.textContent=mode;ui.connection.textContent=(mode==='observer'?'read-only \xB7 ':'live \xB7 ')+new Date().toLocaleTimeString();ui.topStatus.textContent=mode==='host'?'host control':mode+' view'}
+function renderControls(){const lanes=activeLanes();const previous=ui.laneSelect.value||selectedLaneId;ui.laneSelect.innerHTML=lanes.map(lane=>'<option value="'+esc(lane.id)+'">'+esc(lane.displayName)+'</option>').join('');ui.laneSelect.value=lanes.some(lane=>lane.id===previous)?previous:(lanes[0]?.id||'');const hostLocked=!hostToken;document.querySelector('#add-person').hidden=hostLocked;document.querySelector('#command-form').hidden=hostLocked;document.querySelector('#copy-invite').hidden=hostLocked;document.querySelector('#quick-copy').hidden=hostLocked;document.querySelectorAll('#message-form input,#message-form button').forEach(element=>element.disabled=!hostToken&&!laneToken);const mode=hostToken?'host':laneToken?'participant':'observer';ui.hostMode.textContent=mode;ui.connection.textContent=(mode==='observer'?'read-only - ':'live - ')+new Date().toLocaleTimeString();ui.topStatus.textContent=mode==='host'?'host control':mode+' team view'}
 function renderMetrics(){const events=snapshot?.events||[];ui.metricActive.textContent=String(activeLanes().filter(lane=>lane.connected).length);ui.metricTurns.textContent=String(events.filter(event=>event.kind==='turn.completed').length);ui.metricActions.textContent=String(events.filter(event=>event.kind==='command.result').length)}
-function render(){if(!snapshot)return;ui.roomTitle.textContent=snapshot.title;ui.roomMeta.textContent=snapshot.repo+' \xB7 '+snapshot.id;renderPeople();renderTerminal();renderMessages();renderControls();renderMetrics()}
-async function refresh(){if(refreshing)return;refreshing=true;try{snapshot=await api('/api/snapshot');if(hostToken&&!hostConfig)hostConfig=await api('/api/host/config',{host:true});if(!selectedLaneId)selectedLaneId=activeLanes()[0]?.id||'';render()}catch(error){ui.connection.textContent=error.message;ui.topStatus.textContent='offline'}finally{refreshing=false}}
+function render(){if(!snapshot)return;ui.roomTitle.textContent=snapshot.title;ui.roomMeta.textContent=snapshot.repo+' - '+snapshot.id;renderPeople();renderTerminal();renderMessages();renderControls();renderMetrics()}
+async function refresh(){if(refreshing)return;refreshing=true;try{snapshot=await api('/api/snapshot');if(hostToken)hostConfig=await api('/api/host/config',{host:true});if(!selectedLaneId)selectedLaneId=activeLanes()[0]?.id||'';render()}catch(error){ui.connection.textContent=error.message;ui.topStatus.textContent='offline'}finally{refreshing=false}}
 async function removeLane(laneId){const lane=snapshot.lanes.find(candidate=>candidate.id===laneId);if(!lane||!confirm('Remove '+lane.displayName+' and revoke this lane?'))return;await api('/api/lanes/'+encodeURIComponent(laneId),{method:'DELETE',host:true});toast(lane.displayName+' removed');await refresh()}
-function joinCommand(name='Builder',policy='suggest'){if(!hostConfig)return'';return hostConfig.joinCommand+' --name '+shellQuote(name)+' --policy '+policy}
-document.querySelector('#copy-invite').onclick=()=>copy(joinCommand(),'invite command copied');
-document.querySelector('#quick-copy').onclick=()=>copy(joinCommand(),'invite command copied');
-document.querySelector('#add-person').onsubmit=async event=>{event.preventDefault();const data=new FormData(event.currentTarget);await copy(joinCommand(String(data.get('name')),String(data.get('policy'))),'join command copied');event.currentTarget.querySelector('input').select()};
+function focusInvite(){ui.inviteName.focus();ui.inviteName.select()}
+function inviteCommand(inviteId){return hostConfig?.invites?.find(invite=>invite.id===inviteId)?.joinCommand||''}
+async function revokeInvite(inviteId){const invite=snapshot.invites.find(candidate=>candidate.id===inviteId);if(!invite||!confirm('Revoke the invite for '+invite.displayName+'?'))return;await api('/api/invites/'+encodeURIComponent(inviteId),{method:'DELETE',host:true});toast(invite.displayName+' invite revoked');await refresh()}
+document.querySelector('#copy-invite').onclick=focusInvite;
+document.querySelector('#quick-copy').onclick=focusInvite;
+document.querySelector('#add-person').onsubmit=async event=>{event.preventDefault();const data=new FormData(event.currentTarget);const name=String(data.get('name'));const created=await api('/api/invites',{method:'POST',host:true,body:{displayName:name,policy:data.get('policy'),terminalMirror:data.get('terminalMirror')==='on'}});await copy(created.joinCommand,'invite copied for '+name);ui.inviteFeedback.textContent=name+' invited';ui.inviteName.value='';await refresh();focusInvite()};
 document.querySelector('#message-form').onsubmit=async event=>{event.preventDefault();const data=new FormData(event.currentTarget);const path=hostToken?'/api/conductor/message':'/api/lanes/'+encodeURIComponent(viewerLaneId)+'/message';const headers=hostToken?{method:'POST',host:true,body:{text:data.get('text')}}:{method:'POST',body:{text:data.get('text')}};if(!hostToken)headers.lane=true;await api(path,headers);event.currentTarget.reset();toast('sent to room and conductor');await refresh()};
 document.querySelector('#command-form').onsubmit=async event=>{event.preventDefault();const data=new FormData(event.currentTarget);await api('/api/conductor/command',{method:'POST',host:true,body:{laneId:data.get('laneId'),kind:data.get('kind'),text:data.get('text')}});ui.commandText.value='';toast('visible action queued');await refresh()};
 ui.laneSelect.onchange=()=>{selectedLaneId=ui.laneSelect.value;render()};
 ui.kindSelect.onchange=()=>{ui.commandText.placeholder={suggest:'what should the lane know?',request_status:'what status do you need?',start_followup:'what should Codex do next?',steer_active_turn:'how should the active turn change?',request_interrupt:'why should the active turn stop?'}[ui.kindSelect.value]||'visible action'};
+ui.modeLive.onclick=()=>{terminalMode='live';syncTerminalMode(selectedLane())};
+ui.modeActivity.onclick=()=>{terminalMode='activity';syncTerminalMode(selectedLane())};
 setInterval(refresh,900);refresh();
 </script></body></html>`;
 }
@@ -930,7 +1163,7 @@ var LocalRoomStore = class _LocalRoomStore {
     this.state = state;
   }
   static async create(input) {
-    await fs3.mkdir(input.stateDir, { recursive: true, mode: 448 });
+    await fs4.mkdir(input.stateDir, { recursive: true, mode: 448 });
     const statePath = path5.join(input.stateDir, "room.json");
     const state = {
       version: protocolVersion,
@@ -938,6 +1171,7 @@ var LocalRoomStore = class _LocalRoomStore {
       title: input.title,
       repo: input.repo,
       createdAt: Date.now(),
+      invites: [],
       lanes: [],
       events: [],
       conductorMessages: [],
@@ -952,10 +1186,16 @@ var LocalRoomStore = class _LocalRoomStore {
   }
   static async load(stateDir) {
     const statePath = path5.join(stateDir, "room.json");
-    const state = JSON.parse(await fs3.readFile(statePath, "utf8"));
+    const state = JSON.parse(await fs4.readFile(statePath, "utf8"));
     state.hostToken ||= crypto.randomUUID();
     state.inviteToken ||= crypto.randomUUID();
-    for (const lane of state.lanes) lane.removedAt ??= null;
+    state.invites ??= [];
+    for (const lane of state.lanes) {
+      lane.removedAt ??= null;
+      lane.terminalMirror ??= false;
+      lane.terminalColumns ??= null;
+      lane.terminalRows ??= null;
+    }
     const store = new _LocalRoomStore(statePath, state);
     await store.save();
     return store;
@@ -967,6 +1207,7 @@ var LocalRoomStore = class _LocalRoomStore {
       title: this.state.title,
       repo: publicRepoName(this.state.repo),
       createdAt: this.state.createdAt,
+      invites: this.state.invites.map(({ token: _token, ...invite }) => invite),
       lanes: this.state.lanes.map(({ token: _token, ...lane }) => ({
         ...lane,
         repo: publicRepoName(lane.repo)
@@ -979,8 +1220,12 @@ var LocalRoomStore = class _LocalRoomStore {
     const inviteUrl = capabilityUrl(publicUrl, "invite", this.state.inviteToken);
     return {
       inviteUrl,
-      joinCommand: `npx --yes @vincentkoc/multicodex@latest join ${shellQuote(inviteUrl)} --repo .`,
-      activeLanes: this.state.lanes.filter((lane) => !lane.removedAt).length
+      joinCommand: joinCommand(inviteUrl),
+      activeLanes: this.state.lanes.filter((lane) => !lane.removedAt).length,
+      invites: this.state.invites.filter((invite) => !invite.claimedAt && !invite.revokedAt).map((invite) => ({
+        id: invite.id,
+        joinCommand: joinCommand(capabilityUrl(publicUrl, "invite", invite.token), invite)
+      }))
     };
   }
   hostUrl(publicUrl) {
@@ -995,6 +1240,55 @@ var LocalRoomStore = class _LocalRoomStore {
   authorizeInvite(token) {
     return token === this.state.inviteToken;
   }
+  async createInvite(input) {
+    const invite = {
+      id: `invite_${crypto.randomUUID()}`,
+      token: crypto.randomUUID(),
+      displayName: input.displayName,
+      policy: input.policy,
+      terminalMirror: input.terminalMirror !== false,
+      createdAt: Date.now(),
+      claimedAt: null,
+      claimedLaneId: null,
+      revokedAt: null
+    };
+    this.state.invites.push(invite);
+    await this.save();
+    const { token, ...publicInvite } = invite;
+    return { invite: publicInvite, token };
+  }
+  async revokeInvite(inviteId) {
+    const invite = this.state.invites.find((candidate) => candidate.id === inviteId);
+    if (!invite) throw new RoomError(404, "invite not found");
+    if (invite.claimedAt) throw new RoomError(409, "invite already claimed");
+    if (invite.revokedAt) return;
+    invite.revokedAt = Date.now();
+    await this.save();
+  }
+  async joinFromInvite(inviteToken, input) {
+    if (this.authorizeInvite(inviteToken)) return this.join(input);
+    const invite = this.state.invites.find((candidate) => candidate.token === inviteToken);
+    if (!invite) throw new RoomError(401, "valid room invite required");
+    if (invite.revokedAt) throw new RoomError(410, "invite revoked by host");
+    if (invite.claimedAt) throw new RoomError(410, "invite already claimed");
+    invite.claimedAt = Date.now();
+    await this.save();
+    try {
+      const joined = await this.join({
+        displayName: invite.displayName,
+        repo: input.repo,
+        policy: invite.policy,
+        terminalMirror: invite.terminalMirror && input.terminalMirror === true
+      });
+      invite.claimedLaneId = joined.lane.id;
+      await this.save();
+      return joined;
+    } catch (cause) {
+      invite.claimedAt = null;
+      await this.save();
+      throw cause;
+    }
+  }
   async join(input) {
     const now = Date.now();
     const lane = {
@@ -1003,6 +1297,9 @@ var LocalRoomStore = class _LocalRoomStore {
       displayName: input.displayName,
       repo: input.repo,
       policy: input.policy,
+      terminalMirror: Boolean(input.terminalMirror),
+      terminalColumns: null,
+      terminalRows: null,
       connected: false,
       threadId: null,
       currentTurnId: null,
@@ -1027,6 +1324,7 @@ var LocalRoomStore = class _LocalRoomStore {
     lane.displayName = input.displayName;
     lane.repo = input.repo;
     lane.policy = input.policy;
+    lane.terminalMirror = Boolean(input.terminalMirror);
     lane.updatedAt = Date.now();
     lane.status = "reconnecting";
     await this.save();
@@ -1038,6 +1336,34 @@ var LocalRoomStore = class _LocalRoomStore {
       (lane) => lane.id === laneId && lane.token === token && !lane.removedAt
     ) ?? null;
   }
+  authorizeParticipant(token) {
+    return this.state.lanes.some((lane) => lane.token === token && !lane.removedAt);
+  }
+  authorizeTerminalViewer(laneId, token) {
+    const lane = this.state.lanes.find((candidate) => candidate.id === laneId);
+    if (!lane || lane.removedAt || !lane.terminalMirror) return false;
+    return token === this.state.hostToken || this.authorizeParticipant(token);
+  }
+  authorizeTerminalPublisher(laneId, token) {
+    const lane = this.authorizeLane(laneId, token);
+    return Boolean(lane?.terminalMirror);
+  }
+  async updateTerminalSize(laneId, token, columns, rows) {
+    const lane = this.requireLane(laneId, token);
+    if (!lane.terminalMirror) throw new RoomError(403, "terminal mirror unavailable");
+    lane.terminalColumns = terminalDimension(columns, 20, 400);
+    lane.terminalRows = terminalDimension(rows, 10, 200);
+    lane.updatedAt = Date.now();
+    await this.save();
+  }
+  async disableTerminalMirror(laneId, token) {
+    const lane = this.requireLane(laneId, token);
+    lane.terminalMirror = false;
+    lane.terminalColumns = null;
+    lane.terminalRows = null;
+    lane.updatedAt = Date.now();
+    await this.save();
+  }
   async appendEvents(laneId, token, events) {
     const lane = this.requireLane(laneId, token);
     for (const event of events) {
@@ -1097,7 +1423,7 @@ var LocalRoomStore = class _LocalRoomStore {
   async removeLane(laneId) {
     const lane = this.state.lanes.find((candidate) => candidate.id === laneId);
     if (!lane) throw new RoomError(404, "lane not found");
-    if (lane.removedAt) return;
+    if (lane.removedAt) return lane.token;
     const now = Date.now();
     lane.removedAt = now;
     lane.connected = false;
@@ -1105,6 +1431,7 @@ var LocalRoomStore = class _LocalRoomStore {
     lane.status = "removed by host";
     lane.updatedAt = now;
     await this.addConductorMessage("system", `${lane.displayName} removed by host`);
+    return lane.token;
   }
   async addParticipantMessage(laneId, token, body) {
     const lane = this.requireLane(laneId, token);
@@ -1138,9 +1465,9 @@ var LocalRoomStore = class _LocalRoomStore {
   async save() {
     this.savePromise = this.savePromise.then(async () => {
       const temporary = `${this.statePath}.tmp`;
-      await fs3.writeFile(temporary, `${JSON.stringify(this.state, null, 2)}
+      await fs4.writeFile(temporary, `${JSON.stringify(this.state, null, 2)}
 `, { mode: 384 });
-      await fs3.rename(temporary, this.statePath);
+      await fs4.rename(temporary, this.statePath);
     });
     await this.savePromise;
   }
@@ -1152,10 +1479,19 @@ async function startLocalRoomServer(input) {
   }
   if (input.publicUrl) new URL(input.publicUrl);
   let publicUrl = "";
+  const terminalHub = new TerminalMirrorHub();
   const server = http.createServer((request, response) => {
-    void handleRequest(input.store, input.handlers, publicUrl, request, response).catch((cause) => {
+    void handleRequest(
+      input.store,
+      input.handlers,
+      terminalHub,
+      publicUrl,
+      request,
+      response
+    ).catch((cause) => {
       const error = cause instanceof RoomError ? cause : new RoomError(500, errorMessage(cause));
-      sendJson(response, error.status, { error: error.message });
+      if (!response.headersSent) sendJson(response, error.status, { error: error.message });
+      else response.destroy();
     });
   });
   await new Promise((resolve, reject) => {
@@ -1170,18 +1506,26 @@ async function startLocalRoomServer(input) {
     hostUrl: input.store.hostUrl(publicUrl),
     inviteUrl: input.store.inviteUrl(publicUrl),
     close: async () => {
+      terminalHub.closeAll();
       await new Promise(
         (resolve, reject) => server.close((cause) => cause ? reject(cause) : resolve())
       );
     }
   };
 }
-async function handleRequest(store, handlers, publicUrl, request, response) {
+async function handleRequest(store, handlers, terminalHub, publicUrl, request, response) {
   const url = new URL(request.url ?? "/", "http://127.0.0.1");
   if (request.method === "GET" && url.pathname === "/") {
     sendText(response, 200, localRoomHtml(), "text/html; charset=utf-8");
     return;
   }
+  if (request.method === "GET") {
+    const asset = await readTerminalAsset(url.pathname);
+    if (asset) {
+      sendBinary(response, 200, asset.body, asset.contentType);
+      return;
+    }
+  }
   if (request.method === "GET" && url.pathname === "/api/snapshot") {
     sendJson(response, 200, store.snapshot());
     return;
@@ -1191,19 +1535,37 @@ async function handleRequest(store, handlers, publicUrl, request, response) {
     sendJson(response, 200, store.hostConfig(publicUrl));
     return;
   }
+  if (request.method === "POST" && url.pathname === "/api/invites") {
+    requireHost(store, request);
+    const body = await readJson(request);
+    const policy = requiredPolicy(body.policy);
+    const created = await store.createInvite({
+      displayName: requiredString(body.displayName, "displayName"),
+      policy,
+      terminalMirror: body.terminalMirror !== false
+    });
+    const inviteUrl = capabilityUrl(publicUrl, "invite", created.token);
+    sendJson(response, 201, {
+      invite: created.invite,
+      inviteUrl,
+      joinCommand: joinCommand(inviteUrl, created.invite)
+    });
+    return;
+  }
+  const inviteMatch = url.pathname.match(/^\/api\/invites\/([^/]+)$/);
+  if (request.method === "DELETE" && inviteMatch) {
+    requireHost(store, request);
+    await store.revokeInvite(decodeURIComponent(inviteMatch[1]));
+    sendJson(response, 200, { revoked: true });
+    return;
+  }
   if (request.method === "POST" && url.pathname === "/api/join") {
-    if (!store.authorizeInvite(bearer(request))) {
-      throw new RoomError(401, "valid room invite required");
-    }
     const body = await readJson(request);
-    const policy = body.policy;
-    if (!["observe", "suggest", "steer"].includes(String(policy))) {
-      throw new RoomError(400, "policy must be observe, suggest, or steer");
-    }
-    const joined = await store.join({
+    const joined = await store.joinFromInvite(bearer(request), {
       displayName: requiredString(body.displayName, "displayName"),
       repo: requiredString(body.repo, "repo"),
-      policy
+      policy: requiredPolicy(body.policy),
+      terminalMirror: body.terminalMirror === true
     });
     sendJson(response, 201, { room: store.snapshot(), ...joined });
     return;
@@ -1211,15 +1573,15 @@ async function handleRequest(store, handlers, publicUrl, request, response) {
   const resumeMatch = url.pathname.match(/^\/api\/lanes\/([^/]+)\/resume$/);
   if (request.method === "POST" && resumeMatch) {
     const body = await readJson(request);
-    const policy = body.policy;
-    if (!["observe", "suggest", "steer"].includes(String(policy))) {
-      throw new RoomError(400, "policy must be observe, suggest, or steer");
-    }
-    const resumed = await store.resumeLane(decodeURIComponent(resumeMatch[1]), bearer(request), {
+    const laneId = decodeURIComponent(resumeMatch[1]);
+    const terminalMirror = body.terminalMirror === true;
+    const resumed = await store.resumeLane(laneId, bearer(request), {
       displayName: requiredString(body.displayName, "displayName"),
       repo: requiredString(body.repo, "repo"),
-      policy
+      policy: requiredPolicy(body.policy),
+      terminalMirror
     });
+    if (!terminalMirror) terminalHub.closeLane(laneId);
     sendJson(response, 200, { room: store.snapshot(), ...resumed });
     return;
   }
@@ -1239,6 +1601,44 @@ async function handleRequest(store, handlers, publicUrl, request, response) {
     sendJson(response, 200, { commands: store.commandsAfter(laneId, bearer(request), after) });
     return;
   }
+  const terminalMatch = url.pathname.match(/^\/api\/lanes\/([^/]+)\/terminal$/);
+  if (terminalMatch) {
+    const laneId = decodeURIComponent(terminalMatch[1]);
+    const token = optionalBearer(request);
+    if (request.method === "GET") {
+      if (!store.authorizeTerminalViewer(laneId, token)) {
+        throw new RoomError(403, "terminal mirror unavailable");
+      }
+      terminalHub.subscribe(laneId, token, response);
+      return;
+    }
+    if (request.method === "POST") {
+      if (!store.authorizeTerminalPublisher(laneId, token)) {
+        throw new RoomError(403, "terminal mirror unavailable");
+      }
+      for await (const chunk of request) terminalHub.publish(laneId, Buffer.from(chunk));
+      sendJson(response, 202, { accepted: true });
+      return;
+    }
+    if (request.method === "DELETE") {
+      await store.disableTerminalMirror(laneId, token);
+      terminalHub.closeLane(laneId);
+      sendJson(response, 200, { disabled: true });
+      return;
+    }
+  }
+  const terminalSizeMatch = url.pathname.match(/^\/api\/lanes\/([^/]+)\/terminal-size$/);
+  if (request.method === "POST" && terminalSizeMatch) {
+    const body = await readJson(request);
+    await store.updateTerminalSize(
+      decodeURIComponent(terminalSizeMatch[1]),
+      bearer(request),
+      Number(body.columns),
+      Number(body.rows)
+    );
+    sendJson(response, 202, { accepted: true });
+    return;
+  }
   const laneMessageMatch = url.pathname.match(/^\/api\/lanes\/([^/]+)\/message$/);
   if (request.method === "POST" && laneMessageMatch) {
     const laneId = decodeURIComponent(laneMessageMatch[1]);
@@ -1265,7 +1665,10 @@ async function handleRequest(store, handlers, publicUrl, request, response) {
   const removeMatch = url.pathname.match(/^\/api\/lanes\/([^/]+)$/);
   if (request.method === "DELETE" && removeMatch) {
     requireHost(store, request);
-    await store.removeLane(decodeURIComponent(removeMatch[1]));
+    const laneId = decodeURIComponent(removeMatch[1]);
+    const removedToken = await store.removeLane(laneId);
+    terminalHub.closeViewer(removedToken);
+    terminalHub.closeLane(laneId);
     sendJson(response, 200, { removed: true });
     return;
   }
@@ -1341,6 +1744,10 @@ function bearer(request) {
   if (!value?.startsWith("Bearer ")) throw new RoomError(401, "lane capability required");
   return value.slice("Bearer ".length);
 }
+function optionalBearer(request) {
+  const value = request.headers.authorization;
+  return value?.startsWith("Bearer ") ? value.slice("Bearer ".length) : "";
+}
 function requireHost(store, request) {
   if (!store.authorizeHost(bearer(request))) throw new RoomError(401, "host capability required");
 }
@@ -1356,6 +1763,16 @@ function requiredCommandKind(value) {
   }
   return value;
 }
+function requiredPolicy(value) {
+  if (!["observe", "suggest", "steer"].includes(String(value))) {
+    throw new RoomError(400, "policy must be observe, suggest, or steer");
+  }
+  return value;
+}
+function terminalDimension(value, minimum, maximum) {
+  if (!Number.isFinite(value)) throw new RoomError(400, "valid terminal dimensions required");
+  return Math.min(maximum, Math.max(minimum, Math.trunc(value)));
+}
 function advertisedUrl(host2, port, configured) {
   if (configured) return new URL(configured).toString().replace(/\/$/, "");
   if (["0.0.0.0", "::"].includes(host2)) {
@@ -1372,9 +1789,23 @@ function capabilityUrl(base, kind, token) {
 function shellQuote(value) {
   return `'${value.replaceAll("'", `'"'"'`)}'`;
 }
+function joinCommand(inviteUrl, invite) {
+  const command2 = `npx --yes @vincentkoc/multicodex@latest join ${shellQuote(inviteUrl)} --repo .`;
+  if (!invite) return `${command2} --terminal-mirror`;
+  return `${command2} --name ${shellQuote(invite.displayName)} --policy ${invite.policy}${invite.terminalMirror ? " --terminal-mirror" : ""}`;
+}
 function sendJson(response, status2, body) {
   sendText(response, status2, JSON.stringify(body), "application/json; charset=utf-8");
 }
+function sendBinary(response, status2, body, contentType) {
+  response.writeHead(status2, {
+    "content-type": contentType,
+    "content-length": String(body.byteLength),
+    "cache-control": "public, max-age=31536000, immutable",
+    "x-content-type-options": "nosniff"
+  });
+  response.end(body);
+}
 function sendText(response, status2, body, contentType) {
   response.writeHead(status2, {
     "content-type": contentType,
@@ -1446,8 +1877,8 @@ async function host(args2) {
       "",
       "MultiCodex room ready",
       `control: ${server.hostUrl}`,
-      `invite: npx --yes @vincentkoc/multicodex@latest join ${shellQuote2(server.inviteUrl)} --repo . --name Builder --policy suggest`,
-      `dev join: pnpm multicodex join ${shellQuote2(server.inviteUrl)} --repo . --name Builder --policy suggest`,
+      `invite: npx --yes @vincentkoc/multicodex@latest join ${shellQuote2(server.inviteUrl)} --repo . --name Builder --policy suggest --terminal-mirror`,
+      `dev join: pnpm multicodex join ${shellQuote2(server.inviteUrl)} --repo . --name Builder --policy suggest --terminal-mirror`,
       "conductor: local ACPx / Codex",
       "runtime: no Crabfleet, Crabbox, server OpenAI key, or GitHub token",
       ""
@@ -1463,6 +1894,9 @@ async function join(args2) {
   if (!["observe", "suggest", "steer"].includes(policy)) {
     throw new Error("policy must be observe, suggest, or steer");
   }
+  const noTui = Boolean(options["no-tui"]);
+  const terminalMirror = Boolean(options["terminal-mirror"]);
+  if (noTui && terminalMirror) throw new Error("--terminal-mirror requires the normal Codex TUI");
   const codexPath = await resolveUserCodexPath({ explicit: options.codex });
   if (!codexPath) {
     throw new Error(
@@ -1475,7 +1909,8 @@ async function join(args2) {
     displayName: options.name ?? process.env.USER ?? "Builder",
     policy,
     codexPath,
-    noTui: Boolean(options["no-tui"]),
+    noTui,
+    terminalMirror,
     prompt: options.prompt,
     fresh: Boolean(options.fresh),
     statePath: options.state ? path6.resolve(options.state) : void 0
@@ -1489,8 +1924,8 @@ async function doctor() {
   const [nodeMajor = 0, nodeMinor = 0] = process.versions.node.split(".").map(Number);
   checks.push([
     "Node",
-    nodeMajor > 22 || nodeMajor === 22 && nodeMinor >= 13,
-    `${process.version} (requires >=22.13.0)`
+    nodeMajor > 24 || nodeMajor === 24 && nodeMinor >= 11 || nodeMajor === 22 && nodeMinor >= 18,
+    `${process.version} (requires ^22.18.0 or >=24.11.0)`
   ]);
   const codexPath = await resolveUserCodexPath();
   if (!codexPath) {
@@ -1542,6 +1977,7 @@ Usage:
 
 Options:
   --no-tui           connect the bridge without launching the normal Codex TUI
+  --terminal-mirror  share an ephemeral read-only TUI mirror with the room
   --prompt <text>    start a builder turn after connecting
   --fresh            create a new lane instead of resuming local lane state
   --state <path>     override the builder lane state file

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincentkoc/multicodex",
-	"version": "0.1.0",
+	"version": "0.2.0",
 	"private": false,
 	"description": "A self-contained multiplayer control room for normal local Codex sessions",
 	"homepage": "https://github.com/vincentkoc/multicodex#readme",
@@ -23,41 +23,39 @@
 		"access": "public"
 	},
 	"scripts": {
-		"alpha:host": "node --experimental-strip-types packages/cli/src/index.ts host --repo .",
-		"build": "pnpm build:cli && pnpm smoke:cli && pnpm legacy:build",
+		"build": "pnpm build:cli && pnpm smoke:cli",
 		"build:cli": "node scripts/build-cli.mjs",
 		"check": "pnpm typecheck && pnpm test && pnpm lint && pnpm format",
-		"db:local": "wrangler d1 migrations apply DB --local",
-		"deploy": "pnpm build && wrangler d1 migrations apply DB --remote && wrangler deploy",
-		"dev": "node scripts/dev.mjs",
 		"format": "oxfmt --check .",
 		"format:fix": "oxfmt .",
 		"lint": "oxlint .",
-		"legacy:build": "wrangler types && vite build && tsc --noEmit",
 		"multicodex": "node --experimental-strip-types packages/cli/src/index.ts",
 		"prepack": "pnpm build:cli",
 		"smoke:cli": "node dist/cli.mjs --help",
 		"test": "node --test --experimental-strip-types tests/*.test.ts",
-		"typecheck": "wrangler types && tsc --noEmit"
+		"typecheck": "tsc --noEmit"
 	},
 	"dependencies": {
 		"@agentclientprotocol/codex-acp": "0.0.46",
+		"@openclaw/libterminal": "0.1.0",
 		"acpx": "0.10.0",
-		"lucide-preact": "^0.468.0",
-		"preact": "^10.29.2"
+		"node-pty": "1.1.0"
 	},
 	"devDependencies": {
-		"@preact/preset-vite": "^2.10.5",
 		"@types/node": "^24.0.0",
 		"esbuild": "0.28.1",
 		"oxfmt": "^0.54.0",
 		"oxlint": "^1.69.0",
-		"typescript": "^5.9.3",
-		"vite": "^8.0.16",
-		"wrangler": "^4.100.0"
+		"typescript": "^5.9.3"
 	},
 	"engines": {
-		"node": ">=22.13.0"
-	},
-	"packageManager": "pnpm@10.23.0"
+		"node": "^22.18.0 || >=24.11.0"
+	},
+	"packageManager": "pnpm@10.23.0",
+	"pnpm": {
+		"onlyBuiltDependencies": [
+			"esbuild",
+			"node-pty"
+		]
+	}
 }