switchroom 0.12.3 → 0.12.5

package/dist/cli/switchroom.js

@@ -46894,8 +46894,8 @@ var {
 } = import__.default;
 
 // src/build-info.ts
-var VERSION = "0.12.3";
-var COMMIT_SHA = "88d8cd0a";
+var VERSION = "0.12.5";
+var COMMIT_SHA = "bab28d7e";
 
 // src/cli/agent.ts
 init_source();
@@ -48276,6 +48276,7 @@ function buildWorkspaceContext(args) {
     botToken: resolvedBotToken ?? rawBotToken,
     forumChatId: telegramConfig.forum_chat_id,
     dangerousMode: agentConfig.dangerous_mode === true,
+    admin: agentConfig.admin === true,
     useSwitchroomPlugin: usesSwitchroomTelegramPlugin(agentConfig),
     useHotReloadStable: agentConfig.channels?.telegram?.hotReloadStable === true,
     telegramEnabledFlag: agentConfig.channels?.telegram?.enabled === false ? "false" : "true",

package/dist/host-control/main.js

@@ -14693,7 +14693,7 @@ import {
   renameSync,
   mkdirSync
 } from "node:fs";
-import { join as join2, dirname as dirname2 } from "node:path";
+import { join as join2, dirname as dirname2, resolve as resolve5 } from "node:path";
 
 // src/host-control/protocol.ts
 var MAX_FRAME_BYTES = 64 * 1024;
@@ -15355,8 +15355,8 @@ class HostdServer {
           process.stderr.write(`hostd: server error on ${sockPath}: ${err.message}
 `);
         });
