@zereight/mcp-gitlab 2.0.28 → 2.0.32

package/build/schemas.js

@@ -62,6 +62,8 @@ export const GitLabPipelineJobSchema = z.object({
     started_at: z.string().nullable().optional(),
     finished_at: z.string().nullable().optional(),
     duration: z.number().nullable().optional(),
+    queued_duration: z.number().nullable().optional(),
+    failure_reason: z.string().nullable().optional(),
     user: z
         .object({
         id: z.coerce.string(),
@@ -89,6 +91,19 @@ export const GitLabPipelineJobSchema = z.object({
     })
         .optional(),
     web_url: z.string().optional(),
+    allow_failure: z.boolean().optional(),
+    retried: z.boolean().optional(),
+    tag_list: z.array(z.string()).optional(),
+    runner: z
+        .object({
+        id: z.coerce.string().optional(),
+        description: z.string().nullable().optional(),
+        active: z.boolean().optional(),
+        is_shared: z.boolean().optional(),
+        runner_type: z.string().optional(),
+    })
+        .nullable()
+        .optional(),
 });
 // Pipeline trigger job (bridge) schema
 export const GitLabPipelineTriggerJobSchema = z.object({
@@ -188,9 +203,7 @@ export const ListPipelinesSchema = z
         .describe("The status of pipelines"),
     ref: z.string().optional().describe("The ref of pipelines"),
     sha: z.string().optional().describe("The SHA of pipelines"),
-    yaml_errors: z.boolean()
-        .optional()
-        .describe("Returns pipelines with invalid configurations"),
+    yaml_errors: z.boolean().optional().describe("Returns pipelines with invalid configurations"),
     username: z.string().optional().describe("The username of the user who triggered pipelines"),
     updated_after: z
         .string()
@@ -249,6 +262,126 @@ export const ListPipelineTriggerJobsSchema = z
         .describe("The scope of trigger jobs to show"),
 })
     .merge(PaginationOptionsSchema);
+// Deployment related schemas
+export const GitLabDeploymentSchema = z.object({
+    id: z.coerce.string(),
+    iid: z.coerce.string().optional(),
+    status: z.string(),
+    ref: z.string().optional(),
+    sha: z.string(),
+    created_at: z.string(),
+    updated_at: z.string().optional(),
+    finished_at: z.string().nullable().optional(),
+    environment: z
+        .object({
+        id: z.coerce.string().optional(),
+        name: z.string(),
+        slug: z.string().optional(),
+        external_url: z.string().nullable().optional(),
+        state: z.string().optional(),
+        tier: z.string().optional(),
+    })
+        .optional(),
+    deployable: z
+        .object({
+        id: z.coerce.string().optional(),
+        name: z.string().optional(),
+        status: z.string().optional(),
+        stage: z.string().optional(),
+        web_url: z.string().optional(),
+        pipeline: z
+            .object({
+            id: z.coerce.string().optional(),
+            status: z.string().optional(),
+            ref: z.string().optional(),
+            sha: z.string().optional(),
+            web_url: z.string().optional(),
+        })
+            .optional(),
+    })
+        .nullable()
+        .optional(),
+    user: z
+        .object({
+        id: z.coerce.string().optional(),
+        username: z.string().optional(),
+        name: z.string().optional(),
+        avatar_url: z.string().nullable().optional(),
+    })
+        .optional(),
+    web_url: z.string().optional(),
+});
+export const ListDeploymentsSchema = z
+    .object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    environment: z.string().optional().describe("Filter by environment name"),
+    ref: z.string().optional().describe("Filter by ref"),
+    sha: z
+        .string()
+        .optional()
+        .describe("Filter by commit SHA (if supported by your GitLab version)"),
+    status: z.string().optional().describe("Filter by deployment status"),
+    updated_after: z
+        .string()
+        .optional()
+        .describe("Return deployments updated after the specified date"),
+    updated_before: z
+        .string()
+        .optional()
+        .describe("Return deployments updated before the specified date"),
+    order_by: z
+        .enum(["id", "iid", "created_at", "updated_at", "ref", "status", "environment"])
+        .optional()
+        .describe("Order deployments by"),
+    sort: z.enum(["asc", "desc"]).optional().describe("Sort deployments"),
+})
+    .merge(PaginationOptionsSchema);
+export const GetDeploymentSchema = z.object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    deployment_id: z.coerce.string().describe("The ID of the deployment"),
+});
+// Environment related schemas
+const GitLabEnvironmentLastDeploymentSchema = z.object({
+    id: z.coerce.string().optional(),
+    iid: z.coerce.string().optional(),
+    status: z.string().optional(),
+    ref: z.string().optional(),
+    sha: z.string().optional(),
+    created_at: z.string().optional(),
+    updated_at: z.string().optional(),
+    web_url: z.string().optional(),
+});
+export const GitLabEnvironmentSchema = z.object({
+    id: z.coerce.string(),
+    name: z.string(),
+    slug: z.string().optional(),
+    external_url: z.string().nullable().optional(),
+    state: z.string().optional(),
+    tier: z.string().optional(),
+    environment_type: z.string().optional(),
+    created_at: z.string().optional(),
+    updated_at: z.string().optional(),
+    auto_stop_at: z.string().nullable().optional(),
+    enable_advanced_logs_querying: z.boolean().optional(),
+    logs_api_path: z.string().optional(),
+    web_url: z.string().optional(),
+    last_deployment: GitLabEnvironmentLastDeploymentSchema.nullable().optional(),
+});
+export const ListEnvironmentsSchema = z
+    .object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    name: z.string().optional().describe("Return environments with this exact name"),
+    search: z.string().optional().describe("Search environments by name"),
+    states: z
+        .enum(["available", "stopped"])
+        .optional()
+        .describe("Filter environments by state"),
+})
+    .merge(PaginationOptionsSchema);
+export const GetEnvironmentSchema = z.object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    environment_id: z.coerce.string().describe("The ID of the environment"),
+});
 // Schema for creating a new pipeline
 export const CreatePipelineSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
