oc-codex-multi-auth 6.8.2 → 6.9.0

package/README.md

@@ -180,6 +180,7 @@ If browser launch is blocked, use the alternate login paths in [docs/getting-sta
 | `codex-limits` | What quota or rate-limit state is visible now? |
 | `codex-reset` | Do I have a banked rate-limit reset credit, and how do I redeem it? |
 | `codex-dashboard` | Can I manage accounts from one interactive surface? |
+| `codex-pool` | Which accounts are preferred for each model, and how do I change them? |
 
 Most of these also run as a **direct CLI** with no agent/model involvement (no token cost) — e.g. `oc-codex-multi-auth warm`, `oc-codex-multi-auth status`, or `npx -y oc-codex-multi-auth@latest warm`. Use `oc-codex-multi-auth warm` to open every enabled account's usage window at the start of a session and stagger the rolling quota cooldowns. Add `--json` for scriptable output.
 
@@ -244,6 +245,58 @@ Primary config files:
 - `~/.config/opencode/tui.json`
 - `~/.opencode/openai-codex-auth-config.json`
 
+### Route models to preferred accounts
+
+Use `modelAccountPools` to assign one or more preferred ChatGPT accounts to a
+model. Account references use stable account IDs, so adding, removing, or
+reordering accounts does not silently change a model's routing.
+
+```json
+{
+  "modelAccountPools": {
+    "gpt-5.6-sol": [
+      "org-example-account-id",
+      "00000000-0000-0000-0000-000000000000"
+    ],
+    "gpt-5.6-terra": [
+      "org-another-account-id"
+    ]
+  }
+}
+```
+
+Save this configuration in `~/.opencode/openai-codex-auth-config.json`, then
+restart OpenCode. Model matching is case-insensitive and uses the effective
+model after request model normalization.
+
+Use `codex-pool` to manage these mappings with ordinary 1-based account
+numbers. The tool resolves those numbers and writes stable IDs to disk:
+
+```text
+codex-pool
+codex-pool action="set" model="gpt-5.6-sol" accounts=[7,8]
+codex-pool action="add" model="gpt-5.6-sol" accounts=[9]
+codex-pool action="remove" model="gpt-5.6-sol" accounts=[7]
+codex-pool action="clear" model="gpt-5.6-sol"
+```
+
+Add `dryRun=true` to preview a mutation. Use `format="json"` for structured
+output; stable IDs remain redacted unless `includeSensitive=true` is also set.
+Restart OpenCode after an applied mutation. The plugin configuration is global
+while account storage is per-project by default, so a reference unresolved in
+the current project is reported but never automatically deleted.
+
+Routing behavior:
+
+- A mapped model uses only healthy, selectable accounts in its preferred pool.
+- Existing rotation strategy, quota, cooldown, and token-health rules still apply within the preferred pool.
+- If every preferred account is unavailable, disabled, unknown, cooling down, or rate-limited, routing automatically falls back to the healthy general account pool.
+- An unmapped model or an empty account list uses the general account pool directly.
+- `codex-status`, `codex-dashboard`, and routing diagnostics report the account-pool mode as `preferred`, `general`, or `general-fallback`.
+
+Account IDs are local account metadata but should still be treated as private
+configuration. Do not publish a populated configuration file.
+
 Selected runtime/environment overrides:
 
 | Variable | Effect |

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,qBAAqB,CAAC;AA4M/D;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,iBAAiB,EAAE,MA4sH/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAoB,CAAC;AAElD,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,qBAAqB,CAAC;AA6M/D;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,iBAAiB,EAAE,MAgvH/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAoB,CAAC;AAElD,eAAe,iBAAiB,CAAC"}

package/dist/index.js

@@ -32,7 +32,7 @@ import { queuedRefresh } from "./lib/refresh-queue.js";
 import { openBrowserUrl } from "./lib/auth/browser.js";
 import { startLocalOAuthServer } from "./lib/auth/server.js";
 import { promptAddAnotherAccount, promptLoginMode } from "./lib/cli.js";
-import { getCodexMode, getRequestTransformMode, getFastSession, getFastSessionStrategy, getFastSessionMaxInputItems, getRetryProfile, getRetryBudgetOverrides, getRateLimitToastDebounceMs, getRetryAllAccountsMaxRetries, getRetryAllAccountsMaxWaitMs, getRetryAllAccountsRateLimited, getFallbackToGpt52OnUnsupportedGpt53, getUnsupportedCodexPolicy, getUnsupportedCodexFallbackChain, getTokenRefreshSkewMs, getSessionRecovery, getAutoResume, getAutoUpdate, getToastDurationMs, getPerProjectAccounts, getEmptyResponseMaxRetries, getEmptyResponseRetryDelayMs, getPidOffsetEnabled, getRotationStrategy, getFetchTimeoutMs, getStreamStallTimeoutMs, getCodexTuiV2, getCodexTuiColorProfile, getCodexTuiGlyphMode, getBeginnerSafeMode, getCodexTuiMaskEmail, loadPluginConfig, } from "./lib/config.js";
+import { getCodexMode, getRequestTransformMode, getFastSession, getFastSessionStrategy, getFastSessionMaxInputItems, getRetryProfile, getRetryBudgetOverrides, getRateLimitToastDebounceMs, getRetryAllAccountsMaxRetries, getRetryAllAccountsMaxWaitMs, getRetryAllAccountsRateLimited, getFallbackToGpt52OnUnsupportedGpt53, getUnsupportedCodexPolicy, getUnsupportedCodexFallbackChain, getTokenRefreshSkewMs, getSessionRecovery, getAutoResume, getAutoUpdate, getToastDurationMs, getPerProjectAccounts, getEmptyResponseMaxRetries, getEmptyResponseRetryDelayMs, getPidOffsetEnabled, getRotationStrategy, getModelAccountPool, getFetchTimeoutMs, getStreamStallTimeoutMs, getCodexTuiV2, getCodexTuiColorProfile, getCodexTuiGlyphMode, getBeginnerSafeMode, getCodexTuiMaskEmail, loadPluginConfig, } from "./lib/config.js";
 import { AUTH_LABELS, CODEX_BASE_URL, DUMMY_API_KEY, LOG_STAGES, PLUGIN_NAME, PROVIDER_ID, ACCOUNT_LIMITS, } from "./lib/constants.js";
 import { initLogger, logRequest, logDebug, logInfo, logWarn, logError, setCorrelationId, clearCorrelationId, } from "./lib/logger.js";
 import { checkAndNotify } from "./lib/auto-update-checker.js";
@@ -132,6 +132,8 @@ export const OpenAIOAuthPlugin = async ({ client }) => {
             fallbackFrom: snapshot?.fallbackFrom ?? null,
             fallbackTo: snapshot?.fallbackTo ?? null,
             fallbackReason: snapshot?.fallbackReason ?? null,
+            accountPoolMode: snapshot?.accountPoolMode ?? null,
+            configuredAccountPoolSize: snapshot?.configuredAccountPoolSize ?? 0,
             selectionExplainability: serializeSelectionExplainability(options.selectionExplainability ?? snapshot?.explainability ?? []),
         };
     };
