@hotmeshio/long-tail 0.1.4 → 0.1.6

package/build/system/activities/triage/tools.js

@@ -1,178 +1,19 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BASE_TAGS = void 0;
 exports.loadTriageTools = loadTriageTools;
 exports.callTriageTool = callTriageTool;
-const context_1 = require("../../../services/iam/context");
-const ephemeral_1 = require("../../../services/iam/ephemeral");
-const logger_1 = require("../../../services/logger");
-const mcpClient = __importStar(require("../../../services/mcp/client"));
-const mcpDbService = __importStar(require("../../../services/mcp/db"));
-const yamlDb = __importStar(require("../../../services/yaml-workflow/db"));
-const yamlDeployer = __importStar(require("../../../services/yaml-workflow/deployer"));
-const strategy_advisors_1 = require("../../workflows/mcp-query/strategy-advisors");
+const tool_executor_1 = require("../../workflows/shared/tool-executor");
+const tool_loader_1 = require("../../workflows/shared/tool-loader");
 const cache_1 = require("./cache");
-/** Base tags always included — triage always needs DB for investigation + compiled workflows */
+/** Base tags always included — triage always needs DB + compiled workflows */
 exports.BASE_TAGS = ['workflows', 'compiled', 'database'];
-// ── LLM + MCP tool activities ────────────────────────────────
-/**
- * Single activity that discovers, caches, and returns a lightweight summary.
- *
- * Full ChatCompletionTool definitions are cached in module-level toolDefCache
- * so they never flow through the durable pipe. Only tool IDs (qualified name
- * strings) and a compact inventory string are returned.
- *
- * Includes strategy advisor section for overlapping server categories.
- *
- * @param tags - MCP server tags to scope by (merged with BASE_TAGS).
- *               Pass undefined/empty to load all servers.
- */
 async function loadTriageTools(tags) {
-    logger_1.loggerRegistry.debug(`[mcpTriage:loadTriageTools] tags: ${tags?.join(',') || 'all'}`);
-    let servers;
-    if (tags?.length) {
-        const combinedTags = [...new Set([...exports.BASE_TAGS, ...tags])];
-        servers = await mcpDbService.findServersByTags(combinedTags, 'any');
-    }
-    else {
-        const result = await mcpDbService.listMcpServers({ limit: 100 });
-        servers = result.servers;
-    }
-    const toolIds = [];
-    const inventoryLines = [];
-    const serverInfos = [];
-    for (const server of servers) {
-        const manifest = server.tool_manifest || [];
-        const slug = server.name.replace(/[^a-zA-Z0-9]/g, '_');
-        const serverTags = server.tags?.length ? server.tags.join(', ') : 'general';
-        const toolNames = [];
-        for (const t of manifest) {
-            const qualifiedName = `${slug}__${t.name}`;
-            cache_1.toolServerMap.set(qualifiedName, server.name);
-            cache_1.toolDefCache.set(qualifiedName, {
-                type: 'function',
-                function: {
-                    name: qualifiedName,
-                    description: `[${server.name}] ${t.description || ''}`,
-                    parameters: (t.inputSchema || { type: 'object', properties: {} }),
-                },
-            });
-            toolIds.push(qualifiedName);
-            toolNames.push(t.name);
-        }
-        inventoryLines.push(`• ${server.name} [${serverTags}] (${manifest.length} tools): ${toolNames.join(', ')}`);
-        serverInfos.push({
-            name: server.name,
-            description: server.description || null,
-            tags: server.tags || [],
-            metadata: server.metadata || null,
-            toolNames,
-            toolCount: manifest.length,
-            slug,
-        });
-    }
-    const strategy = (0, strategy_advisors_1.generateStrategySection)(serverInfos);
-    logger_1.loggerRegistry.info(`[mcpTriage:loadTriageTools] ${servers.length} servers, ${toolIds.length} tools loaded`);
-    return { toolIds, inventory: inventoryLines.join('\n'), strategy };
+    return (0, tool_loader_1.loadToolsFromServers)(tags, { toolServerMap: cache_1.toolServerMap, toolDefCache: cache_1.toolDefCache }, {
+        baseTags: exports.BASE_TAGS,
+        logPrefix: 'mcpTriage',
+    });
 }
