@yinuo-ngm/mcp-server 0.1.1 → 0.1.3

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

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hubV2DocsTools = hubV2DocsTools;
+const client_1 = require("./client");
+const index_1 = require("./config/index");
+const schemas_1 = require("./schemas");
+const result_1 = require("../../utils/result");
+function hubV2DocsTools() {
+    return [
+        {
+            name: "hub_v2_docs_list",
+            description: "List Hub V2 project documents with Project Token.",
+            riskLevel: "read",
+            inputSchema: schemas_1.docsListSchema,
+            async handler(args) {
+                const ctx = (0, index_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const status = args.status;
+                const data = await client.request("GET", client.tokenUrl("/docs", {
+                    page: args.page ?? 1,
+                    pageSize: args.pageSize ?? 20,
+                    status,
+                    statusGroup: status ? undefined : "active",
+                    keyword: args.keyword,
+                    category: args.category,
+                    categoryId: args.categoryId,
+                }));
+                return (0, result_1.ok)("hub_v2_docs_list", data);
+            },
+        },
+        {
+            name: "hub_v2_docs_get",
+            description: "Read one Hub V2 project document by id with Project Token.",
+            riskLevel: "read",
+            inputSchema: schemas_1.docsGetSchema,
+            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(`/docs/${encodeURIComponent(args.docId)}`));
+                return (0, result_1.ok)("hub_v2_docs_get", data);
+            },
+        },
+        {
+            name: "hub_v2_docs_get_by_slug",
+            description: "Read one Hub V2 project document by slug with Project Token.",
+            riskLevel: "read",
+            inputSchema: schemas_1.docsGetBySlugSchema,
+            async handler(args) {
+                const ctx = (0, index_1.resolveHubV2Context)(args, "project");
+                const client = new client_1.HubV2Client(ctx);
+                const payload = await client.request("GET", client.tokenUrl(`/docs/by-slug/${encodeURIComponent(args.slug)}`));
+                if (args.contentOnly) {
+                    const content = extractDocumentContent(payload);
+                    if (typeof content === "string") {
+                        return (0, result_1.ok)("hub_v2_docs_get_by_slug", content);
+                    }
+                    return (0, result_1.fail)("hub_v2_docs_get_by_slug", "Hub V2 document response did not include data.contentMd or data.item.contentMd", {
+                        code: "DOCUMENT_CONTENT_NOT_FOUND",
+                        detail: {
+                            slug: args.slug,
+                            responseKeys: Object.keys(payload),
+                        },
+                    });
+                }
+                return (0, result_1.ok)("hub_v2_docs_get_by_slug", payload);
+            },
+        },
+        {
+            name: "hub_v2_docs_create",
+            description: "Preview or create a Hub V2 project document draft with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.docsCreateSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = "/docs";
+                if (!hasDocumentContent(args)) {
+                    return (0, result_1.fail)("hub_v2_docs_create", "content or contentMd is required", {
+                        code: "VALIDATION_ERROR",
+                        detail: { field: "content" },
+                    });
+                }
+                const ctx = args.confirm ? (0, index_1.resolveHubV2Context)(args, "personal") : undefined;
+                const body = (0, client_1.compact)({
+                    title: args.title,
+                    content: args.content,
+                    contentMd: args.contentMd,
+                    slug: args.slug,
+                    category: args.category,
+                    categoryId: args.categoryId,
+                    summary: args.summary,
+                    tags: args.tags,
+                    status: args.status ?? "draft",
+                    source: args.source ?? ctx?.source,
+                    version: args.version,
+                });
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_docs_create", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "doc:create:write",
+                            body,
+                        },
+                    });
+                }
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_docs_create", data);
+            },
+        },
+        {
+            name: "hub_v2_docs_update",
+            description: "Preview or update a Hub V2 project document with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.docsUpdateSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/docs/${encodeURIComponent(args.docId)}`;
+                if (!hasDocumentUpdateField(args)) {
+                    return (0, result_1.fail)("hub_v2_docs_update", "at least one document field is required", {
+                        code: "VALIDATION_ERROR",
+                        detail: { field: "title" },
+                    });
+                }
+                const ctx = args.confirm ? (0, index_1.resolveHubV2Context)(args, "personal") : undefined;
+                const body = (0, client_1.compactUndefined)({
+                    title: args.title,
+                    content: args.content,
+                    contentMd: args.contentMd,
+                    slug: args.slug,
+                    category: args.category,
+                    categoryId: args.categoryId,
+                    summary: args.summary,
+                    tags: args.tags,
+                    source: args.source ?? ctx?.source,
+                    version: args.version,
+                });
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_docs_update", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "PATCH",
+                            path,
+                            requiredScope: "doc:update:write",
+                            body,
+                        },
+                    });
+                }
+                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_docs_update", data);
+            },
+        },
+        {
+            name: "hub_v2_docs_publish",
+            description: "Preview or publish a Hub V2 project document with Personal Token.",
+            riskLevel: "write",
+            inputSchema: schemas_1.docsPublishSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = `/docs/${encodeURIComponent(args.docId)}/publish`;
+                const ctx = args.confirm ? (0, index_1.resolveHubV2Context)(args, "personal") : undefined;
+                const body = (0, client_1.compact)({
+                    source: args.source ?? ctx?.source,
+                });
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_docs_publish", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to execute this write operation",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "doc:publish:write",
+                            body,
+                        },
+                    });
+                }
+                const client = new client_1.HubV2Client(ctx);
+                const data = await client.request("POST", client.personalUrl(path), body);
+                return (0, result_1.ok)("hub_v2_docs_publish", data);
+            },
+        },
+    ];
+}
+function extractDocumentContent(payload) {
+    const data = payload.data && typeof payload.data === "object" && !Array.isArray(payload.data)
+        ? payload.data
+        : undefined;
+    if (typeof data?.contentMd === "string") {
+        return data.contentMd;
+    }
+    const item = data?.item && typeof data.item === "object" && !Array.isArray(data.item)
+        ? data.item
+        : undefined;
+    return typeof item?.contentMd === "string" ? item.contentMd : undefined;
+}
+function hasDocumentContent(args) {
+    return Boolean(args.content?.trim() || args.contentMd?.trim());
+}
+function hasDocumentUpdateField(args) {
+    return (args.title !== undefined ||
+        args.content !== undefined ||
+        args.contentMd !== undefined ||
+        args.slug !== undefined ||
+        args.category !== undefined ||
+        args.categoryId !== undefined ||
+        args.summary !== undefined ||
+        args.version !== undefined);
+}

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

