@aipanel/provider-deepseek 1.2.0-beta.0

package/lib/system.cjs

@@ -0,0 +1,195 @@
+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 system_exports = {};
+__export(system_exports, {
+  checkDeepSeekInstalled: () => checkDeepSeekInstalled,
+  getDeepSeekVersion: () => getDeepSeekVersion,
+  killOrphanDeepSeekProcesses: () => killOrphanDeepSeekProcesses
+});
+module.exports = __toCommonJS(system_exports);
+var import_child_process = require("child_process");
+var import_node = require("@aipanel/core/node");
+const log = (0, import_node.createLogger)("DeepSeekSystem");
+async function checkDeepSeekInstalled() {
+  const timer = log.timer("checkDeepSeekInstalled");
+  return new Promise((resolve) => {
+    log.debug("Checking if dsh is installed...");
+    const proc = (0, import_child_process.spawn)("dsh", ["--version"], { stdio: "ignore", shell: true });
+    proc.on("close", (code) => {
+      const installed = code === 0;
+      timer.end(installed ? "\u2713 dsh is installed" : "\u274C dsh not found");
+      resolve(installed);
+    });
+    proc.on("error", (err) => {
+      log.debug("Failed to check dsh installation", { error: err.message });
+      timer.end("\u274C Check failed");
+      resolve(false);
+    });
+  });
+}
+function getDeepSeekVersion() {
+  return new Promise((resolve) => {
+    const proc = (0, import_child_process.spawn)("dsh", ["--version"], { stdio: "pipe", shell: true });
+    let output = "";
+    proc.stdout?.on("data", (data) => {
+      output += data.toString();
+    });
+    proc.on("close", (code) => {
+      if (code === 0 && output.trim()) {
+        resolve(output.trim());
+      } else {
+        resolve(null);
+      }
+    });
+    proc.on("error", () => {
+      resolve(null);
+    });
+  });
+}
+const KILL_ORPHAN_TIMEOUT = 5e3;
+async function killOrphanDeepSeekProcesses() {
+  const timer = log.timer("killOrphanDeepSeekProcesses");
+  log.debug("Looking for orphan dsh processes (PPID=1)");
+  return new Promise((resolve) => {
+    let settled = false;
+    const done = (count) => {
+      if (settled) return;
+      settled = true;
+      resolve(count);
+    };
+    const timeout = setTimeout(() => {
+      log.warn("Kill orphan processes timed out, skipping");
+      timer.end("\u26A0 Timeout, skipped");
+      done(0);
+    }, KILL_ORPHAN_TIMEOUT);
+    const wrappedResolve = (count) => {
+      clearTimeout(timeout);
+      done(count);
+    };
+    if (process.platform === "win32") {
+      killOrphanProcessesOnWindows(wrappedResolve, timer);
+    } else {
+      killOrphanProcessesOnUnix(wrappedResolve, timer);
+    }
+  });
+}
+function killOrphanProcessesOnWindows(resolve, timer) {
+  log.debug("Using Windows method to find orphan processes");
+  const proc = (0, import_child_process.spawn)(
+    "wmic",
+    ["process", "where", 'name="node.exe"', "get", "processid,parentprocessid,commandline"],
+    { stdio: "pipe" }
+  );
+  let output = "";
+  proc.stdout?.on("data", (data) => {
+    output += data.toString();
+  });
+  proc.on("close", () => {
+    const pidsToKill = [];
+    output.split("\n").forEach((rawLine) => {
+      const line = rawLine.trim();
+      if (!line.includes("dsh")) return;
+      const parts = line.trim().split(/\s+/);
+      if (parts.length >= 2) {
+        const ppid = parts[0];
+        const pid = parts[1];
+        if (ppid === "1" && pid && !isNaN(Number(pid))) {
+          pidsToKill.push(pid);
+        }
+      }
+    });
+    if (pidsToKill.length > 0) {
+      log.debug(`Found ${pidsToKill.length} orphan processes`, { pids: pidsToKill });
+      let killedCount = 0;
+      let completedCount = 0;
+      pidsToKill.forEach((pid) => {
+        const killProc = (0, import_child_process.spawn)("taskkill", ["/F", "/PID", pid], { stdio: "ignore" });
+        killProc.on("close", (code) => {
+          completedCount++;
+          if (code === 0) killedCount++;
+          if (completedCount === pidsToKill.length) {
+            timer.end(`\u2713 Killed ${killedCount} orphan processes`);
+            resolve(killedCount);
+          }
+        });
+      });
+    } else {
+      log.debug("No orphan processes found");
+      timer.end("No orphan processes found");
+      resolve(0);
+    }
+  });
+  proc.on("error", (err) => {
+    log.debug("Failed to find orphan processes", { error: err.message });
+    timer.end("\u274C Failed to find orphan processes");
+    resolve(0);
+  });
+}
+function killOrphanProcessesOnUnix(resolve, timer) {
+  log.debug("Using Unix method to find orphan processes");
+  const proc = (0, import_child_process.spawn)("ps", ["-e", "-o", "pid,ppid,args"], { stdio: "pipe" });
+  let output = "";
+  proc.stdout?.on("data", (data) => {
+    output += data.toString();
+  });
+  proc.on("close", () => {
+    const lines = output.split("\n");
+    const pidsToKill = [];
+    lines.forEach((line) => {
+      if (!line.includes("dsh")) return;
+      const parts = line.trim().split(/\s+/);
+      if (parts.length >= 3) {
+        const pid = parts[0];
+        const ppid = parts[1];
+        if (ppid === "1") {
+          pidsToKill.push(pid);
+        }
+      }
+    });
+    if (pidsToKill.length > 0) {
+      log.debug(`Found ${pidsToKill.length} orphan processes`, { pids: pidsToKill });
+      const killProc = (0, import_child_process.spawn)("kill", ["-9", ...pidsToKill], { stdio: "ignore" });
+      killProc.on("close", (code) => {
+        const killedCount = code === 0 ? pidsToKill.length : 0;
+        timer.end(
+          killedCount > 0 ? `\u2713 Killed ${killedCount} orphan processes` : "\u274C Failed to kill processes"
+        );
+        resolve(killedCount);
+      });
+      killProc.on("error", () => {
+        timer.end("\u274C Failed to kill processes");
+        resolve(0);
+      });
+    } else {
+      log.debug("No orphan processes found");
+      timer.end("No orphan processes found");
+      resolve(0);
+    }
+  });
+  proc.on("error", (err) => {
+    log.debug("Failed to find orphan processes", { error: err.message });
+    timer.end("\u274C Failed to find orphan processes");
+    resolve(0);
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  checkDeepSeekInstalled,
+  getDeepSeekVersion,
+  killOrphanDeepSeekProcesses
+});

package/lib/system.d.ts

@@ -0,0 +1,3 @@
+export declare function checkDeepSeekInstalled(): Promise<boolean>;
+export declare function getDeepSeekVersion(): Promise<string | null>;
+export declare function killOrphanDeepSeekProcesses(): Promise<number>;

package/lib/types.cjs

@@ -0,0 +1,42 @@
+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 types_exports = {};
+__export(types_exports, {
+  SESSION_EVENT_TYPES: () => SESSION_EVENT_TYPES
+});
+module.exports = __toCommonJS(types_exports);
+const SESSION_EVENT_TYPES = {
+  /** 回合开始 → 视为 streaming */
+  TURN_START: "turn/start",
+  /** 回合结束（稳定停等） */
+  TURN_END: "turn/end",
+  /** 步骤开始 */
+  STEP_START: "step/start",
+  /** 步骤结束 */
+  STEP_END: "step/end",
+  /** 助手输出完成 */
+  ASSISTANT_MESSAGE: "assistant/message",
+  /** 助手输出增量分片 */
+  ASSISTANT_CHUNK: "assistant/chunk",
+  /** 思考增量分片 */
+  THINKING_DELTA: "thinking/delta"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SESSION_EVENT_TYPES
+});

