@huanlin/dsh-plugin-preface-context 0.1.0

package/lib/types/settings.js

@@ -0,0 +1,85 @@
+/**
+ * Host-side `preface-context` settings namespace + live source wiring.
+ *
+ * The plugin-row config (the `entry` passed to the plugin's `apply`) is the
+ * composition BASE of the `preface-context` settings namespace: when a dsh
+ * settings service is mounted, its user layer is layered on top (schema
+ * defaults → base → user layer) and the runtime reads the live resolved
+ * value through the bridge's `source` thunk. Without a settings service the
+ * conditional `ctx.inject(['settings'], ...)` child never activates and the
+ * source is exactly the entry: behavior identical to a no-settings build.
+ *
+ * The namespace reaches the web configuration boundary directly: the
+ * apiproxy `settings.mutate` / `settings.describe` RPCs accept any
+ * registered namespace (no allowlist gate in current upstream dsh), so the
+ * client card reads/writes through `ctx.settingsScope.bind({ namespace })`
+ * — no gateway channel is needed.
+ *
+ * @module @huanlin/dsh-plugin-preface-context/settings
+ */
+import { Config } from "./config.js";
+/** The `preface-context` settings namespace (registered when a settings service exists). */
+export const PREFACE_SETTINGS_NAMESPACE = 'preface-context';
+/**
+ * Mirror of @deepseek-ai/dsh-settings' `isUnloading` guard (its
+ * `installSettingsSection` skips source/listener work while the plugin fiber
+ * is unloading or disposed). The library compares `ctx.fiber.state` against
+ * `FiberState.DISPOSED` / `FiberState.UNLOADING`; the const enum is erased at
+ * runtime, so the vendored numeric values (4 / 5) are mirrored here.
+ */
+function isUnloading(ctx) {
+    const state = ctx.fiber?.state;
+    return state === 4 || state === 5;
+}
+/**
+ * Install the `preface-context` settings namespace and wire the live source.
+ *
+ * Mirrors the dsh `installSettingsSection` pattern. The registration rides a
+ * conditional `ctx.inject(['settings'], ...)` child, so with no settings
+ * service the source stays the entry config. Multi-fiber dedupe: the host
+ * may compose several preface-context fibers, and `settings.register` fails
+ * loud on a duplicate namespace — the catch lets the first registration own
+ * the live namespace while later instances fall back to the entry source.
+ * @param ctx - consumer plugin context owning the wiring.
+ * @param entry - the composition entry config, used as `base`.
+ * @returns the bridge the runtime and gateway read through.
+ */
+export function installPrefaceSettings(ctx, entry) {
+    const listeners = new Set();
+    let source = () => entry;
+    const notify = () => {
+        for (const listener of [...listeners])
+            listener();
+    };
+    ctx.inject(['settings'], (sctx) => {
+        let scope;
+        try {
+            scope = sctx.settings.register(PREFACE_SETTINGS_NAMESPACE, Config, { base: entry });
+        }
+        catch (error) {
+            if (!(error instanceof Error) || !error.message.includes('already registered'))
+                throw error;
+            ctx.logger('preface-context').debug('settings namespace already registered — entry-source fallback (multi-fiber dedupe)');
+            return;
+        }
+        source = () => scope.get();
+        sctx.effect(() => () => {
+            if (isUnloading(ctx))
+                return;
+            source = () => entry;
+            notify();
+        });
+        notify();
+        scope.watch(() => {
+            if (isUnloading(ctx))
+                return;
+            notify();
+        });
+    });
+    return {
+        source: () => source(),
+        onChange: (callback) => {
+            listeners.add(callback);
+        },
+    };
+}

package/package.json

@@ -0,0 +1,130 @@
+{
+  "name": "@huanlin/dsh-plugin-preface-context",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "dsh-plugin"
+  ],
+  "description": "在每次会话开头固定注入一段用户配置的文本上下文（设置页输入框可编辑），作为模型可见的 instructions 注入第一轮请求。 | Injects a user-configured text block as model-visible instructions context at the start of every DSH session (editable from the settings page).",
+  "type": "module",
+  "license": "AGPL-3.0",
+  "main": "./lib/index.js",
+  "types": "./lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "import": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/",
+    "cordis.patch.yml"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-plugins",
+        "@deepseek-ai/dsh-client-ui-renderer"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "schemastery": "^3.18.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-connection": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-store": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-primitives": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-renderer": {
+      "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
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "schemastery": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^22.20.1",
+    "@types/react": "~18.3.31",
+    "@types/react-dom": "~18.3.0",
+    "clsx": "^2.1.1",
+    "jsdom": "^25.0.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "schemastery": "^3.18.0",
+    "tsdown": "^0.15.0",
+    "typescript": "^5.9.2",
+    "use-sync-external-store": "^1.2.0",
+    "vitest": "^3.2.7"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.client.json",
+    "test": "vitest run",
+    "build": "tsdown -c tsdown.config.ts && tsc -p tsconfig.json && tsc -p tsconfig.client.json",
+    "bundle:client": "tsdown -c tsdown.config.ts"
+  }
+}