@sellable/install 0.1.721 → 0.1.722-wip.hermes.20260909.1

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.721
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.722-wip.hermes.20260909.1
 ARG MCP_PACKAGE=@sellable/mcp@0.1.915
 ARG INSTALLER_INTEGRITY
 ARG MCP_INTEGRITY=sha512-+WdyO3WxQ9U7fHMvxBojPRDIZun/INy9mKOz/A1IcBFEWXFkpPooT0yMUzY1qCYcewTM1AUxP3p2QOtsxRIYQA==
 
-RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.721" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.722-wip.hermes.20260909.1" \
     && test "${MCP_PACKAGE}" = "@sellable/mcp@0.1.915" \
     && 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.721" \
     && 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.721' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.915') 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.722-wip.hermes.20260909.1' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.915') 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.721', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.915', 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.722-wip.hermes.20260909.1', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.915', 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,7 +3,7 @@
 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.721` is
+`@sellable/install@0.1.722-wip.hermes.20260909.1` is
 published:
 
 ```sh

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

@@ -1,5 +1,5 @@
 # syntax=docker/dockerfile:1.7
-ARG HERMES_IMAGE=nousresearch/hermes-agent@sha256:d597ca1f766ff23ff86437fe5e0f36a6049166ce91df917d9577d7418f0767de
+ARG HERMES_IMAGE=nousresearch/hermes-agent@sha256:d58e024542f9de5f9de16a4a668f6728c417ce3341ee5e8419479492de16c432
 ARG SLACK_PP_GO_IMAGE=golang@sha256:386d475a660466863d9f8c766fec64d7fdad3edac2c6a05020c09534d71edb4b
 
 FROM ${SLACK_PP_GO_IMAGE} AS slack-pp-cli-builder
@@ -202,7 +202,7 @@ RUN set -eux; \
       'const fs=require("fs"); const manifest=JSON.parse(fs.readFileSync("/usr/local/share/sellable-agent/default-profile-bundle/manifest.json")); if(String(manifest.bundleVersion)!==process.argv[1] || manifest.bundleDigest!==process.argv[2]) process.exit(1);' \
       "${DEFAULT_PROFILE_BUNDLE_VERSION}" "${DEFAULT_PROFILE_BUNDLE_DIGEST}" \
     && node --input-type=module -e \
-      'import { installHermesAgentBridge, HERMES_AGENT_BRIDGE_DEDICATED_V020_CONTRACT } from "/usr/local/lib/sellable-agent/hermes-bridge.mjs"; installHermesAgentBridge({ sourceRoot: "/opt/hermes", contract: HERMES_AGENT_BRIDGE_DEDICATED_V020_CONTRACT });' \
+      'import { installHermesAgentBridge, HERMES_AGENT_BRIDGE_DEDICATED_V021_CONTRACT } from "/usr/local/lib/sellable-agent/hermes-bridge.mjs"; installHermesAgentBridge({ sourceRoot: "/opt/hermes", contract: HERMES_AGENT_BRIDGE_DEDICATED_V021_CONTRACT });' \
     && node --input-type=module -e \
       'await import("/usr/local/lib/sellable-agent/fly-runtime-identity.mjs");' \
     && node --input-type=module -e \

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

