talon-agent 4.6.1 → 5.0.1

package/src/frontend/{shared → presentation}/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/teams/commands.ts

@@ -9,8 +9,8 @@ import { resolveModel } from "../../core/models/catalog.js";
 import { resolveChatBackend } from "../../core/engine/backend-controller/index.js";
 import { getSessionInfo } from "../../storage/sessions.js";
 import { getChatSettings } from "../../storage/chat-settings.js";
-import { performSessionReset } from "../shared/session-status.js";
-import { buildCacheDisplay } from "../shared/status-context.js";
+import { performSessionReset } from "../presentation/session-status.js";
+import { buildCacheDisplay } from "../presentation/status-context.js";
 import { buildAdaptiveCard } from "./formatting.js";
 import type { ChatMessage } from "./graph.js";
 import { postCard } from "./outbound.js";

package/src/frontend/teams/turn.ts

@@ -4,7 +4,7 @@
  */
 
 import { log, logError } from "../../util/log.js";
-import { deriveNumericChatId } from "../../util/chat-id.js";
+import { deriveNumericChatId } from "../../core/frontend-runtime/chat-id.js";
 import {
   toolInputToRecord,
   type AgentEvent,

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/admin/health.ts

@@ -12,7 +12,7 @@ import { getAllSessions } from "../../../storage/sessions.js";
 import { todayLogDate } from "../../../storage/daily-log.js";
 import { getActiveCount } from "../../../core/engine/dispatcher.js";
 import { getHealthStatus, getRecentErrors } from "../../../util/watchdog.js";
-import { formatDuration } from "../helpers/index.js";
+import { formatDuration } from "../../presentation/format.js";
 
 export async function replyStats(ctx: Context): Promise<void> {
   const h = getHealthStatus();

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

@@ -8,7 +8,7 @@ import { escapeHtml } from "../formatting.js";
 import { resetSession, getAllSessions } from "../../../storage/sessions.js";
 import { clearHistory } from "../../../storage/history.js";
 import { getChatSettings } from "../../../storage/chat-settings.js";
-import { formatModelLabel } from "../helpers/index.js";
+import { formatModelLabel } from "../../presentation/format.js";
 import { replyHtmlChunked } from "./chunked-reply.js";
 
 /** `/admin chats` — every active session, newest first, titled via getChat. */

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

@@ -9,13 +9,13 @@ import {
   type EffortLevel,
 } from "../../../storage/chat-settings.js";
 import { getBackendIdForChat } from "../../../core/engine/backend-controller/index.js";
-import { renderEffortRows } from "../helpers/index.js";
+import { renderEffortRows } from "../render/menu.js";
 import { resolveBackendForChat } from "../model-menu.js";
 import {
   displayReasoningEffort,
   getActiveReasoningLevels,
   supportsReasoningLevel,
-} from "../../shared/reasoning-levels.js";
+} from "../../presentation/reasoning-levels.js";
 import { answerCallbackQuerySafe, type CallbackDeps } from "./query.js";
 
 export async function handleEffortCallback(

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

@@ -12,7 +12,7 @@ import {
   renderMetricsKeyboard,
   renderMetricsPanel,
   type MetricsView,
-} from "../helpers/index.js";
+} from "../render/reports.js";
 import { isAuthorizedAdmin } from "../commands/state.js";
 import { answerCallbackQuerySafe, editOrIgnoreSame } from "./query.js";
 

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/model/views.ts

@@ -11,7 +11,7 @@ import {
   renderModelBrowseKeyboard,
   renderBackendMenuKeyboard,
   renderBackendMenuText,
-} from "../../helpers/index.js";
+} from "../../render/menu.js";
 import {
   buildModelMenuViewForChat,
   buildModelBrowseViewForChat,

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/query.ts

@@ -7,7 +7,7 @@ import type { Context } from "grammy";
 import type { TalonConfig } from "../../../core/config/index.js";
 import type { Backend } from "../../../core/agent-runtime/capabilities.js";
 import { logWarn } from "../../../util/log.js";
-import type { SettingsButton } from "../helpers/index.js";
+import type { SettingsButton } from "../render/menu.js";
 
 export type CallbackDeps = {
   config: TalonConfig;

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

@@ -14,20 +14,20 @@ 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,
   renderSettingsKeyboard,
   type SettingsButton,
-} from "../helpers/index.js";
+} from "../render/menu.js";
 import { resolveBackendForChat } from "../model-menu.js";
 import { resolveActiveModelForChat } from "../../../core/models/active-model.js";
 import {
   displayReasoningEffort,
   getActiveReasoningLevels,
   supportsReasoningLevel,
-} from "../../shared/reasoning-levels.js";
+} from "../../presentation/reasoning-levels.js";
 import { answerCallbackQuerySafe, type CallbackDeps } from "./query.js";
 
 export async function handleSettingsCallback(

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

@@ -1,5 +1,5 @@
 /**
- * Admin + maintenance commands — /admin, /metrics, /doctor, /dream, /soul,
+ * Admin + maintenance commands — /admin, /metrics, /doctor, /dream,
  * /restart, /update — plus the unknown-command "did you mean…?" suggester.
  *
  * Most commands here gate on the configured admin user id via
@@ -8,24 +8,23 @@
 
 import type { Bot } from "grammy";
 import type { TalonConfig } from "../../../core/config/index.js";
-import { respawnSelf } from "../../../util/respawn.js";
+import { respawnSelf } from "../../../core/daemon/respawn.js";
 import { isStaleCommand } from "../stale-command.js";
 import {
   getRepoRoot,
   runSelfUpdate,
 } from "../../../core/update/self-update.js";
-import { forceDream } from "../../../core/background/dream.js";
-import { getSoul } from "../../../core/soul/service.js";
+import { forceDream } from "../../../core/background/dream/index.js";
 import { escapeHtml } from "../formatting.js";
 import { closestMatch } from "../../../native/strsim.js";
+import { formatDuration } from "../../presentation/format.js";
 import {
-  formatDuration,
   renderDoctorMessage,
   renderMetricsKeyboard,
   renderMetricsPanel,
   renderUsageMessage,
-} from "../helpers/index.js";
-import { collectPlanUsage } from "../../shared/plan-usage-report.js";
+} from "../render/reports.js";
+import { collectPlanUsage } from "../../presentation/plan-usage-report.js";
 import { collectDoctorReport } from "../../../core/doctor/index.js";
 import { handleAdminCommand } from "../admin.js";
 import { getTodayMetrics } from "../../../storage/metrics.js";
@@ -126,39 +125,6 @@ function registerDreamCommand(bot: Bot): void {
   });
 }
 
-// /soul — introspect the compiled identity (read-only). `/soul dream`
-// (admin) runs the organic maintenance pass. Inert when the soul is
-// disabled (TALON_SOUL_ENABLED), so it's safe to ship dormant.
-function registerSoulCommand(bot: Bot): void {
-  bot.command("soul", async (ctx) => {
-    const soul = getSoul();
-    if (!soul.enabled) {
-      await ctx.reply("Soul is disabled (set TALON_SOUL_ENABLED to enable).");
-      return;
-    }
-    const arg = (ctx.match ?? "").trim().toLowerCase();
-    if (arg === "dream") {
-      if (!isAuthorizedAdmin(ctx)) {
-        await ctx.reply("Not authorized.");
-        return;
-      }
-      const sent = await ctx.reply("🧠 Soul dreaming...");
-      void soul
-        .dream()
-        .then(() =>
-          bot.api.editMessageText(
-            ctx.chat.id,
-            sent.message_id,
-            "🧠 Soul dream complete.",
-          ),
-        )
-        .catch(() => undefined);
-      return;
-    }
-    await ctx.reply(soul.introspect());
-  });
-}
-
 function registerRestartCommand(bot: Bot): void {
   bot.command("restart", async (ctx) => {
     if (!isAuthorizedAdmin(ctx)) {
@@ -275,7 +241,6 @@ export function registerAdminCommands(
   registerUsageCommand(bot, config);
   registerDoctorCommand(bot, config);
   registerDreamCommand(bot);
-  registerSoulCommand(bot);
   registerRestartCommand(bot);
   const updateRepoRoot = config.devBuild ? getRepoRoot() : null;
   if (updateRepoRoot) registerUpdateCommand(bot, config, updateRepoRoot);

package/src/frontend/telegram/commands/index.ts

@@ -8,7 +8,7 @@
  *   - `memory`      — /memory (read-only view of the typed memory store)
  *   - `session`     — /reset /status
  *   - `settings`    — /model /effort /pulse /settings
- *   - `admin`       — /admin /metrics /doctor /dream /soul /restart /update
+ *   - `admin`       — /admin /metrics /doctor /dream /restart /update
  *                     + the unknown-command suggester
  *
  * `registerCommands` wires every group onto the bot in an order that ends

package/src/frontend/telegram/commands/info.ts

@@ -5,12 +5,12 @@
 import type { Bot, Context } from "grammy";
 import { isUserClientReady } from "../userbot.js";
 import { escapeHtml } from "../formatting.js";
+import { formatDuration } from "../../presentation/format.js";
 import {
-  formatDuration,
   renderMeshPairLink,
   renderMeshReport,
   type MeshReachability,
-} from "../helpers/index.js";
+} from "../render/reports.js";
 import { isAuthorizedAdmin } from "./state.js";
 import { getLoadedPlugins } from "../../../core/plugin/index.js";
 import { getMeshService } from "../../../core/mesh/index.js";

package/src/frontend/telegram/commands/session.ts

@@ -2,7 +2,7 @@
  * Session commands — /reset and /status.
  *
  * Data gathering and the reset sequence live in
- * frontend/shared/session-status.ts; this file only renders Telegram HTML.
+ * frontend/presentation/session-status.ts; this file only renders Telegram HTML.
  */
 
 import type { Bot } from "grammy";
@@ -13,13 +13,17 @@ import {
   formatTokenCount,
   formatBytes,
   formatUsd,
-} from "../helpers/index.js";
+} from "../../presentation/format.js";
 import { resolveBackendForChat } from "../model-menu.js";
 import { getBackendIdForChat } from "../../../core/engine/backend-controller/index.js";
 import {
   performSessionReset,
   collectSessionStatus,
-} from "../../shared/session-status.js";
+} from "../../presentation/session-status.js";
+import {
+  formatCacheTempLine,
+  formatDaemonLine,
+} from "../../presentation/status-context.js";
 import { stopCurrentTurn } from "../../../core/engine/dispatcher.js";
 import type { RegisterDeps } from "./state.js";
 
