@zereight/mcp-gitlab 2.1.16 → 2.1.18

package/build/schemas.js

@@ -3057,14 +3057,15 @@ export const GitLabTagSignatureSchema = z.object({
 // --- Work item schemas (GraphQL-based) ---
 // Case-insensitive work item type enum (accepts "ISSUE", "Issue", "issue")
 const workItemTypeEnum = z.string().transform(v => v.toLowerCase()).pipe(z.enum(["issue", "task", "incident", "test_case", "epic", "key_result", "objective", "requirement", "ticket"]));
+const ProjectIdOrPathSchema = z.coerce.string().describe("Project ID, URL-encoded project path, or group path (e.g. 'group/subgroup' for group-level work items)");
 // Common params for work item tools
 const WorkItemParamsSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    project_id: ProjectIdOrPathSchema,
     iid: z.coerce.number().describe("The internal ID (IID) of the work item"),
 });
 export const GetWorkItemSchema = WorkItemParamsSchema;
 export const ListWorkItemsSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    project_id: ProjectIdOrPathSchema,
     types: z
         .array(workItemTypeEnum)
         .optional()
@@ -3096,7 +3097,7 @@ export const ListWorkItemsSchema = z.object({
         .describe("Cursor for pagination (from previous response's endCursor)"),
 });
 export const CreateWorkItemSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    project_id: ProjectIdOrPathSchema,
     title: z.string().describe("Title of the work item"),
     type: workItemTypeEnum
         .optional()
@@ -3166,38 +3167,38 @@ export const UpdateWorkItemSchema = WorkItemParamsSchema.extend({
         .describe("Incident only: set escalation status"),
 });
 export const ConvertWorkItemTypeSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    project_id: ProjectIdOrPathSchema,
     iid: z.coerce.number().describe("The internal ID of the work item"),
     new_type: workItemTypeEnum.describe("The target work item type to convert to"),
 });
 export const ListWorkItemStatusesSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    project_id: ProjectIdOrPathSchema,
     work_item_type: workItemTypeEnum
         .optional()
         .default("issue")
         .describe("The work item type to list available statuses for. Defaults to 'issue'."),
 });
 export const ListWorkItemNotesSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    project_id: ProjectIdOrPathSchema,
     iid: z.coerce.number().describe("The internal ID of the work item"),
     page_size: z.coerce.number().optional().default(20).describe("Number of discussions to return (default 20)"),
     after: z.string().optional().describe("Cursor for pagination"),
     sort: z.enum(["CREATED_ASC", "CREATED_DESC"]).optional().default("CREATED_ASC").describe("Sort order for discussions"),
 });
 export const CreateWorkItemNoteSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    project_id: ProjectIdOrPathSchema,
     iid: z.coerce.number().describe("The internal ID of the work item"),
     body: z.string().describe("Note body (Markdown supported)"),
     internal: z.coerce.boolean().optional().default(false).describe("Create as internal/confidential note (only visible to project members)"),
     discussion_id: z.string().optional().describe("Discussion ID to reply to (for threaded replies). If omitted, creates a new top-level note."),
 });
 export const MoveWorkItemSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path of the source project"),
+    project_id: z.coerce.string().describe("Project ID, URL-encoded project path, or group path of the source namespace"),
     iid: z.coerce.number().describe("The internal ID of the work item to move"),
-    target_project_id: z.coerce.string().describe("Project ID or URL-encoded path of the target project"),
+    target_project_id: z.coerce.string().describe("Project ID, URL-encoded project path, or group path of the target namespace"),
 });
 export const ListCustomFieldDefinitionsSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    project_id: ProjectIdOrPathSchema,
     work_item_type: workItemTypeEnum
         .optional()
         .default("issue")
@@ -3249,23 +3250,23 @@ export const DeleteIssueNoteEmojiReactionSchema = ProjectParamsSchema.extend({
 });
 // --- Emoji Reaction schemas (GraphQL: Work Items) ---
 export const CreateWorkItemEmojiReactionSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    project_id: ProjectIdOrPathSchema,
     iid: z.coerce.number().describe("The internal ID of the work item"),
     name: emojiNameField,
 });
 export const DeleteWorkItemEmojiReactionSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    project_id: ProjectIdOrPathSchema,
     iid: z.coerce.number().describe("The internal ID of the work item"),
     name: emojiNameField,
 });
 export const CreateWorkItemNoteEmojiReactionSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    project_id: ProjectIdOrPathSchema,
     iid: z.coerce.number().describe("The internal ID of the work item"),
     note_id: z.string().describe("The GraphQL GID of the note (e.g. 'gid://gitlab/Note/123' from list_work_item_notes)"),
     name: emojiNameField,
 });
 export const DeleteWorkItemNoteEmojiReactionSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    project_id: ProjectIdOrPathSchema,
     iid: z.coerce.number().describe("The internal ID of the work item"),
     note_id: z.string().describe("The GraphQL GID of the note (e.g. 'gid://gitlab/Note/123' from list_work_item_notes)"),
     name: emojiNameField,
