session-steward 0.11.1 → 0.11.2

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.11.2] - 2026-09-23
+
+### Added
+
+- Added `session-steward update` with version output and a sudo prompt when needed.
+
+### Changed
+
+- Updated compatibility coverage for current Codex and Claude releases, including Codex memory v2 storage.
+
 ## [0.11.1] - 2026-09-14
 
 ### Added
@@ -174,6 +184,7 @@
 - Support for custom Codex home folders and a saved folder preference.
 - Streaming and bounded-memory discovery for large session collections and transcripts.
 
+[0.11.2]: https://github.com/mallikcheripally/session-steward/compare/v0.11.1...v0.11.2
 [0.11.1]: https://github.com/mallikcheripally/session-steward/compare/v0.11.0...v0.11.1
 [0.11.0]: https://github.com/mallikcheripally/session-steward/compare/v0.10.3...v0.11.0
 [0.10.3]: https://github.com/mallikcheripally/session-steward/compare/v0.10.2...v0.10.3

package/README.md

@@ -192,10 +192,12 @@ Archiving a Claude Desktop session does not delete it. It remains available unti
 ## Update or uninstall
 
 ```bash
-npm install --global session-steward@latest
+session-steward update
 npm uninstall --global session-steward
 ```
 
+If npm needs root access, the update command asks before retrying with `sudo`.
+
 Uninstalling does not remove provider sessions, recovery backups, or saved folder preferences.
 
 ## Troubleshooting

package/bin/session-steward.mjs

@@ -13,6 +13,20 @@ assertSupportedNode();
 if (process.argv[2] === "mcp") {
   process.argv.splice(2, 1);
   await import("./session-steward-mcp.mjs");
+} else if (process.argv[2] === "update") {
+  process.argv.splice(2, 1);
+  if (process.argv.length !== 2) {
+    process.stderr.write("Usage: session-steward update\n");
+    process.exitCode = 1;
+  } else {
+    const { updateSessionSteward } = await import("../lib/self-update.mjs");
+    try {
+      process.exitCode = await updateSessionSteward();
+    } catch (error) {
+      process.stderr.write(`Could not run the update: ${error.message}\n`);
+      process.exitCode = 1;
+    }
+  }
 } else {
   await startBrowser();
 }
