agent-relay-server 0.3.3 → 0.3.5

package/bin/agent-relay-codex.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env bun
-import { chmodSync, cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { appendFileSync, chmodSync, cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { createInterface } from "node:readline/promises";
@@ -149,6 +149,15 @@ function samePath(left: string, right: string): boolean {
   return process.platform === "win32" ? a.toLowerCase() === b.toLowerCase() : a === b;
 }
 
+function isAlive(pid: number): boolean {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 function candidateNames(command: string): string[] {
   if (process.platform !== "win32") return [command];
   const extensions = (process.env.PATHEXT || ".COM;.EXE;.BAT;.CMD;.PS1").split(";").filter(Boolean);
@@ -278,6 +287,48 @@ async function waitForPort(url: string, child: ReturnType<typeof Bun.spawn>): Pr
   throw new Error(`timed out waiting for ${url}`);
 }
 
+async function waitForSidecarPid(runDir: string, timeoutMs: number): Promise<boolean> {
+  const pidsPath = join(runDir, "sidecar-pids.txt");
+  const deadline = Date.now() + timeoutMs;
+
+  while (Date.now() < deadline) {
+    if (existsSync(pidsPath)) {
+      for (const line of readFileSync(pidsPath, "utf8").split("\n")) {
+        const pid = Number(line.trim());
+        if (Number.isFinite(pid) && pid > 0 && isAlive(pid)) return true;
+      }
+    }
+    await Bun.sleep(100);
+  }
+
+  return false;
+}
+
+function spawnFallbackSidecar(runDir: string, env: Record<string, string | undefined>): number {
+  const autoDir = join(runDir, "auto");
+  mkdirSync(autoDir, { recursive: true });
+
+  const sidecarEnv: Record<string, string | undefined> = {
+    ...env,
+    CODEX_THREAD_MODE: "auto",
+    CODEX_LIVE_CWD: process.cwd(),
+    CODEX_LIVE_STATE_PATH: join(autoDir, "live-state.json"),
+  };
+  delete sidecarEnv.CODEX_THREAD_ID;
+
+  const sidecar = Bun.spawn(["bun", "run", join(activePackageRoot(), "codex", "live-sidecar.ts")], {
+    env: sidecarEnv,
+    stdout: Bun.file(join(autoDir, "sidecar.log")),
+    stderr: Bun.file(join(autoDir, "sidecar.log")),
+  });
+  sidecar.unref();
+
+  writeFileSync(join(autoDir, "sidecar.pid"), String(sidecar.pid));
+  appendFileSync(join(runDir, "sidecar-pids.txt"), `${sidecar.pid}\n`);
+
+  return sidecar.pid;
+}
+
 function cleanupRun(runDir: string, appServer: ReturnType<typeof Bun.spawn> | null): void {
   if (existsSync(runDir)) {
     const pidsPath = join(runDir, "sidecar-pids.txt");
@@ -482,6 +533,13 @@ async function start(args: string[]): Promise<void> {
     stdout: "inherit",
     stderr: "inherit",
   });
+
+  const sidecarDetected = await waitForSidecarPid(runDir, 2500);
+  if (!sidecarDetected && codex.exitCode === null) {
+    const pid = spawnFallbackSidecar(runDir, env);
+    console.error(`Agent Relay: SessionStart hook did not start sidecar; started fallback sidecar pid ${pid}`);
+  }
+
   const exitCode = await codex.exited;
   shutdown();
   process.exit(exitCode);

package/codex/README.md

@@ -16,6 +16,7 @@ This sidecar connects to a Codex app-server session and to Agent Relay, then del
 - otherwise resumes the newest thread for the current `cwd`
 - otherwise creates a new thread
 - registers a relay agent with `client: codex-live`
+- marks the relay agent `ready=true` once app-server + thread are attached
 - polls relay inbox and delivers messages into the live thread
 - coalesces ordinary relay bursts into one delivery turn
 - reconnects to the app-server with exponential backoff after disconnects
@@ -55,6 +56,7 @@ For local development from this repo:
 
 ```bash
 bun run bin/agent-relay-codex.ts
+bun run codex:smoke:fallback
 ```
 
 Useful environment variables:

package/codex/live-sidecar.ts

@@ -319,9 +319,13 @@ class CodexLiveSidecar {
       : this.activeTurnId || this.threadStatus === "active"
         ? "busy"
         : "idle";
+    const ready = this.appConnected && Boolean(this.threadId);
 
     try {
-      await this.relay.setStatus(this.agentId, status);
+      await Promise.all([
+        this.relay.setStatus(this.agentId, status),
+        this.relay.setReady(this.agentId, ready),
+      ]);
     } catch {
       // Best-effort status sync.
     }

package/codex/plugin/.codex-plugin/plugin.json

@@ -1,13 +1,17 @@
 {
   "name": "agent-relay",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Agent Relay integration for Codex sessions",
   "author": {
     "name": "Edin Mujkanovic"
   },
   "repository": "https://github.com/edimuj/agent-relay",
   "license": "MIT",
-  "keywords": ["agent-relay", "multi-agent", "codex"],
+  "keywords": [
+    "agent-relay",
+    "multi-agent",
+    "codex"
+  ],
   "skills": "./skills/",
   "interface": {
     "displayName": "Agent Relay",
@@ -15,7 +19,10 @@
     "longDescription": "Adds Codex-facing instructions for Agent Relay and pairs with the agent-relay-codex launcher for live incoming messages.",
     "developerName": "Edin Mujkanovic",
     "category": "Productivity",
-    "capabilities": ["Read", "Write"],
+    "capabilities": [
+      "Read",
+      "Write"
+    ],
     "defaultPrompt": [
       "Use Agent Relay to message another coding agent.",
       "Check how this Codex session is connected to Agent Relay."

package/codex/relay.ts

@@ -68,6 +68,10 @@ export class RelayClient {
     await this.json("PATCH", `/api/agents/${encodeURIComponent(agentId)}/status`, { status });
   }
 
+  async setReady(agentId: string, ready: boolean): Promise<void> {
+    await this.json("PATCH", `/api/agents/${encodeURIComponent(agentId)}/ready`, { ready });
+  }
+
   async pollMessages(agentId: string, sinceId: number): Promise<RelayMessage[]> {
     const url = new URL(`/api/messages`, this.baseUrl);
     url.searchParams.set("for", agentId);

package/codex/smoke/fallback.ts

@@ -0,0 +1,125 @@
+import { chmodSync, existsSync, mkdirSync, mkdtempSync, readFileSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { tmpdir } from "node:os";
+
+const ROOT_DIR = resolve(import.meta.dir, "../..");
+
+function log(message: string): void {
+  console.error(`[codex-fallback-smoke] ${message}`);
+}
+
+async function waitForExit(process: Bun.Subprocess, timeoutMs: number): Promise<number> {
+  const started = Date.now();
+  while (Date.now() - started < timeoutMs) {
+    if (process.exitCode !== null) return process.exitCode;
+    await Bun.sleep(100);
+  }
+  try {
+    process.kill();
+  } catch {
+    // Process already exited.
+  }
+  throw new Error(`timed out waiting for process to exit after ${timeoutMs}ms`);
+}
+
+function writeFakeCodex(path: string): void {
+  const script = `#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "\${1:-}" == "plugin" && "\${2:-}" == "marketplace" && "\${3:-}" == "add" ]]; then
+  exit 0
+fi
+
+if [[ "\${1:-}" == "app-server" && "\${2:-}" == "--listen" ]]; then
+  url="\${3:-}"
+  port="\${url##*:}"
+  exec node -e 'const net=require("node:net"); const port=Number(process.argv[1]); const server=net.createServer((socket)=>socket.destroy()); server.listen(port,"127.0.0.1"); setInterval(()=>{},1000);' "$port"
+fi
+
+if [[ "\${1:-}" == "--remote" ]]; then
+  sleep 6
+  exit 0
+fi
+
+echo "fake codex: unsupported args: $*" >&2
+exit 64
+`;
+  writeFileSync(path, script, "utf8");
+  chmodSync(path, 0o755);
+}
+
+function parseRuntimeDir(stderr: string): string | null {
+  const match = stderr.match(/^Runtime:\s+(.+)$/m);
+  return match?.[1]?.trim() || null;
+}
+
+async function main(): Promise<void> {
+  const tempHome = mkdtempSync(join(tmpdir(), "agent-relay-codex-fallback-"));
+  const fakeBin = join(tempHome, "fake-bin");
+  mkdirSync(fakeBin, { recursive: true });
+
+  const fakeCodexPath = join(fakeBin, "codex");
+  writeFakeCodex(fakeCodexPath);
+
+  const env = {
+    ...process.env,
+    HOME: tempHome,
+    USERPROFILE: tempHome,
+    PATH: `${fakeBin}:${process.env.PATH || ""}`,
+    AGENT_RELAY_URL: process.env.AGENT_RELAY_URL || "http://127.0.0.1:4850",
+  };
+
+  log("starting launcher with fake codex runtime (hooks intentionally not fired)");
+  const run = Bun.spawn(["bun", "run", "bin/agent-relay-codex.ts", "start"], {
+    cwd: ROOT_DIR,
+    env,
+    stdout: "pipe",
+    stderr: "pipe",
+  });
+
+  const exitCode = await waitForExit(run, 25_000);
+  const stderr = await new Response(run.stderr).text();
+  const stdout = await new Response(run.stdout).text();
+
+  if (exitCode !== 0) {
+    throw new Error(`launcher exited ${exitCode}\nstdout:\n${stdout}\nstderr:\n${stderr}`);
+  }
+
+  const runtimeDir = parseRuntimeDir(stderr);
+  if (!runtimeDir) {
+    throw new Error(`missing runtime directory in launcher output\nstderr:\n${stderr}`);
+  }
+
+  if (!stderr.includes("SessionStart hook did not start sidecar; started fallback sidecar pid")) {
+    throw new Error(`fallback start message not found\nstderr:\n${stderr}`);
+  }
+
+  const fallbackPidPath = join(runtimeDir, "auto", "sidecar.pid");
+  const fallbackLogPath = join(runtimeDir, "auto", "sidecar.log");
+  const sidecarPidsPath = join(runtimeDir, "sidecar-pids.txt");
+
+  if (!existsSync(fallbackPidPath)) {
+    throw new Error(`fallback pid file missing: ${fallbackPidPath}`);
+  }
+  if (!existsSync(sidecarPidsPath)) {
+    throw new Error(`sidecar-pids missing: ${sidecarPidsPath}`);
+  }
+
+  const pid = readFileSync(fallbackPidPath, "utf8").trim();
+  const pidsFile = readFileSync(sidecarPidsPath, "utf8");
+  if (!pid || !pidsFile.includes(pid)) {
+    throw new Error(`fallback pid ${pid || "<empty>"} not recorded in sidecar-pids.txt`);
+  }
+
+  log(`fallback sidecar created pid ${pid}`);
+  if (existsSync(fallbackLogPath)) {
+    log(`fallback log file present at ${fallbackLogPath}`);
+  }
+  log("fallback smoke passed");
+}
+
+main().catch((error) => {
+  log(error instanceof Error ? error.stack || error.message : String(error));
+  process.exitCode = 1;
+});
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-server",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Lightweight HTTP message relay for inter-agent communication across machines",
   "module": "src/index.ts",
   "type": "module",
@@ -26,7 +26,8 @@
     "codex:live": "bun run codex/live-sidecar.ts",
     "codex:live:start": "bash codex/start-live.sh",
     "codex:install": "bun run bin/agent-relay-codex.ts install",
-    "codex:doctor": "bun run bin/agent-relay-codex.ts doctor"
+    "codex:doctor": "bun run bin/agent-relay-codex.ts doctor",
+    "codex:smoke:fallback": "bun run codex/smoke/fallback.ts"
   },
   "keywords": [
     "agent",

package/public/index.html

@@ -134,7 +134,7 @@
               <div class="card-body">
                 <div class="d-flex align-items-center">
                   <div>
-                    <div class="text-secondary small">Online</div>
+                    <div class="text-secondary small">Active</div>
                     <div class="h1 mb-0 text-success" x-text="onlineCount"></div>
                   </div>
                   <i class="ti ti-circle-check ms-auto stat-card"></i>
@@ -176,7 +176,7 @@
             <div class="card">
               <div class="card-header d-flex align-items-center">
                 <h3 class="card-title">Agents</h3>
-                <span class="badge bg-success text-white ms-auto" x-text="onlineCount + ' online'"></span>
+                <span class="badge bg-success text-white ms-auto" x-text="onlineCount + ' active'"></span>
               </div>
               <div class="list-group list-group-flush" style="max-height: 60vh; overflow-y: auto">
                 <template x-for="a in sortedAgents.slice(0, 20)" :key="a.id">
@@ -319,7 +319,7 @@
           <div class="card">
             <div class="card-body text-center text-secondary py-5">
               <i class="ti ti-robot-off" style="font-size:48px; opacity:0.3"></i>
-              <p class="mt-2" x-text="showOffline ? 'No agents registered' : 'No agents online — enable Show Offline'"></p>
+              <p class="mt-2" x-text="showOffline ? 'No agents registered' : 'No active agents — enable Show Offline'"></p>
             </div>
           </div>
         </template>
@@ -822,11 +822,11 @@ function relay() {
     // ── Computed ──
 
     get onlineCount() {
-      return this.agents.filter(a => a.status === 'online').length;
+      return this.agents.filter(a => a.status !== 'offline').length;
     },
 
     get sortedAgents() {
-      let list = this.showOffline ? [...this.agents] : this.agents.filter(a => a.status === 'online');
+      let list = this.showOffline ? [...this.agents] : this.agents.filter(a => a.status !== 'offline');
       const dir = this.agentSortDir === 'desc' ? -1 : 1;
       return list.sort((a, b) => {
         let cmp = 0;