@@ -74,6 +78,7 @@ export function registerSessionCommands(
             `  Read ${formatTokenCount(s.cache.read)}${s.cache.showsWrite ? `  Write ${formatTokenCount(s.cache.write)}` : ""}`,
           ]
         : []),
+      ...(s.cacheTemp ? [`  ${formatCacheTempLine(s.cacheTemp)}`] : []),
       `  Input ${formatTokenCount(s.inputTokens)}  Output ${formatTokenCount(s.outputTokens)}${s.costUsd > 0 ? `  Cost ${formatUsd(s.costUsd)}` : ""}`,
       "",
       ...(s.plan
@@ -91,6 +96,7 @@ export function registerSessionCommands(
       `<b>Session</b>   ${s.sessionName ? `"${escapeHtml(s.sessionName)}" ` : ""}${s.sessionId ? "<code>" + escapeHtml(s.sessionId.slice(0, 8)) + "...</code>" : "<i>(new)</i>"} · ${s.sessionAge} old`,
       `<b>Uptime</b>    ${s.uptime} · ${s.activeSessionCount} active session${s.activeSessionCount === 1 ? "" : "s"}`,
       `<b>Runtime</b>   ${escapeHtml(s.runtime)} · ${formatBytes(s.rssBytes)} RSS`,
+      escapeHtml(formatDaemonLine(s.daemon)),
     ];
     await ctx.reply(lines.join("\n"), { parse_mode: "HTML" });
   });

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

