@sellable/install 0.1.650 → 0.1.651

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.650
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.651
 ARG MCP_PACKAGE=@sellable/mcp@0.1.880
 ARG INSTALLER_INTEGRITY
 ARG MCP_INTEGRITY=sha512-+Fo8aQlYduLaQMQff+ZA25LeUhWZ7I7UH5DECpND84LQ+rHSjKeKFj4Zs93bVHXwQCIy2OLbr75y4f4+CyT57w==
 
-RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.650" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.651" \
     && test "${MCP_PACKAGE}" = "@sellable/mcp@0.1.880" \
     && 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.650" \
     && 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.650' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.880') 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.651' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.880') 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.650', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.880', 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.651', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.880', 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.650` is
+`@sellable/install@0.1.651` 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.880
 ARG MCP_INTEGRITY=sha512-+Fo8aQlYduLaQMQff+ZA25LeUhWZ7I7UH5DECpND84LQ+rHSjKeKFj4Zs93bVHXwQCIy2OLbr75y4f4+CyT57w==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.650
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.651
 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 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.650";
+  "@sellable/install@0.1.651";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.880";
 const DEFAULT_PROFILE_BUNDLE_ROOT =

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

@@ -1,4 +1,4 @@
-import { createHash } from "node:crypto";
+import { createHash, createHmac, timingSafeEqual } from "node:crypto";
 import {
   closeSync,
   constants,
@@ -18,11 +18,169 @@ import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 
 export const HERMES_AGENT_BRIDGE_ID = "sellable-agent-hermes-bridge/v1";
 export const HERMES_AGENT_BRIDGE_MARKER = "SELLABLE_AGENT_HERMES_BRIDGE_V1";
+export const HERMES_DEVELOPER_SLACK_METADATA_CONTRACT =
+  "hermes-developer-native-slack-metadata/v1";
+
+const HERMES_DEVELOPER_NATIVE_SOURCE = "hermes-developer-node-socket-mode/v1";
+const HERMES_DEVELOPER_EVENT_TYPES = new Set([
+  "app_mention",
+  "message",
+  "interactive",
+]);
+const HERMES_DEVELOPER_EVENT_SUBTYPES = new Set([
+  "",
+  "message_changed",
+  "message_deleted",
+  "unsupported",
+]);
+const HERMES_DEVELOPER_SLACK_ID = /^[A-Z][A-Z0-9]{8,31}$/;
+const HERMES_DEVELOPER_SLACK_TS = /^\d{1,16}\.\d{6}$/;
+const HERMES_DEVELOPER_EVENT_ID = /^[A-Za-z0-9_.:-]{1,128}$/;
 
 const sha256 = (value) => createHash("sha256").update(value).digest("hex");
 const isSha256 = (value) =>
   typeof value === "string" && /^[a-f0-9]{64}$/.test(value);
 
+function canonicalHermesDeveloperMetadata(value) {
+  if (Array.isArray(value)) return value.map(canonicalHermesDeveloperMetadata);
+  if (value && typeof value === "object") {
+    return Object.fromEntries(
+      Object.keys(value)
+        .sort()
+        .map((key) => [key, canonicalHermesDeveloperMetadata(value[key])])
+    );
+  }
+  return value;
+}
+
+function exactHermesDeveloperMetadataKeys(value, expected) {
+  return (
+    value &&
+    typeof value === "object" &&
+    !Array.isArray(value) &&
+    Object.keys(value).sort().join("\0") === [...expected].sort().join("\0")
+  );
+}
+
+/**
+ * Seal identity copied by the repo-owned Socket Mode receiver before any
+ * planner or worker execution. This deliberately has no text or tool
+ * arguments: downstream code cannot select a Slack principal, route, event or
+ * acknowledgement contract.
+ */
+export function createHermesDeveloperTrustedSlackMetadata(
+  input,
+  authenticationKey
+) {
+  if (!Buffer.isBuffer(authenticationKey) || authenticationKey.length < 32) {
+    throw new HermesAgentBridgeError(
+      "HERMES_DEVELOPER_SLACK_METADATA_KEY_REQUIRED",
+      "Hermes developer Slack metadata requires a gateway-private authentication key"
+    );
+  }
+  const keys = [
+    "source",
+    "teamId",
+    "channelId",
+    "actorId",
+    "eventId",
+    "eventType",
+    "eventSubtype",
+    "messageTs",
+    "threadTs",
+    "botId",
+    "ackCapability",
+    "adapterGeneration",
+  ];
+  if (
+    !exactHermesDeveloperMetadataKeys(input, keys) ||
+    input.source !== HERMES_DEVELOPER_NATIVE_SOURCE ||
+    !HERMES_DEVELOPER_SLACK_ID.test(input.teamId ?? "") ||
+    !HERMES_DEVELOPER_SLACK_ID.test(input.channelId ?? "") ||
+    !HERMES_DEVELOPER_SLACK_ID.test(input.actorId ?? "") ||
+    !HERMES_DEVELOPER_EVENT_ID.test(input.eventId ?? "") ||
+    !HERMES_DEVELOPER_EVENT_TYPES.has(input.eventType) ||
+    !HERMES_DEVELOPER_EVENT_SUBTYPES.has(input.eventSubtype ?? "") ||
+    !HERMES_DEVELOPER_SLACK_TS.test(input.messageTs ?? "") ||
+    (input.threadTs !== null &&
+      !HERMES_DEVELOPER_SLACK_TS.test(input.threadTs ?? "")) ||
+    (input.botId !== null &&
+      !HERMES_DEVELOPER_SLACK_ID.test(input.botId ?? "")) ||
+    input.ackCapability !== "defer_until_durable_intake" ||
+    !Number.isSafeInteger(input.adapterGeneration) ||
+    input.adapterGeneration < 1
+  ) {
+    throw new HermesAgentBridgeError(
+      "HERMES_DEVELOPER_SLACK_METADATA_REJECTED",
+      "Hermes developer Slack metadata must come from the deferred-ack repo-owned receiver"
+    );
+  }
+  const body = canonicalHermesDeveloperMetadata({
+    contract: HERMES_DEVELOPER_SLACK_METADATA_CONTRACT,
+    ...input,
+  });
+  const metadataDigest = sha256(JSON.stringify(body));
+  return Object.freeze({
+    ...body,
+    metadataDigest,
+    authenticationTag: createHmac("sha256", authenticationKey)
+      .update(metadataDigest)
+      .digest("hex"),
+  });
+}
+
+export function verifyHermesDeveloperTrustedSlackMetadata(
+  value,
+  authenticationKey
+) {
+  try {
+    if (!Buffer.isBuffer(authenticationKey) || authenticationKey.length < 32) {
+      return false;
+    }
+    if (
+      !exactHermesDeveloperMetadataKeys(value, [
+        "contract",
+        "source",
+        "teamId",
+        "channelId",
+        "actorId",
+        "eventId",
+        "eventType",
+        "eventSubtype",
+        "messageTs",
+        "threadTs",
+        "botId",
+        "ackCapability",
+        "adapterGeneration",
+        "metadataDigest",
+        "authenticationTag",
+      ]) ||
+      value.contract !== HERMES_DEVELOPER_SLACK_METADATA_CONTRACT
+    ) {
+      return false;
+    }
+    const {
+      contract: _contract,
+      metadataDigest,
+      authenticationTag,
+      ...input
+    } = value;
+    const rebuilt = createHermesDeveloperTrustedSlackMetadata(
+      input,
+      authenticationKey
+    );
+    const supplied = Buffer.from(authenticationTag ?? "", "hex");
+    const expected = Buffer.from(rebuilt.authenticationTag, "hex");
+    return (
+      rebuilt.metadataDigest === metadataDigest &&
+      supplied.length === expected.length &&
+      timingSafeEqual(supplied, expected)
+    );
+  } catch {
+    return false;
+  }
+}
+
 export class HermesAgentBridgeError extends Error {
   constructor(code, message, details = {}) {
     super(message);

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