dsh-usage-state 0.4.0 → 0.4.1

package/README.en.md

@@ -101,6 +101,7 @@ Expanding **Advanced** lets you override the source and endpoint, name a credent
 
 - **0.2 line only**: `engines.dsh` = `>=0.2.0-rc.2 <0.3.0-0` (this is what dsh-market's badge and install gate read). On an earlier host, install `0.3.2`.
 - `peerDependencies` carry `@deepseek-ai/dsh-settings` (`^0.2.0-rc.2`) and `@deepseek-ai/schemastery` (`^3.18.2`). The first one is deliberate: the runtime install gate only reads `@deepseek-ai/dsh*` peers, so declaring it makes a 0.1.x host **refuse the install** instead of accepting it and then failing to boot. Both are platform-provided; pnpm may print a `missing peer` warning for them, which is expected.
+- Version `0.4.1` fixes `0.4.0`'s missing readings: the browser half's RPC contribution lacked the `create()` factory 0.2 requires, so `remote.usageState` never mounted — the UI showed **no readings at all** and mislabelled the cause as `Mode not supported`. The same release stops swallowing a rejected mount, says "reading" while the catalog is absent, and adds **real 0.2 registry contract tests** (revision 18). **Use `0.4.1`, not `0.4.0`.**
 - Version `0.4.0` migrates to the 0.2 settings model (`Config` + `configForms`, with cross-entry config read through `configEditor`). Verification and results: [`docs/implementation.md`](docs/implementation.md) §10; rationale: [`docs/design-consensus.md`](docs/design-consensus.md) revision 17.
 - Version `0.3.2` (last of the 0.1 line) only widened `engines.dsh`; **its claimed 0.2 compatibility was wrong** — on `0.2.0-rc.2` it fails the entire web boot because `settingsScope` does not exist there.
 - Published to npm as [`dsh-usage-state`](https://www.npmjs.com/package/dsh-usage-state); GitHub installs work too.

package/README.md

@@ -125,6 +125,7 @@ dsh plugin --profile web add /path/to/dsh-usage-state
 
 - **只支持 DSH 0.2 线**：`engines.dsh` = `>=0.2.0-rc.2 <0.3.0-0`（市场读它做徽标与"可安装"判定）。0.2 之前的宿主请装 `0.3.2`。
 - `peerDependencies` 里有 `@deepseek-ai/dsh-settings`（`^0.2.0-rc.2`）与 `@deepseek-ai/schemastery`（`^3.18.2`）：前者是**故意的**——平台的运行时安装闸门只读 `@deepseek-ai/dsh*` 的 peer，声明它可以让 0.1.x 宿主在**安装时**就拒绝，而不是装上之后把启动搞崩；两者都由平台提供，pnpm 可能为此打一行 `missing peer` 警告，属预期。
+- 版本 `0.4.1`：修 `0.4.0` 的读数缺失——客户端 RPC contribution 的参数 codec 少了 0.2 要求的 `create()`，`remote.usageState` 因此从未挂载，界面表现为**没有任何读数**并误报 `Mode not supported`。同一轮还让挂载失败不再被静默吞掉、catalog 未到时改说「读取中」，并把**真实 0.2 registry 契约测试**写进单测（修订 18）。**请用 `0.4.1`，不要用 `0.4.0`。**
 - 版本 `0.4.0`：迁到 0.2 原生设置模型（`Config` + `configForms`，宿主侧 `configEditor` 读跨条目配置）。验证方式与结论见 [`docs/implementation.md`](docs/implementation.md) §10、决策见 [`docs/design-consensus.md`](docs/design-consensus.md) 修订 17。
 - 版本 `0.3.2`（0.1 线末版）：仅放宽 `engines.dsh`；**它声称的 0.2 兼容是错的**（0.3.2 在 0.2.0-rc.2 上会因 `settingsScope` 不存在而让整个 web 启动失败）。
 - 同名发布在 npm（[`dsh-usage-state`](https://www.npmjs.com/package/dsh-usage-state)），也可从 GitHub 直接安装。

package/lib/client.js

@@ -7,6 +7,47 @@ window.__ModuleLoader__.load({
 		let react = require("react");
 		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region src/client/contribution.ts
+		/** Absent or boolean — the one parameter this plugin's RPC takes. */
+		const forceSchema = { parse: (value) => value === void 0 ? void 0 : value === true };
+		/**
+		* A strict codec built without zod: `schema` is what the wire decodes through, and
+		* `create()` is the factory the platform's registry calls to obtain it.
+		*/
+		const booleanOrUndefined = {
+			mode: "strict",
+			typeSymbol: "dsh-usage-state#Force",
+			create: () => forceSchema
+		};
+		const srcJson = { mode: "src-json" };
+		/** Must mirror `src/host/typert.ts`: the wire endpoint is `<namespace>/<method>`. */
+		const CONTRIBUTION = {
+			package: "dsh-usage-state",
+			descriptors: [{
+				id: "dsh-usage-state#usageState/getState",
+				service: "usageState",
+				namespace: "usageState",
+				method: "getState",
+				invocation: { kind: "direct" },
+				parameters: [{
+					name: "force",
+					wire: "force",
+					source: "json",
+					acceptsUndefined: true,
+					codec: booleanOrUndefined
+				}],
+				result: srcJson
+			}, {
+				id: "dsh-usage-state#usageState/describeCredentials",
+				service: "usageState",
+				namespace: "usageState",
+				method: "describeCredentials",
+				invocation: { kind: "direct" },
+				parameters: [],
+				result: srcJson
+			}]
+		};
+		//#endregion
 		//#region src/shared/config.ts
 		const DEFAULT_CONFIG = {
 			models: [],
@@ -1067,6 +1108,10 @@ window.__ModuleLoader__.load({
 		function describeStatus(input) {
 			const { status, snapshot, display, now } = input;
 			if (status.kind === "hidden") return [];
+			if (status.kind === "loading") return [{
+				kind: "state",
+				state: "loading"
+			}];
 			if (status.kind === "unconfigured") return [{
 				kind: "state",
 				state: "unconfigured"
@@ -1287,12 +1332,15 @@ window.__ModuleLoader__.load({
 			}
 		}
 		/** Map a provider resolution onto what the line can say about it. */
-		function statusOf(resolution) {
+		function statusOf(resolution, catalogEmpty) {
 			switch (resolution.reason) {
 				case "hidden": return { kind: "hidden" };
 				case "needs-endpoint": return { kind: "needs-endpoint" };
 				case "unknown-source":
-				case "unsupported": return resolution.sourceId === null ? { kind: "unconfigured" } : { kind: "unsupported" };
+				case "unsupported":
+					if (resolution.sourceId === null) return { kind: "unconfigured" };
+					if (catalogEmpty) return { kind: "loading" };
+					return { kind: "unsupported" };
 				case "auto":
 				case "configured":
 					if (resolution.key === void 0 || resolution.sourceId === null || resolution.mode === null) return { kind: "unconfigured" };
@@ -1323,11 +1371,15 @@ window.__ModuleLoader__.load({
 				provider: current.provider,
 				config,
 				catalog: state.catalog
-			}));
+			}), state.catalog.length === 0);
 			const snapshot = status.kind === "ready" ? state.snapshots[status.key] : void 0;
 			const sourceLabel = status.kind === "ready" ? state.catalog.find((entry) => entry.id === status.sourceId)?.displayName ?? status.sourceId : "";
 			const fullParts = statusParts({
-				segments: describeStatus({
+				segments: state.catalog.length === 0 && state.status === "error" && state.error !== void 0 ? [{
+					kind: "state",
+					state: "error",
+					errorDetail: state.error
+				}] : describeStatus({
 					sourceLabel,
 					status,
 					snapshot,
@@ -1722,6 +1774,21 @@ window.__ModuleLoader__.load({
 					this.publish({ credentialsError: messageOf(error) });
 				}
 			}
+			/**
+			* Record that the RPC contribution never mounted.
+			*
+			* Without this the only symptom is an empty catalog, which every surface reads
+			* as "nothing configured yet" — the real cause has to be nameable, because it is
+			* a plugin/host contract failure, not something the user can configure away.
+			*/
+			failRemote(message) {
+				this.publish({
+					status: "error",
+					error: message,
+					catalog: [],
+					snapshots: {}
+				});
+			}
 		};
 		//#endregion
 		//#region src/client/index.tsx
@@ -1735,40 +1802,6 @@ window.__ModuleLoader__.load({
 		];
 		const USAGE_STATE_NS = "usage-state";
 		const POLL_INTERVAL_MS = 3e4;
-		/** Hand-rolled codecs: the browser bundle must not carry zod. */
-		const booleanOrUndefined = {
-			mode: "strict",
-			typeSymbol: "dsh-usage-state#Force",
-			schema: { parse: (value) => value === void 0 ? void 0 : value === true }
-		};
-		const srcJson = { mode: "src-json" };
-		/** Must mirror `src/host/typert.ts`: the wire endpoint is `<namespace>/<method>`. */
-		const CONTRIBUTION = {
-			package: "dsh-usage-state",
-			descriptors: [{
-				id: "dsh-usage-state#usageState/getState",
-				service: "usageState",
-				namespace: "usageState",
-				method: "getState",
-				invocation: { kind: "direct" },
-				parameters: [{
-					name: "force",
-					wire: "force",
-					source: "json",
-					acceptsUndefined: true,
-					codec: booleanOrUndefined
-				}],
-				result: srcJson
-			}, {
-				id: "dsh-usage-state#usageState/describeCredentials",
-				service: "usageState",
-				namespace: "usageState",
-				method: "describeCredentials",
-				invocation: { kind: "direct" },
-				parameters: [],
-				result: srcJson
-			}]
-		};
 		function apply(ctx) {
 			ctx.effect(() => ctx.locale.register(LOCALE_NS, {
 				zh,
@@ -1815,7 +1848,11 @@ window.__ModuleLoader__.load({
 					store.refresh(false);
 					store.refreshModels();
 					store.refreshCredentials();
-				}, () => void 0);
+				}, (error) => {
+					const message = error instanceof Error ? error.message : String(error);
+					console.error("dsh-usage-state: remote contribution did not mount", error);
+					store.failRemote(message);
+				});
 				return () => {
 					cancelled = true;
 					dispose?.();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-usage-state",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
   "description": "DSH plugin: show account balance (API mode) or coding-plan quota (5h/7d/30d) for the model in use",
   "license": "MIT",
@@ -28,12 +28,14 @@
     "./package.json": "./package.json"
   },
   "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.4",
     "@deepseek-ai/dsh-client-locale": "^0.2.0-rc.2",
     "@deepseek-ai/dsh-client-store": "^0.2.0-rc.2",
     "@deepseek-ai/dsh-client-ui-conversation": "^0.2.0-rc.2",
     "@deepseek-ai/dsh-client-ui-primitives": "^0.2.0-rc.2",
     "@deepseek-ai/dsh-client-ui-slots": "^0.2.0-rc.2",
     "@deepseek-ai/dsh-typert-loader": "^0.2.0-rc.2",
+    "@deepseek-ai/dsh-typert-registry": "^0.2.0-rc.2",
     "@deepseek-ai/schemastery": "^3.18.2",
     "@types/node": "^24.0.0",
     "@types/react": "~18.3.1",