talon-agent 4.6.0 → 5.0.0

package/src/frontend/native/{extensions.ts → surface/extensions.ts}

@@ -17,18 +17,21 @@
  * gating on top.
  */
 
-import type { Backend } from "../../core/agent-runtime/capabilities.js";
-import { performPluginReload } from "../../core/engine/gateway-actions/plugins.js";
-import { getPluginPromptAdditions } from "../../core/plugin/index.js";
-import { listPluginItems, setPluginEnabled } from "../../core/plugin/manage.js";
-import { notifyPromptInputsChanged } from "../../core/prompt/invalidation.js";
-import { listSkills, setSkillEnabled } from "../../storage/skills.js";
+import type { Backend } from "../../../core/agent-runtime/capabilities.js";
+import { performPluginReload } from "../../../core/engine/gateway-actions/plugins.js";
+import { getPluginPromptAdditions } from "../../../core/plugin/index.js";
+import {
+  listPluginItems,
+  setPluginEnabled,
+} from "../../../core/plugin/manage.js";
+import { notifyPromptInputsChanged } from "../../../core/prompt/invalidation.js";
+import { listSkills, setSkillEnabled } from "../../../storage/skills.js";
 import {
   rebuildSystemPrompt,
   type TalonConfig,
-} from "../../core/config/index.js";
-import { log } from "../../util/log.js";
-import type { PluginItem, SkillItem, ToggleResult } from "./protocol.js";
+} from "../../../core/config/index.js";
+import { log } from "../../../util/log.js";
+import type { PluginItem, SkillItem, ToggleResult } from "../protocol.js";
 import { persistConfigPatch } from "./settings.js";
 
 export function pluginItems(config: TalonConfig): PluginItem[] {

package/src/frontend/native/{handlers.ts → surface/handlers.ts}

@@ -4,11 +4,11 @@
  * anything with logic of its own lives in the module named for it.
  */
 
-import { files } from "../../util/paths.js";
-import { setChatPulse } from "../../storage/chat-settings.js";
-import { getPooledBackend } from "../../core/engine/backend-controller/index.js";
-import { createChat, deleteChat, renameChat } from "./chat-lifecycle.js";
-import { broadcastChatUpdated, toClientChat } from "./chat-wire.js";
+import { files } from "../../../util/paths.js";
+import { setChatPulse } from "../../../storage/chat-settings.js";
+import { getPooledBackend } from "../../../core/engine/backend-controller/index.js";
+import { createChat, deleteChat, renameChat } from "../chats/chat-lifecycle.js";
+import { broadcastChatUpdated, toClientChat } from "../chats/chat-wire.js";
 import { control } from "./control.js";
 import {
   pluginItems,
@@ -16,7 +16,7 @@ import {
   togglePlugin,
   toggleSkill,
 } from "./extensions.js";
-import { historyPage, searchHistory } from "./history.js";
+import { historyPage, searchHistory } from "../chats/history.js";
 import { readLogEntries } from "./logs.js";
 import { listMemory, memoryWhy } from "./memory.js";
 import {
@@ -24,7 +24,7 @@ import {
   MAX_UPLOAD_BYTES,
   resolveUpload,
   saveUploadStream,
-} from "./media.js";
+} from "../media/media.js";
 import {
   effortLevels,
   listBackends,
@@ -33,15 +33,20 @@ import {
   setEffort,
   setModel,
 } from "./models.js";
-import { setQueued } from "./queue.js";
-import { resetChat } from "./reset.js";
-import type { NativeRuntime } from "./runtime.js";
-import type { BridgeServerHandlers, SendOptions } from "./server.js";
-import type { ClientAttachment } from "./protocol.js";
+import { setQueued } from "../turn/queue.js";
+import { resetChat } from "../chats/reset.js";
+import type { NativeRuntime } from "../runtime.js";
+import type { BridgeServerHandlers, SendOptions } from "../bridge/server.js";
+import type { ClientAttachment } from "../protocol.js";
 import { configSnapshot, applyConfigUpdate } from "./settings.js";
 import { bridgeStatus, broadcastStatus } from "./status.js";
-import { logWarn } from "../../util/log.js";
-import { interruptTurn, isBusy, liveTurnEvents, startTurn } from "./turn.js";
+import { logWarn } from "../../../util/log.js";
+import {
+  interruptTurn,
+  isBusy,
+  liveTurnEvents,
+  startTurn,
+} from "../turn/turn.js";
 
 /**
  * Turn a `/send` body's attachment references into the records this daemon

package/src/frontend/native/{logs.ts → surface/logs.ts}

@@ -7,8 +7,8 @@
  * Pure functions over a raw tail string; file I/O stays with the caller.
  */
 
-import { tailFile } from "../../util/tail-file.js";
-import type { LogEntry, LogLevel } from "./protocol.js";
+import { tailFile } from "../../../util/tail-file.js";
+import type { LogEntry, LogLevel } from "../protocol.js";
 
 /** pino numeric levels → wire level names. */
 const PINO_LEVELS: Record<number, LogLevel> = {

package/src/frontend/native/{memory.ts → surface/memory.ts}

@@ -23,12 +23,12 @@ import {
   type MemoryHistoryRow,
   type MemoryKind,
   type MemoryRow,
-} from "../../storage/memory.js";
+} from "../../../storage/memory.js";
 import type {
   MemoryHistoryWire,
   MemoryRowWire,
   MemoryWhyWire,
-} from "./protocol.js";
+} from "../protocol.js";
 
 /** Hard ceiling on one listing, whatever the client asks for. */
 const MAX_LIMIT = 100;

package/src/frontend/native/{models.ts → surface/models.ts}

@@ -12,7 +12,7 @@ import {
   setChatBackend,
   EFFORT_LEVELS,
   type EffortLevel,
-} from "../../storage/chat-settings.js";
+} from "../../../storage/chat-settings.js";
 import {
   getBackendForChat,
   getBackendIdForChat,
@@ -20,13 +20,13 @@ import {
   acquireBackendInstance,
   listAvailableBackends,
   rebindChat,
-} from "../../core/engine/backend-controller/index.js";
-import { getActiveReasoningLevels } from "../shared/reasoning-levels.js";
-import { broadcastChatUpdated } from "./chat-wire.js";
-import { emitSystem } from "./emit.js";
-import type { BackendOption, ModelOption } from "./protocol.js";
-import { wipeChatConversation } from "./reset.js";
-import type { NativeRuntime } from "./runtime.js";
+} from "../../../core/engine/backend-controller/index.js";
+import { getActiveReasoningLevels } from "../../shared/reasoning-levels.js";
+import { broadcastChatUpdated } from "../chats/chat-wire.js";
+import { emitSystem } from "../turn/emit.js";
+import type { BackendOption, ModelOption } from "../protocol.js";
+import { wipeChatConversation } from "../chats/reset.js";
+import type { NativeRuntime } from "../runtime.js";
 import { broadcastStatus } from "./status.js";
 
 export async function listModels(
@@ -104,8 +104,15 @@ export function setModel(
   // Persisted setting first — see toClientChat. Writing the pick under the
   // live binding's key would attach it to the wrong backend whenever the
   // boot-time rebind to the persisted backend is still pending.
-  const backendId =
-    getChatSettings(chatId).backend ?? getBackendIdForChat(chatId);
+  let backendId: string;
+  try {
+    backendId = getChatSettings(chatId).backend ?? getBackendIdForChat(chatId);
+  } catch {
+    // Pool not ready — the same fallback listModels uses in this state, so
+    // the pick lands under the backend whose catalog the client was shown.
+    // Letting this throw would 400 the route and drop the pick entirely.
+    backendId = runtime.config.backend;
+  }
   setChatModelForBackend(chatId, backendId, model.trim() || undefined);
   broadcastChatUpdated(runtime, entry);
 }

package/src/frontend/native/{settings.ts → surface/settings.ts}

@@ -14,21 +14,21 @@
 import { existsSync, readFileSync, mkdirSync } from "node:fs";
 import writeFileAtomic from "write-file-atomic";
 import { dirname } from "node:path";
-import type { TalonConfig } from "../../core/config/index.js";
-import { files as pathFiles } from "../../util/paths.js";
-import { setTimezone } from "../../util/time.js";
-import { resolveModel } from "../../core/models/catalog.js";
-import { getHealthStatus } from "../../util/watchdog.js";
-import { getActiveSessionCount } from "../../storage/sessions.js";
+import type { TalonConfig } from "../../../core/config/index.js";
+import { files as pathFiles } from "../../../util/paths.js";
+import { setTimezone } from "../../../util/time.js";
+import { resolveModel } from "../../../core/models/catalog.js";
+import { getHealthStatus } from "../../../util/watchdog.js";
+import { getActiveSessionCount } from "../../../storage/sessions.js";
 import {
   startPulseTimer,
   stopPulseTimer,
-} from "../../core/background/pulse.js";
+} from "../../../core/background/pulse/pulse.js";
 import {
   startHeartbeatTimer,
   stopHeartbeatTimer,
-} from "../../core/background/heartbeat/index.js";
-import { log } from "../../util/log.js";
+} from "../../../core/background/heartbeat/index.js";
+import { log } from "../../../util/log.js";
 
 /** Config keys a client may change through the bridge. */
 export const EDITABLE = [

package/src/frontend/native/{status.ts → surface/status.ts}

@@ -3,9 +3,9 @@
  * as a `status` event whenever something it reports changes.
  */
 
-import { resolveModel } from "../../core/models/catalog.js";
-import { BRIDGE_PROTOCOL_VERSION, type BridgeStatus } from "./protocol.js";
-import type { NativeRuntime } from "./runtime.js";
+import { resolveModel } from "../../../core/models/catalog.js";
+import { BRIDGE_PROTOCOL_VERSION, type BridgeStatus } from "../protocol.js";
+import type { NativeRuntime } from "../runtime.js";
 
 export function bridgeStatus(runtime: NativeRuntime): BridgeStatus {
   const { config } = runtime;

package/src/frontend/native/{actions.ts → turn/actions.ts}

@@ -8,10 +8,13 @@
  * fallback knows the turn already produced output).
  */
 
-import type { FrontendActionHandler, ActionResult } from "../../core/types.js";
-import type { Gateway } from "../../core/engine/gateway.js";
-import type { NativeChats, ChatEntry } from "./chats.js";
-import type { BridgeEvent, ClientButton } from "./protocol.js";
+import type {
+  FrontendActionHandler,
+  ActionResult,
+} from "../../../core/types.js";
+import type { Gateway } from "../../../core/engine/gateway.js";
+import type { NativeChats, ChatEntry } from "../chats/chats.js";
+import type { BridgeEvent, ClientButton } from "../protocol.js";
 
 export type NativeActionDeps = {
   chats: NativeChats;

package/src/frontend/native/{context.ts → turn/context.ts}

@@ -3,17 +3,17 @@
  * cache it on the runtime, and push changes to clients.
  */
 
-import { getSessionInfo } from "../../storage/sessions.js";
-import { buildContextDisplay } from "../shared/status-context.js";
-import { resolveActiveModelForChat } from "../../core/models/active-model.js";
+import { getSessionInfo } from "../../../storage/sessions.js";
+import { buildContextDisplay } from "../../shared/status-context.js";
+import { resolveActiveModelForChat } from "../../../core/models/active-model.js";
 import {
   getBackendForChat,
   getBackendIdForChat,
-} from "../../core/engine/backend-controller/index.js";
-import { broadcastChatUpdated } from "./chat-wire.js";
-import type { ChatEntry } from "./chats.js";
-import type { ContextInfo } from "./protocol.js";
-import type { NativeRuntime } from "./runtime.js";
+} from "../../../core/engine/backend-controller/index.js";
+import { broadcastChatUpdated } from "../chats/chat-wire.js";
+import type { ChatEntry } from "../chats/chats.js";
+import type { ContextInfo } from "../protocol.js";
+import type { NativeRuntime } from "../runtime.js";
 
 type ContextOptions = { resolveModel?: boolean };
 

package/src/frontend/native/{emit.ts → turn/emit.ts}

@@ -3,19 +3,19 @@
  * persist), touch the chat, and broadcast it to every client.
  */
 