-/**
- * Call any tool by its qualified name — handles both YAML workflows
- * (yaml__* prefix) and raw MCP tools (server_slug__tool_name).
- */
 async function callTriageTool(qualifiedName, args) {
-    // Check if this is a compiled YAML workflow
-    const yamlWorkflowName = cache_1.yamlWorkflowMap.get(qualifiedName);
-    if (yamlWorkflowName) {
-        try {
-            const wf = await yamlDb.getYamlWorkflowByName(yamlWorkflowName);
-            if (!wf || wf.status !== 'active') {
-                return { error: `Compiled workflow "${yamlWorkflowName}" is not active` };
-            }
-            // Inject _scope from the current ToolContext so YAML workers get IAM
-            const toolCtx = (0, context_1.getToolContext)();
-            const scopedArgs = toolCtx?.principal.id
-                ? {
-                    ...args,
-                    _scope: {
-                        principal: toolCtx.principal,
-                        ...(toolCtx.initiatingPrincipal ? { initiatingPrincipal: toolCtx.initiatingPrincipal } : {}),
-                        scopes: toolCtx.credentials.scopes,
-                    },
-                }
-                : args;
-            const { job_id, result } = await yamlDeployer.invokeYamlWorkflowSync(wf.app_id, wf.graph_topic, scopedArgs, undefined, wf.graph_topic);
-            return { job_id, workflow: yamlWorkflowName, status: 'completed', result };
-        }
-        catch (err) {
-            return { error: err.message, tool: qualifiedName, args };
-        }
-    }
-    // Exchange ephemeral credential tokens (eph:v1:...) right before the MCP call
-    args = await (0, ephemeral_1.exchangeTokensInArgs)(args);
-    // Standard MCP tool routing
-    const serverName = cache_1.toolServerMap.get(qualifiedName);
-    const separatorIdx = qualifiedName.indexOf('__');
-    const toolName = separatorIdx >= 0
-        ? qualifiedName.slice(separatorIdx + 2)
-        : qualifiedName;
-    // Build auth context from ToolContext (set by interceptor via IAM service)
-    const toolCtx = (0, context_1.getToolContext)();
-    const authContext = toolCtx?.principal.id
-        ? { userId: toolCtx.principal.id, delegationToken: toolCtx.credentials.delegationToken }
-        : undefined;
-    if (serverName) {
-        try {
-            return await mcpClient.callServerTool(serverName, toolName, args, authContext);
-        }
-        catch (err) {
-            return { error: err.message, tool: qualifiedName, args };
-        }
-    }
-    // Fallback: try the tool name directly against all connected servers
-    const { servers } = await mcpDbService.listMcpServers({ limit: 100 });
-    for (const server of servers) {
-        const manifest = server.tool_manifest || [];
-        if (manifest.some((t) => t.name === toolName)) {
-            try {
-                return await mcpClient.callServerTool(server.name, toolName, args, authContext);
-            }
-            catch (err) {
-                return { error: err.message, tool: qualifiedName, args };
-            }
-        }
-    }
-    return { error: `Unknown tool: ${qualifiedName} (no server found)`, tool: qualifiedName };
+    return (0, tool_executor_1.callTool)(qualifiedName, args, { toolServerMap: cache_1.toolServerMap, yamlWorkflowMap: cache_1.yamlWorkflowMap });
 }

package/build/system/index.js

@@ -77,6 +77,12 @@ function getSystemWorkers() {
             workers.push({ taskQueue: 'long-tail-system', workflow: mcpDeterministic });
         }
         catch { /* not available */ }
+        // ── Workflow builder (direct YAML construction) ──
+        try {
+            const { mcpWorkflowBuilder } = require('./workflows/mcp-workflow-builder');
+            workers.push({ taskQueue: 'long-tail-system', workflow: mcpWorkflowBuilder });
+        }
+        catch { /* not available */ }
     }
     return workers;
 }
