@gaberrb/polypus 0.4.8 → 0.4.10

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/cli/index.ts
 import { Command } from "commander";
-import pc14 from "picocolors";
+import pc15 from "picocolors";
 
 // src/cli/commands/add-agent.ts
 import pc from "picocolors";
@@ -113,6 +113,9 @@ var en = {
   "cli.opt.verify": "after the agent finishes, run project checks (typecheck/build/test) and iterate until they pass",
   "cli.opt.budget": "stop the run when the estimated session cost reaches this USD amount (OpenRouter pricing)",
   "cli.cmd.usage": "Show token/cost analytics aggregated per day",
+  "cli.cmd.sessions": "List saved sessions that can be resumed",
+  "cli.opt.continue": "resume the most recent saved session",
+  "cli.opt.resume": "resume a specific saved session by id",
   "cli.arg.swarmTask": "high-level task to split across agents",
   "cli.opt.agents": "comma-separated agent names (default: all configured)",
   "cli.opt.maxSubtasks": "maximum number of parallel subtasks",
@@ -139,6 +142,7 @@ var en = {
   "run.reprompt": "\u21BB no tool call \u2014 reinforcing instructions (attempt {attempt})",
   "run.autocorrect": "\u21BB tool failed \u2014 auto-correcting with extra context",
   "run.cancelled": "\u25A0 cancelled",
+  "compaction.done": "context compacted: ~{before} \u2192 ~{after} tokens",
   "run.jsonNeedsTask": "--json requires a task argument (headless mode has no interactive REPL).",
   "review.approveAll": "approve all",
   "review.reject": "reject",
@@ -156,6 +160,13 @@ var en = {
   "usage.empty": "No usage recorded yet. Run a task to start tracking.",
   "usage.total": "total",
   "usage.runs": "runs",
+  // sessions
+  "sessions.header": "Saved sessions (most recent first):",
+  "sessions.empty": "No saved sessions yet.",
+  "sessions.hint": "Resume with `polypus run --continue` or `polypus run --resume <id>`.",
+  "sessions.notFound": 'No saved session with id "{id}".',
+  "sessions.noneToContinue": "No previous session to continue \u2014 starting fresh.",
+  "sessions.resumed": "\u21BA resumed session {id} ({n} messages)",
   // repl
   "repl.welcome": "Polypus interactive session.",
   "repl.welcomeHint": " Type /help for commands, /exit to quit.",
@@ -182,6 +193,8 @@ var en = {
     "  /allow <glob>    add a path glob to the allow-list",
     "  /allow           show the current allow-list and mode",
     "  /reset           clear the conversation history",
+    "  /sessions        list saved sessions you can resume",
+    "  /resume <id>     resume a saved session",
     "  /help            show this help",
     "  /exit            quit",
     "Anything else is sent to the agent as a task."
@@ -362,6 +375,9 @@ var ptBR = {
   "cli.opt.verify": "ap\xF3s o agente terminar, roda as checagens do projeto (typecheck/build/test) e itera at\xE9 passar",
   "cli.opt.budget": "interrompe a execu\xE7\xE3o quando o custo estimado da sess\xE3o atingir este valor em USD (pre\xE7os do OpenRouter)",
   "cli.cmd.usage": "Mostra analytics de tokens/custo agregados por dia",
+  "cli.cmd.sessions": "Lista as sess\xF5es salvas que podem ser retomadas",
+  "cli.opt.continue": "retoma a sess\xE3o salva mais recente",
+  "cli.opt.resume": "retoma uma sess\xE3o salva espec\xEDfica pelo id",
   "cli.arg.swarmTask": "tarefa de alto n\xEDvel para dividir entre os agentes",
   "cli.opt.agents": "nomes de agentes separados por v\xEDrgula (padr\xE3o: todos)",
   "cli.opt.maxSubtasks": "n\xFAmero m\xE1ximo de subtarefas paralelas",
@@ -386,6 +402,7 @@ var ptBR = {
   "run.reprompt": "\u21BB nenhuma chamada de tool \u2014 refor\xE7ando instru\xE7\xF5es (tentativa {attempt})",
   "run.autocorrect": "\u21BB tool falhou \u2014 autocorrigindo com contexto extra",
   "run.cancelled": "\u25A0 cancelado",
+  "compaction.done": "contexto compactado: ~{before} \u2192 ~{after} tokens",
   "run.jsonNeedsTask": "--json exige um argumento de tarefa (o modo headless n\xE3o tem REPL interativo).",
   "review.approveAll": "aprovar tudo",
   "review.reject": "rejeitar",
@@ -403,6 +420,13 @@ var ptBR = {
   "usage.empty": "Nenhum uso registrado ainda. Rode uma tarefa para come\xE7ar a medir.",
   "usage.total": "total",
   "usage.runs": "execu\xE7\xF5es",
+  // sessions
+  "sessions.header": "Sess\xF5es salvas (mais recentes primeiro):",
+  "sessions.empty": "Nenhuma sess\xE3o salva ainda.",
+  "sessions.hint": "Retome com `polypus run --continue` ou `polypus run --resume <id>`.",
+  "sessions.notFound": 'Nenhuma sess\xE3o salva com id "{id}".',
+  "sessions.noneToContinue": "Nenhuma sess\xE3o anterior para continuar \u2014 come\xE7ando do zero.",
+  "sessions.resumed": "\u21BA sess\xE3o {id} retomada ({n} mensagens)",
   "repl.welcome": "Sess\xE3o interativa do Polypus.",
   "repl.welcomeHint": " Digite /help para comandos, /exit para sair.",
   "repl.modeChanged": "modo \u2192 {mode}",
@@ -428,6 +452,8 @@ var ptBR = {
     "  /allow <glob>    adiciona um glob de caminho \xE0 allow-list",
     "  /allow           mostra a allow-list e o modo atuais",
     "  /reset           limpa o hist\xF3rico da conversa",
+    "  /sessions        lista as sess\xF5es salvas que voc\xEA pode retomar",
+    "  /resume <id>     retoma uma sess\xE3o salva",
     "  /help            mostra esta ajuda",
     "  /exit            sair",
     "Qualquer outra coisa \xE9 enviada ao agente como tarefa."
@@ -1086,6 +1112,13 @@ var SECRET_PATTERNS = [
   { re: /\bsk-[A-Za-z0-9]{32,}\b/, kind: "OpenAI-style secret key" },
   { re: /\bAIza[0-9A-Za-z_-]{35}\b/, kind: "Google API key" }
 ];
+function redactSecrets(text2) {
+  let out = text2;
+  for (const { re } of SECRET_PATTERNS) {
+    out = out.replace(new RegExp(re.source, re.flags.includes("g") ? re.flags : re.flags + "g"), "[redacted]");
+  }
+  return out;
+}
 function scanSecrets(text2) {
   const findings = [];
   const lines = text2.split("\n");
@@ -2061,6 +2094,56 @@ async function loadProjectInstructions(workspace) {
   return void 0;
 }
 
+// src/core/agent/compaction.ts
+function estimateTokens(messages) {
+  let chars = 0;
+  for (const m of messages) chars += m.content.length;
+  return Math.ceil(chars / 4);
+}
+var RECENT_KEEP = 8;
+var MIN_TO_COMPACT = 4;
+var MAX_SUMMARY_INPUT = 4e4;
+function findSafeCut(messages, desiredKeep = RECENT_KEEP) {
+  let cut = Math.max(1, messages.length - desiredKeep);
+  while (cut < messages.length && (messages[cut].role === "tool" || messages[cut - 1]?.role === "assistant" && (messages[cut - 1].toolCalls?.length ?? 0) > 0)) {
+    cut++;
+  }
+  return cut;
+}
+function serialize(messages) {
+  const text2 = messages.map((m) => {
+    const tools = m.toolCalls?.length ? ` [called: ${m.toolCalls.map((c) => c.name).join(", ")}]` : "";
+    return `${m.role}${tools}: ${m.content}`;
+  }).join("\n\n");
+  return text2.length > MAX_SUMMARY_INPUT ? text2.slice(-MAX_SUMMARY_INPUT) : text2;
+}
+async function compactHistory(messages, agent, signal) {
+  if (messages.length === 0) return messages;
+  const system = messages[0].role === "system" ? messages[0] : void 0;
+  const startIdx = system ? 1 : 0;
+  const cut = findSafeCut(messages);
+  if (cut >= messages.length) return messages;
+  const middle = messages.slice(startIdx, cut);
+  if (middle.length < MIN_TO_COMPACT) return messages;
+  const tail = messages.slice(cut);
+  const summary = await agent.provider.chat({
+    messages: [
+      {
+        role: "system",
+        content: "You compress a coding agent's conversation so it can continue with less context. Summarize the messages below into a concise but information-dense brief that preserves: the original task and goal, key decisions, files created/edited and why, important command/test outputs, and any remaining TODOs or open problems. Use terse bullet points. Do not invent details."
+      },
+      { role: "user", content: serialize(middle) }
+    ],
+    signal
+  });
+  const summaryMessage = {
+    role: "user",
+    content: `[Summary of earlier conversation, compacted to save context]
+${summary.content.trim()}`
+  };
+  return system ? [system, summaryMessage, ...tail] : [summaryMessage, ...tail];
+}
+
 // src/core/agent/loop.ts
 function looksLikeStall(text2) {
   const lc = text2.toLowerCase();
@@ -2115,9 +2198,22 @@ async function runAgent(opts) {
   const maxToolRetries = opts.maxToolRetries ?? 3;
   const autoCorrect = opts.autoCorrect ?? true;
   const usage2 = { promptTokens: 0, completionTokens: 0 };
+  const compactThreshold = opts.compactThresholdTokens ?? 0;
+  let lastPromptTokens = 0;
   for (let step = 1; step <= maxSteps; step++) {
     if (opts.signal?.aborted) return { finished: false, reason: "cancelled", steps: step - 1, messages, usage: usage2 };
     events?.onStep?.(step);
+    if (compactThreshold > 0) {
+      const current = lastPromptTokens || estimateTokens(messages);
+      if (current >= compactThreshold) {
+        const compacted = await compactHistory(messages, agent, opts.signal);
+        if (compacted.length < messages.length) {
+          messages.splice(0, messages.length, ...compacted);
+          lastPromptTokens = estimateTokens(messages);
+          events?.onCompaction?.(current, lastPromptTokens);
+        }
+      }
+    }
     let response;
     try {
       response = await agent.provider.chat({
@@ -2132,6 +2228,7 @@ async function runAgent(opts) {
     }
     usage2.promptTokens += response.usage?.promptTokens ?? 0;
     usage2.completionTokens += response.usage?.completionTokens ?? 0;
+    lastPromptTokens = response.usage?.promptTokens ?? estimateTokens(messages);
     events?.onUsage?.(usage2);
     const { toolCalls, text: text2 } = driver.parse(response);
     messages.push(driver.assistantMessage(response, toolCalls));
@@ -2461,6 +2558,69 @@ function accumulate(bucket, e) {
   bucket.runs += 1;
 }
 
+// src/core/agent/session-store.ts
+import { mkdir as mkdir4, readFile as readFile11, readdir as readdir5, writeFile as writeFile4 } from "fs/promises";
+import { join as join5 } from "path";
+function sessionsDir() {
+  return join5(configDir(), "sessions");
+}
+function newSessionId() {
+  const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  const rand = Math.random().toString(36).slice(2, 6);
+  return `${stamp}-${rand}`;
+}
+function sessionPath(id) {
+  return join5(sessionsDir(), `${id}.json`);
+}
+async function saveSession(record) {
+  await mkdir4(sessionsDir(), { recursive: true });
+  const safe = {
+    ...record,
+    messages: record.messages.map((m) => ({ ...m, content: redactSecrets(m.content) }))
+  };
+  await writeFile4(sessionPath(record.id), JSON.stringify(safe, null, 2) + "\n", "utf8");
+}
+async function loadSession(id) {
+  try {
+    return JSON.parse(await readFile11(sessionPath(id), "utf8"));
+  } catch {
+    return void 0;
+  }
+}
+async function listSessions() {
+  let files;
+  try {
+    files = (await readdir5(sessionsDir())).filter((f) => f.endsWith(".json"));
+  } catch {
+    return [];
+  }
+  const summaries = [];
+  for (const f of files) {
+    try {
+      const r = JSON.parse(await readFile11(join5(sessionsDir(), f), "utf8"));
+      summaries.push({
+        id: r.id,
+        updatedAt: r.updatedAt,
+        title: r.title,
+        agentName: r.agentName,
+        mode: r.mode,
+        messageCount: r.messages?.length ?? 0
+      });
+    } catch {
+    }
+  }
+  return summaries.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+}
+async function latestSession() {
+  const [latest] = await listSessions();
+  return latest ? loadSession(latest.id) : void 0;
+}
+function deriveTitle(messages) {
+  const firstUser = messages.find((m) => m.role === "user");
+  const text2 = (firstUser?.content ?? "").replace(/\s+/g, " ").trim();
+  return text2.length > 60 ? text2.slice(0, 60) + "\u2026" : text2 || "(untitled)";
+}
+
 // src/cli/commands/json-output.ts
 var OUTPUT_PREVIEW = 500;
 function createJsonCollector() {
@@ -2494,6 +2654,9 @@ function createJsonCollector() {
     onReprompt(attempt) {
       log.push({ type: "reprompt", attempt });
     },
+    onCompaction(before, after) {
+      log.push({ type: "compaction", before, after });
+    },
     onUsage() {
     }
   };
@@ -3145,6 +3308,36 @@ async function handleCommand(cmd, arg, ctx) {
       session.history = [];
       console.log(pc6.dim(t("repl.historyCleared")));
       return;
+    case "sessions": {
+      const all = await listSessions();
+      if (all.length === 0) {
+        console.log(pc6.yellow(t("sessions.empty")));
+        return;
+      }
+      console.log(pc6.bold(t("sessions.header")));
+      for (const s of all) {
+        console.log(`  ${pc6.cyan(s.id)} ${pc6.dim(`[${s.messageCount} msgs]`)} ${s.title}`);
+      }
+      return;
+    }
+    case "resume": {
+      if (!arg) {
+        console.log(pc6.yellow(t("repl.needName", { usage: "/resume <id>" })));
+        return;
+      }
+      const record = await loadSession(arg);
+      if (!record) {
+        console.log(pc6.red(t("sessions.notFound", { id: arg })));
+        return;
+      }
+      session.id = record.id;
+      session.title = record.title;
+      session.agentName = record.agentName;
+      session.mode = record.mode;
+      session.history = record.messages;
+      console.log(pc6.green(t("sessions.resumed", { id: record.id, n: record.messages.length })));
+      return;
+    }
     case "swarm": {
       if (!arg) {
         console.log(pc6.yellow(t("repl.needName", { usage: "/swarm <task>" })));
@@ -3226,7 +3419,7 @@ import pc7 from "picocolors";
 // src/core/git/worktree.ts
 import { mkdtemp } from "fs/promises";
 import { tmpdir } from "os";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 import { simpleGit } from "simple-git";
 async function ensureRepo(workspace) {
   const git = simpleGit(workspace);
@@ -3247,7 +3440,7 @@ async function identityArgs(git) {
 }
 async function createWorktree(git, label) {
   const branch = `polypus/${label}-${Date.now().toString(36)}`;
-  const path = await mkdtemp(join5(tmpdir(), "polypus-wt-"));
+  const path = await mkdtemp(join6(tmpdir(), "polypus-wt-"));
   await git.raw(["worktree", "add", "-b", branch, path, "HEAD"]);
   return { path, branch };
 }
@@ -3676,21 +3869,39 @@ var Spinner = class {
 
 // src/cli/commands/run.ts
 var MAX_VERIFY_FIXES = 3;
+function compactionThreshold() {
+  if (process.env.POLYPUS_NO_COMPACT) return 0;
+  const v = Number(process.env.POLYPUS_COMPACT_THRESHOLD);
+  return Number.isFinite(v) && v > 0 ? v : 12e4;
+}
 async function run(task, opts) {
   let config = await loadConfig();
-  const agentConfig = resolveAgent(config, opts.agent);
   const workspace = process.cwd();
+  let seeded;
+  if (opts.resume) {
+    seeded = await loadSession(opts.resume);
+    if (!seeded) throw new Error(t("sessions.notFound", { id: opts.resume }));
+  } else if (opts.continue) {
+    seeded = await latestSession();
+    if (!seeded && !opts.json) console.log(pc8.dim(t("sessions.noneToContinue")));
+  }
+  const agentConfig = resolveAgent(config, opts.agent ?? seeded?.agentName);
   const session = {
+    id: seeded?.id ?? newSessionId(),
+    title: seeded?.title ?? "",
     agentName: agentConfig.name,
-    mode: opts.mode ?? config.permissions.mode,
+    mode: opts.mode ?? seeded?.mode ?? config.permissions.mode,
     allow: config.permissions.allow,
     deny: config.permissions.deny,
     allowedCommands: config.permissions.allowedCommands,
     maxSteps: opts.maxSteps ? Number(opts.maxSteps) : void 0,
-    history: [],
+    history: seeded?.messages ?? [],
     budget: opts.budget ? Number(opts.budget) : void 0,
     costUsd: 0
   };
+  if (seeded && !opts.json) {
+    console.log(pc8.dim(t("sessions.resumed", { id: seeded.id, n: seeded.messages.length })));
+  }
   const runTask = async (taskText) => {
     const active = resolveAgent(config, session.agentName);
     const resolved2 = createProvider(active);
@@ -3788,6 +3999,7 @@ async function executeTask(task, resolved, workspace, session, json = false, ver
     promptContext: { workspace, mode: session.mode, allow: session.allow },
     history: session.history,
     maxSteps: session.maxSteps,
+    compactThresholdTokens: compactionThreshold(),
     signal: controller.signal,
     events
   });
@@ -3803,6 +4015,16 @@ async function executeTask(task, resolved, workspace, session, json = false, ver
     spinner3.stop();
     cancel2.dispose();
   }
+  if (!session.title) session.title = deriveTitle(session.history);
+  await saveSession({
+    id: session.id,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    title: session.title,
+    agentName: session.agentName,
+    mode: session.mode,
+    messages: session.history
+  }).catch(() => {
+  });
   const runCost = pricing ? estimateCost(result.usage, pricing) : 0;
   session.costUsd += runCost;
   await recordUsage({
@@ -3961,6 +4183,10 @@ function renderEvents(spinner3) {
       spinner3.stop();
       console.log(pc8.yellow("  " + t("run.reprompt", { attempt })));
     },
+    onCompaction(before, after) {
+      spinner3.stop();
+      console.log(pc8.dim("\u21AF " + t("compaction.done", { before: fmtTokens(before), after: fmtTokens(after) })));
+    },
     onCorrection() {
       spinner3.stop();
       console.log(pc8.yellow("    \u21BB " + t("run.autocorrect")));
@@ -3977,8 +4203,8 @@ async function setup() {
 import pc9 from "picocolors";
 
 // src/core/scaffold/init.ts
-import { mkdir as mkdir4, writeFile as writeFile4, access } from "fs/promises";
-import { dirname as dirname3, join as join6 } from "path";
+import { mkdir as mkdir5, writeFile as writeFile5, access } from "fs/promises";
+import { dirname as dirname3, join as join7 } from "path";
 
 // src/core/scaffold/templates.ts
 function polyTemplates(locale) {
@@ -4221,13 +4447,13 @@ async function scaffoldPoly(workspace, opts) {
   const skipped = [];
   for (const [rel, content] of Object.entries(templates)) {
     const display = `.poly/${rel}`;
-    const abs = join6(workspace, ".poly", ...rel.split("/"));
+    const abs = join7(workspace, ".poly", ...rel.split("/"));
     if (!opts.force && await exists(abs)) {
       skipped.push(display);
       continue;
     }
-    await mkdir4(dirname3(abs), { recursive: true });
-    await writeFile4(abs, content, "utf8");
+    await mkdir5(dirname3(abs), { recursive: true });
+    await writeFile5(abs, content, "utf8");
     created.push(display);
   }
   return { created, skipped };
@@ -4341,11 +4567,30 @@ function fmtTokens2(n) {
   return n >= 1e3 ? `${(n / 1e3).toFixed(1)}k` : String(n);
 }
 
+// src/cli/commands/sessions.ts
+import pc12 from "picocolors";
+async function sessions() {
+  const all = await listSessions();
+  if (all.length === 0) {
+    console.log(pc12.yellow(t("sessions.empty")));
+    return;
+  }
+  console.log(pc12.bold(t("sessions.header")));
+  for (const s of all) {
+    const when = s.updatedAt.replace("T", " ").slice(0, 16);
+    console.log(
+      `  ${pc12.cyan(s.id)}  ${pc12.dim(when)}  ${pc12.dim(`[${s.agentName} \xB7 ${s.mode} \xB7 ${s.messageCount} msgs]`)}`
+    );
+    console.log(`     ${s.title}`);
+  }
+  console.log(pc12.dim("\n" + t("sessions.hint")));
+}
+
 // src/cli/commands/prd.ts
-import { writeFile as writeFile5, readFile as readFile11 } from "fs/promises";
+import { writeFile as writeFile6, readFile as readFile12 } from "fs/promises";
 import { execFile } from "child_process";
 import { promisify as promisify3 } from "util";
-import pc12 from "picocolors";
+import pc13 from "picocolors";
 
 // src/core/agent/prd.ts
 var SYSTEM = [
@@ -4473,15 +4718,15 @@ async function prd(issueRef, opts) {
   const guide = readProjectGuide(["context.md"]);
   const markdown = await withRetry(() => generatePrd(issue, provider, guide));
   if (opts.out) {
-    await writeFile5(opts.out, markdown + "\n", "utf8");
-    console.error(pc12.green(t("prd.wrote", { path: opts.out })));
+    await writeFile6(opts.out, markdown + "\n", "utf8");
+    console.error(pc13.green(t("prd.wrote", { path: opts.out })));
   } else {
     process.stdout.write(markdown + "\n");
   }
 }
 async function loadIssue(issueRef, input) {
   if (input) {
-    const raw = input === "-" ? await readStdin() : await readFile11(input, "utf8");
+    const raw = input === "-" ? await readStdin() : await readFile12(input, "utf8");
     return normalize2(JSON.parse(stripBom(raw)));
   }
   const num = numericRef(issueRef);
@@ -4500,10 +4745,10 @@ function normalize2(raw) {
 }
 
 // src/cli/commands/review.ts
-import { writeFile as writeFile6, readFile as readFile12 } from "fs/promises";
+import { writeFile as writeFile7, readFile as readFile13 } from "fs/promises";
 import { execFile as execFile2 } from "child_process";
 import { promisify as promisify4 } from "util";
-import pc13 from "picocolors";
+import pc14 from "picocolors";
 
 // src/core/agent/review.ts
 var MAX_DIFF_CHARS = Number(process.env.POLYPUS_MAX_DIFF_CHARS) || 6e4;
@@ -4569,14 +4814,14 @@ async function review(prRef, opts) {
   const guide = readProjectGuide(["rules.md", "context.md"]);
   const markdown = await withRetry(() => reviewDiff(diff, meta, provider, guide));
   if (opts.out) {
-    await writeFile6(opts.out, markdown + "\n", "utf8");
-    console.error(pc13.green(t("review.wrote", { path: opts.out })));
+    await writeFile7(opts.out, markdown + "\n", "utf8");
+    console.error(pc14.green(t("review.wrote", { path: opts.out })));
   } else {
     process.stdout.write(markdown + "\n");
   }
 }
 async function loadDiff(num, input) {
-  if (input) return input === "-" ? readStdin() : readFile12(input, "utf8");
+  if (input) return input === "-" ? readStdin() : readFile13(input, "utf8");
   const { stdout: stdout2 } = await exec4("gh", ["pr", "diff", num]);
   return stdout2;
 }
@@ -4588,7 +4833,7 @@ async function loadMeta(num, input) {
 }
 
 // src/cli/index.ts
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 
 // src/core/config/dotenv.ts
 import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
@@ -4621,7 +4866,7 @@ async function launchInteractive() {
   const config = await loadConfig();
   if (config.agents.length === 0) {
     console.log(banner());
-    console.log("  " + pc14.yellow(t("welcome.firstRun")) + "\n");
+    console.log("  " + pc15.yellow(t("welcome.firstRun")) + "\n");
     await setup();
   }
   await run(void 0, {});
@@ -4648,21 +4893,22 @@ function buildProgram() {
   program.command("add-agent").argument("<name>", t("cli.arg.addAgentName")).requiredOption("--provider <provider>", t("cli.opt.provider")).requiredOption("--model <model>", t("cli.opt.model")).option("--api-key <key>", t("cli.opt.apiKey")).option("--base-url <url>", t("cli.opt.baseUrl")).option("--tool-mode <mode>", t("cli.opt.toolMode"), "auto").option("--set-default", t("cli.opt.setDefault")).description(t("cli.cmd.addAgent")).action((name, opts) => addAgent(name, opts));
   program.command("remove-agent").argument("<name>", t("cli.arg.removeAgentName")).description(t("cli.cmd.removeAgent")).action((name) => removeAgent(name));
   program.command("list-agents").alias("agents").description(t("cli.cmd.listAgents")).action(() => listAgents());
-  program.command("run").argument("[task]", t("cli.arg.runTask")).option("--agent <name>", t("cli.opt.agent")).option("--mode <mode>", t("cli.opt.mode")).option("--max-steps <n>", t("cli.opt.maxSteps")).option("--json", t("cli.opt.json")).option("--verify", t("cli.opt.verify")).option("--budget <usd>", t("cli.opt.budget")).description(t("cli.cmd.run")).action((task, opts) => run(task, opts));
+  program.command("run").argument("[task]", t("cli.arg.runTask")).option("--agent <name>", t("cli.opt.agent")).option("--mode <mode>", t("cli.opt.mode")).option("--max-steps <n>", t("cli.opt.maxSteps")).option("--json", t("cli.opt.json")).option("--verify", t("cli.opt.verify")).option("--budget <usd>", t("cli.opt.budget")).option("--continue", t("cli.opt.continue")).option("--resume <id>", t("cli.opt.resume")).description(t("cli.cmd.run")).action((task, opts) => run(task, opts));
   program.command("swarm").argument("<task>", t("cli.arg.swarmTask")).option("--agents <names>", t("cli.opt.agents")).option("--max-subtasks <n>", t("cli.opt.maxSubtasks")).description(t("cli.cmd.swarm")).action((task, opts) => swarm(task, opts));
   program.command("models").option("--search <text>", t("cli.opt.search")).option("--tools", t("cli.opt.toolsOnly")).option("--free", t("cli.opt.free")).option("--max-price <usd>", t("cli.opt.maxPrice")).option("--sort <order>", t("cli.opt.sort")).option("--limit <n>", t("cli.opt.limit")).description(t("cli.cmd.models")).action((opts) => models(opts));
   program.command("usage").description(t("cli.cmd.usage")).action(() => usage());
+  program.command("sessions").description(t("cli.cmd.sessions")).action(() => sessions());
   program.command("prd").argument("<issue>", t("cli.arg.prdIssue")).option("--out <file>", t("cli.opt.out")).option("--model <model>", t("cli.opt.model")).option("--input <file>", t("cli.opt.input")).description(t("cli.cmd.prd")).action((issue, opts) => prd(issue, opts));
   program.command("review").argument("<pr>", t("cli.arg.reviewPr")).option("--out <file>", t("cli.opt.out")).option("--model <model>", t("cli.opt.model")).option("--input <file>", t("cli.opt.input")).description(t("cli.cmd.review")).action((pr, opts) => review(pr, opts));
   return program;
 }
 async function main() {
   try {
-    loadDotenv([join7(configDir(), ".env"), join7(process.cwd(), ".env")]);
+    loadDotenv([join8(configDir(), ".env"), join8(process.cwd(), ".env")]);
     await resolveLocale();
     await buildProgram().parseAsync(process.argv);
   } catch (err) {
-    console.error(pc14.red(`\u2717 ${err.message}`));
+    console.error(pc15.red(`\u2717 ${err.message}`));
     process.exitCode = 1;
   }
 }