talon-agent 4.6.1 → 5.0.1

package/src/frontend/native/{empty-chat-sweep.ts → chats/empty-chat-sweep.ts}

@@ -15,11 +15,11 @@
  * means the removal is broadcast, so open lists update in place.
  */
 
-import { log, logError } from "../../util/log.js";
-import { getRecentHistory } from "../../storage/history.js";
+import { log, logError } from "../../../util/log.js";
+import { getRecentHistory } from "../../../storage/history.js";
 import { deleteChat } from "./chat-lifecycle.js";
-import type { NativeRuntime } from "./runtime.js";
-import { isBusy } from "./turn.js";
+import type { NativeRuntime } from "../runtime.js";
+import { isBusy } from "../turn/turn.js";
 
 const EMPTY_CHAT_MIN_AGE_MS = 60 * 60_000;
 const EMPTY_CHAT_SWEEP_INTERVAL_MS = 30 * 60_000;

package/src/frontend/native/{history.ts → chats/history.ts}

@@ -10,19 +10,19 @@ import {
   searchHistoryMessages,
   type HistoryMessage,
   type MessageAttachment,
-} from "../../storage/history.js";
-import { isDeliveryTool } from "../../core/tools/index.js";
+} from "../../../storage/history.js";
+import { isDeliveryTool } from "../../../core/tools/index.js";
 import type { ChatEntry } from "./chats.js";
-import { refreshContext } from "./context.js";
-import { contentTypeFor, rehydrateAttachment } from "./media.js";
+import { refreshContext } from "../turn/context.js";
+import { contentTypeFor, rehydrateAttachment } from "../media/media.js";
 import {
   historyToClientMessage,
   type ClientAttachment,
   type ClientMessage,
   type SearchResult,
-} from "./protocol.js";
-import type { NativeRuntime } from "./runtime.js";
-import { getTurnMeta } from "./turn-meta.js";
+} from "../protocol.js";
+import type { NativeRuntime } from "../runtime.js";
+import { getTurnMeta } from "../turn/turn-meta.js";
 
 export type HistoryPageOptions = { before?: number; limit?: number };
 

package/src/frontend/native/{reset.ts → chats/reset.ts}

@@ -3,14 +3,14 @@
  * cached readouts, pulse checkpoint) while keeping the chat itself.
  */
 
-import { resetSession } from "../../storage/sessions.js";
-import { clearHistory } from "../../storage/history.js";
-import { resetPulseCheckpoint } from "../../core/background/pulse.js";
-import { getBackendForChat } 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/pulse.js";
+import { getBackendForChat } from "../../../core/engine/backend-controller/index.js";
 import { broadcastChatUpdated } from "./chat-wire.js";
