agent-relay 11.8.4 → 11.8.5

package/dist/index.cjs

@@ -20644,8 +20644,13 @@ function placementActionName(capability) {
 function placementActionInput(input, placement) {
   const payload = { ...input ?? {} };
   payload.capability = placement.capability;
-  payload.node = placement.node;
-  payload.target_node = placement.node;
+  if (placement.node) {
+    payload.node = placement.node;
+    payload.target_node = placement.node;
+  } else {
+    delete payload.node;
+    delete payload.target_node;
+  }
   if (placement.repo)
     payload.repo = placement.repo;
   if (placement.ttlMs > 0) {
@@ -20694,6 +20699,7 @@ var RelaycastMessagingClient = class {
   agentClient;
   selfNodeName;
   placementTtlMs;
+  placementSandboxOnly;
   maxQueuedPlacements;
   placementLog;
   sessionRef;
@@ -20705,6 +20711,7 @@ var RelaycastMessagingClient = class {
     this.agentClient = options.agentClient ?? (options.agentToken ? this.relaycast.as?.(options.agentToken, options.agentClientOptions) : void 0);
     this.selfNodeName = options.selfNodeName;
     this.placementTtlMs = options.placementTtlMs ?? 60 * 60 * 1e3;
+    this.placementSandboxOnly = options.placementSandboxOnly ?? false;
     this.maxQueuedPlacements = options.maxQueuedPlacements ?? 100;
     this.placementLog = options.placementLog;
     this.sessionRef = options.sessionRef === void 0 ? currentReplaySessionRef() : resolveReplaySessionRef(options.sessionRef);
@@ -21057,6 +21064,8 @@ var RelaycastMessagingClient = class {
       const capability = nonEmptyPlacement(input.capability, "placement capability");
       const repo = input.repo?.trim() || void 0;
       const targetNode = this.resolvePlacementNode(input.node, input.selfNodeName);
+      const sandboxOnly = input.sandboxOnly ?? this.placementSandboxOnly;
+      const failFast = input.failFast ?? true;
       const ttlMs = Math.max(0, input.ttlMs ?? input.ttlOverrideMs ?? this.placementTtlMs);
       const pollIntervalMs = Math.max(25, input.pollIntervalMs ?? 1e3);
       const startedAt = Date.now();
@@ -21065,19 +21074,22 @@ var RelaycastMessagingClient = class {
       try {
         while (true) {
           attempts += 1;
-          const decision = await this.selectPlacementNode({ capability, repo, targetNode });
+          const decision = await this.selectPlacementNode({ capability, repo, targetNode, sandboxOnly });
           if (decision.node) {
             const actionName = input.actionName ?? placementActionName(capability);
+            const clientMustTarget = Boolean(targetNode || repo || sandboxOnly);
             const actionInput = placementActionInput(input.input, {
               capability,
-              node: decision.node.name,
+              ...clientMustTarget ? { node: decision.node.name } : {},
               repo,
               ttlMs
             });
             const ack = await this.commands.invoke(actionName, actionInput);
+            const placedNode = clientMustTarget ? decision.node : await this.resolvePlacementAckNode(ack, capability);
+            const placedNodeLabel = placedNode?.name ?? ack.dispatchedNodeId ?? ack.handlerNodeId ?? "engine-selected node";
             const confirmation = input.confirm ? await this.confirmPlacementInvocation(actionName, ack, {
               capability,
-              node: decision.node.name,
+              node: placedNodeLabel,
               repo,
               attempts,
               // Defaults and validation live in confirmPlacementInvocation
@@ -21087,10 +21099,10 @@ var RelaycastMessagingClient = class {
             }) : void 0;
             return {
               ...ack,
-              node: decision.node,
+              ...placedNode ? { node: placedNode } : {},
               placement: {
                 capability,
-                node: decision.node.name,
+                ...placedNode ? { node: placedNode.name } : {},
                 ...repo ? { repo } : {},
                 attempts,
                 queued,
@@ -21108,9 +21120,9 @@ var RelaycastMessagingClient = class {
               attempts
             });
           }
-          if (input.failFast || Date.now() - startedAt >= ttlMs) {
-            const code = decision.reconcileReason === "unmapped_repo" ? "unmapped_repo" : "placement_ttl_expired";
-            const message = code === "unmapped_repo" ? `${decision.message}; no node maps the requested repo` : `${decision.message}; placement TTL expired`;
+          if (failFast || Date.now() - startedAt >= ttlMs) {
+            const code = failFast ? decision.reconcileReason === "unmapped_repo" ? "unmapped_repo" : decision.reconcileReason === "target_offline" ? "node_unavailable" : decision.reconcileReason === "sandbox_policy_mismatch" ? "sandbox_policy_mismatch" : "no_eligible_node" : decision.reconcileReason === "unmapped_repo" ? "unmapped_repo" : "placement_ttl_expired";
+            const message = code === "unmapped_repo" ? `${decision.message}; no node maps the requested repo` : failFast ? `${decision.message}; placement failed fast` : `${decision.message}; placement TTL expired`;
             await this.reconcilePlacement(input, {
               action: "failed",
               reason: decision.reconcileReason,
@@ -21270,9 +21282,17 @@ var RelaycastMessagingClient = class {
           reconcileReason: "no_eligible_node"
         };
       }
-      if (!node.live) {
+      if (input.sandboxOnly && !this.nodeIsCloudSandbox(node)) {
+        return {
+          message: `Placement rejected: node "${node.name}" is not a Cloud sandbox`,
+          hardFail: true,
+          reason: "sandbox_policy_mismatch",
+          reconcileReason: "sandbox_policy_mismatch"
+        };
+      }
+      if (!this.nodeIsPlacementReady(node)) {
         return {
-          message: `Placement queued: target node "${node.name}" is offline`,
+          message: `Placement queued: target node "${node.name}" is not placement-ready`,
           reconcileReason: "target_offline"
         };
       }
@@ -21286,10 +21306,17 @@ var RelaycastMessagingClient = class {
     }
     const nodes = await this.nodes.list({ capability: input.capability });
     const capable = nodes.filter((node) => this.nodeHasCapability(node, input.capability));
-    const live = capable.filter((node) => node.live);
+    const policyEligible = input.sandboxOnly ? capable.filter((node) => this.nodeIsCloudSandbox(node)) : capable;
+    const live = policyEligible.filter((node) => this.nodeIsPlacementReady(node));
     const eligible = live.filter((node) => this.nodeMapsRepo(node, input.repo));
     if (eligible[0])
       return { node: eligible[0] };
+    if (input.sandboxOnly) {
+      return {
+        message: `Placement queued: no placement-ready Cloud sandbox advertises capability "${input.capability}"`,
+        reconcileReason: "sandbox_policy_mismatch"
+      };
+    }
     if (input.repo && live.length > 0) {
       return {
         message: `Placement queued: no live node advertising "${input.capability}" maps repo "${input.repo}"`,
@@ -21304,6 +21331,29 @@ var RelaycastMessagingClient = class {
   nodeHasCapability(node, capability) {
     return node.capabilities.some((item) => item.name === capability);
   }
+  /** Return true only when the fresh roster reports a usable action handler. */
+  nodeIsPlacementReady(node) {
+    return node.status === "online" && node.live === true && node.handlersLive === true;
+  }
+  /** Match the stable Cloud JIT provenance tag without relying on disposable node names. */
+  nodeIsCloudSandbox(node) {
+    return Boolean(node.tags?.some((tag) => /^cloud:node-type:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?-jit$/.test(tag)));
+  }
+  async resolvePlacementAckNode(ack, capability) {
+    const nodeId = ack.dispatchedNodeId ?? ack.handlerNodeId;
+    if (nodeId) {
+      try {
+        const nodes = await this.nodes.list({ capability });
+        return nodes.find((candidate) => candidate.id === nodeId || candidate.nodeId === nodeId);
+      } catch (error51) {
+        try {
+          this.placementLog?.(`[placement] dispatch ${ack.invocationId ?? "unknown"} accepted by ${nodeId}, but roster metadata could not be refreshed: ${error51 instanceof Error ? error51.message : String(error51)}`);
+        } catch {
+        }
+      }
+    }
+    return void 0;
+  }
   nodeMapsRepo(node, repo) {
     if (!repo)
       return true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "11.8.4",
+  "version": "11.8.5",
   "description": "Real-time agent-to-agent communication system",
   "type": "module",
   "main": "dist/index.cjs",
@@ -43,14 +43,14 @@
     "pack:validate": "npm pack --dry-run"
   },
   "dependencies": {
-    "@agent-relay/cloud": "11.8.4",
-    "@agent-relay/config": "11.8.4",
-    "@agent-relay/fleet": "11.8.4",
-    "@agent-relay/harness-driver": "11.8.4",
-    "@agent-relay/harnesses": "11.8.4",
-    "@agent-relay/sdk": "11.8.4",
-    "@agent-relay/session": "11.8.4",
-    "@agent-relay/utils": "11.8.4",
+    "@agent-relay/cloud": "11.8.5",
+    "@agent-relay/config": "11.8.5",
+    "@agent-relay/fleet": "11.8.5",
+    "@agent-relay/harness-driver": "11.8.5",
+    "@agent-relay/harnesses": "11.8.5",
+    "@agent-relay/sdk": "11.8.5",
+    "@agent-relay/session": "11.8.5",
+    "@agent-relay/utils": "11.8.5",
     "@modelcontextprotocol/sdk": "^1.23.0",
     "@relayfile/client": "^0.10.27",
     "@relayflows/cli": "1.0.1",