@aipanel/provider-deepseek 1.2.0-beta.0

package/lib/dsh-install.cjs

@@ -0,0 +1,95 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var dsh_install_exports = {};
+__export(dsh_install_exports, {
+  DSH_CLIENT_PACKAGE: () => DSH_CLIENT_PACKAGE,
+  dshProfileDir: () => dshProfileDir,
+  ensureDshClient: () => ensureDshClient,
+  isDshClientInstalled: () => isDshClientInstalled,
+  resolveDevDshClientSource: () => resolveDevDshClientSource
+});
+module.exports = __toCommonJS(dsh_install_exports);
+var import_node_fs = __toESM(require("node:fs"));
+var import_node_os = __toESM(require("node:os"));
+var import_node_path = __toESM(require("node:path"));
+var import_execa = require("execa");
+var import_node_url = require("node:url");
+var import_node = require("@aipanel/core/node");
+const log = (0, import_node.createLogger)("DshInstall");
+const DSH_CLIENT_PACKAGE = "@aipanel/dsh-client";
+function resolveDevDshClientSource(metaUrl) {
+  const here = import_node_path.default.dirname((0, import_node_url.fileURLToPath)(metaUrl));
+  const devDir = import_node_path.default.resolve(here, "../dsh-client");
+  if (import_node_fs.default.existsSync(import_node_path.default.join(devDir, "package.json")) && import_node_fs.default.existsSync(import_node_path.default.join(devDir, "lib/client.js"))) {
+    return devDir;
+  }
+  return null;
+}
+function dshProfileDir(home) {
+  const resolved = home || process.env.DSH_HOME || import_node_path.default.join(import_node_os.default.homedir(), ".dsh");
+  return import_node_path.default.join(resolved, "profiles", "web");
+}
+function isDshClientInstalled(profileDir) {
+  return import_node_fs.default.existsSync(
+    import_node_path.default.join(profileDir, "node_modules", "@aipanel", "dsh-client", "package.json")
+  );
+}
+async function ensureDshClient(profileDir, target, home) {
+  try {
+    log.debug(`installing ${target} into dsh profile via dsh plugin add`);
+    await (0, import_execa.execa)("dsh", ["plugin", "--profile", "web", "add", target], {
+      reject: true,
+      shell: true,
+      env: {
+        ...process.env,
+        ...home ? { DSH_HOME: home } : {}
+      }
+    });
+    if (!isDshClientInstalled(profileDir)) {
+      log.warn(`dsh plugin add finished but ${DSH_CLIENT_PACKAGE} is not resolvable`, {
+        profileDir
+      });
+      return false;
+    }
+    return true;
+  } catch (e) {
+    log.warn(`failed to install ${DSH_CLIENT_PACKAGE} via dsh plugin add`, {
+      target,
+      error: e instanceof Error ? e.message : String(e)
+    });
+    return false;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DSH_CLIENT_PACKAGE,
+  dshProfileDir,
+  ensureDshClient,
+  isDshClientInstalled,
+  resolveDevDshClientSource
+});

package/lib/dsh-install.d.ts

@@ -0,0 +1,16 @@
+export declare const DSH_CLIENT_PACKAGE = "@aipanel/dsh-client";
+/**
+ * 是否为 dev workspace 且 dsh-client 产物就绪（存在 package.json 与 lib/client.js）。
+ * 生产安装的 provider 在 node_modules/@aipanel/provider-deepseek/ 下，上一级不是 dsh-client，返回 null。
+ */
+export declare function resolveDevDshClientSource(metaUrl: string): string | null;
+/** dsh web profile 目录（固定 --profile web）；home 未指定时回退 $DSH_HOME / ~/.dsh */
+export declare function dshProfileDir(home?: string): string;
+/** @aipanel/dsh-client 在 profile 的 node_modules 中是否可解析 */
+export declare function isDshClientInstalled(profileDir: string): boolean;
+/**
+ * 确保 @aipanel/dsh-client 已安装且为最新（官方命令 dsh plugin add）。
+ * 每次启动都执行（不跳过已安装）：dev 本地目录每次重装保证改代码生效，
+ * 生产 npm 包每次检查 registry 拉取最新版本。安装失败返回 false（不阻塞启动，仅 chip 高亮不可用）。
+ */
+export declare function ensureDshClient(profileDir: string, target: string, home?: string): Promise<boolean>;