@@ -87,14 +93,15 @@ function getSystemWorkers() {
  */
 exports.builtinMcpServerFactories = {
     'long-tail-human-queue': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/human-queue'))).then((m) => m.createHumanQueueServer()),
-    'long-tail-db': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/db-query'))).then((m) => m.createDbServer()),
-    'long-tail-document-vision': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/document-vision'))).then((m) => m.createVisionServer()),
-    'mcp-workflows-longtail': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/workflow'))).then((m) => m.createWorkflowServer()),
-    'long-tail-workflow-compiler': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/workflow-compiler'))).then((m) => m.createWorkflowCompilerServer()),
+    'long-tail-translation': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/translation'))).then((m) => m.createTranslationServer()),
+    'long-tail-vision': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/vision'))).then((m) => m.createVisionServer()),
     'long-tail-playwright': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/playwright'))).then((m) => m.createPlaywrightServer()),
     'long-tail-playwright-cli': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/playwright-cli'))).then((m) => m.createPlaywrightCliServer()),
     'long-tail-file-storage': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/file-storage'))).then((m) => m.createFileStorageServer()),
     'long-tail-http-fetch': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/http-fetch'))).then((m) => m.createHttpFetchServer()),
     'long-tail-oauth': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/oauth'))).then((m) => m.createOAuthServer()),
+    'long-tail-docs': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/docs'))).then((m) => m.createDocsServer()),
     'long-tail-claude-code': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/claude-code'))).then((m) => m.createClaudeCodeServer()),
+    'long-tail-admin': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/admin'))).then((m) => m.createAdminServer()),
+    'long-tail-knowledge': () => Promise.resolve().then(() => __importStar(require('./mcp-servers/knowledge'))).then((m) => m.createKnowledgeServer()),
 };

package/build/system/mcp-servers/admin/escalations.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Escalation tools — mirrors routes/escalations/
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerEscalationTools(server: McpServer): void;

package/build/system/mcp-servers/admin/escalations.js

@@ -0,0 +1,149 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerEscalationTools = registerEscalationTools;
+const escalationService = __importStar(require("../../../services/escalation"));
+const schemas_1 = require("./schemas");
+function registerEscalationTools(server) {
+    // mirrors GET /api/escalations
+    server.registerTool('find_escalations', {
+        title: 'Find Escalations',
+        description: 'Search escalations with optional filters. Returns records with ' +
+            'type, role, priority, status, description, and assignment info.',
+        inputSchema: schemas_1.findEscalationsSchema,
+    }, async (args) => {
+        const { escalations, total } = await escalationService.listEscalations({
+            status: args.status,
+            role: args.role,
+            type: args.type,
+            priority: args.priority,
+            limit: args.limit,
+            offset: args.offset,
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        total,
+                        count: escalations.length,
+                        escalations: escalations.map((e) => ({
+                            id: e.id,
+                            type: e.type,
+                            subtype: e.subtype,
+                            role: e.role,
+                            priority: e.priority,
+                            status: e.status,
+                            description: e.description,
+                            workflow_type: e.workflow_type,
+                            assigned_to: e.assigned_to,
+                            created_at: e.created_at,
+                        })),
+                    }),
+                }],
+        };
+    });
+    // mirrors GET /api/escalations/stats
+    server.registerTool('get_escalation_stats', {
+        title: 'Get Escalation Stats',
+        description: 'Aggregated escalation statistics: pending, claimed, created, ' +
+            'resolved counts with breakdown by role and type.',
+        inputSchema: schemas_1.getEscalationStatsSchema,
+    }, async (args) => {
+        const stats = await escalationService.getEscalationStats(undefined, args.period);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(stats),
+                }],
+        };
+    });
+    // mirrors POST /api/escalations/:id/claim
+    server.registerTool('claim_escalation', {
+        title: 'Claim Escalation',
+        description: 'Claim an escalation for a time-boxed lock. The escalation is ' +
+            'reserved so no one else picks it up. If the claim expires, ' +
+            'the escalation returns to the queue.',
+        inputSchema: schemas_1.claimEscalationSchema,
+    }, async (args) => {
+        const escalation = await escalationService.getEscalation(args.id);
+        if (!escalation) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: 'Escalation not found' }) }],
+                isError: true,
+            };
+        }
+        const result = await escalationService.claimEscalation(args.id, 'lt-system', args.duration_minutes);
+        if (!result) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: 'Escalation not available for claim' }) }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result) }],
+        };
+    });
+    // mirrors POST /api/escalations/release-expired
+    server.registerTool('release_expired_claims', {
+        title: 'Release Expired Claims',
+        description: 'Release all escalation claims that exceeded their lock duration. ' +
+            'Expired escalations return to the available queue.',
+        inputSchema: schemas_1.releaseExpiredClaimsSchema,
+    }, async (_args) => {
+        const released = await escalationService.releaseExpiredClaims();
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ released }) }],
+        };
+    });
+    // mirrors POST /api/escalations/bulk-triage
+    server.registerTool('bulk_triage', {
+        title: 'Bulk Triage',
+        description: 'Resolve escalations for triage and start mcpTriage workflows. ' +
+            'Each escalation is marked resolved with needsTriage=true, then ' +
+            'a triage workflow is started to remediate the issue.',
+        inputSchema: schemas_1.bulkTriageSchema,
+    }, async (args) => {
+        const resolved = await escalationService.bulkResolveForTriage(args.ids, args.hint);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        triaged: resolved.length,
+                        escalation_ids: resolved.map((e) => e.id),
+                    }),
+                }],
+        };
+    });
+}

