talon-agent 5.0.0 → 5.0.1

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

@@ -20,14 +20,14 @@ 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

@@ -8,7 +8,7 @@
 
 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,
@@ -17,14 +17,14 @@ import {
 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";

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,17 +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 "../../shared/status-context.js";
+} from "../../presentation/status-context.js";
 import { stopCurrentTurn } from "../../../core/engine/dispatcher.js";
 import type { RegisterDeps } from "./state.js";
 

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

@@ -23,13 +23,15 @@ 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/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/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:",
+};

package/src/frontend/telegram/{helpers → render}/menu.ts

@@ -1,19 +1,49 @@
 /**
  * Settings + model-picker UI: settings text, the `/model` main/browse/backend
- * keyboards, effort rows, and the menu-state builder. All pure rendering.
+ * keyboards, effort rows, the model-option list, and the menu-state builder.
+ * All pure rendering.
+ *
+ * The settings body itself is `frontend/presentation/reports.ts`, rendered
+ * with Telegram's dialect; everything below it is inline-keyboard shape,
+ * which has no counterpart on Discord (Components, not keyboards).
  */
 
 import { escapeHtml } from "../formatting.js";
 import type { ReasoningEffortLevel } from "../../../core/types.js";
 import { REASONING_LEVEL_LABELS } from "../../../core/models/reasoning-levels.js";