package/lib/index.cjs

@@ -0,0 +1,63 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var lib_exports = {};
+__export(lib_exports, {
+  DEFAULT_DEEPSEEK_PROVIDER_OPTIONS: () => import_constants2.DEFAULT_DEEPSEEK_PROVIDER_OPTIONS,
+  DSH_DEFAULT_PORT: () => import_constants2.DSH_DEFAULT_PORT,
+  DSH_LOOPBACK_HOST: () => import_constants2.DSH_LOOPBACK_HOST,
+  DeepSeekAPI: () => import_api.DeepSeekAPI,
+  buildDshOverlay: () => import_profile.buildDshOverlay,
+  checkDeepSeekInstalled: () => import_system.checkDeepSeekInstalled,
+  createProvider: () => createProvider,
+  generateBridgeScript: () => import_bridge_script.generateBridgeScript,
+  getDeepSeekVersion: () => import_system.getDeepSeekVersion,
+  killOrphanDeepSeekProcesses: () => import_system.killOrphanDeepSeekProcesses,
+  startDeepSeekWeb: () => import_deepseek_web.startDeepSeekWeb,
+  writeDshOverlay: () => import_profile.writeDshOverlay
+});
+module.exports = __toCommonJS(lib_exports);
+var import_provider = require("./provider.cjs");
+var import_constants = require("./constants.cjs");
+var import_api = require("./api.cjs");
+var import_deepseek_web = require("./deepseek-web.cjs");
+var import_profile = require("./profile.cjs");
+var import_bridge_script = require("./bridge-script.cjs");
+var import_system = require("./system.cjs");
+var import_constants2 = require("./constants.cjs");
+function createProvider(ctx) {
+  return new import_provider.DeepSeekWebProvider(
+    { hostname: import_constants.DSH_LOOPBACK_HOST },
+    { getWebPort: ctx.getWebPort, getProxyPort: ctx.getProxyPort },
+    ctx.options
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_DEEPSEEK_PROVIDER_OPTIONS,
+  DSH_DEFAULT_PORT,
+  DSH_LOOPBACK_HOST,
+  DeepSeekAPI,
+  buildDshOverlay,
+  checkDeepSeekInstalled,
+  createProvider,
+  generateBridgeScript,
+  getDeepSeekVersion,
+  killOrphanDeepSeekProcesses,
+  startDeepSeekWeb,
+  writeDshOverlay
+});

package/lib/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * DeepSeek Harness Web Provider
+ * 实现 WebProvider 契约：进程管理、RPC 会话 API、桥接脚本、CLI 环境检查。
+ * 所有 dsh 专属类型与常量自包含于此包。
+ */
+import type { ProviderInitContext, WebProvider } from "@aipanel/core";
+/** 约定工厂：核心层动态加载本包后调用，初始化动作完全由 Provider 定义 */
+export declare function createProvider(ctx: ProviderInitContext): WebProvider;
+export { DeepSeekAPI } from "./api";
+export type { DeepSeekWebProviderConfig, DeepSeekWebProviderDeps } from "./provider";
+export { startDeepSeekWeb, type DeepSeekWebOptions } from "./deepseek-web";
+export { buildDshOverlay, writeDshOverlay } from "./profile";
+export { generateBridgeScript, type BridgeScriptOptions } from "./bridge-script";
+export { checkDeepSeekInstalled, getDeepSeekVersion, killOrphanDeepSeekProcesses } from "./system";
+export { DEFAULT_DEEPSEEK_PROVIDER_OPTIONS, DSH_LOOPBACK_HOST, DSH_DEFAULT_PORT } from "./constants";
+export type { DeepSeekProviderOptions, DeepSeekPermissionPreset, DeepSeekBusyEnter, SessionSummary, WorkspaceView, SessionStreamEvent, ServerRequest, ServerResponse, ClientRequest, } from "./types";

package/lib/profile.cjs

