@paca-ai/paca-mcp 0.1.0-rc.6

package/tools/sprint-tools.js

@@ -0,0 +1,258 @@
+import { z } from "zod";
+import { formatList, formatSprint } from "../utils/index.js";
+const ListSprintsSchema = z.object({
+    projectId: z.string(),
+});
+const GetSprintSchema = z.object({
+    projectId: z.string(),
+    sprintId: z.string(),
+});
+const CreateSprintSchema = z.object({
+    projectId: z.string(),
+    name: z.string(),
+    startDate: z.string(),
+    endDate: z.string(),
+});
+const UpdateSprintSchema = z.object({
+    projectId: z.string(),
+    sprintId: z.string(),
+    name: z.string().optional(),
+    startDate: z.string().optional(),
+    endDate: z.string().optional(),
+});
+const DeleteSprintSchema = z.object({
+    projectId: z.string(),
+    sprintId: z.string(),
+});
+const CompleteSprintSchema = z.object({
+    projectId: z.string(),
+    sprintId: z.string(),
+});
+/**
+ * Returns all sprint-related MCP tools.
+ * @returns Array of sprint tools
+ */
+export function getSprintTools() {
+    return [
+        {
+            name: "list_sprints",
+            description: "List all sprints in a project",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    projectId: {
+                        type: "string",
+                        description: "The ID of the project",
+                    },
+                },
+                required: ["projectId"],
+            },
+        },
+        {
+            name: "get_sprint",
+            description: "Get details of a specific sprint",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    projectId: {
+                        type: "string",
+                        description: "The ID of the project",
+                    },
+                    sprintId: {
+                        type: "string",
+                        description: "The ID of the sprint",
+                    },
+                },
+                required: ["projectId", "sprintId"],
+            },
+        },
+        {
+            name: "create_sprint",
+            description: "Create a new sprint",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    projectId: {
+                        type: "string",
+                        description: "The ID of the project",
+                    },
+                    name: {
+                        type: "string",
+                        description: "The name of the sprint",
+                    },
+                    startDate: {
+                        type: "string",
+                        description: "The start date (ISO 8601 format)",
+                    },
+                    endDate: {
+                        type: "string",
+                        description: "The end date (ISO 8601 format)",
+                    },
+                },
+                required: ["projectId", "name", "startDate", "endDate"],
+            },
+        },
+        {
+            name: "update_sprint",
+            description: "Update an existing sprint",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    projectId: {
+                        type: "string",
+                        description: "The ID of the project",
+                    },
+                    sprintId: {
+                        type: "string",
+                        description: "The ID of the sprint",
+                    },
+                    name: {
+                        type: "string",
+                        description: "The new name of the sprint",
+                    },
+                    startDate: {
+                        type: "string",
+                        description: "The new start date (ISO 8601 format)",
+                    },
+                    endDate: {
+                        type: "string",
+                        description: "The new end date (ISO 8601 format)",
+                    },
+                },
+                required: ["projectId", "sprintId"],
+            },
+        },
+        {
+            name: "delete_sprint",
+            description: "Delete a sprint",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    projectId: {
+                        type: "string",
+                        description: "The ID of the project",
+                    },
+                    sprintId: {
+                        type: "string",
+                        description: "The ID of the sprint",
+                    },
+                },
+                required: ["projectId", "sprintId"],
+            },
+        },
+        {
+            name: "complete_sprint",
+            description: "Mark a sprint as completed",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    projectId: {
+                        type: "string",
+                        description: "The ID of the project",
+                    },
+                    sprintId: {
+                        type: "string",
+                        description: "The ID of the sprint",
+                    },
+                },
+                required: ["projectId", "sprintId"],
+            },
+        },
+    ];
+}
+/**
+ * Handles sprint-related tool calls.
+ * @param toolName - Name of the tool being called
+ * @param args - Tool arguments
+ * @param client - Paca API client instance
+ * @returns Tool response
+ */
+export async function handleSprintTool(toolName, args, client) {
+    switch (toolName) {
+        case "list_sprints": {
+            const { projectId } = ListSprintsSchema.parse(args);
+            const sprints = await client.listSprints(projectId);
+            const formatted = formatList(sprints, formatSprint);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Sprints:\n\n${formatted}`,
+                    },
+                ],
+            };
+        }
+        case "get_sprint": {
+            const { projectId, sprintId } = GetSprintSchema.parse(args);
+            const sprint = await client.getSprint(projectId, sprintId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatSprint(sprint),
+                    },
+                ],
+            };
+        }
+        case "create_sprint": {
+            const { projectId, name, startDate, endDate } = CreateSprintSchema.parse(args);
+            const sprint = await client.createSprint({
+                project_id: projectId,
+                name,
+                start_date: startDate,
+                end_date: endDate,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Sprint created successfully:\n\n${formatSprint(sprint)}`,
+                    },
+                ],
+            };
+        }
+        case "update_sprint": {
+            const { projectId, sprintId, name, startDate, endDate } = UpdateSprintSchema.parse(args);
+            const sprint = await client.updateSprint(projectId, sprintId, {
+                name,
+                start_date: startDate,
+                end_date: endDate,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Sprint updated successfully:\n\n${formatSprint(sprint)}`,
+                    },
+                ],
+            };
+        }
+        case "delete_sprint": {
+            const { projectId, sprintId } = DeleteSprintSchema.parse(args);
+            await client.deleteSprint(projectId, sprintId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Sprint ${sprintId} deleted successfully`,
+                    },
+                ],
+            };
+        }
+        case "complete_sprint": {
+            const { projectId, sprintId } = CompleteSprintSchema.parse(args);
+            const sprint = await client.completeSprint(projectId, sprintId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Sprint completed successfully:\n\n${formatSprint(sprint)}`,
+                    },
+                ],
+            };
+        }
+        default:
+            throw new Error(`Unknown sprint tool: ${toolName}`);
+    }
+}
+//# sourceMappingURL=sprint-tools.js.map

package/tools/sprint-tools.js.map

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

package/tools/task-activity-tools.d.ts

@@ -0,0 +1,15 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { PacaAPITaskExtendedClient } from "../api/index.js";
+/**
+ * Returns all task comment and activity related MCP tools.
+ */
+export declare function getTaskActivityTools(): Tool[];
+/**
+ * Returns all task GitHub related MCP tools.
+ */
+export declare function getTaskGitHubTools(): Tool[];
+/**
+ * Handles task activity, comment, and GitHub tool calls.
+ */
+export declare function handleTaskActivityTool(toolName: string, args: any, client: PacaAPITaskExtendedClient): Promise<any>;
+//# sourceMappingURL=task-activity-tools.d.ts.map

package/tools/task-activity-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-activity-tools.d.ts","sourceRoot":"","sources":["../../src/tools/task-activity-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAyDjE;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,EAAE,CA2F7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,EAAE,CAqH3C;AAoCD;;GAEG;AACH,wBAAsB,sBAAsB,CAC3C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,yBAAyB,GAC/B,OAAO,CAAC,GAAG,CAAC,CAiJd"}