-import { resolveModel, resolveModelId } from "../../../core/models/catalog.js";
 import {
-  DEFAULT_PULSE_INTERVAL_MS,
-  formatDuration,
-  formatModelLabel,
-  formatCompactModelLabel,
-  getTelegramModelOptions,
-} from "./format.js";
+  getModels,
+  resolveModel,
+  resolveModelId,
+  type ModelInfo,
+} from "../../../core/models/catalog.js";
+import { renderSettingsText as renderSettingsTextWith } from "../../presentation/reports.js";
+import { TELEGRAM_REPORTS } from "./html.js";
+
+/** Display name for a known ModelInfo. */
+export function formatModelOptionLabel(model: ModelInfo): string {
+  return model.displayName;
+}
+
+/** Compact display name for a known ModelInfo. */
+export function formatCompactModelLabel(model: ModelInfo): string {
+  return model.displayName;
+}
+
+/** One option per distinct display name, in catalog order. */
+export function getTelegramModelOptions(): ModelInfo[] {
+  const options: ModelInfo[] = [];
+  const seenKeys = new Set<string>();
+
+  for (const model of getModels()) {
+    const key = model.displayName.toLowerCase();
+    if (seenKeys.has(key)) continue;
+    seenKeys.add(key);
+    options.push(model);
+  }
+
+  return options;
+}
 
 export function renderSettingsText(
   model: string,
@@ -22,17 +52,14 @@ export function renderSettingsText(
   pulseIntervalMs?: number,
   modelDetails?: Array<string>,
 ): string {
-  const intervalStr = pulseIntervalMs
-    ? formatDuration(pulseIntervalMs)
-    : formatDuration(DEFAULT_PULSE_INTERVAL_MS);
-  return [
-    "<b>🦅 Settings</b>",
-    "",
-    `<b>Model:</b> <code>${escapeHtml(formatModelLabel(model))}</code>`,
-    ...(modelDetails?.length ? modelDetails.map(escapeHtml) : []),
-    `<b>Effort:</b> ${effort}`,
-    `<b>Pulse:</b> ${proactive ? "on" : "off"} (every ${intervalStr})`,
-  ].join("\n");
+  return renderSettingsTextWith(
+    TELEGRAM_REPORTS,
+    model,
+    effort,
+    proactive,
+    pulseIntervalMs,
+    modelDetails,
+  );
 }
 
 export function isSelectedModel(

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

@@ -0,0 +1,182 @@
+/**
+ * Metrics, doctor, mesh and usage reports for Telegram (HTML messages).
+ *
+ * The reports themselves live in `frontend/presentation/reports.ts` and
+ * the HTML dialect in `./html.ts`; this file is the wrappers that keep
+ * each command to a single import, plus the two Telegram-only pieces:
+ * the /metrics grain keyboard and the `/mesh` bridge footer.
+ */
+
+import { escapeHtml } from "../formatting.js";
+import type { DoctorReport } from "../../../core/doctor/index.js";
+import type { MeshPingResult } from "../../../core/mesh/service.js";
+import type { BackendUsageEntry } from "../../presentation/plan-usage-report.js";
+import type { SettingsButton } from "./menu.js";
+import {
+  renderDoctorReport,
+  renderMeshReport as renderMeshReportWith,
+  renderMetricsPanel as renderMetricsPanelWith,
+  renderUsageMessage as renderUsageMessageWith,
+  type MetricsSnapshot,
+} from "../../presentation/reports.js";
+import { TELEGRAM_MESSAGE_MAX, TELEGRAM_REPORTS } from "./html.js";
+
+/**
+ * Rows shown in the `tool_calls` leaderboard before the tail collapses
+ * into a "…and N more" line. A long-lived bot accumulates a lifetime
+ * tool-call entry per distinct tool name (easily 100+ once plugin and
+ * MCP tools are counted), which is what used to push /metrics past
+ * Telegram's message limit and split it across messages.
+ */
+const TOOL_CALLS_TOP_N = 12;
+
+/** Which grain the /metrics panel is currently showing. */
+export type MetricsView = "today" | "all";
+
+const VIEW_TITLES: Record<MetricsView, string> = {
+  today: "Metrics — today (UTC)",
+  all: "Metrics — all time",
+};
+
+/**
+ * Render the /metrics panel for one grain as a SINGLE Telegram message.
+ * Pair it with `renderMetricsKeyboard(view)` — the Today / All time
+ * buttons swap grains by editing this message in place.
+ */
+export function renderMetricsPanel(
+  metrics: MetricsSnapshot,
+  view: MetricsView,
+  maxLen = TELEGRAM_MESSAGE_MAX,
+): string {
+  return renderMetricsPanelWith(
+    metrics,
+    TELEGRAM_REPORTS,
+    VIEW_TITLES[view],
+    maxLen,
+    TOOL_CALLS_TOP_N,
+  );
+}
+
+/** Grain-switch buttons for the /metrics panel. */
+export function renderMetricsKeyboard(
+  view: MetricsView,
+): Array<Array<SettingsButton>> {
+  return [
+    [
+      {
+        text: view === "today" ? "✓ Today" : "Today",
+        callback_data: "metrics:today",
+      },
+      {
+        text: view === "all" ? "✓ All time" : "All time",
+        callback_data: "metrics:all",
+      },
+    ],
+  ];
+}
+
+/** Render the `/usage` report — one block per exposed backend. */
+export function renderUsageMessage(entries: BackendUsageEntry[]): string {
+  return renderUsageMessageWith(entries, TELEGRAM_REPORTS);
+}
+
+/**
+ * Render a DoctorReport as one Telegram HTML message. Same data as
+ * `talon doctor` (src/core/doctor/) plus in-process runtime info — when
+ * this renders, the bot is by definition running, so the CLI's "is the
+ * bot up" probe becomes an uptime line instead.
+ */
+export function renderDoctorMessage(report: DoctorReport): string {
+  return renderDoctorReport(report, TELEGRAM_REPORTS);
+}
+
+// ── /mesh ───────────────────────────────────────────────────────────────────
+
+/**
+ * Render the `/mesh` fleet report as one HTML message, with the bridge
+ * footer appended when the caller supplies reachability.
+ */
+export function renderMeshReport(
+  results: MeshPingResult[],
+  now = Date.now(),
+  bridge?: MeshReachability,
+): string {
+  // An empty fleet is the one case where "what do I point a device at?" is
+  // the only useful thing to say, so the bridge line carries the answer
+  // instead of leaving the operator to hunt for host and port.
+  return renderMeshReportWith(
+    results,
+    TELEGRAM_REPORTS,
+    now,
+    bridgeLines(bridge),
+  );
+}
+
+/** What `/mesh` says about the bridge a new device would dial. */
+export type MeshReachability =
+  | {
+      ok: true;
+      url: string;
+      authRequired: boolean;
+      token?: string;
+      fingerprint?: string;
+    }
+  | { ok: false; text: string };
+
+/**
+ * The bridge footer.
+ *
+ * The bearer token and certificate appear when the caller passed them, which
+ * `/mesh` does for the configured admin and not for anyone else: an operator
+ * asking their own daemon how to reach itself should get the answer, while a
+ * group member reading the fleet has no business holding the key to it.
+ */
+function bridgeLines(bridge?: MeshReachability): string[] {
+  if (!bridge) return [];
+  if (!bridge.ok) return ["", `<b>Bridge</b> — ${escapeHtml(bridge.text)}`];
+  const auth = bridge.authRequired ? "token required" : "no token";
+  return [
+    "",
+    `<b>Bridge</b> <code>${escapeHtml(bridge.url)}</code> · ${auth}`,
+    ...(bridge.token ? [`Token <code>${escapeHtml(bridge.token)}</code>`] : []),
+    ...(bridge.fingerprint
+      ? [`Certificate <code>${escapeHtml(bridge.fingerprint)}</code>`]
+      : []),
+    "Run <code>/mesh link</code> for a one-tap pairing link.",
+  ];
+}
+
+/**
+ * Render a minted pairing link, or why one couldn't be minted.
+ *
+ * The values are printed alongside the link because the link's whole payoff
+ * — the phone configuring itself — depends on the companion already being
+ * installed, and the fallback needs to be right there when it isn't.
+ */
+export function renderMeshPairLink(
+  minted:
+    | {
+        ok: true;
+        link: string;
+        url: string;
+        token: string;
+        fingerprint?: string;
+      }
+    | { ok: false; text: string },
+): string {
+  if (!minted.ok) {
+    return `<b>Pairing</b>\n\n${escapeHtml(minted.text)}`;
+  }
+  return [
+    "<b>Pair a device</b>",
+    "",
+    `Open on the phone: ${escapeHtml(minted.link)}`,
+    "",
+    "Single-use, expires in 10 minutes. If the companion isn't installed yet:",
+    `  Bridge <code>${escapeHtml(minted.url)}</code>`,
+    `  Token <code>${escapeHtml(minted.token)}</code>`,
+    ...(minted.fingerprint
+      ? [`  Certificate <code>${escapeHtml(minted.fingerprint)}</code>`]
+      : []),
+  ].join("\n");
+}

package/src/frontend/terminal/builtins/context.ts

@@ -7,9 +7,9 @@ import {
   apportionCells,
   type ContextBreakdown,
   type ContextSegmentKey,
-} from "../../shared/status-context.js";
+} from "../../presentation/status-context.js";
 import { getRecentHistory } from "../../../storage/history.js";
-import { formatTokenCount } from "../../shared/format.js";
+import { formatTokenCount } from "../../presentation/format.js";
 import { getChatSettings } from "../../../storage/chat-settings.js";
 import { resolveModelId as resolveModelName } from "../../../core/models/catalog.js";
 import { getSessionInfo } from "../../../storage/sessions.js";

package/src/frontend/terminal/builtins/session.ts

@@ -2,7 +2,7 @@
 
 import pc from "picocolors";
 import { formatTimeAgo } from "../renderer.js";
-import { isTerminalChatId } from "../../../util/chat-id.js";
+import { isTerminalChatId } from "../../../core/frontend-runtime/chat-id.js";
 import { resolveModel as coreResolveModel } from "../../../core/models/catalog.js";
 import {
   getAllSessions,

package/src/frontend/terminal/builtins/status.ts

@@ -5,12 +5,12 @@ import {
   buildCacheDisplay,
   buildContextDisplay,
   buildPlanDisplay,
-} from "../../shared/status-context.js";
+} from "../../presentation/status-context.js";
 import {
   formatDuration,
   formatTokenCount,
   formatUsd,
-} from "../../shared/format.js";
+} from "../../presentation/format.js";
 import { getChatSettings } from "../../../storage/chat-settings.js";
 import { getSessionInfo } from "../../../storage/sessions.js";
 import { getLoadedPlugins } from "../../../core/plugin/index.js";

