agenthub-multiagent-mcp 1.3.0 → 1.4.1

package/src/tools/index.ts

@@ -532,6 +532,15 @@ export function registerTools(): Tool[] {
             description: "Filter by priority (optional)",
             enum: ["lowest", "low", "medium", "high", "highest"],
           },
+          required_type: {
+            type: "string",
+            description: "Filter by required skill type - matches your agent type",
+            enum: ["frontend", "backend", "android", "ios", "ai", "design-specs"],
+          },
+          match_my_type: {
+            type: "boolean",
+            description: "If true, only show tasks matching your registered agent type",
+          },
         },
       },
     },
@@ -581,6 +590,150 @@ export function registerTools(): Tool[] {
         required: ["task_id", "description"],
       },
     },
+
+    // Ticket creation tools
+    {
+      name: "create_epic",
+      description: "Create an epic (large body of work) in a project",
+      inputSchema: {
+        type: "object",
+        properties: {
+          project_id: {
+            type: "string",
+            description: "Project ID to create epic in",
+          },
+          title: {
+            type: "string",
+            description: "Epic title",
+          },
+          description: {
+            type: "string",
+            description: "Epic description (supports markdown)",
+          },
+          source_file: {
+            type: "string",
+            description: "Optional: path to OpenSpec file this came from",
+          },
+        },
+        required: ["project_id", "title"],
+      },
+    },
+    {
+      name: "create_story",
+      description: "Create a story under an epic",
+      inputSchema: {
+        type: "object",
+        properties: {
+          project_id: {
+            type: "string",
+            description: "Project ID",
+          },
+          epic_id: {
+            type: "string",
+            description: "Epic ID to add story to",
+          },
+          title: {
+            type: "string",
+            description: "Story title",
+          },
+          description: {
+            type: "string",
+            description: "Story description",
+          },
+          required_type: {
+            type: "string",
+            enum: ["frontend", "backend", "android", "ios", "ai", "design-specs"],
+            description: "Required skill type for this story",
+          },
+          labels: {
+            type: "array",
+            items: { type: "string" },
+            description: "Additional labels",
+          },
+        },
+        required: ["project_id", "title"],
+      },
+    },
+    {
+      name: "create_task",
+      description: "Create a task under a story",
+      inputSchema: {
+        type: "object",
+        properties: {
+          project_id: {
+            type: "string",
+            description: "Project ID",
+          },
+          story_id: {
+            type: "string",
+            description: "Story ID to add task to",
+          },
+          title: {
+            type: "string",
+            description: "Task title",
+          },
+          description: {
+            type: "string",
+            description: "Task description",
+          },
+          required_type: {
+            type: "string",
+            enum: ["frontend", "backend", "android", "ios", "ai", "design-specs"],
+            description: "Required skill type",
+          },
+        },
+        required: ["project_id", "title"],
+      },
+    },
+    {
+      name: "upload_attachment",
+      description: "Upload a file (screenshot, log, etc.) as proof of work to a ticket",
+      inputSchema: {
+        type: "object",
+        properties: {
+          ticket_id: {
+            type: "string",
+            description: "Ticket ID to attach file to",
+          },
+          ticket_type: {
+            type: "string",
+            enum: ["epic", "story", "task"],
+            description: "Type of ticket",
+          },
+          ticket_key: {
+            type: "string",
+            description: "Ticket key (e.g., PROJ-T42)",
+          },
+          file_path: {
+            type: "string",
+            description: "Local path to file to upload",
+          },
+          description: {
+            type: "string",
+            description: "Optional description of the file",
+          },
+        },
+        required: ["ticket_id", "ticket_type", "ticket_key", "file_path"],
+      },
+    },
+    {
+      name: "add_comment",
+      description: "Add a comment to any ticket (epic, story, task)",
+      inputSchema: {
+        type: "object",
+        properties: {
+          ticket_id: {
+            type: "string",
+            description: "Ticket ID to comment on",
+          },
+          body: {
+            type: "string",
+            description: "Comment body (supports markdown)",
+          },
+        },
+        required: ["ticket_id", "body"],
+      },
+    },
   ];
 }
 
