agent-relay 12.0.0 → 12.1.0

package/dist/cli/lib/sdk-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-command.js","sourceRoot":"","sources":["../../../src/cli/lib/sdk-command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAwB,MAAM,kBAAkB,CAAC;AAE3F,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAyB,MAAM,iBAAiB,CAAC;AAchG,MAAM,UAAU,eAAe,CAAC,YAAqC,EAAE;IACrE,OAAO;QACL,gBAAgB;QAChB,oBAAoB;QACpB,eAAe,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACjF,GAAG,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACjD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QACrD,IAAI,EAAE,WAAW;QACjB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO,CACL,OAAO;SACJ,MAAM,CACL,uBAAuB,EACvB,yEAAyE,CAC1E;SACA,MAAM,CAAC,YAAY,EAAE,2BAA2B,CAAC;SACjD,MAAM,CAAC,iBAAiB,EAAE,6CAA6C,CAAC;SACxE,MAAM,CAAC,kBAAkB,EAAE,wDAAwD,CAAC;QACrF,6EAA6E;QAC7E,iFAAiF;QACjF,8EAA8E;QAC9E,yDAAyD;SACxD,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACxE,WAAW,CAAC,cAAc,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC,CAAC,CACL,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAA6B;IAC9D,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,YAAkC;QACrD,KAAK,EAAE,IAAI,CAAC,KAA2B;QACvC,OAAO,EAAE,IAAI,CAAC,OAA6B;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAoB,EAAE,KAAc;IAC5D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAoB,EAAE,EAAuB;IACxE,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,CAAC;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"sdk-command.js","sourceRoot":"","sources":["../../../src/cli/lib/sdk-command.ts"],"names":[],"mappings":"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"}

package/dist/cli/lib/spawn-lifecycle.d.ts

