menmu-agent-room 0.1.0

package/README.md

@@ -0,0 +1,63 @@
+# agent_room
+
+A Linux host creates a shared project session. Members on macOS or Linux request access using its IP and session ID, then share a Codex task queue, terminal and browser conversation after host approval.
+
+## Install with npm
+
+Requires Node.js 20+ and npm:
+
+```sh
+npm install -g menmu-agent-room
+agent_room help
+```
+
+This archive includes macOS/Linux x64/arm64 native binaries. It requires no Go compiler, install scripts, or additional download during installation. The launcher selects the platform and checks its SHA-256 before running. `--ignore-scripts` installations also work.
+
+The npm package name is `menmu-agent-room`; the installed command is `agent_room`. For offline installation, use `npm install -g ./menmu-agent-room-0.1.0.tgz`. To install without administrator access, add `--prefix "$HOME/.local"` and put `$HOME/.local/bin` on PATH.
+
+## Host (Linux)
+
+The host also needs the compatible Codex runtime and a Codex login:
+
+```sh
+npm install --prefix "$HOME/.local/share/agent_room/codex" '@openai/codex@0.151.0-alpha.7.2'
+~/.local/share/agent_room/codex/node_modules/.bin/codex login
+cd /path/to/your/git/project
+agent_room host .
+```
+
+If the host already has this runtime and login, reuse them. Members need neither Codex nor a host OS account. Work runs with the host execution user's authority.
+
+## Join and open the browser (member's computer)
+
+Copy the actual host address, including its port, and full session ID:
+
+```sh
+agent_room join HOST_IP SESSION_ID --name alice --answers
+```
+
+The host approves in another terminal in the same project:
+
+```sh
+agent_room requests
+agent_room approve REQUEST_ID
+```
+
+Already connected in a terminal? Open a separate browser client with:
+
+```sh
+agent_room answers HOST_IP SESSION_ID --name alice
+```
+
+Startup prints `Browser URL: http://127.0.0.1:<local-port>/<random-access-id>/`. This address is generated on each member's own computer; it cannot be assembled from the host IP and session ID. Keep the client running. Add `--no-open` to print the URL without launching a browser.
+
+The browser supports sending tasks, shared member history, member filters, progress grouped by task, and final answers with collapsible progress. The original terminal remains available.
+
+## Update or uninstall
+
+```sh
+npm install -g menmu-agent-room@latest
+npm uninstall -g menmu-agent-room
+```
+
+Uninstalling the CLI keeps host sessions and client credentials. Native hosts currently running are not replaced until they restart.

package/bin/agent_room.cjs

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+'use strict';
+const fs = require('node:fs');
+const path = require('node:path');
+const crypto = require('node:crypto');
+const {spawn} = require('node:child_process');
+const {constants} = require('node:os');
+
+function binaryPath(root, platform = process.platform, architecture = process.arch) {
+  const arch = {x64:'amd64', arm64:'arm64'}[architecture];
+  if (!['darwin', 'linux'].includes(platform) || !arch) {
+    throw new Error(`Unsupported platform ${platform}/${architecture}; agent_room supports macOS/Linux x64 and arm64.`);
+  }
+  return path.join(root, 'native', `agent_room-${platform}-${arch}`);
+}
+function verifyBinary(root, platform, architecture) {
+  const binary = binaryPath(root, platform, architecture);
+  const filename = path.basename(binary);
+  const lines = fs.readFileSync(path.join(root, 'native', 'SHA256SUMS'), 'utf8').split('\n');
+  const checksums = lines.map(line => /^([a-f0-9]{64})\s+([^\s]+)$/.exec(line)).filter(match => match && match[2] === filename);
+  if (checksums.length !== 1) throw new Error(`Missing or ambiguous checksum for ${filename}; reinstall the npm package.`);
+  const actual = crypto.createHash('sha256').update(fs.readFileSync(binary)).digest('hex');
+  if (actual !== checksums[0][1]) throw new Error(`Binary checksum mismatch for ${filename}; reinstall the npm package.`);
+  fs.accessSync(binary, fs.constants.X_OK);
+  return binary;
+}
+function run(root, args) {
+  let executable;
+  try { executable = verifyBinary(root, process.platform, process.arch); }
+  catch (error) {console.error(`agent_room: ${error.message}`);process.exitCode = 1;return;}
+  const child = spawn(executable, args, {stdio:'inherit', shell:false});
+  const handlers = new Map();
+  for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
+    const handler = () => {if (child.exitCode === null && child.signalCode === null) child.kill(signal);};
+    handlers.set(signal, handler);process.on(signal, handler);
+  }
+  function cleanup() {for (const [signal,handler] of handlers) process.removeListener(signal,handler);}
+  child.once('error', error => {cleanup();console.error(`agent_room: could not launch native client: ${error.message}`);process.exitCode=1;});
+  child.once('exit', (code,signal) => {
+    cleanup();
+    process.exitCode = code ?? (constants.signals[signal] ? 128 + constants.signals[signal] : 1);
+  });
+}
+if (require.main === module) run(path.resolve(__dirname, '..'), process.argv.slice(2));
+module.exports = {binaryPath, verifyBinary, run};

package/native/SHA256SUMS

@@ -0,0 +1,4 @@
+dc72bf7b7c5039354573f7f28008815a760515fe0668d7b7d3b69d930fb05a60  agent_room-linux-amd64
+3caaf84a17353f800afa4caefb86119bcaece39beedcc9e8c01faeaa8506bb60  agent_room-linux-arm64
+a0e51e90b386f81986bf1d4a0e7c3d8b018df56fb4bf300e0ee72eb3524ab640  agent_room-darwin-amd64
+fb92b33ea29dc1007434e4d85e3185209f2676c670b7d9fbef2ec324cbda022b  agent_room-darwin-arm64

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "menmu-agent-room",
+  "version": "0.1.0",
+  "description": "Shared Codex project sessions with host-approved members, terminal and browser clients",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "UNLICENSED",
+  "bin": {
+    "agent_room": "bin/agent_room.cjs"
+  },
+  "files": [
+    "bin/agent_room.cjs",
+    "native/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}