@sellable/install 0.1.483 → 0.1.484

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.483
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.484
 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.483" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.484" \
     && 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.483" \
     && 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.483' || 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.484' || 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.483', 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.484', 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.483` is
+`@sellable/install@0.1.484` is
 published:
 
 ```sh
 docker build --platform linux/amd64 \
   --build-arg INSTALLER_INTEGRITY='sha512-…' \
-  --tag sellable-agent-host:0.1.483 .
+  --tag sellable-agent-host:0.1.484 .
 ```
 
 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-customer-image/Dockerfile

@@ -5,7 +5,7 @@ USER root
 
 ARG MCP_PACKAGE=@sellable/mcp@0.1.805
 ARG MCP_INTEGRITY=sha512-ULMGwWalb14SaMgxLeeiOWjavXpnONhdD8kAkvp7rJFdiL7s30VwXX+1j/aNwijiWXqqNQ1wcsXUPqk4eWpslg==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.483
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.484
 ARG TUS_JS_CLIENT_VERSION=4.3.1
 ARG HERMES_VERSION=0.20.0
 ARG MCP_TRUST_ROOT_B64
@@ -61,6 +61,7 @@ COPY mcp-context-proxy.mjs fly-customer-model.mjs fly-customer-worker.mjs profil
 COPY hermes-memory-dirty.mjs /opt/sellable/bin/hermes-memory-dirty
 COPY hermes-memory-reconcile.sh /opt/sellable/share/hermes-memory-reconcile.sh
 COPY fly-customer-image/customer-runtime.mjs /usr/local/lib/sellable-agent/fly-customer-image/customer-runtime.mjs
+COPY fly-customer-image/model-auth-store.mjs /usr/local/lib/sellable-agent/fly-customer-image/model-auth-store.mjs
 COPY fly-customer-image/rootfs/ /
 
 RUN node --input-type=module -e \

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

@@ -48,6 +48,7 @@ import {
   materializeNativeSlackCustomerProfile,
   validateNativeSlackCustomerProfile,
 } from "../profile-materializer.mjs";
+import { reconcileHermesRootModelAuth } from "./model-auth-store.mjs";
 
 const DATA_ROOT = "/opt/data";
 const PROFILES_ROOT = join(DATA_ROOT, "profiles");
@@ -69,7 +70,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.483";
+  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.484";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ??
   "@sellable/mcp@0.1.805";
