@open-artifacts/bus 0.124.0 → 0.125.0

package/assets/oa-bus.ts

@@ -11,7 +11,7 @@ import { StringDecoder } from "node:string_decoder";
 type Json = Record<string, unknown>;
 
 /** The IPC marker (CONTRACT.md): the package version, stamped by the CLI's bundler. */
-const CLIENT_VERSION = "0.124.0";
+const CLIENT_VERSION = "0.125.0";
 
 type Frame = Json & { type: string; id: string };
 type Ctx = {
@@ -116,6 +116,16 @@ const refusals: Record<
     `200 messages are already waiting.`,
     "Send again once some are delivered or expire.",
   ],
+  // #1295: the cap sockets' inbox_full (pending count, bytes or the hub total).
+  mailbox_full: [
+    "Its mailbox is full.",
+    "Send again once it has read some, or message another agent.",
+  ],
+  // #1295: a name only held after a move; no one reads it.
+  reserved_name: [
+    "No one has that name now; it was left by an agent that moved.",
+    "Run the oa_bus list_agents tool to find who has it now.",
+  ],
   too_large: [
     "It is too large to send (the limit is 1 MB).",
     "Send a shorter message.",
@@ -416,6 +426,14 @@ function statusSaysText(
   ].join(" · ");
 }
 
+/** "2026-11-05 10:00 UTC" from an ISO time; unreadable times are shown as sent. */
+const awayTime = (iso: string): string => {
+  const t = Date.parse(iso);
+  return Number.isNaN(t)
+    ? iso
+    : `${new Date(t).toISOString().slice(0, 16).replace("T", " ")} UTC`;
+};
+
 /** @oa/bus-ipc rosterLine: one list_agents line. */
 function rosterLine(
   a: StatusFields & {
@@ -424,11 +442,13 @@ function rosterLine(
     namespace: string;
     machine_label?: unknown;
     queued: boolean;
+    /** #1295: ISO time the agent went away; it is closed, its mailbox kept. */
+    away?: string | undefined;
   },
   now = Date.now(),
 ): string {
   const says = statusSaysText(a, now);
-  return `- ${a.name} (${displayKind(a.kind)}, ${a.namespace}${typeof a.machine_label === "string" && a.machine_label ? `, ${a.machine_label}` : ""})${a.queued ? " (queued)" : ""}${says ? `  ${says}` : ""}`;
+  return `- ${a.name} (${displayKind(a.kind)}, ${a.namespace}${typeof a.machine_label === "string" && a.machine_label ? `, ${a.machine_label}` : ""})${a.away !== undefined ? (a.away ? ` (away since ${awayTime(a.away)})` : " (away)") : a.queued ? " (queued)" : ""}${says ? `  ${says}` : ""}`;
 }
 
 /** @oa/bus-ipc selfText: the agent entry, its status cleaned. */
@@ -838,6 +858,8 @@ function open(
         pid: process.pid,
         cwd: id.cwd,
         proposed_name: id.name,
+        // #1295: this asset decodes away rows and the new refusals.
+        caps: ["mailbox"],
         attest: start ? { proc_start: start } : {},
       }),
     );
@@ -1032,6 +1054,7 @@ export default function oaBus(pi: Pi): void {
                   namespace: String(a.namespace),
                   queued:
                     (a.state ?? (a.live ? "live" : "queued")) === "queued",
+                  away: a.state === "away" ? String(a.since ?? "") : undefined,
                 },
                 now,
               ),

package/dist/index.js

@@ -31389,7 +31389,17 @@ var init_caps = __esm({
        * to a socket whose hello listed it, and lists it in `hello_ok.caps`; the
        * client sends `to_id` only when it did.
        */
-      ids: "ids"
+      ids: "ids",
+      /**
+       * Lasting mailboxes (#1295): the client decodes a send receipt's `queued`
+       * and `since`, the `mailbox_full` and `reserved_name` refusals, and roster
+       * rows with `state: "away"` and `since`. The hub sends those only to a
+       * socket whose hello listed it, and lists it in `hello_ok.caps`; any other
+       * socket sees today's shapes (`inbox_full`, `unknown_agent`, no away rows).
+       * A client also lists it to have the hub hand an address over on `agent_up`
+       * `replaces` (a /clear).
+       */
+      mailbox: "mailbox"
     };
     MAX_CAPS = 16;
     CapTokenSchema = external_exports.string().regex(/^[a-z][a-z0-9_-]{0,31}$/);
@@ -31819,6 +31829,33 @@ var init_names = __esm({
   }
 });
 