@@ -0,0 +1,91 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var profile_exports = {};
+__export(profile_exports, {
+  buildDshOverlay: () => buildDshOverlay,
+  writeDshOverlay: () => writeDshOverlay
+});
+module.exports = __toCommonJS(profile_exports);
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_url = require("url");
+var import_node = require("@aipanel/core/node");
+const log = (0, import_node.createLogger)("DeepSeekProfile");
+function buildDshOverlay(options) {
+  const { vitePort, cwd, pluginDistPath, clientAvailable = true } = options;
+  const mcpUrl = `http://127.0.0.1:${vitePort}${import_node.MCP_API_PATH}`;
+  const rows = [];
+  rows.push(
+    [
+      "    - id: aipanel-mcp",
+      "      name: '@deepseek-ai/dsh-mcp-client'",
+      "      config:",
+      "        serverName: aipanel",
+      "        transport: streamable-http",
+      `        url: ${mcpUrl}`,
+      "        headers: {}"
+    ].join("\n")
+  );
+  if (pluginDistPath && import_fs.default.existsSync(pluginDistPath)) {
+    const pluginSpec = (0, import_url.pathToFileURL)(pluginDistPath).href;
+    log.debug("injecting aipanel host plugin row", { pluginDistPath, pluginSpec });
+    rows.push(
+      [
+        "    - id: aipanel",
+        `      name: '${pluginSpec}'`,
+        "      inject: [tools, subprocess]",
+        "      config:",
+        `        cwd: ${JSON.stringify(cwd)}`,
+        "        autoDiagnose: true"
+      ].join("\n")
+    );
+  } else {
+    log.debug("aipanel dsh-plugin dist not found, skipping host plugin row", { pluginDistPath });
+  }
+  rows.push(
+    [
+      "    - id: aipanel-client",
+      "      name: '@aipanel/dsh-client'",
+      ...clientAvailable ? [] : ["      disabled: true"]
+    ].join("\n")
+  );
+  return ["- insert:", rows.join("\n"), ""].join("\n");
+}
+function writeDshOverlay(workspaceCwd, overlay) {
+  const dir = import_path.default.join(workspaceCwd, "node_modules", ".cache", "aipanel");
+  import_fs.default.mkdirSync(dir, { recursive: true });
+  const file = import_path.default.join(dir, "dsh-overlay.cordis.yml");
+  import_fs.default.writeFileSync(file, overlay, "utf-8");
+  log.debug("Wrote dsh overlay", { file });
+  return file;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildDshOverlay,
+  writeDshOverlay
+});

package/lib/profile.d.ts

@@ -0,0 +1,11 @@
+/** 组装 overlay YAML */
+export declare function buildDshOverlay(options: {
+    vitePort: number;
+    cwd: string;
+    pluginDistPath?: string;
+    /** client 插件是否可被 dsh 解析（provider 已同步到 dsh profile）；false 时停用该行，避免 fail-loud */
+    clientAvailable?: boolean;
+}): string;
+/** 将 overlay 写入项目缓存目录（node_modules/.cache/aipanel，参照 opencode 的
+ * node_modules/.cache/opencode 惯例），不污染用户项目根目录。 */
+export declare function writeDshOverlay(workspaceCwd: string, overlay: string): string;

package/lib/provider.cjs

