dsh-web-icon-indicator 0.3.1 → 0.4.1

package/CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.1](https://github.com/waknow/dsh-web-icon-indicator/compare/v0.4.0...v0.4.1) (2026-09-04)
+
+### Added
+
+* add marketplace screenshots.json and ship it in the npm tarball ([8efb5e7](https://github.com/waknow/dsh-web-icon-indicator/commit/8efb5e752c2759681bfbf78b9ccd8650d1f6973a))
+* declare DSH host requirement via engines.dsh ([ec1be5c](https://github.com/waknow/dsh-web-icon-indicator/commit/ec1be5c6723a1237c68acc317bd26580fd06d9d0))
+
+### Changed
+
+* document declaring/updating the DSH host requirement (engines.dsh) ([fb568b7](https://github.com/waknow/dsh-web-icon-indicator/commit/fb568b71362b4931712240087213845cfb3b76ee))
+## [0.4.0](https://github.com/waknow/dsh-web-icon-indicator/compare/v0.3.1...v0.4.0) (2026-09-04)
+
+### Added
+
+* support DSH 0.1.2 settings service and configuration card ([de3019e](https://github.com/waknow/dsh-web-icon-indicator/commit/de3019e347fdbd3a512604a8377adc7523305730))
+
+### Changed
+
+* auto-create GitHub Release after successful npm publish ([02d98e3](https://github.com/waknow/dsh-web-icon-indicator/commit/02d98e3db9f83013a3e7667c6a0848efecb8ef37))
+* note DSH 0.1.2 support and add a version-support banner ([cd42d2c](https://github.com/waknow/dsh-web-icon-indicator/commit/cd42d2c5b5650800e3620c5806b1b4ac2b25c84f))
 ## [0.3.1](https://github.com/waknow/dsh-web-icon-indicator/compare/v0.3.0...v0.3.1) (2026-09-02)
 
 ### Fixed
@@ -16,6 +36,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 
 * add multi-agent count visualization to READMEs ([4326456](https://github.com/waknow/dsh-web-icon-indicator/commit/4326456d60f4f90bab16a3424f91b9550e25da8a))
+
 ## [0.3.0](https://github.com/waknow/dsh-web-icon-indicator/compare/v0.2.3...v0.3.0) (2026-08-31)
 
 ### Added

package/README.md

@@ -7,6 +7,8 @@
 [![npm downloads](https://img.shields.io/npm/dm/dsh-web-icon-indicator)](https://www.npmjs.com/package/dsh-web-icon-indicator)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 
+> **⚠️ DSH version support** — requires **DSH ≥ 0.1.2** (the settings-service API the configuration card uses). Built & verified against **DSH 0.1.2-rc.1**, the highest version currently tested. On **DSH < 0.1.2** the favicon still works, but the settings UI (**Settings → Plugins → Plugin config**) is unavailable.
+
 Browser tab favicon reflects the current DSH session state — `idle` / `running` / `asking` / `done` — so you can see at a glance whether a session needs your attention, even when the tab is in the background.
 
 ## ✨ What it does
@@ -151,7 +153,7 @@ Entries are shallow-merged over the defaults, so you can override only a few sta
       done:    { effect: heartbeat, colors: ['#2ECC71'] }
 ```
 
-### Settings page & `settings.yaml` (DSH ≥ rc7)
+### Settings page & `settings.yaml` (DSH ≥ 0.1.2)
 
 The plugin registers the whole config surface above with the DSH settings
 service under the `web-icon-indicator` namespace (a schemastery schema in

package/README.zh.md

@@ -7,6 +7,8 @@
 [![npm downloads](https://img.shields.io/npm/dm/dsh-web-icon-indicator)](https://www.npmjs.com/package/dsh-web-icon-indicator)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 
+> **⚠️ DSH 版本支持** —— 需要 **DSH ≥ 0.1.2**（设置卡片所用的 settings 服务 API）。已针对当前最高测试版本 **DSH 0.1.2-rc.1** 构建并验证。在 **DSH < 0.1.2** 上 favicon 仍可用，但设置页（**设置 → 插件 → 插件配置**）不可用。
+
 浏览器标签页 favicon 实时反映 DSH 会话状态——`待机` / `运行中` / `提问` / `完成`——让你在标签页置于后台时也能一眼看出是否有会话需要处理。
 
 ## ✨ 功能特性
@@ -146,7 +148,7 @@ config:
       done:    { effect: heartbeat, colors: ['#2ECC71'] }
 ```
 
-### 设置页与 `settings.yaml`（DSH ≥ rc7）
+### 设置页与 `settings.yaml`（DSH ≥ 0.1.2）
 
 插件把上面整套配置注册进 DSH settings 服务，命名空间为 `web-icon-indicator`
 （schema 为 `lib/index.js` 中的 schemastery schema）：

package/lib/index.js

@@ -69,7 +69,6 @@
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import z from "@deepseek-ai/schemastery";
-import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
@@ -98,8 +97,12 @@ const STATE_NAMES = ["idle", "running", "asking", "done"];
  * Settings namespace under which this plugin's config is registered (the
  * `web-icon-indicator:` section of the profile's settings.yaml, surfaced in
  * 设置 → 插件 → 插件配置). Lowercase kebab, per the settings domain's rule.
+ *
+ * Since DSH 0.1.2 the namespace is a plain string literal (the type-level
+ * `SettingsNamespace` brand exists only at compile time; the runtime value is
+ * the same string), so no helper import is needed here.
  */
-const SETTINGS_NAMESPACE = settingsNamespace("web-icon-indicator");
+const SETTINGS_NAMESPACE = "web-icon-indicator";
 
 /**
  * Schemastery schema mirroring `DEFAULTS`. Registered with the settings
@@ -420,8 +423,15 @@ export default {
   /** Settings namespace + validation schema (exported for reuse/tooling). */
   SETTINGS_NAMESPACE,
   CONFIG_SCHEMA,
-  apply(ctx) {
-    const entry = ctx.get("config") || {};
+  apply(ctx, config) {
+    // Cordis passes the resolved composition config as the second argument
+    // (`apply(ctx, config)`). `config` is the row's own `config` from the
+    // profile composition (merged over the schema only when a `Config` schema
+    // is declared); this plugin merges its `DEFAULTS` itself via `resolveConfig`,
+    // so an absent row config simply yields the defaults. Fall back to the old
+    // `ctx.get("config")` read for compatibility (it is undefined on the host
+    // but kept for the zero-dep test harness and older hosts).
+    const entry = config ?? ctx.get("config") ?? {};
     let source = () => entry;
     // Merge each configured state over its default: { effect, colors, speed }.
     // Idempotent on schema-resolved values, so it doubles as the fallback
@@ -456,22 +466,34 @@ export default {
       .replace("__CFG__", JSON.stringify({ states: c.states }));
     let script = buildScript(cfg);
     let iconsDir = resolveIconsDir(cfg.iconsDir);
-    installSettingsSection(ctx, SETTINGS_NAMESPACE, CONFIG_SCHEMA, entry, {
-      setSource: (next) => { source = next; },
-      onChange: () => {
-        // Settings service mounted, or the section changed: re-resolve, then
-        // mutate cfg in place so the state-machine closures (asking/done hold)
-        // and the injected script see the new values immediately.
-        const next = resolveConfig(source());
-        cfg.askingHoldMs = next.askingHoldMs;
-        cfg.doneHoldMs = next.doneHoldMs;
-        cfg.statusPath = next.statusPath;
-        cfg.iconPathPrefix = next.iconPathPrefix;
-        if (next.iconsDir !== undefined) cfg.iconsDir = next.iconsDir;
-        cfg.states = next.states;
-        iconsDir = resolveIconsDir(cfg.iconsDir);
-        script = buildScript(cfg);
-      },
+    // Register the settings namespace with the host `settings` service. Since
+    // DSH 0.1.2 the standalone `installSettingsSection` export is gone — the
+    // host exposes a `settings` service whose `installSection(owner, ns,
+    // schema, entry, hooks)` carries the same attach/detach lifecycle (base
+    // layer + `setSource` sink + `onChange` notification). The host's own
+    // plugins all use `ctx.inject(["settings"], …)` so the section attaches as
+    // soon as the provider is available — a plain `ctx.get("settings")` can run
+    // before the provider is ready and silently skip the registration. When no
+    // settings provider is composed the callback never fires and the plugin
+    // keeps working on its composition entry + DEFAULTS only.
+    ctx.inject(["settings"], (settingsCtx) => {
+      settingsCtx.settings.installSection(ctx, SETTINGS_NAMESPACE, CONFIG_SCHEMA, entry, {
+        setSource: (next) => { source = next; },
+        onChange: () => {
+          // Settings service mounted, or the section changed: re-resolve, then
+          // mutate cfg in place so the state-machine closures (asking/done hold)
+          // and the injected script see the new values immediately.
+          const next = resolveConfig(source());
+          cfg.askingHoldMs = next.askingHoldMs;
+          cfg.doneHoldMs = next.doneHoldMs;
+          cfg.statusPath = next.statusPath;
+          cfg.iconPathPrefix = next.iconPathPrefix;
+          if (next.iconsDir !== undefined) cfg.iconsDir = next.iconsDir;
+          cfg.states = next.states;
+          iconsDir = resolveIconsDir(cfg.iconsDir);
+          script = buildScript(cfg);
+        },
+      });
     });
     const webServer = ctx.webServer;
     const agents = ctx.agents;
@@ -633,9 +655,14 @@ export default {
     });
 
     // Authoritative pending-approval check: fold the live session's event log
-    // for an `approval/asked` that no `approval/decided` has closed.
+    // for an `approval/asked` that no `approval/decided` has closed. Since DSH
+    // 0.1.2-alpha.4 `Session.events` is gone — read the log on demand through
+    // `session.snapshotEvents()` (a frozen half-open range snapshot). Guard on
+    // the method so older/newer hosts degrade gracefully.
     const hasPendingApproval = (live) => {
-      const events = live?.session?.events;
+      const session = live?.session;
+      if (!session || typeof session.snapshotEvents !== "function") return false;
+      const events = session.snapshotEvents();
       if (!Array.isArray(events)) return false;
       const open = new Set();
       for (const ev of events) {

package/lib/types/index.d.ts

@@ -102,7 +102,7 @@ declare const plugin: {
   name: "dsh-web-icon-indicator";
   inject: readonly ["webServer", "timer", "agents", "fs", "sandboxPolicy"];
   config: DshWebIconIndicatorConfig;
-  apply(ctx: unknown): void;
+  apply(ctx: unknown, config?: unknown): void;
   /** Settings namespace carrying the config (`web-icon-indicator`). */
   SETTINGS_NAMESPACE: string;
   /** Schemastery schema validating the config surface. */

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "dsh-web-icon-indicator",
   "description": "Browser tab favicon reflects the DSH session state: idle / running / asking / done, recolored and animated from one base SVG in the browser (fully configurable colors + effects). · 浏览器标签页 favicon 实时反映 DSH 会话状态：待机 / 运行中 / 提问 / 完成，由单个 base.svg 在浏览器中动态上色与动画（颜色与特效完全可配置）。",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "type": "module",
+  "engines": {
+    "dsh": ">=0.1.2-rc.1"
+  },
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
   "license": "MIT",
@@ -21,17 +24,15 @@
     "client": {
       "platform": "web",
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-renderer",
         "@deepseek-ai/dsh-client-ui-settings",
         "@deepseek-ai/dsh-client-ui-settings-plugins"
       ]
     }
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.7",
-    "@deepseek-ai/schemastery": "^3.18.0"
+    "@deepseek-ai/schemastery": "^3.18.2"
   },
   "exports": {
     ".": {
@@ -52,6 +53,7 @@
     "assets",
     "docs",
     "cordis.patch.yml",
+    "screenshots.json",
     "CHANGELOG.md",
     "README.md",
     "README.zh.md",

package/screenshots.json

@@ -0,0 +1,10 @@
+[
+  "assets/states-default.svg",
+  "assets/multi-agent-count.svg",
+  "assets/effects/blink.svg",
+  "assets/effects/breath.svg",
+  "assets/effects/rainbow.svg",
+  "assets/effects/heartbeat.svg",
+  "assets/effects/bounce.svg",
+  "assets/effects/static.svg"
+]