@yadsh/dsh-qa-integrations 0.5.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 (212) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +617 -0
  3. package/compatibility.json +10 -0
  4. package/cordis.patch.yml +5 -0
  5. package/lib/broker.js +239 -0
  6. package/lib/broker.js.map +1 -0
  7. package/lib/client/bitrix24.js +33 -0
  8. package/lib/client/bitrix24.js.map +1 -0
  9. package/lib/client/card.js +33 -0
  10. package/lib/client/card.js.map +1 -0
  11. package/lib/client/confluence.js +148 -0
  12. package/lib/client/confluence.js.map +1 -0
  13. package/lib/client/copy.js +18 -0
  14. package/lib/client/copy.js.map +1 -0
  15. package/lib/client/gitlab.js +64 -0
  16. package/lib/client/gitlab.js.map +1 -0
  17. package/lib/client/index.js +71 -0
  18. package/lib/client/index.js.map +1 -0
  19. package/lib/client/integrations.js +34 -0
  20. package/lib/client/integrations.js.map +1 -0
  21. package/lib/client/jira.js +150 -0
  22. package/lib/client/jira.js.map +1 -0
  23. package/lib/client/provider-card.js +143 -0
  24. package/lib/client/provider-card.js.map +1 -0
  25. package/lib/client/styles.js +35 -0
  26. package/lib/client/styles.js.map +1 -0
  27. package/lib/client/teamcity.js +55 -0
  28. package/lib/client/teamcity.js.map +1 -0
  29. package/lib/client.js +8069 -0
  30. package/lib/client.js.map +1 -0
  31. package/lib/coerce.js +69 -0
  32. package/lib/coerce.js.map +1 -0
  33. package/lib/config.js +51 -0
  34. package/lib/config.js.map +1 -0
  35. package/lib/errors.js +14 -0
  36. package/lib/errors.js.map +1 -0
  37. package/lib/index.js +510 -0
  38. package/lib/index.js.map +1 -0
  39. package/lib/providers/bitrix24/catalog.js +245 -0
  40. package/lib/providers/bitrix24/catalog.js.map +1 -0
  41. package/lib/providers/bitrix24/config.js +40 -0
  42. package/lib/providers/bitrix24/config.js.map +1 -0
  43. package/lib/providers/bitrix24/index.js +128 -0
  44. package/lib/providers/bitrix24/index.js.map +1 -0
  45. package/lib/providers/bitrix24/operations.js +491 -0
  46. package/lib/providers/bitrix24/operations.js.map +1 -0
  47. package/lib/providers/bitrix24/tools.js +1035 -0
  48. package/lib/providers/bitrix24/tools.js.map +1 -0
  49. package/lib/providers/bitrix24/transport.js +142 -0
  50. package/lib/providers/bitrix24/transport.js.map +1 -0
  51. package/lib/providers/confluence/adf.js +348 -0
  52. package/lib/providers/confluence/adf.js.map +1 -0
  53. package/lib/providers/confluence/catalog.js +135 -0
  54. package/lib/providers/confluence/catalog.js.map +1 -0
  55. package/lib/providers/confluence/config.js +196 -0
  56. package/lib/providers/confluence/config.js.map +1 -0
  57. package/lib/providers/confluence/cql.js +78 -0
  58. package/lib/providers/confluence/cql.js.map +1 -0
  59. package/lib/providers/confluence/index.js +319 -0
  60. package/lib/providers/confluence/index.js.map +1 -0
  61. package/lib/providers/confluence/operations.js +653 -0
  62. package/lib/providers/confluence/operations.js.map +1 -0
  63. package/lib/providers/confluence/tools.js +282 -0
  64. package/lib/providers/confluence/tools.js.map +1 -0
  65. package/lib/providers/confluence/transport.js +247 -0
  66. package/lib/providers/confluence/transport.js.map +1 -0
  67. package/lib/providers/contract.js +2 -0
  68. package/lib/providers/contract.js.map +1 -0
  69. package/lib/providers/gitlab/catalog.js +171 -0
  70. package/lib/providers/gitlab/catalog.js.map +1 -0
  71. package/lib/providers/gitlab/config.js +141 -0
  72. package/lib/providers/gitlab/config.js.map +1 -0
  73. package/lib/providers/gitlab/index.js +227 -0
  74. package/lib/providers/gitlab/index.js.map +1 -0
  75. package/lib/providers/gitlab/operations.js +794 -0
  76. package/lib/providers/gitlab/operations.js.map +1 -0
  77. package/lib/providers/gitlab/tools.js +859 -0
  78. package/lib/providers/gitlab/tools.js.map +1 -0
  79. package/lib/providers/gitlab/transport.js +140 -0
  80. package/lib/providers/gitlab/transport.js.map +1 -0
  81. package/lib/providers/jira/adf.js +235 -0
  82. package/lib/providers/jira/adf.js.map +1 -0
  83. package/lib/providers/jira/catalog.js +145 -0
  84. package/lib/providers/jira/catalog.js.map +1 -0
  85. package/lib/providers/jira/config.js +198 -0
  86. package/lib/providers/jira/config.js.map +1 -0
  87. package/lib/providers/jira/index.js +301 -0
  88. package/lib/providers/jira/index.js.map +1 -0
  89. package/lib/providers/jira/jql.js +299 -0
  90. package/lib/providers/jira/jql.js.map +1 -0
  91. package/lib/providers/jira/operations.js +617 -0
  92. package/lib/providers/jira/operations.js.map +1 -0
  93. package/lib/providers/jira/tools.js +341 -0
  94. package/lib/providers/jira/tools.js.map +1 -0
  95. package/lib/providers/jira/transport.js +227 -0
  96. package/lib/providers/jira/transport.js.map +1 -0
  97. package/lib/providers/registry.js +21 -0
  98. package/lib/providers/registry.js.map +1 -0
  99. package/lib/providers/shared/account.js +20 -0
  100. package/lib/providers/shared/account.js.map +1 -0
  101. package/lib/providers/shared/host.js +15 -0
  102. package/lib/providers/shared/host.js.map +1 -0
  103. package/lib/providers/shared/http.js +148 -0
  104. package/lib/providers/shared/http.js.map +1 -0
  105. package/lib/providers/teamcity/artifacts.js +155 -0
  106. package/lib/providers/teamcity/artifacts.js.map +1 -0
  107. package/lib/providers/teamcity/catalog.js +155 -0
  108. package/lib/providers/teamcity/catalog.js.map +1 -0
  109. package/lib/providers/teamcity/config.js +262 -0
  110. package/lib/providers/teamcity/config.js.map +1 -0
  111. package/lib/providers/teamcity/index.js +228 -0
  112. package/lib/providers/teamcity/index.js.map +1 -0
  113. package/lib/providers/teamcity/locators.js +95 -0
  114. package/lib/providers/teamcity/locators.js.map +1 -0
  115. package/lib/providers/teamcity/logs.js +113 -0
  116. package/lib/providers/teamcity/logs.js.map +1 -0
  117. package/lib/providers/teamcity/network.js +160 -0
  118. package/lib/providers/teamcity/network.js.map +1 -0
  119. package/lib/providers/teamcity/operations.js +625 -0
  120. package/lib/providers/teamcity/operations.js.map +1 -0
  121. package/lib/providers/teamcity/tools.js +480 -0
  122. package/lib/providers/teamcity/tools.js.map +1 -0
  123. package/lib/providers/teamcity/transport.js +126 -0
  124. package/lib/providers/teamcity/transport.js.map +1 -0
  125. package/lib/redaction.js +38 -0
  126. package/lib/redaction.js.map +1 -0
  127. package/lib/repository.js +414 -0
  128. package/lib/repository.js.map +1 -0
  129. package/lib/secrets/key-provider.js +76 -0
  130. package/lib/secrets/key-provider.js.map +1 -0
  131. package/lib/secrets/secret-store.js +93 -0
  132. package/lib/secrets/secret-store.js.map +1 -0
  133. package/lib/shared/settings.js +19 -0
  134. package/lib/shared/settings.js.map +1 -0
  135. package/lib/tool-kit.js +55 -0
  136. package/lib/tool-kit.js.map +1 -0
  137. package/lib/tools.js +28 -0
  138. package/lib/tools.js.map +1 -0
  139. package/lib/typert.host.d.ts +3 -0
  140. package/lib/typert.host.js +1689 -0
  141. package/lib/typert.remote-client.d.ts +84 -0
  142. package/lib/typert.remote-client.js +1429 -0
  143. package/lib/types/broker.d.ts +30 -0
  144. package/lib/types/client/bitrix24.d.ts +18 -0
  145. package/lib/types/client/card.d.ts +13 -0
  146. package/lib/types/client/confluence.d.ts +17 -0
  147. package/lib/types/client/copy.d.ts +7 -0
  148. package/lib/types/client/gitlab.d.ts +15 -0
  149. package/lib/types/client/index.d.ts +13 -0
  150. package/lib/types/client/integrations.d.ts +28 -0
  151. package/lib/types/client/jira.d.ts +17 -0
  152. package/lib/types/client/provider-card.d.ts +63 -0
  153. package/lib/types/client/styles.d.ts +7 -0
  154. package/lib/types/client/teamcity.d.ts +19 -0
  155. package/lib/types/coerce.d.ts +18 -0
  156. package/lib/types/config.d.ts +48 -0
  157. package/lib/types/errors.d.ts +26 -0
  158. package/lib/types/index.d.ts +170 -0
  159. package/lib/types/providers/bitrix24/catalog.d.ts +48 -0
  160. package/lib/types/providers/bitrix24/config.d.ts +43 -0
  161. package/lib/types/providers/bitrix24/index.d.ts +31 -0
  162. package/lib/types/providers/bitrix24/operations.d.ts +13 -0
  163. package/lib/types/providers/bitrix24/tools.d.ts +9 -0
  164. package/lib/types/providers/bitrix24/transport.d.ts +26 -0
  165. package/lib/types/providers/confluence/adf.d.ts +22 -0
  166. package/lib/types/providers/confluence/catalog.d.ts +59 -0
  167. package/lib/types/providers/confluence/config.d.ts +68 -0
  168. package/lib/types/providers/confluence/cql.d.ts +43 -0
  169. package/lib/types/providers/confluence/index.d.ts +73 -0
  170. package/lib/types/providers/confluence/operations.d.ts +92 -0
  171. package/lib/types/providers/confluence/tools.d.ts +15 -0
  172. package/lib/types/providers/confluence/transport.d.ts +77 -0
  173. package/lib/types/providers/contract.d.ts +33 -0
  174. package/lib/types/providers/gitlab/catalog.d.ts +49 -0
  175. package/lib/types/providers/gitlab/config.d.ts +50 -0
  176. package/lib/types/providers/gitlab/index.d.ts +49 -0
  177. package/lib/types/providers/gitlab/operations.d.ts +40 -0
  178. package/lib/types/providers/gitlab/tools.d.ts +15 -0
  179. package/lib/types/providers/gitlab/transport.d.ts +52 -0
  180. package/lib/types/providers/jira/adf.d.ts +27 -0
  181. package/lib/types/providers/jira/catalog.d.ts +74 -0
  182. package/lib/types/providers/jira/config.d.ts +73 -0
  183. package/lib/types/providers/jira/index.d.ts +79 -0
  184. package/lib/types/providers/jira/jql.d.ts +51 -0
  185. package/lib/types/providers/jira/operations.d.ts +58 -0
  186. package/lib/types/providers/jira/tools.d.ts +17 -0
  187. package/lib/types/providers/jira/transport.d.ts +65 -0
  188. package/lib/types/providers/registry.d.ts +9 -0
  189. package/lib/types/providers/shared/account.d.ts +10 -0
  190. package/lib/types/providers/shared/host.d.ts +9 -0
  191. package/lib/types/providers/shared/http.d.ts +51 -0
  192. package/lib/types/providers/teamcity/artifacts.d.ts +45 -0
  193. package/lib/types/providers/teamcity/catalog.d.ts +55 -0
  194. package/lib/types/providers/teamcity/config.d.ts +66 -0
  195. package/lib/types/providers/teamcity/index.d.ts +62 -0
  196. package/lib/types/providers/teamcity/locators.d.ts +47 -0
  197. package/lib/types/providers/teamcity/logs.d.ts +31 -0
  198. package/lib/types/providers/teamcity/network.d.ts +32 -0
  199. package/lib/types/providers/teamcity/operations.d.ts +84 -0
  200. package/lib/types/providers/teamcity/tools.d.ts +15 -0
  201. package/lib/types/providers/teamcity/transport.d.ts +53 -0
  202. package/lib/types/redaction.d.ts +3 -0
  203. package/lib/types/repository.d.ts +48 -0
  204. package/lib/types/secrets/key-provider.d.ts +30 -0
  205. package/lib/types/secrets/secret-store.d.ts +12 -0
  206. package/lib/types/shared/settings.d.ts +19 -0
  207. package/lib/types/tool-kit.d.ts +26 -0
  208. package/lib/types/tools.d.ts +16 -0
  209. package/lib/types/types.d.ts +138 -0
  210. package/lib/types.js +2 -0
  211. package/lib/types.js.map +1 -0
  212. package/package.json +143 -0