-import { pushMessage } from "../../storage/history.js";
-import { extractSessionName } from "../../util/session-name.js";
-import { broadcastChatUpdated } from "./chat-wire.js";
-import { DEFAULT_CHAT_TITLE, type ChatEntry } from "./chats.js";
-import { mediaUrl, registerMedia } from "./media.js";
+import { pushMessage } from "../../../storage/history.js";
+import { extractSessionName } from "../../../util/session-name.js";
+import { broadcastChatUpdated } from "../chats/chat-wire.js";
+import { DEFAULT_CHAT_TITLE, type ChatEntry } from "../chats/chats.js";
+import { mediaUrl, registerMedia } from "../media/media.js";
 import {
   BOT_SENDER_ID,
   USER_SENDER_ID,
   type ClientButton,
   type ClientAttachment,
   type ClientMessage,
-} from "./protocol.js";
-import type { NativeRuntime } from "./runtime.js";
+} from "../protocol.js";
+import type { NativeRuntime } from "../runtime.js";
 
 /**
  * Name a chat from its first user message — instantly and for free.

package/src/frontend/native/{queue.ts → turn/queue.ts}

@@ -3,9 +3,9 @@
  * is running. Every mutation is synced to clients as a `chat_updated`.
  */
 
-import { broadcastChatUpdated } from "./chat-wire.js";
-import type { ChatEntry } from "./chats.js";
-import type { NativeRuntime, QueuedEntry } from "./runtime.js";
+import { broadcastChatUpdated } from "../chats/chat-wire.js";
+import type { ChatEntry } from "../chats/chats.js";
+import type { NativeRuntime, QueuedEntry } from "../runtime.js";
 
 /**
  * Set (or replace) a chat's queued follow-up and sync it to every client via

package/src/frontend/native/{turn-meta.ts → turn/turn-meta.ts}

@@ -13,8 +13,8 @@ import {
   recordTurnMeta as storeRecordTurnMeta,
   getTurnMeta as storeGetTurnMeta,
   clearTurnMeta as storeClearTurnMeta,
-} from "../../storage/turn-meta.js";
-import type { ClientToolCall } from "./protocol.js";
+} from "../../../storage/turn-meta.js";
+import type { ClientToolCall } from "../protocol.js";
 
 export type TurnMeta = {
   durationMs?: number;

package/src/frontend/native/{turn.ts → turn/turn.ts}

@@ -6,19 +6,19 @@
  * backends) — mirroring the terminal renderer's delivery semantics.
  */
 
