dsh-openrouter-provider-advisor 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 All notable changes to this project are documented here.
 
+## [0.1.4] - 2026-09-04
+
+### Fixed
+
+- Compatible with DSH web `>= 0.1.2-rc.1` again after the breaking client/Host
+  API changes in that release. The previous build failed to load on current
+  DSH because it imported `settingsNamespace` / `installSettingsSection` from
+  `@deepseek-ai/dsh-settings` (both removed in 0.1.2) and injected the removed
+  `apiProxy` service.
+- Host: the OpenRouter settings namespace is now registered through
+  `ctx.settings.register(...)` and read through its live owner scope
+  (`dsh >= 0.1.2` settings API), replacing the removed helper functions.
+- Host: session model catalog reads and session model selections now go
+  through `ctx.sessionController.modelCatalog()` / `selectModel(...)`
+  (the Session business API that replaced the `apiProxy` RPC service).
+- Client: dropped every import from the removed `@deepseek-ai/dsh-client-*`
+  type packages (including `dsh-client-runtime`); the bundle now types the
+  runtime structurally, like current first-party/external plugins.
+- Client: `sidebar.footer.action` / `shell.overlay` seats no longer inject a
+  `useSessions` render prop, so the trigger and overlay read the current
+  session from the root `sessions` service's list store instead.
+- Manifest: `dsh.plugin.json` engine floor raised to `>= 0.1.2-rc.1`, and the
+  client module injection list narrowed to the modules current DSH serves.
+
+### Validation
+
+- 80 automated tests passing (adapter specs updated to the
+  `sessionController` seam).
+- TypeScript typecheck and production build passing.
+- `npm audit --omit=dev` reports zero vulnerabilities.
+
 ## [0.1.3] - 2026-08-25
 
 ### Changed

package/README.md

@@ -47,7 +47,7 @@
 
 ## 安装
 
