@sellable/install 0.1.607 → 0.1.608-wip.phase188.20260812.1

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.607
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.608-wip.phase188.20260812.1
 ARG MCP_PACKAGE=@sellable/mcp@0.1.864
 ARG INSTALLER_INTEGRITY
 ARG MCP_INTEGRITY=sha512-UevVd71zQL2FgnqYaeHBkTi73iUV0Lg5BchM5JNhUbvaFxAFQ2M1n9uSS18qVuM9Km0aGZ7a0k8M9e2AVPboAw==
 
-RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.607" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.608-wip.phase188.20260812.1" \
     && test "${MCP_PACKAGE}" = "@sellable/mcp@0.1.864" \
     && 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.607" \
     && 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.607-wip.hermes-desktop.20260811160530' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.864') 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.608-wip.phase188.20260812.1' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.864') 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.607', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.864', 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.608-wip.phase188.20260812.1', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.864', 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.607` is
+`@sellable/install@0.1.608-wip.phase188.20260812.1` is
 published:
 
 ```sh
 docker build --platform linux/amd64 \
   --build-arg INSTALLER_INTEGRITY='sha512-…' \
-  --tag sellable-agent-host:0.1.607-wip.hermes-desktop.20260811160530 .
+  --tag sellable-agent-host:0.1.608-wip.phase188.20260812.1-wip.hermes-desktop.20260811160530 .
 ```
 
 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/admin-runtime-reconciler.mjs

@@ -80,6 +80,30 @@ export function validateAdminRuntimeTuple(tuple) {
       };
     }
   }
