@drakon-systems/multi-clawd 1.8.0 → 1.8.1

package/README.md

@@ -364,7 +364,7 @@ openclaw plugins install (Get-Location).Path
 **Or let your agent install it.** Running an OpenClaw assistant or Claude
 Code on the target machine already? Paste it this and go make coffee:
 
-> Read https://raw.githubusercontent.com/Drakon-Systems-Ltd/multi-clawd/v1.8.0/SETUP-AGENT.md
+> Read https://raw.githubusercontent.com/Drakon-Systems-Ltd/multi-clawd/v1.8.1/SETUP-AGENT.md
 > and follow it to set up multi-clawd on this machine. I own a second
 > Claude account — ask me when you need me to log in.
 

package/dist/credential-state.js

@@ -0,0 +1,30 @@
+import { readFileSync, writeFileSync, mkdirSync, renameSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { parseStoredState, mergeHealthStates, clearCredentialFailure, } from "./shim-core.js";
+export function healthStateFile(accountId) {
+    return join(homedir(), ".openclaw", "state", "multi-clawd", `${accountId}.json`);
+}
+export function clearAccountCredentialFailure(accountId) {
+    const file = healthStateFile(accountId);
+    let state;
+    try {
+        state = parseStoredState(readFileSync(file, "utf8")) ?? { accountId, windows: {} };
+    }
+    catch {
+        return false;
+    }
+    if (state.credential?.status !== "failed")
+        return false;
+    const cleared = mergeHealthStates(state, clearCredentialFailure(state, Date.now()), Date.now());
+    try {
+        mkdirSync(dirname(file), { recursive: true });
+        const tmp = `${file}.tmp-${process.pid}`;
+        writeFileSync(tmp, JSON.stringify(cleared, null, 2), { mode: 0o600 });
+        renameSync(tmp, file);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/index.js

@@ -11,10 +11,12 @@ import { resolveExecMode, permissionModeArgs } from "./exec-policy.js";
 import { resolveBaseModelIds } from "./catalog-source.js";
 import { allCredentialFailed, classifyAccountHealth } from "./health.js";
 import { decideStickySelection } from "./sticky.js";
-import { clearCredentialFailure, mergeHealthStates, parseStoredState, recordCredentialFailure, } from "./shim-core.js";
+import { mergeHealthStates, parseStoredState, recordCredentialFailure, } from "./shim-core.js";
 import { createTokenRefResolver, isSecretRefShape, } from "./token-resolution.js";
 import { resolveSecretRefValues } from "openclaw/plugin-sdk/secret-ref-runtime";
 import { addAlert, alertKeysWithPrefix, clearAlert, pendingAlertText, } from "./alerts.js";
+import { healthStateFile, clearAccountCredentialFailure } from "./credential-state.js";
+export { healthStateFile, clearAccountCredentialFailure };
 import { buildAccountChildEnv, tokenFileModeWarning, validateAccountTokenSources, } from "./account-env.js";
 import { diffCatalogModels, formatNewModelNotice, } from "./model-currency.js";
 import { checkAccountCredential, createRefProbeTracker, } from "./login-health.js";
@@ -285,9 +287,6 @@ function buildRuntimeModel(account, modelId) {
     };
 }
 const SHIM_PATH = fileURLToPath(new URL("./shim.js", import.meta.url));
-export function healthStateFile(accountId) {
-    return join(homedir(), ".openclaw", "state", "multi-clawd", `${accountId}.json`);
-}
 function knownModelsFile() {
     return join(homedir(), ".openclaw", "state", "multi-clawd", "known-models.json");
 }
@@ -500,32 +499,6 @@ function readHealthState(accountId) {
         return undefined;
     }
 }
-export function clearAccountCredentialFailure(accountId) {
-    const file = healthStateFile(accountId);
-    let state;
-    try {
-        state = parseStoredState(readFileSync(file, "utf8")) ?? {
-            accountId,
-            windows: {},
-        };
-    }
-    catch {
-        return false;
-    }
-    if (state.credential?.status !== "failed")
-        return false;
-    const cleared = mergeHealthStates(state, clearCredentialFailure(state, Date.now()), Date.now());
-    try {
-        mkdirSync(dirname(file), { recursive: true });
-        const tmp = `${file}.tmp-${process.pid}`;
-        writeFileSync(tmp, JSON.stringify(cleared, null, 2), { mode: 0o600 });
-        renameSync(tmp, file);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 function readStickyEntry(file) {
     try {
         const parsed = JSON.parse(readFileSync(file, "utf8"));

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "multi-clawd",
   "name": "multi-clawd",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "Register additional Claude Code logins (Max/Pro accounts) as first-class OpenClaw CLI backends for cross-account failover, keeping the full skills/MCP harness on every account.",
   "cliBackends": [
     "claw1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drakon-systems/multi-clawd",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "Multi-account Claude Code failover for OpenClaw — register additional Claude (Max/Pro) logins as first-class CLI backends and keep the full skills/MCP harness across every account. Also imports those accounts' setup tokens into Hermes Agent's Anthropic credential pool.",
   "type": "module",
   "license": "MIT",

package/scripts/cli.mjs

@@ -16,7 +16,7 @@
  * has to remember `--pin --force`.
  */
 import { execFileSync, spawnSync } from "node:child_process";
-import { readFileSync } from "node:fs";
+import { readFileSync, existsSync as existsSyncEarly } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import readline from "node:readline/promises";
@@ -92,6 +92,34 @@ async function askYes(question, dflt = true) {
 }
 
 /** This package's own version (the CLI half). */
+/**
+ * Why a `dist/` import failed, in the user's terms.
+ *
+ * The bare "reinstall the package" message was wrong in the one case that
+ * actually happens: this CLI installs globally, `openclaw` is a peerDependency,
+ * and on a box where the peer is not resolvable from this directory a perfectly
+ * complete build still throws ERR_MODULE_NOT_FOUND. Reinstalling cannot fix
+ * that, so "reinstall the package" sends people in circles — it did, on a Mac,
+ * 18 Aug 2026. Check the file exists first, then report the real cause.
+ */
+function distFailure(cmd, mod, err) {
+  const path = resolve(__dirname, "..", "dist", mod);
+  if (!existsSyncEarly(path)) {
+    return `${cmd}: built dist/${mod} is missing — reinstall the package.`;
+  }
+  const missingPeer = /Cannot find package '([^']+)'/.exec(String(err?.message ?? ""));
+  if (missingPeer) {
+    const peer = missingPeer[1];
+    return [
+      `${cmd}: dist/${mod} is present but cannot load — the "${peer}" package is not`,
+      `resolvable from this install (${resolve(__dirname, "..")}).`,
+      `Install "${peer}" globally alongside this CLI, or run the CLI with npx from a`,
+      `directory where "${peer}" resolves.`,
+    ].join("\n  ");
+  }
+  return `${cmd}: dist/${mod} failed to load — ${err?.message ?? err}`;
+}
+
 function cliVersion() {
   return JSON.parse(readFileSync(resolve(__dirname, "..", "package.json"), "utf8")).version;
 }
@@ -134,8 +162,8 @@ async function chain(args = []) {
   let ca;
   try {
     ca = await import(resolve(__dirname, "..", "dist", "chain-audit.js"));
-  } catch {
-    console.error("chain: built dist/ is missing — reinstall the package.");
+  } catch (err) {
+    console.error(distFailure("chain", "chain-audit.js", err));
     process.exit(1);
   }
 
@@ -227,8 +255,8 @@ async function update() {
   let uc;
   try {
     uc = await import(resolve(__dirname, "..", "dist", "update-core.js"));
-  } catch {
-    console.error("update: built dist/ is missing — reinstall the package.");
+  } catch (err) {
+    console.error(distFailure("update", "update-core.js", err));
     process.exit(1);
   }
   console.log(`\n${BOLD}🦞 multi-clawd update${RESET}\n`);
@@ -391,8 +419,8 @@ async function explain() {
     ec = await import(resolve(__dirname, "..", "dist", "explain-core.js"));
     health = await import(resolve(__dirname, "..", "dist", "health.js"));
     shim = await import(resolve(__dirname, "..", "dist", "shim-core.js"));
-  } catch {
-    console.error("explain: built dist/ is missing — reinstall the package.");
+  } catch (err) {
+    console.error(distFailure("explain", "explain-core.js", err));
     process.exit(1);
   }
   let config = {};
@@ -465,9 +493,12 @@ async function login() {
   try {
     lp = await import(resolve(__dirname, "..", "dist", "login-plan.js"));
     ec = await import(resolve(__dirname, "..", "dist", "explain-core.js"));
-    idx = await import(resolve(__dirname, "..", "dist", "index.js"));
-  } catch {
-    console.error("login: built dist/ is missing — reinstall the package.");
+    // credential-state.js, NOT index.js: this is the one call login needs from
+    // the plugin side, and index.js drags in the `openclaw` peer, which is not
+    // resolvable from a global CLI install on every machine.
+    idx = await import(resolve(__dirname, "..", "dist", "credential-state.js"));
+  } catch (err) {
+    console.error(distFailure("login", "login-plan.js", err));
     process.exit(1);
   }
   let config = {};