@huanlin/dsh-plugin-interpreters 0.2.3 → 0.4.0

package/lib/types/gateway.d.ts

@@ -1,63 +1,63 @@
-/**
- * gateway.ts — host-side HTTP gateway exposing the `interpreters` config to
- * the browser through a self-hosted `/interpreters/api` route.
- *
- * The DSH typertGateway `/api` RPC dispatch was the original channel
- * (TypertRemoteService + @Remote), but the host's SRC discovery
- * (ctx.reflect.props enumeration) is not claiming plugin-owned service
- * endpoints on the current dsh snapshot. The self-hosted HTTP route
- * mirrors the better-sidebar pattern: `ctx.webServer.register` claims a
- * prefix route, the handler reads/writes the settings seam in-process
- * (no wire-layer allowlist gate), and the browser reaches it through
- * `fetch('/interpreters/api/<method>')`.
- *
- * Route shape:
- *   POST /interpreters/api/get  → { ok: true, value: { config: ResolvedConfig } }
- *   POST /interpreters/api/set  body: { patch: Partial<Config> }
- *                                → { ok: true, value: { config: ResolvedConfig } }
- * Errors carry { ok: false, error: { code, message } }.
- *
- * @module dsh-interpreters/gateway
- */
-import type { Context } from '@deepseek-ai/cordis';
-import type { Settings } from '@deepseek-ai/dsh-settings';
-import { type Config as ConfigType, type ResolvedConfig } from './config.js';
-import { type InterpretersSettingsBridge } from './settings.js';
-/** Wire view returned by both `get` and `set`: the fully-resolved config. */
-export interface InterpretersConfigView {
-    config: ResolvedConfig;
-}
-/** Patch shape the `set` endpoint accepts (every field optional, null = clear). */
-export type InterpretersConfigPatch = Partial<ConfigType>;
-/**
- * Register the `/interpreters/api` HTTP route on the host's web server.
- *
- * The route reads/writes the `interpreters` settings namespace in-process
- * through the bridge + `ctx.settings`. The settings service is optional:
- * when absent, `get` degrades to the entry source and `set` returns a
- * clear error.
- * @param ctx - host context carrying `webServer`.
- * @param bridge - the settings bridge the route reads through.
- */
-export declare function registerHttpGateway(ctx: Context, bridge: InterpretersSettingsBridge): void;
-/**
- * Handle the `set` method: validate the patch, write the user layer, return
- * the new resolved config.
- * @param body - the parsed JSON body from the request.
- * @param settings - the live settings service (undefined when unavailable).
- * @param bridge - the settings bridge for reading the source.
- * @returns the new resolved config view.
- * @throws when the settings service is unavailable.
- */
-export declare function handleSet(body: unknown, settings: Settings | undefined, bridge: InterpretersSettingsBridge): Promise<InterpretersConfigView>;
-/**
- * Extract and validate the patch from the request body.
- *
- * JSON wire boundary: null = "delete" (filtered), undefined never crosses
- * JSON. Unknown keys are dropped (the settings service is non-strict and
- * would otherwise store them). Light type guards constrain paths to
- * strings and timeout to a finite number.
- * @param body - the parsed JSON body.
- * @returns the normalized patch (only known, well-typed keys).
- */
-export declare function extractPatch(body: unknown): Record<string, unknown>;
+/**
+ * gateway.ts — host-side HTTP gateway exposing the `interpreters` config to
+ * the browser through a self-hosted `/interpreters/api` route.
+ *
+ * The DSH typertGateway `/api` RPC dispatch was the original channel
+ * (TypertRemoteService + @Remote), but the host's SRC discovery
+ * (ctx.reflect.props enumeration) is not claiming plugin-owned service
+ * endpoints on the current dsh snapshot. The self-hosted HTTP route
+ * mirrors the better-sidebar pattern: `ctx.webServer.register` claims a
+ * prefix route, the handler reads/writes the settings seam in-process
+ * (no wire-layer allowlist gate), and the browser reaches it through
+ * `fetch('/interpreters/api/<method>')`.
+ *
+ * Route shape:
+ *   POST /interpreters/api/get  → { ok: true, value: { config: ResolvedConfig } }
+ *   POST /interpreters/api/set  body: { patch: Partial<Config> }
+ *                                → { ok: true, value: { config: ResolvedConfig } }
+ * Errors carry { ok: false, error: { code, message } }.
+ *
+ * @module dsh-interpreters/gateway
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { SettingsProvider } from '@deepseek-ai/dsh-settings';
+import { type Config as ConfigType, type ResolvedConfig } from './config.js';
+import { type InterpretersSettingsBridge } from './settings.js';
+/** Wire view returned by both `get` and `set`: the fully-resolved config. */
+export interface InterpretersConfigView {
+    config: ResolvedConfig;
+}
+/** Patch shape the `set` endpoint accepts (every field optional, null = clear). */
+export type InterpretersConfigPatch = Partial<ConfigType>;
+/**
+ * Register the `/interpreters/api` HTTP route on the host's web server.
+ *
+ * The route reads/writes the `interpreters` settings namespace in-process
+ * through the bridge + `ctx.settings`. The settings service is optional:
+ * when absent, `get` degrades to the entry source and `set` returns a
+ * clear error.
+ * @param ctx - host context carrying `webServer`.
+ * @param bridge - the settings bridge the route reads through.
+ */
+export declare function registerHttpGateway(ctx: Context, bridge: InterpretersSettingsBridge): void;
+/**
+ * Handle the `set` method: validate the patch, write the user layer, return
+ * the new resolved config.
+ * @param body - the parsed JSON body from the request.
+ * @param settings - the live settings service (undefined when unavailable).
+ * @param bridge - the settings bridge for reading the source.
+ * @returns the new resolved config view.
+ * @throws when the settings service is unavailable.
+ */
+export declare function handleSet(body: unknown, settings: SettingsProvider | undefined, bridge: InterpretersSettingsBridge): Promise<InterpretersConfigView>;
+/**
+ * Extract and validate the patch from the request body.
+ *
+ * JSON wire boundary: null = "delete" (filtered), undefined never crosses
+ * JSON. Unknown keys are dropped (the settings service is non-strict and
+ * would otherwise store them). Light type guards constrain paths to
+ * strings and timeout to a finite number.
+ * @param body - the parsed JSON body.
+ * @returns the normalized patch (only known, well-typed keys).
+ */
+export declare function extractPatch(body: unknown): Record<string, unknown>;