@@ -17,19 +17,21 @@ import {
   disablePulse,
   enablePulse,
   isPulseEnabled,
-} from "../../../core/background/pulse.js";
+} from "../../../core/background/pulse/pulse.js";
 import { escapeHtml } from "../formatting.js";
 import {
   formatModelLabel,
   formatDuration,
   parseInterval,
+} from "../../presentation/format.js";
+import {
   renderSettingsText,
   renderSettingsKeyboard,
   renderEffortRows,
   renderModelMenuText,
   renderModelMenuKeyboard,
   type SettingsButton,
-} from "../helpers/index.js";
+} from "../render/menu.js";
 import {
   buildModelMenuViewForChat,
   resolveBackendForChat,
@@ -40,7 +42,7 @@ import {
   displayReasoningEffort,
   getActiveReasoningLevels,
   supportsReasoningLevel,
-} from "../../shared/reasoning-levels.js";
+} from "../../presentation/reasoning-levels.js";
 import type { RegisterDeps } from "./state.js";
 
 /** `/model <query>` — resolve the query against the per-chat backend and

package/src/frontend/telegram/handlers/messages.ts

@@ -13,7 +13,6 @@ import { setMessageFilePath } from "../../../storage/history.js";
 import { addMedia } from "../../../storage/media-index.js";
 import { appendDailyLog } from "../../../storage/daily-log.js";
 import { logError } from "../../../util/log.js";
-import { recordMessageSignal } from "../../../core/soul/taps.js";
 import {
   getSenderName,
   getReplyContext,
@@ -178,15 +177,6 @@ export async function handleTextMessage(
   );
   const prompt = fwdCtx + replyCtx + replyPhotoCtx + (ctx.message.text ?? "");
 
-  // Soul tap: a message reaching here is addressed to Talon (DM, mention, or
-  // reply). If it reads as a standing directive or a correction, record it as
-  // evidence. No-op unless the soul is enabled.
-  recordMessageSignal({
-    text: ctx.message.text ?? "",
-    actor: sender,
-    addressedToBot: true,
-  });
-
   enqueueMessage(bot, config, chatId, ctx.chat.id, {
     prompt,
     replyToId: ctx.message.message_id,

package/src/frontend/telegram/handlers/state.ts

@@ -13,7 +13,7 @@ import {
   createDmUserTracker,
   createNoticeCooldown,
   createRateLimiter,
-} from "../../shared/access.js";
+} from "../../presentation/access.js";
 
 // ── First-time DM user tracking ──────────────────────────────────────────────
 

package/src/frontend/telegram/index.ts

@@ -10,7 +10,6 @@ import { Bot, InputFile, API_CONSTANTS } from "grammy";
 import { autoRetry } from "@grammyjs/auto-retry";
 import { apiThrottler } from "@grammyjs/transformer-throttler";
 import type { TalonConfig } from "../../core/config/index.js";
-import { soulEnabled } from "../../core/soul/settings.js";
 import type { ContextManager } from "../../core/types.js";
 import type { Gateway } from "../../core/engine/gateway.js";
 import { createTelegramActionHandler, sendText } from "./actions/index.js";
@@ -127,13 +126,10 @@ export function createTelegramFrontend(
       });
       // Beyond grammY's defaults: `chat_join_request` feeds the moderation
       // tool's pending-join cache (inert unless the bot admins an
-      // approval-gated chat), and `message_reaction` feeds the soul's
-      // reaction tap — subscribed only when the soul is enabled, so a
-      // soulless deployment's reaction behaviour is unchanged.
+      // approval-gated chat).
       const allowedUpdates = [
         ...API_CONSTANTS.DEFAULT_UPDATE_TYPES,
         "chat_join_request" as const,
-        ...(soulEnabled(config.soul) ? ["message_reaction" as const] : []),
       ];
       await bot.start({
         allowed_updates: allowedUpdates,

package/src/frontend/telegram/middleware.ts

@@ -12,13 +12,12 @@ import type { TalonConfig } from "../../core/config/index.js";
 import { pushMessage } from "../../storage/history.js";
 import type { HistoryMessage } from "../../storage/repositories/history-repo.js";
 import { allowChat, revokeChat } from "./userbot.js";
-import { registerChat } from "../../core/background/pulse.js";
+import { registerChat } from "../../core/background/pulse/pulse.js";
 import { log } from "../../util/log.js";
 import { getSenderName } from "./handlers/index.js";
 import { noteUpdateId } from "./update-offset.js";
 import { noteInboundThread } from "./topics.js";
 import { recordJoinRequest } from "./join-requests.js";
-import { newlyAddedEmojis, recordReactionToBot } from "../../core/soul/taps.js";
 import {
   handleTextMessage,
   handlePhotoMessage,
@@ -147,18 +146,6 @@ function captureHistory(
   return next();
 }
 
-// ── Reaction tap — feed reactions on Talon's own messages to the soul ────
-// Telegram only delivers `message_reaction` updates when subscribed via
-// allowed_updates (see index.ts) and, in groups, when the bot is an admin.
-// The handler is inert unless the soul is enabled.
-function tapReaction(ctx: Filter<Context, "message_reaction">): void {
-  const mr = ctx.messageReaction;
-  // Ignore the bot reacting to messages itself.
-  if (mr.user?.id === ctx.me.id) return;
-  const added = newlyAddedEmojis(mr.old_reaction, mr.new_reaction);
-  recordReactionToBot(mr.chat.id, mr.message_id, added);
-}
-
 // ── Join requests — cache for moderate(op="list_join_requests") ─────────
 // Delivered only when subscribed via allowed_updates (see index.ts) and
 // the bot admins a chat whose invite link requires approval. Stored, not
@@ -208,7 +195,6 @@ function registerMessageHandlers(bot: Bot, config: TalonConfig): void {
 export function registerMiddleware(bot: Bot, config: TalonConfig): void {
   bot.use(trackUpdateOffset);
   bot.on("message", captureHistory);
-  bot.on("message_reaction", tapReaction);
   bot.on("chat_join_request", cacheJoinRequest);
   bot.on("my_chat_member", revokeOnRemoval);
   registerMessageHandlers(bot, config);

package/src/frontend/telegram/model-menu.ts

@@ -32,7 +32,7 @@ import {
   buildModelMenuState,
   type ModelMenuState,
   type SettingsButton,
-} from "./helpers/index.js";
+} from "./render/menu.js";
 import {
   hasBackendPool,
   getBackendIdForChat,

package/src/frontend/telegram/render/html.ts

@@ -0,0 +1,30 @@
+/**
+ * Telegram's dialect of the shared chat reports.
+ *
+ * `frontend/presentation/reports.ts` writes each report once and takes
+ * the markup spelling from a `ReportFormatter`; this is Telegram's.
+ * `escape` is `escapeHtml` because sends use `parse_mode: HTML`, so a
+ * literal `<` in a device name, a model id, a metric key or a backend
+ * note would be read as a tag and 400 the entire message.
+ *
+ * Its own module so both `reports.ts` (the report wrappers) and
+ * `menu.ts` (the settings body) can read it without a cycle.
+ */
+
+import { escapeHtml } from "../formatting.js";
+import type { ReportFormatter } from "../../presentation/reports.js";
+
+/** Telegram hard-caps a message at 4096 characters; this leaves headroom. */
+export const TELEGRAM_MESSAGE_MAX = 3800;
+
+export const TELEGRAM_REPORTS: ReportFormatter = {
+  bold: (s) => `<b>${s}</b>`,
+  italic: (s) => `<i>${s}</i>`,
+  // Telegram has one italic tag; Discord spells this one `*…*`.
+  emphasis: (s) => `<i>${s}</i>`,
+  code: (s) => `<code>${s}</code>`,
+  escape: escapeHtml,
+  lineLimit: TELEGRAM_MESSAGE_MAX,
+  metricLabelMax: 80,
+  pulseLabel: "Pulse:",
+};