agent-relay 12.4.1 → 13.0.1

package/dist/cli/lib/spawn-lifecycle.js

@@ -24,9 +24,12 @@ export function spawnLifecycleState(value) {
         const output = value.output !== null && typeof value.output === 'object'
             ? value.output
             : value;
-        // A terminal success status without explicit launch and readiness proof is
-        // a failed spawn, not a live-but-uncertain one. Genuine uncertainty is
-        // reserved for non-terminal acknowledgements and confirmation timeouts.
+        // Every caller of this receipt (MCP spawn, `fleet spawn --auto-place`)
+        // requires proven readiness. A terminal success without explicit launch and
+        // readiness proof is a failed spawn, not a live-but-uncertain one. Genuine
+        // uncertainty is reserved for non-terminal acknowledgements and confirmation
+        // timeouts. The unverified targeted path does not reach here: it keeps the
+        // SDK's own placement evidence (see `spawnInvocationWithMergedPlacement`).
         return output.spawned === true && output.ready === true ? 'ready' : 'failed';
     }
     if (status && FAILURE.has(status))

package/dist/cli/lib/spawn-lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"spawn-lifecycle.js","sourceRoot":"","sources":["../../../src/cli/lib/spawn-lifecycle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"spawn-lifecycle.js","sourceRoot":"","sources":["../../../src/cli/lib/spawn-lifecycle.ts"],"names":[],"mappings":"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"}

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.6";
+var SDK_VERSION = "8.16.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(),
@@ -20346,8 +20353,53 @@ var WorkspaceSchema = external_exports.object({
   classification_reason: external_exports.string().nullable().default(null),
   classified_at: external_exports.string().nullable().default(null)
 });
+var WORKSPACE_METADATA_MAX_BYTES = 16 * 1024;
+var WORKSPACE_METADATA_MAX_KEYS = 100;
+var WORKSPACE_METADATA_MAX_DEPTH = 8;
+var WORKSPACE_METADATA_MAX_KEY_LENGTH = 128;
+function metadataProblem(value, depth = 0) {
+  if (value === null || typeof value === "string" || typeof value === "boolean")
+    return;
+  if (typeof value === "number" && Number.isFinite(value))
+    return;
+  if (depth > WORKSPACE_METADATA_MAX_DEPTH)
+    return "metadata must contain at most 8 nested object/array levels below its root";
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      const problem = metadataProblem(item, depth + 1);
+      if (problem)
+        return problem;
+    }
+    return;
+  }
+  if (typeof value !== "object" || !value || Object.getPrototypeOf(value) !== Object.prototype) {
+    return "metadata values must be JSON values";
+  }
+  for (const [key, item] of Object.entries(value)) {
+    if ([...key].length > WORKSPACE_METADATA_MAX_KEY_LENGTH)
+      return "metadata keys must be at most 128 Unicode code points";
+    const normalized = key.replace(/([a-z0-9])([A-Z])/g, "$1_$2").toLowerCase();
+    if (["__proto__", "prototype", "constructor"].includes(key) || /(?:^|[^a-z0-9])(?:tokens?|secrets?|passwords?|passwd|authorization|credentials?)(?:$|[^a-z0-9])/.test(normalized) || /(?:api|private|access|refresh)[^a-z0-9]*keys?/.test(normalized) || normalized.split(/[^a-z0-9]+/).some((part) => /^(?:(?:access|refresh|api|auth|bearer|session|client|id)tokens?|(?:client|app|shared|signing|webhook|consumer)secrets?|secretkeys?|password(?:hash|digest|salt))$/.test(part))) {
+      return "metadata must not contain secret-like keys";
+    }
+    const problem = metadataProblem(item, depth + 1);
+    if (problem)
+      return problem;
+  }
+}
+var WorkspaceMetadataSchema = external_exports.unknown().superRefine((metadata, ctx) => {
+  const problem = metadata && typeof metadata === "object" && Object.keys(metadata).length > WORKSPACE_METADATA_MAX_KEYS ? "metadata must contain at most 100 top-level keys" : metadataProblem(metadata);
+  if (problem) {
+    ctx.addIssue({ code: "custom", message: problem });
+    return;
+  }
+  if (new TextEncoder().encode(JSON.stringify(metadata)).byteLength > WORKSPACE_METADATA_MAX_BYTES) {
+    ctx.addIssue({ code: "custom", message: "metadata must be at most 16384 UTF-8 bytes" });
+  }
+}).pipe(external_exports.record(external_exports.string(), external_exports.unknown()));
 var CreateWorkspaceRequestSchema = external_exports.object({
   name: external_exports.string(),
+  metadata: WorkspaceMetadataSchema.optional(),
   expires_in_seconds: external_exports.number().int().min(60).max(30 * 24 * 60 * 60).optional(),
   provenance: WorkspaceProvenanceInputSchema.optional()
 });
