@ekho/gitlab-mcp 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (226) hide show
  1. package/LICENSE +21 -0
  2. package/PLAN.md +517 -0
  3. package/README.md +429 -0
  4. package/dist/config.d.ts +35 -0
  5. package/dist/config.js +59 -0
  6. package/dist/config.js.map +1 -0
  7. package/dist/groups/access_tokens/tools.d.ts +3 -0
  8. package/dist/groups/access_tokens/tools.js +198 -0
  9. package/dist/groups/access_tokens/tools.js.map +1 -0
  10. package/dist/groups/admin/tools.d.ts +3 -0
  11. package/dist/groups/admin/tools.js +136 -0
  12. package/dist/groups/admin/tools.js.map +1 -0
  13. package/dist/groups/ai_catalog/queries.d.ts +3 -0
  14. package/dist/groups/ai_catalog/queries.js +75 -0
  15. package/dist/groups/ai_catalog/queries.js.map +1 -0
  16. package/dist/groups/ai_catalog/tools.d.ts +3 -0
  17. package/dist/groups/ai_catalog/tools.js +40 -0
  18. package/dist/groups/ai_catalog/tools.js.map +1 -0
  19. package/dist/groups/analytics/queries.d.ts +1 -0
  20. package/dist/groups/analytics/queries.js +28 -0
  21. package/dist/groups/analytics/queries.js.map +1 -0
  22. package/dist/groups/analytics/tools.d.ts +3 -0
  23. package/dist/groups/analytics/tools.js +110 -0
  24. package/dist/groups/analytics/tools.js.map +1 -0
  25. package/dist/groups/audit_events/tools.d.ts +3 -0
  26. package/dist/groups/audit_events/tools.js +112 -0
  27. package/dist/groups/audit_events/tools.js.map +1 -0
  28. package/dist/groups/boards/tools.d.ts +3 -0
  29. package/dist/groups/boards/tools.js +46 -0
  30. package/dist/groups/boards/tools.js.map +1 -0
  31. package/dist/groups/branches/tools.d.ts +3 -0
  32. package/dist/groups/branches/tools.js +122 -0
  33. package/dist/groups/branches/tools.js.map +1 -0
  34. package/dist/groups/ci_catalog/queries.d.ts +2 -0
  35. package/dist/groups/ci_catalog/queries.js +63 -0
  36. package/dist/groups/ci_catalog/queries.js.map +1 -0
  37. package/dist/groups/ci_catalog/tools.d.ts +3 -0
  38. package/dist/groups/ci_catalog/tools.js +45 -0
  39. package/dist/groups/ci_catalog/tools.js.map +1 -0
  40. package/dist/groups/ci_lint/tools.d.ts +3 -0
  41. package/dist/groups/ci_lint/tools.js +36 -0
  42. package/dist/groups/ci_lint/tools.js.map +1 -0
  43. package/dist/groups/ci_variables/tools.d.ts +3 -0
  44. package/dist/groups/ci_variables/tools.js +201 -0
  45. package/dist/groups/ci_variables/tools.js.map +1 -0
  46. package/dist/groups/code_search/tools.d.ts +3 -0
  47. package/dist/groups/code_search/tools.js +70 -0
  48. package/dist/groups/code_search/tools.js.map +1 -0
  49. package/dist/groups/commits/tools.d.ts +3 -0
  50. package/dist/groups/commits/tools.js +192 -0
  51. package/dist/groups/commits/tools.js.map +1 -0
  52. package/dist/groups/compliance/queries.d.ts +1 -0
  53. package/dist/groups/compliance/queries.js +22 -0
  54. package/dist/groups/compliance/queries.js.map +1 -0
  55. package/dist/groups/compliance/tools.d.ts +3 -0
  56. package/dist/groups/compliance/tools.js +104 -0
  57. package/dist/groups/compliance/tools.js.map +1 -0
  58. package/dist/groups/container_registry/tools.d.ts +3 -0
  59. package/dist/groups/container_registry/tools.js +113 -0
  60. package/dist/groups/container_registry/tools.js.map +1 -0
  61. package/dist/groups/custom_roles/queries.d.ts +5 -0
  62. package/dist/groups/custom_roles/queries.js +69 -0
  63. package/dist/groups/custom_roles/queries.js.map +1 -0
  64. package/dist/groups/custom_roles/tools.d.ts +3 -0
  65. package/dist/groups/custom_roles/tools.js +84 -0
  66. package/dist/groups/custom_roles/tools.js.map +1 -0
  67. package/dist/groups/deployments/tools.d.ts +3 -0
  68. package/dist/groups/deployments/tools.js +98 -0
  69. package/dist/groups/deployments/tools.js.map +1 -0
  70. package/dist/groups/discussions/tools.d.ts +3 -0
  71. package/dist/groups/discussions/tools.js +144 -0
  72. package/dist/groups/discussions/tools.js.map +1 -0
  73. package/dist/groups/duo_chat/queries.d.ts +4 -0
  74. package/dist/groups/duo_chat/queries.js +76 -0
  75. package/dist/groups/duo_chat/queries.js.map +1 -0
  76. package/dist/groups/duo_chat/tools.d.ts +3 -0
  77. package/dist/groups/duo_chat/tools.js +95 -0
  78. package/dist/groups/duo_chat/tools.js.map +1 -0
  79. package/dist/groups/environments/tools.d.ts +3 -0
  80. package/dist/groups/environments/tools.js +105 -0
  81. package/dist/groups/environments/tools.js.map +1 -0
  82. package/dist/groups/events/tools.d.ts +3 -0
  83. package/dist/groups/events/tools.js +64 -0
  84. package/dist/groups/events/tools.js.map +1 -0
  85. package/dist/groups/feature_flags/tools.d.ts +3 -0
  86. package/dist/groups/feature_flags/tools.js +137 -0
  87. package/dist/groups/feature_flags/tools.js.map +1 -0
  88. package/dist/groups/groups/tools.d.ts +3 -0
  89. package/dist/groups/groups/tools.js +145 -0
  90. package/dist/groups/groups/tools.js.map +1 -0
  91. package/dist/groups/integrations/tools.d.ts +3 -0
  92. package/dist/groups/integrations/tools.js +143 -0
  93. package/dist/groups/integrations/tools.js.map +1 -0
  94. package/dist/groups/jobs/tools.d.ts +3 -0
  95. package/dist/groups/jobs/tools.js +209 -0
  96. package/dist/groups/jobs/tools.js.map +1 -0
  97. package/dist/groups/keys/tools.d.ts +3 -0
  98. package/dist/groups/keys/tools.js +140 -0
  99. package/dist/groups/keys/tools.js.map +1 -0
  100. package/dist/groups/labels/tools.d.ts +3 -0
  101. package/dist/groups/labels/tools.js +110 -0
  102. package/dist/groups/labels/tools.js.map +1 -0
  103. package/dist/groups/members/tools.d.ts +3 -0
  104. package/dist/groups/members/tools.js +136 -0
  105. package/dist/groups/members/tools.js.map +1 -0
  106. package/dist/groups/merge_requests/tools.d.ts +3 -0
  107. package/dist/groups/merge_requests/tools.js +288 -0
  108. package/dist/groups/merge_requests/tools.js.map +1 -0
  109. package/dist/groups/milestones/tools.d.ts +3 -0
  110. package/dist/groups/milestones/tools.js +143 -0
  111. package/dist/groups/milestones/tools.js.map +1 -0
  112. package/dist/groups/packages/tools.d.ts +3 -0
  113. package/dist/groups/packages/tools.js +157 -0
  114. package/dist/groups/packages/tools.js.map +1 -0
  115. package/dist/groups/pipeline_schedules/tools.d.ts +3 -0
  116. package/dist/groups/pipeline_schedules/tools.js +127 -0
  117. package/dist/groups/pipeline_schedules/tools.js.map +1 -0
  118. package/dist/groups/pipeline_triggers/tools.d.ts +3 -0
  119. package/dist/groups/pipeline_triggers/tools.js +74 -0
  120. package/dist/groups/pipeline_triggers/tools.js.map +1 -0
  121. package/dist/groups/pipelines/tools.d.ts +3 -0
  122. package/dist/groups/pipelines/tools.js +140 -0
  123. package/dist/groups/pipelines/tools.js.map +1 -0
  124. package/dist/groups/projects/tools.d.ts +3 -0
  125. package/dist/groups/projects/tools.js +189 -0
  126. package/dist/groups/projects/tools.js.map +1 -0
  127. package/dist/groups/protected_environments/tools.d.ts +3 -0
  128. package/dist/groups/protected_environments/tools.js +77 -0
  129. package/dist/groups/protected_environments/tools.js.map +1 -0
  130. package/dist/groups/releases/tools.d.ts +3 -0
  131. package/dist/groups/releases/tools.js +153 -0
  132. package/dist/groups/releases/tools.js.map +1 -0
  133. package/dist/groups/repository_files/tools.d.ts +3 -0
  134. package/dist/groups/repository_files/tools.js +163 -0
  135. package/dist/groups/repository_files/tools.js.map +1 -0
  136. package/dist/groups/runners/tools.d.ts +3 -0
  137. package/dist/groups/runners/tools.js +108 -0
  138. package/dist/groups/runners/tools.js.map +1 -0
  139. package/dist/groups/search/tools.d.ts +3 -0
  140. package/dist/groups/search/tools.js +58 -0
  141. package/dist/groups/search/tools.js.map +1 -0
  142. package/dist/groups/secrets/queries.d.ts +10 -0
  143. package/dist/groups/secrets/queries.js +121 -0
  144. package/dist/groups/secrets/queries.js.map +1 -0
  145. package/dist/groups/secrets/tools.d.ts +8 -0
  146. package/dist/groups/secrets/tools.js +167 -0
  147. package/dist/groups/secrets/tools.js.map +1 -0
  148. package/dist/groups/security_policies/queries.d.ts +3 -0
  149. package/dist/groups/security_policies/queries.js +75 -0
  150. package/dist/groups/security_policies/queries.js.map +1 -0
  151. package/dist/groups/security_policies/tools.d.ts +3 -0
  152. package/dist/groups/security_policies/tools.js +40 -0
  153. package/dist/groups/security_policies/tools.js.map +1 -0
  154. package/dist/groups/security_reports/queries.d.ts +1 -0
  155. package/dist/groups/security_reports/queries.js +75 -0
  156. package/dist/groups/security_reports/queries.js.map +1 -0
  157. package/dist/groups/security_reports/tools.d.ts +3 -0
  158. package/dist/groups/security_reports/tools.js +51 -0
  159. package/dist/groups/security_reports/tools.js.map +1 -0
  160. package/dist/groups/snippets/tools.d.ts +3 -0
  161. package/dist/groups/snippets/tools.js +148 -0
  162. package/dist/groups/snippets/tools.js.map +1 -0
  163. package/dist/groups/statistics/queries.d.ts +2 -0
  164. package/dist/groups/statistics/queries.js +32 -0
  165. package/dist/groups/statistics/queries.js.map +1 -0
  166. package/dist/groups/statistics/tools.d.ts +3 -0
  167. package/dist/groups/statistics/tools.js +35 -0
  168. package/dist/groups/statistics/tools.js.map +1 -0
  169. package/dist/groups/tags/tools.d.ts +3 -0
  170. package/dist/groups/tags/tools.js +97 -0
  171. package/dist/groups/tags/tools.js.map +1 -0
  172. package/dist/groups/todos/tools.d.ts +3 -0
  173. package/dist/groups/todos/tools.js +93 -0
  174. package/dist/groups/todos/tools.js.map +1 -0
  175. package/dist/groups/users/tools.d.ts +3 -0
  176. package/dist/groups/users/tools.js +121 -0
  177. package/dist/groups/users/tools.js.map +1 -0
  178. package/dist/groups/vulnerabilities/queries.d.ts +3 -0
  179. package/dist/groups/vulnerabilities/queries.js +104 -0
  180. package/dist/groups/vulnerabilities/queries.js.map +1 -0
  181. package/dist/groups/vulnerabilities/tools.d.ts +3 -0
  182. package/dist/groups/vulnerabilities/tools.js +131 -0
  183. package/dist/groups/vulnerabilities/tools.js.map +1 -0
  184. package/dist/groups/webhooks/tools.d.ts +3 -0
  185. package/dist/groups/webhooks/tools.js +213 -0
  186. package/dist/groups/webhooks/tools.js.map +1 -0
  187. package/dist/groups/wiki/tools.d.ts +3 -0
  188. package/dist/groups/wiki/tools.js +142 -0
  189. package/dist/groups/wiki/tools.js.map +1 -0
  190. package/dist/groups/work_items/queries.d.ts +16 -0
  191. package/dist/groups/work_items/queries.js +181 -0
  192. package/dist/groups/work_items/queries.js.map +1 -0
  193. package/dist/groups/work_items/tools.d.ts +3 -0
  194. package/dist/groups/work_items/tools.js +250 -0
  195. package/dist/groups/work_items/tools.js.map +1 -0
  196. package/dist/http/errors.d.ts +21 -0
  197. package/dist/http/errors.js +62 -0
  198. package/dist/http/errors.js.map +1 -0
  199. package/dist/http/graphql.d.ts +29 -0
  200. package/dist/http/graphql.js +93 -0
  201. package/dist/http/graphql.js.map +1 -0
  202. package/dist/http/rest.d.ts +96 -0
  203. package/dist/http/rest.js +369 -0
  204. package/dist/http/rest.js.map +1 -0
  205. package/dist/index.d.ts +2 -0
  206. package/dist/index.js +25 -0
  207. package/dist/index.js.map +1 -0
  208. package/dist/shared/args.d.ts +51 -0
  209. package/dist/shared/args.js +46 -0
  210. package/dist/shared/args.js.map +1 -0
  211. package/dist/shared/handlers.d.ts +6 -0
  212. package/dist/shared/handlers.js +14 -0
  213. package/dist/shared/handlers.js.map +1 -0
  214. package/dist/shared/ids.d.ts +18 -0
  215. package/dist/shared/ids.js +43 -0
  216. package/dist/shared/ids.js.map +1 -0
  217. package/dist/tools/meta.d.ts +3 -0
  218. package/dist/tools/meta.js +22 -0
  219. package/dist/tools/meta.js.map +1 -0
  220. package/dist/tools/registry.d.ts +3 -0
  221. package/dist/tools/registry.js +117 -0
  222. package/dist/tools/registry.js.map +1 -0
  223. package/dist/tools/types.d.ts +18 -0
  224. package/dist/tools/types.js +20 -0
  225. package/dist/tools/types.js.map +1 -0
  226. package/package.json +72 -0
