dsh-smooth-stream 0.1.0 → 0.3.1

package/lib/index.js

@@ -1,4 +1,9 @@
+import { settingsNamespace } from "@deepseek-ai/dsh-settings";
 import Schema from "@deepseek-ai/schemastery";
+import { readFileSync } from "node:fs";
+import { basename, dirname, isAbsolute, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
 //#region src/config.ts
 /** Defaults shared by the Host schema and the client-side fallback. */
 const DEFAULT_STREAM_CONFIG = {
@@ -41,6 +46,122 @@ function injectStreamConfig(html, config) {
 	return `${html.slice(0, at)}${script}${html.slice(at)}`;
 }
 //#endregion
+//#region src/package-meta.ts
+/** Host-only package metadata. The package manifest remains the source of truth. */
+function packageManifestPath() {
+	try {
+		return join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+	} catch {}
+	return join(process.cwd(), "package.json");
+}
+const manifest = JSON.parse(readFileSync(packageManifestPath(), "utf8"));
+function readRequiredString(field) {
+	const value = manifest[field];
+	if (typeof value !== "string" || value.length === 0) throw new Error(`dsh-smooth-stream: package.json must contain a non-empty ${field}`);
+	return value;
+}
+/** npm package name, read from this plugin's manifest. */
+const STREAM_PACKAGE_NAME = readRequiredString("name");
+/** Version of the code currently loaded by the Host, read from its manifest. */
+const STREAM_PACKAGE_VERSION = readRequiredString("version");
+//#endregion
+//#region src/profile-installation.ts
+/** Host-only profile source inspection and fixed npm update runner. */
+function record(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function profileDirectory(baseUrl) {
+	if (baseUrl === void 0) return void 0;
+	try {
+		const url = new URL(baseUrl);
+		return url.protocol === "file:" ? fileURLToPath(url) : void 0;
+	} catch {
+		return;
+	}
+}
+function hasBundle(manifest, packageName) {
+	const bundles = record(record(manifest.dsh)?.profile)?.bundles;
+	return Array.isArray(bundles) && bundles.includes(packageName);
+}
+function isLocalSpecifier(specifier) {
+	return specifier.startsWith("link:") || specifier.startsWith("file:") || specifier.startsWith(".") || isAbsolute(specifier) || /^[A-Za-z]:[\\/]/.test(specifier);
+}
+function isRegistrySpecifier(specifier) {
+	return specifier.length > 0 && !specifier.includes(":") && !/[\\/]/.test(specifier);
+}
+function isNpmSpecifier(specifier, packageName) {
+	if (!specifier.startsWith("npm:")) return isRegistrySpecifier(specifier);
+	const aliased = specifier.slice(4);
+	if (aliased === packageName) return true;
+	const prefix = `${packageName}@`;
+	return aliased.startsWith(prefix) && isRegistrySpecifier(aliased.slice(prefix.length));
+}
+/**
+* Read only the profile manifest anchored by the current Cordis config tree.
+* A malformed or unrelated tree never receives an update affordance.
+*/
+function inspectProfileInstallation(baseUrl, packageName) {
+	const profileDir = profileDirectory(baseUrl);
+	if (profileDir === void 0) return { kind: "unmanaged" };
+	let manifest;
+	try {
+		manifest = JSON.parse(readFileSync(join(profileDir, "package.json"), "utf8"));
+	} catch {
+		return { kind: "unmanaged" };
+	}
+	const specifier = record(manifest.dependencies)?.[packageName];
+	if (typeof specifier !== "string" || !hasBundle(manifest, packageName)) return { kind: "unmanaged" };
+	if (isLocalSpecifier(specifier)) return { kind: "development" };
+	if (!isNpmSpecifier(specifier, packageName)) return { kind: "unmanaged" };
+	return {
+		kind: "npm",
+		profileDir,
+		profileName: basename(profileDir)
+	};
+}
+/** Run the same fixed package update operation that a profile user would invoke. */
+function updateNpmProfilePackage(profileDir, packageName) {
+	const command = process.platform === "win32" ? "pnpm.cmd" : "pnpm";
+	return new Promise((resolve, reject) => {
+		const child = spawn(command, ["update", packageName], {
+			cwd: profileDir,
+			stdio: "ignore",
+			shell: false,
+			windowsHide: true
+		});
+		child.once("error", reject);
+		child.once("exit", (code, signal) => {
+			if (code === 0) resolve();
+			else reject(/* @__PURE__ */ new Error(`dsh-smooth-stream: pnpm update failed (${signal ?? String(code)})`));
+		});
+	});
+}
+//#endregion
+//#region src/settings-api.ts
+/** Shared wire vocabulary for the plugin-owned settings RPC channel. */
+/** Dedicated, loopback-only RPC channel registered by the Host half. */
+const STREAM_SETTINGS_RPC_CHANNEL = "/smooth-stream";
+/** Endpoints accepted by {@link STREAM_SETTINGS_RPC_CHANNEL}. */
+const STREAM_SETTINGS_RPC = {
+	read: "settings.read",
+	write: "settings.write",
+	upgrade: "plugin.upgrade"
+};
+//#endregion
+//#region src/settings.ts
+/**
+* User-owned settings for the smooth-stream plugin, exposed to the Host
+* settings service and edited from the Web Settings "plugin configuration"
+* page. This is the runtime-editable complement to {@link StreamConfig}: that
+* contract is composed at load and bridged once through the boot global, while
+* these preferences live in the durable user-settings document and take effect
+* live.
+*/
+/** Settings namespace registered by the Host and served through the plugin RPC. */
+const STREAM_SETTINGS_NS = "smooth-stream";
+/** Defaults shared by the Host schema and the client-side fallback. */
+const DEFAULT_STREAM_SETTINGS = { thinkAutoExpand: true };
+//#endregion
 //#region src/plugin.ts
 /** Display name shown by the Host loader while the plugin is mounted. */
 const name = "dsh-smooth-stream";
@@ -56,6 +177,11 @@ const Config = Schema.object({
 	maxScrollSpeedPxPerSec: Schema.number().min(1).max(2e3).default(DEFAULT_STREAM_CONFIG.maxScrollSpeedPxPerSec)
 });
 /**
+* Schema of the user-owned settings section. The Host keeps it in the durable
+* settings provider while the browser edits it through the plugin RPC below.
+*/
+const StreamSettingsSchema = Schema.object({ thinkAutoExpand: Schema.boolean().default(DEFAULT_STREAM_SETTINGS.thinkAutoExpand) });
+/**
 * Host half: log the resolved configuration and bridge it to the browser
 * half. The web boot graph carries no per-entry config, so the validated
 * value is injected into every served index response as a boot global the
@@ -68,6 +194,109 @@ function apply(ctx, config) {
 	ctx.inject(["webServer"], (httpCtx) => {
 		httpCtx.effect(() => httpCtx.webServer.tapIndex((html) => injectStreamConfig(html, config)), "dsh-smooth-stream: boot config bridge");
 	});
+	ctx.inject(["settings"], (settingsCtx) => {
+		const scope = settingsCtx.settings.register(settingsNamespace(STREAM_SETTINGS_NS), StreamSettingsSchema, { applies: "live" });
+		settingsCtx.inject(["connection"], (connectionCtx) => {
+			let upgrade;
+			const view = () => {
+				const installation = inspectProfileInstallation(connectionCtx.baseUrl, STREAM_PACKAGE_NAME);
+				return {
+					version: STREAM_PACKAGE_VERSION,
+					installation: installation.kind,
+					writable: connectionCtx.settings.writable,
+					thinkAutoExpand: scope.get().thinkAutoExpand,
+					canUpgrade: installation.kind === "npm"
+				};
+			};
+			const handle = async (endpoint, payload) => {
+				if (endpoint === STREAM_SETTINGS_RPC.read) return {
+					ok: true,
+					value: view()
+				};
+				if (endpoint === STREAM_SETTINGS_RPC.write) {
+					if (typeof payload !== "object" || payload === null || typeof payload.thinkAutoExpand !== "boolean") return {
+						ok: false,
+						error: {
+							code: "settings-rejected",
+							message: "thinkAutoExpand must be a boolean",
+							details: { ns: STREAM_SETTINGS_NS }
+						}
+					};
+					if (!connectionCtx.settings.writable) return {
+						ok: false,
+						error: {
+							code: "settings-rejected",
+							message: "smooth-stream settings are read-only",
+							details: { ns: STREAM_SETTINGS_NS }
+						}
+					};
+					try {
+						await scope.update({ thinkAutoExpand: payload.thinkAutoExpand });
+					} catch {
+						return {
+							ok: false,
+							error: {
+								code: "settings-rejected",
+								message: "smooth-stream settings update failed",
+								details: { ns: STREAM_SETTINGS_NS }
+							}
+						};
+					}
+					return {
+						ok: true,
+						value: view()
+					};
+				}
+				if (endpoint === STREAM_SETTINGS_RPC.upgrade) {
+					const installation = inspectProfileInstallation(connectionCtx.baseUrl, STREAM_PACKAGE_NAME);
+					if (installation.kind !== "npm") return {
+						ok: false,
+						error: {
+							code: "internal",
+							message: "smooth-stream is not an npm profile dependency",
+							details: {}
+						}
+					};
+					if (upgrade !== void 0) return {
+						ok: false,
+						error: {
+							code: "internal",
+							message: "smooth-stream update is already running",
+							details: {}
+						}
+					};
+					upgrade = updateNpmProfilePackage(installation.profileDir, STREAM_PACKAGE_NAME);
+					try {
+						await upgrade;
+					} catch {
+						return {
+							ok: false,
+							error: {
+								code: "internal",
+								message: "smooth-stream update failed",
+								details: {}
+							}
+						};
+					} finally {
+						upgrade = void 0;
+					}
+					return {
+						ok: true,
+						value: { restartRequired: true }
+					};
+				}
+				return {
+					ok: false,
+					error: {
+						code: "internal",
+						message: `unknown smooth-stream endpoint ${JSON.stringify(endpoint)}`,
+						details: {}
+					}
+				};
+			};
+			connectionCtx.effect(() => connectionCtx.connection.rpc.handle(STREAM_SETTINGS_RPC_CHANNEL, handle, { authority: "loopback" }), "dsh-smooth-stream: settings RPC");
+		});
+	});
 }
 //#endregion
 export { Config, apply, name };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-smooth-stream",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "DeepSeek Harness (dsh) plugin: silky streaming reveal, no flicker. dsh 丝滑流式渲染插件。",
   "license": "MIT",
   "type": "module",
@@ -53,7 +53,7 @@
     "src/**/*.css",
     "cordis.patch.yml",
     "README.md",
-    "README.zh.md",
+    "README.en.md",
     "LICENSE"
   ],
   "dsh": {
@@ -65,7 +65,10 @@
       "inject": [
         "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-ui-conversation",
-        "@deepseek-ai/dsh-client-locale"
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-plugins"
       ]
     }
   },
@@ -75,13 +78,19 @@
     "test": "vitest run",
     "typecheck": "tsc -p tsconfig.json --pretty false"
   },
