mixdog 1.3.5 → 1.4.0

package/src/standalone/session-service/session-calls/session-action.mjs

@@ -40,7 +40,7 @@ export function createSessionActionCalls(ctx) {
     responseSessionId,
   } = ctx;
   const { bodyForClient } = ctx.projection;
-  const { retainUnwatched } = ctx.retention;
+  const { retainUnwatched, awaitingApprovalSessionKinds, roomHandoffQuestions } = ctx.retention;
   const { assertAvailable, hostedEntryForSession, entryForSession } = ctx.entries;
 
   /** A cold session's review, read from its durable turn record (the same
@@ -111,6 +111,27 @@ export function createSessionActionCalls(ctx) {
     return result;
   }
 
+  /** Rows with `awaitingApproval` on every session whose live runtime shows an
+   *  approval card: a list row reads "needs you" from it whether or not any
+   *  pane receives that session's lane. A room member's row also carries the
+   *  handed-off questions it holds (`handoffQuestions`), which its room shows. */
+  function withApprovalWaits(rows) {
+    if (!Array.isArray(rows)) return rows;
+    const waiting = awaitingApprovalSessionKinds();
+    const questions = roomHandoffQuestions();
+    if (!waiting.size && !questions.size) return rows;
+    return rows.map((row) => {
+      const kind = waiting.get(row?.id);
+      const asked = questions.get(row?.id);
+      if (!kind && !asked) return row;
+      return {
+        ...row,
+        ...(kind ? { awaitingApproval: true, ...(kind === 'question' ? { awaitingQuestion: true } : {}) } : {}),
+        ...(asked ? { handoffQuestions: asked } : {}),
+      };
+    });
+  }
+
   async function listSessionCatalog(options = {}) {
     if (isClosed()) throw new Error('session service is closed');
     if (typeof listSessions !== 'function') {
@@ -124,7 +145,7 @@ export function createSessionActionCalls(ctx) {
     });
     // A `page: { limit, cursor }` request answers one page: { sessions, nextCursor }.
     const page = listed && !Array.isArray(listed) && Array.isArray(listed.sessions) ? listed : null;
-    const sessions = page ? page.sessions : listed;
+    const sessions = withApprovalWaits(page ? page.sessions : listed);
     const remoteSession = typeof getRemoteSessionState === 'function' ? await getRemoteSessionState() : null;
     const nextCursor = typeof page?.nextCursor === 'string' ? page.nextCursor : null;
     return {

package/src/standalone/session-service/session-calls/session-views.mjs

@@ -131,6 +131,14 @@ export function createSessionViewCalls(ctx) {
     notePrependViewer(viewer, params);
     const id = String(sessionId || '');
     if (!id) throw new TypeError('sessionId is required');
+    if (params.attachmentHistory === true) {
+      // Apart from every window: nothing here reads, fills or replaces a
+      // transcript projection.
+      const stored =
+        typeof readStoredSession === 'function' ? await readStoredSession(id, { attachmentHistory: true }) : null;
+      assertAvailable();
+      return { history: stored ? { items: stored.items } : null };
+    }
     const live = await liveEntryFor(id);
     assertAvailable(live);
     if (params.transcriptRange) {

package/src/standalone/session-tool-output.mjs

@@ -7,6 +7,8 @@ import { summarizeToolResult } from '../runtime/shared/tool-result-summary.mjs';
 import { TOOL_OUTPUT_PAGE_BYTES, TOOL_OUTPUT_TAIL_BYTES } from '../runtime/shared/tool-output-budget.mjs';
 
 export const SESSION_TOOL_OUTPUT_BYTES = TOOL_OUTPUT_TAIL_BYTES;
+// A session title as the session tool quotes it, listed or read.
+export const SESSION_TITLE_LIMIT = 160;
 const MESSAGE_TEXT_LIMIT = 2000;
 const LIST_PREVIEW_LIMIT = 100;
 const outputBytes = (value) => Buffer.byteLength(JSON.stringify(value), 'utf8');
@@ -15,24 +17,30 @@ const outputBytes = (value) => Buffer.byteLength(JSON.stringify(value), 'utf8');
  *  `rich` adds the owning bot, last activity, latest line and working state
  *  (never for a background caller: bot-status.mjs scopedBot). `rich` may be a
  *  per-row predicate: a bot gets them only for its own sessions. */
-export function sessionListOutput(page, limit, { rich = true } = {}) {
+export function sessionListOutput(page, limit, { rich = true, cursorOf = encodeCatalogCursor } = {}) {
   const raw = page.sessions;
   const sessions = raw.slice(0, limit).map((row) => {
     // Decided first: a session that is not the caller's carries its real
     // title only, never a preview standing in for it.
     const own = typeof rich === 'function' ? rich(row) : rich;
     const title = own ? row.title || row.preview : row.title;
+    // Live work, for every caller: its own turn or pool row (`working`)
+    // reads `running` whatever the settled catalog status; an Agent session
+    // working for it (`agentWorking`) marks it working too.
+    const status = row.working === true ? 'running' : row.status;
+    const working = row.working === true || row.agentWorking === true ? { working: true } : {};
     const base = {
       id: row.id,
-      ...(title ? { title: escapeHarnessTags(truncateToolText(title, 160)) } : {}),
-      ...(row.status ? { status: row.status } : {}),
+      ...(title ? { title: escapeHarnessTags(truncateToolText(title, SESSION_TITLE_LIMIT)) } : {}),
+      ...(status ? { status } : {}),
       ...(row.cwd ? { cwd: row.cwd } : {}),
       ...(row.archived === true ? { archived: true } : {}),
     };
-    if (!own) return base;
+    if (!own) return { ...base, ...working };
     // The bot it belongs to: its chat, room seat or the task's creator.
     const bot = sessionBotOf(row);
-    const lastUsedAt = Number(row.lastUsedAt) || 0;
+    // A live row's latest sign of work (`liveAt`) is newer than its last settled turn.
+    const lastUsedAt = Math.max(Number(row.lastUsedAt) || 0, Number(row.liveAt) || 0);
     const preview = String(row.lastMessagePreview || '').replace(/\s+/g, ' ');
     return {
       ...base,
@@ -40,7 +48,7 @@ export function sessionListOutput(page, limit, { rich = true } = {}) {
       ...(lastUsedAt ? { lastUsedAt: new Date(lastUsedAt).toISOString() } : {}),
       // The latest user or assistant line, quoted data.
       ...(preview.trim() ? { preview: escapeHarnessTags(truncateToolText(preview, LIST_PREVIEW_LIMIT)) } : {}),
-      ...(row.working === true || row.agentWorking === true ? { working: true } : {}),
+      ...working,
     };
   });
   const result = {
@@ -50,7 +58,7 @@ export function sessionListOutput(page, limit, { rich = true } = {}) {
   };
   for (;;) {
     if (sessions.length < raw.length && sessions.length) {
-      result.nextCursor = encodeCatalogCursor(raw[sessions.length - 1]);
+      result.nextCursor = cursorOf(raw[sessions.length - 1]);
     }
     if (outputBytes(result) <= TOOL_OUTPUT_PAGE_BYTES) return result;
     if (sessions.length <= 1) throw new Error('session: one catalog row exceeds the output budget');

package/src/tui/app/model-options.mjs

@@ -9,6 +9,7 @@ import { theme } from '../theme.mjs';
 import { displayModelName, effortDisplayLabel } from '../../runtime/shared/model-display.mjs';
 import { isRollingModelAlias } from '../../runtime/shared/model-alias.mjs';
 import { describeError } from '../../runtime/shared/error-presentation.mjs';
+import { providerDisplayName } from '../../runtime/shared/provider-display-name.mjs';
 import { DAYBREAK_PROVIDER, daybreakBlueOn } from '../../runtime/shared/llm/openai-daybreak.mjs';
 
 export const parsedModelVersion = (id) => {
@@ -165,34 +166,8 @@ export const normalizeModelOptions = (models) => {
   return normalized;
 };
 
-const PROVIDER_DISPLAY_NAMES = new Map([
-  ['openai-oauth', 'OpenAI OAuth'],
-  ['anthropic-oauth', 'Anthropic OAuth'],
-  ['grok-oauth', 'Grok OAuth'],
-  ['muse-code-oauth', 'Muse Code'],
-  ['command-code-oauth', 'Command Code'],
-  ['mimo-oauth', 'MiMo'],
-  ['cursor-oauth', 'Cursor OAuth'],
-  ['devin-oauth', 'Devin'],
-  ['antigravity-oauth', 'Antigravity OAuth'],
-  ['openai', 'OpenAI API'],
-  ['openai-api', 'OpenAI API'],
-  ['anthropic', 'Anthropic API'],
-  ['anthropic-api', 'Anthropic API'],
-  ['gemini', 'Gemini API'],
-  ['gemini-api', 'Gemini API'],
-  ['xai', 'xAI API'],
-  ['xai-api', 'xAI API'],
-  ['deepseek', 'DeepSeek API'],
-  ['deepseek-api', 'DeepSeek API'],
-  ['opencode-go-oauth', 'OpenCode Go OAuth'],
-  ['openrouter', 'OpenRouter'],
-  ['mixdog-local', 'Local Provider'],
-  ['default', 'Default'],
-]);
-
-export const providerDisplayName = (provider) =>
-  PROVIDER_DISPLAY_NAMES.get(String(provider || '').toLowerCase()) ?? (provider || 'Provider');
+// Provider display names live in runtime/shared so error text can name the provider too.
+export { providerDisplayName };
 
 export const resolveProviderDisplayName = (provider, providerNames = null) =>
   (String(provider || '')

package/src/tui/dist/index.mjs

@@ -24385,6 +24385,12 @@ var init_file_has_data = __esm({
   }
 });
 
+// src/runtime/shared/abort-race.mjs
+var init_abort_race = __esm({
+  "src/runtime/shared/abort-race.mjs"() {
+  }
+});
+
 // src/runtime/shared/bounded-download.mjs
 import { createWriteStream, rmSync as rmSync2 } from "node:fs";
 import { Transform as Transform2 } from "node:stream";
@@ -24458,7 +24464,7 @@ async function streamResponseToFile(response, destPath, { maxBytes, expectedByte
 var MAX_NATIVE_BINARY_DOWNLOAD_BYTES;
 var init_bounded_download = __esm({
   "src/runtime/shared/bounded-download.mjs"() {
-    init_sleep();
+    init_abort_race();
     MAX_NATIVE_BINARY_DOWNLOAD_BYTES = 256 * 1024 * 1024;
   }
 });
@@ -40971,16 +40977,7 @@ function summarizeCodeGraphResult({ text, translate }) {
   if (looksLikeZeroResultText(text)) return translate("No results", "No results");
   return null;
 }
-function summarizeFetchResult({ text, trimmed, args, normalized, translate }) {
-  if (normalized === "fetch") {
-    const a = parseToolArgs(args);
-    const isChannelFetch = !firstText(a.url, a.uri) && Boolean(firstText(a.channel, a.channelId, a.chatId, a.messageId) || a.limit != null);
-    if (isChannelFetch) {
-      const n = countNonEmptyLines(text);
-      if (trimmed && looksLineOriented(text) && n > 0) return countLabel(translate, n, "message");
-      return summarizeGenericResult(text, translate);
-    }
-  }
+function summarizeFetchResult({ text }) {
   const status = /(?:HTTP[\s/]*\d?\.?\d?\s*|status[:\s]+)([1-5]\d{2})\b/i.exec(text) || /\b([1-5]\d{2})\s+(?:OK|Not\s+Found|Forbidden|Moved|Found|Created|No\s+Content|Bad\s+Request|Unauthorized|Internal)/.exec(
     text
   );
@@ -42494,6 +42491,22 @@ function transportErrorText(error) {
   return `${TRANSPORT_SENTENCES[verdict.kind]}${detail ? ` (${detail})` : ""}.`;
 }
 
+// src/runtime/shared/provider-timeout-phase.mjs
+var TIMEOUT_PHASE = Object.freeze({
+  // The response headers did not arrive in the first-byte window.
+  HEADERS: "headers",
+  // The headers arrived, the first chunk did not.
+  FIRST_CHUNK: "first-chunk",
+  // A stream that already produced output went silent.
+  IDLE: "idle",
+  // A sign-in token refresh did not answer: an auth problem, not a slow model.
+  AUTH: "auth"
+});
+function isFirstByteTimeout(err) {
+  const phase = err?.timeoutPhase;
+  return phase === TIMEOUT_PHASE.HEADERS || phase === TIMEOUT_PHASE.FIRST_CHUNK;
+}
+
 // src/runtime/agent/orchestrator/providers/provider-error-kind.mjs
 var PROVIDER_ERROR_KINDS = Object.freeze([
   "overloaded",
@@ -43341,20 +43354,6 @@ function describeError(value) {
   };
 }
 
-// src/runtime/shared/provider-timeout-phase.mjs
-var TIMEOUT_PHASE = Object.freeze({
-  // The response headers did not arrive in the first-byte window.
-  HEADERS: "headers",
-  // The headers arrived, the first chunk did not.
-  FIRST_CHUNK: "first-chunk",
-  // A stream that already produced output went silent.
-  IDLE: "idle"
-});
-function isFirstByteTimeout(err) {
-  const phase = err?.timeoutPhase;
-  return phase === TIMEOUT_PHASE.HEADERS || phase === TIMEOUT_PHASE.FIRST_CHUNK;
-}
-
 // src/runtime/shared/err-text.mjs
 function errorHttpStatus(err) {
   return Number(err?.httpStatus || err?.status || err?.response?.status || 0) || 0;
@@ -43512,16 +43511,16 @@ function hasTypedEvidence(error) {
   if (!error || typeof error !== "object") return false;
   return Boolean(error.errorKind?.kind) || errorHttpStatus(error) > 0 || Boolean(error.code) || Boolean(error.retryAfterMs);
 }
-var timedOutMs = (text) => Number(/timed out after (\d+)ms/i.exec(text)?.[1]) || 0;
-function stillThinkingText(error, text) {
+var timedOutMs = (text) => Number(/(?:timed out after|within) (\d+)ms/i.exec(text)?.[1]) || 0;
+function stillThinkingText(error, text, providerLabel) {
   const ms = Number(error.waitedMs) || timedOutMs(text);
-  const provider = typeof error.providerLabel === "string" && error.providerLabel ? error.providerLabel : "the provider";
+  const provider = typeof providerLabel === "string" && providerLabel ? providerLabel : "the provider";
   const attempts = Number(error.attempts) > 0 ? `; attempts: ${Math.floor(Number(error.attempts))}` : "";
   return `Model still thinking: no output in ${formatDurationMs(ms)}; ${provider} sent nothing yet${attempts}.`;
 }
-function typedStreamFailureText(error, text) {
+function typedStreamFailureText(error, text, providerLabel) {
   if (!error || typeof error !== "object") return null;
-  if (isFirstByteTimeout(error)) return stillThinkingText(error, text);
+  if (isFirstByteTimeout(error)) return stillThinkingText(error, text, providerLabel);
   if (error.timeoutPhase === TIMEOUT_PHASE.IDLE) {
     const ms = timedOutMs(text);
     return ms > 0 ? `No progress ${formatDurationMs(ms)}.` : "No progress.";
@@ -43558,7 +43557,7 @@ function presentErrorText(error, options = {}) {
   if (embeddedError) text = embeddedError;
   text = oneLine(stripErrorPrefix(text));
   if (!text) return "Unknown error";
-  const streamFailure = typedStreamFailureText(error, text);
+  const streamFailure = typedStreamFailureText(error, text, options.providerLabel);
   if (streamFailure) return streamFailure;
   if (code === "PROVIDER_PREFIX_MUTATION" || name === "ProviderPrefixMutationError") {
     return "Session state changed unexpectedly.";
@@ -59516,6 +59515,34 @@ function isRollingModelAlias(id) {
   return /-latest$/i.test(String(id || "").trim());
 }
 
+// src/runtime/shared/provider-display-name.mjs
+var PROVIDER_DISPLAY_NAMES = /* @__PURE__ */ new Map([
+  ["openai-oauth", "OpenAI OAuth"],
+  ["anthropic-oauth", "Anthropic OAuth"],
+  ["grok-oauth", "Grok OAuth"],
+  ["muse-code-oauth", "Muse Code"],
+  ["command-code-oauth", "Command Code"],
+  ["mimo-oauth", "MiMo"],
+  ["cursor-oauth", "Cursor OAuth"],
+  ["devin-oauth", "Devin"],
+  ["antigravity-oauth", "Antigravity OAuth"],
+  ["openai", "OpenAI API"],
+  ["openai-api", "OpenAI API"],
+  ["anthropic", "Anthropic API"],
+  ["anthropic-api", "Anthropic API"],
+  ["gemini", "Gemini API"],
+  ["gemini-api", "Gemini API"],
+  ["xai", "xAI API"],
+  ["xai-api", "xAI API"],
+  ["deepseek", "DeepSeek API"],
+  ["deepseek-api", "DeepSeek API"],
+  ["opencode-go-oauth", "OpenCode Go OAuth"],
+  ["openrouter", "OpenRouter"],
+  ["mixdog-local", "Local Provider"],
+  ["default", "Default"]
+]);
+var providerDisplayName = (provider) => PROVIDER_DISPLAY_NAMES.get(String(provider || "").toLowerCase()) ?? (provider || "Provider");
+
 // src/runtime/shared/llm/openai-daybreak.mjs
 var DAYBREAK_PROVIDER = "openai-oauth";
 var DAYBREAK_PARAMETER_ID = "daybreak";
@@ -59663,32 +59690,6 @@ var normalizeModelOptions = (models) => {
   }
   return normalized;
 };
-var PROVIDER_DISPLAY_NAMES = /* @__PURE__ */ new Map([
-  ["openai-oauth", "OpenAI OAuth"],
-  ["anthropic-oauth", "Anthropic OAuth"],
-  ["grok-oauth", "Grok OAuth"],
-  ["muse-code-oauth", "Muse Code"],
-  ["command-code-oauth", "Command Code"],
-  ["mimo-oauth", "MiMo"],
-  ["cursor-oauth", "Cursor OAuth"],
-  ["devin-oauth", "Devin"],
-  ["antigravity-oauth", "Antigravity OAuth"],
-  ["openai", "OpenAI API"],
-  ["openai-api", "OpenAI API"],
-  ["anthropic", "Anthropic API"],
-  ["anthropic-api", "Anthropic API"],
-  ["gemini", "Gemini API"],
-  ["gemini-api", "Gemini API"],
-  ["xai", "xAI API"],
-  ["xai-api", "xAI API"],
-  ["deepseek", "DeepSeek API"],
-  ["deepseek-api", "DeepSeek API"],
-  ["opencode-go-oauth", "OpenCode Go OAuth"],
-  ["openrouter", "OpenRouter"],
-  ["mixdog-local", "Local Provider"],
-  ["default", "Default"]
-]);
-var providerDisplayName = (provider) => PROVIDER_DISPLAY_NAMES.get(String(provider || "").toLowerCase()) ?? (provider || "Provider");
 var resolveProviderDisplayName = (provider, providerNames = null) => String(provider || "").trim().startsWith("custom-") && providerNames?.[String(provider).trim()] || providerDisplayName(provider);
 var loadProviderDisplayNames = async (store) => {
   let setup = null;
@@ -62368,13 +62369,6 @@ function canonicalizeStoredChannelsConfig(value = {}) {
   const next = isPlainObject(value) ? { ...value } : {};
   delete next.promptInjection;
   delete next.schedules;
-  delete next.nonInteractive;
-  delete next.interactive;
-  delete next.backend;
-  delete next.provider;
-  delete next.discord;
-  delete next.telegram;
-  delete next.channel;
   return next;
 }
 function canonicalizeUnifiedConfig(value = {}) {

package/src/tui/session/agent-job-feed/model-notification.mjs

@@ -1,4 +1,5 @@
 import { readImageAttachmentFromPath } from '../../paste-attachments.mjs';
+import { PROMPT_ORIGIN_CHANNEL } from '../../../runtime/agent/orchestrator/session/manager/pending-message-entry.mjs';
 
 // Channel inbound images arrive as a JSON-array-of-paths meta value (stringified
 // across the notify IPC boundary). Parse defensively; a malformed value simply
@@ -44,6 +45,8 @@ export function createModelNotificationEnqueue({ chain, enqueue, getState, getDi
       priority: 'later',
       key: notificationKey || undefined,
       displayText: delivery.displayText || text,
+      // Its provenance (an inbound channel message) rides beside the mode.
+      ...(event?.origin === PROMPT_ORIGIN_CHANNEL ? { origin: PROMPT_ORIGIN_CHANNEL } : {}),
     };
     // Image load failed or overran its budget: still deliver the text body so
     // the notification is never silently lost.

package/src/tui/session/initial-state.mjs

@@ -26,6 +26,9 @@ export function createInitialSessionState({ runtime, runtimeCwd, baseRouteState
     queued: [],
     thinking: null,
     toolApproval: null,
+    // Approvals waiting behind the shown one (its own, and copies of sessions
+    // it delegated or handed work to): the dock's "1/N".
+    toolApprovalsWaiting: 0,
     // How the last approval ended and from which device, so every device can
     // say who answered ({ id, approved, device, at }).
     toolApprovalResult: null,

package/src/tui/session/notice-surface.mjs

@@ -40,6 +40,8 @@ export function createNoticeSurface({ getState, set, isDisposed, pushItem, repla
         : polishNoticeText(text);
     if (!value && !options.room) return null;
     const forceTranscript = options.transcript === true;
+    // A message posted from the stored record keeps its stored time.
+    const storedAt = Number.isFinite(options.at) ? options.at : null;
     if (!forceTranscript) return pushToast(value, tone, options.ttlMs, options);
     // The agent's own message posted outside a turn (agent-home-delivery.mjs):
     // its reply row, as the stored message restores.
@@ -50,8 +52,9 @@ export function createNoticeSurface({ getState, set, isDisposed, pushItem, repla
         id,
         text: value,
         streaming: false,
-        at: Date.now(),
+        at: storedAt ?? Date.now(),
         ...(options.messageId ? { messageId: options.messageId } : {}),
+        ...(options.posted ? { posted: true } : {}),
       });
       return id;
     }
@@ -85,6 +88,9 @@ export function createNoticeSurface({ getState, set, isDisposed, pushItem, repla
       // A held request of an unattended run (human-gate/held-message.mjs).
       ...(options.heldRequest ? { heldRequest: options.heldRequest } : {}),
       ...(options.messageId ? { messageId: options.messageId } : {}),
+      ...(storedAt !== null ? { at: storedAt } : {}),
+      // Posted outside any turn: its own turn key (transcript-turn-keys.mjs).
+      ...(options.posted ? { posted: true } : {}),
     });
     return id;
   };

package/src/tui/session/queue-helpers.mjs

@@ -4,7 +4,8 @@
  * flattening, session activity timestamps, and batch merging.
  */
 import { agentJobResultText, parseAgentJob, parseSyntheticAgentMessage } from './agent-envelope.mjs';
-import { attachmentTextForPart, isAttachmentReference } from '../../runtime/attachments/store.mjs';
+import { isAttachmentReference } from '../../runtime/attachments/store.mjs';
+import { promptContentText, sessionActivityTimestamp } from '../../runtime/shared/idle-auto-clear-gate.mjs';
 import { recognisedSlashToken } from '../app/slash-commands.mjs';
 
 const QUEUE_PRIORITY = { now: 0, next: 1, later: 2 };
@@ -82,47 +83,7 @@ export function notificationDisplayText(text) {
   return firstQueueLine(synthetic?.result || result || text) || 'agent notification';
 }
 
-export function promptContentText(content) {
-  if (typeof content === 'string') return content;
-  if (Array.isArray(content)) {
-    return content
-      .map((part) => {
-        if (typeof part === 'string') return part;
-        if (part?.type === 'text') return isAttachmentReference(part) ? attachmentTextForPart(part) : part.text || '';
-        if (part?.type === 'image') return '[Image]';
-        if (part?.type === 'file') return '[File]';
-        return part?.text || '';
-      })
-      .filter(Boolean)
-      .join('\n');
-  }
-  return String(content ?? '');
-}
-
-function timestampMs(value) {
-  if (value == null || value === '') return 0;
-  const n = Number(value);
-  if (Number.isFinite(n) && n > 0) return n;
-  const parsed = Date.parse(String(value));
-  return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
-}
-
-function hasModelVisibleConversation(session) {
-  const messages = Array.isArray(session?.messages) ? session.messages : [];
-  return messages.some((message) => {
-    const role = message?.role;
-    if (role !== 'user' && role !== 'assistant' && role !== 'tool') return false;
-    const text = promptContentText(message.content).trim();
-    if (role === 'user' && text.startsWith('<system-reminder>')) return false;
-    if (role === 'assistant' && text === '.' && !Array.isArray(message.toolCalls)) return false;
-    return !!text || role === 'assistant' || role === 'tool';
-  });
-}
-
-export function sessionActivityTimestamp(session, fallback = 0) {
-  if (!hasModelVisibleConversation(session)) return 0;
-  return timestampMs(session?.lastUsedAt) || timestampMs(session?.updatedAt) || timestampMs(fallback);
-}
+export { promptContentText, sessionActivityTimestamp };
 
 export function promptDisplayText(content, options = {}) {
   if (typeof options.displayText === 'string' && options.displayText.trim()) return options.displayText;

package/src/tui/session/session-api/routes-agent-definitions.mjs

@@ -2,6 +2,16 @@
  * routes-agent-definitions.mjs — the session route surface's passthroughs to
  * the runtime's agent, workflow-pack, connector and lead-identity services.
  */
+
+/** Mixy's status with `exists`, the one rule (mixy-presence.mjs) the desktop
+ *  answers from (main/mixy-first.ts). null when her routines cannot be read:
+ *  the status still serves readers of her name. */
+async function withMixyExists(status) {
+  if (!status || typeof status !== 'object') return status;
+  const { readMixyExists } = await import('../../../session-runtime/routine-owner.mjs');
+  return { ...status, exists: await readMixyExists(status).catch(() => null) };
+}
+
 export function createAgentDefinitionApi(runtime) {
   return {
     listAgents: () => {
@@ -53,8 +63,10 @@ export function createAgentDefinitionApi(runtime) {
     saveLeadPersona: async (text) => runtime.saveLeadPersona?.(text) ?? '',
     getLeadAgentBody: () => runtime.getLeadAgentBody?.() ?? '',
     saveLeadAgentBody: async (text) => runtime.saveLeadAgentBody?.(text) ?? '',
-    getLeadStatus: () =>
-      runtime.getLeadStatus?.() ?? { created: null, name: '', avatar: null, homeChatted: false, route: null },
+    getLeadStatus: async () =>
+      withMixyExists(
+        runtime.getLeadStatus?.() ?? { created: null, name: '', avatar: null, homeChatted: false, route: null }
+      ),
     getLeadHomeRoute: () => runtime.getLeadHomeRoute?.() ?? null,
     saveLeadIdentity: async (payload) => runtime.saveLeadIdentity?.(payload) ?? null,
     setLeadCreated: async (created, description) => runtime.setLeadCreated?.(created, description) ?? null,

package/src/tui/session/session-api/routes-write.mjs

@@ -54,14 +54,18 @@ const SESSION_ONLY_KEYS = new Set(['provider', 'model', 'effort', 'fast', 'autoE
  * the tuning, or both. Completed here, inside the serialized route write,
  * against the latest selected route — so a Fast-only change keeps the effort a
  * previous write selected. `unchanged` when it asks for nothing the selected
- * route does not already have.
+ * route does not already have and the session itself already runs that model
+ * (a fallback hop moves the session, not the selected route).
  */
 function completeSessionOnlyRequest(request, selected) {
   const named = Boolean(request.provider || request.model);
   const target = named ? request : { ...request, provider: selected.provider, model: selected.model };
   const sameModel = target.provider === selected.provider && target.model === selected.model;
   if (!sameModel) return { request: target, unchanged: false };
+  const sessionOnTarget =
+    !selected.sessionModel || (selected.sessionProvider === target.provider && selected.sessionModel === target.model);
   const unchanged =
+    sessionOnTarget &&
     Object.keys(request).every((key) => SESSION_ONLY_KEYS.has(key)) &&
     (request.effort === undefined || request.effort === selected.effort) &&
     (request.fast === undefined || request.fast === (selected.fast === true)) &&

package/src/tui/session/session-api/routes.mjs

@@ -128,6 +128,7 @@ export function createSessionRouteApi(bag) {
       return result;
     }),
     getOrchestrationMode: () => runtime.getOrchestrationMode(),
+    getConfiguredOrchestrationMode: () => runtime.getConfiguredOrchestrationMode(),
     setOrchestrationMode: withCommandLock(async (mode, options) => {
       const result = await runtime.setOrchestrationMode(mode, options);
       publishSessionSwitches(bag, { orchestrationModeSwitch: result?.orchestrationModeSwitch });

package/src/tui/session/session-api/settings.mjs

@@ -112,12 +112,28 @@ export function createSessionSettingsApi(bag) {
     setAiSessionTitles: withCommandLock(async (enabled) => {
       return await runtime.setAiSessionTitles?.(enabled);
     }),
+    getCacheWarmingSettings: () => {
+      return runtime.getCacheWarmingSettings?.() || { enabled: true };
+    },
+    setCacheWarmingEnabled: withCommandLock(async (enabled) => {
+      return await runtime.setCacheWarmingEnabled?.(enabled);
+    }),
     getHeartbeatSettings: () => {
-      return runtime.getHeartbeatSettings?.() || { heartbeat: true };
+      return runtime.getHeartbeatSettings?.() || { heartbeat: true, intervalMinutes: 60 };
     },
     setHeartbeatEnabled: withCommandLock(async (enabled) => {
       return await runtime.setHeartbeatEnabled?.(enabled);
     }),
+    setHeartbeatInterval: withCommandLock(async (minutes) => {
+      return await runtime.setHeartbeatInterval?.(minutes);
+    }),
+    // The desktop app reports the user's latest in-app input time: Mixy's
+    // heartbeat waits for 30 quiet minutes (mixy-heartbeat.mjs noteUserInput).
+    noteUserInput: async (at) => {
+      const { noteUserInput } = await import('../../../session-runtime/mixy-heartbeat.mjs');
+      noteUserInput(at);
+      return { ok: true };
+    },
     getReactionSettings: () => {
       return runtime.getReactionSettings?.() || { reactions: true };
     },

package/src/tui/session/session-flow/auto-clear.mjs

@@ -4,7 +4,7 @@
  * cleared-session UI once the active turn settles.
  */
 import { presentErrorText } from '../../../runtime/shared/err-text.mjs';
-import { sessionActivityTimestamp } from '../queue-helpers.mjs';
+import { idleAutoClearDue, sessionActivityTimestamp } from '../../../runtime/shared/idle-auto-clear-gate.mjs';
 import { archiveItemsForCompaction, compactionArchivedRows } from '../compaction-view.mjs';
 
 // Upper bound on the awaited idle compaction. Without a bound a stalled
@@ -17,29 +17,6 @@ import { archiveItemsForCompaction, compactionArchivedRows } from '../compaction
 const AUTO_CLEAR_COMPACT_TIMEOUT_MS = 60_000;
 const LATE_COMPLETION_NOTICE = 'auto-clear completed late; compacted conversation retained';
 
-// A zero is often an unavailable/stale meter field, not an authoritative
-// measurement. Do not let it mask the sibling live estimate.
-function contextUsageBelowThreshold(runtime, minContextPercent) {
-  if (!(minContextPercent > 0)) return false;
-  const status = runtime.contextStatus?.() || null;
-  const usedTokens = Math.max(
-    0,
-    Number(status?.usedTokens) || 0,
-    Number(status?.currentEstimatedTokens) || 0,
-    Number(status?.compaction?.currentEstimatedTokens) || 0
-  );
-  const triggerTokens = Number(
-    status?.compaction?.triggerTokens ||
-      status?.compaction?.autoCompactTokenLimit ||
-      runtime.session?.autoCompactTokenLimit ||
-      0
-  );
-  if (!Number.isFinite(usedTokens) || !Number.isFinite(triggerTokens) || !(usedTokens > 0 && triggerTokens > 0)) {
-    return true;
-  }
-  return (usedTokens / triggerTokens) * 100 < minContextPercent;
-}
-
 export function createAutoClearOps(bag, { reset, kickDrain }) {
   const {
     runtime,
@@ -140,15 +117,9 @@ export function createAutoClearOps(bag, { reset, kickDrain }) {
     const cfg = autoClearState();
     const now = Date.now();
     const activityAt = sessionActivityTimestamp(runtime.session, flags.lastUserActivityAt);
-    const idleMs = activityAt ? now - activityAt : 0;
-    const notIdle =
-      !cfg.enabled ||
-      getState().busy ||
-      (!ignorePending && pending.length > 0) ||
-      flags.autoClearRunning ||
-      flags.autoClearInFlight ||
-      idleMs < cfg.idleMs;
-    if (notIdle || contextUsageBelowThreshold(runtime, Number(cfg.minContextPercent ?? 10))) {
+    const blocked =
+      getState().busy || (!ignorePending && pending.length > 0) || flags.autoClearRunning || flags.autoClearInFlight;
+    if (blocked || !idleAutoClearDue({ cfg, activityAt, at: now, runtime })) {
       if (!activityAt) flags.lastUserActivityAt = now;
       return false;
     }