@@ -3287,11 +3288,11 @@ export const ListIssueNoteEmojiReactionsSchema = ProjectParamsSchema.extend({
     discussion_id: noteEmojiDiscussionField,
 });
 export const ListWorkItemEmojiReactionsSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    project_id: ProjectIdOrPathSchema,
     iid: z.coerce.number().describe("The internal ID of the work item"),
 });
 export const ListWorkItemNoteEmojiReactionsSchema = z.object({
-    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    project_id: ProjectIdOrPathSchema,
     iid: z.coerce.number().describe("The internal ID of the work item"),
     note_id: z.string().describe("The GraphQL GID of the note (e.g. 'gid://gitlab/Note/123' from list_work_item_notes)"),
 });
@@ -3377,3 +3378,164 @@ export const GetWebhookEventSchema = z
     message: "Provide exactly one of project_id or group_id",
 });
 export const HealthCheckSchema = z.object({});
+// --- CI/CD Variable types ---
+export const GitLabCiVariableSchema = z.object({
+    variable_type: z.enum(["env_var", "file"]).optional(),
+    key: z.string(),
+    value: z.string().nullable(),
+    protected: z.boolean().optional(),
+    masked: z.boolean().optional(),
+    hidden: z.boolean().optional(),
+    raw: z.boolean().optional(),
+    environment_scope: z.string().optional(),
+    description: z.string().nullable().optional(),
+});
+const ciVariableFields = {
+    key: z.string().describe("The key of the variable (must match /[a-zA-Z0-9_]+/)"),
+    value: z.string().describe("The value of the variable"),
+    variable_type: z
+        .enum(["env_var", "file"])
+        .optional()
+        .describe("The type of variable: 'env_var' (default) or 'file'"),
+    protected: z
+        .boolean()
+        .optional()
+        .describe("Whether the variable is only available on protected branches/tags"),
+    masked: z.boolean().optional().describe("Whether the variable value is masked in job logs"),
+    raw: z.boolean().optional().describe("Whether the variable is not expanded (treated as raw string)"),
+    environment_scope: z
+        .string()
+        .optional()
+        .describe("Environment scope (e.g. '*', 'production'). Default: '*'"),
+    description: z.string().optional().describe("Description of the variable"),
+};
+export const ListProjectVariablesSchema = z
+    .object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    filter: z
+        .object({ environment_scope: z.string() })
+        .optional()
+        .describe("Filter by environment scope (e.g. '*', 'production')"),
+})
+    .merge(PaginationOptionsSchema);
+export const GetProjectVariableSchema = z.object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    key: z.string().describe("The key of the variable"),
+    filter: z
+        .object({ environment_scope: z.string() })
+        .optional()
+        .describe("Filter by environment scope"),
+});
+export const CreateProjectVariableSchema = z.object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    ...ciVariableFields,
+});
+export const UpdateProjectVariableSchema = z.object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    key: z.string().describe("The key of the variable to update"),
+    value: z.string().describe("The new value of the variable"),
+    variable_type: z.enum(["env_var", "file"]).optional().describe("The type of variable"),
+    protected: z.boolean().optional().describe("Whether the variable is protected"),
+    masked: z.boolean().optional().describe("Whether the variable value is masked in job logs"),
+    raw: z.boolean().optional().describe("Whether the variable is not expanded"),
+    environment_scope: z
+        .string()
+        .optional()
+        .describe("New environment scope to assign to the variable (renames the scope, e.g. '*', 'production'). Use filter.environment_scope to identify which variable to update when multiple share the same key."),
+    description: z.string().optional().describe("Description of the variable"),
+    filter: z
+        .object({ environment_scope: z.string() })
+        .optional()
+        .describe("Identifies which variable to update when multiple variables share the same key across different environment scopes"),
+});
+export const DeleteProjectVariableSchema = z.object({
+    project_id: z.coerce.string().describe("Project ID or URL-encoded path"),
+    key: z.string().describe("The key of the variable to delete"),
+    filter: z
+        .object({ environment_scope: z.string() })
+        .optional()
+        .describe("Filter by environment scope to disambiguate when multiple variables share the same key"),
+});
+export const ListGroupVariablesSchema = z
+    .object({
+    group_id: z.coerce.string().describe("Group ID or URL-encoded path"),
+    filter: z
+        .object({ environment_scope: z.string() })
+        .optional()
+        .describe("Filter by environment scope (e.g. '*', 'production')"),
+})
+    .merge(PaginationOptionsSchema);
+export const GetGroupVariableSchema = z.object({
+    group_id: z.coerce.string().describe("Group ID or URL-encoded path"),
+    key: z.string().describe("The key of the variable"),
+    filter: z
+        .object({ environment_scope: z.string() })
+        .optional()
+        .describe("Filter by environment scope"),
+});
+export const CreateGroupVariableSchema = z.object({
+    group_id: z.coerce.string().describe("Group ID or URL-encoded path"),
+    ...ciVariableFields,
+});
+export const UpdateGroupVariableSchema = z.object({
+    group_id: z.coerce.string().describe("Group ID or URL-encoded path"),
+    key: z.string().describe("The key of the variable to update"),
+    value: z.string().describe("The new value of the variable"),
+    variable_type: z.enum(["env_var", "file"]).optional().describe("The type of variable"),
+    protected: z.boolean().optional().describe("Whether the variable is protected"),
+    masked: z.boolean().optional().describe("Whether the variable value is masked in job logs"),
+    raw: z.boolean().optional().describe("Whether the variable is not expanded"),
+    environment_scope: z
+        .string()
+        .optional()
+        .describe("New environment scope to assign to the variable (renames the scope, e.g. '*', 'production'). Use filter.environment_scope to identify which variable to update when multiple share the same key."),
+    description: z.string().optional().describe("Description of the variable"),
+    filter: z
+        .object({ environment_scope: z.string() })
+        .optional()
+        .describe("Identifies which variable to update when multiple variables share the same key across different environment scopes"),
+});
+export const DeleteGroupVariableSchema = z.object({
+    group_id: z.coerce.string().describe("Group ID or URL-encoded path"),
+    key: z.string().describe("The key of the variable to delete"),
+    filter: z
+        .object({ environment_scope: z.string() })
+        .optional()
+        .describe("Filter by environment scope to disambiguate when multiple variables share the same key"),
+});
+// --- Dependency Proxy types ---
+export const GitLabDependencyProxySchema = z.object({
+    enabled: z.boolean(),
+    blob_count: z.number().nullable().optional(),
+    total_size: z.string().nullable().optional(),
+    image_prefix: z.string().nullable().optional(),
+    ttl_policy: z
+        .object({
+        enabled: z.boolean(),
+        ttl: z.number().nullable().optional(),
+    })
+        .nullable()
+        .optional(),
+});
+export const GitLabDependencyProxyBlobSchema = z.object({
+    file_name: z.string(),
+    size: z.string(),
+    created_at: z.string().nullable().optional(),
+});
+export const GetDependencyProxySettingsSchema = z.object({
+    group_id: z.coerce.string().describe("Group ID or URL-encoded path"),
+});
+export const UpdateDependencyProxySettingsSchema = z.object({
+    group_id: z.coerce.string().describe("Group ID or URL-encoded path"),
+    enabled: z.boolean().optional().describe("Enable or disable the dependency proxy"),
+    identity: z.string().optional().describe("Proxy username for authenticated Docker Hub pulls (Premium/Ultimate)"),
+    secret: z.string().optional().describe("Proxy password / access token for authenticated pulls"),
+});
+export const ListDependencyProxyBlobsSchema = z.object({
+    group_id: z.coerce.string().describe("Group ID or URL-encoded path"),
+    first: z.number().int().optional().describe("Number of blobs to return (default: 20)"),
+    after: z.string().optional().describe("Cursor for pagination (from previous response pageInfo.endCursor)"),
+});
+export const PurgeDependencyProxyCacheSchema = z.object({
+    group_id: z.coerce.string().describe("Group ID or URL-encoded path"),
+});

