@sellable/install 0.1.689 → 0.1.691

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.689
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.691
 ARG MCP_PACKAGE=@sellable/mcp@0.1.901
 ARG INSTALLER_INTEGRITY
 ARG MCP_INTEGRITY=sha512-0YBT2d3YBgZFSgEcmoDCNLz/PWMiBbqMWeZoEFArWuk63/vrYATEp/qBNzYhpy7SKClLapsb1RRagdXrvo/p9g==
 
-RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.689" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.691" \
     && test "${MCP_PACKAGE}" = "@sellable/mcp@0.1.901" \
     && 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.689" \
     && 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.689' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.901') 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.691' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.901') 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.689', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.901', 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.691', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.901', 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.689` is
+`@sellable/install@0.1.691` is
 published:
 
 ```sh

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

@@ -107,6 +107,7 @@ import {
   reconcileHermesModelAuth,
 } from "../model-auth-reconciler.mjs";
 import { createModelHealthReporter } from "../model-health-reporter.mjs";
+import { createMcpAdminRuntimeBindingV3 } from "../mcp-runtime-binding.mjs";
 import { createAdminRuntimePhaseTelemetry } from "./admin-runtime-phase-telemetry.mjs";
 import {
   completeAdminStateReceiptRecovery,
@@ -784,6 +785,28 @@ function profilePackageReceipt(
   };
 }
 
+function installAdminMcpRuntimeBinding(
+  profileRoot,
+  profileId,
+  agentServiceEnv
+) {
+  const serviceCredentialGeneration = Number(
+    agentServiceEnv.SELLABLE_AGENT_CREDENTIAL_GENERATION
+  );
+  const binding = createMcpAdminRuntimeBindingV3({
+    workspaceId: agentServiceEnv.SELLABLE_AGENT_WORKSPACE_ID,
+    agentId: agentServiceEnv.SELLABLE_AGENT_ID,
+    runtimeId: RUNTIME_ID,
+    profileId,
+    serviceCredentialGeneration,
+    runtimeGeneration: RUNTIME_GENERATION,
+  });
+  atomicPrivateFile(
+    join(profileRoot, "sellable", "runtime-binding.json"),
+    `${JSON.stringify(binding, null, 2)}\n`
+  );
+}
+
 function installAdminModelConfig(profileRoot, modelConfig) {
   const path = join(profileRoot, "config.yaml");
   const stat = lstatSync(path);
@@ -1180,6 +1203,7 @@ async function materializeAdminProfile({
       installAdminModelConfig(stageRoot, modelConfig);
       installAdminHermesMemoryHook(stageRoot);
       stageAdminRuntimeTree(stageRoot);
+      installAdminMcpRuntimeBinding(stageRoot, profile, agentServiceEnv);
       return stage;
     });
 

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

@@ -8,7 +8,7 @@ ENV PLAYWRIGHT_BROWSERS_PATH=/opt/hermes/.playwright
 
 ARG MCP_PACKAGE=@sellable/mcp@0.1.901
 ARG MCP_INTEGRITY=sha512-0YBT2d3YBgZFSgEcmoDCNLz/PWMiBbqMWeZoEFArWuk63/vrYATEp/qBNzYhpy7SKClLapsb1RRagdXrvo/p9g==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.689
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.691
 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

@@ -105,7 +105,7 @@ const RUNTIME_GENERATION = Number(
 const BOOT_SESSION_ID = randomUUID();
 const HERMES_VERSION = process.env.SELLABLE_AGENT_HERMES_VERSION ?? "0.20.4";
 const INSTALLER_PACKAGE =
-  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.689";
+  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.691";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.901";
 const DEFAULT_PROFILE_BUNDLE_ROOT =

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

@@ -67,12 +67,26 @@ function exactObject(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 
-function safeTimestamp(value) {
-  return (
+function normalizedTimestamp(value) {
+  if (
     typeof value === "string" &&
     value.length <= 64 &&
     Number.isFinite(Date.parse(value))
-  );
+  ) {
+    return value;
+  }
+  // Hermes 0.20.4'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 (
+    typeof value === "number" &&
+    Number.isFinite(value) &&
+    value >= 946_684_800 &&
+    value <= 4_102_444_800
+  ) {
+    return new Date(value * 1_000).toISOString();
+  }
+  return null;
 }
 
 function evidence(code, value, extra = {}) {
@@ -325,13 +339,14 @@ export function sanitizeHermesRunEvent(value, options = {}) {
   if (bytes(encoded) > MAX_EVENT_BYTES || !exactObject(value)) {
     return evidence("NATIVE_EVENT_UNKNOWN", value, { ordinal });
   }
+  const timestamp = normalizedTimestamp(value.timestamp);
   const required = KNOWN_EVENT_KEYS[value.event];
   if (
     !required ||
     required.some((key) => !(key in value)) ||
     value.run_id !== expectedRunId ||
     !RUN_ID.test(value.run_id ?? "") ||
-    !safeTimestamp(value.timestamp)
+    !timestamp
   ) {
     return evidence("NATIVE_EVENT_UNKNOWN", value, { ordinal });
   }
@@ -339,7 +354,7 @@ export function sanitizeHermesRunEvent(value, options = {}) {
     ok: true,
     event: value.event,
     runId: expectedRunId,
-    timestamp: value.timestamp,
+    timestamp,
     nativeEventIdentity: sha256(`${ordinal}\n${encoded}`),
   };
   if (value.event === "approval.request") {

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.689";
+const INSTALLER_PACKAGE = "@sellable/install@0.1.691";
 const MCP_PACKAGE = "@sellable/mcp@0.1.901";
 const HERMES_VERSION = "0.18.0";
 const SHA256 = /^[a-f0-9]{64}$/;

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

@@ -1547,7 +1547,7 @@ export function compileClaimToProfileDesired(activeClaim, config) {
       pinned.hermesCli !== "hermes" ||
       pinned.hermesVersion !== "0.18.0" ||
       pinned.installerPackage !==
-        "@sellable/install@0.1.689" ||
+        "@sellable/install@0.1.691" ||
       pinned.mcpPackage !== "@sellable/mcp@0.1.901" ||
       !Array.isArray(policy.toolInclude) ||
       policy.toolInclude.length === 0 ||

package/lib/sellable-agent/mcp-context-proxy.mjs

@@ -6,7 +6,6 @@ import {
   constants,
   existsSync,
   fsyncSync,
-  linkSync,
   lstatSync,
   openSync,
   readFileSync,
@@ -712,21 +711,20 @@ function activateOrRefreshEndpointSession({
       return { ok: false, code: "endpoint_session_not_applicable" };
     }
     if (state.body && !endpointSessionBodyMatches(state.body, valid.body)) {
-      // Hermes keeps one stdio MCP transport alive across sequential API
-      // endpoint runs. A descriptor for the next run is therefore expected to
-      // meet an already-activated proxy session occasionally. Preserve that
-      // verified descriptor without replacing any newer heartbeat refresh,
-      // then use Hermes' narrow transport-expiry recovery path to rebuild the
-      // proxy with a fresh endpoint session. The nonce is intentionally not
-      // burned until that fresh session claims the descriptor.
-      try {
-        linkSync(claimedPath, descriptorPath);
-      } catch (error) {
-        if (error?.code !== "EEXIST") {
-          return { ok: false, code: "endpoint_descriptor_restore_failed" };
-        }
+      // Hermes deliberately reuses one stdio MCP transport across sequential
+      // endpoint runs. Rotate that transport in place after proving the next
+      // server-signed descriptor against the runtime binding. Returning a
+      // synthetic transport-expired error here made Hermes mark the Sellable
+      // MCP unavailable mid-conversation, so the following reviewed Calendar
+      // read never reached the backend. The nonce is burned before the session
+      // pointer moves, preserving the exact same single-use fence as first
+      // activation; a stale or replayed descriptor still fails closed.
+      if (!burnNonce(consumedRoot, valid.body.nonce)) {
+        return { ok: false, code: "descriptor_replayed" };
       }
-      return { ok: false, code: "endpoint transport session expired" };
+      state.body = Object.freeze({ ...valid.body });
+      state.activated = true;
+      return { ok: true, body: state.body };
     }
     if (!burnNonce(consumedRoot, valid.body.nonce)) {
       return { ok: false, code: "descriptor_replayed" };

package/lib/sellable-agent/mcp-runtime-binding.mjs

@@ -20,6 +20,17 @@ const RUNTIME_BINDING_V1_KEYS = Object.freeze([
   "memberAllowlist",
 ]);
 
+export const ADMIN_RUNTIME_BINDING_V3_KEYS = Object.freeze([
+  "schemaVersion",
+  "runtimeMode",
+  "workspaceId",
+  "agentId",
+  "runtimeId",
+  "profileId",
+  "serviceCredentialGeneration",
+  "runtimeGeneration",
+]);
+
 export const RUNTIME_BINDING_V2_KEYS = Object.freeze([
   "schemaVersion",
   "runtimeMode",
@@ -87,6 +98,28 @@ function validScope(values, { allowEmpty = false } = {}) {
 }
 
 export function validateMcpRuntimeBinding(binding) {
+  if (
+    exactKeys(binding, ADMIN_RUNTIME_BINDING_V3_KEYS) &&
+    binding.schemaVersion === "sellable-agent-mcp-runtime-binding/v3"
+  ) {
+    for (const key of [
+      "workspaceId",
+      "agentId",
+      "runtimeId",
+      "profileId",
+    ]) {
+      if (typeof binding[key] !== "string" || !SAFE_ID.test(binding[key])) {
+        return false;
+      }
+    }
+    return Boolean(
+      binding.runtimeMode === "native_admin" &&
+        Number.isSafeInteger(binding.serviceCredentialGeneration) &&
+        binding.serviceCredentialGeneration > 0 &&
+        Number.isSafeInteger(binding.runtimeGeneration) &&
+        binding.runtimeGeneration > 0
+    );
+  }
   if (
     exactKeys(binding, RUNTIME_BINDING_V2_KEYS) &&
     binding.schemaVersion === "sellable-agent-mcp-runtime-binding/v2"
@@ -152,6 +185,23 @@ export function validateMcpRuntimeBinding(binding) {
   );
 }
 
+export function createMcpAdminRuntimeBindingV3(input) {
+  const binding = {
+    schemaVersion: "sellable-agent-mcp-runtime-binding/v3",
+    runtimeMode: "native_admin",
+    workspaceId: input.workspaceId,
+    agentId: input.agentId,
+    runtimeId: input.runtimeId,
+    profileId: input.profileId,
+    serviceCredentialGeneration: input.serviceCredentialGeneration,
+    runtimeGeneration: input.runtimeGeneration,
+  };
+  if (!validateMcpRuntimeBinding(binding)) {
+    throw new Error("mcp_admin_runtime_binding_v3_invalid");
+  }
+  return binding;
+}
+
 export function createMcpRuntimeBindingV2(desired) {
   const binding = {
     schemaVersion: "sellable-agent-mcp-runtime-binding/v2",

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

@@ -283,7 +283,7 @@ function validateDesired(desired) {
     desired.hermesCli !== "hermes" ||
     desired.hermesVersion !== "0.18.0" ||
     desired.installerPackage !==
-      "@sellable/install@0.1.689" ||
+      "@sellable/install@0.1.691" ||
     desired.mcpPackage !== "@sellable/mcp@0.1.901" ||
     !Array.isArray(desired.toolInclude) ||
     desired.toolInclude.length === 0 ||

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