@sellable/install 0.1.584 → 0.1.586

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.582
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.586
 ARG MCP_PACKAGE=@sellable/mcp@0.1.860
 ARG INSTALLER_INTEGRITY
 ARG MCP_INTEGRITY=sha512-jRA1KsCV2d4Zcuo5/UmJiP8P0NaoC3ZDvUFRQOc2AMSNDVmUR6gWvtkyAiqb1lukbFWKzfVlz2/4EWzxvb7hkQ==
 
-RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.582" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.586" \
     && test "${MCP_PACKAGE}" = "@sellable/mcp@0.1.860" \
     && 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.582" \
     && 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.582' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.860') 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.586' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.860') 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.582', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.860', 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.586', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.860', 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,13 +3,13 @@
 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.582` is
+`@sellable/install@0.1.586` is
 published:
 
 ```sh
 docker build --platform linux/amd64 \
   --build-arg INSTALLER_INTEGRITY='sha512-…' \
-  --tag sellable-agent-host:0.1.582 .
+  --tag sellable-agent-host:0.1.586 .
 ```
 
 Create a private `bootstrap/` directory owned by root with mode `0700`. It must contain `bootstrap.json`, `provider-auth`, and `slack-app`, each owned by root with mode `0600`. `bootstrap.json` contains only non-secret identities, hashes, package integrities, and the control-plane URL. The other two files contain the provider JSON and global Slack app token whose hashes are pinned by `bootstrap.json`.

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

@@ -15,6 +15,7 @@ ARG ADMIN_LOCKED_TREE_DIGEST
 ARG ADMIN_ARTIFACT_DIGEST
 ARG ADMIN_PACKAGE_LOCK_B64
 ARG ADMIN_PROFILE_CONTRACT_TEMPLATE_B64
+ARG MCP_TRUST_ROOT_FINGERPRINT
 ARG TUS_JS_CLIENT_VERSION=4.3.1
 ARG STRIPE_CLI_PACKAGE=@stripe/cli-linux-x64@1.45.0
 ARG STRIPE_CLI_INTEGRITY=sha512-1ZhoPpoweYfynqsvhCLlTjZ7lPz5IKtxqAMT5MBy6zrwLRTP9x0T6r8h/jLYL8lRH1c7zC/6X6/XUu2V+r9Bog==
@@ -76,8 +77,22 @@ RUN set -eux; \
           /etc/cont-init.d/02-reconcile-profiles; \
     npm cache clean --force
 
+# The MCP turn trust root is the same build secret the customer image bakes.
+# The Admin runtime hands the Product MCP context proxy this exact file plus
+# its fingerprint, so the baked bytes must match the pinned signing contract.
+RUN --mount=type=secret,id=mcp_trust_root,required=true \
+    set -eux; \
+    test -s /run/secrets/mcp_trust_root; \
+    test -n "${MCP_TRUST_ROOT_FINGERPRINT}"; \
+    install -d -m 0755 /usr/local/share/sellable-agent; \
+    install -o root -g root -m 0444 /run/secrets/mcp_trust_root \
+      /usr/local/share/sellable-agent/mcp-turn-trust-root.pem; \
+    test "$(sha256sum /usr/local/share/sellable-agent/mcp-turn-trust-root.pem | cut -d ' ' -f 1)" = "${MCP_TRUST_ROOT_FINGERPRINT}"
+
 COPY fly-admin-image/admin-runtime.mjs /usr/local/lib/sellable-agent/admin-runtime/admin-runtime.mjs
 COPY fly-admin-image/start-admin-runtime /usr/local/lib/sellable-agent/admin-runtime/start-admin-runtime
+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
 COPY model-auth-reconciler.mjs /usr/local/lib/sellable-agent/model-auth-reconciler.mjs
 COPY model-auth-canary-reseed.mjs /usr/local/lib/sellable-agent/model-auth-canary-reseed.mjs
@@ -98,6 +113,8 @@ RUN node --input-type=module -e \
       'import { installHermesAgentBridge, HERMES_AGENT_BRIDGE_DEDICATED_V020_CONTRACT } from "/usr/local/lib/sellable-agent/hermes-bridge.mjs"; installHermesAgentBridge({ sourceRoot: "/opt/hermes", contract: HERMES_AGENT_BRIDGE_DEDICATED_V020_CONTRACT });' \
     && node --input-type=module -e \
       'await import("/usr/local/lib/sellable-agent/fly-runtime-identity.mjs");' \
+    && node --input-type=module -e \
+      'await import("/usr/local/lib/sellable-agent/mcp-context-proxy.mjs");' \
     && install -d -m 0755 /usr/local/share/sellable-agent \
     && printf '%s\n' \
       '#!/usr/bin/env node' \
@@ -125,6 +142,8 @@ RUN node --input-type=module -e \
     && chmod 0555 \
       /usr/local/lib/sellable-agent/admin-runtime/admin-runtime.mjs \
       /usr/local/lib/sellable-agent/admin-runtime/start-admin-runtime \
+      /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 \
       /usr/local/lib/sellable-agent/model-auth-reconciler.mjs \
       /usr/local/lib/sellable-agent/model-auth-canary-reseed.mjs \

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

@@ -102,9 +102,19 @@ 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.
+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";
 const NODE = "/usr/local/bin/node";
+// The Product MCP runs behind the same context proxy the customer runtime
+// uses, from the same stable image path. The Admin MCP stays a direct dist
+// entrypoint — two distinct servers on one profile.
+const MCP_CONTEXT_PROXY = "/usr/local/lib/sellable-agent/mcp-context-proxy.mjs";
+const MCP_TURN_TRUST_ROOT =
+  "/usr/local/share/sellable-agent/mcp-turn-trust-root.pem";
 const ADMIN_INSTALL_PACKAGE_ROOT = join(
   ARTIFACT_ROOT,
   "node_modules",
@@ -561,6 +571,48 @@ function exactSoul(claim) {
   return { bytes: soul, sha256: sha256(soul), byteLength: soul.byteLength };
 }
 
+// The context proxy fails closed at startup unless its descriptor roots
+// exist as private directories, its trust root file matches the fingerprint
+// it is handed, and its downstream command is absolute. The materializer owns
+// every one of those inputs so the `sellable` server can never enter a
+// fail-closed respawn loop from missing environment.
+function productMcpContextProxyEnvironment(layout) {
+  let trustRootPem;
+  try {
+    const entry = lstatSync(MCP_TURN_TRUST_ROOT);
+    if (
+      entry.isSymbolicLink() ||
+      !entry.isFile() ||
+      (entry.mode & 0o022) !== 0
+    ) {
+      throw new Error("admin_runtime_trust_root_rejected");
+    }
+    trustRootPem = readFileSync(MCP_TURN_TRUST_ROOT, "utf8");
+  } catch {
+    throw new Error("admin_runtime_trust_root_rejected");
+  }
+  privateDirectory(MCP_TURN_CONTEXT_ROOT);
+  privateDirectory(join(MCP_TURN_CONTEXT_ROOT, "consumed"));
+  return {
+    SELLABLE_AGENT_TURN_DESCRIPTOR_PATH: join(
+      MCP_TURN_CONTEXT_ROOT,
+      "turn-context.json"
+    ),
+    SELLABLE_AGENT_TURN_CONSUMED_ROOT: join(MCP_TURN_CONTEXT_ROOT, "consumed"),
+    SELLABLE_AGENT_MCP_RUNTIME_BINDING_PATH: join(
+      layout.profileHome,
+      "sellable",
+      "runtime-binding.json"
+    ),
+    SELLABLE_AGENT_MCP_TRUST_ROOT_PATH: MCP_TURN_TRUST_ROOT,
+    SELLABLE_AGENT_MCP_TRUST_ROOT_FINGERPRINT: sha256(trustRootPem),
+    SELLABLE_AGENT_MCP_DOWNSTREAM_COMMAND: NODE,
+    SELLABLE_AGENT_MCP_DOWNSTREAM_ARGS_JSON: JSON.stringify([
+      `${ARTIFACT_ROOT}/node_modules/@sellable/mcp/dist/index.js`,
+    ]),
+  };
+}
+
 function profilePackageReceipt(
   profileContract,
   alias,
@@ -569,21 +621,24 @@ function profilePackageReceipt(
   agentServiceEnv = {}
 ) {
   const entry = profileContract.packages[alias][role];
-  const packageName = entry.name;
-  const entrypoint =
-    alias === "sellable"
-      ? `${ARTIFACT_ROOT}/node_modules/@sellable/mcp/dist/index.js`
-      : `${ARTIFACT_ROOT}/node_modules/@sellable/admin-mcp/dist/index.js`;
   return {
     ...entry,
     command: "/usr/local/bin/node",
-    args: [entrypoint],
+    args:
+      alias === "sellable"
+        ? [MCP_CONTEXT_PROXY]
+        : [`${ARTIFACT_ROOT}/node_modules/@sellable/admin-mcp/dist/index.js`],
     // The Admin MCP resolves its packaged gateway scripts through
     // SELLABLE_ADMIN_ROOT and its CLI shell-outs through PATH, so the server
     // entry carries them instead of relying on gateway inheritance.
     ...(alias === "sellable-admin" ? { env: adminToolEnv(layout) } : {}),
-    ...(alias === "sellable" && Object.keys(agentServiceEnv).length > 0
-      ? { env: agentServiceEnv }
+    ...(alias === "sellable"
+      ? {
+          env: {
+            ...agentServiceEnv,
+            ...productMcpContextProxyEnvironment(layout),
+          },
+        }
       : {}),
   };
 }

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

@@ -6,7 +6,7 @@ USER root
 
 ARG MCP_PACKAGE=@sellable/mcp@0.1.860
 ARG MCP_INTEGRITY=sha512-jRA1KsCV2d4Zcuo5/UmJiP8P0NaoC3ZDvUFRQOc2AMSNDVmUR6gWvtkyAiqb1lukbFWKzfVlz2/4EWzxvb7hkQ==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.582
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.586
 ARG TUS_JS_CLIENT_VERSION=4.3.1
 ARG HERMES_VERSION=0.20.0
 ARG TIRITH_VERSION=0.3.3

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

@@ -93,7 +93,7 @@ const RUNTIME_GENERATION = Number(
 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.582";
+  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.586";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.860";
 

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

@@ -39,7 +39,7 @@ 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.582";
+  "@sellable/install@0.1.586";
 const MCP_PACKAGE = "@sellable/mcp@0.1.860";
 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.582" ||
+      pinned.installerPackage !== "@sellable/install@0.1.586" ||
       pinned.mcpPackage !== "@sellable/mcp@0.1.860" ||
       !Array.isArray(policy.toolInclude) ||
       policy.toolInclude.length === 0 ||

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

@@ -23,6 +23,7 @@ import {
   relative,
   resolve,
 } from "node:path";
+import { parseDocument } from "yaml";
 import {
   FLY_CUSTOMER_MODEL_ID,
   FLY_CUSTOMER_MODEL_PROVIDER,
@@ -201,7 +202,7 @@ function validateDesired(desired) {
     desired.serviceCredentialGeneration < 1 ||
     desired.hermesCli !== "hermes" ||
     desired.hermesVersion !== "0.18.0" ||
-    desired.installerPackage !== "@sellable/install@0.1.582" ||
+    desired.installerPackage !== "@sellable/install@0.1.586" ||
     desired.mcpPackage !== "@sellable/mcp@0.1.860" ||
     !Array.isArray(desired.toolInclude) ||
     desired.toolInclude.length === 0 ||
@@ -424,8 +425,22 @@ function profileConfigWithoutLiveSkills(value) {
   return normalized;
 }
 
+function readProfileConfig(pathValue) {
+  const document = parseDocument(readFileSync(pathValue, "utf8"));
+  const value = document.toJS();
+  if (
+    document.errors.length > 0 ||
+    !value ||
+    typeof value !== "object" ||
+    Array.isArray(value)
+  ) {
+    throw new Error("profile config rejected");
+  }
+  return value;
+}
+
 function normalizedProfileConfigBytes(pathValue) {
-  const value = JSON.parse(readFileSync(pathValue, "utf8"));
+  const value = readProfileConfig(pathValue);
   return Buffer.from(
     `${JSON.stringify(profileConfigWithoutLiveSkills(value), null, 2)}\n`,
     "utf8"
@@ -436,8 +451,11 @@ function mergeLiveSkillsConfig(sourceRoot, targetRoot) {
   const sourcePath = join(sourceRoot, "config.yaml");
   const targetPath = join(targetRoot, "config.yaml");
   if (!existsSync(sourcePath) || !existsSync(targetPath)) return;
-  const source = JSON.parse(readFileSync(sourcePath, "utf8"));
-  const target = JSON.parse(readFileSync(targetPath, "utf8"));
+  // Hermes owns this live file and normalizes it from the seed JSON into
+  // YAML. Parse both representations so a routine image refresh does not
+  // strand a healthy customer runtime before it can acknowledge its secrets.
+  const source = readProfileConfig(sourcePath);
+  const target = readProfileConfig(targetPath);
   const sourceSkills = source?.skills;
   if (
     !sourceSkills ||
@@ -500,7 +518,7 @@ function preservedSkillsConfigIdentity(profileRoot) {
   const configPath = join(profileRoot, "config.yaml");
   let disabled = {};
   if (existsSync(configPath)) {
-    const config = JSON.parse(readFileSync(configPath, "utf8"));
+    const config = readProfileConfig(configPath);
     const skills = config?.skills;
     if (skills && typeof skills === "object" && !Array.isArray(skills)) {
       disabled = Object.fromEntries(

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.582";
+export const PINNED_INSTALL_PACKAGE = "@sellable/install@0.1.586";
 export const PINNED_MCP_PACKAGE = "@sellable/mcp@0.1.860";
 
 export function deriveAgentProfileId(workspaceId, agentId, hostId) {
@@ -611,7 +611,7 @@ function inspectProvisionedProfile({
       !matchesReadback(manifest, request) ||
       manifest.serviceCredentialReference !== serviceCredentialReference ||
       manifest.installerPackage !== PINNED_INSTALL_PACKAGE ||
-      manifest.installerVersion !== "0.1.582" ||
+      manifest.installerVersion !== "0.1.586" ||
       manifest.mcpPackage !== PINNED_MCP_PACKAGE ||
       manifest.credentialKeyVersion !== credentialKeyVersion ||
       !/^[a-f0-9]{16}$/.test(manifest.credentialFingerprint) ||
@@ -825,7 +825,7 @@ function successReceipt({
     subject: `agent-profile:${observed.profileId}`,
     cli: {
       installPackage: PINNED_INSTALL_PACKAGE,
-      installVersion: "0.1.582",
+      installVersion: "0.1.586",
       mcpPackage: PINNED_MCP_PACKAGE,
       command: "hermes profile bootstrap",
     },
@@ -873,7 +873,7 @@ function failure(code, stages, extra = {}, request = null) {
       : "agent-profile:unbound",
     cli: {
       installPackage: PINNED_INSTALL_PACKAGE,
-      installVersion: "0.1.582",
+      installVersion: "0.1.586",
       mcpPackage: PINNED_MCP_PACKAGE,
       command: "hermes profile bootstrap",
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/install",
-  "version": "0.1.584",
+  "version": "0.1.586",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code, Codex, and Hermes",
   "bin": {