agent-relay 2.1.10 → 2.1.11

package/dist/index.cjs

@@ -3156,13 +3156,13 @@ var init_logger = __esm({
 });
 
 // packages/config/dist/bridge-utils.js
-var import_node_child_process9, import_node_util3, execAsync2;
+var import_node_child_process10, import_node_util3, execAsync2;
 var init_bridge_utils = __esm({
   "packages/config/dist/bridge-utils.js"() {
     "use strict";
-    import_node_child_process9 = require("node:child_process");
+    import_node_child_process10 = require("node:child_process");
     import_node_util3 = require("node:util");
-    execAsync2 = (0, import_node_util3.promisify)(import_node_child_process9.exec);
+    execAsync2 = (0, import_node_util3.promisify)(import_node_child_process10.exec);
   }
 });
 
@@ -43148,6 +43148,7 @@ var import_node_net3 = require("node:net");
 var import_node_crypto9 = require("node:crypto");
 var import_node_path11 = require("node:path");
 var import_node_os6 = require("node:os");
+var import_node_child_process4 = require("node:child_process");
 var import_node_fs8 = require("node:fs");
 var import_node_url2 = require("node:url");
 
@@ -43502,9 +43503,9 @@ var AgentHealthMonitor = class extends import_events.EventEmitter {
    * Get memory and CPU usage for a process
    */
   async getProcessUsage(pid) {
-    const { execSync: execSync10 } = await import("child_process");
+    const { execSync: execSync12 } = await import("child_process");
     try {
-      const output = execSync10(`ps -o rss=,pcpu= -p ${pid}`, { encoding: "utf8" }).trim();
+      const output = execSync12(`ps -o rss=,pcpu= -p ${pid}`, { encoding: "utf8" }).trim();
       const [rss, cpu] = output.split(/\s+/);
       return {
         memory: parseInt(rss, 10) * 1024,
@@ -46429,7 +46430,7 @@ var ACTIVITY_VERIFICATION = {
 function hashWorkspaceId(workspaceId) {
   return (0, import_node_crypto9.createHash)("sha256").update(workspaceId).digest("hex").slice(0, 12);
 }
-var RelayPtyOrchestrator = class extends BaseWrapper {
+var RelayPtyOrchestrator = class _RelayPtyOrchestrator extends BaseWrapper {
   config;
   // Process management
   relayPtyProcess;
@@ -46493,6 +46494,42 @@ var RelayPtyOrchestrator = class extends BaseWrapper {
   cgroupManager;
   hasCgroupSetup = false;
   // Note: sessionEndProcessed and lastSummaryRawContent are inherited from BaseWrapper
+  /**
+   * Gather system diagnostics for debugging SIGKILL/unexpected exits.
+   * Returns a formatted string with memory, process, and system info.
+   */
+  static gatherSigkillDiagnostics(agentName, pid) {
+    const lines = [];
+    try {
+      const free = (0, import_node_os6.freemem)();
+      const total = (0, import_node_os6.totalmem)();
+      const usedPercent = Math.round((1 - free / total) * 100);
+      lines.push(`Memory: ${Math.round(free / 1024 / 1024)}MB free / ${Math.round(total / 1024 / 1024)}MB total (${usedPercent}% used)`);
+      try {
+        const psOutput = (0, import_node_child_process4.execSync)("ps aux | grep -c relay-pty || echo 0", { encoding: "utf-8", timeout: 1e3 }).trim();
+        lines.push(`relay-pty processes: ${psOutput}`);
+      } catch {
+      }
+      try {
+        const dmesgOutput = (0, import_node_child_process4.execSync)('dmesg -T 2>/dev/null | grep -i "killed process" | tail -3 || true', {
+          encoding: "utf-8",
+          timeout: 1e3
+        }).trim();
+        if (dmesgOutput) {
+          lines.push(`Recent OOM kills: ${dmesgOutput.replace(/\n/g, " | ")}`);
+        }
+      } catch {
+      }
+      if (pid) {
+        lines.push(`Killed process PID: ${pid}`);
+      }
+      lines.push(`Agent name: ${agentName}`);
+      lines.push(`Timestamp: ${(/* @__PURE__ */ new Date()).toISOString()}`);
+    } catch (err) {
+      lines.push(`Diagnostics error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return lines.join("\n  ");
+  }
   constructor(config2) {
     super(config2);
     this.config = config2;
@@ -46708,6 +46745,11 @@ var RelayPtyOrchestrator = class extends BaseWrapper {
     if (!binaryPath) {
       throw new Error("relay-pty binary not found. Build with: cd relay-pty && cargo build --release");
     }
+    try {
+      (0, import_node_fs8.accessSync)(binaryPath, import_node_fs8.constants.X_OK);
+    } catch (err) {
+      throw new Error(`relay-pty binary not executable at ${binaryPath}: ${err?.message ?? "permission denied"}. Build with: cd relay-pty && cargo build --release, or ensure the binary has execute permissions.`);
+    }
     this.log(` Using binary: ${binaryPath}`);
     await this.spawnRelayPty(binaryPath);
     await this.connectToSocket();
@@ -46897,6 +46939,13 @@ var RelayPtyOrchestrator = class extends BaseWrapper {
       if (!this.socketConnected) {
         this.earlyExitInfo = { code, signal, stderr: stderrBuffer };
       }
+      if (signal === "SIGKILL" || exitCode === 137) {
+        const diagnostics = _RelayPtyOrchestrator.gatherSigkillDiagnostics(this.config.name, proc.pid);
+        this.logError(` SIGKILL DETECTED - gathering diagnostics:
+  ${diagnostics}`);
+        console.error(`[relay-pty-orchestrator] SIGKILL for ${this.config.name}:
+  ${diagnostics}`);
+      }
       this.running = false;
       const crashContext = this.memoryMonitor.getCrashContext(this.config.name);
       this.memoryMonitor.unregister(this.config.name);
@@ -47318,7 +47367,10 @@ ${line}
           const exitReason = exitInfo.signal ? `signal ${exitInfo.signal}` : `code ${exitInfo.code ?? "unknown"}`;
           const stderrHint = exitInfo.stderr ? `
   stderr: ${exitInfo.stderr.trim().slice(0, 500)}` : "";
-          throw new Error(`relay-pty process died early (${exitReason}).${stderrHint}`);
+          const diagnostics = exitInfo.signal === "SIGKILL" || exitInfo.code === 137 ? `
+  Diagnostics (SIGKILL often indicates OOM or resource limits):
+  ${_RelayPtyOrchestrator.gatherSigkillDiagnostics(this.config.name, this.relayPtyProcess?.pid)}` : "";
+          throw new Error(`relay-pty process died early (${exitReason}).${stderrHint}${diagnostics}`);
         }
         throw new Error("relay-pty process died before socket could be created");
       }
@@ -47338,7 +47390,10 @@ ${line}
       const exitReason = exitInfo.signal ? `signal ${exitInfo.signal}` : `code ${exitInfo.code ?? "unknown"}`;
       const stderrHint = exitInfo.stderr ? `
   stderr: ${exitInfo.stderr.trim().slice(0, 500)}` : "";
-      throw new Error(`relay-pty process died during socket connection (${exitReason}).${stderrHint}`);
+      const diagnostics = exitInfo.signal === "SIGKILL" || exitInfo.code === 137 ? `
+  Diagnostics (SIGKILL often indicates OOM or resource limits):
+  ${_RelayPtyOrchestrator.gatherSigkillDiagnostics(this.config.name, this.relayPtyProcess?.pid)}` : "";
+      throw new Error(`relay-pty process died during socket connection (${exitReason}).${stderrHint}${diagnostics}`);
     }
     throw new Error(`Failed to connect to socket after ${maxAttempts} attempts`);
   }
@@ -48611,7 +48666,7 @@ var OpenCodeApi = class {
 var openCodeApi = new OpenCodeApi();
 
 // packages/wrapper/dist/opencode-wrapper.js
-var import_node_child_process4 = require("node:child_process");
+var import_node_child_process5 = require("node:child_process");
 var TASK_INJECTION = {
   /** Maximum retries when injection fails */
   MAX_RETRIES: 3,
@@ -48719,7 +48774,7 @@ var OpenCodeWrapper = class extends BaseWrapper {
     this.running = true;
     await this.client.connect();
     const args = this.config.args ?? [];
-    this.process = (0, import_node_child_process4.spawn)(this.config.command, args, {
+    this.process = (0, import_node_child_process5.spawn)(this.config.command, args, {
       cwd: this.config.cwd,
       env: { ...process.env, ...this.config.env },
       stdio: ["pipe", "pipe", "pipe"]
@@ -48797,7 +48852,7 @@ var OpenCodeWrapper = class extends BaseWrapper {
    */
   async startServe() {
     console.log("[OpenCodeWrapper] Auto-starting opencode serve...");
-    this.serveProcess = (0, import_node_child_process4.spawn)("opencode", ["serve"], {
+    this.serveProcess = (0, import_node_child_process5.spawn)("opencode", ["serve"], {
       cwd: this.config.cwd,
       env: { ...process.env, ...this.config.env },
       stdio: "ignore",
@@ -55295,26 +55350,26 @@ var Router = class _Router {
 };
 
 // packages/bridge/dist/utils.js
-var import_node_child_process5 = require("node:child_process");
+var import_node_child_process6 = require("node:child_process");
 var import_node_util = require("node:util");
-var execAsync = (0, import_node_util.promisify)(import_node_child_process5.exec);
+var execAsync = (0, import_node_util.promisify)(import_node_child_process6.exec);
 function sleep2(ms) {
   return new Promise((resolve5) => setTimeout(resolve5, ms));
 }
 
 // packages/bridge/dist/shadow-cli.js
-var import_node_child_process7 = require("node:child_process");
+var import_node_child_process8 = require("node:child_process");
 var import_node_util2 = require("node:util");
 
 // packages/utils/dist/command-resolver.js
-var import_node_child_process6 = require("node:child_process");
+var import_node_child_process7 = require("node:child_process");
 var import_node_fs10 = __toESM(require("node:fs"), 1);
 function resolveCommand(command) {
   if (command.startsWith("/")) {
     return resolveSymlinks(command);
   }
   try {
-    const output = (0, import_node_child_process6.execSync)(`which ${command}`, {
+    const output = (0, import_node_child_process7.execSync)(`which ${command}`, {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"],
       // Ensure we have a reasonable PATH
@@ -55348,7 +55403,7 @@ function resolveSymlinks(filePath) {
 }
 function commandExists(command) {
   try {
-    (0, import_node_child_process6.execSync)(`which ${command}`, {
+    (0, import_node_child_process7.execSync)(`which ${command}`, {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -55359,7 +55414,7 @@ function commandExists(command) {
 }
 
 // packages/bridge/dist/shadow-cli.js
-var execFileAsync = (0, import_node_util2.promisify)(import_node_child_process7.execFile);
+var execFileAsync = (0, import_node_util2.promisify)(import_node_child_process8.execFile);
 function normalizeCli(cli) {
   if (!cli)
     return null;
@@ -55423,13 +55478,13 @@ async function selectShadowCli(primaryCli, options) {
 }
 
 // packages/bridge/dist/cli-resolution.js
-var import_node_child_process8 = require("node:child_process");
+var import_node_child_process9 = require("node:child_process");
 init_logger();
 var log2 = createLogger2("cli-resolution");
 function commandExists2(cmd) {
   try {
     const whichCmd = process.platform === "win32" ? "where" : "which";
-    (0, import_node_child_process8.execSync)(`${whichCmd} ${cmd}`, { stdio: "ignore" });
+    (0, import_node_child_process9.execSync)(`${whichCmd} ${cmd}`, { stdio: "ignore" });
     return true;
   } catch {
     return false;
@@ -55470,7 +55525,7 @@ function resolveCli(rawCommand) {
 
 // packages/bridge/dist/spawner.js
 var import_node_fs14 = __toESM(require("node:fs"), 1);
-var import_node_child_process12 = require("node:child_process");
+var import_node_child_process13 = require("node:child_process");
 var import_node_path17 = __toESM(require("node:path"), 1);
 var import_node_url3 = require("node:url");
 
@@ -63593,8 +63648,8 @@ var relayStatusSchema = external_exports.object({});
 
 // packages/mcp/dist/tools/relay-logs.js
 var import_node_util4 = require("node:util");
-var import_node_child_process10 = require("node:child_process");
-var execAsync3 = (0, import_node_util4.promisify)(import_node_child_process10.exec);
+var import_node_child_process11 = require("node:child_process");
+var execAsync3 = (0, import_node_util4.promisify)(import_node_child_process11.exec);
 var relayLogsSchema = external_exports.object({
   agent: external_exports.string().describe("Name of the agent to get logs for"),
   lines: external_exports.number().optional().default(50).describe("Number of lines to retrieve (default: 50)")
@@ -63661,6 +63716,14 @@ var relayChannelMessageSchema = external_exports.object({
   message: external_exports.string().describe("The message content"),
   thread: external_exports.string().optional().describe("Optional thread ID for threaded conversations")
 });
+var relayAdminChannelJoinSchema = external_exports.object({
+  channel: external_exports.string().describe("The channel name"),
+  member: external_exports.string().describe("The agent name to add to the channel")
+});
+var relayAdminRemoveMemberSchema = external_exports.object({
+  channel: external_exports.string().describe("The channel name"),
+  member: external_exports.string().describe("The agent name to remove from the channel")
+});
 
 // packages/mcp/dist/tools/relay-shadow.js
 var relayShadowBindSchema = external_exports.object({
@@ -63685,11 +63748,21 @@ var relayVoteSchema = external_exports.object({
   reason: external_exports.string().optional().describe("Optional reason for your vote")
 });
 
+// packages/mcp/dist/tools/relay-messages.js
+var relayQueryMessagesSchema = external_exports.object({
+  limit: external_exports.number().optional().describe("Maximum number of messages to return (default: 100)"),
+  since_ts: external_exports.number().optional().describe("Only return messages after this Unix timestamp (ms)"),
+  from: external_exports.string().optional().describe("Filter by sender name"),
+  to: external_exports.string().optional().describe("Filter by recipient name"),
+  thread: external_exports.string().optional().describe("Filter by thread ID"),
+  order: external_exports.enum(["asc", "desc"]).optional().describe("Sort order (default: desc)")
+});
+
 // packages/mcp/dist/install.js
 var import_node_fs13 = require("node:fs");
 var import_node_path16 = require("node:path");
 var import_node_os9 = require("node:os");
-var import_node_child_process11 = require("node:child_process");
+var import_node_child_process12 = require("node:child_process");
 
 // node_modules/smol-toml/dist/error.js
 function getLineColFromPtr(string3, ptr) {
@@ -64597,7 +64670,7 @@ function getConfigPaths() {
 }
 function isUsingNvm() {
   try {
-    const nodePath = (0, import_node_child_process11.execSync)("which node", { encoding: "utf-8" }).trim();
+    const nodePath = (0, import_node_child_process12.execSync)("which node", { encoding: "utf-8" }).trim();
     return nodePath.includes(".nvm");
   } catch {
     return false;
@@ -64605,14 +64678,14 @@ function isUsingNvm() {
 }
 function getNodePath() {
   try {
-    return (0, import_node_child_process11.execSync)("which node", { encoding: "utf-8" }).trim();
+    return (0, import_node_child_process12.execSync)("which node", { encoding: "utf-8" }).trim();
   } catch {
     return null;
   }
 }
 function getGlobalMcpBinPath() {
   try {
-    const npmPrefix = (0, import_node_child_process11.execSync)("npm prefix -g", { encoding: "utf-8" }).trim();
+    const npmPrefix = (0, import_node_child_process12.execSync)("npm prefix -g", { encoding: "utf-8" }).trim();
     const binPath = (0, import_node_path16.join)(npmPrefix, "lib", "node_modules", "@agent-relay", "mcp", "dist", "bin.js");
     if ((0, import_node_fs13.existsSync)(binPath)) {
       return binPath;
@@ -65021,6 +65094,12 @@ var AgentSpawner = class _AgentSpawner {
   policyEnforcementEnabled = false;
   onMarkSpawning;
   onClearSpawning;
+  /**
+   * Set of agent names currently being spawned.
+   * Prevents race conditions where concurrent spawn requests for the same agent
+   * could both pass the activeWorkers.has() check before either completes.
+   */
+  spawningAgents = /* @__PURE__ */ new Set();
   constructor(projectRootOrOptions, _tmuxSession, dashboardPort) {
     const options = typeof projectRootOrOptions === "string" ? { projectRoot: projectRootOrOptions, tmuxSession: _tmuxSession, dashboardPort } : projectRootOrOptions;
     const paths = getProjectPaths(options.projectRoot);
@@ -65045,6 +65124,72 @@ var AgentSpawner = class _AgentSpawner {
       });
       log3.info("Policy enforcement enabled");
     }
+    this.cleanupOrphanedWorkers();
+  }
+  /**
+   * Clean up orphaned relay-pty processes from a previous daemon run.
+   * Reads workers.json to find PIDs from the previous session and kills any
+   * that are still running. This ensures a clean slate after daemon restarts.
+   */
+  cleanupOrphanedWorkers() {
+    if (!import_node_fs14.default.existsSync(this.workersPath)) {
+      return;
+    }
+    try {
+      const raw = JSON.parse(import_node_fs14.default.readFileSync(this.workersPath, "utf-8"));
+      const workers = Array.isArray(raw?.workers) ? raw.workers : [];
+      if (workers.length === 0) {
+        return;
+      }
+      log3.info(`Checking for orphaned workers from previous run (${workers.length} entries)`);
+      let orphansKilled = 0;
+      for (const worker of workers) {
+        if (!worker.pid) {
+          continue;
+        }
+        let isRunning = false;
+        try {
+          process.kill(worker.pid, 0);
+          isRunning = true;
+        } catch {
+        }
+        if (isRunning) {
+          try {
+            const psOutput = (0, import_node_child_process13.execSync)(`ps -p ${worker.pid} -o comm= 2>/dev/null || true`, {
+              encoding: "utf-8",
+              timeout: 1e3
+            }).trim();
+            if (psOutput.includes("relay-pty") || psOutput.includes(worker.cli)) {
+              log3.warn(`Killing orphaned worker "${worker.name}" (PID: ${worker.pid})`);
+              try {
+                process.kill(worker.pid, "SIGTERM");
+              } catch {
+              }
+              const pid = worker.pid;
+              setTimeout(() => {
+                try {
+                  process.kill(pid, 0);
+                  process.kill(pid, "SIGKILL");
+                  log3.warn(`Force killed orphaned worker "${worker.name}" (PID: ${pid})`);
+                } catch {
+                }
+              }, 500);
+              orphansKilled++;
+            } else {
+              log3.debug(`PID ${worker.pid} is running but not relay-pty (${psOutput}), skipping`);
+            }
+          } catch (err) {
+            log3.debug(`Could not verify PID ${worker.pid}, skipping: ${err}`);
+          }
+        }
+      }
+      import_node_fs14.default.writeFileSync(this.workersPath, JSON.stringify({ workers: [] }, null, 2));
+      if (orphansKilled > 0) {
+        log3.info(`Cleaned up ${orphansKilled} orphaned worker(s) from previous run`);
+      }
+    } catch (err) {
+      log3.warn(`Failed to clean up orphaned workers: ${err}`);
+    }
   }
   /**
    * Set cloud policy fetcher for workspace-level policies
@@ -65142,7 +65287,7 @@ var AgentSpawner = class _AgentSpawner {
       return null;
     }
     return await new Promise((resolve5) => {
-      (0, import_node_child_process12.execFile)(ghPath, ["auth", "token", "--hostname", "github.com"], { timeout: 5e3 }, (err, stdout) => {
+      (0, import_node_child_process13.execFile)(ghPath, ["auth", "token", "--hostname", "github.com"], { timeout: 5e3 }, (err, stdout) => {
         if (err) {
           resolve5(null);
           return;
@@ -65268,6 +65413,13 @@ var AgentSpawner = class _AgentSpawner {
         error: `Agent "${name}" is already running. Use a different name or release the existing agent first.`
       };
     }
+    if (this.spawningAgents.has(name)) {
+      return {
+        success: false,
+        name,
+        error: `Agent "${name}" spawn is already in progress. Wait for it to complete or use a different name.`
+      };
+    }
     if (this.isAgentConnected(name)) {
       return {
         success: false,
@@ -65300,6 +65452,8 @@ var AgentSpawner = class _AgentSpawner {
         log3.debug(`Policy allowed spawn: ${spawnerName} -> ${name} (source: ${decision.policySource})`);
       }
     }
+    this.spawningAgents.add(name);
+    log3.info(`Spawn lock acquired for ${name} (concurrent spawns: ${this.spawningAgents.size})`);
     try {
       const cliParts = cli.split(" ");
       const rawCommandName = cliParts[0];
@@ -65850,6 +66004,9 @@ ${relayInstructions}`;
         error: tracedError.userMessage,
         errorId: tracedError.errorId
       };
+    } finally {
+      this.spawningAgents.delete(name);
+      log3.info(`Spawn lock released for ${name} (remaining: ${this.spawningAgents.size})`);
     }
   }
   /** Role presets for shadow agents */
@@ -71120,7 +71277,7 @@ var SyncQueue = class {
 // packages/utils/dist/git-remote.js
 var fs26 = __toESM(require("node:fs"), 1);
 var path27 = __toESM(require("node:path"), 1);
-var import_node_child_process13 = require("node:child_process");
+var import_node_child_process14 = require("node:child_process");
 function parseGitRemoteUrl(url) {
   if (!url)
     return null;
@@ -71140,7 +71297,7 @@ function getGitRemoteUrl(workingDirectory, remoteName = "origin") {
     if (!fs26.existsSync(gitDir)) {
       return null;
     }
-    const result = (0, import_node_child_process13.execSync)(`git remote get-url ${remoteName}`, {
+    const result = (0, import_node_child_process14.execSync)(`git remote get-url ${remoteName}`, {
       cwd: workingDirectory,
       encoding: "utf-8",
       timeout: 5e3,
@@ -73994,7 +74151,7 @@ var Daemon = class _Daemon {
     return this.consensus;
   }
 };
-var isMainModule = import_meta_url === `file://${process.argv[1]}`;
+var isMainModule = import_meta_url === `file://${process.argv[1]}` && !process.env.AGENT_RELAY_VERSION;
 if (isMainModule) {
   const daemon = new Daemon();
   process.on("SIGINT", async () => {
@@ -74748,15 +74905,15 @@ var Orchestrator = class extends import_events8.EventEmitter {
    */
   getGitInfo(workspacePath) {
     try {
-      const { execSync: execSync10 } = require("child_process");
-      const branch = execSync10("git branch --show-current", {
+      const { execSync: execSync12 } = require("child_process");
+      const branch = execSync12("git branch --show-current", {
         cwd: workspacePath,
         encoding: "utf8",
         stdio: ["pipe", "pipe", "pipe"]
       }).trim();
       let remote;
       try {
-        remote = execSync10("git remote get-url origin", {
+        remote = execSync12("git remote get-url origin", {
           cwd: workspacePath,
           encoding: "utf8",
           stdio: ["pipe", "pipe", "pipe"]
@@ -77240,7 +77397,7 @@ function manageContext(compactor, messages) {
 }
 
 // packages/daemon/dist/cli-auth.js
-var import_node_child_process14 = require("node:child_process");
+var import_node_child_process15 = require("node:child_process");
 var fs33 = __toESM(require("fs/promises"), 1);
 var os15 = __toESM(require("os"), 1);
 var import_node_path27 = require("node:path");
@@ -77357,7 +77514,7 @@ async function startCLIAuth(provider, options = {}) {
       config2.command,
       ...args
     ];
-    const proc = (0, import_node_child_process14.spawn)(relayPtyPath, relayArgs, {
+    const proc = (0, import_node_child_process15.spawn)(relayPtyPath, relayArgs, {
       cwd: process.cwd(),
       env: {
         ...process.env,
@@ -78599,11 +78756,11 @@ var HookRegistry = class {
 };
 
 // packages/trajectory/dist/integration.js
-var import_node_child_process15 = require("node:child_process");
+var import_node_child_process16 = require("node:child_process");
 async function runTrail2(args) {
   return new Promise((resolve5) => {
     const trajectoryEnv = getTrajectoryEnvVars();
-    const proc = (0, import_node_child_process15.spawn)("trail", args, {
+    const proc = (0, import_node_child_process16.spawn)("trail", args, {
       cwd: getProjectPaths().projectRoot,
       env: { ...process.env, ...trajectoryEnv },
       stdio: ["pipe", "pipe", "pipe"]
@@ -78874,7 +79031,7 @@ var TrajectoryIntegration2 = class {
    */
   isTrailInstalledSync() {
     try {
-      (0, import_node_child_process15.execSync)("which trail", { stdio: "pipe" });
+      (0, import_node_child_process16.execSync)("which trail", { stdio: "pipe" });
       return true;
     } catch {
       return false;

package/dist/src/cli/index.js

@@ -2140,6 +2140,49 @@ program
         process.exit(1);
     }
 });
+// send - Send a message to an agent via the local daemon
+program
+    .command('send')
+    .description('Send a message to an agent')
+    .argument('<agent>', 'Target agent name (or * for broadcast, #channel for channel)')
+    .argument('<message>', 'Message to send')
+    .option('--from <name>', 'Sender name', 'cli')
+    .option('--thread <id>', 'Thread identifier')
+    .action(async (agent, message, options) => {
+    const paths = getProjectPaths();
+    const client = new RelayClient({
+        socketPath: paths.socketPath,
+        agentName: options.from,
+        entityType: 'user',
+        quiet: true,
+        reconnect: false,
+        maxReconnectAttempts: 0,
+        reconnectDelayMs: 0,
+        reconnectMaxDelayMs: 0,
+    });
+    try {
+        await client.connect();
+        const sent = client.sendMessage(agent, message, 'message', undefined, options.thread);
+        if (sent) {
+            console.log(`Message sent to ${agent}`);
+        }
+        else {
+            console.error('Failed to send message');
+            process.exit(1);
+        }
+        client.disconnect();
+    }
+    catch (err) {
+        if (err.code === 'ECONNREFUSED' || err.code === 'ENOENT' || err.message?.includes('Cannot connect')) {
+            console.error(`Cannot connect to daemon. Is it running?`);
+            console.log(`Run 'agent-relay up' to start the daemon.`);
+        }
+        else {
+            console.error(`Failed to send message: ${err.message}`);
+        }
+        process.exit(1);
+    }
+});
 // agents:kill - Kill a spawned agent by PID
 program
     .command('agents:kill')