@goodandready/dsh-opencode-provider 0.5.5 → 0.5.6

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.5.6
+
+- **Persistent sticky routing**: the last successful account/model per conversation survives adapter and Desktop restarts. `~/.dsh/storages/dsh-opencode/sticky.json` stores hashed session ids and key fingerprints only (no keys or prompt text), keeps 500 entries for 14 days.
+- 88 tests.
+
 ## 0.5.5
 
 - **Per-account request stats**: every upstream attempt now records its outcome, latency and TTFT in the local request log; the heatmap adds a per-account table with requests, errors and average latency/TTFT. No prompt or response content is stored.

package/README.md

@@ -95,7 +95,7 @@ graph LR
 - **`/opencode` command** for status, usage, accounts, models, rules, and `test [model]`.
 - **TUI settings section** for the terminal profile (`/settings → OpenCode`) with the key, endpoints, allowlist, active account, fallback model, sticky routing and timeouts.
 - **Quota fallback**: choose a free model in Settings → OpenCode; a Go quota rejection retries once through Console/Zen.
-- **Sticky account**: the last successful account is preferred for the same conversation; explicit model rules and pinned accounts win.
+- **Sticky account**: the last successful account is preferred for the same conversation and survives restarts via a local `sticky.json` (hashed session ids and key fingerprints only); explicit model rules and pinned accounts win.
 - **Routing trace** in the quota panel and per-account heatmap filter.
 - **One-click plugin update** in Settings → OpenCode: current/latest version, an update badge, and an **Update now** button that installs the exact npm version through the DSH CLI and asks for a restart. The host endpoint is `GET/POST /dsh-opencode/update`.
 - **Plan-aware Go picker**: hides models outside the Go table unless turned off; descriptions carry `Go`, `Console` or `FREE`.
@@ -123,12 +123,12 @@ npm pack
 Install the **packed tarball** into a profile:
 
 ```bash
-dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.5.tgz
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.6.tgz
 # DSH Desktop:
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.5.tgz
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.6.tgz
 
 # Or install the published package:
-dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.5
+dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.6
 ```
 
 Restart dsh (or DSH Desktop), then pick `OpenCode` or `OpenCode Go` in the model picker.

package/README.ru.md

@@ -94,7 +94,7 @@ graph LR
 - **Онбординг аккаунтов**: **Import all from auth.json** переносит все ключи OpenCode в отдельные credential ref и добавляет аккаунты; **Check all accounts** обновляет квоты и health по каждому аккаунту.
 - **Правила «модель ➔ аккаунт»**: сопоставление по glob-паттернам закрепляет предпочтительный аккаунт за моделью; остальные аккаунты остаются в резерве.
 - **Квотный fallback**: выберите бесплатную модель в настройках; при ошибке квоты Go тот же запрос один раз повторяется через Console/Zen. Если fallback тоже не сработал, возвращается исходная ошибка квоты.
-- **Липкий аккаунт**: последний успешный аккаунт предпочитается в том же диалоге; явные правила модели, закреплённый аккаунт и квотный fallback имеют приоритет.
+- **Липкий аккаунт**: последний успешный аккаунт предпочитается в том же диалоге и сохраняется между перезапусками в локальном `sticky.json` (только хешированные session id и fingerprint ключей); явные правила модели, закреплённый аккаунт и квотный fallback имеют приоритет.
 - **Трассировка маршрутизации**: панель квот показывает последние решения (`rule`, `sticky`, `rotation`, `quota-fallback`) без промптов и ключей.
 - **Статистика по аккаунтам**: в request log пишутся `ok`, `latencyMs`, `ttftMs` и `error`; heatmap показывает таблицу запросов, ошибок и средних latency/TTFT по каждому аккаунту.
 - **Почасовой Heatmap запросов**: сетка «день недели × час» в локальном времени плюс суточная полоса агрегации. Фильтры переключают отображение между всеми запросами, конкретной моделью и аккаунтом. Лог `~/.dsh/storages/dsh-opencode/requests.jsonl` хранит только метаданные `{at, provider, model, purpose, account, reason, ok, latencyMs, ttftMs, error}` (промпты и ответы не сохраняются).
@@ -122,12 +122,12 @@ npm pack
 Установка из **упакованного tarball**:
 
 ```bash
-dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.5.tgz
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.6.tgz
 # DSH Desktop:
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.5.tgz
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.6.tgz
 
 # Либо установка опубликованного пакета из npm:
-dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.5
+dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.6
 ```
 
 После установки перезапустите dsh (или DSH Desktop) и выберите **OpenCode** или **OpenCode Go** в списке моделей.

