multiclaw 0.9.0 → 0.10.0

package/dist/commands/prune.d.ts

@@ -1,6 +1,6 @@
 export interface PruneOptions {
     config?: string;
-    history?: boolean;
+    sessions?: boolean;
     runs?: boolean;
     all?: boolean;
     dryRun?: boolean;
@@ -11,7 +11,7 @@ export interface PruneItem {
     label: string;
     path: string;
     size: number;
-    kind: "history" | "run" | "all-runs";
+    kind: "session" | "run" | "all-runs";
 }
 /** Scan `.multiclaw/` and list prune-able items with their sizes. */
 export declare function scanPruneItems(workDir: string): PruneItem[];

package/dist/commands/sessions.d.ts

@@ -0,0 +1,13 @@
+export interface SessionsCommandOptions {
+    config?: string;
+}
+/** `multiclaw sessions ls` — list saved sessions, newest first. */
+export declare function sessionsListCommand(options: SessionsCommandOptions): Promise<void>;
+/**
+ * `multiclaw sessions rm <id>` — delete a session by id or a unique prefix.
+ *
+ * A prefix is accepted because the ids are UUIDs no one types in full. An
+ * ambiguous prefix is refused rather than guessed, so a `rm` never deletes a
+ * session the user did not mean.
+ */
+export declare function sessionsRemoveCommand(id: string, options: SessionsCommandOptions): Promise<void>;

package/dist/commands/tui.d.ts

@@ -1,4 +1,8 @@
 export interface TuiCommandOptions {
     config?: string;
+    /** Start a fresh session instead of continuing the most recent one. */
+    new?: boolean;
+    /** Resume a session: a specific id, or `true` to open the picker. */
+    resume?: string | boolean;
 }
 export declare function tuiCommand(options: TuiCommandOptions): Promise<void>;

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/index.ts
 import { readFileSync as readFileSync4 } from "fs";
-import { dirname as dirname4, join as join6 } from "path";
+import { dirname as dirname5, join as join6 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { Command } from "commander";
 
@@ -475,24 +475,28 @@ import { checkbox as checkbox2, confirm } from "@inquirer/prompts";
 function scanPruneItems(workDir) {
   const items = [];
   const multiclawDir = path3.join(workDir, ".multiclaw");
-  const historyFile = path3.join(multiclawDir, "console", "history.json");
-  if (fs3.existsSync(historyFile)) {
-    const stat = fs3.statSync(historyFile);
-    const raw = fs3.readFileSync(historyFile, "utf-8");
-    let turns = 0;
-    try {
-      const parsed = JSON.parse(raw);
-      if (Array.isArray(parsed)) turns = parsed.length;
-    } catch {
-    }
-    items.push({
-      id: "history",
-      label: `Console history (${turns} turn${turns === 1 ? "" : "s"}, ${formatBytes(stat.size)})`,
-      path: historyFile,
-      size: stat.size,
-      kind: "history"
+  const sessionsDir = path3.join(multiclawDir, "sessions");
+  const index = readSessionIndex(sessionsDir);
+  const metaById = new Map(index.map((meta) => [meta.id, meta]));
+  const onDisk = fs3.existsSync(sessionsDir) ? fs3.readdirSync(sessionsDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name) : [];
+  const sessionItems2 = [];
+  for (const id of /* @__PURE__ */ new Set([...metaById.keys(), ...onDisk])) {
+    const dir = path3.join(sessionsDir, id);
+    const size = fs3.existsSync(dir) ? dirSize(dir) : 0;
+    const meta = metaById.get(id);
+    const title = meta?.title && meta.title.trim() !== "" ? meta.title : "(untitled)";
+    const turns = meta?.turnCount ?? 0;
+    sessionItems2.push({
+      id,
+      label: `${title}  (${turns} turn${turns === 1 ? "" : "s"}, ${formatBytes(size)})`,
+      path: dir,
+      size,
+      kind: "session",
+      lastActiveAt: meta?.lastActiveAt ?? 0
     });
   }
+  sessionItems2.sort((a, b) => b.lastActiveAt - a.lastActiveAt);
+  for (const { lastActiveAt: _unused, ...item } of sessionItems2) items.push(item);
   const runsDir = path3.join(multiclawDir, "runs");
   if (fs3.existsSync(runsDir)) {
     const entries = fs3.readdirSync(runsDir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name.startsWith("run-")).sort((a, b) => a.name.localeCompare(b.name));
@@ -527,8 +531,9 @@ function deletePruneItems(items) {
   const failed = [];
   for (const item of items) {
     try {
-      if (item.kind === "history") {
-        fs3.unlinkSync(item.path);
+      if (item.kind === "session") {
+        fs3.rmSync(item.path, { recursive: true, force: true });
+        removeSessionFromIndex(path3.dirname(item.path), path3.basename(item.path));
         deleted.push(item.id);
       } else if (item.kind === "run") {
         fs3.rmSync(item.path, { recursive: true, force: true });
@@ -555,11 +560,11 @@ function resolvePruneTargets(options, items) {
   if (options.all) {
     return items.map((i) => i.id);
   }
-  if (options.history && options.runs) {
+  if (options.sessions && options.runs) {
     return items.map((i) => i.id);
   }
-  if (options.history) {
-    return items.filter((i) => i.kind === "history").map((i) => i.id);
+  if (options.sessions) {
+    return items.filter((i) => i.kind === "session").map((i) => i.id);
   }
   if (options.runs) {
     return items.filter((i) => i.kind === "run" || i.kind === "all-runs").map((i) => i.id);
@@ -570,7 +575,7 @@ async function pruneCommand(options) {
   const config = await loadConfig(options.config);
   const items = scanPruneItems(config.workDir);
   if (items.length === 0) {
-    console.log("Nothing to prune \u2014 no history or runs found.");
+    console.log("Nothing to prune \u2014 no sessions or runs found.");
     return;
   }
   let selectedIds;
@@ -635,6 +640,46 @@ async function pruneCommand(options) {
     process.exitCode = 1;
   }
 }
+function readSessionIndex(sessionsDir) {
+  try {
+    const parsed = JSON.parse(
+      fs3.readFileSync(path3.join(sessionsDir, "index.json"), "utf-8")
+    );
+    if (!Array.isArray(parsed)) return [];
+    const entries = [];
+    for (const value of parsed) {
+      if (typeof value !== "object" || value === null) continue;
+      const entry = value;
+      if (typeof entry.id !== "string") continue;
+      entries.push({
+        id: entry.id,
+        title: typeof entry.title === "string" ? entry.title : "",
+        turnCount: typeof entry.turnCount === "number" ? entry.turnCount : 0,
+        lastActiveAt: typeof entry.lastActiveAt === "number" ? entry.lastActiveAt : 0
+      });
+    }
+    return entries;
+  } catch {
+    return [];
+  }
+}
+function removeSessionFromIndex(sessionsDir, id) {
+  const indexPath = path3.join(sessionsDir, "index.json");
+  let parsed;
+  try {
+    parsed = JSON.parse(fs3.readFileSync(indexPath, "utf-8"));
+  } catch {
+    return;
+  }
+  if (!Array.isArray(parsed)) return;
+  const next = parsed.filter(
+    (entry) => !(typeof entry === "object" && entry !== null && entry.id === id)
+  );
+  if (next.length === parsed.length) return;
+  const tmp = `${indexPath}.tmp`;
+  fs3.writeFileSync(tmp, JSON.stringify(next), "utf-8");
+  fs3.renameSync(tmp, indexPath);
+}
 function formatBytes(bytes) {
   if (bytes === 0) return "0 B";
   const k = 1024;
@@ -997,9 +1042,9 @@ function resumeOptionsFromReport(report, requirementOverride) {
   if (agents2.length === 0) {
     throw new Error("The previous run has no agent results \u2014 nothing to resume");
   }
-  const sessions = {};
+  const sessions2 = {};
   for (const result of latest.values()) {
-    if (result.sessionId) sessions[result.agentId] = result.sessionId;
+    if (result.sessionId) sessions2[result.agentId] = result.sessionId;
   }
   const requirement = requirementOverride ?? report.requirement;
   if (requirement === void 0) {
@@ -1011,7 +1056,7 @@ function resumeOptionsFromReport(report, requirementOverride) {
       agents: agents2,
       // Absent, not `{}`: core reads a missing `sessions` as "start every agent
       // fresh", which is exactly the single-agent retry of a failed agent.
-      ...Object.keys(sessions).length > 0 ? { sessions } : {}
+      ...Object.keys(sessions2).length > 0 ? { sessions: sessions2 } : {}
     }
   };
 }
@@ -1128,13 +1173,67 @@ function walkFiles(root, visit) {
   }
 }
 
+// src/commands/sessions.ts
+function sessionItems(workDir) {
+  return scanPruneItems(workDir).filter((item) => item.kind === "session");
+}
+async function sessionsListCommand(options) {
+  const config = await loadConfig(options.config);
+  const items = sessionItems(config.workDir);
+  if (items.length === 0) {
+    console.log("No saved sessions.");
+    return;
+  }
+  for (const item of items) {
+    console.log(`  \x1B[2m${item.id}\x1B[0m  ${item.label}`);
+  }
+}
+async function sessionsRemoveCommand(id, options) {
+  const config = await loadConfig(options.config);
+  const items = sessionItems(config.workDir);
+  const exact = items.find((item) => item.id === id);
+  const matches = exact ? [exact] : items.filter((item) => item.id.startsWith(id));
+  if (matches.length === 0) {
+    console.error(`No session matching "${id}".`);
+    process.exitCode = 1;
+    return;
+  }
+  if (matches.length > 1) {
+    console.error(
+      `"${id}" matches ${matches.length} sessions \u2014 use more of the id:
+${matches.map((m) => `  ${m.id}`).join("\n")}`
+    );
+    process.exitCode = 1;
+    return;
+  }
+  const { deleted, failed } = deletePruneItems(matches);
+  if (deleted.length > 0) {
+    console.log(`\x1B[32m\u2713\x1B[0m Removed session ${matches[0].id}`);
+  }
+  if (failed.length > 0) {
+    console.error(`\x1B[31m\u2717\x1B[0m Failed to remove ${matches[0].id}: ${failed[0].error}`);
+    process.exitCode = 1;
+  }
+}
+
 // src/commands/tui.ts
+function initialSession(options) {
+  if (options.new) return { kind: "new" };
+  if (options.resume !== void 0) {
+    return {
+      kind: "resume",
+      ...typeof options.resume === "string" ? { id: options.resume } : {}
+    };
+  }
+  return void 0;
+}
 async function tuiCommand(options) {
   const config = await loadConfig(options.config);
   await assertRuntimesAvailable(config);
   const { startTui } = await import("@multiclawcli/dashboard/tui");
   await startTui({
     config,
+    initialSession: initialSession(options),
     onTurnStart: (eventBus, logDir) => {
       const writer = new FileLogWriter(logDir);
       const detach = writer.attach(eventBus);
@@ -1152,7 +1251,7 @@ async function tuiCommand(options) {
 // src/commands/upgrade.ts
 import { execSync } from "child_process";
 import { existsSync as existsSync6, readFileSync as readFileSync3 } from "fs";
-import { dirname as dirname3, join as join5, resolve as resolve4 } from "path";
+import { dirname as dirname4, join as join5, resolve as resolve4 } from "path";
 import { fileURLToPath } from "url";
 var PACKAGE_NAME = "multiclaw";
 var RED2 = "\x1B[31m";
@@ -1171,7 +1270,7 @@ function findPackageRoot(start) {
   let dir = resolve4(start);
   for (; ; ) {
     if (readManifest(dir)?.name === PACKAGE_NAME) return dir;
-    const parent = dirname3(dir);
+    const parent = dirname4(dir);
     if (parent === dir) return void 0;
     dir = parent;
   }
@@ -1202,7 +1301,7 @@ var MANUAL = {
   unknown: "npm install -g multiclaw@latest"
 };
 function createUpgradeContext() {
-  const pkgRoot = findPackageRoot(dirname3(fileURLToPath(import.meta.url)));
+  const pkgRoot = findPackageRoot(dirname4(fileURLToPath(import.meta.url)));
   if (!pkgRoot) return void 0;
   const currentVersion = readInstalledVersion(pkgRoot);
   if (!currentVersion) return void 0;
@@ -1275,10 +1374,12 @@ async function upgradeCommand() {
 
 // src/index.ts
 var __filename2 = fileURLToPath2(import.meta.url);
-var __dirname2 = dirname4(__filename2);
+var __dirname2 = dirname5(__filename2);
 var pkg = JSON.parse(readFileSync4(join6(__dirname2, "../package.json"), "utf-8"));
 var program = new Command();
-program.name("multiclaw").description("Multi-agent orchestration CLI").version(pkg.version, "-v, --version", "Display version number").action((options) => tuiCommand(options));
+program.name("multiclaw").description("Multi-agent orchestration CLI").version(pkg.version, "-v, --version", "Display version number").option("--config <path>", "Config file path (default: auto-discover ./multiclaw.config.ts)").option("--new", "Start a new session instead of continuing the most recent").option("-r, --resume [id]", "Resume a session by id, or open the session picker").action(
+  (options) => tuiCommand(options)
+);
 program.command("init").description("Scaffold a config file (interactive)").action(() => initCommand());
 program.command("run [requirement]").description("Run an orchestration headlessly").option("--config <path>", "Config file path (default: auto-discover ./multiclaw.config.ts)").option("--no-leader", "Batch mode only: skip routing and run the full team").option("--dry-run", "Preview the routed plan without running the pipeline").option(
   "--resume [path]",
@@ -1286,7 +1387,10 @@ program.command("run [requirement]").description("Run an orchestration headlessl
 ).action((requirement, opts) => runCommand(requirement, opts));
 program.command("upgrade").description("Upgrade multiclaw to the latest version").action(() => upgradeCommand());
 program.command("doctor").description("Check which agent providers are installed and ready").option("--config <path>", "Config file path (default: auto-discover ./multiclaw.config.ts)").action((opts) => doctorCommand(opts.config));
-program.command("prune").description("Clean up history entries and old run directories (interactive)").option("--config <path>", "Config file path (default: auto-discover ./multiclaw.config.ts)").option("--history", "Prune console history only (non-interactive)").option("--runs", "Prune all runs only (non-interactive)").option("--all", "Prune everything (non-interactive)").option("--dry-run", "Show what would be deleted without deleting").option("--yes", "Skip confirmation prompt").action((opts) => pruneCommand(opts));
+program.command("prune").description("Clean up saved sessions and old run directories (interactive)").option("--config <path>", "Config file path (default: auto-discover ./multiclaw.config.ts)").option("--sessions", "Prune saved sessions only (non-interactive)").option("--runs", "Prune all runs only (non-interactive)").option("--all", "Prune everything (non-interactive)").option("--dry-run", "Show what would be deleted without deleting").option("--yes", "Skip confirmation prompt").action((opts) => pruneCommand(opts));
+var sessions = program.command("sessions").description("Manage saved console sessions");
+sessions.command("ls").description("List saved sessions, newest first").option("--config <path>", "Config file path (default: auto-discover ./multiclaw.config.ts)").action((opts) => sessionsListCommand(opts));
+sessions.command("rm <id>").description("Delete a saved session by id (or a unique prefix)").option("--config <path>", "Config file path (default: auto-discover ./multiclaw.config.ts)").action((id, opts) => sessionsRemoveCommand(id, opts));
 program.parseAsync(process.argv).catch((err) => {
   const message = err instanceof Error ? err.message : String(err);
   console.error(`\x1B[31mError: ${message}\x1B[0m`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multiclaw",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "type": "module",
   "bin": {
     "multiclaw": "dist/index.js"
@@ -30,8 +30,8 @@
     "@agentclientprotocol/claude-agent-acp": "^0.95.0",
     "@agentclientprotocol/codex-acp": "^2.2.2",
     "@inquirer/prompts": "^8.7.4",
-    "@multiclawcli/core": "0.9.0",
-    "@multiclawcli/dashboard": "0.9.0",
+    "@multiclawcli/core": "0.10.0",
+    "@multiclawcli/dashboard": "0.10.0",
     "commander": "^15.0.0",
     "jiti": "^2.7.0"
   },