@cortexkit/opencode-magic-context 0.17.2 → 0.18.0

package/dist/index.js

@@ -15122,6 +15122,161 @@ var init_model_requirements = __esm(() => {
   };
 });
 
+// src/features/magic-context/overflow-detection.ts
+function extractErrorMessage(error51) {
+  if (!error51)
+    return "";
+  if (typeof error51 === "string")
+    return error51;
+  if (typeof error51 === "object") {
+    const obj = error51;
+    const nested = obj.error;
+    if (nested && typeof nested.message === "string" && nested.message.length > 0) {
+      return nested.message;
+    }
+  }
+  if (error51 instanceof Error)
+    return error51.message;
+  if (typeof error51 === "object") {
+    const obj = error51;
+    if (typeof obj.message === "string")
+      return obj.message;
+    if (typeof obj.responseBody === "string")
+      return obj.responseBody;
+    try {
+      return JSON.stringify(error51);
+    } catch {
+      return String(error51);
+    }
+  }
+  return String(error51);
+}
+function detectOverflow(error51) {
+  const message = extractErrorMessage(error51);
+  if (!message) {
+    return { isOverflow: false };
+  }
+  const hasStatus413 = /\b413\b/.test(message) && /(entity|payload|context|prompt)/i.test(message);
+  let matched;
+  for (const pattern of OVERFLOW_PATTERNS) {
+    if (pattern.test(message)) {
+      matched = pattern;
+      break;
+    }
+  }
+  if (!matched && !hasStatus413) {
+    return { isOverflow: false };
+  }
+  const reportedLimit = parseReportedLimit(message);
+  return {
+    isOverflow: true,
+    reportedLimit,
+    matchedPattern: matched?.source
+  };
+}
+function parseReportedLimit(message) {
+  if (!message)
+    return;
+  for (const pattern of LIMIT_EXTRACTION_PATTERNS) {
+    const match = message.match(pattern);
+    if (!match)
+      continue;
+    const raw = match[1];
+    if (!raw)
+      continue;
+    const value = Number.parseInt(raw, 10);
+    if (!Number.isFinite(value))
+      continue;
+    if (value < MIN_PLAUSIBLE_LIMIT || value > MAX_PLAUSIBLE_LIMIT)
+      continue;
+    return value;
+  }
+  return;
+}
+var OVERFLOW_PATTERNS, LIMIT_EXTRACTION_PATTERNS, MIN_PLAUSIBLE_LIMIT = 1024, MAX_PLAUSIBLE_LIMIT = 1e7;
+var init_overflow_detection = __esm(() => {
+  OVERFLOW_PATTERNS = [
+    /prompt is too long/i,
+    /input is too long for requested model/i,
+    /exceeds the context window/i,
+    /input token count.*exceeds the maximum/i,
+    /maximum prompt length is \d+/i,
+    /reduce the length of the messages/i,
+    /maximum context length is \d+ tokens/i,
+    /exceeds the limit of \d+/i,
+    /exceeds the available context size/i,
+    /greater than the context length/i,
+    /context window exceeds limit/i,
+    /exceeded model token limit/i,
+    /context[_ ]length[_ ]exceeded/i,
+    /request entity too large/i,
+    /context length is only \d+ tokens/i,
+    /input length.*exceeds.*context length/i,
+    /prompt too long; exceeded (?:max )?context length/i,
+    /too large for model with \d+ maximum context length/i,
+    /model_context_window_exceeded/i,
+    /context size has been exceeded/i
+  ];
+  LIMIT_EXTRACTION_PATTERNS = [
+    /maximum prompt length is (\d+)/i,
+    /maximum context length is (\d+) tokens?/i,
+    /context length is only (\d+) tokens?/i,
+    /exceeds the limit of (\d+)/i,
+    /too large for model with (\d+) maximum context length/i,
+    /context size.*(\d+) tokens?/i,
+    /exceeds? the context length of (\d+)/i,
+    /max(?:imum)?.*context.*?(\d+)/i
+  ];
+});
+
+// src/shared/resolve-fallbacks.ts
+function resolveFallbackChain(agentName, userFallbacks) {
+  const userList = normalizeUserFallbacks(userFallbacks);
+  if (userList.length > 0) {
+    return dedupe(userList.filter(isValidModelSpec));
+  }
+  const builtin = getAgentFallbackModels(agentName);
+  if (!builtin || builtin.length === 0)
+    return [];
+  return dedupe(builtin.filter(isValidModelSpec));
+}
+function normalizeUserFallbacks(userFallbacks) {
+  if (!userFallbacks)
+    return [];
+  if (typeof userFallbacks === "string") {
+    const trimmed = userFallbacks.trim();
+    return trimmed ? [trimmed] : [];
+  }
+  return userFallbacks.map((s) => s.trim()).filter((s) => s.length > 0);
+}
+function isValidModelSpec(spec) {
+  const slash = spec.indexOf("/");
+  return slash > 0 && slash < spec.length - 1;
+}
+function dedupe(list) {
+  const seen = new Set;
+  const out = [];
+  for (const item of list) {
+    if (seen.has(item))
+      continue;
+    seen.add(item);
+    out.push(item);
+  }
+  return out;
+}
+function parseProviderModel(spec) {
+  const slash = spec.indexOf("/");
+  if (slash < 1 || slash >= spec.length - 1)
+    return null;
+  return {
+    providerID: spec.slice(0, slash).trim(),
+    modelID: spec.slice(slash + 1).trim()
+  };
+}
+var init_resolve_fallbacks = __esm(() => {
+  init_model_requirements();
+});
+
 // src/shared/model-suggestion-retry.ts
 function extractMessage(error51) {
   if (typeof error51 === "string")
@@ -15177,6 +15332,9 @@ function parseModelSuggestion(error51) {
   };
 }
 async function promptWithTimeout(client, args, timeoutMs, signal) {
+  if (signal?.aborted) {
+    throw new Error("prompt aborted by external signal");
+  }
   const controller = new AbortController;
   const timeout = setTimeout(() => controller.abort(), timeoutMs);
   const onExternalAbort = () => controller.abort();
@@ -15199,16 +15357,39 @@ async function promptWithTimeout(client, args, timeoutMs, signal) {
     signal?.removeEventListener("abort", onExternalAbort);
   }
 }
-async function promptSyncWithModelSuggestionRetry(client, args, options = {}) {
-  const timeoutMs = options.timeoutMs ?? 300000;
+function isNonRetryable(error51, externalSignal) {
+  if (externalSignal?.aborted)
+    return true;
+  if (error51 instanceof Error) {
+    if (error51.name === "AbortError")
+      return true;
+    if (error51.message === "prompt aborted by external signal")
+      return true;
+    if (/^prompt timed out after \d+ms$/.test(error51.message))
+      return true;
+  }
+  if (detectOverflow(error51).isOverflow)
+    return true;
+  return false;
+}
+function shortErr(error51) {
+  if (error51 instanceof Error) {
+    return error51.name && error51.name !== "Error" ? `${error51.name}: ${error51.message}` : error51.message;
+  }
+  return extractMessage(error51);
+}
+async function attemptOnce(client, args, timeoutMs, signal, callContext, label) {
   try {
-    await promptWithTimeout(client, args, timeoutMs, options.signal);
+    await promptWithTimeout(client, args, timeoutMs, signal);
+    return;
   } catch (error51) {
+    if (isNonRetryable(error51, signal))
+      throw error51;
     const suggestion = parseModelSuggestion(error51);
     if (!suggestion || !args.body.model) {
       throw error51;
     }
-    log("[model-suggestion-retry] Model not found, retrying with suggestion", {
+    log(`[${callContext}] ${label}: model not found, retrying with suggestion`, {
       original: `${suggestion.providerID}/${suggestion.modelID}`,
       suggested: suggestion.suggestion
     });
@@ -15221,11 +15402,59 @@ async function promptSyncWithModelSuggestionRetry(client, args, options = {}) {
           modelID: suggestion.suggestion
         }
       }
-    }, timeoutMs, options.signal);
+    }, timeoutMs, signal);
   }
 }
