devchain-cli 0.6.1 → 0.7.0

package/dist/server/modules/mcp/controllers/mcp-http.controller.js

@@ -17,6 +17,7 @@ const common_1 = require("@nestjs/common");
 const mcp_service_1 = require("../services/mcp.service");
 const crypto_1 = require("crypto");
 const constants_1 = require("../constants");
+const tool_definitions_1 = require("../tool-definitions");
 const JSONRPC_ERRORS = {
     PARSE_ERROR: -32700,
     INVALID_REQUEST: -32600,
@@ -43,6 +44,18 @@ function isJsonRpcRequest(msg) {
 function isNotification(msg) {
     return !('id' in msg);
 }
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function getSpreadableErrorData(data) {
+    if (data === undefined || data === null) {
+        return {};
+    }
+    if (isPlainObject(data)) {
+        return data;
+    }
+    return { data };
+}
 let McpHttpController = class McpHttpController {
     constructor(mcp) {
         this.mcp = mcp;
@@ -114,6 +127,7 @@ let McpHttpController = class McpHttpController {
                     return makeResult(id, resp.data ?? null);
                 return makeError(id, JSONRPC_ERRORS.INTERNAL_ERROR, resp.error?.message || 'Error', {
                     code: resp.error?.code,
+                    ...getSpreadableErrorData(resp.error?.data),
                 });
             }
             if (req.method === 'tools/call' || req.method === 'tools.call') {
@@ -131,6 +145,7 @@ let McpHttpController = class McpHttpController {
                     });
                 return makeError(id, JSONRPC_ERRORS.INTERNAL_ERROR, resp.error?.message || 'Error', {
                     code: resp.error?.code,
+                    ...getSpreadableErrorData(resp.error?.data),
                 });
             }
             const resp = await this.mcp.handleToolCall(req.method, req.params ?? {});
@@ -138,6 +153,7 @@ let McpHttpController = class McpHttpController {
                 return makeResult(id, resp.data ?? null);
             return makeError(id, JSONRPC_ERRORS.INTERNAL_ERROR, resp.error?.message || 'Error', {
                 code: resp.error?.code,
+                ...getSpreadableErrorData(resp.error?.data),
             });
         }
         catch (err) {
@@ -146,568 +162,7 @@ let McpHttpController = class McpHttpController {
         }
     }
     listTools() {
-        const tools = [
-            {
-                name: 'devchain_list_sessions',
-                description: 'List active sessions for discovery. This is the bootstrap tool that requires no sessionId - use it to discover valid session IDs for other MCP calls.',
-                inputSchema: {
-                    type: 'object',
-                    properties: {},
-                },
-            },
-            {
-                name: 'devchain_register_guest',
-                description: 'Register as a guest agent to join the DevChain system. Use this when you are an external AI agent running in a tmux session and want to appear in the Chat page alongside other agents. Returns a guestId that must be used as sessionId for all subsequent MCP tool calls. Your project is auto-detected from your tmux working directory.',
-                inputSchema: {
-                    type: 'object',
-                    required: ['name', 'tmuxSessionId'],
-                    properties: {
-                        name: {
-                            type: 'string',
-                            description: 'Display name for the guest agent (must be unique within the project)',
-                        },
-                        tmuxSessionId: {
-                            type: 'string',
-                            description: 'The tmux session ID where the guest is running',
-                        },
-                        description: {
-                            type: 'string',
-                            description: 'Optional description of the guest agent',
-                        },
-                    },
-                },
-            },
-            {
-                name: 'devchain_list_documents',
-                description: 'List all documents for the project resolved from the session.',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                        tags: {
-                            type: 'array',
-                            items: { type: 'string' },
-                            description: 'Filter by tags (all must match)',
-                        },
-                        q: { type: 'string', description: 'Search query for title/content' },
-                        limit: { type: 'number', description: 'Max results (default: 100)' },
-                        offset: { type: 'number', description: 'Pagination offset (default: 0)' },
-                    },
-                },
-            },
-            {
-                name: 'devchain_activity_start',
-                description: 'Start an activity for an agent; posts a system start message and begins a running timer (DM by default).',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId', 'title'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                        title: { type: 'string', description: 'Activity title (<=256 chars)' },
-                        threadId: { type: 'string', description: 'Target thread UUID (optional)' },
-                        announce: { type: 'boolean', description: 'Whether to post the start system message' },
-                    },
-                },
-            },
-            {
-                name: 'devchain_activity_finish',
-                description: 'Finish the latest running activity for an agent; optionally posts a finish system message.',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                        threadId: { type: 'string', description: 'Target thread UUID (optional)' },
-                        message: { type: 'string', description: 'Optional finish message (<=1000 chars)' },
-                        status: {
-                            type: 'string',
-                            enum: ['success', 'failed', 'canceled'],
-                            description: 'Final status (default success)',
-                        },
-                    },
-                },
-            },
-            {
-                name: 'devchain_get_document',
-                description: 'Get a single document by ID or slug, with optional link resolution',
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        id: { type: 'string', description: 'Document UUID' },
-                        slug: { type: 'string', description: 'Document slug (requires projectId)' },
-                        projectId: { type: 'string', description: 'Project ID when using slug' },
-                        includeLinks: {
-                            type: 'string',
-                            enum: ['none', 'meta', 'inline'],
-                            description: 'Link resolution: none (no links), meta (link metadata), inline (full content)',
-                        },
-                        maxDepth: {
-                            type: 'number',
-                            description: 'Max depth for inline resolution (default: 1)',
-                        },
-                        maxBytes: {
-                            type: 'number',
-                            description: 'Max bytes for inline content (default: 64KB)',
-                        },
-                    },
-                },
-            },
-            {
-                name: 'devchain_create_document',
-                description: 'Create a new markdown document in the project resolved from the session',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId', 'title', 'contentMd'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                        title: { type: 'string', description: 'Document title' },
-                        contentMd: { type: 'string', description: 'Markdown content' },
-                        tags: { type: 'array', items: { type: 'string' }, description: 'Document tags' },
-                    },
-                },
-            },
-            {
-                name: 'devchain_update_document',
-                description: 'Update an existing document',
-                inputSchema: {
-                    type: 'object',
-                    required: ['id'],
-                    properties: {
-                        id: { type: 'string', description: 'Document UUID' },
-                        title: { type: 'string', description: 'New title' },
-                        slug: { type: 'string', description: 'New slug' },
-                        contentMd: { type: 'string', description: 'New markdown content' },
-                        tags: { type: 'array', items: { type: 'string' }, description: 'New tags' },
-                        archived: { type: 'boolean', description: 'Archive status' },
-                        version: { type: 'number', description: 'Version for optimistic locking' },
-                    },
-                },
-            },
-            {
-                name: 'devchain_list_prompts',
-                description: 'List prompts for the project resolved from the session',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                        tags: { type: 'array', items: { type: 'string' }, description: 'Filter by tags' },
-                        q: { type: 'string', description: 'Search query' },
-                    },
-                },
-            },
-            {
-                name: 'devchain_get_prompt',
-                description: 'Get a specific prompt by ID or by (name + sessionId)',
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        id: { type: 'string', description: 'Prompt UUID' },
-                        name: { type: 'string', description: 'Prompt name/title' },
-                        version: { type: 'number', description: 'Specific version number' },
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix) required when querying by name',
-                        },
-                    },
-                },
-            },
-            {
-                name: 'devchain_list_agents',
-                description: 'List agents for the project resolved from the session',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                        limit: { type: 'number', description: 'Max results (default: 100)' },
-                        offset: { type: 'number', description: 'Pagination offset (default: 0)' },
-                        q: {
-                            type: 'string',
-                            description: 'Optional case-insensitive substring filter on agent name',
-                        },
-                    },
-                },
-            },
-            {
-                name: 'devchain_get_agent_by_name',
-                description: 'Fetch a single agent by name for the project resolved from the session',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId', 'name'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                        name: {
-                            type: 'string',
-                            description: 'Agent name to look up (case-insensitive match)',
-                        },
-                    },
-                },
-            },
-            {
-                name: 'devchain_list_statuses',
-                description: 'List project statuses resolved from the session',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                    },
-                },
-            },
-            {
-                name: 'devchain_list_epics',
-                description: 'List epics for the project resolved from the session with optional filters',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                        statusName: {
-                            type: 'string',
-                            description: 'Optional status name filter (case-insensitive)',
-                        },
-                        limit: { type: 'number', description: 'Max results (default: 100)' },
-                        offset: { type: 'number', description: 'Pagination offset (default: 0)' },
-                        q: {
-                            type: 'string',
-                            description: 'Optional search query applied to epic titles and descriptions',
-                        },
-                    },
-                },
-            },
-            {
-                name: 'devchain_list_assigned_epics_tasks',
-                description: 'List epics assigned to the specified agent within the project resolved from the session',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId', 'agentName'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                        agentName: { type: 'string', description: 'Agent name to match (case-insensitive)' },
-                        limit: { type: 'number', description: 'Max results (default: 100)' },
-                        offset: { type: 'number', description: 'Pagination offset (default: 0)' },
-                    },
-                },
-            },
-            {
-                name: 'devchain_create_epic',
-                description: 'Create a new epic within the project resolved from the session',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId', 'title'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                        title: { type: 'string', description: 'Epic title' },
-                        description: { type: 'string', description: 'Optional epic description' },
-                        statusName: {
-                            type: 'string',
-                            description: 'Optional status name (case-insensitive)',
-                        },
-                        tags: {
-                            type: 'array',
-                            items: { type: 'string' },
-                            description: 'Optional list of tags to assign to the epic',
-                        },
-                        agentName: {
-                            type: 'string',
-                            description: 'Optional agent name to assign (case-insensitive)',
-                        },
-                        parentId: {
-                            type: 'string',
-                            description: 'Optional parent epic UUID to nest this epic under',
-                        },
-                    },
-                },
-            },
-            {
-                name: 'devchain_get_epic_by_id',
-                description: 'Fetch a single epic, including comments and related hierarchy details',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId', 'id'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                        id: { type: 'string', description: 'Epic UUID' },
-                    },
-                },
-            },
-            {
-                name: 'devchain_add_epic_comment',
-                description: 'Add a comment to the specified epic within the project resolved from the session. Author is derived from session agent.',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId', 'epicId', 'content'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                        epicId: { type: 'string', description: 'Epic UUID' },
-                        content: { type: 'string', description: 'Comment body content' },
-                    },
-                },
-            },
-            {
-                name: 'devchain_update_epic',
-                description: 'Update an epic with flexible field updates including status (by name), assignment (by agent name or clear), parent hierarchy, and tags. Uses optimistic locking via version.',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId', 'id', 'version'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                        id: { type: 'string', description: 'Epic UUID' },
-                        version: { type: 'number', description: 'Current version for optimistic locking' },
-                        title: { type: 'string', description: 'New epic title' },
-                        description: { type: 'string', description: 'New epic description' },
-                        statusName: {
-                            type: 'string',
-                            description: 'Status name (case-insensitive exact match)',
-                        },
-                        assignment: {
-                            type: 'object',
-                            description: 'Assignment update: either { agentName: string } to assign or { clear: true } to unassign',
-                            oneOf: [
-                                {
-                                    type: 'object',
-                                    required: ['agentName'],
-                                    properties: {
-                                        agentName: {
-                                            type: 'string',
-                                            description: 'Agent name (case-insensitive exact match)',
-                                        },
-                                    },
-                                },
-                                {
-                                    type: 'object',
-                                    required: ['clear'],
-                                    properties: {
-                                        clear: {
-                                            type: 'boolean',
-                                            const: true,
-                                            description: 'Set to true to clear assignment',
-                                        },
-                                    },
-                                },
-                            ],
-                        },
-                        parentId: {
-                            type: 'string',
-                            description: 'Parent epic UUID (mutually exclusive with clearParent)',
-                        },
-                        clearParent: {
-                            type: 'boolean',
-                            description: 'Set to true to remove parent (mutually exclusive with parentId)',
-                        },
-                        setTags: {
-                            type: 'array',
-                            items: { type: 'string' },
-                            description: 'Replace all tags with this array',
-                        },
-                        addTags: { type: 'array', items: { type: 'string' }, description: 'Tags to add' },
-                        removeTags: { type: 'array', items: { type: 'string' }, description: 'Tags to remove' },
-                    },
-                },
-            },
-            {
-                name: 'devchain_create_record',
-                description: 'Create a new record (generic data storage for epics)',
-                inputSchema: {
-                    type: 'object',
-                    required: ['epicId', 'type', 'data'],
-                    properties: {
-                        epicId: { type: 'string', description: 'Epic UUID this record belongs to' },
-                        type: { type: 'string', description: 'Record type identifier' },
-                        data: { type: 'object', description: 'Arbitrary JSON data' },
-                        tags: { type: 'array', items: { type: 'string' }, description: 'Record tags' },
-                    },
-                },
-            },
-            {
-                name: 'devchain_update_record',
-                description: 'Update an existing record',
-                inputSchema: {
-                    type: 'object',
-                    required: ['id', 'version'],
-                    properties: {
-                        id: { type: 'string', description: 'Record UUID' },
-                        data: { type: 'object', description: 'New data (merged)' },
-                        type: { type: 'string', description: 'New type' },
-                        tags: { type: 'array', items: { type: 'string' }, description: 'New tags' },
-                        version: { type: 'number', description: 'Current version for optimistic locking' },
-                    },
-                },
-            },
-            {
-                name: 'devchain_get_record',
-                description: 'Get a record by ID',
-                inputSchema: {
-                    type: 'object',
-                    required: ['id'],
-                    properties: { id: { type: 'string', description: 'Record UUID' } },
-                },
-            },
-            {
-                name: 'devchain_list_records',
-                description: 'List records for an epic with optional filtering',
-                inputSchema: {
-                    type: 'object',
-                    required: ['epicId'],
-                    properties: {
-                        epicId: { type: 'string', description: 'Epic UUID' },
-                        type: { type: 'string', description: 'Filter by record type' },
-                        tags: { type: 'array', items: { type: 'string' }, description: 'Filter by tags' },
-                        limit: { type: 'number', description: 'Max results' },
-                        offset: { type: 'number', description: 'Pagination offset' },
-                    },
-                },
-            },
-            {
-                name: 'devchain_add_tags',
-                description: 'Add tags to a record',
-                inputSchema: {
-                    type: 'object',
-                    required: ['id', 'tags'],
-                    properties: {
-                        id: { type: 'string', description: 'Record UUID' },
-                        tags: {
-                            type: 'array',
-                            items: { type: 'string' },
-                            minItems: 1,
-                            description: 'Tags to add',
-                        },
-                    },
-                },
-            },
-            {
-                name: 'devchain_remove_tags',
-                description: 'Remove tags from a record',
-                inputSchema: {
-                    type: 'object',
-                    required: ['id', 'tags'],
-                    properties: {
-                        id: { type: 'string', description: 'Record UUID' },
-                        tags: {
-                            type: 'array',
-                            items: { type: 'string' },
-                            minItems: 1,
-                            description: 'Tags to remove',
-                        },
-                    },
-                },
-            },
-            {
-                name: 'devchain_send_message',
-                description: 'Send a chat message. Sender is derived from session agent. Provide recipientAgentNames to create a new agent-initiated group.',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId', 'message'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                        recipientAgentNames: {
-                            type: 'array',
-                            items: { type: 'string' },
-                            description: 'Agent names (case-insensitive) to receive the message.',
-                        },
-                        recipient: {
-                            type: 'string',
-                            enum: ['user', 'agents'],
-                            description: 'Set to "user" to DM the user without a threadId.',
-                        },
-                        message: { type: 'string', description: 'Message content to deliver.' },
-                    },
-                },
-            },
-            {
-                name: 'devchain_chat_ack',
-                description: 'Mark a chat message as read for an agent and emit a message.read event.',
-                inputSchema: {
-                    type: 'object',
-                    required: ['sessionId', 'thread_id', 'message_id'],
-                    properties: {
-                        sessionId: {
-                            type: 'string',
-                            description: 'Session ID (full UUID or 8+ char prefix)',
-                        },
-                        thread_id: { type: 'string', description: 'Chat thread UUID.' },
-                        message_id: { type: 'string', description: 'Chat message UUID to acknowledge.' },
-                    },
-                },
-            },
-            {
-                name: 'devchain_chat_read_history',
-                description: 'Fetch recent messages for a chat thread so agents can catch up after an invite.',
-                inputSchema: {
-                    type: 'object',
-                    required: ['thread_id'],
-                    properties: {
-                        thread_id: { type: 'string', description: 'Chat thread UUID.' },
-                        limit: { type: 'number', description: 'Max messages to return (default 50, max 200).' },
-                        since: {
-                            type: 'string',
-                            description: 'ISO timestamp; only messages after this time are returned.',
-                        },
-                        exclude_system: {
-                            type: 'boolean',
-                            description: 'Exclude system messages. Defaults to true when omitted to show only user/agent authored messages.',
-                        },
-                    },
-                },
-            },
-            {
-                name: 'devchain_chat_list_members',
-                description: 'List members of a chat thread along with their online status.',
-                inputSchema: {
-                    type: 'object',
-                    required: ['thread_id'],
-                    properties: { thread_id: { type: 'string', description: 'Chat thread UUID.' } },
-                },
-            },
-        ];
-        return (0, constants_1.filterHiddenTools)(tools);
+        return (0, constants_1.filterHiddenTools)((0, tool_definitions_1.getToolDefinitions)());
     }
     async handleSseStream(request, reply, sessionId, _lastEventId) {
         reply.raw.writeHead(200, {