agent-relay-codex 0.4.27 → 0.4.29

package/live-sidecar.ts

@@ -85,6 +85,7 @@ class CodexLiveSidecar {
   private draining = false;
   private drainDueAt = 0;
   private reconnecting: Promise<void> | null = null;
+  private relayPrimerDelivered = false;
   private readonly pendingMessages = new Map<number, RelayMessage>();
   private readonly activeClaimedMessageIds = new Set<number>();
 
@@ -529,7 +530,7 @@ class CodexLiveSidecar {
     }
 
     const delivery = this.pickDeliveryMode(batch.messages);
-    const prompt = formatRelayPrompt(batch.messages);
+    const prompt = formatRelayPrompt(batch.messages, { includePrimer: !this.relayPrimerDelivered });
     const ids = batch.messages.map((message) => message.id).join(", ");
     this.log(`delivering message ${ids} via ${delivery}`);
 
@@ -548,6 +549,7 @@ class CodexLiveSidecar {
       try {
         await this.app.turnSteer(this.threadId, this.activeTurnId, prompt);
         for (const id of claimedMessageIds) this.activeClaimedMessageIds.add(id);
+        this.relayPrimerDelivered = true;
         await this.markBatchRead(batch.messages);
         this.advanceCursor(batch.messages);
         this.writeState();
@@ -559,6 +561,7 @@ class CodexLiveSidecar {
 
     await this.app.turnStart(this.threadId, prompt);
     for (const id of claimedMessageIds) this.activeClaimedMessageIds.add(id);
+    this.relayPrimerDelivered = true;
     await this.markBatchRead(batch.messages);
     this.advanceCursor(batch.messages);
     this.writeState();
@@ -654,10 +657,25 @@ function shouldIsolateMessage(message: RelayMessage): boolean {
   return delivery === "interrupt" || delivery === "start" || delivery === "steer" || priority === "urgent";
 }
 
-export function formatRelayPrompt(messages: RelayMessage[]): string {
+export function formatRelayPrompt(
+  messages: RelayMessage[],
+  opts: { includePrimer?: boolean } = {},
+): string {
+  const includePrimer = opts.includePrimer === true;
+  const relayUrl = process.env.AGENT_RELAY_URL || "http://127.0.0.1:4850";
+  const primer = [
+    "Agent Relay live-message primer:",
+    "Treat Agent Relay deliveries as live incoming messages from other agents. Respond or act on them as appropriate.",
+    "When calling the relay API, include AGENT_RELAY_TOKEN as the X-Agent-Relay-Token header if that environment variable is set.",
+    `For normal replies, POST JSON to ${relayUrl}/api/messages with from set to your Agent Relay ID, to set to the sender Agent Relay ID, body set to your response, and replyTo set to the incoming message id.`,
+    `For pair chat replies, POST JSON to ${relayUrl}/api/pairs/{pairId}/messages with from set to your Agent Relay ID and body set to your response.`,
+    "",
+  ];
+
   if (messages.length === 1) {
     const message = messages[0]!;
     const lines = [
+      ...(includePrimer ? primer : []),
       "Agent Relay message received.",
       "",
       formatMessageSummary(message),
@@ -678,16 +696,15 @@ export function formatRelayPrompt(messages: RelayMessage[]): string {
       "Body:",
       message.body,
       "",
-      "Treat this as a live incoming message from another agent. Respond or act on it as appropriate.",
-      "If AGENT_RELAY_TOKEN is set, include it as the X-Agent-Relay-Token header when calling the relay API.",
       typeof message.meta?.pairId === "string"
-        ? `For pair chat, POST JSON to ${process.env.AGENT_RELAY_URL || "http://127.0.0.1:4850"}/api/pairs/${message.meta.pairId}/messages with from set to your Agent Relay ID and body set to your response.`
-        : `To reply, POST JSON to ${process.env.AGENT_RELAY_URL || "http://127.0.0.1:4850"}/api/messages with from set to your Agent Relay ID, to set to ${JSON.stringify(message.from)}, and replyTo set to ${message.id}.`,
+        ? `Reply routing: pairId=${JSON.stringify(message.meta.pairId)}.`
+        : `Reply routing: to=${JSON.stringify(message.from)}, replyTo=${message.id}.`,
     );
     return lines.join("\n");
   }
 
   const lines = [
+    ...(includePrimer ? primer : []),
     "Agent Relay message batch received.",
     "",
     `Count: ${messages.length}`,
@@ -705,13 +722,16 @@ export function formatRelayPrompt(messages: RelayMessage[]): string {
     if (message.subject) lines.push(`Subject: ${message.subject}`);
     if (message.replyTo) lines.push(`Reply To: ${message.replyTo}`);
     if (typeof message.meta?.pairId === "string") lines.push(`Pair ID: ${message.meta.pairId}`);
+    lines.push(
+      typeof message.meta?.pairId === "string"
+        ? `Reply routing: pairId=${JSON.stringify(message.meta.pairId)}.`
+        : `Reply routing: to=${JSON.stringify(message.from)}, replyTo=${message.id}.`,
+    );
     lines.push("Body:", message.body, "", "---", "");
   }
 
   lines.push(
-    "Treat these as live incoming messages from other agents. Synthesize them into one coherent response or action.",
-    "If AGENT_RELAY_TOKEN is set, include it as the X-Agent-Relay-Token header when calling the relay API.",
-    `To reply, POST JSON to ${process.env.AGENT_RELAY_URL || "http://127.0.0.1:4850"}/api/messages with from set to your Agent Relay ID and replyTo set to the message you are answering.`,
+    "Synthesize these messages into one coherent response or action. Use each message's Reply routing line when replying.",
   );
   return lines.join("\n");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-codex",
-  "version": "0.4.27",
+  "version": "0.4.29",
   "description": "Codex integration for Agent Relay — auto-registers sessions as agents and enables inter-agent messaging",
   "type": "module",
   "bin": {

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

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "0.4.27",
+  "version": "0.4.29",
   "description": "Agent Relay integration for Codex sessions",
   "author": {
     "name": "Edin Mujkanovic"