@yinuo-ngm/mcp-server 0.1.1 → 0.1.3

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

@@ -0,0 +1,318 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rdUpdateSchema = exports.rdCloseSchema = exports.rdCompleteSchema = exports.rdBlockSchema = exports.rdSimpleWriteSchema = exports.rdUpdateProgressSchema = exports.rdStageTaskCreateSchema = exports.rdStageTasksListSchema = exports.rdAdvanceStageSchema = exports.rdCreateSchema = exports.rdUploadRawSchema = exports.rdReadDetailSchema = exports.rdGetSchema = exports.rdListSchema = exports.fileUploadSchema = exports.markdownImageUploadSchema = exports.issueUpdateSchema = exports.issueParticipantRemoveSchema = exports.issueBranchCompleteSchema = exports.issueBranchActionSchema = exports.issueBranchStartMineSchema = exports.issueBranchCreateSchema = exports.issueParticipantAddSchema = exports.issueCloseSchema = exports.issueReopenSchema = exports.issueResolveSchema = exports.issueSimpleWriteSchema = exports.issueAssignSchema = exports.issueCommentSchema = exports.issueCreateSchema = exports.issueUploadRawSchema = exports.issueAttachmentRawSchema = exports.issueReadDetailSchema = exports.issueGetSchema = exports.issuesListSchema = exports.docsPublishSchema = exports.docsUpdateSchema = exports.docsCreateSchema = exports.docsGetBySlugSchema = exports.docsGetSchema = exports.docsListSchema = exports.pagingSchema = exports.projectMembersListSchema = exports.projectSelectorSchema = void 0;
+const zod_1 = require("zod");
+exports.projectSelectorSchema = zod_1.z.object({
+    project: zod_1.z.string().trim().min(1).optional(),
+    projectKey: zod_1.z.string().trim().min(1).optional(),
+}).strict();
+exports.projectMembersListSchema = exports.projectSelectorSchema;
+exports.pagingSchema = zod_1.z.object({
+    page: zod_1.z.number().int().min(1).optional(),
+    pageSize: zod_1.z.number().int().min(1).max(200).optional(),
+}).strict();
+exports.docsListSchema = exports.projectSelectorSchema.extend({
+    page: zod_1.z.number().int().min(1).optional(),
+    pageSize: zod_1.z.number().int().min(1).max(200).optional(),
+    status: zod_1.z.enum(["draft", "published", "archived"]).optional(),
+    keyword: zod_1.z.string().trim().min(1).optional(),
+    category: zod_1.z.string().trim().min(1).optional(),
+    categoryId: zod_1.z.string().trim().min(1).optional(),
+}).strict();
+exports.docsGetSchema = exports.projectSelectorSchema.extend({
+    docId: zod_1.z.string().trim().min(1),
+}).strict();
+exports.docsGetBySlugSchema = exports.projectSelectorSchema.extend({
+    slug: zod_1.z.string().trim().min(1),
+    contentOnly: zod_1.z.boolean().optional(),
+}).strict();
+exports.docsCreateSchema = exports.projectSelectorSchema.extend({
+    title: zod_1.z.string().trim().min(1).max(120),
+    content: zod_1.z.string().min(1).optional(),
+    contentMd: zod_1.z.string().min(1).optional(),
+    slug: zod_1.z.string().trim().min(1).max(80).optional(),
+    category: zod_1.z.string().trim().max(80).optional(),
+    categoryId: zod_1.z.string().trim().max(80).optional(),
+    summary: zod_1.z.string().trim().max(500).optional(),
+    tags: zod_1.z.array(zod_1.z.string().trim().min(1).max(40)).max(20).optional(),
+    status: zod_1.z.enum(["draft"]).optional(),
+    source: zod_1.z.string().trim().max(40).optional(),
+    version: zod_1.z.string().trim().max(40).optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.docsUpdateSchema = exports.projectSelectorSchema.extend({
+    docId: zod_1.z.string().trim().min(1),
+    title: zod_1.z.string().trim().min(1).max(120).optional(),
+    content: zod_1.z.string().min(1).optional(),
+    contentMd: zod_1.z.string().min(1).optional(),
+    slug: zod_1.z.string().trim().min(1).max(80).optional(),
+    category: zod_1.z.string().trim().max(80).optional(),
+    categoryId: zod_1.z.string().trim().max(80).optional(),
+    summary: zod_1.z.string().trim().max(500).nullable().optional(),
+    tags: zod_1.z.array(zod_1.z.string().trim().min(1).max(40)).max(20).optional(),
+    source: zod_1.z.string().trim().max(40).optional(),
+    version: zod_1.z.string().trim().max(40).nullable().optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.docsPublishSchema = exports.projectSelectorSchema.extend({
+    docId: zod_1.z.string().trim().min(1),
+    source: zod_1.z.string().trim().max(40).optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.issuesListSchema = exports.projectSelectorSchema.extend({
+    page: zod_1.z.number().int().min(1).optional(),
+    pageSize: zod_1.z.number().int().min(1).max(200).optional(),
+    keyword: zod_1.z.string().trim().min(1).optional(),
+    status: zod_1.z.array(zod_1.z.string().trim().min(1)).optional(),
+    priority: zod_1.z.array(zod_1.z.string().trim().min(1)).optional(),
+    assigneeId: zod_1.z.string().trim().min(1).optional(),
+    verifierId: zod_1.z.string().trim().min(1).optional(),
+    rdItemId: zod_1.z.string().trim().min(1).optional(),
+}).strict();
+exports.issueGetSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+}).strict();
+exports.issueReadDetailSchema = exports.issueGetSchema;
+exports.issueAttachmentRawSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+    attachmentId: zod_1.z.string().trim().min(1),
+    maxBytes: zod_1.z.number().int().min(1).max(5 * 1024 * 1024).optional(),
+}).strict();
+exports.issueUploadRawSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+    uploadId: zod_1.z.string().trim().min(1),
+    maxBytes: zod_1.z.number().int().min(1).max(5 * 1024 * 1024).optional(),
+}).strict();
+const issueTypeSchema = zod_1.z.enum(["bug", "feature", "change", "improvement", "task", "test"]);
+const issuePrioritySchema = zod_1.z.enum(["low", "medium", "high", "critical"]);
+exports.issueCreateSchema = exports.projectSelectorSchema.extend({
+    title: zod_1.z.string().trim().min(1),
+    description: zod_1.z.string().optional(),
+    type: issueTypeSchema.optional(),
+    priority: issuePrioritySchema.optional(),
+    assigneeId: zod_1.z.string().trim().nullable().optional(),
+    verifierId: zod_1.z.string().trim().nullable().optional(),
+    rdItemId: zod_1.z.string().trim().nullable().optional(),
+    moduleCode: zod_1.z.string().trim().optional(),
+    versionCode: zod_1.z.string().trim().optional(),
+    environmentCode: zod_1.z.string().trim().optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.issueCommentSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+    content: zod_1.z.string().min(1),
+    mentions: zod_1.z.array(zod_1.z.string().trim().min(1)).optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.issueAssignSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+    assigneeId: zod_1.z.string().trim().min(1),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.issueSimpleWriteSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.issueResolveSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+    resolutionSummary: zod_1.z.string().optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.issueReopenSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+    remark: zod_1.z.string().optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.issueCloseSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+    reason: zod_1.z.string().trim().optional(),
+    remark: zod_1.z.string().optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.issueParticipantAddSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+    userId: zod_1.z.string().trim().min(1),
+    taskTitle: zod_1.z.string().trim().max(80).optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.issueBranchCreateSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+    ownerUserId: zod_1.z.string().trim().min(1),
+    title: zod_1.z.string().trim().min(1).max(80),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.issueBranchStartMineSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+    title: zod_1.z.string().trim().min(1).max(80),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.issueBranchActionSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+    branchId: zod_1.z.string().trim().min(1),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.issueBranchCompleteSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+    branchId: zod_1.z.string().trim().min(1),
+    summary: zod_1.z.string().trim().max(500).optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.issueParticipantRemoveSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+    participantId: zod_1.z.string().trim().min(1),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.issueUpdateSchema = exports.projectSelectorSchema.extend({
+    issueId: zod_1.z.string().trim().min(1),
+    title: zod_1.z.string().trim().optional(),
+    description: zod_1.z.string().nullable().optional(),
+    type: issueTypeSchema.optional(),
+    priority: issuePrioritySchema.optional(),
+    rdItemId: zod_1.z.string().trim().nullable().optional(),
+    moduleCode: zod_1.z.string().trim().nullable().optional(),
+    versionCode: zod_1.z.string().trim().nullable().optional(),
+    environmentCode: zod_1.z.string().trim().nullable().optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.markdownImageUploadSchema = exports.projectSelectorSchema.extend({
+    filePath: zod_1.z.string().trim().min(1).optional(),
+    contentBase64: zod_1.z.string().trim().min(1).optional(),
+    fileName: zod_1.z.string().trim().min(1).optional(),
+    mimeType: zod_1.z.string().trim().min(1).optional(),
+    alt: zod_1.z.string().trim().min(1).optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.fileUploadSchema = exports.projectSelectorSchema.extend({
+    target: zod_1.z.enum(["issueAttachment", "taskSheetAttachment"]),
+    filePath: zod_1.z.string().trim().min(1).optional(),
+    contentBase64: zod_1.z.string().trim().min(1).optional(),
+    fileName: zod_1.z.string().trim().min(1).optional(),
+    mimeType: zod_1.z.string().trim().min(1).optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.rdListSchema = exports.projectSelectorSchema.extend({
+    page: zod_1.z.number().int().min(1).optional(),
+    pageSize: zod_1.z.number().int().min(1).max(200).optional(),
+    keyword: zod_1.z.string().trim().min(1).optional(),
+    stageId: zod_1.z.string().trim().min(1).optional(),
+    status: zod_1.z.array(zod_1.z.string().trim().min(1)).optional(),
+    type: zod_1.z.array(zod_1.z.string().trim().min(1)).optional(),
+    priority: zod_1.z.array(zod_1.z.string().trim().min(1)).optional(),
+    assigneeId: zod_1.z.string().trim().min(1).optional(),
+}).strict();
+exports.rdGetSchema = exports.projectSelectorSchema.extend({
+    itemId: zod_1.z.string().trim().min(1),
+}).strict();
+exports.rdReadDetailSchema = exports.rdGetSchema;
+exports.rdUploadRawSchema = exports.projectSelectorSchema.extend({
+    itemId: zod_1.z.string().trim().min(1),
+    uploadId: zod_1.z.string().trim().min(1),
+    maxBytes: zod_1.z.number().int().min(1).max(5 * 1024 * 1024).optional(),
+}).strict();
+const rdTypeSchema = zod_1.z.enum([
+    "feature_dev",
+    "tech_refactor",
+    "integration",
+    "env_setup",
+    "bug_fix",
+    "requirement_confirmation",
+    "solution_design",
+    "testing_validation",
+    "delivery_launch",
+    "project_closure",
+]);
+const rdPrioritySchema = zod_1.z.enum(["low", "medium", "high", "critical"]);
+const rdInitialStageTaskSchema = zod_1.z.object({
+    templateId: zod_1.z.string().trim().min(1).nullable().optional(),
+    title: zod_1.z.string().trim().min(1),
+    description: zod_1.z.string().trim().nullable().optional(),
+    ownerId: zod_1.z.string().trim().nullable().optional(),
+    plannedStartAt: zod_1.z.string().trim().nullable().optional(),
+    plannedEndAt: zod_1.z.string().trim().nullable().optional(),
+}).strict();
+const rdStageTaskTemplateSelectionSchema = zod_1.z.object({
+    templateId: zod_1.z.string().trim().min(1),
+    ownerId: zod_1.z.string().trim().nullable().optional(),
+}).strict();
+exports.rdCreateSchema = exports.projectSelectorSchema.extend({
+    title: zod_1.z.string().trim().min(1),
+    description: zod_1.z.string().optional(),
+    stageId: zod_1.z.string().trim().nullable().optional(),
+    type: rdTypeSchema.optional(),
+    priority: rdPrioritySchema.optional(),
+    memberIds: zod_1.z.array(zod_1.z.string().trim().min(1)).min(1),
+    verifierId: zod_1.z.string().trim().nullable().optional(),
+    planStartAt: zod_1.z.string().trim().optional(),
+    planEndAt: zod_1.z.string().trim().optional(),
+    stageTasks: zod_1.z.array(rdInitialStageTaskSchema).optional(),
+    stageTaskTemplates: zod_1.z.array(rdStageTaskTemplateSelectionSchema).optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.rdAdvanceStageSchema = exports.projectSelectorSchema.extend({
+    itemId: zod_1.z.string().trim().min(1),
+    stageId: zod_1.z.string().trim().min(1),
+    memberIds: zod_1.z.array(zod_1.z.string().trim().min(1)).optional(),
+    description: zod_1.z.string().trim().min(1).optional(),
+    planStartAt: zod_1.z.string().trim().min(1).optional(),
+    planEndAt: zod_1.z.string().trim().min(1).optional(),
+    stageTasks: zod_1.z.array(rdInitialStageTaskSchema).optional(),
+    stageTaskTemplates: zod_1.z.array(rdStageTaskTemplateSelectionSchema).optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.rdStageTasksListSchema = exports.projectSelectorSchema.extend({
+    itemId: zod_1.z.string().trim().min(1),
+}).strict();
+exports.rdStageTaskCreateSchema = exports.projectSelectorSchema.extend({
+    itemId: zod_1.z.string().trim().min(1),
+    title: zod_1.z.string().trim().min(1).max(200),
+    description: zod_1.z.string().trim().max(2000).nullable().optional(),
+    ownerIds: zod_1.z.array(zod_1.z.string().trim().min(1)).min(1),
+    plannedStartAt: zod_1.z.string().trim().nullable().optional(),
+    plannedEndAt: zod_1.z.string().trim().nullable().optional(),
+    sortOrder: zod_1.z.number().int().optional(),
+    remark: zod_1.z.string().trim().max(1000).nullable().optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.rdUpdateProgressSchema = exports.projectSelectorSchema.extend({
+    itemId: zod_1.z.string().trim().min(1),
+    progress: zod_1.z.number().int().min(0).max(100),
+    note: zod_1.z.string().trim().optional(),
+    blockReason: zod_1.z.string().trim().min(1).max(500).optional(),
+    resolveBlockId: zod_1.z.string().trim().min(1).optional(),
+    stageTaskId: zod_1.z.string().trim().min(1).optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.rdSimpleWriteSchema = exports.projectSelectorSchema.extend({
+    itemId: zod_1.z.string().trim().min(1),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.rdBlockSchema = exports.projectSelectorSchema.extend({
+    itemId: zod_1.z.string().trim().min(1),
+    blockerReason: zod_1.z.string().optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.rdCompleteSchema = exports.projectSelectorSchema.extend({
+    itemId: zod_1.z.string().trim().min(1),
+    reason: zod_1.z.string().trim().max(1000).optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.rdCloseSchema = exports.projectSelectorSchema.extend({
+    itemId: zod_1.z.string().trim().min(1),
+    reason: zod_1.z.string().trim().optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();
+exports.rdUpdateSchema = exports.projectSelectorSchema.extend({
+    itemId: zod_1.z.string().trim().min(1),
+    version: zod_1.z.number().int().min(1),
+    title: zod_1.z.string().trim().optional(),
+    description: zod_1.z.string().nullable().optional(),
+    stageId: zod_1.z.string().trim().nullable().optional(),
+    type: rdTypeSchema.optional(),
+    priority: rdPrioritySchema.optional(),
+    memberIds: zod_1.z.array(zod_1.z.string().trim().min(1)).min(1).optional(),
+    verifierId: zod_1.z.string().trim().nullable().optional(),
+    planStartAt: zod_1.z.string().trim().nullable().optional(),
+    planEndAt: zod_1.z.string().trim().nullable().optional(),
+    stageDescription: zod_1.z.string().trim().max(4000).nullable().optional(),
+    confirm: zod_1.z.boolean().optional(),
+}).strict();

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

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

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

@@ -0,0 +1,198 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hubV2UploadTools = hubV2UploadTools;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const client_1 = require("./client");
+const index_1 = require("./config/index");
+const schemas_1 = require("./schemas");
+const result_1 = require("../../utils/result");
+function hubV2UploadTools() {
+    return [
+        {
+            name: "hub_v2_upload_markdown_image",
+            description: "Upload a local or base64 image with Personal Token and return Markdown for Hub V2 content.",
+            riskLevel: "write",
+            inputSchema: schemas_1.markdownImageUploadSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const path = "/uploads/markdown";
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_upload_markdown_image", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to upload this image",
+                        data: {
+                            method: "POST",
+                            path,
+                            requiredScope: "issue:create:write or issue:update:write or issue:comment:write or rd:create:write or rd:stage-task:write or rd:transition:write or rd:edit:write",
+                            maxBytes: maxUploadBytes(),
+                            input: {
+                                mode: args.filePath ? "filePath" : "contentBase64",
+                                fileName: args.fileName,
+                                mimeType: args.mimeType,
+                                alt: args.alt,
+                                hasFilePath: Boolean(args.filePath),
+                                hasContentBase64: Boolean(args.contentBase64),
+                            },
+                        },
+                    });
+                }
+                const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const file = resolveUploadFile(args);
+                const form = new FormData();
+                const bytes = new Uint8Array(file.content.byteLength);
+                bytes.set(file.content);
+                form.append("file", new Blob([bytes], { type: file.mimeType }), file.fileName);
+                if (args.alt) {
+                    form.append("alt", args.alt);
+                }
+                const data = await client.multipart("POST", client.personalUrl("/uploads/markdown"), form);
+                return (0, result_1.ok)("hub_v2_upload_markdown_image", data);
+            },
+        },
+        {
+            name: "hub_v2_file_upload",
+            description: "Upload a local or base64 file with Personal Token and return a Hub V2 uploadId.",
+            riskLevel: "write",
+            inputSchema: schemas_1.fileUploadSchema,
+            allowPreviewWhenBlocked: true,
+            isConfirmed: (args) => args.confirm === true,
+            async handler(args) {
+                const uploadPath = "/uploads/file";
+                if (!args.confirm) {
+                    return (0, result_1.ok)("hub_v2_file_upload", {
+                        code: "PREVIEW",
+                        message: "set confirm=true to upload this file",
+                        data: {
+                            method: "POST",
+                            path: uploadPath,
+                            requiredScope: fileUploadRequiredScope(args.target),
+                            maxBytes: maxUploadBytes(),
+                            input: {
+                                target: args.target,
+                                mode: args.filePath ? "filePath" : "contentBase64",
+                                fileName: args.fileName,
+                                mimeType: args.mimeType,
+                                hasFilePath: Boolean(args.filePath),
+                                hasContentBase64: Boolean(args.contentBase64),
+                            },
+                        },
+                    });
+                }
+                const ctx = (0, index_1.resolveHubV2Context)(args, "personal");
+                const client = new client_1.HubV2Client(ctx);
+                const file = resolveUploadFile(args);
+                const form = new FormData();
+                const bytes = new Uint8Array(file.content.byteLength);
+                bytes.set(file.content);
+                form.append("file", new Blob([bytes], { type: file.mimeType }), file.fileName);
+                form.append("target", args.target);
+                const data = await client.multipart("POST", client.personalUrl(uploadPath), form);
+                return (0, result_1.ok)("hub_v2_file_upload", data);
+            },
+        },
+    ];
+}
+function fileUploadRequiredScope(target) {
+    switch (target) {
+        case "issueAttachment":
+            return "issue:update:write";
+        case "taskSheetAttachment":
+            return "rd:stage-task:write or rd:edit:write";
+    }
+}
+function resolveUploadFile(args) {
+    if (Boolean(args.filePath) === Boolean(args.contentBase64)) {
+        throw new Error("provide exactly one of filePath or contentBase64");
+    }
+    if (args.filePath) {
+        const resolvedPath = node_path_1.default.resolve(args.filePath);
+        assertAllowedFilePath(resolvedPath);
+        if (!(0, node_fs_1.existsSync)(resolvedPath) || !(0, node_fs_1.statSync)(resolvedPath).isFile()) {
+            throw new Error(`upload file not found: ${resolvedPath}`);
+        }
+        const fileSize = (0, node_fs_1.statSync)(resolvedPath).size;
+        assertUploadSize(fileSize);
+        return {
+            content: (0, node_fs_1.readFileSync)(resolvedPath),
+            fileName: node_path_1.default.basename(resolvedPath),
+            mimeType: args.mimeType ?? inferMimeType(resolvedPath),
+        };
+    }
+    const fileName = args.fileName?.trim();
+    if (!args.contentBase64 || !fileName) {
+        throw new Error("contentBase64 and fileName are required");
+    }
+    const content = decodeBase64Content(args.contentBase64);
+    return {
+        content,
+        fileName,
+        mimeType: args.mimeType ?? inferMimeType(fileName),
+    };
+}
+function maxUploadBytes() {
+    const value = Number.parseInt(String(process.env.NGM_MCP_MAX_UPLOAD_BYTES ?? ""), 10);
+    return Number.isFinite(value) && value > 0 ? value : 5 * 1024 * 1024;
+}
+function assertUploadSize(fileSize) {
+    const maxBytes = maxUploadBytes();
+    if (fileSize > maxBytes) {
+        throw new Error(`upload file is too large: ${fileSize} bytes exceeds NGM_MCP_MAX_UPLOAD_BYTES=${maxBytes}`);
+    }
+}
+function decodeBase64Content(value) {
+    const normalized = value.trim().replace(/^data:[^,]+,/, "").replace(/\s+/g, "");
+    if (!normalized) {
+        throw new Error("contentBase64 is empty");
+    }
+    if (!/^[A-Za-z0-9+/]*={0,2}$/.test(normalized) || normalized.length % 4 !== 0) {
+        throw new Error("contentBase64 is not a valid base64 string");
+    }
+    const firstPaddingIndex = normalized.indexOf("=");
+    if (firstPaddingIndex !== -1 && !/^={1,2}$/.test(normalized.slice(firstPaddingIndex))) {
+        throw new Error("contentBase64 is not a valid base64 string");
+    }
+    const content = Buffer.from(normalized, "base64");
+    if (content.byteLength === 0) {
+        throw new Error("contentBase64 is empty");
+    }
+    assertUploadSize(content.byteLength);
+    return content;
+}
+function assertAllowedFilePath(filePath) {
+    const roots = [
+        process.env.NGM_MCP_UPLOAD_ROOT,
+        process.cwd(),
+    ]
+        .map((item) => item?.trim())
+        .filter((item) => Boolean(item))
+        .map((item) => node_path_1.default.resolve(item));
+    const allowed = roots.some((root) => filePath === root || filePath.startsWith(`${root}${node_path_1.default.sep}`));
+    if (!allowed) {
+        throw new Error("filePath must be under NGM_MCP_UPLOAD_ROOT or the current working directory");
+    }
+}
+function inferMimeType(fileName) {
+    switch (node_path_1.default.extname(fileName).toLowerCase()) {
+        case ".png":
+            return "image/png";
+        case ".jpg":
+        case ".jpeg":
+            return "image/jpeg";
+        case ".gif":
+            return "image/gif";
+        case ".webp":
+            return "image/webp";
+        case ".bmp":
+            return "image/bmp";
+        case ".svg":
+            return "image/svg+xml";
+        default:
+            return "application/octet-stream";
+    }
+}

package/lib/tools/index.d.ts

@@ -7,6 +7,9 @@ export type McpToolDefinition<TSchema extends z.AnyZodObject = z.AnyZodObject> =
     description: string;
     riskLevel: ToolRiskLevel;
     inputSchema: TSchema;
+    allowPreviewWhenBlocked?: boolean;
+    deferPolicyToHandler?: boolean;
+    isConfirmed?: (args: z.infer<TSchema>) => boolean;
     handler(args: z.infer<TSchema>, context: ToolContext): Promise<ToolResult> | ToolResult;
 };
 export declare function allTools(): McpToolDefinition[];

package/lib/tools/index.js

@@ -1,19 +1,43 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.allTools = allTools;
+const capability_tools_1 = require("./capability.tools");
+const angular_1 = require("./angular");
+const controlled_tools_1 = require("./controlled.tools");
+const file_write_tools_1 = require("./file-write.tools");
 const git_tools_1 = require("./git.tools");
+const hub_v2_1 = require("./hub-v2");
 const log_tools_1 = require("./log.tools");
+const nginx_tools_1 = require("./nginx.tools");
+const project_observe_tools_1 = require("./project-observe.tools");
 const project_tools_1 = require("./project.tools");
 const proxy_tools_1 = require("./proxy.tools");
 const runtime_tools_1 = require("./runtime.tools");
+const review_1 = require("./review");
+const standard_1 = require("./standard");
 const task_tools_1 = require("./task.tools");
+const test_1 = require("./test");
+const workspace_tools_1 = require("./workspace.tools");
+const workflow_1 = require("./workflow");
 function allTools() {
     return [
+        ...(0, capability_tools_1.capabilityTools)(),
+        ...(0, workspace_tools_1.workspaceTools)(),
+        ...(0, controlled_tools_1.controlledTools)(),
+        ...(0, file_write_tools_1.fileWriteTools)(),
         ...(0, project_tools_1.projectTools)(),
+        ...(0, project_observe_tools_1.projectObserveTools)(),
         ...(0, task_tools_1.taskTools)(),
         ...(0, log_tools_1.logTools)(),
         ...(0, git_tools_1.gitTools)(),
+        ...(0, standard_1.standardTools)(),
+        ...(0, test_1.testStandardTools)(),
+        ...(0, angular_1.angularStandardTools)(),
+        ...(0, review_1.reviewTools)(),
+        ...(0, workflow_1.frontendWorkflowTools)(),
         ...(0, runtime_tools_1.runtimeTools)(),
+        ...(0, nginx_tools_1.nginxTools)(),
         ...(0, proxy_tools_1.proxyTools)(),
+        ...(0, hub_v2_1.hubV2Tools)(),
     ];
 }

package/lib/tools/log.tools.js

@@ -23,22 +23,49 @@ function clampSearchLimit(value) {
 function logTools() {
     return [
         {
-            name: "ngm.log.tail",
+            name: "ngm_log_tail",
             description: "Read recent task logs by runId or taskId.",
             riskLevel: "read",
             inputSchema: logTailSchema,
             async handler(args, context) {
                 const tail = clampTail(args.tail);
                 let runId = args.runId;
+                const localServer = context.services.localServer;
+                const availability = localServer ? await localServer.availability() : { available: false, reason: "local server client is not configured" };
                 if (!runId && args.taskId) {
-                    const snapshot = await context.services.core.task.getSnapshotByTaskId(args.taskId);
+                    if (!availability.available || !localServer) {
+                        return (0, result_1.ok)("ngm_log_tail", {
+                            controlPlane: "unavailable",
+                            localServer: availability,
+                            status: "unavailable",
+                            reason: "ng-manager local server is not running; start it with ngm server or ngm ui to read shared task logs",
+                            taskId: args.taskId,
+                            tail,
+                            lines: [],
+                        });
+                    }
+                    const snapshot = await localServer.getTaskStatus(args.taskId);
                     runId = snapshot?.runId;
                 }
                 if (!runId) {
                     throw new Error("runId or taskId is required");
                 }
-                const lines = await context.services.core.task.getTailLogsByRun(runId, tail);
-                return (0, result_1.ok)("ngm.log.tail", {
+                if (!availability.available || !localServer) {
+                    return (0, result_1.ok)("ngm_log_tail", {
+                        controlPlane: "unavailable",
+                        localServer: availability,
+                        status: "unavailable",
+                        reason: "ng-manager local server is not running; start it with ngm server or ngm ui to read shared task logs",
+                        runId,
+                        tail,
+                        lines: [],
+                    });
+                }
+                const controlPlane = "local-server";
+                const lines = await localServer.getTaskLogTail(runId, tail);
+                return (0, result_1.ok)("ngm_log_tail", {
+                    controlPlane,
+                    localServer: availability,
                     runId,
                     tail,
                     lines,
@@ -46,7 +73,7 @@ function logTools() {
             },
         },
         {
-            name: "ngm.log.search",
+            name: "ngm_log_search",
             description: "Search recent ng-manager system logs by keyword.",
             riskLevel: "read",
             inputSchema: logSearchSchema,
@@ -64,7 +91,7 @@ function logTools() {
                     return text.includes(needle);
                 })
                     .slice(0, limit);
-                return (0, result_1.ok)("ngm.log.search", {
+                return (0, result_1.ok)("ngm_log_search", {
                     query: args.query,
                     limit,
                     entries,

package/lib/tools/nginx/index.d.ts

@@ -0,0 +1 @@
+export { nginxControlTools } from "./nginx-control.tools";

package/lib/tools/nginx/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nginxControlTools = void 0;
+var nginx_control_tools_1 = require("./nginx-control.tools");
+Object.defineProperty(exports, "nginxControlTools", { enumerable: true, get: function () { return nginx_control_tools_1.nginxControlTools; } });

package/lib/tools/nginx/nginx-control.tools.d.ts

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