dsh-update-status 0.1.5 → 0.1.7

package/lib/index.d.ts

@@ -22,6 +22,23 @@ type ReleaseCompatibility = 'verified' | 'unverified' | 'incompatible';
  */
 type UpdateWarningKind = 'failure' | 'notice';
 type InstallKind = 'npm-global' | 'pnpm-global' | 'source-checkout' | 'unknown';
+/** Language-neutral warning facts; the browser renders them in its own locale. */
+type UpdateWarning = {
+  code: 'registry-unavailable';
+  detail: string;
+} | {
+  code: 'channel-unavailable';
+  channel: ReleaseChannel;
+} | {
+  code: 'version-incomparable';
+  currentVersion: string;
+  channel: ReleaseChannel;
+  selectedVersion: string;
+} | {
+  code: 'preview-unverified';
+  channel: ReleaseChannel;
+  version: string;
+};
 interface ChannelRelease {
   channel: ReleaseChannel;
   version: string | null;
@@ -39,9 +56,12 @@ interface UpdateStatus {
   hasUpdate: boolean;
   cached: boolean;
   checkedAt: string | null;
+  /** English fallback for older clients; current clients localize `warnings`. */
   warning: string | null;
   /** Severity of `warning`; absent from a Host older than the field. */
   warningKind?: UpdateWarningKind | null;
+  /** Structured warning facts; absent from a Host older than this field. */
+  warnings?: UpdateWarning[];
   installKind: InstallKind;
   upgradeCommand: string;
   releaseUrl: string;
@@ -56,6 +76,32 @@ interface UpdateStatus {
   canApplyInPlace: false;
 }
 //#endregion
+//#region src/host/settings.d.ts
+/** Deployment config (ordinary) plus the volatile user preferences the form edits. */
+interface UpdateStatusConfig {
+  /** Deployment: on-demand registry cache duration, in hours. */
+  cacheTtlHours?: number;
+  /** Deployment: registry request timeout, in milliseconds. */
+  timeoutMs?: number;
+  /** Deployment: run one metadata check when the process mounts the plugin. */
+  autoCheckOnMount?: boolean;
+  /** Preference: show the sidebar version chip and its update panel. */
+  sidebarEnabled?: boolean;
+  /** Preference: release channel followed for comparison and commands. */
+  channel?: ReleaseChannel;
+  /** Preference: on-demand registry cache duration, in minutes. */
+  cacheTtlMinutes?: number;
+}
+/**
+ * The plugin's Config schema; its volatile fields ARE the settings form.
+ *
+ * The explicit two-argument annotation is load-bearing: a `.volatile()` field's
+ * output is a stable reference (`Volatile<T>`) rather than the bare value the
+ * input side takes, so the inferred schema type cannot be named by the emitted
+ * `.d.ts` (TS2883) without stating the input side here.
+ */
+export declare const Config: z<UpdateStatusConfig, Record<string, unknown>>;
+//#endregion
 //#region src/host/installation.d.ts
 interface InstallationInfo {
   currentVersion: string;
@@ -78,7 +124,7 @@ interface UpdateStatusServiceOptions {
   ttlMs?: number;
   releaseUrl?: string;
 }
-declare class UpdateStatusService {
+export declare class UpdateStatusService {
   private readonly installation;
   private readonly fetchLatest;
   private readonly now;
@@ -93,21 +139,14 @@ declare class UpdateStatusService {
   private refreshRelease;
   private statusAfterFailure;
   private statusFromCache;
-  /** No remote data at all: the registry read itself failed, never a notice. */
   private statusWithoutRemoteRelease;
 }
 //#endregion
 //#region src/index.d.ts
-declare const name = "dsh-update-status";
+export declare const name = "dsh-update-status";
 /** Connection supplies the authenticated transport; settings remains optional. */
-declare const inject: string[];
-interface Config {
-  cacheTtlHours?: number;
-  timeoutMs?: number;
-  autoCheckOnMount?: boolean;
-}
-/** Deployment config only controls metadata-check timing; it never authorizes upgrades. */
-declare const Config: z<Config>;
-declare function apply(ctx: Context, config?: Config): void;
+export declare const inject: string[];
+export type Config = UpdateStatusConfig;
+export declare function apply(ctx: Context, config?: Config): void;
 //#endregion
-export { Config, type InstallKind, type UpdateStatus, UpdateStatusService, apply, inject, name };
+export type { InstallKind, UpdateStatus };

package/lib/index.js

@@ -1,17 +1,8 @@
 import { createRequire } from "node:module";
-import z from "@deepseek-ai/schemastery";
 import { existsSync, readFileSync, realpathSync } from "node:fs";
 import { dirname, join, normalize, sep } from "node:path";
+import z from "@deepseek-ai/schemastery";
 //#region src/shared/types.ts
-/**
-* JSON-only contract shared by the Host and Web halves.
-*
-* The static package uses the authenticated Connection RPC channel because
-* `harness.handle` / `host.call` are dynamic-Cordis-only closure APIs in DSH
-* 0.1.5-rc.1. The endpoint vocabulary remains deliberately small and private
-* to this plugin channel.
-*/
-const PLUGIN_ID = "dsh-update-status";
 const PACKAGE_NAME = "@deepseek-ai/dsh";
 /** Shared Connection RPC channel. Custom prefixes 405 on the SPA fallback. */
 const UPDATE_STATUS_CHANNEL = "/api";
@@ -21,11 +12,7 @@ const UPDATE_STATUS_CHANNEL = "/api";
 * release the registry reports stays `unverified` — the plugin never claims a
 * compatibility nobody checked.
 */
-const VERIFIED_DSH_VERSIONS = [
-	"0.1.5-rc.1",
-	"0.1.6-alpha.1",
-	"0.1.6-alpha.2"
-];
+const VERIFIED_DSH_VERSIONS = ["0.1.7-alpha.2", "0.1.7-rc.1"];
 const RELEASE_CHANNELS = [
 	"latest",
 	"next",
@@ -137,8 +124,8 @@ function upgradeCommandFor(installKind, packageName = PACKAGE_NAME, channel = "l
 	switch (installKind) {
 		case "npm-global": return `npm install -g ${specifier}`;
 		case "pnpm-global": return `pnpm add -g ${specifier}`;
-		case "source-checkout": return "在 DSH checkout 中拉取代码、安装依赖并重新构建；插件不会从 GUI 原地替换";
-		default: return "请确认 dsh 安装方式后再升级；当前插件不会代为执行";
+		case "source-checkout": return "Update the DSH source checkout, install its dependencies, and rebuild it; this plugin cannot replace it in place from the GUI";
+		default: return "Confirm how DSH was installed before upgrading; this plugin cannot perform the upgrade for you";
 	}
 }
 /**
@@ -266,34 +253,6 @@ function installUpdateStatusRpc(ctx, service) {
 	});
 }
 //#endregion
-//#region src/host/settings.ts
-const SettingsSchema = z.object({
-	sidebarEnabled: z.boolean().default(true),
-	channel: z.union([
-		"latest",
-		"next",
-		"alpha"
-	]).default("latest").loose(),
-	cacheTtlMinutes: z.number().min(30).max(1440).default(360)
-});
-/** Settings are optional composition; absent providers leave the Web default on. */
-function installSettings(ctx) {
-	ctx.inject(["settings"], (settingsCtx) => {
-		try {
-			settingsCtx.settings.register(PLUGIN_ID, SettingsSchema, {
-				base: {
-					sidebarEnabled: true,
-					channel: "latest",
-					cacheTtlMinutes: 360
-				},
-				applies: "live"
-			});
-		} catch (error) {
-			console.error("[dsh-update-status] settings namespace registration failed:", error);
-		}
-	});
-}
-//#endregion
 //#region src/shared/semver.ts
 const SEMVER = /^(?:v)?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
 const NUMERIC_IDENTIFIER = /^(0|[1-9]\d*)$/;
@@ -354,10 +313,20 @@ function boundedMessage(error) {
 	const trimmed = (error instanceof Error ? error.message : String(error)).replace(/\s+/g, " ").trim();
 	return trimmed === "" ? "unknown error" : trimmed.slice(0, 220);
 }
-function warningWith(base, addition) {
-	if (base === null || base === "") return addition;
-	if (addition === null || addition === "") return base;
-	return `${base} ${addition}`;
+function warningText(warning) {
+	switch (warning.code) {
+		case "registry-unavailable": return `Unable to check the npm registry: ${warning.detail}`;
+		case "channel-unavailable": return `The npm registry does not publish a ${warning.channel} channel.`;
+		case "version-incomparable": return `Unable to compare the current version ${warning.currentVersion} with ${warning.channel} channel version ${warning.selectedVersion} using SemVer.`;
+		case "preview-unverified": return `${warning.channel} is a preview channel; version ${warning.version} has not been verified as compatible with this plugin.`;
+	}
+}
+function warningFallback(warnings) {
+	return warnings.length === 0 ? null : warnings.map(warningText).join(" ");
+}
+function warningKindOf(warnings) {
+	if (warnings.length === 0) return null;
+	return warnings.every((warning) => warning.code === "preview-unverified") ? "notice" : "failure";
 }
 function dateOrNull(value) {
 	if (typeof value !== "string" || value === "") return null;
@@ -442,16 +411,16 @@ var UpdateStatusService = class {
 	async check(force = false, channel = "latest", cacheTtlMinutes) {
 		const ttlMs = isCacheTtlMinutes(cacheTtlMinutes) ? cacheTtlMinutes * 60 * 1e3 : this.ttlMs;
 		const cached = this.cache;
-		if (!force && cached !== void 0 && this.now() - cached.checkedAtMs < ttlMs) return this.statusFromCache(cached, channel, true, null);
+		if (!force && cached !== void 0 && this.now() - cached.checkedAtMs < ttlMs) return this.statusFromCache(cached, channel, true, []);
 		if (this.inFlight !== void 0) try {
-			return this.statusFromCache(await this.inFlight, channel, false, null);
+			return this.statusFromCache(await this.inFlight, channel, false, []);
 		} catch (error) {
 			return this.statusAfterFailure(channel, error);
 		}
 		const run = this.refreshRelease();
 		this.inFlight = run;
 		try {
-			return this.statusFromCache(await run, channel, false, null);
+			return this.statusFromCache(await run, channel, false, []);
 		} catch (error) {
 			return this.statusAfterFailure(channel, error);
 		} finally {
@@ -467,10 +436,13 @@ var UpdateStatusService = class {
 		return cache;
 	}
 	statusAfterFailure(channel, error) {
-		const warning = `无法检查 npm registry：${boundedMessage(error)}`;
-		return this.cache === void 0 ? this.statusWithoutRemoteRelease(channel, warning) : this.statusFromCache(this.cache, channel, true, warning);
+		const warnings = [{
+			code: "registry-unavailable",
+			detail: boundedMessage(error)
+		}];
+		return this.cache === void 0 ? this.statusWithoutRemoteRelease(channel, warnings) : this.statusFromCache(this.cache, channel, true, warnings);
 	}
-	statusFromCache(cache, channel, cached, initialWarning) {
+	statusFromCache(cache, channel, cached, initialWarnings) {
 		const selected = cache.release.channels.find((release) => release.channel === channel) ?? {
 			channel,
 			version: null,
@@ -478,19 +450,31 @@ var UpdateStatusService = class {
 			compatibility: "unverified"
 		};
 		const comparison = selected.version === null ? void 0 : compareSemver(this.installation.currentVersion, selected.version);
-		const missingWarning = selected.version === null ? `npm registry 未发布 ${channel} 通道。` : null;
-		const comparisonWarning = selected.version !== null && comparison === void 0 ? `无法按 SemVer 比较当前版本 ${this.installation.currentVersion} 与 ${channel} 通道版本 ${selected.version}。` : null;
-		const previewWarning = channel !== "latest" && selected.version !== null && selected.compatibility !== "verified" ? `${channel} 是预览通道，版本 ${selected.version} 尚未验证与本插件兼容。` : null;
-		const failureWarning = warningWith(warningWith(initialWarning, missingWarning), comparisonWarning);
-		const warning = warningWith(failureWarning, previewWarning);
+		const warnings = [...initialWarnings];
+		if (selected.version === null) warnings.push({
+			code: "channel-unavailable",
+			channel
+		});
+		if (selected.version !== null && comparison === void 0) warnings.push({
+			code: "version-incomparable",
+			currentVersion: this.installation.currentVersion,
+			channel,
+			selectedVersion: selected.version
+		});
+		if (channel !== "latest" && selected.version !== null && selected.compatibility !== "verified") warnings.push({
+			code: "preview-unverified",
+			channel,
+			version: selected.version
+		});
 		return {
 			currentVersion: this.installation.currentVersion,
 			latestVersion: selected.version,
 			hasUpdate: comparison !== void 0 && comparison < 0,
 			cached,
 			checkedAt: new Date(cache.checkedAtMs).toISOString(),
-			warning,
-			warningKind: warning === null ? null : failureWarning === null ? "notice" : "failure",
+			warning: warningFallback(warnings),
+			warningKind: warningKindOf(warnings),
+			warnings,
 			installKind: this.installation.installKind,
 			upgradeCommand: upgradeCommandFor(this.installation.installKind, this.installation.packageName || "@deepseek-ai/dsh", channel),
 			releaseUrl: this.releaseUrl,
@@ -502,16 +486,16 @@ var UpdateStatusService = class {
 			canApplyInPlace: false
 		};
 	}
-	/** No remote data at all: the registry read itself failed, never a notice. */
-	statusWithoutRemoteRelease(channel, warning) {
+	statusWithoutRemoteRelease(channel, warnings) {
 		return {
 			currentVersion: this.installation.currentVersion,
 			latestVersion: null,
 			hasUpdate: false,
 			cached: false,
 			checkedAt: null,
-			warning,
-			warningKind: "failure",
+			warning: warningFallback(warnings),
+			warningKind: warningKindOf(warnings),
+			warnings,
 			installKind: this.installation.installKind,
 			upgradeCommand: upgradeCommandFor(this.installation.installKind, this.installation.packageName || "@deepseek-ai/dsh", channel),
 			releaseUrl: this.releaseUrl,
@@ -530,16 +514,57 @@ var UpdateStatusService = class {
 	}
 };
 //#endregion
-//#region src/index.ts
-const name = "dsh-update-status";
-/** Connection supplies the authenticated transport; settings remains optional. */
-const inject = ["connection"];
-/** Deployment config only controls metadata-check timing; it never authorizes upgrades. */
+//#region src/host/settings.ts
+/**
+* The plugin's Config schema; its volatile fields ARE the settings form.
+*
+* The explicit two-argument annotation is load-bearing: a `.volatile()` field's
+* output is a stable reference (`Volatile<T>`) rather than the bare value the
+* input side takes, so the inferred schema type cannot be named by the emitted
+* `.d.ts` (TS2883) without stating the input side here.
+*/
 const Config = z.object({
 	cacheTtlHours: z.number().step(1).min(1).max(24).default(6),
 	timeoutMs: z.number().step(1).min(1e3).max(3e4).default(DEFAULT_TIMEOUT_MS),
-	autoCheckOnMount: z.boolean().default(true)
+	autoCheckOnMount: z.boolean().default(true),
+	sidebarEnabled: z.boolean().default(true).volatile(),
+	channel: z.union([
+		"latest",
+		"next",
+		"alpha"
+	]).default("latest").loose().volatile(),
+	cacheTtlMinutes: z.number().min(30).max(1440).default(360).volatile()
 });
+/**
+* Suppress the auto-generated settings page for this entry.
+*
+* `autoGenerate` defaults to true, which would put a second, generic form beside
+* the plugin's own `settings.section` page. Registering the policy is the
+* documented move for a plugin that owns its preference UI (`ui-theme`,
+* `ui-chat`, `ui-conversation` all do exactly this), and the entry's row stays
+* in `settings.describe()` either way — the browser half still reads and writes
+* it through `ctx.configForms`.
+*
+* Guarded twice: a deployment without the settings service never runs the inject
+* callback (the plugin keeps working from its defaults), and a refused policy
+* registration is contained instead of taking the plugin down.
+*
+* @param ctx - Host plugin context owning the entry's page policy.
+*/
+function installSettings(ctx) {
+	try {
+		ctx.inject(["settings"], (child) => {
+			child.effect(() => child.settings.configure({ auto: false }, ctx.fiber));
+		});
+	} catch (error) {
+		console.error("[dsh-update-status] settings page policy registration failed:", error);
+	}
+}
+//#endregion
+//#region src/index.ts
+const name = "dsh-update-status";
+/** Connection supplies the authenticated transport; settings remains optional. */
+const inject = ["connection"];
 function boundedNumber(value, fallback, min, max) {
 	if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
 	return Math.min(max, Math.max(min, Math.floor(value)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-update-status",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Read-only DeepSeek Harness Web plugin that shows the running DSH version, discovers latest/next/alpha releases, warns about compatibility, and generates copy-only upgrade commands.",
   "type": "module",
   "main": "lib/index.js",
@@ -42,12 +42,17 @@
     "access": "public"
   },
   "dsh": {
+    "manifestVersion": 1,
+    "engines": {
+      "dsh": ">=0.1.7-alpha.2 <0.2.0"
+    },
     "bundle": {
       "patch": "./cordis.patch.yml"
     },
     "client": {
       "platform": "web",
       "inject": [
+        "@deepseek-ai/dsh-api-remotes",
         "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-ui-layout",
         "@deepseek-ai/dsh-client-ui-sidebar",
@@ -57,9 +62,8 @@
     },
     "compatibility": {
       "dshReleases": {
-        "0.1.5-rc.1": "compatible",
-        "0.1.6-alpha.1": "compatible",
-        "0.1.6-alpha.2": "compatible"
+        "0.1.7-alpha.2": "compatible",
+        "0.1.7-rc.1": "compatible"
       }
     }
   },
@@ -72,23 +76,21 @@
     "version"
   ],
   "license": "MIT",
-  "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.2"
-  },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-settings": ">=0.1.5-rc.1"
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-settings": ">=0.1.7-alpha.2 <0.2.0",
+    "@deepseek-ai/schemastery": "^3.18.4"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-settings": "0.1.5-rc.1",
-    "@deepseek-ai/schemastery": "^3.18.2",
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-settings": "0.1.7-alpha.2",
+    "@deepseek-ai/schemastery": "^3.18.4",
     "@types/node": "^26.2.0",
     "@types/react": "^18.3.31",
     "react": "^18.3.1",
-    "tsdown": "^0.22.14",
+    "tsdown": "^0.23.0",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.11"
+    "vitest": "^5.0.1"
   },
   "scripts": {
     "build": "tsdown",