@thelioo/opencode-balancer 0.1.0

package/INSTALL.txt

@@ -0,0 +1,58 @@
+opencode-balancer installation guide for AI agents
+
+Goal
+Install @thelioo/opencode-balancer as an opencode npm plugin without removing or rewriting the user's existing opencode configuration.
+
+What this plugin does
+opencode-balancer lets opencode users save multiple authenticated accounts per provider, switch active accounts with /balancer commands, and automatically retry with another saved account when the active account is rate-limited.
+
+Important rules
+- Do not run npm install for this plugin. opencode installs npm plugins automatically with Bun at startup.
+- Preserve existing opencode config, plugins, comments, formatting, providers, agents, MCP servers, and permissions whenever possible.
+- Use the singular key "plugin", not "plugins".
+- Add the plugin only if it is not already present.
+- Prefer @thelioo/opencode-balancer@latest for user installs.
+
+Steps
+1. Locate the user's opencode config.
+   - Prefer ~/.config/opencode/opencode.jsonc if it exists.
+   - Otherwise use ~/.config/opencode/opencode.json if it exists.
+   - If neither exists, create ~/.config/opencode/opencode.json with a minimal JSON object.
+
+2. Ensure the config has a top-level plugin array.
+   - If plugin already exists and is an array, keep all existing entries.
+   - If plugin is missing, create it.
+   - If the config is JSONC, keep JSONC syntax valid.
+   - If the config is JSON, keep JSON syntax valid.
+
+3. Add this plugin entry:
+   @thelioo/opencode-balancer@latest
+
+4. Save the config.
+
+5. Show the user the final plugin array.
+
+6. Tell the user to restart opencode.
+
+Expected config shape
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@thelioo/opencode-balancer@latest"]
+}
+
+After restart
+The user can connect and save accounts with:
+/connect anthropic
+/balancer alias work
+
+Useful commands
+/balancer help
+/balancer list
+/balancer status
+/balancer use <provider> <alias>
+/balancer remove <provider> <alias>
+
+Verification
+- Confirm the opencode config contains @thelioo/opencode-balancer@latest in the plugin array.
+- Confirm no existing plugin entries were removed.
+- Remind the user that opencode must be restarted before /balancer becomes available.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thelioo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,172 @@
+<div align="center">
+
+# opencode-balancer
+
+_Use multiple accounts per opencode provider and switch automatically when one hits a rate limit._
+
+[![npm version](https://img.shields.io/npm/v/@thelioo/opencode-balancer?style=flat-square)](https://www.npmjs.com/package/@thelioo/opencode-balancer)
+[![TypeScript](https://img.shields.io/badge/TypeScript-blue?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org)
+[![opencode plugin](https://img.shields.io/badge/opencode-plugin-111?style=flat-square)](https://opencode.ai/docs/plugins)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)](LICENSE)
+
+[Features](#features) | [Installation](#installation) | [Usage](#usage) | [Commands](#commands) | [Troubleshooting](#troubleshooting)
+
+</div>
+
+`opencode-balancer` is an [opencode](https://opencode.ai/) plugin that lets you save multiple authenticated accounts for the same provider, give each one a friendly alias, and keep working when the active account becomes rate-limited.
+
+It works with opencode's existing auth flow: connect a provider, save the detected credentials as an alias, then let the plugin inject the active account credentials into future model requests.
+
+> [!NOTE]
+> This plugin manages credentials already configured through opencode. It does not create accounts, bypass provider limits, or modify provider-side quotas.
+
+## Features
+
+- **Multiple accounts per provider**: Save aliases like `work`, `personal`, or `backup` for the same provider.
+- **Automatic failover**: Switches to another saved account on retryable rate-limit/server responses.
+- **Native opencode commands**: Adds `/balancer` directly inside opencode.
+- **OAuth-friendly setup**: Adds an optional alias prompt to provider OAuth flows.
+- **Agent tool support**: Exposes a `balancer_command` tool so opencode agents can manage accounts when asked.
+- **Local credential store**: Saves account metadata under your opencode config directory.
+
+## Installation
+
+### Option A: Let an AI Agent Install It
+
+Paste this into opencode or another coding agent running on your machine:
+
+```text
+Install and configure @thelioo/opencode-balancer by following this guide:
+https://raw.githubusercontent.com/thelioo/opencode-balancer/refs/heads/main/INSTALL.txt
+```
+
+Or read the local guide: [INSTALL.txt](INSTALL.txt).
+
+### Option B: Manual Setup
+
+Add the plugin to your opencode config:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@thelioo/opencode-balancer@latest"]
+}
+```
+
+Then restart opencode.
+
+> [!TIP]
+> No manual `npm install` is required. opencode automatically installs npm plugins with Bun at startup and caches them locally.
+
+## Usage
+
+### Save Your First Account
+
+Connect a provider as usual:
+
+```text
+/connect anthropic
+```
+
+After the connection is detected, save it with an alias:
+
+```text
+/balancer alias work
+```
+
+### Add Another Account
+
+Connect the same provider with a different account, then save it:
+
+```text
+/connect anthropic
+/balancer alias personal
+```
+
+### Switch Accounts Manually
+
+```text
+/balancer use anthropic work
+```
+
+### List Saved Accounts
+
+```text
+/balancer list
+```
+
+Example output:
+
+```text
+anthropic:
+  * work (oauth, healthy)
+    personal (oauth, healthy)
+```
+
+When the active account receives a retryable response such as `429`, `500`, `502`, `503`, `504`, or `529`, the plugin marks it as temporarily rate-limited and retries with another available account for the same provider.
+
+## Commands
+
+| Command | Description |
+| --- | --- |
+| `/balancer help` | Show available commands. |
+| `/balancer alias <name>` | Save the last detected connection with an alias. |
+| `/balancer save <provider> <name>` | Save the provider's current native credentials. |
+| `/balancer use <provider> <name>` | Switch the active account for a provider. |
+| `/balancer list` | List saved accounts. |
+| `/balancer status` | Show saved accounts, last capture, and storage path. |
+| `/balancer remove <provider> <name>` | Remove a saved account. |
+
+Aliases are normalized to lowercase and may contain letters, numbers, dots, hyphens, and underscores.
+
+## How It Works
+
+`opencode-balancer` hooks into opencode's plugin lifecycle and request flow:
+
+1. It watches opencode auth changes and records the last detected provider credentials.
+2. `/balancer alias <name>` stores those credentials under a provider-specific alias.
+3. Before model requests, the plugin selects the active account for the request provider.
+4. If the provider returns a retryable rate-limit or server response, the plugin marks the account as temporarily unavailable and retries with another saved account.
+
+Saved account data is written to:
+
+```text
+~/.config/opencode/balancer-accounts.json
+```
+
+If `OPENCODE_CONFIG_DIR` is set, the plugin uses that directory instead.
+
+> [!CAUTION]
+> The account store contains credentials. Keep it private and do not commit it to a repository.
+
+## Local Development
+
+```bash
+npm install
+npm run check
+npm run build
+```
+
+To test a local checkout with opencode, point your config to the package directory:
+
+```json
+{
+  "plugin": ["file:///absolute/path/to/opencode-balancer"]
+}
+```
+
+## Troubleshooting
+
+| Problem | What to try |
+| --- | --- |
+| Plugin does not load | Confirm `plugin` is singular, restart opencode, and check that the package name is `@thelioo/opencode-balancer@latest`. |
+| `/balancer` is unavailable | Restart opencode after editing the config. |
+| No connection detected | Run `/connect <provider>` first, then `/balancer alias <name>`. |
+| Account is not switching | Run `/balancer list` and confirm there is another healthy account for the same provider. |
+| Need to inspect storage | Run `/balancer status` to see the account store path. |
+
+## Resources
+
+- [opencode plugins documentation](https://opencode.ai/docs/plugins)
+- [opencode configuration](https://opencode.ai/docs/config)
+- [npm package](https://www.npmjs.com/package/@thelioo/opencode-balancer)

package/dist/balancer/accounts.d.ts

@@ -0,0 +1,9 @@
+import type { Account, AuthInfo, ProviderState } from "./types";
+export declare function normalizeAlias(alias: string): string;
+export declare function saveAccount(providerID: string, aliasInput: string, auth: AuthInfo): Promise<Account>;
+export declare function getProviderState(providerID: string): Promise<ProviderState | undefined>;
+export declare function getActiveAccount(providerID: string): Promise<Account | undefined>;
+export declare function listAccountsText(): Promise<string>;
+export declare function nextAvailableAccount(providerID: string, currentAlias?: string): Promise<Account | undefined>;
+export declare function markRateLimited(providerID: string, alias: string, retryAfterMs?: number): Promise<void>;
+export declare function markUsed(providerID: string, alias: string): Promise<void>;

package/dist/balancer/accounts.js

@@ -0,0 +1,102 @@
+import { now } from "./state";
+import { readStore, writeStore } from "./storage";
+export function normalizeAlias(alias) {
+    return alias
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+export async function saveAccount(providerID, aliasInput, auth) {
+    const alias = normalizeAlias(aliasInput);
+    if (!alias)
+        throw new Error("Invalid alias. Use letters, numbers, dots, hyphens, or underscores.");
+    const store = await readStore();
+    const provider = store.providers[providerID] ?? { accounts: {} };
+    const existing = provider.accounts[alias];
+    const account = {
+        alias,
+        providerID,
+        auth,
+        createdAt: existing?.createdAt ?? now(),
+        updatedAt: now(),
+        lastUsedAt: existing?.lastUsedAt,
+        failures: existing?.failures,
+        rateLimitedUntil: existing?.rateLimitedUntil,
+    };
+    provider.accounts[alias] = account;
+    provider.active = alias;
+    store.providers[providerID] = provider;
+    store.lastCaptured = {
+        providerID,
+        auth,
+        capturedAt: now(),
+        source: store.lastCaptured?.source ?? "auth-file",
+    };
+    await writeStore(store);
+    return account;
+}
+export async function getProviderState(providerID) {
+    return (await readStore()).providers[providerID];
+}
+export async function getActiveAccount(providerID) {
+    const provider = await getProviderState(providerID);
+    if (!provider?.active)
+        return undefined;
+    return provider.accounts[provider.active];
+}
+export async function listAccountsText() {
+    const store = await readStore();
+    const lines = [];
+    for (const [providerID, provider] of Object.entries(store.providers).sort(([a], [b]) => a.localeCompare(b))) {
+        lines.push(`${providerID}:`);
+        const accounts = Object.values(provider.accounts).sort((a, b) => a.alias.localeCompare(b.alias));
+        if (accounts.length === 0) {
+            lines.push("  (no accounts)");
+            continue;
+        }
+        for (const account of accounts) {
+            const marker = provider.active === account.alias ? "*" : " ";
+            const limited = account.rateLimitedUntil && account.rateLimitedUntil > now()
+                ? ` rate-limited ${Math.ceil((account.rateLimitedUntil - now()) / 1000)}s`
+                : "healthy";
+            lines.push(`  ${marker} ${account.alias} (${account.auth.type}, ${limited})`);
+        }
+    }
+    if (lines.length === 0)
+        return "No accounts saved. Use `/connect <provider>` and then `/balancer alias <name>`.";
+    const last = store.lastCaptured;
+    if (last)
+        lines.push("", `Last detected connection: ${last.providerID} (${last.auth.type})`);
+    return lines.join("\n");
+}
+export async function nextAvailableAccount(providerID, currentAlias) {
+    const provider = await getProviderState(providerID);
+    if (!provider)
+        return undefined;
+    const accounts = Object.values(provider.accounts);
+    return accounts.find((account) => account.alias !== currentAlias &&
+        (!account.rateLimitedUntil || account.rateLimitedUntil <= now()));
+}
+export async function markRateLimited(providerID, alias, retryAfterMs = 60_000) {
+    const store = await readStore();
+    const account = store.providers[providerID]?.accounts[alias];
+    if (!account)
+        return;
+    account.failures = (account.failures ?? 0) + 1;
+    account.rateLimitedUntil = now() + retryAfterMs;
+    account.updatedAt = now();
+    await writeStore(store);
+}
+export async function markUsed(providerID, alias) {
+    const store = await readStore();
+    const account = store.providers[providerID]?.accounts[alias];
+    if (!account)
+        return;
+    account.lastUsedAt = now();
+    account.updatedAt = now();
+    if (account.rateLimitedUntil && account.rateLimitedUntil <= now())
+        delete account.rateLimitedUntil;
+    await writeStore(store);
+}
+//# sourceMappingURL=accounts.js.map

package/dist/balancer/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../src/balancer/accounts.ts"],"names":[],"mappings":"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"}

package/dist/balancer/auth-watcher.d.ts

@@ -0,0 +1 @@
+export declare function startAuthWatcher(client: any): void;

package/dist/balancer/auth-watcher.js

@@ -0,0 +1,30 @@
+import { authPath, captureAuth, isAuthInfo, now, readNativeAuth, showToast, state, } from "./core";
+export function startAuthWatcher(client) {
+    if (state.watchStarted)
+        return;
+    state.watchStarted = true;
+    void readNativeAuth().then((auth) => {
+        state.lastAuthSnapshot = auth;
+    });
+    const path = authPath();
+    const handleChange = async () => {
+        const next = await readNativeAuth();
+        for (const [providerID, auth] of Object.entries(next)) {
+            if (!isAuthInfo(auth))
+                continue;
+            const suppressedUntil = state.suppressAuthCaptureUntil.get(providerID) ?? 0;
+            if (suppressedUntil > now())
+                continue;
+            const previous = JSON.stringify(state.lastAuthSnapshot[providerID] ?? null);
+            const current = JSON.stringify(auth);
+            if (previous === current)
+                continue;
+            await captureAuth(providerID, auth, "auth-file");
+            await showToast(client, `Balancer: new ${providerID} connection detected. Use /balancer alias <name>.`, "info");
+        }
+        state.lastAuthSnapshot = next;
+    };
+    const timer = setInterval(() => void handleChange(), 1_000);
+    timer.unref?.();
+}
+//# sourceMappingURL=auth-watcher.js.map

package/dist/balancer/auth-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-watcher.js","sourceRoot":"","sources":["../../src/balancer/auth-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,QAAQ,EACR,WAAW,EACX,UAAU,EACV,GAAG,EACH,cAAc,EACd,SAAS,EACT,KAAK,GACR,MAAM,QAAQ,CAAC;AAEhB,MAAM,UAAU,gBAAgB,CAAC,MAAW;IACxC,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO;IAC/B,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;IAC1B,KAAK,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QAChC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAClC,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;IACxB,MAAM,YAAY,GAAG,KAAK,IAAI,EAAE;QAC5B,MAAM,IAAI,GAAG,MAAM,cAAc,EAAE,CAAC;QACpC,KAAK,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,SAAS;YAChC,MAAM,eAAe,GACjB,KAAK,CAAC,wBAAwB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACxD,IAAI,eAAe,GAAG,GAAG,EAAE;gBAAE,SAAS;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAC3B,KAAK,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,IAAI,CAC7C,CAAC;YACF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,QAAQ,KAAK,OAAO;gBAAE,SAAS;YACnC,MAAM,WAAW,CAAC,UAAU,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;YACjD,MAAM,SAAS,CACX,MAAM,EACN,iBAAiB,UAAU,mDAAmD,EAC9E,MAAM,CACT,CAAC;QACN,CAAC;QACD,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAClC,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,YAAY,EAAE,EAAE,KAAK,CAAC,CAAC;IAC3D,KAAgC,CAAC,KAAK,EAAE,EAAE,CAAC;AAChD,CAAC"}

package/dist/balancer/commands.d.ts

@@ -0,0 +1 @@
+export declare function runBalancerCommand(client: any, raw: string): Promise<string>;

package/dist/balancer/commands.js

@@ -0,0 +1,94 @@
+import { isAuthInfo, listAccountsText, normalizeAlias, readNativeAuth, readStore, saveAccount, setNativeAuth, storePath, writeStore, } from "./core";
+function parseArgs(input) {
+    return (input
+        .match(/(?:[^\s"]+|"[^"]*")+/g)
+        ?.map((x) => x.replace(/^"|"$/g, "")) ?? []);
+}
+export async function runBalancerCommand(client, raw) {
+    const [action = "help", ...args] = parseArgs(raw);
+    const store = await readStore();
+    if (["help", "--help", "-h"].includes(action)) {
+        return [
+            "Balancer commands:",
+            "",
+            "  /balancer alias <name>",
+            "    saves the last detected connection",
+            "    with an alias",
+            "",
+            "  /balancer save <provider> <name>",
+            "    saves the provider's current credentials",
+            "",
+            "  /balancer use <provider> <name>",
+            "    switches the active account",
+            "",
+            "  /balancer list",
+            "    lists accounts",
+            "",
+            "  /balancer status",
+            "    shows current state",
+            "",
+            "  /balancer remove <provider> <name>",
+            "    removes an account",
+        ].join("\n");
+    }
+    if (action === "alias") {
+        const alias = args[0];
+        if (!alias)
+            return "Usage: /balancer alias <name>";
+        const captured = store.lastCaptured;
+        if (!captured)
+            return "No connection detected yet. Run /connect <provider> first.";
+        const account = await saveAccount(captured.providerID, alias, captured.auth);
+        await setNativeAuth(client, captured.providerID, captured.auth);
+        return `Account saved and activated: ${captured.providerID}/${account.alias}`;
+    }
+    if (action === "save") {
+        const [providerID, alias] = args;
+        if (!providerID || !alias)
+            return "Usage: /balancer save <provider> <name>";
+        const auth = (await readNativeAuth())[providerID];
+        if (!isAuthInfo(auth))
+            return `No native credentials found for ${providerID}. Run /connect ${providerID} first.`;
+        const account = await saveAccount(providerID, alias, auth);
+        return `Account saved and activated: ${providerID}/${account.alias}`;
+    }
+    if (action === "use") {
+        const [providerID, aliasInput] = args;
+        const alias = normalizeAlias(aliasInput ?? "");
+        if (!providerID || !alias)
+            return "Usage: /balancer use <provider> <name>";
+        const account = store.providers[providerID]?.accounts[alias];
+        if (!account)
+            return `Account not found: ${providerID}/${alias}`;
+        store.providers[providerID].active = alias;
+        await writeStore(store);
+        await setNativeAuth(client, providerID, account.auth);
+        return `Active account changed to ${providerID}/${alias}`;
+    }
+    if (action === "list" || action === "accounts")
+        return listAccountsText();
+    if (action === "status") {
+        const last = store.lastCaptured;
+        const lines = [await listAccountsText()];
+        if (last)
+            lines.push("", `Last capture: ${last.providerID} via ${last.source} at ${new Date(last.capturedAt).toLocaleString()}`);
+        lines.push("", `Storage: ${storePath()}`);
+        return lines.join("\n");
+    }
+    if (action === "remove") {
+        const [providerID, aliasInput] = args;
+        const alias = normalizeAlias(aliasInput ?? "");
+        if (!providerID || !alias)
+            return "Usage: /balancer remove <provider> <name>";
+        const provider = store.providers[providerID];
+        if (!provider?.accounts[alias])
+            return `Account not found: ${providerID}/${alias}`;
+        delete provider.accounts[alias];
+        if (provider.active === alias)
+            provider.active = Object.keys(provider.accounts)[0];
+        await writeStore(store);
+        return `Account removed: ${providerID}/${alias}`;
+    }
+    return `Unknown command: ${action}. Use /balancer help.`;
+}
+//# sourceMappingURL=commands.js.map

package/dist/balancer/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/balancer/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,SAAS,EACT,WAAW,EACX,aAAa,EACb,SAAS,EACT,UAAU,GACb,MAAM,QAAQ,CAAC;AAEhB,SAAS,SAAS,CAAC,KAAa;IAC5B,OAAO,CACH,KAAK;SACA,KAAK,CAAC,uBAAuB,CAAC;QAC/B,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAClD,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAW,EAAE,GAAW;IAC7D,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAEhC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,OAAO;YACH,oBAAoB;YACpB,EAAE;YACF,0BAA0B;YAC1B,wCAAwC;YACxC,mBAAmB;YACnB,EAAE;YACF,oCAAoC;YACpC,8CAA8C;YAC9C,EAAE;YACF,mCAAmC;YACnC,iCAAiC;YACjC,EAAE;YACF,kBAAkB;YAClB,oBAAoB;YACpB,EAAE;YACF,oBAAoB;YACpB,yBAAyB;YACzB,EAAE;YACF,sCAAsC;YACtC,wBAAwB;SAC3B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK;YAAE,OAAO,+BAA+B,CAAC;QACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC;QACpC,IAAI,CAAC,QAAQ;YACT,OAAO,4DAA4D,CAAC;QACxE,MAAM,OAAO,GAAG,MAAM,WAAW,CAC7B,QAAQ,CAAC,UAAU,EACnB,KAAK,EACL,QAAQ,CAAC,IAAI,CAChB,CAAC;QACF,MAAM,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChE,OAAO,gCAAgC,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAClF,CAAC;IAED,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;QACjC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK;YACrB,OAAO,yCAAyC,CAAC;QACrD,MAAM,IAAI,GAAG,CAAC,MAAM,cAAc,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YACjB,OAAO,mCAAmC,UAAU,kBAAkB,UAAU,SAAS,CAAC;QAC9F,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC3D,OAAO,gCAAgC,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IACzE,CAAC;IAED,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACnB,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC;QACtC,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK;YACrB,OAAO,wCAAwC,CAAC;QACpD,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO;YAAE,OAAO,sBAAsB,UAAU,IAAI,KAAK,EAAE,CAAC;QACjE,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC;QAC3C,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;QACxB,MAAM,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACtD,OAAO,6BAA6B,UAAU,IAAI,KAAK,EAAE,CAAC;IAC9D,CAAC;IAED,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,gBAAgB,EAAE,CAAC;IAE1E,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC;QAChC,MAAM,KAAK,GAAG,CAAC,MAAM,gBAAgB,EAAE,CAAC,CAAC;QACzC,IAAI,IAAI;YACJ,KAAK,CAAC,IAAI,CACN,EAAE,EACF,iBAAiB,IAAI,CAAC,UAAU,QAAQ,IAAI,CAAC,MAAM,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,cAAc,EAAE,EAAE,CACzG,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,SAAS,EAAE,EAAE,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC;QACtC,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK;YACrB,OAAO,2CAA2C,CAAC;QACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC;YAC1B,OAAO,sBAAsB,UAAU,IAAI,KAAK,EAAE,CAAC;QACvD,OAAO,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,QAAQ,CAAC,MAAM,KAAK,KAAK;YACzB,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,oBAAoB,UAAU,IAAI,KAAK,EAAE,CAAC;IACrD,CAAC;IAED,OAAO,oBAAoB,MAAM,uBAAuB,CAAC;AAC7D,CAAC"}

package/dist/balancer/core.d.ts

@@ -0,0 +1,6 @@
+export * from "./accounts";
+export * from "./http";
+export * from "./native";
+export * from "./state";
+export * from "./storage";
+export * from "./types";

package/dist/balancer/core.js

@@ -0,0 +1,7 @@
+export * from "./accounts";
+export * from "./http";
+export * from "./native";
+export * from "./state";
+export * from "./storage";
+export * from "./types";
+//# sourceMappingURL=core.js.map

package/dist/balancer/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/balancer/core.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}

package/dist/balancer/fetch-patch.d.ts

@@ -0,0 +1 @@
+export declare function installFetchPatch(client: any): Promise<void>;

package/dist/balancer/fetch-patch.js

@@ -0,0 +1,110 @@
+import { BALANCER_ALIAS_INPUT, applyAuthToHeaders, captureAuth, cloneRequestInput, fakeCommandResponse, headersFrom, INTERNAL_REQUEST_HEADER, isAuthInfo, isInternalUrl, markRateLimited, markUsed, maybeInjectAliasPrompt, nextAvailableAccount, normalizeAlias, now, parseAuthSetProvider, parseJsonBody, parseProviderAuthorize, parseProviderCallback, parseSessionCommand, parseUrl, readNativeAuth, readStore, RETRYABLE_STATUS, retryAfterMs, saveAccount, setNativeAuth, showToast, state, writeStore, } from "./core";
+import { runBalancerCommand } from "./commands";
+export async function installFetchPatch(client) {
+    if (state.fetchPatched)
+        return;
+    state.fetchPatched = true;
+    const originalFetch = globalThis.fetch.bind(globalThis);
+    globalThis.fetch = (async (input, init) => {
+        const url = parseUrl(input);
+        const commandSessionID = parseSessionCommand(url);
+        if (commandSessionID &&
+            (init?.method ?? "GET").toUpperCase() === "POST") {
+            const body = parseJsonBody(init);
+            if (body?.command === "balancer") {
+                const result = await runBalancerCommand(client, typeof body.arguments === "string" ? body.arguments : "");
+                await showToast(client, result.split("\n")[0] ?? result, "info");
+                return new Response(JSON.stringify(fakeCommandResponse(commandSessionID, result)), {
+                    status: 200,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+        }
+        if (isInternalUrl(url) && url?.pathname === "/provider/auth") {
+            return maybeInjectAliasPrompt(await originalFetch(input, init));
+        }
+        const authorizeProvider = parseProviderAuthorize(url);
+        if (authorizeProvider &&
+            (init?.method ?? "GET").toUpperCase() === "POST") {
+            const body = parseJsonBody(init);
+            const alias = typeof body?.inputs?.[BALANCER_ALIAS_INPUT] === "string"
+                ? normalizeAlias(body.inputs[BALANCER_ALIAS_INPUT])
+                : "";
+            if (alias)
+                state.pendingOauthAlias.set(authorizeProvider, alias);
+            if (body?.inputs && BALANCER_ALIAS_INPUT in body.inputs) {
+                delete body.inputs[BALANCER_ALIAS_INPUT];
+                init = { ...init, body: JSON.stringify(body) };
+            }
+            return originalFetch(input, init);
+        }
+        const callbackProvider = parseProviderCallback(url);
+        if (callbackProvider &&
+            (init?.method ?? "GET").toUpperCase() === "POST") {
+            const response = await originalFetch(input, init);
+            const alias = state.pendingOauthAlias.get(callbackProvider);
+            if (response.ok && alias) {
+                setTimeout(async () => {
+                    const auth = (await readNativeAuth())[callbackProvider];
+                    if (isAuthInfo(auth)) {
+                        await saveAccount(callbackProvider, alias, auth);
+                        await showToast(client, `Balancer: account ${callbackProvider}/${alias} saved.`, "success");
+                    }
+                    state.pendingOauthAlias.delete(callbackProvider);
+                }, 250);
+            }
+            return response;
+        }
+        const authSetProvider = parseAuthSetProvider(url);
+        if (authSetProvider &&
+            (init?.method ?? "GET").toUpperCase() === "PUT") {
+            const body = parseJsonBody(init);
+            const response = await originalFetch(input, init);
+            if (response.ok && isAuthInfo(body)) {
+                const suppressedUntil = state.suppressAuthCaptureUntil.get(authSetProvider) ?? 0;
+                if (suppressedUntil <= now()) {
+                    await captureAuth(authSetProvider, body, "http");
+                    await showToast(client, `Balancer: ${authSetProvider} connection detected. Use /balancer alias <name>.`, "info");
+                }
+            }
+            return response;
+        }
+        const headers = headersFrom(input, init);
+        const requestID = headers.get(INTERNAL_REQUEST_HEADER);
+        if (!requestID)
+            return originalFetch(input, init);
+        const pending = state.pendingRequests.get(requestID);
+        headers.delete(INTERNAL_REQUEST_HEADER);
+        if (!pending?.account) {
+            const [nextInput, nextInit] = cloneRequestInput(input, init, headers);
+            return originalFetch(nextInput, nextInit);
+        }
+        let account = pending.account;
+        let attempt = 0;
+        while (true) {
+            attempt++;
+            const attemptHeaders = new Headers(headers);
+            applyAuthToHeaders(attemptHeaders, account);
+            const [nextInput, nextInit] = cloneRequestInput(input, init, attemptHeaders);
+            const response = await originalFetch(nextInput, nextInit);
+            if (!RETRYABLE_STATUS.has(response.status)) {
+                await markUsed(account.providerID, account.alias);
+                return response;
+            }
+            await markRateLimited(account.providerID, account.alias, retryAfterMs(response));
+            const next = await nextAvailableAccount(account.providerID, account.alias);
+            if (!next || attempt >= 3)
+                return response;
+            account = next;
+            const store = await readStore();
+            const provider = store.providers[account.providerID];
+            if (provider) {
+                provider.active = account.alias;
+                await writeStore(store);
+            }
+            await setNativeAuth(client, account.providerID, account.auth);
+            await showToast(client, `Balancer: ${pending.providerID}/${pending.account.alias} is rate limited. Switching to ${account.alias}.`, "warning");
+        }
+    });
+}
+//# sourceMappingURL=fetch-patch.js.map