+async function promptSyncWithModelSuggestionRetry(client, args, options = {}) {
+  const timeoutMs = options.timeoutMs ?? 300000;
+  const callContext = options.callContext ?? "subagent";
+  const fallbacks = options.fallbackModels ?? [];
+  const explicitPrimaryLabel = args.body.model?.providerID && args.body.model.modelID ? `${args.body.model.providerID}/${args.body.model.modelID}` : "primary";
+  let lastError = null;
+  try {
+    await attemptOnce(client, args, timeoutMs, options.signal, callContext, explicitPrimaryLabel);
+    return;
+  } catch (error51) {
+    lastError = error51;
+    if (isNonRetryable(error51, options.signal))
+      throw error51;
+    if (fallbacks.length === 0) {
+      throw error51;
+    }
+    log(`[${callContext}] primary (${explicitPrimaryLabel}) failed: ${shortErr(error51)}; trying ${fallbacks.length} fallback(s)`);
+  }
+  for (let i = 0;i < fallbacks.length; i += 1) {
+    const parsed = parseProviderModel(fallbacks[i]);
+    if (!parsed) {
+      log(`[${callContext}] skipping invalid fallback spec: ${fallbacks[i]}`);
+      continue;
+    }
+    const label = `${parsed.providerID}/${parsed.modelID}`;
+    const attemptArgs = {
+      ...args,
+      body: { ...args.body, model: parsed }
+    };
+    try {
+      await attemptOnce(client, attemptArgs, timeoutMs, options.signal, callContext, label);
+      log(`[${callContext}] fallback succeeded with ${label} (attempt ${i + 2}/${fallbacks.length + 1})`);
+      return;
+    } catch (error51) {
+      lastError = error51;
+      if (isNonRetryable(error51, options.signal))
+        throw error51;
+      const remaining = fallbacks.length - i - 1;
+      if (remaining > 0) {
+        log(`[${callContext}] ${label} failed: ${shortErr(error51)}; ${remaining} fallback(s) left`);
+      }
+    }
+  }
+  log(`[${callContext}] all models exhausted; tried: ${[explicitPrimaryLabel, ...fallbacks].join(", ")}; last error: ${shortErr(lastError)}`);
+  throw lastError ?? new Error("All fallback models failed");
+}
 var init_model_suggestion_retry = __esm(() => {
+  init_overflow_detection();
   init_logger();
+  init_resolve_fallbacks();
 });
 
 // src/shared/normalize-sdk-response.ts
@@ -15257,6 +15486,7 @@ var init_shared = __esm(() => {
   init_logger();
   init_model_requirements();
   init_model_suggestion_retry();
+  init_resolve_fallbacks();
 });
 
 // src/shared/record-type-guard.ts
