@github-tools/sdk 1.12.0 → 1.14.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 (45) hide show
  1. package/README.md +22 -17
  2. package/dist/connect/eve.d.mts +2 -3
  3. package/dist/connect/eve.d.mts.map +1 -1
  4. package/dist/connect/eve.mjs +1 -1
  5. package/dist/connect.d.mts +8 -86
  6. package/dist/connect.d.mts.map +1 -1
  7. package/dist/connect.mjs +2 -2
  8. package/dist/eve-runtime-BdolQrBF.mjs +275 -0
  9. package/dist/eve-runtime-BdolQrBF.mjs.map +1 -0
  10. package/dist/{eve-runtime-BmoVTbEU.d.mts → eve-runtime-D1v4C0UP.d.mts} +14 -6
  11. package/dist/eve-runtime-D1v4C0UP.d.mts.map +1 -0
  12. package/dist/eve-runtime.d.mts +4 -3
  13. package/dist/eve-runtime.mjs +2 -2
  14. package/dist/eve.d.mts +4 -4
  15. package/dist/eve.d.mts.map +1 -1
  16. package/dist/eve.mjs +2 -2
  17. package/dist/index-PqQNoVuw.d.mts +287 -0
  18. package/dist/index-PqQNoVuw.d.mts.map +1 -0
  19. package/dist/index.d.mts +3 -2
  20. package/dist/index.mjs +3 -3
  21. package/dist/{src-D45Onmsn.mjs → src-D9WxaIVj.mjs} +83 -4
  22. package/dist/src-D9WxaIVj.mjs.map +1 -0
  23. package/dist/{token-BIn80-XU.mjs → token-Dt6qs_kf.mjs} +9 -168
  24. package/dist/token-Dt6qs_kf.mjs.map +1 -0
  25. package/dist/tool-types-DbZpOYFG.d.mts +3312 -0
  26. package/dist/tool-types-DbZpOYFG.d.mts.map +1 -0
  27. package/dist/{types-CiNZNOXa.d.mts → types-BAEqBfM5.d.mts} +3 -3
  28. package/dist/{types-CiNZNOXa.d.mts.map → types-BAEqBfM5.d.mts.map} +1 -1
  29. package/dist/{types-CoTpsxxp.d.mts → types-CCoH12WC.d.mts} +4 -3
  30. package/dist/types-CCoH12WC.d.mts.map +1 -0
  31. package/dist/workflow.d.mts +2 -1
  32. package/dist/workflow.d.mts.map +1 -1
  33. package/dist/workflow.mjs +2 -2
  34. package/dist/{write-tools-CnJE0Vvu.mjs → write-tools-Ct0ZV87Z.mjs} +1296 -306
  35. package/dist/write-tools-Ct0ZV87Z.mjs.map +1 -0
  36. package/package.json +3 -3
  37. package/dist/eve-runtime-3asyv7YM.mjs +0 -771
  38. package/dist/eve-runtime-3asyv7YM.mjs.map +0 -1
  39. package/dist/eve-runtime-BmoVTbEU.d.mts.map +0 -1
  40. package/dist/index-CGeFo38P.d.mts +0 -783
  41. package/dist/index-CGeFo38P.d.mts.map +0 -1
  42. package/dist/src-D45Onmsn.mjs.map +0 -1
  43. package/dist/token-BIn80-XU.mjs.map +0 -1
  44. package/dist/types-CoTpsxxp.d.mts.map +0 -1
  45. package/dist/write-tools-CnJE0Vvu.mjs.map +0 -1
