@sellable/install 0.1.682 → 0.1.683

package/container/Dockerfile

@@ -3,13 +3,13 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.682
-ARG MCP_PACKAGE=@sellable/mcp@0.1.899
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.683
+ARG MCP_PACKAGE=@sellable/mcp@0.1.900
 ARG INSTALLER_INTEGRITY
-ARG MCP_INTEGRITY=sha512-hnwdSFBun/DESrkNTbM+sRLMVjkRF1iMFRHw8zurlse4r5XxBu1VIo03mo9TVR5mEUVrJmpNxsU4QweODpmHMg==
+ARG MCP_INTEGRITY=sha512-xLAA8pzfKujvUYT+eg8FPTGgA2CIcgsPG3bM1NjMPLOSib7l32H4ca9SkbeBV7jOPCxcc3+XZBKEIhmtJufiEg==
 
-RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.682" \
-    && test "${MCP_PACKAGE}" = "@sellable/mcp@0.1.899" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.683" \
+    && test "${MCP_PACKAGE}" = "@sellable/mcp@0.1.900" \
     && test -n "${INSTALLER_INTEGRITY}" \
     && test "$(npm view "${INSTALLER_PACKAGE}" dist.integrity)" = "${INSTALLER_INTEGRITY}" \
     && test "$(npm view "${MCP_PACKAGE}" dist.integrity)" = "${MCP_INTEGRITY}" \
@@ -23,9 +23,9 @@ RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.682" \
     && mkdir -p /opt/sellable-agent/install-root /opt/sellable-agent/mcp-root \
     && npm install --prefix /opt/sellable-agent/install-root --omit=dev --ignore-scripts --no-audit --no-fund "${INSTALLER_PACKAGE}" \
     && npm install --prefix /opt/sellable-agent/mcp-root --omit=dev --ignore-scripts --no-audit --no-fund "${MCP_PACKAGE}" \
-    && node --input-type=module -e "import { readFileSync } from 'node:fs'; const install = JSON.parse(readFileSync('/opt/sellable-agent/install-root/node_modules/@sellable/install/package.json')); const mcp = JSON.parse(readFileSync('/opt/sellable-agent/mcp-root/node_modules/@sellable/mcp/package.json')); if (install.name !== '@sellable/install' || install.version !== '0.1.682' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.899') throw new Error('package identity rejected');" \
+    && node --input-type=module -e "import { readFileSync } from 'node:fs'; const install = JSON.parse(readFileSync('/opt/sellable-agent/install-root/node_modules/@sellable/install/package.json')); const mcp = JSON.parse(readFileSync('/opt/sellable-agent/mcp-root/node_modules/@sellable/mcp/package.json')); if (install.name !== '@sellable/install' || install.version !== '0.1.683' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.900') throw new Error('package identity rejected');" \
     && node --input-type=module -e "import { buildExternalRuntimeClosure } from '/opt/sellable-agent/install-root/node_modules/@sellable/install/lib/sellable-agent/external-runtime-builder.mjs'; const built = buildExternalRuntimeClosure({ mcpPackageRoot: '/opt/sellable-agent/mcp-root/node_modules/@sellable/mcp', mcpNodeModulesRoot: '/opt/sellable-agent/mcp-root/node_modules', hermesSourceRoot: '/opt/hermes', ownerUid: 0, ownerGid: 0 }); if (!built.closureDigest) throw new Error('runtime closure rejected');" \
-    && node --input-type=module -e "import { chmodSync, writeFileSync } from 'node:fs'; const release = { installerPackage: '@sellable/install@0.1.682', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.899', mcpIntegrity: process.argv[2] }; writeFileSync('/opt/sellable-agent/release.json', JSON.stringify(release) + '\\n', { mode: 0o444 }); chmodSync('/opt/sellable-agent/release.json', 0o444);" "${INSTALLER_INTEGRITY}" "${MCP_INTEGRITY}" \
+    && node --input-type=module -e "import { chmodSync, writeFileSync } from 'node:fs'; const release = { installerPackage: '@sellable/install@0.1.683', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.900', mcpIntegrity: process.argv[2] }; writeFileSync('/opt/sellable-agent/release.json', JSON.stringify(release) + '\\n', { mode: 0o444 }); chmodSync('/opt/sellable-agent/release.json', 0o444);" "${INSTALLER_INTEGRITY}" "${MCP_INTEGRITY}" \
     && npm cache clean --force
 
 COPY entrypoint.sh /usr/local/bin/sellable-agent-container-entrypoint

