dsh-mcp 1.8.0 → 1.9.0

package/CHANGELOG.en.md

@@ -9,6 +9,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.9.0] - 2026-08-28
+
+### Added
+
+- **Tool-list stability (better prompt-cache hits)**: tool schemas are canonicalized (recursive key sorting) before registration, so servers reordering schema keys no longer triggers dispose/re-register churn; MCP tools in the system prompt are rendered in stable name order, so the same tool set renders byte-identically no matter the hot-set or `tools/list` order
+
 ## [1.8.0] - 2026-08-27
 
 ### Added

package/CHANGELOG.md

@@ -9,6 +9,12 @@
 
 ## [Unreleased]
 
+## [1.9.0] - 2026-08-28
+
+### 新增
+
+- **工具列表稳定化增强（提升 prompt cache 命中）**：注册前对工具 schema 做规范化（递归排序键），服务器返回的键顺序变化不再导致工具被误判为变化而注销重注册；系统提示词中 MCP 工具按名称稳定排序，同一工具集合的渲染文本恒定——热注入集（search 模式每次调用都会变动）与服务器 `tools/list` 顺序不再影响提示词稳定性
+
 ## [1.8.0] - 2026-08-27
 
 ### 新增

package/lib/index.js

@@ -1182,6 +1182,16 @@ let McpManagerService = (() => {
 					});
 				}
 				assembly.tools = kept;
+				// Canonical tool order: render MCP tools sorted by name so the
+				// system prompt stays byte-stable for the same tool set no
+				// matter the registration or hot-set order (hot tools move on
+				// every call, and servers may reorder tools/list) — stable
+				// output is what preserves prompt-cache hits.
+				const mcpKept = [];
+				const otherKept = [];
+				for (const tool of assembly.tools) (tool.name.startsWith("mcp__") ? mcpKept : otherKept).push(tool);
+				mcpKept.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+				assembly.tools = [...otherKept, ...mcpKept];
 				return next();
 			});
 			this.ctx.on("tools/result", (exec) => {

package/lib/mcp-client.js

@@ -205,9 +205,22 @@ function toolPublicEqual(a, b) {
 	if (!jsonEqual(a.parameters, b.parameters)) return false;
 	return jsonEqual(a.output && a.output.schema, b.output && b.output.schema);
 }
-/** Deep equality of JSON-serializable values (schema objects). */
+/**
+* Recursively sort object keys so semantically identical JSON compares equal
+* regardless of key order (servers often reorder schema keys between lists).
+*/
+function canonicalize(value) {
+	if (Array.isArray(value)) return value.map(canonicalize);
+	if (value !== null && typeof value === "object") {
+		const out = {};
+		for (const key of Object.keys(value).sort()) out[key] = canonicalize(value[key]);
+		return out;
+	}
+	return value;
+}
+/** Deep equality of JSON-serializable values, ignoring object key order. */
 function jsonEqual(a, b) {
-	return JSON.stringify(a ?? null) === JSON.stringify(b ?? null);
+	return JSON.stringify(canonicalize(a ?? null)) === JSON.stringify(canonicalize(b ?? null));
 }
 /** Keep a supported advertised schema; unsupported MCP vocabulary falls back to JsonValue. */
 function supportedOutputSchema(candidate) {
@@ -225,7 +238,11 @@ function createDefinition(client, ctx, publicName, rawName, description, paramet
 	return {
 		name: publicName,
 		description,
-		parameters,
+		// Canonicalize before registration: servers often return JSON Schema
+		// with unstable key ordering; sorting keys keeps the model-visible tool
+		// list byte-stable across re-syncs and reconnects, which is what
+		// preserves prompt-cache hits.
+		parameters: canonicalize(parameters),
 		output: createOutput(rawName, structuredSchema),
 		execute: createExecutor(client, ctx, rawName, taskRequired, opts, projections),
 		finalizeContent(exec, result) {
@@ -249,7 +266,7 @@ function createOutput(rawName, structuredSchema) {
 					type: "array",
 					items: {}
 				},
-				structuredContent: structuredSchema ?? {}
+				structuredContent: canonicalize(structuredSchema ?? {})
 			},
 			required: structuredSchema === void 0 ? ["content"] : ["content", "structuredContent"],
 			additionalProperties: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mcp",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "MCP 管理界面 + tool search：可视化配置/启停/刷新 MCP 服务器与工具勾选，按需检索（tool search）热注入；工具列表稳定命中缓存、不撑爆上下文。DeepSeek Harness plugin: MCP management UI + tool search — stable tool list, cache-friendly, no context bloat.",
   "type": "module",
   "main": "lib/index.js",