-import type { ExecuteResult } from "../../core/types.js";
-import type { AgentEvent } from "../../core/agent-runtime/events.js";
-import { execute } from "../../core/engine/dispatcher.js";
-import { toolInputToRecord } from "../../core/agent-runtime/events.js";
-import { getBackendForChat } from "../../core/engine/backend-controller/index.js";
-import { isDeliveryTool } from "../../core/tools/index.js";
+import type { ExecuteResult } from "../../../core/types.js";
+import type { AgentEvent } from "../../../core/agent-runtime/events.js";
+import { execute } from "../../../core/engine/dispatcher.js";
+import { toolInputToRecord } from "../../../core/agent-runtime/events.js";
+import { getBackendForChat } from "../../../core/engine/backend-controller/index.js";
+import { isDeliveryTool } from "../../../core/tools/index.js";
 import { recordTurnMeta } from "./turn-meta.js";
-import type { ChatEntry } from "./chats.js";
+import type { ChatEntry } from "../chats/chats.js";
 import { refreshContext } from "./context.js";
 import { emitAssistant, emitUser } from "./emit.js";
-import type { BridgeEvent, ClientAttachment } from "./protocol.js";
+import type { BridgeEvent, ClientAttachment } from "../protocol.js";
 import { takeQueued } from "./queue.js";