@@ -2883,7 +2883,7 @@ async function flushHermesSnapshot({
       profileId,
       profileRoot,
       hermesRoot: DATA_ROOT,
-      hermesVersion: "0.20.4",
+      hermesVersion: "0.21.1",
       debounceMs: 0,
       operationIdentity,
       upload: ({
@@ -2900,7 +2900,7 @@ async function flushHermesSnapshot({
           {
             archiveDigest,
             archiveBytes,
-            hermesVersion: "0.20.4",
+            hermesVersion: "0.21.1",
             sourceProfileId,
             ...v2,
           },
@@ -3843,13 +3843,13 @@ async function runAdminProduction() {
             profileId: activeLaunch.profile.profile,
             profileRoot: activeLaunch.profile.profileHome,
             hermesRoot: DATA_ROOT,
-            hermesVersion: "0.20.4",
+            hermesVersion: "0.21.1",
             upload: ({ archiveDigest, archiveBytes, sourceProfileId, bytes }) =>
               client.putMemorySnapshot(
                 {
                   archiveDigest,
                   archiveBytes,
-                  hermesVersion: "0.20.4",
+                  hermesVersion: "0.21.1",
                   sourceProfileId,
                 },
                 bytes
@@ -4019,7 +4019,7 @@ async function runAdminProduction() {
             profileId: basename(profileContract.profileHome),
             profileRoot: profileContract.profileHome,
             hermesRoot: DATA_ROOT,
-            hermesVersion: "0.20.4",
+            hermesVersion: "0.21.1",
             fetchLatest: () => client.getMemorySnapshot(),
           })
       );

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

@@ -1,5 +1,5 @@
 # syntax=docker/dockerfile:1.7
-ARG HERMES_IMAGE=nousresearch/hermes-agent@sha256:d597ca1f766ff23ff86437fe5e0f36a6049166ce91df917d9577d7418f0767de
+ARG HERMES_IMAGE=nousresearch/hermes-agent@sha256:d58e024542f9de5f9de16a4a668f6728c417ce3341ee5e8419479492de16c432
 FROM ${HERMES_IMAGE}
 
 USER root
@@ -8,12 +8,12 @@ ENV PLAYWRIGHT_BROWSERS_PATH=/opt/hermes/.playwright
 
 ARG MCP_PACKAGE=@sellable/mcp@0.1.915
 ARG MCP_INTEGRITY=sha512-+WdyO3WxQ9U7fHMvxBojPRDIZun/INy9mKOz/A1IcBFEWXFkpPooT0yMUzY1qCYcewTM1AUxP3p2QOtsxRIYQA==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.721
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.722-wip.hermes.20260909.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
 ARG YAML_VERSION=2.9.0
-ARG HERMES_VERSION=0.20.4
+ARG HERMES_VERSION=0.21.1
 ARG AGENT_BROWSER_VERSION=0.26.0
 ARG TIRITH_VERSION=0.3.3
 ARG PLAYWRIGHT_VERSION=1.62.1
@@ -54,7 +54,7 @@ RUN --mount=type=secret,id=mcp_trust_root,required=true \
     && ln -s /usr/local/lib/sellable-agent/external-runtime/playwright/node_modules/.bin/playwright \
          /usr/local/bin/playwright \
     && test "$(playwright --version)" = "Version ${PLAYWRIGHT_VERSION}" \
-    && playwright install chromium \
+    && playwright install --with-deps chromium \
     && test -d "/opt/hermes/.playwright/chromium-${PLAYWRIGHT_BROWSER_REVISION}" \
     && test -d "/opt/hermes/.playwright/chromium_headless_shell-${PLAYWRIGHT_BROWSER_REVISION}" \
     && ln -sf /usr/local/lib/sellable-agent/node_modules/.bin/agent-browser /usr/local/bin/agent-browser \
@@ -107,7 +107,7 @@ RUN set -eux; \
       'const fs=require("fs"); const manifest=JSON.parse(fs.readFileSync("/usr/local/share/sellable-agent/default-profile-bundle/manifest.json")); if(String(manifest.bundleVersion)!==process.argv[1] || manifest.bundleDigest!==process.argv[2]) process.exit(1);' \
       "${DEFAULT_PROFILE_BUNDLE_VERSION}" "${DEFAULT_PROFILE_BUNDLE_DIGEST}" \
     && node --input-type=module -e \
-      'import { installHermesAgentBridge, HERMES_AGENT_BRIDGE_DEDICATED_V020_CONTRACT } from "/usr/local/lib/sellable-agent/hermes-bridge.mjs"; installHermesAgentBridge({ sourceRoot: "/opt/hermes", contract: HERMES_AGENT_BRIDGE_DEDICATED_V020_CONTRACT });' \
+      'import { installHermesAgentBridge, HERMES_AGENT_BRIDGE_DEDICATED_V021_CONTRACT } from "/usr/local/lib/sellable-agent/hermes-bridge.mjs"; installHermesAgentBridge({ sourceRoot: "/opt/hermes", contract: HERMES_AGENT_BRIDGE_DEDICATED_V021_CONTRACT });' \
     && node --input-type=module -e \
       'await import("/usr/local/lib/sellable-agent/fly-runtime-identity.mjs");' \
     && node --input-type=module -e \

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

@@ -105,12 +105,11 @@ const RUNTIME_GENERATION = Number(
     "0"
 );
 const BOOT_SESSION_ID = randomUUID();
-const HERMES_VERSION = process.env.SELLABLE_AGENT_HERMES_VERSION ?? "0.20.4";
+const HERMES_VERSION = process.env.SELLABLE_AGENT_HERMES_VERSION ?? "0.21.1";
 const INSTALLER_PACKAGE =
-  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.721";
+  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.722-wip.hermes.20260909.1";
 const MCP_PACKAGE =
-  process.env.SELLABLE_AGENT_MCP_PACKAGE ??
-  "@sellable/mcp@0.1.915";
+  process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.915";
 export const ENDPOINT_MAX_CONCURRENT_RUNS = 10;
 const DEFAULT_PROFILE_BUNDLE_ROOT =
   "/usr/local/share/sellable-agent/default-profile-bundle";

package/lib/sellable-agent/fly-customer-image/hermes-runs-client.mjs

@@ -14,13 +14,13 @@ const MAX_HISTORY_ITEMS = 64;
 const MAX_EVENT_BYTES = 128 * 1024;
 const MAX_CANONICAL_OUTPUT_BYTES = 48 * 1024;
 const EXACT_FIXTURE_DIGEST =
-  "d9a0b30e0924735a79abb2ddf55288ab10342fbffad5150cabb3b6979d23cd3e";
+  "51c75f1c639cd02920be8524cb35242be244d6fff277aff646035a2f0a66b312";
 
 export const HERMES_RUNS_FIXTURE_IDENTITY = Object.freeze({
   schemaVersion: "sellable-hermes-api-capabilities/v1",
   image:
-    "nousresearch/hermes-agent@sha256:d597ca1f766ff23ff86437fe5e0f36a6049166ce91df917d9577d7418f0767de",
-  hermesVersion: "0.20.4",
+    "nousresearch/hermes-agent@sha256:d58e024542f9de5f9de16a4a668f6728c417ce3341ee5e8419479492de16c432",
+  hermesVersion: "0.21.1",
   fixtureDigest: EXACT_FIXTURE_DIGEST,
   origin: LOOPBACK_ORIGIN,
   auth: "bearer",
@@ -68,6 +68,10 @@ function exactObject(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 
+function approvalResolved(value) {
+  return value === true || (Number.isSafeInteger(value) && value > 0);
+}
+
 function normalizedTimestamp(value) {
   if (
     typeof value === "string" &&
@@ -76,7 +80,7 @@ function normalizedTimestamp(value) {
   ) {
     return value;
   }
-  // Hermes 0.20.4's live /v1/runs implementation emits time.time() seconds,
+  // Hermes 0.21.1's live /v1/runs implementation emits time.time() seconds,
   // even though the captured fixture examples use ISO strings. Normalize that
   // observed wire shape so known tool events do not collapse to UNKNOWN.
   if (
@@ -254,7 +258,10 @@ function nativeStatus(value, expectedRunId) {
   if (!exactObject(value) || value.run_id !== expectedRunId) {
     return evidence("NATIVE_STATUS_UNKNOWN", value);
   }
-  const status = value.status;
+  const status =
+    value.status === "waiting_for_approval"
+      ? "awaiting_approval"
+      : value.status;
   if (
     ![
       "started",
@@ -370,7 +377,10 @@ export function sanitizeHermesRunEvent(value, options = {}) {
     });
   }
   if (value.event === "approval.responded") {
-    if (!["once", "deny"].includes(value.choice) || value.resolved !== true) {
+    if (
+      !["once", "deny"].includes(value.choice) ||
+      !approvalResolved(value.resolved)
+    ) {
       return evidence("NATIVE_EVENT_UNKNOWN", value, { ordinal });
     }
     return Object.freeze({
@@ -513,7 +523,7 @@ export function createHermesRunsClient(options = {}) {
         throw transportFailure("SUBMIT_AMBIGUOUS", error);
       }
       const value = await readBounded(response);
-      // Hermes 0.20.4 emits 429 for its concurrency limiter and 503 while the
+      // Hermes 0.21.1 emits 429 for its concurrency limiter and 503 while the
       // gateway is draining. Both responses occur before it allocates a run,
       // so retrying the identical request cannot duplicate a native attempt.
       if (response.status === 429 || response.status === 503) {
@@ -522,8 +532,12 @@ export function createHermesRunsClient(options = {}) {
       if (
         response.status !== 202 ||
         !exactObject(value) ||
-        stableJson(Object.keys(value).sort()) !==
-          stableJson(["run_id", "status"]) ||
+        stableJson(
+          Object.keys(value)
+            .filter((key) => key !== "replayed")
+            .sort()
+        ) !== stableJson(["run_id", "status"]) ||
+        (value.replayed !== undefined && value.replayed !== false) ||
         value.status !== "started" ||
         !RUN_ID.test(value.run_id ?? "")
       ) {
@@ -671,7 +685,7 @@ export function createHermesRunsClient(options = {}) {
           stableJson(["choice", "object", "resolved", "run_id"]) ||
         value.run_id !== runId ||
         value.choice !== choice ||
-        value.resolved !== true
+        !approvalResolved(value.resolved)
       ) {
         return evidence("NATIVE_APPROVAL_UNCERTAIN", value, {
           nativeStatus: response.status,
@@ -699,6 +713,16 @@ export function createHermesRunsClient(options = {}) {
         });
       }
       const value = await readBounded(response);
+      // Hermes 0.21 returns the existing terminal status when stop races
+      // completion. Preserve that result; a failed/completed run is not cancelled.
+      if (
+        response.status === 200 &&
+        exactObject(value) &&
+        value.run_id === runId &&
+        ["completed", "failed", "cancelled"].includes(value.status)
+      ) {
+        return nativeStatus(value, runId);
+      }
       if (
         response.status !== 200 ||
         !exactObject(value) ||

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

@@ -1029,7 +1029,7 @@ export function createFlyCustomerControlClient({
     Number.isSafeInteger(value?.archiveBytes) &&
     value.archiveBytes > 0 &&
     value.archiveBytes <= 512 * 1024 * 1024 &&
-    value.hermesVersion === "0.20.4" &&
+    value.hermesVersion === "0.21.1" &&
     /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/.test(value?.sourceProfileId ?? "");
   const boundedSnapshotIdentity = (value) =>
     /^[A-Za-z0-9][A-Za-z0-9_./:-]{0,255}$/.test(value ?? "");
@@ -1141,9 +1141,7 @@ export function createFlyCustomerControlClient({
           operationId: expected.operationId,
         }
       : { schemaVersion: "sellable-hermes-snapshot-get/v1" };
-    const search = isV2
-      ? `?${new URLSearchParams(body).toString()}`
-      : "";
+    const search = isV2 ? `?${new URLSearchParams(body).toString()}` : "";
     const result = await memorySnapshotControl(
       "GET",
       body,

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

@@ -1167,6 +1167,129 @@ export function patchHermesSourceFile(patchKind, source) {
     );
   }
 
+  // Hermes 0.21 split configuration, MCP dispatch, and turn execution into
+  // separate modules. Keep the historical contracts intact for older images.
+  if (patchKind === "gateway-config-dedicated-v021") {
+    return replaceExactlyOnce(
+      source,
+      "getenv = _getenv_str\n",
+      `${SECRET_FD_HELPER}
+def getenv(name, default=""):
+    if name == "SLACK_BOT_TOKEN" and os.getenv("SELLABLE_AGENT_RUNTIME", "") == "1":
+        return _sellable_agent_read_slack_secret(9, "SLACK_BOT_TOKEN", "xoxb-")
+    return _getenv_str(name, default)
+`,
+      "v0.21 dedicated config credential reader"
+    );
+  }
+
+  if (patchKind === "slack-adapter-dedicated-v021") {
+    let patched = replaceExactlyOnce(
+      source,
+      "logger = logging.getLogger(__name__)\n",
+      `logger = logging.getLogger(__name__)\n${SECRET_FD_HELPER}${SLACK_DEDICATED_TEST_API_HELPER}${SLACK_MESSAGE_UNFURL_FILE_HELPER}`,
+      "v0.21 dedicated Slack helpers"
+    );
+    patched = replaceExactlyOnce(
+      patched,
+      '            app_token = get_secret("SLACK_APP_TOKEN")',
+      '            app_token = (_sellable_agent_read_slack_secret(8, "SLACK_APP_TOKEN", "xapp-")\n                         if os.getenv("SELLABLE_AGENT_RUNTIME", "") == "1"\n                         else get_secret("SLACK_APP_TOKEN"))',
+      "v0.21 dedicated app credential"
+    );
+    patched = replaceExactlyOnce(
+      patched,
+      "        client = AsyncWebClient(token=token, user_agent_prefix=_HERMES_SLACK_USER_AGENT_PREFIX)",
+      "        client = AsyncWebClient(token=token, user_agent_prefix=_HERMES_SLACK_USER_AGENT_PREFIX,\n                                **_sellable_agent_slack_api_kwargs())",
+      "v0.21 Slack API client"
+    );
+    patched = replaceExactlyOnce(
+      patched,
+      "        present = tokens_file.exists()",
+      '        present = tokens_file.exists() and os.getenv("SELLABLE_AGENT_RUNTIME", "") != "1"',
+      "v0.21 OAuth file isolation"
+    );
+    patched = replaceExactlyOnce(
+      patched,
+      "            scope_id=str(team_id) if team_id else None,\n            # Workflow/app posts",
+      "            scope_id=str(team_id) if team_id else None,\n            message_id=ts,\n            # Workflow/app posts",
+      "v0.21 Slack source identity"
+    );
+    return replaceExactlyOnce(
+      patched,
+      '        for f in event.get("files", []):',
+      [
+        '        files = list(event.get("files") or [])',
+        "        files.extend(await _sellable_agent_recover_slack_message_unfurl_files(",
+        '            self, event.get("attachments") or [], channel_id, team_id, files))',
+        "        for f in files:",
+      ].join("\n"),
+      "v0.21 unfurled file recovery"
+    );
+  }
+
+  if (patchKind === "mcp-tool-endpoint-v021") {
+    let patched = replaceExactlyOnce(
+      source,
+      'logger = logging.getLogger("tools.mcp_tool")\n',
+      `logger = logging.getLogger("tools.mcp_tool")\nimport os\n${MCP_ENDPOINT_META_HELPER_OPTIONAL_SESSION}`,
+      "v0.21 MCP metadata helper"
+    );
+    return replaceExactlyOnce(
+      patched,
+      "    _call_coro = server.session.call_tool(tool_name, arguments=args)",
+      [
+        "    sellable_meta = _sellable_agent_call_meta()",
+        '    call_kwargs = {"arguments": args}',
+        "    if sellable_meta is not None:",
+        '        call_kwargs["meta"] = sellable_meta',
+        "    _call_coro = server.session.call_tool(tool_name, **call_kwargs)",
+      ].join("\n"),
+      "v0.21 MCP call metadata"
+    );
+  }
+
+  if (patchKind === "gateway-session-v021") {
+    return replaceExactlyOnce(
+      source,
+      "            session_key=context.session_key,\n",
+      `            # ${HERMES_AGENT_BRIDGE_MARKER}: durable conversation identity.
+            session_key=context.session_key,
+            session_id=context.session_id,
+`,
+      "v0.21 durable session identity"
+    );
+  }
+
+  if (patchKind === "gateway-provider-preflight-v021") {
+    let patched = replaceExactlyOnce(
+      source,
+      'logger = logging.getLogger("gateway.run")\n',
+      `logger = logging.getLogger("gateway.run")\nimport os\nimport concurrent.futures\n${V020_PROVIDER_PREFLIGHT_HELPER}`,
+      "v0.21 provider helper"
+    );
+    return replaceExactlyOnce(
+      patched,
+      "        max_iterations = _current_max_iterations()\n",
+      "        max_iterations = _current_max_iterations()\n        _sellable_agent_preflight_model_providers()\n",
+      "v0.21 provider preflight"
+    );
+  }
+
+  if (patchKind === "turn-context-v021") {
+    let patched = replaceExactlyOnce(
+      source,
+      "logger = logging.getLogger(__name__)\n",
+      `logger = logging.getLogger(__name__)\n${V020_SOUL_TURN_PROLOGUE_HELPER}`,
+      "v0.21 SOUL helper"
+    );
+    return replaceExactlyOnce(
+      patched,
+      "    # System prompt is cached per session for prefix caching.\n    if agent._cached_system_prompt is None:\n        restore_or_build_system_prompt(agent, system_message, conversation_history)",
+      "    # System prompt is cached per session for prefix caching.\n    _sellable_agent_restore_or_build_proven_soul(\n        agent, system_message, conversation_history, restore_or_build_system_prompt,\n    )",
+      "v0.21 SOUL turn boundary"
+    );
+  }
+
   if (patchKind === "gateway-config") {
     let patched = replaceExactlyOnce(
       source,
@@ -1670,7 +1793,10 @@ export function patchHermesSourceFile(patchKind, source) {
     return patched;
   }
 
-  if (patchKind === "skills-cache-freshness-v020") {
+  if (
+    patchKind === "skills-cache-freshness-v020" ||
+    patchKind === "skills-cache-freshness-v021"
+  ) {
     let patched = replaceExactlyOnce(
       source,
       "        sig.append((str(d), m))",
@@ -1706,8 +1832,12 @@ export function patchHermesSourceFile(patchKind, source) {
     );
     patched = replaceExactlyOnce(
       patched,
-      "                if name in disabled:\n                    continue",
-      "                if name in filtered_disabled:\n                    continue",
+      patchKind === "skills-cache-freshness-v021"
+        ? "                if name in seen_names or name in disabled:\n                    continue"
+        : "                if name in disabled:\n                    continue",
+      patchKind === "skills-cache-freshness-v021"
+        ? "                if name in seen_names or name in filtered_disabled:\n                    continue"
+        : "                if name in filtered_disabled:\n                    continue",
       "v0.20 filtered disabled behavior"
     );
     patched = replaceExactlyOnce(
@@ -1727,7 +1857,10 @@ export function patchHermesSourceFile(patchKind, source) {
     return patched;
   }
 
-  if (patchKind === "skills-prompt-freshness-v020") {
+  if (
+    patchKind === "skills-prompt-freshness-v020" ||
+    patchKind === "skills-prompt-freshness-v021"
+  ) {
     let patched = replaceExactlyOnce(
       source,
       "_SKILLS_PROMPT_CACHE_LOCK = threading.Lock()",
@@ -1775,9 +1908,14 @@ export function patchHermesSourceFile(patchKind, source) {
     );
     patched = replaceExactlyOnce(
       patched,
-      "        tuple(sorted(compact_categories or ())),\n    )\n    with _SKILLS_PROMPT_CACHE_LOCK:\n        cached = _SKILLS_PROMPT_CACHE.get(cache_key)",
+      (patchKind === "skills-prompt-freshness-v021"
+        ? "        _platform_hint, tuple(sorted(disabled)), tuple(sorted(compact_categories or ())),"
+        : "        tuple(sorted(compact_categories or ())),") +
+        "\n    )\n    with _SKILLS_PROMPT_CACHE_LOCK:\n        cached = _SKILLS_PROMPT_CACHE.get(cache_key)",
       [
-        "        tuple(sorted(compact_categories or ())),",
+        patchKind === "skills-prompt-freshness-v021"
+          ? "        _platform_hint, tuple(sorted(disabled)), tuple(sorted(compact_categories or ())),"
+          : "        tuple(sorted(compact_categories or ())),",
         "        live_signature,",
         "    )",
         "    global _SELLABLE_AGENT_SKILLS_PROMPT_SIGNATURE",
@@ -2061,6 +2199,72 @@ export const HERMES_AGENT_BRIDGE_DEDICATED_V020_CONTRACT = normalizeContract({
   ],
 });
 
+export const HERMES_AGENT_BRIDGE_DEDICATED_V021_CONTRACT = normalizeContract({
+  "bridgeId": "sellable-agent-hermes-bridge/v1",
+  "hermesVersion": "0.21.1",
+  "versionFile": {
+    "path": "hermes_cli/__init__.py",
+    "sha256": "efae023ac37622277aac298ac15c646b855e870132c38970feeda9552f1ecc27"
+  },
+  "files": [
+    {
+      "path": "gateway/config_env.py",
+      "patchKind": "gateway-config-dedicated-v021",
+      "sourceSha256": "984ae7b68befecd52fc17b6d38e763f40c7040a2ba69ed4a2c39f1a88ae6734a",
+      "patchedSha256": "0180fbcb1df6e5a7651f172c492a8e317f7455c8ed0e955c7a4f0488fa23b6c2"
+    },
+    {
+      "path": "plugins/platforms/slack/adapter.py",
+      "patchKind": "slack-adapter-dedicated-v021",
+      "sourceSha256": "23048a107304993686250af044256199be2f73171bb5b4cca6a900ea272a6064",
+      "patchedSha256": "bc05fd5f227e42f733ee78c80ffab6c7c53840975fc5bc9755aa2ef8f2c8ff47"
+    },
+    {
+      "path": "tools/mcp_tool_handlers.py",
+      "patchKind": "mcp-tool-endpoint-v021",
+      "sourceSha256": "e6af250f0fbfeb12a936c340a46f40f8d40332ed8bbc4eb63fded66e37aaa7bf",
+      "patchedSha256": "2dae40d821eb6b8986251d10161dbcc9de009628041f282cc6fc2b4d0787a765"
+    },
+    {
+      "path": "gateway/run.py",
+      "patchKind": "gateway-session-v021",
+      "sourceSha256": "3b1f670243d4932ac1f2a2a68bee61a8c7f9bcdac7bd48d43289db90f17bab67",
+      "patchedSha256": "2e25d50add6c49748b2cdd4c2bd115039e72c0b4eeb9c882eb1cd07a2a25c304"
+    },
+    {
+      "path": "gateway/run_turn_runner.py",
+      "patchKind": "gateway-provider-preflight-v021",
+      "sourceSha256": "8ebd74318db2259ac52c35dbf9568b98dbb19c1d2e30289f4efc76a12ac8ceeb",
+      "patchedSha256": "26a13f167835036c37ff92da3c1d036267544cf8a6529f5d40c3ee0ae58fa1cb"
+    },
+    {
+      "path": "agent/turn_context.py",
+      "patchKind": "turn-context-v021",
+      "sourceSha256": "d1a84a24c5b50a7a866268fde453694c6b98790e31d7d4310d8756027149863a",
+      "patchedSha256": "e039fa0e814fc8c3963269c13ed3aab290997428509a8c7c756dac19d3b1ab7a"
+    },
+    {
+      "path": "cron/scheduler.py",
+      "patchKind": "cron-scheduler-v020",
+      "sourceSha256": "f1891e94697ccf5f7b66ae7788345368b452af447fbc43356ae5376a3c753518",
+      "patchedSha256": "977197af3b3dca572b0ed94089c05ae4d2748cce795e11247c5ca2a6ba20dc2c"
+    },
+    {
+      "path": "tools/skills_tool.py",
+      "patchKind": "skills-cache-freshness-v021",
+      "sourceSha256": "0f205b8c2d9266d272d8c6cae3d189b86a5aebce98f03b61605d266b65f9497c",
+      "patchedSha256": "8696b37ef58c0cc570c437abac730ac0e670e44365ddeae452ad40a501f13a1b"
+    },
+    {
+      "path": "agent/prompt_builder.py",
+      "patchKind": "skills-prompt-freshness-v021",
+      "sourceSha256": "83160fab72772012bc308bc730a0085e7acb126f1bea49d62f990505f00ce677",
+      "patchedSha256": "6ab2aa30e06b124333d28ed73fc7b56394fbc71f040f3387f6fbc835d799f266"
+    }
+  ],
+  "contractDigest": "a77ab3480e335d52dde12b50c9c7ace29419f02ec3e13fe1678126ec4aed6cce"
+});
+
 function assertRelativeContractPath(path) {
   if (
     !path ||

package/lib/sellable-agent/hermes-memory-snapshot.mjs

@@ -123,7 +123,7 @@ const LEGACY_HERMES_SNAPSHOT_SCRIPT = "scripts/hermes-memory-reconcile.sh";
 
 const HERMES = "/opt/hermes/.venv/bin/hermes";
 const HERMES_PYTHON = "/opt/hermes/.venv/bin/python";
-const VERSION = "0.20.4";
+const VERSION = "0.21.1";
 const ID = /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/;
 const BOUNDED_ID = /^[A-Za-z0-9][A-Za-z0-9_./:-]{0,255}$/;
 const SHA256 = /^[a-f0-9]{64}$/;

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.721";
+const INSTALLER_PACKAGE = "@sellable/install@0.1.722-wip.hermes.20260909.1";
 const MCP_PACKAGE = "@sellable/mcp@0.1.915";
 const HERMES_VERSION = "0.18.0";
 const SHA256 = /^[a-f0-9]{64}$/;

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

@@ -1546,8 +1546,7 @@ export function compileClaimToProfileDesired(activeClaim, config) {
       ]) ||
       pinned.hermesCli !== "hermes" ||
       pinned.hermesVersion !== "0.18.0" ||
-      pinned.installerPackage !==
-        "@sellable/install@0.1.721" ||
+      pinned.installerPackage !== "@sellable/install@0.1.722-wip.hermes.20260909.1" ||
       pinned.mcpPackage !== "@sellable/mcp@0.1.915" ||
       !Array.isArray(policy.toolInclude) ||
       policy.toolInclude.length === 0 ||

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

@@ -282,8 +282,7 @@ function validateDesired(desired) {
     desired.serviceCredentialGeneration < 1 ||
     desired.hermesCli !== "hermes" ||
     desired.hermesVersion !== "0.18.0" ||
-    desired.installerPackage !==
-      "@sellable/install@0.1.721" ||
+    desired.installerPackage !== "@sellable/install@0.1.722-wip.hermes.20260909.1" ||
     desired.mcpPackage !== "@sellable/mcp@0.1.915" ||
     !Array.isArray(desired.toolInclude) ||
     desired.toolInclude.length === 0 ||
@@ -2520,7 +2519,7 @@ function validateNativeSlackDesired(desired) {
     !SHA256.test(desired.accessPolicyHash ?? "") ||
     !SHA256.test(desired.runtimeDesiredHash ?? "") ||
     !FINGERPRINT.test(desired.apiServerKeyFingerprint ?? "") ||
-    desired.hermesVersion !== "0.20.4" ||
+    desired.hermesVersion !== "0.21.1" ||
     !/^@sellable\/install@\d+\.\d+\.\d+(?:[-.A-Za-z0-9]+)?$/.test(
       desired.installerPackage ?? ""
     ) ||

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

@@ -25,8 +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.721";
+export const PINNED_INSTALL_PACKAGE = "@sellable/install@0.1.722-wip.hermes.20260909.1";
 export const PINNED_MCP_PACKAGE = "@sellable/mcp@0.1.915";
 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.721",
+  "version": "0.1.722-wip.hermes.20260909.1",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code, Codex, and Hermes",
   "bin": {