@sellable/install 0.1.467 → 0.1.469

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.467
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.469
 ARG MCP_PACKAGE=@sellable/mcp@0.1.760-wip.phase143.20260727100513
 ARG INSTALLER_INTEGRITY
 ARG MCP_INTEGRITY=sha512-muNXHuRnLTfsnW+MQUvK+p0VBZETDKeevr70iRliXyqE3/SLrZQJLL1laJzMo+qiUs9jMXMHdKOQfQqLiwJvtg==
 
-RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.467" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.469" \
     && test "${MCP_PACKAGE}" = "@sellable/mcp@0.1.760-wip.phase143.20260727100513" \
     && 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.467" \
     && 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.467' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.760-wip.phase143.20260727100513') 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.469' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.760-wip.phase143.20260727100513') 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.467', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.760-wip.phase143.20260727100513', 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.469', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.760-wip.phase143.20260727100513', 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.467` is
+`@sellable/install@0.1.469` is
 published:
 
 ```sh
 docker build --platform linux/amd64 \
   --build-arg INSTALLER_INTEGRITY='sha512-…' \
-  --tag sellable-agent-host:0.1.467 .
+  --tag sellable-agent-host:0.1.469 .
 ```
 
 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/admin-runtime.mjs

@@ -42,9 +42,10 @@ import {
   parseFlyCustomerModelCredential,
 } from "../admin-artifact/node_modules/@sellable/install/lib/sellable-agent/fly-customer-model.mjs";
 import {
-  buildAgentServiceEnvironment,
+  buildAdminAgentServiceEnvironment,
   buildNativeHermesLaunch,
 } from "../admin-artifact/node_modules/@sellable/install/lib/sellable-agent/fly-customer-worker.mjs";