@@ -400,24 +401,13 @@ function writeRuntimeHermesConfig({
   const runtimeConfigRoot = profileRoot;
   mkdirSync(runtimeConfigRoot, { recursive: true, mode: 0o700 });
   chmodSync(runtimeConfigRoot, 0o700);
-  const priorIdentityPath = join(runtimeConfigRoot, "runtime-identity.json");
-  let priorModelCredentialGeneration = null;
-  if (existsSync(priorIdentityPath)) {
-    try {
-      const priorIdentity = JSON.parse(readFileSync(priorIdentityPath, "utf8"));
-      if (
-        Number.isSafeInteger(priorIdentity.modelCredentialGeneration) &&
-        priorIdentity.modelCredentialGeneration > 0
-      ) {
-        priorModelCredentialGeneration =
-          priorIdentity.modelCredentialGeneration;
-      }
-    } catch {
-      priorModelCredentialGeneration = null;
-    }
-  }
   const localHermesAuthStorePath = join(runtimeConfigRoot, "auth.json");
   const hermesRootAuthStorePath = join(DATA_ROOT, "auth.json");
+  const hermesRootAuthMarkerPath = join(
+    DATA_ROOT,
+    ".sellable-agent",
+    "model-auth-source.json"
+  );
   if (existsSync(localHermesAuthStorePath)) {
     const localAuthStore = lstatSync(localHermesAuthStorePath);
     if (localAuthStore.isSymbolicLink() || !localAuthStore.isFile()) {
@@ -425,17 +415,6 @@ function writeRuntimeHermesConfig({
     }
     unlinkSync(localHermesAuthStorePath);
   }
-  if (
-    priorModelCredentialGeneration !== null &&
-    priorModelCredentialGeneration !== desired.modelCredentialGeneration &&
-    existsSync(hermesRootAuthStorePath)
-  ) {
-    const authStore = lstatSync(hermesRootAuthStorePath);
-    if (authStore.isSymbolicLink() || !authStore.isFile()) {
-      throw new Error("customer_model_auth_store_rejected");
-    }
-    unlinkSync(hermesRootAuthStorePath);
-  }
   const mcpConfig = JSON.parse(
     readFileSync(join(profileRoot, "sellable", "mcp.json"), "utf8")
   );
@@ -480,19 +459,12 @@ function writeRuntimeHermesConfig({
   const modelCredential = parseFlyCustomerModelCredential(secrets.modelCodex);
   const modelAuthPath = join(secretRoot, "auth.json");
   atomicFile(modelAuthPath, modelCredential.authJson, 0o600);
-  if (!existsSync(hermesRootAuthStorePath)) {
-    atomicFile(
-      hermesRootAuthStorePath,
-      modelCredential.hermesRootAuthJson,
-      0o600
-    );
-  } else {
-    const authStore = lstatSync(hermesRootAuthStorePath);
-    if (authStore.isSymbolicLink() || !authStore.isFile()) {
-      throw new Error("customer_model_auth_store_rejected");
-    }
-    chmodSync(hermesRootAuthStorePath, 0o600);
-  }
+  const modelAuthState = reconcileHermesRootModelAuth({
+    authStorePath: hermesRootAuthStorePath,
+    markerPath: hermesRootAuthMarkerPath,
+    modelCredential,
+    generation: desired.modelCredentialGeneration,
+  });
   atomicJson(runtimeConfigPath, {
     ...baseConfig,
     ...(testModelOrigin
@@ -572,6 +544,8 @@ function writeRuntimeHermesConfig({
     gatesPath,
     modelAuthPath,
     hermesRootAuthStorePath,
+    hermesRootAuthMarkerPath,
+    modelAuthSourceFingerprint: modelAuthState.sourceFingerprint,
     modelCredential,
   };
 }
@@ -785,8 +759,10 @@ async function proveProvisionedApplication({
           "from hermes_cli.auth import resolve_codex_runtime_credentials",
           "value = resolve_codex_runtime_credentials(refresh_if_expiring=False)",
           'root_auth = get_default_hermes_root() / "auth.json"',
+          'root_auth_marker = get_default_hermes_root() / ".sellable-agent" / "model-auth-source.json"',
           'local_auth = get_hermes_home() / "auth.json"',
-          'print(json.dumps({"provider": value.get("provider"), "source": value.get("source"), "source_class": "root_fallback" if root_auth.is_file() and not local_auth.exists() else "unexpected", "auth_mode": value.get("auth_mode"), "credential_present": bool(value.get("api_key")), "local_auth_entry_count": 0 if not local_auth.exists() else 1}))',
+          "marker = json.loads(root_auth_marker.read_text()) if root_auth_marker.is_file() else {}",
+          'print(json.dumps({"provider": value.get("provider"), "source": value.get("source"), "source_class": "root_fallback" if root_auth.is_file() and not local_auth.exists() else "unexpected", "auth_mode": value.get("auth_mode"), "credential_present": bool(value.get("api_key")), "local_auth_entry_count": 0 if not local_auth.exists() else 1, "source_fingerprint": marker.get("sourceFingerprint"), "credential_generation": marker.get("generation")}))',
         ].join(";"),
       ],
       {
@@ -801,7 +777,10 @@ async function proveProvisionedApplication({
   } catch {
     modelAuthReadback = null;
   }
-  const modelAuthVerdict = evaluateModelAuthReadback(modelAuthReadback);
+  const modelAuthVerdict = evaluateModelAuthReadback(modelAuthReadback, {
+    sourceFingerprint: runtimeConfig.modelAuthSourceFingerprint,
+    generation: desired.modelCredentialGeneration,
+  });
   if (modelAuth.status !== 0 || !modelAuthVerdict.accepted) {
     // Name the failed invariant: a bare rejection sent the 2026-07-28 outage
     // hunting the credential itself when the credential was valid and only its

package/lib/sellable-agent/fly-customer-image/model-auth-store.mjs

@@ -0,0 +1,143 @@
+import { createHash, randomUUID } from "node:crypto";
+import {
+  chmodSync,
+  existsSync,
+  lstatSync,
+  mkdirSync,
+  readFileSync,
+  renameSync,
+  writeFileSync,
+} from "node:fs";
+import { dirname } from "node:path";
+
+const MARKER_VERSION = 1;
+const MARKER_KEYS = ["generation", "sourceFingerprint", "version"];
+
+const sha256 = (value) => createHash("sha256").update(value).digest("hex");
+
+function assertRegularFileOrMissing(path) {
+  if (!existsSync(path)) return;
+  const entry = lstatSync(path);
+  if (entry.isSymbolicLink() || !entry.isFile()) {
+    throw new Error("customer_model_auth_store_rejected");
+  }
+}
+
+function atomicPrivateFile(path, bytes) {
+  mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+  const temporary = `${path}.${process.pid}.${randomUUID()}.tmp`;
+  writeFileSync(temporary, bytes, { flag: "wx", mode: 0o600 });
+  chmodSync(temporary, 0o600);
+  renameSync(temporary, path);
+  chmodSync(path, 0o600);
+}
+
+function readMarker(path) {
+  assertRegularFileOrMissing(path);
+  if (!existsSync(path)) return null;
+  try {
+    const marker = JSON.parse(readFileSync(path, "utf8"));
+    if (
+      !marker ||
+      typeof marker !== "object" ||
+      Array.isArray(marker) ||
+      Object.keys(marker).sort().join("\0") !==
+        [...MARKER_KEYS].sort().join("\0") ||
+      marker.version !== MARKER_VERSION ||
+      !Number.isSafeInteger(marker.generation) ||
+      marker.generation < 1 ||
+      !/^[a-f0-9]{16}$/.test(marker.sourceFingerprint)
+    ) {
+      return null;
+    }
+    return marker;
+  } catch {
+    return null;
+  }
+}
+
+function usableHermesRootAuth(path) {
+  if (!existsSync(path)) return false;
+  try {
+    const value = JSON.parse(readFileSync(path, "utf8"));
+    const provider = value?.providers?.["openai-codex"];
+    const pool = value?.credential_pool?.["openai-codex"];
+    return Boolean(
+      value?.active_provider === "openai-codex" &&
+        provider?.auth_mode === "chatgpt" &&
+        provider.tokens &&
+        ["id_token", "access_token", "refresh_token", "account_id"].every(
+          (key) =>
+            typeof provider.tokens[key] === "string" &&
+            provider.tokens[key].length > 0
+        ) &&
+        Array.isArray(pool) &&
+        pool.length > 0
+    );
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Reconcile Hermes' persistent root auth store with the sealed control-plane
+ * credential without undoing a later in-place OAuth refresh.
+ *
+ * The marker is written only after the matching auth store is durable. A
+ * missing or mismatched marker therefore means the root store must be reseeded,
+ * even when runtime-identity.json already records the new generation after an
+ * interrupted or overlapping reconciliation.
+ */
+export function reconcileHermesRootModelAuth({
+  authStorePath,
+  markerPath,
+  modelCredential,
+  generation,
+}) {
+  if (
+    typeof authStorePath !== "string" ||
+    !authStorePath ||
+    typeof markerPath !== "string" ||
+    !markerPath ||
+    !Number.isSafeInteger(generation) ||
+    generation < 1 ||
+    !modelCredential ||
+    typeof modelCredential.authJson !== "string" ||
+    typeof modelCredential.hermesRootAuthJson !== "string"
+  ) {
+    throw new Error("customer_model_auth_store_rejected");
+  }
+
+  assertRegularFileOrMissing(authStorePath);
+  const sourceFingerprint = sha256(modelCredential.authJson).slice(0, 16);
+  const priorMarker = readMarker(markerPath);
+  const markerMatches =
+    priorMarker?.generation === generation &&
+    priorMarker.sourceFingerprint === sourceFingerprint;
+  const authStoreUsable = usableHermesRootAuth(authStorePath);
+
+  if (!markerMatches || !authStoreUsable) {
+    atomicPrivateFile(authStorePath, modelCredential.hermesRootAuthJson);
+    atomicPrivateFile(
+      markerPath,
+      `${JSON.stringify(
+        {
+          version: MARKER_VERSION,
+          generation,
+          sourceFingerprint,
+        },
+        null,
+        2
+      )}\n`
+    );
+  } else {
+    chmodSync(authStorePath, 0o600);
+    chmodSync(markerPath, 0o600);
+  }
+
+  return Object.freeze({
+    sourceFingerprint,
+    generation,
+    reseeded: !markerMatches || !authStoreUsable,
+  });
+}

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

@@ -30,8 +30,11 @@ const TRUSTED_MODEL_AUTH_SOURCES = ["hermes-auth-store", "credential_pool"];
  * Decide whether the runtime's model-auth readback proves a usable, isolated
  * Codex credential. Returns the first failed invariant so boot failures name
  * the actual cause instead of a generic rejection.
+ *
+ * @param {unknown} readback
+ * @param {{ sourceFingerprint: string, generation: number } | null} [expected]
  */
-export function evaluateModelAuthReadback(readback) {
+export function evaluateModelAuthReadback(readback, expected = null) {
   const reject = (rejection) => ({ accepted: false, rejection });
   if (!readback || typeof readback !== "object" || Array.isArray(readback)) {
     return reject("readback_unparsable");
@@ -54,6 +57,12 @@ export function evaluateModelAuthReadback(readback) {
   if (readback.credential_present !== true) {
     return reject("credential_absent");
   }
+  if (expected && readback.source_fingerprint !== expected.sourceFingerprint) {
+    return reject("source_fingerprint_mismatch");
+  }
+  if (expected && readback.credential_generation !== expected.generation) {
+    return reject("credential_generation_mismatch");
+  }
   return { accepted: true, rejection: null };
 }
 

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.483";
+const INSTALLER_PACKAGE = "@sellable/install@0.1.484";
 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.483" ||
+      pinned.installerPackage !== "@sellable/install@0.1.484" ||
       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.483" ||
+    desired.installerPackage !== "@sellable/install@0.1.484" ||
     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.483";
+export const PINNED_INSTALL_PACKAGE = "@sellable/install@0.1.484";
 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.483" ||
+      manifest.installerVersion !== "0.1.484" ||
       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.483",
+      installVersion: "0.1.484",
       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.483",
+      installVersion: "0.1.484",
       mcpPackage: PINNED_MCP_PACKAGE,
       command: "hermes profile bootstrap",
     },

package/package.json

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