package/src/frontend/terminal/index.ts

@@ -16,7 +16,7 @@ import { log } from "../../util/log.js";
 import {
   deriveNumericChatId,
   generateTerminalChatId,
-} from "../../util/chat-id.js";
+} from "../../core/frontend-runtime/chat-id.js";
 import { resolveModel } from "../../core/models/catalog.js";
 import { toolInputToRecord } from "../../core/agent-runtime/events.js";
 import { createRenderer } from "./renderer.js";
@@ -27,7 +27,7 @@ import {
   clearCommands,
   type CommandContext,
 } from "./commands.js";
-import { buildCacheDisplay } from "../shared/status-context.js";
+import { buildCacheDisplay } from "../presentation/status-context.js";
 
 // ── State ────────────────────────────────────────────────────────────────────
 

package/src/frontend/terminal/renderer.ts

@@ -7,7 +7,7 @@
  */
 
 import pc from "picocolors";
-import { formatUsd } from "../shared/format.js";
+import { formatUsd } from "../presentation/format.js";
 
 // ── Types ────────────────────────────────────────────────────────────────────
 

package/src/frontend/whatsapp/commands.ts

@@ -5,7 +5,7 @@
  * WhatsApp has no inline buttons, so everything Telegram does with a
  * picker is done here with typed arguments: `/model` prints a numbered
  * catalog, `/model 3` (or `/model <id>`, `/model <backend>`) picks from
