@sellable/install 0.1.755 → 0.1.756

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.755
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.756
 ARG MCP_PACKAGE=@sellable/mcp@0.1.938
 ARG INSTALLER_INTEGRITY
 ARG MCP_INTEGRITY=sha512-wcVCiCXVvKeE/SufP+2iXk8zgzwYWh78M/1vwa7oorF9UZbzut9szyZV47t4iMX9owYgBVaGwdlOC6eX8VQX4A==
 
-RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.755" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.756" \
     && test "${MCP_PACKAGE}" = "@sellable/mcp@0.1.938" \
     && 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.755" \
     && 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.755' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.938') 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.756' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.938') 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.755', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.938', 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.756', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.938', 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.755` is
+`@sellable/install@0.1.756` is
 published:
 
 ```sh

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.938
 ARG MCP_INTEGRITY=sha512-wcVCiCXVvKeE/SufP+2iXk8zgzwYWh78M/1vwa7oorF9UZbzut9szyZV47t4iMX9owYgBVaGwdlOC6eX8VQX4A==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.755
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.756
 ARG ADMIN_MCP_PACKAGE=@sellable/admin-mcp@0.1.202
 ARG ADMIN_MCP_INTEGRITY=sha512-ym3aye/0vQ8tfULJlKz9JFOxvIQsl1G+n3np+TTgK/tecwNblBo/j3AkTnRqH9iomKzPbZzP+n4tEQsvsU8ByA==
 ARG TUS_JS_CLIENT_VERSION=4.3.1

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

@@ -121,7 +121,7 @@ const RUNTIME_GENERATION = Number(
 const BOOT_SESSION_ID = randomUUID();
 const HERMES_VERSION = process.env.SELLABLE_AGENT_HERMES_VERSION ?? "0.21.3";
 const INSTALLER_PACKAGE =
-  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.755";
+  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.756";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.938";
 export const ENDPOINT_MAX_CONCURRENT_RUNS = 10;
@@ -344,6 +344,45 @@ export function customerRuntimeDoctorRequired(
   return action !== "ENABLE_GATEWAY" && runtimeAuthorityScope !== "CANDIDATE";
 }
 
+export const CUSTOMER_RUNTIME_DEFERRED_SNAPSHOT_CODE =
+  "hermes_snapshot_deferred_until_serving";
+
+/**
+ * Upgrade's BACKING_UP stage already captured the durable pre-replacement
+ * profile. Reconciliation on the replacement can dirty that profile again,
+ * but compacting and uploading a large state.db is recovery work rather than
+ * serving proof. Keep the dirty marker for the normal post-serving reconciler
+ * instead of putting two independently bounded backups in front of candidate
+ * Slack readiness.
+ *
+ * @param {"ASSIGNED" | "CANDIDATE" | null | undefined} runtimeAuthorityScope
+ */
+export function customerRuntimeSnapshotRequiredBeforeServing(
+  runtimeAuthorityScope
+) {
+  return runtimeAuthorityScope !== "CANDIDATE";
+}
+
+function deferredCustomerRuntimeSnapshot() {
+  return {
+    ok: false,
+    status: "PENDING_RETRY",
+    code: CUSTOMER_RUNTIME_DEFERRED_SNAPSHOT_CODE,
+  };
+}
+
+async function flushHermesSnapshotBeforeServing({
+  client,
+  profileId,
+  profileRoot,
+  runtimeAuthorityScope,
+}) {
+  if (!customerRuntimeSnapshotRequiredBeforeServing(runtimeAuthorityScope)) {
+    return deferredCustomerRuntimeSnapshot();
+  }
+  return await flushHermesSnapshot({ client, profileId, profileRoot });
+}
+
 function exactArtifact(claim, type) {
   const artifacts = claim?.revision?.artifacts?.filter(
     (artifact) =>
@@ -3634,6 +3673,7 @@ async function processOperation({
   identity,
   reattestAuthority,
 }) {
+  const runtimeAuthorityScope = claim.runtimeAuthority?.scope ?? null;
   const trustRootPem = readFileSync(TRUST_ROOT, "utf8");
   const { desired, toolInclude } = compileDesired(claim, trustRootPem);
   mkdirSync(PROFILES_ROOT, { recursive: true, mode: 0o700 });
@@ -3742,10 +3782,11 @@ async function processOperation({
     materialized.status !== "REUSED" || memoryCron.status !== "REUSED";
   if (materializerChanged || defaultProfile.changed || publicSkills.changed)
     markHermesSnapshotDirty(profileRoot);
-  const memorySnapshot = await flushHermesSnapshot({
+  const memorySnapshot = await flushHermesSnapshotBeforeServing({
     client,
     profileId: desired.profileId,
     profileRoot,
+    runtimeAuthorityScope,
   });
   if (!memorySnapshot.ok) markHermesSnapshotDirty(profileRoot);
   const prove =
@@ -3771,7 +3812,7 @@ async function processOperation({
     runtimeConfig,
     secrets,
     profileDigest: pristineProfile.manifest.profileDigest,
-    runtimeAuthorityScope: claim.runtimeAuthority?.scope ?? null,
+    runtimeAuthorityScope,
   });
   const customerProgramCrons = await ensureHermesCustomerProgramCrons({
     profileId: desired.profileId,
@@ -3793,10 +3834,11 @@ async function processOperation({
   });
   if (!onboardingCron.ok) throw new Error(onboardingCron.code);
   markHermesSnapshotDirty(profileRoot);
-  const onboardingMemorySnapshot = await flushHermesSnapshot({
+  const onboardingMemorySnapshot = await flushHermesSnapshotBeforeServing({
     client,
     profileId: desired.profileId,
     profileRoot,
+    runtimeAuthorityScope,
   });
   const nativeDefaultProfileProof = proof.gatewayReadback?.running
     ? await proveCustomerRuntimeDefaultSkills({

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

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

@@ -1546,7 +1546,7 @@ export function compileClaimToProfileDesired(activeClaim, config) {
       ]) ||
       pinned.hermesCli !== "hermes" ||
       pinned.hermesVersion !== "0.18.0" ||
-      pinned.installerPackage !== "@sellable/install@0.1.755" ||
+      pinned.installerPackage !== "@sellable/install@0.1.756" ||
       pinned.mcpPackage !== "@sellable/mcp@0.1.938" ||
       !Array.isArray(policy.toolInclude) ||
       policy.toolInclude.length === 0 ||

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

@@ -282,7 +282,7 @@ function validateDesired(desired) {
     desired.serviceCredentialGeneration < 1 ||
     desired.hermesCli !== "hermes" ||
     desired.hermesVersion !== "0.18.0" ||
-    desired.installerPackage !== "@sellable/install@0.1.755" ||
+    desired.installerPackage !== "@sellable/install@0.1.756" ||
     desired.mcpPackage !== "@sellable/mcp@0.1.938" ||
     !Array.isArray(desired.toolInclude) ||
     desired.toolInclude.length === 0 ||

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

@@ -25,7 +25,7 @@ import { fileURLToPath } from "node:url";
 import { deriveContainedProfileId } from "./profile-materializer.mjs";
 
 export const PROVISIONING_ACTION = "PROVISION_HERMES_PROFILE";
-export const PINNED_INSTALL_PACKAGE = "@sellable/install@0.1.755";
+export const PINNED_INSTALL_PACKAGE = "@sellable/install@0.1.756";
 export const PINNED_MCP_PACKAGE = "@sellable/mcp@0.1.938";
 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.755",
+  "version": "0.1.756",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code, Codex, and Hermes",
   "bin": {