package/container/README.md

@@ -3,7 +3,7 @@
 This image is a dedicated Agent worker/runtime boundary beside an existing Hermes dashboard. It never replaces or reconfigures the dashboard container.
 
 Build from this directory after
-`@sellable/install@0.1.682` is
+`@sellable/install@0.1.683` is
 published:
 
 ```sh

package/lib/sellable-agent/external-runtime-builder.mjs

@@ -28,7 +28,7 @@ import {
 
 const MANIFEST_VERSION = "sellable-agent-external-runtime-closure/v1";
 const MCP_PACKAGE = "@sellable/mcp";
-const MCP_VERSION = "0.1.899";
+const MCP_VERSION = "0.1.900";
 const SAFE_COMPONENT = /^[A-Za-z0-9@._+-]+$/;
 const HERMES_EXCLUDES = new Set([".git", ".playwright", "node_modules"]);
 

package/lib/sellable-agent/fly-admin-image/admin-runtime.mjs

@@ -831,8 +831,10 @@ const ADMIN_LIVE_SKILLS_CONFIG_KEYS = Object.freeze([
   "platform_disabled",
 ]);
 const ADMIN_LIVE_PLUGIN_CONFIG_KEYS = Object.freeze(["enabled", "disabled"]);
-const ADMIN_SEALED_SKILL_DIRECTORIES = new Set([
-  "sellable",
+const ADMIN_SEALED_SKILL_PATHS = new Set([
+  // The package owns only the root routing skill. Customer/operator skills
+  // live below this namespace and must survive profile materialization.
+  "sellable/SKILL.md",
   // The Admin profile factory owns this whole namespace. Preserving an old
   // package version as mutable operator state makes every package upgrade
   // restage forever when any Admin skill changes.
@@ -865,7 +867,9 @@ function adminPreservedSkillsIdentity(profileRoot) {
       const nextRelative = relativePath ? `${relativePath}/${name}` : name;
       if (
         rootName === "skills" &&
-        ADMIN_SEALED_SKILL_DIRECTORIES.has(nextRelative)
+        [...ADMIN_SEALED_SKILL_PATHS].some(
+          (path) => nextRelative === path || nextRelative.startsWith(`${path}/`)
+        )
       )
         continue;
       const path = join(directory, name);
@@ -1188,9 +1192,7 @@ async function materializeAdminProfile({
               join(profileHome, "skills"),
               join(stageRoot, "skills"),
               {
-                preserveTargetTopLevelNames: [
-                  ...ADMIN_SEALED_SKILL_DIRECTORIES,
-                ],
+                preserveTargetPaths: [...ADMIN_SEALED_SKILL_PATHS],
               }
             );
           }

package/lib/sellable-agent/fly-customer-image/Dockerfile

@@ -6,9 +6,9 @@ USER root
 
 ENV PLAYWRIGHT_BROWSERS_PATH=/opt/hermes/.playwright
 
-ARG MCP_PACKAGE=@sellable/mcp@0.1.899
-ARG MCP_INTEGRITY=sha512-hnwdSFBun/DESrkNTbM+sRLMVjkRF1iMFRHw8zurlse4r5XxBu1VIo03mo9TVR5mEUVrJmpNxsU4QweODpmHMg==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.682
+ARG MCP_PACKAGE=@sellable/mcp@0.1.900
+ARG MCP_INTEGRITY=sha512-xLAA8pzfKujvUYT+eg8FPTGgA2CIcgsPG3bM1NjMPLOSib7l32H4ca9SkbeBV7jOPCxcc3+XZBKEIhmtJufiEg==
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.683
 ARG ADMIN_MCP_PACKAGE=@sellable/admin-mcp@0.1.186-wip.phase158.20260802034727
 ARG ADMIN_MCP_INTEGRITY=sha512-qYNew5wd2IfgVcp1UYOG9QvpF/8Mx19YJ5HQtMKzvSfUf3evePjtaKsoXLf2C/GUJ5QlLlHJo84VWOI3V01+9A==
 ARG TUS_JS_CLIENT_VERSION=4.3.1

package/lib/sellable-agent/fly-customer-image/customer-runtime.mjs

@@ -106,9 +106,9 @@ const BOOT_SESSION_ID = randomUUID();
 const HERMES_VERSION = process.env.SELLABLE_AGENT_HERMES_VERSION ?? "0.20.4";
 const INSTALLER_PACKAGE =
   process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ??
-  "@sellable/install@0.1.682";
+  "@sellable/install@0.1.683";
 const MCP_PACKAGE =
-  process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.899";
+  process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.900";
 const DEFAULT_PROFILE_BUNDLE_ROOT =
   "/usr/local/share/sellable-agent/default-profile-bundle";
 const DEFAULT_PROFILE_CRON_PYTHON = [

package/lib/sellable-agent/fly-runtime-identity.mjs

@@ -1026,7 +1026,7 @@ export function createFlyCustomerControlClient({
     /^[a-f0-9]{64}$/.test(value?.archiveDigest ?? "") &&
     Number.isSafeInteger(value?.archiveBytes) &&
     value.archiveBytes > 0 &&
-    value.archiveBytes <= 128 * 1024 * 1024 &&
+    value.archiveBytes <= 512 * 1024 * 1024 &&
     value.hermesVersion === "0.20.4" &&
     /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/.test(value?.sourceProfileId ?? "");
   const boundedSnapshotIdentity = (value) =>
@@ -1159,7 +1159,7 @@ export function createFlyCustomerControlClient({
         /^[a-f0-9]{64}$/.test(result.archiveDigest ?? "") &&
         Number.isSafeInteger(result.archiveBytes) &&
         result.archiveBytes > 0 &&
-        result.archiveBytes <= 128 * 1024 * 1024);
+        result.archiveBytes <= 512 * 1024 * 1024);
     if (
       !(isV2 ? identityReadbackAccepted : metadataAccepted(result)) ||
       !signedUrlAccepted(result.signedUrl)

package/lib/sellable-agent/hermes-memory-snapshot.mjs

@@ -64,13 +64,7 @@ export const HERMES_OPPORTUNITY_SEQUENCES_CRON = Object.freeze({
   schedule: "every 30m",
   deliver: "slack",
   skills: Object.freeze([HERMES_OPPORTUNITY_SEQUENCES_SKILL]),
-  enabledToolsets: Object.freeze([
-    "file",
-    "terminal",
-    "safe",
-    "sellable",
-    "mcp",
-  ]),
+  enabledToolsets: Object.freeze(["file", "terminal", "safe", "sellable", "mcp"]),
   noAgent: false,
 });
 export const HERMES_OPPORTUNITY_SEQUENCES_JOURNAL_ROOT =
@@ -88,7 +82,13 @@ export const HERMES_CLIENT_RELATIONSHIPS_CRONS = Object.freeze({
   chaseSchedule: "30 13 * * 1-5",
   deliver: "slack",
   skills: Object.freeze([HERMES_CLIENT_RELATIONSHIPS_SKILL]),
-  enabledToolsets: Object.freeze(["file", "terminal", "safe", "sellable", "mcp"]),
+  enabledToolsets: Object.freeze([
+    "file",
+    "terminal",
+    "safe",
+    "sellable",
+    "mcp",
+  ]),
   noAgent: false,
 });
 export const CLIENT_RELATIONSHIPS_ASSETS = Object.freeze([
@@ -104,7 +104,12 @@ const VERSION = "0.20.4";
 const ID = /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/;
 const BOUNDED_ID = /^[A-Za-z0-9][A-Za-z0-9_./:-]{0,255}$/;
 const SHA256 = /^[a-f0-9]{64}$/;
-const MAX_BYTES = 128 * 1024 * 1024;
+// Native state.db is durable conversation/thread state and grows over time.
+// The previous 128 MiB ceiling left the Admin recovery ZIP only ~1.5 MiB of
+// headroom in production and eventually made every protected Backup/Refresh
+// fail after Hermes had already created the archive. Keep this bounded for
+// memory/storage safety, but large enough for an established profile.
+export const HERMES_SNAPSHOT_MAX_ARCHIVE_BYTES = 512 * 1024 * 1024;
 const MAX_PLUGIN_DATA_BYTES = 10 * 1024 * 1024;
 const MAX_PORTABLE_EXTERNAL_BYTES = 32 * 1024 * 1024;
 const MAX_PORTABLE_CONFIG_BYTES = 64 * 1024;
@@ -115,6 +120,8 @@ const MAX_PORTABLE_CONFIG_BYTES = 64 * 1024;
 // persistent retry scheduler back off instead of contending with the live
 // Slack gateway for a full ten minutes.
 const NATIVE_COMMAND_TIMEOUT_MS = 120_000;
+const STATE_DB_COMPACTION_TIMEOUT_MS = 240_000;
+export const HERMES_SNAPSHOT_CRON_SESSION_RETENTION_HOURS = 48;
 const TRANSIENT_PROFILE_ROOTS = new Set([
   ".artifact-venv",
   ".cache",
@@ -415,27 +422,55 @@ export function mergeHermesState(
 export function replaceHermesState(
   sourceRoot,
   targetRoot,
-  /** @type {{preserveTargetTopLevelNames?:string[]}} */
-  { preserveTargetTopLevelNames = [] } = {}
+  /** @type {{preserveTargetTopLevelNames?:string[],preserveTargetPaths?:string[]}} */
+  { preserveTargetTopLevelNames = [], preserveTargetPaths = [] } = {}
 ) {
   assertHermesMergeRoot(targetRoot);
-  const preserved = hermesTopLevelNameSet(
+  const preservedTopLevel = hermesTopLevelNameSet(
     preserveTargetTopLevelNames,
     "hermes_snapshot_replace_policy_rejected"
   );
-  for (const name of readdirSync(targetRoot)) {
-    if (preserved.has(name)) continue;
-    const targetPath = join(targetRoot, name);
-    const stat = lstatSync(targetPath);
-    if (stat.isSymbolicLink() || (!stat.isDirectory() && !stat.isFile())) {
-      throw new Error("hermes_snapshot_merge_target_rejected");
+  const preservedPaths = new Set(
+    preserveTargetPaths.map((path) => {
+      if (
+        typeof path !== "string" ||
+        !/^[A-Za-z0-9][A-Za-z0-9._-]*(?:\/[A-Za-z0-9][A-Za-z0-9._-]*)*$/.test(
+          path
+        )
+      ) {
+        throw new Error("hermes_snapshot_replace_policy_rejected");
+      }
+      return path;
+    })
+  );
+  for (const name of preservedTopLevel) preservedPaths.add(name);
+  const prune = (target, relativeRoot = "") => {
+    for (const name of readdirSync(target)) {
+      const relativePath = relativeRoot ? `${relativeRoot}/${name}` : name;
+      const targetPath = join(target, name);
+      const stat = lstatSync(targetPath);
+      if (stat.isSymbolicLink() || (!stat.isDirectory() && !stat.isFile())) {
+        throw new Error("hermes_snapshot_merge_target_rejected");
+      }
+      if (preservedPaths.has(relativePath)) continue;
+      if (
+        [...preservedPaths].some((path) => path.startsWith(`${relativePath}/`))
+      ) {
+        if (!stat.isDirectory()) {
+          throw new Error("hermes_snapshot_merge_target_rejected");
+        }
+        prune(targetPath, relativePath);
+        continue;
+      }
+      rmSync(targetPath, { recursive: true, force: false });
     }
-    rmSync(targetPath, { recursive: true, force: false });
-  }
+  };
+  prune(targetRoot);
   if (!assertHermesMergeRoot(sourceRoot, { allowMissing: true })) return;
-  mergeHermesStateEntries(sourceRoot, targetRoot, {
-    skippedTopLevelNames: preserved,
-  });
+  // The merge is deliberately no-clobber. Exact sealed target paths survive,
+  // while mutable source siblings (for example sellable/<custom-skill>) are
+  // carried into the staged profile.
+  mergeHermesStateEntries(sourceRoot, targetRoot);
 }
 
 const LEGACY_LIGHTFIELD_VENV = ".venv-amplify-audit";
@@ -557,6 +592,77 @@ function cronJobs(profileRoot) {
   return jobs;
 }
 
+function assertStagedCronDependencies(profileRoot) {
+  const skillNames = new Set();
+  const skillsRoot = join(profileRoot, "skills");
+  const walkSkills = (directory) => {
+    for (const name of readdirSync(directory)) {
+      const path = join(directory, name);
+      const stat = lstatSync(path);
+      if (stat.isSymbolicLink()) {
+        throw new Error("hermes_snapshot_dependency_rejected");
+      }
+      if (stat.isDirectory()) walkSkills(path);
+      else if (stat.isFile() && name === "SKILL.md") {
+        skillNames.add(basename(directory));
+      }
+    }
+  };
+  if (existsSync(skillsRoot)) {
+    const stat = lstatSync(skillsRoot);
+    if (stat.isSymbolicLink() || !stat.isDirectory()) {
+      throw new Error("hermes_snapshot_dependency_rejected");
+    }
+    walkSkills(skillsRoot);
+  }
+  const scriptsRoot = join(profileRoot, "scripts");
+  for (const job of cronJobs(profileRoot)) {
+    if (!job || typeof job !== "object" || Array.isArray(job)) {
+      throw new Error("hermes_snapshot_dependency_rejected");
+    }
+    const declaredSkills = [];
+    if (Object.hasOwn(job, "skill") && job.skill !== null) {
+      if (typeof job.skill !== "string" || !ID.test(job.skill)) {
+        throw new Error("hermes_snapshot_dependency_rejected");
+      }
+      declaredSkills.push(job.skill);
+    }
+    if (Object.hasOwn(job, "skills") && job.skills !== null) {
+      if (
+        !Array.isArray(job.skills) ||
+        job.skills.some((skill) => typeof skill !== "string" || !ID.test(skill))
+      ) {
+        throw new Error("hermes_snapshot_dependency_rejected");
+      }
+      declaredSkills.push(...job.skills);
+    }
+    if (declaredSkills.some((skill) => !skillNames.has(skill))) {
+      throw new Error("hermes_snapshot_dependency_rejected");
+    }
+    if (Object.hasOwn(job, "script") && job.script !== null) {
+      if (
+        typeof job.script !== "string" ||
+        !/^[A-Za-z0-9][A-Za-z0-9._-]*(?:\/[A-Za-z0-9][A-Za-z0-9._-]*)*$/.test(
+          job.script
+        )
+      ) {
+        throw new Error("hermes_snapshot_dependency_rejected");
+      }
+      const script = job.script.startsWith("scripts/")
+        ? job.script.slice("scripts/".length)
+        : job.script;
+      const scriptPath = join(scriptsRoot, script);
+      if (!existsSync(scriptPath)) {
+        throw new Error("hermes_snapshot_dependency_rejected");
+      }
+      const stat = lstatSync(scriptPath);
+      if (stat.isSymbolicLink() || !stat.isFile()) {
+        throw new Error("hermes_snapshot_dependency_rejected");
+      }
+    }
+  }
+}
+
 const sameJson = (left, right) =>
   JSON.stringify(left) === JSON.stringify(right);
 
@@ -695,6 +801,169 @@ const childRunner = (runChild) => runChild ?? runBoundedHermesChild;
 const childFailed = (result) =>
   result?.exitCode !== 0 || result?.timedOut || result?.outputLimitExceeded;
 
+const STATE_DB_COMPACTION_SCRIPT = String.raw`
+import json
+import os
+import sqlite3
+import sys
+import time
+
+source_path, target_path = sys.argv[1], sys.argv[2]
+retention_hours = int(sys.argv[3])
+source = sqlite3.connect("file:" + source_path + "?mode=ro", uri=True)
+destination = sqlite3.connect(target_path)
+try:
+    source.backup(destination)
+finally:
+    source.close()
+
+try:
+    if destination.execute("PRAGMA quick_check").fetchone()[0] != "ok":
+        raise RuntimeError("source backup failed quick_check")
+    destination.execute("PRAGMA foreign_keys=ON")
+    table_names = {
+        row[0]
+        for row in destination.execute(
+            "SELECT name FROM sqlite_master WHERE type='table'"
+        )
+    }
+    pruned_sessions = 0
+    pruned_messages = 0
+    if {"sessions", "messages"}.issubset(table_names):
+        cutoff = time.time() - retention_hours * 60 * 60
+        session_columns = {
+            row[1] for row in destination.execute("PRAGMA table_info(sessions)")
+        }
+        pinned_clause = (
+            "AND COALESCE(pinned, 0) = 0" if "pinned" in session_columns else ""
+        )
+        destination.execute(
+            "CREATE TEMP TABLE snapshot_pruned_sessions(id TEXT PRIMARY KEY)"
+        )
+        destination.execute(
+            "WITH RECURSIVE doomed(id) AS ("
+            " SELECT id FROM sessions"
+            " WHERE source = 'cron' AND ended_at IS NOT NULL"
+            " AND COALESCE(last_activity_at, ended_at, started_at) < ? "
+            + pinned_clause
+            + " UNION"
+            " SELECT child.id FROM sessions child"
+            " JOIN doomed parent ON child.parent_session_id = parent.id"
+            ") INSERT OR IGNORE INTO snapshot_pruned_sessions(id)"
+            " SELECT id FROM doomed",
+            (cutoff,),
+        )
+        pruned_sessions = destination.execute(
+            "SELECT COUNT(*) FROM snapshot_pruned_sessions"
+        ).fetchone()[0]
+        pruned_messages = destination.execute(
+            "SELECT COUNT(*) FROM messages WHERE session_id IN "
+            "(SELECT id FROM snapshot_pruned_sessions)"
+        ).fetchone()[0]
+        destination.execute(
+            "DELETE FROM messages WHERE session_id IN "
+            "(SELECT id FROM snapshot_pruned_sessions)"
+        )
+        if "session_model_usage" in table_names:
+            destination.execute(
+                "DELETE FROM session_model_usage WHERE session_id IN "
+                "(SELECT id FROM snapshot_pruned_sessions)"
+            )
+        destination.execute(
+            "DELETE FROM sessions WHERE id IN "
+            "(SELECT id FROM snapshot_pruned_sessions)"
+        )
+        if "system_prompts" in table_names:
+            destination.execute(
+                "DELETE FROM system_prompts WHERE NOT EXISTS ("
+                " SELECT 1 FROM sessions"
+                " WHERE sessions.system_prompt_hash = system_prompts.hash"
+                ")"
+            )
+        destination.commit()
+    for table in ("messages_fts", "messages_fts_trigram", "messages_fts_cjk"):
+        if table in table_names:
+            destination.execute(
+                'INSERT INTO "' + table + '" ("' + table + '") VALUES (\'optimize\')'
+            )
+    destination.commit()
+    destination.execute("VACUUM")
+    if destination.execute("PRAGMA quick_check").fetchone()[0] != "ok":
+        raise RuntimeError("compacted backup failed quick_check")
+    if destination.execute("PRAGMA foreign_key_check").fetchone() is not None:
+        raise RuntimeError("compacted backup failed foreign_key_check")
+finally:
+    destination.close()
+
+os.chmod(target_path, 0o600)
+print(json.dumps({
+    "ok": True,
+    "prunedSessions": pruned_sessions,
+    "prunedMessages": pruned_messages,
+    "retentionHours": retention_hours,
+    "archiveStateBytes": os.path.getsize(target_path),
+}, separators=(",", ":")))
+`;
+
+export async function compactHermesSnapshotStateDb({
+  sourcePath,
+  targetPath,
+  retentionHours = HERMES_SNAPSHOT_CRON_SESSION_RETENTION_HOURS,
+  hermesPython = HERMES_PYTHON,
+  runChild = undefined,
+}) {
+  if (
+    !isAbsolute(sourcePath) ||
+    !isAbsolute(targetPath) ||
+    resolve(sourcePath) === resolve(targetPath) ||
+    !existsSync(sourcePath) ||
+    existsSync(targetPath) ||
+    !Number.isSafeInteger(retentionHours) ||
+    retentionHours < 1 ||
+    retentionHours > 30 * 24
+  ) {
+    throw new Error("hermes_snapshot_state_db_compaction_rejected");
+  }
+  regularFile(sourcePath);
+  mkdirSync(dirname(targetPath), { recursive: true, mode: 0o700 });
+  const result = await childRunner(runChild)({
+    command: hermesPython,
+    args: [
+      "-c",
+      STATE_DB_COMPACTION_SCRIPT,
+      sourcePath,
+      targetPath,
+      String(retentionHours),
+    ],
+    env: { ...process.env, NO_COLOR: "1" },
+    shell: false,
+    timeoutMs: STATE_DB_COMPACTION_TIMEOUT_MS,
+    maxOutputBytes: 64 * 1024,
+  });
+  if (childFailed(result) || !existsSync(targetPath)) {
+    throw new Error("hermes_snapshot_state_db_compaction_failed");
+  }
+  const target = regularFile(targetPath);
+  let summary;
+  try {
+    summary = JSON.parse(String(result.stdout ?? ""));
+  } catch {
+    throw new Error("hermes_snapshot_state_db_compaction_failed");
+  }
+  if (
+    summary?.ok !== true ||
+    summary.retentionHours !== retentionHours ||
+    !Number.isSafeInteger(summary.prunedSessions) ||
+    summary.prunedSessions < 0 ||
+    !Number.isSafeInteger(summary.prunedMessages) ||
+    summary.prunedMessages < 0 ||
+    summary.archiveStateBytes !== target.size
+  ) {
+    throw new Error("hermes_snapshot_state_db_compaction_failed");
+  }
+  return summary;
+}
+
 function nativeSummaryAccepted(result, complete, incomplete) {
   const output = `${result?.stdout ?? ""}\n${result?.stderr ?? ""}`;
   return (
@@ -807,6 +1076,10 @@ function stageHermesUserState({ profileId, profileRoot, hermesRoot }) {
   for (const name of HERMES_SNAPSHOT_USER_STATE_ENTRIES) {
     const source = join(profileRoot, name);
     if (existsSync(source)) {
+      // state.db is copied online and compacted after the rest of the staged
+      // tree is assembled. Never hard-link this one file: pruning the staged
+      // recovery copy must be physically incapable of touching the live DB.
+      if (name === "state.db") continue;
       stageUserStateEntry(
         source,
         join(stagedProfileRoot, name),
@@ -1426,7 +1699,9 @@ export async function ensureHermesClientRelationshipsCrons({
         return failed("hermes_client_relationships_cron_prune_failed");
       }
       if (cronJobs(profileRoot).some((after) => after?.id === job.id)) {
-        return failed("hermes_client_relationships_cron_prune_readback_rejected");
+        return failed(
+          "hermes_client_relationships_cron_prune_readback_rejected"
+        );
       }
       removed.push({ name: job.name, jobId: job.id, status: "REMOVED" });
     }
@@ -1516,7 +1791,10 @@ export async function captureHermesBackup({
   hermesVersion,
   archiveDirectory = "/tmp",
   hermesCli = HERMES,
-  maxArchiveBytes = MAX_BYTES,
+  hermesPython = HERMES_PYTHON,
+  maxArchiveBytes = HERMES_SNAPSHOT_MAX_ARCHIVE_BYTES,
+  cronSessionRetentionHours = HERMES_SNAPSHOT_CRON_SESSION_RETENTION_HOURS,
+  stateDbCompactor = compactHermesSnapshotStateDb,
   runChild,
   operationIdentity = /** @type {any} */ (undefined),
 }) {
@@ -1554,6 +1832,18 @@ export async function captureHermesBackup({
   let stagingRoot;
   try {
     stagingRoot = stageHermesUserState({ profileId, profileRoot, hermesRoot });
+    const stagedProfileRoot = join(stagingRoot, "profiles", profileId);
+    const sourceStateDb = join(profileRoot, "state.db");
+    if (existsSync(sourceStateDb)) {
+      await stateDbCompactor({
+        sourcePath: sourceStateDb,
+        targetPath: join(stagedProfileRoot, "state.db"),
+        retentionHours: cronSessionRetentionHours,
+        hermesPython,
+        runChild,
+      });
+    }
+    assertStagedCronDependencies(stagedProfileRoot);
     const result = await childRunner(runChild)(
       invocation(["backup", "-o", archivePath], stagingRoot, hermesCli)
     );
@@ -1588,7 +1878,7 @@ export async function captureHermesBackup({
   } catch (error) {
     const code = error instanceof Error ? error.message : "";
     return failed(
-      /^hermes_snapshot_(?:external_state|plugin_data|portable_config)/.test(
+      /^hermes_snapshot_(?:external_state|plugin_data|portable_config|dependency|state_db)/.test(
         code
       )
         ? code
@@ -1783,7 +2073,7 @@ function validLatest(latest, hermesVersion) {
   return (
     Buffer.isBuffer(latest?.bytes) &&
     latest.bytes.byteLength > 0 &&
-    latest.bytes.byteLength <= MAX_BYTES &&
+    latest.bytes.byteLength <= HERMES_SNAPSHOT_MAX_ARCHIVE_BYTES &&
     latest.archiveBytes === latest.bytes.byteLength &&
     SHA256.test(latest.archiveDigest ?? "") &&
     sha256(latest.bytes) === latest.archiveDigest &&

package/lib/sellable-agent/host-bootstrap.mjs

@@ -38,8 +38,8 @@ import { installAgentHostServices } from "./service-installer.mjs";
 const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "../..");
 const VERSION = "sellable-agent-host-bootstrap/v1";
 const RECEIPT_VERSION = "sellable-agent-host-registration/v1";
-const INSTALLER_PACKAGE = "@sellable/install@0.1.682";
-const MCP_PACKAGE = "@sellable/mcp@0.1.899";
+const INSTALLER_PACKAGE = "@sellable/install@0.1.683";
+const MCP_PACKAGE = "@sellable/mcp@0.1.900";
 const HERMES_VERSION = "0.18.0";
 const SHA256 = /^[a-f0-9]{64}$/;
 const SHA256_16 = /^[a-f0-9]{16}$/;

package/lib/sellable-agent/host-worker.mjs

@@ -1547,8 +1547,8 @@ export function compileClaimToProfileDesired(activeClaim, config) {
       pinned.hermesCli !== "hermes" ||
       pinned.hermesVersion !== "0.18.0" ||
       pinned.installerPackage !==
-        "@sellable/install@0.1.682" ||
-      pinned.mcpPackage !== "@sellable/mcp@0.1.899" ||
+        "@sellable/install@0.1.683" ||
+      pinned.mcpPackage !== "@sellable/mcp@0.1.900" ||
       !Array.isArray(policy.toolInclude) ||
       policy.toolInclude.length === 0 ||
       !Number.isSafeInteger(slack.generation) ||

package/lib/sellable-agent/profile-materializer.mjs

@@ -283,8 +283,8 @@ function validateDesired(desired) {
     desired.hermesCli !== "hermes" ||
     desired.hermesVersion !== "0.18.0" ||
     desired.installerPackage !==
-      "@sellable/install@0.1.682" ||
-    desired.mcpPackage !== "@sellable/mcp@0.1.899" ||
+      "@sellable/install@0.1.683" ||
+    desired.mcpPackage !== "@sellable/mcp@0.1.900" ||
     !Array.isArray(desired.toolInclude) ||
     desired.toolInclude.length === 0 ||
     desired.toolInclude.some((tool) => !/^[a-z][a-z0-9_]{0,127}$/.test(tool)) ||

package/lib/sellable-agent/provisioning-adapter.mjs

@@ -26,8 +26,8 @@ import { deriveContainedProfileId } from "./profile-materializer.mjs";
 
 export const PROVISIONING_ACTION = "PROVISION_HERMES_PROFILE";
 export const PINNED_INSTALL_PACKAGE =
-  "@sellable/install@0.1.682";
-export const PINNED_MCP_PACKAGE = "@sellable/mcp@0.1.899";
+  "@sellable/install@0.1.683";
+export const PINNED_MCP_PACKAGE = "@sellable/mcp@0.1.900";
 const PINNED_INSTALL_VERSION = PINNED_INSTALL_PACKAGE.slice(
   PINNED_INSTALL_PACKAGE.lastIndexOf("@") + 1
 );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/install",
-  "version": "0.1.682",
+  "version": "0.1.683",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code, Codex, and Hermes",
   "bin": {