gitlab-mcp 1.2.1 → 1.3.0

package/dist/tools/gitlab.js

@@ -12,6 +12,13 @@ const optionalNumberArray = z.preprocess((value) => (value === null ? undefined
 const optionalStringOrNumber = z.preprocess((value) => (value === null ? undefined : value), z.union([z.string(), z.number()]).optional());
 const optionalStringOrStringArray = z.preprocess((value) => (value === null ? undefined : value), z.union([z.string(), z.array(z.string())]).optional());
 const optionalRecord = z.preprocess((value) => (value === null ? undefined : value), z.record(z.string(), z.unknown()).optional());
+const pipelineInputValueSchema = z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.array(z.union([z.string(), z.number(), z.boolean()]))
+]);
+const optionalPipelineInputsRecord = z.preprocess((value) => (value === null ? undefined : value), z.record(z.string(), pipelineInputValueSchema).optional());
 const paginationShape = {
     page: optionalNumber,
     per_page: optionalNumber
@@ -29,6 +36,9 @@ export function registerGitLabTools(server, context) {
         if (!enabledNames.has(definition.name)) {
             continue;
         }
+        if (definition.requiresLocalFileTools && !context.allowLocalFileTools) {
+            continue;
+        }
         if (disableGraphqlTools && isGraphqlToolName(definition.name)) {
             continue;
         }
@@ -526,7 +536,7 @@ function getGitLabToolDefinitions() {
             },
             handler: async (args, context) => {
                 const projectId = resolveProjectId(args, context, false);
-                const query = toQuery(omit(args, ["project_id"]));
+                const query = toQuery(cleanMergeRequestListArgs(omit(args, ["project_id"])));
                 if (projectId) {
                     return context.gitlab.listMergeRequests(projectId, { query });
                 }
@@ -816,6 +826,17 @@ function getGitLabToolDefinitions() {
             },
             handler: async (args, context) => context.gitlab.getMergeRequestApprovalState(resolveProjectId(args, context, true), getString(args, "merge_request_iid"))
         },
+        {
+            name: "gitlab_get_merge_request_conflicts",
+            title: "Get Merge Request Conflicts",
+            description: "Get conflict details for MR.",
+            mutating: false,
+            inputSchema: {
+                project_id: z.string().optional(),
+                merge_request_iid: z.string().min(1)
+            },
+            handler: async (args, context) => context.gitlab.getMergeRequestConflicts(resolveProjectId(args, context, true), getString(args, "merge_request_iid"))
+        },
         {
             name: "gitlab_list_merge_request_discussions",
             title: "List Merge Request Discussions",
@@ -1501,6 +1522,71 @@ function getGitLabToolDefinitions() {
             },
             handler: async (args, context) => context.gitlab.getPipeline(resolveProjectId(args, context, true), getString(args, "pipeline_id"))
         },
+        {
+            name: "gitlab_list_deployments",
+            title: "List Deployments",
+            description: "List deployments in a project.",
+            mutating: false,
+            requiresFeature: "pipeline",
+            inputSchema: {
+                project_id: z.string().optional(),
+                environment: optionalString,
+                ref: optionalString,
+                sha: optionalString,
+                status: optionalString,
+                updated_after: optionalString,
+                updated_before: optionalString,
+                order_by: z
+                    .enum(["id", "iid", "created_at", "updated_at", "ref", "status", "environment"])
+                    .optional(),
+                sort: z.enum(["asc", "desc"]).optional(),
+                ...paginationShape
+            },
+            handler: async (args, context) => context.gitlab.listDeployments(resolveProjectId(args, context, true), {
+                query: toQuery(omit(args, ["project_id"]))
+            })
+        },
+        {
+            name: "gitlab_get_deployment",
+            title: "Get Deployment",
+            description: "Get one deployment by ID.",
+            mutating: false,
+            requiresFeature: "pipeline",
+            inputSchema: {
+                project_id: z.string().optional(),
+                deployment_id: z.string().min(1)
+            },
+            handler: async (args, context) => context.gitlab.getDeployment(resolveProjectId(args, context, true), getString(args, "deployment_id"))
+        },
+        {
+            name: "gitlab_list_environments",
+            title: "List Environments",
+            description: "List environments in a project.",
+            mutating: false,
+            requiresFeature: "pipeline",
+            inputSchema: {
+                project_id: z.string().optional(),
+                name: optionalString,
+                search: optionalString,
+                states: z.enum(["available", "stopped"]).optional(),
+                ...paginationShape
+            },
+            handler: async (args, context) => context.gitlab.listEnvironments(resolveProjectId(args, context, true), {
+                query: toQuery(omit(args, ["project_id"]))
+            })
+        },
+        {
+            name: "gitlab_get_environment",
+            title: "Get Environment",
+            description: "Get one environment by ID.",
+            mutating: false,
+            requiresFeature: "pipeline",
+            inputSchema: {
+                project_id: z.string().optional(),
+                environment_id: z.string().min(1)
+            },
+            handler: async (args, context) => context.gitlab.getEnvironment(resolveProjectId(args, context, true), getString(args, "environment_id"))
+        },
         {
             name: "gitlab_list_pipeline_jobs",
             title: "List Pipeline Jobs",
@@ -1580,6 +1666,74 @@ function getGitLabToolDefinitions() {
             },
             handler: async (args, context) => context.gitlab.getPipelineJobOutput(resolveProjectId(args, context, true), getString(args, "job_id"))
         },
+        {
+            name: "gitlab_list_job_artifacts",
+            title: "List Job Artifacts",
+            description: "List files and directories inside a job artifacts archive.",
+            mutating: false,
+            requiresFeature: "pipeline",
+            inputSchema: {
+                project_id: z.string().optional(),
+                job_id: z.string().min(1),
+                path: optionalString,
+                recursive: optionalBoolean
+            },
+            handler: async (args, context) => context.gitlab.listJobArtifacts(resolveProjectId(args, context, true), getString(args, "job_id"), { query: toQuery(omit(args, ["project_id", "job_id"])) })
+        },
+        {
+            name: "gitlab_download_job_artifacts",
+            title: "Download Job Artifacts",
+            description: "Download the full job artifacts archive as base64 content.",
+            mutating: false,
+            requiresFeature: "pipeline",
+            inputSchema: {
+                project_id: z.string().optional(),
+                job_id: z.string().min(1)
+            },
+            handler: async (args, context) => context.gitlab.downloadJobArtifacts(resolveProjectId(args, context, true), getString(args, "job_id"))
+        },
+        {
+            name: "gitlab_download_job_artifacts_local",
+            title: "Download Job Artifacts Local",
+            description: "Download the full job artifacts archive to a local directory.",
+            mutating: true,
+            requiresFeature: "pipeline",
+            requiresLocalFileTools: true,
+            inputSchema: {
+                project_id: z.string().optional(),
+                job_id: z.string().min(1),
+                local_path: optionalString
+            },
+            handler: async (args, context) => context.gitlab.saveJobArtifacts(resolveProjectId(args, context, true), getString(args, "job_id"), getOptionalString(args, "local_path"))
+        },
+        {
+            name: "gitlab_get_job_artifact_file",
+            title: "Get Job Artifact File",
+            description: "Return one file from a job artifacts archive as inline UTF-8 or base64 content.",
+            mutating: false,
+            requiresFeature: "pipeline",
+            inputSchema: {
+                project_id: z.string().optional(),
+                job_id: z.string().min(1),
+                artifact_path: z.string().min(1)
+            },
+            handler: async (args, context) => context.gitlab.getJobArtifactFile(resolveProjectId(args, context, true), getString(args, "job_id"), getString(args, "artifact_path"))
+        },
+        {
+            name: "gitlab_get_job_artifact_file_local",
+            title: "Get Job Artifact File Local",
+            description: "Save one file from a job artifacts archive to a local directory.",
+            mutating: true,
+            requiresFeature: "pipeline",
+            requiresLocalFileTools: true,
+            inputSchema: {
+                project_id: z.string().optional(),
+                job_id: z.string().min(1),
+                artifact_path: z.string().min(1),
+                local_path: optionalString
+            },
+            handler: async (args, context) => context.gitlab.saveJobArtifactFile(resolveProjectId(args, context, true), getString(args, "job_id"), getString(args, "artifact_path"), getOptionalString(args, "local_path"))
+        },
         {
             name: "gitlab_create_pipeline",
             title: "Create Pipeline",
@@ -1589,6 +1743,7 @@ function getGitLabToolDefinitions() {
             inputSchema: {
                 project_id: z.string().optional(),
                 ref: z.string().min(1),
+                inputs: optionalPipelineInputsRecord,
                 variables: z
                     .array(z.object({
                     key: z.string(),
@@ -1599,7 +1754,8 @@ function getGitLabToolDefinitions() {
             },
             handler: async (args, context) => context.gitlab.createPipeline(resolveProjectId(args, context, true), {
                 ref: getString(args, "ref"),
-                variables: getArray(args, "variables")
+                inputs: getOptionalPipelineInputsRecord(args, "inputs"),
+                variables: getOptionalArray(args, "variables")
             })
         },
         {
@@ -2516,8 +2672,11 @@ function getOptionalNumber(args, key) {
     }
     return value;
 }
-function getArray(args, key) {
+function getOptionalArray(args, key) {
     const value = args[key];
+    if (value === undefined) {
+        return undefined;
+    }
     if (!Array.isArray(value)) {
         throw new Error(`'${key}' must be array`);
     }
@@ -2543,6 +2702,37 @@ function getOptionalRecord(args, key) {
     }
     return value;
 }
+function getOptionalPipelineInputsRecord(args, key) {
+    const value = getOptionalRecord(args, key);
+    if (!value) {
+        return undefined;
+    }
+    for (const [entryKey, entryValue] of Object.entries(value)) {
+        if (!pipelineInputValueSchema.safeParse(entryValue).success) {
+            throw new Error(`'${key}.${entryKey}' must be a string, number, boolean, or array of primitive values`);
+        }
+    }
+    return value;
+}
+function cleanMergeRequestListArgs(args) {
+    const cleanedArgs = { ...args };
+    if (hasValue(cleanedArgs.author_username)) {
+        delete cleanedArgs.author_id;
+    }
+    if (hasValue(cleanedArgs.assignee_username)) {
+        delete cleanedArgs.assignee_id;
+    }
+    if (hasValue(cleanedArgs.reviewer_username)) {
+        delete cleanedArgs.reviewer_id;
+    }
+    return cleanedArgs;
+}
+function hasValue(value) {
+    if (typeof value === "string") {
+        return value.length > 0;
+    }
+    return value !== undefined && value !== null;
+}
 function requireArrayValue(items, index, errorMessage) {
     const value = items[index];
     if (value === undefined) {