@skj1724/oh-my-opencode 3.19.6 → 3.19.8

package/dist/shared/index.d.ts

@@ -28,6 +28,7 @@ export * from "./agent-tool-restrictions";
 export * from "./model-requirements";
 export * from "./model-resolver";
 export * from "./model-availability";
+export * from "./runtime-fallback";
 export * from "./perf-timer";
 export * from "./perf-tracer";
 export * from "./case-insensitive";

package/dist/shared/provider-error-classifier.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Provider Error Classifier
+ *
+ * 统一的 provider 错误分类逻辑，用于判断错误类型和是否可重试/fallback。
+ * 支持 OpenAI、Anthropic、Gemini、xAI、Zhipu 等主流 provider。
+ */
+export type ErrorCategory = "rate_limit" | "quota" | "overloaded" | "context_overflow" | "auth" | "bad_request" | "model_unavailable" | "provider_unavailable" | "unknown";
+export interface ProviderErrorClassification {
+    category: ErrorCategory;
+    retryable: boolean;
+    shouldFallback: boolean;
+    statusCode?: number;
+    providerGuess?: string;
+    retryAfterMs?: number;
+    reason: string;
+}
+/**
+ * 分类 provider 错误
+ *
+ * @param error - 未知类型的错误对象
+ * @returns 包含错误分类、可重试性、是否应该 fallback 等信息
+ */
+export declare function classifyProviderError(error: unknown): ProviderErrorClassification;

package/dist/shared/provider-error-classifier.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/shared/retry-strategy.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Retry/backoff 策略服务
+ *
+ * 提供纯函数式的重试决策计算，支持指数退避、Retry-After 和 Jitter。
+ */
+export interface RetryConfig {
+    /** 最大重试次数 */
+    max_attempts: number;
+    /** 初始延迟（毫秒） */
+    initial_delay_ms: number;
+    /** 退避因子 */
+    backoff_factor: number;
+    /** 最大延迟（毫秒） */
+    max_delay_ms: number;
+    /** 是否启用 jitter */
+    jitter: boolean;
+    /** 是否尊重 Retry-After 头 */
+    respect_retry_after: boolean;
+}
+export interface RetryDecision {
+    /** 是否可重试 */
+    retryable: boolean;
+    /** 延迟时间（毫秒） */
+    delay_ms: number;
+    /** 当前尝试次数 */
+    attempt: number;
+    /** 决策原因 */
+    reason: string;
+}
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * 计算重试延迟
+ *
+ * @param attempt - 当前尝试次数（从 0 开始）
+ * @param config - 重试配置
+ * @param retryAfterMs - 可选的 Retry-After 值（毫秒）
+ * @returns 重试决策
+ */
+export declare function calculateRetryDelay(attempt: number, config: RetryConfig, retryAfterMs?: number): RetryDecision;

package/dist/shared/retry-strategy.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/shared/runtime-fallback.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Runtime Fallback Decision Service
+ *
+ * 纯函数：根据 agent/category 的 fallback chain，结合当前失败状态和可用模型，
+ * 决定下一个要尝试的模型。
+ */
+import type { ProviderErrorClassification } from "./provider-error-classifier";
+export interface FallbackModel {
+    providerID: string;
+    modelID: string;
+    variant?: string;
+}
+export interface FallbackAttempt {
+    model: FallbackModel;
+    error?: ProviderErrorClassification;
+}
+export interface FallbackSkip {
+    model?: FallbackModel;
+    reason: string;
+}
+export interface FallbackNextResult {
+    kind: "next";
+    model: FallbackModel;
+    attempts: FallbackAttempt[];
+    skipped?: FallbackSkip[];
+}
+export interface FallbackExhaustedResult {
+    kind: "exhausted";
+    attempts: FallbackAttempt[];
+    reason: string;
+    skipped?: FallbackSkip[];
+    lastErrorClassification?: ProviderErrorClassification;
+}
+export interface FallbackUnconfiguredResult {
+    kind: "unconfigured";
+    reason: string;
+    skipped?: FallbackSkip[];
+}
+export type FallbackResult = FallbackNextResult | FallbackExhaustedResult | FallbackUnconfiguredResult;
+export interface RuntimeFallbackInput {
+    agent?: string;
+    category?: string;
+    currentModel: FallbackModel;
+    attempts: FallbackAttempt[];
+    availableModels?: Set<string>;
+    lastErrorClassification?: ProviderErrorClassification;
+    configuredFallbackModels?: FallbackModel[];
+    maxAttempts?: number;
+}
+/**
+ * 解析下一个 fallback 模型
+ *
+ * 逻辑：
+ * 1. 从 AGENT_MODEL_REQUIREMENTS 或 CATEGORY_MODEL_REQUIREMENTS 获取 fallbackChain
+ * 2. 将 chain 展开为候选列表（每个 provider × model 组合，保持顺序）
+ * 3. 跳过 currentModel 和 attempts 中的 model
+ * 4. 如果 availableModels 非空，使用 fuzzyMatchModel 检查可用性
+ * 5. 返回第一个有效候选，或 exhausted
+ */
+export declare function resolveNextFallbackModel(input: RuntimeFallbackInput): FallbackResult;

package/dist/shared/runtime-fallback.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/delegate-task/tools.d.ts

@@ -1,6 +1,6 @@
 import { type PluginInput, type ToolDefinition } from "@opencode-ai/plugin";
 import type { BackgroundManager } from "../../features/background-agent";
-import type { CategoryConfig, CategoriesConfig, GitMasterConfig } from "../../config/schema";
+import type { CategoryConfig, CategoriesConfig, FallbackModelEntry, GitMasterConfig, RuntimeFallbackConfig } from "../../config/schema";
 type OpencodeClient = PluginInput["client"];
 export declare function resolveCategoryConfig(categoryName: string, options: {
     userCategories?: CategoriesConfig;
@@ -18,6 +18,8 @@ export interface DelegateTaskToolOptions {
     userCategories?: CategoriesConfig;
     gitMasterConfig?: GitMasterConfig;
     sisyphusJuniorModel?: string;
+    runtimeFallbackConfig?: RuntimeFallbackConfig;
+    agentFallbackModels?: Record<string, FallbackModelEntry[] | undefined>;
 }
 export interface BuildSystemContentInput {
     skillContent?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skj1724/oh-my-opencode",
-  "version": "3.19.6",
+  "version": "3.19.8",
   "description": "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",