@michengai/dsh-codex-ui 0.2.48

package/dist/index.d.mts

@@ -0,0 +1,7 @@
+import { Context } from "@deepseek-ai/cordis";
+//#region src/index.d.ts
+declare const inject: string[];
+/** 提供不泄露地址、命令和凭证的连接器目录。 */
+declare function apply(ctx: Context): void;
+//#endregion
+export { apply, inject };

package/dist/index.mjs

@@ -0,0 +1,312 @@
+import { spawn } from "node:child_process";
+import { readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/dependencies.ts
+const MANAGED_DEPENDENCIES = [
+	{
+		id: "experts",
+		packageName: "@michengai/dsh-agency-agents"
+	},
+	{
+		id: "skills",
+		packageName: "@michengai/dsh-skills-manager"
+	},
+	{
+		id: "archive",
+		packageName: "@michengai/dsh-archive-manager"
+	}
+];
+function managedDependency(id) {
+	return MANAGED_DEPENDENCIES.find((dependency) => dependency.id === id);
+}
+//#endregion
+//#region src/dependency-manager.ts
+function profileDirectory() {
+	if (process.env.DSH_PROFILE_DIR !== void 0) return process.env.DSH_PROFILE_DIR;
+	return resolve(homedir(), ".dsh", "profiles", "web");
+}
+async function profileManifest() {
+	try {
+		return JSON.parse(await readFile(resolve(profileDirectory(), "package.json"), "utf8"));
+	} catch (error) {
+		if (error.code === "ENOENT") return {};
+		throw error;
+	}
+}
+async function installedPackageVersion(packageName) {
+	try {
+		const manifest = JSON.parse(await readFile(resolve(profileDirectory(), "node_modules", ...packageName.split("/"), "package.json"), "utf8"));
+		return typeof manifest.version === "string" ? manifest.version : void 0;
+	} catch (error) {
+		if (error.code === "ENOENT") return void 0;
+		throw error;
+	}
+}
+async function npmLatestVersion(packageName) {
+	try {
+		const response = await fetch(`https://registry.npmjs.org/${encodeURIComponent(packageName)}/latest`, { signal: AbortSignal.timeout(5e3) });
+		if (!response.ok) return void 0;
+		const manifest = await response.json();
+		return typeof manifest.version === "string" ? manifest.version : void 0;
+	} catch {
+		return;
+	}
+}
+function escapeRegExp(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/** 将用户确认的精确版本合并进 Profile 的 pnpm 发布时间保护例外。 */
+function applyReleaseExclude(source, packageName, version) {
+	const eol = source.includes("\r\n") ? "\r\n" : "\n";
+	const existing = new RegExp(`^  - '${escapeRegExp(packageName)}@([^']*)'\\s*$`, "m").exec(source);
+	if (existing !== null) {
+		const versions = existing[1].split(/\s*\|\|\s*/).map((item) => item.trim()).filter((item) => item !== "");
+		if (versions.includes(version)) return source;
+		const next = `  - '${packageName}@${[...versions, version].join(" || ")}'`;
+		return `${source.slice(0, existing.index)}${next}${source.slice(existing.index + existing[0].length)}`;
+	}
+	const entry = `  - '${packageName}@${version}'`;
+	const section = /^minimumReleaseAgeExclude:\r?\n(?:(?:  |\t).*(?:\r?\n|$))*/m;
+	if (section.test(source)) return source.replace(section, (match) => `${match.endsWith("\n") ? match : `${match}${eol}`}${entry}${eol}`);
+	return `${source}${source === "" || source.endsWith("\n") ? "" : eol}minimumReleaseAgeExclude:${eol}${entry}${eol}`;
+}
+/** 将用户本次确认的精确版本加入 Profile 的 pnpm 发布时间保护例外。 */
+async function ensureLatestReleaseAllowed(packageName, version) {
+	if (versionParts(version) === void 0) throw new Error("npm 返回了无法识别的最新版本。");
+	const path = resolve(profileDirectory(), "pnpm-workspace.yaml");
+	let source;
+	try {
+		source = await readFile(path, "utf8");
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+		source = "";
+	}
+	const next = applyReleaseExclude(source, packageName, version);
+	if (next !== source) await writeFile(path, next, "utf8");
+}
+function versionParts(version) {
+	const match = /^v?(\d+)\.(\d+)\.(\d+)/.exec(version);
+	return match === null ? void 0 : [
+		Number(match[1]),
+		Number(match[2]),
+		Number(match[3])
+	];
+}
+function newerVersion(installed, latest) {
+	const current = versionParts(installed);
+	const candidate = versionParts(latest);
+	if (current === void 0 || candidate === void 0) return false;
+	return candidate[0] > current[0] || candidate[0] === current[0] && candidate[1] > current[1] || candidate[0] === current[0] && candidate[1] === current[1] && candidate[2] > current[2];
+}
+/** 返回 Web profile 中固定管理插件的实际安装版本与 npm latest 状态。 */
+async function dependencyStatuses() {
+	const manifest = await profileManifest();
+	return Promise.all(MANAGED_DEPENDENCIES.map(async (dependency) => {
+		if ((manifest.dependencies?.[dependency.packageName] ?? manifest.devDependencies?.[dependency.packageName]) === void 0) return {
+			...dependency,
+			installed: false,
+			updateAvailable: false
+		};
+		const version = await installedPackageVersion(dependency.packageName);
+		if (version === void 0) return {
+			...dependency,
+			installed: false,
+			updateAvailable: false
+		};
+		const latestVersion = await npmLatestVersion(dependency.packageName);
+		return {
+			...dependency,
+			installed: true,
+			version,
+			latestVersion,
+			updateAvailable: latestVersion !== void 0 && newerVersion(version, latestVersion)
+		};
+	}));
+}
+/**
+* 把当前进程的 CLI 入口收成绝对路径。源码启动时 argv[1] 常是相对路径，
+* 若再把 cwd 切到 dirname(entry)，子进程会去错误目录找 bin.ts。
+*/
+function resolveDshCliEntry(entry = process.argv[1], cwd = process.cwd()) {
+	if (entry === void 0 || entry === "") throw new Error("无法定位 DSH CLI。请从 DSH 命令启动 Web 服务后重试。");
+	if (entry.startsWith("file:")) return fileURLToPath(entry);
+	return resolve(cwd, entry);
+}
+function pluginCommandError(stderr) {
+	const detail = stderr.replace(/\s+/g, " ").trim();
+	if (detail.includes("minimumReleaseAge") || detail.includes("Release age")) return /* @__PURE__ */ new Error("更新被 pnpm 发布时间保护拦截。请确认已写入当前版本白名单后重试。");
+	if (detail.includes("EPERM") || detail.includes("EBUSY") || detail.includes("EACCES")) return /* @__PURE__ */ new Error("无法覆盖正在运行的插件文件。请先停止 DSH Web，再点击更新。");
+	return /* @__PURE__ */ new Error("从 npm 安装或更新依赖失败。请检查网络、npm registry 或发布时间保护后重试。");
+}
+/**
+* 复用启动当前服务的 DSH CLI：它会通过 pnpm 从 npm 安装或更新，并自动维护
+* dsh.profile.bundles，避免浏览器端直接管理 profile 文件。
+*/
+function runDshPlugin(args) {
+	const entry = resolveDshCliEntry();
+	return new Promise((resolvePromise, reject) => {
+		const child = spawn(process.execPath, [
+			...process.execArgv,
+			entry,
+			"plugin",
+			"--profile",
+			"web",
+			...args
+		], {
+			cwd: process.cwd(),
+			env: {
+				...process.env,
+				CI: "true"
+			},
+			windowsHide: true,
+			stdio: [
+				"ignore",
+				"ignore",
+				"pipe"
+			]
+		});
+		let stderr = "";
+		child.stderr?.on("data", (chunk) => {
+			stderr += String(chunk);
+		});
+		child.once("error", () => {
+			reject(/* @__PURE__ */ new Error("无法启动 DSH 插件安装命令。请确认 Node.js 与 pnpm 可用后重试。"));
+		});
+		child.once("exit", (code) => {
+			code === 0 ? resolvePromise() : reject(pluginCommandError(stderr));
+		});
+	});
+}
+/** 仅允许安装固定依赖，避免把浏览器输入转成任意命令。 */
+async function installDependency(id) {
+	const dependency = managedDependency(id);
+	if (dependency === void 0) throw new Error("不支持安装该依赖。");
+	const latestVersion = await npmLatestVersion(dependency.packageName);
+	if (latestVersion === void 0) throw new Error("无法获取 npm 最新版本，请检查网络或 npm registry 后重试。");
+	await ensureLatestReleaseAllowed(dependency.packageName, latestVersion);
+	await runDshPlugin(["add", `${dependency.packageName}@${latestVersion}`]);
+	const installed = await installedPackageVersion(dependency.packageName);
+	if (installed !== latestVersion) throw new Error(`已请求 ${dependency.packageName}@${latestVersion}，但当前仍是 ${installed ?? "未安装"}。请先停止 DSH Web 后再更新。`);
+	return dependencyStatuses();
+}
+//#endregion
+//#region src/host-services.ts
+function requireService(ctx, key, method) {
+	const service = ctx.get(key);
+	if (service === null || typeof service !== "object" || typeof service[method] !== "function") throw new Error(`michengai-codex-ui 需要宿主服务 “${key}.${String(method)}”`);
+	return service;
+}
+/** 在唯一的宿主边界校验服务能力；宿主 API 变更时立即失败，不会静默返回 503。 */
+function hostServices(ctx) {
+	return {
+		webServer: requireService(ctx, "webServer", "register"),
+		sessions: requireService(ctx, "sessions", "get"),
+		agents: requireService(ctx, "agents", "get"),
+		tools: requireService(ctx, "tools", "schemas")
+	};
+}
+//#endregion
+//#region src/index.ts
+const connectorsEndpoint = "/api/michengai/codex-ui/connectors";
+const dependenciesEndpoint = "/api/michengai/codex-ui/dependencies";
+const inject = [
+	"webServer",
+	"sessions",
+	"agents",
+	"tools"
+];
+/** 提供不泄露地址、命令和凭证的连接器目录。 */
+function apply(ctx) {
+	const host = hostServices(ctx);
+	ctx.effect(() => {
+		const disposeConnectors = host.webServer.register({
+			kind: "exact",
+			path: connectorsEndpoint,
+			handler: async (request, response) => {
+				if (request.method !== "GET" && request.method !== "HEAD") {
+					response.writeHead(405);
+					response.end();
+					return;
+				}
+				try {
+					const sessionId = new URL(request.url ?? "/", "http://localhost").searchParams.get("sessionId");
+					const scope = sessionId === null ? void 0 : host.agents.get(sessionId);
+					const connectors = /* @__PURE__ */ new Map();
+					for (const tool of host.tools.schemas(scope)) {
+						const match = /^mcp__([A-Za-z0-9_-]+?)__(.+)$/.exec(tool.name);
+						if (match === null) continue;
+						const [, serverName, toolName] = match;
+						const tools = connectors.get(serverName) ?? [];
+						tools.push({
+							name: toolName,
+							description: tool.description ?? ""
+						});
+						connectors.set(serverName, tools);
+					}
+					const payload = [...connectors].sort(([a], [b]) => a.localeCompare(b)).map(([name, tools]) => ({
+						name,
+						tools
+					}));
+					response.writeHead(200, {
+						"content-type": "application/json; charset=utf-8",
+						"cache-control": "no-store"
+					});
+					response.end(request.method === "HEAD" ? void 0 : JSON.stringify({ connectors: payload }));
+				} catch {
+					response.writeHead(503, {
+						"content-type": "application/json; charset=utf-8",
+						"cache-control": "no-store"
+					});
+					response.end(JSON.stringify({ error: "连接器目录暂不可用。" }));
+				}
+			}
+		});
+		const disposeDependencies = host.webServer.register({
+			kind: "exact",
+			path: dependenciesEndpoint,
+			handler: async (request, response) => {
+				const url = new URL(request.url ?? "/", "http://localhost");
+				try {
+					if (request.method === "GET") {
+						const dependencies = await dependencyStatuses();
+						response.writeHead(200, {
+							"content-type": "application/json; charset=utf-8",
+							"cache-control": "no-store"
+						});
+						response.end(JSON.stringify({ dependencies }));
+						return;
+					}
+					if (request.method === "POST") {
+						const dependencies = await installDependency(url.searchParams.get("dependency"));
+						response.writeHead(200, {
+							"content-type": "application/json; charset=utf-8",
+							"cache-control": "no-store"
+						});
+						response.end(JSON.stringify({
+							dependencies,
+							restartRequired: true
+						}));
+						return;
+					}
+					response.writeHead(405);
+					response.end();
+				} catch (error) {
+					const message = error instanceof Error ? error.message : "依赖管理暂不可用。";
+					response.writeHead(503, {
+						"content-type": "application/json; charset=utf-8",
+						"cache-control": "no-store"
+					});
+					response.end(JSON.stringify({ error: message }));
+				}
+			}
+		});
+		return () => {
+			disposeConnectors();
+			disposeDependencies();
+		};
+	}, "michengai-codex-ui: catalogs");
+}
+//#endregion
+export { apply, inject };

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@michengai/dsh-codex-ui",
+  "version": "0.2.48",
+  "description": "以 Codex 风格重构 DSH Web 侧栏的独立客户端插件",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MichengAI/dsh-codex-ui.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MichengAI/dsh-codex-ui/issues"
+  },
+  "homepage": "https://github.com/MichengAI/dsh-codex-ui#readme",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./client": {
+      "default": "./dist/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "assets",
+    "cordis.patch.yml",
+    "LICENSE",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-settings-general"
+      ],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "build": "tsc --noEmit && tsdown",
+    "test": "tsx tests/pinned-sessions.assert.ts && tsx tests/session-manager.assert.ts && tsx tests/workspace-browser.assert.ts && tsx tests/sidebar-search.assert.ts && vitest run tests/client-runtime.integration.spec.ts && tsx tests/settings-integration.assert.ts && tsx tests/about-dependencies.assert.ts && tsx tests/dependency-manager.assert.ts && tsx tests/conversation-visuals.assert.ts && tsx tests/client-bundle.assert.ts && tsx tests/codex-suite.assert.ts"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.1 <5.0.0",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.0-rc.0 <0.2.0",
+    "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.0 <0.2.0",
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.0-rc.0 <0.2.0",
+    "@deepseek-ai/dsh-client-ui-layout": ">=0.1.0-rc.0 <0.2.0",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.0-rc.0 <0.2.0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.0 <0.2.0",
+    "@deepseek-ai/dsh-client-ui-settings-general": ">=0.1.0-rc.0 <0.2.0",
+    "@deepseek-ai/dsh-client-ui-sidebar": ">=0.1.0-rc.0 <0.2.0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.0 <0.2.0",
+    "@michengai/dsh-agency-agents": ">=0.1.3 <0.2.0",
+    "@michengai/dsh-skills-manager": ">=0.1.7 <0.2.0",
+    "react": "^18.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@michengai/dsh-agency-agents": { "optional": true },
+    "@michengai/dsh-skills-manager": { "optional": true }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-test-runtime": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-layout": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings-general": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.6",
+    "@types/node": "^26.0.0",
+    "@types/react": "~18.3.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsdown": "^0.22.2",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8",
+    "jsdom": "^29.1.1"
+  }
+}
+
+
+