package/README.zh.md

@@ -94,7 +94,7 @@ graph LR
 - **每账户预计可用时长**：按各窗口的平均消耗速度估算耗尽时间，并标记在重置前最先耗尽的窗口；API 仅提供当前百分比与重置时间，因此为近似值。
 - **模型 ➔ 账户路由规则**：支持 Glob 通配符（如 `*free*`、`deepseek-*`）将模型优先绑定至特定账户，其他账户保留为备用。
 - **配额回退**：在设置中选择免费模型；Go 返回配额错误时，同一请求通过 Console/Zen 重试一次。若回退也失败，返回原始配额错误。
-- **会话粘性账户**：同一会话优先使用上次成功的账户；显式模型规则、固定账户和配额回退优先。
+- **会话粘性账户**：同一会话优先使用上次成功的账户，并通过本地 `sticky.json` 跨重启保留（仅哈希后的 session id 和密钥指纹）；显式模型规则、固定账户和配额回退优先。
 - **路由追踪**：配额面板显示最近的账户/模型决策（`rule`、`sticky`、`rotation`、`quota-fallback`），不记录提示词或密钥。
 - **按账户请求统计**：请求日志记录 `ok`、`latencyMs`、`ttftMs` 和 `error`；热力图表格显示每个账户的请求数、错误数及平均延迟/TTFT。
 - **本地时间请求热力图**：星期×小时交互式热力图，排除系统心跳与重复记录，可按模型或账户过滤，仅保存 `{at, provider, model, purpose, account, reason, ok, latencyMs, ttftMs, error}` 元数据，不保存任何提示词与回复。
@@ -119,12 +119,12 @@ npm pack
 通过**打包文件 (.tgz)**安装：
 
 ```bash
-dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.5.tgz
+dsh plugin --profile web add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.6.tgz
 # DSH 桌面端：
-dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.5.tgz
+dsh plugin --profile desktop add /absolute/path/to/goodandready-dsh-opencode-provider-0.5.6.tgz
 
 # 或从 npm 安装已发布版本：
-dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.5
+dsh plugin --profile web add @goodandready/dsh-opencode-provider@0.5.6
 ```
 
 安装完成后重启 dsh 或 DSH 桌面端，在模型选择器中选择 **OpenCode** 或 **OpenCode Go** 即可。

package/lib/index.d.ts

@@ -176,6 +176,8 @@ interface OpenCodeAdapterDeps {
   readonly recordRequest?: (provider: string, model: string, purpose?: string, account?: string, reason?: string, outcome?: RequestOutcome) => void;
   /** Test seam; defaults to ~/.dsh/storages/dsh-opencode/cooldowns.json. */
   readonly cooldownPath?: string;
+  /** Test seam; defaults to ~/.dsh/storages/dsh-opencode/sticky.json. */
+  readonly stickyPath?: string;
   /** Receives a one-time warning when the provider tool limit drops tools. */
   readonly warn?: (message: string) => void;
 }