@@ -0,0 +1,308 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var provider_exports = {};
+__export(provider_exports, {
+  DeepSeekWebProvider: () => DeepSeekWebProvider
+});
+module.exports = __toCommonJS(provider_exports);
+const import_meta = {};
+var import_node_url = require("node:url");
+var import_node = require("@aipanel/core/node");
+var import_constants = require("./constants.cjs");
+var import_constants2 = require("./constants.cjs");
+var import_api = require("./api.cjs");
+var import_bridge_script = require("./bridge-script.cjs");
+var import_deepseek_web = require("./deepseek-web.cjs");
+var import_profile = require("./profile.cjs");
+var import_system = require("./system.cjs");
+var import_dsh_install = require("./dsh-install.cjs");
+const log = (0, import_node.createLogger)("DeepSeekWebProvider");
+class DeepSeekWebProvider {
+  constructor(config, deps, options) {
+    __publicField(this, "id", "deepseek");
+    __publicField(this, "displayName", "DeepSeek Harness");
+    /** SPA 型无 URL 深链：iframe 保持应用壳，切会话通过 FOCUS_SESSION 消息完成 */
+    __publicField(this, "capabilities", { deepLink: false });
+    __publicField(this, "api");
+    __publicField(this, "deps");
+    __publicField(this, "process", null);
+    __publicField(this, "bridgeOptions", {});
+    __publicField(this, "opts");
+    this.deps = deps;
+    this.opts = resolveDeepSeekOptions(options);
+    this.api = new import_api.DeepSeekAPI(import_constants2.DSH_LOOPBACK_HOST, deps.getWebPort);
+  }
+  /** 代理注入到 HTML 的桥接脚本（Provider 资产） */
+  get bridgeScript() {
+    return (0, import_bridge_script.generateBridgeScript)(this.bridgeOptions);
+  }
+  /** 初始化桥接配置（主题等） */
+  applyConfig(config) {
+    this.bridgeOptions = { theme: config.theme ?? "auto" };
+  }
+  async checkEnvironment() {
+    if (!await (0, import_system.checkDeepSeekInstalled)()) {
+      return {
+        ok: false,
+        message: `DeepSeek Harness (dsh) is not installed!
+
+Please install dsh first:
+
+  npm install -g @deepseek-ai/dsh
+
+or run without installing:
+
+  npx @deepseek-ai/dsh web
+        `
+      };
+    }
+    const version = await (0, import_system.getDeepSeekVersion)();
+    return { ok: true, version: version ?? void 0 };
+  }
+  async start(options) {
+    log.debug("Starting dsh web process", {
+      port: options.port,
+      hostname: import_constants2.DSH_LOOPBACK_HOST,
+      cwd: options.cwd,
+      vitePort: options.vitePort
+    });
+    const devClientDir = (0, import_dsh_install.resolveDevDshClientSource)(import_meta.url);
+    const clientAvailable = await (0, import_dsh_install.ensureDshClient)(
+      (0, import_dsh_install.dshProfileDir)(this.opts.home),
+      devClientDir ?? import_dsh_install.DSH_CLIENT_PACKAGE,
+      this.opts.home
+    );
+    if (!clientAvailable) {
+      log.warn("@aipanel/dsh-client unavailable; @ menu chip highlight disabled", {
+        metaUrl: import_meta.url
+      });
+    }
+    const overlay = (0, import_profile.buildDshOverlay)({
+      vitePort: options.vitePort,
+      cwd: options.cwd,
+      pluginDistPath: this.resolvePluginDist(),
+      clientAvailable
+    });
+    const patchPath = (0, import_profile.writeDshOverlay)(options.cwd, overlay);
+    const proc = (0, import_deepseek_web.startDeepSeekWeb)({
+      port: options.port,
+      hostname: import_constants2.DSH_LOOPBACK_HOST,
+      cwd: options.cwd,
+      patchPath,
+      home: this.opts.home,
+      verbose: options.verbose
+    });
+    this.process = proc;
+    const settings = this.buildSettingsToApply();
+    if (Object.keys(settings).length > 0) {
+      void this.api.applySettings(settings).catch((e) => {
+        log.warn("failed to apply provider settings to dsh", {
+          settings,
+          error: e instanceof Error ? e.message : String(e)
+        });
+      });
+    }
+    return { url: this.api.shellUrl, processHandle: proc };
+  }
+  /** 把 providerOptions 配置映射为 dsh settings 命名空间 patch（仅含用户显式配置项） */
+  buildSettingsToApply() {
+    const sections = {};
+    if (this.opts.agentPreset !== void 0) {
+      sections["agent-presets"] = { ...sections["agent-presets"], default: this.opts.agentPreset };
+    }
+    if (this.opts.permissionPreset !== void 0) {
+      sections.permission = {
+        ...sections.permission,
+        defaultPreset: this.opts.permissionPreset
+      };
+    }
+    if (this.opts.busyEnter !== void 0) {
+      sections["ui-conversation"] = {
+        ...sections["ui-conversation"],
+        busyEnter: this.opts.busyEnter
+      };
+    }
+    return sections;
+  }
+  /** 解析 aipanel dsh-plugin 的构建产物路径（存在才在 overlay 里注入插件行）。
+   * 注意用 fileURLToPath：URL.pathname 是 percent-encoded，中文路径下 existsSync 会误判不存在。 */
+  resolvePluginDist() {
+    const fromHere = new URL("../dsh-plugin/dist/index.js", import_meta.url);
+    return (0, import_node_url.fileURLToPath)(fromHere);
+  }
+  async stop() {
+    if (this.process) {
+      log.debug("Killing dsh web process", { pid: this.process.pid });
+      this.process.kill("SIGTERM");
+      this.process = null;
+    }
+  }
+  async killOrphans() {
+    return (0, import_system.killOrphanDeepSeekProcesses)();
+  }
+  async listSessions(projectDir) {
+    const sessions = await this.api.listSessions(projectDir);
+    const url = this.buildSessionUrl(projectDir, "");
+    return sessions.map((s) => toChatSession(s, url));
+  }
+  async createSession(projectDir, title) {
+    const url = this.buildSessionUrl(projectDir, "");
+    const created = await this.api.createSession(projectDir);
+    return {
+      id: created.sessionId,
+      title: title ?? "",
+      updatedAt: Date.now(),
+      url
+    };
+  }
+  // 删除走归档：dsh 无硬删除语义（workspace.archiveSession），
+  // 归档后 listSessions 按 archivedSessionIds 过滤即从列表消失。
+  async deleteSession(sessionId) {
+    await this.api.archiveSession(sessionId);
+  }
+  buildSessionUrl(projectDir, sessionId) {
+    void projectDir;
+    void sessionId;
+    return `http://${import_constants2.DSH_LOOPBACK_HOST}:${this.deps.getProxyPort()}/`;
+  }
+  subscribeEvents(handler) {
+    const port = this.deps.getWebPort();
+    const base = `ws://${import_constants2.DSH_LOOPBACK_HOST}:${port}`;
+    const endpoints = [import_constants2.DSH_MUX_EVENTS_PATH, import_constants2.DSH_HOST_EVENTS_PATH];
+    log.debug("Subscribing to dsh event streams (WebSocket)", {
+      endpoints: endpoints.map((p) => base + p)
+    });
+    let aborted = false;
+    const sockets = /* @__PURE__ */ new Set();
+    const retryTimers = /* @__PURE__ */ new Set();
+    const cleanupAll = () => {
+      for (const timer of retryTimers) clearTimeout(timer);
+      retryTimers.clear();
+      for (const ws of sockets) {
+        try {
+          ws.close();
+        } catch {
+        }
+      }
+      sockets.clear();
+    };
+    const connect = (path, attempt = 0) => {
+      if (aborted) return;
+      let socket;
+      try {
+        socket = new WebSocket(base + path);
+      } catch (e) {
+        log.warn("dsh event WebSocket create failed", { path, error: String(e) });
+        scheduleReconnect(path, attempt + 1);
+        return;
+      }
+      sockets.add(socket);
+      socket.onmessage = (ev) => {
+        try {
+          const frame = JSON.parse(String(ev.data));
+          const event = mapEvent(frame);
+          if (event) handler(event);
+        } catch {
+        }
+      };
+      socket.onclose = () => {
+        sockets.delete(socket);
+        scheduleReconnect(path, attempt + 1);
+      };
+      socket.onerror = () => {
+        try {
+          socket.close();
+        } catch {
+        }
+      };
+    };
+    const scheduleReconnect = (path, attempt) => {
+      if (aborted) return;
+      const delays = [250, 500, 1e3, 2e3, 5e3];
+      const after = delays[Math.min(attempt, delays.length - 1)];
+      const timer = setTimeout(() => {
+        retryTimers.delete(timer);
+        connect(path);
+      }, after);
+      retryTimers.add(timer);
+    };
+    endpoints.forEach((p) => connect(p));
+    return () => {
+      aborted = true;
+      cleanupAll();
+    };
+  }
+}
+function mapEvent(frame) {
+  if (!frame || typeof frame.method !== "string" || !frame.payload) return null;
+  const payload = frame.payload;
+  const sessionId = payload.sessionId ?? "";
+  switch (frame.method) {
+    case "host/session-status": {
+      if (!sessionId) return null;
+      const running = payload.running === true;
+      return { type: "session.status", sessionId, status: running ? "running" : "idle" };
+    }
+    case "session/event": {
+      const event = payload.event;
+      const type = event?.type ?? "";
+      if (!sessionId || !type) return null;
+      switch (type) {
+        case "assistant/message":
+        case "turn/end":
+          return { type: "thinking", sessionId, thinking: false };
+        case "assistant/chunk":
+        case "thinking/delta":
+        case "turn/start":
+        case "step/start":
+          return { type: "thinking", sessionId, thinking: true };
+        default:
+          return null;
+      }
+    }
+    default:
+      return null;
+  }
+}
+function toChatSession(s, url) {
+  return {
+    id: s.sessionId,
+    // dsh 标题在 projections.values.title，不在顶层
+    title: s.projections?.values?.title ?? "",
+    updatedAt: s.updatedAt,
+    parentId: s.parentSessionId,
+    url
+  };
+}
+function resolveDeepSeekOptions(options) {
+  if (!options) return { ...import_constants.DEFAULT_DEEPSEEK_PROVIDER_OPTIONS };
+  const po = options.providerOptions ?? {};
+  return {
+    ...import_constants.DEFAULT_DEEPSEEK_PROVIDER_OPTIONS,
+    home: po.home ?? options.home,
+    agentPreset: po.agentPreset ?? options.agentPreset,
+    permissionPreset: po.permissionPreset ?? options.permissionPreset,
+    busyEnter: po.busyEnter ?? options.busyEnter
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DeepSeekWebProvider
+});

