primo-rpa-mcp 0.2.0 → 0.2.1

package/.claude/skills/primo-rpa/SKILL.md

@@ -26,13 +26,14 @@ description: Разработка и диагностика роботов Primo
 | Упаковать для передачи | `pack_project` с явным `dryRun=true`, затем `dryRun=false` |
 | Опубликовать в Оркестраторе | `orchestrator_login` при необходимости → `orchestrator_upload_project` |
 | Управлять проектами, роботами и выполнениями тестового API | [Методы управления](references/orchestrator.md); только `apiProfile=test-v1` по совпадающему контракту |
-| Получить статус/логи задания рабочего Оркестратора | `orchestrator_request` по подтверждённому Swagger текущего инстанса |
+| Получить запуски, логи, версии и переменные | `orchestrator_list_launches`, `orchestrator_get_operation_events`, `orchestrator_list_project_versions`, `orchestrator_get_project_variables`; без test-v1, см. [контракт](references/orchestrator.md) |
+| Найти другие маршруты API | `orchestrator_api_catalog` → `orchestrator_request` с подтверждёнными параметрами Swagger/веб-UI |
 
 ## Граница с Monitor и универсальными инструментами
 
 Запуск через `orchestrator_start_robot` поддержан только для явного тестового контракта `test-v1`. Запуск в локальной Studio, live-браузер и непрерывный мониторинг не предоставляются этим MCP. Не выдумывай `run_robot`, `monitor_job` и другие отсутствующие инструменты.
 
-Если задача — статус задания Primo, источником истины служит API соответствующего Оркестратора: используй `orchestrator_request`, когда известны метод, путь и идентификатор из Swagger/реального ответа. Не угадывай endpoint. Специализированные методы управления реализуют предоставленный mock OpenAPI (`test-v1`); не считай их маршруты подтверждёнными для настоящего Primo. Если схемы нет, найди её в доступных материалах либо запроси недостающую схему. Для повторного опроса заранее определи интервал, конечные статусы и ограничение времени; по таймауту сообщи последний наблюдавшийся статус. Не запускай задание повторно для проверки статуса.
+Если задача — статус задания Primo, источником истины служит API соответствующего Оркестратора: используй диагностические инструменты выше либо `orchestrator_request`, когда известны метод, путь и идентификатор из Swagger/веб-UI/реального ответа. Не угадывай endpoint. Специализированные методы управления реализуют предоставленный mock OpenAPI (`test-v1`); не считай их маршруты подтверждёнными для настоящего Primo. Если схемы нет, найди её в доступных материалах либо запроси недостающую схему. Для повторного опроса заранее определи интервал, конечные статусы и ограничение времени; по таймауту сообщи последний наблюдавшийся статус. Не запускай задание повторно для проверки статуса.
 
 Если доступный клиентский `Monitor` умеет ждать локальный процесс или следить за файлом логов, он допустим именно для этой функции. Он не заменяет запрос статуса удалённого задания. Сначала проверь фактическое описание такого инструмента — не делай вывод о его возможностях по имени.
 

package/.claude/skills/primo-rpa/references/connection.md

@@ -2,7 +2,7 @@
 
 ## Локальный Оркестратор через VPN
 
-Команда `primo-rpa-mcp-hybrid`, запущенная через `npx`, — тот же гибридный режим. Примеры распространения: `examples/claude-code/mcp.hybrid.npx.json` (после публикации npm-пакета) и `mcp.hybrid.archive.json` (готовый `.tgz` в корне проекта). Эти варианты не требуют персонального абсолютного пути или сборки пользователем; нужен Node.js >= 22. До публикации не предлагай запуск по имени как уже работающий способ. Skill копируется отдельно в `.claude/skills/primo-rpa` проекта.
+Команда `primo-rpa-mcp-hybrid`, запущенная через `npx`, — тот же гибридный режим. Примеры распространения: `examples/claude-code/mcp.hybrid.npx.json` (опубликованный npm-пакет версии 0.2.0) и `mcp.hybrid.archive.json` (готовый `.tgz` в корне проекта). Эти варианты не требуют персонального абсолютного пути или сборки пользователем; нужен Node.js >= 22. Skill копируется отдельно в `.claude/skills/primo-rpa` проекта.
 
 Если `.mcp.json` запускает `build/hybrid.js` через `type:"stdio"`, все `orchestrator_*` выполняются на компьютере клиента, остальные инструменты — на VPS. Реквизиты Оркестратора остаются локально в `env.PRIMO_ORCHESTRATOR_CONNECTIONS` (строка JSON с именованными подключениями); на VPS передаётся только MCP-токен из `PRIMO_MCP_REMOTE_TOKEN`. Адрес VPS задаёт `PRIMO_MCP_REMOTE_URL`. В инструменты передавай `connection:"production"`, не пароль.
 

