mixdog 0.9.95 → 0.9.97

package/src/standalone/session-wire.mjs

@@ -0,0 +1,55 @@
+// Wire identity shared by the daemon's session transport and its views. Kept dependency-free
+// so both the host process and the client can read it without pulling in the
+// other side's module graph.
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import {
+  SESSION_CONFIGURE_ACTIONS,
+  SESSION_READ_ACTIONS,
+} from './session-protocol.mjs';
+
+/** Compatibility generation, not an application or capability version.
+ * Increment only for a rare, fundamentally incompatible wire rewrite. */
+export const SESSION_PROTOCOL = 1;
+
+/** Monotonic API index inside protocol 1. Increment when actions or payload
+ * shapes change. Newer clients replace older daemons; older clients attach to
+ * newer daemons and are normalized at the session boundary. */
+export const SESSION_REVISION = 1;
+
+/** Diagnostic-only action-surface identity. It never advances the protocol. */
+export const SESSION_CAPABILITY_FINGERPRINT = createHash('sha256')
+  .update(JSON.stringify({
+    read: SESSION_READ_ACTIONS,
+    configure: SESSION_CONFIGURE_ACTIONS,
+  }))
+  .digest('hex')
+  .slice(0, 16);
+
+let cachedVersion = null;
+
+function numericVersion(value) {
+  const match = String(value || '').match(/^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/);
+  return match ? match.slice(1).map(Number) : [0, 0, 0];
+}
+
+export function compareRuntimeVersions(left, right) {
+  const a = numericVersion(left);
+  const b = numericVersion(right);
+  for (let index = 0; index < 3; index += 1) {
+    if (a[index] !== b[index]) return a[index] - b[index];
+  }
+  return 0;
+}
+
+/** Build rank within one protocol generation. */
+export function runtimeVersion() {
+  if (cachedVersion) return cachedVersion;
+  try {
+    const manifest = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
+    cachedVersion = String(manifest?.version || '0.0.0');
+  } catch {
+    cachedVersion = '0.0.0';
+  }
+  return cachedVersion;
+}

package/src/tui/App.jsx

@@ -10,7 +10,7 @@
  *   queued steering prompts + rounded prompt input (one cluster)
  *   statusline (vendored L1/L2)
  *
- * State comes from the engine store via useEngine; submitting a line calls
+ * State comes from the session store via useSession; submitting a line calls
  * store.submit() (or handles a slash command locally). The whole tree is live
  * (no <Static>): full-width bands and the native hardware caret both need real
  * layout, which <Static> collapses. The terminal handles scrollback itself as
