npm - agent-relay-server - Versions diffs - 0.4.17 → 0.4.18 - Mend

agent-relay-server 0.4.17 → 0.4.18

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/README.md CHANGED Viewed

@@ -326,17 +326,20 @@ agent-relay /pair codex "Debug flaky auth tests"
 agent-relay pair codex --objective "Debug flaky auth tests"
 agent-relay pair accept PAIR_ID --agent "$AGENT_RELAY_ID"
 agent-relay pair send PAIR_ID --from "$AGENT_RELAY_ID" --body "What do you see?"
+agent-relay /message codex "Can you look at that failing action?"
+agent-relay /send-claimable tag:backend "Please claim and fix the failing API test"
 agent-relay /disconnect
 agent-relay /status
 agent-relay /label backend-fixer
 agent-relay /tags backend tests urgent
 ```
-Inside provider sessions, the Codex skill and Claude plugin context instruct
-agents to treat slash-style user messages like `/pair codex`, `/status`,
-`/label backend-fixer`, and `/tags backend tests` as relay commands and run the
-CLI. The CLI tries to auto-detect the current agent id from provider state; pass
-`--from` or `--agent` if you want to be explicit.
+Inside provider sessions, the Codex plugin and Claude plugin ship command
+skills for `/pair`, `/message`, `/send-claimable`, `/disconnect`, `/status`,
+`/label`, and `/tags`. If one of those names collides with another installed
+skill, invoke the provider-prefixed form such as `/agent-relay:pair` or
+`/agent-relay:message`. The CLI tries to auto-detect the current agent id from
+provider state; pass `--from` or `--agent` if you want to be explicit.
 If the target is already in a pending or active pair, the relay returns
 `409 Busy`. If a target like `codex` matches multiple available agents, the

package/package.json CHANGED Viewed

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

package/src/cli.ts CHANGED Viewed

@@ -26,7 +26,10 @@ Usage:
   agent-relay setup [--yes] [--dry-run] [--force] [--env-file PATH] [--host HOST] [--port PORT] [--db-path PATH] [--token TOKEN|--no-token]
   agent-relay daemon <install|uninstall|start|stop|restart|enable|disable|status|logs> [options]
   agent-relay pair <target|create|status|accept|reject|hangup|send> [options]
+  agent-relay message <target> <body> [options]
   agent-relay /pair <target|accept|reject|send|status> [...]
+  agent-relay /message <target> <body>
+  agent-relay /send-claimable <target> <body>
   agent-relay /disconnect [PAIR_ID]
   agent-relay /status
   agent-relay /label [LABEL]
@@ -39,6 +42,8 @@ Pair examples:
   agent-relay pair status
   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 /send-claimable tag:backend "Please claim and fix the failing API test"
   agent-relay /disconnect
   agent-relay /status
   agent-relay /label backend-fixer
@@ -94,6 +99,10 @@ export async function handleCli(args: string[]): Promise<"start" | "handled"> {
     await handleSlashOrPairCommand(command, args.slice(1));
     return "handled";
   }
+  if (command === "message" || command === "send" || command === "/message" || command === "/send" || command === "/send-claimable") {
+    await handleMessageCommand(args.slice(1), { claimable: command === "/send-claimable" });
+    return "handled";
+  }
   if (command === "/status" || command === "status") {
     await handleStatusCommand(args.slice(1));
     return "handled";
@@ -357,6 +366,54 @@ async function handlePairCommand(args: string[]): Promise<void> {
   }
 }
+async function handleMessageCommand(args: string[], defaults: { claimable?: boolean } = {}): Promise<void> {
+  const target = args[0];
+  if (!target || target.startsWith("--")) {
+    throw new Error("Usage: agent-relay message <target> <body> [--from AGENT_ID] [--subject TEXT] [--channel NAME] [--reply-to ID] [--claimable]");
+  }
+  let from = await detectAgentId();
+  let subject: string | undefined;
+  let channel: string | undefined;
+  let replyTo: number | undefined;
+  let idempotencyKey: string | undefined;
+  let json = false;
+  let claimable = defaults.claimable ?? 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 === "--channel" && i + 1 < args.length) channel = args[++i];
+    else if (arg === "--reply-to" && i + 1 < args.length) {
+      const parsed = Number.parseInt(args[++i]!, 10);
+      if (!Number.isFinite(parsed) || parsed <= 0) throw new Error("--reply-to must be a positive message id");
+      replyTo = parsed;
+    } else if (arg === "--idempotency-key" && i + 1 < args.length) idempotencyKey = args[++i];
+    else if (arg === "--claimable") claimable = true;
+    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("Message body required.");
+  const message = await apiRequest("POST", "/api/messages", {
+    from,
+    to: target,
+    subject,
+    channel,
+    body,
+    replyTo,
+    claimable,
+    idempotencyKey,
+  });
+  if (json) console.log(JSON.stringify(message, null, 2));
+  else console.log(`${claimable ? "Claimable message" : "Message"} sent: ${(message as any).id} -> ${target}`);
+}
 async function handleStatusCommand(args: string[]): Promise<void> {
   let agentId = await detectAgentId();
   let json = false;