menmu-agent-room 0.1.2 → 1.0.4

package/README.md

@@ -4,6 +4,32 @@ A Linux host creates a shared project session. Members on macOS or Linux request
 
 ## Install with npm
 
+Recommended user setup (Node.js 20+, macOS/Linux, no sudo):
+
+```sh
+npm exec --yes --registry=https://registry.npmjs.org/ --package=menmu-agent-room@latest -- agent_room-setup
+export PATH="$HOME/.local/bin:$PATH"
+agent_room dashboard
+```
+
+The setup command ships inside the npm package; no GitHub script download is
+required. In a source checkout or extracted bundle, use `sh scripts/setup.sh`.
+Setup configures Bash/Zsh and preserves existing global installations. Use
+`agent_room doctor` to identify the command and version currently in use.
+
+```sh
+agent_room --version
+agent_room-update --check
+agent_room-update
+agent_room-update --rollback
+```
+
+Updates validate a staged package before switching the managed entry point.
+Failed updates keep the old version. Running clients need to be restarted;
+updates do not stop hosts or cancel tasks. No background updates are scheduled.
+
+Alternative: global npm installation (use the same npm prefix for updates):
+
 Requires Node.js 20+ and npm:
 
 ```sh
@@ -13,7 +39,7 @@ 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.2.tgz`. To install without administrator access, add `--prefix "$HOME/.local"` and put `$HOME/.local/bin` on PATH.
+The npm package name is `menmu-agent-room`; the installed command is `agent_room`. For offline installation, use `npm install -g ./menmu-agent-room-1.0.4.tgz`. To install without administrator access, add `--prefix "$HOME/.local"` and put `$HOME/.local/bin` on PATH.
 
 ## Host (Linux)
 
