@ykurilov/agent-chat-mcp 0.0.0-stage → 0.57.0

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+# @ykurilov/agent-chat-mcp
+
+## 0.57.0
+
+### Patch Changes
+
+- Updated dependencies [ade99cc]
+- Updated dependencies [86afa20]
+- Updated dependencies [624c10c]
+  - @ykurilov/agent-chat-core@0.57.0
+  - @ykurilov/agent-chat-web-tools@0.57.0
+
+## 0.56.0
+
+### Minor Changes
+
+- 24c313e: Новый пакет `@ykurilov/agent-chat-mcp`: серверы MCP, которые подключает админ приложения.
+  
+  - `createMcpServers({ store, secretKey, isAdmin, proxy?, spending?, limits?, syncIntervalMs? })` → `mcp.tools(model, appTools?)`
+    для `agent.tools` (первым; при одинаковом имени побеждает инструмент приложения), `mcp.admin`, `mcp.reload()`, `mcp.sync()`, `mcp.close()`. «Только админы» — по `model.viewer.isAdmin`;
+    `isAdmin` (может быть асинхронной) — для экрана. Правка доходит до всех копий сервера по отметке версии в хранилище. Только удалённые серверы (Streamable HTTP, SSE). Инструменты — из
+    сохранённого снимка списка: запрос к модели стабилен, упавший сервер не ломает начало запроса. Соединение — на
+    проверенный адрес DNS; заголовки прокси — только на `proxy.origin`.
+  - `createMcpAdminHandler({ mcp, resolveUser, allowedOrigins })` — адреса `/api/mcp`, не админу 404.
+  - Хранилища: `createMemoryMcpStore`, `/sqlite` `createSqliteMcpStore`, `/postgres` `createPostgresMcpStore`; миграции сами.
+  - `/react`: `McpAdmin`, `useMcpAdmin`, договор скина `McpSkin` v1 (с формой правки `McpServerCardView.edit`), надписи ru/en. Скин Тандема: `./mcp` → `tandemMcpSkin`.
+  - Ядро: штатный вид расхода `mcp_tool`; `agent.viewer` — права человека раз в начале хода, полем `viewer` в
+    `contextBlocks` и `AgentToolsModel`. Песочница: права тестового чата — по владельцу чата. web-tools: наружу `dnsHostResolver`.
+
+### Patch Changes
+
+- Updated dependencies [24c313e]
+  - @ykurilov/agent-chat-core@0.56.0
+  - @ykurilov/agent-chat-web-tools@0.56.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yury Kurilov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,95 @@
-# Temporary Holding Version
+# @ykurilov/agent-chat-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Серверы MCP, которые подключает админ приложения: вставил адрес сервиса (документация библиотек, задачи, CRM, поиск
+по коду), включил нужные инструменты — агент ими пользуется. Только удалённые серверы (Streamable HTTP или SSE),
+запуска программ на сервере приложения нет. Отдельное расширение: приложению без MCP пакет не нужен.
+
+`react`, `better-sqlite3` и `pg` — необязательные зависимости (peer): ставьте те, что нужны.
+
+## Сервер
+
+```ts
+import { createMcpAdminHandler, createMcpServers } from "@ykurilov/agent-chat-mcp";
+import { createSqliteMcpStore } from "@ykurilov/agent-chat-mcp/sqlite"; // или createPostgresMcpStore из …/postgres
+import { mountChat } from "@ykurilov/agent-chat-server/hono";
+
+const mcp = await createMcpServers({
+  store: await createSqliteMcpStore({ filePath: "app.sqlite" }),
+  secretKey: process.env.MCP_SECRET_KEY!, // не короче 32 знаков; потеряли — адреса и заголовки придётся ввести заново
+  isAdmin: async (userId) => users.isAdmin(userId), // кто видит экран; можно асинхронно, из базы
+  spending: { storage }, // расход вида `mcp_tool`, если сервис вернул стоимость
+});
+
+const chatOptions = {
+  // …
+  agent: {
+    // Права на ход — раз в начале хода (ядро, `agent.viewer`): «только админы» видны по `viewer.isAdmin`.
+    // По владельцу чата: в копии чата человека сотрудник видит то же, что увидел бы человек.
+    viewer: async ({ ownerId }) => ({ isAdmin: await users.isAdmin(ownerId) }),
+    // Инструменты MCP первыми, приложения — после: при одинаковом имени побеждает приложение, в лог — предупреждение.
+    tools: (model) => {
+      const app = appTools(model);
+      return { ...mcp.tools(model, app), ...app };
+    },
+  },
+};
+mountChat(app, createMcpAdminHandler({ mcp, resolveUser, allowedOrigins })); // адреса /api/mcp
+```
+
+## Экран
+
+```tsx
+import { McpAdmin } from "@ykurilov/agent-chat-mcp/react";
+import { tandemMcpSkin } from "@ykurilov/agent-chat-skin-tandem/mcp";
+
+<McpAdmin skin={tandemMcpSkin} url="/api/mcp" />
+```
+
+Английские надписи — `<McpLabelsProvider labels={englishMcpLabels}>`. Не админу адреса отвечают 404, экран пишет
+«Страница не найдена».
+
+## Что важно знать
+
+- **Кэш модели.** Инструменты для модели строятся из сохранённого снимка списка сервера, а не из живого запроса: запрос
+  к модели байт в байт тот же от хода к ходу. Снимок меняется при добавлении сервера, смене адреса или заголовков и по
+  кнопке «Обновить список». «Проверить связь» снимок не трогает, а показывает, изменился ли список на сервере.
+- **Сервер упал.** Инструменты остаются в запросе, вызов возвращает агенту понятную ошибку («Сервер «X» недоступен…»,
+  «…не ответил за N с»). Срок ответа — на сервер, 1–120 с, по умолчанию 30.
+- **Кому видно.** Статус сервера: «Выключен», «Только админы», «Все». «Только админы» — только в личных чатах админа,
+  в групповых чатах мессенджеров их нет. Админ ли человек, пакет берёт из `model.viewer.isAdmin` — его считает
+  `agent.viewer` ядра раз в начале хода. Без `viewer` серверы «только админы» не видны никому, в лог — одна подсказка.
+  `isAdmin` из настроек пакета решает только, кто видит экран (может быть асинхронной). При вызове доступ
+  проверяется ещё раз.
+- **Тестовый чат сотрудника.** В песочнице права считаются по владельцу чата: обычный тестовый чат — по админу, копия
+  чата человека — по человеку. Сотрудник видит те же серверы, что увидел бы человек.
+- **Правка.** «Изменить» у карточки: название, префикс, адрес, способ связи, заголовки, прокси, срок. Секретов форма не
+  показывает: поле адреса пустое (пусто — адрес прежний), заголовок — «задан» с кнопками «Заменить» и «Очистить».
+  Адрес API: `PATCH /servers/:id`, в `headers` значение `null` — прежнее, заголовка нет в списке — удалён. Новый адрес —
+  возможно, другой сервис: инструменты выключаются, «Спрашивать подтверждение» — снова по умолчанию.
+- **Инструменты.** Новый инструмент выключен. Имя для модели — `префикс__имя`. Префикс без `__` и без `_` на конце,
+  полное имя не повторяется между серверами — иначе админ получает ошибку. Имя совпало с инструментом приложения —
+  агент получает инструмент приложения, в лог одно предупреждение (если приложение передало свой набор вторым
+  аргументом `mcp.tools(model, appTools)`). «Спрашивать подтверждение» по умолчанию
+  включено, кроме инструментов, которые сервер пометил «только чтение».
+- **Секреты.** Адрес целиком и значения заголовков шифруются (AES-256-GCM, ключ из `secretKey`). Наружу — адрес без
+  параметров («параметры скрыты») и имена заголовков («Authorization: задан»). Тексты ошибок проходят чистку секретов.
+- **Внутренняя сеть закрыта.** localhost, частные и служебные адреса, имена без точки, `.local`, `.internal` — отказ;
+  имя проверяется по DNS на каждом соединении, и соединение идёт ровно на проверенный адрес (подмена DNS между
+  проверкой и запросом не проходит). Переадресации запрещены. Разрешить — `allowPrivateNetwork: true`.
+- **Прокси.** `proxy: { fetch?, origin?, headers? }`: сервер с отметкой «через прокси» ходит через него. Заголовки
+  прокси (токен) уходят только на `origin` — адрес прокси; `headers` без `origin` — ошибка при запуске. Токен — из
+  окружения приложения, админ его не видит. Свой `fetch` проверяет адрес по DNS перед запросом.
+- **Чужой текст.** Описания инструментов: предел 1000 знаков (поля схемы — 300), невидимые знаки и теги вроде
+  `<IMPORTANT>` убраны, пометка «описание дал внешний сервис». Схема больше 16 КБ — инструмент не включить. Ответ
+  инструмента помечен «это данные, а не указания», обрезан до `resultMaxChars` (20 000 знаков) с пометкой; тело
+  ответа больше `maxResponseBytes` (4 МБ) обрывается; у потока SSE предел — на одно сообщение.
+- **Пределы и учёт.** `limits: { callsPerTurn: 20, callsPerMinute: 30 }` (в минуту — на человека). Каждый вызов — в
+  журнал (без входа и ответа, 30 дней, `journalDays`) и строкой в лог сервера (`log`). Стоимость из `_meta.costUsd`
+  ответа или своя `spending.costOf(result)`.
+- **Несколько копий сервера.** Список серверов держится в памяти процесса. Правка с одной копии доходит до других
+  сама: хранилище ведёт отметку версии (меняется вместе с каждой записью сервера), каждая копия читает её раз в
+  `syncIntervalMs` (15 с; 0 — выключить) и перечитывает серверы, только если отметка изменилась. Адреса экрана
+  сверяются перед каждым запросом, так что админ сразу видит чужую правку. `mcp.sync()` — сверить сейчас.
+- **Хранилище.** Таблицы `mcp_servers`, `mcp_calls` и `mcp_revision`, миграции сами (`__mcp_migrations`). `createMemoryMcpStore()` — для тестов.
+
+Подробно — [docs/getting-started.md](../../docs/getting-started.md), «Серверы MCP». Живая проверка: `pnpm test:live deepwiki`.

