@yinuo-ngm/mcp-server 0.1.2 → 0.1.3

package/lib/tools/hub-v2/issues-workflow.tools.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hubV2IssueWorkflowTools = hubV2IssueWorkflowTools;
+const client_1 = require("./client");
+const index_1 = require("./config/index");
+const raw_1 = require("./raw");
+const schemas_1 = require("./schemas");
+const result_1 = require("../../utils/result");
+function hubV2IssueWorkflowTools() {
+    return [
+        issueReadTool("hub_v2_issues_logs_list", "List Hub V2 issue logs with Project Token.", "logs"),
+        issueReadTool("hub_v2_issues_comments_list", "List Hub V2 issue comments with Project Token.", "comments"),
+        issueReadTool("hub_v2_issues_participants_list", "List Hub V2 issue participants with Project Token.", "participants"),
+        issueReadTool("hub_v2_issues_attachments_list", "List Hub V2 issue attachments with Project Token.", "attachments"),
+        issueReadTool("hub_v2_issues_branches_list", "List Hub V2 issue collaboration branches with Project Token.", "branches"),
+        {
+            name: "hub_v2_issues_attachment_raw_get",
+            description: "Read one Hub V2 issue attachment raw file as base64 with Project Token.",
+            riskLevel: "read",
+            inputSchema: schemas_1.issueAttachmentRawSchema,
+            async handler(args) {
+                const ctx = (0, index_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await (0, raw_1.readRawAsBase64)(client, client.tokenUrl(`/issues/${encodeURIComponent(args.issueId)}/attachments/${encodeURIComponent(args.attachmentId)}/raw`), args.maxBytes);
+                return (0, result_1.ok)("hub_v2_issues_attachment_raw_get", data);
+            },
+        },
+        {
+            name: "hub_v2_issues_upload_raw_get",
+            description: "Read one Hub V2 issue Markdown upload raw file as base64 with Project Token.",
+            riskLevel: "read",
+            inputSchema: schemas_1.issueUploadRawSchema,
+            async handler(args) {
+                const ctx = (0, index_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await (0, raw_1.readRawAsBase64)(client, client.tokenUrl(`/issues/${encodeURIComponent(args.issueId)}/uploads/${encodeURIComponent(args.uploadId)}/raw`), args.maxBytes);
+                return (0, result_1.ok)("hub_v2_issues_upload_raw_get", data);
+            },
+        },
+        issueSimpleWriteTool("hub_v2_issues_claim", "Preview or claim a Hub V2 issue with Personal Token.", "claim", "issue:assign:write"),
+        {
+            name: "hub_v2_issues_participant_remove",
+            description: "Preview or remove a Hub V2 issue collaborator with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueParticipantRemoveSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/issues/${encodeURIComponent(args.issueId)}/participants/${encodeURIComponent(args.participantId)}`;
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_issues_participant_remove", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "DELETE",
+                            path,
+                            requiredScope: "issue:participant:write",
+                        },
+                    });
+                }
+                const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("DELETE", client.personalUrl(path));
+                return (0, result_1.ok)("hub_v2_issues_participant_remove", data);
+            },
+        },
+        {
+            name: "hub_v2_issues_branch_start_mine",
+            description: "Preview or start the current user's Hub V2 issue collaboration branch with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueBranchStartMineSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                return issueBodyWrite("hub_v2_issues_branch_start_mine", args, "branches/start-mine", "issue:branch:write", {
+                    title: args.title,
+                });
+            },
+        },
+        issueBranchActionTool("hub_v2_issues_branch_start", "Preview or start a Hub V2 issue collaboration branch with Personal Token.", "start"),
+        {
+            name: "hub_v2_issues_branch_complete",
+            description: "Preview or complete a Hub V2 issue collaboration branch with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueBranchCompleteSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `branches/${encodeURIComponent(args.branchId)}/complete`;
+                return issueBodyWrite("hub_v2_issues_branch_complete", args, path, "issue:branch:write", {
+                    summary: args.summary,
+                });
+            },
+        },
+        issueSimpleWriteTool("hub_v2_issues_start", "Preview or start Hub V2 issue processing with Personal Token.", "start", "issue:transition:write"),
+        issueSimpleWriteTool("hub_v2_issues_wait_update", "Preview or move a Hub V2 issue to waiting-update with Personal Token.", "wait-update", "issue:transition:write"),
+        {
+            name: "hub_v2_issues_resolve",
+            description: "Preview or resolve a Hub V2 issue with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueResolveSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                return issueBodyWrite("hub_v2_issues_resolve", args, "resolve", "issue:transition:write", {
+                    resolutionSummary: args.resolutionSummary,
+                });
+            },
+        },
+        issueSimpleWriteTool("hub_v2_issues_verify", "Preview or verify a Hub V2 issue with Personal Token.", "verify", "issue:transition:write"),
+        {
+            name: "hub_v2_issues_reopen",
+            description: "Preview or reopen a Hub V2 issue with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueReopenSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                return issueBodyWrite("hub_v2_issues_reopen", args, "reopen", "issue:transition:write", {
+                    remark: args.remark,
+                });
+            },
+        },
+        {
+            name: "hub_v2_issues_close",
+            description: "Preview or close a Hub V2 issue with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueCloseSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                return issueBodyWrite("hub_v2_issues_close", args, "close", "issue:transition:write", {
+                    reason: args.reason,
+                    remark: args.remark,
+                });
+            },
+        },
+    ];
+}
+function issueReadTool(name, description, suffix) {
+    return {
+        name,
+        description,
+        riskLevel: "read",
+        inputSchema: schemas_1.issueReadDetailSchema,
+        async handler(args) {
+            const ctx = (0, index_1.resolveHubV2Context)(args, "project");
+            const client = new client_1.HubV2Client(ctx);
+            const data = await client.request("GET", client.tokenUrl(`/issues/${encodeURIComponent(args.issueId)}/${suffix}`));
+            return (0, result_1.ok)(name, data);
+        },
+    };
+}
+function issueSimpleWriteTool(name, description, suffix, requiredScope) {
+    return {
+        name,
+        description,
+        riskLevel: "write",
+        inputSchema: schemas_1.issueSimpleWriteSchema,
+        allowPreviewWhenBlocked: true,
+        isConfirmed: (args) => args.confirm === true,
+        async handler(args) {
+            return issueBodyWrite(name, args, suffix, requiredScope);
+        },
+    };
+}
+function issueBranchActionTool(name, description, suffix) {
+    return {
+        name,
+        description,
+        riskLevel: "write",
+        inputSchema: schemas_1.issueBranchActionSchema,
+        allowPreviewWhenBlocked: true,
+        isConfirmed: (args) => args.confirm === true,
+        async handler(args) {
+            return issueBodyWrite(name, args, `branches/${encodeURIComponent(args.branchId)}/${suffix}`, "issue:branch:write");
+        },
+    };
+}
+async function issueBodyWrite(name, args, suffix, requiredScope, body = {}) {
+    const path = `/issues/${encodeURIComponent(args.issueId)}/${suffix}`;
+    const compactBody = (0, client_1.compact)(body);
+    if (!args.confirm) {
+        return (0, result_1.ok)(name, {
+            code: "PREVIEW",
+            message: "set confirm=true to execute this write operation",
+            data: {
+                method: "POST",
+                path,
+                requiredScope,
+                ...(Object.keys(compactBody).length > 0 ? { body: compactBody } : {}),
+            },
+        });
+    }
+    const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
+    const client = new client_1.HubV2Client(ctx);
+    const data = await client.request("POST", client.personalUrl(path), compactBody);
+    return (0, result_1.ok)(name, data);
+}

