agent-relay-server 0.93.0 → 0.93.1

package/docs/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Relay API",
-    "version": "0.93.0",
+    "version": "0.93.1",
     "description": "Real-time message bus for inter-agent communication. Agent-first: this spec is designed for machine consumption — agents can self-discover the full API surface via GET /api/spec.",
     "license": {
       "name": "MIT",

package/package.json

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

package/src/mcp/tools-messaging.ts

@@ -46,7 +46,7 @@ const VALID_ARTIFACT_ENTITY_TYPES = ["message", "task", "recipeRun", "recipeStep
 export const MESSAGING_TOOLS: ToolDefinition[] = [
   {
     name: "relay_send_message",
-    description: "Send an Agent Relay message. Returns a delivery receipt (delivered/expectReply/recipients): if expectReply is false, no live recipient exists — don't wait for a reply. An ambiguous target is rejected up front. An unknown target is stored for delivery once that id registers (the receipt reports delivered:false with empty recipients and a reason) — never silently dropped.",
+    description: "Send an Agent Relay message. Accepts message as an alias for body. Returns a delivery receipt (delivered/expectReply/recipients): if expectReply is false, no live recipient exists — don't wait for a reply. An ambiguous target is rejected up front. An unknown target is stored for delivery once that id registers (the receipt reports delivered:false with empty recipients and a reason) — never silently dropped.",
     requiredScopes: ["messages:write", "message:send"],
     inputSchema: {
       type: "object",
@@ -54,6 +54,7 @@ export const MESSAGING_TOOLS: ToolDefinition[] = [
         from: { type: "string", description: "Deprecated/optional. Your identity is taken from your auth token; ignored for managed agents. You never need to set this." },
         to: { type: "string", description: "Target: an agent id, label, name, or a unique id segment (e.g. the number part) — resolved automatically. Or a fan-out selector: tag:, cap:, label:, team:, policy:, or broadcast." },
         body: { type: "string" },
+        message: { type: "string", description: "Alias for body." },
         kind: { type: "string", enum: ["chat", "channel.event", "task", "pair", "control", "system", "session"] },
         subject: { type: "string" },
         channel: { type: "string" },
@@ -64,13 +65,13 @@ export const MESSAGING_TOOLS: ToolDefinition[] = [
         payload: { type: "object" },
         meta: { type: "object" },
       },
-      required: ["to", "body"],
+      required: ["to"],
       additionalProperties: false,
     },
   },
   {
     name: "relay_reply",
-    description: "Reply to an Agent Relay message by id, preserving reply/thread/channel context. Returns a delivery receipt; expectReply:false means the original sender is no longer reachable.",
+    description: "Reply to an Agent Relay message by id, preserving reply/thread/channel context. Accepts message as an alias for body. Returns a delivery receipt; expectReply:false means the original sender is no longer reachable.",
     requiredScopes: ["messages:write", "message:send"],
     inputSchema: {
       type: "object",
@@ -78,13 +79,14 @@ export const MESSAGING_TOOLS: ToolDefinition[] = [
         from: { type: "string", description: "Deprecated/optional. Your identity is taken from your auth token; ignored for managed agents. You never need to set this." },
         messageId: { type: "integer", minimum: 1 },
         body: { type: "string" },
+        message: { type: "string", description: "Alias for body." },
         subject: { type: "string" },
         format: { type: "string", enum: ["text", "markdown", "markdownv2"] },
         attachments: { type: "array", items: { type: "object" } },
         payload: { type: "object" },
         meta: { type: "object" },
       },
-      required: ["messageId", "body"],
+      required: ["messageId"],
       additionalProperties: false,
     },
   },
@@ -240,7 +242,7 @@ export function relaySendMessage(auth: McpAuthContext, args: Record<string, unkn
         at: deliveryTime,
         kind,
         channel,
-        body: stringField(args.body, "body", { required: true, maxBytes: MAX_BODY_BYTES }),
+        body: messageBody(args),
         subject: optionalString(args.subject, "subject", 200),
         claimable,
         payload,
@@ -258,7 +260,7 @@ export function relaySendMessage(auth: McpAuthContext, args: Record<string, unkn
     to: stringField(args.to, "to", { required: true, max: 200 }),
     kind,
     channel,
-    body: stringField(args.body, "body", { required: true, maxBytes: MAX_BODY_BYTES }),
+    body: messageBody(args),
     subject: optionalString(args.subject, "subject", 200),
     claimable,
     idempotencyKey: optionalString(args.idempotencyKey, "idempotencyKey", 240),
@@ -283,7 +285,7 @@ export function relayReply(auth: McpAuthContext, args: Record<string, unknown>):
   return runMcpSend(auth, {
     from: optionalString(args.from, "from", 200) ?? "",
     to: "",
-    body: stringField(args.body, "body", { required: true, maxBytes: MAX_BODY_BYTES }),
+    body: messageBody(args),
     subject: optionalString(args.subject, "subject", 200),
     replyTo: parent.id,
     attachments,
@@ -292,6 +294,12 @@ export function relayReply(auth: McpAuthContext, args: Record<string, unknown>):
   });
 }
 
+function messageBody(args: Record<string, unknown>): string {
+  const value = args.body ?? args.message;
+  if (value === undefined || value === null) throw new ValidationError("body (or its alias message) is required");
+  return stringField(value, "body", { required: true, maxBytes: MAX_BODY_BYTES });
+}
+
 export function relayGetMessage(args: Record<string, unknown>): Record<string, unknown> {
   const messageId = positiveId(args.messageId, "messageId");
   const message = getMessage(messageId);

package/src/mcp/tools-scheduler.ts

@@ -2,7 +2,7 @@ import { McpAuthError } from "../mcp-errors";
 import { authContextFromMcp } from "../services/auth-context";
 import { ServiceAuthError } from "../services/errors";
 import { cancelTimer, listTimers, scheduleTimer, type ScheduleTimerInput } from "../services/scheduler";
-import type { ScheduledTimer } from "../db";
+import { ValidationError, type ScheduledTimer } from "../db";
 import type { McpAuthContext, ToolDefinition } from "./types";
 import { optionalBoolean, optionalPositiveInt, optionalRecord, optionalString, stringField } from "./validation";
 
@@ -45,14 +45,14 @@ export const SCHEDULER_TOOLS: ToolDefinition[] = [
   },
   {
     name: "relay_cancel_timer",
-    description: "Cancel one of your durable Relay timers. Admin callers may cancel any timer.",
+    description: "Cancel one of your durable Relay timers. Accepts id as an alias for timerId, matching the id returned by relay_schedule_timer. Admin callers may cancel any timer.",
     requiredScopes: ["schedule:write"],
     inputSchema: {
       type: "object",
       properties: {
         timerId: { type: "string" },
+        id: { type: "string", description: "Alias for timerId (matches the `id` field returned by relay_schedule_timer)." },
       },
-      required: ["timerId"],
       additionalProperties: false,
     },
   },
@@ -77,10 +77,16 @@ export function relayListTimers(auth: McpAuthContext, args: Record<string, unkno
 
 export function relayCancelTimer(auth: McpAuthContext, args: Record<string, unknown>): Record<string, unknown> {
   return withAuthErrors(() => ({
-    timer: serializeTimer(cancelTimer(stringField(args.timerId, "timerId", { required: true, max: 120 }), authContextFromMcp(authContextPayload(auth)))),
+    timer: serializeTimer(cancelTimer(timerIdArg(args), authContextFromMcp(authContextPayload(auth)))),
   }));
 }
 
+function timerIdArg(args: Record<string, unknown>): string {
+  const value = args.timerId ?? args.id;
+  if (value === undefined || value === null) throw new ValidationError("timerId (or its alias id) is required");
+  return stringField(value, "timerId", { required: true, max: 120 });
+}
+
 function cleanScheduleInput(args: Record<string, unknown>): ScheduleTimerInput {
   return {
     target: optionalString(args.target, "target", 200),