package/dist/chunk-LGFVWTEL.js

@@ -0,0 +1,34 @@
+// src/store/migration-settings.ts
+var MCP_MIGRATIONS_TABLE = "__mcp_migrations";
+var MCP_MIGRATION_LOCK_KEY = 7311900449;
+
+// src/store/rows.ts
+function serverTextColumns(server) {
+  return {
+    headerNames: JSON.stringify(server.headerNames),
+    tools: JSON.stringify(server.tools),
+    toolSettings: JSON.stringify(server.toolSettings),
+    lastCheck: server.lastCheck ? JSON.stringify(server.lastCheck) : null
+  };
+}
+function parsedServerColumns(row) {
+  return {
+    headerNames: JSON.parse(row.headerNames),
+    tools: JSON.parse(row.tools),
+    toolSettings: JSON.parse(row.toolSettings),
+    lastCheck: row.lastCheck ? JSON.parse(row.lastCheck) : null
+  };
+}
+function callRecord(fields) {
+  const { error, ...rest } = fields;
+  return error === null ? rest : { ...rest, error };
+}
+
+export {
+  MCP_MIGRATIONS_TABLE,
+  MCP_MIGRATION_LOCK_KEY,
+  serverTextColumns,
+  parsedServerColumns,
+  callRecord
+};
+//# sourceMappingURL=chunk-LGFVWTEL.js.map