@@ -260,6 +393,10 @@ export const CreatePipelineSchema = z.object({
     }))
         .optional()
         .describe("An array of variables to use for the pipeline"),
+    inputs: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe("Input parameters for the pipeline (key-value pairs for spec:inputs)"),
 });
 // Schema for retrying a pipeline
 export const RetryPipelineSchema = z.object({
@@ -300,7 +437,7 @@ export const PlayPipelineJobSchema = z.object({
 });
 // Schema for retrying a job
 export const RetryPipelineJobSchema = PipelineJobControlSchema;
-// Schema for canceling a job  
+// Schema for canceling a job
 export const CancelPipelineJobSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
     job_id: z.coerce.string().describe("The ID of the job"),
@@ -438,17 +575,17 @@ export const GitLabRepositorySchema = z.object({
 export const GitLabProjectSchema = GitLabRepositorySchema;
 // File content schemas
 export const GitLabFileContentSchema = z.object({
-    file_name: z.string(), // Changed from name to match GitLab API
-    file_path: z.string(), // Changed from path to match GitLab API
-    size: z.number(),
+    file_name: z.string().optional(),
+    file_path: z.string(),
+    size: z.coerce.number().optional(),
     encoding: z.string(),
     content: z.string(),
-    content_sha256: z.string(), // Changed from sha to match GitLab API
-    ref: z.string(), // Added as GitLab requires branch reference
-    blob_id: z.string(), // Added to match GitLab API
-    commit_id: z.string(), // ID of the current file version
-    last_commit_id: z.string(), // Added to match GitLab API
-    execute_filemode: z.boolean().optional(), // Added to match GitLab API
+    content_sha256: z.string().optional(),
+    ref: z.string().optional(),
+    blob_id: z.string().optional(),
+    commit_id: z.string().optional(),
+    last_commit_id: z.string().optional(),
+    execute_filemode: z.boolean().optional(),
 });
 export const GitLabDirectoryContentSchema = z.object({
     name: z.string(),
@@ -715,6 +852,15 @@ export const GitLabMergeRequestSchema = z.object({
     allow_collaboration: z.boolean().optional(),
     allow_maintainer_to_push: z.boolean().optional(),
     changes_count: z.string().nullable().optional(),
+    diverged_commits_count: z.coerce
+        .number()
+        .nullable()
+        .optional()
+        .describe("Number of commits the source branch is behind the target branch"),
+    rebase_in_progress: z
+        .boolean()
+        .optional()
+        .describe("Whether rebase is currently in progress for this merge request"),
     merge_when_pipeline_succeeds: z.boolean().optional(),
     squash: z.boolean().optional(),
     labels: z.array(z.string()).optional(),
@@ -772,7 +918,8 @@ export const LineRangeSchema = z
 })
     .describe("Line range for multiline comments on GitLab merge request diffs. VALIDATION RULES: 1) line_code is critical for GitLab API success, 2) start/end must have consistent types, 3) line numbers must form valid range, 4) get line_code from GitLab diff API, never generate manually.");
 // Discussion related schemas
-export const GitLabDiscussionNoteSchema = z.object({
+export const GitLabDiscussionNoteSchema = z
+    .object({
     id: z.coerce.string(),
     type: z.enum(["DiscussionNote", "DiffNote", "Note"]).nullable().optional(), // Allow null type for regular notes
     body: z.string().optional(),
@@ -816,7 +963,8 @@ export const GitLabDiscussionNoteSchema = z.object({
     })
         .passthrough() // Allow additional fields
         .optional(),
-}).passthrough(); // Allow additional fields that GitLab might return
+})
+    .passthrough(); // Allow additional fields that GitLab might return
 // Reusable pagination schema for GitLab API responses.
 // See https://docs.gitlab.com/api/rest/#pagination
 export const GitLabPaginationSchema = z.object({
@@ -855,7 +1003,10 @@ export const ListMergeRequestDiscussionsSchema = ProjectParamsSchema.extend({
 export const GetMergeRequestNotesSchema = ProjectParamsSchema.extend({
     merge_request_iid: z.coerce.string().describe("The IID of a merge request"),
     sort: z.enum(["asc", "desc"]).optional().describe("The sort order of the notes"),
-    order_by: z.enum(["created_at", "updated_at"]).optional().describe("The field to sort the notes by"),
+    order_by: z
+        .enum(["created_at", "updated_at"])
+        .optional()
+        .describe("The field to sort the notes by"),
     per_page: z.coerce.number().optional().describe("Number of items per page"),
     page: z.coerce.number().optional().describe("Page number for pagination"),
 });
@@ -950,10 +1101,43 @@ export const CreateRepositorySchema = z.object({
         .describe("Repository visibility level"),
     initialize_with_readme: z.boolean().optional().describe("Initialize with README.md"),
 });
-export const GetFileContentsSchema = ProjectParamsSchema.extend({
-    file_path: z.string().describe("Path to the file or directory"),
+export const GetFileContentsSchema = z
+    .object({
+    project_id: z.coerce
+        .string()
+        .optional()
+        .describe("Project ID or URL-encoded path (optional; falls back to env)"),
+    file_path: z
+        .string()
+        .optional()
+        .describe("Path to the file or directory. Takes precedence over 'path' when both are provided"),
+    path: z.string().optional().describe("Alias of file_path"),
     ref: z.string().optional().describe("Branch/tag/commit to get contents from"),
-});
+})
+    .superRefine((data, ctx) => {
+    const fp = data.file_path?.trim();
+    const p = data.path?.trim();
+    if (!fp && !p) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Either 'file_path' or 'path' must be provided",
+            path: ["file_path"],
+        });
+    }
+    const finalPath = fp && fp.length > 0 ? fp : p ?? "";
+    if (finalPath.trim().length === 0) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "file_path cannot be empty or whitespace",
+            path: ["file_path"],
+        });
+    }
+})
+    .transform(data => ({
+    project_id: (data.project_id ?? "").trim() || undefined,
+    file_path: ((data.file_path ?? "").trim() || (data.path ?? "").trim()).trim(),
+    ref: (data.ref ?? "").trim() || undefined,
+}));
 export const PushFilesSchema = ProjectParamsSchema.extend({
     branch: z.string().describe("Branch to push to"),
     files: z
@@ -970,7 +1154,11 @@ export const CreateIssueSchema = ProjectParamsSchema.extend({
     assignee_ids: z.array(z.number()).optional().describe("Array of user IDs to assign"),
     labels: z.array(z.string()).optional().describe("Array of label names"),
     milestone_id: z.coerce.string().optional().describe("Milestone ID to assign"),
-    issue_type: z.enum(["issue", "incident", "test_case", "task"]).describe("the type of issue. One of issue, incident, test_case or task.").nullish().default("issue"),
+    issue_type: z
+        .enum(["issue", "incident", "test_case", "task"])
+        .describe("the type of issue. One of issue, incident, test_case or task.")
+        .nullish()
+        .default("issue"),
 });
 const MergeRequestOptionsSchema = {
     title: z.string().describe("Merge request title"),
@@ -986,10 +1174,14 @@ const MergeRequestOptionsSchema = {
     labels: z.array(z.string()).optional().describe("Labels for the MR"),
     draft: z.boolean().optional().describe("Create as draft merge request"),
     allow_collaboration: z.boolean().optional().describe("Allow commits from upstream members"),
-    remove_source_branch: z.boolean().nullable()
+    remove_source_branch: z
+        .boolean()
+        .nullable()
         .optional()
         .describe("Flag indicating if a merge request should remove the source branch when merging."),
-    squash: z.boolean().nullable()
+    squash: z
+        .boolean()
+        .nullable()
         .optional()
         .describe("If true, squash all commits into a single commit on merge."),
 };
@@ -1006,7 +1198,8 @@ export const CreateBranchSchema = ProjectParamsSchema.extend({
 export const GetBranchDiffsSchema = ProjectParamsSchema.extend({
     from: z.string().describe("The base branch or commit SHA to compare from"),
     to: z.string().describe("The target branch or commit SHA to compare to"),
-    straight: z.boolean()
+    straight: z
+        .boolean()
         .optional()
         .describe("Comparison method: false for '...' (default), true for '--'"),
     excluded_file_patterns: z
@@ -1041,18 +1234,40 @@ export const UpdateMergeRequestSchema = GetMergeRequestSchema.extend({
 });
 export const MergeMergeRequestSchema = ProjectParamsSchema.extend({
     merge_request_iid: z.coerce.string().optional().describe("The IID of a merge request"),
-    auto_merge: z.boolean().optional().default(false).describe("If true, the merge request merges when the pipeline succeeds."),
+    auto_merge: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("If true, the merge request merges when the pipeline succeeds."),
     merge_commit_message: z.string().optional().describe("Custom merge commit message"),
-    merge_when_pipeline_succeeds: z.boolean().optional().default(false).describe("If true, the merge request merges when the pipeline succeeds.in GitLab 17.11. Use"),
-    should_remove_source_branch: z.boolean().optional().default(false).describe("Remove source branch after merge"),
+    merge_when_pipeline_succeeds: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("If true, the merge request merges when the pipeline succeeds.in GitLab 17.11. Use"),
+    should_remove_source_branch: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Remove source branch after merge"),
     squash_commit_message: z.string().optional().describe("Custom squash commit message"),
-    squash: z.boolean().optional().default(false).describe("Squash commits into a single commit when merging"),
+    squash: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Squash commits into a single commit when merging"),
 });
 // Merge Request Approval schemas
 export const ApproveMergeRequestSchema = ProjectParamsSchema.extend({
     merge_request_iid: z.coerce.string().describe("The IID of the merge request to approve"),
-    sha: z.string().optional().describe("The HEAD of the merge request. Optional, but used to ensure the merge request hasn't changed since you last reviewed it"),
-    approval_password: z.string().optional().describe("Current user's password. Required if 'Require user re-authentication to approve' is enabled in the project settings"),
+    sha: z
+        .string()
+        .optional()
+        .describe("The HEAD of the merge request. Optional, but used to ensure the merge request hasn't changed since you last reviewed it"),
+    approval_password: z
+        .string()
+        .optional()
+        .describe("Current user's password. Required if 'Require user re-authentication to approve' is enabled in the project settings"),
 });
 export const UnapproveMergeRequestSchema = ProjectParamsSchema.extend({
     merge_request_iid: z.coerce.string().describe("The IID of the merge request to unapprove"),
@@ -1073,26 +1288,47 @@ export const GitLabApprovalRuleSchema = z.object({
     eligible_approvers: z.array(GitLabApprovalUserSchema).optional(),
     approvals_required: z.number(),
     users: z.array(GitLabApprovalUserSchema).optional(),
-    groups: z.array(z.object({
+    groups: z
+        .array(z.object({
         id: z.coerce.string(),
         name: z.string(),
         path: z.string(),
         full_path: z.string(),
         avatar_url: z.string().nullable().optional(),
         web_url: z.string(),
-    })).optional(),
+    }))
+        .optional(),
     contains_hidden_groups: z.boolean().optional(),
     approved_by: z.array(GitLabApprovalUserSchema).optional(),
-    source_rule: z.object({
+    source_rule: z
+        .object({
         id: z.coerce.string().optional(),
         name: z.string().optional(),
         rule_type: z.string().optional(),
-    }).nullable().optional(),
+    })
+        .nullable()
+        .optional(),
+    approved: z.boolean().optional(),
+});
+export const GitLabMergeRequestApprovalsResponseSchema = z.object({
     approved: z.boolean().optional(),
+    user_has_approved: z.boolean().optional(),
+    user_can_approve: z.boolean().optional(),
+    approved_by: z
+        .array(z.object({
+        user: GitLabApprovalUserSchema,
+    }))
+        .optional(),
 });
 export const GitLabMergeRequestApprovalStateSchema = z.object({
     approval_rules_overwritten: z.boolean().optional(),
     rules: z.array(GitLabApprovalRuleSchema).optional(),
+    approved: z.boolean().optional(),
+    user_has_approved: z.boolean().optional(),
+    user_can_approve: z.boolean().optional(),
+    approved_by: z.array(GitLabApprovalUserSchema).optional(),
+    approved_by_usernames: z.array(z.string()).optional(),
+    source_endpoint: z.enum(["approval_state", "approvals"]).optional(),
 });
 export const GetMergeRequestApprovalStateSchema = ProjectParamsSchema.extend({
     merge_request_iid: z.coerce.string().describe("The IID of the merge request"),
@@ -1107,7 +1343,8 @@ export const GetMergeRequestDiffsSchema = GetMergeRequestSchema.extend({
 export const ListMergeRequestDiffsSchema = GetMergeRequestSchema.extend({
     page: z.number().optional().describe("Page number for pagination (default: 1)"),
     per_page: z.number().optional().describe("Number of items per page (max: 100, default: 20)"),
-    unidiff: z.boolean()
+    unidiff: z
+        .boolean()
         .optional()
         .describe("Present diffs in the unified diff format. Default is false. Introduced in GitLab 16.5."),
 });
@@ -1117,7 +1354,8 @@ export const ListMergeRequestVersionsSchema = ProjectParamsSchema.extend({
 });
 export const GetMergeRequestVersionSchema = ListMergeRequestVersionsSchema.extend({
     version_id: z.coerce.string().describe("The ID of the merge request diff version"),
-    unidiff: z.boolean()
+    unidiff: z
+        .boolean()
         .optional()
         .describe("Present diffs in the unified diff format. Default is false. Introduced in GitLab 16.5."),
 });
@@ -1177,7 +1415,10 @@ export const ListIssuesSchema = z
 // Merge Requests API operation schemas
 export const ListMergeRequestsSchema = z
     .object({
-    project_id: z.coerce.string().optional().describe("Project ID or URL-encoded path (optional - if not provided, lists all merge requests the user has access to)"),
+    project_id: z.coerce
+        .string()
+        .optional()
+        .describe("Project ID or URL-encoded path (optional - if not provided, lists all merge requests the user has access to)"),
     assignee_id: z.coerce
         .string()
         .optional()
@@ -1276,7 +1517,9 @@ export const UpdateIssueSchema = z.object({
     milestone_id: z.coerce.string().optional().describe("Milestone ID to assign"),
     state_event: z.enum(["close", "reopen"]).optional().describe("Update issue state (close/reopen)"),
     weight: z.number().optional().describe("Weight of the issue (0-9)"),
-    issue_type: z.enum(["issue", "incident", "test_case", "task"]).describe("the type of issue. One of issue, incident, test_case or task."),
+    issue_type: z
+        .enum(["issue", "incident", "test_case", "task"])
+        .describe("the type of issue. One of issue, incident, test_case or task."),
 });
 export const DeleteIssueSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
@@ -1332,11 +1575,10 @@ export const GetProjectSchema = z.object({
 export const ListProjectsSchema = z
     .object({
     search: z.string().optional().describe("Search term for projects"),
-    search_namespaces: z.boolean()
-        .optional()
-        .describe("Needs to be true if search is full path"),
+    search_namespaces: z.boolean().optional().describe("Needs to be true if search is full path"),
     owned: z.boolean().optional().describe("Filter for projects owned by current user"),
-    membership: z.boolean()
+    membership: z
+        .boolean()
         .optional()
         .describe("Filter for projects where current user is a member"),
     simple: z.boolean().optional().describe("Return only limited fields"),
@@ -1476,19 +1718,57 @@ export const GitLabWikiPageSchema = z.object({
 // Extremely flexible position schema for API responses - accepts any structure
 // Strict position schema for creating draft notes and merge request threads
 export const MergeRequestThreadPositionCreateSchema = z.object({
-    base_sha: z.string().describe("REQUIRED: Base commit SHA in the source branch. Get this from merge request diff_refs.base_sha."),
-    head_sha: z.string().describe("REQUIRED: SHA referencing HEAD of the source branch. Get this from merge request diff_refs.head_sha."),
-    start_sha: z.string().describe("REQUIRED: SHA referencing the start commit of the source branch. Get this from merge request diff_refs.start_sha."),
-    position_type: z.enum(["text", "image", "file"]).describe("REQUIRED: Position type. Use 'text' for code diffs, 'image' for image diffs, 'file' for file-level comments."),
-    new_path: z.string().nullable().optional().describe("File path after changes. REQUIRED for most diff comments. Use same as old_path if file wasn't renamed."),
-    old_path: z.string().nullable().optional().describe("File path before changes. REQUIRED for most diff comments. Use same as new_path if file wasn't renamed."),
-    new_line: z.number().nullable().optional().describe("Line number in modified file (after changes). Use for added lines or context lines. NULL for deleted lines. For single-line comments on new lines."),
-    old_line: z.number().nullable().optional().describe("Line number in original file (before changes). Use for deleted lines or context lines. NULL for added lines. For single-line comments on old lines."),
-    line_range: LineRangeSchema.nullable().optional().describe("MULTILINE COMMENTS: Specify start/end line positions for commenting on multiple lines. Alternative to single old_line/new_line."),
-    width: z.number().optional().describe("IMAGE DIFFS ONLY: Width of the image (for position_type='image')."),
-    height: z.number().optional().describe("IMAGE DIFFS ONLY: Height of the image (for position_type='image')."),
-    x: z.number().optional().describe("IMAGE DIFFS ONLY: X coordinate on the image (for position_type='image')."),
-    y: z.number().optional().describe("IMAGE DIFFS ONLY: Y coordinate on the image (for position_type='image')."),
+    base_sha: z
+        .string()
+        .describe("REQUIRED: Base commit SHA in the source branch. Get this from merge request diff_refs.base_sha."),
+    head_sha: z
+        .string()
+        .describe("REQUIRED: SHA referencing HEAD of the source branch. Get this from merge request diff_refs.head_sha."),
+    start_sha: z
+        .string()
+        .describe("REQUIRED: SHA referencing the start commit of the source branch. Get this from merge request diff_refs.start_sha."),
+    position_type: z
+        .enum(["text", "image", "file"])
+        .describe("REQUIRED: Position type. Use 'text' for code diffs, 'image' for image diffs, 'file' for file-level comments."),
+    new_path: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("File path after changes. REQUIRED for most diff comments. Use same as old_path if file wasn't renamed."),
+    old_path: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("File path before changes. REQUIRED for most diff comments. Use same as new_path if file wasn't renamed."),
+    new_line: z
+        .number()
+        .nullable()
+        .optional()
+        .describe("Line number in modified file (after changes). Use for added lines or context lines. NULL for deleted lines. For single-line comments on new lines."),
+    old_line: z
+        .number()
+        .nullable()
+        .optional()
+        .describe("Line number in original file (before changes). Use for deleted lines or context lines. NULL for added lines. For single-line comments on old lines."),
+    line_range: LineRangeSchema.nullable()
+        .optional()
+        .describe("MULTILINE COMMENTS: Specify start/end line positions for commenting on multiple lines. Alternative to single old_line/new_line."),
+    width: z
+        .number()
+        .optional()
+        .describe("IMAGE DIFFS ONLY: Width of the image (for position_type='image')."),
+    height: z
+        .number()
+        .optional()
+        .describe("IMAGE DIFFS ONLY: Height of the image (for position_type='image')."),
+    x: z
+        .number()
+        .optional()
+        .describe("IMAGE DIFFS ONLY: X coordinate on the image (for position_type='image')."),
+    y: z
+        .number()
+        .optional()
+        .describe("IMAGE DIFFS ONLY: Y coordinate on the image (for position_type='image')."),
 });
 // Schema for creating/sending position to GitLab API (stricter)
 export const MergeRequestThreadPositionSchema = z.object({
@@ -1524,7 +1804,9 @@ export const MergeRequestThreadPositionSchema = z.object({
         .nullable()
         .optional()
         .describe("Line number in original file (before changes). Use for deleted lines or context lines. NULL for added lines. For single-line comments on old lines."),
-    line_range: LineRangeSchema.nullable().optional().describe("MULTILINE COMMENTS: Specify start/end line positions for commenting on multiple lines. Alternative to single old_line/new_line."),
+    line_range: LineRangeSchema.nullable()
+        .optional()
+        .describe("MULTILINE COMMENTS: Specify start/end line positions for commenting on multiple lines. Alternative to single old_line/new_line."),
     width: z
         .number()
         .nullable()
@@ -1547,22 +1829,26 @@ export const MergeRequestThreadPositionSchema = z.object({
         .describe("IMAGE DIFFS ONLY: Y coordinate on the image (for position_type='image')."),
 });
 // Draft Notes API schemas
-export const GitLabDraftNoteSchema = z.object({
+export const GitLabDraftNoteSchema = z
+    .object({
     id: z.coerce.string(),
     author: GitLabUserSchema.optional(),
     body: z.string().optional(),
     note: z.string().optional(), // Some APIs might use 'note' instead of 'body'
     created_at: z.string().optional(),
     updated_at: z.string().optional(),
-    position: MergeRequestThreadPositionSchema.nullable().optional(),
+    discussion_id: z.string().nullable().optional(),
+    position: z.record(z.unknown()).nullable().optional(),
     resolve_discussion: z.boolean().optional(),
-}).transform((data) => ({
+})
+    .transform(data => ({
     // Normalize the response to always have consistent field names
     id: data.id,
     author: data.author,
     body: data.body || data.note || "",
     created_at: data.created_at || "",
     updated_at: data.updated_at || "",
+    discussion_id: data.discussion_id || null,
     position: data.position,
     resolve_discussion: data.resolve_discussion,
 }));
@@ -1579,8 +1865,15 @@ export const ListDraftNotesSchema = ProjectParamsSchema.extend({
 export const CreateDraftNoteSchema = ProjectParamsSchema.extend({
     merge_request_iid: z.coerce.string().describe("The IID of a merge request"),
     body: z.string().describe("The content of the draft note"),
+    in_reply_to_discussion_id: z.coerce
+        .string()
+        .optional()
+        .describe("The ID of a discussion the draft note replies to"),
     position: MergeRequestThreadPositionSchema.optional().describe("Position when creating a diff note"),
-    resolve_discussion: z.boolean().optional().describe("Whether to resolve the discussion when publishing"),
+    resolve_discussion: z
+        .boolean()
+        .optional()
+        .describe("Whether to resolve the discussion when publishing"),
 });
 // Update draft note schema
 export const UpdateDraftNoteSchema = ProjectParamsSchema.extend({
@@ -1588,7 +1881,10 @@ export const UpdateDraftNoteSchema = ProjectParamsSchema.extend({
     draft_note_id: z.coerce.string().describe("The ID of the draft note"),
     body: z.string().optional().describe("The content of the draft note"),
     position: MergeRequestThreadPositionSchema.optional().describe("Position when creating a diff note"),
-    resolve_discussion: z.boolean().optional().describe("Whether to resolve the discussion when publishing"),
+    resolve_discussion: z
+        .boolean()
+        .optional()
+        .describe("Whether to resolve the discussion when publishing"),
 });
 // Delete draft note schema
 export const DeleteDraftNoteSchema = ProjectParamsSchema.extend({
@@ -1692,10 +1988,9 @@ export const ListCommitsSchema = z.object({
     path: z.string().optional().describe("The file path"),
     author: z.string().optional().describe("Search commits by commit author"),
     all: z.boolean().optional().describe("Retrieve every commit from the repository"),
-    with_stats: z.boolean()
-        .optional()
-        .describe("Stats about each commit are added to the response"),
-    first_parent: z.boolean()
+    with_stats: z.boolean().optional().describe("Stats about each commit are added to the response"),
+    first_parent: z
+        .boolean()
         .optional()
         .describe("Follow only the first parent commit upon seeing a merge commit"),
     order: z.enum(["default", "topo"]).optional().describe("List commits in order"),
@@ -1711,11 +2006,17 @@ export const GetCommitSchema = z.object({
 export const GetCommitDiffSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or complete URL-encoded path to project"),
     sha: z.string().describe("The commit hash or name of a repository branch or tag"),
-    full_diff: z.boolean().optional().describe("Whether to return the full diff or only first page (default: false)"),
+    full_diff: z
+        .boolean()
+        .optional()
+        .describe("Whether to return the full diff or only first page (default: false)"),
 });
 // Schema for listing issues assigned to the current user
 export const MyIssuesSchema = z.object({
-    project_id: z.string().optional().describe("Project ID or URL-encoded path (optional when GITLAB_PROJECT_ID is set)"),
+    project_id: z
+        .string()
+        .optional()
+        .describe("Project ID or URL-encoded path (optional when GITLAB_PROJECT_ID is set)"),
     state: z
         .enum(["opened", "closed", "all"])
         .optional()
@@ -1723,10 +2024,22 @@ export const MyIssuesSchema = z.object({
     labels: z.array(z.string()).optional().describe("Array of label names to filter by"),
     milestone: z.string().optional().describe("Milestone title to filter by"),
     search: z.string().optional().describe("Search for specific terms in title and description"),
-    created_after: z.string().optional().describe("Return issues created after the given time (ISO 8601)"),
-    created_before: z.string().optional().describe("Return issues created before the given time (ISO 8601)"),
-    updated_after: z.string().optional().describe("Return issues updated after the given time (ISO 8601)"),
-    updated_before: z.string().optional().describe("Return issues updated before the given time (ISO 8601)"),
+    created_after: z
+        .string()
+        .optional()
+        .describe("Return issues created after the given time (ISO 8601)"),
+    created_before: z
+        .string()
+        .optional()
+        .describe("Return issues created before the given time (ISO 8601)"),
+    updated_after: z
+        .string()
+        .optional()
+        .describe("Return issues updated after the given time (ISO 8601)"),
+    updated_before: z
+        .string()
+        .optional()
+        .describe("Return issues updated before the given time (ISO 8601)"),
     per_page: z.number().optional().describe("Number of items per page (default: 20, max: 100)"),
     page: z.number().optional().describe("Page number for pagination (default: 1)"),
 });
@@ -1773,7 +2086,10 @@ export const DownloadAttachmentSchema = z.object({
     project_id: z.string().describe("Project ID or URL-encoded path of the project"),
     secret: z.string().describe("The 32-character secret of the upload"),
     filename: z.string().describe("The filename of the upload"),
-    local_path: z.string().optional().describe("Local path to save the file (optional, defaults to current directory)"),
+    local_path: z
+        .string()
+        .optional()
+        .describe("Local path to save the file (optional, defaults to current directory)"),
 });
 export const GroupIteration = z.object({
     id: z.coerce.string(),
@@ -1804,10 +2120,12 @@ export const ListGroupIterationsSchema = z
         .array(z.enum(["title", "cadence_title"]))
         .optional()
         .describe("Fields in which fuzzy search should be performed with the query given in the argument search. The available options are title and cadence_title. Default is [title]."),
-    include_ancestors: z.boolean()
+    include_ancestors: z
+        .boolean()
         .optional()
         .describe("Include iterations for group and its ancestors. Defaults to true."),
-    include_descendants: z.boolean()
+    include_descendants: z
+        .boolean()
         .optional()
         .describe("Include iterations for group and its descendants. Defaults to false."),
     updated_before: z
@@ -1829,7 +2147,8 @@ export const GitLabEventAuthorSchema = z.object({
     avatar_url: z.string().nullable(),
     web_url: z.string(),
 });
-export const GitLabEventSchema = z.object({
+export const GitLabEventSchema = z
+    .object({
     id: z.coerce.string(),
     project_id: z.coerce.string(),
     action_name: z.string(),
@@ -1843,26 +2162,57 @@ export const GitLabEventSchema = z.object({
     author_username: z.string(),
     imported: z.boolean(),
     imported_from: z.string(),
-}).passthrough(); // Allow additional fields
+})
+    .passthrough(); // Allow additional fields
 // List events schema
 export const ListEventsSchema = z.object({
-    action: z.string().optional().describe("If defined, returns events with the specified action type"),
-    target_type: z.enum(["epic", "issue", "merge_request", "milestone", "note", "project", "snippet", "user"]).optional().describe("If defined, returns events with the specified target type"),
-    before: z.string().optional().describe("If defined, Returns events created before the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use before=2025-08-30"),
-    after: z.string().optional().describe("If defined, Returns events created after the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use after=2025-08-28"),
+    action: z
+        .string()
+        .optional()
+        .describe("If defined, returns events with the specified action type"),
+    target_type: z
+        .enum(["epic", "issue", "merge_request", "milestone", "note", "project", "snippet", "user"])
+        .optional()
+        .describe("If defined, returns events with the specified target type"),
+    before: z
+        .string()
+        .optional()
+        .describe("If defined, Returns events created before the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use before=2025-08-30"),
+    after: z
+        .string()
+        .optional()
+        .describe("If defined, Returns events created after the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use after=2025-08-28"),
     scope: z.string().optional().describe("Include all events across a user's projects"),
-    sort: z.enum(["asc", "desc"]).optional().describe("Direction to sort the results by creation date. Default: desc"),
+    sort: z
+        .enum(["asc", "desc"])
+        .optional()
+        .describe("Direction to sort the results by creation date. Default: desc"),
     page: z.number().optional().describe("Returns the specified results page. Default: 1"),
     per_page: z.number().optional().describe("Number of results per page. Default: 20"),
 });
 // Get project events schema
 export const GetProjectEventsSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
-    action: z.string().optional().describe("If defined, returns events with the specified action type"),
-    target_type: z.enum(["epic", "issue", "merge_request", "milestone", "note", "project", "snippet", "user"]).optional().describe("If defined, returns events with the specified target type"),
-    before: z.string().optional().describe("If defined, Returns events created before the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use before=2025-08-30"),
-    after: z.string().optional().describe("If defined, Returns events created after the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use after=2025-08-28"),
-    sort: z.enum(["asc", "desc"]).optional().describe("Direction to sort the results by creation date. Default: desc"),
+    action: z
+        .string()
+        .optional()
+        .describe("If defined, returns events with the specified action type"),
+    target_type: z
+        .enum(["epic", "issue", "merge_request", "milestone", "note", "project", "snippet", "user"])
+        .optional()
+        .describe("If defined, returns events with the specified target type"),
+    before: z
+        .string()
+        .optional()
+        .describe("If defined, Returns events created before the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use before=2025-08-30"),
+    after: z
+        .string()
+        .optional()
+        .describe("If defined, Returns events created after the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use after=2025-08-28"),
+    sort: z
+        .enum(["asc", "desc"])
+        .optional()
+        .describe("Direction to sort the results by creation date. Default: desc"),
     page: z.number().optional().describe("Returns the specified results page. Default: 1"),
     per_page: z.number().optional().describe("Number of results per page. Default: 20"),
 });
@@ -1885,10 +2235,7 @@ export const GitLabMergeRequestVersionDetailSchema = GitLabMergeRequestVersionSc
 // GraphQL generic execution schema
 export const ExecuteGraphQLSchema = z.object({
     query: z.string().describe("GraphQL query string"),
-    variables: z
-        .record(z.any())
-        .optional()
-        .describe("Variables object for the GraphQL query"),
+    variables: z.record(z.any()).optional().describe("Variables object for the GraphQL query"),
 });
 // Release schemas
 export const GitLabReleaseAssetLinkSchema = z.object({
@@ -1920,15 +2267,18 @@ export const GitLabReleaseSchema = z.object({
     description_html: z.string().nullable().optional(),
     created_at: z.string(),
     released_at: z.string().nullable().optional(),
-    author: z.object({
+    author: z
+        .object({
         id: z.number(),
         name: z.string(),
         username: z.string(),
         state: z.string(),
         avatar_url: z.string().nullable().optional(),
         web_url: z.string(),
-    }).optional(),
-    commit: z.object({
+    })
+        .optional(),
+    commit: z
+        .object({
         id: z.string(),
         short_id: z.string(),
         title: z.string(),
@@ -1941,13 +2291,15 @@ export const GitLabReleaseSchema = z.object({
         committer_name: z.string(),
         committer_email: z.string(),
         committed_date: z.string(),
-    }).optional(),
+    })
+        .optional(),
     milestones: z.array(GitLabMilestonesSchema).optional(),
     commit_path: z.string().optional(),
     tag_path: z.string().optional(),
     assets: GitLabReleaseAssetsSchema.optional(),
     evidences: z.array(GitLabReleaseEvidenceSchema).optional(),
-    _links: z.object({
+    _links: z
+        .object({
         closed_issues_url: z.string().optional(),
         closed_merge_requests_url: z.string().optional(),
         edit_url: z.string().optional(),
@@ -1955,7 +2307,8 @@ export const GitLabReleaseSchema = z.object({
         opened_issues_url: z.string().optional(),
         opened_merge_requests_url: z.string().optional(),
         self: z.string().optional(),
-    }).optional(),
+    })
+        .optional(),
     upcoming_release: z.boolean().optional(),
     historical_release: z.boolean().optional(),
 });
@@ -1989,7 +2342,10 @@ export const CreateReleaseSchema = z.object({
     tag_name: z.string().describe("The tag where the release is created from"),
     name: z.string().optional().describe("The release name"),
     tag_message: z.string().optional().describe("Message to use if creating a new annotated tag"),
-    description: z.string().optional().describe("The description of the release. You can use Markdown."),
+    description: z
+        .string()
+        .optional()
+        .describe("The description of the release. You can use Markdown."),
     ref: z
         .string()
         .optional()
@@ -2002,9 +2358,16 @@ export const CreateReleaseSchema = z.object({
         .object({
         links: z
             .array(z.object({
-            name: z.string().describe("The name of the link. Link names must be unique within the release."),
-            url: z.string().describe("The URL of the link. Link URLs must be unique within the release."),
-            direct_asset_path: z.string().optional().describe("Optional path for a direct asset link."),
+            name: z
+                .string()
+                .describe("The name of the link. Link names must be unique within the release."),
+            url: z
+                .string()
+                .describe("The URL of the link. Link URLs must be unique within the release."),
+            direct_asset_path: z
+                .string()
+                .optional()
+                .describe("Optional path for a direct asset link."),
             link_type: z
                 .enum(["other", "runbook", "image", "package"])
                 .optional()
@@ -2023,7 +2386,10 @@ export const UpdateReleaseSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
     tag_name: z.string().describe("The Git tag the release is associated with"),
     name: z.string().optional().describe("The release name"),
-    description: z.string().optional().describe("The description of the release. You can use Markdown."),
+    description: z
+        .string()
+        .optional()
+        .describe("The description of the release. You can use Markdown."),
     milestones: z
         .array(z.string())
         .optional()
@@ -2041,8 +2407,45 @@ export const CreateReleaseEvidenceSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
     tag_name: z.string().describe("The Git tag the release is associated with"),
 });
+// Job Artifacts schemas
+export const ListJobArtifactsSchema = z.object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    job_id: z.coerce.string().describe("The ID of the job"),
+    path: z
+        .string()
+        .optional()
+        .describe("Directory path within the artifacts archive (defaults to root)"),
+    recursive: z
+        .boolean()
+        .optional()
+        .describe("Whether to list artifacts recursively"),
+});
+export const GitLabArtifactEntrySchema = z.object({
+    name: z.string(),
+    path: z.string(),
+    type: z.enum(["file", "directory"]),
+    size: z.number().optional(),
+    mode: z.string().optional(),
+});
+export const DownloadJobArtifactsSchema = z.object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    job_id: z.coerce.string().describe("The ID of the job"),
+    local_path: z
+        .string()
+        .optional()
+        .describe("Local directory to save the artifact archive (defaults to current directory)"),
+});
+export const GetJobArtifactFileSchema = z.object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    job_id: z.coerce.string().describe("The ID of the job"),
+    artifact_path: z
+        .string()
+        .describe("Path to the file within the artifacts archive"),
+});
 export const DownloadReleaseAssetSchema = z.object({
     project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
     tag_name: z.string().describe("The Git tag the release is associated with"),
-    direct_asset_path: z.string().describe("Path to the release asset file as specified when creating or updating its link"),
+    direct_asset_path: z
+        .string()
+        .describe("Path to the release asset file as specified when creating or updating its link"),
 });