@sellable/install 0.1.687 → 0.1.689

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.687
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.689
 ARG MCP_PACKAGE=@sellable/mcp@0.1.901
 ARG INSTALLER_INTEGRITY
 ARG MCP_INTEGRITY=sha512-0YBT2d3YBgZFSgEcmoDCNLz/PWMiBbqMWeZoEFArWuk63/vrYATEp/qBNzYhpy7SKClLapsb1RRagdXrvo/p9g==
 
-RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.687" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.689" \
     && test "${MCP_PACKAGE}" = "@sellable/mcp@0.1.901" \
     && 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.687" \
     && 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.687' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.901') 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.689' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.901') 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.687', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.901', 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.689', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.901', 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.687` is
+`@sellable/install@0.1.689` is
 published:
 
 ```sh

package/lib/sellable-agent/admin-endpoint-runtime.mjs

@@ -0,0 +1,53 @@
+import { isAbsolute } from "node:path";
+import { nativeGatewayRunning } from "./admin-native-gateway-supervisor.mjs";
+
+const SAFE_ID = /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/;
+
+export function projectAdminEndpointRuntime({
+  activeLaunch,
+  activeGateway,
+  runtimeGeneration,
+  trustRootPem,
+  turnDescriptorPath,
+}) {
+  const claim = activeLaunch?.claim;
+  const operation = claim?.operation;
+  const authority = claim?.runtimeAuthority;
+  const service = claim?.runtimeContract?.service;
+  const profileId = activeLaunch?.profile?.profile;
+  if (
+    !nativeGatewayRunning(activeGateway) ||
+    authority?.scope !== "ASSIGNED" ||
+    authority.runtimeArtifactId !== authority.assignedRuntimeArtifactId ||
+    !SAFE_ID.test(authority.runtimeId ?? "") ||
+    !SAFE_ID.test(operation?.workspaceId ?? "") ||
+    !SAFE_ID.test(operation?.agentId ?? "") ||
+    !SAFE_ID.test(profileId ?? "") ||
+    profileId !== operation?.profileId ||
+    !Number.isSafeInteger(runtimeGeneration) ||
+    runtimeGeneration < 1 ||
+    !Number.isSafeInteger(service?.credentialGeneration) ||
+    service.credentialGeneration < 1 ||
+    typeof trustRootPem !== "string" ||
+    !trustRootPem.includes("-----BEGIN PUBLIC KEY-----") ||
+    !trustRootPem.includes("-----END PUBLIC KEY-----") ||
+    !isAbsolute(turnDescriptorPath ?? "")
+  ) {
+    return null;
+  }
+  return Object.freeze({
+    desired: Object.freeze({
+      workspaceId: operation.workspaceId,
+      agentId: operation.agentId,
+      runtimeId: authority.runtimeId,
+      profileId,
+      runtimeGeneration,
+      serviceCredentialGeneration: service.credentialGeneration,
+    }),
+    runtimeConfig: Object.freeze({ turnDescriptorPath }),
+    trustRootPem,
+    gateway: Object.freeze({
+      readback: () => ({ running: nativeGatewayRunning(activeGateway) }),
+    }),
+  });
+}

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

@@ -155,8 +155,15 @@ COPY fly-admin-image/admin-runtime.mjs /usr/local/lib/sellable-agent/admin-runti
 COPY fly-admin-image/admin-runtime-phase-telemetry.mjs /usr/local/lib/sellable-agent/admin-runtime/admin-runtime-phase-telemetry.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 fly-customer-image/customer-runtime.mjs /usr/local/lib/sellable-agent/fly-customer-image/customer-runtime.mjs
+COPY fly-customer-image/hermes-runs-client.mjs /usr/local/lib/sellable-agent/fly-customer-image/hermes-runs-client.mjs
+COPY fly-customer-image/endpoint-uat-completion-gate.mjs /usr/local/lib/sellable-agent/fly-customer-image/endpoint-uat-completion-gate.mjs
 COPY admin-native-gateway-supervisor.mjs /usr/local/lib/sellable-agent/admin-native-gateway-supervisor.mjs
+COPY admin-endpoint-runtime.mjs /usr/local/lib/sellable-agent/admin-endpoint-runtime.mjs
 COPY abandoned-runtime-scratch.mjs /usr/local/lib/sellable-agent/abandoned-runtime-scratch.mjs
+COPY fly-customer-model.mjs /usr/local/lib/sellable-agent/fly-customer-model.mjs
+COPY fly-customer-worker.mjs /usr/local/lib/sellable-agent/fly-customer-worker.mjs
+COPY profile-materializer.mjs /usr/local/lib/sellable-agent/profile-materializer.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
 COPY fly-runtime-identity.mjs /usr/local/lib/sellable-agent/fly-runtime-identity.mjs
@@ -243,8 +250,15 @@ 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/fly-customer-image/customer-runtime.mjs \
+      /usr/local/lib/sellable-agent/fly-customer-image/hermes-runs-client.mjs \
+      /usr/local/lib/sellable-agent/fly-customer-image/endpoint-uat-completion-gate.mjs \
       /usr/local/lib/sellable-agent/admin-native-gateway-supervisor.mjs \
+      /usr/local/lib/sellable-agent/admin-endpoint-runtime.mjs \
       /usr/local/lib/sellable-agent/abandoned-runtime-scratch.mjs \
+      /usr/local/lib/sellable-agent/fly-customer-model.mjs \
+      /usr/local/lib/sellable-agent/fly-customer-worker.mjs \
+      /usr/local/lib/sellable-agent/profile-materializer.mjs \
       /usr/local/lib/sellable-agent/mcp-context-proxy.mjs \
       /usr/local/lib/sellable-agent/mcp-runtime-binding.mjs \
       /usr/local/lib/sellable-agent/fly-runtime-identity.mjs \
@@ -270,6 +284,7 @@ RUN set -eux; \
 
 LABEL io.sellable.runtime.kind="admin" \
       io.sellable.runtime.listener="native-dedicated-slack" \
+      io.sellable.runtime.api-server="authenticated-loopback-127.0.0.1:8642" \
       io.sellable.runtime.installers="build-only" \
       io.sellable.runtime.default-profile-bundle-version="${DEFAULT_PROFILE_BUNDLE_VERSION}" \
       io.sellable.runtime.default-profile-bundle-digest="${DEFAULT_PROFILE_BUNDLE_DIGEST}"

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

@@ -46,6 +46,7 @@ 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 { projectAdminEndpointRuntime } from "../admin-endpoint-runtime.mjs";
 import {
   nativeGatewayRunning,
   nextAdminNativeGatewayRecovery,
@@ -60,6 +61,7 @@ import {
   SELLABLE_BROWSER_TOOLSET_DEFAULT_MARKER,
   sellableSlackToolsetsForMaterialization,
 } from "../fly-capabilities-bridge.mjs";
+import { createCustomerEndpointRelay } from "../fly-customer-image/customer-runtime.mjs";
 import {
   claimWithSoulObservation,
   createFlyCustomerControlClient,
@@ -131,9 +133,9 @@ const PROFILES_ROOT = join(DATA_ROOT, "profiles");
 const RUNTIME_ROOT = join(DATA_ROOT, ".sellable-agent", "admin-runtime");
 const DELIVERY_ROOT = join(RUNTIME_ROOT, "delivery");
 const SECRET_ROOT = "/run/sellable-agent/admin-runtime";
-// Turn descriptor + consumed roots for the Product MCP context proxy. No
-// descriptor is ever installed on the Slack-only Admin runtime today, but the
-// proxy requires both private roots to exist at startup or it fails closed.
+// Turn descriptor + consumed roots for the Product MCP context proxy. They are
+// normally empty and receive one signed descriptor only while the fenced
+// endpoint relay owns a turn; the proxy fails closed if either root is absent.
 const MCP_TURN_CONTEXT_ROOT = join(SECRET_ROOT, "mcp-turn-context");
 const HERMES = "/opt/hermes/.venv/bin/hermes";
 const HERMES_PYTHON = "/opt/hermes/.venv/bin/python";
@@ -693,7 +695,7 @@ function ensureProductMcpContextProxyRoots() {
   privateDirectory(join(MCP_TURN_CONTEXT_ROOT, "consumed"));
 }
 
-function productMcpContextProxyEnvironment(layout) {
+function readMcpTurnTrustRoot() {
   let trustRootPem;
   try {
     const entry = lstatSync(MCP_TURN_TRUST_ROOT);
@@ -708,6 +710,11 @@ function productMcpContextProxyEnvironment(layout) {
   } catch {
     throw new Error("admin_runtime_trust_root_rejected");
   }
+  return trustRootPem;
+}
+
+function productMcpContextProxyEnvironment(layout) {
+  const trustRootPem = readMcpTurnTrustRoot();
   ensureProductMcpContextProxyRoots();
   return {
     SELLABLE_AGENT_TURN_DESCRIPTOR_PATH: join(
@@ -810,6 +817,10 @@ function installAdminModelConfig(profileRoot, modelConfig) {
       vision: { provider: "openrouter", model: "google/gemini-3.5-flash" },
     });
   }
+  document.setIn(["platforms", "api_server"], {
+    enabled: true,
+    extra: { host: "127.0.0.1", port: 8642, cors_origins: [] },
+  });
   atomicPrivateFile(path, document.toString());
   const readback = parseDocument(readFileSync(path, "utf8")).toJS();
   if (
@@ -820,7 +831,12 @@ function installAdminModelConfig(profileRoot, modelConfig) {
     canonicalJson(readback.credential_pool_strategies) !==
       canonicalJson(modelConfig.credential_pool_strategies) ||
     canonicalJson(readback.fallback_providers) !==
-      canonicalJson(modelConfig.fallback_providers)
+      canonicalJson(modelConfig.fallback_providers) ||
+    canonicalJson(readback.platforms?.api_server) !==
+      canonicalJson({
+        enabled: true,
+        extra: { host: "127.0.0.1", port: 8642, cors_origins: [] },
+      })
   ) {
     throw new Error("admin_model_config_rejected");
   }
@@ -1826,6 +1842,10 @@ function installRuntimeSecrets({ claim, secrets, desiredLifecycle }) {
   );
   atomicPrivateFile(join(SECRET_ROOT, "slack-app"), `${secrets.slackApp}\n`);
   atomicPrivateFile(join(SECRET_ROOT, "slack-bot"), `${secrets.slackBot}\n`);
+  atomicPrivateFile(
+    join(SECRET_ROOT, "api-server-key"),
+    sha256(`admin-endpoint-api\0${randomUUID()}\0${Date.now()}`)
+  );
   const slackSecretFile = join(SECRET_ROOT, "profile-slack.env");
   atomicPrivateFile(
     slackSecretFile,
@@ -2032,6 +2052,7 @@ function clearRuntimeSecrets() {
   for (const name of [
     "slack-app",
     "slack-bot",
+    "api-server-key",
     "profile-slack.env",
     "sellable-config.json",
   ]) {
@@ -2869,10 +2890,9 @@ async function startNativeGateway({ profile, claim }) {
     profileRoot: profile.profileHome,
     secretsRoot: SECRET_ROOT,
     profileId: profile.profile,
-    // Authenticated Hermes HTTP endpoints are CUSTOMER-only. The broker
-    // intentionally does not issue a hermes-api-server secret to ADMIN
-    // runtimes, whose native gateway remains Slack-only.
-    apiServerKeyRequired: false,
+    // The endpoint relay is runtime-local and uses a fresh tmpfs key. The key
+    // never crosses the control plane and Hermes still binds only loopback.
+    apiServerKeyRequired: true,
     env: {
       ...adminToolEnv(adminHomeLayout(profile.profileHome)),
       ...adminAgentServiceEnvironment(claim),
@@ -2896,11 +2916,17 @@ async function startNativeGateway({ profile, claim }) {
     launch.inheritedFileDescriptors.find(({ fd }) => fd === 9).path,
     "r"
   );
+  const apiServerKey = readFileSync(launch.apiServerKeyFile, "utf8");
+  if (!/^[a-f0-9]{64}$/.test(apiServerKey)) {
+    closeSync(appFd);
+    closeSync(botFd);
+    throw new Error("admin_endpoint_api_key_rejected");
+  }
   let child;
   try {
     child = spawn(HERMES, launch.args, {
       cwd: launch.cwd,
-      env: launch.env,
+      env: { ...launch.env, API_SERVER_KEY: apiServerKey },
       stdio: [
         "ignore",
         "ignore",
@@ -3566,12 +3592,28 @@ async function runAdminProduction() {
   let activeLaunch = null;
   let activeModelHealthReporter = null;
   let shutdownMemorySnapshot = null;
+  const endpointRelay = createCustomerEndpointRelay({
+    getControlClient: () => client,
+    getActiveRuntime: () =>
+      projectAdminEndpointRuntime({
+        activeLaunch,
+        activeGateway,
+        runtimeGeneration: RUNTIME_GENERATION,
+        trustRootPem: readMcpTurnTrustRoot(),
+        turnDescriptorPath: join(MCP_TURN_CONTEXT_ROOT, "turn-context.json"),
+      }),
+    runtimeGeneration: RUNTIME_GENERATION,
+    getApiKeyFile: () => join(SECRET_ROOT, "api-server-key"),
+    diagnostic: (value) => process.stderr.write(`${JSON.stringify(value)}\n`),
+  });
+  const endpointLoop = endpointRelay.run(controller.signal);
   const beginShutdownSnapshot = () => {
     if (!activeLaunch || shutdownMemorySnapshot) return;
     const launch = activeLaunch;
     const gateway = activeGateway;
     shutdownMemorySnapshot = (async () => {
       try {
+        await endpointRelay.fenceActive("RUNTIME_SHUTDOWN");
         await stopNativeGateway(gateway);
         if (activeGateway === gateway) activeGateway = null;
         return await flushHermesSnapshot({
@@ -3677,6 +3719,7 @@ async function runAdminProduction() {
             !nativeGatewayRunning(activeGateway) &&
             !gatewayRestartExhaustionReported
           ) {
+            await endpointRelay.fenceActive("GATEWAY_RESTART");
             const recovery = await recoverUnexpectedNativeGateway({
               activeLaunch,
               activeGateway,
@@ -3768,6 +3811,7 @@ async function runAdminProduction() {
       });
       await activeModelHealthReporter?.stop();
       activeModelHealthReporter = null;
+      await endpointRelay.fenceActive("LIFECYCLE_REFRESH");
       await stopNativeGateway(activeGateway);
       activeGateway = null;
       activeLaunch = null;
@@ -4163,6 +4207,7 @@ async function runAdminProduction() {
       })}\n`
     );
   }
