npm - agent-relay-server - Versions diffs - 0.7.3 → 0.8.0 - Mend

agent-relay-server 0.7.3 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-server",
-  "version": "0.7.3",
+  "version": "0.8.0",
   "description": "Lightweight HTTP message relay for inter-agent communication across machines",
   "module": "src/index.ts",
   "type": "module",

package/src/cli.ts CHANGED Viewed

@@ -38,6 +38,7 @@ Usage:
   agent-relay message <target> <body> [options]
   agent-relay /pair <target|accept|reject|send|status> [...]
   agent-relay /message <target> <body>
+  agent-relay /reply <messageId> <body>
   agent-relay /send-claimable <target> <body>
   agent-relay /disconnect [PAIR_ID]
   agent-relay /status
@@ -52,6 +53,7 @@ Pair examples:
   agent-relay pair accept PAIR_ID --agent AGENT_ID
   agent-relay pair send PAIR_ID --from AGENT_ID --body "What do you see?"
   agent-relay /message codex "Can you look at that failing action?"
+  agent-relay /reply 206 "Sounds good, I'll take a look"
   agent-relay /send-claimable tag:backend "Please claim and fix the failing API test"
   agent-relay /disconnect
   agent-relay /status
@@ -123,6 +125,10 @@ export async function handleCli(args: string[]): Promise<"start" | "handled"> {
     await handleMessageCommand(args.slice(1), { claimable: command === "/send-claimable" });
     return "handled";
   }
+  if (command === "reply" || command === "/reply") {
+    await handleReplyCommand(args.slice(1));
+    return "handled";
+  }
   if (command === "/status" || command === "status") {
     await handleStatusCommand(args.slice(1));
     return "handled";
@@ -499,6 +505,42 @@ async function handleMessageCommand(args: string[], defaults: { claimable?: bool
   else console.log(`${claimable ? "Claimable message" : "Message"} sent: ${(message as any).id} -> ${target}`);
 }
+async function handleReplyCommand(args: string[]): Promise<void> {
+  const msgIdRaw = args[0];
+  if (!msgIdRaw || msgIdRaw.startsWith("--")) {
+    throw new Error("Usage: agent-relay /reply <messageId> <body> [--from AGENT_ID] [--subject TEXT] [--json]");
+  }
+  const replyTo = Number.parseInt(msgIdRaw, 10);
+  if (!Number.isFinite(replyTo) || replyTo <= 0) throw new Error("messageId must be a positive integer");
+  let from = await detectAgentId();
+  let subject: string | undefined;
+  let json = false;
+  const bodyParts: string[] = [];
+  for (let i = 1; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--from" && i + 1 < args.length) from = args[++i];
+    else if (arg === "--subject" && i + 1 < args.length) subject = args[++i];
+    else if (arg === "--json") json = true;
+    else bodyParts.push(arg!);
+  }
+  const body = bodyParts.join(" ").trim();
+  if (!from) throw new Error("Could not detect current Agent Relay ID. Pass --from AGENT_ID or set AGENT_RELAY_ID.");
+  if (!body) throw new Error("Reply body required.");
+  const message = await apiRequest("POST", "/api/messages", {
+    from,
+    body,
+    subject,
+    replyTo,
+  });
+  const msg = message as any;
+  if (json) console.log(JSON.stringify(msg, null, 2));
+  else console.log(`Reply sent: ${msg.id} -> ${msg.to} (reply to #${replyTo})`);
+}
 async function handleStatusCommand(args: string[]): Promise<void> {
   let agentId = await detectAgentId();
   let json = false;

package/src/routes.ts CHANGED Viewed

@@ -335,7 +335,7 @@ function normalizeMessageInput(body: unknown): SendMessageInput {
   const input: SendMessageInput = {
     from: cleanString(body.from, "from", { required: true, max: 200 })!,
-    to: cleanString(body.to, "to", { required: true, max: 200 })!,
+    to: cleanString(body.to, "to", { max: 200 }) ?? "",
     body: cleanString(body.body, "body", { required: true, max: MAX_BODY_BYTES })!,
     kind: kind as SendMessageInput["kind"] | undefined,
     replyTo: cleanPositiveId(body.replyTo, "replyTo"),
@@ -355,6 +355,27 @@ function normalizeMessageInput(body: unknown): SendMessageInput {
   return input;
 }
+function applyReplyRouting(input: SendMessageInput): void {
+  if (input.to || !input.replyTo) return;
+  const parent = getMessage(input.replyTo);
+  if (!parent) return;
+  input.to = parent.from;
+  if (!input.channel && parent.channel) input.channel = parent.channel;
+  const parentPayload = parent.payload ?? {};
+  if (parentPayload.schema === "agent-relay.channel.v1" || parentPayload.conversation) {
+    const replyContext: Record<string, unknown> = {};
+    if (parent.channel) replyContext.channelId = parent.channel;
+    if (parentPayload.conversation && typeof parentPayload.conversation === "object") {
+      replyContext.conversationId = (parentPayload.conversation as Record<string, unknown>).id;
+    }
+    if (parentPayload.event && typeof parentPayload.event === "object") {
+      replyContext.parentEventId = (parentPayload.event as Record<string, unknown>).id;
+    }
+    if (parentPayload.source) replyContext.source = parentPayload.source;
+    input.payload = { ...input.payload, replyContext };
+  }
+}
 function normalizeChannelBindingInput(body: unknown): {
   channelId: string;
   conversationId?: string;
@@ -1326,6 +1347,8 @@ const postMessage: Handler = async (req) => {
     if (!input.idempotencyKey) {
       input.idempotencyKey = cleanString(req.headers.get("Idempotency-Key") ?? undefined, "idempotencyKey", { max: 240 });
     }
+    applyReplyRouting(input);
+    if (!input.to) return error("to is required (or provide replyTo to auto-route)");
     const result = sendMessageWithResult(input);
     if (result.created) {
       emitNewMessage(result.message);