@@ -623,6 +776,9 @@ export async function handleToolCall(
 
             context.setCurrentAgentId(existingState.agent_id);
 
+            // Set connect token on client for org operations
+            client.setConnectToken(existingState.token);
+
             // Update state with returned name from server
             state.saveState(workingDir, {
               ...existingState,
@@ -692,12 +848,16 @@ export async function handleToolCall(
       const agentId = registrationResult.agent_id!;
       context.setCurrentAgentId(agentId);
 
+      // Set connect token on client for org operations
+      client.setConnectToken(registrationResult.connect_token!);
+
       // Save state for future reconnection
       state.saveState(workingDir, {
         agent_id: agentId,
         name: registrationResult.agent_name || agentId,
         owner,
         token: registrationResult.connect_token!,
+        agent_type: registrationResult.agent_type,
         registered_at: new Date().toISOString(),
       });
 
@@ -851,10 +1011,22 @@ export async function handleToolCall(
     // Ticket system tools
     case "get_available_tasks": {
       if (!agentId) throw new Error("Not registered. Call agent_register first.");
+
+      let requiredType = args.required_type as string | undefined;
+
+      // If match_my_type is true, get agent's type from state
+      if (args.match_my_type === true) {
+        const workingDir = context.getWorkingDir();
+        const agentState = state.loadState(workingDir);
+        // Use stored agent_type if available, otherwise keep the explicit required_type
+        requiredType = requiredType || agentState?.agent_type;
+      }
+
       const result = await client.getAvailableTasks({
         status: args.status as string | undefined,
         project_id: args.project_id as string | undefined,
         priority: args.priority as string | undefined,
+        required_type: requiredType,
       });
       return wrapWithPendingItems(client, agentId, result, context);
     }
@@ -881,6 +1053,77 @@ export async function handleToolCall(
       return wrapWithPendingItems(client, agentId, result, context);
     }
 
+    // Ticket creation tools
+    case "create_epic": {
+      const result = await client.createEpic({
+        project_id: args.project_id as string,
+        title: args.title as string,
+        description: args.description as string | undefined,
+        source_file: args.source_file as string | undefined,
+      });
+      return {
+        ...result,
+        message: `Created epic ${result.key}: ${args.title}`,
+      };
+    }
+
+    case "create_story": {
+      const result = await client.createStory({
+        project_id: args.project_id as string,
+        epic_id: args.epic_id as string | undefined,
+        title: args.title as string,
+        description: args.description as string | undefined,
+        required_type: args.required_type as string | undefined,
+        labels: args.labels as string[] | undefined,
+      });
+      return {
+        ...result,
+        message: `Created story ${result.key}: ${args.title}`,
+      };
+    }
+
+    case "create_task": {
+      const result = await client.createTask({
+        project_id: args.project_id as string,
+        story_id: args.story_id as string | undefined,
+        title: args.title as string,
+        description: args.description as string | undefined,
+        required_type: args.required_type as string | undefined,
+      });
+      return {
+        ...result,
+        message: `Created task ${result.key}: ${args.title}`,
+      };
+    }
+
+    case "upload_attachment": {
+      if (!agentId) throw new Error("Not registered. Call agent_register first.");
+      const result = await client.uploadAttachment({
+        ticket_id: args.ticket_id as string,
+        ticket_type: args.ticket_type as string,
+        ticket_key: args.ticket_key as string,
+        file_path: args.file_path as string,
+        description: args.description as string | undefined,
+        agent_id: agentId,
+      });
+      return {
+        ...result,
+        message: `Uploaded ${result.filename} to ${args.ticket_key}`,
+      };
+    }
+
+    case "add_comment": {
+      if (!agentId) throw new Error("Not registered. Call agent_register first.");
+      const result = await client.addComment({
+        ticket_id: args.ticket_id as string,
+        body: args.body as string,
+      });
+      return {
+        ...result,
+        message: `Added comment to ticket`,
+      };
+    }
+
     default:
       throw new Error(`Unknown tool: ${name}`);
   }