package/.claude/skills/primo-rpa/references/orchestrator.md

@@ -6,6 +6,19 @@
 
 Предоставленный OpenAPI явно обозначен как mock с условными маршрутами. Девять методов ниже реализуют именно его и требуют `apiProfile:"test-v1"`. Для настоящего Primo используй `orchestrator_request` с методом, `apiPath` и телом из Swagger целевой версии; не подставляй тестовые пути автоматически. Если пользователь просит управление настоящим Primo, а его контракт неизвестен, получи Swagger до вызова мутации.
 
+## Диагностика по маршрутам веб-UI
+
+Снимок веб-UI от 2026-10-08 встроен в `orchestrator_api_catalog`: 488 маршрутов, поиск по `search`, `section`, `method`, пагинация `offset`/`limit`. Неполные шаблоны не являются готовыми запросами; не угадывай параметры и схемы тел.
+
+Для чтения используй специализированные инструменты **без test-v1**:
+
+- `orchestrator_list_launches({connection:"production", pageNumber:0, pageSize:20})` — запуски, исходная структура ответа.
+- `orchestrator_get_operation_events({connection:"production", operationKey:"KEY_FROM_RESPONSE", pageNumber:0, pageSize:100})` — лог запуска.
+- `orchestrator_list_project_versions({connection:"production", rootId:26})` — `noactiveversions`; 26 — указанный пользователем корень arshin_rpa.
+- `orchestrator_get_project_variables({connection:"production", projectId:VERSION_ID})` — переменные версии из ответа списка версий, а не ID корня.
+
+Сначала прочитай фактический ответ, затем возьми operationKey или ID версии; не придумывай поля. Пагинация с нуля, размер страницы по умолчанию 100, максимум MCP 1000. Инструменты не запускают роботов. Для остальных методов `orchestrator_request` принимает подтверждённые пути Swagger/веб-UI; каталог не доказывает совместимость других версий API.
+
 ## Подключение и авторизация
 
 Предпочитай личное именованное подключение из `X-Primo-Orchestrator-Connections` в `.mcp.json`. Заголовок содержит читаемую JSON-строку либо Base64/Base64url от UTF-8 JSON той же формы, что `PRIMO_ORCHESTRATOR_CONNECTIONS`. Реквизиты можно редактировать прямо в `.mcp.json`; отдельный файл и helper необязательны. Значение `headers["X-Primo-Orchestrator-Connections"]` должно быть строкой, не объектом. Внутренние кавычки и обратные слеши экранируй по правилам JSON. Для Unicode используй JSON escapes или Base64; прямой заголовок принимает ASCII. Его параметры действуют только для этого запроса и не меняют окружение VPS. Персональная карта полностью заменяет серверную: неизвестное имя не переключает клиента на учётные данные владельца.

package/README.md

@@ -4,7 +4,7 @@ MCP-сервер для разработки роботов **Primo RPA на Jav
 
 ## Установка и подключение
 