@@ -160,6 +162,8 @@ export const OpenAIOAuthPlugin = async ({ client }) => {
         lines.push(`  Fallback from: ${formatRoutingValue(routing.fallbackFrom)}`);
         lines.push(`  Fallback to: ${formatRoutingValue(routing.fallbackTo)}`);
         lines.push(`  Fallback reason: ${formatRoutingValue(routing.fallbackReason)}`);
+        lines.push(`  Account pool: ${formatRoutingValue(routing.accountPoolMode)}`);
+        lines.push(`  Configured pool size: ${routing.configuredAccountPoolSize}`);
         if (options.includeExplainability) {
             lines.push("  Selection explainability:");
             if (routing.selectionExplainability.length === 0) {
@@ -186,6 +190,8 @@ export const OpenAIOAuthPlugin = async ({ client }) => {
         lines.push(formatUiKeyValue(ui, "Fallback from", formatRoutingValue(routing.fallbackFrom), "muted"));
         lines.push(formatUiKeyValue(ui, "Fallback to", formatRoutingValue(routing.fallbackTo), "muted"));
         lines.push(formatUiKeyValue(ui, "Fallback reason", formatRoutingValue(routing.fallbackReason), routing.fallbackReason ? "warning" : "muted"));
+        lines.push(formatUiKeyValue(ui, "Account pool", formatRoutingValue(routing.accountPoolMode), routing.accountPoolMode === "general-fallback" ? "warning" : "muted"));
+        lines.push(formatUiKeyValue(ui, "Configured pool size", String(routing.configuredAccountPoolSize), "muted"));
         if (options.includeExplainability) {
             lines.push("");
             lines.push(...formatUiSection(ui, "Selection explainability"));
@@ -1355,6 +1361,7 @@ export const OpenAIOAuthPlugin = async ({ client }) => {
                                     const attempted = new Set();
                                     let restartAccountTraversalWithFallback = false;
                                     let restartAccountTraversalAfterWorkspaceDeactivation = false;
+                                    const preferredAccountIds = getModelAccountPool(pluginConfig, model);
                                     while (attempted.size < Math.max(1, accountCount)) {
                                         const selectionExplainability = accountManager.getSelectionExplainability(modelFamily, model, Date.now());
                                         runtimeMetrics.lastSelectionSnapshot = {
@@ -1370,8 +1377,9 @@ export const OpenAIOAuthPlugin = async ({ client }) => {
                                             fallbackFrom,
                                             fallbackTo,
                                             fallbackReason,
+                                            configuredAccountPoolSize: preferredAccountIds.length,
                                         };
-                                        const account = accountManager.getAccountForStrategy(rotationStrategy, modelFamily, model, { pidOffsetEnabled });
+                                        const account = accountManager.getAccountForStrategy(rotationStrategy, modelFamily, model, { pidOffsetEnabled }, preferredAccountIds);
                                         if (!account || attempted.has(account.index)) {
                                             break;
                                         }
@@ -1389,6 +1397,13 @@ export const OpenAIOAuthPlugin = async ({ client }) => {
                                                 fallbackFrom,
                                                 fallbackTo,
                                                 fallbackReason,
+                                                accountPoolMode: preferredAccountIds.length === 0
+                                                    ? "general"
+                                                    : account.accountId !== undefined &&
+                                                        preferredAccountIds.includes(account.accountId)
+                                                        ? "preferred"
+                                                        : "general-fallback",
+                                                configuredAccountPoolSize: preferredAccountIds.length,
                                             };
                                         }
                                         // Log account selection for debugging rotation