@@ -160034,6 +160264,25 @@ var init_migrations = __esm(async () => {
                 WHERE type = 'tool' AND tool_owner_message_id IS NULL;
             `);
       }
+    },
+    {
+      version: 11,
+      description: "Add todo state synthesis columns to session_meta",
+      up: (db) => {
+        const cols = db.prepare("PRAGMA table_info(session_meta)").all();
+        if (!cols.some((c) => c.name === "last_todo_state")) {
+          db.exec("ALTER TABLE session_meta ADD COLUMN last_todo_state TEXT DEFAULT ''");
+        }
+        if (!cols.some((c) => c.name === "todo_synthetic_call_id")) {
+          db.exec("ALTER TABLE session_meta ADD COLUMN todo_synthetic_call_id TEXT DEFAULT ''");
+        }
+        if (!cols.some((c) => c.name === "todo_synthetic_anchor_message_id")) {
+          db.exec("ALTER TABLE session_meta ADD COLUMN todo_synthetic_anchor_message_id TEXT DEFAULT ''");
+        }
+        if (!cols.some((c) => c.name === "todo_synthetic_state_json")) {
+          db.exec("ALTER TABLE session_meta ADD COLUMN todo_synthetic_state_json TEXT DEFAULT ''");
+        }
+      }
     }
   ];
 });
@@ -160516,6 +160765,10 @@ CREATE INDEX IF NOT EXISTS idx_dream_queue_pending ON dream_queue(started_at, en
       note_nudge_trigger_message_id TEXT DEFAULT '',
       note_nudge_sticky_text TEXT DEFAULT '',
       note_nudge_sticky_message_id TEXT DEFAULT '',
+      last_todo_state TEXT DEFAULT '',
+      todo_synthetic_call_id TEXT DEFAULT '',
+      todo_synthetic_anchor_message_id TEXT DEFAULT '',
+      todo_synthetic_state_json TEXT DEFAULT '',
       is_subagent INTEGER DEFAULT 0,
       last_context_percentage REAL DEFAULT 0,
       last_input_tokens INTEGER DEFAULT 0,
@@ -160580,6 +160833,10 @@ CREATE INDEX IF NOT EXISTS idx_dream_queue_pending ON dream_queue(started_at, en
   ensureColumn(db, "session_meta", "note_nudge_trigger_message_id", "TEXT DEFAULT ''");
   ensureColumn(db, "session_meta", "note_nudge_sticky_text", "TEXT DEFAULT ''");
   ensureColumn(db, "session_meta", "note_nudge_sticky_message_id", "TEXT DEFAULT ''");
+  ensureColumn(db, "session_meta", "last_todo_state", "TEXT DEFAULT ''");
+  ensureColumn(db, "session_meta", "todo_synthetic_call_id", "TEXT DEFAULT ''");
+  ensureColumn(db, "session_meta", "todo_synthetic_anchor_message_id", "TEXT DEFAULT ''");
+  ensureColumn(db, "session_meta", "todo_synthetic_state_json", "TEXT DEFAULT ''");
   ensureColumn(db, "session_meta", "note_last_read_at", "INTEGER DEFAULT 0");
   ensureColumn(db, "session_meta", "times_execute_threshold_reached", "INTEGER DEFAULT 0");
   ensureColumn(db, "session_meta", "compartment_in_progress", "INTEGER DEFAULT 0");
@@ -160644,6 +160901,10 @@ function healNullTextColumns(db) {
     ["note_nudge_trigger_message_id", ""],
     ["note_nudge_sticky_text", ""],
     ["note_nudge_sticky_message_id", ""],
+    ["last_todo_state", ""],
+    ["todo_synthetic_call_id", ""],
+    ["todo_synthetic_anchor_message_id", ""],
+    ["todo_synthetic_state_json", ""],
     ["system_prompt_hash", ""],
     ["stripped_placeholder_ids", ""],
     ["memory_block_cache", ""],
@@ -160749,7 +161010,7 @@ function isSessionMetaRow(row) {
   if (row === null || typeof row !== "object")
     return false;
   const r = row;
-  return typeof r.session_id === "string" && typeof r.last_response_time === "number" && isStringOrNull(r.cache_ttl) && typeof r.counter === "number" && typeof r.last_nudge_tokens === "number" && isStringOrNull(r.last_nudge_band) && isStringOrNull(r.last_transform_error) && typeof r.is_subagent === "number" && typeof r.last_context_percentage === "number" && typeof r.last_input_tokens === "number" && isNumberOrNull(r.times_execute_threshold_reached) && isNumberOrNull(r.compartment_in_progress) && (r.system_prompt_hash === null || typeof r.system_prompt_hash === "string" || typeof r.system_prompt_hash === "number") && isNumberOrNull(r.system_prompt_tokens) && isNumberOrNull(r.conversation_tokens) && isNumberOrNull(r.tool_call_tokens) && isNumberOrNull(r.cleared_reasoning_through_tag);
+  return typeof r.session_id === "string" && typeof r.last_response_time === "number" && isStringOrNull(r.cache_ttl) && typeof r.counter === "number" && typeof r.last_nudge_tokens === "number" && isStringOrNull(r.last_nudge_band) && isStringOrNull(r.last_transform_error) && typeof r.is_subagent === "number" && typeof r.last_context_percentage === "number" && typeof r.last_input_tokens === "number" && isNumberOrNull(r.times_execute_threshold_reached) && isNumberOrNull(r.compartment_in_progress) && (r.system_prompt_hash === null || typeof r.system_prompt_hash === "string" || typeof r.system_prompt_hash === "number") && isNumberOrNull(r.system_prompt_tokens) && isNumberOrNull(r.conversation_tokens) && isNumberOrNull(r.tool_call_tokens) && isNumberOrNull(r.cleared_reasoning_through_tag) && isStringOrNull(r.last_todo_state);
 }
 function getDefaultSessionMeta(sessionId) {
   return {
@@ -160769,7 +161030,8 @@ function getDefaultSessionMeta(sessionId) {
     systemPromptTokens: 0,
     conversationTokens: 0,
     toolCallTokens: 0,
-    clearedReasoningThroughTag: 0
+    clearedReasoningThroughTag: 0,
+    lastTodoState: ""
   };
 }
 function ensureSessionMetaRow(db, sessionId) {
@@ -160781,6 +161043,7 @@ function toSessionMeta(row) {
   const transformErrorRaw = typeof row.last_transform_error === "string" ? row.last_transform_error : "";
   const cacheTtlRaw = typeof row.cache_ttl === "string" && row.cache_ttl.length > 0 ? row.cache_ttl : "5m";
   const systemPromptHashRaw = row.system_prompt_hash == null ? "" : row.system_prompt_hash;
+  const lastTodoStateRaw = typeof row.last_todo_state === "string" ? row.last_todo_state : "";
   const numOrZero = (value) => typeof value === "number" ? value : 0;
   return {
     sessionId: row.session_id,
@@ -160799,7 +161062,8 @@ function toSessionMeta(row) {
     systemPromptTokens: numOrZero(row.system_prompt_tokens),
     conversationTokens: numOrZero(row.conversation_tokens),
     toolCallTokens: numOrZero(row.tool_call_tokens),
-    clearedReasoningThroughTag: numOrZero(row.cleared_reasoning_through_tag)
+    clearedReasoningThroughTag: numOrZero(row.cleared_reasoning_through_tag),
+    lastTodoState: lastTodoStateRaw
   };
 }
 var META_COLUMNS, BOOLEAN_META_KEYS;
@@ -160820,7 +161084,8 @@ var init_storage_meta_shared = __esm(() => {
     systemPromptTokens: "system_prompt_tokens",
     conversationTokens: "conversation_tokens",
     toolCallTokens: "tool_call_tokens",
-    clearedReasoningThroughTag: "cleared_reasoning_through_tag"
+    clearedReasoningThroughTag: "cleared_reasoning_through_tag",
+    lastTodoState: "last_todo_state"
   };
   BOOLEAN_META_KEYS = new Set(["isSubagent", "compartmentInProgress"]);
 });
@@ -160856,6 +161121,12 @@ function isPersistedNoteNudgeRow(row) {
   const r = row;
   return typeof r.note_nudge_trigger_pending === "number" && typeof r.note_nudge_trigger_message_id === "string" && typeof r.note_nudge_sticky_text === "string" && typeof r.note_nudge_sticky_message_id === "string";
 }
+function isPersistedTodoSyntheticAnchorRow(row) {
+  if (row === null || typeof row !== "object")
+    return false;
+  const r = row;
+  return typeof r.todo_synthetic_call_id === "string" && typeof r.todo_synthetic_anchor_message_id === "string" && typeof r.todo_synthetic_state_json === "string";
+}
 function isPersistedHistorianFailureRow(row) {
   if (row === null || typeof row !== "object")
     return false;
@@ -160978,6 +161249,29 @@ function setPersistedDeliveredNoteNudge(db, sessionId, text, messageId = "") {
 function clearPersistedNoteNudge(db, sessionId) {
   db.prepare("UPDATE session_meta SET note_nudge_trigger_pending = 0, note_nudge_trigger_message_id = '', note_nudge_sticky_text = '', note_nudge_sticky_message_id = '' WHERE session_id = ?").run(sessionId);
 }
+function getPersistedTodoSyntheticAnchor(db, sessionId) {
+  const result = db.prepare("SELECT todo_synthetic_call_id, todo_synthetic_anchor_message_id, todo_synthetic_state_json FROM session_meta WHERE session_id = ?").get(sessionId);
+  if (!isPersistedTodoSyntheticAnchorRow(result)) {
+    return null;
+  }
+  if (result.todo_synthetic_call_id.length === 0 || result.todo_synthetic_anchor_message_id.length === 0) {
+    return null;
+  }
+  return {
+    callId: result.todo_synthetic_call_id,
+    messageId: result.todo_synthetic_anchor_message_id,
+    stateJson: result.todo_synthetic_state_json
+  };
+}
+function setPersistedTodoSyntheticAnchor(db, sessionId, callId, messageId, stateJson) {
+  db.transaction(() => {
+    ensureSessionMetaRow(db, sessionId);
+    db.prepare("UPDATE session_meta SET todo_synthetic_call_id = ?, todo_synthetic_anchor_message_id = ?, todo_synthetic_state_json = ? WHERE session_id = ?").run(callId, messageId, stateJson, sessionId);
+  })();
+}
+function clearPersistedTodoSyntheticAnchor(db, sessionId) {
+  db.prepare("UPDATE session_meta SET todo_synthetic_call_id = '', todo_synthetic_anchor_message_id = '', todo_synthetic_state_json = '' WHERE session_id = ?").run(sessionId);
+}
 function getNoteLastReadAt(db, sessionId) {
   try {
     const result = db.prepare("SELECT note_last_read_at FROM session_meta WHERE session_id = ?").get(sessionId);
@@ -161130,7 +161424,7 @@ var init_resolve_subagent_fallback = __esm(async () => {
 
 // src/features/magic-context/storage-meta-session.ts
 function getOrCreateSessionMeta(db, sessionId) {
-  const result = db.prepare("SELECT session_id, last_response_time, cache_ttl, counter, last_nudge_tokens, last_nudge_band, last_transform_error, is_subagent, last_context_percentage, last_input_tokens, times_execute_threshold_reached, compartment_in_progress, system_prompt_hash, system_prompt_tokens, conversation_tokens, tool_call_tokens, cleared_reasoning_through_tag FROM session_meta WHERE session_id = ?").get(sessionId);
+  const result = db.prepare("SELECT session_id, last_response_time, cache_ttl, counter, last_nudge_tokens, last_nudge_band, last_transform_error, is_subagent, last_context_percentage, last_input_tokens, times_execute_threshold_reached, compartment_in_progress, system_prompt_hash, system_prompt_tokens, conversation_tokens, tool_call_tokens, cleared_reasoning_through_tag, last_todo_state FROM session_meta WHERE session_id = ?").get(sessionId);
   if (isSessionMetaRow(result)) {
     return toSessionMeta(result);
   }
@@ -161704,9 +161998,7 @@ function loadModelsDevMetadataFromFile() {
   try {
     const configPath = getOpencodeConfigPath();
     if (configPath && existsSync12(configPath)) {
-      let raw = readFileSync8(configPath, "utf-8");
-      raw = raw.replace(/"(?:[^"\\]|\\.)*"|\/\/.*$/gm, (match) => match.startsWith('"') ? match : "");
-      const config2 = JSON.parse(raw);
+      const config2 = parseJsonc(readFileSync8(configPath, "utf-8"));
       if (config2.provider && typeof config2.provider === "object") {
         for (const [providerId, provider2] of Object.entries(config2.provider)) {
           if (!provider2?.models || typeof provider2.models !== "object")
@@ -161778,6 +162070,7 @@ function getModelsDevContextLimit(providerID, modelID) {
 var RELOAD_INTERVAL_MS, apiCache = null, apiLoadedAt = 0, recentlySeenApiSizes, oscillationLogged = false, fileCache = null, fileLastAttempt = 0;
 var init_models_dev_cache = __esm(() => {
   init_data_path();
+  init_jsonc_parser();
   init_logger();
   RELOAD_INTERVAL_MS = 5 * 60 * 1000;
   recentlySeenApiSizes = new Set;
@@ -162125,7 +162418,8 @@ async function runHistorianPrompt(args) {
     timeoutMs,
     dumpLabel,
     modelOverride,
-    agentId = HISTORIAN_AGENT
+    agentId = HISTORIAN_AGENT,
+    fallbackModels
   } = args;
   let agentSessionId = null;
   try {
@@ -162152,7 +162446,11 @@ async function runHistorianPrompt(args) {
             ...modelOverride ? { model: modelOverride } : {},
             parts: [{ type: "text", text: prompt, synthetic: true }]
           }
-        }, { timeoutMs: timeoutMs ?? DEFAULT_HISTORIAN_TIMEOUT_MS });
+        }, {
+          timeoutMs: timeoutMs ?? DEFAULT_HISTORIAN_TIMEOUT_MS,
+          fallbackModels: modelOverride ? undefined : fallbackModels,
+          callContext: agentId === HISTORIAN_EDITOR_AGENT ? "historian:editor" : "historian"
+        });
         sessionLog(parentSessionId, `historian: prompt completed (attempt ${retryIndex + 1}/${MAX_HISTORIAN_RETRIES + 1})`);
         break;
       } catch (error51) {
@@ -163117,6 +163415,7 @@ Historian pass ${passCount + 1}, attempt ${passAttempt} started for messages ${c
         dumpLabelBase: `partial-recomp-${sessionId}-${chunk.startIndex}-${chunk.endIndex}-pass-${passCount + 1}`,
         timeoutMs: historianTimeoutMs,
         fallbackModelId: deps.fallbackModelId,
+        fallbackModels: deps.fallbackModels,
         twoPass: deps.historianTwoPass,
         callbacks: {
           onRepairRetry: async (error51) => {
@@ -164318,7 +164617,8 @@ async function runCompressorPass(args) {
     targetTokens,
     outputCount,
     outputDepth,
-    historianTimeoutMs
+    historianTimeoutMs,
+    fallbackModels
   } = args;
   const prompt = buildCompressorPrompt(compartments, currentTokens, targetTokens, outputDepth, outputCount);
   let agentSessionId = null;
@@ -164340,7 +164640,11 @@ async function runCompressorPass(args) {
         agent: HISTORIAN_AGENT2,
         parts: [{ type: "text", text: prompt, synthetic: true }]
       }
-    }, { timeoutMs: historianTimeoutMs ?? DEFAULT_HISTORIAN_TIMEOUT_MS });
+    }, {
+      timeoutMs: historianTimeoutMs ?? DEFAULT_HISTORIAN_TIMEOUT_MS,
+      fallbackModels,
+      callContext: "compressor"
+    });
     const messagesResponse = await client.session.messages({
       path: { id: agentSessionId },
       query: { directory }
@@ -164520,6 +164824,7 @@ ${chunk.text}`, { stateFilePath });
       dumpLabelBase: `incremental-${sessionId}-${chunk.startIndex}-${chunk.endIndex}`,
       timeoutMs: historianTimeoutMs,
       fallbackModelId: deps.fallbackModelId,
+      fallbackModels: deps.fallbackModels,
       twoPass: deps.historianTwoPass
     });
     if (!validatedPass.ok) {
@@ -164568,6 +164873,7 @@ No new compartments or facts were written. Check the historian model/output and
         directory: sessionDirectory,
         historyBudgetTokens: deps.historyBudgetTokens,
         historianTimeoutMs,
+        fallbackModels: deps.fallbackModels,
         minCompartmentRatio: deps.compressorMinCompartmentRatio,
         maxMergeDepth: deps.compressorMaxMergeDepth
       });