+  "dependencies": {
+    "@deepseek-ai/dsh-settings": "0.1.0-rc.6"
+  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-client-locale": "*",
     "@deepseek-ai/dsh-client-runtime": "*",
     "@deepseek-ai/dsh-client-ui-attachment": "*",
+    "@deepseek-ai/dsh-client-connection": "*",
     "@deepseek-ai/dsh-client-ui-conversation": "*",
     "@deepseek-ai/dsh-client-ui-primitives": "*",
+    "@deepseek-ai/dsh-client-ui-settings": "*",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "*",
     "@deepseek-ai/dsh-client-ui-slots": "*",
     "@deepseek-ai/dsh-host-webserver": "*",
     "@deepseek-ai/schemastery": "*",
@@ -97,12 +106,21 @@
     "@deepseek-ai/dsh-client-ui-attachment": {
       "optional": true
     },
+    "@deepseek-ai/dsh-client-connection": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-client-ui-conversation": {
       "optional": true
     },
     "@deepseek-ai/dsh-client-ui-primitives": {
       "optional": true
     },
+    "@deepseek-ai/dsh-client-ui-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings-plugins": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-client-ui-slots": {
       "optional": true
     },
@@ -115,10 +133,14 @@
     "@deepseek-ai/dsh-client-locale": "0.1.0-rc.6",
     "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-attachment": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-connection": "0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-conversation": "0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-primitives": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.0-rc.6",
     "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.6",
     "@deepseek-ai/dsh-host-webserver": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-settings": "0.1.0-rc.6",
     "@deepseek-ai/schemastery": "3.18.1",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^22.20.0",