-import { emitSystem } from "./emit.js";
-import type { NativeRuntime } from "./runtime.js";
-import { clearTurnMeta } from "./turn-meta.js";
+import { emitSystem } from "../turn/emit.js";
+import type { NativeRuntime } from "../runtime.js";
+import { clearTurnMeta } from "../turn/turn-meta.js";
 
 /**
  * Forget everything the conversation accumulated. Shared by the explicit

package/src/frontend/native/index.ts

@@ -18,18 +18,21 @@ import type { TalonConfig } from "../../core/config/index.js";
 import type { ContextManager } from "../../core/types.js";
 import type { Gateway } from "../../core/engine/gateway.js";
 import { log, logError } from "../../util/log.js";
-import { createNativeActionHandler } from "./actions.js";
-import { loadOrCreateBridgeToken } from "./auth.js";
-import { warmContextCache } from "./context.js";
-import { removeBridgeDiscovery, writeBridgeDiscovery } from "./discovery.js";
-import { emitAssistant, emitPhoto } from "./emit.js";
-import { startEmptyChatSweep } from "./empty-chat-sweep.js";
-import { buildBridgeHandlers } from "./handlers.js";
+import { createNativeActionHandler } from "./turn/actions.js";
+import { loadOrCreateBridgeToken } from "./bridge/auth.js";
+import { warmContextCache } from "./turn/context.js";
+import {
+  removeBridgeDiscovery,
+  writeBridgeDiscovery,
+} from "./bridge/discovery.js";
+import { emitAssistant, emitPhoto } from "./turn/emit.js";
+import { startEmptyChatSweep } from "./chats/empty-chat-sweep.js";
+import { buildBridgeHandlers } from "./surface/handlers.js";
 import { createNativeRuntime, type NativeRuntime } from "./runtime.js";
-import { BridgeServer } from "./server.js";
-import { isLoopbackHost, loadOrCreateBridgeTlsIdentity } from "./tls.js";
+import { BridgeServer } from "./bridge/server.js";
+import { isLoopbackHost, loadOrCreateBridgeTlsIdentity } from "./bridge/tls.js";
 
-export { summarizeToolResult } from "./tool-result.js";
+export { summarizeToolResult } from "./turn/tool-result.js";
 
 export type NativeFrontend = {
   name: "native";

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

@@ -9,9 +9,9 @@ import { mkdir, unlink } from "node:fs/promises";
 import { basename, extname, join } from "node:path";
 import { pipeline } from "node:stream/promises";
 import type { Readable } from "node:stream";
-import { dirs } from "../../util/paths.js";
-import type { ClientAttachment } from "./protocol.js";
-import type { NativeRuntime } from "./runtime.js";
+import { dirs } from "../../../util/paths.js";
+import type { ClientAttachment } from "../protocol.js";
+import type { NativeRuntime } from "../runtime.js";
 
 /**
  * Upload ceiling. Bodies stream straight to disk, so this bounds what a

package/src/frontend/native/runtime.ts

@@ -11,7 +11,7 @@
 import type { TalonConfig } from "../../core/config/index.js";
 import type { Gateway } from "../../core/engine/gateway.js";
 import { getMeshService, type MeshService } from "../../core/mesh/index.js";
-import { NativeChats } from "./chats.js";
+import { NativeChats } from "./chats/chats.js";
 import type {
   BridgeEvent,
   ClientAttachment,

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

@@ -4,10 +4,10 @@
 
 import { dirname, resolve } from "node:path";
 import { spawn } from "node:child_process";
-import { isBunRuntime } from "../../util/runtime.js";
-import { logError } from "../../util/log.js";
-import { PKG_ROOT } from "../../cli/context.js";
-import { forceDream } from "../../core/background/dream.js";
+import { isBunRuntime } from "../../../util/runtime.js";
+import { logError } from "../../../util/log.js";
+import { PKG_ROOT } from "../../../cli/context.js";
+import { forceDream } from "../../../core/background/dream/index.js";
 
 /**
  * Restart the daemon by spawning a detached `talon restart` — the same

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 "../../presentation/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 "../../presentation/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 "../../../core/weaver/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 → presentation}/format.ts

@@ -1,9 +1,10 @@
 /**
  * Frontend-agnostic display formatters shared by all chat frontends.
  *
- * These were previously duplicated per-frontend (telegram/helpers/format.ts,
- * discord/helpers.ts) and had started to drift — parseInterval accepted days
- * on Discord but not Telegram. One definition here keeps them in lockstep.
+ * These were previously duplicated per-frontend (the old
+ * telegram/helpers/format.ts, discord/helpers.ts) and had started to drift —
+ * parseInterval accepted days on Discord but not Telegram. One definition
+ * here keeps them in lockstep; frontends import this module directly.
  */
 
 import { resolveModel } from "../../core/models/catalog.js";

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

@@ -8,9 +8,21 @@ import type { TalonConfig } from "../../core/config/index.js";
 import {
   normalizeReasoningLevels,
   supportsReasoningLevel,
+  REASONING_LEVEL_DESCRIPTIONS,
 } from "../../core/models/reasoning-levels.js";
 export { supportsReasoningLevel };
 
+/**
+ * Effort-level descriptions shown next to each option in a picker.
+ *
+ * One home for both frontends: Discord renders them as select-menu
+ * descriptions, and anything else offering the same choice reads the
+ * same table rather than copying it.
+ */
+export const EFFORT_DESCRIPTIONS: Record<string, string> = {
+  ...REASONING_LEVEL_DESCRIPTIONS,
+};
+
 export type ActiveReasoningLevels = {
   activeModel: string | null;
   modelInfo?: UnifiedModelInfo;