-Для Оркестратора через корпоративный VPN используйте локальный гибридный клиент: команда `primo-rpa-mcp-hybrid` направляет все `orchestrator_*` с компьютера пользователя, остальные инструменты — на VPS. Готовые конфиги без персональных путей и инструкции по передаче архива/публикации в npm: [распространение клиента](docs/distribution.md). Нужен Node.js >= 22. Пример через npm заработает после публикации пакета; до неё используйте вариант с `.tgz`.
+Для Оркестратора через корпоративный VPN используйте локальный гибридный клиент: команда `primo-rpa-mcp-hybrid` направляет все `orchestrator_*` с компьютера пользователя, остальные инструменты — на VPS. Готовые конфиги без персональных путей и инструкции по передаче архива/публикации в npm: [распространение клиента](docs/distribution.md). Нужен Node.js >= 22. Конфигурация для версии `primo-rpa-mcp@0.2.1`: используйте пример с `npx`; вариант с `.tgz` также доступен.
 
 Ниже описан отдельный режим полностью локального MCP с файловыми путями:
 
@@ -89,7 +89,12 @@ Node.js >= 22. Сервер работает через stdio; диагност
 | `diagnose_error` | Поиск источников по сообщению ошибки; возвращает кандидаты, не подтверждённый диагноз |
 | `orchestrator_login` | Авторизация; поддерживает именованные подключения |
 | `orchestrator_upload_project` | Загрузка ZIP и публикация проекта |
-| `orchestrator_request` | Запрос к API по пути из Swagger вашего Оркестратора |
+| `orchestrator_request` | Запрос по подтверждённому пути из Swagger или веб-UI |
+| `orchestrator_api_catalog` | Поиск в 488 маршрутах из снимка веб-UI |
+| `orchestrator_list_launches` | Последние запуски с пагинацией с нуля |
+| `orchestrator_get_operation_events` | Лог запуска по operationKey |
+| `orchestrator_list_project_versions` | Версии по ID корня проекта (noactiveversions) |
+| `orchestrator_get_project_variables` | Переменные конкретной версии проекта |
 
 ## Подбор CSS-селекторов по сохранённой странице
 
@@ -263,9 +268,22 @@ Helper сохраняет другие MCP-серверы и заголовок
 
 ## Управление Оркестратором по тестовому OpenAPI
 
+Диагностические инструменты используют пути из предоставленного снимка веб-UI от 2026-10-08 и **не требуют `apiProfile:test-v1`**. Подключение и вход остаются прежними; схемы ответов не были предоставлены, поэтому возвращается исходная структура `data` с маскированием учётных данных. Совместимость с другими версиями инстанса требует проверки.
+
+```js
+orchestrator_list_launches({connection:"production", pageNumber:0, pageSize:20})
+orchestrator_get_operation_events({connection:"production", operationKey:"KEY_FROM_LAUNCH", pageNumber:0, pageSize:100})
+orchestrator_list_project_versions({connection:"production", rootId:26})
+orchestrator_get_project_variables({connection:"production", projectId:VERSION_ID_FROM_RESPONSE})
+```
+
+Для `arshin_rpa` пользователь указал ID корня 26; он не зашит в инструмент и не заменяет ID версии. Номер страницы начинается с 0; по умолчанию 100 записей, максимум MCP 1000 (целевой API может иметь меньший лимит). Сортировка последних запусков определяется сервером; MCP не пересортировывает ответ и не придумывает поля ответа.
+
+`orchestrator_api_catalog({section:"RobotLogs", search:"OperationEvents", method:"GET"})` ищет по встроенному каталогу всех 488 путей. `limit` (1–100, по умолчанию 30) и `offset` позволяют листать результаты; `nextOffset` указывает следующую страницу. Пути уже включают `/api`. Шаблоны `{param}`, `//`, `${...}` сохранены как в исходнике: каталог не даёт схем тел и не восстанавливает потерянные параметры. Для прочих запросов нужны реальные параметры и тело из целевого API; каталог сам ничего не вызывает. Маршруты из файла доступны через существующий `orchestrator_request` после заполнения подтверждённых параметров.
+
 Добавлены `orchestrator_list_projects`, `orchestrator_create_project`, `orchestrator_get_project`, `orchestrator_delete_project`, `orchestrator_list_robots`, `orchestrator_get_robot`, `orchestrator_start_robot`, `orchestrator_get_execution`, `orchestrator_stop_execution`.
 
