@yadsh/dsh-sleev 0.0.2 → 0.0.4

package/README.md

@@ -10,7 +10,7 @@ Sleev routing observability for [DeepSeek Harness](https://github.com/deepseek-a
 
 `dsh-sleev` observes provider routes that pass through the external Sleev context-optimization gateway. The current observer does not rewrite prompts, implement compaction, or route traffic itself: routing remains a normal `@deepseek-ai/dsh-llm-pi-ai` provider configuration.
 
-[简体中文](README.zh-CN.md) · [Specification](dsh-sleev-spec-v0.1.md) · [Development guide](docs/development.md) · [Compatibility notes](docs/compatibility.md)
+[简体中文](README.zh-CN.md) · [Specification](SPEC.md) · [Development guide](docs/development.md) · [Compatibility notes](docs/compatibility.md)
 
 ## Installation
 

package/README.zh-CN.md

@@ -10,7 +10,7 @@
 
 `dsh-sleev` 用于观测经由外部 Sleev 上下文优化网关的提供商路由。当前观测器不会改写提示词、实现压缩或自行路由流量；路由仍由普通的 `@deepseek-ai/dsh-llm-pi-ai` 提供商配置负责。
 
-[English](README.md) · [规范](dsh-sleev-spec-v0.1.md) · [开发指南](docs/development.md) · [兼容性说明](docs/compatibility.md)
+[English](README.md) · [规范](SPEC.md) · [开发指南](docs/development.md) · [兼容性说明](docs/compatibility.md)
 
 ## 安装
 

package/compatibility.json

@@ -0,0 +1,16 @@
+{
+  "deepseekHarness": {
+    "channel": "next",
+    "range": ">=0.1.1-rc.2 <0.2.0",
+    "testedReleases": [
+      "0.1.1-rc.2"
+    ],
+    "requiredHostFeatures": [
+      "llm/stream"
+    ],
+    "requiredClientFeatures": [
+      "settings.plugin.item"
+    ]
+  },
+  "node": "^22.19.0 || >=24.0.0"
+}

package/docs/development.md

@@ -3,7 +3,7 @@
 ## Prerequisites
 
 - Node.js 22.19+ or 24+
-- pnpm 11
+- pnpm 10.4.1
 - DeepSeek Harness 0.1.1-rc.2
 - Sleev CLI 1.7.7 for a real gateway test
 

package/lib/client.js

@@ -4,9 +4,110 @@ window.__ModuleLoader__.load({
 		var module = { exports: {} };
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react_jsx_runtime = require("react/jsx-runtime");
 		let react = require("react");
 		let _deepseek_ai_dsh_client_runtime_client = require("@deepseek-ai/dsh-client-runtime/client");
-		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region ../../packages/plugin-kit/lib/client/plugin-card-css.js
+		/**
+		* Canonical DSH settings-plugin card shell CSS — the single source of truth
+		* for the shared `dsh-plugin-card` outer shell (see AGENTS.md). Plugins must
+		* inject this CSS unchanged and may only append rules for their own controls
+		* inside the card body; plugin-specific shell styling is forbidden.
+		*/
+		const PLUGIN_CARD_SHELL_CSS = `
+.dsh-plugin-card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;list-style:none;transition:border-color .16s,background .16s}
+.dsh-plugin-card:hover{border-color:var(--dsw-alias-label-dimmed)}
+.dsh-plugin-card--open{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-label-dimmed)}
+.dsh-plugin-card__header{appearance:none;width:100%;font:inherit;color:inherit;text-align:left;cursor:pointer;background:0 0;border:0;border-radius:12px;align-items:center;gap:12px;padding:14px 16px;display:flex}
+.dsh-plugin-card__header:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:-2px}
+.dsh-plugin-card__head-text{flex-direction:column;flex:1;gap:4px;min-width:0;display:flex}
+.dsh-plugin-card__name{color:var(--dsw-alias-label-primary);font-size:15px;font-weight:600;line-height:1.4}
+.dsh-plugin-card__description{color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}
+.dsh-plugin-card__badge{white-space:nowrap;background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary);border-radius:999px;flex:none;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}
+.dsh-plugin-card__chevron{width:14px;height:14px;color:var(--dsw-alias-label-tertiary);flex:none;transition:transform .16s}
+.dsh-plugin-card--open .dsh-plugin-card__chevron{transform:rotate(180deg)}
+.dsh-plugin-card__body{border-top:1px solid var(--dsw-alias-border-l2);margin:0 16px;padding-bottom:8px}
+`;
+		//#endregion
+		//#region ../../packages/plugin-kit/lib/client/chevron.js
+		/**
+		* The standard disclosure chevron of the shared settings-card shell: a
+		* 14x14 inline SVG stroked with `currentColor` (round caps and joins).
+		* Font glyphs must not be used for this shape — their appearance and
+		* baseline vary by font and encoding.
+		*/
+		function ChevronDown() {
+			return (0, react_jsx_runtime.jsx)("svg", {
+				className: "dsh-plugin-card__chevron",
+				viewBox: "0 0 14 14",
+				fill: "none",
+				"aria-hidden": "true",
+				children: (0, react_jsx_runtime.jsx)("path", {
+					d: "m3.5 5.25 3.5 3.5 3.5-3.5",
+					stroke: "currentColor",
+					strokeLinecap: "round",
+					strokeLinejoin: "round"
+				})
+			});
+		}
+		//#endregion
+		//#region ../../packages/plugin-kit/lib/client/card-shell.js
+		/**
+		* Shared outer shell of a plugin configuration card (AGENTS.md contract): a
+		* direct `<li>` child of the host list with a full-width header button
+		* (`type="button"`, `aria-expanded`, accessible show/hide label, the
+		* title/description stack, an optional status badge, then the chevron) and a
+		* body rendered only while open. Plugin-specific controls belong inside the
+		* body and must not restyle the shell.
+		*/
+		function CardShell(props) {
+			const [open, setOpen] = (0, react.useState)(false);
+			const body = props.bodyClassName === void 0 ? "dsh-plugin-card__body" : `dsh-plugin-card__body ${props.bodyClassName}`;
+			return (0, react_jsx_runtime.jsxs)("li", {
+				className: open ? "dsh-plugin-card dsh-plugin-card--open" : "dsh-plugin-card",
+				children: [(0, react_jsx_runtime.jsxs)("button", {
+					type: "button",
+					className: "dsh-plugin-card__header",
+					"aria-expanded": open,
+					"aria-label": props.label(open),
+					onClick: () => {
+						setOpen(!open);
+					},
+					children: [
+						(0, react_jsx_runtime.jsxs)("span", {
+							className: "dsh-plugin-card__head-text",
+							children: [(0, react_jsx_runtime.jsx)("span", {
+								className: "dsh-plugin-card__name",
+								children: props.title
+							}), (0, react_jsx_runtime.jsx)("span", {
+								className: "dsh-plugin-card__description",
+								children: props.description
+							})]
+						}),
+						props.badge ?? null,
+						(0, react_jsx_runtime.jsx)(ChevronDown, {})
+					]
+				}), open ? (0, react_jsx_runtime.jsx)("div", {
+					className: body,
+					children: props.children
+				}) : null]
+			});
+		}
+		/**
+		* Register the card component into the shared settings-plugins slot. Returns
+		* the registration disposer. Use this variant when the plugin drives the
+		* slot's inject-factory itself (e.g. to dispose a form controller alongside).
+		*/
+		function registerSettingsSlot(host, options) {
+			const slotOptions = {
+				name: options.slotName ?? "settings.plugin.item",
+				key: options.key,
+				...options.locale === void 0 ? {} : { locale: options.locale },
+				...options.inject === void 0 ? {} : { inject: options.inject }
+			};
+			return host.slots.register(slotOptions, options.component);
+		}
+		//#endregion
 		//#region src/client/settings-controller.ts
 		const DEFAULTS = {
 			routes: [],
@@ -239,18 +340,8 @@ window.__ModuleLoader__.load({
 			save: "保存",
 			saving: "保存中…"
 		};
-		const CARD_STYLES = `
-.dsh-sleev-card{list-style:none;border:1px solid var(--dsw-alias-border-l2);border-radius:12px;background:var(--dsw-alias-bg-layer-3);transition:border-color .16s ease,background .16s ease}
-.dsh-sleev-card:hover{border-color:var(--dsw-alias-border-label-dimmed)}
-.dsh-sleev-card.dsh-sleev-card-open{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-border-label-dimmed)}
-.dsh-sleev-header{width:100%;appearance:none;border:0;background:none;font:inherit;color:inherit;text-align:left;cursor:pointer;display:flex;align-items:center;gap:12px;padding:14px 16px;border-radius:12px}
-.dsh-sleev-header:focus-visible,.dsh-sleev-button:focus-visible,.dsh-sleev-reset:focus-visible,.dsh-sleev-input:focus-visible{outline:2px solid var(--dsw-alias-border-brand);outline-offset:2px}
-.dsh-sleev-head-text{flex:1;min-width:0;display:flex;flex-direction:column;gap:4px}
-.dsh-sleev-name{font-size:15px;font-weight:600;line-height:1.4;color:var(--dsw-alias-label-primary)}
-.dsh-sleev-description{font-size:13px;line-height:1.5;color:var(--dsw-alias-label-tertiary)}
-.dsh-sleev-chevron{flex:none;color:var(--dsw-alias-label-tertiary);transition:transform .16s ease;font-size:16px;line-height:1}
-.dsh-sleev-card-open .dsh-sleev-chevron{transform:rotate(180deg)}
-.dsh-sleev-body{border-top:1px solid var(--dsw-alias-border-l2);margin:0 16px;padding-bottom:8px}
+		const CARD_STYLES = `${PLUGIN_CARD_SHELL_CSS}
+.dsh-sleev-button:focus-visible,.dsh-sleev-reset:focus-visible,.dsh-sleev-input:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:2px}
 .dsh-sleev-read-only{margin:12px 0 0;font-size:12px;line-height:1.5;color:var(--dsw-alias-label-tertiary)}
 .dsh-sleev-pill{border-radius:999px;padding:1px 8px;font-size:11px;line-height:17px;font-weight:500;background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary);white-space:nowrap}
 .dsh-sleev-field{display:flex;flex-direction:column;gap:6px;padding:12px 0}
@@ -312,7 +403,6 @@ textarea.dsh-sleev-input{height:64px;min-height:48px;padding:8px 12px;resize:ver
 		}
 		/** Settings card contributed to the official Plugins → Plugin configuration tab. */
 		function SleevSettingsCard(props) {
-			const [open, setOpen] = (0, react.useState)(false);
 			const state = props.useSleevSettings((snapshot) => snapshot);
 			if (!state.available) return null;
 			const blocked = !state.dirty || state.invalid || state.saving || !state.writable;
@@ -324,140 +414,116 @@ textarea.dsh-sleev-input{height:64px;min-height:48px;padding:8px 12px;resize:ver
 				resetLabel: props.t("reset"),
 				onReset: () => props.resetField(field)
 			});
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", {
-				className: `dsh-sleev-card${open ? " dsh-sleev-card-open" : ""}`,
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
-					type: "button",
-					className: "dsh-sleev-header",
-					"aria-expanded": open,
-					"aria-label": `${props.t(open ? "collapse" : "expand")}: Sleev`,
-					onClick: () => setOpen(!open),
-					children: [
-						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-							className: "dsh-sleev-head-text",
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-								className: "dsh-sleev-name",
-								children: props.t("title")
-							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-								className: "dsh-sleev-description",
-								children: props.t("description")
-							})]
-						}),
-						state.dirty ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-							className: "dsh-sleev-pill",
-							children: props.t("unsaved")
-						}) : null,
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-							className: "dsh-sleev-chevron",
-							"aria-hidden": "true",
-							children: "⌄"
-						})
-					]
-				}), open ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-					className: "dsh-sleev-body",
-					children: [
-						!state.writable ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-							className: "dsh-sleev-read-only",
-							role: "status",
-							children: props.t("readOnly")
-						}) : null,
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SettingsField, {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(CardShell, {
+				title: props.t("title"),
+				description: props.t("description"),
+				label: (open) => `${props.t(open ? "collapse" : "expand")}: Sleev`,
+				badge: state.dirty ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: "dsh-plugin-card__badge",
+					children: props.t("unsaved")
+				}) : void 0,
+				children: [
+					!state.writable ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "dsh-sleev-read-only",
+						role: "status",
+						children: props.t("readOnly")
+					}) : null,
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SettingsField, {
+						id: "sleev-routes",
+						label: props.t("routes"),
+						hint: props.t("routesHint"),
+						...common("routes"),
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("textarea", {
 							id: "sleev-routes",
-							label: props.t("routes"),
-							hint: props.t("routesHint"),
-							...common("routes"),
-							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("textarea", {
-								id: "sleev-routes",
-								className: "dsh-sleev-input",
-								value: state.routes.text,
-								disabled: !state.writable,
-								onChange: edit("routes")
-							})
-						}),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SettingsField, {
+							className: "dsh-sleev-input",
+							value: state.routes.text,
+							disabled: !state.writable,
+							onChange: edit("routes")
+						})
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SettingsField, {
+						id: "sleev-route-prefixes",
+						label: props.t("routePrefixes"),
+						hint: props.t("routePrefixesHint"),
+						...common("routePrefixes"),
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("textarea", {
 							id: "sleev-route-prefixes",
-							label: props.t("routePrefixes"),
-							hint: props.t("routePrefixesHint"),
-							...common("routePrefixes"),
-							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("textarea", {
-								id: "sleev-route-prefixes",
-								className: "dsh-sleev-input",
-								value: state.routePrefixes.text,
-								disabled: !state.writable,
-								onChange: edit("routePrefixes")
-							})
-						}),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SettingsField, {
+							className: "dsh-sleev-input",
+							value: state.routePrefixes.text,
+							disabled: !state.writable,
+							onChange: edit("routePrefixes")
+						})
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SettingsField, {
+						id: "sleev-max-recent-calls",
+						label: props.t("maxRecentCalls"),
+						hint: props.t("maxRecentCallsHint"),
+						invalidLabel: props.t("invalidNumber"),
+						...common("maxRecentCalls"),
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
 							id: "sleev-max-recent-calls",
-							label: props.t("maxRecentCalls"),
-							hint: props.t("maxRecentCallsHint"),
-							invalidLabel: props.t("invalidNumber"),
-							...common("maxRecentCalls"),
-							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
-								id: "sleev-max-recent-calls",
-								className: "dsh-sleev-input",
-								type: "number",
-								min: 1,
-								step: 1,
-								value: state.maxRecentCalls.text,
-								disabled: !state.writable,
-								"aria-invalid": state.maxRecentCalls.invalid,
-								onChange: edit("maxRecentCalls")
-							})
-						}),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SettingsField, {
+							className: "dsh-sleev-input",
+							type: "number",
+							min: 1,
+							step: 1,
+							value: state.maxRecentCalls.text,
+							disabled: !state.writable,
+							"aria-invalid": state.maxRecentCalls.invalid,
+							onChange: edit("maxRecentCalls")
+						})
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SettingsField, {
+						id: "sleev-log-level",
+						label: props.t("logLevel"),
+						hint: props.t("logLevelHint"),
+						...common("logLevel"),
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
 							id: "sleev-log-level",
-							label: props.t("logLevel"),
-							hint: props.t("logLevelHint"),
-							...common("logLevel"),
-							children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
-								id: "sleev-log-level",
-								className: "dsh-sleev-input",
-								value: state.logLevel.text,
-								disabled: !state.writable,
-								onChange: edit("logLevel"),
-								children: [
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
-										value: "off",
-										children: props.t("logOff")
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
-										value: "info",
-										children: props.t("logInfo")
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
-										value: "debug",
-										children: props.t("logDebug")
-									})
-								]
-							})
-						}),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-							className: "dsh-sleev-footer",
+							className: "dsh-sleev-input",
+							value: state.logLevel.text,
+							disabled: !state.writable,
+							onChange: edit("logLevel"),
 							children: [
-								state.failed ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-									className: "dsh-sleev-save-error",
-									role: "status",
-									children: props.t("saveFailed")
-								}) : null,
-								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-									type: "button",
-									className: "dsh-sleev-button dsh-sleev-discard",
-									disabled: !state.dirty || state.saving,
-									onClick: props.discard,
-									children: props.t("discard")
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+									value: "off",
+									children: props.t("logOff")
 								}),
