agent-relay-server 0.1.0 → 0.3.0

package/codex/relay.ts

@@ -0,0 +1,116 @@
+import { hostname } from "node:os";
+
+export type RelayAgentStatus = "online" | "idle" | "busy" | "offline";
+
+export interface RelayMessage {
+  id: number;
+  from: string;
+  to: string;
+  subject?: string;
+  body: string;
+  replyTo?: number;
+  claimable?: boolean;
+  meta?: Record<string, unknown>;
+  createdAt: number;
+}
+
+export interface RelayConfig {
+  relayUrl: string;
+  cwd: string;
+  rig: string;
+  capabilities: string[];
+  tags: string[];
+  threadId: string;
+  model?: string;
+  appServerUrl: string;
+}
+
+export function buildAgentIdentity(config: RelayConfig): { id: string; name: string; machine: string; project: string } {
+  const machine = hostname();
+  const project = config.cwd.split("/").filter(Boolean).at(-1) || "unknown";
+  const shortThread = config.threadId.replace(/[^a-zA-Z0-9]/g, "").slice(0, 8) || "thread";
+  const id = `${machine}-${config.rig}-${project}-${shortThread}`;
+  const name = `${project} (${config.rig} @ ${machine})`;
+  return { id, name, machine, project };
+}
+
+export class RelayClient {
+  constructor(private readonly baseUrl: string, private readonly log: (msg: string) => void = () => {}) {}
+
+  async registerAgent(config: RelayConfig): Promise<{ agentId: string; project: string }> {
+    const identity = buildAgentIdentity(config);
+    const payload = {
+      id: identity.id,
+      name: identity.name,
+      machine: identity.machine,
+      rig: config.rig,
+      tags: config.tags,
+      capabilities: config.capabilities,
+      status: "online",
+      meta: {
+        client: "codex-live",
+        threadId: config.threadId,
+        appServerUrl: config.appServerUrl,
+        cwd: config.cwd,
+        model: config.model || null,
+      },
+    };
+
+    await this.json("POST", "/api/agents", payload);
+    return { agentId: identity.id, project: identity.project };
+  }
+
+  async heartbeat(agentId: string): Promise<void> {
+    await this.json("POST", `/api/agents/${encodeURIComponent(agentId)}/heartbeat`);
+  }
+
+  async setStatus(agentId: string, status: RelayAgentStatus): Promise<void> {
+    await this.json("PATCH", `/api/agents/${encodeURIComponent(agentId)}/status`, { status });
+  }
+
+  async pollMessages(agentId: string, sinceId: number): Promise<RelayMessage[]> {
+    const url = new URL(`/api/messages`, this.baseUrl);
+    url.searchParams.set("for", agentId);
+    url.searchParams.set("unread", "true");
+    if (sinceId > 0) url.searchParams.set("sinceId", String(sinceId));
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`relay poll failed: ${response.status} ${response.statusText}`);
+    }
+    return (await response.json()) as RelayMessage[];
+  }
+
+  async claimMessage(messageId: number, agentId: string): Promise<boolean> {
+    const response = await fetch(new URL(`/api/messages/${messageId}/claim`, this.baseUrl), {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ agentId }),
+    });
+
+    if (response.ok) return true;
+    if (response.status === 409) return false;
+    if (response.status === 400 || response.status === 404) return false;
+    throw new Error(`relay claim failed: ${response.status} ${response.statusText}`);
+  }
+
+  async markRead(messageId: number, agentId: string): Promise<void> {
+    await this.json("PATCH", `/api/messages/${messageId}`, { readBy: agentId });
+  }
+
+  private async json(method: string, path: string, body?: unknown): Promise<unknown> {
+    const response = await fetch(new URL(path, this.baseUrl), {
+      method,
+      headers: { "Content-Type": "application/json" },
+      body: body === undefined ? undefined : JSON.stringify(body),
+    });
+
+    if (!response.ok) {
+      const text = await response.text();
+      this.log(`relay error ${method} ${path}: ${response.status} ${text}`);
+      throw new Error(`relay ${method} ${path} failed: ${response.status}`);
+    }
+
+    if (response.status === 204) return null;
+    return response.json().catch(() => null);
+  }
+}

package/codex/start-live.sh