@@ -33,9 +47,11 @@ async function startBrowser() {
   if (values.help) {
     process.stdout.write(`Usage: session-steward [options]
        session-steward mcp [options]
+       session-steward update
 
 Commands:
   mcp                  Run the MCP server over stdio
+  update               Install the latest version with npm
 
 Options:
   --codex-home <path>  Use a custom Codex session folder

package/lib/providers/claude-code/store.mjs

@@ -19,15 +19,15 @@ const PROVIDER_ID = "claude-code";
 const COMPATIBILITY_PROFILE = Object.freeze({
   id: "claude-local-store-2026-08",
   builtFor: {
-    claudeCli: ["2.1.199", "2.1.220", "2.1.228", "2.1.237", "2.1.267"],
-    claudeDesktop: ["1.24012.9", "1.28929.0", "1.32885.1", "1.40609.0", "1.49585.0"],
+    claudeCli: ["2.1.199", "2.1.220", "2.1.228", "2.1.237", "2.1.267", "2.1.280"],
+    claudeDesktop: ["1.24012.9", "1.28929.0", "1.32885.1", "1.40609.0", "1.49585.0", "2.2553.1"],
   },
 });
 const SUPPORTED_ENTRYPOINTS = new Set(["cli", "claude-desktop"]);
 const SHARED_DESKTOP_STATE_FILES = new Set(["scheduled-tasks.json"]);
 const KNOWN_TOP_LEVEL = new Set([
   ".DS_Store", ".last-cleanup", ".last-update-result.json", "agents", "backups", "cache", "commands", "debug", "downloads", "file-history", "history.jsonl", "history.jsonl.lock",
-  "ide", "paste-cache", "plans", "plugins", "projects", "session-env", "sessions", "settings.json",
+  "ide", "image-cache", "paste-cache", "plans", "plugins", "projects", "session-env", "sessions", "settings.json",
   "settings.local.json", "shell-snapshots", "skills", "stats-cache.json", "tasks", "telemetry",
   "todos", "uploads", "usage-data", "mcp-needs-auth-cache.json", "session-steward-backups",
 ]);

package/lib/providers/codex/database-families.mjs

@@ -4,12 +4,24 @@ import path from "node:path";
 import { queryRows } from "../../storage/sqlite.mjs";
 
 const CACHE_TTL_MS = 2_000;
+const MEMORY_TABLES = [
+  { name: "stage1_outputs", requiredColumns: ["thread_id"] },
+  {
+    name: "jobs",
+    optional: true,
+    requiredColumns: [
+      "kind", "job_key", "status", "worker_id", "ownership_token", "started_at",
+      "finished_at", "lease_until", "retry_at", "retry_remaining", "last_error",
+      "input_watermark", "last_success_watermark",
+    ],
+  },
+];
 
 export const CODEX_DATABASE_PROFILE = Object.freeze({
-  id: "codex-local-store-2026-08",
+  id: "codex-local-store-2026-09",
   builtFor: {
-    chatgptDesktop: ["26.727.40816", "26.803.61601", "26.818.21641", "26.818.22352", "26.825.41651", "26.903.61454", "26.903.71938"],
-    codexCli: ["0.144.1", "0.146.0", "0.147.0", "0.148.0", "0.153.4", "0.154.0"],
+    chatgptDesktop: ["26.727.40816", "26.803.61601", "26.818.21641", "26.818.22352", "26.825.41651", "26.903.61454", "26.903.71938", "26.917.51856"],
+    codexCli: ["0.144.1", "0.146.0", "0.147.0", "0.148.0", "0.153.4", "0.154.0", "0.156.1"],
   },
 });
 
@@ -30,28 +42,13 @@ const SCHEMA_REQUIREMENTS = Object.freeze({
     fallback: "memories_1.sqlite",
     pattern: /^memories_(\d+)\.sqlite$/u,
     required: false,
-    tables: [
-      { name: "stage1_outputs", requiredColumns: ["thread_id"] },
-      {
-        name: "jobs",
-        optional: true,
-        requiredColumns: [
-          "kind",
-          "job_key",
-          "status",
-          "worker_id",
-          "ownership_token",
-          "started_at",
-          "finished_at",
-          "lease_until",
-          "retry_at",
-          "retry_remaining",
-          "last_error",
-          "input_watermark",
-          "last_success_watermark",
-        ],
-      },
-    ],
+    tables: MEMORY_TABLES,
+  },
+  memoriesV2: {
+    fallback: "memories_v2_1.sqlite",
+    pattern: /^memories_v2_(\d+)\.sqlite$/u,
+    required: false,
+    tables: MEMORY_TABLES,
   },
   goals: {
     fallback: "goals_1.sqlite",

package/lib/providers/codex/store.mjs

@@ -479,7 +479,7 @@ export function getCodexPaths(codexHomeInput, { refresh = false } = {}) {
   const archivedSessionsDirectory = path.join(codexHome, "archived_sessions");
   const sessionsDirectory = path.join(codexHome, "sessions");
   const resolution = resolveCodexDatabases(codexHome, { refresh });
-  const { goals, logs, memories, queue, state, threadHistory } = resolution.families;
+  const { goals, logs, memories, memoriesV2, queue, state, threadHistory } = resolution.families;
   const stateDatabasePath = state.primary?.path ?? path.join(codexHome, "state_5.sqlite");
   const logsDatabasePath = logs.primary?.path ?? path.join(codexHome, "logs_2.sqlite");
   const memoryDatabasePath = memories.primary?.path ?? path.join(codexHome, "memories_1.sqlite");
@@ -500,7 +500,8 @@ export function getCodexPaths(codexHomeInput, { refresh = false } = {}) {
     logsDatabasePath,
     logsDatabasePaths: allValidDatabases(logs).map((database) => database.path),
     memoryDatabasePath,
-    memoryDatabasePaths: allValidDatabases(memories).map((database) => database.path),
+    memoryDatabasePaths: [memories, memoriesV2].flatMap((family) =>
+      allValidDatabases(family).map((database) => database.path)),
     queueDatabasePath,
     queueDatabasePaths: allValidDatabases(queue).map((database) => database.path),
     resolvedDatabases: databaseFamilySummary(resolution),
@@ -971,6 +972,8 @@ function stateSchema(database) {
     ? database.tables.thread_dynamic_tools
     : inspectSqliteTable(database.path, "thread_dynamic_tools");
   const schema = {
+    attachmentTables: ["thread_artifacts", "thread_attachments"]
+      .filter((tableName) => inspectSqliteTable(database.path, tableName).exists),
     columns,
     hasDynamicTools: Boolean(dynamicTools?.exists),
     hasSpawnEdges: Boolean(spawn?.exists),
@@ -2408,6 +2411,9 @@ export async function fingerprintSessionDeletion({ plan, scope, store }) {
 
   for (const database of store.stateDatabases ?? [{ path: store.stateDatabasePath }]) {
     fingerprintRowsForIds(hash, database.path, "threads", "id", plan.ids);
+    for (const tableName of stateSchema(database).attachmentTables) {
+      fingerprintRowsForIds(hash, database.path, tableName, "thread_id", plan.ids);
+    }
     if (stateSchema(database).hasDynamicTools) {
       fingerprintRowsForIds(hash, database.path, "thread_dynamic_tools", "thread_id", plan.ids);
     }

package/lib/self-update.mjs

@@ -0,0 +1,95 @@
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline/promises";
+
+import packageMetadata from "../package.json" with { type: "json" };
+import { getCommandInvocation } from "./platform.mjs";
+
+const PACKAGE_SPEC = `${packageMetadata.name}@latest`;
+const INSTALL_ARGS = ["install", "--global", PACKAGE_SPEC];
+const VERSION_ARGS = ["list", "--global", "--depth=0", "--json", packageMetadata.name];
+
+async function runCommand(command, args, { captureStdout = false, platform, stderr, stdout }) {
+  const invocation = getCommandInvocation(command, args, { platform });
+
+  return new Promise((resolve, reject) => {
+    const child = spawn(invocation.command, invocation.args, {
+      stdio: ["inherit", "pipe", "pipe"],
+      windowsHide: invocation.windowsHide,
+    });
+    let errorOutput = "";
+    let output = "";
+
+    child.stdout.on("data", (chunk) => {
+      if (captureStdout) output = (output + chunk.toString()).slice(-16_384);
+      else stdout.write(chunk);
+    });
+    child.stderr.on("data", (chunk) => {
+      stderr.write(chunk);
+      errorOutput = (errorOutput + chunk.toString()).slice(-8_192);
+    });
+    child.on("error", reject);
+    child.on("close", (exitCode) => resolve({ exitCode: exitCode ?? 1, errorOutput, output }));
+  });
+}
+
+async function confirmSudo({ stdin, stdout }) {
+  const prompt = createInterface({ input: stdin, output: stdout });
+  try {
+    const answer = await prompt.question("Retry the update with sudo? [y/N] ");
+    return /^(?:y|yes)$/iu.test(answer.trim());
+  } finally {
+    prompt.close();
+  }
+}
+
+export async function updateSessionSteward({
+  confirm = confirmSudo,
+  currentVersion = packageMetadata.version,
+  platform = process.platform,
+  run = runCommand,
+  stdin = process.stdin,
+  stdout = process.stdout,
+  stderr = process.stderr,
+} = {}) {
+  stdout.write(`Current version: ${currentVersion}\nUpdating Session Steward with npm...\n`);
+  let result = await run("npm", INSTALL_ARGS, { platform, stderr, stdout });
+  let usedSudo = false;
+
+  if (result.exitCode !== 0 && /\b(?:EACCES|EPERM)\b/u.test(result.errorOutput)) {
+    if (platform === "win32") {
+      stderr.write("Global npm install needs permission. Open an elevated terminal and run session-steward update.\n");
+    } else if (stdin.isTTY && stdout.isTTY) {
+      stdout.write("The global npm install needs elevated permission.\n");
+      if (await confirm({ stdin, stdout })) {
+        usedSudo = true;
+        result = await run("sudo", ["npm", ...INSTALL_ARGS], { platform, stderr, stdout });
+      }
+    } else {
+      stderr.write("Global npm install needs elevated permission. Run sudo session-steward update in a terminal.\n");
+    }
+  }
+
+  if (result.exitCode === 0) {
+    let installedVersion;
+    try {
+      const versionResult = await run(
+        usedSudo ? "sudo" : "npm",
+        usedSudo ? ["npm", ...VERSION_ARGS] : VERSION_ARGS,
+        { captureStdout: true, platform, stderr, stdout },
+      );
+      if (versionResult.exitCode === 0) {
+        installedVersion = JSON.parse(versionResult.output)?.dependencies?.[packageMetadata.name]?.version;
+      }
+    } catch {
+      // Installation succeeded, but npm could not confirm the installed version.
+    }
+
+    if (typeof installedVersion === "string" && /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.+-]+)?$/u.test(installedVersion)) {
+      stdout.write(`Updated version: ${installedVersion}\n`);
+    } else {
+      stderr.write("Update completed, but the installed version could not be confirmed. Run session-steward --version.\n");
+    }
+  }
+
+  return result.exitCode;
+}

package/lib/update-check.mjs

@@ -80,6 +80,6 @@ export async function findAvailableUpdate({
   }
 }
 
-export function formatUpdateNotice({ latestVersion, packageName }) {
-  return `Session Steward ${latestVersion} is available. Update with: npm install -g ${packageName}@latest`;
+export function formatUpdateNotice({ latestVersion }) {
+  return `Session Steward ${latestVersion} is available. Update with: session-steward update`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "session-steward",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "mcpName": "io.github.mallikcheripally/session-steward",
   "description": "Codex and Claude Code session manager - browse and delete old sessions. Browser UI + CLI + MCP",
   "license": "MIT",