agent-relay-server 0.3.4 → 0.3.5

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,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Agent Relay integration for Codex sessions",
   "author": {
     "name": "Edin Mujkanovic"

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.4",
+  "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;