-前置条件：DSH `0.1.1-rc.2` 或更新版本、Node.js `^22.19.0` 或 `>=24`，并已在 **DSH 设置 → 模型** 中配置 OpenRouter provider/API Key。
+前置条件：DSH `0.1.2-rc.1` 或更新版本（插件适配了 0.1.2 移除 `settingsNamespace`/`installSettingsSection` 与 `apiProxy` 服务后的 Host/Client API）、Node.js `^22.19.0` 或 `>=24`，并已在 **DSH 设置 → 模型** 中配置 OpenRouter provider/API Key。
 
 ```bash
 dsh plugin --profile web add dsh-openrouter-provider-advisor@latest
@@ -148,6 +148,7 @@ POST /api/v1/presets/{slug}/chat/completions
 | 插件已安装但界面没变化 | 硬刷新浏览器；Host 有改动时重启 DSH。 |
 | 未检测到 OpenRouter 凭据 | 在 DSH 设置 → 模型中配置 OpenRouter provider/API Key。 |
 | 某供应商分数高但请求 429 | uptime 有统计延迟，临时切换到其他供应商。 |
+| 面板默认选中的模型不是当前会话选的那一个 | DSH `>= 0.1.2` 的会话级模型选择由前端模型目录维护，Host 目录 API 只提供部署默认；在面板下拉里选择要分析的模型即可，推荐与切换都会按所选模型执行。 |
 | `minimum release age` | 等待 profile 安全策略允许该版本后重试。 |
 | DSH 拒绝 `.env` 中的 `DEEPSEEK_BASE_URL` | 从项目 `.env` 移除，并在启动 DSH 的终端中 `export`。 |
 

package/dsh.plugin.json

@@ -1,10 +1,10 @@
 {
   "id": "dsh-external/dsh-openrouter-provider-advisor",
-  "version": "0.1.0",
+  "version": "0.1.4",
   "main": "./lib/index.js",
-  "description": "OpenRouter 供应商推荐与安全切换：按质量、速度、缓存价格、上下文和可用率排序",
+  "description": "OpenRouter 供应商推荐与安全切换：按质量、速度、缓存价格、上下文和可用率排序（兼容 DSH >= 0.1.2-rc.1）",
   "engines": {
-    "dsh": ">=0.1.1-rc.2"
+    "dsh": ">=0.1.2-rc.1"
   },
   "contributes": {
     "tools": ["recommend_openrouter_providers", "switch_openrouter_provider"],

package/lib/client.js

@@ -670,13 +670,9 @@ function consume(operation) {
 }
 function ProviderSidebarTrigger(props) {
 	const i18n = useUiI18n();
-	const current = props.useSessions((state) => state.current);
-	const currentAddress = props.useSessions((state) => state.currentAddress);
+	const sessionState = (0, react.useSyncExternalStore)(props.sessions.subscribe, props.sessions.getSnapshot, props.sessions.getSnapshot);
 	const panel = (0, react.useSyncExternalStore)(props.store.subscribe, props.store.getSnapshot, props.store.getSnapshot);
-	const target = providerTriggerState({
-		current,
-		currentAddress
-	});
+	const target = providerTriggerState(sessionState);
 	return (0, react.createElement)(react.Fragment, null, (0, react.createElement)("style", null, "div:has(> div[data-slot=\"sidebar.footer.action\"] > button[data-openrouter-provider-trigger]){flex-wrap:wrap;row-gap:4px}"), (0, react.createElement)("button", {
 		type: "button",
 		disabled: target.disabled,
@@ -724,13 +720,9 @@ function freshnessLabel(updatedAt, now, i18n = createI18n("zh-CN")) {
 const providerGridColumns = "minmax(110px,1fr) minmax(0,2fr) minmax(54px,auto)";
 function ProviderOverlay(props) {
 	const i18n = useUiI18n();
-	const current = props.useSessions((state$1) => state$1.current);
-	const currentAddress = props.useSessions((state$1) => state$1.currentAddress);
+	const sessionState = (0, react.useSyncExternalStore)(props.sessions.subscribe, props.sessions.getSnapshot, props.sessions.getSnapshot);
 	const state = (0, react.useSyncExternalStore)(props.store.subscribe, props.store.getSnapshot, props.store.getSnapshot);
-	const target = providerTriggerState({
-		current,
-		currentAddress
-	});
+	const target = providerTriggerState(sessionState);
 	const dialogRef = (0, react.useRef)(null);
 	const [now, setNow] = (0, react.useState)(() => Date.now());
 	(0, react.useEffect)(() => {
@@ -1708,15 +1700,14 @@ function OpenRouterProvidersSettingsCard({ scope }) {
 const inject = [
 	"sessions",
 	"slots",
-	"settingsScope",
-	"locale"
+	"locale",
+	"settingsScope"
 ];
 function apply(ctx) {
-	const client = ctx;
-	attachLocale(client.locale);
+	attachLocale(ctx.locale);
 	ctx.effect(() => {
-		const offZh = client.locale.register(LOCALE_NS, "zh", zh);
-		const offEn = client.locale.register(LOCALE_NS, "en", en);
+		const offZh = ctx.locale.register(LOCALE_NS, "zh", zh);
+		const offEn = ctx.locale.register(LOCALE_NS, "en", en);
 		return () => {
 			offZh();
 			offEn();
@@ -1724,30 +1715,27 @@ function apply(ctx) {
 		};
 	}, "openrouter-providers: locale dictionaries");
 	const panelStore = createProviderPanelStore();
+	const sessions = ctx.sessions.list;
 	const BoundTrigger = (props) => (0, react.createElement)(ProviderSidebarTrigger, {
 		...props,
-		store: panelStore
+		store: panelStore,
+		sessions
 	});
-	const BoundOverlay = (props) => (0, react.createElement)(ProviderOverlay, {
-		...props,
-		store: panelStore
+	const BoundOverlay = () => (0, react.createElement)(ProviderOverlay, {
+		store: panelStore,
+		sessions
 	});
-	client.slots.inject("sidebar.footer.action", () => client.slots.register({
+	ctx.slots.inject("sidebar.footer.action", () => ctx.slots.register({
 		name: "sidebar.footer.action",
 		id: "openrouter-providers-trigger",
 		order: 20
 	}, BoundTrigger));
-	client.slots.inject("shell.overlay", () => client.slots.register({
-		name: "shell.overlay",
-		id: "openrouter-providers-overlay",
-		order: 20
-	}, BoundOverlay));
+	ctx.slots.inject("shell.overlay", () => ctx.slots.register({ name: "shell.overlay" }, BoundOverlay));
 	ctx.effect(() => () => panelStore.dispose(), "openrouter-providers: provider panel store");
-	const scope = client.settingsScope.bind({ namespace: "openrouter-providers" });
-	client.slots.inject("settings.plugin.item", () => client.slots.register({
+	const scope = ctx.settingsScope.bind({ namespace: "openrouter-providers" });
+	ctx.slots.inject("settings.plugin.item", () => ctx.slots.register({
 		name: "settings.plugin.item",
 		key: "openrouter-providers",
-		locale: "openrouter-providers",
 		inject: () => ({ scope })
 	}, OpenRouterProvidersSettingsCard));
 }

package/lib/index.js

@@ -1,5 +1,4 @@
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
-import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import z from "@deepseek-ai/schemastery";
 
@@ -622,10 +621,6 @@ var OpenRouterClient = class {
 
 //#endregion
 //#region src/host-adapter.ts
-function unwrap(operation, response) {
-	if (!response.result.ok) throw new Error(`${operation} failed: ${response.result.error.code}: ${response.result.error.message}`);
-	return response.result.value;
-}
 function createHostController(ctx, config, credentialRef$1) {
 	const clients = /* @__PURE__ */ new Map();
 	const client = (credential) => {
@@ -644,6 +639,7 @@ function createHostController(ctx, config, credentialRef$1) {
 	};
 	const profiles = () => ctx.settings.get("llm-pi-ai")?.providers ?? {};
 	const fallbackRef = "OPENROUTER_API_KEY";
+	const catalog = async () => ctx.sessionController.modelCatalog();
 	return new OpenRouterProviderController({
 		config,
 		credential: async (provider) => {
@@ -670,11 +666,11 @@ function createHostController(ctx, config, credentialRef$1) {
 				source: providerRef === void 0 ? "fallback" : "provider"
 			};
 		},
-		sessionSelection: async (sessionId) => unwrap("session.models", await ctx.apiProxy.sessions.models({ payload: { sessionId } })).current,
-		sessionDirectory: async (sessionId) => {
-			const value = unwrap("session.models", await ctx.apiProxy.sessions.models({ payload: { sessionId } }));
+		sessionSelection: async () => (await catalog()).default,
+		sessionDirectory: async () => {
+			const value = await catalog();
 			return {
-				current: value.current,
+				current: value.default,
 				groups: value.groups ?? []
 			};
 		},
@@ -693,7 +689,7 @@ function createHostController(ctx, config, credentialRef$1) {
 			value: models
 		}]),
 		selectModel: async (selection) => {
-			unwrap("session.selectModel", await ctx.apiProxy.sessions.selectModel({ payload: selection }));
+			await ctx.sessionController.selectModel(selection);
 		},
 		saveDefault: (selection) => ctx.agentDefaultModel.saveSelection(selection)
 	});
@@ -904,15 +900,28 @@ function createProviderTools(defineTool$1, controller) {
 //#endregion
 //#region src/index.ts
 const name = "openrouter-providers";
+/**
+* Required host services.
+*
+* `sessionController` (Session Remote owner, provided by dsh-api-session-controller)
+* replaced the pre-0.1.2 `apiProxy` RPC service that was removed from DSH: the
+* panel now reads the shared model catalog and installs session model
+* selections directly through the Host Session business API.
+*/
 const inject = [
 	"tools",
 	"settings",
 	"credentials",
 	"agentDefaultModel",
-	"apiProxy",
+	"sessionController",
 	"webServer"
 ];
-const NS = settingsNamespace("openrouter-providers");
+/**
+* Settings namespace this plugin owns. Registered through the current
+* `ctx.settings.register` API; the older `settingsNamespace()` helper was
+* removed in DSH 0.1.2.
+*/
+const NS = "openrouter-providers";
 const weights = z.object({
 	quantization: z.number().min(0).max(1).default(.3),
 	speed: z.number().min(0).max(1).default(.3),
@@ -933,16 +942,13 @@ const Config = z.object({
 	uptimePenaltyFactor: z.number().min(0).max(1).default(.85)
 });
 function apply(ctx, initial = DEFAULT_CONFIG) {
-	let source = () => initial;
-	installSettingsSection(ctx, NS, Config, initial, {
-		validate: validateConfig,
-		setSource: (current) => {
-			source = current;
-		},
-		onChange: () => {}
+	const scope = ctx.settings.register(NS, Config, {
+		base: initial,
+		validate: validateConfig
 	});
+	const readConfig = () => scope.get();
 	const host = ctx;
-	const controller = createHostController(host, () => source(), credentialRef);
+	const controller = createHostController(host, readConfig, credentialRef);
 	ctx.effect(() => ctx.on("tools/pre-execute", providerToolApproval), "openrouter-providers: approve provider switch");
 	ctx.effect(() => host.webServer.register({
 		kind: "prefix",

package/lib/types/client/index.d.ts

@@ -1,4 +1,33 @@
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type SessionsListStoreLike } from './provider-panel.js';
+import { type SettingsScopeLike } from './settings-card.js';
+import { type LocaleServiceLike } from './i18n.js';
+/**
+ * Structural client-context subset — mirrors how current external plugins
+ * (dsh-market, dsh-web-updater) type the runtime: the removed
+ * `@deepseek-ai/dsh-client-runtime` type package no longer exists in
+ * DSH >= 0.1.2, so the plugin imports no client type package and types only
+ * the services it touches.
+ */
+export interface OrpClientContext {
+    effect(dispose: () => unknown, label?: string): void;
+    locale: LocaleServiceLike & {
+        register(namespace: string, locale: string, messages: Record<string, string>): () => void;
+    };
+    /** Root sessions service (list store carrying the current session selection). */
+    sessions: {
+        list: SessionsListStoreLike;
+    };
+    slots: {
+        inject(name: string, register: () => unknown): void;
+        register(options: Record<string, unknown>, component: unknown): unknown;
+    };
+    /** Settings-namespace binder provided by the settings section (dsh web >= 0.1.0-rc.7). */
+    settingsScope: {
+        bind(spec: {
+            namespace: string;
+        }): SettingsScopeLike;
+    };
+}
 export declare const inject: string[];
-export declare function apply(ctx: ClientContext): void;
+export declare function apply(ctx: OrpClientContext): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/client/provider-panel.d.ts

@@ -3,12 +3,19 @@ import type { RecommendationResponse } from '../directory.js';
 import type { RankedProvider } from '../types.js';
 import type { RankingStrategy } from '../config.js';
 import type { ProviderPanelStore } from './provider-panel-store.js';
-interface SessionListLike {
+export interface SessionListLike {
     current?: string | undefined;
     currentAddress?: unknown | undefined;
 }
-interface GlobalSlotProps {
-    useSessions<T>(selector: (state: SessionListLike) => T): T;
+/**
+ * Observable snapshot of the root sessions list store. DSH >= 0.1.2 no longer
+ * injects a `useSessions` render prop into `sidebar.footer.action` /
+ * `shell.overlay` occupants, so the components subscribe to the root sessions
+ * service directly (the same list store the useSessions hook reads).
+ */
+export interface SessionsListStoreLike {
+    getSnapshot(): SessionListLike;
+    subscribe(listener: () => void): () => void;
 }
 export interface ProviderRowView {
     group: string;
@@ -52,17 +59,18 @@ export declare function providerTriggerState(state: SessionListLike): {
     disabled: boolean;
 };
 export declare function providerTriggerLayout(wide: boolean): CSSProperties;
-export declare function ProviderSidebarTrigger(props: GlobalSlotProps & {
+export declare function ProviderSidebarTrigger(props: {
     wide: boolean;
     store: ProviderPanelStore;
+    sessions: SessionsListStoreLike;
 }): ReactNode;
 export declare function freshnessLabel(updatedAt: number, now: number, i18n?: {
     locale: import("./i18n.js").SupportedLocale;
     t(key: import("./i18n.js").TranslationKey, params?: Record<string, string | number>): string;
 }): string;
 export declare const providerGridColumns = "minmax(110px,1fr) minmax(0,2fr) minmax(54px,auto)";
-export declare function ProviderOverlay(props: GlobalSlotProps & {
+export declare function ProviderOverlay(props: {
     store: ProviderPanelStore;
+    sessions: SessionsListStoreLike;
 }): ReactNode;
-export {};
 //# sourceMappingURL=provider-panel.d.ts.map

package/lib/types/host-adapter.d.ts

@@ -1,16 +1,21 @@
 import type { Config } from './config.js';
 import { OpenRouterProviderController, type SessionSelection } from './controller.js';
-interface RpcResult<T> {
-    result: {
-        ok: true;
-        value: T;
-    } | {
-        ok: false;
-        error: {
-            code: string;
-            message: string;
-        };
-    };
+/**
+ * Session model catalog surfaced by `ctx.sessionController.modelCatalog()`
+ * (structural subset — the full wire type carries more fields).
+ */
+interface SessionModelCatalog {
+    default: SessionSelection;
+    groups?: Array<{
+        id: string;
+        name: string;
+        models: Array<{
+            id: string;
+            name: string;
+            contextWindow?: number;
+            [key: string]: unknown;
+        }>;
+    }>;
 }
 export interface HostContextLike {
     credentials: {
@@ -26,37 +31,22 @@ export interface HostContextLike {
             value: unknown;
         }>): Promise<void>;
     };
-    apiProxy: {
-        sessions: {
-            models(input: {
-                payload: {
-                    sessionId: string;
-                };
-            }): Promise<RpcResult<{
-                current: SessionSelection;
-                groups?: Array<{
-                    id: string;
-                    name: string;
-                    models: Array<{
-                        id: string;
-                        name: string;
-                    }>;
-                }>;
-            }>>;
-            selectModel(input: {
-                payload: {
-                    sessionId: string;
-                    provider: string;
-                    model: string;
-                    reasoningEffort?: string;
-                };
-            }): Promise<RpcResult<{
-                selected: SessionSelection;
-            }>>;
-        };
+    /**
+     * Host Session business API (dsh >= 0.1.2, provided by dsh-api-session-controller).
+     * Replaces the removed `apiProxy` RPC service: catalog reads and session model
+     * selections now go through this in-process service instead of an HTTP remote.
+     */
+    sessionController: {
+        modelCatalog(): Promise<SessionModelCatalog>;
+        selectModel(request: {
+            sessionId: string;
+            provider: string;
+            model: string;
+            reasoningEffort?: string;
+        }): Promise<unknown>;
     };
     agentDefaultModel: {
-        saveSelection(selection: Omit<SessionSelection, never>): Promise<void>;
+        saveSelection(selection: SessionSelection): Promise<void>;
     };
 }
 export declare function createHostController(ctx: HostContextLike, config: () => Config, credentialRef: (name: string) => unknown): OpenRouterProviderController;

package/lib/types/index.d.ts

@@ -2,8 +2,21 @@ import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import { type Config as ProviderConfig } from './config.js';
 export declare const name = "openrouter-providers";
+/**
+ * Required host services.
+ *
+ * `sessionController` (Session Remote owner, provided by dsh-api-session-controller)
+ * replaced the pre-0.1.2 `apiProxy` RPC service that was removed from DSH: the
+ * panel now reads the shared model catalog and installs session model
+ * selections directly through the Host Session business API.
+ */
 export declare const inject: string[];
-export declare const NS: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+/**
+ * Settings namespace this plugin owns. Registered through the current
+ * `ctx.settings.register` API; the older `settingsNamespace()` helper was
+ * removed in DSH 0.1.2.
+ */
+export declare const NS: "openrouter-providers";
 export declare const Config: z<ProviderConfig>;
 export declare function apply(ctx: Context, initial?: ProviderConfig): void;
 export { OpenRouterProviderDirectory } from './directory.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-openrouter-provider-advisor",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "DSH web plugin that ranks OpenRouter upstream providers by quality, speed, cache-heavy price, context, and uptime, then safely switches the active route.",
   "keywords": [
     "deepseek-harness",
@@ -44,11 +44,7 @@
       "platform": "web",
       "inject": [
         "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-ui-layout",
-        "@deepseek-ai/dsh-client-ui-sidebar",
-        "@deepseek-ai/dsh-client-ui-settings",
-        "@deepseek-ai/dsh-client-ui-settings-plugins"
+        "@deepseek-ai/dsh-client-ui-slots"
       ]
     }
   },
@@ -62,28 +58,14 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@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-layout": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-credentials": "^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/schemastery": "^3.18.1",
     "react": ">=18.2.0 <20"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@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-layout": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-credentials": "^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/schemastery": "^3.18.1",
     "@types/node": "^22.20.0",