@sellable/install 0.1.798 → 0.1.799

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.799
 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.799" \
     && 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.799' || 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.799', 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.799` 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.799
 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,
@@ -55,8 +63,14 @@ export function endpointToolNames(options: {
 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 +79,7 @@ export function startClaudeRun(
   request: ClaudeRunsRequest,
   options: {
     root: string;
+    configDir?: string;
     spawnImpl?: (...args: any[]) => any;
     timeoutMs?: number;
   }
@@ -82,6 +97,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,
@@ -132,7 +134,12 @@ export function endpointToolNames({
   return [...names];
 }
 
-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 +196,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 +209,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 +244,90 @@ 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;
+
+// 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 +366,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 +387,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 +433,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,39 +456,100 @@ 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();
+  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 checkAuthentication(configDir);
+          if (stopped) throw new Error("claude_runs_cancelled");
+          if (state !== "READY") {
+            failure ??=
+              state === "SIGN_IN_REQUIRED"
+                ? "claude_runs_sign_in_required"
+                : "claude_runs_auth_check_unavailable";
+            continue;
+          }
+          activeRun = startRun(request, {
+            root: connection.localRoot,
+            configDir,
+          });
+          try {
+            return await activeRun.promise;
+          } catch (error) {
+            if (stopped || error.message !== "claude_runs_usage_limited")
+              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 checkAuthentication(configDir).catch(
+        () => "UNAVAILABLE"
+      );
+      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;
@@ -465,12 +629,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,
@@ -521,7 +684,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 +705,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.799";
 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/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.799";
 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.799" ||
       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.799" ||
     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.799";
 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.799",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code, Codex, and Hermes",
   "bin": {