@sellable/install 0.1.789 → 0.1.790

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.789
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.790
 ARG MCP_PACKAGE=@sellable/mcp@0.1.955
 ARG INSTALLER_INTEGRITY
 ARG MCP_INTEGRITY=sha512-OsyazlSe75wU6O1jAqOutTTt3K+rP5epwQKZEDWyl+qz0wxstVwTbq3FFEGniwr+svVOX3GWET8koIqeDyanow==
 
-RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.789" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.790" \
     && test "${MCP_PACKAGE}" = "@sellable/mcp@0.1.955" \
     && 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.789" \
     && 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.789' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.955') 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.790' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.955') 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.789', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.955', 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.790', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.955', 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.789` is
+`@sellable/install@0.1.790` is
 published:
 
 ```sh

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.955
 ARG MCP_INTEGRITY=sha512-OsyazlSe75wU6O1jAqOutTTt3K+rP5epwQKZEDWyl+qz0wxstVwTbq3FFEGniwr+svVOX3GWET8koIqeDyanow==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.789
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.790
 ARG ADMIN_MCP_PACKAGE=@sellable/admin-mcp@0.1.202
 ARG ADMIN_MCP_INTEGRITY=sha512-ym3aye/0vQ8tfULJlKz9JFOxvIQsl1G+n3np+TTgK/tecwNblBo/j3AkTnRqH9iomKzPbZzP+n4tEQsvsU8ByA==
 ARG TUS_JS_CLIENT_VERSION=4.3.1

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

@@ -95,6 +95,7 @@ import {
 import {
   createHermesRunsClient,
   HERMES_RUNS_FIXTURE_IDENTITY,
+  validateEndpointModelSelection,
   validateOpenerOutputContract,
 } from "./hermes-runs-client.mjs";
 import {
@@ -123,7 +124,7 @@ const RUNTIME_GENERATION = Number(
 const BOOT_SESSION_ID = randomUUID();
 const HERMES_VERSION = process.env.SELLABLE_AGENT_HERMES_VERSION ?? "0.21.5";
 const INSTALLER_PACKAGE =
-  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.789";
+  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.790";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.955";
 export const ENDPOINT_MAX_CONCURRENT_RUNS = 10;
@@ -1071,6 +1072,16 @@ function endpointEventEnvelope(event, ordinal) {
           outputDigest: event.outputDigest ?? null,
           errorDigest: event.errorDigest ?? null,
           evidenceDigest: event.evidence?.digest ?? null,
+          ...(event.servedRuntime || event.usage
+            ? {
+                servedProvider: event.servedRuntime?.provider ?? null,
+                servedModel: event.servedRuntime?.model ?? null,
+                inputTokens: event.usage?.inputTokens ?? null,
+                outputTokens: event.usage?.outputTokens ?? null,
+                cacheReadTokens: event.usage?.cacheReadTokens ?? null,
+                cacheWriteTokens: event.usage?.cacheWriteTokens ?? null,
+              }
+            : {}),
           ...(/^writer-[123]$|^editor$/.test(event.stage ?? "")
             ? {
                 stage: event.stage,
@@ -1887,6 +1898,11 @@ export function createCustomerEndpointRelay(options = {}) {
 
   const runClaim = async (claim, outerSignal) => {
     const identity = endpointClaimIdentity(claim);
+    // A caller-named model rides on the run; absent means the machine default.
+    const modelSelection =
+      claim?.run?.modelSelection === undefined
+        ? null
+        : validateEndpointModelSelection(claim.run.modelSelection);
     const activeRuntime = getActiveRuntime();
     if (!endpointRuntimeCurrent(claim, activeRuntime, runtimeGeneration)) {
       return { ok: false, code: "customer_endpoint_generation_fenced" };
@@ -2031,6 +2047,15 @@ export function createCustomerEndpointRelay(options = {}) {
       held.committedSequence = sequences.at(-1);
     };
     try {
+      if (usesOpenerDraftStrategy(claim) && modelSelection) {
+        // The three-draft stages are pinned to the Codex output-format path in
+        // the Hermes bridge; refuse rather than silently serve the default.
+        await complete(claim, identity, {
+          attemptStatus: "FAILED",
+          status: "FAILED",
+        });
+        return { ok: false, code: "OPENER_STAGE_MODEL_SELECTION_UNSUPPORTED" };
+      }
       if (usesOpenerDraftStrategy(claim)) {
         // Phase 206: writers are private native sessions within this one fenced
         // claim. Only the editor's validated result reaches durable completion.
@@ -2126,6 +2151,7 @@ export function createCustomerEndpointRelay(options = {}) {
           claim.run.conversationHistory
         ),
         correlation: `${claim.attempt.conversationId}:${claim.attempt.runId}:${claim.attempt.id}`,
+        ...(modelSelection ? { modelSelection } : {}),
       };
       while (!submitted) {
         try {

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

@@ -200,6 +200,39 @@ function canonicalHistory(value) {
   return result;
 }
 
+// The models a caller may name for one endpoint run. The server checks the
+// same list before it hands the run over; the runtime checks it again here so
+// a run can never reach Hermes with a model that was not reviewed.
+export const ENDPOINT_MODEL_SELECTION_ALLOWLIST = Object.freeze({
+  openrouter: Object.freeze([
+    "anthropic/claude-opus-5.5",
+    "anthropic/claude-sonnet-5.5",
+  ]),
+});
+const ENDPOINT_MODEL_REASONING_EFFORTS = Object.freeze([
+  "low",
+  "medium",
+  "high",
+  "xhigh",
+]);
+
+export function validateEndpointModelSelection(value) {
+  if (
+    !exactObject(value) ||
+    Object.keys(value).sort().join(",") !== "model,provider,reasoningEffort" ||
+    !Object.hasOwn(ENDPOINT_MODEL_SELECTION_ALLOWLIST, value.provider) ||
+    !ENDPOINT_MODEL_SELECTION_ALLOWLIST[value.provider].includes(value.model) ||
+    !ENDPOINT_MODEL_REASONING_EFFORTS.includes(value.reasoningEffort)
+  ) {
+    throw new Error("hermes_runs_model_selection_rejected");
+  }
+  return Object.freeze({
+    provider: value.provider,
+    model: value.model,
+    reasoningEffort: value.reasoningEffort,
+  });
+}
+
 export function validateOpenerOutputContract(value) {
   const schema = value?.schema;
   if (
@@ -232,7 +265,7 @@ function compileCreateBody(input, openerStage = false) {
     "input",
     "instructions",
     "correlation",
-    ...(openerStage ? ["outputContract"] : []),
+    ...(openerStage ? ["outputContract"] : ["modelSelection"]),
   ];
   if (Object.keys(input).some((key) => !allowed.includes(key))) {
     throw new Error("hermes_runs_submit_rejected");
@@ -254,11 +287,24 @@ function compileCreateBody(input, openerStage = false) {
   if (openerStage && history.length !== 0) {
     throw new Error("hermes_opener_stage_history_rejected");
   }
+  const modelSelection =
+    input.modelSelection === undefined
+      ? null
+      : validateEndpointModelSelection(input.modelSelection);
   return Object.freeze({
     input: compiledInput,
     instructions,
     conversation_history: history,
     session_id: `${openerStage ? "sellable_opener_stage" : "sellable_endpoint"}_${sha256(correlation).slice(0, 32)}`,
+    // Hermes 0.21.5 honours a per-run provider and model on /v1/runs and
+    // resolves the provider's credential from the machine's own pool.
+    ...(modelSelection === null
+      ? {}
+      : {
+          provider: modelSelection.provider,
+          model: modelSelection.model,
+          model_options: { reasoning_effort: modelSelection.reasoningEffort },
+        }),
     ...(input.outputContract === undefined
       ? {}
       : {
@@ -287,6 +333,30 @@ async function readBounded(response, maximum = MAX_RESPONSE_BYTES) {
   }
 }
 
+const SERVED_RUNTIME_ID = /^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/;
+
+// The provider and model that actually served a run (a fallback can differ
+// from the request) and its token counts, so cost and model are auditable.
+function servedRuntime(value) {
+  return exactObject(value) &&
+    SERVED_RUNTIME_ID.test(value.provider ?? "") &&
+    SERVED_RUNTIME_ID.test(value.model ?? "")
+    ? Object.freeze({ provider: value.provider, model: value.model })
+    : null;
+}
+
+function runUsage(value) {
+  if (!exactObject(value)) return null;
+  const count = (key) =>
+    Number.isSafeInteger(value[key]) && value[key] >= 0 ? value[key] : null;
+  return Object.freeze({
+    inputTokens: count("input_tokens"),
+    outputTokens: count("output_tokens"),
+    cacheReadTokens: count("cache_read_tokens"),
+    cacheWriteTokens: count("cache_write_tokens"),
+  });
+}
+
 function ensureRunId(value) {
   if (!RUN_ID.test(value ?? "")) throw new Error("hermes_runs_run_id_rejected");
   return value;
@@ -340,6 +410,8 @@ function nativeStatus(value, expectedRunId) {
       classification: "COMPLETED",
       output,
       outputDigest: sha256(stableJson(output)),
+      servedRuntime: servedRuntime(value.runtime),
+      usage: runUsage(value.usage),
     });
   }
   if (status === "failed") {
@@ -439,6 +511,8 @@ export function sanitizeHermesRunEvent(value, options = {}) {
       output: value.output,
       outputDigest: sha256(stableJson(value.output)),
       usageDigest: sha256(stableJson(value.usage)),
+      servedRuntime: servedRuntime(value.runtime),
+      usage: runUsage(value.usage),
     });
   }
   if (value.event === "run.failed") {

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

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

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

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

@@ -312,7 +312,7 @@ function validateDesired(desired) {
     desired.serviceCredentialGeneration < 1 ||
     desired.hermesCli !== "hermes" ||
     desired.hermesVersion !== "0.18.0" ||
-    desired.installerPackage !== "@sellable/install@0.1.789" ||
+    desired.installerPackage !== "@sellable/install@0.1.790" ||
     desired.mcpPackage !== "@sellable/mcp@0.1.955" ||
     !Array.isArray(desired.toolInclude) ||
     desired.toolInclude.length === 0 ||

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