@@ -164756,6 +165062,7 @@ Historian pass ${passCount + 1}, attempt ${passAttempt} started for messages ${c
         dumpLabelBase: `recomp-${sessionId}-${chunk.startIndex}-${chunk.endIndex}-pass-${passCount + 1}`,
         timeoutMs: historianTimeoutMs,
         fallbackModelId: deps.fallbackModelId,
+        fallbackModels: deps.fallbackModels,
         twoPass: deps.historianTwoPass,
         callbacks: {
           onRepairRetry: async (error51) => {
@@ -164853,6 +165160,7 @@ Nothing was written.`;
         directory: sessionDirectory,
         historyBudgetTokens: deps.historyBudgetTokens,
         historianTimeoutMs,
+        fallbackModels: deps.fallbackModels,
         minCompartmentRatio: deps.compressorMinCompartmentRatio,
         maxMergeDepth: deps.compressorMaxMergeDepth
       });
@@ -165722,6 +166030,7 @@ function buildDreamTaskPrompt(task, args) {
 init_shared();
 init_assistant_message_extractor();
 init_logger();
+init_resolve_fallbacks();
 
 // src/features/magic-context/sidekick/core.ts
 var SIDEKICK_SYSTEM_PROMPT = `You are Sidekick, a focused memory-retrieval subagent for an AI coding assistant.
@@ -165741,6 +166050,7 @@ function stripThinkingBlocks(text) {
 
 // src/features/magic-context/sidekick/agent.ts
 async function runSidekick(deps) {
+  const fallbackModels = resolveFallbackChain(SIDEKICK_AGENT, deps.config.fallback_models);
   let agentSessionId = null;
   try {
     const createResponse = await deps.client.session.create({
@@ -165763,7 +166073,7 @@ async function runSidekick(deps) {
         system: deps.config.system_prompt?.trim() || deps.config.prompt?.trim() || SIDEKICK_SYSTEM_PROMPT,
         parts: [{ type: "text", text: deps.userMessage, synthetic: true }]
       }
-    }, { timeoutMs: deps.config.timeout_ms });
+    }, { timeoutMs: deps.config.timeout_ms, fallbackModels, callContext: "sidekick" });
     const messagesResponse = await deps.client.session.messages({
       path: { id: agentSessionId },
       query: { directory: deps.sessionDirectory ?? deps.projectPath }
@@ -166387,7 +166697,6 @@ function createLiveSessionState() {
 
 // src/index.ts
 init_conflict_warning_hook();
-
 // src/features/magic-context/dreamer/storage-dream-state.ts
 var getDreamStateStatements = new WeakMap;
 var setDreamStateStatements = new WeakMap;
@@ -166833,7 +167142,12 @@ If no promotions are warranted, return empty arrays. Always consume reviewed can
         system: DREAMER_SYSTEM_PROMPT,
         parts: [{ type: "text", text: prompt, synthetic: true }]
       }
-    }, { timeoutMs: Math.min(remainingMs, 5 * 60 * 1000), signal: abortController.signal });
+    }, {
+      timeoutMs: Math.min(remainingMs, 5 * 60 * 1000),
+      signal: abortController.signal,
+      fallbackModels: args.fallbackModels,
+      callContext: "dreamer:user-memories"
+    });
     const messagesResponse = await args.client.session.messages({
       path: { id: agentSessionId },
       query: { directory: args.sessionDirectory }
@@ -166892,7 +167206,8 @@ If no promotions are warranted, return empty arrays. Always consume reviewed can
     }
     return result;
   } catch (error51) {
-    log(`[dreamer] user-memories: review failed: ${getErrorMessage(error51)}`);
+    const errorDescription = describeError(error51);
+    log(`[dreamer] user-memories: review failed: ${errorDescription.brief}`, errorDescription.stackHead ? { stackHead: errorDescription.stackHead } : undefined);
     return result;
   } finally {
     clearInterval(leaseInterval);
@@ -166923,6 +167238,7 @@ function insertDreamRun(db, run) {
 
 // src/features/magic-context/dreamer/runner.ts
 var dreamProjectDirectories = new Map;
+var CIRCUIT_BREAKER_THRESHOLD = 3;
 function registerDreamProjectDirectory(projectIdentity, directory) {
   dreamProjectDirectories.set(projectIdentity, directory);
 }
@@ -166939,6 +167255,25 @@ function countNewIds(beforeIds, afterIds) {
   }
   return count;
 }
+function getCircuitBreakerSignature(error51, brief) {
+  if (error51 instanceof Error && error51.name && error51.name !== "Error") {
+    return error51.name;
+  }
+  const namedError = error51;
+  if (namedError && typeof namedError === "object" && typeof namedError.name === "string" && namedError.name.length > 0 && namedError.name !== "Error") {
+    return namedError.name;
+  }
+  return brief.split(":")[0]?.trim().split(/\s+/)[0] || brief || "unknown";
+}
+function shouldSkipCircuitBreaker(error51, brief) {
+  const namedError = error51;
+  const name2 = error51 instanceof Error ? error51.name : namedError && typeof namedError === "object" && typeof namedError.name === "string" ? namedError.name : "";
+  const combined = `${name2} ${brief}`.toLowerCase();
+  return name2 === "AbortError" || combined.includes("lease");
+}
+function logWithStackHead(message, stackHead) {
+  log(message, stackHead ? { stackHead } : undefined);
+}
 function getOpenCodeDbPath2() {
   return join13(getDataDir(), "opencode", "opencode.db");
 }
@@ -167044,7 +167379,12 @@ async function identifyKeyFilesForSession(args) {
           system: KEY_FILES_SYSTEM_PROMPT,
           parts: [{ type: "text", text: prompt, synthetic: true }]
         }
-      }, { timeoutMs: Math.min(remainingMs, 300000), signal: abortController.signal });
+      }, {
+        timeoutMs: Math.min(remainingMs, 300000),
+        signal: abortController.signal,
+        fallbackModels: args.fallbackModels,
+        callContext: `dreamer:key-files:${args.sessionId.slice(0, 12)}`
+      });
       const messagesResponse = await args.client.session.messages({
         path: { id: agentSessionId },
         query: { directory: args.sessionDirectory }
@@ -167117,6 +167457,7 @@ async function identifyKeyFiles(args) {
       parentSessionId: args.parentSessionId,
       sessionDirectory: args.sessionDirectory,
       holderId: args.holderId,
+      fallbackModels: args.fallbackModels,
       deadline: args.deadline,
       sessionId,
       config: args.config
@@ -167170,6 +167511,9 @@ async function runDream(args) {
   const deadline = startedAt + args.maxRuntimeMinutes * 60 * 1000;
   const lastDreamAt = getDreamState(args.db, `last_dream_at:${args.projectIdentity}`) ?? getDreamState(args.db, "last_dream_at");
   log(`[dreamer] last dream at: ${lastDreamAt ?? "never"} (project=${args.projectIdentity})`);
+  let lastErrorSignature = null;
+  let consecutiveSameErrorFailures = 0;
+  let circuitBreakerTripped = false;
   try {
     for (const taskName of args.tasks) {
       if (Date.now() > deadline) {
@@ -167230,7 +167574,9 @@ async function runDream(args) {
           }
         }, {
           timeoutMs: args.taskTimeoutMinutes * 60 * 1000,
-          signal: taskAbortController.signal
+          signal: taskAbortController.signal,
+          fallbackModels: args.fallbackModels,
+          callContext: `dreamer:${taskName}`
         });
         const messagesResponse = await args.client.session.messages({
           path: { id: agentSessionId },
@@ -167250,16 +167596,40 @@ async function runDream(args) {
           durationMs,
           result: taskResult
         });
+        lastErrorSignature = null;
+        consecutiveSameErrorFailures = 0;
       } catch (error51) {
         const durationMs = Date.now() - taskStartedAt;
-        const errorMsg = getErrorMessage(error51);
-        log(`[dreamer] task ${taskName}: failed after ${(durationMs / 1000).toFixed(1)}s — ${errorMsg}`);
+        const errorDescription = describeError(error51);
+        logWithStackHead(`[dreamer] task ${taskName}: failed after ${(durationMs / 1000).toFixed(1)}s — ${errorDescription.brief}`, errorDescription.stackHead);
         result.tasks.push({
           name: taskName,
           durationMs,
           result: null,
-          error: errorMsg
+          error: errorDescription.brief
         });
+        if (shouldSkipCircuitBreaker(error51, errorDescription.brief)) {
+          lastErrorSignature = null;
+          consecutiveSameErrorFailures = 0;
+        } else {
+          const signature = getCircuitBreakerSignature(error51, errorDescription.brief);
+          if (signature === lastErrorSignature) {
+            consecutiveSameErrorFailures += 1;
+          } else {
+            lastErrorSignature = signature;
+            consecutiveSameErrorFailures = 1;
+          }
+          if (consecutiveSameErrorFailures >= CIRCUIT_BREAKER_THRESHOLD) {
+            circuitBreakerTripped = true;
+            log(`[dreamer] circuit breaker: ${consecutiveSameErrorFailures} consecutive ${signature} failures — aborting remaining tasks`);
+            result.tasks.push({
+              name: "circuit-breaker",
+              durationMs: 0,
+              result: "",
+              error: `Aborted remaining tasks: ${consecutiveSameErrorFailures} consecutive ${signature} failures. Configure dreamer model/fallback_models in magic-context.jsonc.`
+            });
+          }
+        }
       } finally {
         clearInterval(leaseRenewalInterval);
         if (agentSessionId) {
@@ -167271,8 +167641,20 @@ async function runDream(args) {
           });
         }
       }
+      if (circuitBreakerTripped) {
+        break;
+      }
+    }
+    if (circuitBreakerTripped) {
+      log("[dreamer] circuit breaker: skipping post-task phases");
+      result.tasks.push({
+        name: "post-task-phases",
+        durationMs: 0,
+        result: "",
+        error: "Skipped post-task phases after circuit breaker tripped; configure dreamer model/fallback_models in magic-context.jsonc."
+      });
     }
-    if (args.experimentalUserMemories?.enabled && Date.now() <= deadline) {
+    if (!circuitBreakerTripped && args.experimentalUserMemories?.enabled && Date.now() <= deadline) {
       const umStart = Date.now();
       try {
         const reviewResult = await reviewUserMemories({
@@ -167282,7 +167664,8 @@ async function runDream(args) {
           sessionDirectory: args.sessionDirectory,
           holderId,
           deadline,
-          promotionThreshold: args.experimentalUserMemories.promotionThreshold
+          promotionThreshold: args.experimentalUserMemories.promotionThreshold,
+          fallbackModels: args.fallbackModels
         });
         const umOutput = `promoted=${reviewResult.promoted} merged=${reviewResult.merged} dismissed=${reviewResult.dismissed} consumed=${reviewResult.candidatesConsumed}`;
         if (reviewResult.promoted > 0 || reviewResult.merged > 0 || reviewResult.dismissed > 0) {
@@ -167294,16 +167677,17 @@ async function runDream(args) {
           result: umOutput
         });
       } catch (error51) {
-        log(`[dreamer] user-memory review failed: ${getErrorMessage(error51)}`);
+        const errorDescription = describeError(error51);
+        logWithStackHead(`[dreamer] user-memory review failed: ${errorDescription.brief}`, errorDescription.stackHead);
         result.tasks.push({
           name: "user memories",
           durationMs: Date.now() - umStart,
           result: "",
-          error: getErrorMessage(error51)
+          error: errorDescription.brief
         });
       }
     }
-    if (Date.now() <= deadline) {
+    if (!circuitBreakerTripped && Date.now() <= deadline) {
       try {
         await evaluateSmartNotes({
           db: args.db,
@@ -167313,13 +167697,15 @@ async function runDream(args) {
           sessionDirectory: args.sessionDirectory,
           holderId,
           deadline,
-          result
+          result,
+          fallbackModels: args.fallbackModels
         });
       } catch (error51) {
-        log(`[dreamer] smart note evaluation failed: ${getErrorMessage(error51)}`);
+        const errorDescription = describeError(error51);
+        logWithStackHead(`[dreamer] smart note evaluation failed: ${errorDescription.brief}`, errorDescription.stackHead);
       }
     }
-    if (args.experimentalPinKeyFiles?.enabled && Date.now() <= deadline) {
+    if (!circuitBreakerTripped && args.experimentalPinKeyFiles?.enabled && Date.now() <= deadline) {
       const kfStart = Date.now();
       try {
         await identifyKeyFiles({
@@ -167330,7 +167716,8 @@ async function runDream(args) {
           sessionDirectory: args.sessionDirectory ?? args.projectIdentity,
           holderId,
           deadline,
-          config: args.experimentalPinKeyFiles
+          config: args.experimentalPinKeyFiles,
+          fallbackModels: args.fallbackModels
         });
         result.tasks.push({
           name: "key files",
@@ -167338,12 +167725,13 @@ async function runDream(args) {
           result: "completed"
         });
       } catch (error51) {
-        log(`[key-files] identification phase failed: ${getErrorMessage(error51)}`);
+        const errorDescription = describeError(error51);
+        logWithStackHead(`[key-files] identification phase failed: ${errorDescription.brief}`, errorDescription.stackHead);
         result.tasks.push({
           name: "key files",
           durationMs: Date.now() - kfStart,
           result: "",
-          error: getErrorMessage(error51)
+          error: errorDescription.brief
         });
       }
     }
@@ -167378,7 +167766,13 @@ async function runDream(args) {
     smartNotesPending: result.smartNotesPending,
     memoryChanges: persistedMemoryChanges
   });
-  const POST_TASK_NAMES = new Set(["smart-notes", "user memories", "key files"]);
+  const POST_TASK_NAMES = new Set([
+    "smart-notes",
+    "user memories",
+    "key files",
+    "post-task-phases",
+    "circuit-breaker"
+  ]);
   const hasSuccessfulTask = result.tasks.some((t) => !t.error && !POST_TASK_NAMES.has(t.name));
   if (hasSuccessfulTask) {
     setDreamState(args.db, `last_dream_at:${args.projectIdentity}`, String(result.finishedAt));
@@ -167457,7 +167851,12 @@ Only include notes whose conditions you could definitively evaluate. Skip notes
         system: DREAMER_SYSTEM_PROMPT,
         parts: [{ type: "text", text: evaluationPrompt, synthetic: true }]
       }
-    }, { timeoutMs: Math.min(remainingMs, 300000), signal: abortController.signal });
+    }, {
+      timeoutMs: Math.min(remainingMs, 300000),
+      signal: abortController.signal,
+      fallbackModels: args.fallbackModels,
+      callContext: "dreamer:smart-notes"
+    });
     const messagesResponse = await args.client.session.messages({
       path: { id: agentSessionId },
       query: { directory: args.sessionDirectory ?? args.projectIdentity }
@@ -167516,15 +167915,15 @@ Only include notes whose conditions you could definitively evaluate. Skip notes
     });
   } catch (error51) {
     const durationMs = Date.now() - taskStartedAt;
-    const errorMsg = getErrorMessage(error51);
+    const errorDescription = describeError(error51);
     args.result.smartNotesSurfaced = 0;
     args.result.smartNotesPending = pendingNotes.length;
-    log(`[dreamer] smart notes: failed after ${(durationMs / 1000).toFixed(1)}s — ${errorMsg}`);
+    logWithStackHead(`[dreamer] smart notes: failed after ${(durationMs / 1000).toFixed(1)}s — ${errorDescription.brief}`, errorDescription.stackHead);
     args.result.tasks.push({
       name: "smart-notes",
       durationMs,
       result: null,
-      error: errorMsg
+      error: errorDescription.brief
     });
   } finally {
     clearInterval(leaseInterval);
@@ -167557,7 +167956,8 @@ async function processDreamQueue(args) {
       maxRuntimeMinutes: args.maxRuntimeMinutes,
       sessionDirectory: projectDirectory,
       experimentalUserMemories: args.experimentalUserMemories,
-      experimentalPinKeyFiles: args.experimentalPinKeyFiles
+      experimentalPinKeyFiles: args.experimentalPinKeyFiles,
+      fallbackModels: args.fallbackModels
     });
   } catch (error51) {
     log(`[dreamer] runDream threw for ${entry.projectIdentity}: ${getErrorMessage(error51)}`);
@@ -168165,6 +168565,7 @@ function searchGitCommitsSync(db, projectPath, query, options) {
 init_embedding();
 init_project_identity();
 init_logger();
+init_resolve_fallbacks();
 await init_storage();
 var DREAM_TIMER_INTERVAL_MS = 15 * 60 * 1000;
 var activeTimer = null;
@@ -168251,7 +168652,8 @@ async function sweepProject(reg, origin) {
       maxRuntimeMinutes: reg.dreamerConfig.max_runtime_minutes,
       experimentalUserMemories: reg.experimentalUserMemories,
       experimentalPinKeyFiles: reg.experimentalPinKeyFiles,
-      projectIdentity: registrationIdentity
+      projectIdentity: registrationIdentity,
+      fallbackModels: resolveFallbackChain(DREAMER_AGENT, reg.dreamerConfig.fallback_models)
     });
   } catch (error51) {
     log(`[dreamer] timer-triggered queue processing failed for ${reg.directory}:`, error51);
@@ -168779,6 +169181,7 @@ function createTagger() {
 init_magic_context();
 init_project_identity();
 init_logger();
+init_resolve_fallbacks();
 await init_storage();
 
 // src/hooks/magic-context/command-handler.ts
@@ -169259,7 +169662,8 @@ Dreaming is not configured for this project.`, {});
     maxRuntimeMinutes: deps.dreamer.config.max_runtime_minutes,
     experimentalUserMemories: deps.dreamer.experimentalUserMemories,
     experimentalPinKeyFiles: deps.dreamer.experimentalPinKeyFiles,
-    projectIdentity: deps.dreamer.projectPath
+    projectIdentity: deps.dreamer.projectPath,
+    fallbackModels: deps.dreamer.fallbackModels
   });
   await deps.sendNotification(sessionId, result ? summarizeDreamResult(result) : "Dream queued, but another worker is already processing the queue.", {});
   throwSentinel("CTX-DREAM");
@@ -169555,113 +169959,8 @@ function clearSessionTracking(sessionId) {
   }
 }
 
-// src/features/magic-context/overflow-detection.ts
-var OVERFLOW_PATTERNS = [
-  /prompt is too long/i,
-  /input is too long for requested model/i,
-  /exceeds the context window/i,
-  /input token count.*exceeds the maximum/i,
-  /maximum prompt length is \d+/i,
-  /reduce the length of the messages/i,
-  /maximum context length is \d+ tokens/i,
-  /exceeds the limit of \d+/i,
-  /exceeds the available context size/i,
-  /greater than the context length/i,
-  /context window exceeds limit/i,
-  /exceeded model token limit/i,
-  /context[_ ]length[_ ]exceeded/i,
-  /request entity too large/i,
-  /context length is only \d+ tokens/i,
-  /input length.*exceeds.*context length/i,
-  /prompt too long; exceeded (?:max )?context length/i,
-  /too large for model with \d+ maximum context length/i,
-  /model_context_window_exceeded/i,
-  /context size has been exceeded/i
-];
-var LIMIT_EXTRACTION_PATTERNS = [
-  /maximum prompt length is (\d+)/i,
-  /maximum context length is (\d+) tokens?/i,
-  /context length is only (\d+) tokens?/i,
-  /exceeds the limit of (\d+)/i,
-  /too large for model with (\d+) maximum context length/i,
-  /context size.*(\d+) tokens?/i,
-  /exceeds? the context length of (\d+)/i,
-  /max(?:imum)?.*context.*?(\d+)/i
-];
-var MIN_PLAUSIBLE_LIMIT = 1024;
-var MAX_PLAUSIBLE_LIMIT = 1e7;
-function extractErrorMessage(error51) {
-  if (!error51)
-    return "";
-  if (typeof error51 === "string")
-    return error51;
-  if (typeof error51 === "object") {
-    const obj = error51;
-    const nested = obj.error;
-    if (nested && typeof nested.message === "string" && nested.message.length > 0) {
-      return nested.message;
-    }
-  }
-  if (error51 instanceof Error)
-    return error51.message;
-  if (typeof error51 === "object") {
-    const obj = error51;
-    if (typeof obj.message === "string")
-      return obj.message;
-    if (typeof obj.responseBody === "string")
-      return obj.responseBody;
-    try {
-      return JSON.stringify(error51);
-    } catch {
-      return String(error51);
-    }
-  }
-  return String(error51);
-}
-function detectOverflow(error51) {
-  const message = extractErrorMessage(error51);
-  if (!message) {
-    return { isOverflow: false };
-  }
-  const hasStatus413 = /\b413\b/.test(message) && /(entity|payload|context|prompt)/i.test(message);
-  let matched;
-  for (const pattern of OVERFLOW_PATTERNS) {
-    if (pattern.test(message)) {
-      matched = pattern;
-      break;
-    }
-  }
-  if (!matched && !hasStatus413) {
-    return { isOverflow: false };
-  }
-  const reportedLimit = parseReportedLimit(message);
-  return {
-    isOverflow: true,
-    reportedLimit,
-    matchedPattern: matched?.source
-  };
-}
-function parseReportedLimit(message) {
-  if (!message)
-    return;
-  for (const pattern of LIMIT_EXTRACTION_PATTERNS) {
-    const match = message.match(pattern);
-    if (!match)
-      continue;
-    const raw = match[1];
-    if (!raw)
-      continue;
-    const value = Number.parseInt(raw, 10);
-    if (!Number.isFinite(value))
-      continue;
-    if (value < MIN_PLAUSIBLE_LIMIT || value > MAX_PLAUSIBLE_LIMIT)
-      continue;
-    return value;
-  }
-  return;
-}
-
 // src/hooks/magic-context/event-handler.ts
+init_overflow_detection();
 init_storage_meta_persisted();
 init_logger();
 await __promiseAll([
@@ -170575,6 +170874,7 @@ async function runCompartmentPhase(args) {
         historianChunkTokens: args.historianChunkTokens,
         historyBudgetTokens: args.historyBudgetTokens,
         historianTimeoutMs: args.historianTimeoutMs,
+        fallbackModels: args.fallbackModels,
         directory: args.compartmentDirectory,
         fallbackModelId: args.fallbackModelId,
         getNotificationParams: args.getNotificationParams,
@@ -170602,6 +170902,7 @@ async function runCompartmentPhase(args) {
         historianChunkTokens: args.historianChunkTokens,
         historyBudgetTokens: args.historyBudgetTokens,
         historianTimeoutMs: args.historianTimeoutMs,
+        fallbackModels: args.fallbackModels,
         directory: args.compartmentDirectory,
         fallbackModelId: args.fallbackModelId,
         getNotificationParams: args.getNotificationParams,
@@ -170641,6 +170942,7 @@ async function runCompartmentPhase(args) {
       directory: args.compartmentDirectory,
       historyBudgetTokens: args.historyBudgetTokens,
       historianTimeoutMs: args.historianTimeoutMs,
+      fallbackModels: args.fallbackModels,
       minCompartmentRatio: args.compressorMinCompartmentRatio,
       maxMergeDepth: args.compressorMaxMergeDepth
     }).then((compressed) => {
@@ -170738,6 +171040,46 @@ function countMessagesSinceLastUser(messages) {
   }
   return messagesSinceLastUser;
 }
+function injectToolPartIntoLatestAssistant(messages, part) {
+  for (let index = messages.length - 1;index >= 0; index -= 1) {
+    const message = messages[index];
+    if (message.info.role !== "assistant")
+      continue;
+    if (typeof message.info.id !== "string")
+      continue;
+    if (hasToolPartWithCallId(message, part.callID)) {
+      return message.info.id;
+    }
+    message.parts.push(part);
+    return message.info.id;
+  }
+  return null;
+}
+function injectToolPartIntoAssistantById(messages, messageId, part) {
+  for (const message of messages) {
+    if (message.info.id !== messageId)
+      continue;
+    if (message.info.role !== "assistant")
+      continue;
+    if (hasToolPartWithCallId(message, part.callID))
+      return true;
+    message.parts.push(part);
+    return true;
+  }
+  return false;
+}
+function hasToolPartWithCallId(message, callId) {
+  for (const part of message.parts) {
+    if (part === null || typeof part !== "object")
+      continue;
+    const p = part;
+    if (p.type !== "tool")
+      continue;
+    if (p.callID === callId)
+      return true;
+  }
+  return false;
+}
 function appendReminderToUserMessage(message, reminder) {
   for (const part of message.parts) {
     if (!isTextPart(part)) {
@@ -172247,6 +172589,84 @@ function isVisibleNoteReadPart(part) {
   return false;
 }
 
+// src/hooks/magic-context/todo-view.ts
+import { createHash as createHash4 } from "node:crypto";
+var TERMINAL_STATUSES = new Set(["completed", "cancelled"]);
+var TITLE_DONE_STATUSES = new Set(["completed"]);
+var SYNTHETIC_CALL_ID_PREFIX = "mc_synthetic_todo_";
+function normalizeTodoStateJson(todos) {
+  if (!Array.isArray(todos))
+    return null;
+  const normalized = [];
+  for (const todo of todos) {
+    if (!isTodoItem(todo))
+      return null;
+    normalized.push({
+      content: todo.content,
+      status: todo.status,
+      priority: todo.priority
+    });
+  }
+  return JSON.stringify(normalized);
+}
+function buildSyntheticTodoPart(stateJson) {
+  const todos = parseTodoState(stateJson);
+  if (todos === null || todos.length === 0)
+    return null;
+  if (todos.every((t) => TERMINAL_STATUSES.has(t.status)))
+    return null;
+  const callID = computeSyntheticCallId(stateJson);
+  const activeCount = todos.filter((t) => !TITLE_DONE_STATUSES.has(t.status)).length;
+  const output = JSON.stringify(todos, null, 2);
+  const ts = 0;
+  return {
+    type: "tool",
+    callID,
+    tool: "todowrite",
+    state: {
+      status: "completed",
+      input: { todos },
+      output,
+      title: `${activeCount} todos`,
+      metadata: { todos, truncated: false },
+      time: { start: ts, end: ts }
+    },
+    syntheticTodoMarker: true
+  };
+}
+function computeSyntheticCallId(stateJson) {
+  const hash2 = createHash4("sha256").update(stateJson).digest("hex").slice(0, 16);
+  return `${SYNTHETIC_CALL_ID_PREFIX}${hash2}`;
+}
+function parseTodoState(stateJson) {
+  if (stateJson.length === 0)
+    return null;
+  try {
+    const parsed = JSON.parse(stateJson);
+    if (!Array.isArray(parsed))
+      return null;
+    const result = [];
+    for (const item of parsed) {
+      if (!isTodoItem(item))
+        continue;
+      result.push({
+        content: item.content,
+        status: item.status,
+        priority: item.priority
+      });
+    }
+    return result;
+  } catch {
+    return null;
+  }
+}
+function isTodoItem(value) {
+  if (value === null || typeof value !== "object")
+    return false;
+  const todo = value;
+  return typeof todo.content === "string" && typeof todo.status === "string" && typeof todo.priority === "string";
+}
+
 // src/hooks/magic-context/transform-stage-logger.ts
 init_logger();
 function logTransformTiming(sessionId, stage, startMs, extra) {
@@ -172488,6 +172908,33 @@ async function runPostTransformPhase(args) {
     const anchoredMessageId = appendReminderToLatestUserMessage(args.messages, noteInstruction);
     markNoteNudgeDelivered(args.db, args.sessionId, noteInstruction, anchoredMessageId);
   }
+  if (args.fullFeatureMode) {
+    const persistedAnchor = getPersistedTodoSyntheticAnchor(args.db, args.sessionId);
+    if (isCacheBustingPass) {
+      const part = buildSyntheticTodoPart(args.sessionMeta.lastTodoState);
+      if (part === null) {
+        if (persistedAnchor) {
+          clearPersistedTodoSyntheticAnchor(args.db, args.sessionId);
+        }
+      } else if (persistedAnchor && persistedAnchor.callId === part.callID && injectToolPartIntoAssistantById(args.messages, persistedAnchor.messageId, part)) {
+        if (persistedAnchor.stateJson.length === 0) {
+          setPersistedTodoSyntheticAnchor(args.db, args.sessionId, persistedAnchor.callId, persistedAnchor.messageId, args.sessionMeta.lastTodoState);
+        }
+      } else {
+        const anchoredMessageId = injectToolPartIntoLatestAssistant(args.messages, part);
+        if (anchoredMessageId) {
+          setPersistedTodoSyntheticAnchor(args.db, args.sessionId, part.callID, anchoredMessageId, args.sessionMeta.lastTodoState);
+        } else if (persistedAnchor) {
+          clearPersistedTodoSyntheticAnchor(args.db, args.sessionId);
+        }
+      }
+    } else if (persistedAnchor && persistedAnchor.stateJson.length > 0) {
+      const part = buildSyntheticTodoPart(persistedAnchor.stateJson);
+      if (part !== null && part.callID === persistedAnchor.callId) {
+        injectToolPartIntoAssistantById(args.messages, persistedAnchor.messageId, part);
+      }
+    }
+  }
   if (args.fullFeatureMode && args.autoSearch?.enabled && args.projectPath) {
     const visibleMemoryIds = getVisibleMemoryIds(args.db, args.sessionId) ?? undefined;
     try {
@@ -172719,6 +173166,7 @@ function createTransform(deps) {
         historianChunkTokens: deps.getHistorianChunkTokens?.() ?? 20000,
         historyBudgetTokens,
         historianTimeoutMs: deps.historianTimeoutMs,
+        fallbackModels: deps.fallbackModels,
         directory: compartmentDirectory,
         fallbackModelId,
         getNotificationParams: () => notificationParams,
@@ -172888,6 +173336,7 @@ Historian previously failed ${historianFailureState.failureCount} time(s), so ma
       historianChunkTokens: deps.getHistorianChunkTokens?.() ?? 20000,
       historyBudgetTokens,
       historianTimeoutMs: deps.historianTimeoutMs,
+      fallbackModels: deps.fallbackModels,
       compartmentDirectory,
       messages,
       pendingCompartmentInjection,
@@ -173728,9 +174177,17 @@ function createToolExecuteAfterHook(args) {
     if (typedInput.tool === "todowrite") {
       const todoArgs = typedInput.args;
       const todos = todoArgs?.todos;
-      if (Array.isArray(todos) && todos.length > 0 && todos.every((t) => t.status === "completed" || t.status === "cancelled")) {
-        const sessionMeta = getOrCreateSessionMeta(args.db, typedInput.sessionID);
-        if (!sessionMeta.isSubagent) {
+      const sessionMeta = Array.isArray(todos) ? getOrCreateSessionMeta(args.db, typedInput.sessionID) : null;
+      if (sessionMeta && !sessionMeta.isSubagent) {
+        const normalizedTodos = normalizeTodoStateJson(todos);
+        if (normalizedTodos !== null) {
+          updateSessionMeta(args.db, typedInput.sessionID, {
+            lastTodoState: normalizedTodos
+          });
+        }
+      }
+      if (Array.isArray(todos) && todos.length > 0 && todos.every((t) => typeof t === "object" && t !== null && (t.status === "completed" || t.status === "cancelled"))) {
+        if (sessionMeta && !sessionMeta.isSubagent) {
           onNoteTrigger(args.db, typedInput.sessionID, "todos_complete");
         }
       }
@@ -173746,7 +174203,7 @@ function createToolExecuteAfterHook(args) {
 init_send_session_notification();
 
 // src/hooks/magic-context/system-prompt-hash.ts
-import { createHash as createHash4 } from "node:crypto";
+import { createHash as createHash5 } from "node:crypto";
 import { existsSync as existsSync13, readFileSync as readFileSync9, realpathSync } from "node:fs";
 import { join as join22, resolve as resolve4, sep } from "node:path";
 
@@ -174051,7 +174508,7 @@ ${sections.join(`
 `);
     if (systemContent.length === 0)
       return;
-    const currentHash = createHash4("md5").update(systemContent).digest("hex");
+    const currentHash = createHash5("md5").update(systemContent).digest("hex");
     if (!sessionMetaEarly) {
       return;
     }
@@ -174066,14 +174523,12 @@ ${sections.join(`
     } else if (previousHash === "" || previousHash === "0") {
       sessionLog(sessionId, `system prompt hash initialized: ${currentHash} (len=${systemContent.length})`);
     }
-    const systemPromptTokens = estimateTokens(systemContent);
     if (currentHash !== previousHash) {
+      const systemPromptTokens = estimateTokens(systemContent);
       updateSessionMeta(deps.db, sessionId, {
         systemPromptHash: currentHash,
         systemPromptTokens
       });
-    } else if (Math.abs(sessionMeta.systemPromptTokens - systemPromptTokens) > 50) {
-      updateSessionMeta(deps.db, sessionId, { systemPromptTokens });
     }
     if (isCacheBusting) {
       deps.systemPromptRefreshSessions.delete(sessionId);
@@ -174135,6 +174590,7 @@ function createMagicContextHook(deps) {
   }
   let lastScheduleCheckMs = 0;
   const getHistorianChunkTokens = () => deriveHistorianChunkTokens(resolveHistorianContextLimit(deps.config.historian?.model));
+  const historianFallbackModels = resolveFallbackChain(HISTORIAN_AGENT, deps.config.historian?.fallback_models);
   const nudgePlacements = createNudgePlacementStore(db);
   const historyRefreshSessions = deps.liveSessionState?.historyRefreshSessions ?? new Set;
   const systemPromptRefreshSessions = deps.liveSessionState?.systemPromptRefreshSessions ?? new Set;
@@ -174194,6 +174650,7 @@ function createMagicContextHook(deps) {
     executeThresholdPercentage: deps.config.execute_threshold_percentage,
     executeThresholdTokens: deps.config.execute_threshold_tokens,
     historianTimeoutMs: deps.config.historian_timeout_ms ?? DEFAULT_HISTORIAN_TIMEOUT_MS,
+    fallbackModels: historianFallbackModels,
     getNotificationParams: (sessionId) => getLiveNotificationParams(sessionId, liveModelBySession, variantBySession, agentBySession),
     getModelKey: (sessionId) => {
       const model = liveModelBySession.get(sessionId);
@@ -174271,7 +174728,8 @@ function createMagicContextHook(deps) {
         enabled: true,
         token_budget: deps.config.dreamer.pin_key_files.token_budget,
         min_reads: deps.config.dreamer.pin_key_files.min_reads
-      } : undefined
+      } : undefined,
+      fallbackModels: resolveFallbackChain(DREAMER_AGENT, deps.config.dreamer?.fallback_models)
     }).catch((error51) => {
       log("[dreamer] scheduled queue processing failed:", error51);
     });
@@ -174305,6 +174763,7 @@ function createMagicContextHook(deps) {
       sessionId,
       historianChunkTokens: getHistorianChunkTokens(),
       historianTimeoutMs: deps.config.historian_timeout_ms ?? DEFAULT_HISTORIAN_TIMEOUT_MS,
+      fallbackModels: historianFallbackModels,
       directory: deps.directory,
       fallbackModelId: (() => {
         const model = resolveLiveModel(sessionId);
@@ -174344,7 +174803,8 @@ function createMagicContextHook(deps) {
         enabled: true,
         token_budget: deps.config.dreamer.pin_key_files.token_budget,
         min_reads: deps.config.dreamer.pin_key_files.min_reads
-      } : undefined
+      } : undefined,
+      fallbackModels: resolveFallbackChain(DREAMER_AGENT, deps.config.dreamer.fallback_models)
     } : undefined
   });
   const systemPromptHash = createSystemPromptHashHandler({
@@ -175006,19 +175466,7 @@ function buildStatusDetail(db, sessionId, directory, modelKey, config2, liveSess
     }
     detail.nextNudgeAfter = detail.lastNudgeTokens + detail.nudgeInterval;
     try {
-      const compartments = db.prepare("SELECT content, title, start_message, end_message FROM compartments WHERE session_id = ?").all(sessionId);
-      const facts = db.prepare("SELECT content FROM session_facts WHERE session_id = ?").all(sessionId);
-      let histTokens = 0;
-      for (const c of compartments) {
-        histTokens += estimateTokens(`<compartment start="${c.start_message}" end="${c.end_message}" title="${c.title}">
-${c.content}
-</compartment>
-`);
-      }
-      for (const f of facts) {
-        histTokens += estimateTokens(`* ${f.content}
-`);
-      }
+      const histTokens = base.compartmentTokens + base.factTokens;
       detail.historyBlockTokens = histTokens;
       if (detail.contextLimit > 0) {
         const budget = Math.floor(detail.contextLimit * (Math.min(detail.executeThreshold, 80) / 100) * detail.historyBudgetPercentage);
@@ -175191,7 +175639,7 @@ function normalizeLimit2(limit) {
   return Math.max(1, Math.floor(limit));
 }
 function getAllowedActions(deps) {
-  const allowed = deps.allowedActions?.length ? deps.allowedActions : [...CTX_MEMORY_DREAMER_ACTIONS];
+  const allowed = deps.allowedActions?.length ? deps.allowedActions : ["write", "delete"];
   return [...allowed];
 }
 function normalizeCategory(category) {
@@ -175297,7 +175745,7 @@ function createCtxMemoryTool(deps) {
   return tool2({
     description: CTX_MEMORY_DESCRIPTION,
     args: {
-      action: tool2.schema.enum(allowedActions).describe("Action to perform on memories"),
+      action: tool2.schema.enum([...CTX_MEMORY_DREAMER_ACTIONS]).describe("Action to perform on memories"),
       content: tool2.schema.string().optional().describe("Memory content (required for write, update, merge)"),
       category: tool2.schema.string().optional().describe("Memory category (required for write, optional filter for list, optional override for merge)"),
       id: tool2.schema.number().optional().describe("Memory ID (required for delete, update, archive)"),
@@ -176063,11 +176511,11 @@ import { createServer } from "node:http";
 import { dirname as dirname6 } from "node:path";
 
 // src/shared/rpc-utils.ts
-import { createHash as createHash5 } from "node:crypto";
+import { createHash as createHash6 } from "node:crypto";
 import { join as join23 } from "node:path";
 function projectHash(directory) {
   const normalized = directory.replace(/\/+$/, "");
-  return createHash5("sha256").update(normalized).digest("hex").slice(0, 16);
+  return createHash6("sha256").update(normalized).digest("hex").slice(0, 16);
 }
 function rpcPortFilePath(storageDir, directory) {
   return join23(storageDir, "rpc", projectHash(directory), "port");