@@ -183,7 +185,9 @@ declare class OpenCodeAdapter extends LlmAdapter {
   private readonly deps;
   private readonly fetchImpl;
   private readonly cooldownPath;
+  private readonly stickyPath;
   private cooldownWrites;
+  private stickyWrites;
   /** key fingerprint → cooldown deadline and the rejection that caused it. */
   private readonly cooldowns;
   private readonly sticky;
@@ -201,6 +205,11 @@ declare class OpenCodeAdapter extends LlmAdapter {
   stream(options: GenerateOptions): AsyncIterable<StreamChunk>;
   private run;
   private rememberSticky;
+  /** Await pending sticky persistence writes (tests and shutdown). */
+  flushSticky(): Promise<void>;
+  private loadSticky;
+  private pruneSticky;
+  private persistSticky;
   private pushTrace;
   private parse;
   private send;

package/lib/index.js

@@ -17,7 +17,7 @@ const DEFAULT_GO_API_BASE = "https://opencode.ai/inference/go";
 const DEFAULT_GO_ZEN_BASE = "https://opencode.ai/zen/go/v1";
 const DEFAULT_USAGE_URL = "https://opencode.ai/zen/go/v1/usage";
 const DEFAULT_AUTH_ENTRY = "opencode-go";
-const DEFAULT_USER_AGENT = "dsh-opencode-provider/0.5.5";
+const DEFAULT_USER_AGENT = "dsh-opencode-provider/0.5.6";
 const DEFAULT_CONTEXT_WINDOW = 262144;
 const DEFAULT_MAX_TOKENS = 32768;
 const DEFAULT_GENERATE_MAX_TOKENS = 32768;
@@ -3076,11 +3076,17 @@ function defaultCooldownPath() {
 	const home = process.env.DSH_HOME?.trim() || join(homedir(), ".dsh");
 	return join(home, "storages", "dsh-opencode", "cooldowns.json");
 }
+function defaultStickyPath() {
+	const home = process.env.DSH_HOME?.trim() || join(homedir(), ".dsh");
+	return join(home, "storages", "dsh-opencode", "sticky.json");
+}
 var OpenCodeAdapter = class extends LlmAdapter {
 	deps;
 	fetchImpl;
 	cooldownPath;
+	stickyPath;
 	cooldownWrites = Promise.resolve();
+	stickyWrites = Promise.resolve();
 	/** key fingerprint → cooldown deadline and the rejection that caused it. */
 	cooldowns = /* @__PURE__ */ new Map();
 	sticky = /* @__PURE__ */ new Map();
@@ -3091,7 +3097,9 @@ var OpenCodeAdapter = class extends LlmAdapter {
 		this.deps = deps;
 		this.fetchImpl = deps.fetchImpl ?? fetch;
 		this.cooldownPath = deps.cooldownPath ?? defaultCooldownPath();
+		this.stickyPath = deps.stickyPath ?? defaultStickyPath();
 		this.loadCooldowns();
+		this.loadSticky();
 	}
 	providerInfo(provider) {
 		return {
@@ -3315,6 +3323,55 @@ var OpenCodeAdapter = class extends LlmAdapter {
 			model: options.model,
 			at: Date.now()
 		});
+		this.persistSticky();
+	}
+	/** Await pending sticky persistence writes (tests and shutdown). */
+	async flushSticky() {
+		await this.stickyWrites;
+	}
+	loadSticky() {
+		try {
+			const entries = JSON.parse(readFileSync(this.stickyPath, "utf8")).sticky;
+			if (typeof entries !== "object" || entries === null || Array.isArray(entries)) return;
+			for (const [sessionId, value] of Object.entries(entries)) {
+				if (typeof value !== "object" || value === null || Array.isArray(value)) continue;
+				const record = value;
+				const fingerprint = record.fingerprint;
+				const label = record.label;
+				const provider = record.provider;
+				const model = record.model;
+				const at = record.at;
+				if (typeof fingerprint !== "string" || !/^[0-9a-f]{16}$/.test(fingerprint)) continue;
+				if (typeof label !== "string" || label === "") continue;
+				if (typeof provider !== "string" || provider === "") continue;
+				if (typeof model !== "string" || model === "") continue;
+				if (typeof at !== "number" || !Number.isFinite(at)) continue;
+				this.sticky.set(sessionId, {
+					fingerprint,
+					label,
+					provider,
+					model,
+					at
+				});
+			}
+			this.pruneSticky();
+		} catch {}
+	}
+	pruneSticky() {
+		const cutoff = Date.now() - 12096e5;
+		for (const [sessionId, entry] of this.sticky) if (entry.at < cutoff) this.sticky.delete(sessionId);
+		const overflow = this.sticky.size - 500;
+		if (overflow <= 0) return;
+		const oldest = [...this.sticky.entries()].sort((a, b) => a[1].at - b[1].at).slice(0, overflow);
+		for (const [sessionId] of oldest) this.sticky.delete(sessionId);
+	}
+	persistSticky() {
+		this.pruneSticky();
+		const payload = JSON.stringify({ sticky: Object.fromEntries(this.sticky) });
+		this.stickyWrites = this.stickyWrites.then(async () => {
+			await mkdir(dirname(this.stickyPath), { recursive: true });
+			await writeFile(this.stickyPath, payload, "utf8");
+		}).catch(() => {});
 	}
 	pushTrace(entry) {
 		this.routing.unshift(entry);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-opencode-provider",
-  "version": "0.5.5",
+  "version": "0.5.6",
   "description": "OpenCode / OpenCode Go LLM provider plugin for DeepSeek Harness (dsh).",
   "license": "MIT",
   "type": "module",