@sellable/install 0.1.527 → 0.1.529-wip.phase169.20260806.3

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.527
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.529-wip.phase169.20260806.3
 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.527" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.529-wip.phase169.20260806.3" \
     && 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.527" \
     && 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.527' || 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.529-wip.phase169.20260806.3' || 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.527', 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.529-wip.phase169.20260806.3', 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.527` is
+`@sellable/install@0.1.529-wip.phase169.20260806.3` is
 published:
 
 ```sh
 docker build --platform linux/amd64 \
   --build-arg INSTALLER_INTEGRITY='sha512-…' \
-  --tag sellable-agent-host:0.1.527 .
+  --tag sellable-agent-host:0.1.529-wip.phase169.20260806.3 .
 ```
 
 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

@@ -2261,6 +2261,7 @@ export async function runAdminCanary() {
       bundleGeneration: 1,
       policyHash: "a".repeat(64),
       credentialPoolStrategy: "fill_first",
+      runtime: { apiMaxRetries: 0, requestTimeoutSeconds: 60 },
       codex: [
         {
           slotId: "dittto-primary",

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

@@ -5,7 +5,7 @@ USER root
 
 ARG MCP_PACKAGE=@sellable/mcp@0.1.811-wip.phase169.20260805145230
 ARG MCP_INTEGRITY=sha512-ygNtAiYCdMM3dlTZHMiaAo5aasw4cuhphkxHSvHzF4T9FRFgR3BQodKCsqYz7EfN0nHrDUnsrzcjWedYFQUT0A==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.527
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.529-wip.phase169.20260806.3
 ARG TUS_JS_CLIENT_VERSION=4.3.1
 ARG HERMES_VERSION=0.20.0
 ARG MCP_TRUST_ROOT_B64

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

@@ -79,7 +79,7 @@ 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.527";
+  "@sellable/install@0.1.529-wip.phase169.20260806.3";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ??
   "@sellable/mcp@0.1.811-wip.phase169.20260805145230";

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

@@ -336,6 +336,16 @@ def _sellable_agent_call_meta():
     }
 `;
 
+const MCP_META_HELPER_OPTIONAL_SESSION = MCP_META_HELPER
+  .replace(
+    '    if platform != "slack" or not channel_id or not requester_id or not message_id or not session_id:\n        raise RuntimeError("Sellable MCP calls require a bound Slack requester, channel, message, and session")\n',
+    '    if platform != "slack" or not channel_id or not requester_id or not message_id:\n        raise RuntimeError("Sellable MCP calls require a bound Slack requester, channel, and message")\n'
+  )
+  .replace(
+    '    return {\n        "sellableAgent": {\n            "requesterId": requester_id,\n            "channelId": channel_id,\n            "providerRequestId": message_id,\n            "sessionId": session_id,\n        }\n    }\n',
+    '    sellable_agent = {\n        "requesterId": requester_id,\n        "channelId": channel_id,\n        "providerRequestId": message_id,\n    }\n    if session_id:\n        sellable_agent["sessionId"] = session_id\n    return {"sellableAgent": sellable_agent}\n'
+  );
+
 const V020_SOUL_TURN_PROLOGUE_HELPER = `
 # ${HERMES_AGENT_BRIDGE_MARKER}: apply only the proven live SOUL at a turn boundary.
 _SELLABLE_AGENT_SOUL_SESSION_HASHES = {}
@@ -1058,11 +1068,15 @@ export function patchHermesSourceFile(patchKind, source) {
     return patched;
   }
 
-  if (patchKind === "mcp-tool") {
+  if (patchKind === "mcp-tool" || patchKind === "mcp-tool-v020") {
+    const metaHelper =
+      patchKind === "mcp-tool-v020"
+        ? MCP_META_HELPER_OPTIONAL_SESSION
+        : MCP_META_HELPER;
     let patched = replaceExactlyOnce(
       source,
       "logger = logging.getLogger(__name__)\n",
-      `logger = logging.getLogger(__name__)\n${MCP_META_HELPER}`,
+      `logger = logging.getLogger(__name__)\n${metaHelper}`,
       "MCP metadata helper"
     );
     patched = replaceExactlyOnce(
@@ -1080,6 +1094,25 @@ export function patchHermesSourceFile(patchKind, source) {
     return patched;
   }
 
+  if (patchKind === "gateway-session-v020") {
+    return replaceExactlyOnce(
+      source,
+      [
+        "            session_key=context.session_key,",
+        "            message_id=str(context.source.message_id) if context.source.message_id else \"\",",
+      ].join("\n"),
+      [
+        "            session_key=context.session_key,",
+        "            # Bind the durable Hermes conversation ID alongside the Slack actor.",
+        "            # Sellable MCP SOUL calls require this task-local identity, and omitting",
+        "            # it must not make otherwise valid Slack MCP calls fail closed.",
+        "            session_id=context.session_id,",
+        "            message_id=str(context.source.message_id) if context.source.message_id else \"\",",
+      ].join("\n"),
+      "v0.20 gateway durable session identity"
+    );
+  }
+
   if (patchKind === "turn-context-v020") {
     let patched = replaceExactlyOnce(
       source,
@@ -1328,11 +1361,19 @@ export const HERMES_AGENT_BRIDGE_DEDICATED_V020_CONTRACT = normalizeContract({
     },
     {
       path: "tools/mcp_tool.py",
-      patchKind: "mcp-tool",
+      patchKind: "mcp-tool-v020",
       sourceSha256:
         "f9d50eec7b98819fa91b8ce640c8a32eff0726e0f349832763852bd82bbbb958",
       patchedSha256:
-        "0cea69c0d72afd7c3eb65afafbfa0d2ba43a865118d169733df71105ccfb094f",
+        "34fa3946e7012c8b5d405f7a55897241d629afd2ceff45bd7e6746877f749e3c",
+    },
+    {
+      path: "gateway/run.py",
+      patchKind: "gateway-session-v020",
+      sourceSha256:
+        "0b749a90ff5740b5c8ce9d138f869aca19295f4c458e3b680e9be9fd7b0fb2ec",
+      patchedSha256:
+        "c2eba580b98c9b4088580930e4045046d835efd9cd88e20391dd9c1f24d930ca",
     },
     {
       path: "agent/turn_context.py",

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.527";
+const INSTALLER_PACKAGE = "@sellable/install@0.1.529-wip.phase169.20260806.3";
 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

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

package/lib/sellable-agent/model-auth-reconciler.mjs

@@ -17,8 +17,6 @@ export const MODEL_AUTH_MINIMUM_VALIDITY_MS = 20 * 60 * 1000;
 export const MODEL_AUTH_PROVIDER = "openai-codex";
 export const MODEL_AUTH_DEFAULT_MODEL = "gpt-5.6-sol";
 export const MODEL_AUTH_REASONING_EFFORT = "high";
-export const MODEL_AUTH_REQUEST_TIMEOUT_SECONDS = 60;
-export const MODEL_AUTH_API_MAX_RETRIES = 1;
 
 const MARKER_VERSION = 2;
 const SHA256 = /^[a-f0-9]{64}$/;
@@ -36,9 +34,14 @@ const RUNTIME_KEYS = Object.freeze([
   "bundleGeneration",
   "policyHash",
   "credentialPoolStrategy",
+  "runtime",
   "codex",
   "openrouter",
 ]);
+const RUNTIME_BEHAVIOR_KEYS = Object.freeze([
+  "apiMaxRetries",
+  "requestTimeoutSeconds",
+]);
 const SLOT_KEYS = Object.freeze([
   "slotId",
   "priority",
@@ -294,10 +297,21 @@ export function parseModelAuthRuntimeCredential(secret, options = {}) {
     !SHA256.test(value.policyHash ?? "") ||
     !Array.isArray(value.codex) ||
     value.codex.length !== 2 ||
+    !exactKeys(value.runtime, RUNTIME_BEHAVIOR_KEYS) ||
     !exactKeys(value.openrouter, OPENROUTER_KEYS)
   ) {
     fail("model_auth_projection_incomplete");
   }
+  if (
+    !Number.isInteger(value.runtime.apiMaxRetries) ||
+    value.runtime.apiMaxRetries < 0 ||
+    value.runtime.apiMaxRetries > 2 ||
+    !Number.isInteger(value.runtime.requestTimeoutSeconds) ||
+    value.runtime.requestTimeoutSeconds < 1 ||
+    value.runtime.requestTimeoutSeconds > 60
+  ) {
+    fail("model_auth_projection_incomplete");
+  }
   const nowValue = options.now ?? new Date();
   const nowMs =
     nowValue instanceof Date ? nowValue.getTime() : Number(nowValue);
@@ -368,13 +382,15 @@ export function modelAuthConfigOverlay(credential) {
     // attempts can keep a slow-but-open provider leg alive for five minutes.
     // The ordered provider/model chain is the retry strategy for these
     // runtimes, so bound each leg once and advance instead of retrying it.
-    agent: Object.freeze({ api_max_retries: MODEL_AUTH_API_MAX_RETRIES }),
+    agent: Object.freeze({
+      api_max_retries: credential.value.runtime.apiMaxRetries,
+    }),
     providers: Object.freeze({
       "openai-codex": Object.freeze({
-        request_timeout_seconds: MODEL_AUTH_REQUEST_TIMEOUT_SECONDS,
+        request_timeout_seconds: credential.value.runtime.requestTimeoutSeconds,
       }),
       openrouter: Object.freeze({
-        request_timeout_seconds: MODEL_AUTH_REQUEST_TIMEOUT_SECONDS,
+        request_timeout_seconds: credential.value.runtime.requestTimeoutSeconds,
       }),
     }),
     model: Object.freeze({

package/lib/sellable-agent/model-health-reporter.mjs

@@ -126,7 +126,13 @@ function safeSnapshot(snapshot) {
 
 function codexHealthState(slot) {
   if (slot.state === "ok") return "HEALTHY";
-  if (slot.state === "exhausted") return "REFRESHING";
+  if (slot.state === "exhausted") {
+    return /(?:usage[_-]?limit[_-]?reached|quota|credits?|billing|subscription)/i.test(
+      slot.lastErrorReason ?? ""
+    )
+      ? "EXHAUSTED"
+      : "REFRESHING";
+  }
   if (/revok/.test(slot.lastErrorReason ?? "")) return "REVOKED";
   if (/(?:auth|unauthor|invalid|expired)/.test(slot.lastErrorReason ?? "")) {
     return "REAUTH_REQUIRED";

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

@@ -200,7 +200,7 @@ function validateDesired(desired) {
     desired.hermesCli !== "hermes" ||
     desired.hermesVersion !== "0.18.0" ||
     desired.installerPackage !==
-      "@sellable/install@0.1.527" ||
+      "@sellable/install@0.1.529-wip.phase169.20260806.3" ||
     desired.mcpPackage !==
       "@sellable/mcp@0.1.760-wip.phase143.20260727100513" ||
     !Array.isArray(desired.toolInclude) ||

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

@@ -26,7 +26,7 @@ import { deriveContainedProfileId } from "./profile-materializer.mjs";
 
 export const PROVISIONING_ACTION = "PROVISION_HERMES_PROFILE";
 export const PINNED_INSTALL_PACKAGE =
-  "@sellable/install@0.1.527";
+  "@sellable/install@0.1.529-wip.phase169.20260806.3";
 export const PINNED_MCP_PACKAGE =
   "@sellable/mcp@0.1.760-wip.phase143.20260727100513";
 
@@ -613,7 +613,7 @@ function inspectProvisionedProfile({
       !matchesReadback(manifest, request) ||
       manifest.serviceCredentialReference !== serviceCredentialReference ||
       manifest.installerPackage !== PINNED_INSTALL_PACKAGE ||
-      manifest.installerVersion !== "0.1.527" ||
+      manifest.installerVersion !== "0.1.529-wip.phase169.20260806.3" ||
       manifest.mcpPackage !== PINNED_MCP_PACKAGE ||
       manifest.credentialKeyVersion !== credentialKeyVersion ||
       !/^[a-f0-9]{16}$/.test(manifest.credentialFingerprint) ||
@@ -827,7 +827,7 @@ function successReceipt({
     subject: `agent-profile:${observed.profileId}`,
     cli: {
       installPackage: PINNED_INSTALL_PACKAGE,
-      installVersion: "0.1.527",
+      installVersion: "0.1.529-wip.phase169.20260806.3",
       mcpPackage: PINNED_MCP_PACKAGE,
       command: "hermes profile bootstrap",
     },
@@ -875,7 +875,7 @@ function failure(code, stages, extra = {}, request = null) {
       : "agent-profile:unbound",
     cli: {
       installPackage: PINNED_INSTALL_PACKAGE,
-      installVersion: "0.1.527",
+      installVersion: "0.1.529-wip.phase169.20260806.3",
       mcpPackage: PINNED_MCP_PACKAGE,
       command: "hermes profile bootstrap",
     },

package/package.json

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