- * it. The state changes come from frontend/shared/model-commands.ts;
+ * it. The state changes come from frontend/presentation/model-commands.ts;
  * this module only parses, authorises, and renders.
  *
  * Replies are written in Markdown — `sendText` translates them into
@@ -23,16 +23,16 @@ import {
   formatModelLabel,
   formatTokenCount,
   formatUsd,
-} from "../shared/format.js";
+} from "../presentation/format.js";
 import {
   collectSessionStatus,
   performSessionReset,
   type SessionStatusData,
-} from "../shared/session-status.js";
+} from "../presentation/session-status.js";
 import {
   formatCacheTempLine,
   formatDaemonLine,
-} from "../shared/status-context.js";
+} from "../presentation/status-context.js";
 import {
   describeChatEffort,
   describeChatModels,
@@ -45,7 +45,7 @@ import {
   switchChatBackend,
   type ModelCommandDeps,
   type ModelOverview,
-} from "../shared/model-commands.js";
+} from "../presentation/model-commands.js";
 import { sendText } from "./actions/send.js";
 import { identityAllowed, type Identity } from "./connection/identity.js";
 import type { WhatsAppChatInfo } from "./registry.js";

package/src/frontend/whatsapp/registry.ts

@@ -9,7 +9,7 @@
  */
 
 import { isJidGroup, jidNormalizedUser } from "baileys";
-import { deriveNumericChatId } from "../../util/chat-id.js";
+import { deriveNumericChatId } from "../../core/frontend-runtime/chat-id.js";
 import { bareId } from "./connection/identity.js";
 
 export type WhatsAppChatInfo = {

package/src/index.ts

@@ -3,12 +3,15 @@
  *
  * Dispatches the hidden `_mcp-launch` (MCP supervisor) and `_lua-run`
  * (WASM Lua trigger runner) subcommands BEFORE the app graph loads —
- * both are Talon re-invoking itself (see util/mcp-launcher.ts). The
+ * both are Talon re-invoking itself (see core/mcp-hub/launcher.ts). The
  * dynamic import keeps these helper processes light: they evaluate this
  * shim and their own module, never the backends/frontends/plugins.
  */
 
-import { MCP_LAUNCH_SUBCOMMAND, runSupervisor } from "./util/mcp-launcher.js";
+import {
+  MCP_LAUNCH_SUBCOMMAND,
+  runSupervisor,
+} from "./core/mcp-hub/launcher.js";
 import { LUA_RUN_SUBCOMMAND, runLuaMain } from "./core/scripts/lua.js";
 
 if (process.argv[2] === MCP_LAUNCH_SUBCOMMAND) {

package/src/util/runtime.ts

@@ -11,7 +11,7 @@
  *
  * Bun-COMPILED binaries are a third shape detected separately (argv[1]
  * points into the embedded virtual fs) — see the existing `$bunfs`
- * checks at the spawn sites and in `util/mcp-launcher.ts`.
+ * checks at the spawn sites and in `core/mcp-hub/launcher.ts`.
  */
 
 /** True when the current process is executing under the Bun runtime. */