package/lib/provider.d.ts

@@ -0,0 +1,49 @@
+import type { ChatSession, ProviderConfig, ProviderEnvironmentInfo, ProviderEvent, ProviderStartOptions, ProviderStartResult, WebProvider } from "@aipanel/core";
+/** DeepSeekWebProvider 构造配置（核心层传入的运行时参数） */
+export interface DeepSeekWebProviderConfig {
+    /** 服务主机名 */
+    hostname: string;
+}
+/** DeepSeekWebProvider 构造依赖（端口等运行时状态由编排层提供） */
+export interface DeepSeekWebProviderDeps {
+    /** 实际 Web 端口读取器 */
+    getWebPort: () => number;
+    /** 实际代理端口读取器 */
+    getProxyPort: () => number;
+}
+/**
+ * DeepSeek Harness Web Provider
+ * 组合 CLI 进程管理、RPC 会话 API、桥接脚本，向核心层暴露 WebProvider 契约。
+ */
+export declare class DeepSeekWebProvider implements WebProvider {
+    readonly id = "deepseek";
+    readonly displayName = "DeepSeek Harness";
+    /** SPA 型无 URL 深链：iframe 保持应用壳，切会话通过 FOCUS_SESSION 消息完成 */
+    readonly capabilities: {
+        readonly deepLink: false;
+    };
+    private readonly api;
+    private deps;
+    private process;
+    private bridgeOptions;
+    private readonly opts;
+    constructor(config: DeepSeekWebProviderConfig, deps: DeepSeekWebProviderDeps, options?: Record<string, unknown>);
+    /** 代理注入到 HTML 的桥接脚本（Provider 资产） */
+    get bridgeScript(): string | undefined;
+    /** 初始化桥接配置（主题等） */
+    applyConfig(config: ProviderConfig): void;
+    checkEnvironment(): Promise<ProviderEnvironmentInfo>;
+    start(options: ProviderStartOptions): Promise<ProviderStartResult>;
+    /** 把 providerOptions 配置映射为 dsh settings 命名空间 patch（仅含用户显式配置项） */
+    private buildSettingsToApply;
+    /** 解析 aipanel dsh-plugin 的构建产物路径（存在才在 overlay 里注入插件行）。
+     * 注意用 fileURLToPath：URL.pathname 是 percent-encoded，中文路径下 existsSync 会误判不存在。 */
+    private resolvePluginDist;
+    stop(): Promise<void>;
+    killOrphans(): Promise<number>;
+    listSessions(projectDir: string): Promise<ChatSession[]>;
+    createSession(projectDir: string, title?: string): Promise<ChatSession>;
+    deleteSession(sessionId: string): Promise<void>;
+    buildSessionUrl(projectDir: string, sessionId: string): string;
+    subscribeEvents(handler: (e: ProviderEvent) => void): () => void;
+}