@anastops/mcp-server 1.1.1 → 2.0.0

package/dist/handlers/v3/agent-tools.js

@@ -0,0 +1,460 @@
+/**
+ * MCP v3.0 - Consolidated Agent Management Tools
+ * Implements aggressive consolidation plan: 5 tools → 2 tools
+ *
+ * Tools:
+ * 1. agent_manage - Handle create, deploy, retire operations (write operations)
+ * 2. agent_query - Handle status, list operations (read operations)
+ *
+ * @see docs/MCP-V3-AGGRESSIVE-CONSOLIDATION.md
+ */
+import { nanoid } from 'nanoid';
+import { getPersistence } from '../../persistence.js';
+import { safePersist, agents, getAgent } from '../handlers.base.js';
+// ============================================================================
+// Tool 1: agent_manage (Write Operations)
+// ============================================================================
+/**
+ * MCP Tool Schema for agent_manage
+ *
+ * Handles all write operations on agents:
+ * - create: Create a new AI agent for a session
+ * - deploy: Deploy an agent to work on a specific task
+ * - retire: Mark an agent as completed
+ *
+ * @example Create agent
+ * ```typescript
+ * agent_manage({
+ *   operation: 'create',
+ *   session_id: 'abc123',
+ *   role: 'implementer',
+ *   name: 'feature-agent',
+ *   provider: 'claude',
+ *   model: 'claude-sonnet'
+ * })
+ * // Returns: { agent_id: 'xyz', name: 'feature-agent', role: 'implementer', status: 'idle' }
+ * ```
+ *
+ * @example Deploy agent to task
+ * ```typescript
+ * agent_manage({
+ *   operation: 'deploy',
+ *   agent_id: 'xyz789',
+ *   task_id: 'task123'
+ * })
+ * // Returns: { agent_id: 'xyz789', task_id: 'task123', status: 'working' }
+ * ```
+ *
+ * @example Retire agent
+ * ```typescript
+ * agent_manage({
+ *   operation: 'retire',
+ *   agent_id: 'xyz789'
+ * })
+ * // Returns: { agent_id: 'xyz789', status: 'completed', retired: true }
+ * ```
+ */
+export const agentManageToolDefinition = {
+    name: 'agent_manage',
+    description: 'Manage agents: create new agents, deploy agents to tasks, or retire agents. Use create to spawn new agents, deploy to assign work, retire to mark completion.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['create', 'deploy', 'retire'],
+                description: 'Operation to perform: create, deploy, or retire',
+            },
+            // create operation parameters
+            session_id: {
+                type: 'string',
+                description: 'Required for create: session ID to create agent in',
+            },
+            role: {
+                type: 'string',
+                enum: [
+                    'orchestrator',
+                    'planner',
+                    'implementer',
+                    'reviewer',
+                    'tester',
+                    'debugger',
+                    'documenter',
+                    'specialist',
+                ],
+                description: 'Required for create: agent role',
+            },
+            name: {
+                type: 'string',
+                description: 'For create: agent name (defaults to auto-generated)',
+            },
+            provider: {
+                type: 'string',
+                description: 'For create: AI provider (default: claude)',
+            },
+            model: {
+                type: 'string',
+                description: 'For create: model to use (default: claude-sonnet)',
+            },
+            // deploy operation parameters
+            agent_id: {
+                type: 'string',
+                description: 'Required for deploy/retire: agent ID',
+            },
+            task_id: {
+                type: 'string',
+                description: 'Required for deploy: task ID to assign agent to',
+            },
+        },
+        required: ['operation'],
+    },
+};
+/**
+ * Validate required fields for agent_manage operations
+ */
+function validateAgentManageArgs(operation, args) {
+    switch (operation) {
+        case 'create':
+            if (args.session_id === undefined || args.session_id === null || args.session_id === '') {
+                throw new Error('create operation requires session_id');
+            }
+            if (args.role === undefined || args.role === null) {
+                throw new Error('create operation requires role');
+            }
+            break;
+        case 'deploy':
+            if (args.agent_id === undefined || args.agent_id === null || args.agent_id === '') {
+                throw new Error('deploy operation requires agent_id');
+            }
+            if (args.task_id === undefined || args.task_id === null || args.task_id === '') {
+                throw new Error('deploy operation requires task_id');
+            }
+            break;
+        case 'retire':
+            if (args.agent_id === undefined || args.agent_id === null || args.agent_id === '') {
+                throw new Error('retire operation requires agent_id');
+            }
+            break;
+        default:
+            throw new Error(`Unknown operation: ${operation}`);
+    }
+}
+/**
+ * Handler for agent_manage tool
+ */
+export async function handleAgentManage(args) {
+    const operation = args.operation;
+    if (!operation) {
+        throw new Error('operation parameter is required');
+    }
+    const typedArgs = args;
+    // Validate operation-specific required fields
+    validateAgentManageArgs(operation, typedArgs);
+    switch (operation) {
+        case 'create':
+            return handleAgentCreate(typedArgs);
+        case 'deploy':
+            return handleAgentDeploy(typedArgs);
+        case 'retire':
+            return handleAgentRetire(typedArgs);
+        default: {
+            const unknownOp = operation;
+            throw new Error(`Unknown operation: ${unknownOp}`);
+        }
+    }
+}
+/**
+ * Create a new AI agent
+ */
+function handleAgentCreate(args) {
+    const agentId = nanoid(21);
+    const now = new Date();
+    const agent = {
+        id: agentId,
+        session_id: args.session_id,
+        role: args.role ?? 'implementer',
+        name: args.name ?? `agent-${agentId.slice(0, 4)}`,
+        status: 'idle',
+        provider: args.provider ?? 'claude',
+        model: args.model ?? 'claude-sonnet',
+        current_task_id: null,
+        tasks_completed: 0,
+        tasks_failed: 0,
+        tokens_used: 0,
+        created_at: now,
+        last_activity_at: now,
+        config: {},
+    };
+    agents.set(agentId, agent);
+    // Persist to MongoDB
+    safePersist(getPersistence().saveAgent(agent));
+    return {
+        agent_id: agent.id,
+        name: agent.name,
+        role: agent.role,
+        status: agent.status,
+    };
+}
+/**
+ * Deploy an agent to a task
+ */
+async function handleAgentDeploy(args) {
+    const agent = await getAgent(args.agent_id);
+    if (agent === null) {
+        throw new Error(`Agent not found: ${args.agent_id}`);
+    }
+    agent.current_task_id = args.task_id;
+    agent.status = 'working';
+    agent.last_activity_at = new Date();
+    agents.set(agent.id, agent);
+    // Persist to MongoDB
+    safePersist(getPersistence().saveAgent(agent));
+    return {
+        agent_id: agent.id,
+        task_id: agent.current_task_id,
+        status: agent.status,
+    };
+}
+/**
+ * Retire an agent (mark as completed)
+ */
+async function handleAgentRetire(args) {
+    const agent = await getAgent(args.agent_id);
+    if (agent === null) {
+        throw new Error(`Agent not found: ${args.agent_id}`);
+    }
+    // Retire the agent
+    agent.status = 'completed';
+    agent.last_activity_at = new Date();
+    agent.current_task_id = null;
+    agents.set(agent.id, agent);
+    // Persist to MongoDB
+    safePersist(getPersistence().saveAgent(agent));
+    return {
+        agent_id: agent.id,
+        name: agent.name,
+        role: agent.role,
+        status: agent.status,
+        tasks_completed: agent.tasks_completed,
+        retired: true,
+    };
+}
+// ============================================================================
+// Tool 2: agent_query (Read Operations)
+// ============================================================================
+/**
+ * MCP Tool Schema for agent_query
+ *
+ * Handles all read operations on agents:
+ * - status: Get detailed status of a single agent
+ * - list: List all agents in a session
+ *
+ * @example Get agent status
+ * ```typescript
+ * agent_query({
+ *   operation: 'status',
+ *   agent_id: 'xyz789'
+ * })
+ * // Returns: { id, name, role, status, provider, model, tasks_completed, ... }
+ * ```
+ *
+ * @example List agents in session
+ * ```typescript
+ * agent_query({
+ *   operation: 'list',
+ *   session_id: 'abc123',
+ *   format: 'json'
+ * })
+ * // Returns: { count: 3, agents: [{ id, name, role, status }, ...] }
+ * ```
+ *
+ * @example List agents as ASCII table
+ * ```typescript
+ * agent_query({
+ *   operation: 'list',
+ *   session_id: 'abc123',
+ *   format: 'table'
+ * })
+ * // Returns: ASCII table formatted output
+ * ```
+ */
+export const agentQueryToolDefinition = {
+    name: 'agent_query',
+    description: 'Query agent information: get status of a specific agent or list all agents in a session. Use status for detailed info, list for overview.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['status', 'list'],
+                description: 'Type of query (default: status if agent_id provided, else list if session_id provided)',
+            },
+            // status operation parameters
+            agent_id: {
+                type: 'string',
+                description: 'For status: specific agent ID to query',
+            },
+            // list operation parameters
+            session_id: {
+                type: 'string',
+                description: 'For list: session ID to list agents from',
+            },
+            status: {
+                type: 'string',
+                description: 'For list: filter by agent status',
+            },
+            format: {
+                type: 'string',
+                enum: ['table', 'json'],
+                description: 'For list: output format (default: json)',
+            },
+        },
+    },
+};
+/**
+ * Validate required fields for agent_query operations
+ */
+function validateAgentQueryArgs(operation, args) {
+    switch (operation) {
+        case 'status':
+            if (args.agent_id === undefined || args.agent_id === null || args.agent_id === '') {
+                throw new Error('status operation requires agent_id');
+            }
+            break;
+        case 'list':
+            if (args.session_id === undefined || args.session_id === null || args.session_id === '') {
+                throw new Error('list operation requires session_id');
+            }
+            break;
+        default:
+            throw new Error(`Unknown operation: ${operation}`);
+    }
+}
+/**
+ * Auto-detect operation if not explicitly provided
+ */
+function detectAgentQueryOperation(args) {
+    if (args.operation !== undefined) {
+        return args.operation;
+    }
+    // Auto-detect based on parameters
+    if (args.agent_id !== undefined && args.agent_id !== null && args.agent_id !== '') {
+        return 'status';
+    }
+    if (args.session_id !== undefined && args.session_id !== null && args.session_id !== '') {
+        return 'list';
+    }
+    throw new Error('Cannot auto-detect operation: provide either agent_id or session_id');
+}
+/**
+ * Handler for agent_query tool
+ */
+export async function handleAgentQuery(args) {
+    const typedArgs = args;
+    // Auto-detect operation if not provided
+    const operation = detectAgentQueryOperation(typedArgs);
+    // Validate operation-specific required fields
+    validateAgentQueryArgs(operation, typedArgs);
+    switch (operation) {
+        case 'status':
+            return handleAgentStatus(typedArgs);
+        case 'list':
+            return handleAgentList(typedArgs);
+        default: {
+            const unknownOp = operation;
+            throw new Error(`Unknown operation: ${unknownOp}`);
+        }
+    }
+}
+/**
+ * Get detailed status of a single agent
+ */
+async function handleAgentStatus(args) {
+    const agent = await getAgent(args.agent_id);
+    if (agent === null) {
+        throw new Error(`Agent not found: ${args.agent_id}`);
+    }
+    return agent;
+}
+/**
+ * List all agents in a session
+ */
+async function handleAgentList(args) {
+    // Get from in-memory cache first
+    const inMemoryAgents = [];
+    for (const [, agent] of Array.from(agents.entries())) {
+        if (args.session_id === undefined || agent.session_id === args.session_id) {
+            inMemoryAgents.push(agent);
+        }
+    }
+    // Also get from MongoDB for persistence
+    const persistedAgents = await getPersistence().listAgents({
+        ...(args.session_id !== undefined && { session_id: args.session_id }),
+    });
+    // Merge: in-memory takes precedence
+    const inMemoryIds = new Set(inMemoryAgents.map((a) => a.id));
+    const sessionAgents = [
+        ...inMemoryAgents,
+        ...persistedAgents.filter((a) => !inMemoryIds.has(a.id)),
+    ];
+    // Apply status filter if provided
+    const filteredAgents = args.status !== undefined && args.status !== null && args.status !== ''
+        ? sessionAgents.filter((a) => a.status === args.status)
+        : sessionAgents;
+    // Format output
+    const agentSummaries = filteredAgents.map((a) => ({
+        id: a.id,
+        name: a.name,
+        role: a.role,
+        status: a.status,
+    }));
+    // Return based on format
+    if (args.format === 'table') {
+        return formatAgentsAsTable(agentSummaries);
+    }
+    return {
+        count: agentSummaries.length,
+        agents: agentSummaries,
+    };
+}
+/**
+ * Format agents as ASCII table
+ */
+function formatAgentsAsTable(agents) {
+    if (agents.length === 0) {
+        return 'No agents found';
+    }
+    const rows = [
+        ['ID', 'Name', 'Role', 'Status'],
+        ...agents.map((a) => [a.id, a.name, a.role, a.status]),
+    ];
+    const headerRow = rows[0];
+    if (headerRow === undefined) {
+        return 'No agents found';
+    }
+    // Calculate column widths
+    const widths = headerRow.map((_, colIdx) => Math.max(...rows.map((row) => String(row[colIdx] ?? '').length)));
+    // Build table
+    const lines = [];
+    // Header
+    lines.push(headerRow.map((cell, i) => String(cell).padEnd(widths[i] ?? 0)).join(' | '));
+    // Separator
+    lines.push(widths.map((w) => '-'.repeat(w)).join('-+-'));
+    // Data rows
+    for (let i = 1; i < rows.length; i++) {
+        const row = rows[i];
+        if (row !== undefined) {
+            lines.push(row.map((cell, j) => String(cell).padEnd(widths[j] ?? 0)).join(' | '));
+        }
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export const v3AgentToolDefinitions = [agentManageToolDefinition, agentQueryToolDefinition];
+export const v3AgentHandlers = {
+    agent_manage: handleAgentManage,
+    agent_query: handleAgentQuery,
+};
+//# sourceMappingURL=agent-tools.js.map

package/dist/handlers/v3/agent-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.js","sourceRoot":"","sources":["../../../src/handlers/v3/agent-tools.ts"],"names":[],"mappings":"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"}

package/dist/handlers/v3/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Anastops MCP v3.0 - Consolidated Tools Export
+ *
+ * This module exports all v3.0 consolidated tools for integration with the main MCP server.
+ *
+ * Utility and Data Tools: 6 tools (from 17 original tools)
+ * - data_manage (consolidates: memory_store, artifact_save, context_optimize)
+ * - data_query (consolidates: memory_retrieve, artifact_get, artifact_list)
+ * - system_query (consolidates: health_check, provider_list, metrics_get)
+ * - lock_manage (consolidates: lock_acquire, lock_release, lock_status)
+ * - session_monitoring (consolidates: session_cost, session_metrics, session_throttle)
+ * - config_manage (consolidates: config_get, config_set)
+ */
+export { dataManageTool, dataQueryTool, systemQueryTool, lockManageTool, sessionMonitoringTool, configManageTool, toolDefinitions as utilityToolDefinitions, handleDataManage, handleDataQuery, handleSystemQuery, handleLockManage, handleSessionMonitoring, handleConfigManage, handleTool as handleUtilityTool, } from './utility-tools.js';
+export type { HandlerContext, ToolDefinition } from '../types.js';
+import type { HandlerContext } from '../types.js';
+export declare const v3UtilityTools: import("../types.js").ToolDefinition[];
+type UtilityHandler = (args: Record<string, unknown>, context: HandlerContext) => Promise<unknown>;
+export declare const v3UtilityHandlers: Record<string, UtilityHandler>;
+/**
+ * Helper to dispatch v3 utility tool calls
+ *
+ * @example
+ * const result = await dispatchV3UtilityTool('data_manage', {
+ *   operation: 'store',
+ *   key: 'config',
+ *   value: { setting: 'value' }
+ * }, context);
+ */
+export declare function dispatchV3UtilityTool(toolName: string, args: Record<string, unknown>, context: HandlerContext): Promise<unknown>;
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/v3/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/handlers/v3/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAEL,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,IAAI,sBAAsB,EAEzC,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,UAAU,IAAI,iBAAiB,GAChC,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAelD,eAAO,MAAM,cAAc,wCAAkB,CAAC;AAE9C,KAAK,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEnG,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAa5D,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC,CAMlB"}

package/dist/handlers/v3/index.js

@@ -0,0 +1,56 @@
+/**
+ * Anastops MCP v3.0 - Consolidated Tools Export
+ *
+ * This module exports all v3.0 consolidated tools for integration with the main MCP server.
+ *
+ * Utility and Data Tools: 6 tools (from 17 original tools)
+ * - data_manage (consolidates: memory_store, artifact_save, context_optimize)
+ * - data_query (consolidates: memory_retrieve, artifact_get, artifact_list)
+ * - system_query (consolidates: health_check, provider_list, metrics_get)
+ * - lock_manage (consolidates: lock_acquire, lock_release, lock_status)
+ * - session_monitoring (consolidates: session_cost, session_metrics, session_throttle)
+ * - config_manage (consolidates: config_get, config_set)
+ */
+// Utility and Data Management Tools
+export { 
+// Tool definitions
+dataManageTool, dataQueryTool, systemQueryTool, lockManageTool, sessionMonitoringTool, configManageTool, toolDefinitions as utilityToolDefinitions, 
+// Handlers
+handleDataManage, handleDataQuery, handleSystemQuery, handleLockManage, handleSessionMonitoring, handleConfigManage, handleTool as handleUtilityTool, } from './utility-tools.js';
+/**
+ * All v3.0 utility and data tool schemas
+ */
+import { handleDataManage, handleDataQuery, handleLockManage, handleSessionMonitoring, handleSystemQuery, handleConfigManage, toolDefinitions, } from './utility-tools.js';
+export const v3UtilityTools = toolDefinitions;
+export const v3UtilityHandlers = {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    data_manage: handleDataManage,
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    data_query: handleDataQuery,
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    system_query: handleSystemQuery,
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    lock_manage: handleLockManage,
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    session_monitoring: handleSessionMonitoring,
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    config_manage: handleConfigManage,
+};
+/**
+ * Helper to dispatch v3 utility tool calls
+ *
+ * @example
+ * const result = await dispatchV3UtilityTool('data_manage', {
+ *   operation: 'store',
+ *   key: 'config',
+ *   value: { setting: 'value' }
+ * }, context);
+ */
+export async function dispatchV3UtilityTool(toolName, args, context) {
+    const handler = v3UtilityHandlers[toolName];
+    if (handler === undefined) {
+        throw new Error(`Unknown v3 utility tool: ${toolName}`);
+    }
+    return handler(args, context);
+}
+//# sourceMappingURL=index.js.map

package/dist/handlers/v3/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/handlers/v3/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,oCAAoC;AACpC,OAAO;AACL,mBAAmB;AACnB,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,IAAI,sBAAsB;AACzC,WAAW;AACX,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,UAAU,IAAI,iBAAiB,GAChC,MAAM,oBAAoB,CAAC;AAO5B;;GAEG;AACH,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC;AAI9C,MAAM,CAAC,MAAM,iBAAiB,GAAmC;IAC/D,mEAAmE;IACnE,WAAW,EAAE,gBAAkC;IAC/C,mEAAmE;IACnE,UAAU,EAAE,eAAiC;IAC7C,mEAAmE;IACnE,YAAY,EAAE,iBAAmC;IACjD,mEAAmE;IACnE,WAAW,EAAE,gBAAkC;IAC/C,mEAAmE;IACnE,kBAAkB,EAAE,uBAAyC;IAC7D,mEAAmE;IACnE,aAAa,EAAE,kBAAoC;CACpD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAgB,EAChB,IAA6B,EAC7B,OAAuB;IAEvB,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAChC,CAAC"}