cc-claw 0.3.10 → 0.3.11

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.3.11" : (() => {
       try {
         return JSON.parse(readFileSync(join2(process.cwd(), "package.json"), "utf-8")).version ?? "unknown";
       } catch {
@@ -1144,6 +1144,7 @@ function initDatabase() {
       model TEXT,
       thinking TEXT,
       timeout INTEGER,
+      fallbacks TEXT,
       session_type TEXT NOT NULL DEFAULT 'isolated',
       channel TEXT,
       target TEXT,
@@ -1263,6 +1264,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 {
   }
@@ -1955,8 +1960,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 +1973,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 +1982,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);
@@ -2283,7 +2294,7 @@ var init_store4 = __esm({
     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
@@ -2982,17 +2993,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;
 var init_inject = __esm({
   "src/memory/inject.ts"() {
     "use strict";
@@ -3004,6 +3019,8 @@ 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;
   }
 });
 
@@ -3114,6 +3131,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 +3165,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,24 +3198,16 @@ 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) {
   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 (tier === "full") {
     const ctx = searchContext(userMessage);
     if (ctx) {
@@ -3226,9 +3215,11 @@ ${user}`);
 ${ctx}`);
     }
   }
-  const memory2 = await injectMemoryContext(userMessage);
-  if (memory2) {
-    sections.push(memory2);
+  if (tier !== "slim") {
+    const memory2 = await injectMemoryContext(userMessage);
+    if (memory2) {
+      sections.push(memory2);
+    }
   }
   if (chatId && (tier === "full" || tier === "heartbeat")) {
     const orchestrationContext = buildOrchestrationContext(chatId);
@@ -3285,7 +3276,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 +3287,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;
@@ -3452,9 +3440,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();
@@ -3579,20 +3567,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 +3648,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 +4232,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);
@@ -5866,8 +5856,8 @@ 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 { cwd, onStream, model: model2, backend: backend2, permMode, onToolAction, bootstrapTier, timeoutMs } = opts ?? {};
+  const adapter = backend2 ? getAdapter(backend2) : getAdapterForChat(chatId);
   const mode = permMode ?? "yolo";
   const thinkingLevel = getThinkingLevel(chatId);
   const resolvedCwd = cwd ?? WORKSPACE_PATH;
@@ -5934,6 +5924,14 @@ async function askAgentImpl(chatId, userMessage, opts) {
   }
   if (result.resultText) {
     appendToLog(chatId, userMessage, result.resultText);
+    const AUTO_SUMMARIZE_THRESHOLD = 30;
+    const pairCount = getMessagePairCount(chatId);
+    if (pairCount >= AUTO_SUMMARIZE_THRESHOLD) {
+      log(`[agent] Auto-summarizing chat ${chatId} after ${pairCount} turns`);
+      summarizeSession(chatId).catch((err) => {
+        warn(`[agent] Auto-summarize failed for chat ${chatId}: ${err}`);
+      });
+    }
   }
   return {
     text: result.resultText || `(No response from ${adapter.displayName})`,
@@ -6125,6 +6123,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 +6139,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 +6470,49 @@ 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
+        });
+        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 ?? (() => {
@@ -7146,6 +7184,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 +7830,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 +7856,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();
   }
 });
@@ -8069,6 +8108,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 +9253,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/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",
         "plain"
       );
       break;
@@ -9620,6 +9736,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(
@@ -9876,8 +10016,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");
@@ -10377,7 +10517,16 @@ async function handleText(msg, channel) {
     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 (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 () => {
@@ -10401,6 +10550,30 @@ async function handleText(msg, channel) {
   } 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 +10678,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 +10731,8 @@ async function sendResponse(chatId, channel, text, messageId) {
       ]);
     }
   }
-  const cleanText = await processFileSends2(chatId, channel, afterUpdates);
+  const afterFiles = await processFileSends2(chatId, channel, afterUpdates);
+  const cleanText = await processImageGenerations(chatId, channel, afterFiles);
   if (!cleanText) return;
   if (isVoiceEnabled(chatId)) {
     try {
@@ -10746,6 +10952,45 @@ ${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);
+      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);
+      const { summarizeSession: summarizeSession2 } = await Promise.resolve().then(() => (init_summarize(), summarize_exports));
+      await summarizeSession2(targetChatId);
+      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 +11202,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, pendingFallbackMessages, CLI_INSTALL_HINTS, BLOCKED_PATH_PATTERNS2, ALLOWED_REACTION_EMOJIS, SKILLS_PER_PAGE;
 var init_router = __esm({
   "src/router.ts"() {
     "use strict";
@@ -10968,6 +11213,8 @@ var init_router = __esm({
     init_log();
     init_format_time();
     init_agent();
+    init_retry();
+    init_image_gen();
     init_stt();
     init_store4();
     init_summarize();
@@ -10996,6 +11243,8 @@ var init_router = __esm({
       normal: "Normal \u2014 summarized actions",
       verbose: "Verbose \u2014 full details"
     };
+    pendingInterrupts = /* @__PURE__ */ new Map();
+    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 +11339,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 +11361,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 +11384,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 +11430,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 +11645,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 +11716,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 +11739,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 +11786,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 +11803,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 +11888,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 +11947,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 +11967,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 +11980,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 } 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 +12005,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 {
@@ -11767,11 +12089,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 +12153,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 +12177,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 +12193,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 +12255,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 +12320,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 +12330,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 +12355,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 +12384,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");
   }
 });
 
@@ -12263,12 +12585,12 @@ __export(api_client_exports, {
   apiPost: () => apiPost,
   isDaemonRunning: () => isDaemonRunning
 });
-import { readFileSync as readFileSync12, existsSync as existsSync17 } from "fs";
+import { readFileSync as readFileSync12, 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 readFileSync12(TOKEN_PATH, "utf-8").trim();
   } catch {
   }
   return null;
@@ -12361,7 +12683,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 +12723,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 +12814,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 +12848,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 +12888,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,7 +12913,7 @@ 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");
@@ -12710,10 +13032,10 @@ 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 readFileSync13, 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);
   }
@@ -12761,12 +13083,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 +13119,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 +13163,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 +13202,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 +13246,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 +13272,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 +13294,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 +13342,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 +13363,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 +13384,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 +13455,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 +13467,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 +13552,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 +13572,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 +13591,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 +13605,7 @@ var init_cron2 = __esm({
     init_paths();
     init_resolve_chat();
     init_types2();
+    init_format_time();
   }
 });
 
@@ -13270,9 +13619,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 +13652,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 +13780,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 +13825,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 +13863,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 +14055,9 @@ __export(config_exports, {
   configList: () => configList,
   configSet: () => configSet
 });
-import { existsSync as existsSync28, readFileSync as readFileSync14 } from "fs";
+import { existsSync as existsSync29, readFileSync as readFileSync14 } 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 +14091,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,7 +14137,7 @@ 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);
   }
@@ -13841,9 +14190,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 +14253,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);
   }
@@ -14052,9 +14401,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 +14465,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 +14516,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 +14628,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 +14758,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 +14797,11 @@ __export(chat_exports, {
   chatSend: () => chatSend
 });
 import { request as httpRequest2 } from "http";
-import { readFileSync as readFileSync15, existsSync as existsSync36 } from "fs";
+import { readFileSync as readFileSync15, 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 readFileSync15(TOKEN_PATH2, "utf-8").trim();
   } catch {
   }
   return null;
@@ -14878,10 +15227,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 readFileSync16, 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,10 +15304,10 @@ 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"));
@@ -14968,9 +15317,9 @@ async function setup() {
       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 +15512,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 +15681,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 +15701,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);
   });