dsh-client-auto-continue 0.8.1 → 0.9.0

package/lib/index.js

@@ -112,6 +112,7 @@ var DEFAULT_CONFIG = {
   freshMs: 15 * 60 * 1e3,
   verbose: true,
   classify: true,
+  retryableErrorPatterns: "",
   backoffFactor: 2,
   backoffMaxMs: 3e5,
   notify: false,
@@ -150,6 +151,7 @@ function resolveConfig(section) {
     freshMs: numberOr(value.freshMs, DEFAULT_CONFIG.freshMs),
     verbose: booleanOr(value.verbose, DEFAULT_CONFIG.verbose),
     classify: booleanOr(value.classify, DEFAULT_CONFIG.classify),
+    retryableErrorPatterns: typeof value.retryableErrorPatterns === "string" ? value.retryableErrorPatterns.trim() : DEFAULT_CONFIG.retryableErrorPatterns,
     backoffFactor: Math.max(1, numberOr(value.backoffFactor, DEFAULT_CONFIG.backoffFactor)),
     backoffMaxMs: numberOr(value.backoffMaxMs, DEFAULT_CONFIG.backoffMaxMs),
     notify: booleanOr(value.notify, DEFAULT_CONFIG.notify),
@@ -166,8 +168,10 @@ function resolveConfig(section) {
 function isNonHumanReason(kind) {
   return kind === "error" || kind === "interrupted" || kind === "max-tokens";
 }
-function isTransientFailure(failure) {
-  const haystack = `${failure.code} ${failure.message}`.toLowerCase();
+function isTransientFailure(failure, retryableErrorPatterns = "") {
+  const haystack = `${failure.code} ${failure.status ?? ""} ${failure.message}`.toLowerCase();
+  const explicitlyRetryable = retryableErrorPatterns.split(/\r?\n/).map((pattern) => pattern.trim().toLowerCase()).filter((pattern) => pattern !== "").some((pattern) => haystack.includes(pattern));
+  if (explicitlyRetryable) return true;
   const status = failure.status;
   if (status !== void 0 && (status === 401 || status === 403)) return false;
   const permanent = /auth|unauthor|forbidden|credential|api[_-]?key|permission/i.test(haystack) || /insufficient.*(balance|quota)|billing|payment|quota.*exceeded.*(?!retry)/i.test(haystack) || /model.*not[_-]?found|unknown[_-]?model|model[_-]?not[_-]?found|not.*support.*model/i.test(haystack) || /context.*(length|limit|overflow|exceed)|token.*limit|max.*context/i.test(haystack) || /invalid[_-]?request|bad[_-]?request/i.test(haystack);
@@ -564,7 +568,7 @@ ${event.data.arguments}`;
   // ---------- host 帧 ----------
   onTurnFailure(sessionId, reason, failure) {
     const config = this.getConfig();
-    if (config.classify && !isTransientFailure(failure)) {
+    if (config.classify && !isTransientFailure(failure, config.retryableErrorPatterns)) {
       const summary = `${failure.code}${failure.status !== void 0 ? ` (HTTP ${failure.status})` : ""}`;
       this.log(`跳过 ${sessionId}(${reason}): 永久性失败 ${summary} — ${failure.message}`);
       this.bumpStat({ skipped: 1, code: failure.code });
@@ -913,6 +917,8 @@ var AutoContinueSchema = z2.object({
   verbose: z2.boolean().default(true),
   /** Classify failures: auto-continue transient errors only; permanent ones are skipped and notified. */
   classify: z2.boolean().default(true),
+  /** Provider-specific message/code/status fragments that explicitly count as retryable, one literal per line. */
+  retryableErrorPatterns: z2.string().default(""),
   /** Cooldown multiplier per consecutive failure (adaptive backoff). */
   backoffFactor: z2.natural().min(1).default(2),
   /** Cap on the effective backoff interval (ms). */

package/lib/types/client/dsh-store-compat.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Snapshot-store bridge across the two public DSH client module layouts.
+ *
+ * DSH 0.1.2 moved the store engine from the dynamic
+ * `@deepseek-ai/dsh-client-runtime/client` row into the shell-seeded
+ * `@deepseek-ai/dsh-client-store` platform module. Keep the probe dynamic so
+ * esbuild does not turn both candidates into eager top-level requires: the
+ * loader must only resolve the module that exists in the running DSH cohort.
+ */
+/** Writable observable snapshot used by the settings card. */
+export interface SnapshotStore<T> {
+    getSnapshot(): T;
+    subscribe(listener: () => void): () => void;
+    update(mutator: (draft: T) => void): void;
+    set(next: T): void;
+}
+/** Settings state consumed by the staged form. */
+export interface SettingsScopeSnapshot<T> {
+    status: 'loading' | 'ready' | 'unavailable';
+    value: T | undefined;
+    base: unknown;
+    user: unknown;
+    revision: number | undefined;
+    writable: boolean;
+    mode: 'host' | 'memory';
+}
+/** Stable subset shared by the legacy and DSH 0.1.2 settings scopes. */
+export interface SettingsScope<T> {
+    getSnapshot(): SettingsScopeSnapshot<T>;
+    subscribe(listener: () => void): () => void;
+    set(field: string, value: unknown): Promise<void>;
+    unset(field: string): Promise<void>;
+}
+export declare const createSnapshotStore: <T>(init: T, options?: {
+    flush?: "raf" | "sync";
+    persist?: {
+        name: string;
+    };
+}) => SnapshotStore<T>;

package/lib/types/client/index.d.ts

@@ -9,7 +9,7 @@
  *   action endpoint,
  * - feeds the card's stats / paused-sessions panels from the bridge state.
  */
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
 import { type SettingsCardKey } from './locales.ts';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface LocaleNamespaceMap {

package/lib/types/client/locales.d.ts

@@ -35,6 +35,8 @@ export declare const zh: {
     'field.verboseHint': string;
     'field.classify': string;
     'field.classifyHint': string;
+    'field.retryableErrorPatterns': string;
+    'field.retryableErrorPatternsHint': string;
     'field.backoffFactor': string;
     'field.backoffFactorHint': string;
     'field.backoffMaxMs': string;

package/lib/types/client/settings-card.d.ts

@@ -1,6 +1,6 @@
-import { type SettingsScope, type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import { type AutoContinueSettings } from './engine.ts';
+import { type SettingsScope, type SnapshotStore } from './dsh-store-compat.ts';
 import { type CardActions, type CardFieldState, type CardShell } from './settings-form.ts';
 /** What the auto-continue card renders. */
 export interface AutoContinueSettingsCardState extends CardShell {
@@ -18,6 +18,7 @@ export interface AutoContinueSettingsCardState extends CardShell {
     freshMs: CardFieldState;
     verbose: CardFieldState;
     classify: CardFieldState;
+    retryableErrorPatterns: CardFieldState;
     backoffFactor: CardFieldState;
     backoffMaxMs: CardFieldState;
     notify: CardFieldState;

package/lib/types/client/settings-form.d.ts

@@ -10,7 +10,7 @@
  * default — and whether the user layer carries it (presence, not value
  * equality, marks an override).
  */
-import type { SettingsScope, SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SettingsScope, SnapshotStore } from './dsh-store-compat.ts';
 /** The write one field's staged text performs when the card is saved. */
 export type FieldWrite = {
     kind: 'set';

package/lib/types/index.d.ts

@@ -41,6 +41,8 @@ export declare const AutoContinueSchema: z<Schemastery.ObjectS<{
     verbose: z<boolean, boolean>;
     /** Classify failures: auto-continue transient errors only; permanent ones are skipped and notified. */
     classify: z<boolean, boolean>;
+    /** Provider-specific message/code/status fragments that explicitly count as retryable, one literal per line. */
+    retryableErrorPatterns: z<string, string>;
     /** Cooldown multiplier per consecutive failure (adaptive backoff). */
     backoffFactor: z<number, number>;
     /** Cap on the effective backoff interval (ms). */
@@ -90,6 +92,8 @@ export declare const AutoContinueSchema: z<Schemastery.ObjectS<{
     verbose: z<boolean, boolean>;
     /** Classify failures: auto-continue transient errors only; permanent ones are skipped and notified. */
     classify: z<boolean, boolean>;
+    /** Provider-specific message/code/status fragments that explicitly count as retryable, one literal per line. */
+    retryableErrorPatterns: z<string, string>;
     /** Cooldown multiplier per consecutive failure (adaptive backoff). */
     backoffFactor: z<number, number>;
     /** Cap on the effective backoff interval (ms). */

package/lib/types/shared/core.d.ts

@@ -33,6 +33,8 @@ export interface AutoContinueSettings {
     verbose?: boolean;
     /** Classify failures: auto-continue transient errors only; permanent ones (auth/balance/model) are skipped and notified. */
     classify?: boolean;
+    /** Provider-specific message/code/status fragments that explicitly count as retryable, one literal per line. */
+    retryableErrorPatterns?: string;
     /** Cooldown multiplier per consecutive failure (adaptive backoff). */
     backoffFactor?: number;
     /** Cap on the effective backoff interval (ms). */
@@ -81,10 +83,11 @@ export interface FailureFacts {
 }
 /**
  * 错误分类: 该失败是否值得自动继续。
+ * 用户填写的 provider 专属文本片段优先覆盖内置结果; 未命中时,
  * 永久性失败(认证/余额/模型不存在/上下文超限等)重试也不会成功, 应跳过并通知用户;
  * 其余(网络、超时、5xx、429 等)视为临时性失败, 允许自动恢复。
  */
-export declare function isTransientFailure(failure: FailureFacts): boolean;
+export declare function isTransientFailure(failure: FailureFacts, retryableErrorPatterns?: string): boolean;
 /**
  * host/agent-error 消息分类: 仅明确属于网络/传输类的临时错误才自动继续。
  * 其余(序列化失败、配置/宿主内部错误等)视为永久性——重试无益, 且用户停止导致的

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-client-auto-continue",
   "description": "DSH Web UI plugin: automatically sends \"继续\" (continue) when a request is interrupted by network errors or other non-human causes",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -36,7 +36,6 @@
       "platform": "web",
       "inject": [
         "@deepseek-ai/dsh-client-connection",
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-ui-settings",
         "@deepseek-ai/dsh-client-ui-settings-plugins"
@@ -47,7 +46,7 @@
     "build": "node build.mjs && tsc -p tsconfig.build.json",
     "watch": "node build.mjs --watch",
     "typecheck": "tsc --noEmit",
-    "test": "node tests/simulate-host.mjs",
+    "test": "node tests/simulate-host.mjs && node tests/simulate-client-loader.mjs",
     "prepack": "npm run build"
   },
   "keywords": [
@@ -70,7 +69,6 @@
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.7",
     "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.7",
     "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.7",
     "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.0-rc.7",
     "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.7",

package/src/client/dsh-store-compat.ts

@@ -0,0 +1,57 @@
+/**
+ * Snapshot-store bridge across the two public DSH client module layouts.
+ *
+ * DSH 0.1.2 moved the store engine from the dynamic
+ * `@deepseek-ai/dsh-client-runtime/client` row into the shell-seeded
+ * `@deepseek-ai/dsh-client-store` platform module. Keep the probe dynamic so
+ * esbuild does not turn both candidates into eager top-level requires: the
+ * loader must only resolve the module that exists in the running DSH cohort.
+ */
+
+/** Writable observable snapshot used by the settings card. */
+export interface SnapshotStore<T> {
+  getSnapshot(): T;
+  subscribe(listener: () => void): () => void;
+  update(mutator: (draft: T) => void): void;
+  set(next: T): void;
+}
+
+/** Settings state consumed by the staged form. */
+export interface SettingsScopeSnapshot<T> {
+  status: 'loading' | 'ready' | 'unavailable';
+  value: T | undefined;
+  base: unknown;
+  user: unknown;
+  revision: number | undefined;
+  writable: boolean;
+  mode: 'host' | 'memory';
+}
+
+/** Stable subset shared by the legacy and DSH 0.1.2 settings scopes. */
+export interface SettingsScope<T> {
+  getSnapshot(): SettingsScopeSnapshot<T>;
+  subscribe(listener: () => void): () => void;
+  set(field: string, value: unknown): Promise<void>;
+  unset(field: string): Promise<void>;
+}
+
+interface SnapshotStoreModule {
+  createSnapshotStore<T>(
+    init: T,
+    options?: { flush?: 'raf' | 'sync'; persist?: { name: string } },
+  ): SnapshotStore<T>;
+}
+
+function resolveSnapshotStore(): SnapshotStoreModule {
+  // String assembly is intentional: it preserves the lazy try/fallback in the
+  // emitted client bundle instead of letting the bundler resolve both names.
+  const current = ['@deepseek-ai/dsh-client', '-store'].join('');
+  const legacy = ['@deepseek-ai/dsh-client-runtime', '/client'].join('');
+  try {
+    return require(current) as SnapshotStoreModule;
+  } catch {
+    return require(legacy) as SnapshotStoreModule;
+  }
+}
+
+export const { createSnapshotStore } = resolveSnapshotStore();

package/src/client/index.ts

@@ -9,7 +9,7 @@
  *   action endpoint,
  * - feeds the card's stats / paused-sessions panels from the bridge state.
  */
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
 // Type-only: pulls the locale plugin's Context merge (ctx.locale).
 import type {} from '@deepseek-ai/dsh-client-locale/client';
 // Type-only: pulls the settings-surface SlotMap merge and ctx.settingsScope.

package/src/client/locales.ts

@@ -36,6 +36,8 @@ export const zh = {
   'field.verboseHint': '在浏览器控制台输出 [auto-continue] 日志。',
   'field.classify': '错误分类',
   'field.classifyHint': '仅自动恢复临时性错误(网络/超时/5xx 等); 认证/余额/模型不存在等永久性错误跳过并通知。',
+  'field.retryableErrorPatterns': '自定义可恢复错误',
+  'field.retryableErrorPatternsHint': '每行一个大小写不敏感的普通文本片段; 命中错误码、HTTP 状态或消息时覆盖内置分类。请只填 provider 稳定且足够具体的文案, 过宽会重复请求。',
   'field.backoffFactor': '退避系数',
   'field.backoffFactorHint': '连续失败时冷却间隔的倍率(如 2 表示 20s→40s→80s 递增)。',
   'field.backoffMaxMs': '最大退避间隔 (ms)',
@@ -122,6 +124,8 @@ export const en: Record<SettingsCardKey, string> = {
   'field.verboseHint': 'Log [auto-continue] lines to the browser console.',
   'field.classify': 'Classify errors',
   'field.classifyHint': 'Auto-resume transient failures only (network/timeout/5xx…); auth, balance and model errors are skipped and notified.',
+  'field.retryableErrorPatterns': 'Custom retryable errors',
+  'field.retryableErrorPatternsHint': 'One case-insensitive literal per line. A match in the error code, HTTP status, or message overrides built-in classification. Use only stable, provider-specific text; broad matches can repeat requests.',
   'field.backoffFactor': 'Backoff factor',
   'field.backoffFactorHint': 'Cooldown multiplier per consecutive failure (2 = 20s→40s→80s…).',
   'field.backoffMaxMs': 'Max backoff (ms)',

package/src/client/settings-card.tsx

@@ -8,9 +8,9 @@
  * tokens so the card follows the active theme.
  */
 import { useEffect, useState, type ReactNode } from 'react';
-import { createSnapshotStore, type SettingsScope, type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import { DEFAULT_CONFIG, type AutoContinueSettings } from './engine.ts';
+import { createSnapshotStore, type SettingsScope, type SnapshotStore } from './dsh-store-compat.ts';
 import {
   pausedSessions,
   readTodayStats,
@@ -50,6 +50,7 @@ export interface AutoContinueSettingsCardState extends CardShell {
   freshMs: CardFieldState;
   verbose: CardFieldState;
   classify: CardFieldState;
+  retryableErrorPatterns: CardFieldState;
   backoffFactor: CardFieldState;
   backoffMaxMs: CardFieldState;
   notify: CardFieldState;
@@ -94,6 +95,7 @@ export class AutoContinueSettingsCardController {
       numberField('freshMs', 0),
       booleanField('verbose'),
       booleanField('classify'),
+      textField('retryableErrorPatterns'),
       numberField('backoffFactor', 1),
       numberField('backoffMaxMs', 0),
       booleanField('notify'),
@@ -125,6 +127,7 @@ export class AutoContinueSettingsCardController {
       freshMs: this.form.field('freshMs'),
       verbose: this.form.field('verbose'),
       classify: this.form.field('classify'),
+      retryableErrorPatterns: this.form.field('retryableErrorPatterns'),
       backoffFactor: this.form.field('backoffFactor'),
       backoffMaxMs: this.form.field('backoffMaxMs'),
       notify: this.form.field('notify'),
@@ -230,7 +233,8 @@ interface FieldProps {
 }
 
 /** A staged value field; `numeric` only hints the keypad, which drafts a field accepts is decided by its spec. */
-function ValueField(props: FieldProps & { numeric?: boolean; placeholder?: string }) {
+function ValueField(props: FieldProps & { numeric?: boolean; multiline?: boolean; placeholder?: string }) {
+  const className = props.invalid ? 'dshAcInput dshAcInputInvalid' : 'dshAcInput';
   return (
     <div className="dshAcField">
       <div className="dshAcHead">
@@ -244,17 +248,30 @@ function ValueField(props: FieldProps & { numeric?: boolean; placeholder?: strin
           </span>
         ) : null}
       </div>
-      <input
-        id={props.id}
-        className={props.invalid ? 'dshAcInput dshAcInputInvalid' : 'dshAcInput'}
-        type="text"
-        inputMode={props.numeric === true ? 'numeric' : undefined}
-        aria-invalid={props.invalid || undefined}
-        value={props.text}
-        placeholder={props.placeholder ?? ''}
-        disabled={props.disabled}
-        onChange={(event) => props.onEdit(event.target.value)}
-      />
+      {props.multiline === true ? (
+        <textarea
+          id={props.id}
+          className={`${className} dshAcTextArea`}
+          aria-invalid={props.invalid || undefined}
+          value={props.text}
+          placeholder={props.placeholder ?? ''}
+          disabled={props.disabled}
+          rows={4}
+          onChange={(event) => props.onEdit(event.target.value)}
+        />
+      ) : (
+        <input
+          id={props.id}
+          className={className}
+          type="text"
+          inputMode={props.numeric === true ? 'numeric' : undefined}
+          aria-invalid={props.invalid || undefined}
+          value={props.text}
+          placeholder={props.placeholder ?? ''}
+          disabled={props.disabled}
+          onChange={(event) => props.onEdit(event.target.value)}
+        />
+      )}
       <p className={props.invalid ? 'dshAcInvalid' : 'dshAcHint'}>
         {props.invalid ? props.t('chrome.invalidNumber') : props.hint}
       </p>
@@ -554,6 +571,17 @@ export function AutoContinueSettingsCard(props: AutoContinueSettingsCardProps) {
         onEdit={(text) => props.edit('classify', text)}
         onReset={() => props.resetField('classify')}
       />
+      <ValueField
+        id="auto-continue-retryable-error-patterns"
+        label={t('field.retryableErrorPatterns')}
+        hint={t('field.retryableErrorPatternsHint')}
+        multiline
+        {...shared}
+        {...state.retryableErrorPatterns}
+        onEdit={(text) => props.edit('retryableErrorPatterns', text)}
+        placeholder="Upstream rejected the request as invalid"
+        onReset={() => props.resetField('retryableErrorPatterns')}
+      />
       <ValueField
         id="auto-continue-backoff-factor"
         label={t('field.backoffFactor')}

package/src/client/settings-form.ts

@@ -10,7 +10,7 @@
  * default — and whether the user layer carries it (presence, not value
  * equality, marks an override).
  */
-import type { SettingsScope, SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SettingsScope, SnapshotStore } from './dsh-store-compat.ts';
 
 /** The write one field's staged text performs when the card is saved. */
 export type FieldWrite = { kind: 'set'; value: unknown } | { kind: 'clear' };

package/src/client/styles.ts

@@ -117,6 +117,7 @@ const css = `
 .dshAcInput:focus-visible { border-color: var(--dsw-alias-brand-primary); outline: none; }
 .dshAcInput:disabled { color: var(--dsw-alias-label-tertiary); cursor: default; }
 .dshAcInputInvalid { border-color: var(--dsw-alias-label-error); }
+.dshAcTextArea { box-sizing: border-box; height: auto; min-height: 84px; padding: 8px 12px; resize: vertical; }
 .dshAcSelect {
   border: 1px solid var(--dsw-alias-border-l2);
   background: var(--dsw-alias-bg-layer-3);

package/src/host/engine.ts

@@ -459,7 +459,7 @@ export class AutoContinueRunner {
 
   private onTurnFailure(sessionId: SessionId, reason: string, failure: FailureFacts): void {
     const config = this.getConfig();
-    if (config.classify && !isTransientFailure(failure)) {
+    if (config.classify && !isTransientFailure(failure, config.retryableErrorPatterns)) {
       const summary = `${failure.code}${failure.status !== undefined ? ` (HTTP ${failure.status})` : ''}`;
       this.log(`跳过 ${sessionId}(${reason}): 永久性失败 ${summary} — ${failure.message}`);
       this.bumpStat({ skipped: 1, code: failure.code });

package/src/index.ts

@@ -56,6 +56,8 @@ export const AutoContinueSchema = z.object({
   verbose: z.boolean().default(true),
   /** Classify failures: auto-continue transient errors only; permanent ones are skipped and notified. */
   classify: z.boolean().default(true),
+  /** Provider-specific message/code/status fragments that explicitly count as retryable, one literal per line. */
+  retryableErrorPatterns: z.string().default(''),
   /** Cooldown multiplier per consecutive failure (adaptive backoff). */
   backoffFactor: z.natural().min(1).default(2),
   /** Cap on the effective backoff interval (ms). */

package/src/shared/core.ts

@@ -34,6 +34,8 @@ export interface AutoContinueSettings {
   verbose?: boolean;
   /** Classify failures: auto-continue transient errors only; permanent ones (auth/balance/model) are skipped and notified. */
   classify?: boolean;
+  /** Provider-specific message/code/status fragments that explicitly count as retryable, one literal per line. */
+  retryableErrorPatterns?: string;
   /** Cooldown multiplier per consecutive failure (adaptive backoff). */
   backoffFactor?: number;
   /** Cap on the effective backoff interval (ms). */
@@ -76,6 +78,7 @@ export const DEFAULT_CONFIG: AutoContinueConfig = {
   freshMs: 15 * 60 * 1000,
   verbose: true,
   classify: true,
+  retryableErrorPatterns: '',
   backoffFactor: 2,
   backoffMaxMs: 300000,
   notify: false,
@@ -130,6 +133,10 @@ export function resolveConfig(section: AutoContinueSettings | undefined): AutoCo
     freshMs: numberOr(value.freshMs, DEFAULT_CONFIG.freshMs),
     verbose: booleanOr(value.verbose, DEFAULT_CONFIG.verbose),
     classify: booleanOr(value.classify, DEFAULT_CONFIG.classify),
+    retryableErrorPatterns:
+      typeof value.retryableErrorPatterns === 'string'
+        ? value.retryableErrorPatterns.trim()
+        : DEFAULT_CONFIG.retryableErrorPatterns,
     backoffFactor: Math.max(1, numberOr(value.backoffFactor, DEFAULT_CONFIG.backoffFactor)),
     backoffMaxMs: numberOr(value.backoffMaxMs, DEFAULT_CONFIG.backoffMaxMs),
     notify: booleanOr(value.notify, DEFAULT_CONFIG.notify),
@@ -171,11 +178,18 @@ export interface FailureFacts {
 
 /**
  * 错误分类: 该失败是否值得自动继续。
+ * 用户填写的 provider 专属文本片段优先覆盖内置结果; 未命中时,
  * 永久性失败(认证/余额/模型不存在/上下文超限等)重试也不会成功, 应跳过并通知用户;
  * 其余(网络、超时、5xx、429 等)视为临时性失败, 允许自动恢复。
  */
-export function isTransientFailure(failure: FailureFacts): boolean {
-  const haystack = `${failure.code} ${failure.message}`.toLowerCase();
+export function isTransientFailure(failure: FailureFacts, retryableErrorPatterns = ''): boolean {
+  const haystack = `${failure.code} ${failure.status ?? ''} ${failure.message}`.toLowerCase();
+  const explicitlyRetryable = retryableErrorPatterns
+    .split(/\r?\n/)
+    .map((pattern) => pattern.trim().toLowerCase())
+    .filter((pattern) => pattern !== '')
+    .some((pattern) => haystack.includes(pattern));
+  if (explicitlyRetryable) return true;
   const status = failure.status;
   if (status !== undefined && (status === 401 || status === 403)) return false;
   const permanent =
@@ -456,4 +470,3 @@ export function isOurEcho(state: SessionState, event: SessionEvent): boolean {
     .join('');
   return text === state.lastSentText;
 }
-