@sellable/install 0.1.717-wip.phase202.20260901.5 → 0.1.718

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.717-wip.phase202.20260901.5
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.718
 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.717-wip.phase202.20260901.5" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.718" \
     && 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.717-wip.phase202.202609
     && 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.717-wip.phase202.20260901.5' || 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.718' || 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.717-wip.phase202.20260901.5', 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.718', 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.717-wip.phase202.20260901.5` is
+`@sellable/install@0.1.718` is
 published:
 
 ```sh

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

@@ -756,18 +756,20 @@ function productMcpInventoryProofEnvironment() {
   const root = mkdtempSync(join(SECRET_ROOT, "mcp-inventory-proof-"));
   privateDirectory(root);
   privateDirectory(join(root, "consumed"));
+  const configPath = join(root, "sellable-config.json");
+  atomicPrivateFile(
+    configPath,
+    `${JSON.stringify({
+      apiUrl: "https://example.invalid",
+      token: "skt_live_admin_inventory_proof_nonsecret",
+    })}\n`
+  );
   return {
     root,
     env: {
       SELLABLE_AGENT_TURN_DESCRIPTOR_PATH: join(root, "turn-context.json"),
       SELLABLE_AGENT_TURN_CONSUMED_ROOT: join(root, "consumed"),
-      SELLABLE_AGENT_MCP_RUNTIME_BINDING_PATH: join(
-        root,
-        "runtime-binding.json"
-      ),
-      // Package inventory is intentionally unauthenticated. The canary config
-      // supplies its nonsecret human fixture; do not advertise a service-file
-      // intent before production secrets exist on a fresh replacement machine.
+      SELLABLE_CONFIG_PATH: configPath,
       SELLABLE_AGENT_SERVICE_CREDENTIAL_FILE: "",
     },
   };

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.915
 ARG MCP_INTEGRITY=sha512-+WdyO3WxQ9U7fHMvxBojPRDIZun/INy9mKOz/A1IcBFEWXFkpPooT0yMUzY1qCYcewTM1AUxP3p2QOtsxRIYQA==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.717-wip.phase202.20260901.5
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.718
 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

@@ -107,11 +107,10 @@ 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.717-wip.phase202.20260901.5";
+  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.718";
 const MCP_PACKAGE =
   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";
 const DEFAULT_PROFILE_CRON_PYTHON = [
@@ -1395,7 +1394,7 @@ export function createCustomerEndpointRelay(options = {}) {
   }
   const activeAttempts = new Set();
   let failures = 0;
-  const maximumConcurrentRuns = ENDPOINT_MAX_CONCURRENT_RUNS;
+  const maximumConcurrentRuns = 4;
 
   // Each redacted event is bounded to 8 KiB and the signed request is bounded
   // to 64 KiB. Six events leave room for identity/signature envelope overhead
@@ -1825,25 +1824,49 @@ export function createCustomerEndpointRelay(options = {}) {
     };
     try {
       let submitted;
-      try {
-        submitted = await runs.submit(
-          {
-            input: claim.run.input,
-            instructions: endpointRunInstructions(claim),
-            conversationHistory: endpointConversationHistory(
-              claim.run.conversationHistory
-            ),
-            correlation: `${claim.attempt.conversationId}:${claim.attempt.runId}:${claim.attempt.id}`,
-          },
-          { signal: controller.signal }
-        );
-      } catch (error) {
-        if (error?.classification !== "SUBMIT_AMBIGUOUS") throw error;
-        await complete(claim, identity, {
-          attemptStatus: "UNCERTAIN",
-          status: "UNCERTAIN",
-        });
-        return { ok: false, code: "SUBMIT_AMBIGUOUS" };
+      const submitRequest = {
+        input: claim.run.input,
+        instructions: endpointRunInstructions(claim),
+        conversationHistory: endpointConversationHistory(
+          claim.run.conversationHistory
+        ),
+        correlation: `${claim.attempt.conversationId}:${claim.attempt.runId}:${claim.attempt.id}`,
+      };
+      while (!submitted) {
+        try {
+          submitted = await runs.submit(submitRequest, {
+            signal: controller.signal,
+          });
+        } catch (error) {
+          if (error?.classification === "SUBMIT_AMBIGUOUS") {
+            await complete(claim, identity, {
+              attemptStatus: "UNCERTAIN",
+              status: "UNCERTAIN",
+            });
+            return { ok: false, code: "SUBMIT_AMBIGUOUS" };
+          }
+          if (error?.classification !== "SUBMIT_NOT_ADMITTED") throw error;
+          const remainingMs = deadlineMs - now().getTime();
+          if (deadlineExpired || remainingMs <= 0) {
+            await complete(claim, identity, {
+              attemptStatus: "TIMED_OUT",
+              status: "TIMED_OUT",
+            });
+            return { ok: false, code: "SUBMIT_NOT_ADMITTED_TIMEOUT" };
+          }
+          const retryAfterMs = Number.isFinite(error.retryAfterMs)
+            ? Math.max(100, Math.min(5_000, error.retryAfterMs))
+            : 1_000;
+          await abortablePause(
+            Math.min(retryAfterMs, remainingMs),
+            controller.signal,
+            sleepImpl
+          );
+          if (heartbeatFailure) throw heartbeatFailure;
+          if (controller.signal.aborted) {
+            throw controller.signal.reason ?? new Error("endpoint_run_aborted");
+          }
+        }
       }
       held.nativeRunId = submitted.runId;
       await append(

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

@@ -446,6 +446,25 @@ function transportFailure(code, error) {
   return result;
 }
 
+function submitNotAdmitted(response, value) {
+  const retryAfter = response.headers?.get?.("retry-after") ?? "";
+  const retryAfterSeconds =
+    retryAfter.trim().length > 0 ? Number(retryAfter) : Number.NaN;
+  const retryAfterMs = Number.isFinite(retryAfterSeconds)
+    ? Math.max(100, Math.min(5_000, retryAfterSeconds * 1_000))
+    : 1_000;
+  const result = new Error("SUBMIT_NOT_ADMITTED");
+  result.code = "SUBMIT_NOT_ADMITTED";
+  result.classification = "SUBMIT_NOT_ADMITTED";
+  result.certainty = "NOT_ACCEPTED";
+  result.nativeStatus = response.status;
+  result.retryAfterMs = retryAfterMs;
+  result.evidence = Object.freeze({
+    digest: sha256(stableJson(value)),
+  });
+  return result;
+}
+
 /** @param {any} options */
 export function createHermesRunsClient(options = {}) {
   const {
@@ -494,6 +513,12 @@ 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
+      // 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) {
+        throw submitNotAdmitted(response, value);
+      }
       if (
         response.status !== 202 ||
         !exactObject(value) ||

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

@@ -1155,6 +1155,26 @@ function stageHermesUserState({ profileId, profileRoot, hermesRoot }) {
   for (const name of HERMES_SNAPSHOT_USER_STATE_ENTRIES) {
     const source = join(profileRoot, name);
     if (existsSync(source)) {
+      if (name === "SOUL.md") {
+        const sourceStat = lstatSync(source);
+        if (
+          sourceStat.isSymbolicLink() ||
+          !sourceStat.isFile() ||
+          sourceStat.nlink !== 1
+        ) {
+          throw new Error("hermes_snapshot_soul_metadata_rejected");
+        }
+        const target = join(stagedProfileRoot, name);
+        // Hermes rejects the live SOUL when its link count is not exactly one.
+        // Snapshot compaction can run for minutes, so a staged hard link would
+        // make otherwise healthy Agent turns fail for the whole capture window.
+        copyFileSync(source, target, constants.COPYFILE_EXCL);
+        chmodSync(target, 0o600);
+        if (regularFile(target).nlink !== 1) {
+          throw new Error("hermes_snapshot_soul_metadata_rejected");
+        }
+        continue;
+      }
       // state.db is copied online and compacted after the rest of the staged
       // tree is assembled. Never hard-link this one file: pruning the staged
       // recovery copy must be physically incapable of touching the live DB.
@@ -2190,7 +2210,7 @@ export async function captureHermesBackup({
   } catch (error) {
     const code = error instanceof Error ? error.message : "";
     return failed(
-      /^hermes_snapshot_(?:external_state|plugin_data|portable_config|dependency|state_db)/.test(
+      /^hermes_snapshot_(?:external_state|plugin_data|portable_config|dependency|state_db|soul_metadata)/.test(
         code
       )
         ? code

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.717-wip.phase202.20260901.5";
+const INSTALLER_PACKAGE = "@sellable/install@0.1.718";
 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

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

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.717-wip.phase202.20260901.5" ||
+      "@sellable/install@0.1.718" ||
     desired.mcpPackage !== "@sellable/mcp@0.1.915" ||
     !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.717-wip.phase202.20260901.5";
+  "@sellable/install@0.1.718";
 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.717-wip.phase202.20260901.5",
+  "version": "0.1.718",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code, Codex, and Hermes",
   "bin": {