agent-relay-server 0.10.18 → 0.10.19

package/README.md

@@ -261,6 +261,11 @@ agent-relay setup --yes
 agent-relay daemon install --binary "$(command -v agent-relay)" --enable --start --yes
 ```
 
+Global installs create a user-level fallback shim at `~/.local/bin/agent-relay`
+when the package manager's bin directory is not reliably visible. If a new shell
+still cannot find `agent-relay`, add `~/.local/bin` and your Bun bin directory to
+`PATH`.
+
 `setup` creates a managed env file with a generated token, loopback bind, and a
 durable SQLite path. `daemon install` auto-detects systemd (Linux) and
 LaunchAgents (macOS).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-server",
-  "version": "0.10.18",
+  "version": "0.10.19",
   "description": "Lightweight HTTP message relay for inter-agent communication across machines",
   "module": "src/index.ts",
   "type": "module",
@@ -20,6 +20,7 @@
     "!src/**/*.test.ts",
     "examples/**",
     "recipes/**",
+    "scripts/install-bin-shim.cjs",
     "scripts/orchestrator-spawn-smoke.ts",
     "runner/src/config.ts",
     "runner/src/adapter.ts",
@@ -33,6 +34,7 @@
     "agent-relay-sdk": "0.2.0"
   },
   "scripts": {
+    "postinstall": "node scripts/install-bin-shim.cjs",
     "start": "bun run src/index.ts",
     "dev": "bun --watch run src/index.ts",
     "dev:dashboard": "cd dashboard && npx vite",

package/scripts/install-bin-shim.cjs

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+const { existsSync, lstatSync, mkdirSync, readFileSync, writeFileSync, chmodSync } = require("node:fs");
+const { homedir } = require("node:os");
+const { delimiter, join, relative } = require("node:path");
+
+const MARKER = "agent-relay managed user shim";
+
+function shellQuote(value) {
+  return `'${String(value).replace(/'/g, `'\\''`)}'`;
+}
+
+function truthy(value) {
+  return value === "1" || value === "true" || value === "yes";
+}
+
+function packageLooksGlobal(packageRoot) {
+  const normalized = packageRoot.replace(/\\/g, "/");
+  return normalized.includes("/lib/node_modules/agent-relay-server") ||
+    normalized.includes("/.bun/install/global/node_modules/agent-relay-server") ||
+    normalized.includes("/.bun/install/global/agent-relay-server");
+}
+
+function shouldInstallShim(env, packageRoot) {
+  if (truthy(env.AGENT_RELAY_SKIP_BIN_SHIM) || env.AGENT_RELAY_INSTALL_USER_BIN === "0") return false;
+  if (truthy(env.AGENT_RELAY_INSTALL_USER_BIN)) return true;
+  if (env.npm_config_global === "true") return true;
+  return packageLooksGlobal(packageRoot);
+}
+
+function pathContains(dir, env) {
+  return String(env.PATH || "").split(delimiter).some((entry) => entry === dir);
+}
+
+function chooseBinDir(env, home) {
+  if (env.AGENT_RELAY_USER_BIN_DIR) return env.AGENT_RELAY_USER_BIN_DIR;
+  const localBin = join(home, ".local", "bin");
+  const bunBin = join(home, ".bun", "bin");
+  if (pathContains(localBin, env)) return localBin;
+  if (pathContains(bunBin, env)) return bunBin;
+  return localBin;
+}
+
+function canOverwriteShim(path) {
+  if (!existsSync(path)) return true;
+  const stat = lstatSync(path);
+  if (stat.isSymbolicLink()) return true;
+  if (!stat.isFile()) return false;
+  return readFileSync(path, "utf8").includes(MARKER);
+}
+
+function renderShim(cliPath) {
+  return [
+    "#!/usr/bin/env sh",
+    `# ${MARKER}`,
+    `CLI=${shellQuote(cliPath)}`,
+    "if command -v bun >/dev/null 2>&1; then",
+    '  exec bun "$CLI" "$@"',
+    "fi",
+    'if [ -n "$HOME" ] && [ -x "$HOME/.bun/bin/bun" ]; then',
+    '  exec "$HOME/.bun/bin/bun" "$CLI" "$@"',
+    "fi",
+    'echo "agent-relay: Bun is required but was not found on PATH or at $HOME/.bun/bin/bun" >&2',
+    "exit 127",
+    "",
+  ].join("\n");
+}
+
+function installShim(env = process.env) {
+  const packageRoot = join(__dirname, "..");
+  if (!shouldInstallShim(env, packageRoot)) return { installed: false, skipped: "not-global" };
+
+  const home = env.HOME || homedir();
+  if (!home) return { installed: false, skipped: "no-home" };
+
+  const binDir = chooseBinDir(env, home);
+  const shimPath = join(binDir, "agent-relay");
+  const cliPath = join(packageRoot, "src", "index.ts");
+
+  if (!canOverwriteShim(shimPath)) {
+    console.warn(`[agent-relay] Not overwriting existing ${shimPath}; set AGENT_RELAY_USER_BIN_DIR to choose another shim location.`);
+    return { installed: false, skipped: "exists", path: shimPath };
+  }
+
+  mkdirSync(binDir, { recursive: true });
+  writeFileSync(shimPath, renderShim(cliPath), "utf8");
+  chmodSync(shimPath, 0o755);
+
+  if (!pathContains(binDir, env)) {
+    const display = relative(home, binDir).startsWith("..") ? binDir : `~/${relative(home, binDir)}`;
+    console.warn(`[agent-relay] Installed ${shimPath}. Add ${display} to PATH to run agent-relay from a new shell.`);
+  }
+
+  return { installed: true, path: shimPath };
+}
+
+if (require.main === module) {
+  try {
+    installShim();
+  } catch (error) {
+    console.warn(`[agent-relay] Could not install user PATH shim: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+
+module.exports = { installShim, renderShim, shouldInstallShim };