package/lib/types/settings.d.ts

@@ -1,43 +1,43 @@
-/**
- * settings.ts — host-side bridge between the `interpreters` settings namespace
- * and the plugin's other halves (tool registration + RPC gateway).
- *
- * The composition `Config` (cordis.patch.yml) is the first-boot seed; once the
- * `ctx.settings` service mounts, the user-editable layer takes over and live
- * re-registration follows every committed change. Headless assemblies without
- * a settings provider fall back to the composition config (no persistence, no
- * live reload).
- *
- * The bridge pattern mirrors `dsh-advisor/src/settings.ts`: a `source()` thunk
- * the gateway reads in-process, plus an `onChange()` subscription the host
- * entry uses to re-register the tools. This avoids any wire-layer allowlist
- * (the DSH settings RPC domain only serves a fixed namespace set to browser
- * configuration clients; the gateway bypasses it through `/api`).
- *
- * @module dsh-interpreters/settings
- */
-import type { Context } from '@deepseek-ai/cordis';
-import { type Config as ConfigType } from './config.js';
-/** Settings namespace under which interpreter paths persist. */
-export declare const SETTINGS_NAMESPACE: import("@deepseek-ai/dsh-settings").SettingsNamespace;
-/** Read face the gateway and tool re-registration consume. */
-export interface InterpretersSettingsBridge {
-    /** The current resolved config (composition seed while settings is absent). */
-    source(): ConfigType;
-    /** Observe committed changes to the resolved config. */
-    onChange(callback: () => void): void;
-}
-/**
- * Install the `interpreters` 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 — host composition may mount several
- * concurrent fibers of this plugin, and only the first registration owns the
- * namespace.
- * @param ctx - host context.
- * @param entry - composition-layer config (cordis.patch.yml seed).
- * @returns the bridge the gateway and tool re-registration consume.
- */
-export declare function installInterpretersSettings(ctx: Context, entry: ConfigType): InterpretersSettingsBridge;
+/**
+ * settings.ts — host-side bridge between the `interpreters` settings namespace
+ * and the plugin's other halves (tool registration + RPC gateway).
+ *
+ * The composition `Config` (cordis.patch.yml) is the first-boot seed; once the
+ * `ctx.settings` service mounts, the user-editable layer takes over and live
+ * re-registration follows every committed change. Headless assemblies without
+ * a settings provider fall back to the composition config (no persistence, no
+ * live reload).
+ *
+ * The bridge pattern mirrors `dsh-advisor/src/settings.ts`: a `source()` thunk
+ * the gateway reads in-process, plus an `onChange()` subscription the host
+ * entry uses to re-register the tools. This avoids any wire-layer allowlist
+ * (the DSH settings RPC domain only serves a fixed namespace set to browser
+ * configuration clients; the gateway bypasses it through `/api`).
+ *
+ * @module dsh-interpreters/settings
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type Config as ConfigType } from './config.js';
+/** Settings namespace under which interpreter paths persist. */
+export declare const SETTINGS_NAMESPACE: "interpreters";
+/** Read face the gateway and tool re-registration consume. */
+export interface InterpretersSettingsBridge {
+    /** The current resolved config (composition seed while settings is absent). */
+    source(): ConfigType;
+    /** Observe committed changes to the resolved config. */
+    onChange(callback: () => void): void;
+}
+/**
+ * Install the `interpreters` 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 — host composition may mount several
+ * concurrent fibers of this plugin, and only the first registration owns the
+ * namespace.
+ * @param ctx - host context.
+ * @param entry - composition-layer config (cordis.patch.yml seed).
+ * @returns the bridge the gateway and tool re-registration consume.
+ */
+export declare function installInterpretersSettings(ctx: Context, entry: ConfigType): InterpretersSettingsBridge;

