@kontextmind/kxm 0.7.69 → 0.7.71

package/.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "kxm",
       "source": "./plugins/kxm",
       "description": "Durable workflows, peer agents, and kxm tui",
-      "version": "0.7.69",
+      "version": "0.7.71",
       "category": "development",
       "tags": ["kxm", "multi-agent", "workflows", "mcp"]
     }

package/CHANGELOG.md

@@ -6,6 +6,13 @@ All notable user-facing changes are documented here. The project follows [Semant
 
 ### Added
 
+- **`kxm peer send --allow-offline` queues to a registered offline peer.**
+  `POST /v1/messages` accepts `allowOffline: true` (also `kxm_send.allowOffline`): a
+  registered agent in the same project is stored `queued` instead of `target_not_found`,
+  real-time `publish` is skipped, and the existing reconnect cursor delivers the message
+  once on resumption. Unknown names still fail closed. TTL expiry is unchanged; queued
+  messages are not evidence unless `workflowContext` was hub-authorized at send.
+
 - **Per-tenant hosting operations, and a backup that covers the whole state set.**
   `docs/operations.md` gained a *Per-tenant hosted deployment* section (one tenant = one box
   = one hub; loopback-only hub and supervisor; the tenant's proxy owns TLS and the browser

package/docs/test-matrix.md

@@ -22,6 +22,7 @@ npm run verify
 | All delivery modes, message fields, hop limits, and validation | `test/core/hub-api.test.ts`, `test/core/protocol.test.ts` |
 | Queue, acknowledgement, visibility, reply, and authorization | `test/core/hub-api.test.ts`, `test/core/hub.test.ts` |
 | Queued/delivered replay after recipient restart reuses one message record | `test/core/hub.test.ts`, `test/core/extension.test.ts`, `test/core/mcp.test.ts` |
+| Known-offline peer send with `allowOffline` queues, delivers once on resumption, and expires unread by TTL | `test/core/hub-api.test.ts` |
 | One-to-three-peer fanout, recoverable local timeouts/aborts, exact retries, and partial-error collection | `test/core/client.test.ts`, `test/core/hub-api.test.ts`, `test/core/extension.test.ts`, `test/core/mcp.test.ts` |
 | TTL expiry, sender cancellation, and terminal retention | `test/core/hub-api.test.ts` |
 | Terminal inbound cleanup and next-request activation | `test/core/extension.test.ts`, `test/core/mcp.test.ts` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontextmind/kxm",
-  "version": "0.7.69",
+  "version": "0.7.71",
   "description": "KXM local-first multi-agent orchestration and operator dashboard",
   "type": "module",
   "author": "KontextMind",

package/plugins/kxm/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "kxm",
   "displayName": "KXM",
-  "version": "0.7.69",
+  "version": "0.7.71",
   "description": "Headless multi-agent orchestration, durable workflows, and a live operator dashboard for Pi and Claude Code",
   "author": {
     "name": "KontextMind",

package/plugins/kxm/dist/cli.js

@@ -18350,9 +18350,7 @@ function findKxmRepoRoot(fromUrl = import.meta.url) {
 
 // plugins/kxm/src/client.ts
 import { createHash as createHash3 } from "node:crypto";
-
-// plugins/kxm/src/workflow.ts
-import { createHash as createHash2 } from "node:crypto";
+import { hostname } from "node:os";
 
 // plugins/kxm/src/protocol.ts
 import { randomUUID } from "node:crypto";
@@ -18361,6 +18359,7 @@ var MIN_MESSAGE_TTL_MS = 1e3;
 var MAX_MESSAGE_TTL_MS = 7 * 24 * 60 * 6e4;
 var DEFAULT_MESSAGE_RETENTION_MS = 7 * 24 * 60 * 6e4;
 var MAX_BODY_BYTES = 256 * 1024;
+var MAX_AGENT_HOST_CHARS = 64;
 var ProtocolError = class extends Error {
   statusCode;
   code;
@@ -18453,6 +18452,7 @@ function validateTerminalReceipt(value) {
 }
 
 // plugins/kxm/src/workflow.ts
+import { createHash as createHash2 } from "node:crypto";
 var PROMOTABLE_JOURNAL_CATEGORIES = ["skill-candidate", "hypothesis", "experiment"];
 var WORKFLOW_TERMINAL_TARGET = "$terminal";
 function normalizeOutcomeValue(value, field) {
@@ -19200,6 +19200,13 @@ var MeshWaitError = class extends Error {
     this.waitStatus = waitStatus;
   }
 };
+function defaultHostLabel() {
+  try {
+    return hostname().trim().slice(0, MAX_AGENT_HOST_CHARS) || void 0;
+  } catch {
+    return void 0;
+  }
+}
 function completedFanoutResult(target, message) {
   if (message.status === "queued" || message.status === "delivered") {
     throw new Error(`message ${message.id} is not complete`);
@@ -19289,8 +19296,11 @@ var HubClient = class {
     this.onEvent = void 0;
     this.eventLoop = void 0;
   }
-  async listAgents() {
-    const result = await this.request("/v1/agents");
+  /** Online peers of this client's project. `includeOffline` also returns
+   * registered members whose lease the hub has already retired. */
+  async listAgents(options = {}) {
+    const path4 = options.includeOffline ? "/v1/agents?includeOffline=true" : "/v1/agents";
+    const result = await this.request(path4);
     return result.agents;
   }
   async send(options) {
@@ -19530,7 +19540,8 @@ var HubClient = class {
           name: this.options.name,
           purpose: this.options.purpose,
           project: this.options.project,
-          model: this.options.model
+          model: this.options.model,
+          host: this.options.host ?? defaultHostLabel()
         })
       }, false);
       this.agent = registration.agent;
@@ -19770,14 +19781,19 @@ var AGENT_COMMANDS = [
     group: "peer",
     verb: "list",
     label: "List hub peers",
-    description: "List online peer agents in this project's hub pool, including their names and purposes.",
+    description: "List peer agents in this project's hub pool with their names, purposes, host label, and hub-clocked presence (online, stale, offline). Registered offline peers are listed only when includeOffline is set.",
     parameters: {
       type: "object",
-      properties: {},
+      properties: {
+        includeOffline: {
+          type: "boolean",
+          description: "Also list registered peers whose hub lease has expired"
+        }
+      },
       additionalProperties: false
     },
-    async execute(client) {
-      return { agents: await client.listAgents() };
+    async execute(client, args) {
+      return { agents: await client.listAgents({ includeOffline: args.includeOffline === true }) };
     }
   },
   {
@@ -19817,7 +19833,12 @@ var AGENT_COMMANDS = [
           required: ["runId", "stageId", "requirementKey", "attempt"],
           additionalProperties: false
         },
-        ttlMs: { type: "number", minimum: 1e3, maximum: 6048e5, description: "Message TTL in milliseconds" }
+        ttlMs: { type: "number", minimum: 1e3, maximum: 6048e5, description: "Message TTL in milliseconds" },
+        allowOffline: {
+          type: "boolean",
+          default: false,
+          description: "Queue the request if the target is a registered offline agent in this project"
+        }
       },
       required: ["target", "content"],
       additionalProperties: false
@@ -19834,7 +19855,8 @@ var AGENT_COMMANDS = [
         ...correlationId ? { correlationId } : {},
         ...idempotencyKey ? { idempotencyKey } : {},
         ...workflowContext ? { workflowContext } : {},
-        ...typeof args.ttlMs === "number" ? { ttlMs: args.ttlMs } : {}
+        ...typeof args.ttlMs === "number" ? { ttlMs: args.ttlMs } : {},
+        ...args.allowOffline === true ? { allowOffline: true } : {}
       });
       return { messageId: message.id, status: message.status, target: message.toName };
     }
@@ -26182,8 +26204,8 @@ function printWorker(runtime, worker, payload, text, outcome) {
 }
 function hostMode(runtime) {
   try {
-    const hostname = new URL(runtime.serverUrl).hostname;
-    if (hostname === "127.0.0.1" || hostname === "localhost" || hostname === "::1") return "local";
+    const hostname2 = new URL(runtime.serverUrl).hostname;
+    if (hostname2 === "127.0.0.1" || hostname2 === "localhost" || hostname2 === "::1") return "local";
   } catch {
   }
   return "hub";
@@ -43081,6 +43103,13 @@ function meshTuiTheme(color) {
 function visibleAgents(snapshot) {
   return snapshot.agents.filter((agent) => agent.model !== "tui");
 }
+function presenceCell(agent, theme, width = 7) {
+  const presence = agent.presence ?? "n/a";
+  const cell = pad(presence, width);
+  if (presence === "online") return theme.success(cell);
+  if (presence === "stale") return theme.warning(cell);
+  return theme.dim(cell);
+}
 function panelMetric(snapshot, panel) {
   if (panel === "agents") {
     const agents = visibleAgents(snapshot);
@@ -43131,7 +43160,7 @@ function listLines(snapshot, view, theme) {
   const now = Date.parse(snapshot.fetchedAt);
   const mark = (index) => cursor(theme, index === view.selected, "list", view.pane);
   if (view.tab === "agents") {
-    return visibleAgents(snapshot).map((agent, index) => `${mark(index)}${pad(agent.name, 14)} ${agent.online ? theme.success(pad("yes", 3)) : theme.dim(pad("no", 3))} ${pad(agent.model ?? "-", 18)} ${pad(age(agent.lastSeenAt, now), 4)}`);
+    return visibleAgents(snapshot).map((agent, index) => `${mark(index)}${pad(agent.name, 14)} ${presenceCell(agent, theme)} ${pad(agent.host ?? "-", 12)} ${pad(agent.model ?? "-", 14)} ${pad(age(agent.lastSeenAt, now), 4)}`);
   }
   if (view.tab === "tasks" || view.tab === "workflows") {
     const runs = view.tab === "tasks" ? snapshot.runs.filter((run) => run.status === "running" || run.status === "waiting") : snapshot.runs;
@@ -43169,9 +43198,10 @@ function detailLines(snapshot, view, theme) {
     const related = snapshot.openMessages.filter((message) => message.fromName === agent.name || message.toName === agent.name);
     return [
       theme.accent(agent.name),
-      `${agent.online ? theme.success("online") : theme.dim("offline")}  ${agent.model ?? "-"}`,
+      `${presenceCell(agent, theme, (agent.presence ?? "n/a").length)}  ${agent.model ?? "-"}`,
+      `host ${agent.host ?? "-"}`,
       agent.purpose,
-      `seen ${age(agent.lastSeenAt, now)} ago`,
+      `seen ${age(agent.lastSeenAt, now)} ago \xB7 lease ${agent.leaseExpiresAt?.slice(11, 19) ?? "n/a"} UTC`,
       "",
       theme.dim("Open work"),
       ...related.length === 0 ? [theme.dim("none")] : related.map((message) => `${message.status}  ${message.fromName} \u2192 ${message.toName}  ${age(message.createdAt, now)}`)
@@ -43480,7 +43510,7 @@ async function runMeshTui(input) {
     }
     if (!useOpsStream && identity) {
       try {
-        const listed = await input.fetchImpl(`${base}/v1/agents`, { headers: headers(identity) });
+        const listed = await input.fetchImpl(`${base}/v1/agents?includeOffline=true`, { headers: headers(identity) });
         if (listed.ok) {
           const body = await readJson(listed);
           const byId = new Map(local.agents.map((agent) => [agent.id, agent]));
@@ -47738,10 +47768,10 @@ function createProgram(ctx, result) {
   });
   const peer = addGlobalOptions(program2.command("peer").description("Peer agent messaging and coordination"));
   peer.helpCommand("help", "Show peer help");
-  addGlobalOptions(peer.command("list").description("List online peer agents in this project's hub pool")).option("--payload <json>", "JSON payload").action(async function peerListAction(opts) {
+  addGlobalOptions(peer.command("list").description("List peer agents in this project's hub pool with host and presence")).option("--include-offline", "Also list registered peers whose hub lease has expired").option("--payload <json>", "JSON payload").action(async function peerListAction(opts) {
     result.code = await dispatchAgentCliCommand(runtimeFrom(ctx, this), "kxm_list", opts ?? {});
   });
-  addGlobalOptions(peer.command("send [target] [content]").description("Send a focused request to a peer agent")).option("--target <name>", "Peer name or agent ID").option("--content <text>", "Focused request content").option("--delivery <mode>", "steer, followUp, or nextTurn").option("--correlation-id <id>", "Task grouping ID").option("--idempotency-key <key>", "Deduplication key").option("--workflow-context <json>", "Workflow context JSON").option("--ttl-ms <ms>", "Message TTL in milliseconds").option("--payload <json>", "JSON payload").action(async function peerSendAction(target, content, opts) {
+  addGlobalOptions(peer.command("send [target] [content]").description("Send a focused request to a peer agent")).option("--target <name>", "Peer name or agent ID").option("--content <text>", "Focused request content").option("--delivery <mode>", "steer, followUp, or nextTurn").option("--correlation-id <id>", "Task grouping ID").option("--idempotency-key <key>", "Deduplication key").option("--workflow-context <json>", "Workflow context JSON").option("--ttl-ms <ms>", "Message TTL in milliseconds").option("--allow-offline", "Queue the request if the target is registered but offline").option("--payload <json>", "JSON payload").action(async function peerSendAction(target, content, opts) {
     const options = { ...opts, ...target ? { target } : {}, ...content ? { content } : {} };
     result.code = await dispatchAgentCliCommand(runtimeFrom(ctx, this), "kxm_send", options);
   });

package/plugins/kxm/dist/client.js

@@ -1,11 +1,13 @@
 // plugins/kxm/src/client.ts
 import { createHash } from "node:crypto";
+import { hostname } from "node:os";
 
 // plugins/kxm/src/protocol.ts
 var DEFAULT_MESSAGE_TTL_MS = 24 * 60 * 6e4;
 var MAX_MESSAGE_TTL_MS = 7 * 24 * 60 * 6e4;
 var DEFAULT_MESSAGE_RETENTION_MS = 7 * 24 * 60 * 6e4;
 var MAX_BODY_BYTES = 256 * 1024;
+var MAX_AGENT_HOST_CHARS = 64;
 
 // plugins/kxm/src/workflow.ts
 function canonicalWorkflowEvidenceKey(value) {
@@ -21,6 +23,13 @@ var MeshWaitError = class extends Error {
     this.waitStatus = waitStatus;
   }
 };
+function defaultHostLabel() {
+  try {
+    return hostname().trim().slice(0, MAX_AGENT_HOST_CHARS) || void 0;
+  } catch {
+    return void 0;
+  }
+}
 function completedFanoutResult(target, message) {
   if (message.status === "queued" || message.status === "delivered") {
     throw new Error(`message ${message.id} is not complete`);
@@ -110,8 +119,11 @@ var HubClient = class {
     this.onEvent = void 0;
     this.eventLoop = void 0;
   }
-  async listAgents() {
-    const result = await this.request("/v1/agents");
+  /** Online peers of this client's project. `includeOffline` also returns
+   * registered members whose lease the hub has already retired. */
+  async listAgents(options = {}) {
+    const path = options.includeOffline ? "/v1/agents?includeOffline=true" : "/v1/agents";
+    const result = await this.request(path);
     return result.agents;
   }
   async send(options) {
@@ -351,7 +363,8 @@ var HubClient = class {
           name: this.options.name,
           purpose: this.options.purpose,
           project: this.options.project,
-          model: this.options.model
+          model: this.options.model,
+          host: this.options.host ?? defaultHostLabel()
         })
       }, false);
       this.agent = registration.agent;

package/plugins/kxm/dist/core.js

@@ -12,6 +12,17 @@ var DEFAULT_RATE_LIMIT_MAX = 600;
 var DEFAULT_RATE_LIMIT_WINDOW_MS = 6e4;
 var MAX_BODY_BYTES = 256 * 1024;
 var MAX_CONTENT_CHARS = 32e3;
+var MAX_AGENT_HOST_CHARS = 64;
+function agentPresenceView(agent, staleAfterMs = DEFAULT_STALE_AFTER_MS, now = Date.now()) {
+  const lastSeenMs = Date.parse(agent.lastSeenAt);
+  const leaseExpiresAtMs = (Number.isFinite(lastSeenMs) ? lastSeenMs : 0) + staleAfterMs;
+  const leaseExpiresAt = new Date(leaseExpiresAtMs).toISOString();
+  if (!agent.online) return { leaseExpiresAt, presence: "offline" };
+  return { leaseExpiresAt, presence: now < leaseExpiresAtMs ? "online" : "stale" };
+}
+function toAgentRecord(agent, staleAfterMs, now) {
+  return { ...agent, ...agentPresenceView(agent, staleAfterMs, now) };
+}
 var ProtocolError = class extends Error {
   statusCode;
   code;
@@ -945,14 +956,19 @@ var AGENT_COMMANDS = [
     group: "peer",
     verb: "list",
     label: "List hub peers",
-    description: "List online peer agents in this project's hub pool, including their names and purposes.",
+    description: "List peer agents in this project's hub pool with their names, purposes, host label, and hub-clocked presence (online, stale, offline). Registered offline peers are listed only when includeOffline is set.",
     parameters: {
       type: "object",
-      properties: {},
+      properties: {
+        includeOffline: {
+          type: "boolean",
+          description: "Also list registered peers whose hub lease has expired"
+        }
+      },
       additionalProperties: false
     },
-    async execute(client) {
-      return { agents: await client.listAgents() };
+    async execute(client, args) {
+      return { agents: await client.listAgents({ includeOffline: args.includeOffline === true }) };
     }
   },
   {
@@ -992,7 +1008,12 @@ var AGENT_COMMANDS = [
           required: ["runId", "stageId", "requirementKey", "attempt"],
           additionalProperties: false
         },
-        ttlMs: { type: "number", minimum: 1e3, maximum: 6048e5, description: "Message TTL in milliseconds" }
+        ttlMs: { type: "number", minimum: 1e3, maximum: 6048e5, description: "Message TTL in milliseconds" },
+        allowOffline: {
+          type: "boolean",
+          default: false,
+          description: "Queue the request if the target is a registered offline agent in this project"
+        }
       },
       required: ["target", "content"],
       additionalProperties: false
@@ -1009,7 +1030,8 @@ var AGENT_COMMANDS = [
         ...correlationId ? { correlationId } : {},
         ...idempotencyKey ? { idempotencyKey } : {},
         ...workflowContext ? { workflowContext } : {},
-        ...typeof args.ttlMs === "number" ? { ttlMs: args.ttlMs } : {}
+        ...typeof args.ttlMs === "number" ? { ttlMs: args.ttlMs } : {},
+        ...args.allowOffline === true ? { allowOffline: true } : {}
       });
       return { messageId: message.id, status: message.status, target: message.toName };
     }
@@ -2005,6 +2027,7 @@ export {
   DEFAULT_RATE_LIMIT_WINDOW_MS,
   DEFAULT_STALE_AFTER_MS,
   LOG_LEVEL_PRIORITY,
+  MAX_AGENT_HOST_CHARS,
   MAX_BODY_BYTES,
   MAX_CONTENT_CHARS,
   MAX_CONTEXT_ITEM_IDS,
@@ -2020,6 +2043,7 @@ export {
   TERMINAL_RECEIPT_SCHEMA,
   WORKER_RESULT_SCHEMA,
   WORKER_SCHEMA,
+  agentPresenceView,
   agentWorker,
   behavioralConfigHash,
   clearSessionTokenFromDisk,
@@ -2060,6 +2084,7 @@ export {
   rotateLogFiles,
   sessionTokenPath,
   timingSafeStringCompare,
+  toAgentRecord,
   validateTerminalReceipt,
   workerResult
 };

package/plugins/kxm/dist/extension.js

@@ -14534,6 +14534,7 @@ import { dirname, join, resolve } from "node:path";
 
 // plugins/kxm/src/client.ts
 import { createHash } from "node:crypto";
+import { hostname } from "node:os";
 
 // plugins/kxm/src/protocol.ts
 var DEFAULT_MESSAGE_TTL_MS = 24 * 60 * 6e4;
@@ -14541,6 +14542,7 @@ var MAX_MESSAGE_TTL_MS = 7 * 24 * 60 * 6e4;
 var DEFAULT_MESSAGE_RETENTION_MS = 7 * 24 * 60 * 6e4;
 var MAX_BODY_BYTES = 256 * 1024;
 var MAX_CONTENT_CHARS = 32e3;
+var MAX_AGENT_HOST_CHARS = 64;
 
 // plugins/kxm/src/workflow.ts
 function canonicalWorkflowEvidenceKey(value) {
@@ -14556,6 +14558,13 @@ var MeshWaitError = class extends Error {
     this.waitStatus = waitStatus;
   }
 };
+function defaultHostLabel() {
+  try {
+    return hostname().trim().slice(0, MAX_AGENT_HOST_CHARS) || void 0;
+  } catch {
+    return void 0;
+  }
+}
 function completedFanoutResult(target, message) {
   if (message.status === "queued" || message.status === "delivered") {
     throw new Error(`message ${message.id} is not complete`);
@@ -14645,8 +14654,11 @@ var HubClient = class {
     this.onEvent = void 0;
     this.eventLoop = void 0;
   }
-  async listAgents() {
-    const result2 = await this.request("/v1/agents");
+  /** Online peers of this client's project. `includeOffline` also returns
+   * registered members whose lease the hub has already retired. */
+  async listAgents(options = {}) {
+    const path = options.includeOffline ? "/v1/agents?includeOffline=true" : "/v1/agents";
+    const result2 = await this.request(path);
     return result2.agents;
   }
   async send(options) {
@@ -14886,7 +14898,8 @@ var HubClient = class {
           name: this.options.name,
           purpose: this.options.purpose,
           project: this.options.project,
-          model: this.options.model
+          model: this.options.model,
+          host: this.options.host ?? defaultHostLabel()
         })
       }, false);
       this.agent = registration.agent;
@@ -15014,14 +15027,19 @@ var AGENT_COMMANDS = [
     group: "peer",
     verb: "list",
     label: "List hub peers",
-    description: "List online peer agents in this project's hub pool, including their names and purposes.",
+    description: "List peer agents in this project's hub pool with their names, purposes, host label, and hub-clocked presence (online, stale, offline). Registered offline peers are listed only when includeOffline is set.",
     parameters: {
       type: "object",
-      properties: {},
+      properties: {
+        includeOffline: {
+          type: "boolean",
+          description: "Also list registered peers whose hub lease has expired"
+        }
+      },
       additionalProperties: false
     },
-    async execute(client) {
-      return { agents: await client.listAgents() };
+    async execute(client, args) {
+      return { agents: await client.listAgents({ includeOffline: args.includeOffline === true }) };
     }
   },
   {
@@ -15061,7 +15079,12 @@ var AGENT_COMMANDS = [
           required: ["runId", "stageId", "requirementKey", "attempt"],
           additionalProperties: false
         },
-        ttlMs: { type: "number", minimum: 1e3, maximum: 6048e5, description: "Message TTL in milliseconds" }
+        ttlMs: { type: "number", minimum: 1e3, maximum: 6048e5, description: "Message TTL in milliseconds" },
+        allowOffline: {
+          type: "boolean",
+          default: false,
+          description: "Queue the request if the target is a registered offline agent in this project"
+        }
       },
       required: ["target", "content"],
       additionalProperties: false
@@ -15078,7 +15101,8 @@ var AGENT_COMMANDS = [
         ...correlationId ? { correlationId } : {},
         ...idempotencyKey ? { idempotencyKey } : {},
         ...workflowContext ? { workflowContext } : {},
-        ...typeof args.ttlMs === "number" ? { ttlMs: args.ttlMs } : {}
+        ...typeof args.ttlMs === "number" ? { ttlMs: args.ttlMs } : {},
+        ...args.allowOffline === true ? { allowOffline: true } : {}
       });
       return { messageId: message.id, status: message.status, target: message.toName };
     }

package/plugins/kxm/dist/mcp-server.js

@@ -15755,12 +15755,14 @@ var StdioServerTransport = class {
 
 // plugins/kxm/src/client.ts
 import { createHash } from "node:crypto";
+import { hostname } from "node:os";
 
 // plugins/kxm/src/protocol.ts
 var DEFAULT_MESSAGE_TTL_MS = 24 * 60 * 6e4;
 var MAX_MESSAGE_TTL_MS = 7 * 24 * 60 * 6e4;
 var DEFAULT_MESSAGE_RETENTION_MS = 7 * 24 * 60 * 6e4;
 var MAX_BODY_BYTES = 256 * 1024;
+var MAX_AGENT_HOST_CHARS = 64;
 
 // plugins/kxm/src/workflow.ts
 function canonicalWorkflowEvidenceKey(value) {
@@ -15776,6 +15778,13 @@ var MeshWaitError = class extends Error {
     this.waitStatus = waitStatus;
   }
 };
+function defaultHostLabel() {
+  try {
+    return hostname().trim().slice(0, MAX_AGENT_HOST_CHARS) || void 0;
+  } catch {
+    return void 0;
+  }
+}
 function completedFanoutResult(target, message) {
   if (message.status === "queued" || message.status === "delivered") {
     throw new Error(`message ${message.id} is not complete`);
@@ -15865,8 +15874,11 @@ var HubClient = class {
     this.onEvent = void 0;
     this.eventLoop = void 0;
   }
-  async listAgents() {
-    const result = await this.request("/v1/agents");
+  /** Online peers of this client's project. `includeOffline` also returns
+   * registered members whose lease the hub has already retired. */
+  async listAgents(options = {}) {
+    const path = options.includeOffline ? "/v1/agents?includeOffline=true" : "/v1/agents";
+    const result = await this.request(path);
     return result.agents;
   }
   async send(options) {
@@ -16106,7 +16118,8 @@ var HubClient = class {
           name: this.options.name,
           purpose: this.options.purpose,
           project: this.options.project,
-          model: this.options.model
+          model: this.options.model,
+          host: this.options.host ?? defaultHostLabel()
         })
       }, false);
       this.agent = registration.agent;
@@ -16325,14 +16338,19 @@ var AGENT_COMMANDS = [
     group: "peer",
     verb: "list",
     label: "List hub peers",
-    description: "List online peer agents in this project's hub pool, including their names and purposes.",
+    description: "List peer agents in this project's hub pool with their names, purposes, host label, and hub-clocked presence (online, stale, offline). Registered offline peers are listed only when includeOffline is set.",
     parameters: {
       type: "object",
-      properties: {},
+      properties: {
+        includeOffline: {
+          type: "boolean",
+          description: "Also list registered peers whose hub lease has expired"
+        }
+      },
       additionalProperties: false
     },
-    async execute(client) {
-      return { agents: await client.listAgents() };
+    async execute(client, args) {
+      return { agents: await client.listAgents({ includeOffline: args.includeOffline === true }) };
     }
   },
   {
@@ -16372,7 +16390,12 @@ var AGENT_COMMANDS = [
           required: ["runId", "stageId", "requirementKey", "attempt"],
           additionalProperties: false
         },
-        ttlMs: { type: "number", minimum: 1e3, maximum: 6048e5, description: "Message TTL in milliseconds" }
+        ttlMs: { type: "number", minimum: 1e3, maximum: 6048e5, description: "Message TTL in milliseconds" },
+        allowOffline: {
+          type: "boolean",
+          default: false,
+          description: "Queue the request if the target is a registered offline agent in this project"
+        }
       },
       required: ["target", "content"],
       additionalProperties: false
@@ -16389,7 +16412,8 @@ var AGENT_COMMANDS = [
         ...correlationId ? { correlationId } : {},
         ...idempotencyKey ? { idempotencyKey } : {},
         ...workflowContext ? { workflowContext } : {},
-        ...typeof args.ttlMs === "number" ? { ttlMs: args.ttlMs } : {}
+        ...typeof args.ttlMs === "number" ? { ttlMs: args.ttlMs } : {},
+        ...args.allowOffline === true ? { allowOffline: true } : {}
       });
       return { messageId: message.id, status: message.status, target: message.toName };
     }
@@ -17121,7 +17145,7 @@ async function deliverInboxNotification(messageId, delivered, notify) {
 }
 
 // plugins/kxm/src/mcp-server.ts
-var VERSION = "0.7.69";
+var VERSION = "0.7.71";
 var inbox = /* @__PURE__ */ new Map();
 var notifiedInbox = /* @__PURE__ */ new Set();
 var meshClient;