@@ -20363,6 +20415,7 @@ var WorkspaceLookupSchema = external_exports.object({
   created_at: external_exports.string()
 });
 var UpdateWorkspaceRequestSchema = external_exports.object({
+  metadata: WorkspaceMetadataSchema.optional(),
   name: external_exports.string().optional(),
   system_prompt: external_exports.string().nullable().optional()
 });
@@ -20531,6 +20584,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 +20655,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 +20742,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
 });
@@ -21247,6 +21304,15 @@ var telemetryPropertiesSchema = external_exports.record(telemetryKeySchema, tele
     });
   }
 });
+var TELEMETRY_CLOUD_ID_MAX_LENGTH = 128;
+var telemetryGroupsSchema = external_exports.object({
+  organization: telemetryString(TELEMETRY_CLOUD_ID_MAX_LENGTH).optional(),
+  workspace: telemetryString(TELEMETRY_CLOUD_ID_MAX_LENGTH).optional()
+}).strict();
+var telemetryPersonSetOnceSchema = external_exports.object({
+  first_human_message_at: telemetryString(64).optional(),
+  first_agent_message_at: telemetryString(64).optional()
+}).strict();
 var telemetryEnvelopeBaseSchema = external_exports.object({
   distinct_id: telemetryString(128),
   properties: telemetryPropertiesSchema.default({})
@@ -21255,7 +21321,11 @@ var telemetryIngestionEventSchema = telemetryEnvelopeBaseSchema.extend({
   event: clientTelemetryEventSchema
 });
 var internalTelemetryEventSchema = telemetryEnvelopeBaseSchema.extend({
-  event: telemetryEventSchema
+  event: telemetryEventSchema,
+  groups: telemetryGroupsSchema.optional(),
+  set_once: telemetryPersonSetOnceSchema.optional(),
+  /** `false` for events whose distinct id is not a person (the workspace fallback). */
+  process_person_profile: external_exports.boolean().optional()
 }).merge(telemetryOriginSchema);
 
 // ../../node_modules/@relaycast/types/dist/fleet-wire.js
@@ -21540,6 +21610,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 +22245,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 +22260,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 +22817,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 = {};
@@ -23433,6 +23519,7 @@ var RelayCast = class _RelayCast {
       body: JSON.stringify({
         name,
         ...resolved.expiresInSeconds !== void 0 ? { expires_in_seconds: resolved.expiresInSeconds } : {},
+        ...resolved.metadata !== void 0 ? { metadata: resolved.metadata } : {},
         provenance: toWorkspaceProvenanceInput(resolved.provenance)
       })
     });
@@ -25857,14 +25944,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 +26092,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 +26125,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 +26543,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 +26569,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 +26586,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 +26604,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 +26689,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 +26718,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 +26768,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 +26929,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 +27794,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.1",
+  "version": "13.0.1",
   "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.1",
-    "@agent-relay/cloud": "12.4.1",
-    "@agent-relay/config": "12.4.1",
-    "@agent-relay/fleet": "12.4.1",
-    "@agent-relay/harness-driver": "12.4.1",
-    "@agent-relay/harnesses": "12.4.1",
-    "@agent-relay/sdk": "12.4.1",
-    "@agent-relay/session": "12.4.1",
-    "@agent-relay/utils": "12.4.1",
+    "@agent-relay/cli-surface": "13.0.1",
+    "@agent-relay/cloud": "13.0.1",
+    "@agent-relay/config": "13.0.1",
+    "@agent-relay/fleet": "13.0.1",
+    "@agent-relay/harness-driver": "13.0.1",
+    "@agent-relay/harnesses": "13.0.1",
+    "@agent-relay/sdk": "13.0.1",
+    "@agent-relay/session": "13.0.1",
+    "@agent-relay/utils": "13.0.1",
     "@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",