+  if (tuple.profileContractTemplate !== undefined) {
+    const templatePackages = tuple.profileContractTemplate?.packages;
+    const profilePackageByTupleName = {
+      "@sellable/mcp": templatePackages?.sellable?.mcp,
+      "@sellable/install": templatePackages?.sellable?.install,
+      "@sellable/admin-mcp": templatePackages?.["sellable-admin"]?.mcp,
+      "@sellable/admin-install": templatePackages?.["sellable-admin"]?.install,
+    };
+    for (const name of ADMIN_RUNTIME_TUPLE_MEMBERS) {
+      const tuplePackage = tuple.packages[name];
+      const profilePackage = profilePackageByTupleName[name];
+      if (
+        profilePackage?.name !== tuplePackage.name ||
+        profilePackage?.version !== tuplePackage.version ||
+        profilePackage?.integrity !== tuplePackage.integrity
+      ) {
+        return {
+          ok: false,
+          code: "admin_runtime_tuple_profile_package_mismatch",
+          packageName: name,
+        };
+      }
+    }
+  }
   if (
     !SHA256.test(tuple.lockedTreeDigest ?? "") ||
     !SHA256.test(tuple.artifactDigest ?? "")

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

@@ -6,7 +6,7 @@ USER root
 
 ARG MCP_PACKAGE=@sellable/mcp@0.1.864
 ARG MCP_INTEGRITY=sha512-UevVd71zQL2FgnqYaeHBkTi73iUV0Lg5BchM5JNhUbvaFxAFQ2M1n9uSS18qVuM9Km0aGZ7a0k8M9e2AVPboAw==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.607
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.608-wip.phase188.20260812.1
 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

@@ -96,7 +96,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.607";
+  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.608-wip.phase188.20260812.1";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.864";
 
@@ -259,6 +259,10 @@ function compileDesired(claim, trustRootPem) {
   if (
     !operation ||
     operation.targetRevisionId !== claim?.revision?.id ||
+    !Number.isSafeInteger(operation.configGeneration) ||
+    operation.configGeneration < 1 ||
+    !Number.isSafeInteger(operation.lifecycleGeneration) ||
+    operation.lifecycleGeneration < 0 ||
     !slack ||
     !service ||
     !model ||
@@ -2137,26 +2141,83 @@ async function startNativeGateway({ desired, runtimeConfig, secrets }) {
 
 export const API_SERVER_READINESS_DEADLINE_MS = 240_000;
 const API_SERVER_READINESS_RETRY_MS = 1_000;
+export const NATIVE_GATEWAY_SERVING_PROOF_INTERVAL_MS = 30_000;
+export const NATIVE_GATEWAY_RECOVERY_COOLDOWN_MS = 60_000;
+export const NATIVE_GATEWAY_RECOVERY_MAX_ATTEMPTS = 3;
+const NATIVE_GATEWAY_RECOVERY_BUDGET_MS = 30_000;
+const NATIVE_GATEWAY_RECOVERY_BACKOFF_MS = 500;
+const NATIVE_GATEWAY_RECOVERY_BACKOFF_CAP_MS = 2_000;
+
+const NATIVE_GATEWAY_SERVING_REASONS = new Set([
+  "GATEWAY_STOPPED",
+  "SLACK_DISCONNECTED",
+  "API_UNAVAILABLE",
+  "AUTH_UNAVAILABLE",
+  "CAPABILITIES_UNAVAILABLE",
+  "IDENTITY_MISMATCH",
+  "RECOVERY_FAILED",
+  "RECOVERY_IN_PROGRESS",
+]);
+
+function nativeGatewayServingFailure(reasonCode) {
+  const error = new Error(
+    `customer_native_gateway_serving_rejected:${reasonCode}`
+  );
+  error.reasonCode = reasonCode;
+  return error;
+}
+
+function nativeGatewayServingFailureReason(error) {
+  return NATIVE_GATEWAY_SERVING_REASONS.has(error?.reasonCode)
+    ? error.reasonCode
+    : "RECOVERY_FAILED";
+}
+
+function throwIfAborted(signal) {
+  if (!signal?.aborted) return;
+  throw signal.reason instanceof Error
+    ? signal.reason
+    : new DOMException("Aborted", "AbortError");
+}
+
+function nativeGatewayRuntimeStatusReason(
+  status,
+  { expectedPid, expectedHome }
+) {
+  if (!status) return "API_UNAVAILABLE";
+  if (
+    !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
+  ) {
+    return "IDENTITY_MISMATCH";
+  }
+  if (status.gateway_state !== "running") return "GATEWAY_STOPPED";
+  if (status.platforms?.slack?.state !== "connected") {
+    return "SLACK_DISCONNECTED";
+  }
+  if (status.platforms?.api_server?.state !== "connected") {
+    return "API_UNAVAILABLE";
+  }
+  return null;
+}
 
 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"
+  return (
+    nativeGatewayRuntimeStatusReason(status, {
+      expectedPid,
+      expectedHome,
+    }) === null
   );
 }
 
@@ -2179,86 +2240,140 @@ function readNativeGatewayRuntimeStatus(runtimeHome) {
   }
 }
 
-async function proveApiServerReadiness({
+export async function proveNativeGatewayServing({
   desired,
   apiServerKey,
   gateway,
   runtimeConfig,
+  signal,
+  fetchImpl = fetch,
+  readStatus = readNativeGatewayRuntimeStatus,
 }) {
   const origin = "http://127.0.0.1:8642";
+  const requestSignal = () =>
+    signal
+      ? AbortSignal.any([signal, AbortSignal.timeout(5_000)])
+      : AbortSignal.timeout(5_000);
   const request = (authorization) =>
-    fetch(`${origin}/v1/capabilities`, {
+    fetchImpl(`${origin}/v1/capabilities`, {
       headers: authorization ? { authorization } : {},
-      signal: AbortSignal.timeout(5_000),
+      signal: requestSignal(),
     });
-  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"
-        )}`
-      );
+  throwIfAborted(signal);
+  const gatewayReadback = gateway?.readback();
+  if (
+    !gatewayReadback?.running ||
+    !Number.isSafeInteger(gateway?.child?.pid) ||
+    gateway.child.pid <= 1
+  ) {
+    throw nativeGatewayServingFailure("GATEWAY_STOPPED");
+  }
+  const statusReason = nativeGatewayRuntimeStatusReason(
+    readStatus(runtimeConfig.runtimeHome),
+    {
+      expectedPid: gateway.child.pid,
+      expectedHome: runtimeConfig.runtimeHome,
     }
-    const candidateStatus = readNativeGatewayRuntimeStatus(
-      runtimeConfig.runtimeHome
-    );
-    if (
-      !nativeGatewayRuntimeStatusAccepted(candidateStatus, {
-        expectedPid: gateway.child.pid,
-        expectedHome: runtimeConfig.runtimeHome,
-      })
-    ) {
-      await sleep(API_SERVER_READINESS_RETRY_MS);
-      continue;
+  );
+  if (statusReason) throw nativeGatewayServingFailure(statusReason);
+  let health;
+  let missing;
+  let wrong;
+  let correct;
+  try {
+    [health, missing, wrong, correct] = await Promise.all([
+      fetchImpl(`${origin}/health`, { signal: requestSignal() }),
+      request(null),
+      request("Bearer phase166-readiness-intentionally-wrong"),
+      request(`Bearer ${apiServerKey}`),
+    ]);
+  } catch (error) {
+    throwIfAborted(signal);
+    throw nativeGatewayServingFailure("API_UNAVAILABLE");
+  }
+  throwIfAborted(signal);
+  if (health.status !== 200) {
+    throw nativeGatewayServingFailure("API_UNAVAILABLE");
+  }
+  if (
+    missing.status !== 401 ||
+    wrong.status !== 401 ||
+    correct.status !== 200
+  ) {
+    throw nativeGatewayServingFailure("AUTH_UNAVAILABLE");
+  }
+  let capabilities;
+  try {
+    capabilities = await correct.json();
+  } catch {
+    throw nativeGatewayServingFailure("CAPABILITIES_UNAVAILABLE");
+  }
+  const finalStatusReason = nativeGatewayRuntimeStatusReason(
+    readStatus(runtimeConfig.runtimeHome),
+    {
+      expectedPid: gateway.child.pid,
+      expectedHome: runtimeConfig.runtimeHome,
     }
+  );
+  if (finalStatusReason) {
+    throw nativeGatewayServingFailure(finalStatusReason);
+  }
+  if (
+    capabilities?.auth?.required !== true ||
+    capabilities?.features?.run_submission !== true ||
+    capabilities?.features?.run_events_sse !== true
+  ) {
+    throw nativeGatewayServingFailure("CAPABILITIES_UNAVAILABLE");
+  }
+  return Object.freeze({
+    host: "127.0.0.1",
+    port: 8642,
+    cors: false,
+    keyGeneration: desired.apiServerKeyGeneration,
+    keyFingerprint: desired.apiServerKeyFingerprint,
+    authStatusDigest: sha256(
+      JSON.stringify({
+        health: health.status,
+        missing: missing.status,
+        wrong: wrong.status,
+        correct: correct.status,
+      })
+    ),
+    capabilitiesDigest: sha256(JSON.stringify(capabilities)),
+    fixtureDigest: HERMES_RUNS_FIXTURE_IDENTITY.fixtureDigest,
+    relayCapability: "fixture_bound_runs_relay_v1",
+    runtimeGeneration: desired.runtimeGeneration,
+    gatewayPid: gateway.child.pid,
+  });
+}
+
+async function proveApiServerReadiness({
+  desired,
+  apiServerKey,
+  gateway,
+  runtimeConfig,
+  signal,
+}) {
+  const deadlineAt = Date.now() + API_SERVER_READINESS_DEADLINE_MS;
+  while (Date.now() < deadlineAt) {
     try {
-      const [health, missing, wrong, correct] = await Promise.all([
-        fetch(`${origin}/health`, { signal: AbortSignal.timeout(5_000) }),
-        request(null),
-        request("Bearer phase166-readiness-intentionally-wrong"),
-        request(`Bearer ${apiServerKey}`),
-      ]);
-      const capabilities = correct.ok ? await correct.json() : null;
-      if (
-        health.status === 200 &&
-        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
-      ) {
-        return Object.freeze({
-          host: "127.0.0.1",
-          port: 8642,
-          cors: false,
-          keyGeneration: desired.apiServerKeyGeneration,
-          keyFingerprint: desired.apiServerKeyFingerprint,
-          authStatusDigest: sha256(
-            JSON.stringify({
-              health: health.status,
-              missing: missing.status,
-              wrong: wrong.status,
-              correct: correct.status,
-            })
-          ),
-          capabilitiesDigest: sha256(JSON.stringify(capabilities)),
-          fixtureDigest: HERMES_RUNS_FIXTURE_IDENTITY.fixtureDigest,
-          relayCapability: "fixture_bound_runs_relay_v1",
-          runtimeGeneration: desired.runtimeGeneration,
-          gatewayPid: gateway.child.pid,
-        });
+      return await proveNativeGatewayServing({
+        desired,
+        apiServerKey,
+        gateway,
+        runtimeConfig,
+        signal,
+      });
+    } catch (error) {
+      throwIfAborted(signal);
+      if (nativeGatewayServingFailureReason(error) === "GATEWAY_STOPPED") {
+        const gatewayReadback = gateway?.readback();
+        throw new Error(
+          `customer_native_gateway_start_rejected:${redactRuntimeDiagnostic(
+            gatewayReadback?.output ?? "candidate exited before readiness"
+          )}`
+        );
       }
-    } catch {
       // Hermes can hold its singleton lock before the local HTTP listener is
       // accepting connections. Keep the lifecycle claim fenced while the
       // bounded readiness window converges instead of replacing it again.
@@ -2275,10 +2390,12 @@ export async function startProvenNativeGateway({
   startGateway = startNativeGateway,
   proveReadiness = proveApiServerReadiness,
   stopGateway = stopNativeGateway,
+  signal,
 }) {
   let gateway = null;
   try {
-    gateway = await startGateway({ desired, runtimeConfig, secrets });
+    gateway = await startGateway({ desired, runtimeConfig, secrets, signal });
+    throwIfAborted(signal);
     const gatewayReadback = gateway.readback();
     if (!gatewayReadback.running) {
       throw new Error("customer_native_gateway_readback_rejected");
@@ -2288,6 +2405,7 @@ export async function startProvenNativeGateway({
       apiServerKey: secrets.hermesApiServer,
       gateway,
       runtimeConfig,
+      signal,
     });
     return { gateway, gatewayReadback, apiServerReadiness };
   } catch (error) {
@@ -2310,6 +2428,230 @@ export async function startProvenNativeGateway({
   }
 }
 
+function nativeGatewayServingObservation({
+  runtime,
+  bootSessionId,
+  flyGeneration,
+  state,
+  reasonCode,
+  checkedAt,
+}) {
+  const gatewayPid = runtime.gateway?.child?.pid;
+  const desired = runtime.desired;
+  const authority = runtime.servingAuthority;
+  if (
+    !Number.isSafeInteger(gatewayPid) ||
+    gatewayPid <= 1 ||
+    authority?.runtimeId !== desired.runtimeId ||
+    authority?.profileId !== desired.profileId ||
+    !Number.isSafeInteger(authority?.runtimeGeneration) ||
+    authority.runtimeGeneration < 1 ||
+    !Number.isSafeInteger(authority?.configGeneration) ||
+    authority.configGeneration < 1 ||
+    !Number.isSafeInteger(authority?.lifecycleGeneration) ||
+    authority.lifecycleGeneration < 0
+  ) {
+    throw new Error("customer_native_gateway_observation_rejected");
+  }
+  return Object.freeze({
+    version: 1,
+    runtimeId: authority.runtimeId,
+    flyGeneration,
+    runtimeGeneration: authority.runtimeGeneration,
+    configGeneration: authority.configGeneration,
+    lifecycleGeneration: authority.lifecycleGeneration,
+    bootSessionId,
+    profileId: desired.profileId,
+    hermesHomeId: flyRuntimeDigest({
+      schemaVersion: "sellable-agent-hermes-home/v1",
+      root: DATA_ROOT,
+      profileId: desired.profileId,
+    }),
+    gatewayPid,
+    checkedAt: new Date(checkedAt).toISOString(),
+    state,
+    reasonCode,
+  });
+}
+
+/**
+ * One in-process, single-flight owner beside the existing signed claim loop.
+ * It creates no timer: the lifecycle loop decides when to call poll().
+ */
+export function createNativeGatewayServingSupervisor({
+  runtime,
+  getActiveRuntime,
+  bootSessionId,
+  flyGeneration,
+  now = Date.now,
+  random = Math.random,
+  pause = (ms, signal) => abortablePause(ms, signal, sleep),
+  proveServing = proveNativeGatewayServing,
+  startProvenGateway = startProvenNativeGateway,
+  stopGateway = stopNativeGateway,
+}) {
+  let stopped = false;
+  let episode = null;
+  let episodeController = null;
+  let nextEligibleAt = now() + NATIVE_GATEWAY_SERVING_PROOF_INTERVAL_MS;
+  let current = null;
+  const outgoing = [];
+
+  const authorityCurrent = () =>
+    !stopped &&
+    getActiveRuntime() === runtime &&
+    runtime.servingAuthority?.flyGeneration === flyGeneration;
+
+  const publish = (state, reasonCode) => {
+    if (!authorityCurrent()) return null;
+    const observation = nativeGatewayServingObservation({
+      runtime,
+      bootSessionId,
+      flyGeneration,
+      state,
+      reasonCode,
+      checkedAt: now(),
+    });
+    current = observation;
+    if (state !== "READY") {
+      while (outgoing[0]?.state === "READY") outgoing.shift();
+    }
+    const previous = outgoing.at(-1);
+    if (
+      previous?.state === observation.state &&
+      previous?.reasonCode === observation.reasonCode &&
+      previous?.gatewayPid === observation.gatewayPid
+    ) {
+      outgoing[outgoing.length - 1] = observation;
+    } else {
+      outgoing.push(observation);
+    }
+    return observation;
+  };
+
+  publish("READY", null);
+
+  const runEpisode = async (signal) => {
+    let failureReason = "RECOVERY_FAILED";
+    try {
+      await proveServing({
+        desired: runtime.desired,
+        apiServerKey: runtime.secrets.hermesApiServer,
+        gateway: runtime.gateway,
+        runtimeConfig: runtime.runtimeConfig,
+        signal,
+      });
+      if (!authorityCurrent()) return;
+      publish("READY", null);
+      nextEligibleAt = now() + NATIVE_GATEWAY_SERVING_PROOF_INTERVAL_MS;
+      return;
+    } catch (error) {
+      throwIfAborted(signal);
+      failureReason = nativeGatewayServingFailureReason(error);
+    }
+
+    publish("RECOVERING", "RECOVERY_IN_PROGRESS");
+    const deadlineAt = now() + NATIVE_GATEWAY_RECOVERY_BUDGET_MS;
+    for (
+      let attempt = 1;
+      attempt <= NATIVE_GATEWAY_RECOVERY_MAX_ATTEMPTS;
+      attempt += 1
+    ) {
+      const backoff = Math.round(
+        Math.min(
+          NATIVE_GATEWAY_RECOVERY_BACKOFF_CAP_MS,
+          NATIVE_GATEWAY_RECOVERY_BACKOFF_MS * 2 ** (attempt - 1)
+        ) *
+          (0.75 + random() * 0.5)
+      );
+      await pause(backoff, signal);
+      throwIfAborted(signal);
+      if (!authorityCurrent()) return;
+      if (now() >= deadlineAt) {
+        failureReason = "RECOVERY_FAILED";
+        break;
+      }
+      try {
+        await stopGateway(runtime.gateway);
+        throwIfAborted(signal);
+        if (!authorityCurrent()) return;
+        if (now() >= deadlineAt) {
+          failureReason = "RECOVERY_FAILED";
+          break;
+        }
+        const proven = await startProvenGateway({
+          desired: runtime.desired,
+          runtimeConfig: runtime.runtimeConfig,
+          secrets: runtime.secrets,
+          signal,
+          proveReadiness: (input) => proveServing({ ...input, signal }),
+        });
+        throwIfAborted(signal);
+        if (!authorityCurrent()) {
+          await stopGateway(proven.gateway);
+          return;
+        }
+        if (now() >= deadlineAt) {
+          await stopGateway(proven.gateway);
+          failureReason = "RECOVERY_FAILED";
+          break;
+        }
+        runtime.gateway = proven.gateway;
+        publish("READY", null);
+        nextEligibleAt = now() + NATIVE_GATEWAY_SERVING_PROOF_INTERVAL_MS;
+        return;
+      } catch (error) {
+        throwIfAborted(signal);
+        failureReason = nativeGatewayServingFailureReason(error);
+      }
+    }
+    if (!authorityCurrent()) return;
+    publish("DEGRADED", failureReason);
+    nextEligibleAt = now() + NATIVE_GATEWAY_RECOVERY_COOLDOWN_MS;
+  };
+
+  return Object.freeze({
+    pendingObservation() {
+      return outgoing[0] ?? current;
+    },
+    observationSent(observation) {
+      if (outgoing[0] === observation) outgoing.shift();
+    },
+    poll({ force = false } = {}) {
+      if (
+        stopped ||
+        episode ||
+        !authorityCurrent() ||
+        (!force && now() < nextEligibleAt)
+      ) {
+        return episode;
+      }
+      episodeController = new AbortController();
+      const activeEpisode = runEpisode(episodeController.signal)
+        .catch((error) => {
+          if (error?.name !== "AbortError") throw error;
+        })
+        .finally(() => {
+          if (episode === activeEpisode) {
+            episode = null;
+            episodeController = null;
+          }
+        });
+      episode = activeEpisode;
+      return activeEpisode;
+    },
+    async stop() {
+      stopped = true;
+      episodeController?.abort();
+      try {
+        await episode;
+      } catch (error) {
+        if (error?.name !== "AbortError") throw error;
+      }
+    },
+  });
+}
+
 async function proveProvisionedApplication({
   desired,
   runtimeConfig,
@@ -2816,6 +3158,14 @@ async function processOperation({ claim, exchange, client, identity }) {
     runtimeConfig,
     trustRootPem,
     action: claim.operation.action,
+    servingAuthority: Object.freeze({
+      runtimeId: RUNTIME_ID,
+      flyGeneration: RUNTIME_GENERATION,
+      runtimeGeneration: RUNTIME_GENERATION,
+      configGeneration: claim.operation.configGeneration,
+      lifecycleGeneration: claim.operation.lifecycleGeneration,
+      profileId: desired.profileId,
+    }),
     gateway: proof.gateway ?? null,
     modelHealthReporter,
   };
@@ -2865,6 +3215,7 @@ async function main() {
   });
   const controller = new AbortController();
   let activeRuntime = null;
+  let servingSupervisor = null;
   let shutdownMemorySnapshot = null;
   const endpointRelay = createCustomerEndpointRelay({
     getControlClient: () => client,
@@ -2878,6 +3229,8 @@ async function main() {
     const runtime = activeRuntime;
     shutdownMemorySnapshot = (async () => {
       try {
+        await servingSupervisor?.stop();
+        servingSupervisor = null;
         await endpointRelay.fenceActive("RUNTIME_SHUTDOWN");
         await stopNativeGateway(runtime.gateway);
         runtime.gateway = null;
@@ -2919,6 +3272,10 @@ async function main() {
                     callerProfileId: activeRuntime.desired.profileId,
                   }),
                 leaseSeconds: 60,
+                servingObservation:
+                  servingSupervisor?.pendingObservation() ?? undefined,
+                onServingObservationSent: (observation) =>
+                  servingSupervisor?.observationSent(observation),
               })
             : await client.claim(60);
       } catch (error) {
@@ -2963,20 +3320,12 @@ async function main() {
               ),
           });
         }
-        if (
-          activeRuntime?.action !== "INSTANTIATE" &&
-          activeRuntime?.gateway &&
-          !activeRuntime.gateway.readback().running
-        ) {
-          activeRuntime.gateway = await startNativeGateway({
-            desired: activeRuntime.desired,
-            runtimeConfig: activeRuntime.runtimeConfig,
-            secrets: activeRuntime.secrets,
-          });
-        }
+        void servingSupervisor?.poll();
         await sleep(1_000);
         continue;
       }
+      await servingSupervisor?.stop();
+      servingSupervisor = null;
       operationHeartbeat = startOperationHeartbeat({
         claim,
         exchange,
@@ -2991,6 +3340,15 @@ async function main() {
         client,
         identity,
       });
+      servingSupervisor =
+        activeRuntime.action === "INSTANTIATE"
+          ? null
+          : createNativeGatewayServingSupervisor({
+              runtime: activeRuntime,
+              getActiveRuntime: () => activeRuntime,
+              bootSessionId: BOOT_SESSION_ID,
+              flyGeneration: RUNTIME_GENERATION,
+            });
       soulClaimTracker = createSoulClaimObservationTracker({
         runtimeId: RUNTIME_ID,
         profileId: activeRuntime.desired.profileId,

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

@@ -784,6 +784,8 @@ export async function claimWithSoulObservation({
   tracker,
   readSoul,
   leaseSeconds = 60,
+  servingObservation,
+  onServingObservationSent,
 }) {
   // Deliver lifecycle work before any potentially slow local loader proof.
   // Reconciliation uses the same cadence only after the server confirms that
@@ -791,7 +793,9 @@ export async function claimWithSoulObservation({
   const tick = await client.claimTick({
     leaseSeconds,
     soulObservation: tracker.pending(),
+    ...(servingObservation ? { servingObservation } : {}),
   });
+  if (servingObservation) onServingObservationSent?.(servingObservation);
   if (tick?.claim) return tick.claim;
 
   const acknowledgement = tick?.soulAcknowledgement;
@@ -1074,10 +1078,15 @@ export function createFlyCustomerControlClient({
     }
     return { ...result, signedUrl: undefined, bytes };
   };
-  const claimTick = async ({ leaseSeconds = 60, soulObservation } = {}) =>
+  const claimTick = async ({
+    leaseSeconds = 60,
+    soulObservation,
+    servingObservation,
+  } = {}) =>
     post("claim", "/api/v3/sellable-agent/worker/claim", {
       leaseSeconds,
       ...(soulObservation ? { soulObservation } : {}),
+      ...(servingObservation ? { servingObservation } : {}),
     });
   return Object.freeze({
     claimTick,

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.607";
+const INSTALLER_PACKAGE = "@sellable/install@0.1.608-wip.phase188.20260812.1";
 const MCP_PACKAGE = "@sellable/mcp@0.1.864";
 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.607" ||
+      pinned.installerPackage !== "@sellable/install@0.1.608-wip.phase188.20260812.1" ||
       pinned.mcpPackage !== "@sellable/mcp@0.1.864" ||
       !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.607" ||
+    desired.installerPackage !== "@sellable/install@0.1.608-wip.phase188.20260812.1" ||
     desired.mcpPackage !== "@sellable/mcp@0.1.864" ||
     !Array.isArray(desired.toolInclude) ||
     desired.toolInclude.length === 0 ||

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