package/src/client/SmoothStreamCard.module.css

@@ -0,0 +1,253 @@
+/* Mirrors the shipped PluginCard chrome without importing an internal module
+   from another client package. */
+
+.card {
+  list-style: none;
+  display: flex;
+  flex-direction: column;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 12px;
+  background: var(--dsw-alias-bg-layer-3);
+  transition: border-color .16s, background .16s;
+}
+
+.card:hover {
+  border-color: var(--dsw-alias-label-dimmed);
+}
+
+.cardOpen {
+  border-color: var(--dsw-alias-label-dimmed);
+  background: var(--dsw-alias-bg-layer-2);
+}
+
+.header {
+  appearance: none;
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  width: 100%;
+  padding: 14px 16px;
+  border: 0;
+  border-radius: 12px;
+  background: none;
+  cursor: pointer;
+  text-align: left;
+  font: inherit;
+  color: inherit;
+}
+
+.header:focus-visible {
+  outline: 2px solid var(--dsw-alias-brand-primary);
+  outline-offset: -2px;
+}
+
+.headText {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  min-width: 0;
+  flex: 1;
+}
+
+.name {
+  font-weight: 600;
+  font-size: 15px;
+  line-height: 1.4;
+  color: var(--dsw-alias-label-primary);
+}
+
+.description {
+  font-size: 13px;
+  line-height: 1.5;
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.version {
+  flex: none;
+  max-width: 16rem;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: 12px;
+  line-height: 1.5;
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.pending {
+  flex: none;
+  padding: 1px 8px;
+  border-radius: 999px;
+  background: var(--dsw-alias-bg-module-platform);
+  color: var(--dsw-alias-label-secondary);
+  font-size: 11px;
+  font-weight: 500;
+  line-height: 17px;
+  white-space: nowrap;
+}
+
+.chevron {
+  flex: none;
+  color: var(--dsw-alias-label-tertiary);
+  transition: transform .16s;
+}
+
+.chevronOpen {
+  transform: rotate(180deg);
+}
+
+.body {
+  display: flex;
+  flex-direction: column;
+  margin: 0 16px;
+  padding-bottom: 8px;
+  border-top: 1px solid var(--dsw-alias-border-l2);
+}
+
+.readOnly {
+  margin: 12px 0 0;
+  font-size: 12px;
+  line-height: 1.5;
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.field {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 12px 0;
+}
+
+.fieldHead {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+}
+
+.label {
+  flex: 1;
+  min-width: 0;
+  font-size: 13px;
+  font-weight: 500;
+  line-height: 1.5;
+  color: var(--dsw-alias-label-primary);
+}
+
+.toggle {
+  width: 16px;
+  height: 16px;
+  accent-color: var(--dsw-alias-brand-primary);
+  cursor: pointer;
+}
+
+.toggle:disabled {
+  cursor: default;
+}
+
+.toggle:focus-visible {
+  outline: 2px solid var(--dsw-alias-brand-primary);
+  outline-offset: 2px;
+}
+
+.hint {
+  margin: 0;
+  font-size: 12px;
+  line-height: 1.5;
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.failure {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 12px 0;
+}
+
+.updateRow {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 12px 0;
+  border-top: 1px solid var(--dsw-alias-border-l2);
+}
+
+.updateCopy {
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+  gap: 4px;
+}
+
+.footer {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 8px;
+  padding: 12px 0 4px;
+  border-top: 1px solid var(--dsw-alias-border-l2);
+}
+
+.failed {
+  flex: 1;
+  min-width: 0;
+  margin: 0;
+  font-size: 12px;
+  line-height: 1.5;
+  color: var(--dsw-alias-label-error);
+}
+
+.save,
+.discard,
+.update {
+  appearance: none;
+  border: 1px solid transparent;
+  border-radius: 8px;
+  font: inherit;
+  font-size: 13px;
+  line-height: 1.5;
+  padding: 5px 14px;
+  cursor: pointer;
+}
+
+.save {
+  background: var(--dsw-alias-label-primary);
+  color: var(--dsw-alias-bg-layer-3);
+}
+
+.discard {
+  border-color: var(--dsw-alias-border-l2);
+  background: none;
+  color: var(--dsw-alias-label-secondary);
+}
+
+.discard:hover:not(:disabled),
+.update:hover:not(:disabled) {
+  border-color: var(--dsw-alias-label-dimmed);
+  color: var(--dsw-alias-label-primary);
+}
+
+.update {
+  display: inline-flex;
+  align-items: center;
+  flex: none;
+  gap: 6px;
+  border-color: var(--dsw-alias-border-l2);
+  background: none;
+  color: var(--dsw-alias-label-secondary);
+}
+
+.discard:disabled,
+.save:disabled,
+.update:disabled {
+  opacity: 0.4;
+  cursor: default;
+}
+
+.discard:focus-visible,
+.save:focus-visible,
+.update:focus-visible {
+  outline: 2px solid var(--dsw-alias-brand-primary);
+  outline-offset: 1px;
+}