@sellable/install 0.1.624 → 0.1.625-wip.phase189.20260813.1

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.624
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.625-wip.phase189.20260813.1
 ARG MCP_PACKAGE=@sellable/mcp@0.1.867
 ARG INSTALLER_INTEGRITY
 ARG MCP_INTEGRITY=sha512-8acJ5MfqgXiu9ylK65LlQ7LUBN5GN5fEXOwDTArxYAN7nBvVLhdz0nTGMERc6qCFNBbILTKvo4IErJOnAcJTDA==
 
-RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.624" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.625-wip.phase189.20260813.1" \
     && test "${MCP_PACKAGE}" = "@sellable/mcp@0.1.867" \
     && 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.624" \
     && 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.624' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.867') 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.625-wip.phase189.20260813.1' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.867') 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.624', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.867', 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.625-wip.phase189.20260813.1', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.867', 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.624` is
+`@sellable/install@0.1.625-wip.phase189.20260813.1` is
 published:
 
 ```sh

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

@@ -42,6 +42,7 @@ import {
   buildAdminAgentServiceEnvironment,
   buildNativeHermesLaunch,
   buildRuntimeServingObservation,
+  isOperationBoundBackupClaim,
 } from "../admin-artifact/node_modules/@sellable/install/lib/sellable-agent/fly-customer-worker.mjs";
 import sodium from "../admin-artifact/node_modules/libsodium-wrappers/dist/modules-esm/libsodium-wrappers.mjs";
 import { SELLABLE_ALLOWED_TOOLSETS } from "../fly-capabilities-bridge.mjs";
@@ -1262,7 +1263,13 @@ function operationIdentity(claim, exchange) {
 
 function operationSnapshotIdentity(claim, exchange) {
   const authority = claim?.runtimeAuthority;
-  if (!authority) return undefined;
+  if (
+    !isOperationBoundBackupClaim(claim) ||
+    authority?.scope !== "ASSIGNED" ||
+    authority.runtimeArtifactId !== authority.assignedRuntimeArtifactId
+  ) {
+    return undefined;
+  }
   return {
     operationId: claim.operation.id,
     authorityGeneration: authority.authorityGeneration,
@@ -3261,6 +3268,27 @@ async function runAdminProduction() {
         exchange,
         client,
       });
+      if (isOperationBoundBackupClaim(claim)) {
+        const snapshotIdentity = operationSnapshotIdentity(claim, exchange);
+        if (!snapshotIdentity) {
+          throw new Error("admin_operation_backup_claim_rejected");
+        }
+        const profile = activeLaunch?.profile ?? profileContractForClaim(claim);
+        const backup = await flushHermesSnapshot({
+          client,
+          profileId: basename(profile.profileHome),
+          profileRoot: profile.profileHome,
+          operationIdentity: snapshotIdentity,
+        });
+        if (!backup.ok) {
+          throw new Error("admin_operation_backup_proof_unavailable");
+        }
+        operationHeartbeat.assertHealthy();
+        await operationHeartbeat.stop();
+        operationHeartbeat = null;
+        failures = 0;
+        continue;
+      }
       await activeModelHealthReporter?.stop();
       activeModelHealthReporter = null;
       await stopNativeGateway(activeGateway);
@@ -3347,18 +3375,6 @@ async function runAdminProduction() {
         generationFence: claim.adminRuntimeGeneration.fence,
         profileContract,
       };
-      const upgradeBackup =
-        claim.runtimeAuthority?.scope === "CANDIDATE"
-          ? await flushHermesSnapshot({
-              client,
-              profileId: basename(profileContract.profileHome),
-              profileRoot: profileContract.profileHome,
-              operationIdentity: operationSnapshotIdentity(claim, exchange),
-            })
-          : null;
-      if (upgradeBackup && !upgradeBackup.ok) {
-        throw new Error("admin_upgrade_backup_proof_unavailable");
-      }
       const memoryRestore = await restoreLatestHermesSnapshot({
         profileId: basename(profileContract.profileHome),
         profileRoot: profileContract.profileHome,
@@ -3403,14 +3419,11 @@ async function runAdminProduction() {
         installed,
         desiredLifecycle
       );
-      const memorySnapshot =
-        upgradeBackup ??
-        (await flushHermesSnapshot({
-          client,
-          profileId: profile.profile,
-          profileRoot: profile.profileHome,
-          operationIdentity: operationSnapshotIdentity(claim, exchange),
-        }));
+      const memorySnapshot = await flushHermesSnapshot({
+        client,
+        profileId: profile.profile,
+        profileRoot: profile.profileHome,
+      });
       const settings = settingsProof(
         imported.receipt.generationRoot,
         imported.receipt.settingsDigest

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

@@ -6,7 +6,7 @@ USER root
 
 ARG MCP_PACKAGE=@sellable/mcp@0.1.867
 ARG MCP_INTEGRITY=sha512-8acJ5MfqgXiu9ylK65LlQ7LUBN5GN5fEXOwDTArxYAN7nBvVLhdz0nTGMERc6qCFNBbILTKvo4IErJOnAcJTDA==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.624
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.625-wip.phase189.20260813.1
 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

@@ -22,6 +22,7 @@ import {
   buildRuntimeServingObservation,
   clearCustomerRuntimeSecrets,
   installCustomerRuntimeSecrets,
+  isOperationBoundBackupClaim,
 } from "../fly-customer-worker.mjs";
 import {
   claimWithSoulObservation,
@@ -98,7 +99,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.624";
+  "@sellable/install@0.1.625-wip.phase189.20260813.1";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.867";
 
@@ -402,6 +403,26 @@ function operationIdentity(claim, exchange) {
   };
 }
 
+function operationSnapshotIdentity(claim, exchange) {
+  const authority = claim?.runtimeAuthority;
+  if (
+    !isOperationBoundBackupClaim(claim) ||
+    authority?.scope !== "ASSIGNED" ||
+    authority.runtimeArtifactId !== authority.assignedRuntimeArtifactId
+  ) {
+    return undefined;
+  }
+  return {
+    operationId: claim.operation.id,
+    authorityGeneration: authority.authorityGeneration,
+    runtimeArtifactId: authority.assignedRuntimeArtifactId,
+    sourceMachineId: exchange.workerId,
+    sourceMachineVersion: authority.machineVersion,
+    sourceBootSessionId: BOOT_SESSION_ID,
+    profileSchemaVersion: "customer-native-profile/v1",
+  };
+}
+
 export function customerServingObservation(activeRuntime, exchange) {
   try {
     const authority = activeRuntime?.claim?.runtimeAuthority;
@@ -2631,7 +2652,12 @@ function completionReceipt({
   };
 }
 
-async function flushHermesSnapshot({ client, profileId, profileRoot }) {
+async function flushHermesSnapshot({
+  client,
+  profileId,
+  profileRoot,
+  operationIdentity,
+}) {
   try {
     markHermesSnapshotDirty(profileRoot);
     return await reconcileHermesSnapshot({
@@ -2640,6 +2666,7 @@ async function flushHermesSnapshot({ client, profileId, profileRoot }) {
       hermesRoot: DATA_ROOT,
       hermesVersion: HERMES_VERSION,
       debounceMs: 0,
+      operationIdentity,
       upload: ({ archiveDigest, archiveBytes, sourceProfileId, bytes }) =>
         client.putMemorySnapshot(
           {
@@ -2647,6 +2674,7 @@ async function flushHermesSnapshot({ client, profileId, profileRoot }) {
             archiveBytes,
             hermesVersion: HERMES_VERSION,
             sourceProfileId,
+            ...(operationIdentity ?? {}),
           },
           bytes
         ),
@@ -3054,6 +3082,26 @@ async function main() {
         exchange,
         client,
       });
+      if (isOperationBoundBackupClaim(claim)) {
+        const snapshotIdentity = operationSnapshotIdentity(claim, exchange);
+        if (!snapshotIdentity) {
+          throw new Error("customer_operation_backup_claim_rejected");
+        }
+        const backup = await flushHermesSnapshot({
+          client,
+          profileId: claim.operation.profileId,
+          profileRoot: join(PROFILES_ROOT, claim.operation.profileId),
+          operationIdentity: snapshotIdentity,
+        });
+        if (!backup.ok) {
+          throw new Error("customer_operation_backup_proof_unavailable");
+        }
+        operationHeartbeat.assertHealthy();
+        await operationHeartbeat.stop();
+        operationHeartbeat = null;
+        failures = 0;
+        continue;
+      }
       await activeRuntime?.modelHealthReporter?.stop();
       await endpointRelay.fenceActive("LIFECYCLE_REFRESH");
       await stopNativeGateway(activeRuntime?.gateway);

package/lib/sellable-agent/fly-customer-worker.mjs

@@ -32,6 +32,11 @@ function stableJson(value) {
   return JSON.stringify(value);
 }
 
+/** The only claim that may write an operation-bound snapshot without applying. */
+export function isOperationBoundBackupClaim(claim) {
+  return claim?.operation?.stage === "BACKING_UP";
+}
+
 // CUSTOMER and ADMIN runtimes share this one serving-observation builder.
 export function buildRuntimeServingObservation(input = {}) {
   const keys = [
@@ -56,8 +61,7 @@ export function buildRuntimeServingObservation(input = {}) {
     "nativeGateway",
     "customerRouting",
   ];
-  const identity = (value) =>
-    typeof value === "string" && SAFE_ID.test(value);
+  const identity = (value) => typeof value === "string" && SAFE_ID.test(value);
   const mcp = (value, name) =>
     exactKeys(value, ["serverInfoName", "toolCount"]) &&
     value.serverInfoName === name &&

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.624";
+const INSTALLER_PACKAGE = "@sellable/install@0.1.625-wip.phase189.20260813.1";
 const MCP_PACKAGE = "@sellable/mcp@0.1.867";
 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.624" ||
+        "@sellable/install@0.1.625-wip.phase189.20260813.1" ||
       pinned.mcpPackage !== "@sellable/mcp@0.1.867" ||
       !Array.isArray(policy.toolInclude) ||
       policy.toolInclude.length === 0 ||

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

@@ -279,7 +279,7 @@ function validateDesired(desired) {
     desired.hermesCli !== "hermes" ||
     desired.hermesVersion !== "0.18.0" ||
     desired.installerPackage !==
-      "@sellable/install@0.1.624" ||
+      "@sellable/install@0.1.625-wip.phase189.20260813.1" ||
     desired.mcpPackage !== "@sellable/mcp@0.1.867" ||
     !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.624";
+  "@sellable/install@0.1.625-wip.phase189.20260813.1";
 export const PINNED_MCP_PACKAGE = "@sellable/mcp@0.1.867";
 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.624",
+  "version": "0.1.625-wip.phase189.20260813.1",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code, Codex, and Hermes",
   "bin": {