agent-relay 12.4.0 → 13.0.0

package/dist/index.cjs

@@ -303,7 +303,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // ../../node_modules/@relaycast/sdk/dist/version.js
-var SDK_VERSION = "8.11.5";
+var SDK_VERSION = "8.14.0";
 
 // ../../node_modules/zod/v4/classic/external.js
 var external_exports = {};
@@ -20052,6 +20052,11 @@ var AgentStatusSchema = external_exports.enum(["online", "offline", "away"]);
 var AgentSchema = external_exports.object({
   id: external_exports.string(),
   name: external_exports.string(),
+  /**
+   * `agent@machine` for `address` on POST /v1/dm; `machine` is `direct` for a
+   * self-connected agent. Null when the agent is not hosted anywhere.
+   */
+  address: external_exports.string().nullable().optional(),
   type: AgentTypeSchema,
   status: AgentStatusSchema,
   persona: external_exports.string().nullable(),
@@ -20186,6 +20191,8 @@ var CoreMessagePayloadSchema = external_exports.object({
   agent_id: external_exports.string(),
   agent_name: external_exports.string(),
   agent_type: AgentTypeSchema.optional(),
+  /** Sender's `agent@machine` address at send time; present on direct messages. */
+  agent_address: external_exports.string().optional(),
   text: external_exports.string(),
   injection_mode: MessageInjectionModeSchema.optional(),
   attachments: external_exports.array(FileAttachmentSchema).optional(),
@@ -20531,6 +20538,8 @@ var DeliveryMessageSchema = external_exports.object({
   channel_id: external_exports.string(),
   agent_id: external_exports.string().nullable(),
   agent_name: external_exports.string().nullable(),
+  /** Sender's `agent@machine` at send time; present on direct messages. */
+  agent_address: external_exports.string().optional(),
   text: external_exports.string(),
   thread_id: external_exports.string().nullable(),
   created_at: external_exports.string()
@@ -20600,7 +20609,8 @@ var DmParticipantSchema = external_exports.object({
 });
 var DmInjectionModeSchema = MessageInjectionModeSchema;
 var SendDmRequestSchema = external_exports.object({
-  to: external_exports.string(),
+  to: external_exports.string().optional(),
+  address: external_exports.string().optional(),
   text: external_exports.string(),
   attachments: external_exports.array(external_exports.string()).optional(),
   data: external_exports.record(external_exports.string(), external_exports.unknown()).nullable().optional(),
@@ -20686,6 +20696,7 @@ var ChannelMessagePayloadSchema = CoreMessagePayloadSchema.extend({
 var MessageCreatedEventSchema = external_exports.object({
   id: external_exports.string().uuid(),
   type: external_exports.literal("message.created"),
+  created_at: external_exports.string().optional(),
   channel: external_exports.string(),
   message: ChannelMessagePayloadSchema
 });
@@ -21540,6 +21551,8 @@ var FleetActionInvokeMessageSchema = external_exports.object({
   action: external_exports.string(),
   agent_id: external_exports.string().optional(),
   agent_name: external_exports.string().optional(),
+  caller_id: external_exports.string().optional(),
+  caller_name: external_exports.string().optional(),
   input: FleetWireJsonValueSchema,
   task_execution: FleetTaskExecutionSchema.optional()
 }).strict();
@@ -22173,12 +22186,14 @@ var WsClient = class {
       console.warn('[relaycast] Dropped node event: missing or invalid "type" field', transformed);
     }
   }
+  /** Normalize a direct-node delivery into the public workspace event shape. */
   transformServerLikeEvent(eventType, data) {
     switch (eventType) {
       case "message.created":
         return {
           id: stableRelaycastEventId(String(data.id ?? "")),
           type: "message.created",
+          ...typeof data.created_at === "string" ? { created_at: data.created_at } : {},
           channel: data.channel_name,
           message: {
             id: data.id,
@@ -22186,7 +22201,8 @@ var WsClient = class {
             agent_name: data.from_name,
             text: data.text,
             attachments: Array.isArray(data.attachments) ? data.attachments : [],
-            ...typeof data.injection_mode === "string" ? { injection_mode: data.injection_mode } : {}
+            ...typeof data.injection_mode === "string" ? { injection_mode: data.injection_mode } : {},
+            ...isRecord(data.metadata) ? { metadata: data.metadata } : {}
           }
         };
       case "thread.reply":
@@ -22742,6 +22758,17 @@ var AgentClient = class {
     };
     return this.client.post("/v1/dm", body, idempotencyHeaders(opts));
   }
+  /** DM an `agent@machine` address; fails if the agent is no longer on that machine. */
+  async sendTo(address, text, opts) {
+    const body = {
+      address,
+      text,
+      ...opts?.attachments ? { attachments: opts.attachments } : {},
+      ...opts?.data !== void 0 ? { data: opts.data } : {},
+      mode: opts?.mode ?? "wait"
+    };
+    return this.client.post("/v1/dm", body, idempotencyHeaders(opts));
+  }
   dms = {
     conversations: (opts) => {
       const query = {};
@@ -25857,14 +25884,6 @@ function toRelayTrigger(raw) {
     enabled: readBoolean(trigger, "enabled") ?? true
   };
 }
-function toRelayWorkspaceFleetNodesConfig(raw) {
-  const record2 = asRecord(raw);
-  return {
-    enabled: readBoolean(record2, "enabled") ?? false,
-    defaultEnabled: readBoolean(record2, "defaultEnabled", "default_enabled") ?? false,
-    override: readBoolean(record2, "override") ?? null
-  };
-}
 function normalizeActionInvocationAck(raw) {
   const record2 = asRecord(raw);
   return {
@@ -26013,6 +26032,8 @@ function placementActionName(capability) {
 function placementActionInput(input2, placement) {
   const payload = { ...input2 ?? {} };
   payload.capability = placement.capability;
+  if (placement.verifyReady)
+    payload.verify_ready = true;
   if (placement.node) {
     payload.node = placement.node;
     payload.target_node = placement.node;
@@ -26044,9 +26065,21 @@ var DEFAULT_CONFIRM_POLL_MS = 500;
 var MAX_CONFIRM_TIMEOUT_MS = 2147483647;
 var CONFIRM_SUCCESS_STATUSES = /* @__PURE__ */ new Set(["completed", "succeeded", "success"]);
 var CONFIRM_FAILURE_STATUSES = /* @__PURE__ */ new Set(["failed", "error", "denied", "cancelled", "canceled"]);
-function hasExplicitSpawnReadinessProof(value) {
+function hasSpawnReadinessProof(value) {
   return value.output?.spawned === true && value.output?.ready === true;
 }
+function hasSpawnLaunchProof(value) {
+  return value.output?.spawned === true && typeof value.output?.ready === "boolean";
+}
+function hasSpawnProof(value, requireReadiness) {
+  return requireReadiness ? hasSpawnReadinessProof(value) : hasSpawnLaunchProof(value);
+}
+function spawnProofError(node2, status, action, output2, requireReadiness) {
+  if (output2?.spawned === true && typeof output2.ready !== "boolean") {
+    return requireReadiness ? `node '${node2}' handler did not honour verify_ready: missing explicit spawned:true and ready:true proof; upgrade to a release containing Relay PR #1708` : `node '${node2}' reported ${status} for ${action} without an explicit ready boolean; upgrade to a release containing Relay PR #1708`;
+  }
+  return `node '${node2}' reported ${status} for ${action} without explicit ${requireReadiness ? "spawned:true and ready:true" : "spawned:true and a ready boolean"} proof`;
+}
 var READ_TIMED_OUT = /* @__PURE__ */ Symbol("relay.confirm.readTimedOut");
 function confirmDurationMs(value, fallback, max) {
   return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.min(value, max) : fallback;
@@ -26450,7 +26483,10 @@ var RelaycastMessagingClient = class {
           if (decision.node) {
             const actionName = input2.actionName ?? placementActionName(capability);
             const clientMustTarget = Boolean(targetNode || repo || sandboxOnly);
+            const verifyReady = input2.verifyReady ?? (input2.confirm === true && capability.startsWith("spawn:") && capability !== "spawn:persona");
+            const requireReadiness = verifyReady || capability === "spawn:persona";
             const actionInput = placementActionInput(input2.input, {
+              verifyReady,
               capability,
               ...clientMustTarget ? { node: decision.node.name } : {},
               repo,
@@ -26473,8 +26509,8 @@ var RelaycastMessagingClient = class {
               });
             }
             const ackOutput = ack.output;
-            if (!input2.confirm && capability.startsWith("spawn:") && ackStatus && CONFIRM_SUCCESS_STATUSES.has(ackStatus) && !hasExplicitSpawnReadinessProof({ output: ackOutput })) {
-              throw new RelayPlacementError("spawn_failed", `node '${placedNodeLabel}' reported ${ackStatus} for ${actionName} without explicit spawned:true and ready:true proof`, {
+            if (!input2.confirm && capability.startsWith("spawn:") && ackStatus && CONFIRM_SUCCESS_STATUSES.has(ackStatus) && !hasSpawnProof({ output: ackOutput }, requireReadiness)) {
+              throw new RelayPlacementError("spawn_failed", spawnProofError(placedNodeLabel, ackStatus, actionName, ackOutput, requireReadiness), {
                 capability,
                 node: placedNodeLabel,
                 repo,
@@ -26490,6 +26526,9 @@ var RelaycastMessagingClient = class {
               node: placedNodeLabel,
               repo,
               attempts,
+              // The mode this request actually asked the broker for, so the
+              // poll judges the same contract the invocation carried.
+              requireReadiness,
               // Defaults and validation live in confirmPlacementInvocation
               // so a direct caller cannot bypass them.
               timeoutMs: input2.confirmTimeoutMs,
@@ -26505,7 +26544,10 @@ var RelaycastMessagingClient = class {
                 attempts,
                 queued,
                 confirmed: Boolean(confirmation),
-                state: confirmation ? "ready" : "accepted"
+                // `ready` means proven harness readiness. A confirmation that
+                // only judged the launch contract (`verifyReady: false`) is
+                // confirmed, not ready.
+                state: confirmation && requireReadiness ? "ready" : "accepted"
               },
               ...confirmation ? { confirmation } : {}
             };
@@ -26587,7 +26629,7 @@ var RelaycastMessagingClient = class {
    * pending success — it times out as `spawn_unconfirmed`.
    */
   async confirmPlacementInvocation(actionName, ack, context) {
-    const { timeoutMs, pollIntervalMs, ...errorContext } = context;
+    const { timeoutMs, pollIntervalMs, requireReadiness, ...errorContext } = context;
     const invocationId = ack.invocationId;
     const dispatchState = resolveDispatchState(ack);
     if (!invocationId) {
@@ -26616,8 +26658,8 @@ var RelaycastMessagingClient = class {
             const invocation = outcome.value;
             const status = invocation?.status?.toLowerCase();
             if (status && CONFIRM_SUCCESS_STATUSES.has(status)) {
-              if (errorContext.capability.startsWith("spawn:") && !hasExplicitSpawnReadinessProof(invocation)) {
-                throw new RelayPlacementError("spawn_failed", `node '${context.node}' reported ${status} for ${actionName} without explicit spawned:true and ready:true proof`, {
+              if (errorContext.capability.startsWith("spawn:") && !hasSpawnProof(invocation, requireReadiness)) {
+                throw new RelayPlacementError("spawn_failed", spawnProofError(context.node, status, actionName, invocation.output, requireReadiness), {
                   ...errorContext,
                   state: "failed",
                   invocationId,
@@ -26666,17 +26708,6 @@ var RelaycastMessagingClient = class {
         throw new Error("RelaycastMessagingClient.workspace.info requires the relaycast workspace API.");
       }
       return await this.relaycast.workspace.info();
-    },
-    fleetNodes: {
-      get: async () => {
-        return toRelayWorkspaceFleetNodesConfig(await this.requireWorkspaceFleetNodes().get());
-      },
-      set: async (enabled) => {
-        return toRelayWorkspaceFleetNodesConfig(await this.requireWorkspaceFleetNodes().set(enabled));
-      },
-      inherit: async () => {
-        return toRelayWorkspaceFleetNodesConfig(await this.requireWorkspaceFleetNodes().inherit());
-      }
     }
   };
   resolvePlacementNode(node2, selfNodeName) {
@@ -26838,12 +26869,6 @@ var RelaycastMessagingClient = class {
     }
     return this.relaycast.triggers;
   }
-  requireWorkspaceFleetNodes() {
-    if (!this.relaycast.workspace?.fleetNodes) {
-      throw new Error("RelaycastMessagingClient.workspace.fleetNodes requires @relaycast/sdk with the workspace fleet nodes API.");
-    }
-    return this.relaycast.workspace.fleetNodes;
-  }
   requireAgentActions(operation) {
     const actions = this.agentClient?.actions;
     if (!actions) {
@@ -27709,7 +27734,6 @@ function createWorkspaceFacade(messaging, deps) {
   };
   return {
     info: () => messaging.workspace.info(),
-    fleetNodes: messaging.workspace.fleetNodes,
     register,
     release: async (input2) => {
       if (!deps) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "12.4.0",
+  "version": "13.0.0",
   "description": "Real-time agent-to-agent communication system",
   "type": "module",
   "main": "dist/index.cjs",
@@ -43,20 +43,20 @@
     "pack:validate": "npm pack --dry-run"
   },
   "dependencies": {
-    "@agent-relay/cli-surface": "12.4.0",
-    "@agent-relay/cloud": "12.4.0",
-    "@agent-relay/config": "12.4.0",
-    "@agent-relay/fleet": "12.4.0",
-    "@agent-relay/harness-driver": "12.4.0",
-    "@agent-relay/harnesses": "12.4.0",
-    "@agent-relay/sdk": "12.4.0",
-    "@agent-relay/session": "12.4.0",
-    "@agent-relay/utils": "12.4.0",
+    "@agent-relay/cli-surface": "13.0.0",
+    "@agent-relay/cloud": "13.0.0",
+    "@agent-relay/config": "13.0.0",
+    "@agent-relay/fleet": "13.0.0",
+    "@agent-relay/harness-driver": "13.0.0",
+    "@agent-relay/harnesses": "13.0.0",
+    "@agent-relay/sdk": "13.0.0",
+    "@agent-relay/session": "13.0.0",
+    "@agent-relay/utils": "13.0.0",
     "@modelcontextprotocol/sdk": "^1.23.0",
     "@relayfile/client": "^0.10.27",
     "@relayfile/sdk": "^0.10.64",
     "@relayflows/cli": "1.0.1",
-    "@relayflows/sdk": "^2.0.19",
+    "@relayflows/sdk": "2.0.22",
     "@xterm/headless": "^6.0.0",
     "ai-hist": "^0.18.1",
     "commander": "^12.1.0",