+// ../bus-protocol/src/status.ts
+var IsoTimeSchema, STATUS_STATES, StatusStateSchema, StatusLabelSchema, AgentStatusSchema;
+var init_status = __esm({
+  "../bus-protocol/src/status.ts"() {
+    "use strict";
+    init_zod();
+    init_limits();
+    init_refs();
+    IsoTimeSchema = external_exports.string().datetime({ offset: true });
+    STATUS_STATES = [
+      "working",
+      "idle",
+      "blocked",
+      "waiting_on_owner"
+    ];
+    StatusStateSchema = external_exports.enum(STATUS_STATES);
+    StatusLabelSchema = MachineLabelSchema.refine(
+      (s) => [...s].length <= LIMITS.maxLabelChars,
+      "status label too long"
+    );
+    AgentStatusSchema = external_exports.strictObject({
+      state: StatusStateSchema,
+      label: StatusLabelSchema.optional()
+    });
+  }
+});
+
 // ../bus-protocol/src/receipts.ts
 var RECEIPT_STATES, ReceiptStateSchema, REFUSAL_REASONS, RefusalReasonSchema, ReceiptReasonSchema, MsgIdSchema, receiptReasonMatchesState, receiptShape, ReceiptSchema;
 var init_receipts = __esm({
@@ -31826,6 +31863,7 @@ var init_receipts = __esm({
     "use strict";
     init_zod();
     init_names();
+    init_status();
     RECEIPT_STATES = [
       "pending",
       "delivered",
@@ -31848,7 +31886,19 @@ var init_receipts = __esm({
        */
       "role_vacant",
       /** A reply's `to_id` no longer holds the name: the agent it answers is gone. */
-      "agent_gone"
+      "agent_gone",
+      /**
+       * #1295: the address's mailbox is full (pending count or bytes). Sent only
+       * to a socket whose hello listed `BUS_CAPS.mailbox`; any other gets
+       * `inbox_full`.
+       */
+      "mailbox_full",
+      /**
+       * #1295: the name is only a `held` reservation of a moved or flipped agent;
+       * it has no mailbox. Sent only to a `BUS_CAPS.mailbox` socket; any other
+       * gets `unknown_agent`.
+       */
+      "reserved_name"
     ];
     RefusalReasonSchema = external_exports.enum(REFUSAL_REASONS);
     ReceiptReasonSchema = external_exports.union([
@@ -31867,39 +31917,20 @@ var init_receipts = __esm({
        * through a role address (#1296, the role's holder), to a socket whose
        * hello listed `BUS_CAPS.roles`. An ordinary send never carries it.
        */
-      to_name: BusNameSchema.optional()
+      to_name: BusNameSchema.optional(),
+      /**
+       * #1295, on a `pending` send receipt only, to a socket whose hello listed
+       * `BUS_CAPS.mailbox`: the mail was stored, not pushed. `away`: the
+       * recipient is closed and its mailbox waits for it. `offline`: it is open
+       * but its machine is offline. `since` is when that began.
+       */
+      queued: external_exports.enum(["away", "offline"]).optional(),
+      since: IsoTimeSchema.optional()
     };
     ReceiptSchema = external_exports.strictObject(receiptShape).refine(receiptReasonMatchesState, "reason does not match state");
   }
 });
 
-// ../bus-protocol/src/status.ts
-var IsoTimeSchema, STATUS_STATES, StatusStateSchema, StatusLabelSchema, AgentStatusSchema;
-var init_status = __esm({
-  "../bus-protocol/src/status.ts"() {
-    "use strict";
-    init_zod();
-    init_limits();
-    init_refs();
-    IsoTimeSchema = external_exports.string().datetime({ offset: true });
-    STATUS_STATES = [
-      "working",
-      "idle",
-      "blocked",
-      "waiting_on_owner"
-    ];
-    StatusStateSchema = external_exports.enum(STATUS_STATES);
-    StatusLabelSchema = MachineLabelSchema.refine(
-      (s) => [...s].length <= LIMITS.maxLabelChars,
-      "status label too long"
-    );
-    AgentStatusSchema = external_exports.strictObject({
-      state: StatusStateSchema,
-      label: StatusLabelSchema.optional()
-    });
-  }
-});
-
 // ../bus-protocol/src/rename.ts
 var NAME_KINDS, NameKindSchema, FormerNameSchema, FormerNamesSchema;
 var init_rename = __esm({
@@ -32063,7 +32094,17 @@ var init_protocol2 = __esm({
        * decoder older than this field refuses the unknown key, so a client sends
        * it only to hubs that accept it.
        */
-      name_kind: NameKindSchema.optional()
+      name_kind: NameKindSchema.optional(),
+      /**
+       * #1295: the agent_ref this one takes over from, after a /clear: the same
+       * live process now reports a new session. The hub honours it only for a
+       * socket whose hello listed `BUS_CAPS.mailbox`, when the old ref is an
+       * agent of the same machine; the new ref then inherits the old address
+       * (name, former names) and its pending mail, instead of `<name>-2`. A hub
+       * decoder older than this field refuses the key, so a client sends it only
+       * after `hello_ok.caps` listed `mailbox`.
+       */
+      replaces: AgentRefSchema.optional()
     });
     AgentDown = external_exports.strictObject({
       ...base,
@@ -32169,9 +32210,16 @@ var init_protocol2 = __esm({
       global: external_exports.boolean(),
       /**
        * `live`: machine connected. `queued`: machine disconnected but the session
-       * was last reported open (mail waits up to 1 h). Closed agents are omitted.
+       * was last reported open (mail waits). `away` (#1295, cap-gated): closed,
+       * its mailbox kept for 7 d. Other closed agents are omitted.
        */
-      state: external_exports.enum(["live", "queued"]),
+      state: external_exports.enum(["live", "queued", "away"]),
+      /**
+       * When an `away` agent closed (#1295). Sent, with `state: "away"`, only to
+       * a socket whose hello listed `BUS_CAPS.mailbox`: a decoder older than
+       * either refuses the row, and with it the whole roster.
+       */
+      since: IsoTimeSchema.optional(),
       /** The agent's machine label. */
       machine_label: MachineLabelSchema.optional(),
       /** Self-reported ("agent says"); cleared on close. */
@@ -32344,7 +32392,7 @@ var init_src = __esm({
 });
 
 // ../bus-ipc/src/frames.ts
-var V, MAX_BODY_BYTES, MAX_LINE_BYTES, INLINE_CAP_BYTES, KIND, KIND_TOKEN, AGENT_REF, base2, late, isWellFormed2, WELL_FORMED, CLIENT_VERSION, clientVersion, Hello2, SPAWNED_SOURCES, optIn, Send2, List2, Self, Fetch2, Ack2, SetStatus, StatusRequest, AdapterFrame, AgentInfo, Welcome, Receipt, Roster2, Agent, StatusSet, Body, Deliver2, Notice2, ErrorFrame2, StatusReply, DaemonFrame;
+var V, MAX_BODY_BYTES, MAX_LINE_BYTES, INLINE_CAP_BYTES, KIND, KIND_TOKEN, AGENT_REF, base2, late, isWellFormed2, WELL_FORMED, CLIENT_VERSION, clientVersion, ADAPTER_CAPS, Hello2, SPAWNED_SOURCES, optIn, Send2, List2, Self, Fetch2, Ack2, SetStatus, StatusRequest, AdapterFrame, ConfigFile, AgentInfo, Welcome, Receipt, Roster2, Agent, StatusSet, Body, Deliver2, Notice2, ErrorFrame2, StatusReply, DaemonFrame;
 var init_frames = __esm({
   "../bus-ipc/src/frames.ts"() {
     "use strict";
@@ -32361,10 +32409,11 @@ var init_frames = __esm({
     late = { late: external_exports.array(external_exports.string().min(1)).optional() };
     isWellFormed2 = (s) => s.isWellFormed();
     WELL_FORMED = { message: "text is not well-formed unicode" };
-    CLIENT_VERSION = true ? "0.124.0" : "0.0.0";
+    CLIENT_VERSION = true ? "0.125.0" : "0.0.0";
     clientVersion = {
       client_version: external_exports.string().min(1).max(64).optional()
     };
+    ADAPTER_CAPS = { mailbox: "mailbox" };
     Hello2 = external_exports.object({
       ...base2,
       ...clientVersion,
@@ -32379,6 +32428,8 @@ var init_frames = __esm({
        */
       cwd: external_exports.string().min(1).max(4096).optional(),
       proposed_name: external_exports.string().min(1).max(64).refine(isWellFormed2, WELL_FORMED).optional(),
+      /** What this adapter can decode (ADAPTER_CAPS); absent means none. */
+      caps: external_exports.array(external_exports.string().max(32)).max(16).optional(),
       /** What the harness told the adapter, re-checked by the daemon. */
       attest: external_exports.object({
         session_id: external_exports.string().optional(),
@@ -32474,21 +32525,34 @@ var init_frames = __esm({
       Ack2,
       SetStatus
     ]);
+    ConfigFile = external_exports.object({
+      file: external_exports.string(),
+      state: external_exports.enum(["refused", "noted"]),
+      reason: external_exports.string(),
+      fix: external_exports.string()
+    });
     AgentInfo = external_exports.object({
       name: external_exports.string(),
       namespace: external_exports.string(),
       kind: KIND_TOKEN,
       /** `state === "live"`; kept for older adapters. */
       live: external_exports.boolean(),
-      /** Roster entries only: `queued` means the agent's machine is disconnected. */
-      state: external_exports.enum(["live", "queued"]).optional(),
+      /**
+       * Roster entries only: `queued` means the agent's machine is disconnected;
+       * `away` (#1295) means it is closed and its mailbox is kept, with `since`.
+       */
+      state: external_exports.enum(["live", "queued", "away"]).optional(),
+      /** When an `away` agent closed. */
+      since: IsoTimeSchema.optional(),
       global: external_exports.boolean(),
       /** The agent's machine (B13); absent when the hub is older. */
       machine_label: MachineLabelSchema.optional(),
       /** The agent's own status claim, from the hub. */
       status: StatusStateSchema.optional(),
       status_label: StatusLabelSchema.optional(),
-      status_at: IsoTimeSchema.optional()
+      status_at: IsoTimeSchema.optional(),
+      /** `self` with `row` only: config files refused or noted. Older adapters ignore it. */
+      config_files: external_exports.array(ConfigFile).optional()
     });
     Welcome = external_exports.object({
       ...base2,
@@ -32599,6 +32663,8 @@ var init_frames = __esm({
           )
         })
       ),
+      /** Config files refused or noted (#1527). Absent from older daemons, and when there are none. */
+      config_files: external_exports.array(ConfigFile).optional(),
       /** Messages sent from this machine the hub delivered after the 5 s window, within the last hour. */
       late: external_exports.array(
         external_exports.object({
@@ -32984,7 +33050,7 @@ function statusSaysText(row, now = Date.now()) {
 }
 function rosterLine(a, now = Date.now()) {
   const says = statusSaysText(a, now);
-  return `- ${a.name} (${displayKind(a.kind)}, ${a.namespace}${typeof a.machine_label === "string" && a.machine_label ? `, ${a.machine_label}` : ""})${a.queued ? " (queued)" : ""}${says ? `  ${says}` : ""}`;
+  return `- ${a.name} (${displayKind(a.kind)}, ${a.namespace}${typeof a.machine_label === "string" && a.machine_label ? `, ${a.machine_label}` : ""})${a.away !== void 0 ? a.away ? ` (away since ${awayTime(a.away)})` : " (away)" : a.queued ? " (queued)" : ""}${says ? `  ${says}` : ""}`;
 }
 function selfText(agent) {
   if (!agent) return JSON.stringify(agent, null, 2);
@@ -32998,7 +33064,7 @@ function selfText(agent) {
   };
   return JSON.stringify(shown2, null, 2);
 }
-var MAX_COLS, RETAIN, MB, refusals, quoted, TERMINAL_CONTROLS, CUT_OFF, stripTerminalControls, KIND_CHARS, displayKind, neutralizeBody, deliveredText, oversizedText, INVISIBLES, EXCERPT_CHARS, STATUS_COPY, BAD_LABEL_CHARS2, cleanStatusLabel, statusLabelTooLong, statusSetText, earlierStatusText, STATUS_STALE_MS, agoText, displayLabel, replyGoneText;
+var MAX_COLS, RETAIN, MB, refusals, quoted, TERMINAL_CONTROLS, CUT_OFF, stripTerminalControls, KIND_CHARS, displayKind, neutralizeBody, deliveredText, oversizedText, INVISIBLES, EXCERPT_CHARS, STATUS_COPY, BAD_LABEL_CHARS2, cleanStatusLabel, statusLabelTooLong, statusSetText, earlierStatusText, STATUS_STALE_MS, agoText, displayLabel, awayTime, replyGoneText;
 var init_copy = __esm({
   "../bus-ipc/src/copy.ts"() {
     "use strict";
@@ -33019,6 +33085,16 @@ var init_copy = __esm({
         `${MAILBOX_PENDING_CAP} messages are already waiting.`,
         "Send again once some are delivered or expire."
       ],
+      // #1295: the cap sockets' inbox_full (pending count, bytes or the hub total).
+      mailbox_full: [
+        "Its mailbox is full.",
+        "Send again once it has read some, or message another agent."
+      ],
+      // #1295: a name only held after a move; no one reads it.
+      reserved_name: [
+        "No one has that name now; it was left by an agent that moved.",
+        "Run the oa_bus list_agents tool to find who has it now."
+      ],
       too_large: [
         `It is too large to send (the limit is ${MB}).`,
         "Send a shorter message."
@@ -33099,6 +33175,10 @@ ${neutralizeBody(m.body)}`;
       return `${Math.round(ms / 864e5)} d ago`;
     };
     displayLabel = (label) => [...cleanStatusLabel(stripTerminalControls(label).replace(INVISIBLES, ""))].slice(0, LIMITS.maxLabelChars).join("").replaceAll('"', "'");
+    awayTime = (iso) => {
+      const t = Date.parse(iso);
+      return Number.isNaN(t) ? iso : `${new Date(t).toISOString().slice(0, 16).replace("T", " ")} UTC`;
+    };
     replyGoneText = (name) => `[oa-bus] Information: your reply to ${name} was not sent. The agent that wrote to you as ${name} is gone, or wrote over an hour ago, and another agent may hold that name now. Use the oa_bus list_agents and send_message tools to reach the agent you mean.`;
   }
 });
@@ -33441,7 +33521,16 @@ async function run(name, args, request) {
       if (r.type !== "roster") return failed(r);
       const now = Date.now();
       return text(
-        r.agents.length ? r.agents.map((a) => rosterLine({ ...a, queued: queued(a) }, now)).join("\n") : "No agents in your namespace."
+        r.agents.length ? r.agents.map(
+          (a) => rosterLine(
+            {
+              ...a,
+              queued: queued(a),
+              away: a.state === "away" ? a.since ?? "" : void 0
+            },
+            now
+          )
+        ).join("\n") : "No agents in your namespace."
       );
     }
     if (name === "send_message") {
@@ -33669,6 +33758,7 @@ function codexHello(call, pid, ppid) {
     pid,
     ...call.cwd ? { cwd: call.cwd } : {},
     proposed_name: "codex",
+    caps: [ADAPTER_CAPS.mailbox],
     codex: {
       thread_id: call.threadId,
       call_id: call.callId,
@@ -33911,6 +34001,7 @@ function sessionHello(session, pid, cwd) {
     pid,
     cwd,
     proposed_name: fitName(session.name, 64) || void 0,
+    caps: [ADAPTER_CAPS.mailbox],
     attest: {
       session_id: session.sessionId,
       socket_path: session.socketPath ?? void 0
@@ -33989,8 +34080,8 @@ function shortSocketDir(home2) {
   );
 }
 function daemonSocketPath(home2) {
-  const plain2 = join2(canonicalHome(home2), "daemon.sock");
-  return fits(plain2) ? plain2 : join2(shortSocketDir(home2), "daemon.sock");
+  const plain3 = join2(canonicalHome(home2), "daemon.sock");
+  return fits(plain3) ? plain3 : join2(shortSocketDir(home2), "daemon.sock");
 }
 function claudeReturnDir(home2) {
   const dir = join2(canonicalHome(home2), "claude-return");
@@ -37803,6 +37894,7 @@ async function handleToolCall(input2) {
       pid: process.pid,
       cwd: session.directory,
       proposed_name: nameOf(session.title),
+      caps: [ADAPTER_CAPS.mailbox],
       attest: { session_id: sessionId }
     });
     let client;
@@ -38088,6 +38180,33 @@ var init_codex_main = __esm({
   }
 });
 
+// ../shared/src/harness-skills.ts
+var harnessSkills = {
+  claude: {
+    skillPath: "~/.claude/skills/open-artifacts/SKILL.md",
+    busToolName: (tool) => `mcp__oa_bus__${tool}`
+  },
+  // CODEX_TOOL_NAMESPACE = "mcp__oa_bus" (packages/bus-daemon/src/codex-attest.ts).
+  codex: {
+    skillPath: "~/.codex/AGENTS.md",
+    busToolName: (tool) => `mcp__oa_bus__${tool}`,
+    agentsMd: true
+  },
+  opencode: {
+    skillPath: "~/.config/opencode/skills/open-artifacts/SKILL.md",
+    busToolName: (tool) => `oa_bus_${tool}`
+  },
+  pi: {
+    skillPath: "~/.agents/skills/open-artifacts/SKILL.md"
+  },
+  omp: {
+    skillPath: "~/.agents/skills/open-artifacts/SKILL.md"
+  }
+};
+
+// src/harness-table.ts
+var harnessNames = Object.keys(harnessSkills);
+
 // src/main.ts
 import { resolve as resolve7 } from "node:path";
 
@@ -38097,7 +38216,7 @@ import { join as join15 } from "node:path";
 
 // ../bus-daemon/src/index.ts
 init_src3();
-import { lstatSync as lstatSync6, writeFileSync as writeFileSync4 } from "node:fs";
+import { lstatSync as lstatSync6, realpathSync as realpathSync6, writeFileSync as writeFileSync4 } from "node:fs";
 import { basename as basename5, isAbsolute as isAbsolute5, join as join11 } from "node:path";
 
 // ../bus-adapter-opencode/src/version.ts
@@ -38949,7 +39068,7 @@ function sessionFiles(dir) {
   return out;
 }
 var alive = (s, deps) => deps.isRunning(s.pid) && deps.procStart(s.pid, s.stamp) === s.procStart;
-var strip = ({ procStart: _, stamp: __, ...s }) => s;
+var strip = ({ stamp: _, ...s }) => s;
 function liveClaudeSessions(deps) {
   return sessionFiles(deps.dir).filter((s) => alive(s, deps)).map(strip);
 }
@@ -39081,6 +39200,314 @@ function defaultOpenSessions() {
   });
 }
 
+// ../bus-daemon/src/config-issues.ts
+init_src();
+import { realpathSync as realpathSync4 } from "node:fs";
+import { dirname as dirname4, join as join8 } from "node:path";
+
+// ../bus-daemon/src/global.ts
+import { randomBytes } from "node:crypto";
+import {
+  chmodSync as chmodSync3,
+  closeSync as closeSync3,
+  lstatSync as lstatSync4,
+  mkdirSync as mkdirSync4,
+  openSync as openSync3,
+  realpathSync as realpathSync3,
+  renameSync as renameSync2,
+  statSync as statSync6,
+  unlinkSync,
+  writeSync
+} from "node:fs";
+import { dirname as dirname3, isAbsolute as isAbsolute3, join as join7, sep } from "node:path";
+
+// ../bus-daemon/src/own-file.ts
+import {
+  closeSync as closeSync2,
+  constants,
+  fstatSync as fstatSync2,
+  openSync as openSync2,
+  readFileSync as readFileSync6
+} from "node:fs";
+import { userInfo } from "node:os";
+function isPrivateGroup(gid, user, read = () => readFileSync6("/etc/group", "utf8"), readPasswd = () => readFileSync6("/etc/passwd", "utf8")) {
+  let text3;
+  let passwd;
+  try {
+    text3 = read();
+    passwd = readPasswd();
+  } catch {
+    return false;
+  }
+  for (const line of passwd.split("\n")) {
+    const f = line.split(":");
+    if (f[3] === String(gid) && f[0] !== user) return false;
+  }
+  for (const line of text3.split("\n")) {
+    const [name, , id, members2] = line.split(":");
+    if (id === String(gid))
+      return name === user && (members2 ?? "").trim() === "";
+  }
+  return false;
+}
+var ownGroup = () => ({
+  gid: process.getgid?.(),
+  isPrivate: (gid) => {
+    if (process.platform !== "linux") return false;
+    try {
+      return isPrivateGroup(gid, userInfo().username);
+    } catch {
+      return false;
+    }
+  }
+});
+function readOwnFile(file2, uid = process.getuid?.(), opts = {}) {
+  let fd;
+  try {
+    fd = openSync2(
+      file2,
+      constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0)
+    );
+  } catch (e) {
+    const code2 = e.code;
+    if (code2 === "ENOENT" || code2 === "ENOTDIR") return { state: "none" };
+    return {
+      state: "unsafe",
+      why: code2 === "ELOOP" ? "is a symlink" : `cannot be read (${code2})`
+    };
+  }
+  try {
+    const st = fstatSync2(fd);
+    if (!st.isFile()) return { state: "unsafe", why: "is not a regular file" };
+    if (uid !== void 0 && st.uid !== uid)
+      return { state: "unsafe", why: "belongs to another user" };
+    if (opts.allowGroupWrite) {
+      if (st.mode & 2)
+        return { state: "unsafe", why: "is writable by everyone" };
+      let note;
+      if (st.mode & 16) {
+        const g = opts.group ?? ownGroup();
+        if (st.gid !== g.gid || !g.isPrivate(st.gid))
+          return {
+            state: "unsafe",
+            why: "is writable by a group others share"
+          };
+        note = "is writable by its group";
+      }
+      return {
+        state: "ok",
+        text: readFileSync6(fd, "utf8"),
+        ...note ? { note } : {}
+      };
+    }
+    if (st.mode & 18)
+      return { state: "unsafe", why: "is writable by others" };
+    return { state: "ok", text: readFileSync6(fd, "utf8") };
+  } catch (e) {
+    return {
+      state: "unsafe",
+      why: `cannot be read (${e.code ?? String(e)})`
+    };
+  } finally {
+    closeSync2(fd);
+  }
+}
+
+// ../bus-daemon/src/global.ts
+var globalFile = (h = home()) => join7(h, "global.json");
+var canonicalPath = (path) => realpathSync3.native(path);
+function readGlobalDirs(file2 = globalFile()) {
+  const own2 = readOwnFile(file2);
+  if (own2.state === "none") return { dirs: [] };
+  if (own2.state === "unsafe") return { dirs: [], error: own2.why };
+  try {
+    const raw = JSON.parse(own2.text);
+    const dirs = raw?.dirs;
+    if (!Array.isArray(raw) && Array.isArray(dirs) && dirs.every((d) => typeof d === "string" && isAbsolute3(d)))
+      return { dirs };
+  } catch {
+  }
+  return { dirs: [], error: "is not valid JSON" };
+}
+var idOf = (path, follow = true) => {
+  try {
+    const st = follow ? statSync6(path) : lstatSync4(path);
+    return st.isDirectory() ? `${st.dev}:${st.ino}` : void 0;
+  } catch {
+    return void 0;
+  }
+};
+var loose = (p) => p.normalize("NFC").toLowerCase();
+function isGlobalDir(dir, dirs, onStale) {
+  let real2;
+  try {
+    real2 = realpathSync3(dir);
+  } catch {
+    return false;
+  }
+  const near = loose(real2);
+  const ids = /* @__PURE__ */ new Set();
+  for (const entry of dirs) {
+    const e = loose(entry);
+    const prefix = e.endsWith(sep) ? e : `${e}${sep}`;
+    if (near !== e && !near.startsWith(prefix)) continue;
+    let still;
+    try {
+      still = realpathSync3.native(entry);
+    } catch {
+    }
+    if (still !== entry) {
+      if (still !== void 0) onStale?.(entry);
+      continue;
+    }
+    const id = idOf(entry, false);
+    if (id !== void 0) ids.add(id);
+  }
+  if (ids.size === 0) return false;
+  for (let d = real2; ; d = dirname3(d)) {
+    const id = idOf(d);
+    if (id !== void 0 && ids.has(id)) return true;
+    if (dirname3(d) === d) return false;
+  }
+}
+function sameDir(entry, dir) {
+  try {
+    if (realpathSync3.native(entry) !== entry) return false;
+  } catch {
+    return false;
+  }
+  const id = idOf(entry, false);
+  return id !== void 0 && id === idOf(dir);
+}
+function writeGlobalDirs(dirs, h = home()) {
+  mkdirSync4(h, { recursive: true, mode: 448 });
+  chmodSync3(h, 448);
+  const tmp = join7(h, `.global.json.${randomBytes(8).toString("hex")}.tmp`);
+  const fd = openSync3(tmp, "wx", 384);
+  try {
+    writeSync(fd, `${JSON.stringify({ dirs }, null, 2)}
+`);
+  } catch (e) {
+    closeSync3(fd);
+    unlinkSync(tmp);
+    throw e;
+  }
+  closeSync3(fd);
+  try {
+    chmodSync3(tmp, 384);
+    renameSync2(tmp, globalFile(h));
+  } catch (e) {
+    unlinkSync(tmp);
+    throw e;
+  }
+}
+
+// ../bus-daemon/src/config-issues.ts
+var shq = (s) => `'${s.replace(/'/g, "'\\''")}'`;
+function fixFor(file2, why) {
+  const q = shq(file2);
+  if (why === "is writable by everyone") return `run chmod o-w ${q}`;
+  if (why === "is writable by others") return `run chmod go-w ${q}`;
+  if (why === "is writable by a group others share")
+    return `run chmod g-w ${q}`;
+  if (why === "belongs to another user")
+    return `remove it (rm ${q}) or take it over (chown "$USER" ${q})`;
+  if (why === "is a symlink" || why === "is not a regular file")
+    return `remove it (rm ${q}), then save a regular file there`;
+  if (why.startsWith("cannot be read")) return `run chmod u+r ${q}`;
+  return `fix or remove ${q}`;
+}
+function configIssue(file2, own2, valid2 = true) {
+  if (own2.state === "unsafe")
+    return {
+      file: file2,
+      state: "refused",
+      reason: own2.why,
+      fix: fixFor(file2, own2.why)
+    };
+  if (own2.state === "ok" && !valid2)
+    return {
+      file: file2,
+      state: "refused",
+      reason: "is not a valid .oa-bus.json",
+      fix: `edit ${shq(file2)} to valid JSON, or remove it`
+    };
+  if (own2.state === "ok" && own2.note)
+    return {
+      file: file2,
+      state: "noted",
+      reason: own2.note,
+      fix: `optional: run chmod g-w ${shq(file2)}`
+    };
+  return void 0;
+}
+function isValidConfig(text3) {
+  try {
+    return BusConfigSchema.safeParse(JSON.parse(text3)).success;
+  } catch {
+    return false;
+  }
+}
+function inspectConfig(file2, uid, group) {
+  const own2 = readOwnFile(file2, uid, {
+    allowGroupWrite: true,
+    ...group ? { group } : {}
+  });
+  return configIssue(file2, own2, own2.state !== "ok" || isValidConfig(own2.text));
+}
+function inspectGlobal(file2 = globalFile()) {
+  const { error: error62 } = readGlobalDirs(file2);
+  if (error62 === void 0) return void 0;
+  return {
+    file: file2,
+    state: "refused",
+    reason: error62,
+    fix: error62 === "is not valid JSON" ? `remove it (rm ${shq(file2)}), then run oa-bus global add <dir> again` : fixFor(file2, error62)
+  };
+}
+var ConfigIssues = class {
+  #files = /* @__PURE__ */ new Map();
+  /** Records the result of reading `file` (undefined: it is fine now). */
+  set(file2, uid, issue2, group) {
+    if (issue2) this.#files.set(file2, { uid, group });
+    else this.#files.delete(file2);
+  }
+  /** Every tracked file, re-read now; `within` keeps only those at these paths. */
+  list(within) {
+    const out = [];
+    for (const [file2, { uid, group }] of [...this.#files]) {
+      if (within && !within.has(file2)) continue;
+      const issue2 = inspectConfig(file2, uid, group);
+      if (issue2) out.push(issue2);
+      else this.#files.delete(file2);
+    }
+    return out;
+  }
+};
+function scanConfigFiles(cwd, opts = {}) {
+  const uid = opts.uid ?? process.getuid?.();
+  const out = [];
+  let real2 = cwd;
+  try {
+    real2 = realpathSync4(cwd);
+  } catch {
+  }
+  for (const file2 of configPaths(real2)) {
+    const issue2 = inspectConfig(file2, uid, opts.group);
+    if (issue2) out.push(issue2);
+  }
+  const g = inspectGlobal(opts.globalFile);
+  if (g) out.push(g);
+  return out;
+}
+function configPaths(cwd) {
+  const out = [];
+  for (let dir = cwd; ; dir = dirname4(dir)) {
+    out.push(join8(dir, CONFIG_FILE));
+    if (dirname4(dir) === dir) return out;
+  }
+}
+
 // ../bus-daemon/src/deliver.ts
 init_src2();
 init_src();
@@ -39510,7 +39937,9 @@ var HubConnection = class {
         machine_label: this.opts.label,
         client_version: this.opts.version,
         // Reply ids: the hub then names each sender's agent (deliver.from_id).
-        caps: [BUS_CAPS.ids]
+        // Mailboxes: the hub then sends queued/since, away rows and the new
+        // refusals, and honours agent_up.replaces (#1295).
+        caps: [BUS_CAPS.ids, BUS_CAPS.mailbox]
       });
       this.#guard("sessions", () => {
         this.send({
@@ -39592,156 +40021,8 @@ function defaultBackoff(attempt) {
 // ../bus-daemon/src/namespace.ts
 init_src();
 import { execFileSync as execFileSync4 } from "node:child_process";
-import { realpathSync as realpathSync4 } from "node:fs";
-import { basename as basename4, dirname as dirname4, join as join8, resolve as resolve2 } from "node:path";
-
-// ../bus-daemon/src/global.ts
-import { randomBytes } from "node:crypto";
-import {
-  chmodSync as chmodSync3,
-  closeSync as closeSync3,
-  lstatSync as lstatSync4,
-  mkdirSync as mkdirSync4,
-  openSync as openSync3,
-  realpathSync as realpathSync3,
-  renameSync as renameSync2,
-  statSync as statSync6,
-  unlinkSync,
-  writeSync
-} from "node:fs";
-import { dirname as dirname3, isAbsolute as isAbsolute3, join as join7, sep } from "node:path";
-
-// ../bus-daemon/src/own-file.ts
-import {
-  closeSync as closeSync2,
-  constants,
-  fstatSync as fstatSync2,
-  openSync as openSync2,
-  readFileSync as readFileSync6
-} from "node:fs";
-function readOwnFile(file2, uid = process.getuid?.()) {
-  let fd;
-  try {
-    fd = openSync2(
-      file2,
-      constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0)
-    );
-  } catch (e) {
-    const code2 = e.code;
-    if (code2 === "ENOENT" || code2 === "ENOTDIR") return { state: "none" };
-    return {
-      state: "unsafe",
-      why: code2 === "ELOOP" ? "is a symlink" : `cannot be read (${code2})`
-    };
-  }
-  try {
-    const st = fstatSync2(fd);
-    if (!st.isFile()) return { state: "unsafe", why: "is not a regular file" };
-    if (uid !== void 0 && st.uid !== uid)
-      return { state: "unsafe", why: "belongs to another user" };
-    if (st.mode & 18)
-      return { state: "unsafe", why: "is writable by others" };
-    return { state: "ok", text: readFileSync6(fd, "utf8") };
-  } catch (e) {
-    return {
-      state: "unsafe",
-      why: `cannot be read (${e.code ?? String(e)})`
-    };
-  } finally {
-    closeSync2(fd);
-  }
-}
-
-// ../bus-daemon/src/global.ts
-var globalFile = (h = home()) => join7(h, "global.json");
-var canonicalPath = (path) => realpathSync3.native(path);
-function readGlobalDirs(file2 = globalFile()) {
-  const own2 = readOwnFile(file2);
-  if (own2.state === "none") return { dirs: [] };
-  if (own2.state === "unsafe") return { dirs: [], error: own2.why };
-  try {
-    const raw = JSON.parse(own2.text);
-    const dirs = raw?.dirs;
-    if (!Array.isArray(raw) && Array.isArray(dirs) && dirs.every((d) => typeof d === "string" && isAbsolute3(d)))
-      return { dirs };
-  } catch {
-  }
-  return { dirs: [], error: "is not valid JSON" };
-}
-var idOf = (path, follow = true) => {
-  try {
-    const st = follow ? statSync6(path) : lstatSync4(path);
-    return st.isDirectory() ? `${st.dev}:${st.ino}` : void 0;
-  } catch {
-    return void 0;
-  }
-};
-var loose = (p) => p.normalize("NFC").toLowerCase();
-function isGlobalDir(dir, dirs, onStale) {
-  let real2;
-  try {
-    real2 = realpathSync3(dir);
-  } catch {
-    return false;
-  }
-  const near = loose(real2);
-  const ids = /* @__PURE__ */ new Set();
-  for (const entry of dirs) {
-    const e = loose(entry);
-    const prefix = e.endsWith(sep) ? e : `${e}${sep}`;
-    if (near !== e && !near.startsWith(prefix)) continue;
-    let still;
-    try {
-      still = realpathSync3.native(entry);
-    } catch {
-    }
-    if (still !== entry) {
-      if (still !== void 0) onStale?.(entry);
-      continue;
-    }
-    const id = idOf(entry, false);
-    if (id !== void 0) ids.add(id);
-  }
-  if (ids.size === 0) return false;
-  for (let d = real2; ; d = dirname3(d)) {
-    const id = idOf(d);
-    if (id !== void 0 && ids.has(id)) return true;
-    if (dirname3(d) === d) return false;
-  }
-}
-function sameDir(entry, dir) {
-  try {
-    if (realpathSync3.native(entry) !== entry) return false;
-  } catch {
-    return false;
-  }
-  const id = idOf(entry, false);
-  return id !== void 0 && id === idOf(dir);
-}
-function writeGlobalDirs(dirs, h = home()) {
-  mkdirSync4(h, { recursive: true, mode: 448 });
-  chmodSync3(h, 448);
-  const tmp = join7(h, `.global.json.${randomBytes(8).toString("hex")}.tmp`);
-  const fd = openSync3(tmp, "wx", 384);
-  try {
-    writeSync(fd, `${JSON.stringify({ dirs }, null, 2)}
-`);
-  } catch (e) {
-    closeSync3(fd);
-    unlinkSync(tmp);
-    throw e;
-  }
-  closeSync3(fd);
-  try {
-    chmodSync3(tmp, 384);
-    renameSync2(tmp, globalFile(h));
-  } catch (e) {
-    unlinkSync(tmp);
-    throw e;
-  }
-}
-
-// ../bus-daemon/src/namespace.ts
+import { realpathSync as realpathSync5 } from "node:fs";
+import { basename as basename4, resolve as resolve2 } from "node:path";
 var warned = /* @__PURE__ */ new Set();
 var once = (deps, key2, msg) => {
   if (warned.has(key2)) return;
@@ -39752,7 +40033,7 @@ function resolveNamespace(start, deps = {}) {
   let cwd;
   let missing2 = false;
   try {
-    cwd = realpathSync4(start);
+    cwd = realpathSync5(start);
   } catch (e) {
     if (!deps.allowMissing) throw e;
     cwd = resolve2(start);
@@ -39811,12 +40092,16 @@ function readConfigs(cwd, deps) {
   const uid = deps.uid ?? process.getuid?.();
   const configs = [];
   const asked = [];
-  for (let dir = cwd; ; dir = dirname4(dir)) {
-    const file2 = join8(dir, CONFIG_FILE);
-    const own2 = readOwnFile(file2, uid);
+  for (const file2 of configPaths(cwd)) {
+    const own2 = readOwnFile(file2, uid, {
+      allowGroupWrite: true,
+      ...deps.group ? { group: deps.group } : {}
+    });
     if (own2.state === "unsafe")
       once(deps, file2, `ignoring ${file2}: it ${own2.why}`);
+    let valid2 = true;
     if (own2.state === "ok") {
+      if (own2.note) once(deps, `note:${file2}`, `using ${file2}: it ${own2.note}`);
       let parsed;
       try {
         parsed = BusConfigSchema.safeParse(JSON.parse(own2.text));
@@ -39825,15 +40110,18 @@ function readConfigs(cwd, deps) {
       if (parsed?.success) {
         configs.push(parsed.data);
         if (parsed.data.global === true) asked.push(file2);
-      } else deps.log?.(`ignoring invalid ${file2}`);
+      } else {
+        valid2 = false;
+        deps.log?.(`ignoring invalid ${file2}`);
+      }
     }
-    if (dirname4(dir) === dir) break;
+    deps.issues?.set(file2, uid, configIssue(file2, own2, valid2), deps.group);
   }
   return { cfg: mergeConfigs(configs), asked };
 }
 function nearestConfig(dir, deps = {}) {
   try {
-    return readConfigs(realpathSync4(dir), deps).cfg;
+    return readConfigs(realpathSync5(dir), deps).cfg;
   } catch {
     return {};
   }
@@ -40058,6 +40346,7 @@ var Resends = class {
 };
 
 // ../bus-daemon/src/routes.ts
+init_src2();
 init_src();
 
 // ../bus-daemon/src/status.ts
@@ -40278,6 +40567,27 @@ var statusOf = (row) => Object.fromEntries(
     (k) => row?.[k] === void 0 ? [] : [[k, row[k]]]
   )
 );
+var OLD_REASON = {
+  mailbox_full: "inbox_full",
+  reserved_name: "unknown_agent"
+};
+function forOldAdapter(f) {
+  if (f.type === "roster")
+    return {
+      ...f,
+      agents: f.agents.filter((a) => a.state !== "away").map(({ since: _since, ...a }) => a)
+    };
+  if (f.type === "receipt") {
+    const {
+      queued: _q,
+      since: _s,
+      ...r
+    } = f;
+    const reason = r.reason !== void 0 && r.reason in OLD_REASON ? OLD_REASON[r.reason] : r.reason;
+    return { ...r, ...reason === void 0 ? {} : { reason } };
+  }
+  return f;
+}
 function routeLocal(frame, hello, reply, ctx) {
   const agent = ctx.agents.byRef(hello.agent_ref);
   if (!agent)
@@ -40285,6 +40595,7 @@ function routeLocal(frame, hello, reply, ctx) {
   const ref = agent.ref;
   switch (frame.type) {
     case "self": {
+      const files = frame.row ? ctx.configFiles?.(agent.cwd) ?? [] : [];
       const self = {
         type: "agent",
         agent: {
@@ -40292,7 +40603,8 @@ function routeLocal(frame, hello, reply, ctx) {
           namespace: agent.namespace,
           kind: agent.kind,
           live: agent.live,
-          global: agent.global
+          global: agent.global,
+          ...files.length > 0 ? { config_files: files } : {}
         }
       };
       const own2 = frame.row ? ctx.ownRow?.(ref) : void 0;
@@ -40354,7 +40666,8 @@ function routeLocal(frame, hello, reply, ctx) {
           code: "bad_frame",
           message: "the frame is not valid on the hub wire"
         };
-      const id = ctx.pending.open(frame.id, reply);
+      const gated = hello.caps?.includes(ADAPTER_CAPS.mailbox) ? reply : (f) => reply(forOldAdapter(f));
+      const id = ctx.pending.open(frame.id, gated);
       if (ctx.hub.send(build(id))) return void 0;
       ctx.pending.cancel(id);
       return {
@@ -41809,7 +42122,9 @@ async function runDaemon(deps = {}) {
       kind: kind2,
       proposed_name: fitName(rec.proposedName, 64),
       namespace: rec.namespace,
-      global: rec.global
+      global: rec.global,
+      // A /clear: the new ref takes over the old address and its mail (#1295).
+      ...rec.replaces !== void 0 && hubMailbox ? { replaces: rec.replaces } : {}
     });
   };
   const markLimited = (ref, message) => {
@@ -41829,7 +42144,20 @@ async function runDaemon(deps = {}) {
     limited.delete(ref);
     caps.delete(ref);
   };
-  const resolveNs = (cwd, allowMissing) => (deps.resolveNamespace ?? ((dir) => resolveNamespace(dir, { log, allowMissing })))(cwd);
+  const configIssues = new ConfigIssues();
+  const configFiles = (cwd) => {
+    const g = inspectGlobal();
+    let within;
+    if (cwd !== void 0) {
+      try {
+        within = new Set(configPaths(realpathSync6(cwd)));
+      } catch {
+        within = new Set(configPaths(cwd));
+      }
+    }
+    return [...configIssues.list(within), ...g ? [g] : []];
+  };
+  const resolveNs = (cwd, allowMissing) => (deps.resolveNamespace ?? ((dir) => resolveNamespace(dir, { log, allowMissing, issues: configIssues })))(cwd);
   const cl = deps.claude ?? {};
   const listenPath = deps.socketPath ?? socketPath();
   const returnDir = cl.socketsDir ?? claudeReturnDir2();
@@ -42025,6 +42353,14 @@ async function runDaemon(deps = {}) {
       if (agent) void claude.notify(agent, replyGoneText(peerName));
     }
   });
+  const clearedFrom = (ref, pid, procStart, liveRefs) => agents.all().filter(
+    (a) => a.kind === "claude-code" && a.pid === pid && procStart !== void 0 && a.procStart === procStart && a.ref !== ref && !liveRefs.has(a.ref) && !takenOver.has(a.ref)
+  ).sort(
+    (a, b) => Number(b.live) - Number(a.live) || (seenAt.get(b.ref) ?? 0) - (seenAt.get(a.ref) ?? 0)
+  )[0];
+  const takenOver = /* @__PURE__ */ new Set();
+  const seenAt = /* @__PURE__ */ new Map();
+  let seenSeq = 0;
   const syncClaude = () => {
     const live = liveClaudeSessions(claudeSessions);
     const liveRefs = new Set(live.map((s) => s.ref));
@@ -42032,8 +42368,13 @@ async function runDaemon(deps = {}) {
     for (const s of live) {
       const prev = agents.byRef(s.ref);
       if (prev && prev.kind !== "claude-code") continue;
+      if (prev && prev.procStart === void 0 && prev.pid === s.pid)
+        prev.procStart = s.procStart;
       if (prev?.live) {
-        if (!livePid(s.ref, prev.pid)) prev.pid = s.pid;
+        if (!livePid(s.ref, prev.pid)) {
+          prev.pid = s.pid;
+          prev.procStart = s.procStart;
+        }
         continue;
       }
       if (prev && prev.pid === s.pid) continue;
@@ -42045,15 +42386,20 @@ async function runDaemon(deps = {}) {
         continue;
       }
       if (!WireNamespaceSchema.safeParse(ns.namespace).success) continue;
+      seenAt.set(s.ref, ++seenSeq);
+      const old = prev ? void 0 : clearedFrom(s.ref, s.pid, s.procStart, liveRefs);
+      if (old) takenOver.add(old.ref);
       announceUp(
         agents.up({
+          ...old ? { replaces: old.ref } : {},
           ref: s.ref,
           kind: "claude-code",
-          proposedName: s.name,
-          busName: prev?.busName ?? s.name,
+          proposedName: old?.busName ?? s.name,
+          busName: prev?.busName ?? old?.busName ?? s.name,
           namespace: ns.namespace,
           global: ns.global,
           pid: s.pid,
+          procStart: s.procStart,
           cwd: s.cwd,
           live: true
         })
@@ -42105,6 +42451,7 @@ async function runDaemon(deps = {}) {
   let hubEver = false;
   let hubDroppedAt;
   let hubIds = false;
+  let hubMailbox = false;
   let hubVersion;
   const hub = new HubConnection({
     url: `${cfg.hub.replace(/^http/, "ws").replace(/\/+$/, "")}${BUS_ROUTES.connect}`,
@@ -42123,7 +42470,10 @@ async function runDaemon(deps = {}) {
           upIds.delete(frame.id);
           clearLimited(frame.agent_ref);
           const agent = agents.byRef(frame.agent_ref);
-          if (agent) agent.busName = frame.bus_name;
+          if (agent) {
+            agent.busName = frame.bus_name;
+            delete agent.replaces;
+          }
           resends.up(frame.agent_ref);
           return;
         }
@@ -42190,6 +42540,7 @@ async function runDaemon(deps = {}) {
         case "hello_ok":
           hubVersion = frame.server_version;
           hubIds = frame.caps?.includes(BUS_CAPS.ids) ?? false;
+          hubMailbox = frame.caps?.includes(BUS_CAPS.mailbox) ?? false;
           outbox.flush();
           return;
       }
@@ -42235,6 +42586,7 @@ async function runDaemon(deps = {}) {
       upIds.clear();
       hubVersion = void 0;
       hubIds = false;
+      hubMailbox = false;
       statusRelay.dropped();
       receipts.release();
       resends.dropped();
@@ -42315,11 +42667,11 @@ async function runDaemon(deps = {}) {
           const local = live.filter((a) => a.namespace === namespace);
           const mine = new Map(local.map((a) => [a.busName, a.kind]));
           const roster2 = local[0] && hub.open ? await hubRoster(local[0].ref) : void 0;
-          const rows = roster2 ? roster2.map((a) => ({
+          const rows = roster2 ? roster2.filter((a) => a.state !== "away").map((a) => ({
             name: a.name,
             kind: a.kind,
             machine: a.machine_label ?? (mine.get(a.name) === a.kind ? cfg.label : ""),
-            state: a.state ?? "live",
+            state: a.state === "away" ? "queued" : a.state ?? "live",
             ...a.status === void 0 ? {} : { status: a.status },
             ...a.status_label === void 0 ? {} : { status_label: a.status_label },
             ...a.status_at === void 0 ? {} : { status_at: a.status_at }
@@ -42332,10 +42684,12 @@ async function runDaemon(deps = {}) {
           return { namespace, agents: rows };
         })
       );
+      const config_files = configFiles();
       return {
         pid: process.pid,
         version: version2,
         label: cfg.label,
+        ...config_files.length > 0 ? { config_files } : {},
         hub: hub.open ? "connected" : "connecting",
         ...hub.open || !hub.lastError ? {} : { hub_error: hub.lastError },
         hub_ever: hubEver,
@@ -42418,14 +42772,28 @@ async function runDaemon(deps = {}) {
           };
         attested(pid);
         const proposedName = hello.proposed_name ?? hello.agent_ref;
+        const files = hello.kind === "claude-code" ? liveClaudeSessions(claudeSessions) : [];
+        const mine = files.find(
+          (x) => x.ref === hello.agent_ref && x.pid === pid
+        );
+        const old = mine && !prev ? clearedFrom(
+          hello.agent_ref,
+          pid,
+          mine.procStart,
+          new Set(files.map((x) => x.ref))
+        ) : void 0;
+        seenAt.set(hello.agent_ref, ++seenSeq);
+        if (old) takenOver.add(old.ref);
         const rec = agents.up({
+          ...old ? { replaces: old.ref } : {},
           ref: hello.agent_ref,
           kind: hello.kind,
-          proposedName,
-          busName: prev?.busName ?? proposedName,
+          proposedName: old?.busName ?? proposedName,
+          busName: prev?.busName ?? old?.busName ?? proposedName,
           namespace: ns.namespace,
           global: ns.global,
           pid,
+          ...mine ? { procStart: mine.procStart } : {},
           cwd,
           live: true
         });
@@ -42462,6 +42830,7 @@ async function runDaemon(deps = {}) {
         pending,
         limited: (ref) => limited.has(ref) ? caps.get(ref) ?? "machine" : void 0,
         version: version2,
+        configFiles,
         // The self tool's status: the agent's own row on its roster.
         ownRow: (ref) => {
           const me = agents.byRef(ref);
@@ -42605,7 +42974,7 @@ async function runDaemon(deps = {}) {
 init_src3();
 import { execFileSync as execFileSync5, spawn as spawn2 } from "node:child_process";
 import { closeSync as closeSync4, openSync as openSync4, readFileSync as readFileSync13 } from "node:fs";
-import { homedir as homedir3, userInfo } from "node:os";
+import { homedir as homedir3, userInfo as userInfo2 } from "node:os";
 init_src2();
 
 // src/copy.ts
@@ -43116,6 +43485,14 @@ function copy(style) {
       next(p("muted", clip(`It ${why}.`, 3))),
       next(`Remove it, then run ${BUS_CMD} global add <dir> again.`)
     ],
+    /** A refused or noted config file (#1527): the reason, then the exact fix. Paths arrive already shortened. */
+    configFile: (f) => [
+      warn(
+        f.state === "refused" ? `${f.file} ${f.reason}, so it is ignored.` : `${f.file} ${f.reason}; it is still used.`
+      ),
+      next(`Fix: ${f.fix}`),
+      ...f.restart ? [next("Restart the session to pick up a fix.")] : []
+    ],
     globalAsked: () => [
       warn("This repo's .oa-bus.json asks for global, which is ignored here."),
       next(`Allow it with ${BUS_CMD} global add .`)
@@ -43321,7 +43698,7 @@ import {
   existsSync as existsSync3,
   lstatSync as lstatSync8,
   mkdirSync as mkdirSync7,
-  realpathSync as realpathSync5,
+  realpathSync as realpathSync7,
   renameSync as renameSync7,
   rmSync as rmSync4,
   writeFileSync as writeFileSync6
@@ -44535,7 +44912,7 @@ function writeReplacing(path, text3) {
 var real = (path) => {
   const abs = resolve4(path);
   try {
-    return realpathSync5(abs);
+    return realpathSync7(abs);
   } catch {
     const parent = dirname7(abs);
     return parent === abs ? abs : join13(real(parent), basename6(abs));
@@ -44768,7 +45145,7 @@ var noService = {
   remove: async () => ({}),
   cli: () => ["oa-bus"]
 };
-var VERSION = true ? "0.124.0" : JSON.parse(
+var VERSION = true ? "0.125.0" : JSON.parse(
   readFileSync13(new URL("../package.json", import.meta.url), "utf8")
 ).version;
 var which = (cmd) => {
@@ -44814,7 +45191,7 @@ var spawnDaemon = (cmd, args, opts) => {
 };
 var userName = () => {
   try {
-    return userInfo().username;
+    return userInfo2().username;
   } catch {
     return "";
   }
@@ -44909,6 +45286,17 @@ var sayErr = (ctx, ...lines) => {
 };
 var tildeReason = (ctx, harness, reason) => harness === "codex" && reason.startsWith(`${ctx.userHome}/`) ? `~${reason.slice(ctx.userHome.length)}` : reason;
 var tilde = (ctx, path) => path === ctx.userHome ? "~" : path.startsWith(`${ctx.userHome}/`) ? `~${path.slice(ctx.userHome.length)}` : path;
+var plain2 = (text3) => stripTerminalControls(text3).replace(/[\r\n\t]/g, " ");
+var configFileLines = (ctx, files) => files.flatMap(
+  (f) => ctx.copy.configFile({
+    state: f.state,
+    reason: plain2(f.reason),
+    file: plain2(tilde(ctx, f.file)),
+    fix: plain2(f.fix),
+    // The namespace is resolved when a session starts.
+    restart: f.file.endsWith("/.oa-bus.json")
+  })
+);
 
 // src/machine.ts
 import { readFileSync as readFileSync14, statSync as statSync8 } from "node:fs";
@@ -47399,6 +47787,7 @@ async function status(ctx) {
     async () => (await health).version
   );
   if (update) say(ctx, c.updateAvailable(update, st.version));
+  if (st.config_files?.length) say(ctx, configFileLines(ctx, st.config_files));
   if (st.hub !== "connected") {
     sayErr(ctx, c.hubNotReachable(host, st.hub_error, "status"));
     return 1;
@@ -47590,19 +47979,26 @@ async function doctor(ctx) {
   const allow = globalFile(ctx.home);
   const list = readGlobalDirs(allow);
   if (list.error) warn(c.globalUnusable(tilde(ctx, allow), list.error));
+  const files = scanConfigFiles(ctx.cwd, { globalFile: allow }).filter(
+    (f) => f.file !== allow
+  );
+  if (files.length > 0) {
+    n.warnings += files.length;
+    say(ctx, configFileLines(ctx, files));
+  }
   if (asksForGlobal(ctx, list.dirs)) warn(c.globalAsked());
   say(ctx, "", c.summary(n.failed, n.warnings, n.passed));
   return n.failed > 0 ? 1 : 0;
 }
 
 // src/commands/global.ts
-import { realpathSync as realpathSync6, statSync as statSync10 } from "node:fs";
+import { realpathSync as realpathSync8, statSync as statSync10 } from "node:fs";
 import { resolve as resolve6 } from "node:path";
 function shown(ctx, path) {
   const t = tilde(ctx, path);
   if (t !== path) return t;
   try {
-    return tilde({ userHome: realpathSync6(ctx.userHome) }, path);
+    return tilde({ userHome: realpathSync8(ctx.userHome) }, path);
   } catch {
     return path;
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@open-artifacts/bus",
   "type": "module",
-  "version": "0.124.0",
+  "version": "0.125.0",
   "description": "The Open Artifacts bus: your AI agents reach each other across machines.",
   "license": "MIT",
   "repository": {