@sellable/install 0.1.651 → 0.1.652

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.651
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.652
 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.651" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.652" \
     && 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.651" \
     && 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.651' || 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.652' || 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.651', 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.652', 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.651` is
+`@sellable/install@0.1.652` is
 published:
 
 ```sh

package/lib/sellable-agent/admin-native-gateway-supervisor.mjs

@@ -0,0 +1,24 @@
+export const ADMIN_NATIVE_GATEWAY_MAX_LOCAL_RESTARTS = 3;
+
+export function nativeGatewayRunning(gateway) {
+  const child = gateway?.child;
+  return Boolean(
+    child &&
+      child.exitCode === null &&
+      child.signalCode === null &&
+      child.killed !== true
+  );
+}
+
+export function nextAdminNativeGatewayRecovery({ attempts }) {
+  const completedAttempts = Number.isInteger(attempts)
+    ? Math.max(0, attempts)
+    : 0;
+  if (completedAttempts >= ADMIN_NATIVE_GATEWAY_MAX_LOCAL_RESTARTS) {
+    return {
+      action: "EXHAUSTED",
+      attempt: ADMIN_NATIVE_GATEWAY_MAX_LOCAL_RESTARTS,
+    };
+  }
+  return { action: "RESTART", attempt: completedAttempts + 1 };
+}

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

@@ -150,6 +150,7 @@ RUN --mount=type=secret,id=mcp_trust_root,required=true \
 COPY fly-admin-image/admin-runtime.mjs /usr/local/lib/sellable-agent/admin-runtime/admin-runtime.mjs
 COPY fly-admin-image/admin-state-generation.mjs /usr/local/lib/sellable-agent/admin-runtime/admin-state-generation.mjs
 COPY fly-admin-image/start-admin-runtime /usr/local/lib/sellable-agent/admin-runtime/start-admin-runtime
+COPY admin-native-gateway-supervisor.mjs /usr/local/lib/sellable-agent/admin-native-gateway-supervisor.mjs
 COPY abandoned-runtime-scratch.mjs /usr/local/lib/sellable-agent/abandoned-runtime-scratch.mjs
 COPY mcp-context-proxy.mjs /usr/local/lib/sellable-agent/mcp-context-proxy.mjs
 COPY mcp-runtime-binding.mjs /usr/local/lib/sellable-agent/mcp-runtime-binding.mjs
@@ -237,6 +238,7 @@ RUN set -eux; \
       /usr/local/lib/sellable-agent/admin-runtime/admin-runtime.mjs \
       /usr/local/lib/sellable-agent/admin-runtime/admin-state-generation.mjs \
       /usr/local/lib/sellable-agent/admin-runtime/start-admin-runtime \
+      /usr/local/lib/sellable-agent/admin-native-gateway-supervisor.mjs \
       /usr/local/lib/sellable-agent/abandoned-runtime-scratch.mjs \
       /usr/local/lib/sellable-agent/mcp-context-proxy.mjs \
       /usr/local/lib/sellable-agent/mcp-runtime-binding.mjs \

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

@@ -28,6 +28,7 @@ import { createRequire } from "node:module";
 import { basename, dirname, join } from "node:path";
 import { createInterface } from "node:readline";
 
+import { pruneAbandonedRuntimeScratch } from "../abandoned-runtime-scratch.mjs";
 import {
   buildAdminSettingsManifest,
   encodeAdminSettingsBundle,
@@ -45,6 +46,15 @@ import {
   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 {
+  nativeGatewayRunning,
+  nextAdminNativeGatewayRecovery,
+} from "../admin-native-gateway-supervisor.mjs";
+import {
+  bindDefaultProfileProbeCron,
+  buildDefaultProfileProjection,
+  reconcileDefaultProfileBundle,
+} from "../default-profile-reconciler.mjs";
 import {
   SELLABLE_BROWSER_TOOLSET_DEFAULT_MARKER,
   sellableSlackToolsetsForMaterialization,
@@ -63,18 +73,13 @@ import {
   renewFlyAdminControlSession,
   signedWorkerAuthorization,
 } from "../fly-runtime-identity.mjs";
+import { proveDefaultProfileNativeSkills } from "../fly-skills-bridge.mjs";
 import {
   executeExternalSoulBridgeOperation,
   observeProfileSoul,
   prepareSoulLockRoot,
   withProfileSoulLock,
 } from "../fly-soul-bridge.mjs";
-import { proveDefaultProfileNativeSkills } from "../fly-skills-bridge.mjs";
-import {
-  bindDefaultProfileProbeCron,
-  buildDefaultProfileProjection,
-  reconcileDefaultProfileBundle,
-} from "../default-profile-reconciler.mjs";
 import {
   HERMES_SNAPSHOT_HOOKS,
   HERMES_SNAPSHOT_HOOK_ALLOWLIST_BYTES,
@@ -103,7 +108,6 @@ 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";
@@ -268,7 +272,10 @@ function adminMaterializerReceipt(profileId, profileRoot) {
     fileHashes: Object.fromEntries(
       paths
         .filter((relative) => existsSync(join(profileRoot, relative)))
-        .map((relative) => [relative, sha256(readFileSync(join(profileRoot, relative)))])
+        .map((relative) => [
+          relative,
+          sha256(readFileSync(join(profileRoot, relative))),
+        ])
     ),
   };
 }
@@ -1453,8 +1460,7 @@ function operationSnapshotIdentity(claim, exchange) {
 function adminServingObservation(activeLaunch, activeGateway, exchange) {
   try {
     const authority = activeLaunch?.claim?.runtimeAuthority;
-    const running =
-      activeGateway?.child?.exitCode === null && !activeGateway.child.killed;
+    const running = nativeGatewayRunning(activeGateway);
     const productMcp = activeLaunch?.profile?.servers?.find(
       (server) => server.alias === "sellable"
     );
@@ -2813,7 +2819,7 @@ async function startNativeGateway({ profile, claim }) {
 }
 
 async function stopNativeGateway(gateway) {
-  if (!gateway?.child || gateway.child.exitCode !== null) return;
+  if (!nativeGatewayRunning(gateway)) return;
   gateway.child.kill("SIGTERM");
   const stopped = await Promise.race([
     gateway.closed.then(() => true),
@@ -2825,6 +2831,100 @@ async function stopNativeGateway(gateway) {
   }
 }
 
+async function recoverUnexpectedNativeGateway({
+  activeLaunch,
+  activeGateway,
+  activeModelHealthReporter,
+  identity,
+  exchange,
+  attempts,
+}) {
+  const recovery = nextAdminNativeGatewayRecovery({ attempts });
+  await activeModelHealthReporter?.stop();
+  await stopNativeGateway(activeGateway);
+  if (recovery.action === "EXHAUSTED") {
+    process.stderr.write(
+      `${JSON.stringify({
+        ok: false,
+        code: "admin_native_gateway_restart_exhausted",
+        attempts: recovery.attempt,
+        manualRetryAvailable: true,
+      })}\n`
+    );
+    return {
+      activeGateway: null,
+      activeModelHealthReporter: null,
+      attempts: recovery.attempt,
+      exhausted: true,
+    };
+  }
+  let candidateGateway = null;
+  try {
+    process.stderr.write(
+      `${JSON.stringify({
+        ok: false,
+        code: "admin_native_gateway_exit_detected",
+        attempt: recovery.attempt,
+      })}\n`
+    );
+    candidateGateway = await startNativeGateway(activeLaunch);
+    if (!nativeGatewayRunning(candidateGateway)) {
+      throw new Error("admin_native_gateway_local_restart_failed");
+    }
+    const nextModelHealthReporter = adminModelHealthReporter({
+      identity,
+      exchange,
+      installed: activeLaunch.installed,
+      claim: activeLaunch.claim,
+    });
+    try {
+      await nextModelHealthReporter.start("gateway-recovered");
+    } catch (error) {
+      process.stderr.write(
+        `${JSON.stringify({
+          ok: false,
+          code:
+            error instanceof Error
+              ? error.message
+              : "model_health_report_failed",
+        })}\n`
+      );
+    }
+    process.stderr.write(
+      `${JSON.stringify({
+        ok: true,
+        code: "admin_native_gateway_local_restart",
+        attempt: recovery.attempt,
+        processIdentity: `gateway-${candidateGateway.child.pid}-${activeLaunch.claim.operation.fence}`,
+      })}\n`
+    );
+    return {
+      activeGateway: candidateGateway,
+      activeModelHealthReporter: nextModelHealthReporter,
+      attempts: recovery.attempt,
+      exhausted: false,
+    };
+  } catch (error) {
+    await stopNativeGateway(candidateGateway);
+    process.stderr.write(
+      `${JSON.stringify({
+        ok: false,
+        code:
+          error instanceof Error
+            ? error.message
+            : "admin_native_gateway_local_restart_failed",
+        attempt: recovery.attempt,
+      })}\n`
+    );
+    return {
+      activeGateway: null,
+      activeModelHealthReporter: null,
+      attempts: recovery.attempt,
+      exhausted: false,
+    };
+  }
+}
+
 export async function runAdminCanary() {
   const step = process.env.SELLABLE_AGENT_ADMIN_CANARY_STEP;
   const recoverySecretPath =
@@ -3379,6 +3479,8 @@ async function runAdminProduction() {
   process.once("SIGTERM", stop);
   let operationHeartbeat = null;
   let soulClaimTracker = null;
+  let gatewayRestartAttempts = 0;
+  let gatewayRestartExhaustionReported = false;
   let failures = 0;
   while (!controller.signal.aborted) {
     let claimedOperation = null;
@@ -3454,6 +3556,23 @@ async function runAdminProduction() {
       if (controller.signal.aborted) break;
       if (!claim) {
         if (activeLaunch) {
+          if (
+            !nativeGatewayRunning(activeGateway) &&
+            !gatewayRestartExhaustionReported
+          ) {
+            const recovery = await recoverUnexpectedNativeGateway({
+              activeLaunch,
+              activeGateway,
+              activeModelHealthReporter,
+              identity,
+              exchange,
+              attempts: gatewayRestartAttempts,
+            });
+            activeGateway = recovery.activeGateway;
+            activeModelHealthReporter = recovery.activeModelHealthReporter;
+            gatewayRestartAttempts = recovery.attempts;
+            gatewayRestartExhaustionReported = recovery.exhausted;
+          }
           await reconcileHermesSnapshot({
             profileId: activeLaunch.profile.profile,
             profileRoot: activeLaunch.profile.profileHome,
@@ -3619,6 +3738,7 @@ async function runAdminProduction() {
         fetchLatest: () => client.getMemorySnapshot(),
       });
       if (!memoryRestore.ok) throw new Error(memoryRestore.code);
+      await operationHeartbeat.reattest();
       const legacyLightfieldVenv = quarantineLegacyLightfieldVenv({
         profileId: basename(profileContract.profileHome),
         profileRoot: profileContract.profileHome,
@@ -3647,6 +3767,7 @@ async function runAdminProduction() {
         slack: nativeSlackProfileInput(claim, installed),
         agentServiceEnv: adminAgentServiceEnvironment(claim),
       });
+      await operationHeartbeat.reattest();
       const materializerReceipt = adminMaterializerReceipt(
         profile.profile,
         profile.profileHome
@@ -3697,6 +3818,7 @@ async function runAdminProduction() {
         profileId: profile.profile,
         profileRoot: profile.profileHome,
       });
+      await operationHeartbeat.reattest();
       const settings = settingsProof(
         imported.receipt.generationRoot,
         imported.receipt.settingsDigest
@@ -3723,6 +3845,7 @@ async function runAdminProduction() {
         desiredLifecycle === "ON"
           ? await proveAdminSlackServing(claim, secrets)
           : false;
+      await operationHeartbeat.reattest();
       const candidateLaunch =
         desiredLifecycle === "ON"
           ? { profile, claim, installed, slackProof }
@@ -3731,6 +3854,7 @@ async function runAdminProduction() {
       try {
         if (candidateLaunch) {
           candidateGateway = await startNativeGateway(candidateLaunch);
+          await operationHeartbeat.reattest();
         }
         const nativeDefaultProfileProof = candidateGateway
           ? proveDefaultProfileNativeSkills({
@@ -3818,6 +3942,8 @@ async function runAdminProduction() {
       }
       await operationHeartbeat.stop();
       operationHeartbeat = null;
+      gatewayRestartAttempts = 0;
+      gatewayRestartExhaustionReported = false;
       failures = 0;
     } catch (error) {
       try {

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.651
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.652
 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.651";
+  "@sellable/install@0.1.652";
 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.651";
+const INSTALLER_PACKAGE = "@sellable/install@0.1.652";
 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.651" ||
+        "@sellable/install@0.1.652" ||
       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.651" ||
+      "@sellable/install@0.1.652" ||
     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.651";
+  "@sellable/install@0.1.652";
 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.651",
+  "version": "0.1.652",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code, Codex, and Hermes",
   "bin": {