import { z } from "zod"; // Base schemas for common types export const GitLabAuthorSchema = z.object({ name: z.string(), email: z.string(), date: z.string(), }); // Pipeline related schemas export const GitLabPipelineSchema = z.object({ id: z.number(), project_id: z.number(), sha: z.string(), ref: z.string(), status: z.string(), source: z.string().optional(), created_at: z.string(), updated_at: z.string(), web_url: z.string(), duration: z.number().nullable().optional(), started_at: z.string().nullable().optional(), finished_at: z.string().nullable().optional(), coverage: z.number().nullable().optional(), user: z .object({ id: z.number(), name: z.string(), username: z.string(), avatar_url: z.string().nullable().optional(), }) .optional(), detailed_status: z .object({ icon: z.string().optional(), text: z.string().optional(), label: z.string().optional(), group: z.string().optional(), tooltip: z.string().optional(), has_details: z.boolean().optional(), details_path: z.string().optional(), illustration: z .object({ image: z.string().optional(), size: z.string().optional(), title: z.string().optional(), }) .nullable() .optional(), favicon: z.string().optional(), }) .optional(), }); // Pipeline job related schemas export const GitLabPipelineJobSchema = z.object({ id: z.number(), status: z.string(), stage: z.string(), name: z.string(), ref: z.string(), tag: z.boolean(), coverage: z.number().nullable().optional(), created_at: z.string(), started_at: z.string().nullable().optional(), finished_at: z.string().nullable().optional(), duration: z.number().nullable().optional(), user: z .object({ id: z.number(), name: z.string(), username: z.string(), avatar_url: z.string().nullable().optional(), }) .optional(), commit: z .object({ id: z.string(), short_id: z.string(), title: z.string(), author_name: z.string(), author_email: z.string(), }) .optional(), pipeline: z .object({ id: z.number(), project_id: z.number(), status: z.string(), ref: z.string(), sha: z.string(), }) .optional(), web_url: z.string().optional(), }); // Schema for listing pipelines export const ListPipelinesSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), scope: z .enum(["running", "pending", "finished", "branches", "tags"]) .optional() .describe("The scope of pipelines"), status: z .enum([ "created", "waiting_for_resource", "preparing", "pending", "running", "success", "failed", "canceled", "skipped", "manual", "scheduled", ]) .optional() .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"), username: z.string().optional().describe("The username of the user who triggered pipelines"), updated_after: z .string() .optional() .describe("Return pipelines updated after the specified date"), updated_before: z .string() .optional() .describe("Return pipelines updated before the specified date"), order_by: z .enum(["id", "status", "ref", "updated_at", "user_id"]) .optional() .describe("Order pipelines by"), sort: z.enum(["asc", "desc"]).optional().describe("Sort pipelines"), page: z.number().optional().describe("Page number for pagination"), per_page: z.number().optional().describe("Number of items per page (max 100)"), }); // Schema for getting a specific pipeline export const GetPipelineSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), pipeline_id: z.number().describe("The ID of the pipeline"), }); // Schema for listing jobs in a pipeline export const ListPipelineJobsSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), pipeline_id: z.number().describe("The ID of the pipeline"), scope: z .enum(["created", "pending", "running", "failed", "success", "canceled", "skipped", "manual"]) .optional() .describe("The scope of jobs to show"), include_retried: z.boolean().optional().describe("Whether to include retried jobs"), page: z.number().optional().describe("Page number for pagination"), per_page: z.number().optional().describe("Number of items per page (max 100)"), }); // Schema for creating a new pipeline export const CreatePipelineSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), ref: z.string().describe("The branch or tag to run the pipeline on"), variables: z .array( z.object({ key: z.string().describe("The key of the variable"), value: z.string().describe("The value of the variable"), }) ) .optional() .describe("An array of variables to use for the pipeline"), }); // Schema for retrying a pipeline export const RetryPipelineSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), pipeline_id: z.number().describe("The ID of the pipeline to retry"), }); // Schema for canceling a pipeline export const CancelPipelineSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), pipeline_id: z.number().describe("The ID of the pipeline to cancel"), }); // Schema for the input parameters for pipeline job operations export const GetPipelineJobOutputSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), job_id: z.number().describe("The ID of the job"), }); // User schemas export const GitLabUserSchema = z.object({ username: z.string(), // Changed from login to match GitLab API id: z.number(), name: z.string(), avatar_url: z.string().nullable(), web_url: z.string(), // Changed from html_url to match GitLab API }); export const GetUsersSchema = z.object({ usernames: z.array(z.string()).describe("Array of usernames to search for"), }); export const GitLabUsersResponseSchema = z.record( z.string(), z.object({ id: z.number(), username: z.string(), name: z.string(), avatar_url: z.string(), web_url: z.string(), }).nullable() ); // Namespace related schemas // Base schema for project-related operations const ProjectParamsSchema = z.object({ project_id: z.string().describe("Project ID or complete URL-encoded path to project"), // Changed from owner/repo to match GitLab API }); export const GitLabNamespaceSchema = z.object({ id: z.number(), name: z.string(), path: z.string(), kind: z.enum(["user", "group"]), full_path: z.string(), parent_id: z.number().nullable(), avatar_url: z.string().nullable(), web_url: z.string(), members_count_with_descendants: z.number().optional(), billable_members_count: z.number().optional(), max_seats_used: z.number().optional(), seats_in_use: z.number().optional(), plan: z.string().optional(), end_date: z.string().nullable().optional(), trial_ends_on: z.string().nullable().optional(), trial: z.boolean().optional(), root_repository_size: z.number().optional(), projects_count: z.number().optional(), }); export const GitLabNamespaceExistsResponseSchema = z.object({ exists: z.boolean(), suggests: z.array(z.string()).optional(), }); // Repository related schemas export const GitLabOwnerSchema = z.object({ username: z.string(), // Changed from login to match GitLab API id: z.number(), avatar_url: z.string(), web_url: z.string(), // Changed from html_url to match GitLab API name: z.string(), // Added as GitLab includes full name state: z.string(), // Added as GitLab includes user state }); export const GitLabRepositorySchema = z.object({ id: z.number(), name: z.string(), path_with_namespace: z.string(), visibility: z.string().optional(), owner: GitLabOwnerSchema.optional(), web_url: z.string().optional(), description: z.string().nullable(), fork: z.boolean().optional(), ssh_url_to_repo: z.string().optional(), http_url_to_repo: z.string().optional(), created_at: z.string().optional(), last_activity_at: z.string().optional(), default_branch: z.string().optional(), namespace: z .object({ id: z.number(), name: z.string(), path: z.string(), kind: z.string(), full_path: z.string(), avatar_url: z.string().nullable().optional(), web_url: z.string().optional(), }) .optional(), readme_url: z.string().optional().nullable(), topics: z.array(z.string()).optional(), tag_list: z.array(z.string()).optional(), // deprecated but still present open_issues_count: z.number().optional(), archived: z.boolean().optional(), forks_count: z.number().optional(), star_count: z.number().optional(), permissions: z .object({ project_access: z .object({ access_level: z.number(), notification_level: z.number().optional(), }) .optional() .nullable(), group_access: z .object({ access_level: z.number(), notification_level: z.number().optional(), }) .optional() .nullable(), }) .optional(), container_registry_enabled: z.boolean().optional(), container_registry_access_level: z.string().optional(), issues_enabled: z.boolean().optional(), merge_requests_enabled: z.boolean().optional(), merge_requests_template: z.string().optional(), wiki_enabled: z.boolean().optional(), jobs_enabled: z.boolean().optional(), snippets_enabled: z.boolean().optional(), can_create_merge_request_in: z.boolean().optional(), resolve_outdated_diff_discussions: z.boolean().nullable().optional(), shared_runners_enabled: z.boolean().optional(), shared_with_groups: z .array( z.object({ group_id: z.number(), group_name: z.string(), group_full_path: z.string(), group_access_level: z.number(), }) ) .optional(), }); // Project schema (extended from repository schema) 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(), 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 }); export const GitLabDirectoryContentSchema = z.object({ name: z.string(), path: z.string(), type: z.string(), mode: z.string(), id: z.string(), // Changed from sha to match GitLab API web_url: z.string(), // Changed from html_url to match GitLab API }); export const GitLabContentSchema = z.union([ GitLabFileContentSchema, z.array(GitLabDirectoryContentSchema), ]); // Operation schemas export const FileOperationSchema = z.object({ path: z.string(), content: z.string(), }); // Tree and commit schemas export const GitLabTreeItemSchema = z.object({ id: z.string(), name: z.string(), type: z.enum(["tree", "blob"]), path: z.string(), mode: z.string(), }); export const GetRepositoryTreeSchema = z.object({ project_id: z.string().describe("The ID or URL-encoded path of the project"), path: z.string().optional().describe("The path inside the repository"), ref: z .string() .optional() .describe("The name of a repository branch or tag. Defaults to the default branch."), recursive: z.boolean().optional().describe("Boolean value to get a recursive tree"), per_page: z.number().optional().describe("Number of results to show per page"), page_token: z.string().optional().describe("The tree record ID for pagination"), pagination: z.string().optional().describe("Pagination method (keyset)"), }); export const GitLabTreeSchema = z.object({ id: z.string(), // Changed from sha to match GitLab API tree: z.array(GitLabTreeItemSchema), }); export const GitLabCommitSchema = z.object({ id: z.string(), // Changed from sha to match GitLab API short_id: z.string(), // Added to match GitLab API title: z.string(), // Changed from message to match GitLab API author_name: z.string(), author_email: z.string(), authored_date: z.string(), committer_name: z.string(), committer_email: z.string(), committed_date: z.string(), web_url: z.string(), // Changed from html_url to match GitLab API parent_ids: z.array(z.string()), // Changed from parents to match GitLab API }); // Reference schema export const GitLabReferenceSchema = z.object({ name: z.string(), // Changed from ref to match GitLab API commit: z.object({ id: z.string(), // Changed from sha to match GitLab API web_url: z.string(), // Changed from url to match GitLab API }), }); // Milestones rest api output schemas export const GitLabMilestonesSchema = z.object({ id: z.number(), iid: z.number(), project_id: z.number(), title: z.string(), description: z.string().nullable(), due_date: z.string().nullable(), start_date: z.string().nullable(), state: z.string(), updated_at: z.string(), created_at: z.string(), expired: z.boolean(), web_url: z.string().optional(), }); // Input schemas for operations export const CreateRepositoryOptionsSchema = z.object({ name: z.string(), description: z.string().optional(), visibility: z.enum(["private", "internal", "public"]).optional(), // Changed from private to match GitLab API initialize_with_readme: z.boolean().optional(), // Changed from auto_init to match GitLab API }); export const CreateIssueOptionsSchema = z.object({ title: z.string(), description: z.string().optional(), // Changed from body to match GitLab API assignee_ids: z.array(z.number()).optional(), // Changed from assignees to match GitLab API milestone_id: z.number().optional(), // Changed from milestone to match GitLab API labels: z.array(z.string()).optional(), }); export const CreateMergeRequestOptionsSchema = z.object({ // Changed from CreatePullRequestOptionsSchema title: z.string(), description: z.string().optional(), // Changed from body to match GitLab API source_branch: z.string(), // Changed from head to match GitLab API target_branch: z.string(), // Changed from base to match GitLab API assignee_ids: z .array(z.number()) .optional(), reviewer_ids: z .array(z.number()) .optional(), labels: z.array(z.string()).optional(), allow_collaboration: z.boolean().optional(), // Changed from maintainer_can_modify to match GitLab API draft: z.boolean().optional(), }); export const GitLabDiffSchema = z.object({ old_path: z.string(), new_path: z.string(), a_mode: z.string(), b_mode: z.string(), diff: z.string(), new_file: z.boolean(), renamed_file: z.boolean(), deleted_file: z.boolean(), }); // Response schemas for operations export const GitLabCreateUpdateFileResponseSchema = z.object({ file_path: z.string(), branch: z.string(), commit_id: z.string().optional(), // Optional since it's not always returned by the API content: GitLabFileContentSchema.optional(), }); export const GitLabSearchResponseSchema = z.object({ count: z.number().optional(), total_pages: z.number().optional(), current_page: z.number().optional(), items: z.array(GitLabRepositorySchema), }); // create branch schemas export const CreateBranchOptionsSchema = z.object({ name: z.string(), // Changed from ref to match GitLab API ref: z.string(), // The source branch/commit for the new branch }); export const GitLabCompareResultSchema = z.object({ commit: z.object({ id: z.string().optional(), short_id: z.string().optional(), title: z.string().optional(), author_name: z.string().optional(), author_email: z.string().optional(), created_at: z.string().optional(), }).optional(), commits: z.array(GitLabCommitSchema), diffs: z.array(GitLabDiffSchema), compare_timeout: z.boolean().optional(), compare_same_ref: z.boolean().optional(), }); // Issue related schemas export const GitLabLabelSchema = z.object({ id: z.number(), name: z.string(), color: z.string(), text_color: z.string(), description: z.string().nullable(), description_html: z.string().nullable(), open_issues_count: z.number().optional(), closed_issues_count: z.number().optional(), open_merge_requests_count: z.number().optional(), subscribed: z.boolean().optional(), priority: z.number().nullable().optional(), is_project_label: z.boolean().optional(), }); export const GitLabMilestoneSchema = z.object({ id: z.number(), iid: z.number(), // Added to match GitLab API title: z.string(), description: z.string().nullable().default(""), state: z.string(), web_url: z.string(), // Changed from html_url to match GitLab API }); export const GitLabIssueSchema = z.object({ id: z.number(), iid: z.number(), // Added to match GitLab API project_id: z.number(), // Added to match GitLab API title: z.string(), description: z.string().nullable().default(""), // Changed from body to match GitLab API state: z.string(), author: GitLabUserSchema, assignees: z.array(GitLabUserSchema), labels: z.array(GitLabLabelSchema).or(z.array(z.string())), // Support both label objects and strings milestone: GitLabMilestoneSchema.nullable(), created_at: z.string(), updated_at: z.string(), closed_at: z.string().nullable(), web_url: z.string(), // Changed from html_url to match GitLab API references: z .object({ short: z.string(), relative: z.string(), full: z.string(), }) .optional(), time_stats: z .object({ time_estimate: z.number(), total_time_spent: z.number(), human_time_estimate: z.string().nullable(), human_total_time_spent: z.string().nullable(), }) .optional(), confidential: z.boolean().optional(), due_date: z.string().nullable().optional(), discussion_locked: z.boolean().nullable().optional(), weight: z.number().nullable().optional(), }); // NEW SCHEMA: For issue with link details (used in listing issue links) export const GitLabIssueWithLinkDetailsSchema = GitLabIssueSchema.extend({ issue_link_id: z.number(), link_type: z.enum(["relates_to", "blocks", "is_blocked_by"]), link_created_at: z.string(), link_updated_at: z.string(), }); // Fork related schemas export const GitLabForkParentSchema = z.object({ name: z.string(), path_with_namespace: z.string(), // Changed from full_name to match GitLab API owner: z .object({ username: z.string(), // Changed from login to match GitLab API id: z.number(), avatar_url: z.string(), }) .optional(), // Made optional to handle cases where GitLab API doesn't include it web_url: z.string(), // Changed from html_url to match GitLab API }); export const GitLabForkSchema = GitLabRepositorySchema.extend({ forked_from_project: GitLabForkParentSchema.optional(), // Made optional to handle cases where GitLab API doesn't include it }); // Merge Request related schemas (equivalent to Pull Request) export const GitLabMergeRequestDiffRefSchema = z.object({ base_sha: z.string(), head_sha: z.string(), start_sha: z.string(), }); export const GitLabMergeRequestSchema = z.object({ id: z.number(), iid: z.number(), project_id: z.number(), title: z.string(), description: z.string().nullable(), state: z.string(), merged: z.boolean().optional(), draft: z.boolean().optional(), author: GitLabUserSchema, assignees: z.array(GitLabUserSchema).optional(), reviewers: z.array(GitLabUserSchema).optional(), source_branch: z.string(), target_branch: z.string(), diff_refs: GitLabMergeRequestDiffRefSchema.nullable().optional(), web_url: z.string(), created_at: z.string(), updated_at: z.string(), merged_at: z.string().nullable(), closed_at: z.string().nullable(), merge_commit_sha: z.string().nullable(), detailed_merge_status: z.string().optional(), merge_status: z.string().optional(), merge_error: z.string().nullable().optional(), work_in_progress: z.boolean().optional(), blocking_discussions_resolved: z.boolean().optional(), should_remove_source_branch: z.boolean().nullable().optional(), force_remove_source_branch: z.boolean().nullable().optional(), allow_collaboration: z.boolean().optional(), allow_maintainer_to_push: z.boolean().optional(), changes_count: z.string().nullable().optional(), merge_when_pipeline_succeeds: z.boolean().optional(), squash: z.boolean().optional(), labels: z.array(z.string()).optional(), }); // Discussion related schemas export const GitLabDiscussionNoteSchema = z.object({ id: z.number(), type: z.enum(["DiscussionNote", "DiffNote", "Note"]).nullable(), // Allow null type for regular notes body: z.string(), attachment: z.any().nullable(), // Can be string or object, handle appropriately author: GitLabUserSchema, created_at: z.string(), updated_at: z.string(), system: z.boolean(), noteable_id: z.number(), noteable_type: z.enum(["Issue", "MergeRequest", "Snippet", "Commit", "Epic"]), project_id: z.number().optional(), // Optional for group-level discussions like Epics noteable_iid: z.number().nullable(), resolvable: z.boolean().optional(), resolved: z.boolean().optional(), resolved_by: GitLabUserSchema.nullable().optional(), resolved_at: z.string().nullable().optional(), position: z .object({ // Only present for DiffNote base_sha: z.string(), start_sha: z.string(), head_sha: z.string(), old_path: z.string(), new_path: z.string(), position_type: z.enum(["text", "image", "file"]), old_line: z.number().nullish(), // This is missing for image diffs new_line: z.number().nullish(), // This is missing for image diffs line_range: z .object({ start: z.object({ line_code: z.string(), type: z.enum(["new", "old", "expanded"]), old_line: z.number().nullish(), // This is missing for image diffs new_line: z.number().nullish(), // This is missing for image diffs }), end: z.object({ line_code: z.string(), type: z.enum(["new", "old", "expanded"]), old_line: z.number().nullish(), // This is missing for image diffs new_line: z.number().nullish(), // This is missing for image diffs }), }) .nullable() .optional(), // For multi-line diff notes width: z.number().optional(), // For image diff notes height: z.number().optional(), // For image diff notes x: z.number().optional(), // For image diff notes y: z.number().optional(), // For image diff notes }) .optional(), }); export type GitLabDiscussionNote = z.infer; export const GitLabDiscussionSchema = z.object({ id: z.string(), individual_note: z.boolean(), notes: z.array(GitLabDiscussionNoteSchema), }); export type GitLabDiscussion = z.infer; // Input schema for listing merge request discussions export const ListMergeRequestDiscussionsSchema = ProjectParamsSchema.extend({ merge_request_iid: z.number().describe("The IID of a merge request"), }); // Input schema for updating a merge request discussion note export const UpdateMergeRequestNoteSchema = ProjectParamsSchema.extend({ merge_request_iid: z.number().describe("The IID of a merge request"), discussion_id: z.string().describe("The ID of a thread"), note_id: z.number().describe("The ID of a thread note"), body: z.string().optional().describe("The content of the note or reply"), resolved: z.boolean().optional().describe("Resolve or unresolve the note"), }) .refine(data => data.body !== undefined || data.resolved !== undefined, { message: "At least one of 'body' or 'resolved' must be provided", }) .refine(data => !(data.body !== undefined && data.resolved !== undefined), { message: "Only one of 'body' or 'resolved' can be provided, not both", }); // Input schema for adding a note to an existing merge request discussion export const CreateMergeRequestNoteSchema = ProjectParamsSchema.extend({ merge_request_iid: z.number().describe("The IID of a merge request"), discussion_id: z.string().describe("The ID of a thread"), body: z.string().describe("The content of the note or reply"), created_at: z.string().optional().describe("Date the note was created at (ISO 8601 format)"), }); // Input schema for updating an issue discussion note export const UpdateIssueNoteSchema = ProjectParamsSchema.extend({ issue_iid: z.number().describe("The IID of an issue"), discussion_id: z.string().describe("The ID of a thread"), note_id: z.number().describe("The ID of a thread note"), body: z.string().describe("The content of the note or reply"), }); // Input schema for adding a note to an existing issue discussion export const CreateIssueNoteSchema = ProjectParamsSchema.extend({ issue_iid: z.number().describe("The IID of an issue"), discussion_id: z.string().describe("The ID of a thread"), body: z.string().describe("The content of the note or reply"), created_at: z.string().optional().describe("Date the note was created at (ISO 8601 format)"), }); // API Operation Parameter Schemas export const CreateOrUpdateFileSchema = ProjectParamsSchema.extend({ file_path: z.string().describe("Path where to create/update the file"), content: z.string().describe("Content of the file"), commit_message: z.string().describe("Commit message"), branch: z.string().describe("Branch to create/update the file in"), previous_path: z.string().optional().describe("Path of the file to move/rename"), last_commit_id: z.string().optional().describe("Last known file commit ID"), commit_id: z.string().optional().describe("Current file commit ID (for update operations)"), }); export const SearchRepositoriesSchema = z.object({ search: z.string().describe("Search query"), // Changed from query to match GitLab API page: z.number().optional().describe("Page number for pagination (default: 1)"), per_page: z.number().optional().describe("Number of results per page (default: 20)"), }); export const CreateRepositorySchema = z.object({ name: z.string().describe("Repository name"), description: z.string().optional().describe("Repository description"), visibility: z .enum(["private", "internal", "public"]) .optional() .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"), ref: z.string().optional().describe("Branch/tag/commit to get contents from"), }); export const PushFilesSchema = ProjectParamsSchema.extend({ branch: z.string().describe("Branch to push to"), files: z .array( z.object({ file_path: z.string().describe("Path where to create the file"), content: z.string().describe("Content of the file"), }) ) .describe("Array of files to push"), commit_message: z.string().describe("Commit message"), }); export const CreateIssueSchema = ProjectParamsSchema.extend({ title: z.string().describe("Issue title"), description: z.string().optional().describe("Issue description"), 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.number().optional().describe("Milestone ID to assign"), }); export const CreateMergeRequestSchema = ProjectParamsSchema.extend({ title: z.string().describe("Merge request title"), description: z.string().optional().describe("Merge request description"), source_branch: z.string().describe("Branch containing changes"), target_branch: z.string().describe("Branch to merge into"), assignee_ids: z .array(z.number()) .optional() .describe("The ID of the users to assign the MR to"), reviewer_ids: z .array(z.number()) .optional() .describe("The ID of the users to assign as reviewers of the MR"), 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"), }); export const ForkRepositorySchema = ProjectParamsSchema.extend({ namespace: z.string().optional().describe("Namespace to fork to (full path)"), }); // Branch related schemas export const CreateBranchSchema = ProjectParamsSchema.extend({ branch: z.string().describe("Name for the new branch"), ref: z.string().optional().describe("Source branch/commit for new branch"), }); 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().optional().describe("Comparison method: false for '...' (default), true for '--'"), excluded_file_patterns: z.array(z.string()).optional().describe( "Array of regex patterns to exclude files from the diff results. Each pattern is a JavaScript-compatible regular expression that matches file paths to ignore. Examples: [\"^test/mocks/\", \"\\.spec\\.ts$\", \"package-lock\\.json\"]" ), }); export const GetMergeRequestSchema = ProjectParamsSchema.extend({ merge_request_iid: z.number().optional().describe("The IID of a merge request"), source_branch: z.string().optional().describe("Source branch name"), }); export const UpdateMergeRequestSchema = GetMergeRequestSchema.extend({ title: z.string().optional().describe("The title of the merge request"), description: z.string().optional().describe("The description of the merge request"), target_branch: z.string().optional().describe("The target branch"), assignee_ids: z.array(z.number()).optional().describe("The ID of the users to assign the MR to"), labels: z.array(z.string()).optional().describe("Labels for the MR"), state_event: z .enum(["close", "reopen"]) .optional() .describe("New state (close/reopen) for the MR"), remove_source_branch: z .boolean() .optional() .describe("Flag indicating if the source branch should be removed"), squash: z.boolean().optional().describe("Squash commits into a single commit when merging"), draft: z.boolean().optional().describe("Work in progress merge request"), }); export const GetMergeRequestDiffsSchema = GetMergeRequestSchema.extend({ view: z.enum(["inline", "parallel"]).optional().describe("Diff view type"), }); export const CreateNoteSchema = z.object({ project_id: z.string().describe("Project ID or namespace/project_path"), noteable_type: z .enum(["issue", "merge_request"]) .describe("Type of noteable (issue or merge_request)"), noteable_iid: z.number().describe("IID of the issue or merge request"), body: z.string().describe("Note content"), }); // Issues API operation schemas export const ListIssuesSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), assignee_id: z.number().optional().describe("Return issues assigned to the given user ID"), assignee_username: z.string().optional().describe("Return issues assigned to the given username"), author_id: z.number().optional().describe("Return issues created by the given user ID"), author_username: z.string().optional().describe("Return issues created by the given username"), confidential: z.boolean().optional().describe("Filter confidential or public issues"), created_after: z.string().optional().describe("Return issues created after the given time"), created_before: z.string().optional().describe("Return issues created before the given time"), due_date: z.string().optional().describe("Return issues that have the due date"), label_name: z.array(z.string()).optional().describe("Array of label names"), milestone: z.string().optional().describe("Milestone title"), scope: z .enum(["created-by-me", "assigned-to-me", "all"]) .optional() .describe("Return issues from a specific scope"), search: z.string().optional().describe("Search for specific terms"), state: z .enum(["opened", "closed", "all"]) .optional() .describe("Return issues with a specific state"), updated_after: z.string().optional().describe("Return issues updated after the given time"), updated_before: z.string().optional().describe("Return issues updated before the given time"), with_labels_details: z.boolean().optional().describe("Return more details for each label"), page: z.number().optional().describe("Page number for pagination"), per_page: z.number().optional().describe("Number of items per page"), }); // Merge Requests API operation schemas export const ListMergeRequestsSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), assignee_id: z .number() .optional() .describe("Returns merge requests assigned to the given user ID"), assignee_username: z .string() .optional() .describe("Returns merge requests assigned to the given username"), author_id: z.number().optional().describe("Returns merge requests created by the given user ID"), author_username: z .string() .optional() .describe("Returns merge requests created by the given username"), reviewer_id: z .number() .optional() .describe("Returns merge requests which have the user as a reviewer"), reviewer_username: z .string() .optional() .describe("Returns merge requests which have the user as a reviewer"), created_after: z .string() .optional() .describe("Return merge requests created after the given time"), created_before: z .string() .optional() .describe("Return merge requests created before the given time"), updated_after: z .string() .optional() .describe("Return merge requests updated after the given time"), updated_before: z .string() .optional() .describe("Return merge requests updated before the given time"), labels: z.array(z.string()).optional().describe("Array of label names"), milestone: z.string().optional().describe("Milestone title"), scope: z .enum(["created_by_me", "assigned_to_me", "all"]) .optional() .describe("Return merge requests from a specific scope"), search: z.string().optional().describe("Search for specific terms"), state: z .enum(["opened", "closed", "locked", "merged", "all"]) .optional() .describe("Return merge requests with a specific state"), order_by: z .enum(["created_at", "updated_at", "priority", "label_priority", "milestone_due", "popularity"]) .optional() .describe("Return merge requests ordered by the given field"), sort: z .enum(["asc", "desc"]) .optional() .describe("Return merge requests sorted in ascending or descending order"), target_branch: z .string() .optional() .describe("Return merge requests targeting a specific branch"), source_branch: z .string() .optional() .describe("Return merge requests from a specific source branch"), wip: z.enum(["yes", "no"]).optional().describe("Filter merge requests against their wip status"), with_labels_details: z.boolean().optional().describe("Return more details for each label"), page: z.number().optional().describe("Page number for pagination"), per_page: z.number().optional().describe("Number of items per page"), }); export const GetIssueSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), issue_iid: z.number().describe("The internal ID of the project issue"), }); export const UpdateIssueSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), issue_iid: z.number().describe("The internal ID of the project issue"), title: z.string().optional().describe("The title of the issue"), description: z.string().optional().describe("The description of the issue"), assignee_ids: z.array(z.number()).optional().describe("Array of user IDs to assign issue to"), confidential: z.boolean().optional().describe("Set the issue to be confidential"), discussion_locked: z.boolean().optional().describe("Flag to lock discussions"), due_date: z.string().optional().describe("Date the issue is due (YYYY-MM-DD)"), labels: z.array(z.string()).optional().describe("Array of label names"), milestone_id: z.number().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)"), }); export const DeleteIssueSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), issue_iid: z.number().describe("The internal ID of the project issue"), }); // Issue links related schemas export const GitLabIssueLinkSchema = z.object({ source_issue: GitLabIssueSchema, target_issue: GitLabIssueSchema, link_type: z.enum(["relates_to", "blocks", "is_blocked_by"]), }); export const ListIssueLinksSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), issue_iid: z.number().describe("The internal ID of a project's issue"), }); export const ListIssueDiscussionsSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), issue_iid: z.number().describe("The internal ID of the project issue"), page: z.number().optional().describe("Page number for pagination"), per_page: z.number().optional().describe("Number of items per page"), sort: z .enum(["asc", "desc"]) .optional() .describe("Return issue discussions sorted in ascending or descending order"), order_by: z .enum(["created_at", "updated_at"]) .optional() .describe("Return issue discussions ordered by created_at or updated_at fields"), }); export const GetIssueLinkSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), issue_iid: z.number().describe("The internal ID of a project's issue"), issue_link_id: z.number().describe("ID of an issue relationship"), }); export const CreateIssueLinkSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), issue_iid: z.number().describe("The internal ID of a project's issue"), target_project_id: z.string().describe("The ID or URL-encoded path of a target project"), target_issue_iid: z.number().describe("The internal ID of a target project's issue"), link_type: z .enum(["relates_to", "blocks", "is_blocked_by"]) .optional() .describe("The type of the relation, defaults to relates_to"), }); export const DeleteIssueLinkSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), issue_iid: z.number().describe("The internal ID of a project's issue"), issue_link_id: z.number().describe("The ID of an issue relationship"), }); // Namespace API operation schemas export const ListNamespacesSchema = z.object({ search: z.string().optional().describe("Search term for namespaces"), page: z.number().optional().describe("Page number for pagination"), per_page: z.number().optional().describe("Number of items per page"), owned: z.boolean().optional().describe("Filter for namespaces owned by current user"), }); export const GetNamespaceSchema = z.object({ namespace_id: z.string().describe("Namespace ID or full path"), }); export const VerifyNamespaceSchema = z.object({ path: z.string().describe("Namespace path to verify"), }); // Project API operation schemas export const GetProjectSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), }); export const ListProjectsSchema = z.object({ search: z.string().optional().describe("Search term for projects"), page: z.number().optional().describe("Page number for pagination"), per_page: z.number().optional().describe("Number of items per page"), 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().optional().describe("Filter for projects where current user is a member"), simple: z.boolean().optional().describe("Return only limited fields"), archived: z.boolean().optional().describe("Filter for archived projects"), visibility: z .enum(["public", "internal", "private"]) .optional() .describe("Filter by project visibility"), order_by: z .enum(["id", "name", "path", "created_at", "updated_at", "last_activity_at"]) .optional() .describe("Return projects ordered by field"), sort: z .enum(["asc", "desc"]) .optional() .describe("Return projects sorted in ascending or descending order"), with_issues_enabled: z .boolean() .optional() .describe("Filter projects with issues feature enabled"), with_merge_requests_enabled: z .boolean() .optional() .describe("Filter projects with merge requests feature enabled"), min_access_level: z.number().optional().describe("Filter by minimum access level"), }); // Label operation schemas export const ListLabelsSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), with_counts: z .boolean() .optional() .describe("Whether or not to include issue and merge request counts"), include_ancestor_groups: z.boolean().optional().describe("Include ancestor groups"), search: z.string().optional().describe("Keyword to filter labels by"), }); export const GetLabelSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), label_id: z.string().describe("The ID or title of a project's label"), include_ancestor_groups: z.boolean().optional().describe("Include ancestor groups"), }); export const CreateLabelSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), name: z.string().describe("The name of the label"), color: z .string() .describe("The color of the label given in 6-digit hex notation with leading '#' sign"), description: z.string().optional().describe("The description of the label"), priority: z.number().nullable().optional().describe("The priority of the label"), }); export const UpdateLabelSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), label_id: z.string().describe("The ID or title of a project's label"), new_name: z.string().optional().describe("The new name of the label"), color: z .string() .optional() .describe("The color of the label given in 6-digit hex notation with leading '#' sign"), description: z.string().optional().describe("The new description of the label"), priority: z.number().nullable().optional().describe("The new priority of the label"), }); export const DeleteLabelSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), label_id: z.string().describe("The ID or title of a project's label"), }); // Group projects schema export const ListGroupProjectsSchema = z.object({ group_id: z.string().describe("Group ID or path"), include_subgroups: z.boolean().optional().describe("Include projects from subgroups"), search: z.string().optional().describe("Search term to filter projects"), order_by: z .enum(["name", "path", "created_at", "updated_at", "last_activity_at"]) .optional() .describe("Field to sort by"), sort: z.enum(["asc", "desc"]).optional().describe("Sort direction"), page: z.number().optional().describe("Page number"), per_page: z.number().optional().describe("Number of results per page"), archived: z.boolean().optional().describe("Filter for archived projects"), visibility: z .enum(["public", "internal", "private"]) .optional() .describe("Filter by project visibility"), with_issues_enabled: z .boolean() .optional() .describe("Filter projects with issues feature enabled"), with_merge_requests_enabled: z .boolean() .optional() .describe("Filter projects with merge requests feature enabled"), min_access_level: z.number().optional().describe("Filter by minimum access level"), with_programming_language: z.string().optional().describe("Filter by programming language"), starred: z.boolean().optional().describe("Filter by starred projects"), statistics: z.boolean().optional().describe("Include project statistics"), with_custom_attributes: z.boolean().optional().describe("Include custom attributes"), with_security_reports: z.boolean().optional().describe("Include security reports"), }); // Add wiki operation schemas export const ListWikiPagesSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), page: z.number().optional().describe("Page number for pagination"), per_page: z.number().optional().describe("Number of items per page"), }); export const GetWikiPageSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), slug: z.string().describe("URL-encoded slug of the wiki page"), }); export const CreateWikiPageSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), title: z.string().describe("Title of the wiki page"), content: z.string().describe("Content of the wiki page"), format: z.string().optional().describe("Content format, e.g., markdown, rdoc"), }); export const UpdateWikiPageSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), slug: z.string().describe("URL-encoded slug of the wiki page"), title: z.string().optional().describe("New title of the wiki page"), content: z.string().optional().describe("New content of the wiki page"), format: z.string().optional().describe("Content format, e.g., markdown, rdoc"), }); export const DeleteWikiPageSchema = z.object({ project_id: z.string().describe("Project ID or URL-encoded path"), slug: z.string().describe("URL-encoded slug of the wiki page"), }); // Define wiki response schemas export const GitLabWikiPageSchema = z.object({ title: z.string(), slug: z.string(), format: z.string(), content: z.string(), created_at: z.string().optional(), updated_at: z.string().optional(), }); // Merge Request Thread position schema - used for diff notes export const MergeRequestThreadPositionSchema = z.object({ base_sha: z.string().describe("Base commit SHA in the source branch"), head_sha: z.string().describe("SHA referencing HEAD of the source branch"), start_sha: z.string().describe("SHA referencing the start commit of the source branch"), position_type: z.enum(["text", "image", "file"]).describe("Type of position reference"), new_path: z.string().optional().describe("File path after change"), old_path: z.string().optional().describe("File path before change"), new_line: z.number().nullable().optional().describe("Line number after change"), old_line: z.number().nullable().optional().describe("Line number before change"), width: z.number().optional().describe("Width of the image (for image diffs)"), height: z.number().optional().describe("Height of the image (for image diffs)"), x: z.number().optional().describe("X coordinate on the image (for image diffs)"), y: z.number().optional().describe("Y coordinate on the image (for image diffs)"), }); // Schema for creating a new merge request thread export const CreateMergeRequestThreadSchema = ProjectParamsSchema.extend({ merge_request_iid: z.number().describe("The IID of a merge request"), body: z.string().describe("The content of the thread"), position: MergeRequestThreadPositionSchema.optional().describe( "Position when creating a diff note" ), created_at: z.string().optional().describe("Date the thread was created at (ISO 8601 format)"), }); // Milestone related schemas // Schema for listing project milestones export const ListProjectMilestonesSchema = ProjectParamsSchema.extend({ iids: z.array(z.number()).optional().describe("Return only the milestones having the given iid"), state: z .enum(["active", "closed"]) .optional() .describe("Return only active or closed milestones"), title: z .string() .optional() .describe("Return only milestones with a title matching the provided string"), search: z .string() .optional() .describe("Return only milestones with a title or description matching the provided string"), include_ancestors: z.boolean().optional().describe("Include ancestor groups"), updated_before: z .string() .optional() .describe("Return milestones updated before the specified date (ISO 8601 format)"), updated_after: z .string() .optional() .describe("Return milestones updated after the specified date (ISO 8601 format)"), page: z.number().optional().describe("Page number for pagination"), per_page: z.number().optional().describe("Number of items per page (max 100)"), }); // Schema for getting a single milestone export const GetProjectMilestoneSchema = ProjectParamsSchema.extend({ milestone_id: z.number().describe("The ID of a project milestone"), }); // Schema for creating a new milestone export const CreateProjectMilestoneSchema = ProjectParamsSchema.extend({ title: z.string().describe("The title of the milestone"), description: z.string().optional().describe("The description of the milestone"), due_date: z.string().optional().describe("The due date of the milestone (YYYY-MM-DD)"), start_date: z.string().optional().describe("The start date of the milestone (YYYY-MM-DD)"), }); // Schema for editing a milestone export const EditProjectMilestoneSchema = GetProjectMilestoneSchema.extend({ title: z.string().optional().describe("The title of the milestone"), description: z.string().optional().describe("The description of the milestone"), due_date: z.string().optional().describe("The due date of the milestone (YYYY-MM-DD)"), start_date: z.string().optional().describe("The start date of the milestone (YYYY-MM-DD)"), state_event: z .enum(["close", "activate"]) .optional() .describe("The state event of the milestone"), }); // Schema for deleting a milestone export const DeleteProjectMilestoneSchema = GetProjectMilestoneSchema; // Schema for getting issues assigned to a milestone export const GetMilestoneIssuesSchema = GetProjectMilestoneSchema; // Schema for getting merge requests assigned to a milestone export const GetMilestoneMergeRequestsSchema = GetProjectMilestoneSchema.extend({ page: z.number().optional().describe("Page number for pagination"), per_page: z.number().optional().describe("Number of items per page (max 100)"), }); // Schema for promoting a project milestone to a group milestone export const PromoteProjectMilestoneSchema = GetProjectMilestoneSchema; // Schema for getting burndown chart events for a milestone export const GetMilestoneBurndownEventsSchema = GetProjectMilestoneSchema.extend({ page: z.number().optional().describe("Page number for pagination"), per_page: z.number().optional().describe("Number of items per page (max 100)"), }); // Export types export type GitLabAuthor = z.infer; export type GitLabFork = z.infer; export type GitLabIssue = z.infer; export type GitLabIssueWithLinkDetails = z.infer; export type GitLabMergeRequest = z.infer; export type GitLabRepository = z.infer; export type GitLabFileContent = z.infer; export type GitLabDirectoryContent = z.infer; export type GitLabContent = z.infer; export type FileOperation = z.infer; export type GitLabTree = z.infer; export type GitLabCompareResult = z.infer; export type GitLabCommit = z.infer; export type GitLabReference = z.infer; export type CreateRepositoryOptions = z.infer; export type CreateIssueOptions = z.infer; export type CreateMergeRequestOptions = z.infer; export type CreateBranchOptions = z.infer; export type GitLabCreateUpdateFileResponse = z.infer; export type GitLabSearchResponse = z.infer; export type GitLabMergeRequestDiff = z.infer< typeof GitLabDiffSchema >; export type CreateNoteOptions = z.infer; export type GitLabIssueLink = z.infer; export type ListIssueDiscussionsOptions = z.infer; export type UpdateIssueNoteOptions = z.infer; export type CreateIssueNoteOptions = z.infer; export type GitLabNamespace = z.infer; export type GitLabNamespaceExistsResponse = z.infer; export type GitLabProject = z.infer; export type GitLabLabel = z.infer; export type ListWikiPagesOptions = z.infer; export type GetWikiPageOptions = z.infer; export type CreateWikiPageOptions = z.infer; export type UpdateWikiPageOptions = z.infer; export type DeleteWikiPageOptions = z.infer; export type GitLabWikiPage = z.infer; export type GitLabTreeItem = z.infer; export type GetRepositoryTreeOptions = z.infer; export type MergeRequestThreadPosition = z.infer; export type CreateMergeRequestThreadOptions = z.infer; export type CreateMergeRequestNoteOptions = z.infer; export type GitLabPipelineJob = z.infer; export type GitLabPipeline = z.infer; export type ListPipelinesOptions = z.infer; export type GetPipelineOptions = z.infer; export type ListPipelineJobsOptions = z.infer; export type CreatePipelineOptions = z.infer; export type RetryPipelineOptions = z.infer; export type CancelPipelineOptions = z.infer; export type GitLabMilestones = z.infer; export type ListProjectMilestonesOptions = z.infer; export type GetProjectMilestoneOptions = z.infer; export type CreateProjectMilestoneOptions = z.infer; export type EditProjectMilestoneOptions = z.infer; export type DeleteProjectMilestoneOptions = z.infer; export type GetMilestoneIssuesOptions = z.infer; export type GetMilestoneMergeRequestsOptions = z.infer; export type PromoteProjectMilestoneOptions = z.infer; export type GetMilestoneBurndownEventsOptions = z.infer; export type GitLabUser = z.infer; export type GitLabUsersResponse = z.infer;