@@ -0,0 +1,8 @@
+export declare class HubV2HttpError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    readonly detail?: unknown | undefined;
+    constructor(message: string, status: number, code?: string | undefined, detail?: unknown | undefined);
+}
+export declare function formatHubV2HttpError(status: number, statusText: string, body: unknown): string;
+export declare function toHubV2HttpError(status: number, statusText: string, body: unknown): HubV2HttpError;

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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HubV2HttpError = void 0;
+exports.formatHubV2HttpError = formatHubV2HttpError;
+exports.toHubV2HttpError = toHubV2HttpError;
+class HubV2HttpError extends Error {
+    constructor(message, status, code, detail) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.detail = detail;
+        this.name = "HubV2HttpError";
+    }
+}
+exports.HubV2HttpError = HubV2HttpError;
+function formatHubV2HttpError(status, statusText, body) {
+    const record = body && typeof body === "object" && !Array.isArray(body) ? body : {};
+    const code = typeof record.code === "string" ? record.code : "HTTP_ERROR";
+    const message = typeof record.message === "string" ? record.message : statusText;
+    return `Hub V2 HTTP ${status} ${code}: ${message}`;
+}
+function toHubV2HttpError(status, statusText, body) {
+    const record = body && typeof body === "object" && !Array.isArray(body) ? body : {};
+    const code = typeof record.code === "string" ? record.code : "HTTP_ERROR";
+    const detail = record.detail ?? record.data ?? body;
+    return new HubV2HttpError(formatHubV2HttpError(status, statusText, body), status, code, detail);
+}

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

@@ -0,0 +1,2 @@
+import type { McpToolDefinition } from "../index";
+export declare function hubV2Tools(): McpToolDefinition[];

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

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hubV2Tools = hubV2Tools;
+const docs_tools_1 = require("./docs.tools");
+const issues_tools_1 = require("./issues.tools");
+const issues_workflow_tools_1 = require("./issues-workflow.tools");
+const projects_tools_1 = require("./projects.tools");
+const rd_tools_1 = require("./rd.tools");
+const upload_tools_1 = require("./upload.tools");
+function hubV2Tools() {
+    return [
+        ...(0, projects_tools_1.hubV2ProjectsTools)(),
+        ...(0, docs_tools_1.hubV2DocsTools)(),
+        ...(0, issues_tools_1.hubV2IssuesTools)(),
+        ...(0, issues_workflow_tools_1.hubV2IssueWorkflowTools)(),
+        ...(0, rd_tools_1.hubV2RdTools)(),
+        ...(0, upload_tools_1.hubV2UploadTools)(),
+    ];
+}

package/lib/tools/hub-v2/issues-workflow.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpToolDefinition } from "../index";
+export declare function hubV2IssueWorkflowTools(): McpToolDefinition[];

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.d.ts

@@ -0,0 +1,2 @@
+import type { McpToolDefinition } from "../index";
+export declare function hubV2IssuesTools(): McpToolDefinition[];