multi-agent-collaboration-mcp 0.12.0

package/scripts/refresh-mcp.sh

@@ -0,0 +1,228 @@
+#!/usr/bin/env bash
+# Re-register the freshly built agent-chat MCP server with supported AI CLIs.
+# The npm script runs the build first; this file also validates the artifact so
+# invoking it directly fails clearly instead of installing a broken command.
+set -uo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+SERVER_PATH="$ROOT_DIR/dist/index.js"
+MCP_NAME="${AGENT_CHAT_MCP_NAME:-agent-chat}"
+NODE_BIN="${AGENT_CHAT_NODE_BIN:-${npm_node_execpath:-}}"
+FORCE_REREGISTER="${AGENT_CHAT_FORCE_REREGISTER:-0}"
+
+if [[ -z "$NODE_BIN" ]]; then
+  NODE_BIN="$(command -v node || true)"
+fi
+
+if [[ -z "$MCP_NAME" ]]; then
+  echo "refresh-mcp: AGENT_CHAT_MCP_NAME cannot be empty" >&2
+  exit 2
+fi
+if [[ -z "$NODE_BIN" || ! -x "$NODE_BIN" ]]; then
+  echo "refresh-mcp: Node.js was not found; install Node 22+ or set AGENT_CHAT_NODE_BIN" >&2
+  exit 2
+fi
+if [[ "$FORCE_REREGISTER" != "0" && "$FORCE_REREGISTER" != "1" ]]; then
+  echo "refresh-mcp: AGENT_CHAT_FORCE_REREGISTER must be 0 or 1" >&2
+  exit 2
+fi
+if [[ ! -f "$SERVER_PATH" ]]; then
+  echo "refresh-mcp: $SERVER_PATH not found; run 'npm run build' first" >&2
+  exit 2
+fi
+
+node_major="$("$NODE_BIN" -p 'Number(process.versions.node.split(".")[0])' 2>/dev/null || true)"
+if [[ ! "$node_major" =~ ^[0-9]+$ || "$node_major" -lt 22 ]]; then
+  echo "refresh-mcp: Node 22+ is required (found: $("$NODE_BIN" --version 2>/dev/null || echo unknown))" >&2
+  exit 2
+fi
+
+refreshed=0
+failed=0
+skipped=0
+
+remove_registration() {
+  local label=$1
+  shift
+  echo "[$label] removing existing '$MCP_NAME' registration..."
+  if ! "$@"; then
+    # Claude exits nonzero when the name is absent. Continue because add is the
+    # authoritative step and will still expose permission/configuration errors.
+    echo "[$label] no removable user registration found; continuing" >&2
+  fi
+}
+
+add_registration() {
+  local label=$1
+  shift
+  echo "[$label] adding '$MCP_NAME' -> $NODE_BIN $SERVER_PATH"
+  if "$@"; then
+    refreshed=$((refreshed + 1))
+  else
+    echo "[$label] failed to add '$MCP_NAME'" >&2
+    failed=$((failed + 1))
+  fi
+}
+
+# Both supported CLIs print one command and one args line for stdio servers.
+# Parse those fields and require exact values: a substring check accepts stale
+# targets such as dist/index.js.old or an unrelated extra argument that merely
+# mentions this checkout. Unknown future output formats fail closed and can be
+# replaced explicitly with AGENT_CHAT_FORCE_REREGISTER=1.
+registration_targets_checkout() {
+  local registration=$1
+  local line
+  local registered_command=""
+  local registered_args=""
+  while IFS= read -r line; do
+    line="${line#"${line%%[![:space:]]*}"}"
+    case "$line" in
+      command:\ *) registered_command="${line#command: }" ;;
+      Command:\ *) registered_command="${line#Command: }" ;;
+      args:\ *) registered_args="${line#args: }" ;;
+      Args:\ *) registered_args="${line#Args: }" ;;
+    esac
+  done <<< "$registration"
+  [[ "$registered_command" == "$NODE_BIN" && "$registered_args" == "$SERVER_PATH" ]]
+}
+
+if command -v codex >/dev/null 2>&1; then
+  if [[ "$FORCE_REREGISTER" == "0" ]] &&
+     codex_registration="$(codex mcp get "$MCP_NAME" 2>/dev/null)"; then
+    if registration_targets_checkout "$codex_registration"; then
+      echo "[Codex] existing '$MCP_NAME' registration already targets this checkout; build refreshed in place"
+      refreshed=$((refreshed + 1))
+    else
+      echo "[Codex] existing '$MCP_NAME' registration does not point at $SERVER_PATH; left unchanged. Set AGENT_CHAT_FORCE_REREGISTER=1 to replace it." >&2
+      failed=$((failed + 1))
+    fi
+  else
+    remove_registration "Codex" codex mcp remove "$MCP_NAME"
+    add_registration "Codex" \
+      codex mcp add "$MCP_NAME" -- "$NODE_BIN" "$SERVER_PATH"
+  fi
+else
+  echo "[Codex] skipped: 'codex' is not installed" >&2
+  skipped=$((skipped + 1))
+fi
+
+# Antigravity (agy) has no MCP-management CLI. It discovers global servers in
+# ~/.gemini/config/mcp_config.json, which is separate from Gemini CLI's user
+# settings. Update that JSON atomically and preserve every unrelated field and
+# server. AGENT_CHAT_AGY_CONFIG provides an isolated path for tests.
+if command -v agy >/dev/null 2>&1; then
+  if [[ -n "${AGENT_CHAT_AGY_CONFIG:-}" ]]; then
+    AGY_CONFIG="$AGENT_CHAT_AGY_CONFIG"
+  elif [[ -n "${HOME:-}" ]]; then
+    AGY_CONFIG="$HOME/.gemini/config/mcp_config.json"
+  else
+    AGY_CONFIG=""
+  fi
+  if [[ -z "$AGY_CONFIG" ]]; then
+    echo "[Antigravity/agy] failed: HOME is unset; set AGENT_CHAT_AGY_CONFIG" >&2
+    failed=$((failed + 1))
+  elif [[ "$AGY_CONFIG" != /* ]]; then
+    echo "[Antigravity/agy] failed: config path must be absolute: $AGY_CONFIG" >&2
+    failed=$((failed + 1))
+  else
+    echo "[Antigravity/agy] refreshing '$MCP_NAME' in $AGY_CONFIG"
+    if "$NODE_BIN" - "$AGY_CONFIG" "$MCP_NAME" "$NODE_BIN" "$SERVER_PATH" <<'NODE'
+const fs = require("node:fs");
+const pathModule = require("node:path");
+
+const [requestedPath, name, command, serverPath] = process.argv.slice(2);
+const exists = fs.existsSync(requestedPath);
+const configPath =
+  exists && fs.lstatSync(requestedPath).isSymbolicLink()
+    ? fs.realpathSync(requestedPath)
+    : requestedPath;
+
+let config = {};
+if (exists) {
+  const source = fs.readFileSync(configPath, "utf8");
+  config = source.trim().length === 0 ? {} : JSON.parse(source);
+}
+if (config === null || typeof config !== "object" || Array.isArray(config)) {
+  throw new Error(`${configPath} must contain a JSON object`);
+}
+if (config.mcpServers === undefined) config.mcpServers = {};
+if (
+  config.mcpServers === null ||
+  typeof config.mcpServers !== "object" ||
+  Array.isArray(config.mcpServers)
+) {
+  throw new Error(`${configPath}: mcpServers must be a JSON object`);
+}
+
+// Preserve target-specific environment, timeout, and tool-filter fields. A
+// refresh changes only the executable pair; deleting/recreating this object
+// silently discarded user configuration.
+const prior = config.mcpServers[name];
+const retained =
+  prior !== null && typeof prior === "object" && !Array.isArray(prior)
+    ? prior
+    : {};
+config.mcpServers[name] = { ...retained, command, args: [serverPath] };
+
+const dir = pathModule.dirname(configPath);
+fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+const mode = exists ? fs.statSync(configPath).mode & 0o777 : 0o600;
+const tempPath = `${configPath}.tmp-${process.pid}-${Date.now()}`;
+try {
+  fs.writeFileSync(tempPath, `${JSON.stringify(config, null, 2)}\n`, {
+    encoding: "utf8",
+    mode,
+  });
+  fs.chmodSync(tempPath, mode);
+  fs.renameSync(tempPath, configPath);
+} catch (error) {
+  try {
+    fs.unlinkSync(tempPath);
+  } catch {}
+  throw error;
+}
+NODE
+    then
+      refreshed=$((refreshed + 1))
+    else
+      echo "[Antigravity/agy] failed to refresh '$MCP_NAME'" >&2
+      failed=$((failed + 1))
+    fi
+  fi
+else
+  echo "[Antigravity/agy] skipped: 'agy' is not installed" >&2
+  skipped=$((skipped + 1))
+fi
+
+if command -v claude >/dev/null 2>&1; then
+  if [[ "$FORCE_REREGISTER" == "0" ]] &&
+     claude_registration="$(claude mcp get "$MCP_NAME" 2>/dev/null)"; then
+    if registration_targets_checkout "$claude_registration"; then
+      echo "[Claude] existing '$MCP_NAME' registration already targets this checkout; build refreshed in place"
+      refreshed=$((refreshed + 1))
+    else
+      echo "[Claude] existing '$MCP_NAME' registration does not point at $SERVER_PATH; left unchanged. Set AGENT_CHAT_FORCE_REREGISTER=1 to replace it." >&2
+      failed=$((failed + 1))
+    fi
+  else
+    remove_registration "Claude" \
+      claude mcp remove --scope user "$MCP_NAME"
+    add_registration "Claude" \
+      claude mcp add --scope user --transport stdio \
+        "$MCP_NAME" -- "$NODE_BIN" "$SERVER_PATH"
+  fi
+else
+  echo "[Claude] skipped: 'claude' is not installed" >&2
+  skipped=$((skipped + 1))
+fi
+
+echo
+echo "MCP refresh complete: $refreshed refreshed, $skipped skipped, $failed failed."
+echo "Restart or reconnect already-running CLI sessions so they spawn the new server build."
+
+if [[ "$failed" -gt 0 ]]; then
+  exit 1
+fi
+if [[ "$refreshed" -eq 0 ]]; then
+  exit 2
+fi

package/scripts/stamp-build.mjs

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+// Stamp the deployed build's identity into dist/build-info.json after tsc, so the
+// server_info tool can report the exact commit that produced the running binary.
+// Done at build time, not runtime: a runtime `git rev-parse` would report the
+// source HEAD, which masks the "edited source, forgot to rebuild" skew this exists
+// to surface. dist/build-info.json is gitignored (dist/ is not tracked).
+import { execFileSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import { lstatSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join, relative } from "node:path";
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..");
+const pkg = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+
+let commit = "unknown";
+try {
+  commit = execFileSync("git", ["rev-parse", "--short", "HEAD"], {
+    cwd: root,
+    encoding: "utf8",
+    timeout: 10_000,
+  }).trim();
+  const dirty =
+    execFileSync("git", ["status", "--porcelain"], {
+      cwd: root,
+      encoding: "utf8",
+      timeout: 10_000,
+    }).trim().length > 0;
+  if (dirty) commit += "-dirty"; // built from an uncommitted tree
+} catch {
+  // Not a git checkout (e.g. dist copied without .git); leave "unknown".
+}
+
+// A timestamp alone makes every no-change rebuild tell already-running MCP
+// processes they are stale. Hash the executable JS instead: reconnect only
+// when the deployed behavior actually differs. Keep the timestamp for human
+// diagnostics and as a compatibility fallback for stamps made by old builds.
+const dist = join(root, "dist");
+const files = [];
+const walk = (dir) => {
+  for (const name of readdirSync(dir)) {
+    const path = join(dir, name);
+    const stat = lstatSync(path);
+    // dist is generated output. Never follow a stray symlink during a build:
+    // a loop or a link to a large tree could turn stamping into an unbounded
+    // traversal, and the linked bytes are not part of the packaged artifact.
+    if (stat.isSymbolicLink()) continue;
+    if (stat.isDirectory()) walk(path);
+    else if (name.endsWith(".js")) files.push(path);
+  }
+};
+walk(dist);
+// Code-unit comparison is deterministic across LANG/LC_ALL. localeCompare
+// made identical artifacts hash differently under locales such as cs_CZ.
+files.sort((a, b) => {
+  const ar = relative(root, a);
+  const br = relative(root, b);
+  return ar < br ? -1 : ar > br ? 1 : 0;
+});
+const hash = createHash("sha256");
+const runtimeDependencies = Object.keys(pkg.dependencies ?? {})
+  .sort()
+  .map((name) => {
+    try {
+      const installed = JSON.parse(
+        readFileSync(join(root, "node_modules", name, "package.json"), "utf8"),
+      );
+      return [name, installed.version];
+    } catch {
+      // A normal build has dependencies installed. Keep the declared range in
+      // the identity if a nonstandard packager compiles without node_modules.
+      return [name, pkg.dependencies[name]];
+    }
+  });
+hash.update(
+  JSON.stringify({ version: pkg.version, dependencies: runtimeDependencies }),
+);
+hash.update("\0");
+for (const path of files) {
+  hash.update(relative(root, path));
+  hash.update("\0");
+  hash.update(readFileSync(path));
+  hash.update("\0");
+}
+
+const info = {
+  version: pkg.version,
+  commit,
+  built_at: new Date().toISOString(),
+  artifact_hash: hash.digest("hex"),
+};
+writeFileSync(join(root, "dist", "build-info.json"), JSON.stringify(info) + "\n");
+console.log("stamped dist/build-info.json:", JSON.stringify(info));

package/scripts/wait-for-updates.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# Compatibility entry point for old poller commands. It replaces itself with
+# the single-process Node watcher; there is no shell polling loop or child.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+POLLER="$SCRIPT_DIR/../dist/poller.js"
+node_bin=node
+args=()
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --node)
+      [[ $# -ge 2 ]] || { echo "wait-for-updates: --node needs a value" >&2; exit 2; }
+      node_bin="$2"
+      shift 2
+      ;;
+    --node=*)
+      node_bin="${1#*=}"
+      shift
+      ;;
+    *)
+      args+=("$1")
+      shift
+      ;;
+  esac
+done
+
+[[ -n "$node_bin" ]] || { echo "wait-for-updates: empty Node executable" >&2; exit 2; }
+command -v "$node_bin" >/dev/null 2>&1 || {
+  echo "wait-for-updates: Node executable not found: $node_bin" >&2
+  exit 2
+}
+[[ -f "$POLLER" ]] || { echo "wait-for-updates: $POLLER not found; run 'npm run build'" >&2; exit 2; }
+if [[ ${#args[@]} -eq 0 ]]; then
+  exec "$node_bin" "$POLLER"
+else
+  exec "$node_bin" "$POLLER" "${args[@]}"
+fi