@@ -19,7 +19,7 @@
 import React, { useState, useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react';
 import { Box, Text, useApp, useInput, useStdin, useStdout } from 'ink';
 import { theme, surfaceBackground } from './theme.mjs';
-import { useEngine } from './hooks/useEngine.mjs';
+import { useSession } from './hooks/useSession.mjs';
 import { classifyToolCategory } from '../runtime/shared/tool-surface.mjs';
 import { localPackageVersion } from '../runtime/shared/update-checker.mjs';
 import { Spinner } from './components/Spinner.jsx';
@@ -42,16 +42,6 @@ import {
   splitPastedImagePathCandidates,
 } from './paste-attachments.mjs';
 import { formatDuration } from './time-format.mjs';
-import {
-  listProjects,
-  addProject,
-  touchProjectSelected,
-  renameProject,
-  isDirectory,
-  pathExists,
-  ensureDir,
-  resolveProjectPath,
-} from '../standalone/projects.mjs';
 import { pickFolder } from '../standalone/folder-dialog.mjs';
 import {
   formatHookDenialDetail,
@@ -100,6 +90,7 @@ import { usePromptDraftFlow } from './app/use-prompt-draft-flow.mjs';
 import { useTranscriptActivity } from './app/use-transcript-activity.mjs';
 import { createAppPickers } from './app/create-app-pickers.mjs';
 import { usePromptQueueHistory } from './app/use-prompt-queue-history.mjs';
+import { useMessageSelector } from './app/message-selector.mjs';
 import { useTerminalChrome } from './app/use-terminal-chrome.mjs';
 import { useTranscriptWindow } from './app/use-transcript-window.mjs';
 import {
@@ -120,6 +111,7 @@ import {
   transcriptMeasuredRowsCache,
   buildTranscriptRowIndex,
   transcriptRenderWindow,
+  transcriptSwapReturnsToTail,
 } from './app/transcript-window.mjs';
 import {
   SEARCH_DEFAULT_ROUTE,
@@ -265,7 +257,7 @@ function resolveOnboardingCompleted(store, onboardingCompleted) {
 }
 
 export function App({ store, initialStatusLine = '', forceOnboarding = false, onboardingCompleted = undefined }) {
-  const state = useEngine(store);
+  const state = useSession(store);
   const [toolOutputExpanded, setToolOutputExpanded] = useState(false);
   // True for the entire first-run onboarding wizard (every step + nested depth)
   // so the welcome banner stays reserved and the layout doesn't jump when the
@@ -326,6 +318,9 @@ export function App({ store, initialStatusLine = '', forceOnboarding = false, on
   // same glide back to the bottom.
   const followingRef = useRef(false);
   const lastItemsCountRef = useRef(0);
+  // Head item of the last committed transcript: a bulk swap (session load /
+  // clear / compaction trim) changes it, a live append never does.
+  const lastFirstItemIdRef = useRef(null);
   // picker = null | { type, title, items, onSelect }
   // Rendered as an option panel attached directly above the bottom prompt.
   const pickerOpenedFromEnterRef = useRef(false);
@@ -385,7 +380,7 @@ export function App({ store, initialStatusLine = '', forceOnboarding = false, on
   const [usagePanel, setUsagePanel] = useState(null);
   const usageRequestRef = useRef(0);
   // Cache of the last computed heavy settings-picker status objects (MCP,
-  // hooks, plugins, skills, channel backend). ←/→ cycle/toggle handlers in
+  // hooks, plugins, skills, channel provider). ←/→ cycle/toggle handlers in
   // openSettingsPicker() pass { light: true } to reuse this cache instead of
   // re-querying these heavy getters on every keystroke; only a full open
   // (initial /config or Esc-return) recomputes them.
@@ -413,10 +408,6 @@ export function App({ store, initialStatusLine = '', forceOnboarding = false, on
     setSettingsPrompt,
     setContextPanel,
     closeUsagePanel,
-    listProjects,
-    addProject,
-    touchProjectSelected,
-    resolveProjectPath,
     projectNameFromPath,
     pickFolder,
   });
@@ -429,9 +420,13 @@ export function App({ store, initialStatusLine = '', forceOnboarding = false, on
     initialPickerBuiltRef.current = true;
     const onboardingOwnsScreen = !resolveOnboardingCompleted(store, onboardingCompleted) || forceOnboarding;
     if (!onboardingOwnsScreen && state.items.length === 0) {
-      setPicker(projectPicker.buildProjectPickerState({ initialEntry: true }));
+      setPicker(projectPicker.buildProjectPickerState({ initialEntry: true, loading: true }));
     }
   }
+  useEffect(() => {
+    if (livePickerRef.current?._projectInitialPending !== true) return;
+    void projectPickerRef.current?.openProjectPicker({ initialEntry: true });
+  }, [store]);
   const {
     beginNewProject,
     registerProject,
@@ -793,12 +788,17 @@ export function App({ store, initialStatusLine = '', forceOnboarding = false, on
     const count = state.items.length;
     const previousCount = lastItemsCountRef.current;
     lastItemsCountRef.current = count;
-    if (count < previousCount || previousCount === 0) {
+    const firstId = count > 0 ? (state.items[0]?.id ?? null) : null;
+    const previousFirstId = lastFirstItemIdRef.current;
+    lastFirstItemIdRef.current = firstId;
+    // A bulk swap (compaction included) is an explicit return to the tail: the
+    // rows the reader was anchored to no longer exist.
+    if (transcriptSwapReturnsToTail({ count, previousCount, firstId, previousFirstId })) {
       resetTranscriptScroll();
       return;
     }
     if (count === previousCount || dragRef.current.active) return;
-  }, [state.items.length, resetTranscriptScroll]);
+  }, [state.items, resetTranscriptScroll]);
 
   // Exit + queued-restore + prompt history: app/use-prompt-queue-history.mjs.
   const {
@@ -823,6 +823,17 @@ export function App({ store, initialStatusLine = '', forceOnboarding = false, on
     promptHistoryNavRef,
   });
 
+  // Double-Esc message selector (Claude Code parity): app/message-selector.mjs.
+  const { hasUserMessages, openMessageSelector } = useMessageSelector({
+    store,
+    state,
+    setPicker,
+    setPromptDraftOverride,
+    syncPromptLayoutRows,
+    showPromptHint,
+    clearPromptHint,
+  });
+
   // PROMPT HANDLER cluster extracted to app/use-prompt-handlers.mjs.
   const {
     handlePromptPaste,
@@ -849,6 +860,7 @@ export function App({ store, initialStatusLine = '', forceOnboarding = false, on
     recentPromptHistory,
     resetPromptHistoryNav,
     restoreQueuedToPrompt,
+    openMessageSelector,
     usagePanel,
     closeUsagePanel,
     contextPanel,
@@ -1257,6 +1269,7 @@ export function App({ store, initialStatusLine = '', forceOnboarding = false, on
     handlePromptHistoryNavigate,
     handlePromptInterrupt,
     handlePromptPaste,
+    hasUserMessages,
     hookPrompt,
     initialStatusLine,
     onPromptDraftChange,

package/src/tui/app/app-format.mjs

@@ -8,7 +8,7 @@ import stringWidth from 'string-width';
 import { theme } from '../theme.mjs';
 import { formatToolSurface } from '../../runtime/shared/tool-surface.mjs';
 
-// SEARCH_DEFAULT marker — mirrors backend SEARCH_DEFAULT_PROVIDER/MODEL
+// SEARCH_DEFAULT marker — mirrors search defaults SEARCH_DEFAULT_PROVIDER/MODEL
 // (mixdog-session-runtime.mjs 1167-1168). A search route of {provider:'default',
 // model:'default'} means "follow the Main Model" at runtime (nativeSearchRoutes).
 export const SEARCH_DEFAULT_ROUTE = Object.freeze({ provider: 'default', model: 'default' });

package/src/tui/app/app-view.jsx

@@ -20,7 +20,7 @@ import { UsagePanel } from '../components/UsagePanel.jsx';
 import { TextEntryPanel } from '../components/TextEntryPanel.jsx';
 import { Item } from '../components/TranscriptItem.jsx';
 export function renderAppView(ctx) {
-  const { PANEL_MAX_VISIBLE, acceptSlashPalette, activeSlashQuery, activeTools, agentRevision, cancelChannelPrompt, cancelHookPrompt, cancelProviderPrompt, cancelSettingsPrompt, cancelSlashPalette, channelPrompt, clearPromptHint, completeSlashPalette, contextPanel, cycleWorkflowFromPrompt, exiting, expandedOptionPanel, floatingPanelRows, frameColumns, gridSelectionActiveRef, guardHintWidth, handlePromptEscape, handlePromptHistoryNavigate, handlePromptInterrupt, handlePromptPaste, hookPrompt, initialStatusLine, inputBoxHidden, inputHint, inputHintTone, liveSpinner, onPromptDraftChange, onSubmit, overlayHintAttachItemIndex, overlayHintBandRows, overlayHintFallbackRow, overlayHintOnLastItem, panelCloseMaskRows, panelInkMaskEpoch, panelTransitionClearRows, panelTransitionEpoch, picker, pickerOpenedFromEnterRef, pickerOpenedFromEnterTimerRef, pickerVisibleRows, promptBoxRectRef, promptBoxRows, promptDraft, promptDraftOverride, promptMetaVisible, promptMouseSelectionRef, promptSelectionRef, promptSpinnerColumns, promptValueRef, providerPrompt, queuedCompact, queuedVisible, renderedTranscriptItems, resizeEpoch, resizeState, restoreQueuedToPrompt, setPicker, setSlashIndex, setTextEntryLayoutRows, settingsPrompt, showWelcomeBanner, slashCommands, slashIndex, slashPaletteOpen, state, statuslineStats, store, toolApproval, toolOutputExpanded, transcriptContentHeight, transcriptGuardRows, transcriptMeasureRef, transcriptTailPinned, transcriptWindow, transientStatusWidth, tuiReady, usagePanel, viewportHeight, welcomePromptHintRows, welcomePromptHintText } = ctx; /* DESTRUCTURE */
+  const { PANEL_MAX_VISIBLE, acceptSlashPalette, activeSlashQuery, activeTools, agentRevision, cancelChannelPrompt, cancelHookPrompt, cancelProviderPrompt, cancelSettingsPrompt, cancelSlashPalette, channelPrompt, clearPromptHint, completeSlashPalette, contextPanel, cycleWorkflowFromPrompt, exiting, expandedOptionPanel, floatingPanelRows, frameColumns, gridSelectionActiveRef, guardHintWidth, handlePromptEscape, handlePromptHistoryNavigate, handlePromptInterrupt, handlePromptPaste, hasUserMessages, hookPrompt, initialStatusLine, inputBoxHidden, inputHint, inputHintTone, liveSpinner, onPromptDraftChange, onSubmit, overlayHintAttachItemIndex, overlayHintBandRows, overlayHintFallbackRow, overlayHintOnLastItem, panelCloseMaskRows, panelInkMaskEpoch, panelTransitionClearRows, panelTransitionEpoch, picker, pickerOpenedFromEnterRef, pickerOpenedFromEnterTimerRef, pickerVisibleRows, promptBoxRectRef, promptBoxRows, promptDraft, promptDraftOverride, promptMetaVisible, promptMouseSelectionRef, promptSelectionRef, promptSpinnerColumns, promptValueRef, providerPrompt, queuedCompact, queuedVisible, renderedTranscriptItems, resizeEpoch, resizeState, restoreQueuedToPrompt, setPicker, setSlashIndex, setTextEntryLayoutRows, settingsPrompt, showWelcomeBanner, slashCommands, slashIndex, slashPaletteOpen, state, statuslineStats, store, toolApproval, toolOutputExpanded, transcriptContentHeight, transcriptGuardRows, transcriptMeasureRef, transcriptTailPinned, transcriptWindow, transientStatusWidth, tuiReady, usagePanel, viewportHeight, welcomePromptHintRows, welcomePromptHintText } = ctx; /* DESTRUCTURE */
   const promptInputControl = (
     <PromptInput
       onSubmit={onSubmit}
@@ -47,6 +47,7 @@ export function renderAppView(ctx) {
       // actually be accepted — otherwise Enter must submit the raw text as
       // before instead of dead-ending in the palette accept path.
       commandPaletteActive={slashPaletteOpen && slashCommands.length > 0}
+      commandPaletteOpen={slashPaletteOpen}
       onCommandPaletteNavigate={(direction) => {
         setSlashIndex((index) => {
           const total = slashCommands.length;
@@ -65,7 +66,9 @@ export function renderAppView(ctx) {
       onCommandPaletteAccept={acceptSlashPalette}
       onCommandPaletteCancel={cancelSlashPalette}
       onCommandPaletteComplete={completeSlashPalette}
-      onRestoreQueued={(currentText) => restoreQueuedToPrompt({ restoreDraft: true, showHint: false, currentText })}
+      onRestoreQueued={restoreQueuedToPrompt}
+      hasQueuedMessages={Array.isArray(state.queued) && state.queued.length > 0}
+      hasMessages={hasUserMessages}
     />
   );
 

package/src/tui/app/channel-pickers.mjs

@@ -27,7 +27,7 @@ export function createChannelPickers({
   // a long first-time install finishing later must not hijack whatever
   // screen/picker the user has since navigated to.
   let pickerGen = 0;
-  const openChannelTypeActionsPicker = async (backend, options = {}) => {
+  const openChannelTypeActionsPicker = async (provider, options = {}) => {
     pickerGen += 1;
     const parentReturn = typeof options.returnTo === 'function'
       ? options.returnTo
@@ -43,15 +43,15 @@ export function createChannelPickers({
       store.pushNotice(`channels failed: ${e?.message || e}`, 'error');
       return;
     }
-    const isTelegram = backend === 'telegram';
-    const activeBackend = setup.backend || 'discord';
+    const isTelegram = provider === 'telegram';
+    const activeProvider = setup.provider || 'discord';
     const tokenDescription = isTelegram
       ? `${setup.telegram?.status ?? 'Off'}${setup.telegram?.problem ? ' · Invalid' : ''}`
       : `${setup.discord.status}${setup.discord.problem ? ' · Invalid' : ''}`;
     const mainEntry = setup.channel || {};
     const mainTarget = isTelegram
-      ? (mainEntry?.telegramChatId || (activeBackend === 'telegram' ? mainEntry?.channelId : ''))
-      : (mainEntry?.discordChannelId || (activeBackend === 'discord' ? mainEntry?.channelId : ''));
+      ? (mainEntry?.telegramChatId || (activeProvider === 'telegram' ? mainEntry?.channelId : ''))
+      : (mainEntry?.discordChannelId || (activeProvider === 'discord' ? mainEntry?.channelId : ''));
     const mainDescription = isTelegram
       ? (mainTarget ? `Chat ID ${mainTarget}` : 'Not set · Enter Telegram chat ID')
       : (mainTarget ? `Channel ID ${mainTarget}` : 'Not set · Enter Discord channel ID');
@@ -61,13 +61,13 @@ export function createChannelPickers({
       setContextPanel(null);
       setChannelPrompt({
         ...prompt,
-        afterSave: () => openChannelTypeActionsPicker(backend, options),
+        afterSave: () => openChannelTypeActionsPicker(provider, options),
       });
     };
 
     setPicker({
       title: isTelegram ? 'Telegram' : 'Discord',
-      description: activeBackend === backend
+      description: activeProvider === provider
         ? 'Active channel type · token and main target'
         : 'Token and main target settings',
       help: '↑/↓ Select · Enter Edit · Esc Back',
@@ -108,7 +108,7 @@ export function createChannelPickers({
           if (item._action === 'main-target') {
             openChannelPrompt({
               kind: 'channel-add',
-              backend,
+              provider,
               label: isTelegram ? 'Main chat' : 'Main channel',
               hint: isTelegram
                 ? 'Paste the Telegram chat ID.'
@@ -140,19 +140,19 @@ export function createChannelPickers({
       store.pushNotice(`channels failed: ${e?.message || e}`, 'error');
       return;
     }
-    const activeBackend = setup.backend || 'discord';
+    const activeProvider = setup.provider || 'discord';
     const mainEntry = setup.channel || {};
-    const typeDescription = (backend) => {
-      const selected = activeBackend === backend;
-      const hasToken = backend === 'telegram'
+    const typeDescription = (provider) => {
+      const selected = activeProvider === provider;
+      const hasToken = provider === 'telegram'
         ? setup.telegram?.authenticated === true
         : setup.discord?.authenticated === true;
-      const hasTarget = backend === 'telegram'
-        ? Boolean(mainEntry?.telegramChatId || (activeBackend === 'telegram' && mainEntry?.channelId))
-        : Boolean(mainEntry?.discordChannelId || (activeBackend === 'discord' && mainEntry?.channelId));
+      const hasTarget = provider === 'telegram'
+        ? Boolean(mainEntry?.telegramChatId || (activeProvider === 'telegram' && mainEntry?.channelId))
+        : Boolean(mainEntry?.discordChannelId || (activeProvider === 'discord' && mainEntry?.channelId));
       const needs = [
         ...(hasToken ? [] : ['token']),
-        ...(hasTarget ? [] : [backend === 'telegram' ? 'chat ID' : 'channel ID']),
+        ...(hasTarget ? [] : [provider === 'telegram' ? 'chat ID' : 'channel ID']),
       ];
       return [
         ...(selected ? ['Selected'] : []),
@@ -161,7 +161,7 @@ export function createChannelPickers({
     };
     setPicker({
       title: 'Channel Type Settings',
-      description: 'Choose a type. Selected is the active backend; Ready means token and main target are set.',
+      description: 'Choose a type. Selected is the active provider; Ready means token and main target are set.',
       help: '↑/↓ Select · Enter Open · Esc Back',
       indexMode: 'always',
       labelWidth: 18,
@@ -170,20 +170,20 @@ export function createChannelPickers({
           value: 'discord',
           label: 'Discord',
           description: typeDescription('discord'),
-          _backend: 'discord',
+          _provider: 'discord',
         },
         {
           value: 'telegram',
           label: 'Telegram',
           description: typeDescription('telegram'),
-          _backend: 'telegram',
+          _provider: 'telegram',
         },
       ],
       onSelect: (value, item) => {
-        const backend = item?._backend || (value === 'telegram' ? 'telegram' : value === 'discord' ? 'discord' : null);
-        if (!backend) return;
+        const provider = item?._provider || (value === 'telegram' ? 'telegram' : value === 'discord' ? 'discord' : null);
+        if (!provider) return;
         setPicker(null);
-        openChannelTypeActionsPicker(backend, {
+        openChannelTypeActionsPicker(provider, {
           returnTo: () => openChannelSettingTypePicker(options),
         });
       },
@@ -218,8 +218,8 @@ export function createChannelPickers({
     // Schedules/webhooks management is desktop-only (user decision): the TUI
     // no longer carries their pickers or the webhook-endpoint info page.
     const worker = await store.getChannelWorkerStatus?.();
-    const activeBackend = setup.backend === 'telegram' ? 'telegram' : 'discord';
-    const backendLabel = activeBackend === 'telegram' ? 'Telegram' : 'Discord';
+    const activeProvider = setup.provider === 'telegram' ? 'telegram' : 'discord';
+    const providerLabel = activeProvider === 'telegram' ? 'Telegram' : 'Discord';
     const remoteEnabled = (await store.isRemoteEnabled?.()) === true;
     const boolLabel = (enabled) => enabled ? 'On' : 'Off';
     // Onboarding Step 5 reuses this root picker with a ConfirmBar. Reopens after
@@ -237,25 +237,25 @@ export function createChannelPickers({
         .catch((e) => store.pushNotice(`Remote toggle failed: ${e?.message || e}`, 'error'))
         .finally(() => reopenRoot({ highlightValue }));
     };
-    const cycleChannelBackend = (direction = 1, highlightValue = 'channel-backend') => {
-      const backends = ['discord', 'telegram'];
-      const currentIndex = Math.max(0, backends.indexOf(activeBackend));
-      const chosen = backends[(currentIndex + direction + backends.length) % backends.length];
-      if (chosen === activeBackend) {
-        reopenRoot({ highlightValue, backendOverride: activeBackend });
+    const cycleChannelProvider = (direction = 1, highlightValue = 'channel-provider') => {
+      const providers = ['discord', 'telegram'];
+      const currentIndex = Math.max(0, providers.indexOf(activeProvider));
+      const chosen = providers[(currentIndex + direction + providers.length) % providers.length];
+      if (chosen === activeProvider) {
+        reopenRoot({ highlightValue, providerOverride: activeProvider });
         return;
       }
       try {
-        store.setBackend(chosen);
+        store.setChannelProvider(chosen);
         const label = chosen === 'telegram' ? 'Telegram' : 'Discord';
         const restartHint = (remoteEnabled || worker?.running)
           ? `Channel set to ${label}. Restart remote to apply.`
           : `Channel set to ${label}.`;
         store.pushNotice(restartHint, 'info');
       } catch (e) {
-        store.pushNotice(`channel backend failed: ${e?.message || e}`, 'error');
+        store.pushNotice(`channel provider failed: ${e?.message || e}`, 'error');
       }
-      reopenRoot({ highlightValue, backendOverride: chosen });
+      reopenRoot({ highlightValue, providerOverride: chosen });
     };
     // Voice toggle: enabling installs the managed whisper/ffmpeg runtime (first
     // time only) then flips voice.enabled so the channels pipeline transcribes
@@ -285,11 +285,11 @@ export function createChannelPickers({
         _action: 'remote-runtime',
       },
       {
-        value: 'channel-backend',
+        value: 'channel-provider',
         label: 'Channel',
-        meta: backendLabel,
+        meta: providerLabel,
         description: 'Select Discord or Telegram',
-        _action: 'channel-backend',
+        _action: 'channel-provider',
       },
       {
         value: 'channel-setting',
@@ -329,18 +329,18 @@ export function createChannelPickers({
       indexMode: 'always',
       labelWidth: 18,
       metaWidth: 12,
-      pickerKey: `channels:${activeBackend}:${remoteEnabled ? 'on' : 'off'}:${options.highlightValue || 'root'}`,
+      pickerKey: `channels:${activeProvider}:${remoteEnabled ? 'on' : 'off'}:${options.highlightValue || 'root'}`,
       initialIndex: Math.max(0, items.findIndex((entry) => entry.value === options.highlightValue)),
       items,
       confirmBar: options.confirmBar || null,
       onLeft: options.confirmBar ? undefined : (item) => {
         if (item?._action === 'remote-runtime') applyRemoteRuntime(item.value);
-        else if (item?._action === 'channel-backend') cycleChannelBackend(-1, item.value);
+        else if (item?._action === 'channel-provider') cycleChannelProvider(-1, item.value);
         else if (item?._action === 'voice') applyVoice(item.value);
       },
       onRight: options.confirmBar ? undefined : (item) => {
         if (item?._action === 'remote-runtime') applyRemoteRuntime(item.value);
-        else if (item?._action === 'channel-backend') cycleChannelBackend(1, item.value);
+        else if (item?._action === 'channel-provider') cycleChannelProvider(1, item.value);
         else if (item?._action === 'voice') applyVoice(item.value);
       },
       onSelect: (_value, item) => {
@@ -349,8 +349,8 @@ export function createChannelPickers({
             applyRemoteRuntime(item.value);
             return;
           }
-          if (item._action === 'channel-backend') {
-            cycleChannelBackend(1, item.value);
+          if (item._action === 'channel-provider') {
+            cycleChannelProvider(1, item.value);
             return;
           }
           if (item._action === 'voice') {

package/src/tui/app/core-memory-picker.mjs

@@ -39,20 +39,20 @@ export function createCoreMemoryPicker({
     });
     void store.memoryControl?.({ action: 'core', op: 'list', project_id: '*' }, { silent: true })
       .then(async (result) => {
-        // Memory on/off lives here too so /memory is a one-stop surface:
+        // The recap toggle lives here too so /memory is a one-stop surface:
         // toggle row + add row + curated entries.
-        const memory = (await store.getMemorySettings?.()) || { enabled: true };
-        const memoryOn = memory.enabled !== false;
+        const recap = (await store.getRecapSettings?.()) || { enabled: true };
+        const recapOn = recap.enabled !== false;
         const coreRows = parseMemoryCoreRows(result);
         const rows = [
           {
-            value: 'memory-toggle',
-            label: 'Memory',
-            meta: memoryOn ? 'On' : 'Off',
-            description: memoryOn
-              ? 'Background memory cycles on'
-              : 'Background memory cycles off',
-            _action: 'toggle-memory',
+            value: 'recap-toggle',
+            label: 'Recap',
+            meta: recapOn ? 'On' : 'Off',
+            description: recapOn
+              ? 'Background session recaps on'
+              : 'Background recaps off; core memory remains available',
+            _action: 'toggle-recap',
           },
           { value: 'core-add', label: 'Add Memory', description: 'store a new curated memory sentence', _action: 'add-core' },
           {
@@ -76,17 +76,17 @@ export function createCoreMemoryPicker({
           labelWidth: 12,
           footer: (item) => (item && item._action === 'core-entry' ? (item._summary || item._element || '') : ''),
           onSelect: (_value, item) => {
-            if (item?._action === 'toggle-memory') toggleMemoryEnabled();
+            if (item?._action === 'toggle-recap') toggleRecapEnabled();
             else if (item?._action === 'add-core') beginAddCoreMemory();
             else if (item?._action === 'core-list') openCoreMemoryListPicker(item._rows);
             else if (item?._line) store.pushNotice(item._line, 'info');
           },
           // Toggle rows also respond to ←/→ (matches settings/channels UX).
           onLeft: (item) => {
-            if (item?._action === 'toggle-memory') toggleMemoryEnabled();
+            if (item?._action === 'toggle-recap') toggleRecapEnabled();
           },
           onRight: (item) => {
-            if (item?._action === 'toggle-memory') toggleMemoryEnabled();
+            if (item?._action === 'toggle-recap') toggleRecapEnabled();
           },
           onCancel: closeMemoryCorePicker,
         });
@@ -137,14 +137,14 @@ export function createCoreMemoryPicker({
       });
   };
 
-  const toggleMemoryEnabled = async () => {
-    const memory = (await store.getMemorySettings?.()) || { enabled: true };
-    void Promise.resolve(store.setMemoryEnabled?.(!(memory.enabled !== false)))
+  const toggleRecapEnabled = async () => {
+    const recap = (await store.getRecapSettings?.()) || { enabled: true };
+    void Promise.resolve(store.setRecapEnabled?.(!(recap.enabled !== false)))
       .then((next) => {
-        if (!next) store.pushNotice('memory setting is busy', 'warn');
-        else store.pushNotice(`Memory ${next.enabled ? 'on' : 'off'}`, 'info');
+        if (!next) store.pushNotice('recap setting is busy', 'warn');
+        else store.pushNotice(`Recap ${next.enabled ? 'on' : 'off'}`, 'info');
       })
-      .catch((e) => store.pushNotice(`memory toggle failed: ${e?.message || e}`, 'error'))
+      .catch((e) => store.pushNotice(`recap toggle failed: ${e?.message || e}`, 'error'))
       .finally(() => openMemoryCorePicker());
   };
 

package/src/tui/app/doctor.mjs

@@ -138,18 +138,12 @@ export async function buildDoctorReport(runtime = {}, getState = () => ({})) {
     row(failed.length || conn < conf ? 'warn' : 'ok', detail);
   });
 
-  // 5. memory: enabled/disabled (+ backend health only if the accessor
-  //    already exposes it; no new probing).
+  // 5. memory recap: background-cycle state. Memory ingest, on-demand recall,
+  //    and curated core memory are always available.
   await check('memory', async (row) => {
-    const mem = runtime.getMemorySettings?.() || {};
-    const enabled = mem.enabled !== false;
-    let detail = enabled ? 'enabled' : 'disabled';
-    if (mem.backend) detail += ` · backend ${mem.backend}`;
-    const health = mem.backendHealth || mem.health;
-    if (health != null) {
-      detail += ` · ${typeof health === 'string' ? health : (health.ok ? 'healthy' : 'unhealthy')}`;
-    }
-    row(enabled ? 'ok' : 'warn', detail);
+    const recap = runtime.getRecapSettings?.() || {};
+    const enabled = recap.enabled !== false;
+    row('ok', `recap ${enabled ? 'enabled' : 'disabled'} · core memory available`);
   });
 
   // 6. channels: enabled + worker status + configured tokens (names only).

package/src/tui/app/input-parsers.mjs

@@ -139,7 +139,7 @@ export function parseMemoryCandidateRows(text) {
   // op:'candidates' returns this exact sentinel (index.mjs ~3158) when the
   // resolved scope has none — treat as an empty list, not an inert text row.
   if (!trimmed || /^core candidates:\s*none$/i.test(trimmed)) return [];
-  // Backend row shape (index.mjs ~3164), one candidate per line, no group
+  // Service row shape (index.mjs ~3164), one candidate per line, no group
   // headers:
   //   id=<n> project=<COMMON|slug> score=<x.xx|-> <element> — <summary> (<reason>)
   const rowPattern = /^id=(\d+)\s+project=(\S+)\s+score=(\S+)\s+(.+?)\s+—\s+(.+?)\s+\(([^)]*)\)$/;
@@ -171,7 +171,7 @@ export function parseMemoryCandidateRows(text) {
     });
 }
 
-// Backend "core" op errors are flattened to plain text by store.memoryControl
+// Service "core" operation errors are flattened to plain text by store.memoryControl
 // (isError is dropped -- see engine.mjs memoryControl / toolResponseText in
 // mixdog-session-runtime.mjs). Success text always uses a past-tense verb
 // ("core added/edited/deleted/promoted...", "core candidate dismissed...");