@huanlin/dsh-plugin-tools-manager 0.2.0

package/lib/settings.js

@@ -0,0 +1,79 @@
+/**
+ * settings.ts — host-side bridge between the `tools-manager` settings namespace
+ * and the plugin's other halves (policy + gateway + registry).
+ *
+ * The composition `Config` (cordis.patch.yml) is the first-boot seed; once the
+ * `ctx.settings` service mounts, the user-editable layer takes over and the
+ * disabled set tracks every committed change. Headless assemblies without a
+ * settings provider fall back to the composition config (no persistence, no
+ * live reload).
+ *
+ * The bridge mirrors `dsh-interpreters/src/settings.ts`: a `source()` thunk the
+ * gateway and policy read in-process, plus an `onChange()` subscription the
+ * host entry uses to rebuild the disabled set on every committed change.
+ *
+ * @module dsh-tools-manager/settings
+ */
+import { Config } from './config.js';
+import { resolveConfig } from './config.js';
+/** Settings namespace under which the disabled-tool list persists. */
+export const SETTINGS_NAMESPACE = 'tools-manager';
+/**
+ * Mirror of the dsh-settings internal `isUnloading` guard. The cordis const
+ * enum for fiber state is erased at compile time, so the literal states are
+ * matched numerically: 4 = DISPOSED, 5 = UNLOADING.
+ */
+function isUnloading(ctx) {
+    const state = ctx.fiber?.state;
+    return state === 4 || state === 5;
+}
+/**
+ * Install the `tools-manager` settings namespace and return the bridge.
+ *
+ * The settings service is reached through `ctx.inject(['settings'], ...)` so a
+ * composition without a settings provider still loads the plugin (entry-source
+ * fallback, no persistence). Multi-fiber dedupe is handled by catching the
+ * `"already registered"` rejection.
+ * @param ctx - host context.
+ * @param entry - composition-layer config (cordis.patch.yml seed).
+ * @returns the bridge the gateway and policy consume.
+ */
+export function installToolsManagerSettings(ctx, entry) {
+    const listeners = new Set();
+    let source = () => resolveConfig(entry);
+    const notify = () => {
+        for (const listener of [...listeners])
+            listener();
+    };
+    ctx.inject(['settings'], (sctx) => {
+        let scope;
+        try {
+            scope = sctx.settings.register(SETTINGS_NAMESPACE, Config, { base: entry });
+        }
+        catch (error) {
+            // Multi-fiber dedupe: the first registration owns the namespace; later
+            // fibers stay on the entry source and emit no notifications of their own.
+            if (!(error instanceof Error) || !error.message.includes('already registered'))
+                throw error;
+            ctx.logger('tools-manager').debug('settings namespace already registered — entry-source fallback');
+            return;
+        }
+        source = () => resolveConfig(scope.get());
+        sctx.effect(() => () => {
+            if (isUnloading(ctx))
+                return;
+            source = () => resolveConfig(entry);
+            notify();
+        });
+        notify();
+        scope.watch(() => {
+            if (isUnloading(ctx))
+                return;
+            notify();
+        });
+    });
+    return {
+        source: () => source(),
+        onChange: (cb) => { listeners.add(cb); },
+    };
+}

package/package.json

@@ -0,0 +1,109 @@
+{
+  "name": "@huanlin/dsh-plugin-tools-manager",
+  "version": "0.2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "dsh-plugin"
+  ],
+  "description": "Lists every registered tool grouped by source plugin (tree) and supports globally disabling individual tools; settings card (via /tools-manager/api HTTP route) lets users toggle tools on/off.",
+  "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": {
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/",
+    "cordis.patch.yml"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-primitives",
+        "@deepseek-ai/dsh-client-ui-slots"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^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-host-webserver": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.2-rc.1",
+    "react": "^18.2.0",
+    "schemastery": "^3.18.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-primitives": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-slots": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-renderer": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-host-webserver": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-system-prompt": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "schemastery": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.0",
+    "@types/react": "~18.3.1",
+    "esbuild": "^0.28.2",
+    "lightningcss": "^1.29.2",
+    "react": "^18.2.0",
+    "schemastery": "^3.18.0",
+    "tsdown": "^0.22.2",
+    "typescript": "^5.9.0",
+    "vitest": "^3.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "build": "tsc -p tsconfig.build.json && node scripts/build-client.mjs"
+  }
+}