+  await endpointLoop;
   await activeModelHealthReporter?.stop();
   await stopNativeGateway(activeGateway);
   clearRuntimeSecrets();

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.901
 ARG MCP_INTEGRITY=sha512-0YBT2d3YBgZFSgEcmoDCNLz/PWMiBbqMWeZoEFArWuk63/vrYATEp/qBNzYhpy7SKClLapsb1RRagdXrvo/p9g==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.687
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.689
 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

@@ -18,6 +18,11 @@ import { loadavg } from "node:os";
 import { dirname, join } from "node:path";
 import { pathToFileURL } from "node:url";
 import { pruneAbandonedRuntimeScratch } from "../abandoned-runtime-scratch.mjs";
+import {
+  bindDefaultProfileProbeCron,
+  buildDefaultProfileProjection,
+  reconcileDefaultProfileBundle,
+} from "../default-profile-reconciler.mjs";
 import {
   buildNativeHermesLaunch,
   buildRuntimeServingObservation,
@@ -39,17 +44,12 @@ import {
   renewFlyCustomerControlSession,
   signedWorkerAuthorization,
 } from "../fly-runtime-identity.mjs";
+import { proveDefaultProfileNativeSkills } from "../fly-skills-bridge.mjs";
 import {
   executeExternalSoulBridgeOperation,
   observeProfileSoul,
   prepareSoulLockRoot,
 } from "../fly-soul-bridge.mjs";
-import { proveDefaultProfileNativeSkills } from "../fly-skills-bridge.mjs";
-import {
-  bindDefaultProfileProbeCron,
-  buildDefaultProfileProjection,
-  reconcileDefaultProfileBundle,
-} from "../default-profile-reconciler.mjs";
 import {
   ensureHermesSnapshotCron,
   markHermesSnapshotDirty,
@@ -105,8 +105,7 @@ const RUNTIME_GENERATION = Number(
 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.687";
+  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.689";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.901";
 const DEFAULT_PROFILE_BUNDLE_ROOT =
@@ -1051,6 +1050,8 @@ export function createCustomerEndpointRelay(options = {}) {
     getControlClient,
     getActiveRuntime,
     runtimeGeneration,
+    getApiKeyFile = ({ claim }) =>
+      join(SECRET_ROOT, claim.runtime.profileId, "api-server-key"),
     createRunsClient = ({ apiKeyFile }) =>
       createHermesRunsClient({ apiKeyFile }),
     now = () => new Date(),
@@ -1062,6 +1063,7 @@ export function createCustomerEndpointRelay(options = {}) {
   if (
     typeof getControlClient !== "function" ||
     typeof getActiveRuntime !== "function" ||
+    typeof getApiKeyFile !== "function" ||
     typeof createRunsClient !== "function" ||
     typeof now !== "function" ||
     typeof sleepImpl !== "function" ||
@@ -1364,11 +1366,7 @@ export function createCustomerEndpointRelay(options = {}) {
     if (installedDescriptor.ok !== true) {
       throw new Error("customer_endpoint_mcp_descriptor_rejected");
     }
-    const apiKeyFile = join(
-      SECRET_ROOT,
-      claim.runtime.profileId,
-      "api-server-key"
-    );
+    const apiKeyFile = getApiKeyFile({ claim, activeRuntime });
     const runs = createRunsClient({ apiKeyFile, claim, activeRuntime });
     const controller = new AbortController();
     const abortFromOuter = () => controller.abort(outerSignal.reason);

package/lib/sellable-agent/fly-soul-bridge.mjs

@@ -873,9 +873,38 @@ function proveCanonical(paths, raw, effectiveLoader) {
 
 function safelyRemoveLegacyRoot(paths) {
   if (!existsSync(paths.legacyRootSoulPath)) return null;
-  const legacy = readSafeRegular(paths.legacyRootSoulPath, {
-    maxBytes: 64 * 1024,
-  });
+  let legacy;
+  try {
+    legacy = readSafeRegular(paths.legacyRootSoulPath, {
+      maxBytes: 64 * 1024,
+    });
+  } catch (error) {
+    if (error?.code !== "EACCES" && error?.code !== "EPERM") throw error;
+    const blocked = lstatSync(paths.legacyRootSoulPath);
+    if (
+      blocked.isSymbolicLink() ||
+      !blocked.isFile() ||
+      blocked.nlink !== 1 ||
+      blocked.size > 64 * 1024 ||
+      (blocked.mode & 0o022) !== 0 ||
+      !safeSharedOwner(blocked.uid)
+    ) {
+      fail("soul_legacy_root_rejected");
+    }
+    // The exact live Gateway and canonical profile SOUL were already proven
+    // before this cleanup runs. A root-owned 0600 legacy copy cannot be read
+    // by the deliberately de-privileged bridge, but the Hermes-owned data
+    // directory still permits removing that non-authoritative entry safely.
+    try {
+      unlinkSync(paths.legacyRootSoulPath);
+      fsyncDirectory(paths.dataRoot);
+    } catch (unlinkError) {
+      if (unlinkError?.code !== "EACCES" && unlinkError?.code !== "EPERM") {
+        throw unlinkError;
+      }
+    }
+    return null;
+  }
   if ((legacy.stat.mode & 0o022) !== 0 || !safeSharedOwner(legacy.stat.uid))
     fail("soul_legacy_root_rejected");
   const digest = sha256(legacy.bytes);

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.687";
+const INSTALLER_PACKAGE = "@sellable/install@0.1.689";
 const MCP_PACKAGE = "@sellable/mcp@0.1.901";
 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.687" ||
+        "@sellable/install@0.1.689" ||
       pinned.mcpPackage !== "@sellable/mcp@0.1.901" ||
       !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.687" ||
+      "@sellable/install@0.1.689" ||
     desired.mcpPackage !== "@sellable/mcp@0.1.901" ||
     !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.687";
+  "@sellable/install@0.1.689";
 export const PINNED_MCP_PACKAGE = "@sellable/mcp@0.1.901";
 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.687",
+  "version": "0.1.689",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code, Codex, and Hermes",
   "bin": {