cc-claw 0.3.10 → 0.4.0

package/dist/cli.js

@@ -48,7 +48,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.3.10" : (() => {
+    VERSION = true ? "0.4.0" : (() => {
       try {
         return JSON.parse(readFileSync(join2(process.cwd(), "package.json"), "utf-8")).version ?? "unknown";
       } catch {
@@ -922,12 +922,14 @@ __export(store_exports3, {
   ALL_TOOLS: () => ALL_TOOLS,
   addHeartbeatWatch: () => addHeartbeatWatch,
   addUsage: () => addUsage,
+  appendMessageLog: () => appendMessageLog,
   cancelJobById: () => cancelJobById,
   checkBackendLimits: () => checkBackendLimits,
   cleanExpiredWatches: () => cleanExpiredWatches,
   clearAllSessions: () => clearAllSessions,
   clearBackendLimit: () => clearBackendLimit,
   clearCwd: () => clearCwd,
+  clearMessageLog: () => clearMessageLog,
   clearModel: () => clearModel,
   clearSession: () => clearSession,
   clearSummarizer: () => clearSummarizer,
@@ -935,6 +937,7 @@ __export(store_exports3, {
   clearUsage: () => clearUsage,
   completeJobRun: () => completeJobRun,
   deleteBookmark: () => deleteBookmark,
+  determineEscalationTarget: () => determineEscalationTarget,
   findBookmarksByPrefix: () => findBookmarksByPrefix,
   forgetMemory: () => forgetMemory,
   getActiveJobs: () => getActiveJobs,
@@ -961,14 +964,18 @@ __export(store_exports3, {
   getMemoriesWithoutEmbeddings: () => getMemoriesWithoutEmbeddings,
   getMode: () => getMode,
   getModel: () => getModel,
+  getPendingEscalation: () => getPendingEscalation,
   getRecentBookmarks: () => getRecentBookmarks,
   getRecentMemories: () => getRecentMemories,
+  getRecentMessageLog: () => getRecentMessageLog,
   getSessionId: () => getSessionId,
   getSessionStartedAt: () => getSessionStartedAt,
   getSessionSummariesWithoutEmbeddings: () => getSessionSummariesWithoutEmbeddings,
   getSummarizer: () => getSummarizer,
   getThinkingLevel: () => getThinkingLevel,
   getToolsMap: () => getToolsMap,
+  getUnsummarizedChatIds: () => getUnsummarizedChatIds,
+  getUnsummarizedLog: () => getUnsummarizedLog,
   getUsage: () => getUsage,
   getVerboseLevel: () => getVerboseLevel,
   incrementJobFailures: () => incrementJobFailures,
@@ -977,10 +984,13 @@ __export(store_exports3, {
   insertJobRun: () => insertJobRun,
   listMemories: () => listMemories,
   listSessionSummaries: () => listSessionSummaries,
+  markMessageLogSummarized: () => markMessageLogSummarized,
   openDatabaseReadOnly: () => openDatabaseReadOnly,
   pruneJobRuns: () => pruneJobRuns,
+  pruneMessageLog: () => pruneMessageLog,
   removeChatAlias: () => removeChatAlias,
   removeHeartbeatWatch: () => removeHeartbeatWatch,
+  removePendingEscalation: () => removePendingEscalation,
   resetJobFailures: () => resetJobFailures,
   resetTools: () => resetTools,
   saveMemory: () => saveMemory,
@@ -989,6 +999,7 @@ __export(store_exports3, {
   saveSessionSummaryWithEmbedding: () => saveSessionSummaryWithEmbedding,
   searchMemories: () => searchMemories,
   searchMemoriesReadOnly: () => searchMemoriesReadOnly,
+  searchMessageLog: () => searchMessageLog,
   searchSessionSummaries: () => searchSessionSummaries,
   setBackend: () => setBackend,
   setBackendLimit: () => setBackendLimit,
@@ -1003,6 +1014,8 @@ __export(store_exports3, {
   setSummarizer: () => setSummarizer,
   setThinkingLevel: () => setThinkingLevel,
   setVerboseLevel: () => setVerboseLevel,
+  storePendingEscalation: () => storePendingEscalation,
+  toFts5Query: () => toFts5Query,
   toggleTool: () => toggleTool,
   touchBookmark: () => touchBookmark,
   updateHeartbeatTimestamps: () => updateHeartbeatTimestamps,
@@ -1084,6 +1097,7 @@ function initDatabase() {
       mode TEXT NOT NULL DEFAULT 'yolo'
     );
   `);
+  db.prepare("UPDATE chat_mode SET mode = 'plan' WHERE mode = 'readonly'").run();
   db.exec(`
     CREATE TABLE IF NOT EXISTS chat_verbose (
       chat_id TEXT PRIMARY KEY,
@@ -1144,6 +1158,7 @@ function initDatabase() {
       model TEXT,
       thinking TEXT,
       timeout INTEGER,
+      fallbacks TEXT,
       session_type TEXT NOT NULL DEFAULT 'isolated',
       channel TEXT,
       target TEXT,
@@ -1263,6 +1278,10 @@ function initDatabase() {
         db.exec("ALTER TABLE jobs ADD COLUMN timeout INTEGER");
       } catch {
       }
+      try {
+        db.exec("ALTER TABLE jobs ADD COLUMN fallbacks TEXT");
+      } catch {
+      }
     }
   } catch {
   }
@@ -1390,6 +1409,52 @@ function initDatabase() {
       PRIMARY KEY (chatId, alias)
     )
   `);
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS message_log (
+      id         INTEGER PRIMARY KEY AUTOINCREMENT,
+      chat_id    TEXT    NOT NULL,
+      role       TEXT    NOT NULL,
+      content    TEXT    NOT NULL,
+      backend    TEXT,
+      model      TEXT,
+      session_id TEXT,
+      summarized INTEGER NOT NULL DEFAULT 0,
+      created_at TEXT    NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+  db.exec(`
+    CREATE INDEX IF NOT EXISTS idx_message_log_chat
+      ON message_log (chat_id, created_at DESC)
+  `);
+  db.exec(`
+    CREATE INDEX IF NOT EXISTS idx_message_log_unsummarized
+      ON message_log (chat_id, summarized, created_at ASC)
+  `);
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS message_log_fts
+      USING fts5(content, content='message_log', content_rowid='id')
+  `);
+  db.exec(`
+    CREATE TRIGGER IF NOT EXISTS message_log_ai
+      AFTER INSERT ON message_log BEGIN
+        INSERT INTO message_log_fts(rowid, content) VALUES (new.id, new.content);
+      END
+  `);
+  db.exec(`
+    CREATE TRIGGER IF NOT EXISTS message_log_ad
+      AFTER DELETE ON message_log BEGIN
+        INSERT INTO message_log_fts(message_log_fts, rowid, content)
+          VALUES ('delete', old.id, old.content);
+      END
+  `);
+  db.exec(`
+    CREATE TRIGGER IF NOT EXISTS message_log_au
+      AFTER UPDATE ON message_log BEGIN
+        INSERT INTO message_log_fts(message_log_fts, rowid, content)
+          VALUES ('delete', old.id, old.content);
+        INSERT INTO message_log_fts(rowid, content) VALUES (new.id, new.content);
+      END
+  `);
   try {
     db.exec("ALTER TABLE memories ADD COLUMN embedding TEXT");
   } catch {
@@ -1669,7 +1734,8 @@ function getMode(chatId) {
   const row = db.prepare(
     "SELECT mode FROM chat_mode WHERE chat_id = ?"
   ).get(chatId);
-  return row?.mode ?? "yolo";
+  const raw = row?.mode ?? "yolo";
+  return raw === "readonly" ? "plan" : raw;
 }
 function setMode(chatId, mode) {
   db.prepare(`
@@ -1678,6 +1744,30 @@ function setMode(chatId, mode) {
     ON CONFLICT(chat_id) DO UPDATE SET mode = ?
   `).run(chatId, mode, mode);
 }
+function storePendingEscalation(chatId, message) {
+  pendingEscalations.set(chatId, { message, createdAt: Date.now() });
+  setTimeout(() => pendingEscalations.delete(chatId), ESCALATION_TTL_MS);
+}
+function getPendingEscalation(chatId) {
+  const entry = pendingEscalations.get(chatId);
+  if (!entry) return void 0;
+  if (Date.now() - entry.createdAt > ESCALATION_TTL_MS) {
+    pendingEscalations.delete(chatId);
+    return void 0;
+  }
+  return entry.message;
+}
+function removePendingEscalation(chatId) {
+  pendingEscalations.delete(chatId);
+}
+function determineEscalationTarget(chatId, currentMode) {
+  if (currentMode === "plan") {
+    const tools2 = getEnabledTools(chatId);
+    if (tools2.length > 0 && tools2.length < ALL_TOOLS.length) return "safe";
+    return "yolo";
+  }
+  return "yolo";
+}
 function getUsage(chatId) {
   const row = db.prepare(
     "SELECT input_tokens, output_tokens, cache_read_tokens, request_count, last_input_tokens, last_cache_read_tokens FROM chat_usage WHERE chat_id = ?"
@@ -1955,8 +2045,8 @@ function getBackendUsageInWindow(backend2, windowType) {
 function insertJob(params) {
   const result = db.prepare(`
     INSERT INTO jobs (schedule_type, cron, at_time, every_ms, description, chat_id,
-      backend, model, thinking, timeout, session_type, channel, target, delivery_mode, timezone)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      backend, model, thinking, timeout, fallbacks, session_type, channel, target, delivery_mode, timezone)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
   `).run(
     params.scheduleType,
     params.cron ?? null,
@@ -1968,6 +2058,7 @@ function insertJob(params) {
     params.model ?? null,
     params.thinking ?? null,
     params.timeout ?? null,
+    params.fallbacks?.length ? JSON.stringify(params.fallbacks) : null,
     params.sessionType ?? "isolated",
     params.channel ?? null,
     params.target ?? null,
@@ -1976,14 +2067,19 @@ function insertJob(params) {
   );
   return getJobById(Number(result.lastInsertRowid));
 }
+function mapJobRow(row) {
+  if (!row) return void 0;
+  row.fallbacks = row.fallbacks ? JSON.parse(row.fallbacks) : [];
+  return row;
+}
 function getJobById(id) {
-  return db.prepare(`${JOB_SELECT} WHERE id = ?`).get(id);
+  return mapJobRow(db.prepare(`${JOB_SELECT} WHERE id = ?`).get(id));
 }
 function getActiveJobs() {
-  return db.prepare(`${JOB_SELECT} WHERE active = 1 AND enabled = 1`).all();
+  return db.prepare(`${JOB_SELECT} WHERE active = 1 AND enabled = 1`).all().map((r) => mapJobRow(r));
 }
 function getAllJobs() {
-  return db.prepare(`${JOB_SELECT} WHERE active = 1 ORDER BY id`).all();
+  return db.prepare(`${JOB_SELECT} WHERE active = 1 ORDER BY id`).all().map((r) => mapJobRow(r));
 }
 function updateJobEnabled(id, enabled) {
   const result = db.prepare("UPDATE jobs SET enabled = ? WHERE id = ?").run(enabled ? 1 : 0, id);
@@ -2155,7 +2251,77 @@ function getAllChatAliases() {
 function removeChatAlias(alias) {
   return db.prepare("DELETE FROM chat_aliases WHERE alias = ?").run(alias.toLowerCase()).changes > 0;
 }
-var db, STOP_WORDS, ALL_TOOLS, JOB_SELECT;
+function appendMessageLog(chatId, role, content, backend2, model2, sessionId) {
+  getDb().prepare(`
+    INSERT INTO message_log (chat_id, role, content, backend, model, session_id)
+    VALUES (?, ?, ?, ?, ?, ?)
+  `).run(chatId, role, content, backend2, model2, sessionId);
+}
+function getRecentMessageLog(chatId, limit) {
+  return getDb().prepare(`
+    SELECT * FROM message_log
+    WHERE chat_id = ?
+    ORDER BY created_at DESC, id DESC
+    LIMIT ?
+  `).all(chatId, limit);
+}
+function getUnsummarizedLog(chatId) {
+  return getDb().prepare(`
+    SELECT * FROM message_log
+    WHERE chat_id = ? AND summarized = 0
+    ORDER BY created_at ASC, id ASC
+  `).all(chatId);
+}
+function searchMessageLog(chatId, query, limit = 20) {
+  const sanitized = toFts5Query(query);
+  if (!sanitized) return [];
+  try {
+    return getDb().prepare(`
+      SELECT ml.* FROM message_log ml
+      JOIN message_log_fts fts ON fts.rowid = ml.id
+      WHERE ml.chat_id = ? AND message_log_fts MATCH ?
+      ORDER BY fts.rank
+      LIMIT ?
+    `).all(chatId, sanitized, limit);
+  } catch {
+    return [];
+  }
+}
+function markMessageLogSummarized(chatId) {
+  getDb().prepare(`
+    UPDATE message_log SET summarized = 1
+    WHERE chat_id = ? AND summarized = 0
+  `).run(chatId);
+}
+function clearMessageLog(chatId) {
+  getDb().prepare(`DELETE FROM message_log WHERE chat_id = ?`).run(chatId);
+}
+function getUnsummarizedChatIds() {
+  const rows = getDb().prepare(
+    `SELECT DISTINCT chat_id FROM message_log WHERE summarized = 0`
+  ).all();
+  return rows.map((r) => r.chat_id);
+}
+function pruneMessageLog(retentionDays = 30, rowCapPerChat = 2e3) {
+  const db3 = getDb();
+  db3.prepare(`
+    DELETE FROM message_log
+    WHERE created_at < datetime('now', '-' || ? || ' days')
+  `).run(retentionDays);
+  const chats2 = db3.prepare(
+    `SELECT DISTINCT chat_id FROM message_log`
+  ).all();
+  for (const { chat_id } of chats2) {
+    db3.prepare(`
+      DELETE FROM message_log
+      WHERE chat_id = ? AND id NOT IN (
+        SELECT id FROM message_log WHERE chat_id = ?
+        ORDER BY created_at DESC, id DESC LIMIT ?
+      )
+    `).run(chat_id, chat_id, rowCapPerChat);
+  }
+}
+var db, STOP_WORDS, pendingEscalations, ESCALATION_TTL_MS, ALL_TOOLS, JOB_SELECT;
 var init_store4 = __esm({
   "src/memory/store.ts"() {
     "use strict";
@@ -2280,10 +2446,12 @@ var init_store4 = __esm({
       "near",
       "or"
     ]);
+    pendingEscalations = /* @__PURE__ */ new Map();
+    ESCALATION_TTL_MS = 5 * 60 * 1e3;
     ALL_TOOLS = ["Read", "Glob", "Grep", "Bash", "Write", "Edit", "WebFetch", "WebSearch", "Agent", "AskUserQuestion"];
     JOB_SELECT = `
   SELECT id, schedule_type as scheduleType, cron, at_time as atTime, every_ms as everyMs,
-    description, chat_id as chatId, backend, model, thinking, timeout,
+    description, chat_id as chatId, backend, model, thinking, timeout, fallbacks,
     session_type as sessionType, channel, target, delivery_mode as deliveryMode,
     timezone, enabled, active, created_at as createdAt, last_run_at as lastRunAt,
     next_run_at as nextRunAt, consecutive_failures as consecutiveFailures
@@ -2433,15 +2601,14 @@ var init_claude = __esm({
         switch (opts.permMode) {
           case "plan":
             args.push("--permission-mode", "plan");
-            break;
-          case "readonly":
-            args.push("--permission-mode", "bypassPermissions");
-            args.push("--allowedTools", "Read,Glob,Grep");
+            args.push("--strict-mcp-config");
             break;
           case "safe":
             args.push("--permission-mode", "bypassPermissions");
             if (opts.allowedTools.length > 0) {
-              args.push("--allowedTools", opts.allowedTools.join(","));
+              args.push("--tools", opts.allowedTools.join(","));
+            } else {
+              args.push("--tools", "Read,Glob,Grep");
             }
             break;
           case "yolo":
@@ -2600,11 +2767,10 @@ var init_gemini = __esm({
         if (opts.model) args.push("-m", opts.model);
         switch (opts.permMode) {
           case "plan":
-          case "readonly":
             args.push("--approval-mode", "plan");
             break;
           case "safe":
-            args.push("--approval-mode", "auto_edit");
+            args.push("--approval-mode", "plan");
             break;
           case "yolo":
           default:
@@ -2686,21 +2852,34 @@ var init_codex = __esm({
           thinking: "adjustable",
           thinkingLevels: ["low", "medium", "high", "extra_high"],
           defaultThinkingLevel: "medium"
+        },
+        "gpt-5.1-codex-max": {
+          label: "GPT-5.1 Codex Max \u2014 deep reasoning",
+          thinking: "adjustable",
+          thinkingLevels: ["low", "medium", "high", "extra_high"],
+          defaultThinkingLevel: "medium"
+        },
+        "gpt-5.1-codex-mini": {
+          label: "GPT-5.1 Codex Mini \u2014 cheaper, faster",
+          thinking: "adjustable",
+          thinkingLevels: ["low", "medium", "high", "extra_high"],
+          defaultThinkingLevel: "low"
         }
       };
       defaultModel = "gpt-5.4";
-      // Internal-only model for summarization — not shown in /model picker
       summarizerModel = "gpt-5.1-codex-mini";
       pricing = {
         "gpt-5.4": { in: 2.5, out: 10, cache: 0.63 },
         "gpt-5.3-codex": { in: 2, out: 8, cache: 0.5 },
         "gpt-5.2-codex": { in: 2, out: 8, cache: 0.5 },
+        "gpt-5.1-codex-max": { in: 1.25, out: 10, cache: 0.125 },
         "gpt-5.1-codex-mini": { in: 0.3, out: 1.2, cache: 0.08 }
       };
       contextWindow = {
         "gpt-5.4": 2e5,
         "gpt-5.3-codex": 2e5,
         "gpt-5.2-codex": 2e5,
+        "gpt-5.1-codex-max": 4e5,
         "gpt-5.1-codex-mini": 2e5
       };
       // Codex has no single result event with final text -- the caller (spawnQuery)
@@ -2742,11 +2921,10 @@ var init_codex = __esm({
         if (opts.model) args.push("-m", opts.model);
         switch (opts.permMode) {
           case "plan":
-          case "readonly":
             args.push("--sandbox", "read-only");
             break;
           case "safe":
-            args.push("--full-auto");
+            args.push("--sandbox", "read-only");
             break;
           case "yolo":
           default:
@@ -2904,6 +3082,31 @@ function mergeAndScore(allItems, vectorScores, ftsScores, getDays, decayRate, to
   results.sort((a, b) => b.score - a.score);
   return results.slice(0, topK);
 }
+function setPendingContextBridge(chatId, bridge) {
+  pendingContextBridges.set(chatId, bridge);
+}
+function consumeContextBridge(chatId) {
+  const bridge = pendingContextBridges.get(chatId) ?? null;
+  pendingContextBridges.delete(chatId);
+  return bridge;
+}
+function buildContextBridge(chatId, pairs = 15) {
+  const rows = getRecentMessageLog(chatId, pairs * 2).reverse();
+  if (rows.length === 0) return null;
+  const lines = [`[Conversation history \u2014 continued from previous session]`];
+  let totalChars = lines[0].length;
+  for (const row of rows) {
+    const backendLabel = row.backend ?? "unknown";
+    const date = row.created_at.slice(0, 10);
+    const roleLabel = row.role === "user" ? "You" : "Assistant";
+    const line = `[${backendLabel} \xB7 ${date}] ${roleLabel}: ${row.content}`;
+    if (totalChars + line.length > MAX_BRIDGE_CHARS) break;
+    lines.push(line);
+    totalChars += line.length;
+  }
+  lines.push(`[End of recent history \u2014 you are continuing this conversation]`);
+  return lines.join("\n");
+}
 async function injectMemoryContext(userMessage) {
   const provider = resolveProvider();
   const useVectors = !!provider;
@@ -2982,17 +3185,21 @@ async function injectMemoryContext(userMessage) {
   if (combinedMemories.length === 0 && combinedSessions.length === 0) return null;
   const lines = [];
   for (const m of combinedMemories) {
-    lines.push(`- [${m.type}] ${m.trigger}: ${m.content}`);
+    let text = `- [${m.type}] ${m.trigger}: ${m.content}`;
+    if (text.length > MAX_MEMORY_CHARS) text = text.slice(0, MAX_MEMORY_CHARS) + "\u2026";
+    lines.push(text);
   }
   for (const s of combinedSessions) {
     const date = s.created_at.split("T")[0] ?? s.created_at.split(" ")[0];
-    lines.push(`- [episodic] ${date} session (${s.message_count} msgs): ${s.summary}${s.topics ? ` Topics: ${s.topics}` : ""}`);
+    let text = `- [episodic] ${date} session (${s.message_count} msgs): ${s.summary}${s.topics ? ` Topics: ${s.topics}` : ""}`;
+    if (text.length > MAX_SESSION_CHARS) text = text.slice(0, MAX_SESSION_CHARS) + "\u2026";
+    lines.push(text);
   }
   return `[Memory context]
 ${lines.join("\n")}
 [End memory context]`;
 }
-var MEMORY_DECAY_RATE, SESSION_DECAY_RATE, VECTOR_TOP_K, FTS_TOP_K, FINAL_TOP_K_MEMORIES, FINAL_TOP_K_SESSIONS;
+var MEMORY_DECAY_RATE, SESSION_DECAY_RATE, VECTOR_TOP_K, FTS_TOP_K, FINAL_TOP_K_MEMORIES, FINAL_TOP_K_SESSIONS, MAX_MEMORY_CHARS, MAX_SESSION_CHARS, MAX_BRIDGE_CHARS, pendingContextBridges;
 var init_inject = __esm({
   "src/memory/inject.ts"() {
     "use strict";
@@ -3004,6 +3211,10 @@ var init_inject = __esm({
     FTS_TOP_K = 20;
     FINAL_TOP_K_MEMORIES = 5;
     FINAL_TOP_K_SESSIONS = 3;
+    MAX_MEMORY_CHARS = 500;
+    MAX_SESSION_CHARS = 800;
+    MAX_BRIDGE_CHARS = 48e3;
+    pendingContextBridges = /* @__PURE__ */ new Map();
   }
 });
 
@@ -3114,6 +3325,7 @@ function syncNativeCliFiles() {
     "## System Capabilities",
     "",
     "- To send a file to the user: write [SEND_FILE:/absolute/path] in your response",
+    "- To generate an image: write [GENERATE_IMAGE:detailed prompt] in your response (requires GEMINI_API_KEY)",
     "- To suggest saving a user preference: write [UPDATE_USER:key=value] in your response",
     "- For heartbeat checks: respond with exactly HEARTBEAT_OK if nothing needs attention",
     "- Your working directory is ~/.cc-claw/workspace/",
@@ -3147,29 +3359,8 @@ var init_init = __esm({
 });
 
 // src/bootstrap/loader.ts
-import { readFileSync as readFileSync3, existsSync as existsSync5, readdirSync, statSync as statSync2 } from "fs";
+import { readFileSync as readFileSync3, existsSync as existsSync5, readdirSync } from "fs";
 import { join as join4 } from "path";
-function loadFileWithCache(path, cache) {
-  if (!existsSync5(path)) return null;
-  try {
-    const stat = statSync2(path);
-    if (stat.mtimeMs !== cache.mtime) {
-      cache.content = readFileSync3(path, "utf-8").trim();
-      cache.mtime = stat.mtimeMs;
-      log(`[bootstrap] Loaded ${path} (${cache.content.length} chars)`);
-      syncNativeCliFiles();
-    }
-    return cache.content;
-  } catch {
-    return null;
-  }
-}
-function loadSoul() {
-  return loadFileWithCache(SOUL_PATH2, soulCacheObj);
-}
-function loadUser() {
-  return loadFileWithCache(USER_PATH2, userCacheObj);
-}
 function searchContext(userMessage) {
   if (!existsSync5(CONTEXT_DIR2)) return null;
   const msgWords = new Set(
@@ -3201,23 +3392,18 @@ function searchContext(userMessage) {
   } catch {
   }
   if (bestMatch && bestMatch.score >= 2) {
+    if (bestMatch.content.length > MAX_CONTEXT_CHARS) {
+      return bestMatch.content.slice(0, MAX_CONTEXT_CHARS) + "\n\u2026(truncated)";
+    }
     return bestMatch.content;
   }
   return null;
 }
-async function assembleBootstrapPrompt(userMessage, tier = "full", chatId) {
+async function assembleBootstrapPrompt(userMessage, tier = "full", chatId, permMode) {
   const sections = [];
-  const soul = loadSoul();
-  if (soul) {
-    sections.push(`[System instructions \u2014 follow these]
-${soul}`);
-  }
-  if (tier === "full" || tier === "heartbeat") {
-    const user = loadUser();
-    if (user) {
-      sections.push(`[User profile]
-${user}`);
-    }
+  syncNativeCliFiles();
+  if (permMode && permMode !== "yolo") {
+    sections.push(buildPermissionNotice(permMode));
   }
   if (tier === "full") {
     const ctx = searchContext(userMessage);
@@ -3226,9 +3412,17 @@ ${user}`);
 ${ctx}`);
     }
   }
-  const memory2 = await injectMemoryContext(userMessage);
-  if (memory2) {
-    sections.push(memory2);
+  if (chatId && tier !== "slim") {
+    const bridge = consumeContextBridge(chatId);
+    if (bridge) {
+      sections.push(bridge);
+    }
+  }
+  if (tier !== "slim") {
+    const memory2 = await injectMemoryContext(userMessage);
+    if (memory2) {
+      sections.push(memory2);
+    }
   }
   if (chatId && (tier === "full" || tier === "heartbeat")) {
     const orchestrationContext = buildOrchestrationContext(chatId);
@@ -3241,6 +3435,12 @@ ${ctx}`);
   log(`[bootstrap] Assembled prompt: tier=${tier}, sections=${sections.length}, totalChars=${result.length}`);
   return result;
 }
+function buildPermissionNotice(mode) {
+  if (mode === "plan") {
+    return "[Permission notice]\nYou are in restricted mode (plan). You can read and analyze files but CANNOT edit, write, or execute commands.\nIf the user's request requires modifications or execution, include the marker [NEED_PERMISSION] at the end of your response. Briefly explain what you would need to do and why elevated access is required. Do NOT attempt workarounds or refuse the task \u2014 signal the need and the system will ask the user to approve.\n[End permission notice]";
+  }
+  return "[Permission notice]\nYou are in restricted mode (safe). Only a subset of tools are available to you.\nIf the user's request requires tools you don't have access to, include the marker [NEED_PERMISSION] at the end of your response. Briefly explain what you would need to do and why elevated access is required. Do NOT attempt workarounds or refuse the task \u2014 signal the need and the system will ask the user to approve.\n[End permission notice]";
+}
 function truncateToTokenBudget(text, budget) {
   const charBudget = budget * 4;
   if (text.length <= charBudget) return text;
@@ -3285,7 +3485,7 @@ ${boardText}`);
     return null;
   }
 }
-var SOUL_PATH2, USER_PATH2, CONTEXT_DIR2, soulCacheObj, userCacheObj, ACTIVITY_TOKEN_BUDGET, INBOX_TOKEN_BUDGET, WHITEBOARD_TOKEN_BUDGET;
+var CONTEXT_DIR2, MAX_CONTEXT_CHARS, ACTIVITY_TOKEN_BUDGET, INBOX_TOKEN_BUDGET, WHITEBOARD_TOKEN_BUDGET;
 var init_loader = __esm({
   "src/bootstrap/loader.ts"() {
     "use strict";
@@ -3296,11 +3496,8 @@ var init_loader = __esm({
     init_store3();
     init_store4();
     init_store();
-    SOUL_PATH2 = join4(WORKSPACE_PATH, "SOUL.md");
-    USER_PATH2 = join4(WORKSPACE_PATH, "USER.md");
     CONTEXT_DIR2 = join4(WORKSPACE_PATH, "context");
-    soulCacheObj = { content: null, mtime: 0 };
-    userCacheObj = { content: null, mtime: 0 };
+    MAX_CONTEXT_CHARS = 4e3;
     ACTIVITY_TOKEN_BUDGET = 1500;
     INBOX_TOKEN_BUDGET = 2e3;
     WHITEBOARD_TOKEN_BUDGET = 500;
@@ -3308,66 +3505,62 @@ var init_loader = __esm({
 });
 
 // src/memory/session-log.ts
-function appendToLog(chatId, userMessage, assistantResponse) {
-  if (!logs.has(chatId)) logs.set(chatId, []);
-  const entries = logs.get(chatId);
+function appendToLog(chatId, userMessage, assistantResponse, backend2, model2, sessionId) {
   const now = Date.now();
-  entries.push({ role: "user", text: userMessage, timestamp: now });
-  entries.push({ role: "assistant", text: assistantResponse, timestamp: now });
-  const maxEntries = MAX_PAIRS * 2;
-  if (entries.length > maxEntries) {
-    entries.splice(0, entries.length - maxEntries);
+  appendMessageLog(chatId, "user", userMessage, backend2 ?? null, model2 ?? null, sessionId ?? null);
+  appendMessageLog(chatId, "assistant", assistantResponse, backend2 ?? null, model2 ?? null, sessionId ?? null);
+  const existing = cache.get(chatId) ?? [];
+  existing.push(
+    { role: "user", text: userMessage, timestamp: now },
+    { role: "assistant", text: assistantResponse, timestamp: now }
+  );
+  if (existing.length > CACHE_SIZE * 2) {
+    existing.splice(0, existing.length - CACHE_SIZE * 2);
   }
+  cache.set(chatId, existing);
 }
 function getLog(chatId) {
-  return logs.get(chatId) ?? [];
+  const rows = getUnsummarizedLog(chatId);
+  return rows.map((r) => ({
+    role: r.role,
+    text: r.content,
+    timestamp: (/* @__PURE__ */ new Date(r.created_at + (r.created_at.includes("Z") ? "" : "Z"))).getTime()
+  }));
+}
+function getMessagePairCount(chatId) {
+  const cached = cache.get(chatId);
+  if (cached && cached.length > 0) {
+    return Math.floor(cached.length / 2);
+  }
+  return Math.floor(getUnsummarizedLog(chatId).length / 2);
 }
 function clearLog(chatId) {
-  logs.delete(chatId);
+  markMessageLogSummarized(chatId);
+  cache.delete(chatId);
 }
 function getLoggedChatIds() {
-  return [...logs.keys()].filter((id) => (logs.get(id)?.length ?? 0) > 0);
-}
-function getMessagePairCount(chatId) {
-  return Math.floor((logs.get(chatId)?.length ?? 0) / 2);
+  return getUnsummarizedChatIds();
 }
-var logs, MAX_PAIRS;
+var CACHE_SIZE, cache;
 var init_session_log = __esm({
   "src/memory/session-log.ts"() {
     "use strict";
-    logs = /* @__PURE__ */ new Map();
-    MAX_PAIRS = 100;
+    init_store4();
+    CACHE_SIZE = 20;
+    cache = /* @__PURE__ */ new Map();
   }
 });
 
 // src/memory/summarize.ts
 var summarize_exports = {};
 __export(summarize_exports, {
+  CONTEXT_BRIDGE_PROMPT: () => CONTEXT_BRIDGE_PROMPT,
   summarizeAllPending: () => summarizeAllPending,
-  summarizeSession: () => summarizeSession
+  summarizeSession: () => summarizeSession,
+  summarizeWithFallbackChain: () => summarizeWithFallbackChain
 });
 import { spawn } from "child_process";
 import { createInterface } from "readline";
-function resolveSummarizerAdapter(chatId) {
-  const config2 = getSummarizer(chatId);
-  if (config2.backend === "off") return null;
-  let adapter;
-  if (config2.backend) {
-    adapter = getAdapter(config2.backend);
-  } else {
-    try {
-      adapter = getAdapterForChat(chatId);
-    } catch {
-      try {
-        adapter = getAdapter("claude");
-      } catch {
-        return null;
-      }
-    }
-  }
-  const model2 = config2.model ?? adapter.summarizerModel;
-  return { adapter, model: model2 };
-}
 function buildTranscript(entries) {
   const lines = [];
   let totalLen = 0;
@@ -3385,19 +3578,7 @@ function buildTranscript(entries) {
   }
   return lines.join("\n\n");
 }
-async function summarizeSession(chatId) {
-  const pairCount = getMessagePairCount(chatId);
-  if (pairCount < MIN_PAIRS) {
-    clearLog(chatId);
-    return false;
-  }
-  const resolved = resolveSummarizerAdapter(chatId);
-  if (!resolved) {
-    clearLog(chatId);
-    return false;
-  }
-  const { adapter, model: model2 } = resolved;
-  const entries = getLog(chatId);
+async function attemptSummarize(chatId, adapter, model2, entries) {
   const transcript = buildTranscript(entries);
   const prompt = `${SUMMARIZE_PROMPT}
 
@@ -3416,7 +3597,6 @@ ${transcript}`;
     let inputTokens = 0;
     let outputTokens = 0;
     let cacheReadTokens = 0;
-    const SUMMARIZE_TIMEOUT_MS = 6e4;
     await new Promise((resolve) => {
       const proc = spawn(config2.executable, config2.args, {
         env,
@@ -3426,7 +3606,7 @@ ${transcript}`;
       proc.stderr?.resume();
       const rl2 = createInterface({ input: proc.stdout });
       const timeout = setTimeout(() => {
-        warn(`[summarize] Timeout after ${SUMMARIZE_TIMEOUT_MS / 1e3}s for chat ${chatId} \u2014 killing process`);
+        warn(`[summarize] Timeout (${adapter.id}:${model2}) for chat ${chatId}`);
         rl2.close();
         proc.kill("SIGTERM");
         setTimeout(() => proc.kill("SIGKILL"), 2e3);
@@ -3441,9 +3621,7 @@ ${transcript}`;
         }
         const events = adapter.parseLine(msg);
         for (const ev of events) {
-          if (ev.type === "text" && ev.text) {
-            accumulatedText += ev.text;
-          }
+          if (ev.type === "text" && ev.text) accumulatedText += ev.text;
           if (ev.type === "usage" && ev.usage) {
             inputTokens += ev.usage.input;
             outputTokens += ev.usage.output;
@@ -3452,9 +3630,9 @@ ${transcript}`;
           if (ev.type === "result") {
             resultText = ev.resultText || accumulatedText;
             if (ev.usage) {
-              inputTokens += ev.usage.input;
-              outputTokens += ev.usage.output;
-              cacheReadTokens += ev.usage.cacheRead;
+              inputTokens = ev.usage.input;
+              outputTokens = ev.usage.output;
+              cacheReadTokens = ev.usage.cacheRead;
             }
             if (adapter.shouldKillOnResult()) {
               rl2.close();
@@ -3475,11 +3653,9 @@ ${transcript}`;
     if (inputTokens + outputTokens > 0) {
       addUsage(chatId, inputTokens, outputTokens, cacheReadTokens, model2);
     }
+    if (!resultText) resultText = accumulatedText;
     if (!resultText) {
-      resultText = accumulatedText;
-    }
-    if (!resultText) {
-      warn(`[summarize] ${adapter.displayName} returned empty result for chat ${chatId} \u2014 keeping log for retry`);
+      warn(`[summarize] ${adapter.id}:${model2} returned empty result for chat ${chatId}`);
       return false;
     }
     const summaryMatch = resultText.match(/SUMMARY:\s*(.+?)(?=\nKEY_DETAILS:|\nTOPICS:|$)/s);
@@ -3487,20 +3663,72 @@ ${transcript}`;
     const topicsMatch = resultText.match(/TOPICS:\s*(.+)/);
     let summary = summaryMatch?.[1]?.trim() ?? resultText.trim();
     const keyDetails = keyDetailsMatch?.[1]?.trim();
-    if (keyDetails) {
-      summary += `
+    if (keyDetails) summary += `
 Key details: ${keyDetails}`;
-    }
     const topics = topicsMatch?.[1]?.trim() ?? "";
-    saveSessionSummaryWithEmbedding(chatId, summary, topics, pairCount);
-    log(`[summarize] Saved session summary for chat ${chatId} via ${adapter.id}:${model2} (${pairCount} pairs, topics: ${topics})`);
-    clearLog(chatId);
+    saveSessionSummaryWithEmbedding(chatId, summary, topics, Math.floor(entries.length / 2));
+    log(`[summarize] Saved summary via ${adapter.id}:${model2} for chat ${chatId}`);
     return true;
   } catch (err) {
-    warn(`[summarize] Failed for chat ${chatId}: ${errorMessage(err)} \u2014 keeping log for retry`);
+    warn(`[summarize] ${adapter.id}:${model2} failed for ${chatId}: ${errorMessage(err)}`);
     return false;
   }
 }
+async function summarizeWithFallbackChain(chatId, targetBackendId) {
+  const pairCount = getMessagePairCount(chatId);
+  if (pairCount < MIN_PAIRS) {
+    clearLog(chatId);
+    return false;
+  }
+  const entries = getLog(chatId);
+  if (entries.length === 0) return false;
+  const tried = /* @__PURE__ */ new Set();
+  try {
+    const config2 = getSummarizer(chatId);
+    if (config2.backend !== "off") {
+      const adapter = config2.backend ? getAdapter(config2.backend) : getAdapterForChat(chatId);
+      const model2 = config2.model ?? adapter.summarizerModel;
+      const key = `${adapter.id}:${model2}`;
+      tried.add(key);
+      if (await attemptSummarize(chatId, adapter, model2, entries)) {
+        clearLog(chatId);
+        return true;
+      }
+    }
+  } catch {
+  }
+  if (targetBackendId) {
+    try {
+      const targetAdapter = getAdapter(targetBackendId);
+      const model2 = targetAdapter.summarizerModel;
+      const key = `${targetAdapter.id}:${model2}`;
+      if (!tried.has(key)) {
+        tried.add(key);
+        if (await attemptSummarize(chatId, targetAdapter, model2, entries)) {
+          clearLog(chatId);
+          return true;
+        }
+      }
+    } catch {
+    }
+  }
+  for (const adapter of getAllAdapters()) {
+    const model2 = adapter.summarizerModel;
+    const key = `${adapter.id}:${model2}`;
+    if (!tried.has(key)) {
+      tried.add(key);
+      if (await attemptSummarize(chatId, adapter, model2, entries)) {
+        clearLog(chatId);
+        return true;
+      }
+    }
+  }
+  warn(`[summarize] All fallback attempts failed for chat ${chatId} \u2014 raw log preserved`);
+  return false;
+}
+async function summarizeSession(chatId) {
+  return summarizeWithFallbackChain(chatId);
+}
 async function summarizeAllPending() {
   const chatIds = getLoggedChatIds();
   if (chatIds.length === 0) return;
@@ -3509,7 +3737,7 @@ async function summarizeAllPending() {
     await summarizeSession(chatId);
   }
 }
-var MIN_PAIRS, USER_MSG_LIMIT, AGENT_MSG_LIMIT, TRANSCRIPT_CAP, SUMMARIZE_PROMPT;
+var MIN_PAIRS, USER_MSG_LIMIT, AGENT_MSG_LIMIT, TRANSCRIPT_CAP, SUMMARIZE_TIMEOUT_MS, SUMMARIZE_PROMPT, CONTEXT_BRIDGE_PROMPT;
 var init_summarize = __esm({
   "src/memory/summarize.ts"() {
     "use strict";
@@ -3521,18 +3749,20 @@ var init_summarize = __esm({
     USER_MSG_LIMIT = 4e3;
     AGENT_MSG_LIMIT = 6e3;
     TRANSCRIPT_CAP = 1e5;
+    SUMMARIZE_TIMEOUT_MS = 6e4;
     SUMMARIZE_PROMPT = `You are summarizing a conversation session for long-term episodic memory. This summary will be injected into future conversations to provide context, so it must contain enough specific detail to be useful weeks or months later.
 
 Instructions:
 1. SUMMARY: Write a detailed summary (5-15 sentences depending on session complexity). Capture:
    - What the user asked for and why
    - What was done, decided, or accomplished
-   - Specific details that would be hard to rediscover: names, dates, values, locations, references, sources, outcomes
-   - Anything left unfinished or planned for later
+   - Specific details that would be hard to rediscover: names, dates, values, locations, references, sources, decisions, outcomes \u2014 across any domain
+   - The state at session end: what's done, what's in progress, what's planned next
    - Any preferences, corrections, or instructions the user expressed
 
 2. KEY_DETAILS: List the 3-8 most important specific facts as bullet points. These should be concrete and retrievable \u2014 not vague.
    Good: "User's quarterly report deadline is March 15"
+   Good: "Flight booked to NYC on April 3, confirmation #AB1234"
    Bad: "Discussed deadlines"
 
 3. TOPICS: Extract 5-10 specific topic keywords that would help retrieve this session in a future search. Use proper nouns, specific terms, and distinguishing phrases \u2014 NOT generic words like "discussion" or "help".
@@ -3543,6 +3773,14 @@ KEY_DETAILS:
 - <detail 1>
 - <detail 2>
 TOPICS: <specific-keyword1, specific-keyword2, ...>`;
+    CONTEXT_BRIDGE_PROMPT = `You are handing off an active work session to a new AI assistant. Write a concise handoff brief (3-8 sentences) covering:
+- What the user is actively working on RIGHT NOW
+- Exact current state: what's done, what's in progress, what's blocked
+- Specific details needed to continue: names, dates, decisions, references, links, preferences, or any domain-specific context relevant to the work
+- The immediate next step the assistant should be ready to take
+- Any critical constraints or preferences expressed by the user
+
+Be specific. The new assistant has no prior context. Cover any domain \u2014 personal, research, scheduling, content, technical \u2014 whatever applies to this session.`;
   }
 });
 
@@ -3579,20 +3817,20 @@ var init_registry = __esm({
 });
 
 // src/agents/roles.ts
-function buildRoleInstructions(role, task, persona) {
+function buildRoleInstructions(role, task, persona, includeTools = true) {
   const rolePrompt = persona ?? ROLE_PRESETS[role] ?? ROLE_PRESETS.worker;
   const capitalizedRole = role.charAt(0).toUpperCase() + role.slice(1);
-  return [
+  const parts = [
     `## Your Role: ${capitalizedRole}`,
     "",
     rolePrompt,
-    "",
-    ORCHESTRATOR_TOOLS,
-    "",
-    "## Task",
-    "",
-    task
-  ].join("\n");
+    ""
+  ];
+  if (includeTools) {
+    parts.push(ORCHESTRATOR_TOOLS, "");
+  }
+  parts.push("## Task", "", task);
+  return parts.join("\n");
 }
 var ROLE_PRESETS, ORCHESTRATOR_TOOLS;
 var init_roles = __esm({
@@ -3660,7 +3898,8 @@ function buildAgentPrompt(opts, runnerSkillPath) {
     }
     parts.push("");
   }
-  parts.push(buildRoleInstructions(opts.role ?? "worker", opts.task, opts.persona));
+  const includeTools = opts.includeOrchestratorTools !== false;
+  parts.push(buildRoleInstructions(opts.role ?? "worker", opts.task, opts.persona, includeTools));
   return parts.join("\n");
 }
 function buildSpawnEnv(runner, isSubAgent = false) {
@@ -4243,7 +4482,8 @@ async function startAgent(agentId, chatId, opts) {
     role: opts.role,
     persona: opts.persona,
     extraArgs: mcpExtraArgs.length ? mcpExtraArgs : void 0,
-    isSubAgent: true
+    isSubAgent: true,
+    includeOrchestratorTools: process.env.DASHBOARD_ENABLED === "1"
   }, {
     onText: () => {
       updateAgentOutput(db3, agentId);
@@ -4458,7 +4698,7 @@ function startNextQueued(chatId) {
     description: agent.description ?? void 0,
     model: agent.model ?? void 0,
     skills: JSON.parse(agent.skills),
-    permMode: agent.permMode === "inherit" ? void 0 : agent.permMode,
+    permMode: agent.permMode === "inherit" ? getMode(chatId) : agent.permMode,
     role: agent.role ?? "worker",
     persona: agent.persona ?? void 0,
     maxRuntimeMs: agent.maxRuntimeMs,
@@ -4964,6 +5204,10 @@ function startDashboard() {
         if (body.cwd && !existsSync8(body.cwd)) {
           return jsonResponse(res, { error: `Directory not found: ${body.cwd}` }, 400);
         }
+        if (!body.permMode || body.permMode === "inherit") {
+          const { getMode: getMode2 } = await Promise.resolve().then(() => (init_store4(), store_exports3));
+          body.permMode = getMode2(body.chatId);
+        }
         const result = await spawnSubAgent(body.chatId, body);
         return jsonResponse(res, result);
       } catch (err) {
@@ -5216,7 +5460,10 @@ function startDashboard() {
         const { getMode: getMode2, getCwd: getCwd2, getModel: getModel2, addUsage: addUsage2, getBackend: getBackend2 } = await Promise.resolve().then(() => (init_store4(), store_exports3));
         const { getAdapterForChat: getAdapterForChat2 } = await Promise.resolve().then(() => (init_backends(), backends_exports));
         const chatId = body.chatId;
-        const mode = body.mode ?? getMode2(chatId);
+        const PERM_LEVEL = { plan: 0, safe: 1, yolo: 2 };
+        const storedMode = getMode2(chatId);
+        const requestedMode = body.mode ?? storedMode;
+        const mode = (PERM_LEVEL[requestedMode] ?? 2) <= (PERM_LEVEL[storedMode] ?? 2) ? requestedMode : storedMode;
         const cwd = body.cwd ?? getCwd2(chatId);
         const model2 = body.model ?? getModel2(chatId) ?? (() => {
           try {
@@ -5866,13 +6113,13 @@ function askAgent(chatId, userMessage, opts) {
   return withChatLock(chatId, () => askAgentImpl(chatId, userMessage, opts));
 }
 async function askAgentImpl(chatId, userMessage, opts) {
-  const { cwd, onStream, model: model2, permMode, onToolAction, bootstrapTier, timeoutMs } = opts ?? {};
-  const adapter = getAdapterForChat(chatId);
-  const mode = permMode ?? "yolo";
+  const { cwd, onStream, model: model2, backend: backend2, permMode, onToolAction, bootstrapTier, timeoutMs } = opts ?? {};
+  const adapter = backend2 ? getAdapter(backend2) : getAdapterForChat(chatId);
+  const mode = permMode ?? getMode(chatId);
   const thinkingLevel = getThinkingLevel(chatId);
   const resolvedCwd = cwd ?? WORKSPACE_PATH;
   const tier = bootstrapTier ?? "full";
-  const fullPrompt = await assembleBootstrapPrompt(userMessage, tier, chatId);
+  const fullPrompt = await assembleBootstrapPrompt(userMessage, tier, chatId, mode);
   const existingSessionId = getSessionId(chatId);
   const allowedTools = getEnabledTools(chatId);
   const mcpConfigPath = getMcpConfigPath(chatId);
@@ -5933,7 +6180,17 @@ async function askAgentImpl(chatId, userMessage, opts) {
     clearSession(chatId);
   }
   if (result.resultText) {
-    appendToLog(chatId, userMessage, result.resultText);
+    appendToLog(chatId, userMessage, result.resultText, adapter.id, model2 ?? null, result.sessionId ?? null);
+    const AUTO_SUMMARIZE_THRESHOLD = 30;
+    const pairCount = getMessagePairCount(chatId);
+    if (pairCount >= AUTO_SUMMARIZE_THRESHOLD) {
+      log(`[agent] Auto-summarizing chat ${chatId} after ${pairCount} turns`);
+      summarizeWithFallbackChain(chatId).then((saved) => {
+        if (saved) opts?.onCompaction?.(chatId);
+      }).catch((err) => {
+        warn(`[agent] Auto-summarize failed for chat ${chatId}: ${err}`);
+      });
+    }
   }
   return {
     text: result.resultText || `(No response from ${adapter.displayName})`,
@@ -6125,6 +6382,9 @@ var init_delivery = __esm({
 // src/scheduler/retry.ts
 function classifyError(err) {
   const msg = err instanceof Error ? err.message : String(err);
+  for (const pattern of EXHAUSTED_PATTERNS) {
+    if (pattern.test(msg)) return "exhausted";
+  }
   for (const pattern of TRANSIENT_PATTERNS) {
     if (pattern.test(msg)) return "transient";
   }
@@ -6138,10 +6398,21 @@ function getBackoffMs(retryCount) {
   const jitter = Math.floor(base * 0.2 * (Math.random() * 2 - 1));
   return base + jitter;
 }
-var TRANSIENT_PATTERNS, PERMANENT_PATTERNS, BACKOFF_MS, MAX_RETRIES, AUTO_PAUSE_THRESHOLD;
+var EXHAUSTED_PATTERNS, TRANSIENT_PATTERNS, PERMANENT_PATTERNS, BACKOFF_MS, MAX_RETRIES, AUTO_PAUSE_THRESHOLD;
 var init_retry = __esm({
   "src/scheduler/retry.ts"() {
     "use strict";
+    EXHAUSTED_PATTERNS = [
+      /out of.*usage/i,
+      /\d+-hour limit reached/i,
+      /usage limit reached/i,
+      /hit your.*limit/i,
+      /usage.?limit/i,
+      /exceeded your current quota/i,
+      /RESOURCE.?EXHAUSTED/i,
+      /insufficient.?quota/i,
+      /check your plan and billing/i
+    ];
     TRANSIENT_PATTERNS = [
       /rate.?limit/i,
       /too many requests/i,
@@ -6458,23 +6729,50 @@ async function runWithRetry(job, model2, runId, t0) {
   if (job.thinking && job.thinking !== "auto") {
     setThinkingLevel(chatId, job.thinking);
   }
-  for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
-    try {
-      const timeoutMs = job.timeout ? job.timeout * 1e3 : void 0;
-      const response = await askAgent(chatId, job.description, { model: model2, bootstrapTier: "slim", timeoutMs });
-      return response;
-    } catch (err) {
-      lastError = err;
-      const errorClass = classifyError(err);
-      if (errorClass === "permanent" || attempt >= MAX_RETRIES) {
-        throw err;
+  const timeoutMs = job.timeout ? job.timeout * 1e3 : void 0;
+  const primaryBackend = resolveJobBackendId(job);
+  const chain = [
+    { backend: primaryBackend, model: model2 },
+    ...job.fallbacks ?? []
+  ];
+  for (let chainIdx = 0; chainIdx < chain.length; chainIdx++) {
+    const { backend: currentBackend, model: currentModel } = chain[chainIdx];
+    const isFallback = chainIdx > 0;
+    if (isFallback) {
+      log(`[scheduler] Job #${job.id} falling back to ${currentBackend}:${currentModel} (fallback ${chainIdx}/${job.fallbacks.length})`);
+    }
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+      try {
+        const response = await askAgent(chatId, job.description, {
+          model: currentModel,
+          backend: currentBackend,
+          bootstrapTier: "slim",
+          timeoutMs,
+          permMode: job.sessionType === "main" ? getMode(job.chatId) : "yolo"
+        });
+        if (isFallback) {
+          response.text = `[Fallback: ran on ${currentBackend}:${currentModel}]
+
+${response.text}`;
+        }
+        return response;
+      } catch (err) {
+        lastError = err;
+        const errorClass = classifyError(err);
+        if (errorClass === "exhausted") {
+          log(`[scheduler] Job #${job.id} backend ${currentBackend} exhausted: ${errorMessage(err)}`);
+          break;
+        }
+        if (errorClass === "permanent" || attempt >= MAX_RETRIES) {
+          throw err;
+        }
+        const backoffMs = getBackoffMs(attempt);
+        log(`[scheduler] Job #${job.id} transient error (attempt ${attempt + 1}/${MAX_RETRIES}), retrying in ${backoffMs / 1e3}s: ${errorMessage(err)}`);
+        await new Promise((r) => setTimeout(r, backoffMs));
       }
-      const backoffMs = getBackoffMs(attempt);
-      log(`[scheduler] Job #${job.id} transient error (attempt ${attempt + 1}/${MAX_RETRIES}), retrying in ${backoffMs / 1e3}s: ${errorMessage(err)}`);
-      await new Promise((r) => setTimeout(r, backoffMs));
     }
   }
-  throw lastError ?? new Error("Unknown error");
+  throw lastError ?? new Error("All backends exhausted");
 }
 function resolveJobBackendId(job) {
   return job.backend ?? (() => {
@@ -6578,7 +6876,7 @@ function wrapBackendAdapter(adapter) {
       const config2 = adapter.buildSpawnConfig({
         prompt: opts.prompt,
         sessionId: opts.sessionId,
-        permMode: opts.permMode ?? "yolo",
+        permMode: opts.permMode ?? "plan",
         allowedTools: opts.allowedTools ?? [],
         cwd: opts.cwd
       });
@@ -7146,6 +7444,7 @@ var init_telegram2 = __esm({
           // Skills & profile
           { command: "skills", description: "List and invoke skills" },
           { command: "voice", description: "Toggle voice responses" },
+          { command: "imagine", description: "Generate an image from a prompt" },
           { command: "heartbeat", description: "Configure proactive heartbeat" },
           { command: "chats", description: "Manage multi-chat aliases" }
         ]);
@@ -7791,7 +8090,7 @@ async function finalizeProfile(chatId, state, channel) {
     "<!-- Add any additional preferences below this line -->",
     ""
   ].join("\n");
-  writeFileSync4(USER_PATH3, content, "utf-8");
+  writeFileSync4(USER_PATH2, content, "utf-8");
   activeProfiles.delete(chatId);
   log(`[profile] User profile saved for chat ${chatId}`);
   await channel.sendText(
@@ -7817,23 +8116,23 @@ function extractUserUpdates(text) {
   return { cleanText, updates };
 }
 function appendToUserProfile(key, value) {
-  if (!existsSync11(USER_PATH3)) return;
-  const content = readFileSync7(USER_PATH3, "utf-8");
+  if (!existsSync11(USER_PATH2)) return;
+  const content = readFileSync7(USER_PATH2, "utf-8");
   const line = `- **${key}**: ${value}`;
   if (content.includes(line)) return;
   const updated = content.trimEnd() + `
 ${line}
 `;
-  writeFileSync4(USER_PATH3, updated, "utf-8");
+  writeFileSync4(USER_PATH2, updated, "utf-8");
   log(`[profile] Appended preference: ${key}=${value}`);
 }
-var USER_PATH3, activeProfiles;
+var USER_PATH2, activeProfiles;
 var init_profile = __esm({
   "src/bootstrap/profile.ts"() {
     "use strict";
     init_paths();
     init_log();
-    USER_PATH3 = join12(WORKSPACE_PATH, "USER.md");
+    USER_PATH2 = join12(WORKSPACE_PATH, "USER.md");
     activeProfiles = /* @__PURE__ */ new Map();
   }
 });
@@ -8024,14 +8323,6 @@ var init_heartbeat = __esm({
 });
 
 // src/format-time.ts
-function formatLocalDate(utcDatetime) {
-  const d = parseUtcDatetime(utcDatetime);
-  if (!d) return utcDatetime.split("T")[0] ?? utcDatetime.split(" ")[0];
-  const year = d.getFullYear();
-  const month = String(d.getMonth() + 1).padStart(2, "0");
-  const day = String(d.getDate()).padStart(2, "0");
-  return `${year}-${month}-${day}`;
-}
 function formatLocalDateTime(utcDatetime) {
   const d = parseUtcDatetime(utcDatetime);
   if (!d) return utcDatetime;
@@ -8069,6 +8360,83 @@ var init_format_time = __esm({
   }
 });
 
+// src/media/image-gen.ts
+import { writeFileSync as writeFileSync5, mkdirSync as mkdirSync5, existsSync as existsSync13 } from "fs";
+import { join as join14 } from "path";
+async function generateImage(prompt) {
+  const apiKey = process.env.GEMINI_API_KEY;
+  if (!apiKey) {
+    throw new Error("Image generation requires GEMINI_API_KEY. Configure it in ~/.cc-claw/.env");
+  }
+  log(`[image-gen] Generating image: "${prompt.slice(0, 100)}"`);
+  const response = await fetch(
+    `https://generativelanguage.googleapis.com/v1beta/models/${IMAGE_MODEL}:generateContent?key=${apiKey}`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        contents: [
+          {
+            parts: [{ text: prompt }]
+          }
+        ],
+        generationConfig: {
+          responseModalities: ["TEXT", "IMAGE"]
+        }
+      })
+    }
+  );
+  if (!response.ok) {
+    const errText = await response.text();
+    throw new Error(`Gemini image API error: ${response.status} ${errText.slice(0, 300)}`);
+  }
+  const data = await response.json();
+  const parts = data.candidates?.[0]?.content?.parts;
+  if (!parts || parts.length === 0) {
+    throw new Error("Gemini returned no content for image generation");
+  }
+  let imageData = null;
+  let mimeType = "image/png";
+  let textResponse = null;
+  for (const part of parts) {
+    if (part.inlineData) {
+      imageData = part.inlineData.data;
+      mimeType = part.inlineData.mimeType ?? "image/png";
+    } else if (part.text) {
+      textResponse = part.text;
+    }
+  }
+  if (!imageData) {
+    throw new Error(textResponse ?? "Gemini did not generate an image. The prompt may have been filtered.");
+  }
+  if (!existsSync13(IMAGE_OUTPUT_DIR)) {
+    mkdirSync5(IMAGE_OUTPUT_DIR, { recursive: true });
+  }
+  const ext = mimeType.includes("jpeg") || mimeType.includes("jpg") ? "jpg" : "png";
+  const filename = `img_${Date.now()}.${ext}`;
+  const filePath = join14(IMAGE_OUTPUT_DIR, filename);
+  const buffer = Buffer.from(imageData, "base64");
+  writeFileSync5(filePath, buffer);
+  log(`[image-gen] Saved ${buffer.length} bytes to ${filePath}`);
+  return { filePath, text: textResponse, mimeType };
+}
+function isImageGenAvailable() {
+  return !!process.env.GEMINI_API_KEY;
+}
+var IMAGE_MODEL, IMAGE_OUTPUT_DIR;
+var init_image_gen = __esm({
+  "src/media/image-gen.ts"() {
+    "use strict";
+    init_log();
+    IMAGE_MODEL = "gemini-3.1-flash-image-preview";
+    IMAGE_OUTPUT_DIR = join14(
+      process.env.CC_CLAW_HOME ?? join14(process.env.HOME ?? "/tmp", ".cc-claw"),
+      "data",
+      "images"
+    );
+  }
+});
+
 // src/voice/stt.ts
 import crypto from "crypto";
 import { execFile as execFile2 } from "child_process";
@@ -9137,7 +9505,7 @@ async function handleCommand(msg, channel) {
     case "help":
       await channel.sendText(
         chatId,
-        "Hey! I'm CC-Claw \u2014 your personal AI assistant on Telegram.\n\nI use AI coding CLIs (Claude, Gemini, Codex) as my brain. Just send me a message to get started.\n\nCommands:\n/backend [name] - Switch AI backend (or /claude /gemini /codex)\n/model - Switch model for active backend\n/summarizer - Configure session summarization model\n/status - Show session, model, backend, and usage\n/cost - Show estimated API cost (use /cost all for all-time)\n/usage - Show usage per backend with limits\n/limits - Configure usage limits per backend\n/newchat - Start a fresh conversation\n/summarize - Save session to memory (without resetting)\n/summarize all - Summarize all pending sessions (pre-restart)\n/cwd <path> - Set working directory\n/cwd - Show current working directory\n/memory - List stored memories\n/forget <keyword> - Remove a memory\n/voice - Toggle voice responses\n/cron <description> - Schedule a task (or /schedule)\n/cron - List scheduled jobs (or /jobs)\n/cron cancel <id> - Cancel a job\n/cron pause <id> - Pause a job\n/cron resume <id> - Resume a job\n/cron run <id> - Trigger a job now\n/cron runs [id] - View run history\n/cron edit <id> - Edit a job\n/cron health - Scheduler health\n/skills - List skills from all backends\n/skill-install <url> - Install a skill from GitHub\n/setup-profile - Set up your user profile\n/chats - List authorized chats and aliases\n/heartbeat - Proactive awareness (on/off/interval/hours)\n/history - List recent session summaries\n/stop - Cancel the current running task\n/tools - Configure which tools the agent can use\n/permissions - Switch permission mode (yolo/safe/readonly/plan)\n/verbose - Tool visibility (off/normal/verbose)\n/agents - List active sub-agents\n/tasks - Show task board for current orchestration\n/stopagent <id> - Cancel a specific sub-agent\n/stopall - Cancel all sub-agents in this chat\n/runners - List registered CLI runners\n/mcps - List registered MCP servers\n/help - Show this message",
+        "Hey! I'm CC-Claw \u2014 your personal AI assistant on Telegram.\n\nI use AI coding CLIs (Claude, Gemini, Codex) as my brain. Just send me a message to get started.\n\nCommands:\n/backend [name] - Switch AI backend (or /claude /gemini /codex)\n/model - Switch model for active backend\n/summarizer - Configure session summarization model\n/status - Show session, model, backend, and usage\n/cost - Show estimated API cost (use /cost all for all-time)\n/usage - Show usage per backend with limits\n/limits - Configure usage limits per backend\n/newchat - Start a fresh conversation\n/summarize - Save session to memory (without resetting)\n/summarize all - Summarize all pending sessions (pre-restart)\n/cwd <path> - Set working directory\n/cwd - Show current working directory\n/memory - List stored memories\n/forget <keyword> - Remove a memory\n/voice - Toggle voice responses\n/imagine <prompt> - Generate an image (or /image)\n/cron <description> - Schedule a task (or /schedule)\n/cron - List scheduled jobs (or /jobs)\n/cron cancel <id> - Cancel a job\n/cron pause <id> - Pause a job\n/cron resume <id> - Resume a job\n/cron run <id> - Trigger a job now\n/cron runs [id] - View run history\n/cron edit <id> - Edit a job\n/cron health - Scheduler health\n/skills - List skills from all backends\n/skill-install <url> - Install a skill from GitHub\n/setup-profile - Set up your user profile\n/chats - List authorized chats and aliases\n/heartbeat - Proactive awareness (on/off/interval/hours)\n/history - List recent session summaries\n/stop - Cancel the current running task\n/tools - Configure which tools the agent can use\n/permissions - Switch permission mode (yolo/safe/plan)\n/verbose - Tool visibility (off/normal/verbose)\n/agents - List active sub-agents\n/tasks - Show task board for current orchestration\n/stopagent <id> - Cancel a specific sub-agent\n/stopall - Cancel all sub-agents in this chat\n/runners - List registered CLI runners\n/mcps - List registered MCP servers\n/help - Show this message",
         "plain"
       );
       break;
@@ -9197,7 +9565,7 @@ async function handleCommand(msg, channel) {
           toolButtons.push(row);
         }
         toolButtons.push([{ label: "Reset to defaults (all on)", data: "tool:reset" }]);
-        const modeNote = currentMode === "readonly" ? "\n\nNote: In read-only mode, tool list is ignored (Read/Glob/Grep only)." : currentMode === "plan" ? "\n\nNote: In plan mode, no tools execute." : currentMode === "yolo" ? "\n\nNote: In YOLO mode, tool list is ignored (all tools allowed)." : "";
+        const modeNote = currentMode === "plan" ? "\n\nNote: In plan mode, tool list is ignored (read-only)." : currentMode === "yolo" ? "\n\nNote: In YOLO mode, tool list is ignored (all tools allowed)." : "";
         await channel.sendKeyboard(
           chatId,
           `Configure allowed tools (mode: ${currentMode})${modeNote}
@@ -9233,7 +9601,15 @@ Tap to toggle:`,
       } else {
         const pairs = getMessagePairCount(chatId);
         if (pairs < 2) {
-          await channel.sendText(chatId, "Not enough conversation to summarize (need at least 2 exchanges). Session log is preserved.", "plain");
+          if (getSessionId(chatId)) {
+            await channel.sendText(
+              chatId,
+              "Session log was cleared (auto-compact or service restart). Your conversation history is preserved in episodic memory. Continue chatting normally, or use /newchat to start fresh.",
+              "plain"
+            );
+          } else {
+            await channel.sendText(chatId, "Not enough conversation to summarize (need at least 2 exchanges).", "plain");
+          }
           break;
         }
         await channel.sendText(chatId, `Summarizing current session (${pairs} exchanges)...`, "plain");
@@ -9620,6 +9996,30 @@ ${lines.join("\n")}`, "plain");
       );
       break;
     }
+    case "imagine":
+    case "image": {
+      if (!commandArgs) {
+        await channel.sendText(chatId, "Usage: /imagine <prompt>\nExample: /imagine a cat astronaut on Mars", "plain");
+        return;
+      }
+      if (!isImageGenAvailable()) {
+        await channel.sendText(chatId, "Image generation requires GEMINI_API_KEY. Configure it in ~/.cc-claw/.env", "plain");
+        return;
+      }
+      await channel.sendText(chatId, "\u{1F3A8} Generating image\u2026", "plain");
+      try {
+        const result = await generateImage(commandArgs);
+        const file = await readFile5(result.filePath);
+        const name = result.filePath.split("/").pop() ?? "image.png";
+        await channel.sendFile(chatId, file, name);
+        if (result.text) {
+          await channel.sendText(chatId, result.text, "plain");
+        }
+      } catch (err) {
+        await channel.sendText(chatId, `Image generation failed: ${errorMessage(err)}`, "plain");
+      }
+      break;
+    }
     case "schedule": {
       if (!commandArgs) {
         await channel.sendText(
@@ -9742,20 +10142,38 @@ ${lines.join("\n")}`, "plain");
       break;
     }
     case "history": {
-      const historyLimit = commandArgs ? parseInt(commandArgs, 10) || 5 : 5;
-      const summaries = listSessionSummaries(historyLimit, chatId);
-      if (summaries.length === 0) {
-        await channel.sendText(chatId, "No session history yet. History is saved automatically when you use /newchat.", "plain");
-        return;
+      const query = commandArgs?.trim() ?? "";
+      if (query) {
+        const results = searchMessageLog(chatId, query, 20);
+        if (results.length === 0) {
+          await channel.sendText(chatId, `No matching history found. Try /memories ${query} for older sessions.`, "plain");
+          break;
+        }
+        const lines = [`\u{1F4CB} History: "${query}"`, "\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"];
+        for (const row of results.slice(0, 10)) {
+          const roleLabel = row.role === "user" ? "You" : "Assistant";
+          const date = row.created_at.slice(0, 10);
+          const preview = row.content.slice(0, 300) + (row.content.length > 300 ? "\u2026" : "");
+          lines.push(`[${row.backend ?? "?"} \xB7 ${date}] ${roleLabel}: ${preview}`);
+        }
+        lines.push("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+        await channel.sendText(chatId, lines.join("\n"), "plain");
+      } else {
+        const rows = getRecentMessageLog(chatId, 20).reverse();
+        if (rows.length === 0) {
+          await channel.sendText(chatId, "No conversation history found.", "plain");
+          break;
+        }
+        const lines = ["\u{1F4CB} Recent conversation (last 10 exchanges):", "\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"];
+        for (const row of rows) {
+          const roleLabel = row.role === "user" ? "You" : "Assistant";
+          const date = row.created_at.slice(0, 10);
+          const preview = row.content.slice(0, 300) + (row.content.length > 300 ? "\u2026" : "");
+          lines.push(`[${row.backend ?? "?"} \xB7 ${date}] ${roleLabel}: ${preview}`);
+        }
+        lines.push("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+        await channel.sendText(chatId, lines.join("\n"), "plain");
       }
-      const lines = summaries.map((s) => {
-        const date = formatLocalDate(s.created_at);
-        const shortSummary = s.summary.length > 200 ? s.summary.slice(0, 200) + "\u2026" : s.summary;
-        return `${date} (${s.message_count} msgs)
-${shortSummary}
-Topics: ${s.topics}`;
-      });
-      await channel.sendText(chatId, lines.join("\n\n"), "plain");
       break;
     }
     case "skills": {
@@ -9876,8 +10294,8 @@ Use /skills to see it.`, "plain");
           if (!lim.max_input_tokens) continue;
           const u = getBackendUsageInWindow(lim.backend, lim.window);
           const pct = (u.input_tokens / lim.max_input_tokens * 100).toFixed(0);
-          const warn2 = u.input_tokens / lim.max_input_tokens >= lim.warn_pct;
-          lines.push(`  ${lim.backend} (${lim.window}): ${pct}% of ${(lim.max_input_tokens / 1e3).toFixed(0)}K${warn2 ? " \u26A0\uFE0F" : ""}`);
+          const warn3 = u.input_tokens / lim.max_input_tokens >= lim.warn_pct;
+          lines.push(`  ${lim.backend} (${lim.window}): ${pct}% of ${(lim.max_input_tokens / 1e3).toFixed(0)}K${warn3 ? " \u26A0\uFE0F" : ""}`);
         }
       }
       await channel.sendText(chatId, lines.join("\n"), "plain");
@@ -10376,8 +10794,17 @@ async function handleText(msg, channel) {
     await channel.sendText(chatId, limitMsg, "plain");
     return;
   }
-  if (isChatBusy(chatId)) {
-    await channel.sendText(chatId, "I'm currently processing another request. Your message is queued and will be handled next.", "plain");
+  if (isChatBusy(chatId) && !bypassBusyCheck.delete(chatId)) {
+    if (typeof channel.sendKeyboard === "function") {
+      pendingInterrupts.set(chatId, { msg, channel });
+      await channel.sendKeyboard(chatId, "\u23F3 Agent is working on a request\u2026", [
+        [
+          { label: "\u{1F4E5} Queue message", data: `interrupt:queue:${chatId}` },
+          { label: "\u26A1 Send now", data: `interrupt:now:${chatId}` }
+        ]
+      ]);
+      return;
+    }
   }
   let typingActive = true;
   const typingLoop = async () => {
@@ -10395,12 +10822,57 @@ async function handleText(msg, channel) {
     const tMode = getMode(chatId);
     const tVerbose = getVerboseLevel(chatId);
     const tToolCb = tVerbose !== "off" ? makeToolActionCallback(chatId, channel, tVerbose) : void 0;
-    const response = await askAgent(chatId, text, { cwd: getCwd(chatId), model: model2, permMode: tMode, onToolAction: tToolCb });
+    const response = await askAgent(chatId, text, {
+      cwd: getCwd(chatId),
+      model: model2,
+      permMode: tMode,
+      onToolAction: tToolCb,
+      onCompaction: (cid) => {
+        channel.sendText(cid, "\u{1F4BE} Context saved to memory.").catch(() => {
+        });
+      }
+    });
     if (response.usage) addUsage(chatId, response.usage.input, response.usage.output, response.usage.cacheRead, model2);
+    if (response.text.includes("[NEED_PERMISSION]") && tMode !== "yolo") {
+      const cleanText = response.text.replace(/\[NEED_PERMISSION\]/g, "").trim();
+      await sendResponse(chatId, channel, cleanText, msg.messageId);
+      const targetMode = determineEscalationTarget(chatId, tMode);
+      storePendingEscalation(chatId, text);
+      if (typeof channel.sendKeyboard === "function") {
+        await channel.sendKeyboard(chatId, `Switch to ${targetMode} mode?`, [
+          [{ label: "Allow", data: `perm:escalate:${targetMode}` }, { label: "Deny", data: "perm:deny" }]
+        ]);
+      }
+      return;
+    }
     await sendResponse(chatId, channel, response.text, msg.messageId);
   } catch (err) {
     error("[router] Error:", err);
     const errMsg = errorMessage(err);
+    const errorClass = classifyError(err);
+    if (errorClass === "exhausted" && typeof channel.sendKeyboard === "function") {
+      const currentBackend = getBackend(chatId) ?? "claude";
+      const { getAllAdapters: getAllAdapters2 } = await Promise.resolve().then(() => (init_backends(), backends_exports));
+      const otherBackends = getAllAdapters2().filter((a) => a.id !== currentBackend);
+      if (otherBackends.length > 0) {
+        pendingFallbackMessages.set(chatId, { msg, channel });
+        const buttons = otherBackends.map((a) => ({
+          label: `\u{1F504} ${a.displayName}`,
+          data: `fallback:${a.id}:${chatId}`
+        }));
+        buttons.push({ label: "\u274C Wait", data: `fallback:wait:${chatId}` });
+        await channel.sendKeyboard(
+          chatId,
+          `\u26A0\uFE0F ${getAdapter(currentBackend).displayName} is out of usage.
+
+${errMsg}
+
+Switch to another backend?`,
+          [buttons]
+        );
+        return;
+      }
+    }
     const userMsg = diagnoseAgentError(errMsg, chatId);
     await channel.sendText(chatId, userMsg, "plain");
   } finally {
@@ -10505,16 +10977,48 @@ async function processFileSends2(chatId, channel, text) {
   }
   return text.replace(fileSendPattern, "").trim();
 }
+async function processImageGenerations(chatId, channel, text) {
+  const pattern = /\[GENERATE_IMAGE:(.+?)\]/g;
+  const prompts = [];
+  for (const match of text.matchAll(pattern)) {
+    prompts.push(match[1].trim());
+  }
+  if (prompts.length === 0) return text;
+  if (!isImageGenAvailable()) {
+    log("[router] [GENERATE_IMAGE] marker found but GEMINI_API_KEY not set");
+    return text.replace(pattern, "(Image generation unavailable \u2014 GEMINI_API_KEY not configured)").trim();
+  }
+  for (const prompt of prompts) {
+    try {
+      const result = await generateImage(prompt);
+      const file = await readFile5(result.filePath);
+      const name = result.filePath.split("/").pop() ?? "image.png";
+      await channel.sendFile(chatId, file, name);
+      if (result.text) {
+        await channel.sendText(chatId, result.text, "plain");
+      }
+    } catch (err) {
+      error(`[router] Image generation failed for "${prompt.slice(0, 50)}":`, err);
+      await channel.sendText(chatId, `Image generation failed: ${errorMessage(err)}`, "plain");
+    }
+  }
+  return text.replace(pattern, "").trim();
+}
 async function processReaction(chatId, channel, text, messageId) {
-  const reactPattern = /\[REACT:(.+?)\]/;
-  const match = text.match(reactPattern);
-  if (!match) return text;
-  const emoji = match[1].trim();
-  if (messageId && typeof channel.reactToMessage === "function" && ALLOWED_REACTION_EMOJIS.has(emoji)) {
-    channel.reactToMessage(chatId, messageId, emoji).catch(() => {
-    });
+  const reactPatternGlobal = /\[REACT:(.+?)\]/g;
+  if (!reactPatternGlobal.test(text)) return text;
+  let reacted = false;
+  reactPatternGlobal.lastIndex = 0;
+  let match;
+  while ((match = reactPatternGlobal.exec(text)) !== null) {
+    const emoji = match[1].trim();
+    if (!reacted && messageId && typeof channel.reactToMessage === "function" && ALLOWED_REACTION_EMOJIS.has(emoji)) {
+      channel.reactToMessage(chatId, messageId, emoji).catch(() => {
+      });
+      reacted = true;
+    }
   }
-  return text.replace(reactPattern, "").trim();
+  return text.replace(/\[REACT:(.+?)\]/g, "").trim();
 }
 async function sendResponse(chatId, channel, text, messageId) {
   text = await processReaction(chatId, channel, text, messageId);
@@ -10526,7 +11030,29 @@ async function sendResponse(chatId, channel, text, messageId) {
       ]);
     }
   }
-  const cleanText = await processFileSends2(chatId, channel, afterUpdates);
+  let afterHistory = afterUpdates;
+  const historySearchMatch = afterHistory.match(/\[HISTORY_SEARCH:([^\]]+)\]/);
+  if (historySearchMatch) {
+    afterHistory = afterHistory.replace(/\[HISTORY_SEARCH:[^\]]+\]/g, "").trim();
+    const hsQuery = historySearchMatch[1].trim();
+    const hsResults = searchMessageLog(chatId, hsQuery, 10);
+    if (hsResults.length > 0) {
+      const hsLines = [`\u{1F4CB} History: "${hsQuery}"`, "\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"];
+      for (const row of hsResults.slice(0, 8)) {
+        const label2 = row.role === "user" ? "You" : "Assistant";
+        const date = row.created_at.slice(0, 10);
+        hsLines.push(`[${row.backend ?? "?"} \xB7 ${date}] ${label2}: ${row.content.slice(0, 250)}${row.content.length > 250 ? "\u2026" : ""}`);
+      }
+      hsLines.push("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+      channel.sendText(chatId, hsLines.join("\n")).catch(() => {
+      });
+    } else {
+      channel.sendText(chatId, `No history found for "${hsQuery}". Try /memories ${hsQuery} for older sessions.`).catch(() => {
+      });
+    }
+  }
+  const afterFiles = await processFileSends2(chatId, channel, afterHistory);
+  const cleanText = await processImageGenerations(chatId, channel, afterFiles);
   if (!cleanText) return;
   if (isVoiceEnabled(chatId)) {
     try {
@@ -10551,16 +11077,17 @@ async function sendBackendSwitchConfirmation(chatId, target, channel) {
     await channel.sendText(chatId, `Already using ${targetAdapter.displayName}.`, "plain");
     return;
   }
-  const currentLabel = current ? getAdapter(current).displayName : "current backend";
   if (typeof channel.sendKeyboard === "function") {
     await channel.sendKeyboard(
       chatId,
-      `\u26A0\uFE0F Switching to ${targetAdapter.displayName} will summarize and reset your current session.
-
-What would you like to do?`,
+      `\u{1F504} Switch to ${targetAdapter.displayName}?
+Your conversation history is preserved. ${targetAdapter.displayName} will receive a summary of recent context and can access your full history on request.`,
       [
-        [{ label: `Stay on ${currentLabel}`, data: "backend_cancel" }],
-        [{ label: `Switch to ${targetAdapter.displayName} + summarize`, data: `backend_confirm:${target}` }]
+        [
+          { label: `Switch to ${targetAdapter.displayName}`, data: `backend_confirm:${target}` },
+          { label: `Switch + Clear History`, data: `backend_confirm_clear:${target}` }
+        ],
+        [{ label: "Cancel", data: `backend_cancel:${target}` }]
       ]
     );
   } else {
@@ -10568,21 +11095,21 @@ What would you like to do?`,
   }
 }
 async function doBackendSwitch(chatId, backendId, channel) {
-  summarizeSession(chatId).catch(() => {
-  });
+  const targetAdapter = getAdapter(backendId);
+  const summarized = await summarizeWithFallbackChain(chatId, backendId);
+  if (summarized) {
+    await channel.sendText(chatId, `\u{1F4BE} Context saved \u2014 ${targetAdapter.displayName} summarized your session.`, "plain");
+  }
+  const bridge = buildContextBridge(chatId);
+  if (bridge) {
+    setPendingContextBridge(chatId, bridge);
+  }
   clearSession(chatId);
   clearModel(chatId);
   clearThinkingLevel(chatId);
   setBackend(chatId, backendId);
-  const adapter = getAdapter(backendId);
-  logActivity(getDb(), { chatId, source: "telegram", eventType: "config_changed", summary: `Backend switched to ${adapter.displayName}`, detail: { field: "backend", value: backendId } });
-  await channel.sendText(
-    chatId,
-    `Backend switched to ${adapter.displayName}.
-Default model: ${adapter.defaultModel}
-Session reset. Ready!`,
-    "plain"
-  );
+  logActivity(getDb(), { chatId, source: "telegram", eventType: "config_changed", summary: `Backend switched to ${targetAdapter.displayName}`, detail: { field: "backend", value: backendId } });
+  await channel.sendText(chatId, `\u2705 Switched to ${targetAdapter.displayName}. Ready!`, "plain");
 }
 async function handleCallback(chatId, data, channel) {
   if (data.startsWith("backend:")) {
@@ -10595,14 +11122,17 @@ async function handleCallback(chatId, data, channel) {
       return;
     }
     await sendBackendSwitchConfirmation(chatId, chosen, channel);
+  } else if (data.startsWith("backend_confirm_clear:")) {
+    const target = data.slice(21);
+    if (!getAllBackendIds().includes(target)) return;
+    clearMessageLog(chatId);
+    await doBackendSwitch(chatId, target, channel);
   } else if (data.startsWith("backend_confirm:")) {
     const chosen = data.slice(16);
     if (!getAllBackendIds().includes(chosen)) return;
     await doBackendSwitch(chatId, chosen, channel);
-  } else if (data === "backend_cancel") {
-    const current = getBackend(chatId);
-    const label2 = current ? getAdapter(current).displayName : "current backend";
-    await channel.sendText(chatId, `No change. Staying on ${label2}.`, "plain");
+  } else if (data.startsWith("backend_cancel:") || data === "backend_cancel") {
+    await channel.sendText(chatId, "Switch cancelled.", "plain");
   } else if (data.startsWith("model:")) {
     const chosen = data.slice(6);
     let adapter;
@@ -10657,7 +11187,8 @@ Select thinking/effort level:`,
       await channel.sendText(chatId, `Summarizer pinned to ${bk}:${mdl ?? "default"}.`, "plain");
     }
   } else if (data.startsWith("perms:")) {
-    const chosen = data.slice(6);
+    let chosen = data.slice(6);
+    if (chosen === "readonly") chosen = "plan";
     if (!PERM_MODES[chosen]) return;
     const previous = getMode(chatId);
     if (chosen === previous) {
@@ -10672,6 +11203,20 @@ Select thinking/effort level:`,
 ${PERM_MODES[chosen]}`,
       "plain"
     );
+  } else if (data.startsWith("perm:escalate:")) {
+    const targetMode = data.slice(14);
+    if (!PERM_MODES[targetMode]) return;
+    setMode(chatId, targetMode);
+    logActivity(getDb(), { chatId, source: "telegram", eventType: "config_changed", summary: `Permission escalated to ${targetMode}`, detail: { field: "permissions", value: targetMode } });
+    await channel.sendText(chatId, `Switched to ${targetMode} mode. Re-processing your request...`, "plain");
+    const pending = getPendingEscalation(chatId);
+    if (pending) {
+      removePendingEscalation(chatId);
+      await handleMessage({ text: pending, chatId, source: "telegram" }, channel);
+    }
+  } else if (data === "perm:deny") {
+    removePendingEscalation(chatId);
+    await channel.sendText(chatId, "Keeping current mode.", "plain");
   } else if (data.startsWith("verbose:")) {
     const chosen = data.slice(8);
     if (!VERBOSE_LEVELS[chosen]) return;
@@ -10746,6 +11291,47 @@ ${PERM_MODES[chosen]}`,
     touchBookmark(chatId, alias);
     logActivity(getDb(), { chatId, source: "telegram", eventType: "config_changed", summary: `Working directory set to ${bookmark.path}`, detail: { field: "cwd", value: bookmark.path } });
     await sendCwdSessionChoice(chatId, bookmark.path, channel);
+  } else if (data.startsWith("interrupt:")) {
+    const parts = data.split(":");
+    const action = parts[1];
+    const targetChatId = parts.slice(2).join(":");
+    const pending = pendingInterrupts.get(targetChatId);
+    if (action === "now" && pending) {
+      pendingInterrupts.delete(targetChatId);
+      stopAgent(targetChatId);
+      await channel.sendText(chatId, "\u26A1 Stopping current task and processing your message\u2026", "plain");
+      await new Promise((r) => setTimeout(r, 500));
+      await handleMessage(pending.msg, pending.channel);
+    } else if (action === "queue" && pending) {
+      pendingInterrupts.delete(targetChatId);
+      bypassBusyCheck.add(targetChatId);
+      await channel.sendText(chatId, "\u{1F4E5} Message queued \u2014 will process after current task.", "plain");
+      handleMessage(pending.msg, pending.channel).catch(() => {
+      });
+    } else {
+      await channel.sendText(chatId, "Message already processed or expired.", "plain");
+    }
+  } else if (data.startsWith("fallback:")) {
+    const parts = data.split(":");
+    const targetBackend = parts[1];
+    const targetChatId = parts[2];
+    const pendingMsg = pendingFallbackMessages.get(targetChatId);
+    if (targetBackend === "wait") {
+      pendingFallbackMessages.delete(targetChatId);
+      await channel.sendText(chatId, "OK \u2014 you can switch manually with /backend when ready.", "plain");
+    } else if (pendingMsg) {
+      pendingFallbackMessages.delete(targetChatId);
+      await summarizeWithFallbackChain(targetChatId, targetBackend);
+      const bridge = buildContextBridge(targetChatId);
+      if (bridge) setPendingContextBridge(targetChatId, bridge);
+      clearSession(targetChatId);
+      setBackend(targetChatId, targetBackend);
+      const adapter = getAdapter(targetBackend);
+      await channel.sendText(chatId, `Switched to ${adapter.displayName}. Resending your message\u2026`, "plain");
+      await handleMessage(pendingMsg.msg, pendingMsg.channel);
+    } else {
+      await channel.sendText(chatId, "Fallback expired. Use /backend to switch manually.", "plain");
+    }
   } else if (data.startsWith("skills:page:")) {
     const page = parseInt(data.slice(12), 10);
     const skills2 = await discoverAllSkills();
@@ -10957,7 +11543,7 @@ Use /skills <page> to navigate (e.g. /skills 2)` : "";
   const header2 = totalPages > 1 ? `${skills2.length} skills (page ${safePage}/${totalPages}). Select one to invoke:` : `${skills2.length} skills available. Select one to invoke:`;
   await channel.sendKeyboard(chatId, header2, buttons);
 }
-var PERM_MODES, VERBOSE_LEVELS, CLI_INSTALL_HINTS, BLOCKED_PATH_PATTERNS2, ALLOWED_REACTION_EMOJIS, SKILLS_PER_PAGE;
+var PERM_MODES, VERBOSE_LEVELS, pendingInterrupts, bypassBusyCheck, pendingFallbackMessages, CLI_INSTALL_HINTS, BLOCKED_PATH_PATTERNS2, ALLOWED_REACTION_EMOJIS, SKILLS_PER_PAGE;
 var init_router = __esm({
   "src/router.ts"() {
     "use strict";
@@ -10968,9 +11554,13 @@ var init_router = __esm({
     init_log();
     init_format_time();
     init_agent();
+    init_retry();
+    init_image_gen();
     init_stt();
     init_store4();
     init_summarize();
+    init_inject();
+    init_store4();
     init_session_log();
     init_backends();
     init_cron();
@@ -10988,14 +11578,16 @@ var init_router = __esm({
     PERM_MODES = {
       yolo: "YOLO \u2014 all tools, full autopilot",
       safe: "Safe \u2014 only my allowed tools",
-      readonly: "Read-only \u2014 Read, Glob, Grep only",
-      plan: "Plan \u2014 plan only, no execution"
+      plan: "Plan \u2014 read and analyze only"
     };
     VERBOSE_LEVELS = {
       off: "Off \u2014 no tool visibility",
       normal: "Normal \u2014 summarized actions",
       verbose: "Verbose \u2014 full details"
     };
+    pendingInterrupts = /* @__PURE__ */ new Map();
+    bypassBusyCheck = /* @__PURE__ */ new Set();
+    pendingFallbackMessages = /* @__PURE__ */ new Map();
     CLI_INSTALL_HINTS = {
       claude: "Install: npm install -g @anthropic-ai/claude-code",
       gemini: "Install: npm install -g @anthropic-ai/gemini-cli",
@@ -11090,19 +11682,19 @@ var init_router = __esm({
 });
 
 // src/skills/bootstrap.ts
-import { existsSync as existsSync13 } from "fs";
+import { existsSync as existsSync14 } from "fs";
 import { readdir as readdir3, readFile as readFile6, writeFile as writeFile3, copyFile } from "fs/promises";
-import { join as join14, dirname as dirname3 } from "path";
+import { join as join15, dirname as dirname3 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 async function copyAgentManifestSkills() {
-  if (!existsSync13(PKG_SKILLS)) return;
+  if (!existsSync14(PKG_SKILLS)) return;
   try {
     const entries = await readdir3(PKG_SKILLS, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isFile() || !entry.name.startsWith("agent-") || !entry.name.endsWith(".md")) continue;
-      const src = join14(PKG_SKILLS, entry.name);
-      const dest = join14(SKILLS_PATH, entry.name);
-      if (existsSync13(dest)) continue;
+      const src = join15(PKG_SKILLS, entry.name);
+      const dest = join15(SKILLS_PATH, entry.name);
+      if (existsSync14(dest)) continue;
       await copyFile(src, dest);
       log(`[skills] Bootstrapped ${entry.name} to ${SKILLS_PATH}`);
     }
@@ -11112,8 +11704,8 @@ async function copyAgentManifestSkills() {
 }
 async function bootstrapSkills() {
   await copyAgentManifestSkills();
-  const usmDir = join14(SKILLS_PATH, USM_DIR_NAME);
-  if (existsSync13(usmDir)) return;
+  const usmDir = join15(SKILLS_PATH, USM_DIR_NAME);
+  if (existsSync14(usmDir)) return;
   try {
     const entries = await readdir3(SKILLS_PATH);
     const dirs = entries.filter((e) => !e.startsWith("."));
@@ -11135,8 +11727,8 @@ async function bootstrapSkills() {
   }
 }
 async function patchUsmForCcClaw(usmDir) {
-  const skillPath = join14(usmDir, "SKILL.md");
-  if (!existsSync13(skillPath)) return;
+  const skillPath = join15(usmDir, "SKILL.md");
+  if (!existsSync14(skillPath)) return;
   try {
     let content = await readFile6(skillPath, "utf-8");
     let patched = false;
@@ -11181,8 +11773,8 @@ var init_bootstrap = __esm({
     USM_REPO = "jacob-bd/universal-skills-manager";
     USM_DIR_NAME = "universal-skills-manager";
     CC_CLAW_ECOSYSTEM_PATCH = `| **CC-Claw** | \`~/.cc-claw/workspace/skills/\` | N/A (daemon, no project scope) |`;
-    PKG_ROOT = join14(dirname3(fileURLToPath3(import.meta.url)), "..", "..");
-    PKG_SKILLS = join14(PKG_ROOT, "skills");
+    PKG_ROOT = join15(dirname3(fileURLToPath3(import.meta.url)), "..", "..");
+    PKG_SKILLS = join15(PKG_ROOT, "skills");
   }
 });
 
@@ -11396,13 +11988,13 @@ __export(ai_skill_exports, {
   generateAiSkill: () => generateAiSkill,
   installAiSkill: () => installAiSkill
 });
-import { existsSync as existsSync14, writeFileSync as writeFileSync5, mkdirSync as mkdirSync5 } from "fs";
-import { join as join15 } from "path";
+import { existsSync as existsSync15, writeFileSync as writeFileSync6, mkdirSync as mkdirSync6 } from "fs";
+import { join as join16 } from "path";
 import { homedir as homedir4 } from "os";
 function generateAiSkill() {
   const version = VERSION;
   let systemState = "";
-  if (existsSync14(DB_PATH)) {
+  if (existsSync15(DB_PATH)) {
     try {
       const { openDatabaseReadOnly: openDatabaseReadOnly2 } = (init_store4(), __toCommonJS(store_exports3));
       const readDb = openDatabaseReadOnly2();
@@ -11467,11 +12059,10 @@ cc-claw logs --error                     # Show error log
 \`\`\`bash
 cc-claw backend list --json              # Available backends
 cc-claw backend get --json               # Active backend
-cc-claw backend set claude               # Switch backend
+cc-claw backend set claude               # Switch backend (claude/gemini/codex)
 cc-claw model list --json                # Models for active backend
+cc-claw model get --json                 # Active model
 cc-claw model set claude-opus-4-6        # Switch model
-cc-claw thinking get --json              # Current thinking level
-cc-claw thinking set high                # Set thinking level
 \`\`\`
 
 ### Chat
@@ -11491,12 +12082,23 @@ cc-claw memory add "key" "value"         # Save a memory (needs daemon)
 cc-claw memory forget "keyword"          # Delete memories (needs daemon)
 \`\`\`
 
+### Session
+\`\`\`bash
+cc-claw session get --json               # Current session ID and age
+cc-claw session new                      # Clear session (newchat + summarize)
+\`\`\`
+
 ### Scheduler (cron/schedule are aliases)
 \`\`\`bash
 cc-claw cron list --json                 # All scheduled jobs
 cc-claw cron health --json               # Scheduler health
 cc-claw cron runs --json                 # Run history
 cc-claw cron create --description "Morning briefing" --cron "0 9 * * *" --backend claude
+cc-claw cron edit 3 --model gemini-3-flash-preview  # Change job model
+cc-claw cron edit 3 --backend gemini --model gemini-3-flash-preview  # Change backend + model
+cc-claw cron edit 3 --description "New task" --timeout 300  # Edit multiple fields
+cc-claw cron create --description "Report" --cron "0 9 * * *" --backend claude --model claude-sonnet-4-6   --fallback codex:gpt-5.4 --fallback gemini:gemini-3-flash-preview  # With fallback chain
+cc-claw cron edit 3 --fallback codex:gpt-5.4 --fallback gemini:gemini-3-flash-preview  # Set fallbacks
 cc-claw cron cancel 3                    # Cancel job #3
 cc-claw cron pause 3                     # Pause job
 cc-claw cron resume 3                    # Resume job
@@ -11527,7 +12129,14 @@ cc-claw usage cost --json                # Session cost estimate
 cc-claw usage cost --all --json          # All-time cost by model
 cc-claw usage tokens --json              # Backend usage in last 24h
 cc-claw usage limits list --json         # Current limits
-cc-claw usage limits set claude daily 500000
+cc-claw usage limits set claude daily 500000  # Set a limit
+cc-claw usage limits clear claude daily  # Remove a limit
+\`\`\`
+
+### Thinking / Reasoning
+\`\`\`bash
+cc-claw thinking get --json              # Current thinking level
+cc-claw thinking set high                # Set level (auto/off/low/medium/high/extra_high)
 \`\`\`
 
 ### Permissions & Tools
@@ -11537,10 +12146,71 @@ cc-claw permissions set yolo             # Set mode (yolo/safe/readonly/plan)
 cc-claw tools list --json                # Tools with enabled/disabled status
 cc-claw tools enable Bash                # Enable a tool
 cc-claw tools disable WebFetch           # Disable a tool
+cc-claw tools reset                      # Reset to defaults (all on)
 cc-claw verbose get --json               # Tool visibility level
 cc-claw verbose set verbose              # Set level (off/normal/verbose)
 \`\`\`
 
+### Working Directory
+\`\`\`bash
+cc-claw cwd get --json                   # Show current working directory
+cc-claw cwd set /path/to/dir             # Set working directory
+cc-claw cwd clear                        # Reset to default
+\`\`\`
+
+### Voice
+\`\`\`bash
+cc-claw voice get --json                 # Show voice status
+cc-claw voice set on                     # Enable voice responses
+cc-claw voice set off                    # Disable voice responses
+\`\`\`
+
+### Image Generation
+\`\`\`bash
+# Via Telegram command:
+/imagine a futuristic city at sunset     # Generate image from prompt
+/image a cat astronaut on Mars           # Alias for /imagine
+
+# Via AI marker in responses:
+# The AI can write [GENERATE_IMAGE:prompt] in its response to trigger generation
+# Requires GEMINI_API_KEY in ~/.cc-claw/.env
+\`\`\`
+
+### Heartbeat
+\`\`\`bash
+cc-claw heartbeat get --json             # Show heartbeat config
+cc-claw heartbeat set on                 # Enable proactive awareness
+cc-claw heartbeat set off                # Disable heartbeat
+cc-claw heartbeat set interval 30m       # Set check interval
+cc-claw heartbeat set hours 9-22         # Set active hours
+\`\`\`
+
+### Summarizer
+\`\`\`bash
+cc-claw summarizer get --json            # Current summarizer config
+cc-claw summarizer set auto              # Auto (use active backend's summarizer)
+cc-claw summarizer set off               # Disable summarization
+cc-claw summarizer set claude:claude-haiku-4-5  # Pin specific backend:model
+\`\`\`
+
+### Chat Aliases
+\`\`\`bash
+cc-claw chats list --json                # Authorized chats and aliases
+cc-claw chats alias 123456789 "work"     # Set alias for a chat
+cc-claw chats remove-alias "work"        # Remove alias
+\`\`\`
+
+### Skills
+\`\`\`bash
+cc-claw skills list --json               # All skills from all backends
+cc-claw skills install <github-url>      # Install skill from GitHub
+\`\`\`
+
+### MCP Servers
+\`\`\`bash
+cc-claw mcps list --json                 # Registered MCP servers
+\`\`\`
+
 ### Database
 \`\`\`bash
 cc-claw db stats --json                  # Row counts, file size, WAL status
@@ -11561,15 +12231,10 @@ cc-claw service uninstall               # Remove service
 
 ### Other
 \`\`\`bash
-cc-claw skills list --json               # Available skills
-cc-claw mcps list --json                 # MCP servers
-cc-claw chats list --json                # Chat aliases
-cc-claw session get --json               # Current session
-cc-claw session new                      # Clear session
-cc-claw cwd get --json                   # Working directory
-cc-claw voice get --json                 # Voice status
-cc-claw heartbeat get --json             # Heartbeat config
-cc-claw summarizer get --json            # Summarizer config
+cc-claw setup                            # Interactive configuration wizard
+cc-claw tui                              # Interactive terminal chat
+cc-claw completion --shell zsh           # Generate shell completions (bash/zsh/fish)
+cc-claw --ai                             # Generate/install SKILL.md for AI tools
 \`\`\`
 
 ## JSON Output Format
@@ -11625,11 +12290,11 @@ function installAiSkill() {
   const failed = [];
   for (const [backend2, dirs] of Object.entries(BACKEND_SKILL_DIRS2)) {
     for (const dir of dirs) {
-      const skillDir = join15(dir, "cc-claw-cli");
-      const skillPath = join15(skillDir, "SKILL.md");
+      const skillDir = join16(dir, "cc-claw-cli");
+      const skillPath = join16(skillDir, "SKILL.md");
       try {
-        mkdirSync5(skillDir, { recursive: true });
-        writeFileSync5(skillPath, skill, "utf-8");
+        mkdirSync6(skillDir, { recursive: true });
+        writeFileSync6(skillPath, skill, "utf-8");
         installed.push(skillPath);
       } catch {
         failed.push(skillPath);
@@ -11645,10 +12310,10 @@ var init_ai_skill = __esm({
     init_paths();
     init_version();
     BACKEND_SKILL_DIRS2 = {
-      "cc-claw": [join15(homedir4(), ".cc-claw", "workspace", "skills")],
-      claude: [join15(homedir4(), ".claude", "skills")],
-      gemini: [join15(homedir4(), ".gemini", "skills")],
-      codex: [join15(homedir4(), ".agents", "skills")]
+      "cc-claw": [join16(homedir4(), ".cc-claw", "workspace", "skills")],
+      claude: [join16(homedir4(), ".claude", "skills")],
+      gemini: [join16(homedir4(), ".gemini", "skills")],
+      codex: [join16(homedir4(), ".agents", "skills")]
     };
   }
 });
@@ -11658,21 +12323,21 @@ var index_exports = {};
 __export(index_exports, {
   main: () => main
 });
-import { mkdirSync as mkdirSync6, existsSync as existsSync15, renameSync, statSync as statSync3 } from "fs";
-import { join as join16 } from "path";
+import { mkdirSync as mkdirSync7, existsSync as existsSync16, renameSync, statSync as statSync2, readFileSync as readFileSync10 } from "fs";
+import { join as join17 } from "path";
 import dotenv from "dotenv";
 function migrateLayout() {
   const moves = [
-    [join16(CC_CLAW_HOME, "cc-claw.db"), join16(DATA_PATH, "cc-claw.db")],
-    [join16(CC_CLAW_HOME, "cc-claw.db-shm"), join16(DATA_PATH, "cc-claw.db-shm")],
-    [join16(CC_CLAW_HOME, "cc-claw.db-wal"), join16(DATA_PATH, "cc-claw.db-wal")],
-    [join16(CC_CLAW_HOME, "cc-claw.log"), join16(LOGS_PATH, "cc-claw.log")],
-    [join16(CC_CLAW_HOME, "cc-claw.log.1"), join16(LOGS_PATH, "cc-claw.log.1")],
-    [join16(CC_CLAW_HOME, "cc-claw.error.log"), join16(LOGS_PATH, "cc-claw.error.log")],
-    [join16(CC_CLAW_HOME, "cc-claw.error.log.1"), join16(LOGS_PATH, "cc-claw.error.log.1")]
+    [join17(CC_CLAW_HOME, "cc-claw.db"), join17(DATA_PATH, "cc-claw.db")],
+    [join17(CC_CLAW_HOME, "cc-claw.db-shm"), join17(DATA_PATH, "cc-claw.db-shm")],
+    [join17(CC_CLAW_HOME, "cc-claw.db-wal"), join17(DATA_PATH, "cc-claw.db-wal")],
+    [join17(CC_CLAW_HOME, "cc-claw.log"), join17(LOGS_PATH, "cc-claw.log")],
+    [join17(CC_CLAW_HOME, "cc-claw.log.1"), join17(LOGS_PATH, "cc-claw.log.1")],
+    [join17(CC_CLAW_HOME, "cc-claw.error.log"), join17(LOGS_PATH, "cc-claw.error.log")],
+    [join17(CC_CLAW_HOME, "cc-claw.error.log.1"), join17(LOGS_PATH, "cc-claw.error.log.1")]
   ];
   for (const [from, to] of moves) {
-    if (existsSync15(from) && !existsSync15(to)) {
+    if (existsSync16(from) && !existsSync16(to)) {
       try {
         renameSync(from, to);
       } catch {
@@ -11683,7 +12348,7 @@ function migrateLayout() {
 function rotateLogs() {
   for (const file of [LOG_PATH, ERROR_LOG_PATH]) {
     try {
-      const { size } = statSync3(file);
+      const { size } = statSync2(file);
       if (size > LOG_MAX_BYTES) {
         const archivePath = `${file}.1`;
         try {
@@ -11698,14 +12363,21 @@ function rotateLogs() {
 }
 async function main() {
   rotateLogs();
-  log("[cc-claw] Starting up...");
+  let version = "unknown";
+  try {
+    const pkgPath = new URL("../package.json", import.meta.url);
+    version = JSON.parse(readFileSync10(pkgPath, "utf-8")).version;
+  } catch {
+  }
+  log(`[cc-claw] Starting v${version}`);
   initDatabase();
+  pruneMessageLog(30, 2e3);
   bootstrapBuiltinMcps(getDb());
-  const SUMMARIZE_TIMEOUT_MS = 3e4;
+  const SUMMARIZE_TIMEOUT_MS2 = 3e4;
   try {
     let timer;
     const timeoutPromise = new Promise((_, reject) => {
-      timer = setTimeout(() => reject(new Error("timeout")), SUMMARIZE_TIMEOUT_MS);
+      timer = setTimeout(() => reject(new Error("timeout")), SUMMARIZE_TIMEOUT_MS2);
     });
     try {
       await Promise.race([
@@ -11767,11 +12439,11 @@ async function main() {
   bootstrapSkills().catch((err) => error("[cc-claw] Skill bootstrap failed:", err));
   try {
     const { generateAiSkill: generateAiSkill2 } = await Promise.resolve().then(() => (init_ai_skill(), ai_skill_exports));
-    const { writeFileSync: writeFileSync8, mkdirSync: mkdirSync10 } = await import("fs");
-    const { join: join19 } = await import("path");
-    const skillDir = join19(SKILLS_PATH, "cc-claw-cli");
-    mkdirSync10(skillDir, { recursive: true });
-    writeFileSync8(join19(skillDir, "SKILL.md"), generateAiSkill2(), "utf-8");
+    const { writeFileSync: writeFileSync9, mkdirSync: mkdirSync11 } = await import("fs");
+    const { join: join20 } = await import("path");
+    const skillDir = join20(SKILLS_PATH, "cc-claw-cli");
+    mkdirSync11(skillDir, { recursive: true });
+    writeFileSync9(join20(skillDir, "SKILL.md"), generateAiSkill2(), "utf-8");
     log("[cc-claw] AI skill updated");
   } catch {
   }
@@ -11831,10 +12503,10 @@ var init_index = __esm({
     init_bootstrap2();
     init_health3();
     for (const dir of [CC_CLAW_HOME, DATA_PATH, LOGS_PATH, SKILLS_PATH, RUNNERS_PATH, AGENTS_PATH]) {
-      if (!existsSync15(dir)) mkdirSync6(dir, { recursive: true });
+      if (!existsSync16(dir)) mkdirSync7(dir, { recursive: true });
     }
     migrateLayout();
-    if (existsSync15(ENV_PATH)) {
+    if (existsSync16(ENV_PATH)) {
       dotenv.config({ path: ENV_PATH });
     } else {
       console.error(`[cc-claw] Config not found at ${ENV_PATH} \u2014 run 'cc-claw setup' first`);
@@ -11855,10 +12527,10 @@ __export(service_exports, {
   serviceStatus: () => serviceStatus,
   uninstallService: () => uninstallService
 });
-import { existsSync as existsSync16, mkdirSync as mkdirSync7, writeFileSync as writeFileSync6, unlinkSync as unlinkSync2 } from "fs";
+import { existsSync as existsSync17, mkdirSync as mkdirSync8, writeFileSync as writeFileSync7, unlinkSync as unlinkSync2 } from "fs";
 import { execFileSync as execFileSync2, execSync as execSync5 } from "child_process";
 import { homedir as homedir5, platform } from "os";
-import { join as join17, dirname as dirname4 } from "path";
+import { join as join18, dirname as dirname4 } from "path";
 function resolveExecutable2(name) {
   try {
     return execFileSync2("which", [name], { encoding: "utf-8" }).trim();
@@ -11871,14 +12543,14 @@ function getPathDirs() {
   const home = homedir5();
   const dirs = /* @__PURE__ */ new Set([
     nodeBin,
-    join17(home, ".local", "bin"),
+    join18(home, ".local", "bin"),
     "/usr/local/bin",
     "/usr/bin",
     "/bin"
   ]);
   try {
     const prefix = execSync5("npm config get prefix", { encoding: "utf-8" }).trim();
-    if (prefix) dirs.add(join17(prefix, "bin"));
+    if (prefix) dirs.add(join18(prefix, "bin"));
   } catch {
   }
   return [...dirs].join(":");
@@ -11933,21 +12605,21 @@ function generatePlist() {
 }
 function installMacOS() {
   const agentsDir = dirname4(PLIST_PATH);
-  if (!existsSync16(agentsDir)) mkdirSync7(agentsDir, { recursive: true });
-  if (!existsSync16(LOGS_PATH)) mkdirSync7(LOGS_PATH, { recursive: true });
-  if (existsSync16(PLIST_PATH)) {
+  if (!existsSync17(agentsDir)) mkdirSync8(agentsDir, { recursive: true });
+  if (!existsSync17(LOGS_PATH)) mkdirSync8(LOGS_PATH, { recursive: true });
+  if (existsSync17(PLIST_PATH)) {
     try {
       execFileSync2("launchctl", ["unload", PLIST_PATH]);
     } catch {
     }
   }
-  writeFileSync6(PLIST_PATH, generatePlist());
+  writeFileSync7(PLIST_PATH, generatePlist());
   console.log(`  Installed: ${PLIST_PATH}`);
   execFileSync2("launchctl", ["load", PLIST_PATH]);
   console.log("  Service loaded and starting.");
 }
 function uninstallMacOS() {
-  if (!existsSync16(PLIST_PATH)) {
+  if (!existsSync17(PLIST_PATH)) {
     console.log("  No service found to uninstall.");
     return;
   }
@@ -11998,9 +12670,9 @@ WantedBy=default.target
 `;
 }
 function installLinux() {
-  if (!existsSync16(SYSTEMD_DIR)) mkdirSync7(SYSTEMD_DIR, { recursive: true });
-  if (!existsSync16(LOGS_PATH)) mkdirSync7(LOGS_PATH, { recursive: true });
-  writeFileSync6(UNIT_PATH, generateUnit());
+  if (!existsSync17(SYSTEMD_DIR)) mkdirSync8(SYSTEMD_DIR, { recursive: true });
+  if (!existsSync17(LOGS_PATH)) mkdirSync8(LOGS_PATH, { recursive: true });
+  writeFileSync7(UNIT_PATH, generateUnit());
   console.log(`  Installed: ${UNIT_PATH}`);
   execFileSync2("systemctl", ["--user", "daemon-reload"]);
   execFileSync2("systemctl", ["--user", "enable", "cc-claw"]);
@@ -12008,7 +12680,7 @@ function installLinux() {
   console.log("  Service enabled and started.");
 }
 function uninstallLinux() {
-  if (!existsSync16(UNIT_PATH)) {
+  if (!existsSync17(UNIT_PATH)) {
     console.log("  No service found to uninstall.");
     return;
   }
@@ -12033,7 +12705,7 @@ function statusLinux() {
   }
 }
 function installService() {
-  if (!existsSync16(join17(CC_CLAW_HOME, ".env"))) {
+  if (!existsSync17(join18(CC_CLAW_HOME, ".env"))) {
     console.error(`  Config not found at ${CC_CLAW_HOME}/.env`);
     console.error("  Run 'cc-claw setup' before installing the service.");
     process.exitCode = 1;
@@ -12062,9 +12734,9 @@ var init_service = __esm({
     "use strict";
     init_paths();
     PLIST_LABEL = "com.cc-claw";
-    PLIST_PATH = join17(homedir5(), "Library", "LaunchAgents", `${PLIST_LABEL}.plist`);
-    SYSTEMD_DIR = join17(homedir5(), ".config", "systemd", "user");
-    UNIT_PATH = join17(SYSTEMD_DIR, "cc-claw.service");
+    PLIST_PATH = join18(homedir5(), "Library", "LaunchAgents", `${PLIST_LABEL}.plist`);
+    SYSTEMD_DIR = join18(homedir5(), ".config", "systemd", "user");
+    UNIT_PATH = join18(SYSTEMD_DIR, "cc-claw.service");
   }
 });
 
@@ -12231,13 +12903,13 @@ var init_daemon = __esm({
 });
 
 // src/cli/resolve-chat.ts
-import { readFileSync as readFileSync11 } from "fs";
+import { readFileSync as readFileSync12 } from "fs";
 function resolveChatId(globalOpts) {
   const explicit = globalOpts.chat;
   if (explicit) return explicit;
   if (_cachedDefault) return _cachedDefault;
   try {
-    const content = readFileSync11(ENV_PATH, "utf-8");
+    const content = readFileSync12(ENV_PATH, "utf-8");
     const match = content.match(/^ALLOWED_CHAT_ID=(.+)$/m);
     if (match) {
       _cachedDefault = match[1].split(",")[0].trim();
@@ -12263,12 +12935,12 @@ __export(api_client_exports, {
   apiPost: () => apiPost,
   isDaemonRunning: () => isDaemonRunning
 });
-import { readFileSync as readFileSync12, existsSync as existsSync17 } from "fs";
+import { readFileSync as readFileSync13, existsSync as existsSync18 } from "fs";
 import { request as httpRequest } from "http";
 function getToken() {
   if (process.env.CC_CLAW_API_TOKEN) return process.env.CC_CLAW_API_TOKEN;
   try {
-    if (existsSync17(TOKEN_PATH)) return readFileSync12(TOKEN_PATH, "utf-8").trim();
+    if (existsSync18(TOKEN_PATH)) return readFileSync13(TOKEN_PATH, "utf-8").trim();
   } catch {
   }
   return null;
@@ -12361,7 +13033,7 @@ var status_exports = {};
 __export(status_exports, {
   statusCommand: () => statusCommand
 });
-import { existsSync as existsSync18, statSync as statSync4 } from "fs";
+import { existsSync as existsSync19, statSync as statSync3 } from "fs";
 async function statusCommand(globalOpts, localOpts) {
   try {
     const { openDatabaseReadOnly: openDatabaseReadOnly2 } = await Promise.resolve().then(() => (init_store4(), store_exports3));
@@ -12401,7 +13073,7 @@ async function statusCommand(globalOpts, localOpts) {
     const cwdRow = readDb.prepare("SELECT cwd FROM chat_cwd WHERE chat_id = ?").get(chatId);
     const voiceRow = readDb.prepare("SELECT enabled FROM chat_voice WHERE chat_id = ?").get(chatId);
     const usageRow = readDb.prepare("SELECT * FROM chat_usage WHERE chat_id = ?").get(chatId);
-    const dbStat = existsSync18(DB_PATH) ? statSync4(DB_PATH) : null;
+    const dbStat = existsSync19(DB_PATH) ? statSync3(DB_PATH) : null;
     let daemonRunning = false;
     let daemonInfo = {};
     if (localOpts.deep) {
@@ -12492,12 +13164,12 @@ var doctor_exports = {};
 __export(doctor_exports, {
   doctorCommand: () => doctorCommand
 });
-import { existsSync as existsSync19, statSync as statSync5, accessSync, constants } from "fs";
+import { existsSync as existsSync20, statSync as statSync4, accessSync, constants } from "fs";
 import { execFileSync as execFileSync3 } from "child_process";
 async function doctorCommand(globalOpts, localOpts) {
   const checks = [];
-  if (existsSync19(DB_PATH)) {
-    const size = statSync5(DB_PATH).size;
+  if (existsSync20(DB_PATH)) {
+    const size = statSync4(DB_PATH).size;
     checks.push({ name: "Database", status: "ok", message: `${DB_PATH} (${(size / 1024).toFixed(0)}KB)` });
     try {
       const { openDatabaseReadOnly: openDatabaseReadOnly2 } = await Promise.resolve().then(() => (init_store4(), store_exports3));
@@ -12526,7 +13198,7 @@ async function doctorCommand(globalOpts, localOpts) {
   } else {
     checks.push({ name: "Database", status: "error", message: `Not found at ${DB_PATH}`, fix: "cc-claw setup" });
   }
-  if (existsSync19(ENV_PATH)) {
+  if (existsSync20(ENV_PATH)) {
     checks.push({ name: "Environment", status: "ok", message: `.env loaded` });
   } else {
     checks.push({ name: "Environment", status: "error", message: "No .env found", fix: "cc-claw setup" });
@@ -12566,7 +13238,7 @@ async function doctorCommand(globalOpts, localOpts) {
     checks.push({ name: "Daemon", status: "warning", message: "could not probe" });
   }
   const tokenPath = `${DATA_PATH}/api-token`;
-  if (existsSync19(tokenPath)) {
+  if (existsSync20(tokenPath)) {
     try {
       accessSync(tokenPath, constants.R_OK);
       checks.push({ name: "API token", status: "ok", message: "token file readable" });
@@ -12591,10 +13263,10 @@ async function doctorCommand(globalOpts, localOpts) {
     }
   } catch {
   }
-  if (existsSync19(ERROR_LOG_PATH)) {
+  if (existsSync20(ERROR_LOG_PATH)) {
     try {
-      const { readFileSync: readFileSync17 } = await import("fs");
-      const logContent = readFileSync17(ERROR_LOG_PATH, "utf-8");
+      const { readFileSync: readFileSync18 } = await import("fs");
+      const logContent = readFileSync18(ERROR_LOG_PATH, "utf-8");
       const recentLines = logContent.split("\n").filter(Boolean).slice(-100);
       const last24h = Date.now() - 864e5;
       const recentErrors = recentLines.filter((line) => {
@@ -12710,15 +13382,15 @@ var logs_exports = {};
 __export(logs_exports, {
   logsCommand: () => logsCommand
 });
-import { existsSync as existsSync20, readFileSync as readFileSync13, watchFile as watchFile2, unwatchFile as unwatchFile2 } from "fs";
+import { existsSync as existsSync21, readFileSync as readFileSync14, watchFile as watchFile2, unwatchFile as unwatchFile2 } from "fs";
 async function logsCommand(opts) {
   const logFile = opts.error ? ERROR_LOG_PATH : LOG_PATH;
-  if (!existsSync20(logFile)) {
+  if (!existsSync21(logFile)) {
     outputError("LOG_NOT_FOUND", `Log file not found: ${logFile}`);
     process.exit(1);
   }
   const maxLines = parseInt(opts.lines ?? "100", 10);
-  const content = readFileSync13(logFile, "utf-8");
+  const content = readFileSync14(logFile, "utf-8");
   const allLines = content.split("\n");
   const tailLines = allLines.slice(-maxLines);
   console.log(muted(`  \u2500\u2500 ${logFile} (last ${tailLines.length} lines) \u2500\u2500`));
@@ -12728,7 +13400,7 @@ async function logsCommand(opts) {
     let lastSize = Buffer.byteLength(content, "utf-8");
     watchFile2(logFile, { interval: 500 }, () => {
       try {
-        const newContent = readFileSync13(logFile, "utf-8");
+        const newContent = readFileSync14(logFile, "utf-8");
         const newSize = Buffer.byteLength(newContent, "utf-8");
         if (newSize > lastSize) {
           const newPart = newContent.slice(content.length);
@@ -12761,12 +13433,12 @@ __export(backend_exports, {
   backendList: () => backendList,
   backendSet: () => backendSet
 });
-import { existsSync as existsSync21 } from "fs";
+import { existsSync as existsSync22 } from "fs";
 async function backendList(globalOpts) {
   const { getAllAdapters: getAllAdapters2 } = await Promise.resolve().then(() => (init_backends(), backends_exports));
   const chatId = resolveChatId(globalOpts);
   let activeBackend = null;
-  if (existsSync21(DB_PATH)) {
+  if (existsSync22(DB_PATH)) {
     const { openDatabaseReadOnly: openDatabaseReadOnly2 } = await Promise.resolve().then(() => (init_store4(), store_exports3));
     const readDb = openDatabaseReadOnly2();
     try {
@@ -12797,7 +13469,7 @@ async function backendList(globalOpts) {
 }
 async function backendGet(globalOpts) {
   const chatId = resolveChatId(globalOpts);
-  if (!existsSync21(DB_PATH)) {
+  if (!existsSync22(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found. Run cc-claw setup first.");
     process.exit(1);
   }
@@ -12841,13 +13513,13 @@ __export(model_exports, {
   modelList: () => modelList,
   modelSet: () => modelSet
 });
-import { existsSync as existsSync22 } from "fs";
+import { existsSync as existsSync23 } from "fs";
 async function modelList(globalOpts) {
   const chatId = resolveChatId(globalOpts);
   const { openDatabaseReadOnly: openDatabaseReadOnly2 } = await Promise.resolve().then(() => (init_store4(), store_exports3));
   const { getAdapter: getAdapter2, getAllAdapters: getAllAdapters2 } = await Promise.resolve().then(() => (init_backends(), backends_exports));
   let backendId = "claude";
-  if (existsSync22(DB_PATH)) {
+  if (existsSync23(DB_PATH)) {
     const readDb = openDatabaseReadOnly2();
     try {
       const row = readDb.prepare("SELECT backend FROM chat_backend WHERE chat_id = ?").get(chatId);
@@ -12880,7 +13552,7 @@ async function modelList(globalOpts) {
 }
 async function modelGet(globalOpts) {
   const chatId = resolveChatId(globalOpts);
-  if (!existsSync22(DB_PATH)) {
+  if (!existsSync23(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -12924,9 +13596,9 @@ __export(memory_exports, {
   memoryList: () => memoryList,
   memorySearch: () => memorySearch
 });
-import { existsSync as existsSync23 } from "fs";
+import { existsSync as existsSync24 } from "fs";
 async function memoryList(globalOpts) {
-  if (!existsSync23(DB_PATH)) {
+  if (!existsSync24(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found. Run cc-claw setup first.");
     process.exit(1);
   }
@@ -12950,7 +13622,7 @@ async function memoryList(globalOpts) {
   });
 }
 async function memorySearch(globalOpts, query) {
-  if (!existsSync23(DB_PATH)) {
+  if (!existsSync24(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -12972,7 +13644,7 @@ async function memorySearch(globalOpts, query) {
   });
 }
 async function memoryHistory(globalOpts, opts) {
-  if (!existsSync23(DB_PATH)) {
+  if (!existsSync24(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -13020,7 +13692,17 @@ __export(cron_exports2, {
   cronList: () => cronList,
   cronRuns: () => cronRuns
 });
-import { existsSync as existsSync24 } from "fs";
+import { existsSync as existsSync25 } from "fs";
+function parseFallbacks(raw) {
+  return raw.slice(0, 3).map((f) => {
+    const [backend2, ...rest] = f.split(":");
+    const model2 = rest.join(":");
+    if (!backend2 || !model2) {
+      throw new Error(`Invalid fallback format "${f}" \u2014 expected backend:model (e.g. gemini:gemini-3-flash-preview)`);
+    }
+    return { backend: backend2, model: model2 };
+  });
+}
 function parseAndValidateTimeout(raw) {
   if (!raw) return null;
   const val = parseInt(raw, 10);
@@ -13031,7 +13713,7 @@ function parseAndValidateTimeout(raw) {
   return val;
 }
 async function cronList(globalOpts) {
-  if (!existsSync24(DB_PATH)) {
+  if (!existsSync25(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -13052,15 +13734,24 @@ async function cronList(globalOpts) {
       lines.push(`  ${statusDot(status)} #${j.id} [${status}] ${schedule2}${tz}`);
       lines.push(`    ${j.description}`);
       if (j.backend) lines.push(`    Backend: ${j.backend}${j.model ? ` / ${j.model}` : ""}`);
+      if (j.fallbacks) {
+        try {
+          const fb = JSON.parse(j.fallbacks);
+          if (Array.isArray(fb) && fb.length > 0) {
+            lines.push(`    Fallbacks: ${fb.map((f) => `${f.backend}:${f.model}`).join(" \u2192 ")}`);
+          }
+        } catch {
+        }
+      }
       if (j.timeout) lines.push(`    Timeout: ${j.timeout}s`);
-      if (j.next_run_at) lines.push(`    Next: ${muted(j.next_run_at)}`);
+      if (j.next_run_at) lines.push(`    Next: ${muted(formatLocalDateTime(j.next_run_at))}`);
       lines.push("");
     }
     return lines.join("\n");
   });
 }
 async function cronHealth(globalOpts) {
-  if (!existsSync24(DB_PATH)) {
+  if (!existsSync25(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -13114,6 +13805,7 @@ async function cronCreate(globalOpts, opts) {
         everyMs = unit.startsWith("h") ? num * 36e5 : unit.startsWith("m") ? num * 6e4 : num * 1e3;
       }
     }
+    const fallbacks = opts.fallback?.length ? parseFallbacks(opts.fallback) : void 0;
     const job = insertJob2({
       scheduleType: schedType,
       cron: opts.cron ?? null,
@@ -13125,6 +13817,7 @@ async function cronCreate(globalOpts, opts) {
       model: opts.model ?? null,
       thinking: opts.thinking ?? null,
       timeout,
+      fallbacks,
       sessionType: opts.sessionType ?? "isolated",
       deliveryMode: opts.delivery ?? "announce",
       channel: opts.channel ?? null,
@@ -13209,6 +13902,11 @@ async function cronEdit(globalOpts, id, opts) {
       updates.push("timezone = ?");
       values.push(opts.timezone);
     }
+    if (opts.fallback?.length) {
+      const fallbacks = parseFallbacks(opts.fallback);
+      updates.push("fallbacks = ?");
+      values.push(JSON.stringify(fallbacks));
+    }
     if (updates.length === 0) {
       outputError("NO_CHANGES", "No fields to update. Specify fields with flags (e.g. --description, --cron).");
       process.exit(1);
@@ -13224,7 +13922,7 @@ async function cronEdit(globalOpts, id, opts) {
   }
 }
 async function cronRuns(globalOpts, jobId, opts) {
-  if (!existsSync24(DB_PATH)) {
+  if (!existsSync25(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -13243,7 +13941,7 @@ async function cronRuns(globalOpts, jobId, opts) {
     const lines = ["", divider("Run History"), ""];
     for (const r of list) {
       const duration = r.duration_ms ? ` (${(r.duration_ms / 1e3).toFixed(1)}s)` : "";
-      lines.push(`  #${r.job_id} [${r.status}] ${r.started_at}${duration}`);
+      lines.push(`  #${r.job_id} [${r.status}] ${formatLocalDateTime(r.started_at)}${duration}`);
       if (r.error) lines.push(`    Error: ${r.error.slice(0, 100)}`);
       lines.push("");
     }
@@ -13257,6 +13955,7 @@ var init_cron2 = __esm({
     init_paths();
     init_resolve_chat();
     init_types2();
+    init_format_time();
   }
 });
 
@@ -13270,9 +13969,9 @@ __export(agents_exports, {
   runnersList: () => runnersList,
   tasksList: () => tasksList
 });
-import { existsSync as existsSync25 } from "fs";
+import { existsSync as existsSync26 } from "fs";
 async function agentsList(globalOpts) {
-  if (!existsSync25(DB_PATH)) {
+  if (!existsSync26(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -13303,7 +14002,7 @@ async function agentsList(globalOpts) {
   });
 }
 async function tasksList(globalOpts) {
-  if (!existsSync25(DB_PATH)) {
+  if (!existsSync26(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -13431,18 +14130,18 @@ __export(db_exports, {
   dbPath: () => dbPath,
   dbStats: () => dbStats
 });
-import { existsSync as existsSync26, statSync as statSync6, copyFileSync, mkdirSync as mkdirSync8 } from "fs";
+import { existsSync as existsSync27, statSync as statSync5, copyFileSync, mkdirSync as mkdirSync9 } from "fs";
 import { dirname as dirname5 } from "path";
 async function dbStats(globalOpts) {
-  if (!existsSync26(DB_PATH)) {
+  if (!existsSync27(DB_PATH)) {
     outputError("DB_NOT_FOUND", `Database not found at ${DB_PATH}`);
     process.exit(1);
   }
   const { openDatabaseReadOnly: openDatabaseReadOnly2 } = await Promise.resolve().then(() => (init_store4(), store_exports3));
   const readDb = openDatabaseReadOnly2();
-  const mainSize = statSync6(DB_PATH).size;
+  const mainSize = statSync5(DB_PATH).size;
   const walPath = DB_PATH + "-wal";
-  const walSize = existsSync26(walPath) ? statSync6(walPath).size : 0;
+  const walSize = existsSync27(walPath) ? statSync5(walPath).size : 0;
   const tableNames = readDb.prepare(
     "SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%' AND name NOT LIKE '%_fts%' ORDER BY name"
   ).all();
@@ -13476,17 +14175,17 @@ async function dbPath(globalOpts) {
   output({ path: DB_PATH }, (d) => d.path);
 }
 async function dbBackup(globalOpts, destPath) {
-  if (!existsSync26(DB_PATH)) {
+  if (!existsSync27(DB_PATH)) {
     outputError("DB_NOT_FOUND", `Database not found at ${DB_PATH}`);
     process.exit(1);
   }
   const dest = destPath ?? `${DB_PATH}.backup-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}`;
   try {
-    mkdirSync8(dirname5(dest), { recursive: true });
+    mkdirSync9(dirname5(dest), { recursive: true });
     copyFileSync(DB_PATH, dest);
     const walPath = DB_PATH + "-wal";
-    if (existsSync26(walPath)) copyFileSync(walPath, dest + "-wal");
-    output({ path: dest, sizeBytes: statSync6(dest).size }, (d) => {
+    if (existsSync27(walPath)) copyFileSync(walPath, dest + "-wal");
+    output({ path: dest, sizeBytes: statSync5(dest).size }, (d) => {
       const b = d;
       return `
   ${success("Backup created:")} ${b.path} (${(b.sizeBytes / 1024).toFixed(0)}KB)
@@ -13514,9 +14213,9 @@ __export(usage_exports, {
   usageCost: () => usageCost,
   usageTokens: () => usageTokens
 });
-import { existsSync as existsSync27 } from "fs";
+import { existsSync as existsSync28 } from "fs";
 function ensureDb() {
-  if (!existsSync27(DB_PATH)) {
+  if (!existsSync28(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found. Run cc-claw setup first.");
     process.exit(1);
   }
@@ -13706,9 +14405,9 @@ __export(config_exports, {
   configList: () => configList,
   configSet: () => configSet
 });
-import { existsSync as existsSync28, readFileSync as readFileSync14 } from "fs";
+import { existsSync as existsSync29, readFileSync as readFileSync15 } from "fs";
 async function configList(globalOpts) {
-  if (!existsSync28(DB_PATH)) {
+  if (!existsSync29(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -13742,7 +14441,7 @@ async function configGet(globalOpts, key) {
     outputError("INVALID_KEY", `Unknown config key "${key}". Valid keys: ${RUNTIME_KEYS.join(", ")}`);
     process.exit(1);
   }
-  if (!existsSync28(DB_PATH)) {
+  if (!existsSync29(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -13788,11 +14487,11 @@ async function configSet(globalOpts, key, value) {
   }
 }
 async function configEnv(_globalOpts) {
-  if (!existsSync28(ENV_PATH)) {
+  if (!existsSync29(ENV_PATH)) {
     outputError("ENV_NOT_FOUND", `No .env file at ${ENV_PATH}. Run cc-claw setup.`);
     process.exit(1);
   }
-  const content = readFileSync14(ENV_PATH, "utf-8");
+  const content = readFileSync15(ENV_PATH, "utf-8");
   const entries = {};
   const secretPatterns = /TOKEN|KEY|SECRET|PASSWORD|CREDENTIALS/i;
   for (const line of content.split("\n")) {
@@ -13841,9 +14540,9 @@ __export(session_exports, {
   sessionGet: () => sessionGet,
   sessionNew: () => sessionNew
 });
-import { existsSync as existsSync29 } from "fs";
+import { existsSync as existsSync30 } from "fs";
 async function sessionGet(globalOpts) {
-  if (!existsSync29(DB_PATH)) {
+  if (!existsSync30(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -13904,9 +14603,9 @@ __export(permissions_exports, {
   verboseGet: () => verboseGet,
   verboseSet: () => verboseSet
 });
-import { existsSync as existsSync30 } from "fs";
+import { existsSync as existsSync31 } from "fs";
 function ensureDb2() {
-  if (!existsSync30(DB_PATH)) {
+  if (!existsSync31(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -13922,7 +14621,8 @@ async function permissionsGet(globalOpts) {
   output({ mode }, (d) => d.mode);
 }
 async function permissionsSet(globalOpts, mode) {
-  const valid = ["yolo", "safe", "readonly", "plan"];
+  if (mode === "readonly") mode = "plan";
+  const valid = ["yolo", "safe", "plan"];
   if (!valid.includes(mode)) {
     outputError("INVALID_MODE", `Invalid mode "${mode}". Valid: ${valid.join(", ")}`);
     process.exit(1);
@@ -14052,9 +14752,9 @@ __export(cwd_exports, {
   cwdGet: () => cwdGet,
   cwdSet: () => cwdSet
 });
-import { existsSync as existsSync31 } from "fs";
+import { existsSync as existsSync32 } from "fs";
 async function cwdGet(globalOpts) {
-  if (!existsSync31(DB_PATH)) {
+  if (!existsSync32(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -14116,9 +14816,9 @@ __export(voice_exports, {
   voiceGet: () => voiceGet,
   voiceSet: () => voiceSet
 });
-import { existsSync as existsSync32 } from "fs";
+import { existsSync as existsSync33 } from "fs";
 async function voiceGet(globalOpts) {
-  if (!existsSync32(DB_PATH)) {
+  if (!existsSync33(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -14167,9 +14867,9 @@ __export(heartbeat_exports, {
   heartbeatGet: () => heartbeatGet,
   heartbeatSet: () => heartbeatSet
 });
-import { existsSync as existsSync33 } from "fs";
+import { existsSync as existsSync34 } from "fs";
 async function heartbeatGet(globalOpts) {
-  if (!existsSync33(DB_PATH)) {
+  if (!existsSync34(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -14279,9 +14979,9 @@ __export(chats_exports, {
   chatsList: () => chatsList,
   chatsRemoveAlias: () => chatsRemoveAlias
 });
-import { existsSync as existsSync34 } from "fs";
+import { existsSync as existsSync35 } from "fs";
 async function chatsList(_globalOpts) {
-  if (!existsSync34(DB_PATH)) {
+  if (!existsSync35(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -14409,9 +15109,9 @@ var mcps_exports = {};
 __export(mcps_exports, {
   mcpsList: () => mcpsList
 });
-import { existsSync as existsSync35 } from "fs";
+import { existsSync as existsSync36 } from "fs";
 async function mcpsList(_globalOpts) {
-  if (!existsSync35(DB_PATH)) {
+  if (!existsSync36(DB_PATH)) {
     outputError("DB_NOT_FOUND", "Database not found.");
     process.exit(1);
   }
@@ -14448,11 +15148,11 @@ __export(chat_exports, {
   chatSend: () => chatSend
 });
 import { request as httpRequest2 } from "http";
-import { readFileSync as readFileSync15, existsSync as existsSync36 } from "fs";
+import { readFileSync as readFileSync16, existsSync as existsSync37 } from "fs";
 function getToken2() {
   if (process.env.CC_CLAW_API_TOKEN) return process.env.CC_CLAW_API_TOKEN;
   try {
-    if (existsSync36(TOKEN_PATH2)) return readFileSync15(TOKEN_PATH2, "utf-8").trim();
+    if (existsSync37(TOKEN_PATH2)) return readFileSync16(TOKEN_PATH2, "utf-8").trim();
   } catch {
   }
   return null;
@@ -14878,10 +15578,10 @@ var init_completion = __esm({
 
 // src/setup.ts
 var setup_exports = {};
-import { existsSync as existsSync37, writeFileSync as writeFileSync7, readFileSync as readFileSync16, copyFileSync as copyFileSync2, mkdirSync as mkdirSync9, statSync as statSync7 } from "fs";
+import { existsSync as existsSync38, writeFileSync as writeFileSync8, readFileSync as readFileSync17, copyFileSync as copyFileSync2, mkdirSync as mkdirSync10, statSync as statSync6 } from "fs";
 import { execFileSync as execFileSync4 } from "child_process";
 import { createInterface as createInterface5 } from "readline";
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 function divider2() {
   console.log(dim("\u2500".repeat(55)));
 }
@@ -14955,22 +15655,22 @@ async function setup() {
   }
   console.log("");
   for (const dir of [CC_CLAW_HOME, DATA_PATH, LOGS_PATH, SKILLS_PATH, RUNNERS_PATH, AGENTS_PATH]) {
-    if (!existsSync37(dir)) mkdirSync9(dir, { recursive: true });
+    if (!existsSync38(dir)) mkdirSync10(dir, { recursive: true });
   }
   const env = {};
-  const envSource = existsSync37(ENV_PATH) ? ENV_PATH : existsSync37(".env") ? ".env" : null;
+  const envSource = existsSync38(ENV_PATH) ? ENV_PATH : existsSync38(".env") ? ".env" : null;
   if (envSource) {
     console.log(yellow(`  Found existing config at ${envSource} \u2014 your values will be preserved`));
     console.log(yellow("  unless you enter new ones. Just press Enter to keep existing values.\n"));
-    const existing = readFileSync16(envSource, "utf-8");
+    const existing = readFileSync17(envSource, "utf-8");
     for (const line of existing.split("\n")) {
       const match = line.match(/^([^#=]+)=(.*)$/);
       if (match) env[match[1].trim()] = match[2].trim();
     }
   }
-  const cwdDb = join18(process.cwd(), "cc-claw.db");
-  if (existsSync37(cwdDb) && !existsSync37(DB_PATH)) {
-    const { size } = statSync7(cwdDb);
+  const cwdDb = join19(process.cwd(), "cc-claw.db");
+  if (existsSync38(cwdDb) && !existsSync38(DB_PATH)) {
+    const { size } = statSync6(cwdDb);
     console.log(yellow(`  Found existing database at ${cwdDb} (${(size / 1024).toFixed(0)}KB)`));
     const migrate = await confirm("Copy database to ~/.cc-claw/? (preserves memories & history)", true);
     if (migrate) {
@@ -15163,7 +15863,7 @@ async function setup() {
     envLines.push("", "# Video Analysis", `GEMINI_API_KEY=${env.GEMINI_API_KEY}`);
   }
   const envContent = envLines.join("\n") + "\n";
-  writeFileSync7(ENV_PATH, envContent, { mode: 384 });
+  writeFileSync8(ENV_PATH, envContent, { mode: 384 });
   console.log(green(`  Config saved to ${ENV_PATH} (permissions: owner-only)`));
   header(6, TOTAL_STEPS, "Run on Startup (Daemon)");
   console.log("  CC-Claw can run automatically in the background, starting");
@@ -15332,7 +16032,7 @@ function registerCronCommands(cmd) {
     const { cronList: cronList2 } = await Promise.resolve().then(() => (init_cron2(), cron_exports2));
     await cronList2(program.opts());
   });
-  cmd.command("create").description("Create a scheduled job").requiredOption("--description <text>", "Job description").option("--prompt <text>", "Agent prompt (defaults to description)").option("--cron <expr>", "Cron expression (e.g. '0 9 * * *')").option("--at <iso8601>", "One-shot time").option("--every <interval>", "Repeat interval (e.g. 30m, 1h)").option("--backend <name>", "Backend for this job").option("--model <name>", "Model for this job").option("--thinking <level>", "Thinking level").option("--timeout <seconds>", "Job timeout in seconds (30-3600)").option("--timezone <tz>", "IANA timezone", "UTC").option("--session-type <type>", "Session type (isolated/main)", "isolated").option("--delivery <mode>", "Delivery mode (announce/webhook/none)", "announce").option("--channel <name>", "Delivery channel").option("--target <id>", "Delivery target").option("--cwd <path>", "Working directory").action(async (opts) => {
+  cmd.command("create").description("Create a scheduled job").requiredOption("--description <text>", "Job description").option("--prompt <text>", "Agent prompt (defaults to description)").option("--cron <expr>", "Cron expression (e.g. '0 9 * * *')").option("--at <iso8601>", "One-shot time").option("--every <interval>", "Repeat interval (e.g. 30m, 1h)").option("--backend <name>", "Backend for this job").option("--model <name>", "Model for this job").option("--thinking <level>", "Thinking level").option("--timeout <seconds>", "Job timeout in seconds (30-3600)").option("--fallback <backend:model>", "Fallback backend:model (repeatable, max 3)", (val, prev) => [...prev, val], []).option("--timezone <tz>", "IANA timezone", "UTC").option("--session-type <type>", "Session type (isolated/main)", "isolated").option("--delivery <mode>", "Delivery mode (announce/webhook/none)", "announce").option("--channel <name>", "Delivery channel").option("--target <id>", "Delivery target").option("--cwd <path>", "Working directory").action(async (opts) => {
     const { cronCreate: cronCreate2 } = await Promise.resolve().then(() => (init_cron2(), cron_exports2));
     await cronCreate2(program.opts(), opts);
   });
@@ -15352,7 +16052,7 @@ function registerCronCommands(cmd) {
     const { cronAction: cronAction2 } = await Promise.resolve().then(() => (init_cron2(), cron_exports2));
     await cronAction2(program.opts(), "run", id);
   });
-  cmd.command("edit <id>").description("Edit a job (same flags as create)").option("--description <text>").option("--cron <expr>").option("--at <iso8601>").option("--every <interval>").option("--backend <name>").option("--model <name>").option("--thinking <level>").option("--timeout <seconds>", "Job timeout in seconds (30-3600)").option("--timezone <tz>").action(async (id, opts) => {
+  cmd.command("edit <id>").description("Edit a job (same flags as create)").option("--description <text>").option("--cron <expr>").option("--at <iso8601>").option("--every <interval>").option("--backend <name>").option("--model <name>").option("--thinking <level>").option("--timeout <seconds>", "Job timeout in seconds (30-3600)").option("--fallback <backend:model>", "Fallback backend:model (repeatable, max 3)", (val, prev) => [...prev, val], []).option("--timezone <tz>").action(async (id, opts) => {
     const { cronEdit: cronEdit2 } = await Promise.resolve().then(() => (init_cron2(), cron_exports2));
     await cronEdit2(program.opts(), id, opts);
   });