@sellable/install 0.1.600 → 0.1.602

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.600
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.602
 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.600" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.602" \
     && 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.600" \
     && 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.600' || 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.602' || 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.600', 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.602', 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.600` is
+`@sellable/install@0.1.602` is
 published:
 
 ```sh
 docker build --platform linux/amd64 \
   --build-arg INSTALLER_INTEGRITY='sha512-…' \
-  --tag sellable-agent-host:0.1.600 .
+  --tag sellable-agent-host:0.1.602 .
 ```
 
 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-capabilities-bridge.mjs

@@ -31,6 +31,8 @@ export const CAPABILITIES_BRIDGE_SCHEMA_VERSION =
   "sellable-agent-capabilities-bridge/v1";
 export const CAPABILITIES_PROOF_SCHEMA_VERSION =
   "sellable-agent-capabilities-proof/v1";
+const CAPABILITIES_CONFIG_AUTHORITY_SCHEMA_VERSION =
+  "sellable-agent-capabilities-config-authority/v1";
 export const CAPABILITIES_REQUEST_MAX_BYTES = 16 * 1024;
 
 // Deliberately excludes credential-bearing, external-account, platform-admin,
@@ -192,7 +194,7 @@ function boundedText(value, max) {
   return typeof value === "string" && Buffer.byteLength(value, "utf8") <= max;
 }
 