@@ -0,0 +1,64 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR=$(cd "$(dirname "$0")/.." && pwd)
+CODEX_DIR="$ROOT_DIR/codex"
+RUNTIME_DIR="$CODEX_DIR/runtime"
+APP_LOG="$RUNTIME_DIR/app-server.log"
+APP_PID="$RUNTIME_DIR/app-server.pid"
+APP_URL_FILE="$RUNTIME_DIR/app-server.url"
+STATE_FILE="${CODEX_LIVE_STATE_PATH:-$RUNTIME_DIR/live-state.json}"
+CODEX_APP_SERVER_URL="${CODEX_APP_SERVER_URL:-ws://127.0.0.1:4501}"
+STARTED_APP_SERVER=0
+
+mkdir -p "$RUNTIME_DIR"
+
+cleanup() {
+  if [ "$STARTED_APP_SERVER" = "1" ] && [ -f "$APP_PID" ]; then
+    pid=$(cat "$APP_PID" 2>/dev/null || true)
+    if [ -n "${pid:-}" ] && kill -0 "$pid" 2>/dev/null; then
+      kill "$pid" 2>/dev/null || true
+    fi
+    rm -f "$APP_PID"
+  fi
+}
+trap cleanup EXIT INT TERM
+
+if [ -f "$APP_PID" ]; then
+  pid=$(cat "$APP_PID" 2>/dev/null || true)
+  if [ -n "${pid:-}" ] && kill -0 "$pid" 2>/dev/null; then
+    echo "app-server already running (pid=$pid) at $(cat "$APP_URL_FILE" 2>/dev/null || echo "$CODEX_APP_SERVER_URL")"
+  else
+    rm -f "$APP_PID"
+  fi
+fi
+
+if [ ! -f "$APP_PID" ]; then
+  setsid bash -lc "exec codex app-server --listen '$CODEX_APP_SERVER_URL' >>'$APP_LOG' 2>&1 < /dev/null" &
+  pid=$!
+  STARTED_APP_SERVER=1
+  printf '%s\n' "$pid" > "$APP_PID"
+  printf '%s\n' "$CODEX_APP_SERVER_URL" > "$APP_URL_FILE"
+
+  for _ in $(seq 1 50); do
+    if grep -qiE 'listening|ws://' "$APP_LOG" 2>/dev/null; then
+      break
+    fi
+    if ! kill -0 "$pid" 2>/dev/null; then
+      echo "app-server exited early; see $APP_LOG" >&2
+      exit 1
+    fi
+    sleep 0.2
+  done
+
+  echo "started app-server pid=$pid url=$CODEX_APP_SERVER_URL"
+fi
+
+echo "state file: $STATE_FILE"
+echo "connect Codex TUI with: codex --remote $CODEX_APP_SERVER_URL"
+echo "if sidecar creates a new thread first, inspect $STATE_FILE for threadId and use: codex resume <threadId> --remote $CODEX_APP_SERVER_URL"
+
+export CODEX_APP_SERVER_URL
+export CODEX_LIVE_CWD="${CODEX_LIVE_CWD:-$ROOT_DIR}"
+export CODEX_LIVE_STATE_PATH="$STATE_FILE"
+exec bun run "$CODEX_DIR/live-sidecar.ts"

package/package.json

@@ -1,21 +1,32 @@
 {
   "name": "agent-relay-server",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Lightweight HTTP message relay for inter-agent communication across machines",
   "module": "src/index.ts",
   "type": "module",
   "bin": {
-    "agent-relay": "src/index.ts"
+    "agent-relay": "src/index.ts",
+    "agent-relay-codex": "bin/agent-relay-codex.ts",
+    "codex-relay": "bin/agent-relay-codex.ts"
   },
   "files": [
+    "bin/**/*.ts",
     "src/**/*.ts",
     "!src/**/*.test.ts",
+    "codex/**/*.ts",
+    "codex/**/*.sh",
+    "codex/**/*.ps1",
+    "codex/plugin/**",
     "public/**",
     "README.md"
   ],
   "scripts": {
     "start": "bun run src/index.ts",
-    "dev": "bun --watch run src/index.ts"
+    "dev": "bun --watch run src/index.ts",
+    "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"
   },
   "keywords": [
     "agent",