package/build/test/schema-tests.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env ts-node
-import { GetFileContentsSchema, GitLabFileContentSchema, GitLabRepositorySchema, CreatePipelineSchema, CreateCommitStatusSchema, ListCommitStatusesSchema, CreateIssueNoteSchema, CreateMergeRequestEmojiReactionSchema, CreateIssueEmojiReactionSchema, DeleteMergeRequestEmojiReactionSchema, DeleteIssueEmojiReactionSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, CreateIssueSchema, ListIssuesSchema, ListMergeRequestsSchema, ListLabelsSchema, GitLabMergeRequestSchema, GitLabTreeItemSchema, GetMergeRequestSchema, ListMergeRequestPipelinesSchema, GetRepositoryTreeSchema, GitLabUserFullSchema, GitLabMarkdownUploadSchema, } from '../schemas.js';
+import { GetFileContentsSchema, GitLabFileContentSchema, GitLabRepositorySchema, CreatePipelineSchema, CreateCommitStatusSchema, ListCommitStatusesSchema, CreateIssueNoteSchema, CreateMergeRequestEmojiReactionSchema, CreateIssueEmojiReactionSchema, DeleteMergeRequestEmojiReactionSchema, DeleteIssueEmojiReactionSchema, CreateWorkItemEmojiReactionSchema, CreateWorkItemNoteEmojiReactionSchema, CreateIssueSchema, ListIssuesSchema, ListMergeRequestsSchema, ListLabelsSchema, GitLabMergeRequestSchema, GitLabTreeItemSchema, GetMergeRequestSchema, ListMergeRequestPipelinesSchema, GetRepositoryTreeSchema, GitLabUserFullSchema, GitLabMarkdownUploadSchema, GitLabDependencyProxySchema, GitLabDependencyProxyBlobSchema, } from '../schemas.js';
 function runGetFileContentsSchemaTests() {
     console.log('🧪 Testing GetFileContentsSchema...');
     const cases = [
@@ -1385,6 +1385,106 @@ function runGitLabUserFullSchemaTests() {
     console.log(`\nResults: ${passed} passed, ${failed} failed`);
     return { passed, failed };
 }
+function runGitLabDependencyProxySchemaTests() {
+    console.log('🧪 Testing GitLabDependencyProxySchema...');
+    const cases = [
+        {
+            name: 'schema:dependency_proxy:minimal',
+            input: { enabled: true, blob_count: 0, total_size: '0' },
+            shouldFail: false,
+        },
+        {
+            name: 'schema:dependency_proxy:full',
+            input: {
+                enabled: true,
+                blob_count: 42,
+                total_size: '1234567890',
+                image_prefix: 'gitlab.example.com:5050/my-group/dependency_proxy/containers',
+                ttl_policy: { enabled: true, ttl: 90 },
+            },
+            shouldFail: false,
+        },
+        {
+            name: 'schema:dependency_proxy:nulls-allowed',
+            input: { enabled: false, blob_count: null, total_size: null, image_prefix: null, ttl_policy: null },
+            shouldFail: false,
+        },
+    ];
+    let passed = 0;
+    let failed = 0;
+    cases.forEach(testCase => {
+        const result = { name: testCase.name, status: 'failed' };
+        const parsed = GitLabDependencyProxySchema.safeParse(testCase.input);
+        if (testCase.shouldFail) {
+            result.status = parsed.success ? 'failed' : 'passed';
+            if (parsed.success)
+                result.error = 'Expected schema validation to fail';
+        }
+        else if (parsed.success) {
+            result.status = 'passed';
+        }
+        else {
+            result.error = parsed.error?.message || 'Schema validation failed';
+        }
+        if (result.status === 'passed') {
+            passed++;
+            console.log(`✅ ${result.name}`);
+        }
+        else {
+            failed++;
+            console.log(`❌ ${result.name}: ${result.error}`);
+        }
+    });
+    console.log(`\nResults: ${passed} passed, ${failed} failed`);
+    return { passed, failed };
+}
+function runGitLabDependencyProxyBlobSchemaTests() {
+    console.log('🧪 Testing GitLabDependencyProxyBlobSchema...');
+    const cases = [
+        {
+            name: 'schema:dependency_proxy_blob:basic',
+            input: { file_name: 'sha256:abc123', size: '2.5 MiB', created_at: '2026-01-01T00:00:00Z' },
+            shouldFail: false,
+        },
+        {
+            name: 'schema:dependency_proxy_blob:no-created-at',
+            input: { file_name: 'sha256:def456', size: '512 KiB' },
+            shouldFail: false,
+        },
+        {
+            name: 'schema:dependency_proxy_blob:size-must-be-string',
+            input: { file_name: 'sha256:ghi789', size: 12345 },
+            shouldFail: true,
+        },
+    ];
+    let passed = 0;
+    let failed = 0;
+    cases.forEach(testCase => {
+        const result = { name: testCase.name, status: 'failed' };
+        const parsed = GitLabDependencyProxyBlobSchema.safeParse(testCase.input);
+        if (testCase.shouldFail) {
+            result.status = parsed.success ? 'failed' : 'passed';
+            if (parsed.success)
+                result.error = 'Expected schema validation to fail';
+        }
+        else if (parsed.success) {
+            result.status = 'passed';
+        }
+        else {
+            result.error = parsed.error?.message || 'Schema validation failed';
+        }
+        if (result.status === 'passed') {
+            passed++;
+            console.log(`✅ ${result.name}`);
+        }
+        else {
+            failed++;
+            console.log(`❌ ${result.name}: ${result.error}`);
+        }
+    });
+    console.log(`\nResults: ${passed} passed, ${failed} failed`);
+    return { passed, failed };
+}
 if (import.meta.url === `file://${process.argv[1]}`) {
     const getFileContentsResult = runGetFileContentsSchemaTests();
     const fileContentResult = runGitLabFileContentSchemaTests();
@@ -1403,8 +1503,10 @@ if (import.meta.url === `file://${process.argv[1]}`) {
     const repositoryTreeResult = runGetRepositoryTreeSchemaTests();
     const gitLabUserFullResult = runGitLabUserFullSchemaTests();
     const gitLabMarkdownUploadResult = runGitLabMarkdownUploadSchemaTests();
-    const totalPassed = getFileContentsResult.passed + fileContentResult.passed + createPipelineResult.passed + commitStatusResult.passed + createIssueNoteResult.passed + getMergeRequestResult.passed + listMergeRequestPipelinesResult.passed + gitLabMergeRequestResult.passed + emojiReactionResult.passed + repositorySchemaResult.passed + labelsCoercionResult.passed + approvedByUsernamesResult.passed + listLabelsResult.passed + treeItemResult.passed + repositoryTreeResult.passed + gitLabUserFullResult.passed + gitLabMarkdownUploadResult.passed;
-    const totalFailed = getFileContentsResult.failed + fileContentResult.failed + createPipelineResult.failed + commitStatusResult.failed + createIssueNoteResult.failed + getMergeRequestResult.failed + listMergeRequestPipelinesResult.failed + gitLabMergeRequestResult.failed + emojiReactionResult.failed + repositorySchemaResult.failed + labelsCoercionResult.failed + approvedByUsernamesResult.failed + listLabelsResult.failed + treeItemResult.failed + repositoryTreeResult.failed + gitLabUserFullResult.failed + gitLabMarkdownUploadResult.failed;
+    const dependencyProxyResult = runGitLabDependencyProxySchemaTests();
+    const dependencyProxyBlobResult = runGitLabDependencyProxyBlobSchemaTests();
+    const totalPassed = getFileContentsResult.passed + fileContentResult.passed + createPipelineResult.passed + commitStatusResult.passed + createIssueNoteResult.passed + getMergeRequestResult.passed + listMergeRequestPipelinesResult.passed + gitLabMergeRequestResult.passed + emojiReactionResult.passed + repositorySchemaResult.passed + labelsCoercionResult.passed + approvedByUsernamesResult.passed + listLabelsResult.passed + treeItemResult.passed + repositoryTreeResult.passed + gitLabUserFullResult.passed + gitLabMarkdownUploadResult.passed + dependencyProxyResult.passed + dependencyProxyBlobResult.passed;
+    const totalFailed = getFileContentsResult.failed + fileContentResult.failed + createPipelineResult.failed + commitStatusResult.failed + createIssueNoteResult.failed + getMergeRequestResult.failed + listMergeRequestPipelinesResult.failed + gitLabMergeRequestResult.failed + emojiReactionResult.failed + repositorySchemaResult.failed + labelsCoercionResult.failed + approvedByUsernamesResult.failed + listLabelsResult.failed + treeItemResult.failed + repositoryTreeResult.failed + gitLabUserFullResult.failed + gitLabMarkdownUploadResult.failed + dependencyProxyResult.failed + dependencyProxyBlobResult.failed;
     console.log(`\nTotal Results: ${totalPassed} passed, ${totalFailed} failed`);
     if (totalFailed > 0) {
         process.exit(1);