+import { expectedRuntimeGates } from "../admin-artifact/node_modules/@sellable/install/lib/sellable-agent/runtime-helper.mjs";
 import sodium from "../admin-artifact/node_modules/libsodium-wrappers/dist/modules-esm/libsodium-wrappers.mjs";
 import {
   createFlyCustomerControlClient,
@@ -895,7 +896,29 @@ async function consumeRuntimeSecrets({ claim, exchange, client }) {
   return { mcpService, slackApp, slackBot, modelCodex };
 }
 
-function installRuntimeSecrets({ claim, secrets }) {
+function writeAdminRuntimeGates(desiredLifecycle) {
+  const gates = expectedRuntimeGates(desiredLifecycle);
+  const path = join(SECRET_ROOT, "gates.json");
+  atomicPrivateFile(path, `${JSON.stringify(gates)}\n`);
+  const stat = lstatSync(path);
+  let observed;
+  try {
+    observed = JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    throw new Error("admin_runtime_gates_rejected");
+  }
+  if (
+    stat.isSymbolicLink() ||
+    !stat.isFile() ||
+    (stat.mode & 0o777) !== 0o600 ||
+    canonicalJson(observed) !== canonicalJson(gates)
+  ) {
+    throw new Error("admin_runtime_gates_rejected");
+  }
+  return Object.freeze({ ...observed });
+}
+
+function installRuntimeSecrets({ claim, secrets, desiredLifecycle }) {
   privateDirectory(SECRET_ROOT);
   const modelAuthority = claim?.runtimeContract?.model;
   const modelEnvelope = claim?.secretEnvelopes?.modelCodex;
@@ -988,15 +1011,7 @@ function installRuntimeSecrets({ claim, secrets }) {
     slackSecretFile,
     `SLACK_BOT_TOKEN=${secrets.slackBot}\nSLACK_APP_TOKEN=${secrets.slackApp}\n`
   );
-  atomicPrivateFile(
-    join(SECRET_ROOT, "gates.json"),
-    `${JSON.stringify({
-      workspaceId: claim.operation.workspaceId,
-      agentId: claim.operation.agentId,
-      revisionId: claim.operation.targetRevisionId,
-      fence: claim.operation.fence,
-    })}\n`
-  );
+  const runtimeGates = writeAdminRuntimeGates(desiredLifecycle);
   const productConfigPath = join(SECRET_ROOT, "sellable-config.json");
   atomicPrivateFile(
     productConfigPath,
@@ -1010,6 +1025,7 @@ function installRuntimeSecrets({ claim, secrets }) {
   return {
     rootAuthPath,
     productConfigPath,
+    runtimeGates,
     slackSecretFile,
   };
 }
@@ -1090,7 +1106,14 @@ function adminAgentServiceEnvironment(claim) {
   const service = claim?.runtimeContract?.service;
   const bindings = claim?.runtimeContract?.slack?.selectedBindings;
   const toolInclude = service?.toolInclude;
+  // The operation lease fence and immutable Admin-generation fence are
+  // independent CAS domains. The broker already loads the generation through
+  // operation.adminRuntimeGenerationId and binds it to this workspace/agent.
   if (
+    claim?.agentKind !== "ADMIN" ||
+    claim?.adminRuntimeGeneration?.agentKind !== "ADMIN" ||
+    claim.adminRuntimeGeneration.workspaceId !== operation?.workspaceId ||
+    claim.adminRuntimeGeneration.agentId !== operation?.agentId ||
     !operation ||
     !service ||
     !/^[A-Za-z0-9_-]{1,128}$/.test(service.principalId ?? "") ||
@@ -1109,7 +1132,8 @@ function adminAgentServiceEnvironment(claim) {
   ) {
     throw new Error("admin_runtime_agent_service_environment_rejected");
   }
-  return buildAgentServiceEnvironment({
+  return buildAdminAgentServiceEnvironment({
+    agentKind: claim.agentKind,
     workspaceId: operation.workspaceId,
     agentId: operation.agentId,
     serviceCredentialGeneration: service.credentialGeneration,
@@ -1624,6 +1648,7 @@ function completionReceipt({
   observedLifecycle,
   memorySnapshot,
   modelAuth,
+  runtimeGates,
 }) {
   const identity = operationIdentity(claim, exchange);
   const routeGenerationDigest = flyRuntimeDigest(
@@ -1662,7 +1687,9 @@ function completionReceipt({
     package: sha256(JSON.stringify(packageSpecs())),
     config: operation.profileContract.digest,
     content: operation.profileContract.digest,
-    process: sha256(JSON.stringify({ servers: profile.servers, modelAuth })),
+    process: sha256(
+      JSON.stringify({ servers: profile.servers, modelAuth, runtimeGates })
+    ),
   };
   return {
     ...identity,
@@ -1684,6 +1711,7 @@ function completionReceipt({
       { code: "SETTINGS_GENERATION_PROVEN", status: "TRUE" },
       { code: "RECOVERY_GENERATION_PROVEN", status: "TRUE" },
       { code: "MODEL_AUTH_PROVEN", status: "TRUE" },
+      { code: "RUNTIME_GATES_PROVEN", status: "TRUE" },
       { code: "SLACK_TRAFFIC_DISABLED", status: "TRUE" },
       { code: "NO_BOOT_INSTALL", status: "TRUE" },
     ],
@@ -1927,6 +1955,33 @@ export async function runAdminCanary() {
       workspaceId: fixtureWorkspaceId,
     })}\n`
   );
+  const canaryClaim = {
+    agentKind: "ADMIN",
+    adminRuntimeGeneration: {
+      agentKind: "ADMIN",
+      workspaceId: fixtureWorkspaceId,
+      agentId: fixtureAgentId,
+      fence: "phase158-canary-generation-fence-a",
+    },
+    operation: {
+      workspaceId: fixtureWorkspaceId,
+      agentId: fixtureAgentId,
+      fence: "phase158-canary-operation-fence-a",
+    },
+    runtimeContract: {
+      service: {
+        principalId: "phase158-canary-principal",
+        policyHash: "a".repeat(64),
+        toolInclude: ["get_workspace"],
+        credentialGeneration: 1,
+      },
+      slack: {
+        selectedBindings: [{ channelId: "C_PHASE158_CANARY" }],
+      },
+    },
+  };
+  const agentServiceEnvironment = adminAgentServiceEnvironment(canaryClaim);
+  const runtimeGates = writeAdminRuntimeGates("ON");
 
   const template = JSON.parse(readFileSync(ADMIN_PROFILE_TEMPLATE_PATH));
   const { contentDigest, ...templateContent } = template;
@@ -2083,6 +2138,7 @@ export async function runAdminCanary() {
       sha256: sha256(soulBytes),
       byteLength: soulBytes.byteLength,
     },
+    agentServiceEnv: agentServiceEnvironment,
   });
   const modelAuth = proveAdminModelAuth(profile);
   const observedSettings = settingsProof(
@@ -2105,6 +2161,19 @@ export async function runAdminCanary() {
     profileFactory: "stageAdminProfile",
     profileDigest: profileContract.digest,
     servers: profile.servers,
+    runtimeGates,
+    workspaceAuthority: {
+      agentKind: canaryClaim.agentKind,
+      workspaceLockPresent:
+        Object.prototype.hasOwnProperty.call(
+          agentServiceEnvironment,
+          "SELLABLE_LOCK_WORKSPACE_ID"
+        ) ||
+        Object.prototype.hasOwnProperty.call(
+          agentServiceEnvironment,
+          "SELLABLE_REQUIRE_WORKSPACE_LOCK"
+        ),
+    },
     modelAuth,
     settings: observedSettings,
     adminHome: profile.adminHome,
@@ -2309,8 +2378,12 @@ async function runAdminProduction() {
         exchange,
         client,
       });
-      const installed = installRuntimeSecrets({ claim, secrets });
       const desiredLifecycle = desiredLifecycleForClaim(claim);
+      const installed = installRuntimeSecrets({
+        claim,
+        secrets,
+        desiredLifecycle,
+      });
       let operation = await pollDelivery({ identity, exchange });
       let imported;
       let profileContract;
@@ -2434,6 +2507,7 @@ async function runAdminProduction() {
         observedLifecycle: desiredLifecycle,
         memorySnapshot,
         modelAuth,
+        runtimeGates: installed.runtimeGates,
       });
       operationHeartbeat.assertHealthy();
       const candidateLaunch =

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

@@ -5,7 +5,7 @@ USER root
 
 ARG MCP_PACKAGE=@sellable/mcp@0.1.789-wip.phase159.20260729223403
 ARG MCP_INTEGRITY=sha512-KoheQcAQe/c8xzhF3R1ls6nQd11bcQqM3ykOUlzzNX5kykO7rO8RR2KsOvomwMv2Nn5VzvZZx6rGrle/6woKfw==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.467
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.469
 ARG TUS_JS_CLIENT_VERSION=4.3.1
 ARG HERMES_VERSION=0.19.0
 ARG MCP_TRUST_ROOT_B64

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

@@ -69,7 +69,7 @@ const RUNTIME_GENERATION = Number(
 const BOOT_SESSION_ID = randomUUID();
 const HERMES_VERSION = process.env.SELLABLE_AGENT_HERMES_VERSION ?? "0.19.0";
 const INSTALLER_PACKAGE =
-  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.467";
+  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.469";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ??
   "@sellable/mcp@0.1.789-wip.phase159.20260729223403";

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

@@ -66,6 +66,18 @@ export function buildAgentServiceEnvironment({
   });
 }
 
+export function buildAdminAgentServiceEnvironment({ agentKind, ...input }) {
+  if (agentKind !== "ADMIN") {
+    throw new Error("admin_agent_service_environment_rejected");
+  }
+  const {
+    SELLABLE_LOCK_WORKSPACE_ID: _workspaceLock,
+    SELLABLE_REQUIRE_WORKSPACE_LOCK: _workspaceLockRequired,
+    ...environment
+  } = buildAgentServiceEnvironment(input);
+  return Object.freeze(environment);
+}
+
 function exactKeys(value, keys) {
   return Boolean(
     value &&

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.467";
+const INSTALLER_PACKAGE = "@sellable/install@0.1.469";
 const MCP_PACKAGE = "@sellable/mcp@0.1.760-wip.phase143.20260727100513";
 const HERMES_VERSION = "0.18.0";
 const SHA256 = /^[a-f0-9]{64}$/;

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

@@ -1540,7 +1540,7 @@ export function compileClaimToProfileDesired(activeClaim, config) {
       ]) ||
       pinned.hermesCli !== "hermes" ||
       pinned.hermesVersion !== "0.18.0" ||
-      pinned.installerPackage !== "@sellable/install@0.1.467" ||
+      pinned.installerPackage !== "@sellable/install@0.1.469" ||
       pinned.mcpPackage !==
         "@sellable/mcp@0.1.760-wip.phase143.20260727100513" ||
       !Array.isArray(policy.toolInclude) ||

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

@@ -197,7 +197,7 @@ function validateDesired(desired) {
     desired.serviceCredentialGeneration < 1 ||
     desired.hermesCli !== "hermes" ||
     desired.hermesVersion !== "0.18.0" ||
-    desired.installerPackage !== "@sellable/install@0.1.467" ||
+    desired.installerPackage !== "@sellable/install@0.1.469" ||
     desired.mcpPackage !==
       "@sellable/mcp@0.1.760-wip.phase143.20260727100513" ||
     !Array.isArray(desired.toolInclude) ||

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.467";
+export const PINNED_INSTALL_PACKAGE = "@sellable/install@0.1.469";
 export const PINNED_MCP_PACKAGE =
   "@sellable/mcp@0.1.760-wip.phase143.20260727100513";
 
@@ -612,7 +612,7 @@ function inspectProvisionedProfile({
       !matchesReadback(manifest, request) ||
       manifest.serviceCredentialReference !== serviceCredentialReference ||
       manifest.installerPackage !== PINNED_INSTALL_PACKAGE ||
-      manifest.installerVersion !== "0.1.467" ||
+      manifest.installerVersion !== "0.1.469" ||
       manifest.mcpPackage !== PINNED_MCP_PACKAGE ||
       manifest.credentialKeyVersion !== credentialKeyVersion ||
       !/^[a-f0-9]{16}$/.test(manifest.credentialFingerprint) ||
@@ -826,7 +826,7 @@ function successReceipt({
     subject: `agent-profile:${observed.profileId}`,
     cli: {
       installPackage: PINNED_INSTALL_PACKAGE,
-      installVersion: "0.1.467",
+      installVersion: "0.1.469",
       mcpPackage: PINNED_MCP_PACKAGE,
       command: "hermes profile bootstrap",
     },
@@ -874,7 +874,7 @@ function failure(code, stages, extra = {}, request = null) {
       : "agent-profile:unbound",
     cli: {
       installPackage: PINNED_INSTALL_PACKAGE,
-      installVersion: "0.1.467",
+      installVersion: "0.1.469",
       mcpPackage: PINNED_MCP_PACKAGE,
       command: "hermes profile bootstrap",
     },

package/lib/sellable-agent/runtime-helper.mjs

@@ -504,7 +504,7 @@ function runtimeServiceEnvironmentValues({ profile, profileId, manifest, target,
   };
 }
 
-function expectedRuntimeGates(lifecycle) {
+export function expectedRuntimeGates(lifecycle) {
   if (lifecycle === "ON") return { lifecycle, dispatch: "ENABLED", route: "OPEN", output: "OPEN" };
   if (lifecycle === "OFF") return { lifecycle, dispatch: "FENCED", route: "OPEN", output: "OPEN" };
   if (["ARCHIVING", "ARCHIVED"].includes(lifecycle)) {

package/package.json

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