@drakon-systems/multi-clawd 1.4.2 → 1.5.1

package/dist/explain-core.js

@@ -1,3 +1,27 @@
+const WINDOW_LABELS = {
+    five_hour: "5-hour",
+    seven_day: "weekly",
+    seven_day_overage_included: "weekly incl. overage",
+};
+export function relativeUntil(ms, nowMs) {
+    const mins = Math.max(0, Math.round((ms - nowMs) / 60000));
+    if (mins < 90)
+        return `~${mins}m`;
+    const hours = Math.round(mins / 60);
+    if (hours < 36)
+        return `~${hours}h`;
+    return `~${Math.round(hours / 24)}d`;
+}
+export function renderUsageLine(usage, nowMs) {
+    return usage
+        .map((u) => {
+        const label = WINDOW_LABELS[u.window] ?? u.window;
+        const pct = `${Math.round(u.utilization * 100)}%`;
+        const reset = u.resetsAt !== undefined ? ` (resets ${relativeUntil(u.resetsAt, nowMs)})` : "";
+        return `${label} ${pct}${reset}`;
+    })
+        .join(" · ");
+}
 export function describeAccount(acc) {
     if (acc.native) {
         return "the machine's main `claude` login (default config dir; OS keychain on macOS)";
@@ -82,10 +106,12 @@ export function renderExplanation(model) {
     }
     lines.push("");
     if (model.health.length > 0) {
+        const nowMs = model.nowMs ?? Date.now();
         lines.push("RIGHT NOW");
         for (const h of model.health) {
             const word = VERDICT_WORDS[h.verdict] ?? h.verdict;
             lines.push(`  ${h.id}: ${word}${h.detail ? ` — ${h.detail}` : ""}`);
+            lines.push(`      usage: ${h.usage?.length ? renderUsageLine(h.usage, nowMs) : "no live telemetry"}`);
         }
         if (model.pool) {
             lines.push(model.stickyAccount

package/dist/health.js

@@ -72,6 +72,28 @@ export function classifyAccountHealth(state, options, nowMs, requestedModel) {
         return { verdict: "no_data" };
     return worst;
 }
+export function summarizeWindowUsage(state, options, nowMs) {
+    if (!state)
+        return [];
+    const staleAfterMs = options.staleAfterMs ?? DEFAULT_STALE_AFTER_MS;
+    const usage = [];
+    for (const [window, w] of Object.entries(state.windows)) {
+        if (window.startsWith(MODEL_WINDOW_PREFIX))
+            continue;
+        if (typeof w.utilization !== "number")
+            continue;
+        const resetMs = typeof w.resetsAt === "number" ? w.resetsAt * 1000 : undefined;
+        const resetBearing = resetMs !== undefined && resetMs > nowMs;
+        if (resetBearing && nowMs - w.seenAt > MAX_RESET_HORIZON_MS)
+            continue;
+        if (resetMs !== undefined && !resetBearing)
+            continue;
+        if (!resetBearing && nowMs - w.seenAt > staleAfterMs)
+            continue;
+        usage.push({ window, utilization: w.utilization, resetsAt: resetMs });
+    }
+    return usage.sort((a, b) => (b.resetsAt ?? 0) - (a.resetsAt ?? 0));
+}
 export function choosePoolAccount(pool) {
     const usable = pool.find((a) => a.verdict === "ok" || a.verdict === "no_data");
     if (usable)

package/dist/models.js

@@ -1,5 +1,6 @@
 export const MODEL_ALIASES = {
     opus: "opus",
+    "opus-5": "claude-opus-5",
     "opus-4.8": "claude-opus-4-8",
     "opus-4.7": "claude-opus-4-7",
     "opus-4.6": "claude-opus-4-6",
@@ -8,6 +9,7 @@ export const MODEL_ALIASES = {
     haiku: "haiku",
 };
 const KNOWN_SPECS = {
+    "claude-opus-5": { name: "Claude Opus 5", contextWindow: 1000000, maxTokens: 128000 },
     "claude-opus-4-8": { name: "Claude Opus 4.8", contextWindow: 1048576, maxTokens: 128000 },
     "claude-opus-4-7": { name: "Claude Opus 4.7", contextWindow: 1048576, maxTokens: 64000 },
     "claude-opus-4-6": { name: "Claude Opus 4.6", contextWindow: 1048576, maxTokens: 64000 },

package/dist/shim-core.js

@@ -1,4 +1,5 @@
 export const PRUNE_AFTER_MS = 14 * 24 * 60 * 60 * 1000;
+export const EXPIRED_REJECTED_GRACE_MS = 5 * 60 * 1000;
 const RAW_INFO_MAX_CHARS = 512;
 export function createLineScanner(onLine) {
     let buffer = "";
@@ -106,8 +107,16 @@ export function mergeHealthStates(disk, live, now, pruneAfterMs = PRUNE_AFTER_MS
     const windows = canonicalizeModelWindowKeys(merged);
     if (now !== undefined) {
         for (const [key, w] of Object.entries(windows)) {
-            if (now - w.seenAt > pruneAfterMs)
+            if (now - w.seenAt > pruneAfterMs) {
                 delete windows[key];
+                continue;
+            }
+            const resetMs = typeof w.resetsAt === "number" ? w.resetsAt * 1000 : undefined;
+            if (w.status === "rejected" &&
+                resetMs !== undefined &&
+                now - resetMs > EXPIRED_REJECTED_GRACE_MS) {
+                delete windows[key];
+            }
         }
     }
     const updatedAt = Math.max(disk.updatedAt ?? 0, live.updatedAt ?? 0);

package/openclaw.plugin.json

@@ -1,9 +1,18 @@
 {
   "id": "multi-clawd",
   "name": "multi-clawd",
+  "version": "1.5.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", "claw2", "clawd"],
-  "providers": ["claw1", "claw2", "clawd"],
+  "cliBackends": [
+    "claw1",
+    "claw2",
+    "clawd"
+  ],
+  "providers": [
+    "claw1",
+    "claw2",
+    "clawd"
+  ],
   "modelCatalog": {
     "runtimeAugment": true
   },
@@ -29,7 +38,9 @@
           },
           "accounts": {
             "type": "array",
-            "items": { "type": "string" },
+            "items": {
+              "type": "string"
+            },
             "description": "Account ids (from accounts[]) in preference order; the first is the home account and reclaims the pool when its usage window resets."
           },
           "utilizationThreshold": {
@@ -51,7 +62,9 @@
             "properties": {
               "ladder": {
                 "type": "array",
-                "items": { "type": "string" },
+                "items": {
+                  "type": "string"
+                },
                 "description": "Same-provider models to step down to, best first (e.g. [\"claude-opus-4-8\"]). Requests already at/below the ladder never degrade further."
               },
               "pins": {
@@ -61,8 +74,14 @@
                   "type": "object",
                   "additionalProperties": false,
                   "properties": {
-                    "agentDirIncludes": { "type": "string", "description": "Pin when the launching agent's dir contains this substring." },
-                    "workspaceDirIncludes": { "type": "string", "description": "Pin when the workspace dir contains this substring." }
+                    "agentDirIncludes": {
+                      "type": "string",
+                      "description": "Pin when the launching agent's dir contains this substring."
+                    },
+                    "workspaceDirIncludes": {
+                      "type": "string",
+                      "description": "Pin when the workspace dir contains this substring."
+                    }
                   }
                 }
               }
@@ -70,7 +89,9 @@
           },
           "models": {
             "type": "array",
-            "items": { "type": "string" },
+            "items": {
+              "type": "string"
+            },
             "description": "Extra model ids to expose on the pool backend."
           },
           "defaultModel": {
@@ -85,7 +106,9 @@
         "items": {
           "type": "object",
           "additionalProperties": false,
-          "required": ["id"],
+          "required": [
+            "id"
+          ],
           "properties": {
             "id": {
               "type": "string",
@@ -112,14 +135,25 @@
               "description": "Secret reference resolving to this account's Claude Code setup-token via the gateway's configured secret providers — same shape as every other secret in openclaw.json, e.g. {\"source\":\"exec\",\"provider\":\"onepassword\",\"id\":\"op://Vault/Item/field\"}. Preferred over oauthTokenFile (no plaintext on disk). Resolution failures degrade the account (auth fails, chain steps) rather than crashing the launch.",
               "additionalProperties": true,
               "properties": {
-                "source": { "type": "string", "description": "Secret source kind: env | file | exec." },
-                "provider": { "type": "string", "description": "Configured secret provider name, e.g. \"onepassword\"." },
-                "id": { "type": "string", "description": "Provider-scoped secret id, e.g. an op:// reference." }
+                "source": {
+                  "type": "string",
+                  "description": "Secret source kind: env | file | exec."
+                },
+                "provider": {
+                  "type": "string",
+                  "description": "Configured secret provider name, e.g. \"onepassword\"."
+                },
+                "id": {
+                  "type": "string",
+                  "description": "Provider-scoped secret id, e.g. an op:// reference."
+                }
               }
             },
             "models": {
               "type": "array",
-              "items": { "type": "string" },
+              "items": {
+                "type": "string"
+              },
               "description": "Extra model ids to expose for this account beyond the mirrored claude-cli catalog (e.g. a brand-new model OpenClaw doesn't list yet). Unknown modern claude-* ids also resolve on demand without being listed here."
             },
             "defaultModel": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drakon-systems/multi-clawd",
-  "version": "1.4.2",
+  "version": "1.5.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.",
   "type": "module",
   "license": "MIT",
@@ -55,7 +55,9 @@
     "test:watch": "vitest",
     "prepare": "npm run build",
     "doctor": "node scripts/doctor.mjs",
-    "setup": "node scripts/setup.mjs"
+    "setup": "node scripts/setup.mjs",
+    "sync-manifest": "node -e \"const fs=require('fs');const m=JSON.parse(fs.readFileSync('openclaw.plugin.json','utf8'));m.version=process.env.npm_package_version||JSON.parse(fs.readFileSync('package.json','utf8')).version;fs.writeFileSync('openclaw.plugin.json',JSON.stringify(m,null,2)+'\\n')\"",
+    "version": "npm run sync-manifest && git add openclaw.plugin.json"
   },
   "peerDependencies": {
     "openclaw": ">=2026.6"

package/scripts/cli.mjs

@@ -253,7 +253,11 @@ async function explain() {
     if (h.verdict === "exhausted" && h.resumeAt) {
       detail = `${h.reason ?? "limit hit"} — back in ${rel(h.resumeAt)}`;
     }
-    return { id: a.id, verdict: h.verdict, detail };
+    const usage = health.summarizeWindowUsage(state, {
+      utilizationThreshold: pool?.utilizationThreshold,
+      staleAfterMs: pool?.staleAfterMs,
+    }, now);
+    return { id: a.id, verdict: h.verdict, detail, usage };
   });
   let stickyAccount;
   if (pool) {
@@ -266,7 +270,7 @@ async function explain() {
   }
   console.log(`\n${BOLD}🦞 multi-clawd — your setup, in plain English${RESET}\n`);
   console.log(
-    ec.renderExplanation({ accounts, pool, chain, health: healthRows, stickyAccount }),
+    ec.renderExplanation({ accounts, pool, chain, health: healthRows, stickyAccount, nowMs: now }),
   );
   console.log(`\n${DIM}(health checks: multi-clawd doctor · change things: multi-clawd setup)${RESET}`);
 }