package/lib/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * DeepSeek Harness Provider 专属类型
+ * 所有与 DeepSeek Harness (dsh) 绑定的类型自包含于此，核心层不感知。
+ */
+/** 权限预设（对应 dsh settings permission.defaultPreset） */
+export type DeepSeekPermissionPreset = "read-only" | "workspace-write" | "danger-full-access";
+/** 繁忙时 Enter 键行为（对应 dsh settings ui-conversation.busyEnter） */
+export type DeepSeekBusyEnter = "queue" | "steer";
+/**
+ * DeepSeek Provider 专属配置（对应插件配置的 providerOptions 段）
+ * 保留字符串索引签名，以赋给 PluginOptions 的 Record<string, unknown> 泛型约束。
+ */
+export type DeepSeekProviderOptions = {
+    /** dsh 数据目录（$DSH_HOME），默认跟随系统（~/.dsh） */
+    home?: string;
+    /** 默认 Agent 预设（dsh settings agent-presets.default，如 code/standard；新建会话的默认模式） */
+    agentPreset?: string;
+    /** 默认权限预设（dsh settings permission.defaultPreset） */
+    permissionPreset?: DeepSeekPermissionPreset;
+    /** 繁忙时 Enter 键行为（dsh settings ui-conversation.busyEnter） */
+    busyEnter?: DeepSeekBusyEnter;
+    /**
+     * Provider 允许自定义扩展字段
+     * [key: string]: unknown;
+     */
+    [key: string]: unknown;
+};
+/**
+ * dsh API 四象限 RPC envelope（客户端请求 / 服务端响应）。
+ * 字段为 type/rpcId/method/payload + result:{ok,value|error}，不是标准 JSON-RPC。
+ */
+/** 客户端 → 服务端 请求体（POST /api/<method>） */
+export interface ClientRequest {
+    type: "client-request";
+    rpcId: string;
+    method: string;
+    payload: Record<string, unknown>;
+}
+/** 服务端 → 客户端 响应体 */
+export interface ServerResponse {
+    type: "server-response";
+    rpcId: string;
+    result: {
+        ok: true;
+        value: unknown;
+    } | {
+        ok: false;
+        error: {
+            code?: string;
+            message?: string;
+        };
+    };
+}
+/** 服务端推送帧（SSE data 载荷） */
+export interface ServerRequest {
+    type: "server-request";
+    rpcId: string;
+    method: string;
+    payload: Record<string, unknown>;
+}
+/** 会话摘要（POST /api/session.list 的 items 项） */
+export interface SessionSummary {
+    sessionId: string;
+    updatedAt: number;
+    running: boolean;
+    blank: boolean;
+    parentSessionId?: string;
+    origin?: "subagent";
+    cwd?: string;
+    agentPreset?: string;
+    /** 会话投影（标题等派生值存在 projections.values.title） */
+    projections?: {
+        values?: {
+            title?: string | null;
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+}
+/** session.list 的 value：容器对象（不是数组），会话在 items 下 */
+export interface SessionListResult {
+    items: SessionSummary[];
+}
+/** 工作区视图（POST /api/workspace.list 的 items 项，用于按目录匹配会话） */
+export interface WorkspaceView {
+    workspaceId: string;
+    path: string;
+    title: string;
+    sessionIds: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+/** workspace.list 的 value：容器对象（不是数组），工作区在 items 下，archivedSessionIds 为已归档会话 */
+export interface WorkspaceListResult {
+    items: WorkspaceView[];
+    archivedSessionIds: string[];
+}
+/** workspace.create 的 value（幂等：已存在则返回既有 workspace，created=false） */
+export interface WorkspaceCreateResult {
+    workspace: WorkspaceView;
+    created: boolean;
+}
+/** 会话流式事件（session/event 的 event 字段） */
+export interface SessionStreamEvent {
+    type: string;
+    seq: number;
+    time?: number;
+    data?: Record<string, unknown>;
+}
+/** dsh 会话日志事件类型（用于 thinking/status 推导的稳定子集） */
+export declare const SESSION_EVENT_TYPES: {
+    /** 回合开始 → 视为 streaming */
+    readonly TURN_START: "turn/start";
+    /** 回合结束（稳定停等） */
+    readonly TURN_END: "turn/end";
+    /** 步骤开始 */
+    readonly STEP_START: "step/start";
+    /** 步骤结束 */
+    readonly STEP_END: "step/end";
+    /** 助手输出完成 */
+    readonly ASSISTANT_MESSAGE: "assistant/message";
+    /** 助手输出增量分片 */
+    readonly ASSISTANT_CHUNK: "assistant/chunk";
+    /** 思考增量分片 */
+    readonly THINKING_DELTA: "thinking/delta";
+};
+export type SessionEventType = (typeof SESSION_EVENT_TYPES)[keyof typeof SESSION_EVENT_TYPES];

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@aipanel/provider-deepseek",
+  "version": "1.2.0-beta.0",
+  "type": "module",
+  "main": "lib/index.cjs",
+  "module": "es/index.js",
+  "types": "es/index.d.ts",
+  "files": [
+    "es",
+    "lib"
+  ],
+  "exports": {
+    ".": {
+      "types": "./es/index.d.ts",
+      "import": "./es/index.js",
+      "require": "./lib/index.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "execa": "^9.6.1",
+    "@aipanel/core": "1.2.0-beta.0"
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.0"
+  },
+  "scripts": {
+    "build": "pagoda-cli build && node scripts/build-dsh-assets.mjs",
+    "typecheck": "tsc -p tsconfig.declaration.json --noEmit"
+  }
+}