dsh-vision-router 3.1.0 → 3.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -22,7 +22,7 @@
22
22
  > **Data leaves your machine by default.** When a cloud vision model is used, Vision Router sends the image (or a derived crop), the vision prompt and related request metadata to that provider. A fresh install has an anonymous OVHcloud vision fallback enabled, so "free" and "no key" do **not** mean offline. Do not use the cloud chain for confidential, regulated or classified material. See [Data flow and strict local-only use](#data-flow-and-strict-local-only-use).
23
23
 
24
24
  > [!WARNING]
25
- > **v3.1.0 release notes:** simpler image-input setup and clear cloud-upload privacy controls, plus DSH compatibility, HTTP and dependency fixes. See [v3.1.0 release notes](docs/releases/v3.1.0.md). For the installable version, check [GitHub Releases](https://github.com/ysr666/dsh-vision-router/releases/latest) or npm for the installable version.
25
+ > **v3.1.2 release candidate notes:** New Vision Router icons in DSH Plugin Manager and the native Settings navigation where available; reviewed Alpha.2/Alpha.3 Cordis compatibility, dependency security, and Host process fixes. Older DSH Settings shells keep their default icon. See [v3.1.2 notes](docs/releases/v3.1.2.md). Check [GitHub Releases](https://github.com/ysr666/dsh-vision-router/releases/latest) and npm for actual publication.
26
26
 
27
27
  ## Start here
28
28
 
@@ -79,7 +79,7 @@ These are ordinary chat requests: your normal model reasons through the task and
79
79
  - **Automatic failover with classified errors.** Region blocks, ToS filtering, 402 quota, 429 rate limits, context overflow, network failures — the chain walks providers one by one and only reports after all of them failed, with actionable advice. A 429 immediately advances to the next backend and opens a Retry-After-aware cooldown instead of sleeping inside the request.
80
80
  - **Image memory.** Vision answers are cached by attachment content hash; later text turns substitute the recorded description (marked as untrusted evidence), so DeepSeek genuinely remembers earlier images without re-spending vision calls.
81
81
  - **A verifiable pixel loop.** Reference → `vision_html_screenshot` → `vision_pixel_diff` (ratio + worst 8×8-grid regions) → fix → repeat until the mismatch converges. UI restoration becomes measurable instead of eyeballed.
82
- - **Stable tool schema.** All fourteen deep tools are registered from session start by default, avoiding a mid-conversation tool-list expansion that can invalidate long-context KV/prefix caches. `progressiveTools: true` remains an advanced boot-time opt-in; only then does `vision_activate` mount the tools on demand. See [`docs/progressive-tools-cache.md`](docs/progressive-tools-cache.md).
82
+ - **Stable tool schema.** All fourteen deep tools register globally at startup by default, avoiding a mid-conversation tool-list expansion that can invalidate long-context KV/prefix caches. Individual Agents see them only while their conversation has Vision enabled. `progressiveTools: true` remains an advanced boot-time opt-in; only then does `vision_activate` mount the tools on demand. See [`docs/progressive-tools-cache.md`](docs/progressive-tools-cache.md).
83
83
  - **Selective proxy.** Only the configured vision provider hosts go through your local proxy; DeepSeek stays direct.
84
84
 
85
85
  ### Pixel loop in practice
@@ -100,7 +100,9 @@ The vision model is **only the eyes**; DeepSeek is **always the brain**. An imag
100
100
 
101
101
  ## Tools
102
102
 
103
- Default `progressiveTools: false`: all fourteen deep tools stay registered from plugin startup, so text and image turns can call them immediately. If you explicitly set `progressiveTools: true` in the profile/composition `cordis.patch.yml`, progressive mode is restored: only `vision_activate` is exposed initially, the full tool set mounts on first use, and the `vision-tools` skill is registered. This is a boot-time switch; restart DSH after changing it. Built on sharp / potrace / tesseract / system Chrome — no Python:
103
+ Default `progressiveTools: false`: all fourteen deep tools are registered at startup. **Registration does not grant access in every conversation**: turn **Vision ON** in the current chat to make them visible and callable by its Agent. While Vision is OFF, that Agent cannot use `vision_colors`, `vision_ocr`, or the other Vision Router tools, even with `tool: true` in Settings. Under this default mode, `vision_activate` is **not registered**.
104
+
105
+ To opt into progressive mounting, explicitly set `progressiveTools: true` in the profile/composition `cordis.patch.yml`. Only then is `vision_activate` initially exposed to Vision-enabled Sessions; the full tool set mounts upon activation and the `vision-tools` skill is registered. This is a boot-time switch; restart DSH after changing it. Built on sharp / potrace / tesseract / system Chrome — no Python:
104
106
 
105
107
  <p align="center">
106
108
  <img src="assets/vision-tools.svg" width="100%" alt="Eleven image-processing tools available in DSH Vision Router." />
@@ -609,7 +611,7 @@ exploration (LLM7.io and OVHcloud anonymous tiers) by
609
611
 
610
612
  ## Release notes and community
611
613
 
612
- Release details: [v3.1.0 release notes](docs/releases/v3.1.0.md). Check GitHub Releases or npm for the published version.
614
+ Release details: [v3.1.2 release candidate notes](docs/releases/v3.1.2.md). Check GitHub Releases or npm for the published version.
613
615
 
614
616
  <p align="center">
615
617
  <sub>Ecosystem:</sub>
package/README.zh.md CHANGED
@@ -22,7 +22,7 @@
22
22
  > **默认配置会让数据出网。** 使用云端视觉模型时,Vision Router 会将图片(或由它裁剪出的局部)、识图提示词及相关请求元数据发送给对应供应商。新安装默认开启 OVHcloud 匿名视觉兜底,因此“免费”和“免 Key”不等于离线。涉密、涉案、内部或其他受限材料请勿使用云端链路。详见[数据流向与严格纯本地配置](#数据流向与严格纯本地配置)。
23
23
 
24
24
  > [!WARNING]
25
- > **v3.1.0 更新说明:** 简化识图模型设置,增加云端出网关闭指引与「不再提醒」,并修正 DSH 兼容、HTTP 和依赖安全问题。参见[v3.1.0 更新说明](docs/releases/v3.1.0.md)。实际可安装版本请以 [GitHub Releases](https://github.com/ysr666/dsh-vision-router/releases/latest)或 npm 为准。
25
+ > **v3.1.2 候选版更新说明:** 新增 Vision Router 插件管理图标及新版 DSH 的设置导航图标;纳入 Alpha.2/Alpha.3 Cordis 适配、依赖安全与 Host 进程兼容修复。旧版 DSH 的设置导航保持默认图标。详见[v3.1.2 更新说明](docs/releases/v3.1.2.md)。正式可安装版本以 [GitHub Releases](https://github.com/ysr666/dsh-vision-router/releases/latest) 或 npm 为准。
26
26
 
27
27
  ## 先用起来
28
28
 
@@ -79,7 +79,7 @@ npx @deepseek-ai/dsh plugin --profile web add dsh-vision-router
79
79
  - **自动降级 + 分类报错。** 地区限制、ToS 风控、402 额度、429 限流、上下文超长、网络故障——链路逐供应商尝试,全部失败才报错并给出可操作的建议。遇到 429 会立即尝试下一后端,并按 Retry-After 开启冷却,不会在单次请求内睡眠等待。
80
80
  - **图片记忆。** 视觉答案按附件内容哈希缓存;后续文字轮用记录的描述替换历史图片(标注为不可信证据),DeepSeek 真正“记得”之前发过的图,且不重复消耗视觉调用。
81
81
  - **可验证的像素闭环。** 参照图 → `vision_html_screenshot` → `vision_pixel_diff`(差异率 + 红色热力图 + 最差区域排行)→ 修复 → 再对比,直到差异收敛。UI 还原从“目测”变成“实测”。
82
- - **稳定工具 schema。** 默认从会话开始就注册完整 14 个深看工具,避免图片轮中途扩展工具列表导致长上下文的 KV / prefix cache 失效。仍保留 `progressiveTools: true` 作为高级启动期 opt-in;开启后才使用 `vision_activate` 按需挂载。详见 [`docs/progressive-tools-cache.md`](docs/progressive-tools-cache.md)。
82
+ - **稳定工具 schema。** 默认在插件启动时全局注册完整 14 个深看工具,避免图片轮中途扩展工具列表导致长上下文的 KV / prefix cache 失效;但只有当前会话开启 Vision,Agent 才能看到这些工具。仍保留 `progressiveTools: true` 作为高级启动期选项;开启后才使用 `vision_activate` 按需挂载。详见 [`docs/progressive-tools-cache.md`](docs/progressive-tools-cache.md)。
83
83
  - **选择性代理。** 只有配置的视觉供应商域名走本地代理;DeepSeek 保持直连。
84
84
 
85
85
  ### 像素闭环实测
@@ -100,7 +100,9 @@ Agent 仅根据参考图复刻 UI,再用 `vision_pixel_diff` 验证最终结
100
100
 
101
101
  ## 工具
102
102
 
103
- 默认 `progressiveTools: false`:14 个深看工具从插件启动时就保持常驻,文本轮和图片轮都可直接调用。若你在 profile / composition 的 `cordis.patch.yml` 中显式开启 `progressiveTools: true`,才会恢复渐进模式:初始只暴露 `vision_activate`,首次需要时再挂载完整工具,并注册 `vision-tools` 技能。该开关是启动期配置,修改后需重启 DSH。全部工具基于 sharp / potrace / tesseract / 系统 Chrome——无 Python:
103
+ 默认 `progressiveTools: false`:14 个深看工具在插件启动时即注册。但**注册成功不等于所有会话都能调用**:须在当前聊天中打开 **Vision(视觉)**,该会话的 Agent 才能看到和调用视觉工具。Vision 关闭时,即使设置里 `tool: true`,也无法调用 `vision_colors`、`vision_ocr` 等工具。默认模式下**不会注册 `vision_activate`**。
104
+
105
+ 需要渐进式挂载时,可在 profile / composition 的 `cordis.patch.yml` 中显式设置 `progressiveTools: true`。这时已开启 Vision 的会话初始可使用 `vision_activate`,激活后再挂载完整工具并注册 `vision-tools` 技能。该开关属于启动期配置,修改后需重启 DSH。全部工具基于 sharp / potrace / tesseract / 系统 Chrome——无 Python:
104
106
 
105
107
  <p align="center">
106
108
  <img src="assets/vision-tools-zh.svg" width="100%" alt="DSH Vision Router 的 11 个图像处理工具。" />
@@ -603,7 +605,7 @@ npx dsh-vision-router doctor --profile web
603
605
 
604
606
  ## 版本公告与社区链接
605
607
 
606
- 版本更新详情:[v3.1.0 更新说明](docs/releases/v3.1.0.md)。正式可安装版本请以 GitHub Releases 或 npm 为准。
608
+ 版本更新详情:[v3.1.2 候选版更新说明](docs/releases/v3.1.2.md)。正式可安装版本请以 GitHub Releases 或 npm 为准。
607
609
 
608
610
  <p align="center">
609
611
  <sub>生态收录:</sub>
@@ -0,0 +1 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><defs><linearGradient id="vr-brand" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#6E58F7"/><stop offset="1" stop-color="#179ED6"/></linearGradient></defs><rect width="64" height="64" rx="15" fill="url(#vr-brand)"/><path d="M10 32C17 22 24 17 32 17S47 22 54 32C47 42 40 47 32 47S17 42 10 32Z" fill="none" stroke="#FFFFFF" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/><circle cx="32" cy="32" r="10" fill="#FFFFFF"/><circle cx="32" cy="32" r="5.5" fill="#283C89"/><circle cx="35" cy="29" r="2.2" fill="#A8F2FF"/></svg>
@@ -43,3 +43,24 @@ If the write tokens ever need to shrink, the order is: attach the publishing job
43
43
  environment, then drop `pull-requests: write` from the pin refresh by opening the bump as an
44
44
  issue instead of a pull request. Both trade automation for score, which is why they are not the
45
45
  default.
46
+
47
+
48
+ ## Reviewed Alpha Settings pin: least-privilege update lane
49
+
50
+ The Alpha Settings Host Gate uses a reviewed version / immutable SHA pair
51
+ from config/dsh-alpha-settings-pin.json. Its three job families load that pair
52
+ and reject an invalid or incomplete pin. The gate runs on pull requests that
53
+ touch the config or loader and on the merge to main. The updater stages only
54
+ the JSON config, never workflow YAML; do not grant the bot workflow-edit
55
+ permission. Merging a pin PR is the upstream execution review boundary.
56
+
57
+ The pin step writes both current and changed through GITHUB_OUTPUT. The bot
58
+ updates its dedicated branch using an explicit lease against the remote SHA,
59
+ not an unsafe force push.
60
+
61
+ Repository settings may separately prohibit GitHub Actions from creating PRs,
62
+ even with pull-requests: write. Under that policy the refresh action pushes
63
+ the config-only branch but fails with an actionable compare/PR URL, not a
64
+ misleading success. Opening the PR requires an authorized person or a
65
+ separately scoped PR-writing app token. Changing that security setting is
66
+ outside this code fix.
@@ -0,0 +1,61 @@
1
+ # Client UI lifecycle and onboarding notes
2
+
3
+ These implementation notes are kept outside the self-contained browser module to preserve the project's 256 KiB review limit. The source comments still point to each section. No runtime behavior was extracted or changed.
4
+
5
+ ## Walkthrough spotlight geometry
6
+
7
+ // ── walkthrough spotlight: highlight the real UI targets ────────────────
8
+ // The walkthrough overlays are plain DOM: a dimmed backdrop with a "hole"
9
+ // over the current target (classic box-shadow spotlight), a pulsing ring
10
+ // around it, and the prompt card anchored beside the target with an arrow
11
+ // pointing at it. Everything is pointer-events:none except the prompt, so
12
+ // the real controls stay clickable the whole time.
13
+ //
14
+ // DSH web hashes its CSS-module class names (unstable across builds), so
15
+ // the targets are addressed through the stable surface instead: slot
16
+ // wrappers (data-slot), data-composer-card and aria-haspopup/aria-label
17
+ // attributes. Each step keeps a fallback chain, and when nothing matches
18
+ // the prompt degrades to a corner card with a directional arrow.
19
+
20
+ ## Onboarding step controls
21
+
22
+ // Every step that is not the last one gets a Next button, so the two
23
+ // floating prompts stay symmetric. Step 1's Next advances the stored
24
+ // step; step 2's Next performs the current phase's action for the
25
+ // user — opening the settings panel, then entering the Vision Router
26
+ // section — so the walkthrough can be driven entirely from the prompt
27
+ // without touching the real controls.
28
+
29
+ ## Provider-model draft rows
30
+
31
+ // Rows persist as { provider, model } objects while editing — an
32
+ // incomplete row (provider picked, model pending) stays visible
33
+ // instead of collapsing, which is what made the provider dropdown
34
+ // feel unselectable before. Like the vision backend chain above, an
35
+ // empty configuration still renders one blank row ready to fill.
36
+
37
+ ## Two-select routing row
38
+
39
+ // Same two-select row shape as the vision backend chain above: a
40
+ // provider dropdown (providers that have excluded models) and a model
41
+ // dropdown (that provider's excluded models). A row the user already
42
+ // selected elsewhere stays disabled in the other rows. Option sets
43
+ // come from the memoized top-level hooks (this function is plain
44
+ // render code and must stay hook-free).
45
+
46
+ ## Catalog render-phase bootstrap
47
+
48
+ // Render-phase kick: whenever the body is open and the catalog was never
49
+ // fetched (including after a remount that reset the state), start the
50
+ // fetch. React supports setState during render for the same component,
51
+ // and the status flips to 'loading' so this cannot loop. The same kick
52
+ // runs the cheap test-connection probe once so the Host-owned official
53
+ // provider availability notice can render without a button click.
54
+
55
+ ## Onboarding replay
56
+
57
+ // Re-viewing the guide replays it from the beginning:
58
+ // leave the settings modal first (its panel closes on
59
+ // Escape), show the overview (steps 1-3), and then walk
60
+ // through step 1 on the chat page — starting in place
61
+ // would skip the session/text-model step entirely.
@@ -0,0 +1,31 @@
1
+ # v3.1.1 — maintenance patch / 维护修正版
2
+
3
+ These are candidate release notes. Availability is established only after the protected release workflow publishes an immutable GitHub Release and verified npm package.
4
+
5
+ 本文是候选版更新说明。只有受保护发布流程完成,并核对不可变 GitHub Release、npm 包及来源证明后,才算正式发布。
6
+
7
+ ## Session tool visibility and isolation / 会话工具可见性与隔离
8
+
9
+ - **#761:** After successful HMR/recomposition, retained Agents immediately regain their previous Session Vision-OFF tool mask; Vision-ON Agents stay ON. Execution-time policy remains fail-closed. / HMR 或重组后立即恢复旧 Agent 的识图关闭遮罩,不影响开启状态,不放宽执行期权限。
10
+ - **#762:** Resolve same-name tools using the actual Agent scope instead of an implicit global lookup, preserving other plugins' Agent-local tool shadows. / 按实际 Agent 作用域查询同名工具,避免误删其他插件在该 Agent 中的工具。
11
+ - **#763 and #764:** Add pinned DSH RC3 Agent-scoped visibility regressions and clarify the composer Vision switch's authority. When progressiveTools is false, vision_activate is intentionally absent. / 补充 RC3 真实工具作用域回归测试,明确会话识图开关权限;非渐进模式不注册 vision_activate。
12
+
13
+ ## Image rejection recovery / 上游拒图回退
14
+
15
+ - **#769 (fixes #768):** Recognize a gateway's explicit `The request model is not multimodal` rejection and retry once through the existing canonical image-to-text bridge before output. The fix does not swallow generic HTTP 400, unsupported format/size, cancellation or Session restriction. / 识别网关明确提示模型非多模态时的拒图,输出前经原有文本桥重试一次;不误判通用 HTTP 400、图片大小或格式限制,也不绕过取消与会话权限。
16
+ - **Validation boundary:** This source fix is not a credentialed end-to-end test of the original Windows Desktop + dsh-codearts account. The dated upstream model's actual image capability still depends on the gateway. / 验收边界:尚未使用报告用户的 Windows CodeArts 账号完成真实网关端到端复测,不能保证上游模型本身支持图片。
17
+
18
+ ## Cross-version source builds and DSH RC5 / 跨版本编译与 DSH RC5
19
+
20
+ - **#772 (fixes #771):** Type-only compatibility for separate Host Zod 4.4.3 and DVR Zod 4.6.x copies at the Storage Domain schema boundary, without changing runtime parser, record format or persistence. **#773** adds the pinned RC3 cross-copy compiler guard. / 修复两个 Zod 副本的静态类型不兼容,保持运行时解析与持久化语义不变;新增固定 RC3 混合 Zod 编译回归。
21
+ - **#770:** Qualify DSH 0.2.1-rc.5 exact source at b830ec950faba0a46dda564be3e2d854afed94f1, with Windows Node 22/24 Desktop, macOS/Linux, real Host + Chromium and reasoning Body Slot display behavior. / 验证 RC5 精确源码、三端真实 Host、Windows Node 22/24、浏览器以及推理内容显示逻辑。
22
+ - **#767, #765, #766:** Improve alpha Host executor acceptance and update pinned CI security actions. / 修正 Alpha Host 执行器验收并更新固定版本的 CI 安全 Action。
23
+
24
+ ## Compatibility and limits / 兼容与限制
25
+
26
+ - Supported Node remains ^22.19.0 or >=24.0.0. DSH remains >=0.1.5-rc.1 <0.2.0-0 or >=0.2.0-rc.2 <0.3.0-0. No new Host privileges, Settings migration, Session format change or breaking public API. / 保持既有 Node、DSH 支持窗口,不新增 Host 权限、配置迁移、Session 格式变化或破坏性公开 API。
27
+ - **#759** was closed as not-planned due to missing distinguishing evidence from the reported Windows 34-bundle environment; this release does not claim it was fixed. Reopen if a Vision-ON Agent demonstrably cannot see its authorized tool. / #759 因原始 Windows 34-bundle 故障缺少关键判别证据而归档,不代表修复;如可确认 Vision 开启的 Agent 仍无法调用授权工具,应重新开启。
28
+
29
+ ## Release verification / 发布验收
30
+
31
+ - The upstream source baseline main@de9b0eda passed 33/33 current-head checks as verified on 2026-10-31, including the exact RC5 Host lane. Candidate-head normal CI, artifact reproducibility, npm packed API, immutable tag and trusted publishing provenance must pass separately. / 源码基线 main@de9b0eda 通过了当次 33/33 检查,包含 RC5 真实 Host;仍须单独通过候选分支 CI、包体可复现性、公共 API、不可变标签和可信发布来源证明。
@@ -0,0 +1,25 @@
1
+ # v3.1.2 — Plugin identity and DSH compatibility / 插件图标与 DSH 兼容修正版
2
+
3
+ **Candidate release notes.** Publication is complete only after the protected release workflow verifies the exact main commit, immutable tag, npm provenance and GitHub Release artifacts. / **候选版说明:** 只有受保护发布工作流完成精确 main 提交、不可变标签、npm 来源证明与 GitHub Release 附件验收后,才算正式发布。
4
+
5
+ ## Native Vision Router icons / 原生插件图标
6
+
7
+ - **#783:** Ship a compact eye icon in the npm package for DSH Desktop Plugin Manager. Register the same artwork on the Vision Router Settings navigation through the lifecycle-owned native icon slot. The real DSH 0.2.2-alpha.3 Chromium Settings test verified visible, decoded artwork. / 随 npm 包发布眼睛图标,供 DSH Desktop 插件管理页使用;在支持原生设置图标插槽的 Host 中显示相同图标。Alpha.3 真实 Chromium 验证图标可见且成功解码。
8
+ - **Host distinction:** DSH 0.2.1-rc.5 supports the package Plugin Manager artwork, but has no Settings navigation icon slot; it correctly keeps the default Settings glyph. The Settings icon slot is verified on DSH 0.2.2-alpha.3. This release does not patch unsupported Host internals. / **上游边界:** RC.5 支持插件管理页图标,但没有设置导航图标插槽,因此设置导航仍使用默认图标。新插槽已在 Alpha.3 验证,不通过修改上游内部实现来绕过限制。
9
+
10
+ ## Upstream Alpha compatibility / 上游 Alpha 适配
11
+
12
+ - **#780:** Align inherited image-dimension normalization with Alpha.2's 8192-to-65535 default while retaining user-customized limits. / 适配 Alpha.2 的默认图片尺寸变化,保留自定义限制。
13
+ - **#781:** Accept the WebServer additive resource-route union in exact-source assertions while retaining route ownership and disposal guarantees. / 接受 WebServer 新增资源路由联合类型,保持原有注册、释放契约。
14
+ - **#779, #782:** Pin reviewed Alpha.2, then Alpha.3 immutable source for the real Host CI; Alpha.3 passed six Host jobs spanning Windows/macOS/Linux exact-source, Windows Node 22/24 Desktop and real Chromium Settings lifecycle. No additional Cordis runtime shim was established as necessary by the tested paths. / 分阶段固定 Alpha.2、Alpha.3 精确源码;Alpha.3 的三端、Node22/24 Desktop 和真实浏览器六项验证通过。在已测试调用路径内未发现需新增 Cordis 运行时补丁的确定证据。
15
+
16
+ ## Security and other Host plugins / 安全及其他 Host 插件兼容
17
+
18
+ - **#775:** Resolve the follow-redirects credential redirect advisory. / 修复 follow-redirects 凭据重定向安全告警。
19
+ - **#777:** Preserve the child handle of promisified execFile for non-OCR Host plugins. / 保留非 OCR Host 插件的 promisified execFile.child 句柄语义。
20
+ - **#778:** Move the Alpha pin out of workflow source into ordinary config JSON and correct workflow output propagation, without expanding Bot permissions. Automatic PR creation still awaits a real future update exercise. / 将 Alpha Pin 移至普通 JSON 配置文件,修复输出传值,不扩大 Bot 权限;自动创建 PR 仍待未来真实更新触发验证。
21
+
22
+ ## Support and release checks / 支持边界与发布验收
23
+
24
+ - Public Node range remains ^22.19.0 or >=24.0.0; DSH remains >=0.1.5-rc.1 <0.2.0-0 or >=0.2.0-rc.2 <0.3.0-0. No Session migration, broad remote authority change, or breaking API change. / Node 和 DSH 最低支持版本、Session、远程权限及公共 API 边界不变。
25
+ - **#783** passed 26/26 current-head PR workflows, including the 6/6 Alpha.3 Host jobs, 3 mandatory checks, and older Host/RC regressions. The **v3.1.2 candidate** must separately pass release-commit CI, deterministic pack, registry uniqueness and protected npm/GitHub publication checks. / #783 的 26 项 PR 工作流、6 项 Alpha.3 真实 Host 及旧版兼容检查全绿;v3.1.2 候选提交仍须单独验收正式 CI、可复现包体、npm 唯一版本与受保护发布流程。
package/lib/client.js CHANGED
@@ -12,6 +12,10 @@ window.__ModuleLoader__.load({
12
12
  const { useState, useMemo } = React
13
13
  const { ImageGallery } = require('@deepseek-ai/dsh-client-ui-attachment')
14
14
 
15
+ // Same packaged artwork used by DSH Plugin Manager; a data URL works in Desktop and remote Web.
16
+ const VISION_ROUTER_ICON_SVG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 64 64\"><defs><linearGradient id=\"vr-brand\" x1=\"0\" y1=\"0\" x2=\"1\" y2=\"1\"><stop offset=\"0\" stop-color=\"#6E58F7\"/><stop offset=\"1\" stop-color=\"#179ED6\"/></linearGradient></defs><rect width=\"64\" height=\"64\" rx=\"15\" fill=\"url(#vr-brand)\"/><path d=\"M10 32C17 22 24 17 32 17S47 22 54 32C47 42 40 47 32 47S17 42 10 32Z\" fill=\"none\" stroke=\"#FFFFFF\" stroke-width=\"4\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/><circle cx=\"32\" cy=\"32\" r=\"10\" fill=\"#FFFFFF\"/><circle cx=\"32\" cy=\"32\" r=\"5.5\" fill=\"#283C89\"/><circle cx=\"35\" cy=\"29\" r=\"2.2\" fill=\"#A8F2FF\"/></svg>"
17
+ const VISION_ROUTER_ICON_SRC = 'data:image/svg+xml,' + encodeURIComponent(VISION_ROUTER_ICON_SVG)
18
+
15
19
  // <generated:client-maintenance-actions>
16
20
  function createClientMaintenanceActions({
17
21
  fetchImpl,
@@ -1932,18 +1936,7 @@ openLogFolder,
1932
1936
  }
1933
1937
  }
1934
1938
 
1935
- // ── walkthrough spotlight: highlight the real UI targets ────────────────
1936
- // The walkthrough overlays are plain DOM: a dimmed backdrop with a "hole"
1937
- // over the current target (classic box-shadow spotlight), a pulsing ring
1938
- // around it, and the prompt card anchored beside the target with an arrow
1939
- // pointing at it. Everything is pointer-events:none except the prompt, so
1940
- // the real controls stay clickable the whole time.
1941
- //
1942
- // DSH web hashes its CSS-module class names (unstable across builds), so
1943
- // the targets are addressed through the stable surface instead: slot
1944
- // wrappers (data-slot), data-composer-card and aria-haspopup/aria-label
1945
- // attributes. Each step keeps a fallback chain, and when nothing matches
1946
- // the prompt degrades to a corner card with a directional arrow.
1939
+ // Details: docs/architecture/client-ui-lifecycle-notes.md (Walkthrough spotlight geometry).
1947
1940
  const GUIDE_SELECTOR_TARGETS = [
1948
1941
  '[data-slot="conversation.input.model"] button[aria-haspopup="menu"]',
1949
1942
  '[aria-label^="选择模型"], [aria-label^="Select model"]',
@@ -2163,12 +2156,7 @@ openLogFolder,
2163
2156
  finishVisionSettingsGuide({ remember: true })
2164
2157
  })
2165
2158
  actions.append(cancel)
2166
- // Every step that is not the last one gets a Next button, so the two
2167
- // floating prompts stay symmetric. Step 1's Next advances the stored
2168
- // step; step 2's Next performs the current phase's action for the
2169
- // user — opening the settings panel, then entering the Vision Router
2170
- // section — so the walkthrough can be driven entirely from the prompt
2171
- // without touching the real controls.
2159
+ // Details: docs/architecture/client-ui-lifecycle-notes.md (Onboarding step controls).
2172
2160
  const next = document.createElement('button')
2173
2161
  next.type = 'button'
2174
2162
  next.className = 'vr-btn vr-btn-save'
@@ -3820,11 +3808,7 @@ openLogFolder,
3820
3808
  const raw = 'extraVisionModels' in drafts
3821
3809
  ? drafts['extraVisionModels']
3822
3810
  : readValue(snapshot, 'extraVisionModels')
3823
- // Rows persist as { provider, model } objects while editing — an
3824
- // incomplete row (provider picked, model pending) stays visible
3825
- // instead of collapsing, which is what made the provider dropdown
3826
- // feel unselectable before. Like the vision backend chain above, an
3827
- // empty configuration still renders one blank row ready to fill.
3811
+ // Details: docs/architecture/client-ui-lifecycle-notes.md (Provider-model draft rows).
3828
3812
  const rows = (Array.isArray(raw) && raw.length > 0 ? raw : [{ provider: '', model: '' }]).map(
3829
3813
  (entry) => {
3830
3814
  if (entry && typeof entry === 'object') {
@@ -3840,12 +3824,7 @@ openLogFolder,
3840
3824
  : { provider: text.slice(0, slash), model: text.slice(slash + 1) }
3841
3825
  },
3842
3826
  )
3843
- // Same two-select row shape as the vision backend chain above: a
3844
- // provider dropdown (providers that have excluded models) and a model
3845
- // dropdown (that provider's excluded models). A row the user already
3846
- // selected elsewhere stays disabled in the other rows. Option sets
3847
- // come from the memoized top-level hooks (this function is plain
3848
- // render code and must stay hook-free).
3827
+ // Details: docs/architecture/client-ui-lifecycle-notes.md (Two-select routing row).
3849
3828
  const hiddenProviders = hiddenVisionProviders
3850
3829
  const hiddenModelsOf = hiddenVisionModelsOf
3851
3830
  const used = new Set(
@@ -4021,12 +4000,7 @@ openLogFolder,
4021
4000
  )
4022
4001
  }
4023
4002
 
4024
- // Render-phase kick: whenever the body is open and the catalog was never
4025
- // fetched (including after a remount that reset the state), start the
4026
- // fetch. React supports setState during render for the same component,
4027
- // and the status flips to 'loading' so this cannot loop. The same kick
4028
- // runs the cheap test-connection probe once so the Host-owned official
4029
- // provider availability notice can render without a button click.
4003
+ // Details: docs/architecture/client-ui-lifecycle-notes.md (Catalog render-phase bootstrap).
4030
4004
  if (open && catalog.status === 'idle') {
4031
4005
  loadCatalog()
4032
4006
  }
@@ -4232,11 +4206,7 @@ openLogFolder,
4232
4206
  h('div', { className: 'vr-quickstart-actions' },
4233
4207
  h('button', {
4234
4208
  type: 'button', className: 'vr-btn',
4235
- // Re-viewing the guide replays it from the beginning:
4236
- // leave the settings modal first (its panel closes on
4237
- // Escape), show the overview (steps 1-3), and then walk
4238
- // through step 1 on the chat page — starting in place
4239
- // would skip the session/text-model step entirely.
4209
+ // Details: docs/architecture/client-ui-lifecycle-notes.md (Onboarding replay).
4240
4210
  onClick: () => {
4241
4211
  guideHostUi.closeSettings()
4242
4212
  const reveal = () => showOnboarding(t, { auto: false, focus: true })
@@ -4885,6 +4855,16 @@ openLogFolder,
4885
4855
  // Vision Router owns one canonical settings surface. The section switches
4886
4856
  // to the opt-in remote scope on a non-loopback client.
4887
4857
  const sectionCardInject = Object.freeze({ ...cardInject, scope: primaryScope, surface: 'section' })
4858
+ const VisionRouterSettingsIcon = ({ size }) =>
4859
+ React.createElement('img', {
4860
+ src: VISION_ROUTER_ICON_SRC,
4861
+ alt: '',
4862
+ 'aria-hidden': 'true',
4863
+ draggable: false,
4864
+ width: size,
4865
+ height: size,
4866
+ style: { display: 'block', width: size, height: size },
4867
+ })
4888
4868
  const VisionRouterSettingsSection = (sectionProps) =>
4889
4869
  React.createElement(
4890
4870
  'ul',
@@ -4907,6 +4887,18 @@ openLogFolder,
4907
4887
  }),
4908
4888
  'vision-router: primary settings section',
4909
4889
  )
4890
+ // Native Settings navigation icon (newer Hosts); old Hosts simply do not render this slot.
4891
+ // The effect owns the registration, so DSH restores the default icon on plugin unload.
4892
+ ctx.effect(
4893
+ () =>
4894
+ ctx.slots.inject('settings.section.icon', function* () {
4895
+ yield ctx.slots.register(
4896
+ { name: 'settings.section.icon', id: 'vision-router' },
4897
+ VisionRouterSettingsIcon,
4898
+ )
4899
+ }),
4900
+ 'vision-router: settings navigation icon',
4901
+ )
4910
4902
  ctx.effect(
4911
4903
  () =>
4912
4904
  ctx.slots.inject('tool.call.toolview', function* () {
@@ -21,6 +21,9 @@ const LEGACY_VISION_ATTACHMENT_BYTES = 20 * 1024 * 1024
21
21
  const LEGACY_VISION_ATTACHMENT_PIXELS = 100_000_000
22
22
  const DSH_RC8_DEFAULT_IMAGE_DIMENSION = 2000
23
23
  const DSH_ALPHA_DEFAULT_IMAGE_DIMENSION = 8192
24
+ // DSH 0.2.2-alpha.2 expands the Host admission default, while retaining the
25
+ // 4.2MP/8192px/4MiB normalization tuple of earlier alphas.
26
+ const DSH_ALPHA_022_DEFAULT_IMAGE_DIMENSION = 65_535
24
27
  const VISION_ROUTER_IMAGE_DIMENSION = 10_000
25
28
  const DSH_ALPHA_DEFAULT_NORMALIZED_PIXELS = 2048 * 2048
26
29
  const DSH_ALPHA_DEFAULT_NORMALIZED_DIMENSION = 8192
@@ -135,6 +138,11 @@ function exactAlphaNormalizationDefaults(policy) {
135
138
  policy.maxBytes === DSH_ALPHA_DEFAULT_NORMALIZED_BYTES
136
139
  }
137
140
 
141
+ function knownAlphaDefaultImageDimension(dimension) {
142
+ return dimension === DSH_ALPHA_DEFAULT_IMAGE_DIMENSION ||
143
+ dimension === DSH_ALPHA_022_DEFAULT_IMAGE_DIMENSION
144
+ }
145
+
138
146
  function knownVisionRouterAdmissionShape(limits) {
139
147
  if (!limits || typeof limits !== 'object') return false
140
148
  if (
@@ -142,7 +150,7 @@ function knownVisionRouterAdmissionShape(limits) {
142
150
  limits.maxImagePixels !== LEGACY_VISION_ATTACHMENT_PIXELS
143
151
  ) return false
144
152
  return limits.maxImageDimension === DSH_RC8_DEFAULT_IMAGE_DIMENSION ||
145
- limits.maxImageDimension === DSH_ALPHA_DEFAULT_IMAGE_DIMENSION
153
+ knownAlphaDefaultImageDimension(limits.maxImageDimension)
146
154
  }
147
155
 
148
156
  function replaceFrozenPolicy(store, property, next) {
@@ -163,8 +171,8 @@ function replaceFrozenPolicy(store, property, next) {
163
171
  * containing only the released 20MiB / 100MP admission pair. On rc.8 that
164
172
  * shadowed the later 10000px bundle value and rematerialized the Host's 2000px
165
173
  * default. On 0.1.2-alpha.1 the same stale row additionally omits the new
166
- * normalization fields, rematerializing 8192px admission plus the Host's
167
- * 4.2MP / 4MiB canonical-image defaults.
174
+ * normalization fields, rematerializing 8192px admission (or 65535px on
175
+ * 0.2.2-alpha.2) plus the Host's 4.2MP / 4MiB canonical-image defaults.
168
176
  *
169
177
  * This migration never edits a user's profile file and never creates another
170
178
  * attachment owner. LocalAttachmentStore exposes the resolved immutable
@@ -173,7 +181,8 @@ function replaceFrozenPolicy(store, property, next) {
173
181
  * objects on one exact historical fingerprint:
174
182
  *
175
183
  * - admission bytes === 20MiB and pixels === 100MP; and
176
- * - dimension is rc.8's 2000px default or alpha's 8192px default; and
184
+ * - dimension is rc.8's 2000px or one of the known alpha Host defaults
185
+ * (8192px or 65535px); and
177
186
  * - normalization, when repaired, is EXACTLY alpha.1's 4.2MP/8192px/4MiB
178
187
  * default tuple.
179
188
  *
@@ -206,7 +215,7 @@ export function ensureVisionAttachmentAdmissionPolicy(ctx, logger, options = {})
206
215
  }
207
216
 
208
217
  const repairNormalization =
209
- limits.maxImageDimension === DSH_ALPHA_DEFAULT_IMAGE_DIMENSION &&
218
+ knownAlphaDefaultImageDimension(limits.maxImageDimension) &&
210
219
  exactAlphaNormalizationDefaults(store.normalizationPolicy)
211
220
  const repairDimension =
212
221
  limits.maxImageDimension === DSH_RC8_DEFAULT_IMAGE_DIMENSION ||
@@ -444,6 +444,9 @@ function applyMatureCoreBridge(host, owners, routing, execution, core, runtime)
444
444
  const installPostCoreRuntime = () => {
445
445
  installVisionMaintenanceRoutes(coreRequestAuthorityCtx, { logger: logging.logger })
446
446
  finishSchemaBootstrapOnce()
447
+ // Core has now registered its tools. Restore masks for existing Agents
448
+ // before any new presentation can observe this HMR generation.
449
+ sessionVisionModeCompat.reconcileExistingAgents()
447
450
  installWrapperDirectoryAlias(attachmentCompatCtx, runtimeConfig, logging.logger)
448
451
  }
449
452
  const failCoreApply = (error) => {
@@ -85,7 +85,7 @@ function restrictableOwnedVisionToolNames(tools, owned) {
85
85
  return active
86
86
  }
87
87
 
88
- function assemblyOwnedVisionToolNames(registryTools, scopedTools, owned) {
88
+ function assemblyOwnedVisionToolNames(registryTools, scopedTools, owned, agent) {
89
89
  const active = restrictableOwnedVisionToolNames(registryTools, owned)
90
90
  const scopedGet = scopedTools?.get
91
91
  if (typeof scopedGet !== 'function') return new Set(active)
@@ -93,7 +93,10 @@ function assemblyOwnedVisionToolNames(registryTools, scopedTools, owned) {
93
93
  const projected = new Set()
94
94
  for (const name of active) {
95
95
  try {
96
- const visible = scopedGet.call(scopedTools, name)
96
+ // DSH RC3 get(name, scope) defaults to the *global* view, even when
97
+ // accessed through agent.ctx.tools. Supply the actual Agent to preserve
98
+ // foreign Agent-scoped shadows of DVR global tool names.
99
+ const visible = scopedGet.call(scopedTools, name, agent)
97
100
  // A foreign Agent-scoped definition is allowed to shadow DVR's global
98
101
  // name. DSH restrictions deliberately leave scoped registrations visible,
99
102
  // so the final assembly projection must preserve the same boundary.
@@ -439,7 +442,7 @@ export function installSessionVisionModeBoundary(ctx, config = {}, runtime = {})
439
442
  const transformed = typeof next === 'function' ? await next() : assembly
440
443
  const projectedOwned =
441
444
  ctx?.tools
442
- ? assemblyOwnedVisionToolNames(ctx.tools, agent?.ctx?.tools, ownedVisionTools)
445
+ ? assemblyOwnedVisionToolNames(ctx.tools, agent?.ctx?.tools, ownedVisionTools, agent)
443
446
  : ownedVisionTools
444
447
  return projectAssemblyTools(
445
448
  transformed,
@@ -559,5 +562,28 @@ export function installSessionVisionModeBoundary(ctx, config = {}, runtime = {})
559
562
  },
560
563
  })
561
564
 
562
- return { ctx: wrapped, config }
565
+ // After HMR the old plugin generation releases its Agent-scoped masks.
566
+ // Reconcile agents that were already alive before this generation mounted:
567
+ // otherwise their OFF scopes see newly registered global DVR schemas until
568
+ // the next agent/status or prompt-assembly event.
569
+ const reconcileExistingAgents = () => {
570
+ let agents
571
+ try {
572
+ const registry = ctx.get?.('agents')
573
+ agents = typeof registry?.list === 'function' ? registry.list() : undefined
574
+ } catch {
575
+ return
576
+ }
577
+ if (!Array.isArray(agents)) return
578
+ for (const agent of agents) {
579
+ try {
580
+ syncForAgent(agent)
581
+ } catch {
582
+ // Older Hosts may not expose the same Agent registry seams. Keep the
583
+ // execution guard and ordinary per-step synchronization authoritative.
584
+ }
585
+ }
586
+ }
587
+
588
+ return { ctx: wrapped, config, reconcileExistingAgents }
563
589
  }
@@ -48,23 +48,29 @@ function isTesseractCompatCall(file, args, options) {
48
48
 
49
49
  function nativePromisified(execFileImpl, originalCustom) {
50
50
  if (typeof originalCustom === 'function') return originalCustom
51
- return (file, args, options) => new Promise((resolve, reject) => {
52
- execFileImpl(file, args, options, (error, stdout, stderr) => {
53
- if (error) {
54
- if (error && typeof error === 'object') {
55
- try {
56
- error.stdout = stdout
57
- error.stderr = stderr
58
- } catch {
59
- /* preserve the original error */
51
+ return (file, args, options) => {
52
+ let child
53
+ const pending = new Promise((resolve, reject) => {
54
+ child = execFileImpl(file, args, options, (error, stdout, stderr) => {
55
+ if (error) {
56
+ if (error && typeof error === 'object') {
57
+ try {
58
+ error.stdout = stdout
59
+ error.stderr = stderr
60
+ } catch {
61
+ /* preserve the original error */
62
+ }
60
63
  }
64
+ reject(error)
65
+ return
61
66
  }
62
- reject(error)
63
- return
64
- }
65
- resolve({ stdout, stderr })
67
+ resolve({ stdout, stderr })
68
+ })
66
69
  })
67
- })
70
+ // Match Node's promisified execFile contract even without a custom hook.
71
+ pending.child = child
72
+ return pending
73
+ }
68
74
  }
69
75
 
70
76
  /**
@@ -97,11 +103,16 @@ export function createTesseractPromisifyCompat(execFileImpl, originalCustom, opt
97
103
  return resolvedTempDir
98
104
  }
99
105
 
100
- async function tesseractPromisifyCompat(file, args, execOptions) {
106
+ function tesseractPromisifyCompat(file, args, execOptions) {
101
107
  if (!active || !isTesseractCompatCall(file, args, execOptions)) {
108
+ // Return the native Promise itself: async wrappers discard .child.
102
109
  return delegate(file, args, execOptions)
103
110
  }
111
+ return runTesseractCompat(file, args, execOptions)
112
+ }
104
113
 
114
+ // Staging stdin bytes is asynchronous; only this OCR-specific path is async.
115
+ async function runTesseractCompat(file, args, execOptions) {
105
116
  const bytes = bytesView(execOptions.input)
106
117
  let dir
107
118
  try {
@@ -77,6 +77,10 @@ export function isImageInputUnsupportedFailure(failure) {
77
77
  'i',
78
78
  ),
79
79
  new RegExp(`cannot (?:accept|process|handle) (?:images?|image inputs?)${terminal}`, 'i'),
80
+ // Explicit text-only model/endpoint rejections can omit the word "image".
81
+ // Keep these end-bounded so unrelated modality or size errors do not retry.
82
+ new RegExp(`(?:model|endpoint)\\s+is\\s+not\\s+(?:a\\s+)?multimodal(?:\\s+model)?${terminal}`, 'i'),
83
+ new RegExp(`not\\s+(?:a\\s+)?multimodal\\s+(?:model|endpoint)${terminal}`, 'i'),
80
84
  new RegExp(`(?:model|adapter).*text[- ]only.*(?:images?|image inputs?)${terminal}`, 'i'),
81
85
  new RegExp(`(?:模型|适配器).*不支持(?:图片|图像)(?:输入)?${terminal}`),
82
86
  new RegExp(`(?:图片|图像)输入(?:不被支持|暂不支持|不支持)${terminal}`),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-vision-router",
3
- "version": "3.1.0",
3
+ "version": "3.1.2",
4
4
  "description": "Eyes for text-only DeepSeek Harness agents: built-in free vision chain + pixel-level tools. Remote vision providers, including the default free fallback, receive image content unless strict local-only use is configured.",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -10,6 +10,7 @@
10
10
  "homepage": "https://github.com/ysr666/dsh-vision-router",
11
11
  "type": "module",
12
12
  "main": "lib/public-entry.js",
13
+ "icon": "./assets/icon.svg",
13
14
  "bin": {
14
15
  "dsh-vision-router": "./lib/doctor-cli-p0.js"
15
16
  },
@@ -19,6 +20,7 @@
19
20
  "default": "./lib/public-entry.js"
20
21
  },
21
22
  "./client": "./lib/client.js",
23
+ "./icon": "./assets/icon.svg",
22
24
  "./package.json": "./package.json",
23
25
  "./cordis.patch.yml": "./cordis.patch.yml"
24
26
  },
@@ -90,14 +92,14 @@
90
92
  "@deepseek-ai/dsh-storage-domain": "0.2.0-rc.2"
91
93
  },
92
94
  "scripts": {
93
- "test": "node --test tests/optional-peer-import-contract.test.js tests/index-modularization.test.js tests/adapter-prepare-call-compat.test.js tests/core.test.js tests/issue-374-delegated-call-config.test.js tests/grounding-coordinate-frame.test.js tests/grounding-coordinate-runtime.test.js tests/capability-advisory.test.js tests/vision-execution-policy.test.js tests/vision-backend-diagnostics.test.js tests/live-model-discovery.test.js tests/cache-atomic-write-concurrency.test.js tests/live-model-credential-resolution.test.js tests/vision-model-registry.test.js tests/live-model-client-stability.test.js tests/providers-persistence.test.js tests/provider-directory-fallback.test.js tests/model-catalog-policy.test.js tests/settings-ia-client-prelude.test.js tests/settings-ia-fj.test.js tests/settings-ia-acceptance-regression.test.js tests/settings-migration.test.js tests/settings-section-order.test.js tests/attachment-admission-policy.test.js tests/vision-resilience.test.js tests/degraded-local-evidence.test.js tests/vision-resilience-lifecycle.test.js tests/vision-breaker-readonly.test.js tests/alpha1-browser-lifecycle-integration.test.js tests/issue-367-remote-session-inject.test.js tests/vision-mode-toggle-injection.test.js tests/dev-staged-build.test.js tests/dev-web-reload.test.js tests/client.test.js tests/issue-307-regression.test.js tests/issue-284-vision-mode-toggle.test.js tests/issue-284-vision-mode-hardening.test.js tests/issue-284-attachment-id-hint.test.js tests/issue-284-model-visibility.test.js tests/issue-284-vision-selection-effort.test.js tests/client-presentation-boundary.test.js tests/clipboard-image-paste-compat.test.js tests/remote-settings-bridge.test.js tests/remote-settings-v2-contract.test.js tests/remote-settings-risk-confirmation.test.js tests/local-remote-settings-permission.test.js tests/artifact-path-security.test.js tests/http-compat.test.js tests/catalog-corrections.test.js tests/release-registry-identity.test.js tests/update-check.test.js tests/update-check-signal-lifecycle.test.js tests/self-update.test.js tests/doctor.test.js tests/doctor-cli.test.js tests/legacy-session-repair.test.js tests/profile-pnpm-diagnostics.test.js tests/doctor-v2.test.js tests/doctor-cli-v2.test.js tests/doctor-runtime.test.js tests/dsh-host-capabilities.test.js tests/doctor-host-capabilities.test.js tests/session-repair-v2.test.js tests/activation-shim-contract.test.js tests/bundle-defaults.test.js tests/file-logger.test.js tests/official-deepseek-catalog.test.js tests/replay-delegation.test.js tests/twin-image-capability-fallback.test.js tests/twin-image-custom-wrapper.test.js tests/adversarial-hardening.test.js tests/vision-adversarial-hardening-v2.test.js tests/vision-capability-benchmark-visual-proof.test.js tests/wrapper-directory.test.js tests/logging-ui.test.js tests/manifest-dependencies.test.js tests/provider-transport-threading.test.js tests/architecture-2.3-gate.test.js tests/host-settings-seam.test.js tests/drift-canary-settings-seam.test.js tests/esm-cycle-audit.test.js tests/structured-bootstrap.test.js tests/structured-bootstrap-gate.test.js tests/vision-model-guidance-contract.test.js tests/local-ollama.test.js tests/local-only-vision.test.js tests/ollama-cold-start.test.js tests/ollama-cold-start-loaded.test.js tests/zero-regression-gate.test.js tests/runtime-e2e.test.js tests/local-vision-stabilizer.test.js tests/local-connection-probe.test.js tests/vision-diagnostics-routes.test.js tests/repetition-guard.test.js tests/guide-scroll-gate.test.js tests/settings-scroll-jank-regression.test.js tests/free-cloud-first.test.js tests/dsh-host-compat.test.js tests/native-image-coexistence.test.js tests/issue-276-session-image-ownership.test.js tests/issue-276-entry-policy-bridge.test.js tests/issue-276-policy-hardening.test.js tests/issue-289-native-nonintervention.test.js tests/issue-512-tool-restriction.test.js tests/issue-606-session-source-ownership.test.js tests/pi-ai-bridge-wire-compat.test.js tests/fetch-wrapper-lifecycle.test.js tests/fetch-wrapper-composition.test.js tests/provider-probe-proxy-scope.test.js tests/lifecycle-invariants.test.js tests/vision-tool-settings-generation.test.js tests/release-package-content-identity.test.js tests/release-state-machine.test.js tests/mixed-router.test.js tests/depth-tier.test.js tests/depth-quota-behavior.test.js tests/structured-flow-hardening.test.js tests/structured-flow-adversarial.test.js tests/vision-budget-activation.test.js tests/runtime-boundary-fixes.test.js tests/security-resource-boundaries.test.js tests/security-property-fuzz.test.js tests/security-adversarial-fuzz-contract.test.js tests/runtime-i18n.test.js tests/long-ocr-empty-retry.test.js tests/tesseract-adaptive-ocr.test.js tests/tesseract-node24-boot.test.js tests/session-vision-state.test.js tests/session-vision-state-integration.test.js tests/session-vision-event-feed.test.js tests/session-vision-policy.test.js tests/session-vision-policy-domain.test.js tests/session-vision-delegation.test.js tests/session-vision-delegation-boundary.test.js tests/subagent-vision-inheritance-characterization.test.js tests/subagent-vision-runtime-integration.test.js tests/subagent-vision-cold-resume.test.js tests/image-resource-governor.test.js tests/resource-retention-lifecycle.test.js tests/pixel-diff-stream.test.js tests/large-image-resource-integration.test.js tests/structured-guard-idempotency.test.js tests/vision-routing-product.test.js tests/vision-runtime-performance.test.js tests/vision-routing-settings-prelude.test.js tests/v2-settings-ia-integration.test.js tests/vision-capability-router.test.js tests/vision-capability-reference.test.js tests/vision-capability-benchmark.test.js tests/vision-capability-grounding-proof-contract.test.js tests/vision-capability-probe.test.js tests/vision-capability-axis-freshness.test.js tests/vision-capability-shadow-health.test.js tests/vision-capability-benchmark-service.test.js tests/vision-capability-preflight-hardening.test.js tests/vision-capability-benchmark-contract.test.js tests/vision-capability-benchmark-client.test.js tests/vision-capability-benchmark-client-productization.test.js tests/vision-capability-adapter-route.test.js tests/vision-background-benchmark.test.js tests/vision-background-lifecycle.test.js tests/vision-background-benchmark-productization.test.js tests/vision-capability-benchmark-budget.test.js tests/vision-image-input-verdict.test.js tests/vision-capability-failure-classification.test.js tests/vision-capability-gate-client.test.js tests/v2-product-review-fixes.test.js tests/qa-top5-reliability.test.js tests/qa-screenshot-runtime.test.js tests/qa-runtime-identity.test.js tests/qa-turn-budget-cancellation.test.js tests/qa-cancellation-publication.test.js tests/qa-reliability-tail.test.js tests/qa-endpoint-route-alias.test.js tests/settings-native-card-semantics.test.js tests/settings-native-card-lazy-data.test.js tests/settings-invalid-staged-dirty.test.js tests/vision-toggle-root-hardening.test.js && pnpm test:regression-closure && node --test tests/vision-backend-runtime-policy.test.js tests/vision-router-adversarial-review-fixes.test.js tests/web-panel-delegation.test.js",
95
+ "test": "node --test tests/dsh-alpha-pin.test.js tests/native-plugin-icons.test.js tests/optional-peer-import-contract.test.js tests/index-modularization.test.js tests/adapter-prepare-call-compat.test.js tests/core.test.js tests/issue-374-delegated-call-config.test.js tests/grounding-coordinate-frame.test.js tests/grounding-coordinate-runtime.test.js tests/capability-advisory.test.js tests/vision-execution-policy.test.js tests/vision-backend-diagnostics.test.js tests/live-model-discovery.test.js tests/cache-atomic-write-concurrency.test.js tests/live-model-credential-resolution.test.js tests/vision-model-registry.test.js tests/live-model-client-stability.test.js tests/providers-persistence.test.js tests/provider-directory-fallback.test.js tests/model-catalog-policy.test.js tests/settings-ia-client-prelude.test.js tests/settings-ia-fj.test.js tests/settings-ia-acceptance-regression.test.js tests/settings-migration.test.js tests/settings-section-order.test.js tests/attachment-admission-policy.test.js tests/vision-resilience.test.js tests/degraded-local-evidence.test.js tests/vision-resilience-lifecycle.test.js tests/vision-breaker-readonly.test.js tests/alpha1-browser-lifecycle-integration.test.js tests/issue-367-remote-session-inject.test.js tests/vision-mode-toggle-injection.test.js tests/dev-staged-build.test.js tests/dev-web-reload.test.js tests/client.test.js tests/issue-307-regression.test.js tests/issue-284-vision-mode-toggle.test.js tests/issue-284-vision-mode-hardening.test.js tests/issue-284-attachment-id-hint.test.js tests/issue-284-model-visibility.test.js tests/issue-284-vision-selection-effort.test.js tests/client-presentation-boundary.test.js tests/clipboard-image-paste-compat.test.js tests/remote-settings-bridge.test.js tests/remote-settings-v2-contract.test.js tests/remote-settings-risk-confirmation.test.js tests/local-remote-settings-permission.test.js tests/artifact-path-security.test.js tests/http-compat.test.js tests/catalog-corrections.test.js tests/release-registry-identity.test.js tests/update-check.test.js tests/update-check-signal-lifecycle.test.js tests/self-update.test.js tests/doctor.test.js tests/doctor-cli.test.js tests/legacy-session-repair.test.js tests/profile-pnpm-diagnostics.test.js tests/doctor-v2.test.js tests/doctor-cli-v2.test.js tests/doctor-runtime.test.js tests/dsh-host-capabilities.test.js tests/doctor-host-capabilities.test.js tests/session-repair-v2.test.js tests/activation-shim-contract.test.js tests/bundle-defaults.test.js tests/file-logger.test.js tests/official-deepseek-catalog.test.js tests/replay-delegation.test.js tests/twin-image-capability-fallback.test.js tests/twin-image-custom-wrapper.test.js tests/adversarial-hardening.test.js tests/vision-adversarial-hardening-v2.test.js tests/vision-capability-benchmark-visual-proof.test.js tests/wrapper-directory.test.js tests/logging-ui.test.js tests/manifest-dependencies.test.js tests/provider-transport-threading.test.js tests/architecture-2.3-gate.test.js tests/host-settings-seam.test.js tests/drift-canary-settings-seam.test.js tests/esm-cycle-audit.test.js tests/structured-bootstrap.test.js tests/structured-bootstrap-gate.test.js tests/vision-model-guidance-contract.test.js tests/local-ollama.test.js tests/local-only-vision.test.js tests/ollama-cold-start.test.js tests/ollama-cold-start-loaded.test.js tests/zero-regression-gate.test.js tests/runtime-e2e.test.js tests/local-vision-stabilizer.test.js tests/local-connection-probe.test.js tests/vision-diagnostics-routes.test.js tests/repetition-guard.test.js tests/guide-scroll-gate.test.js tests/settings-scroll-jank-regression.test.js tests/free-cloud-first.test.js tests/dsh-host-compat.test.js tests/native-image-coexistence.test.js tests/issue-276-session-image-ownership.test.js tests/issue-276-entry-policy-bridge.test.js tests/issue-276-policy-hardening.test.js tests/issue-289-native-nonintervention.test.js tests/issue-512-tool-restriction.test.js tests/issue-606-session-source-ownership.test.js tests/pi-ai-bridge-wire-compat.test.js tests/fetch-wrapper-lifecycle.test.js tests/fetch-wrapper-composition.test.js tests/provider-probe-proxy-scope.test.js tests/lifecycle-invariants.test.js tests/vision-tool-settings-generation.test.js tests/release-package-content-identity.test.js tests/release-state-machine.test.js tests/mixed-router.test.js tests/depth-tier.test.js tests/depth-quota-behavior.test.js tests/structured-flow-hardening.test.js tests/structured-flow-adversarial.test.js tests/vision-budget-activation.test.js tests/runtime-boundary-fixes.test.js tests/security-resource-boundaries.test.js tests/security-property-fuzz.test.js tests/security-adversarial-fuzz-contract.test.js tests/runtime-i18n.test.js tests/long-ocr-empty-retry.test.js tests/tesseract-adaptive-ocr.test.js tests/tesseract-node24-boot.test.js tests/session-vision-state.test.js tests/session-vision-state-integration.test.js tests/session-vision-event-feed.test.js tests/session-vision-policy.test.js tests/session-vision-policy-domain.test.js tests/session-vision-delegation.test.js tests/session-vision-delegation-boundary.test.js tests/subagent-vision-inheritance-characterization.test.js tests/subagent-vision-runtime-integration.test.js tests/subagent-vision-cold-resume.test.js tests/image-resource-governor.test.js tests/resource-retention-lifecycle.test.js tests/pixel-diff-stream.test.js tests/large-image-resource-integration.test.js tests/structured-guard-idempotency.test.js tests/vision-routing-product.test.js tests/vision-runtime-performance.test.js tests/vision-routing-settings-prelude.test.js tests/v2-settings-ia-integration.test.js tests/vision-capability-router.test.js tests/vision-capability-reference.test.js tests/vision-capability-benchmark.test.js tests/vision-capability-grounding-proof-contract.test.js tests/vision-capability-probe.test.js tests/vision-capability-axis-freshness.test.js tests/vision-capability-shadow-health.test.js tests/vision-capability-benchmark-service.test.js tests/vision-capability-preflight-hardening.test.js tests/vision-capability-benchmark-contract.test.js tests/vision-capability-benchmark-client.test.js tests/vision-capability-benchmark-client-productization.test.js tests/vision-capability-adapter-route.test.js tests/vision-background-benchmark.test.js tests/vision-background-lifecycle.test.js tests/vision-background-benchmark-productization.test.js tests/vision-capability-benchmark-budget.test.js tests/vision-image-input-verdict.test.js tests/vision-capability-failure-classification.test.js tests/vision-capability-gate-client.test.js tests/v2-product-review-fixes.test.js tests/qa-top5-reliability.test.js tests/qa-screenshot-runtime.test.js tests/qa-runtime-identity.test.js tests/qa-turn-budget-cancellation.test.js tests/qa-cancellation-publication.test.js tests/qa-reliability-tail.test.js tests/qa-endpoint-route-alias.test.js tests/settings-native-card-semantics.test.js tests/settings-native-card-lazy-data.test.js tests/settings-invalid-staged-dirty.test.js tests/vision-toggle-root-hardening.test.js && pnpm test:regression-closure && node --test tests/vision-backend-runtime-policy.test.js tests/vision-router-adversarial-review-fixes.test.js tests/web-panel-delegation.test.js",
94
96
  "test:core": "node --test tests/core.test.js tests/degraded-local-evidence.test.js tests/runtime-e2e.test.js tests/structured-bootstrap.test.js tests/structured-flow-hardening.test.js tests/structured-flow-adversarial.test.js tests/vision-execution-policy.test.js tests/vision-backend-runtime-policy.test.js",
95
97
  "test:routing": "node --test tests/issue-374-delegated-call-config.test.js tests/twin-image-capability-fallback.test.js tests/twin-image-custom-wrapper.test.js tests/vision-routing-product.test.js tests/vision-capability-router.test.js tests/vision-capability-probe.test.js tests/vision-capability-shadow-health.test.js tests/vision-runtime-performance.test.js tests/vision-background-benchmark.test.js tests/vision-image-input-verdict.test.js",
96
98
  "test:session": "node --test tests/session-vision-state.test.js tests/session-vision-state-integration.test.js tests/session-vision-policy.test.js tests/session-vision-delegation.test.js tests/session-vision-delegation-boundary.test.js tests/subagent-vision-inheritance-characterization.test.js tests/subagent-vision-runtime-integration.test.js tests/subagent-vision-cold-resume.test.js tests/session-vision-policy-domain.test.js tests/replay-delegation.test.js tests/legacy-session-repair.test.js tests/session-repair-v2.test.js tests/issue-276-session-image-ownership.test.js",
97
99
  "test:resources": "node --test tests/artifact-path-security.test.js tests/image-resource-governor.test.js tests/resource-retention-lifecycle.test.js tests/pixel-diff-stream.test.js tests/large-image-resource-integration.test.js tests/qa-turn-budget-cancellation.test.js tests/qa-cancellation-publication.test.js",
98
100
  "test:compat": "node --test tests/adapter-prepare-call-compat.test.js tests/attachment-admission-policy.test.js tests/dsh-host-compat.test.js tests/http-compat.test.js tests/pi-ai-bridge-wire-compat.test.js tests/fetch-wrapper-lifecycle.test.js tests/fetch-wrapper-composition.test.js tests/native-image-coexistence.test.js tests/tesseract-node24-boot.test.js tests/dsh-host-capabilities.test.js",
99
101
  "test:web": "node --test tests/alpha1-browser-lifecycle-integration.test.js tests/issue-367-remote-session-inject.test.js tests/vision-mode-toggle-injection.test.js tests/client.test.js tests/client-presentation-boundary.test.js tests/clipboard-image-paste-compat.test.js tests/settings-ia-client-prelude.test.js tests/settings-ia-acceptance-regression.test.js tests/remote-settings-bridge.test.js tests/remote-settings-v2-contract.test.js tests/local-remote-settings-permission.test.js tests/v2-settings-ia-integration.test.js tests/logging-ui.test.js tests/dev-staged-build.test.js tests/dev-web-reload.test.js",
100
- "test:contract": "node --test tests/manifest-dependencies.test.js tests/bundle-defaults.test.js tests/zero-regression-gate.test.js tests/issue-289-native-nonintervention.test.js tests/issue-374-delegated-call-config.test.js tests/runtime-boundary-fixes.test.js tests/security-adversarial-fuzz-contract.test.js tests/runtime-i18n.test.js tests/adapter-prepare-call-compat.test.js tests/dsh-host-compat.test.js tests/attachment-admission-policy.test.js tests/dsh-host-capabilities.test.js tests/doctor-host-capabilities.test.js tests/structured-bootstrap.test.js tests/structured-bootstrap-gate.test.js",
102
+ "test:contract": "node --test tests/dsh-alpha-pin.test.js tests/native-plugin-icons.test.js tests/manifest-dependencies.test.js tests/bundle-defaults.test.js tests/zero-regression-gate.test.js tests/issue-289-native-nonintervention.test.js tests/issue-374-delegated-call-config.test.js tests/runtime-boundary-fixes.test.js tests/security-adversarial-fuzz-contract.test.js tests/runtime-i18n.test.js tests/adapter-prepare-call-compat.test.js tests/dsh-host-compat.test.js tests/attachment-admission-policy.test.js tests/dsh-host-capabilities.test.js tests/doctor-host-capabilities.test.js tests/structured-bootstrap.test.js tests/structured-bootstrap-gate.test.js",
101
103
  "test:grounding": "node --test tests/grounding-coordinate-frame.test.js tests/grounding-coordinate-runtime.test.js tests/vision-capability-grounding-proof-contract.test.js",
102
104
  "test:stress": "node scripts/image-resource-stress.mjs && node --test tests/large-image-resource-integration.test.js tests/resource-retention-lifecycle.test.js",
103
105
  "test:adversarial-fuzz": "node scripts/security-adversarial-fuzz.mjs",