@sellable/install 0.1.798 → 0.1.800

package/container/Dockerfile

@@ -3,12 +3,12 @@ FROM ${HERMES_IMAGE}
 
 USER root
 
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.798
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.800
 ARG MCP_PACKAGE=@sellable/mcp@0.1.957
 ARG INSTALLER_INTEGRITY
 ARG MCP_INTEGRITY=sha512-tIZuO5IEanT/afamDIWdorUNMdqZA6xnjL9jGAmGqYIlIqkXdHB9slWiwfLfmM44iEp7OT98IBHJlvbpMThk6A==
 
-RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.798" \
+RUN test "${INSTALLER_PACKAGE}" = "@sellable/install@0.1.800" \
     && test "${MCP_PACKAGE}" = "@sellable/mcp@0.1.957" \
     && 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.798" \
     && 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.798' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.957') 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.800' || mcp.name !== '@sellable/mcp' || mcp.version !== '0.1.957') 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.798', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.957', 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.800', installerIntegrity: process.argv[1], mcpPackage: '@sellable/mcp@0.1.957', 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.798` is
+`@sellable/install@0.1.800` 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.957
 ARG MCP_INTEGRITY=sha512-tIZuO5IEanT/afamDIWdorUNMdqZA6xnjL9jGAmGqYIlIqkXdHB9slWiwfLfmM44iEp7OT98IBHJlvbpMThk6A==
-ARG INSTALLER_PACKAGE=@sellable/install@0.1.798
+ARG INSTALLER_PACKAGE=@sellable/install@0.1.800
 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/claude-code-runs-api.d.mts

@@ -31,17 +31,25 @@ export type ClaudeRunsServer = Server & { stopActiveRuns(): Promise<void> };
 export type ClaudeRunsApiOptions = {
   token: string;
   connection: RunsApiConnection;
-  execute?: (request: ClaudeRunsRequest) => {
-    promise: Promise<ClaudeRunsResult>;
-    stop(): void;
-  };
+  execute?:
+    | ((request: ClaudeRunsRequest) => {
+        promise: Promise<ClaudeRunsResult>;
+        stop(): void;
+      })
+    | null;
   audit?: (entry: Record<string, unknown>) => void;
   maxConcurrency?: number;
   maxToolConcurrency?: number;
   toolLanes?: ClaudeRunsToolLanes | null;
-  checkAuthentication?: () => Promise<
-    "READY" | "SIGN_IN_REQUIRED" | "UNAVAILABLE"
-  >;
+  checkAuthentication?: (
+    configDir: string
+  ) => Promise<"READY" | "SIGN_IN_REQUIRED" | "UNAVAILABLE">;
+  accounts?: () => string[];
+  startRun?: (
+    request: ClaudeRunsRequest,
+    options: { root: string; configDir: string }
+  ) => { promise: Promise<ClaudeRunsResult>; stop(code?: string): void };
+  now?: () => number;
 };
 export function validateClaudeRunsRequest(
   body: unknown,
@@ -50,13 +58,20 @@ export function validateClaudeRunsRequest(
 export function endpointToolNames(options: {
   turnDescriptorPath: string;
   sessionId: string;
-  toolEndpointIds: string[];
+  /** Absent: every run gets the tools its own turn descriptor allows. */
+  toolEndpointIds?: string[];
 }): string[] | null;
 export function claudeInvocation(
   request: ClaudeRunsRequest,
   root: string,
-  mcpSpecPath?: string | null
+  mcpSpecPath?: string | null,
+  configDir?: string
 ): { command: string; args: string[]; options: SpawnOptions };
+export function claudeAccountDirs(root: string): string[];
+export function claudeUsageLimit(
+  stdout: string,
+  now?: number
+): { retryAt: number } | null;
 export function parseClaudeResult(
   stdout: string,
   request: ClaudeRunsRequest
@@ -65,6 +80,7 @@ export function startClaudeRun(
   request: ClaudeRunsRequest,
   options: {
     root: string;
+    configDir?: string;
     spawnImpl?: (...args: any[]) => any;
     timeoutMs?: number;
   }
@@ -82,6 +98,7 @@ export function startConfiguredClaudeRunsApis(options?: {
 
 export function readClaudeAuthentication(options: {
   root: string;
+  configDir?: string;
   execFileImpl?: any;
   timeoutMs?: number;
 }): Promise<"READY" | "SIGN_IN_REQUIRED" | "UNAVAILABLE">;

package/lib/sellable-agent/fly-customer-image/claude-code-runs-api.mjs

@@ -2,7 +2,9 @@ import { execFile, spawn } from "node:child_process";
 import { createHash, randomBytes, timingSafeEqual } from "node:crypto";
 import {
   appendFileSync,
+  existsSync,
   lstatSync,
+  readdirSync,
   readFileSync,
   rmSync,
   writeFileSync,
@@ -98,15 +100,17 @@ export function validateClaudeRunsRequest(body, models) {
 }
 
 /**
- * A tool-lane run's own allowed tools, read from the signed turn descriptor
- * the runtime installed for its session before submitting; null when the run
- * is not on a tool endpoint. This only narrows: the context proxy verifies the
- * descriptor itself before it lists or calls any tool.
+ * A run's own allowed tools, read from the signed turn descriptor the runtime
+ * installed for its session before submitting. With a tool list, only runs on
+ * those endpoints get tools (and must have some); without one, every run gets
+ * exactly the tools its descriptor allows, and a run allowed none is tool-free
+ * (null). This only narrows: the context proxy verifies the descriptor itself
+ * before it lists or calls any tool.
  */
 export function endpointToolNames({
   turnDescriptorPath,
   sessionId,
-  toolEndpointIds,
+  toolEndpointIds = undefined,
 }) {
   const path = endpointMcpDescriptorPath(turnDescriptorPath, sessionId);
   if (!path) return null;
@@ -118,21 +122,27 @@ export function endpointToolNames({
     throw error;
   }
   const body = JSON.parse(readFileSync(path, "utf8"))?.body;
-  if (!toolEndpointIds.includes(body?.endpointId)) return null;
-  const names = body.allowedToolNames;
+  if (toolEndpointIds && !toolEndpointIds.includes(body?.endpointId))
+    return null;
+  const names = body?.allowedToolNames;
   if (
     endpointHermesSessionId(body) !== sessionId ||
     !Array.isArray(names) ||
-    !names.length ||
+    (toolEndpointIds && !names.length) ||
     names.some(
       (name) => typeof name !== "string" || !/^[A-Za-z0-9_-]{1,128}$/.test(name)
     )
   )
     throw new Error("claude_runs_tool_descriptor_rejected");
-  return [...names];
+  return names.length ? [...names] : null;
 }
 
-export function claudeInvocation(request, root, mcpSpecPath = null) {
+export function claudeInvocation(
+  request,
+  root,
+  mcpSpecPath = null,
+  configDir = `${root}/claude`
+) {
   return {
     command: `${root}/cli/node_modules/.bin/claude`,
     args: [
@@ -189,8 +199,8 @@ export function claudeInvocation(request, root, mcpSpecPath = null) {
       stdio: ["pipe", "pipe", "pipe"],
       env: {
         PATH: "/usr/local/bin:/usr/bin:/bin",
-        HOME: `${root}/claude`,
-        CLAUDE_CONFIG_DIR: `${root}/claude`,
+        HOME: configDir,
+        CLAUDE_CONFIG_DIR: configDir,
         LANG: "C.UTF-8",
         CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: "1",
       },
@@ -202,12 +212,15 @@ export function claudeInvocation(request, root, mcpSpecPath = null) {
 // this boundary; CLI stdout can contain account identity and is never forwarded.
 export function readClaudeAuthentication({
   root,
+  configDir = `${root}/claude`,
   execFileImpl = execFile,
   timeoutMs = 8_000,
 } = {}) {
   const invocation = claudeInvocation(
     { instructions: "", input: "", model: "claude-opus", effort: "high" },
-    root
+    root,
+    null,
+    configDir
   );
   return new Promise((resolve) => {
     execFileImpl(
@@ -234,6 +247,91 @@ export function readClaudeAuthentication({
   });
 }
 
+// Each sign-in is its own Claude config folder: the primary `claude`, then
+// `accounts/<name>` in name order. Refresh tokens rotate inside a folder, so a
+// login is never copied between folders.
+export function claudeAccountDirs(root) {
+  const dirs = [`${root}/claude`];
+  let names = [];
+  try {
+    names = readdirSync(`${root}/accounts`).sort();
+  } catch {
+    /* No extra accounts. */
+  }
+  for (const name of names)
+    if (
+      /^[a-z0-9][a-z0-9-]{0,62}$/.test(name) &&
+      existsSync(`${root}/accounts/${name}/.credentials.json`)
+    )
+      dirs.push(`${root}/accounts/${name}`);
+  return dirs;
+}
+
+const MONTHS = "janfebmaraprmayjunjulaugsepoctnovdec";
+const USAGE_LIMIT_RETRY_MS = 15 * 60_000;
+const SIGN_IN_TRUST_MS = 5 * 60_000;
+
+// Claude Code reports a used-up plan as an API 429 result, for example
+// "You've hit your weekly limit · resets Oct 7, 10am (UTC)". Returns when that
+// account can be tried again, or null for any other result.
+export function claudeUsageLimit(stdout, now = Date.now()) {
+  let value;
+  try {
+    value = JSON.parse(stdout);
+  } catch {
+    return null;
+  }
+  if (
+    !record(value) ||
+    value.is_error !== true ||
+    value.api_error_status !== 429
+  )
+    return null;
+  const reset =
+    /resets\s+(?:([a-z]{3})[a-z]*\s+(\d{1,2}),?\s+)?(\d{1,2})(?::(\d{2}))?\s*(am|pm)\s*\(UTC\)/i.exec(
+      String(value.result ?? "")
+    );
+  let retryAt = null;
+  if (reset) {
+    const hour =
+      (Number(reset[3]) % 12) + (reset[5].toLowerCase() === "pm" ? 12 : 0);
+    const minute = Number(reset[4] ?? 0);
+    const today = new Date(now);
+    if (reset[1]) {
+      const month = MONTHS.indexOf(reset[1].toLowerCase()) / 3;
+      if (Number.isInteger(month)) {
+        retryAt = Date.UTC(
+          today.getUTCFullYear(),
+          month,
+          Number(reset[2]),
+          hour,
+          minute
+        );
+        if (retryAt < now - 86_400_000)
+          retryAt = Date.UTC(
+            today.getUTCFullYear() + 1,
+            month,
+            Number(reset[2]),
+            hour,
+            minute
+          );
+      }
+    } else {
+      retryAt = Date.UTC(
+        today.getUTCFullYear(),
+        today.getUTCMonth(),
+        today.getUTCDate(),
+        hour,
+        minute
+      );
+      if (retryAt <= now) retryAt += 86_400_000;
+    }
+  }
+  if (retryAt === null || retryAt <= now || retryAt > now + 8 * 86_400_000)
+    retryAt = now + USAGE_LIMIT_RETRY_MS;
+  return { retryAt };
+}
+
 export function parseClaudeResult(stdout, request) {
   const result = JSON.parse(stdout);
   const models = Object.keys(result.modelUsage ?? {});
@@ -272,7 +370,12 @@ export function parseClaudeResult(stdout, request) {
 
 export function startClaudeRun(
   request,
-  { root, spawnImpl = spawn, timeoutMs = 750_000 } = {}
+  {
+    root,
+    configDir = `${root}/claude`,
+    spawnImpl = spawn,
+    timeoutMs = 750_000,
+  } = {}
 ) {
   // The tool server's environment travels in a private per-run file, never
   // in argv, and is removed when the run ends.
@@ -288,7 +391,7 @@ export function startClaudeRun(
   const removeSpec = () => {
     if (mcpSpecPath) rmSync(mcpSpecPath, { force: true });
   };
-  const invocation = claudeInvocation(request, root, mcpSpecPath);
+  const invocation = claudeInvocation(request, root, mcpSpecPath, configDir);
   let child;
   try {
     child = spawnImpl(invocation.command, invocation.args, invocation.options);
@@ -334,12 +437,16 @@ export function startClaudeRun(
       clearTimeout(timer);
       clearTimeout(killTimer);
       removeSpec();
+      const stdout = Buffer.concat(chunks).toString("utf8");
+      const limit = reason ? null : claudeUsageLimit(stdout);
+      if (limit)
+        return reject(
+          Object.assign(new Error("claude_runs_usage_limited"), limit)
+        );
       if (reason || code !== 0)
         return reject(new Error(reason ?? "claude_runs_cli_failed"));
       try {
-        resolve(
-          parseClaudeResult(Buffer.concat(chunks).toString("utf8"), request)
-        );
+        resolve(parseClaudeResult(stdout, request));
       } catch {
         reject(new Error("claude_runs_output_rejected"));
       }
@@ -353,42 +460,125 @@ export function startClaudeRun(
 export function createClaudeRunsApi({
   token,
   connection,
-  execute = (request) => {
+  execute = null,
+  audit = () => {},
+  maxConcurrency = CLAUDE_RUNS_MAX_CONCURRENCY,
+  // Tool lanes (replies, follow-ups) have their own slots so a batch of
+  // openers can never crowd them out.
+  maxToolConcurrency = CLAUDE_RUNS_MAX_CONCURRENCY,
+  toolLanes = null,
+  checkAuthentication = (configDir) =>
+    readClaudeAuthentication({ root: connection.localRoot, configDir }),
+  accounts = () => claudeAccountDirs(connection.localRoot),
+  startRun = startClaudeRun,
+  now = Date.now,
+} = {}) {
+  if (!/^[a-f0-9]{64}$/.test(token ?? ""))
+    throw new Error("claude_runs_key_rejected");
+  // An account whose plan is used up rests until its reset; runs go to the
+  // next signed-in account meanwhile, and back to the first once it resets.
+  const usageLimitedUntil = new Map();
+  const resting = (configDir) =>
+    (usageLimitedUntil.get(configDir) ?? 0) > now();
+  // `claude auth status` starts a whole CLI: on the 4-CPU Admin machine seven
+  // at once take longer than its 8s timeout. Runs that arrive together share
+  // one check, a good answer is trusted for five minutes, and only a definite
+  // SIGN_IN_REQUIRED keeps a run off an account; an unanswered check runs and
+  // lets the CLI itself fail the run if the sign-in is really gone.
+  const signedInAt = new Map();
+  const signInChecks = new Map();
+  const signInState = (configDir) => {
+    if (now() - (signedInAt.get(configDir) ?? -Infinity) < SIGN_IN_TRUST_MS)
+      return Promise.resolve("READY");
+    let check = signInChecks.get(configDir);
+    if (!check) {
+      check = Promise.resolve()
+        .then(() => checkAuthentication(configDir))
+        .catch(() => "UNAVAILABLE")
+        .then((state) => {
+          signInChecks.delete(configDir);
+          if (state === "READY") signedInAt.set(configDir, now());
+          else signedInAt.delete(configDir);
+          return state;
+        });
+      signInChecks.set(configDir, check);
+    }
+    return check;
+  };
+  const runOnAccounts = (request) => {
     let activeRun;
     let stopped = false;
     return {
       promise: (async () => {
-        const state = await checkAuthentication();
-        if (stopped) throw new Error("claude_runs_cancelled");
-        if (state !== "READY")
-          throw new Error(
-            state === "SIGN_IN_REQUIRED"
-              ? "claude_runs_sign_in_required"
-              : "claude_runs_auth_check_unavailable"
-          );
-        activeRun = startClaudeRun(request, { root: connection.localRoot });
-        return activeRun.promise;
+        let failure = null;
+        for (const configDir of accounts()) {
+          if (resting(configDir)) {
+            failure = "claude_runs_usage_limited";
+            continue;
+          }
+          const state = await signInState(configDir);
+          if (stopped) throw new Error("claude_runs_cancelled");
+          if (state === "SIGN_IN_REQUIRED") {
+            failure ??= "claude_runs_sign_in_required";
+            continue;
+          }
+          activeRun = startRun(request, {
+            root: connection.localRoot,
+            configDir,
+          });
+          try {
+            return await activeRun.promise;
+          } catch (error) {
+            if (stopped || error.message !== "claude_runs_usage_limited") {
+              signedInAt.delete(configDir);
+              throw error;
+            }
+            usageLimitedUntil.set(configDir, error.retryAt);
+            failure = "claude_runs_usage_limited";
+          }
+        }
+        throw new Error(failure ?? "claude_runs_sign_in_required");
       })(),
       stop() {
         stopped = true;
         activeRun?.stop();
       },
     };
-  },
-  audit = () => {},
-  maxConcurrency = CLAUDE_RUNS_MAX_CONCURRENCY,
-  // Tool lanes (replies, follow-ups) have their own slots so a batch of
-  // openers can never crowd them out.
-  maxToolConcurrency = CLAUDE_RUNS_MAX_CONCURRENCY,
-  toolLanes = null,
-  checkAuthentication = () =>
-    readClaudeAuthentication({ root: connection.localRoot }),
-} = {}) {
-  if (!/^[a-f0-9]{64}$/.test(token ?? ""))
-    throw new Error("claude_runs_key_rejected");
+  };
+  const executeRun = execute ?? runOnAccounts;
+  const readHealth = async () => {
+    const dirs = accounts();
+    let ready = 0;
+    let signedOut = 0;
+    const retryAts = [];
+    for (const configDir of dirs) {
+      if (resting(configDir)) {
+        retryAts.push(usageLimitedUntil.get(configDir));
+        continue;
+      }
+      const state = await signInState(configDir);
+      if (state === "READY") ready++;
+      if (state === "SIGN_IN_REQUIRED") signedOut++;
+    }
+    return {
+      authentication: ready
+        ? "READY"
+        : signedOut === dirs.length
+          ? "SIGN_IN_REQUIRED"
+          : "UNAVAILABLE",
+      accounts: {
+        total: dirs.length,
+        ready,
+        usageLimited: retryAts.length,
+        retryAt: retryAts.length
+          ? new Date(Math.min(...retryAts)).toISOString()
+          : null,
+      },
+    };
+  };
   // The run's own tools and the profile's MCP server, or null for a tool-free run.
   const resolveTools = (request) => {
-    if (!connection.toolEndpointIds || !toolLanes) return null;
+    if (!toolLanes) return null;
     const names = endpointToolNames({
       turnDescriptorPath: toolLanes.turnDescriptorPath,
       sessionId: request.sessionId,
@@ -465,12 +655,11 @@ export function createClaudeRunsApi({
     )
       return json(res, 403, { error: "claude_runs_scope_rejected" });
     if (req.method === "GET" && req.url === "/health") {
-      const authentication = await checkAuthentication().catch(
-        () => "UNAVAILABLE"
-      );
+      const { authentication, accounts: accountHealth } = await readHealth();
       return json(res, 200, {
         ok: authentication === "READY",
         authentication,
+        accounts: accountHealth,
         provider: "claude-code",
         active: inFlight.plain + inFlight.tools,
         toolActive: inFlight.tools,
@@ -481,7 +670,7 @@ export function createClaudeRunsApi({
       });
     }
     if (req.method === "POST" && req.url === "/v1/runs") {
-      if (full("plain") && (!connection.toolEndpointIds || full("tools")))
+      if (full("plain") && (!toolLanes || full("tools")))
         return json(res, 429, { error: "claude_runs_busy" });
       let request;
       try {
@@ -521,7 +710,7 @@ export function createClaudeRunsApi({
       inFlight[pool]++;
       runs.set(run.run_id, run);
       try {
-        run.execution = execute(request);
+        run.execution = executeRun(request);
         run.execution.promise
           .then(
             (result) =>
@@ -542,6 +731,7 @@ export function createClaudeRunsApi({
                       error: [
                         "claude_runs_sign_in_required",
                         "claude_runs_auth_check_unavailable",
+                        "claude_runs_usage_limited",
                       ].includes(error.message)
                         ? error.message
                         : "claude_runs_generation_failed",

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

@@ -126,7 +126,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.798";
+  process.env.SELLABLE_AGENT_INSTALLER_PACKAGE ?? "@sellable/install@0.1.800";
 const MCP_PACKAGE =
   process.env.SELLABLE_AGENT_MCP_PACKAGE ?? "@sellable/mcp@0.1.957";
 export const ENDPOINT_MAX_CONCURRENT_RUNS = 10;

package/lib/sellable-agent/fly-customer-image/runs-api-connections.d.mts

@@ -5,7 +5,8 @@ export type RunsApiConnection = Readonly<{
   agentId: string;
   baseUrl: string;
   apiKeyFile: string;
-  endpointIds: string[];
+  /** Absent: serves every endpoint of its agent. */
+  endpointIds?: string[];
   workKinds: Array<"STANDARD" | "OPENER" | "REPLY" | "FOLLOW_UP">;
   models: Array<{
     provider: string;
@@ -19,6 +20,10 @@ export type RunsApiConnection = Readonly<{
   structuredOutputs?: boolean;
 }>;
 export function runsApiConnectionId(connection: RunsApiConnection): string;
+export function runsApiConnectionServesEndpoint(
+  connection: RunsApiConnection,
+  endpointId: string
+): boolean;
 export function parseRunsApiConnections(raw: unknown): RunsApiConnection[];
 export function runsApiConnectionsForRuntime(
   raw: unknown,

package/lib/sellable-agent/fly-customer-image/runs-api-connections.mjs

@@ -76,10 +76,12 @@ export function parseRunsApiConnections(raw) {
       entry.apiKeyFile
         .split("/")
         .some((part) => part === "." || part === "..") ||
-      !Array.isArray(entry.endpointIds) ||
-      !entry.endpointIds.length ||
-      entry.endpointIds.length > 64 ||
-      !entry.endpointIds.every(id) ||
+      // Absent: the connection serves every endpoint of its agent.
+      (entry.endpointIds !== undefined &&
+        (!Array.isArray(entry.endpointIds) ||
+          !entry.endpointIds.length ||
+          entry.endpointIds.length > 64 ||
+          !entry.endpointIds.every(id))) ||
       !Array.isArray(entry.workKinds) ||
       !entry.workKinds.length ||
       !entry.workKinds.every((kind) =>
@@ -138,24 +140,29 @@ export function parseRunsApiConnections(raw) {
       )
         fail();
     }
-    // Runs on these endpoints get their own allowed tools from the image-owned
-    // service; every other run stays tool-free.
+    // When present, only runs on these endpoints get their own allowed tools
+    // from the image-owned service. When absent, a run gets the tools its own
+    // signed turn descriptor allows, and a run allowed none stays tool-free.
     if (
       entry.toolEndpointIds !== undefined &&
       (entry.localRoot === undefined ||
         !Array.isArray(entry.toolEndpointIds) ||
         !entry.toolEndpointIds.length ||
+        !entry.toolEndpointIds.every(id) ||
         new Set(entry.toolEndpointIds).size !== entry.toolEndpointIds.length ||
-        entry.toolEndpointIds.some(
-          (value) => !entry.endpointIds.includes(value)
-        ))
+        (entry.endpointIds !== undefined &&
+          entry.toolEndpointIds.some(
+            (value) => !entry.endpointIds.includes(value)
+          )))
     )
       fail();
     return Object.freeze({
       ...entry,
       baseUrl,
       models,
-      endpointIds: [...entry.endpointIds],
+      ...(entry.endpointIds === undefined
+        ? {}
+        : { endpointIds: [...entry.endpointIds] }),
       workKinds: [...entry.workKinds],
       ...(entry.toolEndpointIds === undefined
         ? {}
@@ -164,6 +171,14 @@ export function parseRunsApiConnections(raw) {
   });
 }
 
+/** Whether a trusted connection may serve runs of this endpoint. */
+export function runsApiConnectionServesEndpoint(connection, endpointId) {
+  return (
+    connection.endpointIds === undefined ||
+    connection.endpointIds.includes(endpointId)
+  );
+}
+
 export function runsApiConnectionId(connection) {
   return `runs_${createHash("sha256")
     .update(
@@ -210,7 +225,7 @@ export function createConfiguredRunsClient({
   if (
     !connection ||
     env.SELLABLE_RUNTIME_ID !== connection.runtimeId ||
-    !connection.endpointIds.includes(claim.attempt.endpointId) ||
+    !runsApiConnectionServesEndpoint(connection, claim.attempt.endpointId) ||
     !connection.workKinds.includes(workKind) ||
     !connection.models.some(
       (allowed) =>

package/lib/sellable-agent/fly-customer-image/runs-api-health-check.mjs

@@ -7,6 +7,7 @@ import {
   createConfiguredRunsClient,
   RUNS_API_CONNECTIONS_ENV,
   runsApiConnectionId,
+  runsApiConnectionServesEndpoint,
   runsApiConnectionsForRuntime,
 } from "./runs-api-connections.mjs";
 
@@ -35,7 +36,7 @@ export async function checkRunsApiConnection(
   ).find(
     (candidate) =>
       runsApiConnectionId(candidate) === request.connectionId &&
-      candidate.endpointIds.includes(request.endpointId)
+      runsApiConnectionServesEndpoint(candidate, request.endpointId)
   );
   if (!connection) return result("NOT_CONFIGURED");
   try {
@@ -47,10 +48,12 @@ export async function checkRunsApiConnection(
       {
         headers: {
           authorization: `Bearer ${token}`,
-          ...(connection.protocol?.startsWith("openai-") ? {} : {
-            "x-sellable-workspace-id": connection.workspaceId,
-            "x-sellable-agent-id": connection.agentId,
-          }),
+          ...(connection.protocol?.startsWith("openai-")
+            ? {}
+            : {
+                "x-sellable-workspace-id": connection.workspaceId,
+                "x-sellable-agent-id": connection.agentId,
+              }),
         },
         redirect: "error",
         signal: AbortSignal.timeout(12_000),
@@ -141,7 +144,10 @@ export async function verifyRunsApiSelection(
         runsApiConnectionId(item) === request.connectionId &&
         item.baseUrl === selection.runsApiBaseUrl
     );
-    if (!connection?.endpointIds.includes(request.endpointId))
+    if (
+      !connection ||
+      !runsApiConnectionServesEndpoint(connection, request.endpointId)
+    )
       return result("NOT_CONFIGURED");
     verificationWorkKind = connection.workKinds.includes("STANDARD")
       ? "STANDARD"

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