@sellable/install 0.1.646 → 0.1.647

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.646
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.647
 ARG MCP_PACKAGE=@sellable/mcp@0.1.880
 ARG INSTALLER_INTEGRITY
 ARG MCP_INTEGRITY=sha512-+Fo8aQlYduLaQMQff+ZA25LeUhWZ7I7UH5DECpND84LQ+rHSjKeKFj4Zs93bVHXwQCIy2OLbr75y4f4+CyT57w==
 
-RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.646" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.647" \
     && test "${MCP_PACKAGE}" = "@sellable/mcp@0.1.880" \
     && test -n "${INSTALLER_INTEGRITY}" \
     && test "$(npm view "${INSTALLER_PACKAGE}" dist.integrity)" = "${INSTALLER_INTEGRITY}" \
@@ -23,9 +23,9 @@ RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.646" \
     && 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.646' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.880') 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.647' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.880') 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.646', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.880', 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.647', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.880', 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.646` is
+`@sellable/install@0.1.647` is
 published:
 
 ```sh

package/lib/sellable-agent/abandoned-runtime-scratch.mjs

@@ -0,0 +1,93 @@
+import { existsSync, lstatSync, readdirSync, rmSync } from "node:fs";
+import { basename, dirname, isAbsolute, join, resolve } from "node:path";
+
+const ABANDONED_BACKUP_PREFIXES = Object.freeze([
+  ".user-state-",
+  ".legacy-user-state-",
+]);
+
+function canonicalRoot(value, code) {
+  if (
+    typeof value !== "string" ||
+    !isAbsolute(value) ||
+    resolve(value) !== value
+  ) {
+    throw new Error(code);
+  }
+  return value;
+}
+
+function directoryEntries(root, code) {
+  if (!existsSync(root)) return [];
+  const stat = lstatSync(root);
+  if (stat.isSymbolicLink() || !stat.isDirectory()) {
+    throw new Error(code);
+  }
+  return readdirSync(root);
+}
+
+function removeDirectDirectory(root, target, code) {
+  if (dirname(target) !== root || basename(target) === "") {
+    throw new Error(code);
+  }
+  if (!existsSync(target)) return false;
+  const stat = lstatSync(target);
+  if (stat.isSymbolicLink() || !stat.isDirectory()) {
+    throw new Error(code);
+  }
+  rmSync(target, { recursive: true });
+  return true;
+}
+
+/**
+ * A process restart proves these staging directories have no live owner.
+ * Remove only scratch names created by Sellable's snapshot/profile staging;
+ * completed backup archives and the active profile are never candidates.
+ */
+export function pruneAbandonedRuntimeScratch({ hermesRoot, profilesRoot }) {
+  const safeHermesRoot = canonicalRoot(
+    hermesRoot,
+    "runtime_scratch_hermes_root_rejected"
+  );
+  const safeProfilesRoot = canonicalRoot(
+    profilesRoot,
+    "runtime_scratch_profiles_root_rejected"
+  );
+  const backupsRoot = join(safeHermesRoot, "backups");
+  const removed = [];
+
+  for (const name of directoryEntries(
+    backupsRoot,
+    "runtime_scratch_backups_root_rejected"
+  )) {
+    if (!ABANDONED_BACKUP_PREFIXES.some((prefix) => name.startsWith(prefix))) {
+      continue;
+    }
+    if (
+      removeDirectDirectory(
+        backupsRoot,
+        join(backupsRoot, name),
+        "runtime_scratch_backup_candidate_rejected"
+      )
+    ) {
+      removed.push(`backups/${name}`);
+    }
+  }
+
+  const profileStagingRoot = join(safeProfilesRoot, ".staging");
+  if (
+    removeDirectDirectory(
+      safeProfilesRoot,
+      profileStagingRoot,
+      "runtime_scratch_profile_staging_rejected"
+    )
+  ) {
+    removed.push("profiles/.staging");
+  }
+
+  return {
+    ok: true,
+    code: "abandoned_runtime_scratch_pruned",
+    removed,
+  };
+}

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

@@ -103,6 +103,7 @@ import {
   prepareAdminStateGeneration,
   recoverAdminStateReceiptMismatch,
 } from "./admin-state-generation.mjs";
+import { pruneAbandonedRuntimeScratch } from "../abandoned-runtime-scratch.mjs";
 
 export const ADMIN_RUNTIME_SETTINGS_DIRECTORY =
   "/run/sellable-agent/admin-settings";
@@ -3285,6 +3286,19 @@ async function runAdminProduction() {
   ) {
     throw new Error("admin_runtime_configuration_rejected");
   }
+  const scratch = pruneAbandonedRuntimeScratch({
+    hermesRoot: DATA_ROOT,
+    profilesRoot: PROFILES_ROOT,
+  });
+  if (scratch.removed.length > 0) {
+    process.stderr.write(
+      `${JSON.stringify({
+        ok: true,
+        code: scratch.code,
+        removed: scratch.removed,
+      })}\n`
+    );
+  }
   await sodium.ready;
   await proveInstalledPackages();
   let oidcToken = await obtainFlyOidcToken({ audience: AUDIENCE });

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

@@ -8,7 +8,7 @@ ENV PLAYWRIGHT_BROWSERS_PATH=/opt/hermes/.playwright
 
 ARG MCP_PACKAGE=@sellable/mcp@0.1.880
 ARG MCP_INTEGRITY=sha512-+Fo8aQlYduLaQMQff+ZA25LeUhWZ7I7UH5DECpND84LQ+rHSjKeKFj4Zs93bVHXwQCIy2OLbr75y4f4+CyT57w==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.646
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.647
 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

@@ -105,7 +105,7 @@ const BOOT_SESSION_ID = randomUUID();
 const HERMES_VERSION = process.env.SELLABLE_AGENT_HERMES_VERSION ?? "0.20.0";
 const INSTALLER_PACKAGE =
   process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ??
-  "@sellable/install@0.1.646";
+  "@sellable/install@0.1.647";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.880";
 const DEFAULT_PROFILE_BUNDLE_ROOT =

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

@@ -38,7 +38,7 @@ 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.646";
+const INSTALLER_PACKAGE = "@sellable/install@0.1.647";
 const MCP_PACKAGE = "@sellable/mcp@0.1.880";
 const HERMES_VERSION = "0.18.0";
 const SHA256 = /^[a-f0-9]{64}$/;

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

@@ -1547,7 +1547,7 @@ export function compileClaimToProfileDesired(activeClaim, config) {
       pinned.hermesCli !== "hermes" ||
       pinned.hermesVersion !== "0.18.0" ||
       pinned.installerPackage !==
-        "@sellable/install@0.1.646" ||
+        "@sellable/install@0.1.647" ||
       pinned.mcpPackage !== "@sellable/mcp@0.1.880" ||
       !Array.isArray(policy.toolInclude) ||
       policy.toolInclude.length === 0 ||

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

@@ -283,7 +283,7 @@ function validateDesired(desired) {
     desired.hermesCli !== "hermes" ||
     desired.hermesVersion !== "0.18.0" ||
     desired.installerPackage !==
-      "@sellable/install@0.1.646" ||
+      "@sellable/install@0.1.647" ||
     desired.mcpPackage !== "@sellable/mcp@0.1.880" ||
     !Array.isArray(desired.toolInclude) ||
     desired.toolInclude.length === 0 ||

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

@@ -26,7 +26,7 @@ import { deriveContainedProfileId } from "./profile-materializer.mjs";
 
 export const PROVISIONING_ACTION = "PROVISION_HERMES_PROFILE";
 export const PINNED_INSTALL_PACKAGE =
-  "@sellable/install@0.1.646";
+  "@sellable/install@0.1.647";
 export const PINNED_MCP_PACKAGE = "@sellable/mcp@0.1.880";
 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.646",
+  "version": "0.1.647",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code, Codex, and Hermes",
   "bin": {