package/lib/tools/hub-v2/issues.tools.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hubV2IssuesTools = hubV2IssuesTools;
 const client_1 = require("./client");
-const config_1 = require("./config");
+const index_1 = require("./config/index");
 const schemas_1 = require("./schemas");
 const result_1 = require("../../utils/result");
 function hubV2IssuesTools() {
@@ -13,7 +13,7 @@ function hubV2IssuesTools() {
             riskLevel: "read",
             inputSchema: schemas_1.issuesListSchema,
             async handler(args) {
-                const ctx = (0, config_1.resolveHubV2Context)(args, "project");
+                const ctx = (0, index_1.resolveHubV2Context)(args, "project");
                 const client = new client_1.HubV2Client(ctx);
                 const data = await client.request("GET", client.tokenUrl("/issues", {
                     page: args.page ?? 1,
@@ -34,7 +34,7 @@ function hubV2IssuesTools() {
             riskLevel: "read",
             inputSchema: schemas_1.issueGetSchema,
             async handler(args) {
-                const ctx = (0, config_1.resolveHubV2Context)(args, "project");
+                const ctx = (0, index_1.resolveHubV2Context)(args, "project");
                 const client = new client_1.HubV2Client(ctx);
                 const data = await client.request("GET", client.tokenUrl(`/issues/${encodeURIComponent(args.issueId)}`));
                 return (0, result_1.ok)("hub_v2_issues_get", data);
@@ -73,7 +73,7 @@ function hubV2IssuesTools() {
                         },
                     });
                 }
-                const ctx = (0, config_1.resolveHubV2Context)(args, "personal");
+                const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
                 const client = new client_1.HubV2Client(ctx);
                 const data = await client.request("POST", client.personalUrl(path), body);
                 return (0, result_1.ok)("hub_v2_issues_create", data);
@@ -104,12 +104,102 @@ function hubV2IssuesTools() {
                         },
                     });
                 }
-                const ctx = (0, config_1.resolveHubV2Context)(args, "personal");
+                const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
                 const client = new client_1.HubV2Client(ctx);
                 const data = await client.request("POST", client.personalUrl(path), body);
                 return (0, result_1.ok)("hub_v2_issues_comment", data);
             },
         },
