@sellable/install 0.1.701 → 0.1.703

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.701
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.703
 ARG MCP_PACKAGE=@sellable/mcp@0.1.905
 ARG INSTALLER_INTEGRITY
 ARG MCP_INTEGRITY=sha512-WBx3m+OWplwYpR3/Kk/fbc3xe33kdP/sarB6aiX426qmyYAL6KvnhIfmA4+pCNkvsfcx9IihC0quFrsaUimUhw==
 
-RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.701" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.703" \
     && test "${MCP_PACKAGE}" = "@sellable/mcp@0.1.905" \
     && 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.701" \
     && 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.701' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.905') 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.703' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.905') 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.701', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.905', 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.703', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.905', 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.701` is
+`@sellable/install@0.1.703` 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.905
 ARG MCP_INTEGRITY=sha512-WBx3m+OWplwYpR3/Kk/fbc3xe33kdP/sarB6aiX426qmyYAL6KvnhIfmA4+pCNkvsfcx9IihC0quFrsaUimUhw==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.701
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.703
 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.701";
+  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.703";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.905";
 const DEFAULT_PROFILE_BUNDLE_ROOT =
@@ -977,6 +977,9 @@ function endpointCompletionBody({
   attemptStatus,
   status,
   output = null,
+  productContractDigest = null,
+  productProjectedOutput = null,
+  productProjectedOutputDigest = null,
   positiveCancellation = false,
   hasEffectIntent = false,
   now,
@@ -995,12 +998,52 @@ function endpointCompletionBody({
     status,
     canonicalOutput: output,
     canonicalOutputDigest,
+    ...(productContractDigest === null
+      ? {}
+      : {
+          productContractDigest,
+          productProjectedOutput,
+          productProjectedOutputDigest,
+        }),
     positiveCancellation,
     hasEffectIntent,
     completedAt: now().toISOString(),
   };
 }
 
+function endpointProductProjection(productExecution, output) {
+  if (productExecution == null) return { ok: true, completion: {} };
+  const message = output?.message;
+  const candidate = message?.candidate;
+  const subject = message?.subject;
+  const hasSubject = typeof subject === "string";
+  if (
+    !productExecution ||
+    typeof productExecution !== "object" ||
+    Array.isArray(productExecution) ||
+    !ENDPOINT_DIGEST.test(productExecution.contractDigest ?? "") ||
+    !["OPENER", "REPLY", "FOLLOW_UP"].includes(productExecution.workKind) ||
+    typeof productExecution.subjectRequired !== "boolean" ||
+    typeof candidate !== "string" ||
+    candidate.length < 1 ||
+    hasSubject !== productExecution.subjectRequired
+  ) {
+    return { ok: false };
+  }
+  const projectedOutput = productExecution.subjectRequired
+    ? { subject, body: candidate }
+    : { body: candidate };
+  return {
+    ok: true,
+    completion: {
+      productContractDigest: productExecution.contractDigest,
+      productProjectedOutput: projectedOutput,
+      productProjectedOutputDigest:
+        endpointCanonicalOutputDigest(projectedOutput),
+    },
+  };
+}
+
 function endpointPendingControl(value) {
   if (value === null) return null;
   const approvalKeys = [
@@ -1614,10 +1657,22 @@ export function createCustomerEndpointRelay(options = {}) {
           // a second completion or expose the late output as canonical.
           return { ok: true, code: "LATE_NOTICE_ONLY" };
         }
+        const productProjection = endpointProductProjection(
+          claim.run.productExecution,
+          terminalEvent.output
+        );
+        if (!productProjection.ok) {
+          await complete(claim, identity, {
+            attemptStatus: "FAILED",
+            status: "OUTPUT_CONTRACT_FAILED",
+          });
+          return { ok: false, code: "OUTPUT_CONTRACT_FAILED" };
+        }
         await complete(claim, identity, {
           attemptStatus: "SUCCEEDED",
           status: "SUCCEEDED",
           output: terminalEvent.output,
+          ...productProjection.completion,
         });
         return { ok: true, code: "SUCCEEDED" };
       }

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

@@ -18,6 +18,7 @@ import {
   rmSync,
   writeFileSync,
 } from "node:fs";
+import { tmpdir } from "node:os";
 import { basename, dirname, isAbsolute, join, resolve } from "node:path";
 import { promisify } from "node:util";
 import { parseDocument } from "yaml";
@@ -920,14 +921,17 @@ export async function compactHermesSnapshotStateDb({
   targetPath,
   retentionHours = HERMES_SNAPSHOT_CRON_SESSION_RETENTION_HOURS,
   hermesPython = HERMES_PYTHON,
-  runChild = undefined,
+  scratchDirectory = tmpdir(),
+  runChild = /** @type {typeof runBoundedHermesChild | undefined} */ (undefined),
 }) {
   if (
     !isAbsolute(sourcePath) ||
     !isAbsolute(targetPath) ||
+    !isAbsolute(scratchDirectory) ||
     resolve(sourcePath) === resolve(targetPath) ||
     !existsSync(sourcePath) ||
     existsSync(targetPath) ||
+    !existsSync(scratchDirectory) ||
     !Number.isSafeInteger(retentionHours) ||
     retentionHours < 1 ||
     retentionHours > 30 * 24
@@ -935,43 +939,91 @@ export async function compactHermesSnapshotStateDb({
     throw new Error("hermes_snapshot_state_db_compaction_rejected");
   }
   regularFile(sourcePath);
-  mkdirSync(dirname(targetPath), { recursive: true, mode: 0o700 });
-  const result = await childRunner(runChild)({
-    command: hermesPython,
-    args: [
-      "-c",
-      STATE_DB_COMPACTION_SCRIPT,
-      sourcePath,
-      targetPath,
-      String(retentionHours),
-    ],
-    env: { ...process.env, NO_COLOR: "1" },
-    shell: false,
-    timeoutMs: STATE_DB_COMPACTION_TIMEOUT_MS,
-    maxOutputBytes: 64 * 1024,
-  });
-  if (childFailed(result) || !existsSync(targetPath)) {
-    throw new Error("hermes_snapshot_state_db_compaction_failed");
+  const scratchStat = lstatSync(scratchDirectory);
+  if (scratchStat.isSymbolicLink() || !scratchStat.isDirectory()) {
+    throw new Error("hermes_snapshot_state_db_compaction_rejected");
   }
-  const target = regularFile(targetPath);
-  let summary;
+  mkdirSync(dirname(targetPath), { recursive: true, mode: 0o700 });
+  let scratchRoot;
+  let finalTemporaryPath;
+  let targetCreated = false;
   try {
-    summary = JSON.parse(String(result.stdout ?? ""));
+    // Keep SQLite's destination plus VACUUM journal on the Machine's
+    // ephemeral root filesystem. Building both beside the protected staging
+    // tree can briefly require multiple full state.db copies on the small
+    // persistent Fly volume and strand an otherwise healthy Upgrade at
+    // BACKING_UP with ENOSPC. Only the verified compact database crosses back
+    // onto the volume.
+    scratchRoot = mkdtempSync(
+      join(scratchDirectory, ".sellable-hermes-state-db-")
+    );
+    chmodSync(scratchRoot, 0o700);
+    const scratchTargetPath = join(scratchRoot, "state.db");
+    const result = await childRunner(runChild)({
+      command: hermesPython,
+      args: [
+        "-c",
+        STATE_DB_COMPACTION_SCRIPT,
+        sourcePath,
+        scratchTargetPath,
+        String(retentionHours),
+      ],
+      env: { ...process.env, NO_COLOR: "1" },
+      shell: false,
+      timeoutMs: STATE_DB_COMPACTION_TIMEOUT_MS,
+      maxOutputBytes: 64 * 1024,
+    });
+    if (childFailed(result) || !existsSync(scratchTargetPath)) {
+      throw new Error("hermes_snapshot_state_db_compaction_failed");
+    }
+    const scratchTarget = regularFile(scratchTargetPath);
+    const summary = JSON.parse(String(result.stdout ?? ""));
+    if (
+      summary?.ok !== true ||
+      summary.retentionHours !== retentionHours ||
+      !Number.isSafeInteger(summary.prunedSessions) ||
+      summary.prunedSessions < 0 ||
+      !Number.isSafeInteger(summary.prunedMessages) ||
+      summary.prunedMessages < 0 ||
+      summary.archiveStateBytes !== scratchTarget.size
+    ) {
+      throw new Error("hermes_snapshot_state_db_compaction_failed");
+    }
+    finalTemporaryPath = join(
+      dirname(targetPath),
+      `.${basename(targetPath)}.${randomUUID()}`
+    );
+    copyFileSync(
+      scratchTargetPath,
+      finalTemporaryPath,
+      constants.COPYFILE_EXCL
+    );
+    chmodSync(finalTemporaryPath, 0o600);
+    const targetFd = openSync(finalTemporaryPath, constants.O_RDONLY);
+    try {
+      fsyncSync(targetFd);
+    } finally {
+      closeSync(targetFd);
+    }
+    // link(2) gives this staged publication no-replace semantics. If another
+    // writer created targetPath after admission, fail without deleting or
+    // overwriting the other writer's file.
+    linkSync(finalTemporaryPath, targetPath);
+    targetCreated = true;
+    rmSync(finalTemporaryPath, { force: true });
+    finalTemporaryPath = undefined;
+    fsyncDirectory(dirname(targetPath));
+    if (regularFile(targetPath).size !== scratchTarget.size) {
+      throw new Error("hermes_snapshot_state_db_compaction_failed");
+    }
+    return summary;
   } catch {
+    if (targetCreated) rmSync(targetPath, { force: true });
     throw new Error("hermes_snapshot_state_db_compaction_failed");
+  } finally {
+    if (finalTemporaryPath) rmSync(finalTemporaryPath, { force: true });
+    if (scratchRoot) rmSync(scratchRoot, { recursive: true, force: true });
   }
-  if (
-    summary?.ok !== true ||
-    summary.retentionHours !== retentionHours ||
-    !Number.isSafeInteger(summary.prunedSessions) ||
-    summary.prunedSessions < 0 ||
-    !Number.isSafeInteger(summary.prunedMessages) ||
-    summary.prunedMessages < 0 ||
-    summary.archiveStateBytes !== target.size
-  ) {
-    throw new Error("hermes_snapshot_state_db_compaction_failed");
-  }
-  return summary;
 }
 
 function nativeSummaryAccepted(result, complete, incomplete) {

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.701";
+const INSTALLER_PACKAGE = "@sellable/install@0.1.703";
 const MCP_PACKAGE = "@sellable/mcp@0.1.905";
 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.701" ||
+        "@sellable/install@0.1.703" ||
       pinned.mcpPackage !== "@sellable/mcp@0.1.905" ||
       !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.701" ||
+      "@sellable/install@0.1.703" ||
     desired.mcpPackage !== "@sellable/mcp@0.1.905" ||
     !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.701";
+  "@sellable/install@0.1.703";
 export const PINNED_MCP_PACKAGE = "@sellable/mcp@0.1.905";
 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.701",
+  "version": "0.1.703",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code, Codex, and Hermes",
   "bin": {