dsh-desktop-kit 2.2.1 → 2.7.2

package/plugins/dsh-mcp-manager/lib/manager.js

@@ -0,0 +1,146 @@
+/**
+ * MCP server manager: connection lifecycle, tool mapping and status.
+ */
+import { McpClient } from "./client.js";
+
+function sanitize(value) {
+  return String(value ?? "").replace(/[^A-Za-z0-9_-]+/gu, "_").replace(/^_+|_+$/gu, "").slice(0, 48);
+}
+
+function textFromContent(content) {
+  if (!Array.isArray(content)) return "";
+  return content
+    .map((block) => {
+      if (block?.type === "text" && typeof block.text === "string") return block.text;
+      if (block?.type === "image") return `[image ${block.mimeType || "image"}]`;
+      if (block?.type === "resource") return `[resource ${block.resource?.uri || ""}]`;
+      return "";
+    })
+    .filter(Boolean)
+    .join("\n");
+}
+
+export class McpManager {
+  constructor(ctx) {
+    this.ctx = ctx;
+    this.clients = new Map();
+    this.tools = new Map();
+    this.disposers = [];
+    this.closed = false;
+  }
+
+  reopen() {
+    this.closed = false;
+  }
+
+  toolName(serverId, toolName) {
+    const base = `mcp__${sanitize(serverId)}__${sanitize(toolName)}`;
+    if (base.length <= 64 && !this.tools.has(base)) return base;
+    let suffix = 2;
+    while (`${base.slice(0, 60)}_${suffix}`.length <= 64 && this.tools.has(`${base.slice(0, 60)}_${suffix}`)) suffix += 1;
+    return `${base.slice(0, 60)}_${suffix}`;
+  }
+
+  async connect(server) {
+    if (this.closed) throw new Error("MCP manager is closed");
+    const existing = this.clients.get(server.id);
+    if (existing?.client?.connected) return existing;
+    const client = new McpClient(server, this.ctx.logger);
+    try {
+      await client.connect();
+      if (this.closed) {
+        await client.close().catch(() => {});
+        throw new Error("MCP manager is closed");
+      }
+      const tools = await client.listTools();
+      const record = { server, client, tools, resources: [], error: "" };
+      this.clients.set(server.id, record);
+      for (const tool of tools) {
+        const name = this.toolName(server.id, tool.name);
+        this.tools.set(name, { serverId: server.id, tool, record });
+      }
+      return record;
+    } catch (error) {
+      await client.close().catch(() => {});
+      const record = { server, client: null, tools: [], resources: [], error: error instanceof Error ? error.message : String(error) };
+      this.clients.set(server.id, record);
+      return record;
+    }
+  }
+
+  async connectAll(servers) {
+    const results = await Promise.allSettled(servers.map((server) => this.connect(server)));
+    return results;
+  }
+
+  registerTools() {
+    if (this.closed) return;
+    for (const [name, entry] of this.tools) {
+      const definition = {
+        name,
+        description: `MCP ${entry.serverId}/${entry.tool.name}: ${entry.tool.description || "server tool"}`,
+        parameters: entry.tool.inputSchema && typeof entry.tool.inputSchema === "object"
+          ? entry.tool.inputSchema
+          : { type: "object", properties: {} },
+        async execute(input, exec) {
+          const record = entry.record;
+          if (!record?.client?.connected) return { ok: false, text: `MCP ${entry.serverId}: server is not connected` };
+          try {
+            const result = await record.client.callTool(entry.tool.name, input ?? {});
+            const text = textFromContent(result?.content) || (result?.structuredContent ? JSON.stringify(result.structuredContent) : "");
+            return { ok: result?.isError !== true, text: `MCP ${entry.serverId}/${entry.tool.name}:\n${text}` };
+          } catch (error) {
+            return { ok: false, text: `MCP ${entry.serverId}/${entry.tool.name}: ${error instanceof Error ? error.message : String(error)}` };
+          }
+        },
+      };
+      try {
+        const dispose = this.ctx.tools.register(definition);
+        if (typeof dispose === "function") this.disposers.push(dispose);
+      } catch (error) {
+        this.ctx.logger?.warn?.(`[mcp] tool ${name} skipped: ${error instanceof Error ? error.message : String(error)}`);
+      }
+    }
+  }
+
+  async call(serverId, toolName, args) {
+    const record = this.clients.get(serverId);
+    if (!record?.client?.connected) throw new Error(`MCP server not connected: ${serverId}`);
+    const result = await record.client.callTool(toolName, args);
+    return textFromContent(result?.content) || (result?.structuredContent ? JSON.stringify(result.structuredContent) : "");
+  }
+
+  async resources(serverId) {
+    const record = this.clients.get(serverId);
+    if (!record?.client?.connected) throw new Error(`MCP server not connected: ${serverId}`);
+    return record.client.listResources();
+  }
+
+  async readResource(serverId, uri) {
+    const record = this.clients.get(serverId);
+    if (!record?.client?.connected) throw new Error(`MCP server not connected: ${serverId}`);
+    return record.client.readResource(uri);
+  }
+
+  status() {
+    return [...this.clients.values()].map((record) => ({
+      id: record.server.id,
+      scope: record.server.scope,
+      trusted: record.server.trusted,
+      connected: Boolean(record.client?.connected),
+      tools: record.tools.length,
+      error: record.error,
+      serverInfo: record.client?.serverInfo ?? null,
+    }));
+  }
+
+  async close() {
+    this.closed = true;
+    for (const dispose of this.disposers.splice(0)) {
+      try { dispose(); } catch { /* best effort */ }
+    }
+    await Promise.allSettled([...this.clients.values()].map((record) => record.client?.close?.()));
+    this.clients.clear();
+    this.tools.clear();
+  }
+}