-Предоставленный OpenAPI явно помечен как mock с условными маршрутами. Эти инструменты требуют `apiProfile: "test-v1"` и явное подключение (`connection` либо `baseUrl` и `bearerToken`). Совместимость с настоящим Primo Оркестратором не подтверждена. Его методы вызывайте по проверенному Swagger через `orchestrator_request`.
+Предоставленный OpenAPI явно помечен как mock с условными маршрутами. Эти инструменты требуют `apiProfile: "test-v1"` и явное подключение (`connection` либо `baseUrl` и `bearerToken`). Совместимость с настоящим Primo Оркестратором не подтверждена. Для чтения запусков, логов, версий и переменных используйте диагностические инструменты ниже; остальные методы вызывайте через `orchestrator_request` по проверенному Swagger или фактическим запросам веб-UI.
 
 Для входа в тестовый API передайте `orchestrator_login` профиль `test-v1`: `userName` преобразуется в поле `login`, запрос идёт на `/api/Account`, токен именованного подключения берётся из `token` (либо настроенного `tokenField`). Прежняя авторизация `/api/account` сохраняется по умолчанию (`official-upload`).
 

package/build/hybrid.js

@@ -11,8 +11,8 @@ async function main() {
     if (url.protocol !== 'https:' || url.username || url.password || url.hash || !token || /[\r\n\0]/.test(token))
         throw new Error('Invalid remote configuration');
     const localServer = createPrimoServer({ fileMode: 'content' });
-    const local = new Client({ name: 'primo-local-orchestrator', version: '0.2.0' });
-    const remote = new Client({ name: 'primo-remote-tools', version: '0.2.0' });
+    const local = new Client({ name: 'primo-local-orchestrator', version: '0.2.1' });
+    const remote = new Client({ name: 'primo-remote-tools', version: '0.2.1' });
     const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
     let bridge;
     const close = async () => {

package/build/hybridServer.js

@@ -10,7 +10,7 @@ export async function createHybridServer(local, remote) {
     const remoteTools = remoteList.tools.filter(tool => !tool.name.startsWith('orchestrator_'));
     const localNames = new Set(localTools.map(tool => tool.name));
     const remoteNames = new Set(remoteTools.map(tool => tool.name));
-    const server = new Server({ name: 'primo-rpa-mcp', version: '0.2.0' }, {
+    const server = new Server({ name: 'primo-rpa-mcp', version: '0.2.1' }, {
         capabilities: { tools: {} },
         instructions: CONTENT_INSTRUCTIONS
             .replace('This MCP runs remotely.', 'This MCP uses a local stdio bridge to a hosted MCP.')

package/build/server.js

@@ -6,6 +6,7 @@ import { registerExtractSchema } from "./tools/extractSchema.js";
 import { registerPackProject } from "./tools/packProject.js";
 import { registerDocsSearch } from "./tools/docsSearch.js";
 import { registerOrchestratorManagement } from "./tools/orchestratorManagement.js";
+import { registerOrchestratorCatalog } from "./tools/orchestratorCatalog.js";
 import { registerOrchestrator } from "./tools/orchestrator.js";
 import { registerValidateProject } from "./tools/validateProject.js";
 import { registerAnalyzeProject } from "./tools/analyzeProject.js";
@@ -13,13 +14,14 @@ import { registerProcessEditing } from "./tools/processEditing.js";
 import { registerSuggestSelectors } from "./tools/suggestSelectors.js";
 import { registerContentTools } from "./tools/contentTools.js";
 import { installAccessGate } from "./access/mcp.js";
-export const CONTENT_INSTRUCTIONS = "This MCP runs remotely. Projects stay on the client computer. Read local files with Claude Code local tools and send explicit files snapshots {path: relative POSIX path, content, encoding: utf8 or base64}. Paths are labels within the snapshot, never local absolute paths or server filesystem access. File tools return fileChanges; they never save to the client. Before saving locally, compare the current exact-byte SHA-256 to expectedHash; null requires the file to be absent. Verify saved bytes match sha256. On conflict reread and preview again. patch_process apply=true only prepares replacement content; applied=false and localFilesWritten=false remain true until the client saves. Validate using a fresh snapshot of the saved local files. Only upload files required for the task; never include credentials or .git. analyze_project requires an analyzer installed on this server. Structural checks never execute robots. Personal named Orchestrator connections come from the authenticated request X-Primo-Orchestrator-Connections header; use their connection name in tools instead of passing credentials as tool arguments. Dedicated Orchestrator management tools require apiProfile=test-v1 and implement an illustrative test contract. Verify target Swagger before use; production routes must be confirmed.";
+export const CONTENT_INSTRUCTIONS = "This MCP runs remotely. Projects stay on the client computer. Read local files with Claude Code local tools and send explicit files snapshots {path: relative POSIX path, content, encoding: utf8 or base64}. Paths are labels within the snapshot, never local absolute paths or server filesystem access. File tools return fileChanges; they never save to the client. Before saving locally, compare the current exact-byte SHA-256 to expectedHash; null requires the file to be absent. Verify saved bytes match sha256. On conflict reread and preview again. patch_process apply=true only prepares replacement content; applied=false and localFilesWritten=false remain true until the client saves. Validate using a fresh snapshot of the saved local files. Only upload files required for the task; never include credentials or .git. analyze_project requires an analyzer installed on this server. Structural checks never execute robots. Personal named Orchestrator connections come from the authenticated request X-Primo-Orchestrator-Connections header; use their connection name in tools instead of passing credentials as tool arguments. Legacy Orchestrator management tools require apiProfile=test-v1 and implement an illustrative test contract. Diagnostic tools (list_launches, get_operation_events, list_project_versions, get_project_variables) use user-supplied UI routes without test-v1. orchestrator_api_catalog searches the full UI route snapshot; incomplete templates require actual parameters and body schemas before orchestrator_request. Compatibility depends on the target version.";
 export function createPrimoServer(options = {}) {
     const contentMode = options.fileMode === "content";
-    const server = new McpServer({ name: "primo-rpa-mcp", version: "0.2.0" }, contentMode ? { instructions: CONTENT_INSTRUCTIONS } : {});
+    const server = new McpServer({ name: "primo-rpa-mcp", version: "0.2.1" }, contentMode ? { instructions: CONTENT_INSTRUCTIONS } : {});
     if (options.access)
         installAccessGate(server, options.access);
     registerOrchestratorManagement(server);
+    registerOrchestratorCatalog(server);
     if (contentMode) {
         registerContentTools(server);
         registerDocsSearch(server);

package/build/tools/orchestrator.js

@@ -3,7 +3,7 @@ import { readFile } from "node:fs/promises";
 import { OrchestratorClient, resolveConnection, rememberToken } from "../orchestrator/client.js";
 /** Publication uses the official UploadProjectWithOrchApi contract.
  * The explicit test-v1 login profile uses the user-supplied mock OpenAPI.
- * Other production routes must be confirmed by the target installation's Swagger.
+ * Other production routes must be confirmed by Swagger or evidence from the target UI.
  */
 async function parseJsonSafe(res) {
     const text = await res.text();
@@ -195,16 +195,15 @@ export function registerOrchestrator(server) {
     server.registerTool("orchestrator_request", {
         title: "Произвольный запрос к API Оркестратора",
         description: "Generic-клиент для эндпоинтов Оркестратора, которых нет среди готовых инструментов " +
-            "(например управление роботами/заданиями/очередями). ВАЖНО: полный список таких " +
-            "эндпоинтов не публикуется — используйте только пути, которые вы сами нашли в " +
-            "Swagger вашего инстанса Оркестратора (руководство «Открытие Swagger» из комплекта " +
-            "поставки). Не угадывайте пути.",
+            "(например управление роботами/заданиями/очередями). Используйте orchestrator_api_catalog " +
+            "для поиска путей из снимка веб-UI либо Swagger вашего инстанса. Шаблоны каталога " +
+            "могут быть неполными: нужны фактические параметры и схема тела. Не угадывайте их.",
         inputSchema: {
             connection: z.string().optional().describe("Имя персонального подключения из HTTP-заголовка либо серверного PRIMO_ORCHESTRATOR_CONNECTIONS"),
             baseUrl: z.string().optional(),
             bearerToken: z.string().optional(),
             method: z.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]),
-            apiPath: z.string().describe('Путь, начиная с "/api/...", как в вашем Swagger'),
+            apiPath: z.string().describe('Путь, начиная с "/api/...", по Swagger или подтверждённому запросу веб-UI'),
             jsonBody: z.record(z.string(), z.unknown()).optional(),
         },
     }, async (params, extra) => {

package/build/tools/orchestratorCatalog.js

@@ -0,0 +1,36 @@
+import { readFile } from 'node:fs/promises';
+import { z } from 'zod';
+export function registerOrchestratorCatalog(server) {
+    server.registerTool('orchestrator_api_catalog', {
+        title: 'Каталог API Оркестратора из веб-UI',
+        description: 'Поиск путей в пользовательском снимке веб-UI от 2026-10-08. Не делает HTTP-запросов. Пути уже включают /api. Шаблоны с {param}, //, ${...} могут быть неполными; это справочник маршрутов, а не схем тел или ответов. Для вызова нужны фактические параметры целевого инстанса.',
+        inputSchema: {
+            search: z.string().max(512).optional().describe('Подстрока пути, раздела или функции UI; без учёта регистра'),
+            section: z.string().max(100).optional().describe('Точное имя раздела без учёта регистра, например RobotLogs'),
+            method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']).optional(),
+            offset: z.number().int().safe().min(0).default(0),
+            limit: z.number().int().min(1).max(100).default(30),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ search, section, method, offset, limit }) => {
+        try {
+            const catalog = JSON.parse(await readFile(new URL('../../data/orchestrator-api-paths.json', import.meta.url), 'utf8'));
+            const query = search?.trim().toLowerCase();
+            const entries = catalog.entries.filter(entry => (!section || entry.section.toLowerCase() === section.toLowerCase())
+                && (!method || entry.method === method)
+                && (!query || `${entry.section} ${entry.pathTemplate} ${entry.uiFunction}`.toLowerCase().includes(query)));
+            const end = offset + limit;
+            const structuredContent = {
+                source: catalog.source, sourceDate: catalog.sourceDate, totalRoutes: catalog.entries.length,
+                sections: [...new Set(catalog.entries.map(entry => entry.section))],
+                matchedRoutes: entries.length, offset, nextOffset: end < entries.length ? end : null,
+                notice: 'Извлечение из UI, без схем тел и ответов; неполные шаблоны нельзя вызывать буквально. Совместимость зависит от версии инстанса.',
+                entries: entries.slice(offset, end),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(structuredContent, null, 2) }], structuredContent };
+        }
+        catch {
+            return { content: [{ type: 'text', text: 'Не удалось загрузить встроенный каталог API Оркестратора' }], isError: true };
+        }
+    });
+}

package/build/tools/orchestratorManagement.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { OrchestratorClient, resolveConnection } from '../orchestrator/client.js';
-// Routes below implement the supplied illustrative test-v1 OpenAPI contract,
-// not a claim about the production Swagger of a Primo installation.
+// Legacy management routes use the illustrative test-v1 contract.
+// Diagnostic GET routes come from the user-supplied Orchestrator UI extraction.
 const MIN_INT64 = -(1n << 63n);
 const MAX_INT64 = (1n << 63n) - 1n;
 const safeInteger = z.number().int().safe('Нужен безопасный целый JavaScript; значение потеряет точность');
@@ -43,11 +43,12 @@ function redactData(value, secrets) {
     return value;
 }
 export function registerOrchestratorManagement(server) {
-    function register(name, title, method, fields, request) {
+    function register(name, title, method, fields, request, source = 'test-v1') {
+        const connectionFields = { connection: common.connection, baseUrl: common.baseUrl, bearerToken: common.bearerToken };
         server.registerTool(name, {
             title,
-            description: `${title}. Только apiProfile=test-v1: маршрут из предоставленного иллюстративного OpenAPI; совместимость с рабочим Оркестратором требует проверки его Swagger. ${method === 'GET' ? '' : 'Изменяет состояние Оркестратора; вызывайте только по запросу пользователя. Автоматических повторов нет.'}`,
-            inputSchema: { ...common, ...fields },
+            description: `${title}. ${source === 'test-v1' ? 'Только apiProfile=test-v1: маршрут из предоставленного иллюстративного OpenAPI; совместимость с рабочим Оркестратором требует проверки его Swagger.' : 'Маршрут из веб-UI Оркестратора (снимок 2026-10-08); возвращает исходную структуру ответа с маскированием учётных данных. Совместимость зависит от версии инстанса.'} ${method === 'GET' ? '' : 'Изменяет состояние Оркестратора; вызывайте только по запросу пользователя. Автоматических повторов нет.'}`,
+            inputSchema: { ...(source === 'test-v1' ? common : connectionFields), ...fields },
             annotations: { readOnlyHint: method === 'GET', destructiveHint: method === 'DELETE', idempotentHint: method !== 'POST', openWorldHint: true },
         }, async (params, extra) => {
             let client;
@@ -74,7 +75,7 @@ export function registerOrchestratorManagement(server) {
                     }
                 }
                 const structuredContent = {
-                    apiProfile: 'test-v1', testContract: true, method, apiPath: path,
+                    ...(source === 'test-v1' ? { apiProfile: 'test-v1', testContract: true } : { routeSource: 'ui-extracted', sourceDate: '2026-10-08', testContract: false }), method, apiPath: path,
                     status: response.status, data: redactData(data, secrets),
                 };
                 return { content: [{ type: 'text', text: JSON.stringify(structuredContent, null, 2) }], structuredContent, isError: !response.ok };
@@ -104,4 +105,27 @@ export function registerOrchestratorManagement(server) {
     }, ({ robotId, projectId, version, arguments: args }) => ({ path: `/api/Robots/${id(robotId)}`, body: { projectId, ...(version !== undefined ? { version } : {}), ...(args !== undefined ? { arguments: args } : {}) } }));
     register('orchestrator_get_execution', 'Прочитать статус выполнения', 'GET', { executionId: pathId }, params => ({ path: `/api/Executions/${id(params.executionId)}` }));
     register('orchestrator_stop_execution', 'Остановить выполнение', 'DELETE', { executionId: pathId }, params => ({ path: `/api/Executions/${id(params.executionId)}` }));
+    const pagination = {
+        pageNumber: safeInteger.min(0).default(0).describe('Номер страницы с нуля'),
+        pageSize: safeInteger.min(1).max(1000).default(100).describe('Размер страницы; лимит MCP 1000, сервер может ограничивать сильнее'),
+    };
+    const projectId = pathId.refine(value => { try {
+        return BigInt(value) > 0n;
+    }
+    catch {
+        return false;
+    } }, 'Нужен положительный ID проекта');
+    register('orchestrator_list_launches', 'Последние запуски проектов', 'GET', pagination, params => ({ path: `/api/rpaprojectlaunches/all?pageNumber=${params.pageNumber}&pageSize=${params.pageSize}` }), 'ui-extracted');
+    register('orchestrator_get_operation_events', 'Лог запуска по operationKey', 'GET', {
+        operationKey: z.string().min(1).max(512)
+            .refine(value => value.trim() === value && !/[\u0000-\u001f\u007f]/.test(value) && value !== '.' && value !== '..', 'Нужен непустой operationKey без пробелов по краям и управляющих символов')
+            .describe('operationKey из ответа списка запусков; идентификатор передаётся как один кодированный сегмент пути'),
+        ...pagination,
+    }, params => ({ path: `/api/robotlogs/OperationEvents/${id(params.operationKey)}?pageNumber=${params.pageNumber}&pageSize=${params.pageSize}` }), 'ui-extracted');
+    register('orchestrator_list_project_versions', 'Версии проекта (noactiveversions)', 'GET', {
+        rootId: projectId.describe('ID корня проекта, а не версии; для arshin_rpa пользователь указал 26'),
+    }, params => ({ path: `/api/rpaprojects/${id(params.rootId)}/noactiveversions` }), 'ui-extracted');
+    register('orchestrator_get_project_variables', 'Переменные версии проекта', 'GET', {
+        projectId: projectId.describe('ID конкретной версии из ответа списка версий; не подставляйте ID корня автоматически'),
+    }, params => ({ path: `/api/rpaprojectvariables/project/${id(params.projectId)}` }), 'ui-extracted');
 }