@@ -0,0 +1,3312 @@
1
+ import { Tool } from "ai";
2
+ import { z } from "zod";
3
+ import { Octokit as Octokit$1 } from "octokit";
4
+ //#region src/core/detail.d.ts
5
+ type DetailLevel = 'summary' | 'full';
6
+ //#endregion
7
+ //#region src/core/bundles.d.ts
8
+ declare function getPullRequestContextCore({ token, owner, repo, pullNumber, includeFiles, includeReviews, includeChecks, includePatch, filesPerPage, detail }: {
9
+ token: string;
10
+ owner: string;
11
+ repo: string;
12
+ pullNumber: number;
13
+ includeFiles: boolean;
14
+ includeReviews: boolean;
15
+ includeChecks: boolean;
16
+ includePatch: boolean;
17
+ filesPerPage: number;
18
+ detail?: DetailLevel;
19
+ }): Promise<{
20
+ checks?: {
21
+ checkRuns: {
22
+ hasMore: boolean;
23
+ page: number;
24
+ perPage: number;
25
+ nextPage?: number;
26
+ totalCount: number;
27
+ checkRuns: {
28
+ id: number;
29
+ name: string;
30
+ status: "completed" | "in_progress" | "queued" | "requested" | "waiting" | "pending";
31
+ conclusion: "success" | "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "timed_out" | null;
32
+ url: string | null;
33
+ startedAt: string | null;
34
+ completedAt: string | null;
35
+ }[];
36
+ };
37
+ combinedStatus: {
38
+ state: string;
39
+ totalCount: number;
40
+ statuses: {
41
+ context: string;
42
+ state: string;
43
+ description: string | null;
44
+ url: string | null;
45
+ }[];
46
+ };
47
+ } | undefined;
48
+ reviews?: {
49
+ id: number;
50
+ state: string;
51
+ body: string;
52
+ author: string | undefined;
53
+ url: string;
54
+ submittedAt: string | undefined;
55
+ }[] | undefined;
56
+ reviewsHasMore?: boolean | undefined;
57
+ files?: {
58
+ patch?: string | undefined;
59
+ filename: string;
60
+ status: "added" | "removed" | "modified" | "renamed" | "copied" | "changed" | "unchanged";
61
+ additions: number;
62
+ deletions: number;
63
+ changes: number;
64
+ }[] | undefined;
65
+ filesHasMore?: boolean | undefined;
66
+ pullRequest: {
67
+ number: number;
68
+ title: string;
69
+ body: string | null | undefined;
70
+ state: "open" | "closed";
71
+ url: string;
72
+ author: string;
73
+ branch: string;
74
+ headSha: string;
75
+ base: string;
76
+ draft: boolean | undefined;
77
+ merged: boolean;
78
+ mergeable: boolean | null;
79
+ additions: number;
80
+ deletions: number;
81
+ changedFiles: number;
82
+ createdAt: string;
83
+ updatedAt: string;
84
+ mergedAt: string | null;
85
+ };
86
+ }>;
87
+ declare function getIssueContextCore({ token, owner, repo, issueNumber, includeLabels, includeComments, maxComments, detail }: {
88
+ token: string;
89
+ owner: string;
90
+ repo: string;
91
+ issueNumber: number;
92
+ includeLabels: boolean;
93
+ includeComments: boolean;
94
+ maxComments: number;
95
+ detail?: DetailLevel;
96
+ }): Promise<{
97
+ comments?: {
98
+ id: number;
99
+ url: string;
100
+ body: string | null | undefined;
101
+ author: string | undefined;
102
+ createdAt: string;
103
+ updatedAt: string;
104
+ }[] | undefined;
105
+ commentsHasMore?: boolean | undefined;
106
+ labelNames?: string[] | undefined;
107
+ issue: {
108
+ number: number;
109
+ title: string;
110
+ body: string | null | undefined;
111
+ state: string;
112
+ url: string;
113
+ author: string | undefined;
114
+ assignees: string[] | undefined;
115
+ labels: (string | undefined)[];
116
+ comments: number;
117
+ createdAt: string;
118
+ updatedAt: string;
119
+ closedAt: string | null;
120
+ };
121
+ }>;
122
+ declare function getReleaseContextCore({ token, owner, repo, releaseId, includePrevious, includeCompare, detail }: {
123
+ token: string;
124
+ owner: string;
125
+ repo: string;
126
+ releaseId?: number;
127
+ includePrevious: boolean;
128
+ includeCompare: boolean;
129
+ detail?: DetailLevel;
130
+ }): Promise<{
131
+ comparison?: {
132
+ status: "diverged" | "ahead" | "behind" | "identical";
133
+ aheadBy: number;
134
+ behindBy: number;
135
+ totalCommits: number;
136
+ url: string;
137
+ commits: {
138
+ sha: string;
139
+ message: string;
140
+ author: string | undefined;
141
+ authorLogin: string | undefined;
142
+ }[];
143
+ files: {
144
+ patch?: string | undefined;
145
+ filename: string;
146
+ status: "added" | "removed" | "modified" | "renamed" | "copied" | "changed" | "unchanged";
147
+ additions: number;
148
+ deletions: number;
149
+ }[] | undefined;
150
+ } | undefined;
151
+ previousRelease?: {
152
+ id: number;
153
+ tagName: string;
154
+ name: string | null;
155
+ body: string | null | undefined;
156
+ draft: boolean;
157
+ prerelease: boolean;
158
+ url: string;
159
+ author: string;
160
+ createdAt: string;
161
+ publishedAt: string | null;
162
+ } | undefined;
163
+ release: {
164
+ id: number;
165
+ tagName: string;
166
+ name: string | null;
167
+ body: string | null | undefined;
168
+ url: string;
169
+ author: string;
170
+ createdAt: string;
171
+ publishedAt: string | null;
172
+ assets: {
173
+ name: string;
174
+ downloadUrl: string;
175
+ size: number;
176
+ downloadCount: number;
177
+ }[];
178
+ };
179
+ }>;
180
+ declare function getCiFailureContextCore({ token, owner, repo, ref, maxFailedRuns, maxFailedJobs }: {
181
+ token: string;
182
+ owner: string;
183
+ repo: string;
184
+ ref: string;
185
+ maxFailedRuns: number;
186
+ maxFailedJobs: number;
187
+ }): Promise<{
188
+ latestFailure?: {
189
+ run: {
190
+ id: number;
191
+ name: string | null | undefined;
192
+ status: string | null;
193
+ conclusion: string | null;
194
+ branch: string | null;
195
+ event: string;
196
+ url: string;
197
+ actor: string | undefined;
198
+ createdAt: string;
199
+ updatedAt: string;
200
+ runNumber: number;
201
+ runAttempt: number | undefined;
202
+ };
203
+ jobs: Array<{
204
+ id: number;
205
+ name: string;
206
+ status: string;
207
+ conclusion: string | null;
208
+ url: string | null;
209
+ startedAt: string;
210
+ completedAt: string | null;
211
+ steps?: Array<{
212
+ name: string;
213
+ status: string;
214
+ conclusion: string | null;
215
+ number: number;
216
+ startedAt?: string | null;
217
+ completedAt?: string | null;
218
+ }>;
219
+ }>;
220
+ } | undefined;
221
+ ref: string;
222
+ combinedStatus: {
223
+ state: string;
224
+ totalCount: number;
225
+ statuses: {
226
+ context: string;
227
+ state: string;
228
+ description: string | null;
229
+ url: string | null;
230
+ }[];
231
+ };
232
+ failedCheckRuns: {
233
+ id: number;
234
+ name: string;
235
+ status: "completed" | "in_progress" | "queued" | "requested" | "waiting" | "pending";
236
+ conclusion: "success" | "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "timed_out" | null;
237
+ url: string | null;
238
+ startedAt: string | null;
239
+ completedAt: string | null;
240
+ }[];
241
+ checkRunTotalCount: number;
242
+ recentFailedRuns: {
243
+ id: number;
244
+ name: string | null | undefined;
245
+ status: string | null;
246
+ conclusion: string | null;
247
+ branch: string | null;
248
+ event: string;
249
+ url: string;
250
+ actor: string | undefined;
251
+ createdAt: string;
252
+ updatedAt: string;
253
+ runNumber: number;
254
+ runAttempt: number | undefined;
255
+ }[];
256
+ }>;
257
+ //#endregion
258
+ //#region src/core/checks.d.ts
259
+ declare function listCheckRunsCore({ token, owner, repo, ref, perPage, page, maxPages }: {
260
+ token: string;
261
+ owner: string;
262
+ repo: string;
263
+ ref: string;
264
+ perPage: number;
265
+ page?: number;
266
+ maxPages?: number;
267
+ }): Promise<{
268
+ hasMore: boolean;
269
+ page: number;
270
+ perPage: number;
271
+ nextPage?: number;
272
+ totalCount: number;
273
+ checkRuns: {
274
+ id: number;
275
+ name: string;
276
+ status: "completed" | "in_progress" | "queued" | "requested" | "waiting" | "pending";
277
+ conclusion: "success" | "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "timed_out" | null;
278
+ url: string | null;
279
+ startedAt: string | null;
280
+ completedAt: string | null;
281
+ }[];
282
+ }>;
283
+ declare function getCombinedStatusCore({ token, owner, repo, ref }: {
284
+ token: string;
285
+ owner: string;
286
+ repo: string;
287
+ ref: string;
288
+ }): Promise<{
289
+ state: string;
290
+ totalCount: number;
291
+ statuses: {
292
+ context: string;
293
+ state: string;
294
+ description: string | null;
295
+ url: string | null;
296
+ }[];
297
+ }>;
298
+ //#endregion
299
+ //#region src/core/pagination.d.ts
300
+ type PagingFields = {
301
+ hasMore: boolean;
302
+ page: number;
303
+ perPage: number;
304
+ nextPage?: number;
305
+ };
306
+ type PagedList<T> = {
307
+ items: T[];
308
+ } & PagingFields;
309
+ //#endregion
310
+ //#region src/core/commits.d.ts
311
+ declare function listCommitsCore({ token, owner, repo, path, sha, author, since, until, perPage, page, maxPages }: {
312
+ token: string;
313
+ owner: string;
314
+ repo: string;
315
+ path?: string;
316
+ sha?: string;
317
+ author?: string;
318
+ since?: string;
319
+ until?: string;
320
+ perPage: number;
321
+ page?: number;
322
+ maxPages?: number;
323
+ }): Promise<PagedList<{
324
+ sha: string;
325
+ message: string;
326
+ author: string | undefined;
327
+ authorLogin: string | undefined;
328
+ date: string | undefined;
329
+ url: string;
330
+ }>>;
331
+ declare function getCommitCore({ token, owner, repo, ref, includePatch }: {
332
+ token: string;
333
+ owner: string;
334
+ repo: string;
335
+ ref: string;
336
+ includePatch: boolean;
337
+ }): Promise<{
338
+ sha: string;
339
+ message: string;
340
+ author: string | undefined;
341
+ authorLogin: string | undefined;
342
+ date: string | undefined;
343
+ url: string;
344
+ stats: {
345
+ additions: number | undefined;
346
+ deletions: number | undefined;
347
+ total: number | undefined;
348
+ } | null;
349
+ files: {
350
+ patch?: string | undefined;
351
+ filename: string;
352
+ status: "added" | "removed" | "modified" | "renamed" | "copied" | "changed" | "unchanged";
353
+ additions: number;
354
+ deletions: number;
355
+ }[] | undefined;
356
+ }>;
357
+ declare function getBlameCore({ token, owner, repo, path, ref, line, lineStart, lineEnd }: {
358
+ token: string;
359
+ owner: string;
360
+ repo: string;
361
+ path: string;
362
+ ref?: string;
363
+ line?: number;
364
+ lineStart?: number;
365
+ lineEnd?: number;
366
+ }): Promise<{
367
+ error: string;
368
+ ref?: undefined;
369
+ tipSha?: undefined;
370
+ path?: undefined;
371
+ rangeCount?: undefined;
372
+ ranges?: undefined;
373
+ } | {
374
+ ref: string;
375
+ tipSha: string;
376
+ path: string;
377
+ rangeCount: number;
378
+ ranges: {
379
+ startingLine: number;
380
+ endingLine: number;
381
+ age: number;
382
+ commit: {
383
+ sha: string;
384
+ abbreviatedSha: string;
385
+ messageHeadline: string;
386
+ authoredDate: string;
387
+ url: string;
388
+ authorName: string | null;
389
+ authorEmail: string | null;
390
+ authorLogin: string | null;
391
+ };
392
+ }[];
393
+ error?: undefined;
394
+ }>;
395
+ declare function compareCommitsCore({ token, owner, repo, base, head, includePatch }: {
396
+ token: string;
397
+ owner: string;
398
+ repo: string;
399
+ base: string;
400
+ head: string;
401
+ includePatch: boolean;
402
+ }): Promise<{
403
+ status: "diverged" | "ahead" | "behind" | "identical";
404
+ aheadBy: number;
405
+ behindBy: number;
406
+ totalCommits: number;
407
+ url: string;
408
+ commits: {
409
+ sha: string;
410
+ message: string;
411
+ author: string | undefined;
412
+ authorLogin: string | undefined;
413
+ }[];
414
+ files: {
415
+ patch?: string | undefined;
416
+ filename: string;
417
+ status: "added" | "removed" | "modified" | "renamed" | "copied" | "changed" | "unchanged";
418
+ additions: number;
419
+ deletions: number;
420
+ }[] | undefined;
421
+ }>;
422
+ //#endregion
423
+ //#region src/core/discussions.d.ts
424
+ declare function listDiscussionsCore({ token, owner, repo, category, perPage, after }: {
425
+ token: string;
426
+ owner: string;
427
+ repo: string;
428
+ category?: string;
429
+ perPage: number;
430
+ after?: string;
431
+ }): Promise<{
432
+ error: string;
433
+ hasNextPage?: undefined;
434
+ endCursor?: undefined;
435
+ discussions?: undefined;
436
+ } | {
437
+ hasNextPage: boolean;
438
+ endCursor: string | null;
439
+ discussions: {
440
+ id: string;
441
+ number: number;
442
+ title: string;
443
+ url: string;
444
+ author: string | null;
445
+ category: string | null;
446
+ answerChosen: boolean | null;
447
+ createdAt: string;
448
+ updatedAt: string;
449
+ }[];
450
+ error?: undefined;
451
+ }>;
452
+ declare function getDiscussionCore({ token, owner, repo, discussionNumber, detail }: {
453
+ token: string;
454
+ owner: string;
455
+ repo: string;
456
+ discussionNumber: number;
457
+ detail?: DetailLevel;
458
+ }): Promise<{
459
+ error: string;
460
+ id?: undefined;
461
+ number?: undefined;
462
+ title?: undefined;
463
+ body?: undefined;
464
+ url?: undefined;
465
+ author?: undefined;
466
+ category?: undefined;
467
+ answerChosen?: undefined;
468
+ commentsCount?: undefined;
469
+ createdAt?: undefined;
470
+ updatedAt?: undefined;
471
+ } | {
472
+ id: string;
473
+ number: number;
474
+ title: string;
475
+ body: string | null | undefined;
476
+ url: string;
477
+ author: string | null;
478
+ category: string | null;
479
+ answerChosen: boolean | null;
480
+ commentsCount: number;
481
+ createdAt: string;
482
+ updatedAt: string;
483
+ error?: undefined;
484
+ }>;
485
+ /** Not idempotent — each call adds another comment. */
486
+ declare function addDiscussionCommentCore({ token, owner, repo, discussionNumber, body }: {
487
+ token: string;
488
+ owner: string;
489
+ repo: string;
490
+ discussionNumber: number;
491
+ body: string;
492
+ }): Promise<{
493
+ error: string;
494
+ id?: undefined;
495
+ url?: undefined;
496
+ body?: undefined;
497
+ author?: undefined;
498
+ createdAt?: undefined;
499
+ } | {
500
+ id: string;
501
+ url: string;
502
+ body: string;
503
+ author: string | null;
504
+ createdAt: string;
505
+ error?: undefined;
506
+ }>;
507
+ //#endregion
508
+ //#region src/core/gists.d.ts
509
+ declare function listGistsCore({ token, username, perPage, page }: {
510
+ token: string;
511
+ username?: string;
512
+ perPage: number;
513
+ page: number;
514
+ }): Promise<PagedList<{
515
+ id: string;
516
+ description: string | null;
517
+ public: boolean;
518
+ url: string;
519
+ files: string[];
520
+ owner: string | undefined;
521
+ comments: number;
522
+ createdAt: string;
523
+ updatedAt: string;
524
+ }>>;
525
+ declare function getGistCore({ token, gistId }: {
526
+ token: string;
527
+ gistId: string;
528
+ }): Promise<{
529
+ id: string | undefined;
530
+ description: string | null | undefined;
531
+ public: boolean | undefined;
532
+ url: string | undefined;
533
+ owner: string | undefined;
534
+ files: {
535
+ filename: string | undefined;
536
+ language: string | undefined;
537
+ size: number | undefined;
538
+ content: string | undefined;
539
+ }[];
540
+ comments: number | undefined;
541
+ createdAt: string | undefined;
542
+ updatedAt: string | undefined;
543
+ }>;
544
+ declare function listGistCommentsCore({ token, gistId, perPage, page }: {
545
+ token: string;
546
+ gistId: string;
547
+ perPage: number;
548
+ page: number;
549
+ }): Promise<PagedList<{
550
+ id: number;
551
+ body: string;
552
+ author: string | undefined;
553
+ url: string;
554
+ createdAt: string;
555
+ updatedAt: string;
556
+ }>>;
557
+ /** Not idempotent — each call creates a new gist. */
558
+ declare function createGistCore({ token, description, files, isPublic }: {
559
+ token: string;
560
+ description?: string;
561
+ files: Record<string, {
562
+ content: string;
563
+ }>;
564
+ isPublic: boolean;
565
+ }): Promise<{
566
+ id: string | undefined;
567
+ description: string | null | undefined;
568
+ public: boolean | undefined;
569
+ url: string | undefined;
570
+ files: string[];
571
+ owner: string | undefined;
572
+ }>;
573
+ /** Not idempotent — each call applies a new revision. */
574
+ declare function updateGistCore({ token, gistId, description, files, filesToDelete }: {
575
+ token: string;
576
+ gistId: string;
577
+ description?: string;
578
+ files?: Record<string, {
579
+ content: string;
580
+ }>;
581
+ filesToDelete?: string[];
582
+ }): Promise<{
583
+ id: string | undefined;
584
+ description: string | null | undefined;
585
+ url: string | undefined;
586
+ files: string[];
587
+ }>;
588
+ /** Not idempotent — deleting an already-deleted gist returns 404 from GitHub. */
589
+ declare function deleteGistCore({ token, gistId }: {
590
+ token: string;
591
+ gistId: string;
592
+ }): Promise<{
593
+ deleted: boolean;
594
+ gistId: string;
595
+ }>;
596
+ /** Not idempotent — each call adds another comment. */
597
+ declare function createGistCommentCore({ token, gistId, body }: {
598
+ token: string;
599
+ gistId: string;
600
+ body: string;
601
+ }): Promise<{
602
+ id: number;
603
+ url: string;
604
+ body: string;
605
+ author: string | undefined;
606
+ createdAt: string;
607
+ }>;
608
+ //#endregion
609
+ //#region src/core/issues.d.ts
610
+ declare function listIssuesCore({ token, owner, repo, state, labels, perPage, page, maxPages }: {
611
+ token: string;
612
+ owner: string;
613
+ repo: string;
614
+ state: 'open' | 'closed' | 'all';
615
+ labels?: string;
616
+ perPage: number;
617
+ page?: number;
618
+ maxPages?: number;
619
+ }): Promise<PagedList<{
620
+ number: number;
621
+ title: string;
622
+ state: string;
623
+ url: string;
624
+ author: string | undefined;
625
+ labels: (string | undefined)[];
626
+ createdAt: string;
627
+ updatedAt: string;
628
+ }>>;
629
+ declare function getIssueCore({ token, owner, repo, issueNumber, detail }: {
630
+ token: string;
631
+ owner: string;
632
+ repo: string;
633
+ issueNumber: number;
634
+ detail?: DetailLevel;
635
+ }): Promise<{
636
+ number: number;
637
+ title: string;
638
+ body: string | null | undefined;
639
+ state: string;
640
+ url: string;
641
+ author: string | undefined;
642
+ assignees: string[] | undefined;
643
+ labels: (string | undefined)[];
644
+ comments: number;
645
+ createdAt: string;
646
+ updatedAt: string;
647
+ closedAt: string | null;
648
+ }>;
649
+ declare function listIssueCommentsCore({ token, owner, repo, issueNumber, perPage, page, detail }: {
650
+ token: string;
651
+ owner: string;
652
+ repo: string;
653
+ issueNumber: number;
654
+ perPage: number;
655
+ page: number;
656
+ detail?: DetailLevel;
657
+ }): Promise<PagedList<{
658
+ id: number;
659
+ url: string;
660
+ body: string | null | undefined;
661
+ author: string | undefined;
662
+ createdAt: string;
663
+ updatedAt: string;
664
+ }>>;
665
+ /** Not idempotent — each call creates a new issue. */
666
+ declare function createIssueCore({ token, owner, repo, title, body, labels, assignees }: {
667
+ token: string;
668
+ owner: string;
669
+ repo: string;
670
+ title: string;
671
+ body?: string;
672
+ labels?: string[];
673
+ assignees?: string[];
674
+ }): Promise<{
675
+ number: number;
676
+ title: string;
677
+ url: string;
678
+ state: string;
679
+ labels: (string | undefined)[];
680
+ }>;
681
+ /** Not idempotent — each call adds another comment. */
682
+ declare function addIssueCommentCore({ token, owner, repo, issueNumber, body }: {
683
+ token: string;
684
+ owner: string;
685
+ repo: string;
686
+ issueNumber: number;
687
+ body: string;
688
+ }): Promise<{
689
+ id: number;
690
+ url: string;
691
+ body: string | undefined;
692
+ author: string | undefined;
693
+ createdAt: string;
694
+ }>;
695
+ /** Idempotent when the issue is already closed. */
696
+ declare function closeIssueCore({ token, owner, repo, issueNumber, stateReason }: {
697
+ token: string;
698
+ owner: string;
699
+ repo: string;
700
+ issueNumber: number;
701
+ stateReason: 'completed' | 'not_planned';
702
+ }): Promise<{
703
+ number: number;
704
+ title: string;
705
+ state: string;
706
+ url: string;
707
+ closedAt: string | null;
708
+ }>;
709
+ /** Not idempotent — each call applies a new revision. */
710
+ declare function updateIssueCore({ token, owner, repo, issueNumber, title, body, state, stateReason, labels, milestone, assignees }: {
711
+ token: string;
712
+ owner: string;
713
+ repo: string;
714
+ issueNumber: number;
715
+ title?: string;
716
+ body?: string;
717
+ state?: 'open' | 'closed';
718
+ stateReason?: 'completed' | 'not_planned' | 'reopened';
719
+ labels?: string[];
720
+ milestone?: number | null;
721
+ assignees?: string[];
722
+ }): Promise<{
723
+ number: number;
724
+ title: string;
725
+ state: string;
726
+ url: string;
727
+ labels: (string | undefined)[];
728
+ assignees: string[] | undefined;
729
+ milestone: number | null;
730
+ closedAt: string | null;
731
+ updatedAt: string;
732
+ }>;
733
+ /** Not idempotent — each call applies a new revision. */
734
+ declare function updateIssueCommentCore({ token, owner, repo, commentId, body }: {
735
+ token: string;
736
+ owner: string;
737
+ repo: string;
738
+ commentId: number;
739
+ body: string;
740
+ }): Promise<{
741
+ id: number;
742
+ url: string;
743
+ body: string | undefined;
744
+ updatedAt: string;
745
+ }>;
746
+ /** Not idempotent — deleting an already-deleted comment returns 404 from GitHub. */
747
+ declare function deleteIssueCommentCore({ token, owner, repo, commentId }: {
748
+ token: string;
749
+ owner: string;
750
+ repo: string;
751
+ commentId: number;
752
+ }): Promise<{
753
+ deleted: boolean;
754
+ commentId: number;
755
+ }>;
756
+ declare function listLabelsCore({ token, owner, repo, perPage, page }: {
757
+ token: string;
758
+ owner: string;
759
+ repo: string;
760
+ perPage: number;
761
+ page: number;
762
+ }): Promise<PagedList<{
763
+ name: string;
764
+ color: string;
765
+ description: string | null;
766
+ }>>;
767
+ /** Not idempotent — re-adding labels is a no-op on GitHub but still mutates. */
768
+ declare function addLabelsCore({ token, owner, repo, issueNumber, labels }: {
769
+ token: string;
770
+ owner: string;
771
+ repo: string;
772
+ issueNumber: number;
773
+ labels: string[];
774
+ }): Promise<{
775
+ name: string;
776
+ color: string;
777
+ description: string | null;
778
+ }[]>;
779
+ /** Not idempotent — removing a missing label returns 404 from GitHub. */
780
+ declare function removeLabelCore({ token, owner, repo, issueNumber, label }: {
781
+ token: string;
782
+ owner: string;
783
+ repo: string;
784
+ issueNumber: number;
785
+ label: string;
786
+ }): Promise<{
787
+ removed: boolean;
788
+ label: string;
789
+ issueNumber: number;
790
+ }>;
791
+ /** Not idempotent — creating a label that already exists returns 422 from GitHub. */
792
+ declare function createLabelCore({ token, owner, repo, name, color, description }: {
793
+ token: string;
794
+ owner: string;
795
+ repo: string;
796
+ name: string;
797
+ color: string;
798
+ description?: string;
799
+ }): Promise<{
800
+ name: string;
801
+ color: string;
802
+ description: string | null;
803
+ }>;
804
+ /** Not idempotent — each call applies a new revision. */
805
+ declare function updateLabelCore({ token, owner, repo, name, newName, color, description }: {
806
+ token: string;
807
+ owner: string;
808
+ repo: string;
809
+ name: string;
810
+ newName?: string;
811
+ color?: string;
812
+ description?: string | null;
813
+ }): Promise<{
814
+ name: string;
815
+ color: string;
816
+ description: string | null;
817
+ }>;
818
+ /** Not idempotent — deleting a missing label returns 404 from GitHub. */
819
+ declare function deleteLabelCore({ token, owner, repo, name }: {
820
+ token: string;
821
+ owner: string;
822
+ repo: string;
823
+ name: string;
824
+ }): Promise<{
825
+ deleted: boolean;
826
+ name: string;
827
+ }>;
828
+ /** Not idempotent — re-adding an existing assignee is a no-op on GitHub but still mutates. */
829
+ declare function addAssigneesCore({ token, owner, repo, issueNumber, assignees }: {
830
+ token: string;
831
+ owner: string;
832
+ repo: string;
833
+ issueNumber: number;
834
+ assignees: string[];
835
+ }): Promise<{
836
+ number: number;
837
+ assignees: string[] | undefined;
838
+ }>;
839
+ /** Idempotent — removing an assignee that is not assigned is a no-op on GitHub. */
840
+ declare function removeAssigneesCore({ token, owner, repo, issueNumber, assignees }: {
841
+ token: string;
842
+ owner: string;
843
+ repo: string;
844
+ issueNumber: number;
845
+ assignees: string[];
846
+ }): Promise<{
847
+ number: number;
848
+ assignees: string[] | undefined;
849
+ }>;
850
+ //#endregion
851
+ //#region src/core/notifications.d.ts
852
+ declare function listNotificationsCore({ token, all, participating, perPage, page }: {
853
+ token: string;
854
+ all: boolean;
855
+ participating: boolean;
856
+ perPage: number;
857
+ page: number;
858
+ }): Promise<PagedList<{
859
+ threadId: string;
860
+ repository: string;
861
+ subject: {
862
+ title: string;
863
+ type: string;
864
+ url: string;
865
+ };
866
+ reason: string;
867
+ unread: boolean;
868
+ updatedAt: string;
869
+ }>>;
870
+ /** Idempotent — marking an already-read thread is a no-op on GitHub. */
871
+ declare function markNotificationReadCore({ token, threadId }: {
872
+ token: string;
873
+ threadId: string;
874
+ }): Promise<{
875
+ marked: boolean;
876
+ threadId: string;
877
+ }>;
878
+ //#endregion
879
+ //#region src/types.d.ts
880
+ type GithubTool = Tool<any, any>;
881
+ type ToolOptions = {
882
+ needsApproval?: boolean;
883
+ };
884
+ /**
885
+ * Identity for a commit author or committer on GitHub.
886
+ *
887
+ * - **Author** — the person who originally wrote the code patch.
888
+ * - **Committer** — the person who applied the commit to the repository.
889
+ */
890
+ type CommitIdentity = {
891
+ name: string;
892
+ email: string;
893
+ };
894
+ /**
895
+ * Options for commit-creating tools (`createOrUpdateFile`, `mergePullRequest`).
896
+ */
897
+ type CommitToolOptions = ToolOptions & {
898
+ /**
899
+ * The author of the commit — the person who wrote the code patch.
900
+ * Falls back to the authenticated user when omitted.
901
+ */
902
+ author?: CommitIdentity;
903
+ /**
904
+ * The committer of the commit — the person who applied the commit.
905
+ * Falls back to the authenticated user when omitted.
906
+ */
907
+ committer?: CommitIdentity;
908
+ /**
909
+ * Co-authors to attribute on commits.
910
+ * Added as "Co-authored-by" trailers to commit messages.
911
+ */
912
+ coAuthors?: CommitIdentity[];
913
+ };
914
+ /**
915
+ * Per-tool overrides for customizing tool behavior without changing the underlying implementation.
916
+ *
917
+ * Overridable properties: `description`, `title`, `needsApproval`, `strict`, `providerOptions`,
918
+ * `toModelOutput`, and input lifecycle callbacks (`onInputStart`, `onInputDelta`, `onInputAvailable`).
919
+ *
920
+ * `execute`, `inputSchema`, and `outputSchema` cannot be overridden.
921
+ *
922
+ * @example
923
+ * ```ts
924
+ * createGithubTools({
925
+ * overrides: {
926
+ * mergePullRequest: { needsApproval: true, title: 'Merge PR' },
927
+ * listIssues: { description: 'List open bugs' },
928
+ * },
929
+ * })
930
+ * ```
931
+ */
932
+ type ToolOverrides = Partial<Pick<Tool, 'description' | 'needsApproval' | 'onInputAvailable' | 'onInputDelta' | 'onInputStart' | 'providerOptions' | 'strict' | 'title' | 'toModelOutput'>>;
933
+ //#endregion
934
+ //#region src/core/pull-requests.d.ts
935
+ declare function listPullRequestsCore({ token, owner, repo, state, perPage, page, maxPages }: {
936
+ token: string;
937
+ owner: string;
938
+ repo: string;
939
+ state: 'open' | 'closed' | 'all';
940
+ perPage: number;
941
+ page?: number;
942
+ maxPages?: number;
943
+ }): Promise<PagedList<{
944
+ number: number;
945
+ title: string;
946
+ state: string;
947
+ url: string;
948
+ author: string | undefined;
949
+ branch: string;
950
+ base: string;
951
+ draft: boolean | undefined;
952
+ createdAt: string;
953
+ updatedAt: string;
954
+ }>>;
955
+ declare function getPullRequestCore({ token, owner, repo, pullNumber, detail }: {
956
+ token: string;
957
+ owner: string;
958
+ repo: string;
959
+ pullNumber: number;
960
+ detail?: DetailLevel;
961
+ }): Promise<{
962
+ number: number;
963
+ title: string;
964
+ body: string | null | undefined;
965
+ state: "open" | "closed";
966
+ url: string;
967
+ author: string;
968
+ branch: string;
969
+ headSha: string;
970
+ base: string;
971
+ draft: boolean | undefined;
972
+ merged: boolean;
973
+ mergeable: boolean | null;
974
+ additions: number;
975
+ deletions: number;
976
+ changedFiles: number;
977
+ createdAt: string;
978
+ updatedAt: string;
979
+ mergedAt: string | null;
980
+ }>;
981
+ /** Not idempotent — each call creates a new pull request. */
982
+ declare function createPullRequestCore({ token, owner, repo, title, body, head, base, draft }: {
983
+ token: string;
984
+ owner: string;
985
+ repo: string;
986
+ title: string;
987
+ body?: string;
988
+ head: string;
989
+ base: string;
990
+ draft: boolean;
991
+ }): Promise<{
992
+ number: number;
993
+ title: string;
994
+ url: string;
995
+ state: "open" | "closed";
996
+ draft: boolean | undefined;
997
+ branch: string;
998
+ base: string;
999
+ }>;
1000
+ /** Not idempotent — each call applies a new revision. */
1001
+ declare function updatePullRequestCore({ token, owner, repo, pullNumber, title, body, state, base, draft }: {
1002
+ token: string;
1003
+ owner: string;
1004
+ repo: string;
1005
+ pullNumber: number;
1006
+ title?: string;
1007
+ body?: string;
1008
+ state?: 'open' | 'closed';
1009
+ base?: string;
1010
+ draft?: boolean;
1011
+ }): Promise<{
1012
+ number: number;
1013
+ title: string;
1014
+ state: "open" | "closed";
1015
+ draft: boolean | undefined;
1016
+ url: string;
1017
+ base: string;
1018
+ updatedAt: string;
1019
+ }>;
1020
+ /** Not idempotent — merging an already-merged PR returns an error from GitHub. */
1021
+ declare function mergePullRequestCore({ token, owner, repo, pullNumber, commitTitle, commitMessage, mergeMethod, coAuthors }: {
1022
+ token: string;
1023
+ owner: string;
1024
+ repo: string;
1025
+ pullNumber: number;
1026
+ commitTitle?: string;
1027
+ commitMessage?: string;
1028
+ mergeMethod: 'merge' | 'squash' | 'rebase';
1029
+ coAuthors?: CommitIdentity[];
1030
+ }): Promise<{
1031
+ merged: boolean;
1032
+ message: string;
1033
+ sha: string;
1034
+ }>;
1035
+ /** Not idempotent — each call adds another comment. */
1036
+ declare function addPullRequestCommentCore({ token, owner, repo, pullNumber, body }: {
1037
+ token: string;
1038
+ owner: string;
1039
+ repo: string;
1040
+ pullNumber: number;
1041
+ body: string;
1042
+ }): Promise<{
1043
+ id: number;
1044
+ url: string;
1045
+ body: string | undefined;
1046
+ author: string | undefined;
1047
+ createdAt: string;
1048
+ }>;
1049
+ /** Not idempotent — each call applies a new revision. */
1050
+ declare function updatePullRequestCommentCore({ token, owner, repo, commentId, body }: {
1051
+ token: string;
1052
+ owner: string;
1053
+ repo: string;
1054
+ commentId: number;
1055
+ body: string;
1056
+ }): Promise<{
1057
+ id: number;
1058
+ url: string;
1059
+ body: string | undefined;
1060
+ updatedAt: string;
1061
+ }>;
1062
+ /** Not idempotent — deleting an already-deleted comment returns 404 from GitHub. */
1063
+ declare function deletePullRequestCommentCore({ token, owner, repo, commentId }: {
1064
+ token: string;
1065
+ owner: string;
1066
+ repo: string;
1067
+ commentId: number;
1068
+ }): Promise<{
1069
+ deleted: boolean;
1070
+ commentId: number;
1071
+ }>;
1072
+ declare function listPullRequestFilesCore({ token, owner, repo, pullNumber, includePatch, filenames, perPage, page }: {
1073
+ token: string;
1074
+ owner: string;
1075
+ repo: string;
1076
+ pullNumber: number;
1077
+ includePatch: boolean;
1078
+ filenames?: string[];
1079
+ perPage: number;
1080
+ page: number;
1081
+ }): Promise<PagedList<{
1082
+ patch?: string | undefined;
1083
+ filename: string;
1084
+ status: "added" | "removed" | "modified" | "renamed" | "copied" | "changed" | "unchanged";
1085
+ additions: number;
1086
+ deletions: number;
1087
+ changes: number;
1088
+ }>>;
1089
+ declare function listPullRequestReviewsCore({ token, owner, repo, pullNumber, perPage, page }: {
1090
+ token: string;
1091
+ owner: string;
1092
+ repo: string;
1093
+ pullNumber: number;
1094
+ perPage: number;
1095
+ page: number;
1096
+ }): Promise<PagedList<{
1097
+ id: number;
1098
+ state: string;
1099
+ body: string;
1100
+ author: string | undefined;
1101
+ url: string;
1102
+ submittedAt: string | undefined;
1103
+ }>>;
1104
+ /** Not idempotent — each call submits a new review. */
1105
+ declare function createPullRequestReviewCore({ token, owner, repo, pullNumber, body, event, comments }: {
1106
+ token: string;
1107
+ owner: string;
1108
+ repo: string;
1109
+ pullNumber: number;
1110
+ body?: string;
1111
+ event: 'APPROVE' | 'REQUEST_CHANGES' | 'COMMENT';
1112
+ comments?: Array<{
1113
+ path: string;
1114
+ body: string;
1115
+ line?: number;
1116
+ side?: 'LEFT' | 'RIGHT';
1117
+ }>;
1118
+ }): Promise<{
1119
+ id: number;
1120
+ state: string;
1121
+ body: string;
1122
+ url: string;
1123
+ author: string | undefined;
1124
+ submittedAt: string | undefined;
1125
+ }>;
1126
+ declare function listPullRequestReviewThreadsCore({ token, owner, repo, pullNumber, status, detail, perPage, after }: {
1127
+ token: string;
1128
+ owner: string;
1129
+ repo: string;
1130
+ pullNumber: number;
1131
+ status: 'unresolved' | 'all';
1132
+ detail: DetailLevel;
1133
+ perPage: number;
1134
+ after?: string;
1135
+ }): Promise<{
1136
+ error: string;
1137
+ totalCount?: undefined;
1138
+ returnedCount?: undefined;
1139
+ hasNextPage?: undefined;
1140
+ endCursor?: undefined;
1141
+ threads?: undefined;
1142
+ } | {
1143
+ totalCount: number;
1144
+ returnedCount: number;
1145
+ hasNextPage: boolean;
1146
+ endCursor: string | null;
1147
+ threads: {
1148
+ threadId: string;
1149
+ isResolved: boolean;
1150
+ isOutdated: boolean;
1151
+ path: string | null;
1152
+ line: number | null;
1153
+ startLine: number | null;
1154
+ resolvedBy: string | null;
1155
+ commentCount: number;
1156
+ comments: {
1157
+ commentId: number | null;
1158
+ author: string | null;
1159
+ body: string | null | undefined;
1160
+ createdAt: string;
1161
+ }[];
1162
+ }[];
1163
+ error?: undefined;
1164
+ }>;
1165
+ /** Not idempotent — each call posts a new reply. */
1166
+ declare function replyToReviewCommentCore({ token, owner, repo, pullNumber, commentId, body }: {
1167
+ token: string;
1168
+ owner: string;
1169
+ repo: string;
1170
+ pullNumber: number;
1171
+ commentId: number;
1172
+ body: string;
1173
+ }): Promise<{
1174
+ id: number;
1175
+ url: string;
1176
+ author: string;
1177
+ createdAt: string;
1178
+ }>;
1179
+ /** Idempotent — resolving an already-resolved thread is a no-op on GitHub. */
1180
+ declare function resolveReviewThreadCore({ token, threadId }: {
1181
+ token: string;
1182
+ threadId: string;
1183
+ }): Promise<{
1184
+ error: string;
1185
+ threadId?: undefined;
1186
+ isResolved?: undefined;
1187
+ } | {
1188
+ threadId: string;
1189
+ isResolved: boolean;
1190
+ error?: undefined;
1191
+ }>;
1192
+ /** Not idempotent — re-requesting an existing reviewer is a no-op on GitHub but still mutates. */
1193
+ declare function requestReviewersCore({ token, owner, repo, pullNumber, reviewers, teamReviewers }: {
1194
+ token: string;
1195
+ owner: string;
1196
+ repo: string;
1197
+ pullNumber: number;
1198
+ reviewers?: string[];
1199
+ teamReviewers?: string[];
1200
+ }): Promise<{
1201
+ number: number;
1202
+ url: string;
1203
+ requestedReviewers: string[] | undefined;
1204
+ requestedTeams: string[] | undefined;
1205
+ }>;
1206
+ //#endregion
1207
+ //#region src/core/reactions.d.ts
1208
+ declare const REACTION_CONTENTS: readonly ["+1", "-1", "laugh", "confused", "heart", "hooray", "rocket", "eyes"];
1209
+ type ReactionContent = typeof REACTION_CONTENTS[number];
1210
+ declare function listIssueReactionsCore({ token, owner, repo, issueNumber, content, perPage, page }: {
1211
+ token: string;
1212
+ owner: string;
1213
+ repo: string;
1214
+ issueNumber: number;
1215
+ content?: ReactionContent;
1216
+ perPage: number;
1217
+ page: number;
1218
+ }): Promise<{
1219
+ hasMore: boolean;
1220
+ page: number;
1221
+ perPage: number;
1222
+ nextPage?: number;
1223
+ total: number;
1224
+ counts: Record<string, number>;
1225
+ reactions: {
1226
+ content: string;
1227
+ user: string | undefined;
1228
+ }[];
1229
+ }>;
1230
+ /** Idempotent — GitHub returns the existing reaction when the user already reacted with the same content. */
1231
+ declare function addIssueReactionCore({ token, owner, repo, issueNumber, content }: {
1232
+ token: string;
1233
+ owner: string;
1234
+ repo: string;
1235
+ issueNumber: number;
1236
+ content: ReactionContent;
1237
+ }): Promise<{
1238
+ id: number;
1239
+ content: "+1" | "-1" | "laugh" | "confused" | "heart" | "hooray" | "rocket" | "eyes";
1240
+ user: string | undefined;
1241
+ issueNumber: number;
1242
+ }>;
1243
+ declare function listCommentReactionsCore({ token, owner, repo, commentId, content, perPage, page }: {
1244
+ token: string;
1245
+ owner: string;
1246
+ repo: string;
1247
+ commentId: number;
1248
+ content?: ReactionContent;
1249
+ perPage: number;
1250
+ page: number;
1251
+ }): Promise<{
1252
+ hasMore: boolean;
1253
+ page: number;
1254
+ perPage: number;
1255
+ nextPage?: number;
1256
+ total: number;
1257
+ counts: Record<string, number>;
1258
+ reactions: {
1259
+ content: string;
1260
+ user: string | undefined;
1261
+ }[];
1262
+ }>;
1263
+ /** Idempotent — GitHub returns the existing reaction when the user already reacted with the same content. */
1264
+ declare function addCommentReactionCore({ token, owner, repo, commentId, content }: {
1265
+ token: string;
1266
+ owner: string;
1267
+ repo: string;
1268
+ commentId: number;
1269
+ content: ReactionContent;
1270
+ }): Promise<{
1271
+ id: number;
1272
+ content: "+1" | "-1" | "laugh" | "confused" | "heart" | "hooray" | "rocket" | "eyes";
1273
+ user: string | undefined;
1274
+ commentId: number;
1275
+ }>;
1276
+ //#endregion
1277
+ //#region src/core/releases.d.ts
1278
+ declare function listReleasesCore({ token, owner, repo, perPage, page, maxPages, detail }: {
1279
+ token: string;
1280
+ owner: string;
1281
+ repo: string;
1282
+ perPage: number;
1283
+ page?: number;
1284
+ maxPages?: number;
1285
+ detail?: DetailLevel;
1286
+ }): Promise<PagedList<{
1287
+ id: number;
1288
+ tagName: string;
1289
+ name: string | null;
1290
+ body: string | null | undefined;
1291
+ draft: boolean;
1292
+ prerelease: boolean;
1293
+ url: string;
1294
+ author: string;
1295
+ createdAt: string;
1296
+ publishedAt: string | null;
1297
+ }>>;
1298
+ declare function getLatestReleaseCore({ token, owner, repo, detail }: {
1299
+ token: string;
1300
+ owner: string;
1301
+ repo: string;
1302
+ detail?: DetailLevel;
1303
+ }): Promise<{
1304
+ id: number;
1305
+ tagName: string;
1306
+ name: string | null;
1307
+ body: string | null | undefined;
1308
+ url: string;
1309
+ author: string;
1310
+ createdAt: string;
1311
+ publishedAt: string | null;
1312
+ assets: {
1313
+ name: string;
1314
+ downloadUrl: string;
1315
+ size: number;
1316
+ downloadCount: number;
1317
+ }[];
1318
+ }>;
1319
+ declare function getReleaseCore({ token, owner, repo, releaseId, detail }: {
1320
+ token: string;
1321
+ owner: string;
1322
+ repo: string;
1323
+ releaseId: number;
1324
+ detail?: DetailLevel;
1325
+ }): Promise<{
1326
+ id: number;
1327
+ tagName: string;
1328
+ name: string | null;
1329
+ body: string | null | undefined;
1330
+ draft: boolean;
1331
+ prerelease: boolean;
1332
+ url: string;
1333
+ author: string;
1334
+ createdAt: string;
1335
+ publishedAt: string | null;
1336
+ assets: {
1337
+ name: string;
1338
+ downloadUrl: string;
1339
+ size: number;
1340
+ downloadCount: number;
1341
+ }[];
1342
+ }>;
1343
+ /** Not idempotent — creating a release with an existing tag name returns an error from GitHub. */
1344
+ declare function createReleaseCore({ token, owner, repo, tagName, target, name, body, draft, prerelease, generateReleaseNotes }: {
1345
+ token: string;
1346
+ owner: string;
1347
+ repo: string;
1348
+ tagName: string;
1349
+ target?: string;
1350
+ name?: string;
1351
+ body?: string;
1352
+ draft: boolean;
1353
+ prerelease: boolean;
1354
+ generateReleaseNotes: boolean;
1355
+ }): Promise<{
1356
+ id: number;
1357
+ tagName: string;
1358
+ name: string | null;
1359
+ body: string | null | undefined;
1360
+ url: string;
1361
+ draft: boolean;
1362
+ prerelease: boolean;
1363
+ createdAt: string;
1364
+ }>;
1365
+ /** Not idempotent — each call applies a new revision. */
1366
+ declare function updateReleaseCore({ token, owner, repo, releaseId, tagName, target, name, body, draft, prerelease }: {
1367
+ token: string;
1368
+ owner: string;
1369
+ repo: string;
1370
+ releaseId: number;
1371
+ tagName?: string;
1372
+ target?: string;
1373
+ name?: string;
1374
+ body?: string;
1375
+ draft?: boolean;
1376
+ prerelease?: boolean;
1377
+ }): Promise<{
1378
+ id: number;
1379
+ tagName: string;
1380
+ name: string | null;
1381
+ body: string | null | undefined;
1382
+ url: string;
1383
+ draft: boolean;
1384
+ prerelease: boolean;
1385
+ publishedAt: string | null;
1386
+ }>;
1387
+ /** Not idempotent — deleting an already-deleted release returns 404 from GitHub. */
1388
+ declare function deleteReleaseCore({ token, owner, repo, releaseId }: {
1389
+ token: string;
1390
+ owner: string;
1391
+ repo: string;
1392
+ releaseId: number;
1393
+ }): Promise<{
1394
+ deleted: boolean;
1395
+ releaseId: number;
1396
+ }>;
1397
+ //#endregion
1398
+ //#region src/core/repository.d.ts
1399
+ declare function getRepositoryCore({ token, owner, repo }: {
1400
+ token: string;
1401
+ owner: string;
1402
+ repo: string;
1403
+ }): Promise<{
1404
+ name: string;
1405
+ fullName: string;
1406
+ description: string | null;
1407
+ url: string;
1408
+ defaultBranch: string;
1409
+ stars: number;
1410
+ forks: number;
1411
+ openIssues: number;
1412
+ language: string | null;
1413
+ private: boolean;
1414
+ createdAt: string;
1415
+ updatedAt: string;
1416
+ }>;
1417
+ declare function listBranchesCore({ token, owner, repo, perPage, page }: {
1418
+ token: string;
1419
+ owner: string;
1420
+ repo: string;
1421
+ perPage: number;
1422
+ page?: number;
1423
+ }): Promise<PagedList<{
1424
+ name: string;
1425
+ sha: string;
1426
+ protected: boolean;
1427
+ }>>;
1428
+ declare function getFileContentCore({ token, owner, repo, path, ref, startLine, endLine, maxLines }: {
1429
+ token: string;
1430
+ owner: string;
1431
+ repo: string;
1432
+ path: string;
1433
+ ref?: string;
1434
+ startLine?: number;
1435
+ endLine?: number;
1436
+ maxLines?: number;
1437
+ }): Promise<{
1438
+ type: "directory";
1439
+ entries: {
1440
+ name: string;
1441
+ type: "file" | "dir" | "submodule" | "symlink";
1442
+ path: string;
1443
+ }[];
1444
+ path?: undefined;
1445
+ sha?: undefined;
1446
+ size?: undefined;
1447
+ totalLines?: undefined;
1448
+ content?: undefined;
1449
+ startLine?: undefined;
1450
+ endLine?: undefined;
1451
+ truncated?: undefined;
1452
+ } | {
1453
+ type: "submodule" | "symlink";
1454
+ path: string;
1455
+ entries?: undefined;
1456
+ sha?: undefined;
1457
+ size?: undefined;
1458
+ totalLines?: undefined;
1459
+ content?: undefined;
1460
+ startLine?: undefined;
1461
+ endLine?: undefined;
1462
+ truncated?: undefined;
1463
+ } | {
1464
+ type: "file";
1465
+ path: string;
1466
+ sha: string;
1467
+ size: number;
1468
+ totalLines: number;
1469
+ content: string;
1470
+ entries?: undefined;
1471
+ startLine?: undefined;
1472
+ endLine?: undefined;
1473
+ truncated?: undefined;
1474
+ } | {
1475
+ type: "file";
1476
+ path: string;
1477
+ sha: string;
1478
+ size: number;
1479
+ totalLines: number;
1480
+ startLine: number;
1481
+ endLine: number;
1482
+ truncated: boolean;
1483
+ content: string;
1484
+ entries?: undefined;
1485
+ }>;
1486
+ declare function getRepositoryTreeCore({ token, owner, repo, ref, path, recursive }: {
1487
+ token: string;
1488
+ owner: string;
1489
+ repo: string;
1490
+ ref?: string;
1491
+ path?: string;
1492
+ recursive: boolean;
1493
+ }): Promise<{
1494
+ sha: string;
1495
+ truncated: boolean;
1496
+ path: string | undefined;
1497
+ entries: {
1498
+ path: string;
1499
+ type: string;
1500
+ size: number | undefined;
1501
+ sha: string;
1502
+ }[];
1503
+ }>;
1504
+ /** Idempotent when the branch already exists at the target SHA. Not idempotent otherwise. */
1505
+ declare function createBranchCore({ token, owner, repo, branch, from }: {
1506
+ token: string;
1507
+ owner: string;
1508
+ repo: string;
1509
+ branch: string;
1510
+ from?: string;
1511
+ }): Promise<{
1512
+ ref: string;
1513
+ sha: string;
1514
+ url: string;
1515
+ }>;
1516
+ /** Not idempotent — deleting a branch that no longer exists fails with a 422. */
1517
+ declare function deleteBranchCore({ token, owner, repo, branch }: {
1518
+ token: string;
1519
+ owner: string;
1520
+ repo: string;
1521
+ branch: string;
1522
+ }): Promise<{
1523
+ deleted: boolean;
1524
+ branch: string;
1525
+ }>;
1526
+ /** Not idempotent — each call may create another fork attempt. */
1527
+ declare function forkRepositoryCore({ token, owner, repo, organization, name }: {
1528
+ token: string;
1529
+ owner: string;
1530
+ repo: string;
1531
+ organization?: string;
1532
+ name?: string;
1533
+ }): Promise<{
1534
+ name: string;
1535
+ fullName: string;
1536
+ url: string;
1537
+ cloneUrl: string;
1538
+ sshUrl: string;
1539
+ defaultBranch: string;
1540
+ private: boolean;
1541
+ parent: {
1542
+ fullName: string;
1543
+ url: string;
1544
+ } | null;
1545
+ }>;
1546
+ /** Not idempotent — each call creates a new repository. */
1547
+ declare function createRepositoryCore({ token, name, description, isPrivate, autoInit, gitignoreTemplate, licenseTemplate, org }: {
1548
+ token: string;
1549
+ name: string;
1550
+ description?: string;
1551
+ isPrivate: boolean;
1552
+ autoInit: boolean;
1553
+ gitignoreTemplate?: string;
1554
+ licenseTemplate?: string;
1555
+ org?: string;
1556
+ }): Promise<{
1557
+ name: string;
1558
+ fullName: string;
1559
+ description: string | null;
1560
+ url: string;
1561
+ cloneUrl: string;
1562
+ sshUrl: string;
1563
+ defaultBranch: string;
1564
+ private: boolean;
1565
+ createdAt: string;
1566
+ }>;
1567
+ /** Idempotent when updating with sha and content is unchanged. Not idempotent for new commits. */
1568
+ declare function createOrUpdateFileCore({ token, owner, repo, path, message, content, branch, sha, author, committer, coAuthors }: {
1569
+ token: string;
1570
+ owner: string;
1571
+ repo: string;
1572
+ path: string;
1573
+ message: string;
1574
+ content: string;
1575
+ branch?: string;
1576
+ sha?: string;
1577
+ author?: CommitIdentity;
1578
+ committer?: CommitIdentity;
1579
+ coAuthors?: CommitIdentity[];
1580
+ }): Promise<{
1581
+ path: string;
1582
+ sha: string;
1583
+ skipped: true;
1584
+ message: string;
1585
+ commitSha?: undefined;
1586
+ commitUrl?: undefined;
1587
+ } | {
1588
+ path: string | undefined;
1589
+ sha: string | undefined;
1590
+ commitSha: string | undefined;
1591
+ commitUrl: string | undefined;
1592
+ skipped?: undefined;
1593
+ message?: undefined;
1594
+ }>;
1595
+ //#endregion
1596
+ //#region src/core/search.d.ts
1597
+ declare function searchCodeCore({ token, query, perPage }: {
1598
+ token: string;
1599
+ query: string;
1600
+ perPage: number;
1601
+ }): Promise<{
1602
+ totalCount: number;
1603
+ items: {
1604
+ name: string;
1605
+ path: string;
1606
+ url: string;
1607
+ repository: string;
1608
+ sha: string;
1609
+ textMatches: {
1610
+ fragment: string;
1611
+ }[] | undefined;
1612
+ }[];
1613
+ }>;
1614
+ declare function searchRepositoriesCore({ token, query, perPage, sort, order }: {
1615
+ token: string;
1616
+ query: string;
1617
+ perPage: number;
1618
+ sort?: 'stars' | 'forks' | 'help-wanted-issues' | 'updated';
1619
+ order: 'asc' | 'desc';
1620
+ }): Promise<{
1621
+ totalCount: number;
1622
+ items: {
1623
+ name: string;
1624
+ fullName: string;
1625
+ description: string | null;
1626
+ url: string;
1627
+ stars: number;
1628
+ forks: number;
1629
+ language: string | null;
1630
+ topics: string[] | undefined;
1631
+ }[];
1632
+ }>;
1633
+ declare function searchIssuesCore({ token, query, perPage, sort, order }: {
1634
+ token: string;
1635
+ query: string;
1636
+ perPage: number;
1637
+ sort?: 'comments' | 'reactions' | 'created' | 'updated' | 'interactions';
1638
+ order: 'asc' | 'desc';
1639
+ }): Promise<{
1640
+ totalCount: number;
1641
+ items: {
1642
+ number: number;
1643
+ title: string;
1644
+ state: string;
1645
+ url: string;
1646
+ repository: string | undefined;
1647
+ author: string | undefined;
1648
+ labels: (string | undefined)[];
1649
+ comments: number;
1650
+ createdAt: string;
1651
+ updatedAt: string;
1652
+ isPullRequest: boolean;
1653
+ }[];
1654
+ }>;
1655
+ //#endregion
1656
+ //#region src/core/workflows.d.ts
1657
+ declare function listWorkflowsCore({ token, owner, repo, perPage, page }: {
1658
+ token: string;
1659
+ owner: string;
1660
+ repo: string;
1661
+ perPage: number;
1662
+ page: number;
1663
+ }): Promise<{
1664
+ hasMore: boolean;
1665
+ page: number;
1666
+ perPage: number;
1667
+ nextPage?: number;
1668
+ totalCount: number;
1669
+ workflows: {
1670
+ id: number;
1671
+ name: string;
1672
+ path: string;
1673
+ state: "deleted" | "active" | "disabled_fork" | "disabled_inactivity" | "disabled_manually";
1674
+ url: string;
1675
+ createdAt: string;
1676
+ updatedAt: string;
1677
+ }[];
1678
+ }>;
1679
+ type WorkflowRunStatus = 'completed' | 'action_required' | 'cancelled' | 'failure' | 'neutral' | 'skipped' | 'stale' | 'success' | 'timed_out' | 'in_progress' | 'queued' | 'requested' | 'waiting' | 'pending';
1680
+ declare function listWorkflowRunsCore({ token, owner, repo, workflowId, branch, event, status, perPage, page, maxPages }: {
1681
+ token: string;
1682
+ owner: string;
1683
+ repo: string;
1684
+ workflowId?: string | number;
1685
+ branch?: string;
1686
+ event?: string;
1687
+ status?: WorkflowRunStatus;
1688
+ perPage: number;
1689
+ page: number;
1690
+ maxPages?: number;
1691
+ }): Promise<{
1692
+ hasMore: boolean;
1693
+ page: number;
1694
+ perPage: number;
1695
+ nextPage?: number;
1696
+ totalCount: number;
1697
+ runs: {
1698
+ id: number;
1699
+ name: string | null | undefined;
1700
+ status: string | null;
1701
+ conclusion: string | null;
1702
+ branch: string | null;
1703
+ event: string;
1704
+ url: string;
1705
+ actor: string | undefined;
1706
+ createdAt: string;
1707
+ updatedAt: string;
1708
+ runNumber: number;
1709
+ runAttempt: number | undefined;
1710
+ }[];
1711
+ }>;
1712
+ declare function getWorkflowRunCore({ token, owner, repo, runId }: {
1713
+ token: string;
1714
+ owner: string;
1715
+ repo: string;
1716
+ runId: number;
1717
+ }): Promise<{
1718
+ id: number;
1719
+ name: string | null | undefined;
1720
+ status: string | null;
1721
+ conclusion: string | null;
1722
+ branch: string | null;
1723
+ sha: string;
1724
+ event: string;
1725
+ url: string;
1726
+ actor: string | undefined;
1727
+ runNumber: number;
1728
+ runAttempt: number | undefined;
1729
+ createdAt: string;
1730
+ updatedAt: string;
1731
+ runStartedAt: string | undefined;
1732
+ }>;
1733
+ declare function listWorkflowJobsCore({ token, owner, repo, runId, filter, perPage, page }: {
1734
+ token: string;
1735
+ owner: string;
1736
+ repo: string;
1737
+ runId: number;
1738
+ filter: 'latest' | 'all';
1739
+ perPage: number;
1740
+ page: number;
1741
+ }): Promise<{
1742
+ hasMore: boolean;
1743
+ page: number;
1744
+ perPage: number;
1745
+ nextPage?: number;
1746
+ totalCount: number;
1747
+ jobs: {
1748
+ id: number;
1749
+ name: string;
1750
+ status: "completed" | "in_progress" | "queued" | "requested" | "waiting" | "pending";
1751
+ conclusion: "success" | "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "timed_out" | null;
1752
+ url: string | null;
1753
+ startedAt: string;
1754
+ completedAt: string | null;
1755
+ runnerName: string | null;
1756
+ steps: {
1757
+ name: string;
1758
+ status: "completed" | "in_progress" | "queued";
1759
+ conclusion: string | null;
1760
+ number: number;
1761
+ startedAt: string | null | undefined;
1762
+ completedAt: string | null | undefined;
1763
+ }[] | undefined;
1764
+ }[];
1765
+ }>;
1766
+ declare function getWorkflowJobLogsCore({ token, owner, repo, jobId, maxLines }: {
1767
+ token: string;
1768
+ owner: string;
1769
+ repo: string;
1770
+ jobId: number;
1771
+ maxLines: number;
1772
+ }): Promise<{
1773
+ totalLines: number;
1774
+ returnedLines: number;
1775
+ omittedLines: number;
1776
+ log: string;
1777
+ jobId: number;
1778
+ }>;
1779
+ /** Not idempotent — each call starts a new workflow run. */
1780
+ declare function triggerWorkflowCore({ token, owner, repo, workflowId, ref, inputs }: {
1781
+ token: string;
1782
+ owner: string;
1783
+ repo: string;
1784
+ workflowId: string | number;
1785
+ ref: string;
1786
+ inputs?: Record<string, string>;
1787
+ }): Promise<{
1788
+ triggered: boolean;
1789
+ workflowId: string | number;
1790
+ ref: string;
1791
+ }>;
1792
+ /** Not idempotent — cancelling an already-finished run is a no-op on GitHub but still mutates. */
1793
+ declare function cancelWorkflowRunCore({ token, owner, repo, runId }: {
1794
+ token: string;
1795
+ owner: string;
1796
+ repo: string;
1797
+ runId: number;
1798
+ }): Promise<{
1799
+ cancelled: boolean;
1800
+ runId: number;
1801
+ }>;
1802
+ /** Not idempotent — each call starts another run attempt. */
1803
+ declare function rerunWorkflowRunCore({ token, owner, repo, runId, onlyFailedJobs }: {
1804
+ token: string;
1805
+ owner: string;
1806
+ repo: string;
1807
+ runId: number;
1808
+ onlyFailedJobs: boolean;
1809
+ }): Promise<{
1810
+ rerun: boolean;
1811
+ runId: number;
1812
+ onlyFailedJobs: boolean;
1813
+ }>;
1814
+ //#endregion
1815
+ //#region src/core/catalog.d.ts
1816
+ /**
1817
+ * Single source of truth for every GitHub tool.
1818
+ *
1819
+ * `GITHUB_TOOL_NAMES`, `GITHUB_WRITE_TOOLS`, `TOOL_CONNECT_SCOPES`, and the
1820
+ * eve tool registry are all derived from this catalog. Adding a tool here (plus
1821
+ * its `"use step"` factory in `src/tools/` and `allTools` in `src/index.ts`,
1822
+ * both enforced at compile time) is the only registration needed.
1823
+ */
1824
+ declare const GITHUB_TOOL_CATALOG: {
1825
+ /** Get information about a GitHub repository including description, stars, forks, language, and default branch. */
1826
+ getRepository: {
1827
+ description: string;
1828
+ inputSchema: z.ZodObject<{
1829
+ owner: z.ZodString;
1830
+ repo: z.ZodString;
1831
+ }, z.core.$strip>;
1832
+ readonly core: typeof getRepositoryCore;
1833
+ connectScopes: readonly ["contents:read", "metadata:read"];
1834
+ };
1835
+ /** List branches in a GitHub repository. */
1836
+ listBranches: {
1837
+ description: string;
1838
+ inputSchema: z.ZodObject<{
1839
+ owner: z.ZodString;
1840
+ repo: z.ZodString;
1841
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1842
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1843
+ }, z.core.$strip>;
1844
+ readonly core: typeof listBranchesCore;
1845
+ connectScopes: readonly ["contents:read", "metadata:read"];
1846
+ };
1847
+ /** Get the content of a file from a GitHub repository. Prefer startLine/endLine or maxLines for large files. */
1848
+ getFileContent: {
1849
+ description: string;
1850
+ inputSchema: z.ZodObject<{
1851
+ owner: z.ZodString;
1852
+ repo: z.ZodString;
1853
+ path: z.ZodString;
1854
+ ref: z.ZodOptional<z.ZodString>;
1855
+ startLine: z.ZodOptional<z.ZodNumber>;
1856
+ endLine: z.ZodOptional<z.ZodNumber>;
1857
+ maxLines: z.ZodOptional<z.ZodNumber>;
1858
+ }, z.core.$strip>;
1859
+ readonly core: typeof getFileContentCore;
1860
+ connectScopes: readonly ["contents:read", "metadata:read"];
1861
+ };
1862
+ /** List the file and directory structure of a repository at a given ref. */
1863
+ getRepositoryTree: {
1864
+ description: string;
1865
+ inputSchema: z.ZodObject<{
1866
+ owner: z.ZodString;
1867
+ repo: z.ZodString;
1868
+ ref: z.ZodOptional<z.ZodString>;
1869
+ path: z.ZodOptional<z.ZodString>;
1870
+ recursive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
1871
+ }, z.core.$strip>;
1872
+ readonly core: typeof getRepositoryTreeCore;
1873
+ connectScopes: readonly ["contents:read", "metadata:read"];
1874
+ };
1875
+ /** Create a new branch in a GitHub repository from an existing branch or commit SHA. Requires approval by default. */
1876
+ createBranch: {
1877
+ description: string;
1878
+ inputSchema: z.ZodObject<{
1879
+ owner: z.ZodString;
1880
+ repo: z.ZodString;
1881
+ branch: z.ZodString;
1882
+ from: z.ZodOptional<z.ZodString>;
1883
+ }, z.core.$strip>;
1884
+ readonly core: typeof createBranchCore;
1885
+ write: true;
1886
+ connectScopes: readonly ["contents:read", "contents:write", "metadata:read"];
1887
+ };
1888
+ /** Delete a branch from a GitHub repository permanently. Requires approval by default. */
1889
+ deleteBranch: {
1890
+ description: string;
1891
+ inputSchema: z.ZodObject<{
1892
+ owner: z.ZodString;
1893
+ repo: z.ZodString;
1894
+ branch: z.ZodString;
1895
+ }, z.core.$strip>;
1896
+ readonly core: typeof deleteBranchCore;
1897
+ write: true;
1898
+ connectScopes: readonly ["contents:read", "contents:write", "metadata:read"];
1899
+ };
1900
+ /** Fork a GitHub repository to the authenticated user account or a specified organization. Requires approval by default. */
1901
+ forkRepository: {
1902
+ description: string;
1903
+ inputSchema: z.ZodObject<{
1904
+ owner: z.ZodString;
1905
+ repo: z.ZodString;
1906
+ organization: z.ZodOptional<z.ZodString>;
1907
+ name: z.ZodOptional<z.ZodString>;
1908
+ }, z.core.$strip>;
1909
+ readonly core: typeof forkRepositoryCore;
1910
+ write: true;
1911
+ connectScopes: readonly ["contents:read", "metadata:read"];
1912
+ };
1913
+ /** Create a new GitHub repository for the authenticated user or a specified organization. Requires approval by default. */
1914
+ createRepository: {
1915
+ description: string;
1916
+ inputSchema: z.ZodObject<{
1917
+ name: z.ZodString;
1918
+ description: z.ZodOptional<z.ZodString>;
1919
+ isPrivate: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
1920
+ autoInit: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
1921
+ gitignoreTemplate: z.ZodOptional<z.ZodString>;
1922
+ licenseTemplate: z.ZodOptional<z.ZodString>;
1923
+ org: z.ZodOptional<z.ZodString>;
1924
+ }, z.core.$strip>;
1925
+ readonly core: typeof createRepositoryCore;
1926
+ write: true;
1927
+ connectScopes: readonly ["metadata:read", "administration:read", "administration:write"];
1928
+ };
1929
+ /** Create or update a file in a GitHub repository. Provide the SHA when updating an existing file. Requires approval by default. */
1930
+ createOrUpdateFile: {
1931
+ description: string;
1932
+ inputSchema: z.ZodObject<{
1933
+ owner: z.ZodString;
1934
+ repo: z.ZodString;
1935
+ path: z.ZodString;
1936
+ message: z.ZodString;
1937
+ content: z.ZodString;
1938
+ branch: z.ZodOptional<z.ZodString>;
1939
+ sha: z.ZodOptional<z.ZodString>;
1940
+ }, z.core.$strip>;
1941
+ readonly core: typeof createOrUpdateFileCore;
1942
+ write: true;
1943
+ connectScopes: readonly ["contents:read", "contents:write", "metadata:read"];
1944
+ };
1945
+ /** List pull requests for a GitHub repository. */
1946
+ listPullRequests: {
1947
+ description: string;
1948
+ inputSchema: z.ZodObject<{
1949
+ owner: z.ZodString;
1950
+ repo: z.ZodString;
1951
+ state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
1952
+ open: "open";
1953
+ closed: "closed";
1954
+ all: "all";
1955
+ }>>>;
1956
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1957
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1958
+ maxPages: z.ZodOptional<z.ZodNumber>;
1959
+ }, z.core.$strip>;
1960
+ readonly core: typeof listPullRequestsCore;
1961
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read"];
1962
+ };
1963
+ /** Get detailed information about a specific pull request. Body truncated by default (detail: summary). */
1964
+ getPullRequest: {
1965
+ description: string;
1966
+ inputSchema: z.ZodObject<{
1967
+ owner: z.ZodString;
1968
+ repo: z.ZodString;
1969
+ pullNumber: z.ZodNumber;
1970
+ detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
1971
+ summary: "summary";
1972
+ full: "full";
1973
+ }>>>;
1974
+ }, z.core.$strip>;
1975
+ readonly core: typeof getPullRequestCore;
1976
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read"];
1977
+ };
1978
+ /** Create a new pull request in a GitHub repository. Requires approval by default. */
1979
+ createPullRequest: {
1980
+ description: string;
1981
+ inputSchema: z.ZodObject<{
1982
+ owner: z.ZodString;
1983
+ repo: z.ZodString;
1984
+ title: z.ZodString;
1985
+ body: z.ZodOptional<z.ZodString>;
1986
+ head: z.ZodString;
1987
+ base: z.ZodString;
1988
+ draft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
1989
+ }, z.core.$strip>;
1990
+ readonly core: typeof createPullRequestCore;
1991
+ write: true;
1992
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read", "pull_requests:write"];
1993
+ };
1994
+ /** Merge a pull request. Requires approval by default. */
1995
+ mergePullRequest: {
1996
+ description: string;
1997
+ inputSchema: z.ZodObject<{
1998
+ owner: z.ZodString;
1999
+ repo: z.ZodString;
2000
+ pullNumber: z.ZodNumber;
2001
+ commitTitle: z.ZodOptional<z.ZodString>;
2002
+ commitMessage: z.ZodOptional<z.ZodString>;
2003
+ mergeMethod: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2004
+ merge: "merge";
2005
+ squash: "squash";
2006
+ rebase: "rebase";
2007
+ }>>>;
2008
+ }, z.core.$strip>;
2009
+ readonly core: typeof mergePullRequestCore;
2010
+ write: true;
2011
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read", "pull_requests:write"];
2012
+ };
2013
+ /** Update a pull request — title, body, state, base branch, or draft status. Requires approval by default. */
2014
+ updatePullRequest: {
2015
+ description: string;
2016
+ inputSchema: z.ZodObject<{
2017
+ owner: z.ZodString;
2018
+ repo: z.ZodString;
2019
+ pullNumber: z.ZodNumber;
2020
+ title: z.ZodOptional<z.ZodString>;
2021
+ body: z.ZodOptional<z.ZodString>;
2022
+ state: z.ZodOptional<z.ZodEnum<{
2023
+ open: "open";
2024
+ closed: "closed";
2025
+ }>>;
2026
+ base: z.ZodOptional<z.ZodString>;
2027
+ draft: z.ZodOptional<z.ZodBoolean>;
2028
+ }, z.core.$strip>;
2029
+ readonly core: typeof updatePullRequestCore;
2030
+ write: true;
2031
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read", "pull_requests:write"];
2032
+ };
2033
+ /** Add a comment to a pull request. Requires approval by default. */
2034
+ addPullRequestComment: {
2035
+ description: string;
2036
+ inputSchema: z.ZodObject<{
2037
+ owner: z.ZodString;
2038
+ repo: z.ZodString;
2039
+ pullNumber: z.ZodNumber;
2040
+ body: z.ZodString;
2041
+ }, z.core.$strip>;
2042
+ readonly core: typeof addPullRequestCommentCore;
2043
+ write: true;
2044
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read", "pull_requests:write"];
2045
+ };
2046
+ /** Update the body of a comment on a pull request. Requires approval by default. */
2047
+ updatePullRequestComment: {
2048
+ description: string;
2049
+ inputSchema: z.ZodObject<{
2050
+ owner: z.ZodString;
2051
+ repo: z.ZodString;
2052
+ commentId: z.ZodNumber;
2053
+ body: z.ZodString;
2054
+ }, z.core.$strip>;
2055
+ readonly core: typeof updatePullRequestCommentCore;
2056
+ write: true;
2057
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read", "pull_requests:write"];
2058
+ };
2059
+ /** Delete a comment from a pull request permanently. Requires approval by default. */
2060
+ deletePullRequestComment: {
2061
+ description: string;
2062
+ inputSchema: z.ZodObject<{
2063
+ owner: z.ZodString;
2064
+ repo: z.ZodString;
2065
+ commentId: z.ZodNumber;
2066
+ }, z.core.$strip>;
2067
+ readonly core: typeof deletePullRequestCommentCore;
2068
+ write: true;
2069
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read", "pull_requests:write"];
2070
+ };
2071
+ /** List files changed in a pull request with status and stats. Patches omitted by default — set includePatch true for diffs. */
2072
+ listPullRequestFiles: {
2073
+ description: string;
2074
+ inputSchema: z.ZodObject<{
2075
+ owner: z.ZodString;
2076
+ repo: z.ZodString;
2077
+ pullNumber: z.ZodNumber;
2078
+ includePatch: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2079
+ filenames: z.ZodOptional<z.ZodArray<z.ZodString>>;
2080
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2081
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2082
+ }, z.core.$strip>;
2083
+ readonly core: typeof listPullRequestFilesCore;
2084
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read"];
2085
+ };
2086
+ /** List reviews on a pull request (approvals, change requests, and comments). */
2087
+ listPullRequestReviews: {
2088
+ description: string;
2089
+ inputSchema: z.ZodObject<{
2090
+ owner: z.ZodString;
2091
+ repo: z.ZodString;
2092
+ pullNumber: z.ZodNumber;
2093
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2094
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2095
+ }, z.core.$strip>;
2096
+ readonly core: typeof listPullRequestReviewsCore;
2097
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read"];
2098
+ };
2099
+ /** Submit a pull request review — approve, request changes, or comment with optional inline comments on specific lines. Requires approval by default. */
2100
+ createPullRequestReview: {
2101
+ description: string;
2102
+ inputSchema: z.ZodObject<{
2103
+ owner: z.ZodString;
2104
+ repo: z.ZodString;
2105
+ pullNumber: z.ZodNumber;
2106
+ body: z.ZodOptional<z.ZodString>;
2107
+ event: z.ZodEnum<{
2108
+ APPROVE: "APPROVE";
2109
+ REQUEST_CHANGES: "REQUEST_CHANGES";
2110
+ COMMENT: "COMMENT";
2111
+ }>;
2112
+ comments: z.ZodOptional<z.ZodArray<z.ZodObject<{
2113
+ path: z.ZodString;
2114
+ body: z.ZodString;
2115
+ line: z.ZodOptional<z.ZodNumber>;
2116
+ side: z.ZodOptional<z.ZodEnum<{
2117
+ LEFT: "LEFT";
2118
+ RIGHT: "RIGHT";
2119
+ }>>;
2120
+ }, z.core.$strip>>>;
2121
+ }, z.core.$strip>;
2122
+ readonly core: typeof createPullRequestReviewCore;
2123
+ write: true;
2124
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read", "pull_requests:write"];
2125
+ };
2126
+ /** List review threads on a pull request with comments, resolution state, and the IDs needed to reply or resolve. Unresolved only by default. */
2127
+ listPullRequestReviewThreads: {
2128
+ description: string;
2129
+ inputSchema: z.ZodObject<{
2130
+ owner: z.ZodString;
2131
+ repo: z.ZodString;
2132
+ pullNumber: z.ZodNumber;
2133
+ status: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2134
+ all: "all";
2135
+ unresolved: "unresolved";
2136
+ }>>>;
2137
+ detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2138
+ summary: "summary";
2139
+ full: "full";
2140
+ }>>>;
2141
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2142
+ after: z.ZodOptional<z.ZodString>;
2143
+ }, z.core.$strip>;
2144
+ readonly core: typeof listPullRequestReviewThreadsCore;
2145
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read"];
2146
+ };
2147
+ /** Reply to a pull request review comment in its review thread. Requires approval by default. */
2148
+ replyToReviewComment: {
2149
+ description: string;
2150
+ inputSchema: z.ZodObject<{
2151
+ owner: z.ZodString;
2152
+ repo: z.ZodString;
2153
+ pullNumber: z.ZodNumber;
2154
+ commentId: z.ZodNumber;
2155
+ body: z.ZodString;
2156
+ }, z.core.$strip>;
2157
+ readonly core: typeof replyToReviewCommentCore;
2158
+ write: true;
2159
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read", "pull_requests:write"];
2160
+ };
2161
+ /** Mark a pull request review thread as resolved. Requires approval by default. */
2162
+ resolveReviewThread: {
2163
+ description: string;
2164
+ inputSchema: z.ZodObject<{
2165
+ threadId: z.ZodString;
2166
+ }, z.core.$strip>;
2167
+ readonly core: typeof resolveReviewThreadCore;
2168
+ write: true;
2169
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read", "pull_requests:write"];
2170
+ };
2171
+ /** Request reviews from users or teams on a pull request. Requires approval by default. */
2172
+ requestReviewers: {
2173
+ description: string;
2174
+ inputSchema: z.ZodObject<{
2175
+ owner: z.ZodString;
2176
+ repo: z.ZodString;
2177
+ pullNumber: z.ZodNumber;
2178
+ reviewers: z.ZodOptional<z.ZodArray<z.ZodString>>;
2179
+ teamReviewers: z.ZodOptional<z.ZodArray<z.ZodString>>;
2180
+ }, z.core.$strip>;
2181
+ readonly core: typeof requestReviewersCore;
2182
+ write: true;
2183
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read", "pull_requests:write"];
2184
+ };
2185
+ /** Fetch pull request details plus files, reviews, and optional CI checks in one call. */
2186
+ getPullRequestContext: {
2187
+ description: string;
2188
+ inputSchema: z.ZodObject<{
2189
+ owner: z.ZodString;
2190
+ repo: z.ZodString;
2191
+ pullNumber: z.ZodNumber;
2192
+ includeFiles: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2193
+ includeReviews: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2194
+ includeChecks: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2195
+ includePatch: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2196
+ filesPerPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2197
+ detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2198
+ summary: "summary";
2199
+ full: "full";
2200
+ }>>>;
2201
+ }, z.core.$strip>;
2202
+ readonly core: typeof getPullRequestContextCore;
2203
+ connectScopes: readonly ["contents:read", "metadata:read", "pull_requests:read", "checks:read", "statuses:read"];
2204
+ };
2205
+ /** Fetch an issue plus available label names and recent comments in one call. */
2206
+ getIssueContext: {
2207
+ description: string;
2208
+ inputSchema: z.ZodObject<{
2209
+ owner: z.ZodString;
2210
+ repo: z.ZodString;
2211
+ issueNumber: z.ZodNumber;
2212
+ includeLabels: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2213
+ includeComments: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2214
+ maxComments: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2215
+ detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2216
+ summary: "summary";
2217
+ full: "full";
2218
+ }>>>;
2219
+ }, z.core.$strip>;
2220
+ readonly core: typeof getIssueContextCore;
2221
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read"];
2222
+ };
2223
+ /** List issues for a GitHub repository (excludes pull requests). */
2224
+ listIssues: {
2225
+ description: string;
2226
+ inputSchema: z.ZodObject<{
2227
+ owner: z.ZodString;
2228
+ repo: z.ZodString;
2229
+ state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2230
+ open: "open";
2231
+ closed: "closed";
2232
+ all: "all";
2233
+ }>>>;
2234
+ labels: z.ZodOptional<z.ZodString>;
2235
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2236
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2237
+ maxPages: z.ZodOptional<z.ZodNumber>;
2238
+ }, z.core.$strip>;
2239
+ readonly core: typeof listIssuesCore;
2240
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read"];
2241
+ };
2242
+ /** Get detailed information about a specific issue. Body truncated by default (detail: summary). */
2243
+ getIssue: {
2244
+ description: string;
2245
+ inputSchema: z.ZodObject<{
2246
+ owner: z.ZodString;
2247
+ repo: z.ZodString;
2248
+ issueNumber: z.ZodNumber;
2249
+ detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2250
+ summary: "summary";
2251
+ full: "full";
2252
+ }>>>;
2253
+ }, z.core.$strip>;
2254
+ readonly core: typeof getIssueCore;
2255
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read"];
2256
+ };
2257
+ /** List comments on a GitHub issue. Bodies are truncated by default (detail: summary). Prefer getIssueContext for the first page when triaging. */
2258
+ listIssueComments: {
2259
+ description: string;
2260
+ inputSchema: z.ZodObject<{
2261
+ owner: z.ZodString;
2262
+ repo: z.ZodString;
2263
+ issueNumber: z.ZodNumber;
2264
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2265
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2266
+ detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2267
+ summary: "summary";
2268
+ full: "full";
2269
+ }>>>;
2270
+ }, z.core.$strip>;
2271
+ readonly core: typeof listIssueCommentsCore;
2272
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read"];
2273
+ };
2274
+ /** Create a new issue in a GitHub repository. Requires approval by default. */
2275
+ createIssue: {
2276
+ description: string;
2277
+ inputSchema: z.ZodObject<{
2278
+ owner: z.ZodString;
2279
+ repo: z.ZodString;
2280
+ title: z.ZodString;
2281
+ body: z.ZodOptional<z.ZodString>;
2282
+ labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
2283
+ assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
2284
+ }, z.core.$strip>;
2285
+ readonly core: typeof createIssueCore;
2286
+ write: true;
2287
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
2288
+ };
2289
+ /** Add a comment to a GitHub issue. Requires approval by default. */
2290
+ addIssueComment: {
2291
+ description: string;
2292
+ inputSchema: z.ZodObject<{
2293
+ owner: z.ZodString;
2294
+ repo: z.ZodString;
2295
+ issueNumber: z.ZodNumber;
2296
+ body: z.ZodString;
2297
+ }, z.core.$strip>;
2298
+ readonly core: typeof addIssueCommentCore;
2299
+ write: true;
2300
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
2301
+ };
2302
+ /** Update the body of a comment on a GitHub issue. Requires approval by default. */
2303
+ updateIssueComment: {
2304
+ description: string;
2305
+ inputSchema: z.ZodObject<{
2306
+ owner: z.ZodString;
2307
+ repo: z.ZodString;
2308
+ commentId: z.ZodNumber;
2309
+ body: z.ZodString;
2310
+ }, z.core.$strip>;
2311
+ readonly core: typeof updateIssueCommentCore;
2312
+ write: true;
2313
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
2314
+ };
2315
+ /** Delete a comment from a GitHub issue permanently. Requires approval by default. */
2316
+ deleteIssueComment: {
2317
+ description: string;
2318
+ inputSchema: z.ZodObject<{
2319
+ owner: z.ZodString;
2320
+ repo: z.ZodString;
2321
+ commentId: z.ZodNumber;
2322
+ }, z.core.$strip>;
2323
+ readonly core: typeof deleteIssueCommentCore;
2324
+ write: true;
2325
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
2326
+ };
2327
+ /** Close an open GitHub issue. Requires approval by default. */
2328
+ closeIssue: {
2329
+ description: string;
2330
+ inputSchema: z.ZodObject<{
2331
+ owner: z.ZodString;
2332
+ repo: z.ZodString;
2333
+ issueNumber: z.ZodNumber;
2334
+ stateReason: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2335
+ completed: "completed";
2336
+ not_planned: "not_planned";
2337
+ }>>>;
2338
+ }, z.core.$strip>;
2339
+ readonly core: typeof closeIssueCore;
2340
+ write: true;
2341
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
2342
+ };
2343
+ /** Update a GitHub issue — title, body, state, labels, milestone, or assignees. Requires approval by default. */
2344
+ updateIssue: {
2345
+ description: string;
2346
+ inputSchema: z.ZodObject<{
2347
+ owner: z.ZodString;
2348
+ repo: z.ZodString;
2349
+ issueNumber: z.ZodNumber;
2350
+ title: z.ZodOptional<z.ZodString>;
2351
+ body: z.ZodOptional<z.ZodString>;
2352
+ state: z.ZodOptional<z.ZodEnum<{
2353
+ open: "open";
2354
+ closed: "closed";
2355
+ }>>;
2356
+ stateReason: z.ZodOptional<z.ZodEnum<{
2357
+ completed: "completed";
2358
+ not_planned: "not_planned";
2359
+ reopened: "reopened";
2360
+ }>>;
2361
+ labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
2362
+ milestone: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
2363
+ assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
2364
+ }, z.core.$strip>;
2365
+ readonly core: typeof updateIssueCore;
2366
+ write: true;
2367
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
2368
+ };
2369
+ /** List labels available in a GitHub repository. */
2370
+ listLabels: {
2371
+ description: string;
2372
+ inputSchema: z.ZodObject<{
2373
+ owner: z.ZodString;
2374
+ repo: z.ZodString;
2375
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2376
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2377
+ }, z.core.$strip>;
2378
+ readonly core: typeof listLabelsCore;
2379
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read"];
2380
+ };
2381
+ /** Add labels to an issue or pull request. Requires approval by default. */
2382
+ addLabels: {
2383
+ description: string;
2384
+ inputSchema: z.ZodObject<{
2385
+ owner: z.ZodString;
2386
+ repo: z.ZodString;
2387
+ issueNumber: z.ZodNumber;
2388
+ labels: z.ZodArray<z.ZodString>;
2389
+ }, z.core.$strip>;
2390
+ readonly core: typeof addLabelsCore;
2391
+ write: true;
2392
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
2393
+ };
2394
+ /** Remove a label from an issue or pull request. Requires approval by default. */
2395
+ removeLabel: {
2396
+ description: string;
2397
+ inputSchema: z.ZodObject<{
2398
+ owner: z.ZodString;
2399
+ repo: z.ZodString;
2400
+ issueNumber: z.ZodNumber;
2401
+ label: z.ZodString;
2402
+ }, z.core.$strip>;
2403
+ readonly core: typeof removeLabelCore;
2404
+ write: true;
2405
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
2406
+ };
2407
+ /** Create a label in a GitHub repository. Requires approval by default. */
2408
+ createLabel: {
2409
+ description: string;
2410
+ inputSchema: z.ZodObject<{
2411
+ owner: z.ZodString;
2412
+ repo: z.ZodString;
2413
+ name: z.ZodString;
2414
+ color: z.ZodString;
2415
+ description: z.ZodOptional<z.ZodString>;
2416
+ }, z.core.$strip>;
2417
+ readonly core: typeof createLabelCore;
2418
+ write: true;
2419
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
2420
+ };
2421
+ /** Update a label in a GitHub repository — name, color, or description. Requires approval by default. */
2422
+ updateLabel: {
2423
+ description: string;
2424
+ inputSchema: z.ZodObject<{
2425
+ owner: z.ZodString;
2426
+ repo: z.ZodString;
2427
+ name: z.ZodString;
2428
+ newName: z.ZodOptional<z.ZodString>;
2429
+ color: z.ZodOptional<z.ZodString>;
2430
+ description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
2431
+ }, z.core.$strip>;
2432
+ readonly core: typeof updateLabelCore;
2433
+ write: true;
2434
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
2435
+ };
2436
+ /** Delete a label from a GitHub repository permanently. Requires approval by default. */
2437
+ deleteLabel: {
2438
+ description: string;
2439
+ inputSchema: z.ZodObject<{
2440
+ owner: z.ZodString;
2441
+ repo: z.ZodString;
2442
+ name: z.ZodString;
2443
+ }, z.core.$strip>;
2444
+ readonly core: typeof deleteLabelCore;
2445
+ write: true;
2446
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
2447
+ };
2448
+ /** Assign users to an issue or pull request. Requires approval by default. */
2449
+ addAssignees: {
2450
+ description: string;
2451
+ inputSchema: z.ZodObject<{
2452
+ owner: z.ZodString;
2453
+ repo: z.ZodString;
2454
+ issueNumber: z.ZodNumber;
2455
+ assignees: z.ZodArray<z.ZodString>;
2456
+ }, z.core.$strip>;
2457
+ readonly core: typeof addAssigneesCore;
2458
+ write: true;
2459
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
2460
+ };
2461
+ /** Remove assignees from an issue or pull request. Requires approval by default. */
2462
+ removeAssignees: {
2463
+ description: string;
2464
+ inputSchema: z.ZodObject<{
2465
+ owner: z.ZodString;
2466
+ repo: z.ZodString;
2467
+ issueNumber: z.ZodNumber;
2468
+ assignees: z.ZodArray<z.ZodString>;
2469
+ }, z.core.$strip>;
2470
+ readonly core: typeof removeAssigneesCore;
2471
+ write: true;
2472
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
2473
+ };
2474
+ /** List reactions on an issue or pull request conversation, with per-emoji counts. */
2475
+ listIssueReactions: {
2476
+ description: string;
2477
+ inputSchema: z.ZodObject<{
2478
+ owner: z.ZodString;
2479
+ repo: z.ZodString;
2480
+ issueNumber: z.ZodNumber;
2481
+ content: z.ZodOptional<z.ZodEnum<{
2482
+ "+1": "+1";
2483
+ [-1]: "-1";
2484
+ laugh: "laugh";
2485
+ confused: "confused";
2486
+ heart: "heart";
2487
+ hooray: "hooray";
2488
+ rocket: "rocket";
2489
+ eyes: "eyes";
2490
+ }>>;
2491
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2492
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2493
+ }, z.core.$strip>;
2494
+ readonly core: typeof listIssueReactionsCore;
2495
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read"];
2496
+ };
2497
+ /** React to an issue or pull request with an emoji. Requires approval by default. */
2498
+ addIssueReaction: {
2499
+ description: string;
2500
+ inputSchema: z.ZodObject<{
2501
+ owner: z.ZodString;
2502
+ repo: z.ZodString;
2503
+ issueNumber: z.ZodNumber;
2504
+ content: z.ZodEnum<{
2505
+ "+1": "+1";
2506
+ [-1]: "-1";
2507
+ laugh: "laugh";
2508
+ confused: "confused";
2509
+ heart: "heart";
2510
+ hooray: "hooray";
2511
+ rocket: "rocket";
2512
+ eyes: "eyes";
2513
+ }>;
2514
+ }, z.core.$strip>;
2515
+ readonly core: typeof addIssueReactionCore;
2516
+ write: true;
2517
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
2518
+ };
2519
+ /** List reactions on an issue or pull request comment, with per-emoji counts. */
2520
+ listCommentReactions: {
2521
+ description: string;
2522
+ inputSchema: z.ZodObject<{
2523
+ owner: z.ZodString;
2524
+ repo: z.ZodString;
2525
+ commentId: z.ZodNumber;
2526
+ content: z.ZodOptional<z.ZodEnum<{
2527
+ "+1": "+1";
2528
+ [-1]: "-1";
2529
+ laugh: "laugh";
2530
+ confused: "confused";
2531
+ heart: "heart";
2532
+ hooray: "hooray";
2533
+ rocket: "rocket";
2534
+ eyes: "eyes";
2535
+ }>>;
2536
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2537
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2538
+ }, z.core.$strip>;
2539
+ readonly core: typeof listCommentReactionsCore;
2540
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read"];
2541
+ };
2542
+ /** React to an issue or pull request comment with an emoji. Requires approval by default. */
2543
+ addCommentReaction: {
2544
+ description: string;
2545
+ inputSchema: z.ZodObject<{
2546
+ owner: z.ZodString;
2547
+ repo: z.ZodString;
2548
+ commentId: z.ZodNumber;
2549
+ content: z.ZodEnum<{
2550
+ "+1": "+1";
2551
+ [-1]: "-1";
2552
+ laugh: "laugh";
2553
+ confused: "confused";
2554
+ heart: "heart";
2555
+ hooray: "hooray";
2556
+ rocket: "rocket";
2557
+ eyes: "eyes";
2558
+ }>;
2559
+ }, z.core.$strip>;
2560
+ readonly core: typeof addCommentReactionCore;
2561
+ write: true;
2562
+ connectScopes: readonly ["contents:read", "metadata:read", "issues:read", "issues:write"];
2563
+ };
2564
+ /** List discussions in a GitHub repository, most recently updated first, optionally filtered by category. */
2565
+ listDiscussions: {
2566
+ description: string;
2567
+ inputSchema: z.ZodObject<{
2568
+ owner: z.ZodString;
2569
+ repo: z.ZodString;
2570
+ category: z.ZodOptional<z.ZodString>;
2571
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2572
+ after: z.ZodOptional<z.ZodString>;
2573
+ }, z.core.$strip>;
2574
+ readonly core: typeof listDiscussionsCore;
2575
+ connectScopes: readonly ["contents:read", "metadata:read", "discussions:read"];
2576
+ };
2577
+ /** Get a GitHub discussion by number. Body truncated by default (detail: summary). */
2578
+ getDiscussion: {
2579
+ description: string;
2580
+ inputSchema: z.ZodObject<{
2581
+ owner: z.ZodString;
2582
+ repo: z.ZodString;
2583
+ discussionNumber: z.ZodNumber;
2584
+ detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2585
+ summary: "summary";
2586
+ full: "full";
2587
+ }>>>;
2588
+ }, z.core.$strip>;
2589
+ readonly core: typeof getDiscussionCore;
2590
+ connectScopes: readonly ["contents:read", "metadata:read", "discussions:read"];
2591
+ };
2592
+ /** Add a comment to a GitHub discussion. Requires approval by default. */
2593
+ addDiscussionComment: {
2594
+ description: string;
2595
+ inputSchema: z.ZodObject<{
2596
+ owner: z.ZodString;
2597
+ repo: z.ZodString;
2598
+ discussionNumber: z.ZodNumber;
2599
+ body: z.ZodString;
2600
+ }, z.core.$strip>;
2601
+ readonly core: typeof addDiscussionCommentCore;
2602
+ write: true;
2603
+ connectScopes: readonly ["contents:read", "metadata:read", "discussions:read", "discussions:write"];
2604
+ };
2605
+ /** List notification threads for the authenticated user. Requires a token with notifications access. */
2606
+ listNotifications: {
2607
+ description: string;
2608
+ inputSchema: z.ZodObject<{
2609
+ all: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2610
+ participating: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2611
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2612
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2613
+ }, z.core.$strip>;
2614
+ readonly core: typeof listNotificationsCore;
2615
+ connectScopes: readonly [];
2616
+ };
2617
+ /** Mark a single notification thread as read. Requires approval by default. */
2618
+ markNotificationRead: {
2619
+ description: string;
2620
+ inputSchema: z.ZodObject<{
2621
+ threadId: z.ZodString;
2622
+ }, z.core.$strip>;
2623
+ readonly core: typeof markNotificationReadCore;
2624
+ write: true;
2625
+ connectScopes: readonly [];
2626
+ };
2627
+ /** Search for code in GitHub repositories. Use qualifiers like "repo:owner/name" to scope the search. Results include matching text snippets when GitHub returns them. */
2628
+ searchCode: {
2629
+ description: string;
2630
+ inputSchema: z.ZodObject<{
2631
+ query: z.ZodString;
2632
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2633
+ }, z.core.$strip>;
2634
+ readonly core: typeof searchCodeCore;
2635
+ connectScopes: readonly ["contents:read", "metadata:read"];
2636
+ };
2637
+ /** Search for GitHub repositories by keyword, topic, language, or other qualifiers. */
2638
+ searchRepositories: {
2639
+ description: string;
2640
+ inputSchema: z.ZodObject<{
2641
+ query: z.ZodString;
2642
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2643
+ sort: z.ZodOptional<z.ZodEnum<{
2644
+ stars: "stars";
2645
+ forks: "forks";
2646
+ "help-wanted-issues": "help-wanted-issues";
2647
+ updated: "updated";
2648
+ }>>;
2649
+ order: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2650
+ asc: "asc";
2651
+ desc: "desc";
2652
+ }>>>;
2653
+ }, z.core.$strip>;
2654
+ readonly core: typeof searchRepositoriesCore;
2655
+ connectScopes: readonly ["metadata:read"];
2656
+ };
2657
+ /** Search for issues and pull requests across GitHub using search qualifiers like "repo:owner/name is:open". */
2658
+ searchIssues: {
2659
+ description: string;
2660
+ inputSchema: z.ZodObject<{
2661
+ query: z.ZodString;
2662
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2663
+ sort: z.ZodOptional<z.ZodEnum<{
2664
+ comments: "comments";
2665
+ updated: "updated";
2666
+ reactions: "reactions";
2667
+ created: "created";
2668
+ interactions: "interactions";
2669
+ }>>;
2670
+ order: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2671
+ asc: "asc";
2672
+ desc: "desc";
2673
+ }>>>;
2674
+ }, z.core.$strip>;
2675
+ readonly core: typeof searchIssuesCore;
2676
+ connectScopes: readonly ["metadata:read", "issues:read", "pull_requests:read"];
2677
+ };
2678
+ /** List commits for a GitHub repository. Filter by file path to see commits that touched a file. For line-by-line attribution at a given ref, use getBlame instead. */
2679
+ listCommits: {
2680
+ description: string;
2681
+ inputSchema: z.ZodObject<{
2682
+ owner: z.ZodString;
2683
+ repo: z.ZodString;
2684
+ path: z.ZodOptional<z.ZodString>;
2685
+ sha: z.ZodOptional<z.ZodString>;
2686
+ author: z.ZodOptional<z.ZodString>;
2687
+ since: z.ZodOptional<z.ZodString>;
2688
+ until: z.ZodOptional<z.ZodString>;
2689
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2690
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2691
+ maxPages: z.ZodOptional<z.ZodNumber>;
2692
+ }, z.core.$strip>;
2693
+ readonly core: typeof listCommitsCore;
2694
+ connectScopes: readonly ["contents:read", "metadata:read"];
2695
+ };
2696
+ /** Get detailed information about a specific commit, including the list of files changed. Patches omitted by default. */
2697
+ getCommit: {
2698
+ description: string;
2699
+ inputSchema: z.ZodObject<{
2700
+ owner: z.ZodString;
2701
+ repo: z.ZodString;
2702
+ ref: z.ZodString;
2703
+ includePatch: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2704
+ }, z.core.$strip>;
2705
+ readonly core: typeof getCommitCore;
2706
+ connectScopes: readonly ["contents:read", "metadata:read"];
2707
+ };
2708
+ /** Line-level git blame for a file at a commit-like ref (branch, tag, or SHA). Returns contiguous ranges mapping lines to the commits that last modified them. */
2709
+ getBlame: {
2710
+ description: string;
2711
+ inputSchema: z.ZodObject<{
2712
+ owner: z.ZodString;
2713
+ repo: z.ZodString;
2714
+ path: z.ZodString;
2715
+ ref: z.ZodOptional<z.ZodString>;
2716
+ line: z.ZodOptional<z.ZodNumber>;
2717
+ lineStart: z.ZodOptional<z.ZodNumber>;
2718
+ lineEnd: z.ZodOptional<z.ZodNumber>;
2719
+ }, z.core.$strip>;
2720
+ readonly core: typeof getBlameCore;
2721
+ connectScopes: readonly ["contents:read", "metadata:read"];
2722
+ };
2723
+ /** Compare two branches, tags, or commits — ahead/behind counts, commits in between, and differing files. Patches omitted by default. */
2724
+ compareCommits: {
2725
+ description: string;
2726
+ inputSchema: z.ZodObject<{
2727
+ owner: z.ZodString;
2728
+ repo: z.ZodString;
2729
+ base: z.ZodString;
2730
+ head: z.ZodString;
2731
+ includePatch: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2732
+ }, z.core.$strip>;
2733
+ readonly core: typeof compareCommitsCore;
2734
+ connectScopes: readonly ["contents:read", "metadata:read"];
2735
+ };
2736
+ /** List gists for the authenticated user or a specific user. */
2737
+ listGists: {
2738
+ description: string;
2739
+ inputSchema: z.ZodObject<{
2740
+ username: z.ZodOptional<z.ZodString>;
2741
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2742
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2743
+ }, z.core.$strip>;
2744
+ readonly core: typeof listGistsCore;
2745
+ connectScopes: readonly [];
2746
+ };
2747
+ /** Get a gist by ID, including file contents. */
2748
+ getGist: {
2749
+ description: string;
2750
+ inputSchema: z.ZodObject<{
2751
+ gistId: z.ZodString;
2752
+ }, z.core.$strip>;
2753
+ readonly core: typeof getGistCore;
2754
+ connectScopes: readonly [];
2755
+ };
2756
+ /** List comments on a gist. */
2757
+ listGistComments: {
2758
+ description: string;
2759
+ inputSchema: z.ZodObject<{
2760
+ gistId: z.ZodString;
2761
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2762
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2763
+ }, z.core.$strip>;
2764
+ readonly core: typeof listGistCommentsCore;
2765
+ connectScopes: readonly [];
2766
+ };
2767
+ /** Create a new gist with one or more files. Requires approval by default. */
2768
+ createGist: {
2769
+ description: string;
2770
+ inputSchema: z.ZodObject<{
2771
+ description: z.ZodOptional<z.ZodString>;
2772
+ files: z.ZodRecord<z.ZodString, z.ZodObject<{
2773
+ content: z.ZodString;
2774
+ }, z.core.$strip>>;
2775
+ isPublic: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2776
+ }, z.core.$strip>;
2777
+ readonly core: typeof createGistCore;
2778
+ write: true;
2779
+ connectScopes: readonly [];
2780
+ };
2781
+ /** Update an existing gist — edit description, update files, or remove files. Requires approval by default. */
2782
+ updateGist: {
2783
+ description: string;
2784
+ inputSchema: z.ZodObject<{
2785
+ gistId: z.ZodString;
2786
+ description: z.ZodOptional<z.ZodString>;
2787
+ files: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
2788
+ content: z.ZodString;
2789
+ }, z.core.$strip>>>;
2790
+ filesToDelete: z.ZodOptional<z.ZodArray<z.ZodString>>;
2791
+ }, z.core.$strip>;
2792
+ readonly core: typeof updateGistCore;
2793
+ write: true;
2794
+ connectScopes: readonly [];
2795
+ };
2796
+ /** Delete a gist permanently. Requires approval by default. */
2797
+ deleteGist: {
2798
+ description: string;
2799
+ inputSchema: z.ZodObject<{
2800
+ gistId: z.ZodString;
2801
+ }, z.core.$strip>;
2802
+ readonly core: typeof deleteGistCore;
2803
+ write: true;
2804
+ connectScopes: readonly [];
2805
+ };
2806
+ /** Add a comment to a gist. Requires approval by default. */
2807
+ createGistComment: {
2808
+ description: string;
2809
+ inputSchema: z.ZodObject<{
2810
+ gistId: z.ZodString;
2811
+ body: z.ZodString;
2812
+ }, z.core.$strip>;
2813
+ readonly core: typeof createGistCommentCore;
2814
+ write: true;
2815
+ connectScopes: readonly [];
2816
+ };
2817
+ /** List GitHub Actions workflows in a repository. */
2818
+ listWorkflows: {
2819
+ description: string;
2820
+ inputSchema: z.ZodObject<{
2821
+ owner: z.ZodString;
2822
+ repo: z.ZodString;
2823
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2824
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2825
+ }, z.core.$strip>;
2826
+ readonly core: typeof listWorkflowsCore;
2827
+ connectScopes: readonly ["contents:read", "metadata:read", "actions:read"];
2828
+ };
2829
+ /** List workflow runs for a repository, optionally filtered by workflow, branch, status, or event. */
2830
+ listWorkflowRuns: {
2831
+ description: string;
2832
+ inputSchema: z.ZodObject<{
2833
+ owner: z.ZodString;
2834
+ repo: z.ZodString;
2835
+ workflowId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
2836
+ branch: z.ZodOptional<z.ZodString>;
2837
+ event: z.ZodOptional<z.ZodString>;
2838
+ status: z.ZodOptional<z.ZodEnum<{
2839
+ success: "success";
2840
+ completed: "completed";
2841
+ action_required: "action_required";
2842
+ cancelled: "cancelled";
2843
+ failure: "failure";
2844
+ neutral: "neutral";
2845
+ skipped: "skipped";
2846
+ stale: "stale";
2847
+ timed_out: "timed_out";
2848
+ in_progress: "in_progress";
2849
+ queued: "queued";
2850
+ requested: "requested";
2851
+ waiting: "waiting";
2852
+ pending: "pending";
2853
+ }>>;
2854
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2855
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2856
+ maxPages: z.ZodOptional<z.ZodNumber>;
2857
+ }, z.core.$strip>;
2858
+ readonly core: typeof listWorkflowRunsCore;
2859
+ connectScopes: readonly ["contents:read", "metadata:read", "actions:read"];
2860
+ };
2861
+ /** Get details of a specific workflow run including status, timing, and trigger info. */
2862
+ getWorkflowRun: {
2863
+ description: string;
2864
+ inputSchema: z.ZodObject<{
2865
+ owner: z.ZodString;
2866
+ repo: z.ZodString;
2867
+ runId: z.ZodNumber;
2868
+ }, z.core.$strip>;
2869
+ readonly core: typeof getWorkflowRunCore;
2870
+ connectScopes: readonly ["contents:read", "metadata:read", "actions:read"];
2871
+ };
2872
+ /** List jobs for a workflow run, including step-level status and timing. */
2873
+ listWorkflowJobs: {
2874
+ description: string;
2875
+ inputSchema: z.ZodObject<{
2876
+ owner: z.ZodString;
2877
+ repo: z.ZodString;
2878
+ runId: z.ZodNumber;
2879
+ filter: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2880
+ all: "all";
2881
+ latest: "latest";
2882
+ }>>>;
2883
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2884
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2885
+ }, z.core.$strip>;
2886
+ readonly core: typeof listWorkflowJobsCore;
2887
+ connectScopes: readonly ["contents:read", "metadata:read", "actions:read"];
2888
+ };
2889
+ /** Get the log output of a workflow job to diagnose failures. Returns the tail (default 200 lines) with timestamps stripped. */
2890
+ getWorkflowJobLogs: {
2891
+ description: string;
2892
+ inputSchema: z.ZodObject<{
2893
+ owner: z.ZodString;
2894
+ repo: z.ZodString;
2895
+ jobId: z.ZodNumber;
2896
+ maxLines: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2897
+ }, z.core.$strip>;
2898
+ readonly core: typeof getWorkflowJobLogsCore;
2899
+ connectScopes: readonly ["contents:read", "metadata:read", "actions:read"];
2900
+ };
2901
+ /** Trigger a workflow via workflow_dispatch event. Requires approval by default. */
2902
+ triggerWorkflow: {
2903
+ description: string;
2904
+ inputSchema: z.ZodObject<{
2905
+ owner: z.ZodString;
2906
+ repo: z.ZodString;
2907
+ workflowId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
2908
+ ref: z.ZodString;
2909
+ inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
2910
+ }, z.core.$strip>;
2911
+ readonly core: typeof triggerWorkflowCore;
2912
+ write: true;
2913
+ connectScopes: readonly ["contents:read", "metadata:read", "actions:read", "actions:write"];
2914
+ };
2915
+ /** Cancel an in-progress workflow run. Requires approval by default. */
2916
+ cancelWorkflowRun: {
2917
+ description: string;
2918
+ inputSchema: z.ZodObject<{
2919
+ owner: z.ZodString;
2920
+ repo: z.ZodString;
2921
+ runId: z.ZodNumber;
2922
+ }, z.core.$strip>;
2923
+ readonly core: typeof cancelWorkflowRunCore;
2924
+ write: true;
2925
+ connectScopes: readonly ["contents:read", "metadata:read", "actions:read", "actions:write"];
2926
+ };
2927
+ /** Re-run a workflow run, optionally only the failed jobs. Requires approval by default. */
2928
+ rerunWorkflowRun: {
2929
+ description: string;
2930
+ inputSchema: z.ZodObject<{
2931
+ owner: z.ZodString;
2932
+ repo: z.ZodString;
2933
+ runId: z.ZodNumber;
2934
+ onlyFailedJobs: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2935
+ }, z.core.$strip>;
2936
+ readonly core: typeof rerunWorkflowRunCore;
2937
+ write: true;
2938
+ connectScopes: readonly ["contents:read", "metadata:read", "actions:read", "actions:write"];
2939
+ };
2940
+ /** List check runs (Checks API — GitHub Actions and other CI providers) for a commit, branch, or tag. */
2941
+ listCheckRuns: {
2942
+ description: string;
2943
+ inputSchema: z.ZodObject<{
2944
+ owner: z.ZodString;
2945
+ repo: z.ZodString;
2946
+ ref: z.ZodString;
2947
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2948
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2949
+ maxPages: z.ZodOptional<z.ZodNumber>;
2950
+ }, z.core.$strip>;
2951
+ readonly core: typeof listCheckRunsCore;
2952
+ connectScopes: readonly ["contents:read", "metadata:read", "checks:read", "statuses:read"];
2953
+ };
2954
+ /** Get the combined commit status (Statuses API — legacy CI integrations) for a commit, branch, or tag. */
2955
+ getCombinedStatus: {
2956
+ description: string;
2957
+ inputSchema: z.ZodObject<{
2958
+ owner: z.ZodString;
2959
+ repo: z.ZodString;
2960
+ ref: z.ZodString;
2961
+ }, z.core.$strip>;
2962
+ readonly core: typeof getCombinedStatusCore;
2963
+ connectScopes: readonly ["contents:read", "metadata:read", "checks:read", "statuses:read"];
2964
+ };
2965
+ /** Diagnose CI failures for a ref — combined status, failing checks, and failed workflow jobs in one call. */
2966
+ getCiFailureContext: {
2967
+ description: string;
2968
+ inputSchema: z.ZodObject<{
2969
+ owner: z.ZodString;
2970
+ repo: z.ZodString;
2971
+ ref: z.ZodString;
2972
+ maxFailedRuns: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2973
+ maxFailedJobs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2974
+ }, z.core.$strip>;
2975
+ readonly core: typeof getCiFailureContextCore;
2976
+ connectScopes: readonly ["contents:read", "metadata:read", "actions:read", "checks:read", "statuses:read"];
2977
+ };
2978
+ /** List releases for a GitHub repository, newest first (includes drafts and prereleases). */
2979
+ listReleases: {
2980
+ description: string;
2981
+ inputSchema: z.ZodObject<{
2982
+ owner: z.ZodString;
2983
+ repo: z.ZodString;
2984
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2985
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2986
+ maxPages: z.ZodOptional<z.ZodNumber>;
2987
+ detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2988
+ summary: "summary";
2989
+ full: "full";
2990
+ }>>>;
2991
+ }, z.core.$strip>;
2992
+ readonly core: typeof listReleasesCore;
2993
+ connectScopes: readonly ["contents:read", "metadata:read"];
2994
+ };
2995
+ /** Get the latest published release for a GitHub repository (excludes drafts and prereleases). Body truncated by default. */
2996
+ getLatestRelease: {
2997
+ description: string;
2998
+ inputSchema: z.ZodObject<{
2999
+ owner: z.ZodString;
3000
+ repo: z.ZodString;
3001
+ detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
3002
+ summary: "summary";
3003
+ full: "full";
3004
+ }>>>;
3005
+ }, z.core.$strip>;
3006
+ readonly core: typeof getLatestReleaseCore;
3007
+ connectScopes: readonly ["contents:read", "metadata:read"];
3008
+ };
3009
+ /** Get a specific release by ID, including its assets. Body truncated by default. */
3010
+ getRelease: {
3011
+ description: string;
3012
+ inputSchema: z.ZodObject<{
3013
+ owner: z.ZodString;
3014
+ repo: z.ZodString;
3015
+ releaseId: z.ZodNumber;
3016
+ detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
3017
+ summary: "summary";
3018
+ full: "full";
3019
+ }>>>;
3020
+ }, z.core.$strip>;
3021
+ readonly core: typeof getReleaseCore;
3022
+ connectScopes: readonly ["contents:read", "metadata:read"];
3023
+ };
3024
+ /** Fetch a release plus the previous release and tag comparison in one call. */
3025
+ getReleaseContext: {
3026
+ description: string;
3027
+ inputSchema: z.ZodObject<{
3028
+ owner: z.ZodString;
3029
+ repo: z.ZodString;
3030
+ releaseId: z.ZodOptional<z.ZodNumber>;
3031
+ includePrevious: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
3032
+ includeCompare: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
3033
+ detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
3034
+ summary: "summary";
3035
+ full: "full";
3036
+ }>>>;
3037
+ }, z.core.$strip>;
3038
+ readonly core: typeof getReleaseContextCore;
3039
+ connectScopes: readonly ["contents:read", "metadata:read"];
3040
+ };
3041
+ /** Create a new release (and its tag if needed) in a GitHub repository. Requires approval by default. */
3042
+ createRelease: {
3043
+ description: string;
3044
+ inputSchema: z.ZodObject<{
3045
+ owner: z.ZodString;
3046
+ repo: z.ZodString;
3047
+ tagName: z.ZodString;
3048
+ target: z.ZodOptional<z.ZodString>;
3049
+ name: z.ZodOptional<z.ZodString>;
3050
+ body: z.ZodOptional<z.ZodString>;
3051
+ draft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
3052
+ prerelease: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
3053
+ generateReleaseNotes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
3054
+ }, z.core.$strip>;
3055
+ readonly core: typeof createReleaseCore;
3056
+ write: true;
3057
+ connectScopes: readonly ["contents:read", "contents:write", "metadata:read"];
3058
+ };
3059
+ /** Update an existing release — tag, target, title, notes, draft, or prerelease status. Requires approval by default. */
3060
+ updateRelease: {
3061
+ description: string;
3062
+ inputSchema: z.ZodObject<{
3063
+ owner: z.ZodString;
3064
+ repo: z.ZodString;
3065
+ releaseId: z.ZodNumber;
3066
+ tagName: z.ZodOptional<z.ZodString>;
3067
+ target: z.ZodOptional<z.ZodString>;
3068
+ name: z.ZodOptional<z.ZodString>;
3069
+ body: z.ZodOptional<z.ZodString>;
3070
+ draft: z.ZodOptional<z.ZodBoolean>;
3071
+ prerelease: z.ZodOptional<z.ZodBoolean>;
3072
+ }, z.core.$strip>;
3073
+ readonly core: typeof updateReleaseCore;
3074
+ write: true;
3075
+ connectScopes: readonly ["contents:read", "contents:write", "metadata:read"];
3076
+ };
3077
+ /** Delete a release permanently. Requires approval by default. */
3078
+ deleteRelease: {
3079
+ description: string;
3080
+ inputSchema: z.ZodObject<{
3081
+ owner: z.ZodString;
3082
+ repo: z.ZodString;
3083
+ releaseId: z.ZodNumber;
3084
+ }, z.core.$strip>;
3085
+ readonly core: typeof deleteReleaseCore;
3086
+ write: true;
3087
+ connectScopes: readonly ["contents:read", "contents:write", "metadata:read"];
3088
+ };
3089
+ };
3090
+ type GithubToolName = keyof typeof GITHUB_TOOL_CATALOG;
3091
+ /** Tool names whose catalog entry is marked `write: true`. */
3092
+ type GithubWriteToolName = { [K in GithubToolName]: (typeof GITHUB_TOOL_CATALOG)[K] extends {
3093
+ write: true;
3094
+ } ? K : never; }[GithubToolName];
3095
+ //#endregion
3096
+ //#region src/core/tool-names.d.ts
3097
+ /**
3098
+ * All GitHub tool names available via {@link createGithubTools}, keyed by name.
3099
+ * Derived from `GITHUB_TOOL_CATALOG` — the single source of truth for tools.
3100
+ */
3101
+ declare const GITHUB_TOOL_NAMES: { [K in GithubToolName]: K; };
3102
+ //#endregion
3103
+ //#region src/core/presets.d.ts
3104
+ /**
3105
+ * Predefined tool presets for common use cases.
3106
+ * Pass to {@link createGithubTools}, {@link createGithubAgent}, or {@link createDurableGithubAgent}.
3107
+ * Presets can be combined by passing an array.
3108
+ */
3109
+ declare const PRESET_TOOLS: {
3110
+ /**
3111
+ * **Code review** — review pull requests and submit feedback.
3112
+ *
3113
+ * Tools: `getPullRequest`, `listPullRequests`, `listPullRequestFiles`, `listPullRequestReviews`, `listPullRequestReviewThreads`, `getPullRequestContext`,
3114
+ * `getFileContent`, `listCommits`, `getCommit`, `getBlame`, `compareCommits`, `getRepository`, `listBranches`,
3115
+ * `searchCode`, `listCheckRuns`, `getCombinedStatus`, `updatePullRequest`, `addPullRequestComment`, `updatePullRequestComment`,
3116
+ * `deletePullRequestComment`, `createPullRequestReview`, `replyToReviewComment`, `resolveReviewThread`, `requestReviewers`.
3117
+ *
3118
+ * Agent prompt: optimized for thorough PR review with inline feedback.
3119
+ */
3120
+ readonly 'code-review': readonly ["getPullRequest", "listPullRequests", "listPullRequestFiles", "listPullRequestReviews", "listPullRequestReviewThreads", "getPullRequestContext", "getFileContent", "listCommits", "getCommit", "getBlame", "compareCommits", "getRepository", "listBranches", "searchCode", "listCheckRuns", "getCombinedStatus", "updatePullRequest", "addPullRequestComment", "updatePullRequestComment", "deletePullRequestComment", "createPullRequestReview", "replyToReviewComment", "resolveReviewThread", "requestReviewers"];
3121
+ /**
3122
+ * **Issue triage** — manage and organize GitHub issues.
3123
+ *
3124
+ * Tools: `listIssues`, `getIssueContext`, `listIssueComments`, `createIssue`, `addIssueComment`, `updateIssueComment`, `deleteIssueComment`,
3125
+ * `closeIssue`, `updateIssue`, `addLabels`, `removeLabel`, `createLabel`, `updateLabel`, `deleteLabel`,
3126
+ * `addAssignees`, `removeAssignees`,
3127
+ * `listIssueReactions`, `addIssueReaction`, `listCommentReactions`, `addCommentReaction`, `getRepository`,
3128
+ * `searchRepositories`, `searchCode`, `searchIssues`.
3129
+ *
3130
+ * Prefer `getIssueContext` (issue + `labelNames` + recent comments) over separate get/list calls.
3131
+ * Use `listIssueComments` to paginate beyond the comments returned by `getIssueContext`.
3132
+ * Reopen a closed issue with `updateIssue` (`state: 'open'`) — there is no separate reopen tool.
3133
+ * Acknowledge a report with `addIssueReaction` / `addCommentReaction` instead of a comment when no reply is needed.
3134
+ * Agent prompt: optimized for categorizing, labeling, and responding to issues.
3135
+ */
3136
+ readonly 'issue-triage': readonly ["listIssues", "getIssueContext", "listIssueComments", "createIssue", "addIssueComment", "updateIssueComment", "deleteIssueComment", "closeIssue", "updateIssue", "addLabels", "removeLabel", "createLabel", "updateLabel", "deleteLabel", "addAssignees", "removeAssignees", "listIssueReactions", "addIssueReaction", "listCommentReactions", "addCommentReaction", "getRepository", "searchRepositories", "searchCode", "searchIssues"];
3137
+ /**
3138
+ * **CI operations** — monitor and manage GitHub Actions workflows.
3139
+ *
3140
+ * Tools: `getRepository`, `listBranches`, `listCommits`, `getCommit`,
3141
+ * `listWorkflows`, `listWorkflowRuns`, `getWorkflowRun`, `listWorkflowJobs`, `getWorkflowJobLogs`, `listCheckRuns`, `getCombinedStatus`, `getCiFailureContext`,
3142
+ * `triggerWorkflow`, `cancelWorkflowRun`, `rerunWorkflowRun`.
3143
+ *
3144
+ * Diagnose a failure with `getCiFailureContext` first, then read the failing job's output with `getWorkflowJobLogs`.
3145
+ * Agent prompt: optimized for diagnosing CI failures and managing workflow runs.
3146
+ */
3147
+ readonly 'ci-ops': readonly ["getRepository", "listBranches", "listCommits", "getCommit", "listWorkflows", "listWorkflowRuns", "getWorkflowRun", "listWorkflowJobs", "getWorkflowJobLogs", "listCheckRuns", "getCombinedStatus", "getCiFailureContext", "triggerWorkflow", "cancelWorkflowRun", "rerunWorkflowRun"];
3148
+ /**
3149
+ * **Repository explorer** — read-only access to browse codebases.
3150
+ *
3151
+ * Tools: all read-only tools including repos, branches, PRs, issues, discussions, commits, blame, comparisons,
3152
+ * search, gists, workflows, checks, and releases. No write operations.
3153
+ *
3154
+ * Agent prompt: optimized for answering questions about code structure and history.
3155
+ */
3156
+ readonly 'repo-explorer': readonly ["getRepository", "listBranches", "getFileContent", "getRepositoryTree", "listPullRequests", "getPullRequest", "listPullRequestFiles", "listPullRequestReviews", "listPullRequestReviewThreads", "getPullRequestContext", "listIssues", "getIssue", "getIssueContext", "listIssueComments", "listDiscussions", "getDiscussion", "listLabels", "listCommits", "getCommit", "getBlame", "compareCommits", "searchCode", "searchRepositories", "searchIssues", "listGists", "getGist", "listGistComments", "listWorkflows", "listWorkflowRuns", "getWorkflowRun", "listWorkflowJobs", "getWorkflowJobLogs", "listCheckRuns", "getCombinedStatus", "getCiFailureContext", "listReleases", "getLatestRelease", "getRelease", "getReleaseContext"];
3157
+ /**
3158
+ * **Security audit** — review repositories for security risks and report findings.
3159
+ *
3160
+ * Tools: read-only exploration (`getFileContent`, `getRepositoryTree`, `searchCode`, `searchIssues`, `listCommits`, `getCommit`,
3161
+ * `getBlame`, `compareCommits`), PR and CI visibility (`listPullRequests`, `getPullRequest`, `listPullRequestFiles`,
3162
+ * `getPullRequestContext`, `listCheckRuns`, `getCombinedStatus`, `getCiFailureContext`, `listWorkflows`, `listWorkflowRuns`,
3163
+ * `getWorkflowRun`, `listWorkflowJobs`, `getWorkflowJobLogs` — logs can leak secrets, so auditing them matters),
3164
+ * plus `createIssue`, `addIssueComment`, and `addLabels` to report findings.
3165
+ * No destructive writes.
3166
+ *
3167
+ * Agent prompt: optimized for finding and reporting security risks without making changes.
3168
+ */
3169
+ readonly 'security-audit': readonly ["getRepository", "listBranches", "getFileContent", "getRepositoryTree", "listCommits", "getCommit", "getBlame", "compareCommits", "searchCode", "searchRepositories", "searchIssues", "listPullRequests", "getPullRequest", "listPullRequestFiles", "getPullRequestContext", "listCheckRuns", "getCombinedStatus", "getCiFailureContext", "listWorkflows", "listWorkflowRuns", "getWorkflowRun", "listWorkflowJobs", "getWorkflowJobLogs", "listIssues", "getIssue", "getIssueContext", "createIssue", "addIssueComment", "addLabels"];
3170
+ /**
3171
+ * **Release manager** — prepare and publish GitHub releases.
3172
+ *
3173
+ * Tools: `getRepository`, `listBranches`, `listCommits`, `getCommit`, `compareCommits`,
3174
+ * `listReleases`, `getLatestRelease`, `getRelease`, `getReleaseContext`, `createRelease`, `updateRelease`, `deleteRelease`,
3175
+ * `listWorkflows`, `listWorkflowRuns`, `getWorkflowRun`, `listWorkflowJobs`, `triggerWorkflow`,
3176
+ * `listPullRequests`, `getPullRequest`.
3177
+ *
3178
+ * Agent prompt: optimized for summarizing changes and cutting releases safely.
3179
+ */
3180
+ readonly 'release-manager': readonly ["getRepository", "listBranches", "listCommits", "getCommit", "compareCommits", "listReleases", "getLatestRelease", "getRelease", "getReleaseContext", "createRelease", "updateRelease", "deleteRelease", "listWorkflows", "listWorkflowRuns", "getWorkflowRun", "listWorkflowJobs", "triggerWorkflow", "listPullRequests", "getPullRequest"];
3181
+ /**
3182
+ * **Discussion moderator** — answer and moderate repository Discussions.
3183
+ *
3184
+ * Tools: `listDiscussions`, `getDiscussion`, `addDiscussionComment`,
3185
+ * `getRepository`, `searchIssues`, `getIssueContext`, `addIssueComment`.
3186
+ *
3187
+ * Prefer discussions for Q&A; link related issues with `getIssueContext` / `addIssueComment` when needed.
3188
+ * Agent prompt: optimized for clear, on-topic discussion replies.
3189
+ */
3190
+ readonly 'discussion-moderator': readonly ["listDiscussions", "getDiscussion", "addDiscussionComment", "getRepository", "searchIssues", "getIssueContext", "addIssueComment"];
3191
+ /**
3192
+ * **Notification inbox** — triage authenticated-user notification threads.
3193
+ *
3194
+ * Tools: `listNotifications`, `markNotificationRead`, `getIssue`, `getPullRequest`, `getRepository`.
3195
+ *
3196
+ * Requires a user PAT with the Notifications account permission — not available on Connect installation tokens.
3197
+ * Agent prompt: optimized for clearing inbox noise and following up on actionable threads.
3198
+ */
3199
+ readonly 'notification-inbox': readonly ["listNotifications", "markNotificationRead", "getIssue", "getPullRequest", "getRepository"];
3200
+ /**
3201
+ * **PR author** — open pull requests without the full write surface.
3202
+ *
3203
+ * Tools: `getRepository`, `listBranches`, `getFileContent`, `createBranch`, `deleteBranch`, `createOrUpdateFile`,
3204
+ * `createPullRequest`, `updatePullRequest`, `getPullRequest`, `listPullRequestFiles`,
3205
+ * `listPullRequestReviewThreads`, `replyToReviewComment`, `resolveReviewThread`,
3206
+ * `compareCommits`, `getCommit`.
3207
+ *
3208
+ * Respond to review feedback with `listPullRequestReviewThreads` → `replyToReviewComment` → `resolveReviewThread`.
3209
+ * Agent prompt: optimized for branching, editing files, and opening focused PRs.
3210
+ */
3211
+ readonly 'pr-author': readonly ["getRepository", "listBranches", "getFileContent", "createBranch", "deleteBranch", "createOrUpdateFile", "createPullRequest", "updatePullRequest", "getPullRequest", "listPullRequestFiles", "listPullRequestReviewThreads", "replyToReviewComment", "resolveReviewThread", "compareCommits", "getCommit"];
3212
+ /**
3213
+ * **Maintainer** — full repository maintenance with all read and write tools.
3214
+ *
3215
+ * Tools: all tools (same as omitting `preset`).
3216
+ *
3217
+ * Agent prompt: optimized for day-to-day repo maintenance with careful write operations.
3218
+ */
3219
+ readonly maintainer: readonly ["getRepository", "listBranches", "getFileContent", "getRepositoryTree", "createBranch", "deleteBranch", "forkRepository", "createRepository", "createOrUpdateFile", "listPullRequests", "getPullRequest", "listPullRequestFiles", "listPullRequestReviews", "listPullRequestReviewThreads", "getPullRequestContext", "createPullRequest", "mergePullRequest", "updatePullRequest", "addPullRequestComment", "updatePullRequestComment", "deletePullRequestComment", "createPullRequestReview", "replyToReviewComment", "resolveReviewThread", "requestReviewers", "listIssues", "getIssue", "getIssueContext", "listIssueComments", "createIssue", "addIssueComment", "updateIssueComment", "deleteIssueComment", "closeIssue", "updateIssue", "listLabels", "addLabels", "removeLabel", "createLabel", "updateLabel", "deleteLabel", "addAssignees", "removeAssignees", "listIssueReactions", "addIssueReaction", "listCommentReactions", "addCommentReaction", "listDiscussions", "getDiscussion", "addDiscussionComment", "listNotifications", "markNotificationRead", "listCommits", "getCommit", "getBlame", "compareCommits", "searchCode", "searchRepositories", "searchIssues", "listGists", "getGist", "listGistComments", "createGist", "updateGist", "deleteGist", "createGistComment", "listWorkflows", "listWorkflowRuns", "getWorkflowRun", "listWorkflowJobs", "getWorkflowJobLogs", "triggerWorkflow", "cancelWorkflowRun", "rerunWorkflowRun", "listCheckRuns", "getCombinedStatus", "getCiFailureContext", "listReleases", "getLatestRelease", "getRelease", "getReleaseContext", "createRelease", "updateRelease", "deleteRelease"];
3220
+ };
3221
+ type GithubToolPreset = keyof typeof PRESET_TOOLS;
3222
+ /** Tool names included in a single preset. */
3223
+ type PresetToolName<P extends GithubToolPreset> = Extract<(typeof PRESET_TOOLS)[P][number], GithubToolName>;
3224
+ /** Tool names included when combining multiple presets. */
3225
+ type CombinedPresetToolNames<P extends readonly GithubToolPreset[]> = PresetToolName<P[number]>;
3226
+ //#endregion
3227
+ //#region src/core/write-tools.d.ts
3228
+ /**
3229
+ * GitHub tools that perform write operations and require approval by default.
3230
+ * Derived from the `write: true` entries of `GITHUB_TOOL_CATALOG`.
3231
+ */
3232
+ declare const GITHUB_WRITE_TOOLS: { [K in GithubWriteToolName]: K; };
3233
+ //#endregion
3234
+ //#region src/core/approval.d.ts
3235
+ /**
3236
+ * Whether write operations require user approval.
3237
+ *
3238
+ * - `true` — all write tools need approval (default)
3239
+ * - `false` — no approval needed for any write tool
3240
+ * - object — per-tool override via {@link GithubWriteToolName}; unspecified write tools default to `true`
3241
+ *
3242
+ * @example Global disable
3243
+ * ```ts
3244
+ * createGithubTools({ token, requireApproval: false })
3245
+ * ```
3246
+ *
3247
+ * @example Granular per write tool
3248
+ * ```ts
3249
+ * createGithubTools({
3250
+ * token,
3251
+ * requireApproval: {
3252
+ * mergePullRequest: true,
3253
+ * createOrUpdateFile: true,
3254
+ * addPullRequestComment: false,
3255
+ * },
3256
+ * })
3257
+ * ```
3258
+ */
3259
+ type ApprovalConfig = boolean | Partial<Record<GithubWriteToolName, boolean>>;
3260
+ //#endregion
3261
+ //#region src/core/context.d.ts
3262
+ /**
3263
+ * Default repository / issue / PR / ref values applied to tool inputs and
3264
+ * injected into agent system prompts.
3265
+ *
3266
+ * When a field is set here, matching tool schema fields become optional and
3267
+ * default to this value if the model omits them.
3268
+ */
3269
+ type GithubToolsContext = {
3270
+ owner?: string;
3271
+ repo?: string;
3272
+ pullNumber?: number;
3273
+ issueNumber?: number;
3274
+ ref?: string;
3275
+ };
3276
+ //#endregion
3277
+ //#region src/core/token.d.ts
3278
+ type GithubTokenInput = string | (() => Promise<string>);
3279
+ /** Resolves a {@link GithubTokenInput} to a token string. */
3280
+ declare function resolveGithubToken(token?: GithubTokenInput): Promise<string>;
3281
+ //#endregion
3282
+ //#region src/core/tool-types.d.ts
3283
+ /** Full tool set returned when no `preset` is specified. */
3284
+ type AllGithubTools = Record<GithubToolName, GithubTool>;
3285
+ /** Base options shared by all {@link createGithubTools} overloads. */
3286
+ type GithubToolsBaseOptions = {
3287
+ /** GitHub token string or async provider. Falls back to `process.env.GITHUB_TOKEN` when omitted. */
3288
+ token?: GithubTokenInput;
3289
+ /** Control whether write operations require user approval. @see {@link ApprovalConfig} */
3290
+ requireApproval?: ApprovalConfig;
3291
+ /**
3292
+ * Default owner / repo / PR / issue / ref values.
3293
+ * Softens matching tool input fields and fills them when the model omits them.
3294
+ * Also injected into agent system prompts via {@link createGithubAgent}.
3295
+ */
3296
+ context?: GithubToolsContext;
3297
+ /** Per-tool overrides for description, title, needsApproval, and related AI SDK tool fields. */
3298
+ overrides?: Partial<Record<GithubToolName, ToolOverrides>>;
3299
+ /** Default author for commit-creating tools. Falls back to the authenticated user when omitted. */
3300
+ author?: CommitIdentity;
3301
+ /** Default committer for commit-creating tools. Falls back to the authenticated user when omitted. */
3302
+ committer?: CommitIdentity;
3303
+ /** Co-authors to attribute on all commits created by tools. */
3304
+ coAuthors?: CommitIdentity[];
3305
+ };
3306
+ /** Tool set shape for a given preset option (single, combined, or all tools). */
3307
+ type GithubToolsForPreset<P extends GithubToolPreset | readonly GithubToolPreset[] | undefined> = P extends GithubToolPreset ? Pick<AllGithubTools, PresetToolName<P> & GithubToolName> : P extends readonly GithubToolPreset[] ? Pick<AllGithubTools, CombinedPresetToolNames<P> & GithubToolName> : AllGithubTools;
3308
+ /** Pick a subset of GitHub tools by tool name. */
3309
+ type PickGithubTools<T extends GithubToolName> = Pick<AllGithubTools, T>;
3310
+ //#endregion
3311
+ export { ToolOverrides as S, CommitIdentity as _, GithubTokenInput as a, Octokit$1 as b, ApprovalConfig as c, GithubToolPreset as d, PRESET_TOOLS as f, GithubWriteToolName as g, GithubToolName as h, PickGithubTools as i, GITHUB_WRITE_TOOLS as l, GITHUB_TOOL_NAMES as m, GithubToolsBaseOptions as n, resolveGithubToken as o, PresetToolName as p, GithubToolsForPreset as r, GithubToolsContext as s, AllGithubTools as t, CombinedPresetToolNames as u, CommitToolOptions as v, ToolOptions as x, GithubTool as y };
3312
+ //# sourceMappingURL=tool-types-DbZpOYFG.d.mts.map