package/plugins/dsh-mcp-manager/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "dsh-mcp-manager",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": {
+      "default": "./index.js"
+    },
+    "./client": {
+      "default": "./client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "description": "MCP servers for DSH: config, trust, tools, resources, Settings UI and direct calls.",
+  "license": "MIT"
+}

package/plugins/dsh-memory-bridge/README.md

@@ -0,0 +1,161 @@
+# dsh-memory-bridge 2.2
+
+**Память проектов между АРМ. Ваш приватный GitHub. Без команд — всё мышкой.**
+
+Плагин DeepSeek Harness, который синхронизирует досье `dsh-project-memory` между вашими
+Windows-машинами через **ваш собственный приватный GitHub-репозиторий**. Дополнения с разных
+машин объединяются трёхсторонним слиянием, одинаково изменённая строка становится конфликтом
+и **никогда не затирается молча**.
+
+![dsh-memory-bridge](https://cdn.jsdelivr.net/npm/dsh-memory-bridge@2.2.1/docs/images/hero.png)
+
+[![npm](https://img.shields.io/npm/v/dsh-memory-bridge?label=npm&color=cb3837)](https://www.npmjs.com/package/dsh-memory-bridge)
+![license](https://img.shields.io/badge/license-MIT-green)
+![platform](https://img.shields.io/badge/DSH-0.2.x-2f7df6)
+![windows](https://img.shields.io/badge/Windows-10%2F11-0078D6)
+
+**MIT** · проверено на DSH `0.2.2-rc.1` (Windows 11) · без LLM-вызовов, без токенов в работе ·
+у каждого пользователя — свой GitHub-аккаунт и свой репозиторий
+
+---
+
+## Что нового в 2.2
+
+- **История и откат.** У каждого проекта — список commit’ов, которые меняли досье, и кнопка
+  «Восстановить». Восстановление сначала сохраняет текущие файлы в бэкап, затем создаёт новый
+  commit: ничего не пропадает, восстановление видно в истории Git.
+- **Подсветка конфликтов.** В двух версиях «Моё / С GitHub» изменённые строки подсвечиваются:
+  розовые — только у меня, зелёные — только на GitHub. Выбор стал быстрее и безопаснее.
+- **Host-защита приватности.** Перед каждой синхронизацией (не только при подключении)
+  проверяется, что репозиторий всё ещё приватный; публичный или неподтверждённый останавливает
+  синхронизацию до любых git-операций.
+- **CI**: GitHub Actions прогоняет тесты на каждый push.
+- **В 2.1:** свой GitHub-аккаунт у каждого пользователя, мастер настройки в один клик,
+  трёхстороннее слияние, отказ публичному репозиторию.
+
+## Как это работает
+
+1. Досье проекта лежит в приватном репозитории обмена обычными Markdown-файлами.
+2. При синхронизации плагин получает свежую версию, сливает её с локальной (3-way merge через
+   `git merge-file`) и отправляет результат обратно.
+3. Если одна и та же строка изменена по-разному — карточка конфликта с выбором
+   «Оставить моё», «Принять с GitHub» или «Объединить».
+
+Push не форсируется: если кто-то успел раньше, плагин заново получает изменения и сливает.
+
+## Установка
+
+В составе **dsh-desktop-kit 2.3+** плагин уже включён — отдельно ставить не нужно.
+
+Отдельно: в DSH **Плагины → Add plugin** → `dsh-memory-bridge` → перезапустить окно (`Ctrl+R`).
+
+Требования:
+
+- [Git for Windows](https://git-scm.com/download/win);
+- [GitHub CLI (`gh`)](https://cli.github.com/) и один раз выполненный вход `gh auth login`
+  (используется **ваш** аккаунт — данные не уходят в чужие репозитории).
+
+## Первый запуск: 2 клика
+
+1. **Настройки → «Память проектов»**. Если `gh` нет или вы не вошли — страница покажет
+   точные шаги и кнопку «Проверить снова».
+2. Когда GitHub подключён, страница покажет «GitHub: вы вошли как `<ваш-логин>`» и
+   предложит `<ваш-логин>/dsh-memory-exchange`. Нажмите **«Создать приватный репозиторий»**
+   (или впишите существующий и нажмите «Подключить»).
+3. Нажмите **«Включить синхронизацию»** — готово. Дальше всё автоматически.
+
+![Мастер подключения](https://cdn.jsdelivr.net/npm/dsh-memory-bridge@2.2.1/docs/images/setup.png)
+
+### Вторая машина
+
+Установите плагин, откройте страницу и подключите **тот же** репозиторий
+(`<ваш-логин>/dsh-memory-exchange`), затем «Включить». Откройте нужную папку проекта в DSH —
+досье подтянется из репозитория, шаблоны заменятся накопленными данными.
+
+## Конфликты
+
+Если одна и та же строка изменена на двух машинах по-разному, плагин показывает две версии
+рядом и предлагает выбор. Пока конфликт не разрешён, файл не перезаписывается ни локально,
+ни в репозитории.
+
+![Конфликты](https://cdn.jsdelivr.net/npm/dsh-memory-bridge@2.2.1/docs/images/conflicts.png)
+
+## История и откат
+
+В разделе «Проекты» у каждого проекта есть кнопка **«История»**. Она показывает commit’ы,
+которые меняли досье, с датой и автором; кнопка **«Восстановить»** возвращает файлы досье
+к выбранной версии. Текущее состояние сначала уходит в локальный бэкап, а восстановление
+оформляется обычным commit’ом — его видно в истории и можно откатить снова.
+
+## Безопасность
+
+- **Только приватный репозиторий**: плагин проверяет видимость через `gh` и отказывается
+  работать с публичным или неподтверждённым репозиторием.
+- Репозиторий принадлежит вашему GitHub-аккаунту; в поставляемом коде нет чужих владельцев
+  и репозиториев.
+- Секреты и PII вырезаются redaction-ом, домашние пути заменяются токеном `%DSH_HOME%`,
+  служебные файлы и `node_modules` в репозиторий не попадают.
+- Конфликты не разрешаются «силой»: перед записью делается локальный бэкап, вся история —
+  в Git. Плагин не вызывает LLM, не добавляет инструментов и не меняет промпт — **0 токенов**.
+
+## Скриншоты
+
+### Светлая тема
+
+![Настройки, светлая тема](https://cdn.jsdelivr.net/npm/dsh-memory-bridge@2.2.1/docs/images/settings-light.png)
+
+### Тёмная тема
+
+![Настройки, тёмная тема](https://cdn.jsdelivr.net/npm/dsh-memory-bridge@2.2.1/docs/images/settings-dark.png)
+
+### Мобильный экран
+
+<img src="https://cdn.jsdelivr.net/npm/dsh-memory-bridge@2.2.1/docs/images/settings-mobile.png" alt="Настройки на 390 px" width="390">
+
+## Где что лежит
+
+```
+GitHub (private, ваш аккаунт): <login>/dsh-memory-exchange
+  projects/<проект>--<key8>/
+      project.json          # fingerprint, имя, автор последней записи
+      PROJECT.md … RUNBOOK.md
+      JOURNAL/YYYY-MM.md
+
+Локально:
+  ~/.dsh/projects-memory/…  # рабочие досье (ведёт dsh-project-memory)
+  ~/.dsh/memory-sync/
+      config.json           # репозиторий, ветка, интервал, автосинхронизация
+      machine.json          # machineId и имя машины
+      github/<repo>/        # локальный клон репозитория обмена
+      base/<проект>/        # снимок последней успешной синхронизации
+      github-conflicts/     # неразрешённые конфликты (для страницы)
+      backups/…             # копии досье перед записью
+      log.txt               # диагностика
+```
+
+## Ограничения
+
+- Нужны сеть, git и `gh` (одноразовый вход) на каждой машине.
+- Проект должен быть git-репозиторием с remote; не-git проекты показываются как
+  «не синхронизируются» (при появлении remote плагин определяет его сам).
+- Шифрование содержимого репозитория не используется — иначе невозможно слияние Markdown;
+  приватность обеспечивается приватным репозиторием и redaction-ом.
+- Разрешение конфликта — выбор версии целиком/объединение; построчный diff-редактор —
+  в следующей версии.
+
+## Разработка
+
+```powershell
+cd <путь к dsh-memory-bridge>
+node --test        # 35 тестов: два локальных клона, асинхронные добавления, конфликты, redaction,
+                   # per-user GitHub, отказ публичному репозиторию, отсутствие личных владельцев,
+                   # Host-проверка приватности и история/откат версий
+npm pack --dry-run # состав npm-пакета
+```
+
+Скриншоты в `docs/images` генерируются из настоящего `client.js` через preview-harness:
+`node docs/preview/capture.mjs`.
+
+## Лицензия
+
+MIT — см. [LICENSE](LICENSE).