@@ -0,0 +1,144 @@
1
+ import { z } from 'zod';
2
+ import { DiffPositionSchema, PaginationArgs, ProjectIdArg, TargetTypeArg } from '../../shared/args.js';
3
+ import { safe } from '../../shared/handlers.js';
4
+ import { resolveProjectId } from '../../shared/ids.js';
5
+ /**
6
+ * Map a discussion target type to its REST path segment.
7
+ * Issues use the IID, merge_requests use the IID, commits use the SHA.
8
+ */
9
+ function discussionPath(projectId, targetType, targetRef) {
10
+ switch (targetType) {
11
+ case 'issue':
12
+ return `/projects/${projectId}/issues/${targetRef}/discussions`;
13
+ case 'merge_request':
14
+ return `/projects/${projectId}/merge_requests/${targetRef}/discussions`;
15
+ case 'commit':
16
+ return `/projects/${projectId}/repository/commits/${targetRef}/discussions`;
17
+ }
18
+ }
19
+ function notePath(projectId, targetType, targetRef, discussionId, noteId) {
20
+ const root = targetType === 'issue'
21
+ ? `/projects/${projectId}/issues/${targetRef}`
22
+ : targetType === 'merge_request'
23
+ ? `/projects/${projectId}/merge_requests/${targetRef}`
24
+ : `/projects/${projectId}/repository/commits/${targetRef}`;
25
+ const base = `${root}/discussions/${discussionId}`;
26
+ return noteId === undefined ? `${base}/notes` : `${base}/notes/${noteId}`;
27
+ }
28
+ const TargetRefArg = z
29
+ .union([z.string(), z.number()])
30
+ .describe('iid for issues/MRs, full SHA for commits.');
31
+ export function registerDiscussionTools(server, ctx) {
32
+ server.tool('discussion_list', 'List discussions on an issue, merge request, or commit.', {
33
+ ...ProjectIdArg,
34
+ target_type: TargetTypeArg,
35
+ target_ref: TargetRefArg,
36
+ ...PaginationArgs,
37
+ }, async (args) => safe(async () => {
38
+ const projectId = resolveProjectId(ctx.config, args.project_id);
39
+ const path = discussionPath(projectId, args.target_type, args.target_ref);
40
+ const res = await ctx.rest.request({
41
+ path,
42
+ query: { page: args.page, per_page: args.per_page },
43
+ });
44
+ return res.data;
45
+ }));
46
+ server.tool('discussion_create', 'Create a new discussion. For inline MR diff comments, pass `position`.', {
47
+ ...ProjectIdArg,
48
+ target_type: TargetTypeArg,
49
+ target_ref: TargetRefArg,
50
+ body: z.string().min(1),
51
+ position: DiffPositionSchema.optional(),
52
+ created_at: z.string().optional().describe('ISO 8601; requires admin/owner.'),
53
+ }, async (args) => safe(async () => {
54
+ const projectId = resolveProjectId(ctx.config, args.project_id);
55
+ const path = discussionPath(projectId, args.target_type, args.target_ref);
56
+ const reqBody = { body: args.body };
57
+ if (args.position)
58
+ reqBody['position'] = args.position;
59
+ if (args.created_at)
60
+ reqBody['created_at'] = args.created_at;
61
+ const res = await ctx.rest.request({ method: 'POST', path, body: reqBody });
62
+ return res.data;
63
+ }));
64
+ server.tool('discussion_reply', 'Add a reply note to an existing discussion thread.', {
65
+ ...ProjectIdArg,
66
+ target_type: TargetTypeArg,
67
+ target_ref: TargetRefArg,
68
+ discussion_id: z.string(),
69
+ body: z.string().min(1),
70
+ }, async (args) => safe(async () => {
71
+ const projectId = resolveProjectId(ctx.config, args.project_id);
72
+ const path = notePath(projectId, args.target_type, args.target_ref, args.discussion_id);
73
+ const res = await ctx.rest.request({
74
+ method: 'POST',
75
+ path,
76
+ body: { body: args.body },
77
+ });
78
+ return res.data;
79
+ }));
80
+ server.tool('discussion_resolve', 'Resolve or unresolve a discussion (MR only).', {
81
+ ...ProjectIdArg,
82
+ target_type: z.enum(['merge_request']).describe('Only merge_request discussions can be resolved.'),
83
+ target_ref: TargetRefArg,
84
+ discussion_id: z.string(),
85
+ resolved: z.boolean().describe('true to resolve, false to unresolve.'),
86
+ }, async (args) => safe(async () => {
87
+ const projectId = resolveProjectId(ctx.config, args.project_id);
88
+ const path = `/projects/${projectId}/merge_requests/${args.target_ref}/discussions/${args.discussion_id}`;
89
+ const res = await ctx.rest.request({
90
+ method: 'PUT',
91
+ path,
92
+ query: { resolved: args.resolved },
93
+ });
94
+ return res.data;
95
+ }));
96
+ server.tool('note_update', 'Edit the body of a note inside a discussion.', {
97
+ ...ProjectIdArg,
98
+ target_type: TargetTypeArg,
99
+ target_ref: TargetRefArg,
100
+ discussion_id: z.string(),
101
+ note_id: z.number().int().positive(),
102
+ body: z.string().min(1),
103
+ }, async (args) => safe(async () => {
104
+ const projectId = resolveProjectId(ctx.config, args.project_id);
105
+ const path = notePath(projectId, args.target_type, args.target_ref, args.discussion_id, args.note_id);
106
+ const res = await ctx.rest.request({
107
+ method: 'PUT',
108
+ path,
109
+ body: { body: args.body },
110
+ });
111
+ return res.data;
112
+ }));
113
+ server.tool('note_delete', 'Delete a note. Must be the note author or a project maintainer.', {
114
+ ...ProjectIdArg,
115
+ target_type: TargetTypeArg,
116
+ target_ref: TargetRefArg,
117
+ discussion_id: z.string(),
118
+ note_id: z.number().int().positive(),
119
+ }, async (args) => safe(async () => {
120
+ const projectId = resolveProjectId(ctx.config, args.project_id);
121
+ const path = notePath(projectId, args.target_type, args.target_ref, args.discussion_id, args.note_id);
122
+ const res = await ctx.rest.request({ method: 'DELETE', path });
123
+ return res.data ?? { ok: true };
124
+ }));
125
+ server.tool('suggestion_create', 'Create an inline MR comment containing a GitLab suggestion block (```suggestion). The body argument may be prose; suggested_content goes into the suggestion fence.', {
126
+ ...ProjectIdArg,
127
+ mr_iid: z.number().int().positive(),
128
+ position: DiffPositionSchema,
129
+ suggested_content: z.string().describe('Replacement text for the highlighted line range.'),
130
+ body: z.string().optional().describe('Optional preamble before the suggestion fence.'),
131
+ }, async (args) => safe(async () => {
132
+ const projectId = resolveProjectId(ctx.config, args.project_id);
133
+ const fence = '```suggestion\n' + args.suggested_content + '\n```';
134
+ const fullBody = args.body ? `${args.body}\n\n${fence}` : fence;
135
+ const path = discussionPath(projectId, 'merge_request', args.mr_iid);
136
+ const res = await ctx.rest.request({
137
+ method: 'POST',
138
+ path,
139
+ body: { body: fullBody, position: args.position },
140
+ });
141
+ return res.data;
142
+ }));
143
+ }
144
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/discussions/tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export declare const AI_MESSAGES = "\n query AiMessages(\n $requestIds: [ID!]\n $conversationType: AiConversationsThreadsConversationType\n $threadId: AiConversationThreadID\n $roles: [AiMessageRole!]\n $agentVersionId: AiAgentVersionID\n $first: Int\n $after: String\n ) {\n aiMessages(\n requestIds: $requestIds\n conversationType: $conversationType\n threadId: $threadId\n roles: $roles\n agentVersionId: $agentVersionId\n first: $first\n after: $after\n ) {\n pageInfo {\n endCursor\n hasNextPage\n }\n nodes {\n id\n requestId\n role\n content\n contentHtml\n timestamp\n errors\n chunkId\n }\n }\n }\n";
2
+ export declare const AI_THREADS = "\n query AiConversationThreads(\n $conversationType: AiConversationsThreadsConversationType\n $first: Int\n $after: String\n ) {\n aiConversationThreads(conversationType: $conversationType, first: $first, after: $after) {\n pageInfo {\n endCursor\n hasNextPage\n }\n nodes {\n id\n conversationType\n title\n createdAt\n updatedAt\n lastUpdatedAt\n }\n }\n }\n";
3
+ export declare const AI_CHAT_CONTEXT_PRESETS = "\n query AiChatContextPresets($url: String, $resourceId: AiModelID) {\n aiChatContextPresets(url: $url, resourceId: $resourceId) {\n questions\n aiResourceData\n }\n }\n";
4
+ export declare const AI_ACTION_CHAT = "\n mutation AiActionChat($input: AiActionInput!) {\n aiAction(input: $input) {\n requestId\n threadId\n errors\n }\n }\n";
@@ -0,0 +1,76 @@
1
+ export const AI_MESSAGES = /* GraphQL */ `
2
+ query AiMessages(
3
+ $requestIds: [ID!]
4
+ $conversationType: AiConversationsThreadsConversationType
5
+ $threadId: AiConversationThreadID
6
+ $roles: [AiMessageRole!]
7
+ $agentVersionId: AiAgentVersionID
8
+ $first: Int
9
+ $after: String
10
+ ) {
11
+ aiMessages(
12
+ requestIds: $requestIds
13
+ conversationType: $conversationType
14
+ threadId: $threadId
15
+ roles: $roles
16
+ agentVersionId: $agentVersionId
17
+ first: $first
18
+ after: $after
19
+ ) {
20
+ pageInfo {
21
+ endCursor
22
+ hasNextPage
23
+ }
24
+ nodes {
25
+ id
26
+ requestId
27
+ role
28
+ content
29
+ contentHtml
30
+ timestamp
31
+ errors
32
+ chunkId
33
+ }
34
+ }
35
+ }
36
+ `;
37
+ export const AI_THREADS = /* GraphQL */ `
38
+ query AiConversationThreads(
39
+ $conversationType: AiConversationsThreadsConversationType
40
+ $first: Int
41
+ $after: String
42
+ ) {
43
+ aiConversationThreads(conversationType: $conversationType, first: $first, after: $after) {
44
+ pageInfo {
45
+ endCursor
46
+ hasNextPage
47
+ }
48
+ nodes {
49
+ id
50
+ conversationType
51
+ title
52
+ createdAt
53
+ updatedAt
54
+ lastUpdatedAt
55
+ }
56
+ }
57
+ }
58
+ `;
59
+ export const AI_CHAT_CONTEXT_PRESETS = /* GraphQL */ `
60
+ query AiChatContextPresets($url: String, $resourceId: AiModelID) {
61
+ aiChatContextPresets(url: $url, resourceId: $resourceId) {
62
+ questions
63
+ aiResourceData
64
+ }
65
+ }
66
+ `;
67
+ export const AI_ACTION_CHAT = /* GraphQL */ `
68
+ mutation AiActionChat($input: AiActionInput!) {
69
+ aiAction(input: $input) {
70
+ requestId
71
+ threadId
72
+ errors
73
+ }
74
+ }
75
+ `;
76
+ //# sourceMappingURL=queries.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/groups/duo_chat/queries.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCxC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;CAqBvC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAa,CAAC;;;;;;;CAOpD,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;;;;;;;;CAQ3C,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ToolContext } from '../../tools/types.js';
3
+ export declare function registerDuoChatTools(server: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,95 @@
1
+ import { z } from 'zod';
2
+ import { safe } from '../../shared/handlers.js';
3
+ import { AI_ACTION_CHAT, AI_CHAT_CONTEXT_PRESETS, AI_MESSAGES, AI_THREADS, } from './queries.js';
4
+ const ConversationType = z.enum(['DUO_CHAT', 'DUO_CODE_REVIEW']);
5
+ const MessageRole = z.enum(['USER', 'ASSISTANT', 'SYSTEM']);
6
+ export function registerDuoChatTools(server, ctx) {
7
+ server.tool('ai_thread_list', 'List the current user\'s Duo Chat conversation threads (GitLab 17.9+).', {
8
+ conversation_type: ConversationType.optional(),
9
+ first: z.number().int().positive().max(100).optional(),
10
+ after: z.string().optional(),
11
+ }, async (args) => safe(async () => {
12
+ const data = await ctx.graphql.query({
13
+ query: AI_THREADS,
14
+ variables: {
15
+ conversationType: args.conversation_type,
16
+ first: args.first ?? 20,
17
+ after: args.after,
18
+ },
19
+ });
20
+ return {
21
+ items: data.aiConversationThreads.nodes,
22
+ page_info: data.aiConversationThreads.pageInfo,
23
+ };
24
+ }));
25
+ server.tool('ai_message_list', 'List Duo Chat messages. Filter by request_ids (for a specific exchange), thread_id, or roles.', {
26
+ request_ids: z.array(z.string()).optional(),
27
+ thread_id: z.string().optional().describe('Global id of an AI conversation thread.'),
28
+ conversation_type: ConversationType.optional(),
29
+ roles: z.array(MessageRole).optional(),
30
+ first: z.number().int().positive().max(100).optional(),
31
+ after: z.string().optional(),
32
+ }, async (args) => safe(async () => {
33
+ const data = await ctx.graphql.query({
34
+ query: AI_MESSAGES,
35
+ variables: {
36
+ requestIds: args.request_ids,
37
+ threadId: args.thread_id,
38
+ conversationType: args.conversation_type,
39
+ roles: args.roles,
40
+ first: args.first ?? 20,
41
+ after: args.after,
42
+ },
43
+ });
44
+ return {
45
+ items: data.aiMessages.nodes,
46
+ page_info: data.aiMessages.pageInfo,
47
+ };
48
+ }));
49
+ server.tool('ai_chat_context_presets', 'Get available Duo Chat context presets — slash-command questions and AI resource data for a project/MR URL.', {
50
+ url: z.string().optional().describe('GitLab URL of a project/MR/issue to pull context from.'),
51
+ resource_id: z
52
+ .string()
53
+ .optional()
54
+ .describe('Global id of a resource (e.g. gid://gitlab/Project/123).'),
55
+ }, async (args) => safe(async () => {
56
+ const data = await ctx.graphql.query({
57
+ query: AI_CHAT_CONTEXT_PRESETS,
58
+ variables: { url: args.url, resourceId: args.resource_id },
59
+ });
60
+ return data.aiChatContextPresets;
61
+ }));
62
+ server.tool('ai_chat_send', 'Send a message to Duo Chat. Returns request_id + thread_id; response comes asynchronously — poll `ai_message_list` with `request_ids=[returned_id]` to fetch the assistant reply.', {
63
+ content: z.string().min(1),
64
+ resource_id: z
65
+ .string()
66
+ .optional()
67
+ .describe('Optional GitLab resource context (gid://gitlab/Project/123, etc.).'),
68
+ conversation_type: ConversationType.optional().describe('Defaults to DUO_CHAT.'),
69
+ thread_id: z.string().optional().describe('Continue an existing thread.'),
70
+ with_clean_history: z.boolean().optional(),
71
+ }, async (args) => safe(async () => {
72
+ const input = {
73
+ chat: {
74
+ content: args.content,
75
+ ...(args.resource_id !== undefined ? { resourceId: args.resource_id } : {}),
76
+ },
77
+ conversationType: args.conversation_type ?? 'DUO_CHAT',
78
+ };
79
+ if (args.thread_id !== undefined)
80
+ input['threadId'] = args.thread_id;
81
+ if (args.with_clean_history !== undefined) {
82
+ input['withCleanHistory'] = args.with_clean_history;
83
+ }
84
+ const data = await ctx.graphql.query({ query: AI_ACTION_CHAT, variables: { input } });
85
+ if (data.aiAction.errors.length > 0) {
86
+ throw new Error(`aiAction: ${data.aiAction.errors.join('; ')}`);
87
+ }
88
+ return {
89
+ request_id: data.aiAction.requestId,
90
+ thread_id: data.aiAction.threadId,
91
+ hint: 'Poll ai_message_list with request_ids=[request_id] to fetch the assistant reply.',
92
+ };
93
+ }));
94
+ }
95
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/duo_chat/tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ToolContext } from '../../tools/types.js';
3
+ export declare function registerEnvironmentTools(server: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,105 @@
1
+ import { z } from 'zod';
2
+ import { PaginationArgs, ProjectIdArg } from '../../shared/args.js';
3
+ import { safe } from '../../shared/handlers.js';
4
+ import { resolveProjectId } from '../../shared/ids.js';
5
+ const Tier = z.enum(['production', 'staging', 'testing', 'development', 'other']);
6
+ const EnvState = z.enum(['available', 'stopping', 'stopped']);
7
+ export function registerEnvironmentTools(server, ctx) {
8
+ server.tool('environment_list', 'List environments for a project.', {
9
+ ...ProjectIdArg,
10
+ name: z.string().optional(),
11
+ search: z.string().optional(),
12
+ states: EnvState.optional(),
13
+ tier: Tier.optional(),
14
+ ...PaginationArgs,
15
+ }, async (args) => safe(async () => {
16
+ const projectId = resolveProjectId(ctx.config, args.project_id);
17
+ const { project_id: _p, ...rest } = args;
18
+ const res = await ctx.rest.request({
19
+ path: `/projects/${projectId}/environments`,
20
+ query: rest,
21
+ });
22
+ return res.data;
23
+ }));
24
+ server.tool('environment_get', 'Get a single environment with last deployment info.', { ...ProjectIdArg, environment_id: z.number().int().positive() }, async (args) => safe(async () => {
25
+ const projectId = resolveProjectId(ctx.config, args.project_id);
26
+ const res = await ctx.rest.request({
27
+ path: `/projects/${projectId}/environments/${args.environment_id}`,
28
+ });
29
+ return res.data;
30
+ }));
31
+ server.tool('environment_create', 'Create a new environment.', {
32
+ ...ProjectIdArg,
33
+ name: z.string(),
34
+ external_url: z.string().url().optional(),
35
+ tier: Tier.optional(),
36
+ cluster_agent_id: z.number().int().optional(),
37
+ kubernetes_namespace: z.string().optional(),
38
+ flux_resource_path: z.string().optional(),
39
+ }, async (args) => safe(async () => {
40
+ const projectId = resolveProjectId(ctx.config, args.project_id);
41
+ const { project_id: _p, ...body } = args;
42
+ const res = await ctx.rest.request({
43
+ method: 'POST',
44
+ path: `/projects/${projectId}/environments`,
45
+ body,
46
+ });
47
+ return res.data;
48
+ }));
49
+ server.tool('environment_update', 'Update an environment\'s metadata.', {
50
+ ...ProjectIdArg,
51
+ environment_id: z.number().int().positive(),
52
+ name: z.string().optional(),
53
+ external_url: z.string().url().optional(),
54
+ tier: Tier.optional(),
55
+ cluster_agent_id: z.number().int().nullable().optional(),
56
+ kubernetes_namespace: z.string().optional(),
57
+ flux_resource_path: z.string().optional(),
58
+ }, async (args) => safe(async () => {
59
+ const projectId = resolveProjectId(ctx.config, args.project_id);
60
+ const { project_id: _p, environment_id, ...body } = args;
61
+ const res = await ctx.rest.request({
62
+ method: 'PUT',
63
+ path: `/projects/${projectId}/environments/${environment_id}`,
64
+ body,
65
+ });
66
+ return res.data;
67
+ }));
68
+ server.tool('environment_delete', 'Delete an environment (must already be stopped).', { ...ProjectIdArg, environment_id: z.number().int().positive() }, async (args) => safe(async () => {
69
+ const projectId = resolveProjectId(ctx.config, args.project_id);
70
+ const res = await ctx.rest.request({
71
+ method: 'DELETE',
72
+ path: `/projects/${projectId}/environments/${args.environment_id}`,
73
+ });
74
+ return res.data ?? { ok: true };
75
+ }));
76
+ server.tool('environment_stop', 'Stop an environment (runs the on_stop job if configured).', {
77
+ ...ProjectIdArg,
78
+ environment_id: z.number().int().positive(),
79
+ force: z.boolean().optional().describe('Skip the on_stop job and stop directly.'),
80
+ }, async (args) => safe(async () => {
81
+ const projectId = resolveProjectId(ctx.config, args.project_id);
82
+ const res = await ctx.rest.request({
83
+ method: 'POST',
84
+ path: `/projects/${projectId}/environments/${args.environment_id}/stop`,
85
+ ...(args.force !== undefined ? { body: { force: args.force } } : {}),
86
+ });
87
+ return res.data;
88
+ }));
89
+ server.tool('environment_stop_stale', 'Bulk-stop stale environments older than `before` that match `tier`/`limit`.', {
90
+ ...ProjectIdArg,
91
+ before: z.string().describe('ISO 8601 timestamp. Environments inactive before this are stopped.'),
92
+ tier: Tier.optional(),
93
+ limit: z.number().int().positive().optional(),
94
+ }, async (args) => safe(async () => {
95
+ const projectId = resolveProjectId(ctx.config, args.project_id);
96
+ const { project_id: _p, ...body } = args;
97
+ const res = await ctx.rest.request({
98
+ method: 'POST',
99
+ path: `/projects/${projectId}/environments/stop_stale`,
100
+ body,
101
+ });
102
+ return res.data ?? { ok: true };
103
+ }));
104
+ }
105
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/environments/tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ToolContext } from '../../tools/types.js';
3
+ export declare function registerEventTools(server: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,64 @@
1
+ import { z } from 'zod';
2
+ import { PaginationArgs, ProjectIdArg } from '../../shared/args.js';
3
+ import { safe } from '../../shared/handlers.js';
4
+ import { resolveProjectId } from '../../shared/ids.js';
5
+ const EventAction = z.enum([
6
+ 'approved',
7
+ 'closed',
8
+ 'commented',
9
+ 'created',
10
+ 'destroyed',
11
+ 'expired',
12
+ 'joined',
13
+ 'left',
14
+ 'merged',
15
+ 'pushed',
16
+ 'reopened',
17
+ 'updated',
18
+ ]);
19
+ const EventTargetType = z.enum([
20
+ 'issue',
21
+ 'milestone',
22
+ 'merge_request',
23
+ 'note',
24
+ 'project',
25
+ 'snippet',
26
+ 'user',
27
+ 'wiki_page',
28
+ ]);
29
+ const EventFilters = {
30
+ action: EventAction.optional(),
31
+ target_type: EventTargetType.optional(),
32
+ before: z.string().optional().describe('YYYY-MM-DD'),
33
+ after: z.string().optional(),
34
+ scope: z.enum(['all']).optional(),
35
+ sort: z.enum(['asc', 'desc']).optional(),
36
+ ...PaginationArgs,
37
+ };
38
+ export function registerEventTools(server, ctx) {
39
+ server.tool('event_list_current_user', 'List activity events for the authenticated user.', EventFilters, async (args) => safe(async () => {
40
+ const res = await ctx.rest.request({ path: '/events', query: args });
41
+ return res.data;
42
+ }));
43
+ server.tool('event_list_user', 'List activity events for a specific user.', {
44
+ user_id: z.union([z.number().int().positive(), z.string()]).describe('Numeric id or username.'),
45
+ ...EventFilters,
46
+ }, async (args) => safe(async () => {
47
+ const { user_id, ...rest } = args;
48
+ const res = await ctx.rest.request({
49
+ path: `/users/${encodeURIComponent(String(user_id))}/events`,
50
+ query: rest,
51
+ });
52
+ return res.data;
53
+ }));
54
+ server.tool('event_list_project', 'List activity events for a project.', { ...ProjectIdArg, ...EventFilters }, async (args) => safe(async () => {
55
+ const projectId = resolveProjectId(ctx.config, args.project_id);
56
+ const { project_id: _p, ...rest } = args;
57
+ const res = await ctx.rest.request({
58
+ path: `/projects/${projectId}/events`,
59
+ query: rest,
60
+ });
61
+ return res.data;
62
+ }));
63
+ }
64
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/events/tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ToolContext } from '../../tools/types.js';
3
+ export declare function registerFeatureFlagTools(server: McpServer, ctx: ToolContext): void;