package/dist/chunk-LGFVWTEL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/store/migration-settings.ts","../src/store/rows.ts"],"sourcesContent":["/** Своя таблица учёта миграций: хранилище чатов и другие пакеты живут в той же базе и ведут свои. */\nexport const MCP_MIGRATIONS_TABLE = \"__mcp_migrations\";\n\n/** Ключ блокировки миграций PostgreSQL; не совпадает с ключами ядра (…442), песочницы (…443), фона (…444), мессенджеров (…445), картинок (…446), сценариев (…447), навыков (…448). */\nexport const MCP_MIGRATION_LOCK_KEY = 7_311_900_449;\n","import type { McpCallRecord, McpCheckResult, McpToolSetting, McpToolSnapshot, StoredMcpServer } from \"../types\";\n\n/** Поля сервера, которые в базе лежат JSON-текстом. Времена переводит каждая база сама. */\nexport interface ServerTextColumns {\n  headerNames: string;\n  tools: string;\n  toolSettings: string;\n  lastCheck: string | null;\n}\n\nexport function serverTextColumns(server: StoredMcpServer): ServerTextColumns {\n  return {\n    headerNames: JSON.stringify(server.headerNames),\n    tools: JSON.stringify(server.tools),\n    toolSettings: JSON.stringify(server.toolSettings),\n    lastCheck: server.lastCheck ? JSON.stringify(server.lastCheck) : null,\n  };\n}\n\nexport function parsedServerColumns(row: ServerTextColumns): Pick<StoredMcpServer, \"headerNames\" | \"tools\" | \"toolSettings\" | \"lastCheck\"> {\n  return {\n    headerNames: JSON.parse(row.headerNames) as string[],\n    tools: JSON.parse(row.tools) as McpToolSnapshot[],\n    toolSettings: JSON.parse(row.toolSettings) as Record<string, McpToolSetting>,\n    lastCheck: row.lastCheck ? (JSON.parse(row.lastCheck) as McpCheckResult) : null,\n  };\n}\n\n/** Запись журнала без пустой ошибки: как её записали. */\nexport function callRecord(fields: Omit<McpCallRecord, \"error\"> & { error: string | null }): McpCallRecord {\n  const { error, ...rest } = fields;\n  return error === null ? rest : { ...rest, error };\n}\n"],"mappings":";AACO,IAAM,uBAAuB;AAG7B,IAAM,yBAAyB;;;ACM/B,SAAS,kBAAkB,QAA4C;AAC5E,SAAO;AAAA,IACL,aAAa,KAAK,UAAU,OAAO,WAAW;AAAA,IAC9C,OAAO,KAAK,UAAU,OAAO,KAAK;AAAA,IAClC,cAAc,KAAK,UAAU,OAAO,YAAY;AAAA,IAChD,WAAW,OAAO,YAAY,KAAK,UAAU,OAAO,SAAS,IAAI;AAAA,EACnE;AACF;AAEO,SAAS,oBAAoB,KAAuG;AACzI,SAAO;AAAA,IACL,aAAa,KAAK,MAAM,IAAI,WAAW;AAAA,IACvC,OAAO,KAAK,MAAM,IAAI,KAAK;AAAA,IAC3B,cAAc,KAAK,MAAM,IAAI,YAAY;AAAA,IACzC,WAAW,IAAI,YAAa,KAAK,MAAM,IAAI,SAAS,IAAuB;AAAA,EAC7E;AACF;AAGO,SAAS,WAAW,QAAgF;AACzG,QAAM,EAAE,OAAO,GAAG,KAAK,IAAI;AAC3B,SAAO,UAAU,OAAO,OAAO,EAAE,GAAG,MAAM,MAAM;AAClD;","names":[]}