-								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-									type: "button",
-									className: "dsh-sleev-button dsh-sleev-save",
-									disabled: blocked,
-									onClick: props.save,
-									children: props.t(state.saving ? "saving" : "save")
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+									value: "info",
+									children: props.t("logInfo")
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+									value: "debug",
+									children: props.t("logDebug")
 								})
 							]
 						})
-					]
-				}) : null]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "dsh-sleev-footer",
+						children: [
+							state.failed ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "dsh-sleev-save-error",
+								role: "status",
+								children: props.t("saveFailed")
+							}) : null,
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "dsh-sleev-button dsh-sleev-discard",
+								disabled: !state.dirty || state.saving,
+								onClick: props.discard,
+								children: props.t("discard")
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "dsh-sleev-button dsh-sleev-save",
+								disabled: blocked,
+								onClick: props.save,
+								children: props.t(state.saving ? "saving" : "save")
+							})
+						]
+					})
+				]
 			});
 		}
 		const inject = [
@@ -480,12 +546,12 @@ textarea.dsh-sleev-input{height:64px;min-height:48px;padding:8px 12px;resize:ver
 			}), "dsh-sleev: settings dictionaries");
 			const controller = new SleevSettingsController(ctx.settingsScope.bind({ namespace: SETTINGS_NAMESPACE }));
 			ctx.slots.inject("settings.plugin.item", () => {
-				const unregister = ctx.slots.register({
-					name: "settings.plugin.item",
+				const unregister = registerSettingsSlot(ctx, {
 					key: SETTINGS_NAMESPACE,
 					locale: LOCALE_NAMESPACE,
+					component: SleevSettingsCard,
 					inject: () => controller.inject()
-				}, SleevSettingsCard);
+				});
 				return () => {
 					controller.dispose();
 					unregister();

package/lib/index.js

@@ -1,5 +1,6 @@
 import { Service } from "@deepseek-ai/cordis";
 import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
+import { createHostLoggerSink, getPluginLogger } from "@yadsh/dsh-plugin-log";
 import z from "@deepseek-ai/schemastery";
 import { isAgentLoopRequest } from "@deepseek-ai/dsh-llm";
 import { randomUUID } from "node:crypto";
@@ -141,13 +142,12 @@ var CallTelemetryStore = class {
 		const startedAt = this.now();
 		let usage;
 		let finished = false;
-		if (startConfig.logLevel === "debug") this.logger.debug(`dsh-sleev: call-start ${JSON.stringify({
+		if (startConfig.logLevel === "debug") this.logger.debug("sleev.call.start", {
 			callId,
 			provider: options.provider,
 			model: options.model,
-			kind,
-			sessionId: options.sessionId
-		})}`);
+			kind
+		});
 		return {
 			observeUsage: (value) => {
 				usage = normalizeUsage(value);
@@ -176,9 +176,20 @@ var CallTelemetryStore = class {
 				this.completed.push(telemetry);
 				const finishConfig = this.reconfigure();
 				if (finishConfig.logLevel !== "off") {
-					const message = `dsh-sleev: call-end ${JSON.stringify(telemetry)}`;
-					if (finishConfig.logLevel === "debug") this.logger.debug(message);
-					else this.logger.info(message);
+					const fields = {
+						callId: telemetry.callId,
+						provider: telemetry.provider,
+						model: telemetry.model,
+						kind: telemetry.kind,
+						durationMs: telemetry.durationMs,
+						...telemetry.providerUsage === void 0 ? {} : {
+							providerUsage: telemetry.providerUsage,
+							derived: telemetry.derived
+						},
+						result: telemetry.result
+					};
+					if (finishConfig.logLevel === "debug") this.logger.debug("sleev.call.end", fields);
+					else this.logger.info("sleev.call.end", fields);
 				}
 			}
 		};
@@ -197,6 +208,9 @@ var CallTelemetryStore = class {
 //#endregion
 //#region src/index.ts
 const name = "dsh-sleev";
+function pluginLogLevel(level) {
+	return level === "off" ? "silent" : level;
+}
 /** User-editable settings section rendered by the browser client card. */
 const SLEEV_SETTINGS_NAMESPACE = settingsNamespace(SLEEV_SETTINGS_NAMESPACE_ID);
 /** Host-side observer service. Routing itself remains owned by llm-pi-ai. */
@@ -204,6 +218,7 @@ var SleevIntegrationService = class extends Service {
 	static inject = ["llm"];
 	static Config = ConfigSchema;
 	telemetry;
+	logger;
 	constructor(ctx, input = {}) {
 		super(ctx, "sleev");
 		const resolvedEntry = resolveConfig(input);
@@ -214,12 +229,26 @@ var SleevIntegrationService = class extends Service {
 			logLevel: resolvedEntry.logLevel
 		};
 		let configSource = () => entry;
-		this.telemetry = new CallTelemetryStore(ctx.logger, () => resolveConfig(configSource()));
+		this.logger = getPluginLogger({
+			pluginId: "dsh-sleev",
+			level: pluginLogLevel(resolvedEntry.logLevel),
+			console: "trace",
+			consoleSink: createHostLoggerSink(ctx.logger)
+		});
+		ctx.effect(() => async () => this.logger.close(), "dsh-sleev.logger");
+		this.telemetry = new CallTelemetryStore(this.logger.child("telemetry"), () => resolveConfig(configSource()));
 		installSettingsSection(ctx, SLEEV_SETTINGS_NAMESPACE, ConfigSchema, entry, {
 			setSource: (current) => {
 				configSource = current;
 			},
-			onChange: () => this.telemetry.reconfigure()
+			onChange: () => {
+				const config = this.telemetry.reconfigure();
+				this.logger.setLevel(pluginLogLevel(config.logLevel));
+				this.logger.info("telemetry.config.updated", {
+					logLevel: config.logLevel,
+					maxRecentCalls: config.maxRecentCalls
+				});
+			}
 		});
 		ctx.on("llm/stream", (options, next) => {
 			const config = resolveConfig(configSource());
@@ -227,10 +256,10 @@ var SleevIntegrationService = class extends Service {
 			const handle = this.telemetry.begin(options, classifyRequest(options));
 			return observeStream(next(), handle);
 		}, { global: true });
-		if (resolvedEntry.logLevel !== "off") ctx.logger.info(`dsh-sleev: observer active ${JSON.stringify({
+		if (resolvedEntry.logLevel !== "off") this.logger.info("plugin.ready", {
 			routes: resolvedEntry.routes,
 			routePrefixes: resolvedEntry.routePrefixes
-		})}`);
+		});
 	}
 	/** Bounded completed-call snapshot; no prompts, headers, or credentials. */
 	listRecentCalls() {

package/lib/types/host/telemetry-store.d.ts

@@ -3,8 +3,8 @@ import type { ResolvedConfig } from "../shared/config.js";
 import type { CallResult, OptimizerCallTelemetry, RequestKind } from "../shared/telemetry.js";
 /** Minimal logger face used by Cordis and isolated unit tests. */
 export interface TelemetryLogger {
-    debug(message: string): void;
-    info(message: string): void;
+    debug(event: string, fields?: Record<string, unknown>): void;
+    info(event: string, fields?: Record<string, unknown>): void;
 }
 /** Mutable handle kept only for the duration of a streaming call. */
 export interface CallHandle {

package/lib/types/index.d.ts

@@ -14,6 +14,7 @@ export declare class SleevIntegrationService extends Service {
     static inject: string[];
     static Config: import("@deepseek-ai/schemastery").default<Config>;
     private readonly telemetry;
+    private readonly logger;
     constructor(ctx: Context, input?: Config);
     /** Bounded completed-call snapshot; no prompts, headers, or credentials. */
     listRecentCalls(): readonly OptimizerCallTelemetry[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yadsh/dsh-sleev",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Sleev routing observability for DeepSeek Harness",
   "repository": {
     "type": "git",
@@ -50,6 +50,7 @@
     "lib/**/*.js",
     "lib/types/**/*.d.ts",
     "cordis.patch.yml",
+    "compatibility.json",
     "docs/*",
     "README.md",
     "README.zh-CN.md",
@@ -79,10 +80,11 @@
     "@deepseek-ai/dsh-settings": ">=0.1.1-rc.2 <0.2.0",
     "react": "^18.2.0"
   },
-  "dependencies": {},
+  "dependencies": {
+    "@yadsh/dsh-plugin-log": "^0.2.1"
+  },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.1",
-    "@deepseek-ai/schemastery": "3.18.1",
     "@deepseek-ai/dsh-client-locale": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-runtime": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-settings": "0.1.1-rc.2",
@@ -91,15 +93,18 @@
     "@deepseek-ai/dsh-llm": "0.1.1-rc.2",
     "@deepseek-ai/dsh-llm-pi-ai": "0.1.1-rc.2",
     "@deepseek-ai/dsh-settings": "0.1.1-rc.2",
+    "@deepseek-ai/schemastery": "3.18.1",
     "@types/node": "^26.4.0",
     "@types/react": "18.3.28",
     "eslint": "10.9.1",
     "prettier": "^3.6.2",
     "react": "18.3.1",
     "tsdown": "^0.22.14",
-    "tsx": "4.22.4",
+    "tsx": "^4.22.4",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.11"
+    "vitest": "^4.1.11",
+    "@yadsh/dsh-plugin-kit": "^0.1.0",
+    "@yadsh/dsh-config": "^0.0.0"
   },
   "publishConfig": {
     "access": "public",