opencode-copilot-failover 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 pl4fun
+
+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,65 @@
+# opencode-copilot-failover
+
+Automatic provider failover plugin for opencode — switches to GitHub Copilot when primary providers fail.
+
+## How it works
+
+1. Listens for `session.error` events after all built-in retries are exhausted
+2. Detects retryable errors (429, 500, 502, 503, 529, unknown errors)
+3. Maps the failed model to its GitHub Copilot equivalent
+4. Re-prompts the session via the copilot provider
+5. Shows a toast notification in the TUI
+
+## Installation
+
+Add to your `opencode.json`:
+
+```json
+{
+  "plugin": ["opencode-copilot-failover"]
+}
+```
+
+Or alongside other plugins:
+
+```json
+{
+  "plugin": ["oh-my-opencode@latest", "opencode-openai-codex-auth", "opencode-copilot-failover"]
+}
+```
+
+## Supported Models
+
+| Source Model | Copilot Model |
+| --- | --- |
+| `claude-opus-4-6` | `claude-opus-4.6` |
+| `claude-opus-4-5` | `claude-opus-4.5` |
+| `claude-sonnet-4-5` | `claude-sonnet-4.5` |
+| `claude-sonnet-4` | `claude-sonnet-4` |
+| `claude-haiku-4-5` | `claude-haiku-4.5` |
+| `gpt-5.3-codex` | `gpt-5.3-codex` |
+| `gpt-5.2-codex` | `gpt-5.2-codex` |
+| `gpt-5.2` | `gpt-5.2` |
+| `gpt-5.1-codex-max` | `gpt-5.1-codex-max` |
+| `gpt-5.1-codex` | `gpt-5.1-codex` |
+| `gpt-5.1-codex-mini` | `gpt-5.1-codex-mini` |
+| `gpt-5.1` | `gpt-5.1` |
+| `gpt-4.1` | `gpt-4.1` |
+| `gpt-5` | `gpt-5` |
+| `gpt-5-mini` | `gpt-5-mini` |
+| `gemini-2.5-pro` | `gemini-2.5-pro` |
+| `gemini-3-flash` | `gemini-3-flash` |
+| `gemini-3-pro` | `gemini-3-pro` |
+
+## Behavior
+
+- **Zero-config** — works out of the box
+- **Per-request failover** — always tries the primary provider first
+- **Prevents infinite loops** — won't failover if already on copilot
+- **Prevents duplicate failovers** — won't retry the same message twice
+
+## Limitations
+
+- GitHub Copilot must be authenticated in opencode
+- Not all models are available on copilot (unmapped models are skipped)
+- If copilot also fails, no further failover occurs

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "@opencode-ai/plugin";
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAIlD,QAAA,MAAM,MAAM,EAAE,MAUb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+import { CopilotFailoverEngine } from "./lib/failover-engine.js";
+const plugin = async (ctx) => {
+    const engine = new CopilotFailoverEngine(ctx.client);
+    return {
+        event: async ({ event }) => {
+            if (event.type === "session.error") {
+                await engine.handleSessionError(event);
+            }
+        },
+    };
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,MAAM,GAAW,KAAK,EAAE,GAAG,EAAE,EAAE;IACnC,MAAM,MAAM,GAAG,IAAI,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAErD,OAAO;QACL,KAAK,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;YACzB,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACnC,MAAM,MAAM,CAAC,kBAAkB,CAAC,KAA0B,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/lib/constants.d.ts

@@ -0,0 +1,11 @@
+/** Plugin identifier for logging and toast notifications */
+export declare const PLUGIN_NAME: "opencode-copilot-failover";
+/** The target failover provider ID */
+export declare const COPILOT_PROVIDER_ID: "github-copilot";
+/** Providers eligible for failover (any non-copilot provider) */
+export declare const FAILOVER_PROVIDERS: readonly ["anthropic", "openai"];
+/** HTTP status codes that trigger failover */
+export declare const RETRYABLE_STATUS_CODES: readonly [429, 500, 502, 503, 529];
+/** Log prefix for console messages */
+export declare const LOG_PREFIX: "[copilot-failover]";
+//# sourceMappingURL=constants.d.ts.map

package/dist/lib/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../lib/constants.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,eAAO,MAAM,WAAW,EAAG,2BAAoC,CAAC;AAEhE,sCAAsC;AACtC,eAAO,MAAM,mBAAmB,EAAG,gBAAyB,CAAC;AAE7D,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,kCAAmC,CAAC;AAEnE,8CAA8C;AAC9C,eAAO,MAAM,sBAAsB,oCAAqC,CAAC;AAEzE,sCAAsC;AACtC,eAAO,MAAM,UAAU,EAAG,oBAA6B,CAAC"}

package/dist/lib/constants.js

@@ -0,0 +1,11 @@
+/** Plugin identifier for logging and toast notifications */
+export const PLUGIN_NAME = "opencode-copilot-failover";
+/** The target failover provider ID */
+export const COPILOT_PROVIDER_ID = "github-copilot";
+/** Providers eligible for failover (any non-copilot provider) */
+export const FAILOVER_PROVIDERS = ["anthropic", "openai"];
+/** HTTP status codes that trigger failover */
+export const RETRYABLE_STATUS_CODES = [429, 500, 502, 503, 529];
+/** Log prefix for console messages */
+export const LOG_PREFIX = "[copilot-failover]";
+//# sourceMappingURL=constants.js.map

package/dist/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../lib/constants.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,CAAC,MAAM,WAAW,GAAG,2BAAoC,CAAC;AAEhE,sCAAsC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAyB,CAAC;AAE7D,iEAAiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAU,CAAC;AAEnE,8CAA8C;AAC9C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAEzE,sCAAsC;AACtC,MAAM,CAAC,MAAM,UAAU,GAAG,oBAA6B,CAAC"}

package/dist/lib/error-detector.d.ts

@@ -0,0 +1,12 @@
+import type { ApiError, EventSessionError, MessageAbortedError, MessageOutputLengthError, ProviderAuthError, UnknownError } from "@opencode-ai/sdk";
+export type FailoverTrigger = {
+    reason: string;
+    statusCode?: number;
+    provider: string;
+    model: string;
+};
+type SessionError = ProviderAuthError | UnknownError | MessageOutputLengthError | MessageAbortedError | ApiError;
+export declare function isRetryableProviderError(error: SessionError): boolean;
+export declare function extractFailoverTrigger(event: EventSessionError): FailoverTrigger | null;
+export {};
+//# sourceMappingURL=error-detector.d.ts.map

package/dist/lib/error-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-detector.d.ts","sourceRoot":"","sources":["../../lib/error-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,EACjB,YAAY,EACb,MAAM,kBAAkB,CAAC;AAI1B,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,YAAY,GACb,iBAAiB,GACjB,YAAY,GACZ,wBAAwB,GACxB,mBAAmB,GACnB,QAAQ,CAAC;AA2Bb,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAoCrE;AAYD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,iBAAiB,GACvB,eAAe,GAAG,IAAI,CAiBxB"}

package/dist/lib/error-detector.js

@@ -0,0 +1,97 @@
+import { RETRYABLE_STATUS_CODES } from "./constants.js";
+const RETRYABLE_TEXT_SIGNALS = [
+    "rate limit",
+    "too many requests",
+    "quota",
+    "usage limit",
+    "billing limit",
+    "capacity",
+    "overloaded",
+    "service unavailable",
+    "temporarily unavailable",
+    "timeout",
+    "timed out",
+    "deadline exceeded",
+];
+const USER_ABORT_TEXT_SIGNALS = [
+    "user cancelled",
+    "user canceled",
+    "cancelled by user",
+    "canceled by user",
+    "aborted by user",
+    "ctrl+c",
+    "ctrl-c",
+];
+export function isRetryableProviderError(error) {
+    switch (error.name) {
+        case "APIError": {
+            if (error.data.isRetryable)
+                return true;
+            if (error.data.statusCode === 408)
+                return true;
+            if (error.data.statusCode !== undefined &&
+                RETRYABLE_STATUS_CODES.includes(error.data.statusCode)) {
+                return true;
+            }
+            if (hasRetryableTextSignal(error.data.message, error.data.responseBody)) {
+                return true;
+            }
+            return false;
+        }
+        case "ProviderAuthError":
+            return false;
+        case "MessageAbortedError":
+            return !isLikelyUserAbort(error.data.message);
+        case "MessageOutputLengthError":
+            return false;
+        case "UnknownError":
+            return true;
+        default: {
+            const _exhaustive = error;
+            return _exhaustive;
+        }
+    }
+}
+function hasRetryableTextSignal(message, responseBody) {
+    const haystack = `${message}\n${responseBody ?? ""}`.toLowerCase();
+    return RETRYABLE_TEXT_SIGNALS.some((signal) => haystack.includes(signal));
+}
+function isLikelyUserAbort(message) {
+    const normalized = message.toLowerCase();
+    return USER_ABORT_TEXT_SIGNALS.some((signal) => normalized.includes(signal));
+}
+export function extractFailoverTrigger(event) {
+    const error = event.properties.error;
+    if (!error)
+        return null;
+    if (!isRetryableProviderError(error))
+        return null;
+    const trigger = {
+        reason: buildReason(error),
+        provider: "",
+        model: "",
+    };
+    if (error.name === "APIError" && error.data.statusCode !== undefined) {
+        trigger.statusCode = error.data.statusCode;
+    }
+    return trigger;
+}
+function buildReason(error) {
+    switch (error.name) {
+        case "APIError":
+            return error.data.statusCode
+                ? `API error ${error.data.statusCode}: ${error.data.message}`
+                : `API error: ${error.data.message}`;
+        case "UnknownError":
+            return `Unknown error: ${error.data.message}`;
+        case "ProviderAuthError":
+        case "MessageAbortedError":
+        case "MessageOutputLengthError":
+            return error.name;
+        default: {
+            const _exhaustive = error;
+            return _exhaustive;
+        }
+    }
+}
+//# sourceMappingURL=error-detector.js.map

package/dist/lib/error-detector.js.map

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

package/dist/lib/failover-engine.d.ts

@@ -0,0 +1,29 @@
+import type { EventSessionError, OpencodeClient } from "@opencode-ai/sdk";
+/**
+ * Detects provider errors, maps models to github-copilot equivalents,
+ * and re-prompts sessions via the SDK client. Must NEVER throw.
+ */
+export declare class CopilotFailoverEngine {
+    private readonly client;
+    private readonly dedup;
+    private cachedCopilotModels;
+    constructor(client: OpencodeClient);
+    /**
+     * Discover which models are available in the github-copilot provider.
+     * Result is cached for the lifetime of the engine instance.
+     */
+    private discoverCopilotModels;
+    handleSessionError(event: EventSessionError): Promise<void>;
+    private processError;
+    private emitFailoverToast;
+    private emitToast;
+    /**
+     * Convert output Part[] (session.messages response) to input PartInput[]
+     * (session.prompt request). Only TextPart and FilePart map to user-input
+     * equivalents; assistant-side parts (tool, reasoning, step, etc.) are skipped.
+     */
+    private convertPartsToInput;
+    private isDuplicate;
+    private recordDedup;
+}
+//# sourceMappingURL=failover-engine.d.ts.map

package/dist/lib/failover-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failover-engine.d.ts","sourceRoot":"","sources":["../../lib/failover-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,iBAAiB,EAOjB,cAAc,EACd,MAAM,kBAAkB,CAAC;AAe1B;;;GAGG;AACH,qBAAa,qBAAqB;IAIrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,OAAO,CAAC,mBAAmB,CAA4B;gBAE1B,MAAM,EAAE,cAAc;IAEnD;;;OAGG;YACW,qBAAqB;IAuB7B,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;YAYnD,YAAY;YAiFZ,iBAAiB;YAajB,SAAS;IAgCvB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IA4B3B,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,WAAW;CAQnB"}

package/dist/lib/failover-engine.js

@@ -0,0 +1,199 @@
+import { COPILOT_PROVIDER_ID } from "./constants.js";
+import { extractFailoverTrigger } from "./error-detector.js";
+import { resolveWithFallback } from "./model-mapper.js";
+/**
+ * Detects provider errors, maps models to github-copilot equivalents,
+ * and re-prompts sessions via the SDK client. Must NEVER throw.
+ */
+export class CopilotFailoverEngine {
+    client;
+    dedup = new Map();
+    cachedCopilotModels = null;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Discover which models are available in the github-copilot provider.
+     * Result is cached for the lifetime of the engine instance.
+     */
+    async discoverCopilotModels() {
+        if (this.cachedCopilotModels)
+            return this.cachedCopilotModels;
+        try {
+            const result = await this.client.config.providers();
+            const providers = result.data?.providers;
+            if (!providers)
+                return null;
+            const copilotProvider = providers.find((p) => p.id === COPILOT_PROVIDER_ID);
+            if (!copilotProvider?.models)
+                return null;
+            this.cachedCopilotModels = new Set(Object.keys(copilotProvider.models));
+            return this.cachedCopilotModels;
+        }
+        catch {
+            // If the providers API fails, proceed without availability filtering
+            return null;
+        }
+    }
+    async handleSessionError(event) {
+        try {
+            await this.processError(event);
+        }
+        catch (err) {
+            await this.emitToast({
+                title: "Copilot Failover Error",
+                message: err instanceof Error ? err.message : String(err),
+                variant: "error",
+            }).catch(() => { });
+        }
+    }
+    async processError(event) {
+        const error = event.properties.error;
+        if (!error)
+            return;
+        const sessionID = event.properties.sessionID;
+        if (!sessionID)
+            return;
+        const trigger = extractFailoverTrigger(event);
+        if (!trigger)
+            return;
+        const messagesResult = await this.client.session.messages({
+            path: { id: sessionID },
+        });
+        const messages = messagesResult.data;
+        if (!messages || messages.length === 0)
+            return;
+        const failedEntry = [...messages]
+            .reverse()
+            .find((m) => m.info.role === "assistant" && m.info.error);
+        if (!failedEntry)
+            return;
+        const failedAssistant = failedEntry.info;
+        const originalProvider = failedAssistant.providerID;
+        const originalModel = failedAssistant.modelID;
+        if (originalProvider === COPILOT_PROVIDER_ID) {
+            await this.emitToast({
+                title: "Copilot Failover Failed",
+                message: `${COPILOT_PROVIDER_ID}/${originalModel} also errored — no further fallback available`,
+                variant: "error",
+            });
+            return;
+        }
+        const parentID = failedAssistant.parentID;
+        if (this.isDuplicate(sessionID, parentID))
+            return;
+        const availableModels = await this.discoverCopilotModels();
+        const copilotModelID = resolveWithFallback(originalModel, availableModels);
+        if (!copilotModelID) {
+            await this.emitToast({
+                title: "Copilot Failover Unavailable",
+                message: `No copilot mapping for ${originalProvider}/${originalModel}`,
+                variant: "error",
+            });
+            return;
+        }
+        const userEntry = messages.find((m) => m.info.id === parentID);
+        if (!userEntry)
+            return;
+        const inputParts = this.convertPartsToInput(userEntry.parts);
+        if (inputParts.length === 0)
+            return;
+        const userInfo = userEntry.info;
+        await this.client.session.promptAsync({
+            path: { id: sessionID },
+            body: {
+                parts: inputParts,
+                model: {
+                    providerID: COPILOT_PROVIDER_ID,
+                    modelID: copilotModelID,
+                },
+                agent: userInfo.agent,
+                system: userInfo.system,
+                tools: userInfo.tools,
+            },
+        });
+        await this.emitFailoverToast(originalProvider, originalModel, copilotModelID, trigger.reason);
+        this.recordDedup(sessionID, parentID);
+    }
+    async emitFailoverToast(fromProvider, fromModel, toModel, reason) {
+        await this.emitToast({
+            title: "Provider switched to GitHub Copilot",
+            message: `${fromProvider}/${fromModel} → ${COPILOT_PROVIDER_ID}/${toModel} (${reason})`,
+            variant: "warning",
+        });
+    }
+    async emitToast(payload) {
+        const toastEvent = {
+            type: "tui.toast.show",
+            properties: {
+                title: payload.title,
+                message: payload.message,
+                variant: payload.variant,
+                duration: payload.duration,
+            },
+        };
+        try {
+            await this.client.tui.publish({ body: toastEvent });
+            return;
+        }
+        catch {
+            // publish unavailable, fall through to showToast
+        }
+        try {
+            await this.client.tui.showToast({
+                body: {
+                    title: payload.title,
+                    message: payload.message,
+                    variant: payload.variant,
+                    duration: payload.duration,
+                },
+            });
+        }
+        catch {
+            // both toast methods failed — nothing we can do without polluting TUI
+        }
+    }
+    /**
+     * Convert output Part[] (session.messages response) to input PartInput[]
+     * (session.prompt request). Only TextPart and FilePart map to user-input
+     * equivalents; assistant-side parts (tool, reasoning, step, etc.) are skipped.
+     */
+    convertPartsToInput(parts) {
+        const result = [];
+        for (const part of parts) {
+            switch (part.type) {
+                case "text": {
+                    result.push({
+                        type: "text",
+                        text: part.text,
+                    });
+                    break;
+                }
+                case "file": {
+                    result.push({
+                        type: "file",
+                        mime: part.mime,
+                        url: part.url,
+                        ...(part.filename ? { filename: part.filename } : {}),
+                        ...(part.source ? { source: part.source } : {}),
+                    });
+                    break;
+                }
+            }
+        }
+        return result;
+    }
+    isDuplicate(sessionID, parentID) {
+        const sessionSet = this.dedup.get(sessionID);
+        return sessionSet !== undefined && sessionSet.has(parentID);
+    }
+    recordDedup(sessionID, parentID) {
+        let sessionSet = this.dedup.get(sessionID);
+        if (!sessionSet) {
+            sessionSet = new Set();
+            this.dedup.set(sessionID, sessionSet);
+        }
+        sessionSet.add(parentID);
+    }
+}
+//# sourceMappingURL=failover-engine.js.map

package/dist/lib/failover-engine.js.map

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

package/dist/lib/model-mapper.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Model Mapper — maps source provider model IDs to github-copilot model IDs
+ * and provides a ranked fallback chain when the exact model isn't available.
+ *
+ * GitHub Copilot uses DOTS in version numbers where Anthropic uses DASHES.
+ * e.g. anthropic: "claude-opus-4-6" -> copilot: "claude-opus-4.6"
+ *
+ * Verified against `opencode models github-copilot` output (2026-02-10).
+ */
+/**
+ * Maps source provider model IDs to their github-copilot equivalents.
+ *
+ * Key:   model ID as used by the source provider (anthropic, openai, google, etc.)
+ * Value: model ID as accepted by the github-copilot API
+ */
+export declare const COPILOT_MODEL_MAP: Record<string, string>;
+/**
+ * Fallback chain — ordered list of model IDs to try when the original
+ * model isn't available in copilot. Walked top-to-bottom, first match wins.
+ *
+ * Order per user spec:
+ *   1. claude-opus (latest)
+ *   2. openai codex (latest)
+ *   3. claude-sonnet (latest)
+ *   4. kimi-2.5
+ *   5. any remaining
+ */
+export declare const FALLBACK_CHAIN: readonly string[];
+export declare function parseModelString(fullModelID: string): {
+    providerID: string;
+    modelID: string;
+};
+/**
+ * Map a source-provider model ID to its github-copilot equivalent.
+ * Returns `null` if no direct mapping exists (use `resolveWithFallback` for chain).
+ */
+export declare function mapModelToCopilot(modelID: string): string | null;
+/**
+ * Resolve a model to a copilot equivalent, falling back through the
+ * ranked chain if no direct mapping exists.
+ *
+ * @param modelID - The original model ID (bare or fully-qualified)
+ * @param availableModels - Set of model IDs currently available in copilot.
+ *   If provided, both direct mapping and fallback are validated against it.
+ *   If null/undefined, the hardcoded map and chain are trusted as-is.
+ */
+export declare function resolveWithFallback(modelID: string, availableModels?: ReadonlySet<string> | null): string | null;
+export declare function isModelCopilotAvailable(modelID: string): boolean;
+//# sourceMappingURL=model-mapper.d.ts.map

package/dist/lib/model-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-mapper.d.ts","sourceRoot":"","sources":["../../lib/model-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoCpD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAa3C,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CAChB,CASA;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAehE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,MAAM,EACf,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GAC1C,MAAM,GAAG,IAAI,CAuBf;AAUD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEhE"}

package/dist/lib/model-mapper.js

@@ -0,0 +1,140 @@
+/**
+ * Model Mapper — maps source provider model IDs to github-copilot model IDs
+ * and provides a ranked fallback chain when the exact model isn't available.
+ *
+ * GitHub Copilot uses DOTS in version numbers where Anthropic uses DASHES.
+ * e.g. anthropic: "claude-opus-4-6" -> copilot: "claude-opus-4.6"
+ *
+ * Verified against `opencode models github-copilot` output (2026-02-10).
+ */
+/**
+ * Maps source provider model IDs to their github-copilot equivalents.
+ *
+ * Key:   model ID as used by the source provider (anthropic, openai, google, etc.)
+ * Value: model ID as accepted by the github-copilot API
+ */
+export const COPILOT_MODEL_MAP = {
+    // Anthropic
+    "claude-opus-4-6": "claude-opus-4.6",
+    "claude-opus-4.6": "claude-opus-4.6",
+    "claude-opus-4-5": "claude-opus-4.5",
+    "claude-opus-4.5": "claude-opus-4.5",
+    "claude-opus-4-1": "claude-opus-41",
+    "claude-opus-4.1": "claude-opus-41",
+    "claude-opus-41": "claude-opus-41",
+    "claude-sonnet-4-5": "claude-sonnet-4.5",
+    "claude-sonnet-4.5": "claude-sonnet-4.5",
+    "claude-sonnet-4": "claude-sonnet-4",
+    "claude-haiku-4-5": "claude-haiku-4.5",
+    "claude-haiku-4.5": "claude-haiku-4.5",
+    // OpenAI
+    "gpt-5.2-codex": "gpt-5.2-codex",
+    "gpt-5.2": "gpt-5.2",
+    "gpt-5.1-codex-max": "gpt-5.1-codex-max",
+    "gpt-5.1-codex": "gpt-5.1-codex",
+    "gpt-5.1-codex-mini": "gpt-5.1-codex-mini",
+    "gpt-5.1": "gpt-5.1",
+    "gpt-5": "gpt-5",
+    "gpt-5-mini": "gpt-5-mini",
+    "gpt-4.1": "gpt-4.1",
+    "gpt-4o": "gpt-4o",
+    // Google
+    "gemini-2.5-pro": "gemini-2.5-pro",
+    "gemini-3-flash": "gemini-3-flash-preview",
+    "gemini-3-flash-preview": "gemini-3-flash-preview",
+    "gemini-3-pro": "gemini-3-pro-preview",
+    "gemini-3-pro-preview": "gemini-3-pro-preview",
+    // xAI
+    "grok-code-fast-1": "grok-code-fast-1",
+};
+/**
+ * Fallback chain — ordered list of model IDs to try when the original
+ * model isn't available in copilot. Walked top-to-bottom, first match wins.
+ *
+ * Order per user spec:
+ *   1. claude-opus (latest)
+ *   2. openai codex (latest)
+ *   3. claude-sonnet (latest)
+ *   4. kimi-2.5
+ *   5. any remaining
+ */
+export const FALLBACK_CHAIN = [
+    "claude-opus-4.6",
+    "claude-opus-4.5",
+    "gpt-5.3-codex",
+    "gpt-5.2-codex",
+    "claude-sonnet-4.5",
+    "kimi-2.5",
+    "gpt-5.2",
+    "gpt-5-mini",
+    "gemini-3-pro-preview",
+    "gemini-3-flash-preview",
+    "grok-code-fast-1",
+    "claude-haiku-4.5",
+];
+export function parseModelString(fullModelID) {
+    const slashIndex = fullModelID.indexOf("/");
+    if (slashIndex === -1) {
+        return { providerID: "", modelID: fullModelID };
+    }
+    return {
+        providerID: fullModelID.slice(0, slashIndex),
+        modelID: fullModelID.slice(slashIndex + 1),
+    };
+}
+/**
+ * Map a source-provider model ID to its github-copilot equivalent.
+ * Returns `null` if no direct mapping exists (use `resolveWithFallback` for chain).
+ */
+export function mapModelToCopilot(modelID) {
+    const { modelID: bare } = parseModelString(modelID);
+    if (COPILOT_MODEL_MAP[bare] !== undefined) {
+        return COPILOT_MODEL_MAP[bare];
+    }
+    const lower = bare.toLowerCase();
+    for (const key of Object.keys(COPILOT_MODEL_MAP)) {
+        if (key.toLowerCase() === lower) {
+            return COPILOT_MODEL_MAP[key];
+        }
+    }
+    return null;
+}
+/**
+ * Resolve a model to a copilot equivalent, falling back through the
+ * ranked chain if no direct mapping exists.
+ *
+ * @param modelID - The original model ID (bare or fully-qualified)
+ * @param availableModels - Set of model IDs currently available in copilot.
+ *   If provided, both direct mapping and fallback are validated against it.
+ *   If null/undefined, the hardcoded map and chain are trusted as-is.
+ */
+export function resolveWithFallback(modelID, availableModels) {
+    const { modelID: bare } = parseModelString(modelID);
+    // 1. Try the original model ID as-is against copilot's available models
+    if (isAvailable(bare, availableModels)) {
+        return bare;
+    }
+    // 2. Try the mapped name (e.g. claude-opus-4-6 -> claude-opus-4.6)
+    const mappedMatch = mapModelToCopilot(modelID);
+    if (mappedMatch && mappedMatch !== bare && isAvailable(mappedMatch, availableModels)) {
+        return mappedMatch;
+    }
+    // 3. Walk the fallback chain
+    for (const candidate of FALLBACK_CHAIN) {
+        if (candidate === bare || candidate === mappedMatch)
+            continue;
+        if (isAvailable(candidate, availableModels)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+function isAvailable(modelID, availableModels) {
+    if (!availableModels)
+        return true;
+    return availableModels.has(modelID);
+}
+export function isModelCopilotAvailable(modelID) {
+    return mapModelToCopilot(modelID) !== null;
+}
+//# sourceMappingURL=model-mapper.js.map

package/dist/lib/model-mapper.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "opencode-copilot-failover",
+  "version": "0.1.0",
+  "description": "Auto-failover from anthropic/openai providers to github-copilot when primary providers return retryable errors",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "license": "MIT",
+  "author": "pl4fun",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pl4fun/opencode-copilot-failover.git"
+  },
+  "homepage": "https://github.com/pl4fun/opencode-copilot-failover#readme",
+  "bugs": {
+    "url": "https://github.com/pl4fun/opencode-copilot-failover/issues"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "copilot",
+    "failover",
+    "github-copilot",
+    "provider",
+    "auto-switch"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build && npm run test",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": "^1.1.19"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.1.19",
+    "@opencode-ai/sdk": "^1.1.19",
+    "@types/node": "^22",
+    "typescript": "^5.8",
+    "vitest": "latest"
+  }
+}