-import type { LiveToolEntry, NativeRuntime } from "./runtime.js";
+import type { LiveToolEntry, NativeRuntime } from "../runtime.js";
 import { summarizeToolResult } from "./tool-result.js";
 
 /** The tool calls of one running turn, in call order. */

package/src/frontend/shared/model-commands.ts

@@ -33,7 +33,7 @@ import {
 } from "../../core/engine/backend-controller/index.js";
 import { resetSession } from "../../storage/sessions.js";
 import { clearHistory } from "../../storage/history.js";
-import { resetPulseCheckpoint } from "../../core/background/pulse.js";
+import { resetPulseCheckpoint } from "../../core/background/pulse/pulse.js";
 import { logWarn } from "../../util/log.js";
 import {
   displayReasoningEffort,

package/src/frontend/shared/session-status.ts

@@ -18,20 +18,25 @@ import {
 } from "../../storage/sessions.js";
 import { clearHistory } from "../../storage/history.js";
 import { getChatSettings } from "../../storage/chat-settings.js";
-import { resetPulseCheckpoint } from "../../core/background/pulse.js";
-import { isPulseEnabled } from "../../core/background/pulse.js";
+import { resetPulseCheckpoint } from "../../core/background/pulse/pulse.js";
+import { isPulseEnabled } from "../../core/background/pulse/pulse.js";
 import { getWorkspaceDiskUsage } from "../../util/workspace.js";
 import { appendDailyLog } from "../../storage/daily-log.js";
 import { resolveActiveModelForChat } from "../../core/models/active-model.js";
 import { getPooledBackend } from "../../core/engine/backend-controller/index.js";
 import {
   buildCacheDisplay,
+  buildCacheTempDisplay,
   buildContextDisplay,
+  buildDaemonDisplay,
   buildPlanDisplay,
   type CacheDisplay,
+  type CacheTempDisplay,
   type ContextDisplay,
+  type DaemonDisplay,
   type PlanDisplay,
 } from "./status-context.js";
+import { getCacheVerdict, getMetrics } from "../../storage/metrics.js";
 import { formatDuration } from "./format.js";
 
 /**
@@ -79,6 +84,12 @@ export interface SessionStatusData {
   pulseOn: boolean;
   context: ContextDisplay;
   cache: CacheDisplay | null;
+  /**
+   * Whether the chat's prompt prefix is still warm: the last turn's
+   * cross-turn cache verdict and how long ago that turn ended. Null when no
+   * turn has finished in this process (docs/cache-economics.md).
+   */
+  cacheTemp: CacheTempDisplay | null;
   plan: PlanDisplay | null;
   inputTokens: number;
   outputTokens: number;
@@ -98,6 +109,16 @@ export interface SessionStatusData {
   runtime: string;
   /** Daemon resident set size, in bytes. */
   rssBytes: number;
+  /**
+   * What the daemon itself costs: resident memory now, plus the CPU a turn
+   * spends inside Talon (docs/ts-migration-plan.md, Phase 0).
+   */
+  daemon: DaemonDisplay;
+}
+
+/** Mean turn duration, or 0 before any turn has been timed. */
+function averageResponseMs(turns: number, totalResponseMs: number): number {
+  return turns > 0 && totalResponseMs ? Math.round(totalResponseMs / turns) : 0;
 }
 
 /**
@@ -182,10 +203,7 @@ export async function collectSessionStatus(
     await planSource?.usage?.getPlanUsage?.().catch(() => undefined),
   );
 
-  const avgResponseMs =
-    info.turns > 0 && u.totalResponseMs
-      ? Math.round(u.totalResponseMs / info.turns)
-      : 0;
+  const memory = process.memoryUsage();
 
   return {
     activeModel,
@@ -195,6 +213,10 @@ export async function collectSessionStatus(
     pulseOn: isPulseEnabled(chatId),
     context,
     cache,
+    cacheTemp: buildCacheTempDisplay({
+      verdict: getCacheVerdict(chatId),
+      lastTurnEndedAt: info.lastTurnEndedAt,
+    }),
     plan,
     inputTokens,
     outputTokens,
@@ -202,7 +224,7 @@ export async function collectSessionStatus(
     turns: info.turns,
     turnsModelLabel,
     lastResponseMs: u.lastResponseMs || 0,
-    avgResponseMs,
+    avgResponseMs: averageResponseMs(info.turns, u.totalResponseMs),
     fastestMs: u.fastestResponseMs === Infinity ? 0 : u.fastestResponseMs || 0,
     diskBytes: getWorkspaceDiskUsage(config.workspace),
     sessionAge: info.createdAt
@@ -215,6 +237,11 @@ export async function collectSessionStatus(
     runtime: process.versions.bun
       ? `Bun ${process.versions.bun}`
       : `Node ${process.versions.node}`,
-    rssBytes: process.memoryUsage().rss,
+    rssBytes: memory.rss,
+    daemon: buildDaemonDisplay({
+      rssBytes: memory.rss,
+      heapBytes: memory.heapUsed,
+      cpuPerTurn: getMetrics().histograms["turn.cpu_ms"],
+    }),
   };
 }

package/src/frontend/shared/status-context.ts

@@ -1,12 +1,14 @@
 import type { CacheMetricsSupport } from "../../core/types.js";
 import type { PlanUsage } from "../../core/agent-runtime/capabilities.js";
+import type { CacheVerdict } from "../../storage/metrics.js";
 import { formatSmartTimestamp, formatRelativeAge } from "../../util/time.js";
+import { formatDuration } from "./format.js";
 
 // ── /context breakdown ────────────────────────────────────────────────────────
 
 /**
  * Rough token estimate — ~4 chars/token, the house heuristic used everywhere
- * (soul/projector, cache-telemetry). No real tokenizer is wired, so every
+ * (cache-telemetry, and the prompt budgets). No real tokenizer is wired, so every
  * measured figure in the breakdown below is an estimate at this fidelity.
  */
 export function estimateContextTokens(text: string): number {
@@ -271,7 +273,7 @@ export function buildCacheDisplay(input: {
       ? input.cacheWrite
       : 0;
 
-  // Match the canonical formula in `src/backend/shared/usage.ts:cacheHitPercent`:
+  // Match the canonical formula in `src/backend/runtime/usage.ts:cacheHitPercent`:
   // cache_write is tokens being *written to* cache on this call, not served
   // from it, so it must not dilute the hit ratio. The denominator is
   // `input + read` ("effective input"), regardless of whether the backend
@@ -287,6 +289,103 @@ export function buildCacheDisplay(input: {
   };
 }
 
+// ── Cache temperature ───────────────────────────────────────────────────────
+
+export interface CacheTempDisplay {
+  /** Last cross-turn verdict, or "unknown" when this process saw no turn. */
+  verdict: CacheVerdict | "unknown";
+  /** Time since the last turn ended, or "—" when no turn has finished. */
+  idle: string;
+}
+
+/**
+ * Resolve the "is this chat's prompt prefix still warm?" line.
+ *
+ * The aggregate `Cache: NN% hit` above it answers a different question — it
+ * folds in every request of every turn, and an agentic turn's later requests
+ * always read the prefix the first one paid for. What costs money is whether
+ * the NEXT turn will find the prefix still cached, and the two inputs to that
+ * are the last turn's cross-turn verdict and how long ago that turn ended
+ * (docs/cache-economics.md).
+ *
+ * Returns null when neither is known — a chat that has not completed a turn
+ * in this process has nothing to say, and a fabricated "none / 0s" would read
+ * as a measurement.
+ */
+export function buildCacheTempDisplay(input: {
+  verdict?: CacheVerdict;
+  lastTurnEndedAt?: number;
+  now?: number;
+}): CacheTempDisplay | null {
+  const endedAt =
+    typeof input.lastTurnEndedAt === "number" &&
+    Number.isFinite(input.lastTurnEndedAt) &&
+    input.lastTurnEndedAt > 0
+      ? input.lastTurnEndedAt
+      : undefined;
+  if (!input.verdict && endedAt === undefined) return null;
+  const now = input.now ?? Date.now();
+  return {
+    verdict: input.verdict ?? "unknown",
+    idle:
+      endedAt === undefined ? "—" : formatDuration(Math.max(0, now - endedAt)),
+  };
+}
+
+/** The one-line rendering every frontend's /status shares. */
+export function formatCacheTempLine(temp: CacheTempDisplay): string {
+  return `Cache: ${temp.verdict} last turn · idle ${temp.idle}`;
+}
+
+// ── Daemon resources ────────────────────────────────────────────────────────
+
+export interface DaemonDisplay {
+  rssMb: number;
+  heapMb: number;
+  /**
+   * Mean daemon CPU per turn, in ms, or undefined before any turn has been
+   * measured. The metrics store's histograms expose count/avg/min/max only
+   * (`storage/metrics.ts`) — there is no percentile to read, so the line
+   * says "avg" rather than implying a p50 it cannot compute.
+   */
+  cpuPerTurnMs: number | undefined;
+  /** How many turns the average is over. */
+  cpuSamples: number;
+}
+
+/**
+ * Resolve the "what does the daemon itself cost?" line — resident memory
+ * now, and the CPU a turn spends inside Talon rather than waiting on a
+ * model (docs/ts-migration-plan.md, Phase 0). Pure: the caller reads
+ * `process.memoryUsage()` and the `turn.cpu_ms` histogram.
+ */
+export function buildDaemonDisplay(input: {
+  rssBytes: number;
+  heapBytes: number;
+  cpuPerTurn?: { count: number; avg: number };
+}): DaemonDisplay {
+  const toMb = (bytes: number): number =>
+    Number.isFinite(bytes) && bytes > 0 ? Math.round(bytes / (1024 * 1024)) : 0;
+  const cpu = input.cpuPerTurn;
+  const measured =
+    cpu !== undefined && cpu.count > 0 && Number.isFinite(cpu.avg);
+  return {
+    rssMb: toMb(input.rssBytes),
+    heapMb: toMb(input.heapBytes),
+    cpuPerTurnMs: measured ? Math.round(cpu.avg) : undefined,
+    cpuSamples: measured ? cpu.count : 0,
+  };
+}
+
+/** The one-line rendering every frontend's /status shares. */
+export function formatDaemonLine(daemon: DaemonDisplay): string {
+  const cpu =
+    daemon.cpuPerTurnMs === undefined
+      ? "cpu/turn —"
+      : `cpu/turn avg ${daemon.cpuPerTurnMs} ms (n=${daemon.cpuSamples})`;
+  return `Daemon: rss ${daemon.rssMb} MB · heap ${daemon.heapMb} MB · ${cpu}`;
+}
+
 // ── Plan limits ─────────────────────────────────────────────────────────────
 
 /** Figures older than this are labelled with their age in /status. */

package/src/frontend/telegram/admin/background.ts

@@ -9,7 +9,7 @@ import {
   describeSchedule,
   nextRunAt,
 } from "../../../storage/cron.js";
-import { getPulseStatus } from "../../../core/background/pulse.js";
+import { getPulseStatus } from "../../../core/background/pulse/pulse.js";
 import { replyHtmlChunked } from "./chunked-reply.js";
 
 export async function replyCronJobs(ctx: Context): Promise<void> {

package/src/frontend/telegram/callbacks/model/backend.ts

@@ -14,7 +14,7 @@ import {
   rebindChat,
   releaseChat,
 } from "../../../../core/engine/backend-controller/index.js";
-import { resetPulseCheckpoint } from "../../../../core/background/pulse.js";
+import { resetPulseCheckpoint } from "../../../../core/background/pulse/pulse.js";
 import { resolveActiveModelForChat } from "../../../../core/models/active-model.js";
 import { logWarn } from "../../../../util/log.js";
 import type { ModelCallback } from "../../model-callbacks.js";

package/src/frontend/telegram/callbacks/pulse.ts

@@ -8,7 +8,7 @@ import {
   disablePulse,
   enablePulse,
   isPulseEnabled,
-} from "../../../core/background/pulse.js";
+} from "../../../core/background/pulse/pulse.js";
 import { answerCallbackQuerySafe } from "./query.js";
 
 export async function handlePulseCallback(

package/src/frontend/telegram/callbacks/settings.ts

@@ -14,7 +14,7 @@ import {
   disablePulse,
   enablePulse,
   isPulseEnabled,
-} from "../../../core/background/pulse.js";
+} from "../../../core/background/pulse/pulse.js";
 import { getBackendIdForChat } from "../../../core/engine/backend-controller/index.js";
 import {
   renderSettingsText,