package/lib/types/settings.js

@@ -1,83 +1,82 @@
-/**
- * settings.ts — host-side bridge between the `interpreters` settings namespace
- * and the plugin's other halves (tool registration + RPC gateway).
- *
- * The composition `Config` (cordis.patch.yml) is the first-boot seed; once the
- * `ctx.settings` service mounts, the user-editable layer takes over and live
- * re-registration follows every committed change. Headless assemblies without
- * a settings provider fall back to the composition config (no persistence, no
- * live reload).
- *
- * The bridge pattern mirrors `dsh-advisor/src/settings.ts`: a `source()` thunk
- * the gateway reads in-process, plus an `onChange()` subscription the host
- * entry uses to re-register the tools. This avoids any wire-layer allowlist
- * (the DSH settings RPC domain only serves a fixed namespace set to browser
- * configuration clients; the gateway bypasses it through `/api`).
- *
- * @module dsh-interpreters/settings
- */
-import { settingsNamespace } from '@deepseek-ai/dsh-settings';
-import { Config } from './config.js';
-/** Settings namespace under which interpreter paths persist. */
-export const SETTINGS_NAMESPACE = settingsNamespace('interpreters');
-/**
- * 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 `interpreters` 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 — host composition may mount several
- * concurrent fibers of this plugin, and only the first registration owns the
- * namespace.
- * @param ctx - host context.
- * @param entry - composition-layer config (cordis.patch.yml seed).
- * @returns the bridge the gateway and tool re-registration consume.
- */
-export function installInterpretersSettings(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(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('dsh-interpreters').debug('settings namespace already registered — entry-source fallback');
-            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: (cb) => { listeners.add(cb); },
-    };
-}
+/**
+ * settings.ts — host-side bridge between the `interpreters` settings namespace
+ * and the plugin's other halves (tool registration + RPC gateway).
+ *
+ * The composition `Config` (cordis.patch.yml) is the first-boot seed; once the
+ * `ctx.settings` service mounts, the user-editable layer takes over and live
+ * re-registration follows every committed change. Headless assemblies without
+ * a settings provider fall back to the composition config (no persistence, no
+ * live reload).
+ *
+ * The bridge pattern mirrors `dsh-advisor/src/settings.ts`: a `source()` thunk
+ * the gateway reads in-process, plus an `onChange()` subscription the host
+ * entry uses to re-register the tools. This avoids any wire-layer allowlist
+ * (the DSH settings RPC domain only serves a fixed namespace set to browser
+ * configuration clients; the gateway bypasses it through `/api`).
+ *
+ * @module dsh-interpreters/settings
+ */
+import { Config } from './config.js';
+/** Settings namespace under which interpreter paths persist. */
+export const SETTINGS_NAMESPACE = 'interpreters';
+/**
+ * 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 `interpreters` 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 — host composition may mount several
+ * concurrent fibers of this plugin, and only the first registration owns the
+ * namespace.
+ * @param ctx - host context.
+ * @param entry - composition-layer config (cordis.patch.yml seed).
+ * @returns the bridge the gateway and tool re-registration consume.
+ */
+export function installInterpretersSettings(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(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('dsh-interpreters').debug('settings namespace already registered — entry-source fallback');
+            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: (cb) => { listeners.add(cb); },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huanlin/dsh-plugin-interpreters",
-  "version": "0.2.3",
+  "version": "0.4.0",
   "publishConfig": {
     "access": "public"
   },
@@ -33,26 +33,26 @@
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-connection",
-        "@deepseek-ai/dsh-client-ui-settings-plugins",
-        "@deepseek-ai/dsh-client-ui-slots"
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-settings-plugins"
       ],
       "platform": "web"
     }
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1-rc.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.8",
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.5-rc.1",
     "react": "^18.2.0",
     "schemastery": "^3.18.0"
   },