@@ -0,0 +1,12 @@
+export type SpawnLifecycleState = 'accepted' | 'ready' | 'unconfirmed_may_be_running' | 'failed';
+export type SpawnDispatchState = 'dispatched' | 'not_dispatched' | 'unknown';
+export declare function spawnLifecycleState(value: Record<string, unknown>): SpawnLifecycleState;
+/**
+ * Project an upstream spawn invocation record down to an allowlisted set of
+ * lifecycle-evidence fields, dropping raw error text, task payloads, and any
+ * other upstream data that should not cross a CLI/MCP serialization
+ * boundary unsanitized.
+ */
+export declare function sanitizedSpawnReceipt(value: Record<string, unknown>): Record<string, unknown>;
+export declare function spawnPlacementReceipt(value: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=spawn-lifecycle.d.ts.map

package/dist/cli/lib/spawn-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/spawn-lifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,OAAO,GAAG,4BAA4B,GAAG,QAAQ,CAAC;AACjG,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,gBAAgB,GAAG,SAAS,CAAC;AA0B7E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,mBAAmB,CAgBvF;AAiBD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgB7F;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW7F"}

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

@@ -0,0 +1,89 @@
+const SUCCESS = new Set(['completed', 'succeeded', 'success']);
+const FAILURE = new Set(['failed', 'error', 'cancelled', 'canceled', 'denied']);
+const DISPATCHED = new Set(['dispatched', 'invoked', 'running']);
+const NOT_DISPATCHED = new Set(['pending', 'queued']);
+function text(value) {
+    return typeof value === 'string' && value.trim() ? value : undefined;
+}
+function dispatchEvidence(value) {
+    const status = text(value.status)?.toLowerCase();
+    if (text(value.dispatchedNodeId) ||
+        text(value.dispatched_node_id) ||
+        text(value.handlerNodeId) ||
+        text(value.handler_node_id) ||
+        (status !== undefined && (DISPATCHED.has(status) || SUCCESS.has(status)))) {
+        return 'dispatched';
+    }
+    if (status !== undefined && NOT_DISPATCHED.has(status))
+        return 'not_dispatched';
+    return 'unknown';
+}
+export function spawnLifecycleState(value) {
+    const status = text(value.status)?.toLowerCase();
+    if (status && SUCCESS.has(status)) {
+        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.
+        return output.spawned === true && output.ready === true ? 'ready' : 'failed';
+    }
+    if (status && FAILURE.has(status))
+        return 'failed';
+    if (status === 'accepted')
+        return 'accepted';
+    if (status && NOT_DISPATCHED.has(status) && dispatchEvidence(value) === 'not_dispatched')
+        return 'accepted';
+    return 'unconfirmed_may_be_running';
+}
+// Allowlisted keys for a spawn receipt that crosses a CLI/MCP serialization
+// boundary. Upstream invocation records can carry arbitrary broker/handler
+// output (raw error text, task payloads, environment-derived metadata) that
+// is not safe to echo back verbatim — see relay#1563. Only lifecycle
+// evidence (status/ids/readiness) is allowlisted through.
+const SPAWN_RECEIPT_ALLOWED_KEYS = [
+    'status',
+    'invocation_id',
+    'invocationId',
+    'dispatched_node_id',
+    'dispatchedNodeId',
+    'handler_node_id',
+    'handlerNodeId',
+];
+/**
+ * Project an upstream spawn invocation record down to an allowlisted set of
+ * lifecycle-evidence fields, dropping raw error text, task payloads, and any
+ * other upstream data that should not cross a CLI/MCP serialization
+ * boundary unsanitized.
+ */
+export function sanitizedSpawnReceipt(value) {
+    const out = {};
+    for (const key of SPAWN_RECEIPT_ALLOWED_KEYS) {
+        if (value[key] !== undefined)
+            out[key] = value[key];
+    }
+    const output = value.output !== null && typeof value.output === 'object'
+        ? value.output
+        : undefined;
+    if (output && (typeof output.spawned === 'boolean' || typeof output.ready === 'boolean')) {
+        out.output = {
+            ...(typeof output.spawned === 'boolean' ? { spawned: output.spawned } : {}),
+            ...(typeof output.ready === 'boolean' ? { ready: output.ready } : {}),
+        };
+    }
+    return out;
+}
+export function spawnPlacementReceipt(value) {
+    const invocationId = text(value.invocationId) ?? text(value.invocation_id);
+    const dispatchedNodeId = text(value.dispatchedNodeId) ?? text(value.dispatched_node_id);
+    const handlerNodeId = text(value.handlerNodeId) ?? text(value.handler_node_id);
+    return {
+        state: spawnLifecycleState(value),
+        dispatchState: dispatchEvidence(value),
+        ...(invocationId ? { invocationId } : {}),
+        ...(dispatchedNodeId ? { dispatchedNodeId } : {}),
+        ...(handlerNodeId ? { handlerNodeId } : {}),
+    };
+}
+//# sourceMappingURL=spawn-lifecycle.js.map

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

@@ -0,0 +1 @@
+{"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.8.0";
+var SDK_VERSION = "8.9.1";
 
 // ../../node_modules/zod/v4/classic/external.js
 var external_exports = {};
@@ -2868,7 +2868,7 @@ ${content.join("\n")}
 var version = {
   major: 4,
   minor: 6,
-  patch: 1
+  patch: 2
 };
 
 // ../../node_modules/zod/v4/core/schemas.js
@@ -3672,7 +3672,7 @@ function handlePropertyResult(result, final, key, input2, optin, optout) {
     return;
   }
   if (result.value === void 0) {
-    if (isPresent) {
+    if (isPresent || optin === "defaulted" && !isOptionalOut) {
       final.value[key] = void 0;
     }
   } else {
@@ -3908,16 +3908,16 @@ var $ZodObjectJIT = /* @__PURE__ */ $constructor("$ZodObjectJIT", (inst, def) =>
         doc.write(`
         if (${id}.issues.length) {${prefixStr(id, k)}
         }
-        
-        if (${id}.value === undefined) {
-          if (${isPresent}) {
-            newResult[${k}] = undefined;
-          }
+      `);
+        if (optin === "defaulted") {
+          doc.write(`newResult[${k}] = ${id}.value;`);
         } else {
+          doc.write(`
+        if (${id}.value !== undefined || ${isPresent}) {
           newResult[${k}] = ${id}.value;
         }
-
       `);
+        }
       }
     }
     doc.write(`payload.value = newResult;`);
@@ -13977,7 +13977,7 @@ function generateObjectCheck(doc, ctx, schema, accessor, buildsValue = true) {
     }
   }
   const outputVar = newVar(ctx);
-  const hasConditionalKeys = allKeys.some((k) => mayOutputUndefined(propShape[k]) || dropsWhenAbsent(propShape[k]));
+  const hasConditionalKeys = allKeys.some((k) => mayOmitUndefined(propShape[k]) || dropsWhenAbsent(propShape[k]));
   if (!buildsValue) {
     if (unknownKeysMode === "schema") {
       const knownSet = keys.length > 0 ? addConstant(ctx, new Set(keys)) : null;
@@ -14004,7 +14004,7 @@ function generateObjectCheck(doc, ctx, schema, accessor, buildsValue = true) {
       const out = propOutputs.get(k);
       if (dropsWhenAbsent(propShape[k])) {
         doc.write(`if (${kx} in ${accessor}) ${outputVar}[${kx}] = ${out};`);
-      } else if (mayOutputUndefined(propShape[k])) {
+      } else if (mayOmitUndefined(propShape[k])) {
         doc.write(`if (${out} !== undefined || ${kx} in ${accessor}) ${outputVar}[${kx}] = ${out};`);
       } else {
         doc.write(`${outputVar}[${kx}] = ${out};`);
@@ -14137,6 +14137,9 @@ function fastPathAcceptsAbsence(schema) {
 function dropsWhenAbsent(schema) {
   return schema._zod.optin === "optional" && schema._zod.optout === "optional";
 }
+function mayOmitUndefined(schema) {
+  return (schema._zod.optin !== "defaulted" || schema._zod.optout === "optional") && mayOutputUndefined(schema);
+}
 function mayOutputUndefined(schema) {
   const def = schema._zod.def;
   switch (def.type) {
@@ -20133,6 +20136,9 @@ var ReleaseAgentRequestSchema = external_exports.object({
   delete_agent: external_exports.boolean().optional(),
   expected_token_hash: external_exports.string().regex(AGENT_TOKEN_HASH_PATTERN).optional()
 });
+var ExactReleaseAgentRequestSchema = ReleaseAgentRequestSchema.extend({
+  expected_agent_id: external_exports.string().min(1)
+});
 
 // ../../node_modules/@relaycast/types/dist/message.js
 var HeaderBlockSchema = external_exports.object({
@@ -21461,9 +21467,11 @@ var AgentRegisterReplyDataSchema = external_exports.object({
   // Returned only to nodes that advertise FLEET_DELIVERY_CURSOR_CAPABILITY.
   delivery_ack_seq: external_exports.number().int().nonnegative().optional()
 }).strict();
+var NODE_REGISTRATION_CONTRACT_V1 = "relay:node-registration-v1";
 var NodeRegisterReplyDataSchema = external_exports.object({
   provider: FleetProviderIdentitySchema,
-  accepted_capabilities: external_exports.array(FleetCapabilityAcceptanceSchema)
+  accepted_capabilities: external_exports.array(FleetCapabilityAcceptanceSchema),
+  registration_contract: external_exports.literal(NODE_REGISTRATION_CONTRACT_V1).optional()
 }).passthrough();
 var FleetReplyMessageSchema = external_exports.object({
   ...FleetResponseEnvelopeFields,
@@ -22937,6 +22945,7 @@ var RelayError = class extends Error {
   statusCode;
   rawCode;
   status;
+  retryAfterMs;
   constructor(code, message, options = {}) {
     super(message);
     this.name = "RelayError";
@@ -22945,14 +22954,15 @@ var RelayError = class extends Error {
     this.rawCode = options.rawCode;
     this.retryable = options.retryable ?? relayErrorRetryable(code, options.statusCode);
     this.status = options.statusCode ?? 0;
+    this.retryAfterMs = options.retryAfterMs;
     if (options.cause !== void 0) {
       this.cause = options.cause;
     }
   }
 };
-function relayErrorFromApi(rawCode, message, statusCode) {
+function relayErrorFromApi(rawCode, message, statusCode, retryAfterMs) {
   const code = normalizeRelayErrorCode(rawCode, statusCode);
-  return new RelayError(code, message, { statusCode, rawCode });
+  return new RelayError(code, message, { statusCode, rawCode, retryAfterMs });
 }
 
 // ../../node_modules/@relaycast/sdk/dist/client.js
@@ -22980,6 +22990,7 @@ var DEFAULT_RETRY_POLICY = {
   jitter: true,
   retryOn: [429, 500, 502, 503, 504]
 };
+var MAX_AUTOMATIC_RETRY_DELAY_MS = 6e4;
 function normalizeRetryPolicy(input2) {
   return {
     maxRetries: Number.isFinite(input2?.maxRetries) ? Math.max(0, Math.floor(input2.maxRetries)) : DEFAULT_RETRY_POLICY.maxRetries,
@@ -22997,7 +23008,7 @@ function computeBackoffMs(policy, retryAttempt) {
   return Math.max(0, Math.round(exponential * jitterFactor));
 }
 function parseRetryAfterMs(res) {
-  const header = res.headers.get("Retry-After");
+  const header = res.headers?.get("Retry-After");
   if (!header)
     return null;
   const asSeconds = Number(header);
@@ -23115,7 +23126,9 @@ var HttpClient = class _HttpClient {
     if (hasBody)
       headers["Content-Type"] = "application/json";
     const wireBody = hasBody ? decamelizeKeys(body) : void 0;
-    const maxRetries = options?.retry === false ? 0 : this._retryPolicy.maxRetries;
+    const idempotencyKey = Object.entries(headers).find(([name]) => name.toLowerCase() === "idempotency-key")?.[1];
+    const isUnsafeMutation = ["POST", "PATCH"].includes(method.toUpperCase()) && !idempotencyKey;
+    const maxRetries = options?.retry === false || isUnsafeMutation ? 0 : this._retryPolicy.maxRetries;
     let attempt = 0;
     while (true) {
       let res;
@@ -23135,7 +23148,7 @@ var HttpClient = class _HttpClient {
         throw new RelayError("transport_error", `Network request failed: ${err instanceof Error ? err.message : "unknown error"}`, { retryable: true, cause: err });
       }
       if (this._retryPolicy.retryOn.includes(res.status) && attempt < maxRetries) {
-        const waitMs = res.status === 429 ? parseRetryAfterMs(res) ?? computeBackoffMs(this._retryPolicy, attempt) : computeBackoffMs(this._retryPolicy, attempt);
+        const waitMs = Math.min(parseRetryAfterMs(res) ?? computeBackoffMs(this._retryPolicy, attempt), MAX_AUTOMATIC_RETRY_DELAY_MS);
         attempt += 1;
         await sleep(waitMs);
         continue;
@@ -23160,7 +23173,7 @@ var HttpClient = class _HttpClient {
         const errParsed = ApiErrorSchema.safeParse(json2);
         const code = errParsed.success ? errParsed.data.error.code : "unknown_error";
         const message = errParsed.success ? errParsed.data.error.message : "Unknown error";
-        throw relayErrorFromApi(code, message, res.status);
+        throw relayErrorFromApi(code, message, res.status, parseRetryAfterMs(res) ?? void 0);
       }
       const data = envelope.data.data;
       const parsedData = options?.schema ? options.schema.parse(data) : data;
@@ -23678,6 +23691,18 @@ var RelayCast = class _RelayCast {
     resolveIdentity: () => this.resolveIdentity(),
     spawn: (data) => this.client.post("/v1/agents/spawn", data),
     release: (data) => this.client.post("/v1/agents/release", data),
+    /**
+     * Atomically release only the exact immutable agent identity. The key is
+     * deliberately mandatory: callers persist and reuse it across restarts.
+     */
+    releaseExact: (data, options) => {
+      const idempotencyKey = options.idempotencyKey.trim();
+      if (!idempotencyKey)
+        throw new Error("idempotencyKey is required for exact agent release");
+      return this.client.post("/v1/agents/release-exact", data, {
+        headers: { "Idempotency-Key": idempotencyKey }
+      });
+    },
     events: {
       emit: (name, data) => this.client.post(`/v1/agents/${encodeURIComponent(name)}/events`, data),
       list: (name, query) => {
@@ -23719,6 +23744,26 @@ var RelayCast = class _RelayCast {
         params.capability = query.capability;
       if (query?.name)
         params.name = query.name;
+      if (query?.status)
+        params.status = query.status;
+      return this.client.get("/v1/nodes", params);
+    },
+    // Explicit, bounded pagination contract for reading history (e.g. `--all`
+    // in the Relay CLI): pages through every matching row exactly once, no
+    // matter how many the workspace has retained, without silent truncation.
+    // Compatible callers keep using `list()`, which never returns this shape.
+    listHistory: (query) => {
+      const params = { history: "true" };
+      if (query?.capability)
+        params.capability = query.capability;
+      if (query?.name)
+        params.name = query.name;
+      if (query?.status)
+        params.status = query.status;
+      if (query?.cursor)
+        params.cursor = query.cursor;
+      if (query?.limit !== void 0)
+        params.limit = String(query.limit);
       return this.client.get("/v1/nodes", params);
     },
     get: (name) => this.client.get(`/v1/nodes/${encodeURIComponent(name)}`),
@@ -25780,6 +25825,7 @@ function normalizeActionInvocationAck(raw) {
     ...readStr(record2, "handlerNodeId", "handler_node_id") ? { handlerNodeId: readStr(record2, "handlerNodeId", "handler_node_id") } : {},
     ...readStr(record2, "dispatchedNodeId", "dispatched_node_id") ? { dispatchedNodeId: readStr(record2, "dispatchedNodeId", "dispatched_node_id") } : {},
     ...readRecord(record2, "input") ? { input: readRecord(record2, "input") } : {},
+    ...readRecord(record2, "output") ? { output: readRecord(record2, "output") } : {},
     ...readStr(record2, "status") ? { status: readStr(record2, "status") } : {},
     ...readStr(record2, "createdAt", "created_at") ? { createdAt: readStr(record2, "createdAt", "created_at") } : {}
   };
@@ -25859,12 +25905,39 @@ function createRelaycastClient(options) {
 }
 
 // ../sdk/dist/messaging/relaycast-placement.js
+var DISPATCH_EVIDENT_STATUSES = /* @__PURE__ */ new Set([
+  "dispatched",
+  "invoked",
+  "running",
+  "completed",
+  "succeeded",
+  "success"
+]);
+var NOT_DISPATCHED_STATUSES = /* @__PURE__ */ new Set(["pending", "queued"]);
+function resolveDispatchState(ack) {
+  if (ack.dispatchedNodeId || ack.handlerNodeId)
+    return "dispatched";
+  const status = ack.status?.toLowerCase();
+  if (status && DISPATCH_EVIDENT_STATUSES.has(status))
+    return "dispatched";
+  if (status && NOT_DISPATCHED_STATUSES.has(status))
+    return "not_dispatched";
+  return "unknown";
+}
 var RelayPlacementError = class extends Error {
   code;
   capability;
   node;
   repo;
   attempts;
+  /** Stable invocation correlation for accepted/dispatch outcomes. */
+  invocationId;
+  /** Evidence state at the point this placement returned or failed. */
+  state;
+  /** Whether the engine supplied evidence that a node received the dispatch. */
+  dispatchState;
+  /** Original invocation receipt, when a terminal spawn result was observed. */
+  receipt;
   constructor(code, message, context) {
     super(message);
     this.name = "RelayPlacementError";
@@ -25873,6 +25946,10 @@ var RelayPlacementError = class extends Error {
     this.node = context.node;
     this.repo = context.repo;
     this.attempts = context.attempts;
+    this.invocationId = context.invocationId;
+    this.state = context.state;
+    this.dispatchState = context.dispatchState;
+    this.receipt = context.receipt;
   }
 };
 function nonEmptyPlacement(value, label) {
@@ -25918,6 +25995,9 @@ 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) {
+  return value.output?.spawned === true && value.output?.ready === true;
+}
 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;
@@ -26330,6 +26410,32 @@ var RelaycastMessagingClient = class {
             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 ackStatus = ack.status?.toLowerCase();
+            if (ackStatus && CONFIRM_FAILURE_STATUSES.has(ackStatus)) {
+              throw new RelayPlacementError("spawn_failed", `node '${placedNodeLabel}' reported ${ackStatus} for ${actionName} immediately upon dispatch`, {
+                capability,
+                node: placedNodeLabel,
+                repo,
+                attempts,
+                state: "failed",
+                dispatchState: resolveDispatchState(ack),
+                invocationId: ack.invocationId,
+                receipt: ack
+              });
+            }
+            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`, {
+                capability,
+                node: placedNodeLabel,
+                repo,
+                attempts,
+                state: "failed",
+                dispatchState: resolveDispatchState(ack),
+                invocationId: ack.invocationId,
+                receipt: ack
+              });
+            }
             const confirmation = input2.confirm ? await this.confirmPlacementInvocation(actionName, ack, {
               capability,
               node: placedNodeLabel,
@@ -26349,7 +26455,8 @@ var RelaycastMessagingClient = class {
                 ...repo ? { repo } : {},
                 attempts,
                 queued,
-                confirmed: Boolean(confirmation)
+                confirmed: Boolean(confirmation),
+                state: confirmation ? "ready" : "accepted"
               },
               ...confirmation ? { confirmation } : {}
             };
@@ -26433,13 +26540,19 @@ var RelaycastMessagingClient = class {
   async confirmPlacementInvocation(actionName, ack, context) {
     const { timeoutMs, pollIntervalMs, ...errorContext } = context;
     const invocationId = ack.invocationId;
+    const dispatchState = resolveDispatchState(ack);
     if (!invocationId) {
-      throw new RelayPlacementError("spawn_unconfirmed", `node '${context.node}' accepted ${actionName} without returning an invocation id, so the dispatch cannot be confirmed`, errorContext);
+      throw new RelayPlacementError("spawn_unconfirmed", `node '${context.node}' accepted ${actionName} without returning an invocation id, so the dispatch cannot be confirmed`, { ...errorContext, state: "unconfirmed_may_be_running", dispatchState });
     }
     const budgetMs = confirmDurationMs(timeoutMs, DEFAULT_CONFIRM_TIMEOUT_MS, MAX_CONFIRM_TIMEOUT_MS);
     const cadenceMs = confirmDurationMs(pollIntervalMs, DEFAULT_CONFIRM_POLL_MS, budgetMs);
     if (!this.agentClient?.actions) {
-      throw new RelayPlacementError("spawn_unconfirmed", `node '${context.node}' accepted ${actionName} (invocation ${invocationId}), but confirmation requires an agent-scoped client with the actions API, so the dispatch cannot be read back`, errorContext);
+      throw new RelayPlacementError("spawn_unconfirmed", `node '${context.node}' accepted ${actionName} (invocation ${invocationId}), but confirmation requires an agent-scoped client with the actions API, so the dispatch cannot be read back`, {
+        ...errorContext,
+        state: "unconfirmed_may_be_running",
+        invocationId,
+        dispatchState
+      });
     }
     const deadline = Date.now() + budgetMs;
     let lastReadError;
@@ -26454,10 +26567,25 @@ 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`, {
+                  ...errorContext,
+                  state: "failed",
+                  invocationId,
+                  dispatchState,
+                  receipt: invocation
+                });
+              }
               return invocation;
             }
             if (status && CONFIRM_FAILURE_STATUSES.has(status)) {
-              throw new RelayPlacementError("spawn_failed", invocation?.error?.trim() || `node '${context.node}' reported ${status} for ${actionName}`, errorContext);
+              throw new RelayPlacementError("spawn_failed", invocation?.error?.trim() || `node '${context.node}' reported ${status} for ${actionName}`, {
+                ...errorContext,
+                state: "failed",
+                invocationId,
+                dispatchState,
+                receipt: invocation
+              });
             }
           } else {
             lastReadError = outcome.error;
@@ -26465,7 +26593,12 @@ var RelaycastMessagingClient = class {
         }
       }
       if (Date.now() >= deadline) {
-        throw new RelayPlacementError("spawn_unconfirmed", `node '${context.node}' accepted ${actionName} (invocation ${invocationId}) but never reported a result within ${budgetMs}ms. The node advertised capacity and acknowledged the dispatch; nothing confirmed that it launched. Check that node's broker version, or re-run without confirmation to accept an unconfirmed dispatch.` + (lastReadError ? ` Last read error: ${lastReadError}` : ""), errorContext);
+        throw new RelayPlacementError("spawn_unconfirmed", `node '${context.node}' accepted ${actionName} (invocation ${invocationId}) but never reported a result within ${budgetMs}ms. The node advertised capacity and acknowledged the dispatch; nothing confirmed that it launched. The invocation may still be running, so do not retry blindly. Check that node's broker version, or re-run without confirmation to accept an unconfirmed dispatch.` + (lastReadError ? ` Last read error: ${lastReadError}` : ""), {
+          ...errorContext,
+          state: "unconfirmed_may_be_running",
+          invocationId,
+          dispatchState
+        });
       }
       await delay(Math.max(0, Math.min(cadenceMs, deadline - Date.now())));
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "12.0.0",
+  "version": "12.1.0",
   "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": "12.0.0",
-    "@agent-relay/config": "12.0.0",
-    "@agent-relay/fleet": "12.0.0",
-    "@agent-relay/harness-driver": "12.0.0",
-    "@agent-relay/harnesses": "12.0.0",
-    "@agent-relay/sdk": "12.0.0",
-    "@agent-relay/session": "12.0.0",
-    "@agent-relay/utils": "12.0.0",
+    "@agent-relay/cloud": "12.1.0",
+    "@agent-relay/config": "12.1.0",
+    "@agent-relay/fleet": "12.1.0",
+    "@agent-relay/harness-driver": "12.1.0",
+    "@agent-relay/harnesses": "12.1.0",
+    "@agent-relay/sdk": "12.1.0",
+    "@agent-relay/session": "12.1.0",
+    "@agent-relay/utils": "12.1.0",
     "@modelcontextprotocol/sdk": "^1.23.0",
     "@relayfile/client": "^0.10.27",
     "@relayflows/cli": "1.0.1",