@rubytech/create-realagent-code 0.1.575 → 0.1.576

package/payload/server/server.js

@@ -4259,9 +4259,9 @@ var require_dist5 = __commonJS({
           try {
             await onEmpty(c);
           } catch (err) {
-            const id82 = c.elementId.slice(0, 8);
+            const id83 = c.elementId.slice(0, 8);
             const message = err instanceof Error ? err.message : String(err);
-            process.stderr.write(`[trash:empty-run] reason=onEmpty-failed elementId=${id82} labels=${c.labels.join(",")} message=${message}
+            process.stderr.write(`[trash:empty-run] reason=onEmpty-failed elementId=${id83} labels=${c.labels.join(",")} message=${message}
 `);
             continue;
           }
@@ -21386,7 +21386,7 @@ init_neo4j_store();
 async function purgeAdminConversationJsonls(args) {
   const fetchImpl = args.fetchImpl ?? fetch;
   const log2 = args.logger ?? ((line) => console.log(line));
-  const id82 = args.sessionId.slice(0, 8);
+  const id83 = args.sessionId.slice(0, 8);
   const purged = [];
   for (const sessionId of args.claudeSessionIds) {
     const url = `${args.managerBase}/${encodeURIComponent(sessionId)}`;
@@ -21396,7 +21396,7 @@ async function purgeAdminConversationJsonls(args) {
     } catch (err) {
       const message2 = err instanceof Error ? err.message : String(err);
       log2(
-        `[admin-conversation-delete] sessionId=${id82} reason=jsonl-purge-failed claudeSessionId=${sessionId.slice(0, 8)} message=${message2}`
+        `[admin-conversation-delete] sessionId=${id83} reason=jsonl-purge-failed claudeSessionId=${sessionId.slice(0, 8)} message=${message2}`
       );
       return {
         ok: false,
@@ -21413,7 +21413,7 @@ async function purgeAdminConversationJsonls(args) {
     }
     if (res.status === 409) {
       log2(
-        `[admin-conversation-delete] sessionId=${id82} reason=pty-still-alive claudeSessionId=${sessionId.slice(0, 8)}`
+        `[admin-conversation-delete] sessionId=${id83} reason=pty-still-alive claudeSessionId=${sessionId.slice(0, 8)}`
       );
       return {
         ok: false,
@@ -21430,7 +21430,7 @@ async function purgeAdminConversationJsonls(args) {
     } catch {
     }
     log2(
-      `[admin-conversation-delete] sessionId=${id82} reason=jsonl-purge-failed claudeSessionId=${sessionId.slice(0, 8)} message=${message}`
+      `[admin-conversation-delete] sessionId=${id83} reason=jsonl-purge-failed claudeSessionId=${sessionId.slice(0, 8)} message=${message}`
     );
     return {
       ok: false,
@@ -21449,13 +21449,13 @@ async function cascadeAdminConversationDelete(args) {
   const started2 = Date.now();
   const fetchImpl = args.fetchImpl ?? fetch;
   const log2 = args.logger ?? ((line) => console.log(line));
-  const id82 = args.sessionId.slice(0, 8);
+  const id83 = args.sessionId.slice(0, 8);
   let claudeSessionIds;
   try {
     claudeSessionIds = args.claudeSessionIds ?? await getConversationClaudeSessionIds(args.sessionId, args.accountId);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    log2(`[admin-conversation-delete] sessionId=${id82} reason=graph-delete-failed claudeSessionIds-purged= message=transcript-resolve:${message}`);
+    log2(`[admin-conversation-delete] sessionId=${id83} reason=graph-delete-failed claudeSessionIds-purged= message=transcript-resolve:${message}`);
     return { ok: false, reason: "graph-delete-failed", claudeSessionIdsPurged: [], message };
   }
   const purgeOutcome = await purgeAdminConversationJsonls({
@@ -21486,7 +21486,7 @@ async function cascadeAdminConversationDelete(args) {
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     const csv3 = purged.map((s) => s.slice(0, 8)).join(",");
-    log2(`[admin-conversation-delete] sessionId=${id82} reason=graph-delete-failed claudeSessionIds-purged=${csv3} message=${message}`);
+    log2(`[admin-conversation-delete] sessionId=${id83} reason=graph-delete-failed claudeSessionIds-purged=${csv3} message=${message}`);
     return {
       ok: false,
       reason: "graph-delete-failed",
@@ -21499,7 +21499,7 @@ async function cascadeAdminConversationDelete(args) {
   }
   const ms = Date.now() - started2;
   const csv2 = purged.map((s) => s.slice(0, 8)).join(",");
-  log2(`[admin-conversation-delete] sessionId=${id82} claudeSessionIds=${csv2} ms=${ms}`);
+  log2(`[admin-conversation-delete] sessionId=${id83} claudeSessionIds=${csv2} ms=${ms}`);
   return { ok: true, claudeSessionIds: purged, ms };
 }
 
@@ -29716,21 +29716,21 @@ app52.get("/booking-link", requireAdminSession, (c) => {
     console.error("[calendar] op=booking-link auth-rejected reason=no-account-for-session accountId=none");
     return c.json({ error: "no account for session", reason: "no-account-for-session" }, 401);
   }
-  const id82 = account.accountId.slice(0, 8);
+  const id83 = account.accountId.slice(0, 8);
   try {
     if (!existsSync41(join50(account.accountDir, AVAILABILITY_FILENAME))) {
-      console.log(`[calendar] op=booking-link accountId=${id82} bookingDomain=none source=availability-config`);
+      console.log(`[calendar] op=booking-link accountId=${id83} bookingDomain=none source=availability-config`);
       return c.json({ bookingDomain: null });
     }
     const config = readAvailabilityConfig(account.accountDir);
     const bookingDomain = typeof config.bookingDomain === "string" && config.bookingDomain.trim() ? config.bookingDomain.trim() : null;
     console.log(
-      `[calendar] op=booking-link accountId=${id82} bookingDomain=${bookingDomain ?? "none"} source=availability-config`
+      `[calendar] op=booking-link accountId=${id83} bookingDomain=${bookingDomain ?? "none"} source=availability-config`
     );
     return c.json({ bookingDomain });
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(`[calendar] op=booking-link-fail accountId=${id82} err="${message}"`);
+    console.error(`[calendar] op=booking-link-fail accountId=${id83} err="${message}"`);
     return c.json({ bookingDomain: null });
   }
 });
@@ -29750,20 +29750,20 @@ app53.get("/portal-link", requireAdminSession, (c) => {
     console.error("[data-portal] op=portal-link auth-rejected reason=no-account-for-session accountId=none");
     return c.json({ error: "no account for session", reason: "no-account-for-session" }, 401);
   }
-  const id82 = account.accountId.slice(0, 8);
+  const id83 = account.accountId.slice(0, 8);
   try {
     const path = join51(account.accountDir, PORTAL_FILENAME);
     if (!existsSync42(path)) {
-      console.log(`[data-portal] op=portal-link accountId=${id82} portalDomain=none source=data-portal-config`);
+      console.log(`[data-portal] op=portal-link accountId=${id83} portalDomain=none source=data-portal-config`);
       return c.json({ portalDomain: null });
     }
     const cfg = JSON.parse(readFileSync42(path, "utf-8"));
     const portalDomain = typeof cfg.portalDomain === "string" && cfg.portalDomain.trim() ? cfg.portalDomain.trim() : null;
-    console.log(`[data-portal] op=portal-link accountId=${id82} portalDomain=${portalDomain ?? "none"} source=data-portal-config`);
+    console.log(`[data-portal] op=portal-link accountId=${id83} portalDomain=${portalDomain ?? "none"} source=data-portal-config`);
     return c.json({ portalDomain });
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(`[data-portal] op=portal-link-fail accountId=${id82} err="${message}"`);
+    console.error(`[data-portal] op=portal-link-fail accountId=${id83} err="${message}"`);
     return c.json({ portalDomain: null });
   }
 });
@@ -29785,13 +29785,13 @@ app54.get("/planner-link", requireAdminSession, (c) => {
     );
     return c.json({ error: "no account for session", reason: "no-account-for-session" }, 401);
   }
-  const id82 = account.accountId.slice(0, 8);
+  const id83 = account.accountId.slice(0, 8);
   try {
     const portalPath = join52(account.accountDir, PORTAL_FILENAME2);
     const dispatchConfigured = existsSync43(join52(account.accountDir, "dispatch", "config.json"));
     if (!existsSync43(portalPath) || !dispatchConfigured) {
       console.log(
-        `[dispatch-planner] op=planner-link accountId=${id82} plannerUrl=none portal=${existsSync43(portalPath)} dispatch=${dispatchConfigured}`
+        `[dispatch-planner] op=planner-link accountId=${id83} plannerUrl=none portal=${existsSync43(portalPath)} dispatch=${dispatchConfigured}`
       );
       return c.json({ plannerUrl: null });
     }
@@ -29799,12 +29799,12 @@ app54.get("/planner-link", requireAdminSession, (c) => {
     const domain = typeof cfg.portalDomain === "string" && cfg.portalDomain.trim() ? cfg.portalDomain.trim() : null;
     const plannerUrl = domain ? `https://${domain}/planner` : null;
     console.log(
-      `[dispatch-planner] op=planner-link accountId=${id82} plannerUrl=${plannerUrl ?? "none"}`
+      `[dispatch-planner] op=planner-link accountId=${id83} plannerUrl=${plannerUrl ?? "none"}`
     );
     return c.json({ plannerUrl });
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(`[dispatch-planner] op=planner-link-fail accountId=${id82} err="${message}"`);
+    console.error(`[dispatch-planner] op=planner-link-fail accountId=${id83} err="${message}"`);
     return c.json({ plannerUrl: null });
   }
 });
@@ -30385,7 +30385,7 @@ app55.patch("/:eventId", requireAdminSession, async (c) => {
   if (!accountId) return c.json({ error: "Account not found for session" }, 401);
   const eventId = c.req.param("eventId");
   const body = await c.req.json().catch(() => ({}));
-  const id82 = eventId.slice(0, 8);
+  const id83 = eventId.slice(0, 8);
   const setClauses = [];
   const params = { eventId, accountId };
   const fields = [];
@@ -30397,11 +30397,11 @@ app55.patch("/:eventId", requireAdminSession, async (c) => {
   const clearing = bindingTouched && body.agentChannel === null && body.agentDestination === null;
   const binding = bindingTouched && typeof body.agentChannel === "string" && body.agentChannel.length > 0 && typeof body.agentDestination === "string" && body.agentDestination.length > 0;
   if (bindingTouched && !clearing && !binding) {
-    console.error(`[admin:routines] op=patch id=${id82} fields=agentChannel+agentDestination outcome=rejected reason=partial-binding`);
+    console.error(`[admin:routines] op=patch id=${id83} fields=agentChannel+agentDestination outcome=rejected reason=partial-binding`);
     return c.json({ error: "A dispatch binding needs both a channel and a destination, or both cleared." }, 400);
   }
   if (binding && !DISPATCH_CHANNELS2.has(body.agentChannel)) {
-    console.error(`[admin:routines] op=patch id=${id82} fields=agentChannel+agentDestination outcome=rejected reason=invalid-channel channel=${body.agentChannel}`);
+    console.error(`[admin:routines] op=patch id=${id83} fields=agentChannel+agentDestination outcome=rejected reason=invalid-channel channel=${body.agentChannel}`);
     return c.json({ error: `Unknown dispatch channel "${body.agentChannel}".` }, 400);
   }
   const describing = "description" in body;
@@ -30430,7 +30430,7 @@ app55.patch("/:eventId", requireAdminSession, async (c) => {
       storedDescription = pre.records[0]?.get("description") ?? null;
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
-      console.error(`[admin:routines] op=patch id=${id82} outcome=rejected reason=tz-read-fail err="${message}"`);
+      console.error(`[admin:routines] op=patch id=${id83} outcome=rejected reason=tz-read-fail err="${message}"`);
       return c.json({ error: `Routine unavailable: ${message}` }, 503);
     } finally {
       await preSession.close();
@@ -30438,7 +30438,7 @@ app55.patch("/:eventId", requireAdminSession, async (c) => {
   }
   if (binding) {
     if (storedActionPlugin !== null) {
-      console.error(`[admin:routines] op=patch id=${id82} fields=agentChannel+agentDestination outcome=rejected reason=action-routine`);
+      console.error(`[admin:routines] op=patch id=${id83} fields=agentChannel+agentDestination outcome=rejected reason=action-routine`);
       return c.json(
         { error: "This routine runs a tool. Binding a dispatch would stop the tool running, so it is refused; make a separate routine for the dispatch." },
         400
@@ -30446,7 +30446,7 @@ app55.patch("/:eventId", requireAdminSession, async (c) => {
     }
     const effectivePrompt = typeof body.agentPrompt === "string" ? body.agentPrompt : storedPrompt ?? "";
     if (effectivePrompt.trim().length === 0) {
-      console.error(`[admin:routines] op=patch id=${id82} fields=agentChannel+agentDestination outcome=rejected reason=no-prompt`);
+      console.error(`[admin:routines] op=patch id=${id83} fields=agentChannel+agentDestination outcome=rejected reason=no-prompt`);
       return c.json({ error: "A bound routine needs an instruction, or it will fire and do nothing." }, 400);
     }
     const channel = body.agentChannel;
@@ -30456,12 +30456,12 @@ app55.patch("/:eventId", requireAdminSession, async (c) => {
       houseAccountId = channel === "whatsapp" ? resolveHouseOrSoleAccountId(ACCOUNTS_DIR) : accountId;
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
-      console.error(`[admin:routines] op=patch id=${id82} fields=agentChannel+agentDestination outcome=rejected reason=house-unresolved err="${message}"`);
+      console.error(`[admin:routines] op=patch id=${id83} fields=agentChannel+agentDestination outcome=rejected reason=house-unresolved err="${message}"`);
       return c.json({ error: `WhatsApp destinations cannot be validated on this install: ${message}` }, 503);
     }
     const check = validateAgentDestination(ACCOUNTS_DIR, houseAccountId, accountId, channel, destination);
     if (!check.valid) {
-      console.error(`[admin:routines] op=patch id=${id82} fields=agentChannel+agentDestination outcome=rejected reason=${check.reason}`);
+      console.error(`[admin:routines] op=patch id=${id83} fields=agentChannel+agentDestination outcome=rejected reason=${check.reason}`);
       return c.json(
         {
           error: check.reason === "cross-account" ? `That destination belongs to a different account on ${channel}.` : `That destination is not a registered admin or account manager on ${channel}.`
@@ -30478,7 +30478,7 @@ app55.patch("/:eventId", requireAdminSession, async (c) => {
   if (clearing) {
     const keepsRow = typeof body.recurrence === "string" || storedRecurrence !== null || storedActionPlugin !== null;
     if (!keepsRow) {
-      console.error(`[admin:routines] op=patch id=${id82} fields=agentChannel+agentDestination outcome=rejected reason=clear-would-orphan`);
+      console.error(`[admin:routines] op=patch id=${id83} fields=agentChannel+agentDestination outcome=rejected reason=clear-would-orphan`);
       return c.json(
         { error: "Clearing the dispatch on a one-time routine would leave nothing to show. Give it a schedule first, or delete it." },
         400
@@ -30498,12 +30498,12 @@ app55.patch("/:eventId", requireAdminSession, async (c) => {
   let nextName = null;
   if (naming) {
     if (typeof body.name !== "string" || body.name.trim().length === 0) {
-      console.error(`[admin:routines] op=patch id=${id82} fields=name outcome=rejected reason=empty-name`);
+      console.error(`[admin:routines] op=patch id=${id83} fields=name outcome=rejected reason=empty-name`);
       return c.json({ error: "A routine needs a name." }, 400);
     }
     nextName = body.name.trim();
     if (nextName.length > 200) {
-      console.error(`[admin:routines] op=patch id=${id82} fields=name outcome=rejected reason=too-long len=${nextName.length}`);
+      console.error(`[admin:routines] op=patch id=${id83} fields=name outcome=rejected reason=too-long len=${nextName.length}`);
       return c.json({ error: "A routine name is at most 200 characters." }, 400);
     }
     setClauses.push("e.name = $name");
@@ -30516,7 +30516,7 @@ app55.patch("/:eventId", requireAdminSession, async (c) => {
   if (describing) {
     const raw = body.description;
     if (typeof raw !== "string" && raw !== null) {
-      console.error(`[admin:routines] op=patch id=${id82} fields=description outcome=rejected reason=not-a-string`);
+      console.error(`[admin:routines] op=patch id=${id83} fields=description outcome=rejected reason=not-a-string`);
       return c.json({ error: "A description must be text, or null to clear it." }, 400);
     }
     nextDescription = typeof raw === "string" && raw.trim().length > 0 ? raw : null;
@@ -30537,7 +30537,7 @@ app55.patch("/:eventId", requireAdminSession, async (c) => {
       params.embedding = embedding;
     } else {
       embedLog = " embed=failed";
-      console.error(`[admin:routines] op=patch id=${id82} fields=${fields.join("+")} embed=failed`);
+      console.error(`[admin:routines] op=patch id=${id83} fields=${fields.join("+")} embed=failed`);
     }
   }
   if (typeof body.recurrence === "string") {
@@ -30551,7 +30551,7 @@ app55.patch("/:eventId", requireAdminSession, async (c) => {
       nextRunLog = nextRun;
     } catch (err) {
       const reason = err instanceof Error ? err.message : String(err);
-      console.error(`[admin:routines] op=patch id=${id82} outcome=rejected reason=invalid-cron cron=${body.recurrence}`);
+      console.error(`[admin:routines] op=patch id=${id83} outcome=rejected reason=invalid-cron cron=${body.recurrence}`);
       return c.json({ error: `Invalid recurrence: ${reason}` }, 400);
     }
   }
@@ -30569,15 +30569,15 @@ app55.patch("/:eventId", requireAdminSession, async (c) => {
       params
     );
     if (res.records.length === 0) {
-      console.error(`[admin:routines] op=patch id=${id82} outcome=rejected reason=not-found`);
+      console.error(`[admin:routines] op=patch id=${id83} outcome=rejected reason=not-found`);
       return c.json({ error: "Routine not found" }, 404);
     }
     const nameLog = nextName === null ? "" : ` name=len:${nextName.length} operatorEdited=stamped`;
-    console.log(`[admin:routines] op=patch id=${id82} fields=${fields.join("+")} outcome=ok nextRun=${nextRunLog} cron=${params.recurrence ?? "unchanged"}${bindingLog}${nameLog}${embedLog}`);
+    console.log(`[admin:routines] op=patch id=${id83} fields=${fields.join("+")} outcome=ok nextRun=${nextRunLog} cron=${params.recurrence ?? "unchanged"}${bindingLog}${nameLog}${embedLog}`);
     return c.json({ routine: mapRoutine(res.records[0]) });
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(`[admin:routines] op=patch id=${id82} outcome=rejected reason=${message}`);
+    console.error(`[admin:routines] op=patch id=${id83} outcome=rejected reason=${message}`);
     return c.json({ error: `Update failed: ${message}` }, 503);
   } finally {
     await session.close();
@@ -34975,8 +34975,18 @@ async function migrateSidecarAccountIds(opts = {}) {
 init_src2();
 
 // app/lib/whatsapp/gateway/inbound-hub.ts
+var HUB_SEPARATOR = "\0";
 function hubKey(accountId, senderId) {
-  return `${accountId}\0${senderId}`;
+  return `${accountId}${HUB_SEPARATOR}${senderId}`;
+}
+function decodeHubKeys(keys) {
+  const out = [];
+  for (const key2 of keys) {
+    const i = key2.indexOf(HUB_SEPARATOR);
+    if (i < 0) continue;
+    out.push({ accountId: key2.slice(0, i), senderId: key2.slice(i + HUB_SEPARATOR.length) });
+  }
+  return out;
 }
 var InboundHub = class {
   senders = /* @__PURE__ */ new Map();
@@ -35968,6 +35978,14 @@ var WaGateway = class {
   liveReplyTarget(accountId, senderId) {
     return this.replies.get(hubKey(accountId, normalizeTarget(senderId) ?? senderId)) ?? null;
   }
+  /** Task 2557 — every (account, sender) this gateway currently holds a live
+   *  delivery closure for. The follower census reconciles against exactly this
+   *  set, so "should have a reader" and "can be sent to" are one fact and
+   *  cannot drift. Deriving the set from the follower registry instead would
+   *  ask the map that already lost the entry. */
+  boundTargets() {
+    return decodeHubKeys(this.replies.keys());
+  }
   async sendOutbound(accountId, senderId, text) {
     this.outboundSends++;
     const reply = this.replies.get(hubKey(accountId, senderId));
@@ -37188,7 +37206,10 @@ function startEmitter(opts) {
   const abort2 = new AbortController();
   const { entry: entry2, tag } = opts;
   const answers = new AnswerAccumulator();
+  let answersEmitted = 0;
+  let closeReason = "stream-end";
   const emitAnswer = async (answer) => {
+    answersEmitted += 1;
     if (answer.text.trim()) await fanOut2(entry2.subscribers, answer.text, opts.onError, tag);
     if (!opts.onAnswer) return;
     const guarded = { ...answer, text: guardOutbound(entry2.senderId, answer.text) };
@@ -37361,9 +37382,14 @@ function startEmitter(opts) {
       for (const answer of answers.flush()) await emitAnswer(answer);
     } catch (err) {
       if (!abort2.signal.aborted) {
+        closeReason = "error";
         opts.onError?.(`emitter-error: ${err instanceof Error ? err.message : String(err)}`);
       }
     } finally {
+      if (abort2.signal.aborted) closeReason = "aborted";
+      console.error(
+        `${tag} op=follower-closed sessionId=${entry2.sessionId.slice(0, 8)} reason=${closeReason} answers=${answersEmitted}`
+      );
       opts.onClose();
     }
   })();
@@ -37564,6 +37590,12 @@ function startWebchatNativeFileFollower(input) {
   return startEmitter({
     entry: entry2,
     tag: "[webchat-adaptor]",
+    // Task 2557 — the emitter has always had this channel and no follower ever
+    // passed one, so every cause it reported was discarded. The close line
+    // carries the outcome; this carries the cause.
+    onError: (reason) => {
+      console.error(`[webchat-adaptor] op=follower-error sessionId=${input.sessionId.slice(0, 8)} reason=${reason}`);
+    },
     fileDelivery: makeWebchatFileDelivery(entry2),
     // A resumed session's JSONL already holds prior SendUserFile tool_uses;
     // suppress replay so historical calls are not re-reconciled on attach.
@@ -37728,6 +37760,14 @@ function startNativeFileFollower(input) {
   return startEmitter({
     entry: entry2,
     tag: "[whatsapp-adaptor]",
+    // Task 2557 — the emitter has always had this channel and no follower ever
+    // passed one, so every cause it reported (`follow-status-404`,
+    // `emitter-error: …`, `subscriber-error: …`) was discarded. The close line
+    // carries the outcome; this carries the cause, and it can fire without the
+    // stream ending, so neither substitutes for the other.
+    onError: (reason) => {
+      console.error(`[whatsapp-adaptor] op=follower-error sessionId=${input.sessionId.slice(0, 8)} reason=${reason}`);
+    },
     // Task 2521 — admin-only. A public spawn has no tools (Task 2078), so a
     // handler here would reconcile a call that can never fire.
     fileDelivery: input.role === "admin" ? makeWhatsAppFileDelivery(entry2, input.maxyAccountId) : null,
@@ -37752,6 +37792,69 @@ function startNativeFileFollower(input) {
   });
 }
 
+// app/lib/channel-delivery/follower-registry.ts
+function createFollowerRegistry(start) {
+  const controllers = /* @__PURE__ */ new Map();
+  const params = /* @__PURE__ */ new Map();
+  return {
+    attach(p) {
+      controllers.get(p.senderId)?.abort();
+      params.set(p.senderId, p);
+      let ac;
+      ac = start(p, () => {
+        if (controllers.get(p.senderId) === ac) controllers.delete(p.senderId);
+      });
+      controllers.set(p.senderId, ac);
+    },
+    live: () => [...controllers.keys()],
+    paramsFor: (senderId) => params.get(senderId) ?? null
+  };
+}
+
+// app/lib/channel-delivery/follower-census.ts
+var CENSUS_MAX_REATTEMPTS = 3;
+function makeCensusState() {
+  return { attempts: /* @__PURE__ */ new Map() };
+}
+var id82 = (s) => s.slice(0, 8);
+function followerCensusTick(deps, state = makeCensusState()) {
+  const bound = deps.bound();
+  const live = new Set(deps.live());
+  for (const senderId of live) state.attempts.delete(senderId);
+  const missing = bound.filter((b) => !live.has(b.senderId));
+  console.error(
+    `[channel-follower] op=follower-census bound=${bound.length} attached=${live.size} missing=${missing.length} missingSenders=${missing.map((m) => id82(m.senderId)).join(",") || "none"}`
+  );
+  for (const m of missing) {
+    const used = state.attempts.get(m.senderId) ?? 0;
+    if (used >= CENSUS_MAX_REATTEMPTS) {
+      console.error(
+        `[channel-follower] op=follower-reattach sessionId=${id82(deps.paramsFor(m.senderId)?.sessionId ?? "none")} senderId=${id82(m.senderId)} outcome=skipped reason=reattach-exhausted attempts=${used}`
+      );
+      continue;
+    }
+    const p = deps.paramsFor(m.senderId);
+    if (!p) {
+      console.error(
+        `[channel-follower] op=follower-reattach sessionId=none senderId=${id82(m.senderId)} outcome=failed reason=no-attach-params`
+      );
+      continue;
+    }
+    try {
+      state.attempts.set(m.senderId, used + 1);
+      deps.attach(p);
+      console.error(
+        `[channel-follower] op=follower-reattach sessionId=${id82(p.sessionId)} senderId=${id82(p.senderId)} outcome=attached reason=none`
+      );
+    } catch (err) {
+      console.error(
+        `[channel-follower] op=follower-reattach sessionId=${id82(p.sessionId)} senderId=${id82(p.senderId)} outcome=failed reason=${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
+  return `${bound.length} door(s), ${missing.length} without a reader`;
+}
+
 // app/lib/telegram/gateway/inbound-hub.ts
 var InboundHub3 = class {
   keys = /* @__PURE__ */ new Map();
@@ -38449,6 +38552,12 @@ function startTelegramNativeFileFollower(input) {
   return startEmitter({
     entry: entry2,
     tag: "[telegram-adaptor]",
+    // Task 2557 — the emitter has always had this channel and no follower ever
+    // passed one, so every cause it reported was discarded. The close line
+    // carries the outcome; this carries the cause.
+    onError: (reason) => {
+      console.error(`[telegram-adaptor] op=follower-error sessionId=${input.sessionId.slice(0, 8)} reason=${reason}`);
+    },
     fileDelivery: makeTelegramFileDelivery(entry2, input.botToken),
     // A resumed session's JSONL already holds prior SendUserFile tool_uses;
     // suppress replay so historical files are not re-sent on attach.
@@ -39367,7 +39476,27 @@ function resolveChannelOverride(accountId, channel, senderId) {
     return null;
   }
 }
-var nativeFileFollowers = /* @__PURE__ */ new Map();
+var nativeFileFollowers = createFollowerRegistry(
+  (p, onClose) => startNativeFileFollower({
+    sessionId: p.sessionId,
+    senderId: p.senderId,
+    // Task 1390 — the file-path validation scope is the sender's effective
+    // session account (the sub-account for an account-manager), not the house
+    // socket account. `accountId` stays the getSocket key.
+    accountId: p.accountId,
+    maxyAccountId: p.effectiveAccountId,
+    // Task 2521 — file delivery is admin-only; the text emitter is not.
+    role: p.role,
+    // Task 2521 — resolved per answer, not captured once, so a door that goes
+    // live after this session started still receives.
+    // Task 2531 — `effectiveAccountId`, NOT `accountId`. The reply map is keyed
+    // on the platform UUID (wa-gateway.ts:567) while `accountId` here is the
+    // Baileys credential dirname. Passing the dirname missed every lookup and
+    // delivered session 8e5bc4e8's answer to nothing.
+    fanTargets: () => whatsappFanTargets(p.effectiveAccountId, p.senderId),
+    onClose
+  })
+);
 var webchatFileFollowers = /* @__PURE__ */ new Map();
 async function fetchAccountStandingRules(accountId) {
   const session = getSession();
@@ -39598,34 +39727,29 @@ var waGateway = new WaGateway({
       console.error(`[whatsapp-native] spawn-failed senderId=${senderId} role=${role} error=${result.error} status=${result.status}`);
       return;
     }
-    const prior = nativeFileFollowers.get(senderId);
-    if (prior) prior.abort();
-    let ac;
-    ac = startNativeFileFollower({
+    nativeFileFollowers.attach({
       sessionId: req.sessionId,
       senderId,
       accountId,
-      // Task 1390 — the file-path validation scope is the sender's effective
-      // session account (the sub-account for an account-manager), not the house
-      // socket account. accountId stays the getSocket key.
-      maxyAccountId: effectiveAccountId,
-      // Task 2521 — file delivery is admin-only; the text emitter is not.
-      role,
-      // Task 2521 — resolved per answer, not captured once, so a door that goes
-      // live after this session started still receives.
-      // Task 2531 — `effectiveAccountId`, NOT `accountId`. The reply map is
-      // keyed on the platform UUID (wa-gateway.ts:567) while `accountId` here is
-      // the Baileys credential dirname (see the Task 1850 note above). Passing
-      // the dirname missed every lookup and delivered session 8e5bc4e8's answer
-      // to nothing. `accountId` stays correct on line 718: that is the socket.
-      fanTargets: () => whatsappFanTargets(effectiveAccountId, senderId),
-      onClose: () => {
-        if (nativeFileFollowers.get(senderId) === ac) nativeFileFollowers.delete(senderId);
-      }
+      effectiveAccountId,
+      role
     });
-    nativeFileFollowers.set(senderId, ac);
   }
 });
+var followerCensusState = makeCensusState();
+registerLoop({
+  name: "channel-follower",
+  intervalMs: 6e4,
+  run: () => followerCensusTick(
+    {
+      bound: () => waGateway.boundTargets(),
+      live: () => nativeFileFollowers.live(),
+      paramsFor: (senderId) => nativeFileFollowers.paramsFor(senderId),
+      attach: (p) => nativeFileFollowers.attach(p)
+    },
+    followerCensusState
+  )
+});
 app80.route("/", waGateway.routes());
 waGateway.startSweeper();
 registerLoop({

package/dist/__tests__/converge-client-admins.test.js

@@ -1,50 +0,0 @@
-// Task 1623 — acceptance for the installer convergence that drops the vestigial
-// admins[] key from existing client account.json. Filesystem fixtures under a
-// tmp dir; no installer side effects. Runs under `node --test dist/__tests__/*`.
-import test from "node:test";
-import assert from "node:assert/strict";
-import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, rmSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { removeClientAdminsKey } from "../converge-client-admins.js";
-function makeRoot() {
-    return mkdtempSync(join(tmpdir(), "conv-1623-"));
-}
-function acct(root, id, cfg) {
-    mkdirSync(join(root, id), { recursive: true });
-    writeFileSync(join(root, id, "account.json"), JSON.stringify(cfg, null, 2));
-}
-function hasAdmins(root, id) {
-    return "admins" in JSON.parse(readFileSync(join(root, id, "account.json"), "utf-8"));
-}
-test("removes admins from a client, keeps it on the house, is idempotent", () => {
-    const root = makeRoot();
-    try {
-        acct(root, "c1", { accountId: "c1", role: "client", admins: [] });
-        acct(root, "h1", { accountId: "h1", role: "house", admins: [{ userId: "u1", role: "owner" }] });
-        acct(root, "c2", { accountId: "c2", role: "client" }); // already stripped
-        const first = removeClientAdminsKey(root);
-        assert.equal(first.find((r) => r.accountId === "c1")?.action, "removed");
-        assert.equal(first.find((r) => r.accountId === "h1")?.action, "house-kept");
-        assert.equal(first.find((r) => r.accountId === "c2")?.action, "absent");
-        assert.equal(hasAdmins(root, "c1"), false);
-        assert.equal(hasAdmins(root, "h1"), true);
-        const second = removeClientAdminsKey(root);
-        assert.equal(second.find((r) => r.accountId === "c1")?.action, "absent");
-    }
-    finally {
-        rmSync(root, { recursive: true, force: true });
-    }
-});
-test("unreadable account.json is reported, not thrown", () => {
-    const root = makeRoot();
-    try {
-        mkdirSync(join(root, "bad"), { recursive: true });
-        writeFileSync(join(root, "bad", "account.json"), "{ not json");
-        const res = removeClientAdminsKey(root);
-        assert.equal(res.find((r) => r.accountId === "bad")?.action, "unreadable");
-    }
-    finally {
-        rmSync(root, { recursive: true, force: true });
-    }
-});