@@ -70,3 +96,32 @@ 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.
+
+## Local room dashboard
+
+Run `agent_room dashboard` once and keep its terminal running. The local page
+lists saved member identities and local host projects. Add a host address,
+complete session ID and nickname, then connect; first-time members still need
+host approval. Open the conversation from the room card. Disconnect only
+closes that dashboard's connection, preserving membership and submitted tasks.
+Closing the browser tab keeps connections alive; stopping the dashboard process
+closes its connections. Rooms remain available next time, without auto-connecting.
+Connections opened in other terminals are not controlled by this dashboard.
+
+For a host using a custom state directory from an older version, use
+`agent_room dashboard --host-state /absolute/state`. The dashboard does not
+start or stop hosts, create host projects, or grant membership approvals.
+Use `--no-open` to print the local URL without opening a browser.
+
+The chat page shows its local client version, renders Markdown safely, and
+supports code-block copying. Press Enter to send or Alt+Enter for a newline.
+
+## Removing a managed installation
+
+Managed and global npm installations are separate. `npm uninstall -g
+menmu-agent-room` removes the global package only. To remove the managed
+installation, stop its local clients, remove its recognized `~/.local/bin/agent_room`
+and `~/.local/bin/agent_room-update` wrappers, and remove only
+`~/.local/share/agent_room/npm`. Keep the surrounding agent_room directory and
+user configuration directory to preserve host state and member credentials.
+The marked PATH block can remain if you use `~/.local/bin` for other tools.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,48 @@
+# Third-party notices
+
+The browser client embeds marked 15.0.12, used only to tokenize Markdown.
+
+# License information
+
+## Contribution License Agreement
+
+If you contribute code to this project, you are implicitly allowing your code
+to be distributed under the MIT license. You are also implicitly verifying that
+all code is your original work. `</legalese>`
+
+## Marked
+
+Copyright (c) 2018+, MarkedJS (https://github.com/markedjs/)
+Copyright (c) 2011-2018, Christopher Jeffrey (https://github.com/chjj/)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+## Markdown
+
+Copyright © 2004, John Gruber
+http://daringfireball.net/
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+* Neither the name “Markdown” nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+This software is provided by the copyright holders and contributors “as is” and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the copyright owner or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.

package/native/SHA256SUMS

@@ -1,4 +1,4 @@
-42b01b04f38c41c8b8dc71d1e4fe098f3d635156a3b4a7d1de9722163aee92b9  agent_room-linux-amd64
-22ad3a2cf1d060e523091c69973cf26c95be3c319f59e7a4b5d4ae7145b556ea  agent_room-linux-arm64
-38da1a6973e21b64db8f52d75c17a4a24239e49aa361c25390659997e5d30eed  agent_room-darwin-amd64
-68a1830fc9442441c6e1efdc4d963fe27f9ad5d89d822a05d8e7e2a9e41fa0e8  agent_room-darwin-arm64
+a2d397824d4e26a148938f4876100b1b4a15d840a48459326913fc65a99cb410  agent_room-linux-amd64
+43c251414fb4c579b3b799c778554046b58bebaf92902b78e63ed417e777b83a  agent_room-linux-arm64
+d83bbc0f7453f5f7ffc78cec9a11789940344c179412b666b74043af1667f167  agent_room-darwin-amd64
+ecdf2062f4e8c347c6fb052b4d23fb9aa4417b91beed38f4b0d6bd353adff084  agent_room-darwin-arm64

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "menmu-agent-room",
-  "version": "0.1.2",
+  "version": "1.0.4",
   "description": "Shared Codex project sessions with host-approved members, terminal and browser clients",
   "publishConfig": {
     "access": "public",
@@ -12,13 +12,16 @@
     "url": "git+https://github.com/Doorwood/agent_room.git"
   },
   "bin": {
-    "agent_room": "bin/agent_room.cjs"
+    "agent_room": "bin/agent_room.cjs",
+    "agent_room-setup": "scripts/setup.sh"
   },
   "files": [
     "bin/agent_room.cjs",
     "native/",
+    "scripts/setup.sh",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "engines": {
     "node": ">=20"

package/scripts/setup.sh

@@ -0,0 +1,130 @@
+#!/bin/sh
+# User installation/update entry point. Requires Node.js 20+ and npm.
+set -eu
+mode=install
+case "$(basename "$0")" in agent_room-update) mode=update ;; esac
+while [ "$#" -gt 0 ]; do
+ case "$1" in
+  --update) mode=update ;; --check) mode=check ;; --rollback) mode=rollback ;;
+  --help) echo 'Usage: sh setup.sh [--update | --check | --rollback]'; exit 0 ;;
+  *) echo "Unknown option: $1" >&2; exit 2 ;;
+ esac
+ shift
+done
+case "$(uname -s)/$(uname -m)" in
+ Linux/x86_64|Linux/amd64|Linux/aarch64|Linux/arm64|Darwin/x86_64|Darwin/arm64) ;;
+ *) echo 'Supported systems: macOS/Linux x64/arm64' >&2; exit 1 ;;
+esac
+command -v node >/dev/null 2>&1 && command -v npm >/dev/null 2>&1 || { echo 'Install Node.js 20+ and npm first.' >&2; exit 1; }
+node -e 'if (+process.versions.node.split(".")[0] < 20) process.exit(1)' || { echo 'Node.js 20+ is required.' >&2; exit 1; }
+install_root="$HOME/.local/share/agent_room/npm"
+user_bin="$HOME/.local/bin"
+registry=https://registry.npmjs.org/
+current="$install_root/current"
+if [ -f "$current/node_modules/menmu-agent-room/package.json" ]; then active_root=$current; else active_root=$install_root; fi
+installed=$(node -e 'try {console.log(require(process.argv[1]).version)} catch {console.log("none")}' "$active_root/node_modules/menmu-agent-room/package.json")
+active_command=$(command -v agent_room || true)
+printf 'Current command: %s\nManaged installation: %s\n' "${active_command:-not on PATH}" "$installed"
+if [ "$mode" = install ] && [ "$installed" = none ] && [ -n "$active_command" ]; then
+ echo 'An existing installation was detected. Setup will add a user-managed installation and preserve the other package.'
+fi
+if [ "$mode" != check ]; then
+ # Preserve unknown executables. Recognize our wrapper and npm launcher only.
+ for entry in agent_room agent_room-update; do
+ if [ -e "$user_bin/$entry" ] || [ -L "$user_bin/$entry" ]; then
+  node -e 'const fs=require("fs");const p=process.argv[1];let s;try{if(fs.statSync(p).size>1048576)process.exit(1);s=fs.readFileSync(p,"utf8")}catch{process.exit(1)};if(!s.includes(".local/share/agent_room/npm") && !(s.includes("binaryPath") && s.includes("verifyBinary")))process.exit(1)' "$user_bin/$entry" || {
+   echo "Unknown executable at $user_bin/$entry; move it to a backup path before installing. Nothing was replaced." >&2; exit 1;
+  }
+ fi
+ done
+fi
+if [ "$mode" != rollback ]; then
+ latest=$(npm view menmu-agent-room dist-tags.latest --registry="$registry" --prefer-online --fetch-retries=1 --fetch-timeout=15000) || {
+  echo 'Cannot check the official npm registry. Check your network; existing installation is unchanged.' >&2; exit 1;
+ }
+ node -e 'if(!/^\d+\.\d+\.\d+$/.test(process.argv[1]))process.exit(1)' "$latest" || { echo 'Invalid stable registry version.' >&2; exit 1; }
+ printf 'Latest: %s\n' "$latest"
+fi
+if [ "$mode" = check ]; then exit 0; fi
+if [ "$mode" != install ] && [ "$installed" = none ]; then echo 'Run setup first to configure a managed installation.' >&2; exit 1; fi
+mkdir -p "$install_root" "$user_bin"
+lock="$install_root/.update-lock"
+if ! mkdir "$lock" 2>/dev/null; then echo "Another update is in progress. If it was interrupted, verify no updater is running before removing $lock." >&2; exit 1; fi
+stage=''
+cleanup() { if [ -n "$stage" ]; then rm -rf "$stage"; fi; rmdir "$lock"; }
+trap cleanup EXIT
+trap 'exit 130' INT
+trap 'exit 143' TERM HUP
+# Atomic symlink replacement, including macOS where mv follows directory symlinks.
+switch_to() {
+ node -e 'const fs=require("fs"),path=require("path");const [root,target]=process.argv.slice(1);const tmp=path.join(root,".pointer-"+process.pid);try{fs.symlinkSync(target,tmp);fs.renameSync(tmp,path.join(root,"current"))}finally{try{fs.unlinkSync(tmp)}catch{}}' "$install_root" "$1"
+}
+if [ "$mode" = rollback ]; then
+ [ -L "$install_root/previous" ] || { echo 'No previous managed installation is available.' >&2; exit 1; }
+ previous=$(node -e 'console.log(require("fs").realpathSync(process.argv[1]))' "$install_root/previous")
+ node "$previous/node_modules/menmu-agent-room/bin/agent_room.cjs" help >/dev/null
+ switch_to "$previous"
+ echo 'Previous version restored. Restart your local clients to use it.'
+ exit 0
+fi
+if [ "$installed" != "$latest" ]; then
+ if [ "$installed" != none ]; then
+  node -e 'const a=process.argv[1].split(".").map(Number),b=process.argv[2].split(".").map(Number);for(let i=0;i<3;i++){if(a[i]>b[i])process.exit(1);if(a[i]<b[i])break}' "$installed" "$latest" || { echo 'Installed version is newer; no downgrade performed.'; exit 0; }
+ fi
+ mkdir -p "$install_root/releases"
+ stage=$(mktemp -d "$install_root/releases/.stage-XXXXXX")
+ npm install --prefix "$stage" --registry="$registry" --ignore-scripts --no-audit --no-fund --fetch-retries=1 --fetch-timeout=30000 "menmu-agent-room@$latest"
+ # The npm launcher validates the native checksum before starting help.
+ node "$stage/node_modules/menmu-agent-room/bin/agent_room.cjs" help >/dev/null
+ node -e 'if(require(process.argv[1]).version!==process.argv[2])process.exit(1)' "$stage/node_modules/menmu-agent-room/package.json" "$latest"
+ if [ "${latest%%.*}" -ge 1 ]; then
+  node "$stage/node_modules/menmu-agent-room/bin/agent_room.cjs" --version --json > "$stage/version.json"
+  node -e 'if(require(process.argv[1]).version!==process.argv[2])process.exit(1)' "$stage/version.json" "$latest"
+ fi
+ # Keep the prior entry for explicit rollback. Never remove a running version.
+ if [ "$installed" != none ]; then
+  old_root=$(node -e 'console.log(require("fs").realpathSync(process.argv[1]))' "$active_root")
+  node -e 'const fs=require("fs"),p=require("path");const [root,target]=process.argv.slice(1),tmp=p.join(root,".previous-"+process.pid);try{fs.symlinkSync(target,tmp);fs.renameSync(tmp,p.join(root,"previous"))}finally{try{fs.unlinkSync(tmp)}catch{}}' "$install_root" "$old_root"
+ fi
+ release="$install_root/releases/$latest-$(basename "$stage" | cut -c8-)"
+ mv "$stage" "$release"
+ stage=''
+ switch_to "$release"
+fi
+# This wrapper reads current at startup. 0.1.3 legacy installs remain a fallback.
+stage=$(mktemp -d "$user_bin/.agent-room-setup.XXXXXX")
+cat > "$stage/agent_room" <<'WRAPPER'
+#!/bin/sh
+root="$HOME/.local/share/agent_room/npm"
+if [ -f "$root/current/node_modules/menmu-agent-room/bin/agent_room.cjs" ]; then root="$root/current"; fi
+exec node "$root/node_modules/menmu-agent-room/bin/agent_room.cjs" "$@"
+WRAPPER
+# Prefer the newly installed updater so future bug fixes take effect too.
+updater="$install_root/current/node_modules/menmu-agent-room/scripts/setup.sh"
+if [ -f "$updater" ] && grep -Fq .update-lock "$updater"; then cp "$updater" "$stage/agent_room-update"; else cp "$0" "$stage/agent_room-update"; fi
+chmod 755 "$stage/agent_room" "$stage/agent_room-update"
+mv -f "$stage/agent_room" "$user_bin/agent_room"
+mv -f "$stage/agent_room-update" "$user_bin/agent_room-update"
+if [ "$mode" = install ]; then
+ zsh_root=${ZDOTDIR:-$HOME};mkdir -p "$zsh_root"
+ bash_login="$HOME/.profile"
+ if [ -f "$HOME/.bash_profile" ]; then bash_login="$HOME/.bash_profile"; elif [ -f "$HOME/.bash_login" ]; then bash_login="$HOME/.bash_login"; fi
+ for rc in "$bash_login" "$HOME/.bashrc" "$zsh_root/.zprofile" "$zsh_root/.zshrc"; do
+  if ! test -f "$rc" || ! grep -Fq '# agent_room user PATH' "$rc"; then
+   cat >> "$rc" <<'PROFILE'
+
+# agent_room user PATH
+case ":$PATH:" in
+ *":$HOME/.local/bin:"*) ;;
+ *) export PATH="$HOME/.local/bin:$PATH" ;;
+esac
+PROFILE
+  fi
+ done
+fi
+printf '\nInstalled managed version: %s\nCommand: %s/agent_room\n' "$latest" "$user_bin"
+echo 'Restart running answers/join/dashboard clients to use this version; do not restart the host for a client-only UI update.'
+echo 'For this terminal: export PATH="$HOME/.local/bin:$PATH"'
+echo 'Verify: command -v agent_room; agent_room --version; agent_room doctor'
+echo 'Open your rooms: agent_room dashboard'
+echo 'Check: agent_room-update --check | Upgrade: agent_room-update | Restore: agent_room-update --rollback'