-function normalizeNative(native, request, configSha256, packageSpecs) {
+function normalizeNative(native, request, packageSpecs) {
   if (!native || !Array.isArray(native.tools) || !Array.isArray(native.servers))
     fail("capabilities_native_output_rejected");
   const tools = native.tools.map((row) => {
@@ -232,6 +234,7 @@ function normalizeNative(native, request, configSha256, packageSpecs) {
     fail("capabilities_tool_inventory_rejected");
 
   const aliases = expectedAliases(request.expectedRuntimeKind);
+  const serverConfigAuthority = new Map();
   const mcpServers = native.servers.map((row) => {
     if (
       !row ||
@@ -240,6 +243,7 @@ function normalizeNative(native, request, configSha256, packageSpecs) {
       row.transport !== "stdio" ||
       typeof row.workspaceLocked !== "boolean" ||
       typeof row.requiresWorkspaceLock !== "boolean" ||
+      !SHA256.test(row.configAuthoritySha256 ?? "") ||
       !["healthy", "unhealthy", "unknown"].includes(row.health) ||
       !Array.isArray(row.tools) ||
       row.tools.length > 1024 ||
@@ -281,6 +285,7 @@ function normalizeNative(native, request, configSha256, packageSpecs) {
     // authoritative inventory. ADMIN has no customer workspace lock and its
     // two direct live probes remain authoritative.
     const names = customerProductServer ? configuredNames : probedNames;
+    serverConfigAuthority.set(row.name, row.configAuthoritySha256);
     return Object.freeze({
       name: row.name,
       label: row.name === "sellable" ? "Sellable" : "Sellable Admin",
@@ -303,6 +308,37 @@ function normalizeNative(native, request, configSha256, packageSpecs) {
     stableJson(mcpServers.map((server) => server.name)) !== stableJson(aliases)
   )
     fail("capabilities_mcp_inventory_rejected");
+  // The CAS token describes effective Capabilities authority, not YAML bytes.
+  // Hermes' native saver may normalize formatting or materialize defaults, so
+  // hashing the file made an off -> on round trip semantically exact but hash-
+  // unstable. Raw bytes are still fenced around enumeration in readInventory.
+  const configSha256 = sha256(
+    stableJson({
+      schemaVersion: CAPABILITIES_CONFIG_AUTHORITY_SCHEMA_VERSION,
+      platform: "slack",
+      tools: tools.map(({ name, enabled, configured }) => ({
+        name,
+        enabled,
+        configured,
+      })),
+      mcpServers: mcpServers.map(
+        ({
+          name,
+          enabled,
+          transport,
+          workspaceLocked,
+          requiresWorkspaceLock,
+        }) => ({
+          name,
+          enabled,
+          transport,
+          workspaceLocked,
+          requiresWorkspaceLock,
+          configAuthoritySha256: serverConfigAuthority.get(name),
+        })
+      ),
+    })
+  );
   const inventory = Object.freeze({
     complete: true,
     configSha256,
@@ -316,7 +352,7 @@ function normalizeNative(native, request, configSha256, packageSpecs) {
 }
 
 const NATIVE_SCRIPT = String.raw`
-import json, os, stat, sys
+import hashlib, json, os, stat, sys
 request = json.loads(sys.stdin.read())
 from hermes_cli.config import load_config
 from hermes_cli.mcp_config import _get_mcp_servers, _probe_single_server
@@ -403,6 +439,7 @@ def enumerate_capabilities():
             "transport": "http" if server.get("url") else "stdio" if server.get("command") else "unknown",
             "workspaceLocked": env.get("SELLABLE_LOCK_WORKSPACE_ID") == request["expectedWorkspaceId"],
             "requiresWorkspaceLock": str(env.get("SELLABLE_REQUIRE_WORKSPACE_LOCK", "")) == "1",
+            "configAuthoritySha256": hashlib.sha256(json.dumps(server, sort_keys=True, separators=(",", ":"), ensure_ascii=False).encode("utf-8")).hexdigest(),
             "health": health,
             "tools": tools,
             "configuredTools": configured_customer_tools(name, server),
@@ -505,7 +542,7 @@ function atomicProof(paths, inventory) {
 
 function readInventory(request, paths, adapter, packageSpecs) {
   const configPath = join(paths.profileRoot, "config.yaml");
-  const configSha256 = sha256(regularFile(configPath));
+  const rawConfigSha256 = sha256(regularFile(configPath));
   const aliases = expectedAliases(request.expectedRuntimeKind);
   const native = adapter.enumerate({
     expectedAliases: aliases,
@@ -515,9 +552,9 @@ function readInventory(request, paths, adapter, packageSpecs) {
       ? { probeServerName: request.serverName }
       : {}),
   });
-  if (sha256(regularFile(configPath)) !== configSha256)
+  if (sha256(regularFile(configPath)) !== rawConfigSha256)
     fail("capabilities_config_changed");
-  return normalizeNative(native, request, configSha256, packageSpecs);
+  return normalizeNative(native, request, packageSpecs);
 }
 
 function executeLocked(request, paths, adapter, options) {

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.600
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.602
 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

@@ -95,7 +95,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.600";
+  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.602";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.860";
 
@@ -2134,10 +2134,56 @@ async function startNativeGateway({ desired, runtimeConfig, secrets }) {
   };
 }
 
-const API_SERVER_READINESS_DEADLINE_MS = 30_000;
+export const API_SERVER_READINESS_DEADLINE_MS = 240_000;
 const API_SERVER_READINESS_RETRY_MS = 1_000;
 
-async function proveApiServerReadiness({ desired, apiServerKey }) {
+export function nativeGatewayRuntimeStatusAccepted(
+  status,
+  { expectedPid, expectedHome }
+) {
+  return Boolean(
+    status &&
+      Number.isSafeInteger(expectedPid) &&
+      expectedPid > 1 &&
+      status.pid === expectedPid &&
+      status.kind === "hermes-gateway" &&
+      Array.isArray(status.argv) &&
+      status.argv.includes("gateway") &&
+      status.argv.includes("run") &&
+      Number.isSafeInteger(status.start_time) &&
+      status.start_time > 0 &&
+      status.hermes_home === expectedHome &&
+      status.gateway_state === "running" &&
+      status.platforms?.slack?.state === "connected" &&
+      status.platforms?.api_server?.state === "connected"
+  );
+}
+
+function readNativeGatewayRuntimeStatus(runtimeHome) {
+  try {
+    const statusPath = join(runtimeHome, "gateway_state.json");
+    const entry = lstatSync(statusPath);
+    if (
+      entry.isSymbolicLink() ||
+      !entry.isFile() ||
+      (entry.mode & 0o022) !== 0 ||
+      entry.size < 2 ||
+      entry.size > 64 * 1024
+    ) {
+      return null;
+    }
+    return JSON.parse(readFileSync(statusPath, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+async function proveApiServerReadiness({
+  desired,
+  apiServerKey,
+  gateway,
+  runtimeConfig,
+}) {
   const origin = "http://127.0.0.1:8642";
   const request = (authorization) =>
     fetch(`${origin}/v1/capabilities`, {
@@ -2146,6 +2192,26 @@ async function proveApiServerReadiness({ desired, apiServerKey }) {
     });
   const deadlineAt = Date.now() + API_SERVER_READINESS_DEADLINE_MS;
   while (Date.now() < deadlineAt) {
+    const gatewayReadback = gateway?.readback();
+    if (!gatewayReadback?.running) {
+      throw new Error(
+        `customer_native_gateway_start_rejected:${redactRuntimeDiagnostic(
+          gatewayReadback?.output ?? "candidate exited before readiness"
+        )}`
+      );
+    }
+    const candidateStatus = readNativeGatewayRuntimeStatus(
+      runtimeConfig.runtimeHome
+    );
+    if (
+      !nativeGatewayRuntimeStatusAccepted(candidateStatus, {
+        expectedPid: gateway.child.pid,
+        expectedHome: runtimeConfig.runtimeHome,
+      })
+    ) {
+      await sleep(API_SERVER_READINESS_RETRY_MS);
+      continue;
+    }
     try {
       const [health, missing, wrong, correct] = await Promise.all([
         fetch(`${origin}/health`, { signal: AbortSignal.timeout(5_000) }),
@@ -2159,6 +2225,13 @@ async function proveApiServerReadiness({ desired, apiServerKey }) {
         missing.status === 401 &&
         wrong.status === 401 &&
         correct.status === 200 &&
+        nativeGatewayRuntimeStatusAccepted(
+          readNativeGatewayRuntimeStatus(runtimeConfig.runtimeHome),
+          {
+            expectedPid: gateway.child.pid,
+            expectedHome: runtimeConfig.runtimeHome,
+          }
+        ) &&
         capabilities?.auth?.required === true &&
         capabilities?.features?.run_submission === true &&
         capabilities?.features?.run_events_sse === true
@@ -2181,6 +2254,7 @@ async function proveApiServerReadiness({ desired, apiServerKey }) {
           fixtureDigest: HERMES_RUNS_FIXTURE_IDENTITY.fixtureDigest,
           relayCapability: "fixture_bound_runs_relay_v1",
           runtimeGeneration: desired.runtimeGeneration,
+          gatewayPid: gateway.child.pid,
         });
       }
     } catch {
@@ -2193,6 +2267,48 @@ async function proveApiServerReadiness({ desired, apiServerKey }) {
   throw new Error("customer_api_server_readiness_rejected");
 }
 
+export async function startProvenNativeGateway({
+  desired,
+  runtimeConfig,
+  secrets,
+  startGateway = startNativeGateway,
+  proveReadiness = proveApiServerReadiness,
+  stopGateway = stopNativeGateway,
+}) {
+  let gateway = null;
+  try {
+    gateway = await startGateway({ desired, runtimeConfig, secrets });
+    const gatewayReadback = gateway.readback();
+    if (!gatewayReadback.running) {
+      throw new Error("customer_native_gateway_readback_rejected");
+    }
+    const apiServerReadiness = await proveReadiness({
+      desired,
+      apiServerKey: secrets.hermesApiServer,
+      gateway,
+      runtimeConfig,
+    });
+    return { gateway, gatewayReadback, apiServerReadiness };
+  } catch (error) {
+    if (gateway) {
+      try {
+        await stopGateway(gateway);
+      } catch (cleanupError) {
+        process.stderr.write(
+          `${JSON.stringify({
+            ok: false,
+            code:
+              cleanupError instanceof Error
+                ? cleanupError.message
+                : "customer_native_gateway_cleanup_failed",
+          })}\n`
+        );
+      }
+    }
+    throw error;
+  }
+}
+
 async function proveProvisionedApplication({
   desired,
   runtimeConfig,
@@ -2386,20 +2502,12 @@ async function proveApplication({
   ) {
     throw new Error("customer_slack_socket_identity_rejected");
   }
-  const gateway = await startNativeGateway({
-    desired,
-    runtimeConfig,
-    secrets,
-  });
-  const gatewayReadback = gateway.readback();
-  if (!gatewayReadback.running) {
-    await stopNativeGateway(gateway);
-    throw new Error("customer_native_gateway_readback_rejected");
-  }
-  const apiServerReadiness = await proveApiServerReadiness({
-    desired,
-    apiServerKey: secrets.hermesApiServer,
-  });
+  const { gateway, gatewayReadback, apiServerReadiness } =
+    await startProvenNativeGateway({
+      desired,
+      runtimeConfig,
+      secrets,
+    });
   return {
     ...provisioned,
     hermesOutput: `${provisioned.hermesOutput}\n${doctor.stdout}`,

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

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

@@ -278,7 +278,7 @@ function validateDesired(desired) {
     desired.serviceCredentialGeneration < 1 ||
     desired.hermesCli !== "hermes" ||
     desired.hermesVersion !== "0.18.0" ||
-    desired.installerPackage !== "@sellable/install@0.1.600" ||
+    desired.installerPackage !== "@sellable/install@0.1.602" ||
     desired.mcpPackage !== "@sellable/mcp@0.1.860" ||
     !Array.isArray(desired.toolInclude) ||
     desired.toolInclude.length === 0 ||
@@ -2298,6 +2298,7 @@ export async function materializeAgentProfile(input = {}) {
 
 export const NATIVE_SLACK_CUSTOMER_PROFILE_INVENTORY = Object.freeze([
   ".env",
+  ".no-bundled-skills",
   "agent-profile.json",
   "config.yaml",
   "shell-hooks-allowlist.json",
@@ -2538,6 +2539,10 @@ function nativeSlackCustomerFiles(desired, soulBytes = desired.soul) {
   };
   return {
     ".env": "",
+    // The runtime materializer owns this profile's exact skill bytes. Avoid
+    // Hermes re-scanning and re-copying its entire bundled catalog on every
+    // cold gateway start; explicit materialization remains the update path.
+    ".no-bundled-skills": "",
     "config.yaml": `${JSON.stringify(config, null, 2)}\n`,
     "shell-hooks-allowlist.json": HERMES_SNAPSHOT_HOOK_ALLOWLIST_BYTES,
     "sellable/mcp.json": `${JSON.stringify(mcp, null, 2)}\n`,
@@ -2734,6 +2739,25 @@ export function materializeNativeSlackCustomerProfile({
           extraProfiles: extraProfiles.sort(),
         };
       }
+      if (existsSync(activeRoot)) {
+        if (lstatSync(activeRoot).isSymbolicLink()) {
+          throw new Error("active profile symlink rejected");
+        }
+        repointInternalCronProfileReferences(desired, activeRoot);
+        const reusable = validateNativeSlackCustomerProfile({
+          desired,
+          profileRoot: activeRoot,
+        });
+        if (reusable.ok) {
+          return {
+            ok: true,
+            status: "REUSED",
+            profileId: desired.profileId,
+            profileDigest: reusable.manifest.profileDigest,
+            observedSoulRawSha256: reusable.observedSoulRawSha256,
+          };
+        }
+      }
       const desiredSeedBytes = Object.values(
         nativeSlackCustomerFiles(desired)
       ).reduce(

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.600";
+export const PINNED_INSTALL_PACKAGE = "@sellable/install@0.1.602";
 export const PINNED_MCP_PACKAGE = "@sellable/mcp@0.1.860";
 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.600",
+  "version": "0.1.602",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code, Codex, and Hermes",
   "bin": {