@sellable/install 0.1.593-wip.runtime-gates.20260811041542 → 0.1.593

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.593-wip.runtime-gates.20260811041542
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.593
 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.593-wip.runtime-gates.20260811041542" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.593" \
     && 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.593-wip.runtime-gates.2
     && 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.593-wip.runtime-gates.20260811041542' || 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.592' || 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.593-wip.runtime-gates.20260811041542', 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.593', 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.593-wip.runtime-gates.20260811041542` is
+`@sellable/install@0.1.593` is
 published:
 
 ```sh
 docker build --platform linux/amd64 \
   --build-arg INSTALLER_INTEGRITY='sha512-…' \
-  --tag sellable-agent-host:0.1.593-wip.runtime-gates.20260811041542 .
+  --tag sellable-agent-host:0.1.592 .
 ```
 
 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

@@ -41,6 +41,7 @@ import {
   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 {
   claimWithSoulObservation,
@@ -1181,6 +1182,28 @@ async function consumeRuntimeSecrets({ claim, exchange, client }) {
   return { mcpService, slackApp, slackBot, modelCodex };
 }
 
+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 adminProfileFactoryAuthJson(model) {
   if (model.value.schemaVersion !== "sellable-agent-model-auth-runtime/v3") {
     return model.hermesRootAuthJson;
@@ -1326,6 +1349,7 @@ function installRuntimeSecrets({ claim, secrets, desiredLifecycle }) {
     slackSecretFile,
     `SLACK_BOT_TOKEN=${secrets.slackBot}\nSLACK_APP_TOKEN=${secrets.slackApp}\n`
   );
+  const runtimeGates = writeAdminRuntimeGates(desiredLifecycle);
   const productConfigPath = join(SECRET_ROOT, "sellable-config.json");
   atomicPrivateFile(
     productConfigPath,
@@ -1344,6 +1368,7 @@ function installRuntimeSecrets({ claim, secrets, desiredLifecycle }) {
     modelAuthState,
     modelConfig: modelAuthConfigOverlay(model),
     productConfigPath,
+    runtimeGates,
     slackSecretFile,
   };
 }
@@ -1528,6 +1553,7 @@ function clearRuntimeSecrets() {
     "slack-app",
     "slack-bot",
     "profile-slack.env",
+    "gates.json",
     "sellable-config.json",
   ]) {
     rmSync(join(SECRET_ROOT, name), { force: true });
@@ -2088,6 +2114,7 @@ function completionReceipt({
   observedLifecycle,
   memorySnapshot,
   modelAuth,
+  runtimeGates,
 }) {
   const identity = operationIdentity(claim, exchange);
   const routeGenerationDigest = flyRuntimeDigest(
@@ -2135,7 +2162,9 @@ function completionReceipt({
     package: sha256(JSON.stringify(packageSpecs())),
     config: operation.profileContract.digest,
     content: observedProfileDigest,
-    process: sha256(JSON.stringify({ servers: profile.servers, modelAuth })),
+    process: sha256(
+      JSON.stringify({ servers: profile.servers, modelAuth, runtimeGates })
+    ),
   };
   return {
     ...identity,
@@ -2163,6 +2192,7 @@ function completionReceipt({
             : "MODEL_AUTH_DESIRED_PENDING_START",
         status: "TRUE",
       },
+      { code: "RUNTIME_GATES_PROVEN", status: "TRUE" },
       { code: "SLACK_TRAFFIC_DISABLED", status: "TRUE" },
       { code: "NO_BOOT_INSTALL", status: "TRUE" },
     ],
@@ -2533,6 +2563,7 @@ export async function runAdminCanary() {
     },
   };
   const agentServiceEnvironment = adminAgentServiceEnvironment(canaryClaim);
+  const runtimeGates = writeAdminRuntimeGates("ON");
 
   const template = JSON.parse(readFileSync(ADMIN_PROFILE_TEMPLATE_PATH));
   const { contentDigest, ...templateContent } = template;
@@ -2730,6 +2761,7 @@ export async function runAdminCanary() {
     profileFactory: "stageAdminProfile",
     profileDigest: profileContract.digest,
     servers: profile.servers,
+    runtimeGates,
     workspaceAuthority: {
       agentKind: canaryClaim.agentKind,
       workspaceLockPresent:
@@ -3155,6 +3187,7 @@ async function runAdminProduction() {
         observedLifecycle: desiredLifecycle,
         memorySnapshot,
         modelAuth,
+        runtimeGates: installed.runtimeGates,
       });
       operationHeartbeat.assertHealthy();
       const candidateLaunch =

package/lib/sellable-agent/fly-admin-image/start-admin-runtime

@@ -7,7 +7,7 @@ install -d -o hermes -g hermes -m 0700 \
   /opt/data/profiles \
   /run/sellable-agent \
   /run/sellable-agent/admin-runtime
-chown hermes:hermes /opt/data
+chown -R hermes:hermes /opt/data
 chmod 0700 /opt/data
 
 if [ -f /run/secrets/sellable-admin-recovery-private-key.pem ]; then

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.593-wip.runtime-gates.20260811041542
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.593
 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.593-wip.runtime-gates.20260811041542";
+  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.593";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.860";
 
@@ -217,6 +217,13 @@ export function customerRuntimeDoctorFailureCode(
   return null;
 }
 
+export function customerRuntimeDoctorRequired(action) {
+  // START already proves the binaries, Slack identities, gateway, and private
+  // API directly below. The broad interactive diagnostic belongs to REFRESH;
+  // running it on every boot caused five-minute timeout/retry storms.
+  return action !== "ENABLE_GATEWAY";
+}
+
 function exactArtifact(claim, type) {
   const artifacts = claim?.revision?.artifacts?.filter(
     (artifact) =>
@@ -1838,6 +1845,13 @@ function writeRuntimeHermesConfig({
       },
     },
   });
+  const gatesPath = join(secretRoot, "gates.json");
+  atomicJson(gatesPath, {
+    lifecycle: modelLifecycle,
+    dispatch: modelLifecycle === "ON" ? "ENABLED" : "DISABLED",
+    route: modelLifecycle === "ON" ? "OPEN" : "CLOSED",
+    output: modelLifecycle === "ON" ? "OPEN" : "CLOSED",
+  });
   atomicJson(join(runtimeConfigRoot, "runtime-identity.json"), {
     runtimeId: RUNTIME_ID,
     profileId: desired.profileId,
@@ -1858,6 +1872,7 @@ function writeRuntimeHermesConfig({
     runtimeHome: runtimeConfigRoot,
     runtimeConfigPath,
     runtimeMcpPath,
+    gatesPath,
     modelBundlePath,
     hermesRootAuthStorePath,
     hermesRootAuthMarkerPath,
@@ -1958,6 +1973,7 @@ export function applicationRuntimeEnv({ desired, runtimeConfig, secrets }) {
     HERMES_CONFIG_PATH: runtimeConfig.runtimeConfigPath,
     CODEX_HOME: dirname(runtimeConfig.modelBundlePath),
     SELLABLE_AGENT_RUNTIME: "1",
+    SELLABLE_AGENT_RUNTIME_GATE_FILE: runtimeConfig.gatesPath,
     SELLABLE_AGENT_TURN_DESCRIPTOR_PATH: runtimeConfig.turnDescriptorPath,
     SLACK_HOME_CHANNEL: desired.defaultChannelId,
     SLACK_ALLOWED_CHANNELS: desired.selectedChannelIds.join(","),
@@ -2311,6 +2327,7 @@ async function proveProvisionedApplication({
 }
 
 async function proveApplication({
+  action,
   desired,
   runtimeConfig,
   secrets,
@@ -2323,10 +2340,18 @@ async function proveApplication({
     profileDigest,
   });
   const runtimeEnv = applicationRuntimeEnv({ desired, runtimeConfig, secrets });
-  const doctor = await run(HERMES, ["doctor"], {
-    env: runtimeEnv,
-    timeoutMs: 300_000,
-  });
+  const doctor = customerRuntimeDoctorRequired(action)
+    ? await run(HERMES, ["doctor"], {
+        env: runtimeEnv,
+        timeoutMs: 300_000,
+      })
+    : {
+        status: 0,
+        stdout: "Hermes START readiness uses direct runtime checks.",
+        stderr: "",
+        timedOut: false,
+        elapsedMs: 0,
+      };
   const doctorFailure = customerRuntimeDoctorFailureCode(doctor);
   if (doctorFailure) throw new Error(doctorFailure);
   const slackResponse = await fetch(`${slackApiOrigin()}/api/auth.test`, {
@@ -2599,6 +2624,7 @@ async function processOperation({ claim, exchange, client, identity }) {
       ? proveProvisionedApplication
       : proveApplication;
   const proof = await prove({
+    action: claim.operation.action,
     desired,
     runtimeConfig,
     secrets,

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

@@ -388,6 +388,7 @@ export function buildNativeHermesLaunch({
       HERMES_PROFILE: profileId,
       HERMES_CONFIG_PATH: configPath,
       SELLABLE_AGENT_RUNTIME: "1",
+      SELLABLE_AGENT_RUNTIME_GATE_FILE: join(resolvedSecretsRoot, "gates.json"),
       SELLABLE_SLACK_APP_TOKEN_FD: "8",
       SELLABLE_SLACK_BOT_TOKEN_FD: "9",
     }),

package/lib/sellable-agent/fly-runtime-identity.mjs

@@ -1088,7 +1088,8 @@ export function createFlyCustomerControlClient({
       return post(
         "heartbeat",
         "/api/v3/sellable-agent/worker/heartbeat",
-        identityBody
+        identityBody,
+        { replaySafe: true }
       );
     },
     async claimEndpoint(leaseSeconds = 60) {

package/lib/sellable-agent/hermes-bridge.mjs

@@ -306,6 +306,17 @@ def _sellable_agent_call_meta():
         # identity. Send no actor meta; the serving API enforces its own actor
         # gates, as with installs outside the Sellable runtime.
         return None
+    import json
+    gate_path = os.getenv("SELLABLE_AGENT_RUNTIME_GATE_FILE", "")
+    if not gate_path.startswith("/"):
+        raise RuntimeError("Sellable runtime gate path is not pinned")
+    try:
+        with open(gate_path, "r", encoding="utf-8") as gate_file:
+            gates = json.load(gate_file)
+    except (OSError, ValueError) as exc:
+        raise RuntimeError("Sellable runtime gates are unavailable") from exc
+    if gates != {"lifecycle": "ON", "dispatch": "ENABLED", "route": "OPEN", "output": "OPEN"}:
+        raise RuntimeError("Sellable runtime dispatch is fenced")
     from gateway.session_context import get_session_env, session_context_engaged
     if not session_context_engaged():
         raise RuntimeError("Sellable MCP calls require an active Hermes session context")
@@ -594,6 +605,17 @@ def _sellable_agent_call_meta():
         # identity. Send no actor meta; the serving API enforces its own actor
         # gates, as with installs outside the Sellable runtime.
         return None
+    import json
+    gate_path = os.getenv("SELLABLE_AGENT_RUNTIME_GATE_FILE", "")
+    if not gate_path.startswith("/"):
+        raise RuntimeError("Sellable runtime gate path is not pinned")
+    try:
+        with open(gate_path, "r", encoding="utf-8") as gate_file:
+            gates = json.load(gate_file)
+    except (OSError, ValueError) as exc:
+        raise RuntimeError("Sellable runtime gates are unavailable") from exc
+    if gates != {"lifecycle": "ON", "dispatch": "ENABLED", "route": "OPEN", "output": "OPEN"}:
+        raise RuntimeError("Sellable runtime dispatch is fenced")
     from gateway.session_context import get_session_env, session_context_engaged
     if not session_context_engaged():
         raise RuntimeError("Sellable MCP calls require an active Hermes session context")

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

@@ -38,8 +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.593-wip.runtime-gates.20260811041542";
+const INSTALLER_PACKAGE = "@sellable/install@0.1.593";
 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.593-wip.runtime-gates.20260811041542" ||
+      pinned.installerPackage !== "@sellable/install@0.1.593" ||
       pinned.mcpPackage !== "@sellable/mcp@0.1.860" ||
       !Array.isArray(policy.toolInclude) ||
       policy.toolInclude.length === 0 ||
@@ -2122,6 +2122,12 @@ export function createLocalPinnedActionPorts(config, dependencies = {}) {
       await helper({ action: "VERIFY_HERMES_BRIDGE", ...helperIdentity() });
     return helper({ action: "CONTROL_RUNTIME", ...helperIdentity(), control });
   };
+  const setRuntimeLifecycle = (lifecycle) =>
+    helper({
+      action: "SET_RUNTIME_GATES",
+      ...helperIdentity(),
+      lifecycle,
+    });
   const observeRuntimeLifecycle = (lifecycle) =>
     helper({
       action: "OBSERVE_RUNTIME_LIFECYCLE",
@@ -2562,13 +2568,10 @@ export function createLocalPinnedActionPorts(config, dependencies = {}) {
   });
   Object.assign(ports.lifecycle, {
     async fenceDispatch() {
-      // Lifecycle authority is the service itself. Stopping it closes dispatch
-      // without introducing a second file-backed switch that can strand an
-      // otherwise healthy runtime.
-      await controlRuntime("DOWN");
+      await setRuntimeLifecycle("OFF");
     },
     async fenceRouteOutput() {
-      await controlRuntime("DOWN");
+      await setRuntimeLifecycle("ARCHIVED");
     },
     async drain() {
       await controlRuntime("DOWN");
@@ -2588,6 +2591,7 @@ export function createLocalPinnedActionPorts(config, dependencies = {}) {
       return observed;
     },
     async startGateway() {
+      await setRuntimeLifecycle("ON");
       await controlRuntime("UP");
       await observeRuntimeLifecycle("ON");
     },
@@ -2597,6 +2601,7 @@ export function createLocalPinnedActionPorts(config, dependencies = {}) {
           ? "ARCHIVING"
           : "OFF";
       await controlRuntime("DOWN");
+      await setRuntimeLifecycle(lifecycle);
       await observeRuntimeLifecycle(lifecycle);
     },
     async proveNoDispatch() {
@@ -2604,7 +2609,9 @@ export function createLocalPinnedActionPorts(config, dependencies = {}) {
         context.activeClaim.operation.action === "ARCHIVE" ? "ARCHIVED" : "OFF";
       const observed = await observeRuntimeLifecycle(lifecycle);
       return {
-        noDispatch: observed.process.ready === false,
+        noDispatch:
+          observed.gates.dispatch === "FENCED" &&
+          observed.process.ready === false,
       };
     },
     async observeGateway(input) {
@@ -2621,6 +2628,7 @@ export function createLocalPinnedActionPorts(config, dependencies = {}) {
         revisionId: observed.revisionId,
         credentialGeneration: observed.credentialGeneration,
         profileDigest: observed.profileDigest,
+        gates: observed.gates,
         secretsPresent: observed.secretsPresent,
         process: observed.process,
         runtimeObservation: observed.runtimeObservation,
@@ -2671,6 +2679,7 @@ export function createLocalPinnedActionPorts(config, dependencies = {}) {
       };
     },
     async rollback({ priorState }) {
+      await setRuntimeLifecycle(priorState.observedLifecycle);
       if (priorState.observedLifecycle === "ON") await controlRuntime("UP");
       else await controlRuntime("DOWN");
       await observeRuntimeLifecycle(priorState.observedLifecycle);
@@ -2679,35 +2688,21 @@ export function createLocalPinnedActionPorts(config, dependencies = {}) {
       try {
         const evidence = {};
         const confirmedSteps = [];
-        // Older progress receipts name this step FENCE_ROUTE_OUTPUT. Its
-        // concrete proof is now the stopped service, not a gates.json file.
-        // Preserve the step identity so an in-flight archive can resume across
-        // this runtime upgrade.
-        let stopped;
+        let gates;
         try {
-          stopped = await observeRuntimeLifecycle("ARCHIVING");
+          gates = await helper({
+            action: "OBSERVE_RUNTIME_GATES",
+            ...helperIdentity(),
+            lifecycle: "ARCHIVED",
+          });
         } catch {
-          try {
-            stopped = await observeRuntimeLifecycle("ARCHIVED");
-          } catch {
-            return {
-              ok: true,
-              observationId: `archive_${canonicalHostWorkerDigest({ service: "not_stopped" })}`,
-              confirmedSteps,
-            };
-          }
-        }
-        evidence.service = {
-          lifecycle: stopped.lifecycle,
-          processReady: stopped.process?.ready,
-        };
-        if (stopped.process?.ready !== false) {
           return {
             ok: true,
-            observationId: `archive_${canonicalHostWorkerDigest(evidence)}`,
+            observationId: `archive_${canonicalHostWorkerDigest({ gates: "not_confirmed" })}`,
             confirmedSteps,
           };
         }
+        evidence.gates = gates.gates;
         confirmedSteps.push("FENCE_ROUTE_OUTPUT");
         let drain;
         try {

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

@@ -277,7 +277,7 @@ function validateDesired(desired) {
     desired.serviceCredentialGeneration < 1 ||
     desired.hermesCli !== "hermes" ||
     desired.hermesVersion !== "0.18.0" ||
-    desired.installerPackage !== "@sellable/install@0.1.593-wip.runtime-gates.20260811041542" ||
+    desired.installerPackage !== "@sellable/install@0.1.593" ||
     desired.mcpPackage !== "@sellable/mcp@0.1.860" ||
     !Array.isArray(desired.toolInclude) ||
     desired.toolInclude.length === 0 ||

package/lib/sellable-agent/provisioning-adapter.mjs

@@ -25,8 +25,11 @@ 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.593-wip.runtime-gates.20260811041542";
+export const PINNED_INSTALL_PACKAGE = "@sellable/install@0.1.593";
 export const PINNED_MCP_PACKAGE = "@sellable/mcp@0.1.860";
+const PINNED_INSTALL_VERSION = PINNED_INSTALL_PACKAGE.slice(
+  PINNED_INSTALL_PACKAGE.lastIndexOf("@") + 1
+);
 
 export function deriveAgentProfileId(workspaceId, agentId, hostId) {
   return deriveContainedProfileId(workspaceId, agentId, hostId);
@@ -611,7 +614,7 @@ function inspectProvisionedProfile({
       !matchesReadback(manifest, request) ||
       manifest.serviceCredentialReference !== serviceCredentialReference ||
       manifest.installerPackage !== PINNED_INSTALL_PACKAGE ||
-      manifest.installerVersion !== "0.1.593-wip.runtime-gates.20260811041542" ||
+      manifest.installerVersion !== PINNED_INSTALL_VERSION ||
       manifest.mcpPackage !== PINNED_MCP_PACKAGE ||
       manifest.credentialKeyVersion !== credentialKeyVersion ||
       !/^[a-f0-9]{16}$/.test(manifest.credentialFingerprint) ||
@@ -825,7 +828,7 @@ function successReceipt({
     subject: `agent-profile:${observed.profileId}`,
     cli: {
       installPackage: PINNED_INSTALL_PACKAGE,
-      installVersion: "0.1.593-wip.runtime-gates.20260811041542",
+      installVersion: PINNED_INSTALL_VERSION,
       mcpPackage: PINNED_MCP_PACKAGE,
       command: "hermes profile bootstrap",
     },
@@ -873,7 +876,7 @@ function failure(code, stages, extra = {}, request = null) {
       : "agent-profile:unbound",
     cli: {
       installPackage: PINNED_INSTALL_PACKAGE,
-      installVersion: "0.1.593-wip.runtime-gates.20260811041542",
+      installVersion: PINNED_INSTALL_VERSION,
       mcpPackage: PINNED_MCP_PACKAGE,
       command: "hermes profile bootstrap",
     },

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

@@ -276,6 +276,7 @@ function runtimeEnvironment(contract) {
     SLACK_ALLOWED_USERS: contract.memberAllowlist.join(","),
     SLACK_REQUIRE_MENTION: "true",
     SELLABLE_AGENT_RUNTIME: "1",
+    SELLABLE_AGENT_RUNTIME_GATE_FILE: "/runtime/gates.json",
     SELLABLE_AGENT_RUNTIME_UID: String(contract.runtime.uid),
     SELLABLE_AGENT_RUNTIME_GID: String(contract.runtime.gid),
     SELLABLE_AGENT_HERMES_EXECUTABLE: contract.paths.hermesExecutablePath,

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

@@ -54,6 +54,8 @@ const ACTIONS = new Set([
   "INSTALL_MCP_CREDENTIAL",
   "INSTALL_PROVIDER_CREDENTIAL",
   "INSTALL_RUNTIME_SERVICE_ENV",
+  "SET_RUNTIME_GATES",
+  "OBSERVE_RUNTIME_GATES",
   "OBSERVE_RUNTIME_LIFECYCLE",
   "CLEAN_PROFILE_SECRETS",
   "CHOWN_PROFILE",
@@ -101,6 +103,20 @@ const ACTION_KEYS = Object.freeze({
     "revisionId",
     "profileDigest",
   ],
+  SET_RUNTIME_GATES: [
+    "action",
+    "profileId",
+    "operationId",
+    "fence",
+    "lifecycle",
+  ],
+  OBSERVE_RUNTIME_GATES: [
+    "action",
+    "profileId",
+    "operationId",
+    "fence",
+    "lifecycle",
+  ],
   OBSERVE_RUNTIME_LIFECYCLE: [
     "action",
     "profileId",
@@ -765,6 +781,7 @@ function runtimeServiceEnvironmentValues({
       SELLABLE_AGENT_POLICY_HASH: manifest.policyHash,
       SELLABLE_AGENT_PROFILE_ID: profileId,
       SELLABLE_AGENT_RUNTIME_ENV_LOADED: "1",
+      SELLABLE_AGENT_RUNTIME_GATE_FILE: "/runtime/gates.json",
       SELLABLE_AGENT_RUNTIME_SECRET_ROOT: mcpRoot,
       SELLABLE_AGENT_SELECTED_CHANNEL_IDS: JSON.stringify(
         manifest.slackChannelIds
@@ -787,6 +804,56 @@ function runtimeServiceEnvironmentValues({
   };
 }
 
+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)) {
+    return {
+      lifecycle: "ARCHIVED",
+      dispatch: "FENCED",
+      route: "FENCED",
+      output: "FENCED",
+    };
+  }
+  throw new Error("runtime lifecycle rejected");
+}
+
+function writeRuntimeGates(profile, lifecycle) {
+  const root = safeRuntimeStateRoot(profile);
+  const gates = expectedRuntimeGates(lifecycle);
+  const pathValue = join(root, "gates.json");
+  atomicCredential(
+    pathValue,
+    JSON.stringify(gates),
+    profile.runtimeUid,
+    profile.runtimeGid
+  );
+  const parsed = JSON.parse(readFileSync(pathValue, "utf8"));
+  if (stableJson(parsed) !== stableJson(gates))
+    throw new Error("runtime gates readback rejected");
+  return { path: pathValue, gates };
+}
+
+function observeRuntimeGates(profile, lifecycle) {
+  const root = safeRuntimeStateRoot(profile);
+  const pathValue = join(root, "gates.json");
+  const link = lstatSync(pathValue);
+  const parsed = JSON.parse(readFileSync(pathValue, "utf8"));
+  const expected = expectedRuntimeGates(lifecycle);
+  if (
+    link.isSymbolicLink() ||
+    !link.isFile() ||
+    link.uid !== profile.runtimeUid ||
+    link.gid !== profile.runtimeGid ||
+    (link.mode & 0o777) !== 0o600 ||
+    stableJson(parsed) !== stableJson(expected)
+  )
+    throw new Error("runtime gates observation rejected");
+  return { path: pathValue, gates: parsed };
+}
+
 function safePinnedFile(pathValue, label) {
   const resolved = resolve(pathValue ?? "");
   if (!isAbsolute(resolved) || !existsSync(resolved))
@@ -1358,6 +1425,7 @@ function installRuntimeServiceEnvironment(profile, request) {
   if (!existsSync(target)) throw new Error("active profile absent");
   const manifest = validateActiveManifest(target, request, profile);
   const runtimeStateRoot = safeRuntimeStateRoot(profile);
+  writeRuntimeGates(profile, "ON");
   const { paths, values } = runtimeServiceEnvironmentValues({
     profile,
     profileId: request.profileId,
@@ -1912,6 +1980,15 @@ export async function runRuntimeHelperRequest({ requestPath, config }) {
     if (request.action === "INSTALL_RUNTIME_SERVICE_ENV") {
       return installRuntimeServiceEnvironment(profile, request);
     }
+    if (request.action === "SET_RUNTIME_GATES") {
+      const written = writeRuntimeGates(profile, request.lifecycle);
+      return {
+        ok: true,
+        profileId: request.profileId,
+        lifecycle: request.lifecycle,
+        ...written,
+      };
+    }
     if (request.action === "CLEAN_PROFILE_SECRETS") {
       for (const configured of [
         profile.workerRuntimeSecretRoot,
@@ -2001,7 +2078,12 @@ export async function runRuntimeHelperRequest({ requestPath, config }) {
     if (["OBSERVE_RUNTIME", "OBSERVE_RUNTIME_DRIFT"].includes(request.action)) {
       return { ok: true, observation: await observeRuntime(profile, request) };
     }
+    if (request.action === "OBSERVE_RUNTIME_GATES") {
+      const observed = observeRuntimeGates(profile, request.lifecycle);
+      return { ok: true, profileId: request.profileId, ...observed };
+    }
     if (request.action === "OBSERVE_RUNTIME_LIFECYCLE") {
+      const gateObservation = observeRuntimeGates(profile, request.lifecycle);
       const { target } = profileTarget(
         profile,
         { ...request, slot: "ACTIVE" },
@@ -2034,6 +2116,7 @@ export async function runRuntimeHelperRequest({ requestPath, config }) {
           revisionId: observation.revisionId,
           credentialGeneration: observation.serviceCredential.generation,
           profileDigest: observation.profileDigest,
+          gates: gateObservation.gates,
           secretsPresent,
           process: observation.process,
           runtimeObservation: observation,
@@ -2066,6 +2149,7 @@ export async function runRuntimeHelperRequest({ requestPath, config }) {
         revisionId: manifest.revisionId,
         credentialGeneration: manifest.serviceCredentialGeneration,
         profileDigest: manifest.profileDigest,
+        gates: gateObservation.gates,
         secretsPresent,
         process: {
           ready: false,

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

@@ -502,12 +502,29 @@ function finalizeSuccess(state, operation, status) {
 }
 
 function observationMatches(observation, operation, lifecycle) {
+  const expectedGates =
+    lifecycle === "ON"
+      ? { lifecycle: "ON", dispatch: "ENABLED", route: "OPEN", output: "OPEN" }
+      : lifecycle === "OFF"
+        ? {
+            lifecycle: "OFF",
+            dispatch: "FENCED",
+            route: "OPEN",
+            output: "OPEN",
+          }
+        : {
+            lifecycle: "ARCHIVED",
+            dispatch: "FENCED",
+            route: "FENCED",
+            output: "FENCED",
+          };
   return Boolean(
     observation &&
       observation.lifecycle === lifecycle &&
       observation.revisionId === operation.targetRevisionId &&
       observation.credentialGeneration === operation.credentialGeneration &&
       observation.profileDigest === operation.profileDigest &&
+      stableJson(observation.gates) === stableJson(expectedGates) &&
       observation.secretsPresent === (lifecycle !== "ARCHIVED") &&
       observation.process &&
       observation.process.ready === (lifecycle === "ON") &&

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/install",
-  "version": "0.1.593-wip.runtime-gates.20260811041542",
+  "version": "0.1.593",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code, Codex, and Hermes",
   "bin": {