dsh-client-auto-continue 0.8.1 → 0.9.0

package/README.md

@@ -37,7 +37,7 @@ For [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh we
 
 **Smart recovery** (all configurable):
 
-- **Error classification** — transient failures (network / timeout / 5xx / 429…) are auto-resumed; permanent ones are **skipped** and notified, because retrying them never helps. A failure counts as permanent when its HTTP status is 401/403 or its code/message matches auth, credential/API-key, balance/quota, unknown-model, or context-length/overflow keywords. Turn classification off to resume everything
+- **Error classification** — transient failures (network / timeout / 5xx / 429…) are auto-resumed; permanent ones are **skipped** and notified, because retrying them never helps. A failure counts as permanent when its HTTP status is 401/403 or its code/message matches auth, credential/API-key, balance/quota, unknown-model, or context-length/overflow keywords. Provider-specific exceptions can be opted into with literal custom retryable patterns; turn classification off to resume everything
 - **Adaptive backoff** — consecutive failures wait longer each time (cooldown × factor: 20s → 40s → 80s…), capped at the max backoff, instead of hammering a broken upstream
 - **Templated continue text** — `continueText` supports `{code}` `{message}` `{status}` `{tool}` `{turn}` `{errorCount}` `{sessionTitle}` `{elapsed}` placeholders, so the resume message can carry the failure context ("继续 (git push failed: UPSTREAM)"); a **separate template** fires on `max-tokens` (e.g. "继续输出, 不要重复已生成的内容")
 - **Idempotency guard** — before resuming, the plugin inspects the last tool call: if its result is unconfirmed (the turn died mid-tool, e.g. a `git push` that may have gone through), the resume message tells the model to check state first and not to rerun; if the tool is confirmed done, it says so and asks not to repeat it; a failed tool gets no guard (retrying it is the point). Both guard texts are configurable (`{tool}` / `{result}` placeholders)
@@ -72,7 +72,7 @@ The browser half is a thin shell: the settings card, plus a status bridge that s
 
 DSH plugins install into a **profile** (`dsh web` → `web` profile). Install, restart `dsh web`, done.
 
-> **Requires DSH ≥ 0.1.0-rc.7** — newer versions register the settings card through the keyed `settings.plugin.item` slot; on rc.6 and earlier the plugin fails to load (`list slot ... requires options.id`). Upgrade dsh first.
+> **Use the latest DSH (recommended: 0.1.2-alpha.1 or newer).** Run `dsh --version` before installing. Plugin v0.8.2 supports the new 0.1.2 client-store module layout and retains a fallback for DSH 0.1.0-rc.7 through 0.1.1; rc.6 and earlier remain unsupported (`list slot ... requires options.id`). Preview releases may appear on the [official DSH releases page](https://github.com/deepseek-ai/deepseek-harness/releases) before the public npm tag catches up.
 
 ### From npm (recommended)
 
@@ -164,6 +164,7 @@ auto-continue:
   freshMs: 900000
   verbose: true
   classify: true
+  retryableErrorPatterns: ''
   backoffFactor: 2
   backoffMaxMs: 300000
   notify: false
@@ -210,10 +211,21 @@ auto-continue:
 | Scan window (ms) | `900000` | Scan only considers interruptions inside this window |
 | Verbose logs | `on` | `[auto-continue]` console logs |
 | Classify errors | `on` | Auto-resume transient failures only; auth / balance / model errors are skipped and notified |
+| Custom retryable errors | empty | One case-insensitive literal per line; matching the error code, HTTP status, or message explicitly overrides the built-in classifier |
 | Backoff factor | `2` | Cooldown multiplier per consecutive failure (2 = 20s → 40s → 80s…) |
 | Max backoff (ms) | `300000` | Cap on the adaptive backoff interval |
 | Browser notifications | `off` | Notify when auto-continue fires, gives up, or hits a permanent error |
 
+For a provider-specific error that is safe to resume (confirm first that manually sending "continue" recovers), add a narrow, stable fragment rather than disabling classification globally:
+
+```yaml
+auto-continue:
+  retryableErrorPatterns: |-
+    Upstream rejected the request as invalid
+```
+
+Patterns are literal substrings, not regular expressions. Blank lines are ignored; any matching line wins before the built-in permanent-error rules. Cooldown and consecutive-attempt limits still apply.
+
 `continueText` (and `continueTextMaxTokens`) accept the placeholders `{code}`, `{message}`, `{status}`, `{tool}` (last tool call before the failure), `{turn}`, `{errorCount}` (consecutive failures including this one), `{sessionTitle}` (from the session list) and `{elapsed}` (time since the failure, e.g. `1m5s`) — e.g. `继续 ({tool}: {code})` becomes `继续 (git push: UPSTREAM)`. The guard texts accept `{tool}` and `{result}` (a truncated excerpt of the last tool output).
 
 ---
@@ -240,7 +252,7 @@ npm run test        # node tests/simulate-host.mjs — 15 host-side behavioral s
 
 While `npm run watch` runs, the profile's client-hmr row polls `lib/client.js` every 500 ms and hot-reloads the plugin in the browser — no server restart needed for code changes.
 
-CI runs [dsh-plugin-check](https://github.com/omdsh-dev/dsh-plugin-check) on every push to `main` and every pull request, and gates releases — the tag workflow refuses to publish while the check fails.
+CI installs from the lockfile, typechecks, rebuilds and verifies committed artifacts, runs the host and dual-layout client simulations, then runs [dsh-plugin-check](https://github.com/omdsh-dev/dsh-plugin-check). The same health check gates releases.
 
 ---
 

package/README.zh.md

@@ -37,7 +37,7 @@
 
 **智能恢复**(全部可配置):
 
-- **错误分类** — 临时性错误(网络 / 超时 / 5xx / 429 等)自动续跑; 永久性错误跳过并通知, 因为重试也没用。判定为永久性的条件: HTTP 状态码 401/403, 或 code/message 命中认证、凭据/API Key、余额/配额、模型不存在、上下文长度/超限等关键词。关闭分类后则全部自动继续
+- **错误分类** — 临时性错误(网络 / 超时 / 5xx / 429 等)自动续跑; 永久性错误跳过并通知, 因为重试也没用。判定为永久性的条件: HTTP 状态码 401/403, 或 code/message 命中认证、凭据/API Key、余额/配额、模型不存在、上下文长度/超限等关键词。provider 专属例外可由用户显式填写普通文本匹配; 关闭分类后则全部自动继续
 - **自适应退避** — 连续失败时等待时间递增(冷却 × 系数: 20s → 40s → 80s…), 有上限, 不再对故障上游狂轰滥炸
 - **模板化继续文本** — `continueText` 支持 `{code}` `{message}` `{status}` `{tool}` `{turn}` `{errorCount}` `{sessionTitle}` `{elapsed}` 占位符, 续跑消息可携带失败上下文(如「继续 (git push 失败: UPSTREAM)」); 达到 `max-tokens` 时使用**另一套模板**(如「继续输出, 不要重复已生成的内容」)
 - **幂等护栏** — 续跑前检查上一步工具调用: 结果未确认(回合在工具执行中途夭折, 如 `git push` 可能已经推上去了)时, 续跑消息会提示模型先确认状态、不要重复执行; 工具已确认成功时说明已完成、请勿重复; 工具失败则不加护栏(重试本来就是目的)。两段护栏文本都可配置(支持 `{tool}` / `{result}` 占位符)
@@ -72,7 +72,7 @@
 
 DSH 插件安装进 **profile**(`dsh web` 对应 `web` profile)。安装后重启 `dsh web` 即可。
 
-> **要求 DSH ≥ 0.1.0-rc.7** — 新版本通过 keyed 的 `settings.plugin.item` 槽位注册设置卡片; 在 rc.6 及更早版本上插件会加载失败(`list slot ... requires options.id`), 请先升级 dsh。
+> **请使用最新 DSH(推荐 0.1.2-alpha.1 或更高版本)。** 安装前先运行 `dsh --version`。插件 v0.8.2 已支持 0.1.2 的新 client-store 模块布局, 同时为 DSH 0.1.0-rc.7 至 0.1.1 保留兼容回退; rc.6 及更早版本仍不支持(`list slot ... requires options.id`)。预览版可能先发布在 [DSH 官方 Releases](https://github.com/deepseek-ai/deepseek-harness/releases), 公开 npm 标签会稍后跟进。
 
 ### 从 npm 安装(推荐)
 
@@ -164,6 +164,7 @@ auto-continue:
   freshMs: 900000
   verbose: true
   classify: true
+  retryableErrorPatterns: ''
   backoffFactor: 2
   backoffMaxMs: 300000
   notify: false
@@ -210,10 +211,21 @@ auto-continue:
 | 扫描时间窗 (ms) | `900000` | 扫描只处理该时间窗内的中断 |
 | 详细日志 | 开 | 控制台输出 `[auto-continue]` 日志 |
 | 错误分类 | 开 | 仅自动恢复临时性错误; 认证 / 余额 / 模型等永久性错误跳过并通知 |
+| 自定义可恢复错误 | 空 | 每行一个大小写不敏感的普通文本片段; 命中错误码、HTTP 状态或消息时显式覆盖内置分类 |
 | 退避系数 | `2` | 连续失败时冷却间隔的倍率(2 = 20s → 40s → 80s…) |
 | 最大退避间隔 (ms) | `300000` | 自适应退避的上限 |
 | 浏览器通知 | 关 | 自动继续成功 / 放弃 / 遇到永久性错误时弹通知 |
 
+遇到确认可以安全续跑的 provider 专属错误时(先确认手动发送「继续」确实能恢复), 应添加足够具体、稳定的片段, 而不是全局关闭错误分类:
+
+```yaml
+auto-continue:
+  retryableErrorPatterns: |-
+    Upstream rejected the request as invalid
+```
+
+匹配项是普通子串, 不是正则表达式。空行会被忽略; 任一行命中后会优先于内置永久错误规则。冷却与最大连续次数仍然生效。
+
 `continueText`(以及 `continueTextMaxTokens`)支持占位符 `{code}`、`{message}`、`{status}`、`{tool}`(失败前最后一次工具调用)、`{turn}`、`{errorCount}`(连续失败次数, 含本次)、`{sessionTitle}`(来自会话列表)和 `{elapsed}`(距失败经过的时间, 如 `1m5s`)——例如 `继续 ({tool}: {code})` 会变成 `继续 (git push: UPSTREAM)`。护栏文本支持 `{tool}` 与 `{result}`(上一步工具输出的截断摘要)。
 
 ---
@@ -240,7 +252,7 @@ npm run test        # node tests/simulate-host.mjs — 15 个 host 侧行为场
 
 `npm run watch` 运行时, profile 的 client-hmr 行每 500ms 轮询 `lib/client.js` 并在浏览器中热重载插件——改代码无需重启服务。
 
-CI 在每次推送到 `main` 及每个 PR 时跑 [dsh-plugin-check](https://github.com/omdsh-dev/dsh-plugin-check) 体检, 并作为发布的前置条件——体检失败时 tag 流程拒绝发布。
+CI 会按锁文件安装依赖, 执行类型检查、重新构建并核对已提交产物, 跑 host 与双模块布局 client 模拟测试, 最后运行 [dsh-plugin-check](https://github.com/omdsh-dev/dsh-plugin-check); 发布也受同一体检门禁约束。
 
 ---
 

package/lib/client.js

@@ -67,6 +67,8 @@ var 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)",
@@ -148,6 +150,8 @@ var en = {
   "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)",
@@ -201,7 +205,6 @@ var en = {
 
 // src/client/settings-card.tsx
 var import_react = require("react");
-var import_client = require("@deepseek-ai/dsh-client-runtime/client");
 
 // src/shared/core.ts
 var DEFAULT_CONFIG = {
@@ -218,6 +221,7 @@ var DEFAULT_CONFIG = {
   freshMs: 15 * 60 * 1e3,
   verbose: true,
   classify: true,
+  retryableErrorPatterns: "",
   backoffFactor: 2,
   backoffMaxMs: 3e5,
   notify: false,
@@ -233,6 +237,18 @@ var DEFAULT_CONFIG = {
 var RECOVERY_WINDOW_MS = 10 * 60 * 1e3;
 var ECHO_WINDOW_MS = 10 * 60 * 1e3;
 
+// src/client/dsh-store-compat.ts
+function resolveSnapshotStore() {
+  const current = ["@deepseek-ai/dsh-client", "-store"].join("");
+  const legacy = ["@deepseek-ai/dsh-client-runtime", "/client"].join("");
+  try {
+    return require(current);
+  } catch {
+    return require(legacy);
+  }
+}
+var { createSnapshotStore } = resolveSnapshotStore();
+
 // src/client/bridge.ts
 var EMPTY_STATS = {
   date: "",
@@ -659,6 +675,7 @@ var 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);
@@ -734,6 +751,7 @@ var AutoContinueSettingsCardController = class {
       numberField("freshMs", 0),
       booleanField("verbose"),
       booleanField("classify"),
+      textField("retryableErrorPatterns"),
       numberField("backoffFactor", 1),
       numberField("backoffMaxMs", 0),
       booleanField("notify"),
@@ -745,7 +763,7 @@ var AutoContinueSettingsCardController = class {
       numberField("loopToolRepeat", 2),
       textField("loopText")
     ]);
-    this.store = this.form.bind(() => this.projection(), import_client.createSnapshotStore);
+    this.store = this.form.bind(() => this.projection(), createSnapshotStore);
   }
   projection() {
     return {
@@ -764,6 +782,7 @@ var AutoContinueSettingsCardController = class {
       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"),
@@ -831,6 +850,7 @@ function SettingsCard(props) {
   ] });
 }
 function ValueField(props) {
+  const className = props.invalid ? "dshAcInput dshAcInputInvalid" : "dshAcInput";
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "dshAcField", children: [
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "dshAcHead", children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("label", { className: "dshAcLabel", htmlFor: props.id, children: props.label }),
@@ -839,11 +859,23 @@ function ValueField(props) {
         /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", className: "dshAcReset", disabled: props.disabled, onClick: props.onReset, children: props.t("chrome.reset") })
       ] }) : null
     ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    props.multiline === true ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      "textarea",
+      {
+        id: props.id,
+        className: `${className} dshAcTextArea`,
+        "aria-invalid": props.invalid || void 0,
+        value: props.text,
+        placeholder: props.placeholder ?? "",
+        disabled: props.disabled,
+        rows: 4,
+        onChange: (event) => props.onEdit(event.target.value)
+      }
+    ) : /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
       "input",
       {
         id: props.id,
-        className: props.invalid ? "dshAcInput dshAcInputInvalid" : "dshAcInput",
+        className,
         type: "text",
         inputMode: props.numeric === true ? "numeric" : void 0,
         "aria-invalid": props.invalid || void 0,
@@ -1189,6 +1221,20 @@ function AutoContinueSettingsCard(props) {
             onReset: () => props.resetField("classify")
           }
         ),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+          ValueField,
+          {
+            id: "auto-continue-retryable-error-patterns",
+            label: t("field.retryableErrorPatterns"),
+            hint: t("field.retryableErrorPatternsHint"),
+            multiline: true,
+            ...shared,
+            ...state2.retryableErrorPatterns,
+            onEdit: (text) => props.edit("retryableErrorPatterns", text),
+            placeholder: "Upstream rejected the request as invalid",
+            onReset: () => props.resetField("retryableErrorPatterns")
+          }
+        ),
         /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
           ValueField,
           {