+        {
+            name: "hub_v2_issues_assign",
+            description: "Preview or assign a Hub V2 issue assignee with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueAssignSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/issues/${encodeURIComponent(args.issueId)}/assign`;
+                const body = { assigneeId: args.assigneeId };
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_issues_assign", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "issue:assign:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_issues_assign", data);
+            },
+        },
+        {
+            name: "hub_v2_issues_participant_add",
+            description: "Preview or add a Hub V2 issue collaborator, optionally creating a collaborator task branch.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueParticipantAddSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/issues/${encodeURIComponent(args.issueId)}/participants`;
+                const body = (0, client_1.compact)({
+                    userId: args.userId,
+                    taskTitle: args.taskTitle,
+                });
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_issues_participant_add", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "issue:participant:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_issues_participant_add", data);
+            },
+        },
+        {
+            name: "hub_v2_issues_branch_create",
+            description: "Preview or create a Hub V2 issue collaboration branch for an existing collaborator.",
+            riskLevel: "write",
+            inputSchema: schemas_1.issueBranchCreateSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/issues/${encodeURIComponent(args.issueId)}/branches`;
+                const body = {
+                    ownerUserId: args.ownerUserId,
+                    title: args.title,
+                };
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_issues_branch_create", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "issue:branch:write",
+                            body,
+                        },
+                    });
+                }
+                const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_issues_branch_create", data);
+            },
+        },
         {
             name: "hub_v2_issues_update",
             description: "Preview or update Hub V2 issue basic fields with Personal Token.",
@@ -144,7 +234,7 @@ function hubV2IssuesTools() {
                         },
                     });
                 }
-                const ctx = (0, config_1.resolveHubV2Context)(args, "personal");
+                const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
                 const client = new client_1.HubV2Client(ctx);
                 const data = await client.request("PATCH", client.personalUrl(path), body, { preserveNull: true });
                 return (0, result_1.ok)("hub_v2_issues_update", data);

package/lib/tools/hub-v2/projects.tools.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hubV2ProjectsTools = hubV2ProjectsTools;
-const config_1 = require("./config");
+const client_1 = require("./client");
+const index_1 = require("./config/index");
 const schemas_1 = require("./schemas");
 const result_1 = require("../../utils/result");
 function hubV2ProjectsTools() {
@@ -12,7 +13,7 @@ function hubV2ProjectsTools() {
             riskLevel: "read",
             inputSchema: schemas_1.projectSelectorSchema,
             handler(args) {
-                return (0, result_1.ok)("hub_v2_projects_list", (0, config_1.listConfiguredProjects)(args.project ?? args.projectKey));
+                return (0, result_1.ok)("hub_v2_projects_list", (0, index_1.listConfiguredProjects)(args.project ?? args.projectKey));
             },
         },
         {
@@ -21,7 +22,19 @@ function hubV2ProjectsTools() {
             riskLevel: "read",
             inputSchema: schemas_1.projectSelectorSchema,
             handler(args) {
-                return (0, result_1.ok)("hub_v2_projects_get", (0, config_1.getConfiguredProject)(args));
+                return (0, result_1.ok)("hub_v2_projects_get", (0, index_1.getConfiguredProject)(args));
+            },
+        },
+        {
+            name: "hub_v2_project_members_list",
+            description: "List Hub V2 project members with Project Token for assignment and mention candidates.",
+            riskLevel: "read",
+            inputSchema: schemas_1.projectMembersListSchema,
+            async handler(args) {
+                const ctx = (0, index_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("GET", client.tokenUrl("/members"));
+                return (0, result_1.ok)("hub_v2_project_members_list", data);
             },
         },
     ];

package/lib/tools/hub-v2/raw.d.ts

@@ -0,0 +1,8 @@
+import { HubV2Client } from "./client";
+export declare function readRawAsBase64(client: HubV2Client, url: string, maxBytes?: number): Promise<{
+    contentBase64: string;
+    contentType: string;
+    fileName: string | null;
+    sizeBytes: number;
+    truncated: boolean;
+}>;

package/lib/tools/hub-v2/raw.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readRawAsBase64 = readRawAsBase64;
+async function readRawAsBase64(client, url, maxBytes) {
+    const limit = maxBytes ?? 1024 * 1024;
+    const raw = await client.raw("GET", url);
+    if (raw.content.byteLength > limit) {
+        throw new Error(`raw file is too large: ${raw.content.byteLength} bytes exceeds maxBytes=${limit}`);
+    }
+    return {
+        contentBase64: raw.content.toString("base64"),
+        contentType: raw.contentType,
+        fileName: extractFileName(raw.contentDisposition),
+        sizeBytes: raw.content.byteLength,
+        truncated: false,
+    };
+}
+function extractFileName(contentDisposition) {
+    if (!contentDisposition) {
+        return null;
+    }
+    const utf8Match = /filename\*=UTF-8''([^;]+)/i.exec(contentDisposition);
+    if (utf8Match) {
+        try {
+            return decodeURIComponent(utf8Match[1]);
+        }
+        catch {
+            return utf8Match[1];
+        }
+    }
+    const asciiMatch = /filename="([^"]+)"/i.exec(contentDisposition);
+    return asciiMatch?.[1] ?? null;
+}