@khalilgharbaoui/opencode-claude-code-plugin 0.54.2 → 0.55.0

package/dist/index.d.ts

@@ -490,12 +490,13 @@ interface LoggingConfig {
 }
 type WebSearchRouting = "claude" | "disabled" | (string & {});
 /**
- * What happens when the account a conversation runs on is out of usage.
- * `"ask"` (default) shows the operator a form listing the other configured
- * accounts and applies the pick inside the same turn; `"off"` keeps today's
- * behaviour, where the turn ends with the rate-limit error.
+ * What happens when the account a conversation is running on is out of usage
+ * or cannot serve. `"off"` (the default, also what unset means) ends the turn
+ * on one `▌ **usage limit:**` note; `"ask"` ends it on a form listing the
+ * other configured accounts and continues on the pick; `"auto"` moves the same
+ * request to the next eligible configured account without asking.
  */
-type AccountFailoverMode = "ask" | "off";
+type AccountFailoverMode = "ask" | "off" | "auto";
 /** `subagentDispatch`. Unset behaves as `"off"`; see the option's own note. */
 type SubagentDispatchMode = "ask" | "off";
 interface ClaudeCodeProviderSettings {
@@ -539,11 +540,13 @@ interface ClaudeCodeProviderSettings {
      */
     accountInProcess?: boolean;
     /**
-     * When this account is out of usage, show the operator a form listing the
-     * other configured accounts and continue the task on the pick, inside the
-     * same opencode turn. `"ask"` by default, which only does anything when
-     * more than one account is configured. `"off"` keeps the plain rate-limit
-     * error. See README "Account failover".
+     * What a usage limit or an account that cannot serve does to the turn.
+     * Unset or `"off"` (the default) ends it on one `▌ **usage limit:**` note.
+     * `"ask"` shows a form listing the other configured accounts and continues
+     * on the pick. `"auto"` continues the same request on the next eligible
+     * configured account, in configured order, without asking. Both only do
+     * anything when more than one account is configured. See
+     * docs/configuration/accounts.md.
      */
     accountFailover?: AccountFailoverMode;
     /**
@@ -1489,6 +1492,31 @@ declare class ClaudeCodeLanguageModel implements LanguageModelV3 {
      * because which method opencode used is not in them.
      */
     private streamTurn;
+    /**
+     * Run the turn, moving the same request to the next eligible configured
+     * account when the one it ran on is out of usage or cannot serve
+     * (`accountFailover: "auto"`). The single wiring point for the automatic
+     * switch, and outside `runModelChain` on purpose: an account switch starts
+     * that account's own model chain from the top.
+     *
+     * Anything but `"auto"` is `runModelChain` and one `await`, so `"off"` and
+     * `"ask"` are exactly what they were. With `"auto"`, the attempt that failed
+     * decides the switch itself (`completeResult` sets `run.switchTo` and closes
+     * its stream without a `finish`), and the next attempt's prologue makes the
+     * switch the form's pick would have made. This only splices the attempts
+     * into one caller turn: one `stream-start`, and the `finish` of whichever
+     * attempt did not switch.
+     *
+     * The bound is `run.tried`, as it is `tried` for the model chain: every
+     * account spawned or switched to goes in, and none in it is picked again.
+     *
+     * Cancelling the returned stream is a stop, for every attempt: this loop is
+     * the plugin starting more work on the caller's behalf, so a caller that
+     * has gone away must reach all of it. Each attempt gets a signal that the
+     * caller's own `abortSignal` and a `cancel()` both abort, and the loop
+     * starts no further account once either has happened.
+     */
+    private runAccountFailover;
     /**
      * Run the turn, moving to the next model in the fallback chain if the one
      * it started on is refused. The single wiring point for `src/model-fallback.ts`.