agent-relay 10.6.2 → 10.6.4

package/dist/index.cjs

@@ -283,7 +283,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // ../../node_modules/@relaycast/sdk/dist/version.js
-var SDK_VERSION = "6.1.0";
+var SDK_VERSION = "6.2.0";
 
 // ../../node_modules/@relaycast/types/node_modules/zod/v4/classic/external.js
 var external_exports = {};
@@ -1051,10 +1051,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path4) {
-  if (!path4)
+function getElementAtPath(obj, path5) {
+  if (!path5)
     return obj;
-  return path4.reduce((acc, key) => acc?.[key], obj);
+  return path5.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -1463,11 +1463,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path4, issues) {
+function prefixIssues(path5, issues) {
   return issues.map((iss) => {
     var _a7;
     (_a7 = iss).path ?? (_a7.path = []);
-    iss.path.unshift(path4);
+    iss.path.unshift(path5);
     return iss;
   });
 }
@@ -1614,16 +1614,16 @@ function flattenError(error151, mapper = (issue4) => issue4.message) {
 }
 function formatError(error151, mapper = (issue4) => issue4.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error152, path4 = []) => {
+  const processError = (error152, path5 = []) => {
     for (const issue4 of error152.issues) {
       if (issue4.code === "invalid_union" && issue4.errors.length) {
-        issue4.errors.map((issues) => processError({ issues }, [...path4, ...issue4.path]));
+        issue4.errors.map((issues) => processError({ issues }, [...path5, ...issue4.path]));
       } else if (issue4.code === "invalid_key") {
-        processError({ issues: issue4.issues }, [...path4, ...issue4.path]);
+        processError({ issues: issue4.issues }, [...path5, ...issue4.path]);
       } else if (issue4.code === "invalid_element") {
-        processError({ issues: issue4.issues }, [...path4, ...issue4.path]);
+        processError({ issues: issue4.issues }, [...path5, ...issue4.path]);
       } else {
-        const fullpath = [...path4, ...issue4.path];
+        const fullpath = [...path5, ...issue4.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue4));
         } else {
@@ -1650,17 +1650,17 @@ function formatError(error151, mapper = (issue4) => issue4.message) {
 }
 function treeifyError(error151, mapper = (issue4) => issue4.message) {
   const result = { errors: [] };
-  const processError = (error152, path4 = []) => {
+  const processError = (error152, path5 = []) => {
     var _a7, _b;
     for (const issue4 of error152.issues) {
       if (issue4.code === "invalid_union" && issue4.errors.length) {
-        issue4.errors.map((issues) => processError({ issues }, [...path4, ...issue4.path]));
+        issue4.errors.map((issues) => processError({ issues }, [...path5, ...issue4.path]));
       } else if (issue4.code === "invalid_key") {
-        processError({ issues: issue4.issues }, [...path4, ...issue4.path]);
+        processError({ issues: issue4.issues }, [...path5, ...issue4.path]);
       } else if (issue4.code === "invalid_element") {
-        processError({ issues: issue4.issues }, [...path4, ...issue4.path]);
+        processError({ issues: issue4.issues }, [...path5, ...issue4.path]);
       } else {
-        const fullpath = [...path4, ...issue4.path];
+        const fullpath = [...path5, ...issue4.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue4));
           continue;
@@ -1692,8 +1692,8 @@ function treeifyError(error151, mapper = (issue4) => issue4.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path4 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path4) {
+  const path5 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path5) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -14385,13 +14385,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path4 = ref.slice(1).split("/").filter(Boolean);
-  if (path4.length === 0) {
+  const path5 = ref.slice(1).split("/").filter(Boolean);
+  if (path5.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path4[0] === defsKey) {
-    const key = path4[1];
+  if (path5[0] === defsKey) {
+    const key = path5[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -15462,6 +15462,25 @@ var AgentStatusChangedEventSchema = external_exports.object({
   agent: external_exports.object({ name: external_exports.string() }),
   status: external_exports.enum(["active", "idle", "blocked", "waiting", "offline"])
 });
+var AgentExitedEventSchema = external_exports.object({
+  type: external_exports.literal("agent.exited"),
+  agent_id: external_exports.string(),
+  agent_name: external_exports.string(),
+  node_id: external_exports.string().nullable(),
+  invocation_id: external_exports.string().nullable(),
+  reason: external_exports.enum(["deregistered", "missing_from_inventory", "released"])
+});
+var NodeStatusOnlineEventSchema = external_exports.object({
+  type: external_exports.literal("node.status.online"),
+  node_id: external_exports.string(),
+  node_name: external_exports.string().nullable()
+});
+var NodeStatusOfflineEventSchema = external_exports.object({
+  type: external_exports.literal("node.status.offline"),
+  node_id: external_exports.string(),
+  node_name: external_exports.string().nullable(),
+  reason: external_exports.enum(["liveness_timeout", "disconnected", "deregistered"]).optional()
+});
 var ChannelCreatedEventSchema = external_exports.object({
   type: external_exports.literal("channel.created"),
   channel: external_exports.object({ name: external_exports.string(), topic: external_exports.string().nullable() })
@@ -15617,6 +15636,9 @@ var ServerEventSchema = external_exports.discriminatedUnion("type", [
   AgentStatusWaitingEventSchema,
   AgentStatusOfflineEventSchema,
   AgentStatusChangedEventSchema,
+  AgentExitedEventSchema,
+  NodeStatusOnlineEventSchema,
+  NodeStatusOfflineEventSchema,
   ChannelCreatedEventSchema,
   ChannelUpdatedEventSchema,
   ChannelArchivedEventSchema,
@@ -15658,6 +15680,9 @@ var WsClientEventSchema = external_exports.discriminatedUnion("type", [
   AgentStatusWaitingEventSchema,
   AgentStatusOfflineEventSchema,
   AgentStatusChangedEventSchema,
+  AgentExitedEventSchema,
+  NodeStatusOnlineEventSchema,
+  NodeStatusOfflineEventSchema,
   ChannelCreatedEventSchema,
   ChannelUpdatedEventSchema,
   ChannelArchivedEventSchema,
@@ -15773,6 +15798,9 @@ var SubscribableEventTypeSchema = external_exports.enum([
   "agent.status.blocked",
   "agent.status.waiting",
   "agent.status.offline",
+  "agent.exited",
+  "node.status.online",
+  "node.status.offline",
   "channel.created",
   "channel.updated",
   "channel.archived",
@@ -16208,6 +16236,15 @@ function toCamelKey(key) {
 function toSnakeKey(key) {
   return key.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
 }
+var VERBATIM_VALUE_KEYS = /* @__PURE__ */ new Set([
+  "headers",
+  "input",
+  "output",
+  "input_schema",
+  "inputSchema",
+  "output_schema",
+  "outputSchema"
+]);
 function camelizeKeys(value) {
   if (Array.isArray(value)) {
     return value.map((item) => camelizeKeys(item));
@@ -16215,7 +16252,7 @@ function camelizeKeys(value) {
   if (isPlainObject2(value)) {
     const out = {};
     for (const [key, val] of Object.entries(value)) {
-      out[toCamelKey(key)] = camelizeKeys(val);
+      out[toCamelKey(key)] = VERBATIM_VALUE_KEYS.has(key) ? val : camelizeKeys(val);
     }
     return out;
   }
@@ -16228,7 +16265,7 @@ function decamelizeKeys(value) {
   if (isPlainObject2(value)) {
     const out = {};
     for (const [key, val] of Object.entries(value)) {
-      out[toSnakeKey(key)] = key === "headers" && isPlainObject2(val) ? val : decamelizeKeys(val);
+      out[toSnakeKey(key)] = VERBATIM_VALUE_KEYS.has(key) ? val : decamelizeKeys(val);
     }
     return out;
   }
@@ -16892,9 +16929,22 @@ var AgentClient = class {
     heartbeat: async () => {
       await this.client.post("/v1/agents/heartbeat", {});
     },
-    markOffline: async () => {
+    /**
+     * Mark this agent offline.
+     *
+     * By default this is a presence-only signal: a node-hosted (broker) agent
+     * keeps its node binding, so a session still running on its node keeps
+     * receiving deliveries through that node and the binding stays usable for
+     * later reconnection. Pass `{ deregister: true }` to also tear down the
+     * node binding and re-home the agent to its implicit direct node.
+     */
+    markOffline: async (options) => {
       this.stopAutoHeartbeat();
-      await this.client.post("/v1/agents/disconnect", {});
+      if (this.pendingHeartbeat) {
+        await this.pendingHeartbeat;
+        this.pendingHeartbeat = null;
+      }
+      await this.client.post("/v1/agents/disconnect", options?.deregister ? { deregister: true } : {});
     }
   };
   startAutoHeartbeat() {
@@ -16902,6 +16952,8 @@ var AgentClient = class {
     if (this.autoHeartbeatMs === false)
       return;
     this.autoHeartbeatTimer = setInterval(() => {
+      if (this.pendingHeartbeat)
+        return;
       this.pendingHeartbeat = this.presence.heartbeat().catch(() => {
       }).finally(() => {
         this.pendingHeartbeat = null;
@@ -16972,7 +17024,17 @@ var AgentClient = class {
   async heartbeat() {
     await this.presence.heartbeat();
   }
-  async disconnect() {
+  /**
+   * Tear down this client's WebSocket and mark the agent offline.
+   *
+   * By default the HTTP disconnect is presence-only for node-hosted (broker)
+   * agents: the node binding is preserved, so an agent process still running
+   * on its node keeps receiving deliveries through that node, and the binding
+   * remains usable for later reconnection. Pass `{ deregister: true }` to also
+   * deregister the node binding and re-home the agent to its implicit direct
+   * node.
+   */
+  async disconnect(options) {
     this.stopAutoHeartbeat();
     if (this.pendingHeartbeat) {
       await this.pendingHeartbeat;
@@ -16990,7 +17052,7 @@ var AgentClient = class {
       this.ws = null;
     }
     this.activeWsChannels.clear();
-    await this.client.post("/v1/agents/disconnect", {}).catch(() => {
+    await this.client.post("/v1/agents/disconnect", options?.deregister ? { deregister: true } : {}).catch(() => {
     });
   }
   subscribe(channels, onMessage) {
@@ -18137,10 +18199,10 @@ function mergeDefs2(...defs) {
 function cloneDef2(schema) {
   return mergeDefs2(schema._zod.def);
 }
-function getElementAtPath2(obj, path4) {
-  if (!path4)
+function getElementAtPath2(obj, path5) {
+  if (!path5)
     return obj;
-  return path4.reduce((acc, key) => acc?.[key], obj);
+  return path5.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject2(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -18549,11 +18611,11 @@ function explicitlyAborted2(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues2(path4, issues) {
+function prefixIssues2(path5, issues) {
   return issues.map((iss) => {
     var _a7;
     (_a7 = iss).path ?? (_a7.path = []);
-    iss.path.unshift(path4);
+    iss.path.unshift(path5);
     return iss;
   });
 }
@@ -18700,16 +18762,16 @@ function flattenError2(error151, mapper = (issue4) => issue4.message) {
 }
 function formatError2(error151, mapper = (issue4) => issue4.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error152, path4 = []) => {
+  const processError = (error152, path5 = []) => {
     for (const issue4 of error152.issues) {
       if (issue4.code === "invalid_union" && issue4.errors.length) {
-        issue4.errors.map((issues) => processError({ issues }, [...path4, ...issue4.path]));
+        issue4.errors.map((issues) => processError({ issues }, [...path5, ...issue4.path]));
       } else if (issue4.code === "invalid_key") {
-        processError({ issues: issue4.issues }, [...path4, ...issue4.path]);
+        processError({ issues: issue4.issues }, [...path5, ...issue4.path]);
       } else if (issue4.code === "invalid_element") {
-        processError({ issues: issue4.issues }, [...path4, ...issue4.path]);
+        processError({ issues: issue4.issues }, [...path5, ...issue4.path]);
       } else {
-        const fullpath = [...path4, ...issue4.path];
+        const fullpath = [...path5, ...issue4.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue4));
         } else {
@@ -18736,17 +18798,17 @@ function formatError2(error151, mapper = (issue4) => issue4.message) {
 }
 function treeifyError2(error151, mapper = (issue4) => issue4.message) {
   const result = { errors: [] };
-  const processError = (error152, path4 = []) => {
+  const processError = (error152, path5 = []) => {
     var _a7, _b;
     for (const issue4 of error152.issues) {
       if (issue4.code === "invalid_union" && issue4.errors.length) {
-        issue4.errors.map((issues) => processError({ issues }, [...path4, ...issue4.path]));
+        issue4.errors.map((issues) => processError({ issues }, [...path5, ...issue4.path]));
       } else if (issue4.code === "invalid_key") {
-        processError({ issues: issue4.issues }, [...path4, ...issue4.path]);
+        processError({ issues: issue4.issues }, [...path5, ...issue4.path]);
       } else if (issue4.code === "invalid_element") {
-        processError({ issues: issue4.issues }, [...path4, ...issue4.path]);
+        processError({ issues: issue4.issues }, [...path5, ...issue4.path]);
       } else {
-        const fullpath = [...path4, ...issue4.path];
+        const fullpath = [...path5, ...issue4.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue4));
           continue;
@@ -18778,8 +18840,8 @@ function treeifyError2(error151, mapper = (issue4) => issue4.message) {
 }
 function toDotPath2(_path) {
   const segs = [];
-  const path4 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path4) {
+  const path5 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path5) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -31471,13 +31533,13 @@ function resolveRef2(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path4 = ref.slice(1).split("/").filter(Boolean);
-  if (path4.length === 0) {
+  const path5 = ref.slice(1).split("/").filter(Boolean);
+  if (path5.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path4[0] === defsKey) {
-    const key = path4[1];
+  if (path5[0] === defsKey) {
+    const key = path5[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -32070,8 +32132,8 @@ var HttpClient = class _HttpClient {
       ...this._agentRelayDistinctId ? { agentRelayDistinctId: this._agentRelayDistinctId } : {}
     }));
   }
-  async request(method, path4, body, query, options) {
-    const url4 = new URL(path4, this._baseUrl);
+  async request(method, path5, body, query, options) {
+    const url4 = new URL(path5, this._baseUrl);
     if (query) {
       for (const [k, v] of Object.entries(query)) {
         if (v !== void 0)
@@ -32142,20 +32204,20 @@ var HttpClient = class _HttpClient {
       return camelizeKeys(parsedData);
     }
   }
-  get(path4, query, options) {
-    return this.request("GET", path4, void 0, query, options);
+  get(path5, query, options) {
+    return this.request("GET", path5, void 0, query, options);
   }
-  post(path4, body, options) {
-    return this.request("POST", path4, body, void 0, options);
+  post(path5, body, options) {
+    return this.request("POST", path5, body, void 0, options);
   }
-  patch(path4, body, options) {
-    return this.request("PATCH", path4, body, void 0, options);
+  patch(path5, body, options) {
+    return this.request("PATCH", path5, body, void 0, options);
   }
-  put(path4, body, options) {
-    return this.request("PUT", path4, body, void 0, options);
+  put(path5, body, options) {
+    return this.request("PUT", path5, body, void 0, options);
   }
-  async delete(path4, options) {
-    await this.request("DELETE", path4, void 0, void 0, options);
+  async delete(path5, options) {
+    await this.request("DELETE", path5, void 0, void 0, options);
   }
 };
 
@@ -32754,72 +32816,72 @@ function validateJsonSchemaLite(value, schema) {
   validateAgainstSchema(value, schema, "$", state);
   return { valid: state.issues.length === 0, issues: state.issues };
 }
-function validateAgainstSchema(value, schema, path4, state) {
+function validateAgainstSchema(value, schema, path5, state) {
   if (schema === true) {
     return;
   }
   if (schema === false) {
-    addIssue(state, path4, "value is not allowed", "never", describeValue(value));
+    addIssue(state, path5, "value is not allowed", "never", describeValue(value));
     return;
   }
   if (!isSchemaObject(schema)) {
-    addIssue(state, path4, "schema must be a boolean or object", "schema", describeValue(schema));
+    addIssue(state, path5, "schema must be a boolean or object", "schema", describeValue(schema));
     return;
   }
-  validateCombinators(value, schema, path4, state);
+  validateCombinators(value, schema, path5, state);
   if (schema.const !== void 0 && !jsonEqual(value, schema.const)) {
-    addIssue(state, path4, `expected const ${JSON.stringify(schema.const)}`, JSON.stringify(schema.const), describeValue(value));
+    addIssue(state, path5, `expected const ${JSON.stringify(schema.const)}`, JSON.stringify(schema.const), describeValue(value));
   }
   if (schema.enum && !schema.enum.some((candidate) => jsonEqual(value, candidate))) {
-    addIssue(state, path4, `expected one of ${schema.enum.map((candidate) => JSON.stringify(candidate)).join(", ")}`);
+    addIssue(state, path5, `expected one of ${schema.enum.map((candidate) => JSON.stringify(candidate)).join(", ")}`);
   }
   const types = getExpectedTypes(schema);
   if (types.length > 0 && !types.some((type) => matchesType(value, type))) {
-    addIssue(state, path4, `expected ${types.join(" or ")}`, types.join(" or "), describeValue(value));
+    addIssue(state, path5, `expected ${types.join(" or ")}`, types.join(" or "), describeValue(value));
     return;
   }
   if (shouldValidateObject(value, schema)) {
-    validateObject(value, schema, path4, state);
+    validateObject(value, schema, path5, state);
   }
   if (shouldValidateArray(value, schema)) {
-    validateArray(value, schema, path4, state);
+    validateArray(value, schema, path5, state);
   }
   if (typeof value === "string") {
-    validateString(value, schema, path4, state);
+    validateString(value, schema, path5, state);
   }
   if (typeof value === "number") {
-    validateNumber(value, schema, path4, state);
+    validateNumber(value, schema, path5, state);
   }
 }
-function validateCombinators(value, schema, path4, state) {
+function validateCombinators(value, schema, path5, state) {
   if (schema.allOf) {
     for (const child of schema.allOf) {
-      validateAgainstSchema(value, child, path4, state);
+      validateAgainstSchema(value, child, path5, state);
     }
   }
   if (schema.anyOf) {
     const matched = schema.anyOf.some((child) => validateJsonSchemaLite(value, child).valid);
     if (!matched) {
-      addIssue(state, path4, "expected value to match at least one anyOf schema");
+      addIssue(state, path5, "expected value to match at least one anyOf schema");
     }
   }
   if (schema.oneOf) {
     const matches = schema.oneOf.filter((child) => validateJsonSchemaLite(value, child).valid).length;
     if (matches !== 1) {
-      addIssue(state, path4, `expected value to match exactly one oneOf schema, matched ${matches}`);
+      addIssue(state, path5, `expected value to match exactly one oneOf schema, matched ${matches}`);
     }
   }
 }
-function validateObject(value, schema, path4, state) {
+function validateObject(value, schema, path5, state) {
   for (const key of schema.required ?? []) {
     if (!Object.prototype.hasOwnProperty.call(value, key)) {
-      addIssue(state, appendPath(path4, key), "required property is missing");
+      addIssue(state, appendPath(path5, key), "required property is missing");
     }
   }
   const properties = schema.properties ?? {};
   for (const [key, childSchema] of Object.entries(properties)) {
     if (Object.prototype.hasOwnProperty.call(value, key)) {
-      validateAgainstSchema(value[key], childSchema, appendPath(path4, key), state);
+      validateAgainstSchema(value[key], childSchema, appendPath(path5, key), state);
     }
   }
   const additional = schema.additionalProperties;
@@ -32831,48 +32893,48 @@ function validateObject(value, schema, path4, state) {
       continue;
     }
     if (additional === false) {
-      addIssue(state, appendPath(path4, key), "additional property is not allowed");
+      addIssue(state, appendPath(path5, key), "additional property is not allowed");
     } else {
-      validateAgainstSchema(value[key], additional, appendPath(path4, key), state);
+      validateAgainstSchema(value[key], additional, appendPath(path5, key), state);
     }
   }
 }
-function validateArray(value, schema, path4, state) {
+function validateArray(value, schema, path5, state) {
   if (schema.minItems !== void 0 && value.length < schema.minItems) {
-    addIssue(state, path4, `expected at least ${schema.minItems} items`);
+    addIssue(state, path5, `expected at least ${schema.minItems} items`);
   }
   if (schema.maxItems !== void 0 && value.length > schema.maxItems) {
-    addIssue(state, path4, `expected at most ${schema.maxItems} items`);
+    addIssue(state, path5, `expected at most ${schema.maxItems} items`);
   }
   if (schema.items !== void 0) {
     value.forEach((item, index) => {
-      validateAgainstSchema(item, schema.items, `${path4}[${index}]`, state);
+      validateAgainstSchema(item, schema.items, `${path5}[${index}]`, state);
     });
   }
 }
-function validateString(value, schema, path4, state) {
+function validateString(value, schema, path5, state) {
   if (schema.minLength !== void 0 && value.length < schema.minLength) {
-    addIssue(state, path4, `expected length >= ${schema.minLength}`);
+    addIssue(state, path5, `expected length >= ${schema.minLength}`);
   }
   if (schema.maxLength !== void 0 && value.length > schema.maxLength) {
-    addIssue(state, path4, `expected length <= ${schema.maxLength}`);
+    addIssue(state, path5, `expected length <= ${schema.maxLength}`);
   }
   if (schema.pattern !== void 0) {
     try {
       if (!new RegExp(schema.pattern).test(value)) {
-        addIssue(state, path4, `expected string to match /${schema.pattern}/`);
+        addIssue(state, path5, `expected string to match /${schema.pattern}/`);
       }
     } catch {
-      addIssue(state, path4, `invalid pattern /${schema.pattern}/`);
+      addIssue(state, path5, `invalid pattern /${schema.pattern}/`);
     }
   }
 }
-function validateNumber(value, schema, path4, state) {
+function validateNumber(value, schema, path5, state) {
   if (schema.minimum !== void 0 && value < schema.minimum) {
-    addIssue(state, path4, `expected value >= ${schema.minimum}`);
+    addIssue(state, path5, `expected value >= ${schema.minimum}`);
   }
   if (schema.maximum !== void 0 && value > schema.maximum) {
-    addIssue(state, path4, `expected value <= ${schema.maximum}`);
+    addIssue(state, path5, `expected value <= ${schema.maximum}`);
   }
 }
 function getExpectedTypes(schema) {
@@ -32921,12 +32983,12 @@ function isPlainObject4(value) {
 function isSchemaObject(value) {
   return isPlainObject4(value);
 }
-function appendPath(path4, key) {
-  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? `${path4}.${key}` : `${path4}[${JSON.stringify(key)}]`;
+function appendPath(path5, key) {
+  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? `${path5}.${key}` : `${path5}[${JSON.stringify(key)}]`;
 }
-function addIssue(state, path4, message, expected, received) {
+function addIssue(state, path5, message, expected, received) {
   state.issues.push({
-    path: path4,
+    path: path5,
     message,
     ...expected !== void 0 ? { expected } : {},
     ...received !== void 0 ? { received } : {}
@@ -33256,11 +33318,11 @@ function zodIssues(error151) {
     message: issue4.message
   }));
 }
-function formatZodPath(path4) {
-  if (path4.length === 0)
+function formatZodPath(path5) {
+  if (path5.length === 0)
     return "$";
   let result = "$";
-  for (const part of path4) {
+  for (const part of path5) {
     result = typeof part === "number" ? `${result}[${part}]` : `${result}.${part}`;
   }
   return result;
@@ -34076,10 +34138,10 @@ function mergeDefs3(...defs) {
 function cloneDef3(schema) {
   return mergeDefs3(schema._zod.def);
 }
-function getElementAtPath3(obj, path4) {
-  if (!path4)
+function getElementAtPath3(obj, path5) {
+  if (!path5)
     return obj;
-  return path4.reduce((acc, key) => acc?.[key], obj);
+  return path5.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject3(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -34488,11 +34550,11 @@ function explicitlyAborted3(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues3(path4, issues) {
+function prefixIssues3(path5, issues) {
   return issues.map((iss) => {
     var _a7;
     (_a7 = iss).path ?? (_a7.path = []);
-    iss.path.unshift(path4);
+    iss.path.unshift(path5);
     return iss;
   });
 }
@@ -34639,16 +34701,16 @@ function flattenError3(error151, mapper = (issue4) => issue4.message) {
 }
 function formatError3(error151, mapper = (issue4) => issue4.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error152, path4 = []) => {
+  const processError = (error152, path5 = []) => {
     for (const issue4 of error152.issues) {
       if (issue4.code === "invalid_union" && issue4.errors.length) {
-        issue4.errors.map((issues) => processError({ issues }, [...path4, ...issue4.path]));
+        issue4.errors.map((issues) => processError({ issues }, [...path5, ...issue4.path]));
       } else if (issue4.code === "invalid_key") {
-        processError({ issues: issue4.issues }, [...path4, ...issue4.path]);
+        processError({ issues: issue4.issues }, [...path5, ...issue4.path]);
       } else if (issue4.code === "invalid_element") {
-        processError({ issues: issue4.issues }, [...path4, ...issue4.path]);
+        processError({ issues: issue4.issues }, [...path5, ...issue4.path]);
       } else {
-        const fullpath = [...path4, ...issue4.path];
+        const fullpath = [...path5, ...issue4.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue4));
         } else {
@@ -34675,17 +34737,17 @@ function formatError3(error151, mapper = (issue4) => issue4.message) {
 }
 function treeifyError3(error151, mapper = (issue4) => issue4.message) {
   const result = { errors: [] };
-  const processError = (error152, path4 = []) => {
+  const processError = (error152, path5 = []) => {
     var _a7, _b;
     for (const issue4 of error152.issues) {
       if (issue4.code === "invalid_union" && issue4.errors.length) {
-        issue4.errors.map((issues) => processError({ issues }, [...path4, ...issue4.path]));
+        issue4.errors.map((issues) => processError({ issues }, [...path5, ...issue4.path]));
       } else if (issue4.code === "invalid_key") {
-        processError({ issues: issue4.issues }, [...path4, ...issue4.path]);
+        processError({ issues: issue4.issues }, [...path5, ...issue4.path]);
       } else if (issue4.code === "invalid_element") {
-        processError({ issues: issue4.issues }, [...path4, ...issue4.path]);
+        processError({ issues: issue4.issues }, [...path5, ...issue4.path]);
       } else {
-        const fullpath = [...path4, ...issue4.path];
+        const fullpath = [...path5, ...issue4.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue4));
           continue;
@@ -34717,8 +34779,8 @@ function treeifyError3(error151, mapper = (issue4) => issue4.message) {
 }
 function toDotPath3(_path) {
   const segs = [];
-  const path4 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path4) {
+  const path5 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path5) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -47410,13 +47472,13 @@ function resolveRef3(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path4 = ref.slice(1).split("/").filter(Boolean);
-  if (path4.length === 0) {
+  const path5 = ref.slice(1).split("/").filter(Boolean);
+  if (path5.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path4[0] === defsKey) {
-    const key = path4[1];
+  if (path5[0] === defsKey) {
+    const key = path5[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -51782,6 +51844,7 @@ function benchmarkPatterns(iterations = 1e4) {
 // ../utils/dist/command-resolver.js
 var import_node_child_process = require("node:child_process");
 var import_node_fs2 = __toESM(require("node:fs"), 1);
+var import_node_path2 = __toESM(require("node:path"), 1);
 function resolveCommand(command) {
   if (command.startsWith("/")) {
     return resolveSymlinks(command);
@@ -51808,7 +51871,18 @@ function resolveCommand(command) {
 function resolveSymlinks(filePath) {
   try {
     const resolved = import_node_fs2.default.realpathSync(filePath);
-    if (resolved !== filePath && process.env.DEBUG_SPAWN === "1") {
+    if (resolved === filePath) {
+      return filePath;
+    }
+    const originalName = import_node_path2.default.basename(filePath);
+    const resolvedName = import_node_path2.default.basename(resolved);
+    if (originalName !== resolvedName) {
+      if (process.env.DEBUG_SPAWN === "1") {
+        console.log(`[command-resolver] Preserving shim ${filePath} (target ${resolved} has a different basename \u2014 likely a mise/asdf-style dispatcher)`);
+      }
+      return absolutizeShimPath(filePath);
+    }
+    if (process.env.DEBUG_SPAWN === "1") {
       console.log(`[command-resolver] Resolved symlink: ${filePath} -> ${resolved}`);
     }
     return resolved;
@@ -51819,6 +51893,18 @@ function resolveSymlinks(filePath) {
     return filePath;
   }
 }
+function absolutizeShimPath(filePath) {
+  if (import_node_path2.default.isAbsolute(filePath)) {
+    return filePath;
+  }
+  try {
+    const parent = import_node_path2.default.dirname(filePath);
+    const canonicalParent = import_node_fs2.default.realpathSync(parent === "" ? "." : parent);
+    return import_node_path2.default.join(canonicalParent, import_node_path2.default.basename(filePath));
+  } catch {
+    return filePath;
+  }
+}
 function commandExists(command) {
   try {
     (0, import_node_child_process.execSync)(`which ${command}`, {
@@ -51833,7 +51919,7 @@ function commandExists(command) {
 
 // ../utils/dist/git-remote.js
 var fs3 = __toESM(require("node:fs"), 1);
-var path2 = __toESM(require("node:path"), 1);
+var path3 = __toESM(require("node:path"), 1);
 var import_node_child_process2 = require("node:child_process");
 function parseGitRemoteUrl(url4) {
   if (!url4)
@@ -51850,7 +51936,7 @@ function parseGitRemoteUrl(url4) {
 }
 function getGitRemoteUrl(workingDirectory, remoteName = "origin") {
   try {
-    const gitDir = path2.join(workingDirectory, ".git");
+    const gitDir = path3.join(workingDirectory, ".git");
     if (!fs3.existsSync(gitDir)) {
       return null;
     }
@@ -51863,7 +51949,7 @@ function getGitRemoteUrl(workingDirectory, remoteName = "origin") {
     return result.trim() || null;
   } catch {
     try {
-      const configPath = path2.join(workingDirectory, ".git", "config");
+      const configPath = path3.join(workingDirectory, ".git", "config");
       if (!fs3.existsSync(configPath)) {
         return null;
       }
@@ -51884,13 +51970,13 @@ function getRepoFullName(workingDirectory) {
   return parseGitRemoteUrl(remoteUrl);
 }
 function findGitRoot(startPath) {
-  let currentPath = path2.resolve(startPath);
-  const root = path2.parse(currentPath).root;
+  let currentPath = path3.resolve(startPath);
+  const root = path3.parse(currentPath).root;
   while (currentPath !== root) {
-    if (fs3.existsSync(path2.join(currentPath, ".git"))) {
+    if (fs3.existsSync(path3.join(currentPath, ".git"))) {
       return currentPath;
     }
-    currentPath = path2.dirname(currentPath);
+    currentPath = path3.dirname(currentPath);
   }
   return null;
 }
@@ -51908,7 +51994,7 @@ function getRepoFullNameFromPath(workingDirectory) {
 
 // ../utils/dist/update-checker.js
 var import_node_fs3 = __toESM(require("node:fs"), 1);
-var import_node_path2 = __toESM(require("node:path"), 1);
+var import_node_path3 = __toESM(require("node:path"), 1);
 var import_node_https = __toESM(require("node:https"), 1);
 var import_node_os = __toESM(require("node:os"), 1);
 var import_compare_versions = __toESM(require_umd(), 1);
@@ -51916,8 +52002,8 @@ var PACKAGE_NAME = "agent-relay";
 var CHECK_INTERVAL_MS = 60 * 60 * 1e3;
 var NPM_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
 function getCachePath() {
-  const cacheDir = import_node_path2.default.join(import_node_os.default.homedir(), ".agentworkforce/relay");
-  return import_node_path2.default.join(cacheDir, "update-cache.json");
+  const cacheDir = import_node_path3.default.join(import_node_os.default.homedir(), ".agentworkforce/relay");
+  return import_node_path3.default.join(cacheDir, "update-cache.json");
 }
 function readCache() {
   try {
@@ -51933,7 +52019,7 @@ function readCache() {
 function writeCache(cache) {
   try {
     const cachePath = getCachePath();
-    const cacheDir = import_node_path2.default.dirname(cachePath);
+    const cacheDir = import_node_path3.default.dirname(cachePath);
     if (!import_node_fs3.default.existsSync(cacheDir)) {
       import_node_fs3.default.mkdirSync(cacheDir, { recursive: true });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "10.6.2",
+  "version": "10.6.4",
   "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": "10.6.2",
-    "@agent-relay/config": "10.6.2",
-    "@agent-relay/fleet": "10.6.2",
-    "@agent-relay/harness-driver": "10.6.2",
-    "@agent-relay/sdk": "10.6.2",
-    "@agent-relay/utils": "10.6.2",
+    "@agent-relay/cloud": "10.6.4",
+    "@agent-relay/config": "10.6.4",
+    "@agent-relay/fleet": "10.6.4",
+    "@agent-relay/harness-driver": "10.6.4",
+    "@agent-relay/sdk": "10.6.4",
+    "@agent-relay/utils": "10.6.4",
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@relayfile/client": "^0.10.21",
+    "@relayfile/client": "^0.10.27",
     "@relayflows/cli": "^1.0.1",
     "@xterm/headless": "^6.0.0",
     "commander": "^12.1.0",