@@ -0,0 +1,859 @@
1
+ import { optionalBoolean, optionalInteger, requiredInteger, requiredStringList, requiredText, } from "../../coerce.js";
2
+ import { createToolKit } from "../../tool-kit.js";
3
+ import { ISSUE_SCOPES, MR_SCOPES, SEARCH_SCOPES } from "./operations.js";
4
+ export const GITLAB_TOOL_NAMES = [
5
+ "gitlab_connection_get",
6
+ "gitlab_projects_list",
7
+ "gitlab_project_get",
8
+ "gitlab_repository_tree",
9
+ "gitlab_repository_file_get",
10
+ "gitlab_commits_list",
11
+ "gitlab_commit_get",
12
+ "gitlab_compare",
13
+ "gitlab_search",
14
+ "gitlab_issues_list",
15
+ "gitlab_issue_get",
16
+ "gitlab_issue_notes_list",
17
+ "gitlab_merge_requests_list",
18
+ "gitlab_merge_request_get",
19
+ "gitlab_merge_request_changes_get",
20
+ "gitlab_merge_request_discussions_list",
21
+ "gitlab_merge_request_approvals_get",
22
+ "gitlab_merge_request_pipelines_list",
23
+ "gitlab_pipelines_list",
24
+ "gitlab_pipeline_get",
25
+ "gitlab_pipeline_jobs_list",
26
+ "gitlab_job_get",
27
+ "gitlab_job_log_get",
28
+ ];
29
+ const PROJECT_HINT = "Project id (number) or full path such as group/subgroup/project. Both work; the id is what the operation is audited against.";
30
+ const GROUP_HINT = "Group id or full path, such as group/subgroup.";
31
+ /** GitLab accepts either the numeric id or the path, so both are offered. */
32
+ const REQUIRED_PROJECT = {
33
+ oneOf: [{ type: "string" }, { type: "number" }],
34
+ required: true,
35
+ description: PROJECT_HINT,
36
+ };
37
+ const PROJECT = {
38
+ oneOf: [{ type: "string" }, { type: "number" }],
39
+ description: PROJECT_HINT,
40
+ };
41
+ const GROUP = {
42
+ oneOf: [{ type: "string" }, { type: "number" }],
43
+ description: GROUP_HINT,
44
+ };
45
+ const REF_HINT = "Branch, tag or commit sha. Defaults to the project's default branch where GitLab allows it.";
46
+ const PAGE_HINT = "Pagination: GitLab returns 20 rows per page by default and at most 100; the answer carries `pagination.nextPage` while more rows exist.";
47
+ const STATE_HINT = 'State filter: "opened", "closed" or "all".';
48
+ const IID_HINT = "Internal id of the resource inside the project (the number shown as #123), not the global id.";
49
+ const TIMESTAMP_HINT = "ISO 8601 timestamp, or a plain date (YYYY-MM-DD) for midnight UTC.";
50
+ const LABELS_HINT = "Label names; several are ANDed, as GitLab does.";
51
+ const SORT_HINT = 'Sort direction: "asc" or "desc".';
52
+ /**
53
+ * Every tool reports what the *connected* GitLab account may read, never a
54
+ * caller-supplied identity: the account comes from the stored integration of
55
+ * the QA user who owns the DSH session, and the tool schemas carry no user,
56
+ * credential or instance selector.
57
+ */
58
+ export function createGitlabTools(options) {
59
+ const kit = createToolKit({ ...options, provider: "gitlab" });
60
+ const tool = kit.tool;
61
+ return [
62
+ tool({
63
+ name: "gitlab_connection_get",
64
+ description: "Which GitLab instance and user the integration is connected as. Read-only; returns the instance address, the GitLab login and profile name. No token is ever returned.",
65
+ parameters: {},
66
+ operation: "connection.get",
67
+ input: () => ({}),
68
+ }),
69
+ tool({
70
+ name: "gitlab_projects_list",
71
+ description: "Search projects visible to the connected GitLab account. Read-only; returns compact project cards (path, default branch, visibility), use gitlab_project_get for one project in full.",
72
+ parameters: {
73
+ search: {
74
+ type: "string",
75
+ description: "Case-insensitive substring of the project name or path.",
76
+ },
77
+ membership: {
78
+ type: "boolean",
79
+ description: "Only projects the connected account is a member of.",
80
+ },
81
+ archived: {
82
+ type: "boolean",
83
+ description: "true returns archived projects only, false hides them. Omit for both.",
84
+ },
85
+ orderBy: {
86
+ type: "string",
87
+ enum: ["id", "name", "path", "created_at", "last_activity_at"],
88
+ description: "Sort field. Defaults to GitLab's own ordering.",
89
+ },
90
+ sort: { type: "string", enum: ["asc", "desc"], description: SORT_HINT },
91
+ page: { type: "number", description: PAGE_HINT },
92
+ perPage: { type: "number", description: "Rows per page, at most 100." },
93
+ },
94
+ operation: "projects.list",
95
+ input: (args) => ({
96
+ ...(args["search"] === undefined
97
+ ? {}
98
+ : { search: requiredText(args["search"], "search", 1, 200) }),
99
+ ...(args["membership"] === undefined
100
+ ? {}
101
+ : { membership: optionalBoolean(args["membership"], "membership") }),
102
+ ...(args["archived"] === undefined
103
+ ? {}
104
+ : { archived: optionalBoolean(args["archived"], "archived") }),
105
+ ...(args["orderBy"] === undefined
106
+ ? {}
107
+ : { orderBy: requiredText(args["orderBy"], "orderBy", 2, 32) }),
108
+ ...(args["sort"] === undefined
109
+ ? {}
110
+ : { sort: requiredText(args["sort"], "sort", 3, 4) }),
111
+ ...(args["page"] === undefined
112
+ ? {}
113
+ : { page: optionalInteger(args["page"], "page", 1) }),
114
+ ...(args["perPage"] === undefined
115
+ ? {}
116
+ : { perPage: optionalInteger(args["perPage"], "perPage", 1, 100) }),
117
+ }),
118
+ }),
119
+ tool({
120
+ name: "gitlab_project_get",
121
+ description: "One project in full: description, default branch, visibility, namespace and timestamps. Read-only.",
122
+ parameters: {
123
+ project: REQUIRED_PROJECT,
124
+ },
125
+ operation: "projects.get",
126
+ input: (args) => ({ project: args["project"] }),
127
+ }),
128
+ tool({
129
+ name: "gitlab_repository_tree",
130
+ description: "List files and directories of a project at a ref, one directory level at a time. Read-only; a recursive listing is paged, so walk the tree instead of asking for a whole repository.",
131
+ parameters: {
132
+ project: REQUIRED_PROJECT,
133
+ path: {
134
+ type: "string",
135
+ description: "Directory path inside the repository. Omit for the root.",
136
+ },
137
+ ref: { type: "string", description: REF_HINT },
138
+ recursive: {
139
+ type: "boolean",
140
+ description: "List every descendant of `path`. Still paged; prefer walking.",
141
+ },
142
+ page: { type: "number", description: PAGE_HINT },
143
+ perPage: { type: "number", description: "Rows per page, at most 100." },
144
+ },
145
+ operation: "repository.tree",
146
+ input: (args) => ({
147
+ project: args["project"],
148
+ ...(args["path"] === undefined
149
+ ? {}
150
+ : { path: requiredText(args["path"], "path", 1, 512) }),
151
+ ...(args["ref"] === undefined
152
+ ? {}
153
+ : { ref: requiredText(args["ref"], "ref", 1, 255) }),
154
+ ...(args["recursive"] === undefined
155
+ ? {}
156
+ : { recursive: optionalBoolean(args["recursive"], "recursive") }),
157
+ ...(args["page"] === undefined
158
+ ? {}
159
+ : { page: optionalInteger(args["page"], "page", 1) }),
160
+ ...(args["perPage"] === undefined
161
+ ? {}
162
+ : { perPage: optionalInteger(args["perPage"], "perPage", 1, 100) }),
163
+ }),
164
+ }),
165
+ tool({
166
+ name: "gitlab_repository_file_get",
167
+ description: "Read one text file of a repository, with its size and blob id. Read-only. Binary files and files above the deployment limit answer with metadata only (`binary` or `truncated`), never with raw bytes.",
168
+ parameters: {
169
+ project: REQUIRED_PROJECT,
170
+ path: {
171
+ type: "string",
172
+ required: true,
173
+ description: "Full file path inside the repository.",
174
+ },
175
+ ref: { type: "string", description: REF_HINT },
176
+ maxBytes: {
177
+ type: "number",
178
+ description: "Byte budget for the returned body; capped by the deployment limit.",
179
+ },
180
+ },
181
+ operation: "repository.file",
182
+ input: (args) => ({
183
+ project: args["project"],
184
+ path: requiredText(args["path"], "path", 1, 512),
185
+ ...(args["ref"] === undefined
186
+ ? {}
187
+ : { ref: requiredText(args["ref"], "ref", 1, 255) }),
188
+ ...(args["maxBytes"] === undefined
189
+ ? {}
190
+ : { maxBytes: optionalInteger(args["maxBytes"], "maxBytes", 1_024) }),
191
+ }),
192
+ }),
193
+ tool({
194
+ name: "gitlab_commits_list",
195
+ description: "Commits of a project, optionally of one ref or one file path. Read-only; returns the compact card (short id, title, author, date).",
196
+ parameters: {
197
+ project: REQUIRED_PROJECT,
198
+ ref: { type: "string", description: REF_HINT },
199
+ path: {
200
+ type: "string",
201
+ description: "Only commits that changed this file.",
202
+ },
203
+ since: {
204
+ type: "string",
205
+ description: `Commits after this time. ${TIMESTAMP_HINT}`,
206
+ },
207
+ until: {
208
+ type: "string",
209
+ description: `Commits before this time. ${TIMESTAMP_HINT}`,
210
+ },
211
+ author: {
212
+ type: "string",
213
+ description: "Author name or e-mail, as GitLab matches it.",
214
+ },
215
+ page: { type: "number", description: PAGE_HINT },
216
+ perPage: { type: "number", description: "Rows per page, at most 100." },
217
+ },
218
+ operation: "repository.commits",
219
+ input: (args) => ({
220
+ project: args["project"],
221
+ ...(args["ref"] === undefined
222
+ ? {}
223
+ : { ref: requiredText(args["ref"], "ref", 1, 255) }),
224
+ ...(args["path"] === undefined
225
+ ? {}
226
+ : { path: requiredText(args["path"], "path", 1, 512) }),
227
+ ...(args["since"] === undefined
228
+ ? {}
229
+ : { since: requiredText(args["since"], "since", 10, 40) }),
230
+ ...(args["until"] === undefined
231
+ ? {}
232
+ : { until: requiredText(args["until"], "until", 10, 40) }),
233
+ ...(args["author"] === undefined
234
+ ? {}
235
+ : { author: requiredText(args["author"], "author", 1, 120) }),
236
+ ...(args["page"] === undefined
237
+ ? {}
238
+ : { page: optionalInteger(args["page"], "page", 1) }),
239
+ ...(args["perPage"] === undefined
240
+ ? {}
241
+ : { perPage: optionalInteger(args["perPage"], "perPage", 1, 100) }),
242
+ }),
243
+ }),
244
+ tool({
245
+ name: "gitlab_commit_get",
246
+ description: "One commit: full message, author and committer, parents and the diff line counts. Read-only; use gitlab_compare for the diff itself.",
247
+ parameters: {
248
+ project: REQUIRED_PROJECT,
249
+ sha: {
250
+ type: "string",
251
+ required: true,
252
+ description: "Commit sha, full or short (at least 7 characters).",
253
+ },
254
+ stats: {
255
+ type: "boolean",
256
+ description: "Include additions/deletions (on by default).",
257
+ },
258
+ },
259
+ operation: "repository.commit",
260
+ input: (args) => ({
261
+ project: args["project"],
262
+ sha: requiredText(args["sha"], "sha", 7, 40),
263
+ ...(args["stats"] === undefined
264
+ ? {}
265
+ : { stats: optionalBoolean(args["stats"], "stats") }),
266
+ }),
267
+ }),
268
+ tool({
269
+ name: "gitlab_compare",
270
+ description: "Compare two refs or commits of one project: the commits between them and the changed files. Read-only; diff bodies are capped and the answer says so with `diffTruncated`.",
271
+ parameters: {
272
+ project: REQUIRED_PROJECT,
273
+ from: {
274
+ type: "string",
275
+ required: true,
276
+ description: "Base ref or commit sha.",
277
+ },
278
+ to: {
279
+ type: "string",
280
+ required: true,
281
+ description: "Head ref or commit sha.",
282
+ },
283
+ unidiff: {
284
+ type: "boolean",
285
+ description: "Return diff bodies in unified format, with [--] markers instead of a bare hunk dump.",
286
+ },
287
+ },
288
+ operation: "repository.compare",
289
+ input: (args) => ({
290
+ project: args["project"],
291
+ from: requiredText(args["from"], "from", 1, 255),
292
+ to: requiredText(args["to"], "to", 1, 255),
293
+ ...(args["unidiff"] === undefined
294
+ ? {}
295
+ : { unidiff: optionalBoolean(args["unidiff"], "unidiff") }),
296
+ }),
297
+ }),
298
+ tool({
299
+ name: "gitlab_search",
300
+ description: "Search across GitLab as the connected account. Read-only. Code search (`blobs`) needs a project or a group: GitLab only offers it scope-locally. Results are capped by the deployment limit.",
301
+ parameters: {
302
+ query: { type: "string", required: true, description: "Search text." },
303
+ scope: {
304
+ type: "string",
305
+ required: true,
306
+ enum: [...SEARCH_SCOPES],
307
+ description: "What to search. `blobs` is code search, `notes` searches comments.",
308
+ },
309
+ project: PROJECT,
310
+ group: GROUP,
311
+ ref: {
312
+ type: "string",
313
+ description: "Ref to search in, only meaningful together with a project.",
314
+ },
315
+ page: { type: "number", description: PAGE_HINT },
316
+ perPage: {
317
+ type: "number",
318
+ description: "Rows per page, capped by the deployment search limit.",
319
+ },
320
+ },
321
+ operation: "search.run",
322
+ input: (args) => ({
323
+ query: requiredText(args["query"], "query", 1, 200),
324
+ scope: requiredText(args["scope"], "scope", 3, 32),
325
+ ...(args["project"] === undefined ? {} : { project: args["project"] }),
326
+ ...(args["group"] === undefined ? {} : { group: args["group"] }),
327
+ ...(args["ref"] === undefined
328
+ ? {}
329
+ : { ref: requiredText(args["ref"], "ref", 1, 255) }),
330
+ ...(args["page"] === undefined
331
+ ? {}
332
+ : { page: optionalInteger(args["page"], "page", 1) }),
333
+ ...(args["perPage"] === undefined
334
+ ? {}
335
+ : { perPage: optionalInteger(args["perPage"], "perPage", 1, 100) }),
336
+ }),
337
+ }),
338
+ tool({
339
+ name: "gitlab_issues_list",
340
+ description: "Search issues across the projects the connected account can see, or inside one project. Read-only; returns compact cards without descriptions.",
341
+ parameters: {
342
+ project: PROJECT,
343
+ state: {
344
+ type: "string",
345
+ enum: ["opened", "closed", "all"],
346
+ description: STATE_HINT,
347
+ },
348
+ scope: {
349
+ type: "string",
350
+ enum: [...ISSUE_SCOPES],
351
+ description: "Whose issues. Not naming one returns every issue the token may read.",
352
+ },
353
+ assigneeUsername: { type: "string", description: "Assignee login." },
354
+ authorUsername: { type: "string", description: "Author login." },
355
+ labels: {
356
+ type: "array",
357
+ items: { type: "string" },
358
+ description: LABELS_HINT,
359
+ },
360
+ milestone: { type: "string", description: "Milestone title." },
361
+ search: {
362
+ type: "string",
363
+ description: "Substring of the title or description.",
364
+ },
365
+ updatedAfter: {
366
+ type: "string",
367
+ description: `Updated after. ${TIMESTAMP_HINT}`,
368
+ },
369
+ updatedBefore: {
370
+ type: "string",
371
+ description: `Updated before. ${TIMESTAMP_HINT}`,
372
+ },
373
+ page: { type: "number", description: PAGE_HINT },
374
+ perPage: { type: "number", description: "Rows per page, at most 100." },
375
+ },
376
+ operation: "issues.list",
377
+ input: (args) => ({
378
+ ...(args["project"] === undefined ? {} : { project: args["project"] }),
379
+ ...(args["state"] === undefined
380
+ ? {}
381
+ : { state: requiredText(args["state"], "state", 3, 10) }),
382
+ ...(args["scope"] === undefined
383
+ ? {}
384
+ : { scope: requiredText(args["scope"], "scope", 2, 32) }),
385
+ ...(args["assigneeUsername"] === undefined
386
+ ? {}
387
+ : {
388
+ assigneeUsername: requiredText(args["assigneeUsername"], "assigneeUsername", 1, 120),
389
+ }),
390
+ ...(args["authorUsername"] === undefined
391
+ ? {}
392
+ : {
393
+ authorUsername: requiredText(args["authorUsername"], "authorUsername", 1, 120),
394
+ }),
395
+ ...(args["labels"] === undefined
396
+ ? {}
397
+ : { labels: requiredStringList(args["labels"], "labels", 20, 100) }),
398
+ ...(args["milestone"] === undefined
399
+ ? {}
400
+ : {
401
+ milestone: requiredText(args["milestone"], "milestone", 1, 120),
402
+ }),
403
+ ...(args["search"] === undefined
404
+ ? {}
405
+ : { search: requiredText(args["search"], "search", 1, 200) }),
406
+ ...(args["updatedAfter"] === undefined
407
+ ? {}
408
+ : {
409
+ updatedAfter: requiredText(args["updatedAfter"], "updatedAfter", 10, 40),
410
+ }),
411
+ ...(args["updatedBefore"] === undefined
412
+ ? {}
413
+ : {
414
+ updatedBefore: requiredText(args["updatedBefore"], "updatedBefore", 10, 40),
415
+ }),
416
+ ...(args["page"] === undefined
417
+ ? {}
418
+ : { page: optionalInteger(args["page"], "page", 1) }),
419
+ ...(args["perPage"] === undefined
420
+ ? {}
421
+ : { perPage: optionalInteger(args["perPage"], "perPage", 1, 100) }),
422
+ }),
423
+ }),
424
+ tool({
425
+ name: "gitlab_issue_get",
426
+ description: "One issue in full, including its description, milestone and due date. Read-only.",
427
+ parameters: {
428
+ project: REQUIRED_PROJECT,
429
+ iid: { type: "number", required: true, description: IID_HINT },
430
+ },
431
+ operation: "issues.get",
432
+ input: (args) => ({
433
+ project: args["project"],
434
+ iid: requiredInteger(args["iid"], "iid"),
435
+ }),
436
+ }),
437
+ tool({
438
+ name: "gitlab_issue_notes_list",
439
+ description: "Comments of one issue, oldest or newest first. Read-only; system notes (label changes, moves) are marked as such.",
440
+ parameters: {
441
+ project: REQUIRED_PROJECT,
442
+ iid: { type: "number", required: true, description: IID_HINT },
443
+ sort: {
444
+ type: "string",
445
+ enum: ["asc", "desc"],
446
+ description: `Order by creation time. ${SORT_HINT}`,
447
+ },
448
+ page: { type: "number", description: PAGE_HINT },
449
+ perPage: { type: "number", description: "Rows per page, at most 100." },
450
+ },
451
+ operation: "issues.notes",
452
+ input: (args) => ({
453
+ project: args["project"],
454
+ iid: requiredInteger(args["iid"], "iid"),
455
+ ...(args["sort"] === undefined
456
+ ? {}
457
+ : { sort: requiredText(args["sort"], "sort", 3, 4) }),
458
+ ...(args["page"] === undefined
459
+ ? {}
460
+ : { page: optionalInteger(args["page"], "page", 1) }),
461
+ ...(args["perPage"] === undefined
462
+ ? {}
463
+ : { perPage: optionalInteger(args["perPage"], "perPage", 1, 100) }),
464
+ }),
465
+ }),
466
+ tool({
467
+ name: "gitlab_merge_requests_list",
468
+ description: "Search merge requests across the projects the connected account can see, or inside one project. Read-only; returns compact cards without descriptions.",
469
+ parameters: {
470
+ project: PROJECT,
471
+ state: {
472
+ type: "string",
473
+ enum: ["opened", "closed", "locked", "merged", "all"],
474
+ description: 'State filter, "all" includes merged.',
475
+ },
476
+ scope: {
477
+ type: "string",
478
+ enum: [...MR_SCOPES],
479
+ description: "Whose merge requests. Not naming one returns every MR the token may read.",
480
+ },
481
+ sourceBranch: { type: "string", description: "Source branch name." },
482
+ targetBranch: { type: "string", description: "Target branch name." },
483
+ authorUsername: { type: "string", description: "Author login." },
484
+ assigneeUsername: { type: "string", description: "Assignee login." },
485
+ reviewerUsername: { type: "string", description: "Reviewer login." },
486
+ labels: {
487
+ type: "array",
488
+ items: { type: "string" },
489
+ description: LABELS_HINT,
490
+ },
491
+ search: {
492
+ type: "string",
493
+ description: "Substring of the title or description.",
494
+ },
495
+ draft: {
496
+ type: "boolean",
497
+ description: "true returns drafts only, false hides them.",
498
+ },
499
+ updatedAfter: {
500
+ type: "string",
501
+ description: `Updated after. ${TIMESTAMP_HINT}`,
502
+ },
503
+ updatedBefore: {
504
+ type: "string",
505
+ description: `Updated before. ${TIMESTAMP_HINT}`,
506
+ },
507
+ page: { type: "number", description: PAGE_HINT },
508
+ perPage: { type: "number", description: "Rows per page, at most 100." },
509
+ },
510
+ operation: "mergeRequests.list",
511
+ input: (args) => ({
512
+ ...(args["project"] === undefined ? {} : { project: args["project"] }),
513
+ ...(args["state"] === undefined
514
+ ? {}
515
+ : { state: requiredText(args["state"], "state", 3, 10) }),
516
+ ...(args["scope"] === undefined
517
+ ? {}
518
+ : { scope: requiredText(args["scope"], "scope", 2, 32) }),
519
+ ...(args["sourceBranch"] === undefined
520
+ ? {}
521
+ : {
522
+ sourceBranch: requiredText(args["sourceBranch"], "sourceBranch", 1, 255),
523
+ }),
524
+ ...(args["targetBranch"] === undefined
525
+ ? {}
526
+ : {
527
+ targetBranch: requiredText(args["targetBranch"], "targetBranch", 1, 255),
528
+ }),
529
+ ...(args["authorUsername"] === undefined
530
+ ? {}
531
+ : {
532
+ authorUsername: requiredText(args["authorUsername"], "authorUsername", 1, 120),
533
+ }),
534
+ ...(args["assigneeUsername"] === undefined
535
+ ? {}
536
+ : {
537
+ assigneeUsername: requiredText(args["assigneeUsername"], "assigneeUsername", 1, 120),
538
+ }),
539
+ ...(args["reviewerUsername"] === undefined
540
+ ? {}
541
+ : {
542
+ reviewerUsername: requiredText(args["reviewerUsername"], "reviewerUsername", 1, 120),
543
+ }),
544
+ ...(args["labels"] === undefined
545
+ ? {}
546
+ : { labels: requiredStringList(args["labels"], "labels", 20, 100) }),
547
+ ...(args["search"] === undefined
548
+ ? {}
549
+ : { search: requiredText(args["search"], "search", 1, 200) }),
550
+ ...(args["draft"] === undefined
551
+ ? {}
552
+ : { draft: optionalBoolean(args["draft"], "draft") }),
553
+ ...(args["updatedAfter"] === undefined
554
+ ? {}
555
+ : {
556
+ updatedAfter: requiredText(args["updatedAfter"], "updatedAfter", 10, 40),
557
+ }),
558
+ ...(args["updatedBefore"] === undefined
559
+ ? {}
560
+ : {
561
+ updatedBefore: requiredText(args["updatedBefore"], "updatedBefore", 10, 40),
562
+ }),
563
+ ...(args["page"] === undefined
564
+ ? {}
565
+ : { page: optionalInteger(args["page"], "page", 1) }),
566
+ ...(args["perPage"] === undefined
567
+ ? {}
568
+ : { perPage: optionalInteger(args["perPage"], "perPage", 1, 100) }),
569
+ }),
570
+ }),
571
+ tool({
572
+ name: "gitlab_merge_request_get",
573
+ description: "One merge request in full: description, branches, reviewers, merge status and conflict flag. Read-only.",
574
+ parameters: {
575
+ project: REQUIRED_PROJECT,
576
+ iid: { type: "number", required: true, description: IID_HINT },
577
+ },
578
+ operation: "mergeRequests.get",
579
+ input: (args) => ({
580
+ project: args["project"],
581
+ iid: requiredInteger(args["iid"], "iid"),
582
+ }),
583
+ }),
584
+ tool({
585
+ name: "gitlab_merge_request_changes_get",
586
+ description: "Files changed by a merge request, with their diffs. Read-only; paged, and the diff text of one answer is capped (`diffTruncated`), while every changed path is still listed.",
587
+ parameters: {
588
+ project: REQUIRED_PROJECT,
589
+ iid: { type: "number", required: true, description: IID_HINT },
590
+ unidiff: {
591
+ type: "boolean",
592
+ description: "Return unified diff bodies with [--] markers.",
593
+ },
594
+ page: { type: "number", description: PAGE_HINT },
595
+ perPage: {
596
+ type: "number",
597
+ description: "Files per page, at most 100.",
598
+ },
599
+ },
600
+ operation: "mergeRequests.changes",
601
+ input: (args) => ({
602
+ project: args["project"],
603
+ iid: requiredInteger(args["iid"], "iid"),
604
+ ...(args["unidiff"] === undefined
605
+ ? {}
606
+ : { unidiff: optionalBoolean(args["unidiff"], "unidiff") }),
607
+ ...(args["page"] === undefined
608
+ ? {}
609
+ : { page: optionalInteger(args["page"], "page", 1) }),
610
+ ...(args["perPage"] === undefined
611
+ ? {}
612
+ : { perPage: optionalInteger(args["perPage"], "perPage", 1, 100) }),
613
+ }),
614
+ }),
615
+ tool({
616
+ name: "gitlab_merge_request_discussions_list",
617
+ description: "Review discussions of a merge request with their comments and resolution state. Read-only.",
618
+ parameters: {
619
+ project: REQUIRED_PROJECT,
620
+ iid: { type: "number", required: true, description: IID_HINT },
621
+ page: { type: "number", description: PAGE_HINT },
622
+ perPage: { type: "number", description: "Rows per page, at most 100." },
623
+ },
624
+ operation: "mergeRequests.discussions",
625
+ input: (args) => ({
626
+ project: args["project"],
627
+ iid: requiredInteger(args["iid"], "iid"),
628
+ ...(args["page"] === undefined
629
+ ? {}
630
+ : { page: optionalInteger(args["page"], "page", 1) }),
631
+ ...(args["perPage"] === undefined
632
+ ? {}
633
+ : { perPage: optionalInteger(args["perPage"], "perPage", 1, 100) }),
634
+ }),
635
+ }),
636
+ tool({
637
+ name: "gitlab_merge_request_approvals_get",
638
+ description: "Approval state of a merge request: how many approvals are required, how many are left and who approved. Read-only; GitLab tiers differ, an unsupported instance answers with an explicit refusal.",
639
+ parameters: {
640
+ project: REQUIRED_PROJECT,
641
+ iid: { type: "number", required: true, description: IID_HINT },
642
+ },
643
+ operation: "mergeRequests.approvals",
644
+ input: (args) => ({
645
+ project: args["project"],
646
+ iid: requiredInteger(args["iid"], "iid"),
647
+ }),
648
+ }),
649
+ tool({
650
+ name: "gitlab_merge_request_pipelines_list",
651
+ description: "Pipelines attached to a merge request. Read-only; returns compact pipeline cards, use gitlab_pipeline_get for one in full.",
652
+ parameters: {
653
+ project: REQUIRED_PROJECT,
654
+ iid: { type: "number", required: true, description: IID_HINT },
655
+ page: { type: "number", description: PAGE_HINT },
656
+ perPage: { type: "number", description: "Rows per page, at most 100." },
657
+ },
658
+ operation: "mergeRequests.pipelines",
659
+ input: (args) => ({
660
+ project: args["project"],
661
+ iid: requiredInteger(args["iid"], "iid"),
662
+ ...(args["page"] === undefined
663
+ ? {}
664
+ : { page: optionalInteger(args["page"], "page", 1) }),
665
+ ...(args["perPage"] === undefined
666
+ ? {}
667
+ : { perPage: optionalInteger(args["perPage"], "perPage", 1, 100) }),
668
+ }),
669
+ }),
670
+ tool({
671
+ name: "gitlab_pipelines_list",
672
+ description: "Pipelines of a project, newest first unless GitLab orders otherwise. Read-only.",
673
+ parameters: {
674
+ project: REQUIRED_PROJECT,
675
+ ref: {
676
+ type: "string",
677
+ description: "Only pipelines of this branch or tag.",
678
+ },
679
+ status: {
680
+ type: "string",
681
+ enum: [
682
+ "created",
683
+ "waiting_for_resource",
684
+ "preparing",
685
+ "pending",
686
+ "running",
687
+ "success",
688
+ "failed",
689
+ "canceled",
690
+ "skipped",
691
+ "manual",
692
+ "scheduled",
693
+ ],
694
+ description: "Pipeline status filter.",
695
+ },
696
+ source: {
697
+ type: "string",
698
+ description: 'What started the pipeline, for example "push", "merge_request_event", "web", "schedule".',
699
+ },
700
+ username: {
701
+ type: "string",
702
+ description: "Login of the user who ran it.",
703
+ },
704
+ updatedAfter: {
705
+ type: "string",
706
+ description: `Updated after. ${TIMESTAMP_HINT}`,
707
+ },
708
+ updatedBefore: {
709
+ type: "string",
710
+ description: `Updated before. ${TIMESTAMP_HINT}`,
711
+ },
712
+ page: { type: "number", description: PAGE_HINT },
713
+ perPage: { type: "number", description: "Rows per page, at most 100." },
714
+ },
715
+ operation: "pipelines.list",
716
+ input: (args) => ({
717
+ project: args["project"],
718
+ ...(args["ref"] === undefined
719
+ ? {}
720
+ : { ref: requiredText(args["ref"], "ref", 1, 255) }),
721
+ ...(args["status"] === undefined
722
+ ? {}
723
+ : { status: requiredText(args["status"], "status", 3, 32) }),
724
+ ...(args["source"] === undefined
725
+ ? {}
726
+ : { source: requiredText(args["source"], "source", 3, 32) }),
727
+ ...(args["username"] === undefined
728
+ ? {}
729
+ : { username: requiredText(args["username"], "username", 1, 120) }),
730
+ ...(args["updatedAfter"] === undefined
731
+ ? {}
732
+ : {
733
+ updatedAfter: requiredText(args["updatedAfter"], "updatedAfter", 10, 40),
734
+ }),
735
+ ...(args["updatedBefore"] === undefined
736
+ ? {}
737
+ : {
738
+ updatedBefore: requiredText(args["updatedBefore"], "updatedBefore", 10, 40),
739
+ }),
740
+ ...(args["page"] === undefined
741
+ ? {}
742
+ : { page: optionalInteger(args["page"], "page", 1) }),
743
+ ...(args["perPage"] === undefined
744
+ ? {}
745
+ : { perPage: optionalInteger(args["perPage"], "perPage", 1, 100) }),
746
+ }),
747
+ }),
748
+ tool({
749
+ name: "gitlab_pipeline_get",
750
+ description: "One pipeline in full: status, ref, sha, durations, coverage and the human-readable detailed status. Read-only.",
751
+ parameters: {
752
+ project: REQUIRED_PROJECT,
753
+ pipelineId: {
754
+ type: "number",
755
+ required: true,
756
+ description: "Pipeline id from gitlab_pipelines_list.",
757
+ },
758
+ },
759
+ operation: "pipelines.get",
760
+ input: (args) => ({
761
+ project: args["project"],
762
+ pipelineId: requiredInteger(args["pipelineId"], "pipelineId"),
763
+ }),
764
+ }),
765
+ tool({
766
+ name: "gitlab_pipeline_jobs_list",
767
+ description: "Jobs of one pipeline with status, stage and duration. Read-only; use gitlab_job_log_get for the output of one job.",
768
+ parameters: {
769
+ project: REQUIRED_PROJECT,
770
+ pipelineId: {
771
+ type: "number",
772
+ required: true,
773
+ description: "Pipeline id from gitlab_pipelines_list.",
774
+ },
775
+ status: {
776
+ type: "string",
777
+ enum: [
778
+ "created",
779
+ "pending",
780
+ "running",
781
+ "success",
782
+ "failed",
783
+ "canceled",
784
+ "skipped",
785
+ "manual",
786
+ ],
787
+ description: "Only jobs in this status.",
788
+ },
789
+ includeRetried: {
790
+ type: "boolean",
791
+ description: "Also return jobs that were retried.",
792
+ },
793
+ page: { type: "number", description: PAGE_HINT },
794
+ perPage: { type: "number", description: "Rows per page, at most 100." },
795
+ },
796
+ operation: "pipelines.jobs",
797
+ input: (args) => ({
798
+ project: args["project"],
799
+ pipelineId: requiredInteger(args["pipelineId"], "pipelineId"),
800
+ ...(args["status"] === undefined
801
+ ? {}
802
+ : { status: requiredText(args["status"], "status", 3, 32) }),
803
+ ...(args["includeRetried"] === undefined
804
+ ? {}
805
+ : {
806
+ includeRetried: optionalBoolean(args["includeRetried"], "includeRetried"),
807
+ }),
808
+ ...(args["page"] === undefined
809
+ ? {}
810
+ : { page: optionalInteger(args["page"], "page", 1) }),
811
+ ...(args["perPage"] === undefined
812
+ ? {}
813
+ : { perPage: optionalInteger(args["perPage"], "perPage", 1, 100) }),
814
+ }),
815
+ }),
816
+ tool({
817
+ name: "gitlab_job_get",
818
+ description: "One CI job in full: status, stage, failure reason, tags, duration and the artifact file list. Read-only.",
819
+ parameters: {
820
+ project: REQUIRED_PROJECT,
821
+ jobId: {
822
+ type: "number",
823
+ required: true,
824
+ description: "Job id from gitlab_pipeline_jobs_list.",
825
+ },
826
+ },
827
+ operation: "jobs.get",
828
+ input: (args) => ({
829
+ project: args["project"],
830
+ jobId: requiredInteger(args["jobId"], "jobId"),
831
+ }),
832
+ }),
833
+ tool({
834
+ name: "gitlab_job_log_get",
835
+ description: "Log of one CI job, with the byte count and a truncation marker. Read-only; the log is bounded by the deployment limit and stripped of token-shaped strings, because GitLab's own masking is a filter and not a promise.",
836
+ parameters: {
837
+ project: REQUIRED_PROJECT,
838
+ jobId: {
839
+ type: "number",
840
+ required: true,
841
+ description: "Job id from gitlab_pipeline_jobs_list.",
842
+ },
843
+ maxBytes: {
844
+ type: "number",
845
+ description: "Byte budget for the returned log; capped by the deployment limit.",
846
+ },
847
+ },
848
+ operation: "jobs.log",
849
+ input: (args) => ({
850
+ project: args["project"],
851
+ jobId: requiredInteger(args["jobId"], "jobId"),
852
+ ...(args["maxBytes"] === undefined
853
+ ? {}
854
+ : { maxBytes: optionalInteger(args["maxBytes"], "maxBytes", 1_024) }),
855
+ }),
856
+ }),
857
+ ];
858
+ }
859
+ //# sourceMappingURL=tools.js.map