package/build/system/mcp-servers/admin/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Long Tail Admin MCP Server
+ *
+ * Unified system management — every tool maps directly to a REST API
+ * route handler. The tools are organized by route file:
+ *
+ *   tasks.ts           — routes/tasks.ts
+ *   escalations.ts     — routes/escalations/
+ *   workflow-config.ts  — routes/workflows/config.ts
+ *   workflows.ts       — routes/workflows/discovery.ts + invocation.ts
+ *   mcp-servers.ts     — routes/mcp.ts
+ *   yaml-workflows.ts  — routes/yaml-workflows/
+ *   users.ts           — routes/users.ts + routes/roles.ts
+ *   maintenance.ts     — routes/dba.ts
+ *
+ * This server replaces three previously separate servers:
+ *   - long-tail-db-query (read-only task/escalation/health queries)
+ *   - long-tail-workflow-compiler (compile + deploy)
+ *   - mcp-workflows-longtail (list + get + invoke compiled workflows)
+ *
+ * The long-tail-human-queue server remains separate because
+ * escalate_and_wait has special durable signal semantics that
+ * are deeply wired into the YAML worker infrastructure.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createAdminServer(options?: {
+    name?: string;
+    fresh?: boolean;
+}): Promise<McpServer>;
+export declare function getAdminServer(): McpServer | null;
+export declare function stopAdminServer(): Promise<void>;