-        await new Promise((resolve5, reject) => {
-          server.listen(sockPath, () => resolve5());
+        await new Promise((resolve6, reject) => {
+          server.listen(sockPath, () => resolve6());
           server.once("error", reject);
         });
         await chmod(sockPath, 432).catch(() => {
@@ -15378,7 +15378,7 @@ class HostdServer {
   async stop() {
     const paths = [...this.servers.keys()];
     for (const [, server] of this.servers) {
-      await new Promise((resolve5) => server.close(() => resolve5()));
+      await new Promise((resolve6) => server.close(() => resolve6()));
     }
     this.servers.clear();
     for (const s of paths) {
@@ -15604,10 +15604,27 @@ class HostdServer {
       stderr_tail: tail(res.stderr)
     };
   }
+  missingApplyAssets() {
+    const root = this.opts.applyAssetsRoot ?? resolve5(import.meta.dirname, "../..");
+    return [
+      join2(root, "profiles"),
+      join2(root, "profiles", "default"),
+      join2(root, "vendor", "hindsight-memory")
+    ].filter((p) => !existsSync5(p));
+  }
+  applyAssetPreflight(request_id, started) {
+    const missing = this.missingApplyAssets();
+    if (missing.length === 0)
+      return null;
+    return deniedResponse(request_id, `refused: this switchroom-hostd image is missing apply-time ` + `assets [${missing.join(", ")}]. hostd's in-container ` + `\`switchroom apply\` cannot scaffold agents without them and ` + `would pull images then strand the fleet on the old image ` + `(the klanker incident). Nothing was pulled or changed. Fix: ` + `rebuild/refresh the hostd image — \`switchroom update\` ` + `(refreshes hostd) or \`switchroom hostd install\` on the ` + `host; meanwhile run \`switchroom update\` host-side.`, Date.now() - started);
+  }
   handleUpdateApply(req, caller, started) {
     const denied = this.checkFleetMutationLock(req.op, req.request_id, started);
     if (denied)
       return denied;
+    const assetDenied = this.applyAssetPreflight(req.request_id, started);
+    if (assetDenied)
+      return assetDenied;
     if (req.args?.channel && req.args?.pin) {
       return deniedResponse(req.request_id, "update_apply: `channel` and `pin` are mutually exclusive — pass at most one.", Date.now() - started);
     }
@@ -15663,6 +15680,9 @@ class HostdServer {
     const denied = this.checkFleetMutationLock(req.op, req.request_id, started);
     if (denied)
       return denied;
+    const assetDenied = this.applyAssetPreflight(req.request_id, started);
+    if (assetDenied)
+      return assetDenied;
     const args = ["apply", "--non-interactive"];
     const entry = {
       request_id: req.request_id,
@@ -15755,7 +15775,7 @@ class HostdServer {
     };
   }
   runDocker(args) {
-    return new Promise((resolve5, reject) => {
+    return new Promise((resolve6, reject) => {
       const bin = this.opts.dockerBin ?? "docker";
       const child = spawn(bin, args, {
         stdio: ["ignore", "pipe", "pipe"],
@@ -15770,7 +15790,7 @@ class HostdServer {
         stderr += d.toString("utf8");
       });
       child.on("error", (err) => reject(err));
-      child.on("close", (code) => resolve5({ exit_code: code ?? -1, stdout, stderr }));
+      child.on("close", (code) => resolve6({ exit_code: code ?? -1, stdout, stderr }));
     });
   }
   imageRefsForDigestCapture() {
@@ -15919,7 +15939,7 @@ class HostdServer {
     });
   }
   runSwitchroom(args) {
-    return new Promise((resolve5, reject) => {
+    return new Promise((resolve6, reject) => {
       const bin = this.opts.switchroomBin ?? "switchroom";
       const child = spawn(bin, args, {
         stdio: ["ignore", "pipe", "pipe"],
@@ -15934,7 +15954,7 @@ class HostdServer {
         stderr += d.toString("utf8");
       });
       child.on("error", (err) => reject(err));
-      child.on("close", (code) => resolve5({ exit_code: code ?? -1, stdout, stderr }));
+      child.on("close", (code) => resolve6({ exit_code: code ?? -1, stdout, stderr }));
     });
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "switchroom",
-  "version": "0.12.3",
+  "version": "0.12.5",
   "description": "Run Claude Code 24/7 on your Claude Pro/Max subscription over Telegram. Open-source alternative to OpenClaw and NanoClaw — no API keys.",
   "type": "module",
   "bin": {

package/telegram-plugin/dist/gateway/gateway.js

@@ -42575,6 +42575,27 @@ async function tryHostdDispatch(agentName3, req) {
 function hostdRequestId(prefix) {
   return `${prefix}-${Date.now()}-${randomBytes3(4).toString("hex")}`;
 }
+async function hostdGetStatusOnce(agentName3, targetRequestId) {
+  if (!isHostdEnabled())
+    return "not-configured";
+  const sockPath = hostdSocketPath(agentName3);
+  if (!existsSync19(sockPath))
+    return "not-configured";
+  try {
+    const resp = await hostdRequest({ socketPath: sockPath, timeoutMs: 3000 }, {
+      v: 1,
+      op: "get_status",
+      request_id: hostdRequestId("gw-poke-status"),
+      args: { target_request_id: targetRequestId }
+    });
+    if (resp.result === "denied" || resp.result === "error") {
+      return "unavailable";
+    }
+    return resp;
+  } catch {
+    return "unavailable";
+  }
+}
 async function pollHostdStatus(agentName3, targetRequestId, opts) {
   if (!isHostdEnabled())
     return "not-configured";
@@ -42622,6 +42643,32 @@ function warnLegacySpawnIfHostdDisabled(verb) {
 `);
 }
 
+// gateway/update-status-line.ts
+function latestHostdPhase(tail) {
+  if (!tail)
+    return null;
+  let phase = null;
+  for (const raw of tail.split(`
+`)) {
+    const m = /^\s*\u25b8\s*(.+?)\s*$/.exec(raw);
+    if (m && m[1])
+      phase = m[1];
+  }
+  return phase;
+}
+function elapsedMin(startedAt, now) {
+  return Math.max(1, Math.round((now - startedAt) / 60000));
+}
+function formatUpdateStatusLine(resp, startedAt, now) {
+  const mins = elapsedMin(startedAt, now);
+  const tail = `Recreating the fleet (including me) \u2014 I'll report the result here when it's done.`;
+  if (resp.result !== "started") {
+    return `\u23f3 Fleet update finishing \u2014 hostd reported \`${resp.result}\` (~${mins}m). ${tail}`;
+  }
+  const phase = latestHostdPhase(resp.stdout_tail);
+  return phase ? `\u23f3 Fleet update in progress \u2014 phase: ${phase} (~${mins}m). ${tail}` : `\u23f3 Fleet update in progress \u2014 starting (~${mins}m). ${tail}`;
+}
+
 // gateway/boot-sweep-filter.ts
 function shouldSweepChatAtBoot(chatId) {
   const n = Number(chatId);
@@ -46559,11 +46606,11 @@ function sweepStaleTurnActiveMarker(stateDir, opts) {
 }
 
 // ../src/build-info.ts
-var VERSION = "0.12.3";
-var COMMIT_SHA = "88d8cd0a";
-var COMMIT_DATE = "2026-05-18T09:24:07Z";
-var LATEST_PR = 1509;
-var COMMITS_AHEAD_OF_TAG = 2;
+var VERSION = "0.12.5";
+var COMMIT_SHA = "bab28d7e";
+var COMMIT_DATE = "2026-05-18T12:38:38Z";
+var LATEST_PR = 1514;
+var COMMITS_AHEAD_OF_TAG = 3;
 
 // gateway/boot-version.ts
 function formatRelativeAgo(iso) {
@@ -48168,12 +48215,25 @@ function ensureIssuesCard(chatId, threadId) {
     }
   }
 }
+var inFlightUpdate = null;
 startTimer({
   emitMetric: (event) => {
     emitRuntimeMetric(event);
   },
   onFrameworkFallback: async (ctx) => {
-    const text = formatFrameworkFallbackText(ctx.fallbackKind, ctx.silenceMs, ctx.inFlightTools);
+    let text = null;
+    const upd = inFlightUpdate;
+    if (upd != null) {
+      try {
+        const st = await hostdGetStatusOnce(getMyAgentName(), upd.requestId);
+        if (st !== "not-configured" && st !== "unavailable") {
+          text = formatUpdateStatusLine(st, upd.startedAt, Date.now());
+        }
+      } catch {}
+    }
+    if (text == null) {
+      text = formatFrameworkFallbackText(ctx.fallbackKind, ctx.silenceMs, ctx.inFlightTools);
+    }
     try {
       await robustApiCall(() => bot.api.sendMessage(ctx.chatId, text, {
         ...ctx.threadId != null ? { message_thread_id: ctx.threadId } : {},
@@ -52078,33 +52138,38 @@ The gateway will restart as part of the recreate step; watch for the post-restar
     return;
   }
   if (hostdResp.result === "started") {
+    inFlightUpdate = { requestId: updateRequestId, startedAt: Date.now() };
     (async () => {
-      const terminal = await pollHostdStatus(getMyAgentName(), updateRequestId, {
-        timeoutMs: 60000
-      });
-      if (terminal === "not-configured")
-        return;
-      if (terminal.result === "completed")
-        return;
-      clearRestartMarker();
-      const errBody = terminal.error ?? terminal.stderr_tail ?? terminal.stdout_tail ?? "(no error tail returned)";
-      const editedText = `\uD83D\uDE80 <b>update started</b> \u2014 <b>FAILED</b> via hostd ` + `(result=${escapeHtmlForTg(terminal.result)}):
+      try {
+        const terminal = await pollHostdStatus(getMyAgentName(), updateRequestId, {
+          timeoutMs: 60000
+        });
+        if (terminal === "not-configured")
+          return;
+        if (terminal.result === "completed")
+          return;
+        clearRestartMarker();
+        const errBody = terminal.error ?? terminal.stderr_tail ?? terminal.stdout_tail ?? "(no error tail returned)";
+        const editedText = `\uD83D\uDE80 <b>update started</b> \u2014 <b>FAILED</b> via hostd ` + `(result=${escapeHtmlForTg(terminal.result)}):
 ` + preBlock(errBody);
-      if (ackId != null) {
-        try {
-          await robustApiCall(() => lockedBot.api.editMessageText(chatId, ackId, editedText, {
-            parse_mode: "HTML",
-            link_preview_options: { is_disabled: true }
-          }), { verb: "update.poll.editAck" });
-        } catch {
+        if (ackId != null) {
+          try {
+            await robustApiCall(() => lockedBot.api.editMessageText(chatId, ackId, editedText, {
+              parse_mode: "HTML",
+              link_preview_options: { is_disabled: true }
+            }), { verb: "update.poll.editAck" });
+          } catch {
+            try {
+              await switchroomReply(ctx, editedText, { html: true });
+            } catch {}
+          }
+        } else {
           try {
             await switchroomReply(ctx, editedText, { html: true });
           } catch {}
         }
-      } else {
-        try {
-          await switchroomReply(ctx, editedText, { html: true });
-        } catch {}
+      } finally {
+        inFlightUpdate = null;
       }
     })();
     return;

package/telegram-plugin/gateway/gateway.ts

@@ -233,9 +233,11 @@ import {
   hostdRequestId,
   hostdWillBeUsed,
   pollHostdStatus,
+  hostdGetStatusOnce,
   warnLegacySpawnIfHostdDisabled,
   _resetHostdEnabledCache,
 } from './hostd-dispatch.js'
+import { formatUpdateStatusLine } from './update-status-line.js'
 import type { HostdRequest } from '../../src/host-control/protocol.js'
 import type { AgentAudit } from '../welcome-text.js'
 import { shouldSweepChatAtBoot } from './boot-sweep-filter.js'
@@ -2567,22 +2569,50 @@ function ensureIssuesCard(chatId: string, threadId: number | undefined): void {
 // the framework itself sends a user-visible "still working… / still
 // thinking…" message. Honours SWITCHROOM_DISABLE_SILENCE_POKE=1 kill
 // switch (no-op if set).
+// Set when this gateway dispatches an `update_apply` to hostd that
+// returns `started`; cleared when the dispatch poll resolves (terminal
+// / not-configured / timeout). While set, the framework silence
+// fallback substitutes hostd's real phase + elapsed for the generic
+// "still working…" text — deterministic, model-free, the klanker
+// incident fix. In-memory only; a gateway recreate naturally resets it.
+let inFlightUpdate: { requestId: string; startedAt: number } | null = null
+
 silencePoke.startTimer({
   emitMetric: (event) => {
     // Re-emit through the unified runtime-metrics fan-out (PostHog + JSONL).
     emitRuntimeMetric(event)
   },
   onFrameworkFallback: async (ctx) => {
-    // Wording is load-bearing — extracted to `formatFrameworkFallbackText`
-    // in `silence-poke.ts` so it can be snapshot-tested in isolation
-    // (CC-4 in `docs/status-ask-cause-classes.md`). Derives "N min" suffix
-    // from `ctx.silenceMs` so the wording stays honest if the 300s
-    // threshold is tuned.
-    const text = silencePoke.formatFrameworkFallbackText(
-      ctx.fallbackKind,
-      ctx.silenceMs,
-      ctx.inFlightTools,
-    )
+    // Deterministic in-flight update status (klanker incident). If this
+    // gateway dispatched an update_apply that's still running, the
+    // recurring framework fallback carries hostd's REAL phase + elapsed
+    // instead of the content-free "still working…". No model: pure
+    // get_status snapshot → pure formatter. Any hostd unavailability
+    // degrades silently to the existing generic text (zero regression).
+    let text: string | null = null
+    const upd = inFlightUpdate
+    if (upd != null) {
+      try {
+        const st = await hostdGetStatusOnce(getMyAgentName(), upd.requestId)
+        if (st !== 'not-configured' && st !== 'unavailable') {
+          text = formatUpdateStatusLine(st, upd.startedAt, Date.now())
+        }
+      } catch {
+        /* degrade to generic fallback below */
+      }
+    }
+    if (text == null) {
+      // Wording is load-bearing — extracted to `formatFrameworkFallbackText`
+      // in `silence-poke.ts` so it can be snapshot-tested in isolation
+      // (CC-4 in `docs/status-ask-cause-classes.md`). Derives "N min" suffix
+      // from `ctx.silenceMs` so the wording stays honest if the 300s
+      // threshold is tuned.
+      text = silencePoke.formatFrameworkFallbackText(
+        ctx.fallbackKind,
+        ctx.silenceMs,
+        ctx.inFlightTools,
+      )
+    }
     try {
       await robustApiCall(
         () => bot.api.sendMessage(ctx.chatId, text, {
@@ -8594,6 +8624,10 @@ bot.command('update', async ctx => {
     return
   }
   if (hostdResp.result === 'started') {
+    // Mark in-flight so the framework silence fallback renders hostd's
+    // real phase + elapsed (deterministic, model-free) instead of the
+    // content-free "still working…" — the klanker incident fix.
+    inFlightUpdate = { requestId: updateRequestId, startedAt: Date.now() }
     // RFC C §5.3: long-running mutation. Poll get_status until terminal
     // or until the recreate kills this gateway (whichever happens first).
     // The success signal is the post-restart greeting card edited into
@@ -8602,6 +8636,7 @@ bot.command('update', async ctx => {
     // doesn't leave the operator staring at the orphan "🚀 update started"
     // ack indefinitely. Live repro: PR #1305.
     void (async () => {
+     try {
       // 60s budget: RFC C §5.3 specs `apply` at 30s and `update_apply`
       // at 60s. Image pulls + scaffold regeneration dominate the wall
       // clock for update_apply, hence the larger budget. The poll
@@ -8648,6 +8683,11 @@ bot.command('update', async ctx => {
           await switchroomReply(ctx, editedText, { html: true })
         } catch {}
       }
+     } finally {
+       // Poll resolved (terminal / completed / not-configured /
+       // timeout) — stop substituting in-flight update status.
+       inFlightUpdate = null
+     }
     })()
     return
   }

package/telegram-plugin/gateway/hostd-dispatch.ts

@@ -124,6 +124,44 @@ export function hostdRequestId(prefix: string): string {
   return `${prefix}-${Date.now()}-${randomBytes(4).toString("hex")}`;
 }
 
+/**
+ * Single-shot `get_status` snapshot for `targetRequestId` (NOT a
+ * poll-until-terminal — {@link pollHostdStatus} does that). Used by
+ * the framework silence-fallback to render a deterministic in-flight
+ * status line. Returns `"not-configured"` (hostd off / socket absent)
+ * or `"unavailable"` (wire error / hostd couldn't answer) so the
+ * caller can cleanly fall back to the generic fallback text — never
+ * throws, never blocks the fallback.
+ */
+export async function hostdGetStatusOnce(
+  agentName: string,
+  targetRequestId: string,
+): Promise<HostdResponse | "not-configured" | "unavailable"> {
+  if (!isHostdEnabled()) return "not-configured";
+  const sockPath = hostdSocketPath(agentName);
+  if (!existsSync(sockPath)) return "not-configured";
+  try {
+    const resp = await hostdRequest(
+      { socketPath: sockPath, timeoutMs: 3000 },
+      {
+        v: 1,
+        op: "get_status",
+        request_id: hostdRequestId("gw-poke-status"),
+        args: { target_request_id: targetRequestId },
+      },
+    );
+    // hostd answered but couldn't resolve the entry → treat as
+    // unavailable so we degrade to the generic fallback, not a
+    // confusing "error" status line.
+    if (resp.result === "denied" || resp.result === "error") {
+      return "unavailable";
+    }
+    return resp;
+  } catch {
+    return "unavailable";
+  }
+}
+
 /**
  * Poll hostd's `get_status` verb until the target request reaches a
  * terminal state (`completed` / `error` / `denied`) or the caller's

package/telegram-plugin/gateway/update-status-line.ts

@@ -0,0 +1,61 @@
+/**
+ * Deterministic, model-free status line for an in-flight hostd
+ * `update_apply`. Pure function over hostd's `get_status` response —
+ * no model, no I/O. Used by the gateway's framework silence-fallback
+ * so the recurring "is it still going?" message carries hostd's
+ * actual phase + elapsed instead of the content-free
+ * "still working… no update from agent in N min" (the klanker
+ * incident: a multi-minute fleet update with zero visible status).
+ *
+ * The hostd CLI prints step banners as `▸ <step>` lines (pull-images,
+ * apply-config, recreate-containers, doctor, …) into stdout; hostd
+ * surfaces the last 4 KiB as `stdout_tail`. The phase is the LAST such
+ * banner — a deterministic string parse, no interpretation.
+ */
+
+export interface UpdateStatusResponse {
+  result: string;
+  stdout_tail?: string;
+  stderr_tail?: string;
+}
+
+/** Latest `▸ <step>` banner in the tail, or null if none yet. */
+export function latestHostdPhase(tail: string | undefined): string | null {
+  if (!tail) return null;
+  let phase: string | null = null;
+  for (const raw of tail.split("\n")) {
+    const m = /^\s*▸\s*(.+?)\s*$/.exec(raw);
+    if (m && m[1]) phase = m[1];
+  }
+  return phase;
+}
+
+function elapsedMin(startedAt: number, now: number): number {
+  return Math.max(1, Math.round((now - startedAt) / 60_000));
+}
+
+/**
+ * Compose the deterministic status line. `resp` is hostd's get_status
+ * for the in-flight update_apply; `startedAt` is when the gateway
+ * dispatched it; `now` is the current time.
+ */
+export function formatUpdateStatusLine(
+  resp: UpdateStatusResponse,
+  startedAt: number,
+  now: number,
+): string {
+  const mins = elapsedMin(startedAt, now);
+  const tail = `Recreating the fleet (including me) — I'll report the result here when it's done.`;
+
+  // Terminal-but-gateway-still-alive: recreate hasn't killed us yet, or
+  // it failed before recreate. The dedicated terminal/boot path owns the
+  // final verdict; here we just stop claiming "in progress".
+  if (resp.result !== "started") {
+    return `⏳ Fleet update finishing — hostd reported \`${resp.result}\` (~${mins}m). ${tail}`;
+  }
+
+  const phase = latestHostdPhase(resp.stdout_tail);
+  return phase
+    ? `⏳ Fleet update in progress — phase: ${phase} (~${mins}m). ${tail}`
+    : `⏳ Fleet update in progress — starting (~${mins}m). ${tail}`;
+}

package/telegram-plugin/tests/update-status-line.test.ts

@@ -0,0 +1,70 @@
+import { describe, it, expect } from 'vitest'
+import {
+  latestHostdPhase,
+  formatUpdateStatusLine,
+} from '../gateway/update-status-line.js'
+
+const T0 = 1_000_000_000_000
+
+describe('latestHostdPhase', () => {
+  it('returns null for empty / no-banner tail', () => {
+    expect(latestHostdPhase(undefined)).toBeNull()
+    expect(latestHostdPhase('')).toBeNull()
+    expect(latestHostdPhase('Applying switchroom config...\nWrote compose')).toBeNull()
+  })
+
+  it('returns the LAST ▸ banner (deterministic, last wins)', () => {
+    const tail =
+      '▸ pull-images\n some docker output\n▸ apply-config\n▸ recreate-containers\n'
+    expect(latestHostdPhase(tail)).toBe('recreate-containers')
+  })
+
+  it('tolerates leading/trailing whitespace around the banner', () => {
+    expect(latestHostdPhase('  ▸   doctor   \n')).toBe('doctor')
+  })
+})
+
+describe('formatUpdateStatusLine', () => {
+  it('in-progress with a phase: shows phase + elapsed + report-back tail', () => {
+    const line = formatUpdateStatusLine(
+      { result: 'started', stdout_tail: '▸ pull-images\n▸ apply-config\n' },
+      T0,
+      T0 + 2 * 60_000 + 5_000, // ~2m
+    )
+    expect(line).toContain('Fleet update in progress')
+    expect(line).toContain('phase: apply-config')
+    expect(line).toContain('~2m')
+    expect(line).toMatch(/report the result here/i)
+    expect(line).not.toMatch(/still working|no update from agent/i)
+  })
+
+  it('in-progress before any banner: "starting"', () => {
+    const line = formatUpdateStatusLine(
+      { result: 'started', stdout_tail: 'Image ... Pulling' },
+      T0,
+      T0 + 30_000,
+    )
+    expect(line).toContain('Fleet update in progress')
+    expect(line).toContain('starting')
+    expect(line).not.toContain('phase:')
+    expect(line).toContain('~1m') // min 1m floor
+  })
+
+  it('elapsed rounds to nearest minute, floored at 1', () => {
+    expect(formatUpdateStatusLine({ result: 'started' }, T0, T0 + 5_000)).toContain('~1m')
+    expect(
+      formatUpdateStatusLine({ result: 'started' }, T0, T0 + 7 * 60_000 + 40_000),
+    ).toContain('~8m')
+  })
+
+  it('terminal-but-gateway-alive: stops claiming in-progress, defers to verdict path', () => {
+    const line = formatUpdateStatusLine(
+      { result: 'error', stderr_tail: 'boom' },
+      T0,
+      T0 + 3 * 60_000,
+    )
+    expect(line).toContain('finishing')
+    expect(line).toContain('`error`')
+    expect(line).not.toContain('in progress')
+  })
+})