@@ -66,7 +66,10 @@
     "@deepseek-ai/dsh-client-locale": {
       "optional": true
     },
-    "@deepseek-ai/dsh-client-runtime": {
+    "@deepseek-ai/dsh-client-store": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-renderer": {
       "optional": true
     },
     "@deepseek-ai/dsh-client-ui-settings-plugins": {
@@ -95,20 +98,17 @@
     }
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1-rc.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.8",
+    "@deepseek-ai/cordis": "link:D:/Projects/deepseek-harness/dsh/vendor/cordis",
+    "@deepseek-ai/dsh-client-store": "link:D:/Projects/deepseek-harness/dsh/packages/client/store",
+    "@deepseek-ai/dsh-client-ui-primitives": "link:D:/Projects/deepseek-harness/dsh/packages/client/ui-primitives",
+    "@deepseek-ai/dsh-client-ui-slots": "link:D:/Projects/deepseek-harness/dsh/packages/client/ui-slots",
+    "@deepseek-ai/dsh-settings": "link:D:/Projects/deepseek-harness/dsh/packages/settings/settings",
+    "@deepseek-ai/dsh-tools": "link:D:/Projects/deepseek-harness/dsh/packages/core/tools",
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.1",
     "esbuild": "^0.28.2",
     "lightningcss": "^1.29.2",
+    "schemastery": "^3.18.0",
     "tsdown": "^0.22.2",
     "typescript": "^5.9.0",
     "use-sync-external-store": "^1.2.0",