package/build/system/mcp-servers/admin/index.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdminServer = createAdminServer;
+exports.getAdminServer = getAdminServer;
+exports.stopAdminServer = stopAdminServer;
+/**
+ * Long Tail Admin MCP Server
+ *
+ * Unified system management — every tool maps directly to a REST API
+ * route handler. The tools are organized by route file:
+ *
+ *   tasks.ts           — routes/tasks.ts
+ *   escalations.ts     — routes/escalations/
+ *   workflow-config.ts  — routes/workflows/config.ts
+ *   workflows.ts       — routes/workflows/discovery.ts + invocation.ts
+ *   mcp-servers.ts     — routes/mcp.ts
+ *   yaml-workflows.ts  — routes/yaml-workflows/
+ *   users.ts           — routes/users.ts + routes/roles.ts
+ *   maintenance.ts     — routes/dba.ts
+ *
+ * This server replaces three previously separate servers:
+ *   - long-tail-db-query (read-only task/escalation/health queries)
+ *   - long-tail-workflow-compiler (compile + deploy)
+ *   - mcp-workflows-longtail (list + get + invoke compiled workflows)
+ *
+ * The long-tail-human-queue server remains separate because
+ * escalate_and_wait has special durable signal semantics that
+ * are deeply wired into the YAML worker infrastructure.
+ */
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const logger_1 = require("../../../lib/logger");
+const tasks_1 = require("./tasks");
+const escalations_1 = require("./escalations");
+const workflow_config_1 = require("./workflow-config");
+const workflows_1 = require("./workflows");
+const mcp_servers_1 = require("./mcp-servers");
+const yaml_workflows_1 = require("./yaml-workflows");
+const users_1 = require("./users");
+const maintenance_1 = require("./maintenance");
+const TOOL_COUNT = 30;
+let server = null;
+async function createAdminServer(options) {
+    if (server && !options?.fresh)
+        return server;
+    const name = options?.name || 'long-tail-admin';
+    const instance = new mcp_js_1.McpServer({ name, version: '1.0.0' });
+    if (!options?.fresh) {
+        server = instance;
+    }
+    (0, tasks_1.registerTaskTools)(instance); //  2 tools
+    (0, escalations_1.registerEscalationTools)(instance); //  5 tools
+    (0, workflow_config_1.registerWorkflowConfigTools)(instance); // 3 tools
+    (0, workflows_1.registerWorkflowTools)(instance); //  3 tools
+    (0, mcp_servers_1.registerMcpServerTools)(instance); //  4 tools
+    (0, yaml_workflows_1.registerYamlWorkflowTools)(instance); //  5 tools
+    (0, users_1.registerUserTools)(instance); //  7 tools (users + roles)
+    (0, maintenance_1.registerMaintenanceTools)(instance); //  1 tool
+    // Subtotal: 30 — but let me recount...
+    // tasks: find_tasks, get_process_detail = 2
+    // escalations: find_escalations, get_escalation_stats, claim_escalation, release_expired_claims, bulk_triage = 5
+    // workflow-config: list_workflow_configs, upsert_workflow_config, delete_workflow_config = 3
+    // workflows: list_discovered_workflows, invoke_workflow, get_workflow_status = 3
+    // mcp-servers: list_mcp_servers, update_mcp_server, connect_mcp_server, disconnect_mcp_server = 4
+    // yaml-workflows: list_yaml_workflows, get_yaml_workflow, create_yaml_workflow, deploy_yaml_workflow, invoke_yaml_workflow = 5
+    // users: list_users, create_user, add_user_role, remove_user_role, list_roles, create_role, add_escalation_chain = 7
+    // maintenance: prune = 1
+    // Total: 30
+    logger_1.loggerRegistry.info(`[lt-mcp:admin] ${name} ready (${TOOL_COUNT} tools registered)`);
+    return instance;
+}
+function getAdminServer() {
+    return server;
+}
+async function stopAdminServer() {
+    if (server) {
+        await server.close();
+        server = null;
+        logger_1.loggerRegistry.info('[lt-mcp:admin] stopped');
+    }
+}

package/build/system/mcp-servers/admin/maintenance.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Database maintenance tools — mirrors routes/dba.ts
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerMaintenanceTools(server: McpServer): void;

package/build/system/mcp-servers/admin/maintenance.js

@@ -0,0 +1,58 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerMaintenanceTools = registerMaintenanceTools;
+const dbaService = __importStar(require("../../../services/dba"));
+const schemas_1 = require("./schemas");
+function registerMaintenanceTools(server) {
+    // mirrors POST /api/dba/prune
+    server.registerTool('prune', {
+        title: 'Prune Database',
+        description: 'Prune expired jobs, streams, and execution artifacts. Returns ' +
+            'the count of records affected by each operation.',
+        inputSchema: schemas_1.pruneSchema,
+    }, async (args) => {
+        const result = await dbaService.prune({
+            expire: args.expire,
+            jobs: args.jobs,
+            streams: args.streams,
+            entities: args.entities,
+            pruneTransient: args.prune_transient,
+        });
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result) }],
+        };
+    });
+}

package/build/system/mcp-servers/admin/mcp-servers.d.ts

@@ -0,0 +1,5 @@
+/**
+ * MCP server management tools — mirrors routes/mcp.ts
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerMcpServerTools(server: McpServer): void;