@github-tools/sdk 1.18.0 → 1.20.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 (60) hide show
  1. package/README.md +60 -26
  2. package/dist/approval-policy--kByBqhT.mjs +17 -0
  3. package/dist/approval-policy--kByBqhT.mjs.map +1 -0
  4. package/dist/connect/eve.d.mts +2 -2
  5. package/dist/connect/eve.d.mts.map +1 -1
  6. package/dist/connect/eve.mjs +1 -1
  7. package/dist/connect.d.mts +15 -24
  8. package/dist/connect.d.mts.map +1 -1
  9. package/dist/connect.mjs +2 -2
  10. package/dist/{cores-BeLZwcde.mjs → cores-FLzAv2tu.mjs} +23 -2
  11. package/dist/cores-FLzAv2tu.mjs.map +1 -0
  12. package/dist/evaluation-BtoHbxuQ.mjs +311 -0
  13. package/dist/evaluation-BtoHbxuQ.mjs.map +1 -0
  14. package/dist/{eve-runtime-DnhM9Vog.mjs → eve-runtime-C-0doyHq.mjs} +14 -8
  15. package/dist/eve-runtime-C-0doyHq.mjs.map +1 -0
  16. package/dist/{eve-runtime-DNQrQZ36.d.mts → eve-runtime-CflZNuXD.d.mts} +6 -6
  17. package/dist/eve-runtime-CflZNuXD.d.mts.map +1 -0
  18. package/dist/eve-runtime.d.mts +5 -5
  19. package/dist/eve-runtime.mjs +4 -4
  20. package/dist/eve.d.mts +53 -4
  21. package/dist/eve.d.mts.map +1 -1
  22. package/dist/eve.mjs +52 -3
  23. package/dist/eve.mjs.map +1 -1
  24. package/dist/{index-DkZvveZP.d.mts → index-C3wlz660.d.mts} +91 -347
  25. package/dist/index-C3wlz660.d.mts.map +1 -0
  26. package/dist/index.d.mts +3 -3
  27. package/dist/index.mjs +4 -3
  28. package/dist/{src-Bx5p1Unc.mjs → src-DyiAVHKl.mjs} +338 -15
  29. package/dist/src-DyiAVHKl.mjs.map +1 -0
  30. package/dist/tanstack.d.mts +1213 -55
  31. package/dist/tanstack.d.mts.map +1 -1
  32. package/dist/tanstack.mjs +26 -13
  33. package/dist/tanstack.mjs.map +1 -1
  34. package/dist/{token-BOLrrbTS.mjs → token-DIwB-wtp.mjs} +37 -117
  35. package/dist/token-DIwB-wtp.mjs.map +1 -0
  36. package/dist/{tool-types-CrC80SIL.d.mts → tool-types-OFyE3z0C.d.mts} +283 -54
  37. package/dist/tool-types-OFyE3z0C.d.mts.map +1 -0
  38. package/dist/{types-BmwOpI5-.d.mts → types-CJqhvQwi.d.mts} +3 -3
  39. package/dist/{types-BmwOpI5-.d.mts.map → types-CJqhvQwi.d.mts.map} +1 -1
  40. package/dist/{types-CPAsEMzx.d.mts → types-ITYfXMtY.d.mts} +2 -2
  41. package/dist/{types-CPAsEMzx.d.mts.map → types-ITYfXMtY.d.mts.map} +1 -1
  42. package/dist/workflow.d.mts +34 -40
  43. package/dist/workflow.d.mts.map +1 -1
  44. package/dist/workflow.mjs +17 -46
  45. package/dist/workflow.mjs.map +1 -1
  46. package/dist/{write-tools-BaoTUCg7.mjs → write-tools-DnGZw-RD.mjs} +941 -112
  47. package/dist/write-tools-DnGZw-RD.mjs.map +1 -0
  48. package/package.json +10 -12
  49. package/dist/cores-BeLZwcde.mjs.map +0 -1
  50. package/dist/evaluation-f-2QwBid.mjs +0 -210
  51. package/dist/evaluation-f-2QwBid.mjs.map +0 -1
  52. package/dist/eve-runtime-DNQrQZ36.d.mts.map +0 -1
  53. package/dist/eve-runtime-DnhM9Vog.mjs.map +0 -1
  54. package/dist/index-DkZvveZP.d.mts.map +0 -1
  55. package/dist/instructions-BuypoY0x.mjs +0 -148
  56. package/dist/instructions-BuypoY0x.mjs.map +0 -1
  57. package/dist/src-Bx5p1Unc.mjs.map +0 -1
  58. package/dist/token-BOLrrbTS.mjs.map +0 -1
  59. package/dist/tool-types-CrC80SIL.d.mts.map +0 -1
  60. package/dist/write-tools-BaoTUCg7.mjs.map +0 -1
@@ -1,8 +1,9 @@
1
- import { Bt as createRepositoryCore, Gt as getRepositoryTreeCore, Ht as forkRepositoryCore, Jt as PagedList, Kt as listBranchesCore, Rt as createBranchCore, Ut as getFileContentCore, Vt as deleteBranchCore, Wt as getRepositoryCore, Xt as __exportAll, qt as repository_d_exports, zt as createOrUpdateFileCore } from "./index-DkZvveZP.mjs";
2
- import { A as GITHUB_TOOL_CATALOG, C as GithubTokenInput, D as PRESET_TOOLS, E as GithubToolPreset, M as GithubWriteToolName, O as PresetToolName, S as GithubTokenCall, a as GithubToolsContext, b as AUTO_APPROVAL_TOOLS, f as ApprovalConfig, j as GithubToolName, k as GITHUB_TOOL_NAMES, m as ToolApprovalMode, o as CommitIdentity, x as DEFAULT_EVALUATION_MODEL, y as GITHUB_WRITE_TOOLS } from "./tool-types-CrC80SIL.mjs";
1
+ import { A as GithubTokenCall, B as GithubToolName, D as AUTO_APPROVAL_TOOLS, E as GITHUB_WRITE_TOOLS, F as GithubToolPreset, I as PRESET_TOOLS, L as PresetToolName, O as DEFAULT_EVALUATION_MODEL, R as GITHUB_TOOL_NAMES, V as GithubWriteToolName, a as GithubToolsContext, f as ApprovalConfig, j as GithubTokenInput, k as RoutablePreset, l as Octokit, m as ToolApprovalMode, o as CommitIdentity, z as GITHUB_TOOL_CATALOG } from "./tool-types-OFyE3z0C.mjs";
2
+ import "./index-C3wlz660.mjs";
3
3
  import { t as githubToolApproval } from "./interrupts-BSDPwdJ2.mjs";
4
4
  import { z } from "zod";
5
- import { AnyTextAdapter, ChatMiddleware, ChatStream, EvaluateAdapter, ServerTool, Tool, chat } from "@tanstack/ai";
5
+ import { AnyTextAdapter, ChatMiddleware, ChatStream, EvaluateAdapter, ModelMessage, ServerTool, Tool, chat } from "@tanstack/ai";
6
+ //#endregion
6
7
  //#region src/core/detail.d.ts
7
8
  type DetailLevel = 'summary' | 'full';
8
9
  declare namespace bundles_d_exports {
@@ -17,13 +18,14 @@ declare const getPullRequestContextInputSchema: z.ZodObject<{
17
18
  includeChecks: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
18
19
  includePatch: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
19
20
  filesPerPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
21
+ includeLinkedIssues: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
20
22
  detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
21
23
  summary: "summary";
22
24
  full: "full";
23
25
  }>>>;
24
26
  }, z.core.$strip>;
25
- declare const getPullRequestContextDescription = "Fetch pull request details plus files, reviews, and optional CI checks in one call — prefer this over separate getPullRequest / listPullRequestFiles / listPullRequestReviews calls. filesHasMore / reviewsHasMore mean more pages exist on those lists.";
26
- declare function getPullRequestContextCore({ token, owner, repo, pullNumber, includeFiles, includeReviews, includeChecks, includePatch, filesPerPage, detail }: {
27
+ declare const getPullRequestContextDescription = "Fetch pull request details plus files, reviews, and optional CI checks and linked issues in one call — prefer this over separate getPullRequest / listPullRequestFiles / listPullRequestReviews calls. filesHasMore / reviewsHasMore mean more pages exist on those lists.";
28
+ declare function getPullRequestContextCore({ token, owner, repo, pullNumber, includeFiles, includeReviews, includeChecks, includePatch, filesPerPage, includeLinkedIssues, detail }: {
27
29
  token: string;
28
30
  owner: string;
29
31
  repo: string;
@@ -33,8 +35,16 @@ declare function getPullRequestContextCore({ token, owner, repo, pullNumber, inc
33
35
  includeChecks: boolean;
34
36
  includePatch: boolean;
35
37
  filesPerPage: number;
38
+ includeLinkedIssues: boolean;
36
39
  detail?: DetailLevel;
37
40
  }): Promise<{
41
+ linkedIssues?: {
42
+ repository: string;
43
+ number: number;
44
+ title: string;
45
+ state: string;
46
+ url: string;
47
+ }[] | undefined;
38
48
  checks?: {
39
49
  checkRuns: {
40
50
  hasMore: boolean;
@@ -94,6 +104,11 @@ declare function getPullRequestContextCore({ token, owner, repo, pullNumber, inc
94
104
  draft: boolean | undefined;
95
105
  merged: boolean;
96
106
  mergeable: boolean | null;
107
+ mergeableState: string;
108
+ autoMerge: {
109
+ mergeMethod: "merge" | "squash" | "rebase";
110
+ enabledBy: string;
111
+ } | null;
97
112
  additions: number;
98
113
  deletions: number;
99
114
  changedFiles: number;
@@ -154,6 +169,8 @@ declare const getReleaseContextInputSchema: z.ZodObject<{
154
169
  owner: z.ZodString;
155
170
  repo: z.ZodString;
156
171
  releaseId: z.ZodOptional<z.ZodNumber>;
172
+ tag: z.ZodOptional<z.ZodString>;
173
+ previousTag: z.ZodOptional<z.ZodString>;
157
174
  includePrevious: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
158
175
  includeCompare: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
159
176
  detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
@@ -161,12 +178,14 @@ declare const getReleaseContextInputSchema: z.ZodObject<{
161
178
  full: "full";
162
179
  }>>>;
163
180
  }, z.core.$strip>;
164
- declare const getReleaseContextDescription = "Fetch a release (latest or by ID) plus the previous release and tag comparison in one call — prefer this when preparing or reviewing a release";
165
- declare function getReleaseContextCore({ token, owner, repo, releaseId, includePrevious, includeCompare, detail }: {
181
+ declare const getReleaseContextDescription = "Fetch a release (latest, by ID, or by tag) plus the release before it and the comparison between their tags in one call — prefer this when preparing or reviewing a release";
182
+ declare function getReleaseContextCore({ token, owner, repo, releaseId, tag, previousTag, includePrevious, includeCompare, detail }: {
166
183
  token: string;
167
184
  owner: string;
168
185
  repo: string;
169
186
  releaseId?: number;
187
+ tag?: string;
188
+ previousTag?: string;
170
189
  includePrevious: boolean;
171
190
  includeCompare: boolean;
172
191
  detail?: DetailLevel;
@@ -202,6 +221,23 @@ declare function getReleaseContextCore({ token, owner, repo, releaseId, includeP
202
221
  author: string;
203
222
  createdAt: string;
204
223
  publishedAt: string | null;
224
+ } | {
225
+ id: number;
226
+ tagName: string;
227
+ name: string | null;
228
+ body: string | null | undefined;
229
+ draft: boolean;
230
+ prerelease: boolean;
231
+ url: string;
232
+ author: string;
233
+ createdAt: string;
234
+ publishedAt: string | null;
235
+ assets: {
236
+ name: string;
237
+ downloadUrl: string;
238
+ size: number;
239
+ downloadCount: number;
240
+ }[];
205
241
  } | undefined;
206
242
  release: {
207
243
  id: number;
@@ -223,19 +259,57 @@ declare function getReleaseContextCore({ token, owner, repo, releaseId, includeP
223
259
  declare const getCiFailureContextInputSchema: z.ZodObject<{
224
260
  owner: z.ZodString;
225
261
  repo: z.ZodString;
226
- ref: z.ZodString;
262
+ ref: z.ZodOptional<z.ZodString>;
263
+ runId: z.ZodOptional<z.ZodNumber>;
227
264
  maxFailedRuns: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
228
265
  maxFailedJobs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
266
+ logLines: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
229
267
  }, z.core.$strip>;
230
- declare const getCiFailureContextDescription = "Diagnose CI failures for a ref in one call — combined status, failing check runs, recent failed workflow runs, and failed jobs/steps from the latest failure";
231
- declare function getCiFailureContextCore({ token, owner, repo, ref, maxFailedRuns, maxFailedJobs }: {
268
+ declare const getCiFailureContextDescription = "Diagnose CI failures in one call, for a ref or one workflow run: failing checks and statuses (for a ref), recent failed runs, failed jobs and steps, and the end of each failed job's log";
269
+ declare function getCiFailureContextCore({ token, owner, repo, ref, runId, maxFailedRuns, maxFailedJobs, logLines }: {
232
270
  token: string;
233
271
  owner: string;
234
272
  repo: string;
235
- ref: string;
273
+ ref?: string;
274
+ runId?: number;
236
275
  maxFailedRuns: number;
237
276
  maxFailedJobs: number;
277
+ logLines: number;
238
278
  }): Promise<{
279
+ run: {
280
+ id: number;
281
+ name: string | null | undefined;
282
+ status: string | null;
283
+ conclusion: string | null;
284
+ branch: string | null;
285
+ sha: string;
286
+ event: string;
287
+ url: string;
288
+ actor: string | undefined;
289
+ runNumber: number;
290
+ runAttempt: number | undefined;
291
+ createdAt: string;
292
+ updatedAt: string;
293
+ runStartedAt: string | undefined;
294
+ };
295
+ failedJobs: {
296
+ id: number;
297
+ name: string;
298
+ status: "completed" | "in_progress" | "queued" | "requested" | "waiting" | "pending";
299
+ conclusion: "success" | "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "timed_out" | null;
300
+ url: string | null;
301
+ startedAt: string;
302
+ completedAt: string | null;
303
+ steps: {
304
+ name: string;
305
+ status: "completed" | "in_progress" | "queued";
306
+ conclusion: string | null;
307
+ number: number;
308
+ startedAt: string | null | undefined;
309
+ completedAt: string | null | undefined;
310
+ }[] | undefined;
311
+ }[];
312
+ } | {
239
313
  latestFailure?: {
240
314
  run: {
241
315
  id: number;
@@ -251,23 +325,23 @@ declare function getCiFailureContextCore({ token, owner, repo, ref, maxFailedRun
251
325
  runNumber: number;
252
326
  runAttempt: number | undefined;
253
327
  };
254
- jobs: Array<{
328
+ jobs: {
255
329
  id: number;
256
330
  name: string;
257
- status: string;
258
- conclusion: string | null;
331
+ status: "completed" | "in_progress" | "queued" | "requested" | "waiting" | "pending";
332
+ conclusion: "success" | "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "timed_out" | null;
259
333
  url: string | null;
260
334
  startedAt: string;
261
335
  completedAt: string | null;
262
- steps?: Array<{
336
+ steps: {
263
337
  name: string;
264
- status: string;
338
+ status: "completed" | "in_progress" | "queued";
265
339
  conclusion: string | null;
266
340
  number: number;
267
- startedAt?: string | null;
268
- completedAt?: string | null;
269
- }>;
270
- }>;
341
+ startedAt: string | null | undefined;
342
+ completedAt: string | null | undefined;
343
+ }[] | undefined;
344
+ }[];
271
345
  } | undefined;
272
346
  ref: string;
273
347
  combinedStatus: {
@@ -362,6 +436,17 @@ declare function getCombinedStatusCore({ token, owner, repo, ref }: {
362
436
  url: string | null;
363
437
  }[];
364
438
  }>;
439
+ //#endregion
440
+ //#region src/core/pagination.d.ts
441
+ type PagingFields = {
442
+ hasMore: boolean;
443
+ page: number;
444
+ perPage: number;
445
+ nextPage?: number;
446
+ };
447
+ type PagedList<T> = {
448
+ items: T[];
449
+ } & PagingFields;
365
450
  declare namespace commits_d_exports {
366
451
  export { BLAME_QUERY, compareCommitsCore, compareCommitsDescription, compareCommitsInputSchema, getBlameCore, getBlameDescription, getBlameInputSchema, getCommitCore, getCommitDescription, getCommitInputSchema, listCommitsCore, listCommitsDescription, listCommitsInputSchema };
367
452
  }
@@ -1212,7 +1297,7 @@ declare function markNotificationReadCore({ token, threadId }: {
1212
1297
  threadId: string;
1213
1298
  }>;
1214
1299
  declare namespace pull_requests_d_exports {
1215
- export { addPullRequestCommentCore, addPullRequestCommentDescription, addPullRequestCommentInputSchema, createPullRequestCore, createPullRequestDescription, createPullRequestInputSchema, createPullRequestReviewCore, createPullRequestReviewDescription, createPullRequestReviewInputSchema, deletePullRequestCommentCore, deletePullRequestCommentDescription, deletePullRequestCommentInputSchema, getPullRequestCore, getPullRequestDescription, getPullRequestInputSchema, listPullRequestFilesCore, listPullRequestFilesDescription, listPullRequestFilesInputSchema, listPullRequestReviewThreadsCore, listPullRequestReviewThreadsDescription, listPullRequestReviewThreadsInputSchema, listPullRequestReviewsCore, listPullRequestReviewsDescription, listPullRequestReviewsInputSchema, listPullRequestsCore, listPullRequestsDescription, listPullRequestsInputSchema, mergePullRequestCore, mergePullRequestDescription, mergePullRequestInputSchema, replyToReviewCommentCore, replyToReviewCommentDescription, replyToReviewCommentInputSchema, requestReviewersCore, requestReviewersDescription, requestReviewersInputSchema, resolveReviewThreadCore, resolveReviewThreadDescription, resolveReviewThreadInputSchema, updatePullRequestCommentCore, updatePullRequestCommentDescription, updatePullRequestCommentInputSchema, updatePullRequestCore, updatePullRequestDescription, updatePullRequestInputSchema };
1300
+ export { addPullRequestCommentCore, addPullRequestCommentDescription, addPullRequestCommentInputSchema, createPullRequestCore, createPullRequestDescription, createPullRequestInputSchema, createPullRequestReviewCore, createPullRequestReviewDescription, createPullRequestReviewInputSchema, deletePullRequestCommentCore, deletePullRequestCommentDescription, deletePullRequestCommentInputSchema, disablePullRequestAutoMergeCore, disablePullRequestAutoMergeDescription, disablePullRequestAutoMergeInputSchema, enablePullRequestAutoMergeCore, enablePullRequestAutoMergeDescription, enablePullRequestAutoMergeInputSchema, getPullRequestCore, getPullRequestDescription, getPullRequestInputSchema, listPullRequestFilesCore, listPullRequestFilesDescription, listPullRequestFilesInputSchema, listPullRequestReviewThreadsCore, listPullRequestReviewThreadsDescription, listPullRequestReviewThreadsInputSchema, listPullRequestReviewsCore, listPullRequestReviewsDescription, listPullRequestReviewsInputSchema, listPullRequestsCore, listPullRequestsDescription, listPullRequestsInputSchema, mergePullRequestCore, mergePullRequestDescription, mergePullRequestInputSchema, replyToReviewCommentCore, replyToReviewCommentDescription, replyToReviewCommentInputSchema, requestReviewersCore, requestReviewersDescription, requestReviewersInputSchema, resolveReviewThreadCore, resolveReviewThreadDescription, resolveReviewThreadInputSchema, updatePullRequestCommentCore, updatePullRequestCommentDescription, updatePullRequestCommentInputSchema, updatePullRequestCore, updatePullRequestDescription, updatePullRequestInputSchema };
1216
1301
  }
1217
1302
  declare const listPullRequestsInputSchema: z.ZodObject<{
1218
1303
  owner: z.ZodString;
@@ -1276,6 +1361,11 @@ declare function getPullRequestCore({ token, owner, repo, pullNumber, detail }:
1276
1361
  draft: boolean | undefined;
1277
1362
  merged: boolean;
1278
1363
  mergeable: boolean | null;
1364
+ mergeableState: string;
1365
+ autoMerge: {
1366
+ mergeMethod: "merge" | "squash" | "rebase";
1367
+ enabledBy: string;
1368
+ } | null;
1279
1369
  additions: number;
1280
1370
  deletions: number;
1281
1371
  changedFiles: number;
@@ -1499,9 +1589,14 @@ declare const createPullRequestReviewInputSchema: z.ZodObject<{
1499
1589
  LEFT: "LEFT";
1500
1590
  RIGHT: "RIGHT";
1501
1591
  }>>;
1592
+ startLine: z.ZodOptional<z.ZodNumber>;
1593
+ startSide: z.ZodOptional<z.ZodEnum<{
1594
+ LEFT: "LEFT";
1595
+ RIGHT: "RIGHT";
1596
+ }>>;
1502
1597
  }, z.core.$strip>>>;
1503
1598
  }, z.core.$strip>;
1504
- declare const createPullRequestReviewDescription = "Submit a pull request review — approve, request changes, or comment with optional inline comments on specific lines";
1599
+ declare const createPullRequestReviewDescription = "Submit a pull request review — approve, request changes, or comment with optional inline comments on a line or a range of lines, including suggested changes the author can apply";
1505
1600
  /** Not idempotent — each call submits a new review. */
1506
1601
  declare function createPullRequestReviewCore({ token, owner, repo, pullNumber, body, event, comments }: {
1507
1602
  token: string;
@@ -1515,6 +1610,8 @@ declare function createPullRequestReviewCore({ token, owner, repo, pullNumber, b
1515
1610
  body: string;
1516
1611
  line?: number;
1517
1612
  side?: 'LEFT' | 'RIGHT';
1613
+ startLine?: number;
1614
+ startSide?: 'LEFT' | 'RIGHT';
1518
1615
  }>;
1519
1616
  }): Promise<{
1520
1617
  id: number;
@@ -1640,6 +1737,54 @@ declare function requestReviewersCore({ token, owner, repo, pullNumber, reviewer
1640
1737
  requestedReviewers: string[] | undefined;
1641
1738
  requestedTeams: string[] | undefined;
1642
1739
  }>;
1740
+ declare const enablePullRequestAutoMergeInputSchema: z.ZodObject<{
1741
+ owner: z.ZodString;
1742
+ repo: z.ZodString;
1743
+ pullNumber: z.ZodNumber;
1744
+ mergeMethod: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
1745
+ merge: "merge";
1746
+ squash: "squash";
1747
+ rebase: "rebase";
1748
+ }>>>;
1749
+ commitTitle: z.ZodOptional<z.ZodString>;
1750
+ commitMessage: z.ZodOptional<z.ZodString>;
1751
+ }, z.core.$strip>;
1752
+ declare const enablePullRequestAutoMergeDescription = "Merge a pull request automatically once its required checks and reviews pass. The repository must allow auto-merge; a pull request that can already merge needs mergePullRequest instead";
1753
+ /** Idempotent: enabling auto-merge again replaces the pending request with the same settings. */
1754
+ declare function enablePullRequestAutoMergeCore({ token, owner, repo, pullNumber, mergeMethod, commitTitle, commitMessage, coAuthors }: {
1755
+ token: string;
1756
+ owner: string;
1757
+ repo: string;
1758
+ pullNumber: number;
1759
+ mergeMethod: 'merge' | 'squash' | 'rebase';
1760
+ commitTitle?: string;
1761
+ commitMessage?: string;
1762
+ coAuthors?: CommitIdentity[];
1763
+ }): Promise<{
1764
+ number: number;
1765
+ url: string;
1766
+ autoMerge: {
1767
+ enabledAt: string;
1768
+ mergeMethod: string;
1769
+ } | null;
1770
+ }>;
1771
+ declare const disablePullRequestAutoMergeInputSchema: z.ZodObject<{
1772
+ owner: z.ZodString;
1773
+ repo: z.ZodString;
1774
+ pullNumber: z.ZodNumber;
1775
+ }, z.core.$strip>;
1776
+ declare const disablePullRequestAutoMergeDescription = "Cancel a pending auto-merge, so the pull request stays open when its checks pass";
1777
+ /** Idempotent: a pull request without auto-merge stays without it. */
1778
+ declare function disablePullRequestAutoMergeCore({ token, owner, repo, pullNumber }: {
1779
+ token: string;
1780
+ owner: string;
1781
+ repo: string;
1782
+ pullNumber: number;
1783
+ }): Promise<{
1784
+ number: number;
1785
+ url: string;
1786
+ autoMerge: null;
1787
+ }>;
1643
1788
  declare namespace reactions_d_exports {
1644
1789
  export { ReactionContent, addCommentReactionCore, addCommentReactionDescription, addCommentReactionInputSchema, addIssueReactionCore, addIssueReactionDescription, addIssueReactionInputSchema, listCommentReactionsCore, listCommentReactionsDescription, listCommentReactionsInputSchema, listIssueReactionsCore, listIssueReactionsDescription, listIssueReactionsInputSchema };
1645
1790
  }
@@ -1847,18 +1992,20 @@ declare function getLatestReleaseCore({ token, owner, repo, detail }: {
1847
1992
  declare const getReleaseInputSchema: z.ZodObject<{
1848
1993
  owner: z.ZodString;
1849
1994
  repo: z.ZodString;
1850
- releaseId: z.ZodNumber;
1995
+ releaseId: z.ZodOptional<z.ZodNumber>;
1996
+ tag: z.ZodOptional<z.ZodString>;
1851
1997
  detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
1852
1998
  summary: "summary";
1853
1999
  full: "full";
1854
2000
  }>>>;
1855
2001
  }, z.core.$strip>;
1856
- declare const getReleaseDescription = "Get a specific release by ID, including its assets. Body truncated by default (detail: summary)";
1857
- declare function getReleaseCore({ token, owner, repo, releaseId, detail }: {
2002
+ declare const getReleaseDescription = "Get a specific release by ID or tag, including its assets. Body truncated by default (detail: summary)";
2003
+ declare function getReleaseCore({ token, owner, repo, releaseId, tag, detail }: {
1858
2004
  token: string;
1859
2005
  owner: string;
1860
2006
  repo: string;
1861
- releaseId: number;
2007
+ releaseId?: number;
2008
+ tag?: string;
1862
2009
  detail?: DetailLevel;
1863
2010
  }): Promise<{
1864
2011
  id: number;
@@ -1937,30 +2084,613 @@ declare function updateReleaseCore({ token, owner, repo, releaseId, tagName, tar
1937
2084
  draft?: boolean;
1938
2085
  prerelease?: boolean;
1939
2086
  }): Promise<{
1940
- id: number;
1941
- tagName: string;
1942
- name: string | null;
1943
- body: string | null | undefined;
1944
- url: string;
1945
- draft: boolean;
1946
- prerelease: boolean;
1947
- publishedAt: string | null;
2087
+ id: number;
2088
+ tagName: string;
2089
+ name: string | null;
2090
+ body: string | null | undefined;
2091
+ url: string;
2092
+ draft: boolean;
2093
+ prerelease: boolean;
2094
+ publishedAt: string | null;
2095
+ }>;
2096
+ declare const deleteReleaseInputSchema: z.ZodObject<{
2097
+ owner: z.ZodString;
2098
+ repo: z.ZodString;
2099
+ releaseId: z.ZodNumber;
2100
+ }, z.core.$strip>;
2101
+ declare const deleteReleaseDescription = "Delete a release permanently (does not delete the underlying git tag)";
2102
+ /** Not idempotent — deleting an already-deleted release returns 404 from GitHub. */
2103
+ declare function deleteReleaseCore({ token, owner, repo, releaseId }: {
2104
+ token: string;
2105
+ owner: string;
2106
+ repo: string;
2107
+ releaseId: number;
2108
+ }): Promise<{
2109
+ deleted: boolean;
2110
+ releaseId: number;
2111
+ }>;
2112
+ declare namespace security_d_exports {
2113
+ export { listCodeScanningAlertsCore, listCodeScanningAlertsDescription, listCodeScanningAlertsInputSchema, listDependabotAlertsCore, listDependabotAlertsDescription, listDependabotAlertsInputSchema, listSecretScanningAlertsCore, listSecretScanningAlertsDescription, listSecretScanningAlertsInputSchema };
2114
+ }
2115
+ declare const listCodeScanningAlertsInputSchema: z.ZodObject<{
2116
+ owner: z.ZodString;
2117
+ repo: z.ZodString;
2118
+ state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2119
+ open: "open";
2120
+ dismissed: "dismissed";
2121
+ fixed: "fixed";
2122
+ }>>>;
2123
+ severity: z.ZodOptional<z.ZodEnum<{
2124
+ error: "error";
2125
+ critical: "critical";
2126
+ high: "high";
2127
+ medium: "medium";
2128
+ low: "low";
2129
+ warning: "warning";
2130
+ note: "note";
2131
+ }>>;
2132
+ ref: z.ZodOptional<z.ZodString>;
2133
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2134
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2135
+ maxPages: z.ZodOptional<z.ZodNumber>;
2136
+ }, z.core.$strip>;
2137
+ declare const listCodeScanningAlertsDescription = "List code scanning alerts (CodeQL and other analysis tools) for a repository, newest first, with the rule, its severity, and the file and line of the latest instance. Needs code scanning set up on the repository. When hasMore, pass nextPage.";
2138
+ declare function listCodeScanningAlertsCore({ token, owner, repo, state, severity, ref, perPage, page, maxPages }: {
2139
+ token: string;
2140
+ owner: string;
2141
+ repo: string;
2142
+ state: 'open' | 'dismissed' | 'fixed';
2143
+ severity?: 'critical' | 'high' | 'medium' | 'low' | 'warning' | 'note' | 'error';
2144
+ ref?: string;
2145
+ perPage: number;
2146
+ page?: number;
2147
+ maxPages?: number;
2148
+ }): Promise<PagedList<{
2149
+ number: number;
2150
+ state: "open" | "dismissed" | "fixed" | null;
2151
+ severity: "error" | "critical" | "high" | "medium" | "low" | "warning" | "note" | "none" | null | undefined;
2152
+ rule: {
2153
+ id: string | null | undefined;
2154
+ description: string | undefined;
2155
+ };
2156
+ tool: string | undefined;
2157
+ path: string | undefined;
2158
+ line: number | undefined;
2159
+ url: string;
2160
+ createdAt: string;
2161
+ dismissedReason: "false positive" | "won't fix" | "used in tests" | null;
2162
+ }>>;
2163
+ declare const listDependabotAlertsInputSchema: z.ZodObject<{
2164
+ owner: z.ZodString;
2165
+ repo: z.ZodString;
2166
+ state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2167
+ open: "open";
2168
+ dismissed: "dismissed";
2169
+ fixed: "fixed";
2170
+ auto_dismissed: "auto_dismissed";
2171
+ }>>>;
2172
+ severity: z.ZodOptional<z.ZodEnum<{
2173
+ critical: "critical";
2174
+ high: "high";
2175
+ medium: "medium";
2176
+ low: "low";
2177
+ }>>;
2178
+ ecosystem: z.ZodOptional<z.ZodString>;
2179
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2180
+ after: z.ZodOptional<z.ZodString>;
2181
+ }, z.core.$strip>;
2182
+ declare const listDependabotAlertsDescription = "List Dependabot alerts for vulnerable dependencies, newest first, with the package, the advisory (GHSA and CVE IDs, severity, summary), the vulnerable range and the first patched version. When hasMore, pass nextCursor as after.";
2183
+ declare function listDependabotAlertsCore({ token, owner, repo, state, severity, ecosystem, perPage, after }: {
2184
+ token: string;
2185
+ owner: string;
2186
+ repo: string;
2187
+ state: 'open' | 'fixed' | 'dismissed' | 'auto_dismissed';
2188
+ severity?: 'critical' | 'high' | 'medium' | 'low';
2189
+ ecosystem?: string;
2190
+ perPage: number;
2191
+ after?: string;
2192
+ }): Promise<{
2193
+ nextCursor?: string | undefined;
2194
+ items: {
2195
+ number: number;
2196
+ state: "open" | "dismissed" | "fixed" | "auto_dismissed";
2197
+ severity: "critical" | "high" | "medium" | "low";
2198
+ package: string | undefined;
2199
+ ecosystem: string | undefined;
2200
+ manifestPath: string | undefined;
2201
+ scope: "development" | "runtime" | null | undefined;
2202
+ advisory: {
2203
+ ghsaId: string;
2204
+ cveId: string | null;
2205
+ summary: string;
2206
+ };
2207
+ vulnerableVersionRange: string;
2208
+ firstPatchedVersion: string | undefined;
2209
+ url: string;
2210
+ createdAt: string;
2211
+ }[];
2212
+ hasMore: boolean;
2213
+ perPage: number;
2214
+ }>;
2215
+ declare const listSecretScanningAlertsInputSchema: z.ZodObject<{
2216
+ owner: z.ZodString;
2217
+ repo: z.ZodString;
2218
+ state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2219
+ open: "open";
2220
+ resolved: "resolved";
2221
+ }>>>;
2222
+ secretType: z.ZodOptional<z.ZodString>;
2223
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2224
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2225
+ maxPages: z.ZodOptional<z.ZodNumber>;
2226
+ }, z.core.$strip>;
2227
+ declare const listSecretScanningAlertsDescription = "List secret scanning alerts for credentials committed to a repository, newest first, with the secret type, whether the secret is still valid, and whether push protection was bypassed. The secret itself is never returned. When hasMore, pass nextPage.";
2228
+ declare function listSecretScanningAlertsCore({ token, owner, repo, state, secretType, perPage, page, maxPages }: {
2229
+ token: string;
2230
+ owner: string;
2231
+ repo: string;
2232
+ state: 'open' | 'resolved';
2233
+ secretType?: string;
2234
+ perPage: number;
2235
+ page?: number;
2236
+ maxPages?: number;
2237
+ }): Promise<PagedList<{
2238
+ number: number | undefined;
2239
+ state: "open" | "resolved" | undefined;
2240
+ secretType: string | undefined;
2241
+ secretTypeDisplayName: string | undefined;
2242
+ validity: "unknown" | "active" | "inactive" | undefined;
2243
+ pushProtectionBypassed: boolean | null | undefined;
2244
+ resolution: "false_positive" | "wont_fix" | "revoked" | "used_in_tests" | null | undefined;
2245
+ url: string | undefined;
2246
+ createdAt: string | undefined;
2247
+ }>>;
2248
+ declare namespace repository_d_exports {
2249
+ export { composeCommitMessage, createBranchCore, createBranchDescription, createBranchInputSchema, createCommitOnBranch, createOrUpdateFileCore, createOrUpdateFileDescription, createOrUpdateFileInputSchema, createRepositoryCore, createRepositoryDescription, createRepositoryInputSchema, deleteBranchCore, deleteBranchDescription, deleteBranchInputSchema, editFilesCore, editFilesDescription, editFilesInputSchema, forkRepositoryCore, forkRepositoryDescription, forkRepositoryInputSchema, getBranchRulesCore, getBranchRulesDescription, getBranchRulesInputSchema, getFileContentCore, getFileContentDescription, getFileContentInputSchema, getRepositoryCore, getRepositoryDescription, getRepositoryInputSchema, getRepositoryTreeCore, getRepositoryTreeDescription, getRepositoryTreeInputSchema, listBranchesCore, listBranchesDescription, listBranchesInputSchema };
2250
+ }
2251
+ declare function createCommitOnBranch(octokit: Octokit, input: {
2252
+ owner: string;
2253
+ repo: string;
2254
+ branch: string;
2255
+ expectedHeadOid: string;
2256
+ headline: string;
2257
+ body?: string;
2258
+ additions?: Array<{
2259
+ path: string;
2260
+ contents: string;
2261
+ }>;
2262
+ deletions?: Array<{
2263
+ path: string;
2264
+ }>;
2265
+ }): Promise<{
2266
+ commitSha: string;
2267
+ commitUrl: string;
2268
+ }>;
2269
+ declare function composeCommitMessage(message: string, coAuthors?: CommitIdentity[]): string;
2270
+ declare const getRepositoryInputSchema: z.ZodObject<{
2271
+ owner: z.ZodString;
2272
+ repo: z.ZodString;
2273
+ }, z.core.$strip>;
2274
+ declare const getRepositoryDescription = "Get information about a GitHub repository including description, stars, forks, language, and default branch";
2275
+ declare function getRepositoryCore({ token, owner, repo }: {
2276
+ token: string;
2277
+ owner: string;
2278
+ repo: string;
2279
+ }): Promise<{
2280
+ name: string;
2281
+ fullName: string;
2282
+ description: string | null;
2283
+ url: string;
2284
+ defaultBranch: string;
2285
+ stars: number;
2286
+ forks: number;
2287
+ openIssues: number;
2288
+ language: string | null;
2289
+ private: boolean;
2290
+ createdAt: string;
2291
+ updatedAt: string;
2292
+ }>;
2293
+ declare const listBranchesInputSchema: z.ZodObject<{
2294
+ owner: z.ZodString;
2295
+ repo: z.ZodString;
2296
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2297
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2298
+ }, z.core.$strip>;
2299
+ declare const listBranchesDescription = "List branches in a GitHub repository. When hasMore, pass nextPage — do not repeat the same call.";
2300
+ declare function listBranchesCore({ token, owner, repo, perPage, page }: {
2301
+ token: string;
2302
+ owner: string;
2303
+ repo: string;
2304
+ perPage: number;
2305
+ page?: number;
2306
+ }): Promise<PagedList<{
2307
+ name: string;
2308
+ sha: string;
2309
+ protected: boolean;
2310
+ }>>;
2311
+ declare const getFileContentInputSchema: z.ZodObject<{
2312
+ owner: z.ZodString;
2313
+ repo: z.ZodString;
2314
+ path: z.ZodString;
2315
+ ref: z.ZodOptional<z.ZodString>;
2316
+ startLine: z.ZodOptional<z.ZodNumber>;
2317
+ endLine: z.ZodOptional<z.ZodNumber>;
2318
+ maxLines: z.ZodOptional<z.ZodNumber>;
2319
+ }, z.core.$strip>;
2320
+ declare const getFileContentDescription = "Get the content of a file from a GitHub repository. Prefer startLine/endLine or maxLines to read only the lines you need";
2321
+ declare function getFileContentCore({ token, owner, repo, path, ref, startLine, endLine, maxLines }: {
2322
+ token: string;
2323
+ owner: string;
2324
+ repo: string;
2325
+ path: string;
2326
+ ref?: string;
2327
+ startLine?: number;
2328
+ endLine?: number;
2329
+ maxLines?: number;
2330
+ }): Promise<{
2331
+ type: "directory";
2332
+ entries: {
2333
+ name: string;
2334
+ type: "file" | "dir" | "submodule" | "symlink";
2335
+ path: string;
2336
+ }[];
2337
+ path?: undefined;
2338
+ sha?: undefined;
2339
+ size?: undefined;
2340
+ totalLines?: undefined;
2341
+ content?: undefined;
2342
+ startLine?: undefined;
2343
+ endLine?: undefined;
2344
+ truncated?: undefined;
2345
+ } | {
2346
+ type: "submodule" | "symlink";
2347
+ path: string;
2348
+ entries?: undefined;
2349
+ sha?: undefined;
2350
+ size?: undefined;
2351
+ totalLines?: undefined;
2352
+ content?: undefined;
2353
+ startLine?: undefined;
2354
+ endLine?: undefined;
2355
+ truncated?: undefined;
2356
+ } | {
2357
+ type: "file";
2358
+ path: string;
2359
+ sha: string;
2360
+ size: number;
2361
+ totalLines: number;
2362
+ content: string;
2363
+ entries?: undefined;
2364
+ startLine?: undefined;
2365
+ endLine?: undefined;
2366
+ truncated?: undefined;
2367
+ } | {
2368
+ type: "file";
2369
+ path: string;
2370
+ sha: string;
2371
+ size: number;
2372
+ totalLines: number;
2373
+ startLine: number;
2374
+ endLine: number;
2375
+ truncated: boolean;
2376
+ content: string;
2377
+ entries?: undefined;
2378
+ }>;
2379
+ declare const getRepositoryTreeInputSchema: z.ZodObject<{
2380
+ owner: z.ZodString;
2381
+ repo: z.ZodString;
2382
+ ref: z.ZodOptional<z.ZodString>;
2383
+ path: z.ZodOptional<z.ZodString>;
2384
+ recursive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2385
+ }, z.core.$strip>;
2386
+ declare const getRepositoryTreeDescription = "List the file and directory structure of a repository at a given ref. Prefer a path prefix over recursive true. If truncated, narrow path instead of recalling the full tree.";
2387
+ declare function getRepositoryTreeCore({ token, owner, repo, ref, path, recursive }: {
2388
+ token: string;
2389
+ owner: string;
2390
+ repo: string;
2391
+ ref?: string;
2392
+ path?: string;
2393
+ recursive: boolean;
2394
+ }): Promise<{
2395
+ sha: string;
2396
+ truncated: boolean;
2397
+ path: string | undefined;
2398
+ entries: {
2399
+ path: string;
2400
+ type: string;
2401
+ size: number | undefined;
2402
+ sha: string;
2403
+ }[];
2404
+ }>;
2405
+ declare const createBranchInputSchema: z.ZodObject<{
2406
+ owner: z.ZodString;
2407
+ repo: z.ZodString;
2408
+ branch: z.ZodString;
2409
+ from: z.ZodOptional<z.ZodString>;
2410
+ }, z.core.$strip>;
2411
+ declare const createBranchDescription = "Create a new branch in a GitHub repository from an existing branch or commit SHA";
2412
+ /** Idempotent when the branch already exists at the target SHA. Not idempotent otherwise. */
2413
+ declare function createBranchCore({ token, owner, repo, branch, from }: {
2414
+ token: string;
2415
+ owner: string;
2416
+ repo: string;
2417
+ branch: string;
2418
+ from?: string;
2419
+ }): Promise<{
2420
+ ref: string;
2421
+ sha: string;
2422
+ url: string;
2423
+ }>;
2424
+ declare const deleteBranchInputSchema: z.ZodObject<{
2425
+ owner: z.ZodString;
2426
+ repo: z.ZodString;
2427
+ branch: z.ZodString;
2428
+ }, z.core.$strip>;
2429
+ declare const deleteBranchDescription = "Delete a branch from a GitHub repository permanently";
2430
+ /** Not idempotent — deleting a branch that no longer exists fails with a 422. */
2431
+ declare function deleteBranchCore({ token, owner, repo, branch }: {
2432
+ token: string;
2433
+ owner: string;
2434
+ repo: string;
2435
+ branch: string;
2436
+ }): Promise<{
2437
+ deleted: boolean;
2438
+ branch: string;
2439
+ }>;
2440
+ declare const forkRepositoryInputSchema: z.ZodObject<{
2441
+ owner: z.ZodString;
2442
+ repo: z.ZodString;
2443
+ organization: z.ZodOptional<z.ZodString>;
2444
+ name: z.ZodOptional<z.ZodString>;
2445
+ }, z.core.$strip>;
2446
+ declare const forkRepositoryDescription = "Fork a GitHub repository to the authenticated user account or a specified organization";
2447
+ /** Not idempotent — each call may create another fork attempt. */
2448
+ declare function forkRepositoryCore({ token, owner, repo, organization, name }: {
2449
+ token: string;
2450
+ owner: string;
2451
+ repo: string;
2452
+ organization?: string;
2453
+ name?: string;
2454
+ }): Promise<{
2455
+ name: string;
2456
+ fullName: string;
2457
+ url: string;
2458
+ cloneUrl: string;
2459
+ sshUrl: string;
2460
+ defaultBranch: string;
2461
+ private: boolean;
2462
+ parent: {
2463
+ fullName: string;
2464
+ url: string;
2465
+ } | null;
2466
+ }>;
2467
+ declare const createRepositoryInputSchema: z.ZodObject<{
2468
+ name: z.ZodString;
2469
+ description: z.ZodOptional<z.ZodString>;
2470
+ isPrivate: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2471
+ autoInit: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2472
+ gitignoreTemplate: z.ZodOptional<z.ZodString>;
2473
+ licenseTemplate: z.ZodOptional<z.ZodString>;
2474
+ org: z.ZodOptional<z.ZodString>;
2475
+ }, z.core.$strip>;
2476
+ declare const createRepositoryDescription = "Create a new GitHub repository for the authenticated user or a specified organization";
2477
+ /** Not idempotent — each call creates a new repository. */
2478
+ declare function createRepositoryCore({ token, name, description, isPrivate, autoInit, gitignoreTemplate, licenseTemplate, org }: {
2479
+ token: string;
2480
+ name: string;
2481
+ description?: string;
2482
+ isPrivate: boolean;
2483
+ autoInit: boolean;
2484
+ gitignoreTemplate?: string;
2485
+ licenseTemplate?: string;
2486
+ org?: string;
2487
+ }): Promise<{
2488
+ name: string;
2489
+ fullName: string;
2490
+ description: string | null;
2491
+ url: string;
2492
+ cloneUrl: string;
2493
+ sshUrl: string;
2494
+ defaultBranch: string;
2495
+ private: boolean;
2496
+ createdAt: string;
2497
+ }>;
2498
+ declare const createOrUpdateFileInputSchema: z.ZodObject<{
2499
+ owner: z.ZodString;
2500
+ repo: z.ZodString;
2501
+ path: z.ZodString;
2502
+ message: z.ZodString;
2503
+ content: z.ZodString;
2504
+ branch: z.ZodOptional<z.ZodString>;
2505
+ sha: z.ZodOptional<z.ZodString>;
2506
+ }, z.core.$strip>;
2507
+ declare const createOrUpdateFileDescription = "Create or update a file in a GitHub repository. Provide the SHA when updating an existing file.";
2508
+ /** Idempotent when updating with sha and content is unchanged. Not idempotent for new commits. */
2509
+ declare function createOrUpdateFileCore({ token, owner, repo, path, message, content, branch, sha, author, committer, coAuthors }: {
2510
+ token: string;
2511
+ owner: string;
2512
+ repo: string;
2513
+ path: string;
2514
+ message: string;
2515
+ content: string;
2516
+ branch?: string;
2517
+ sha?: string;
2518
+ author?: CommitIdentity;
2519
+ committer?: CommitIdentity;
2520
+ coAuthors?: CommitIdentity[];
2521
+ }): Promise<{
2522
+ path: string;
2523
+ sha: string;
2524
+ skipped: true;
2525
+ message: string;
2526
+ commitSha?: undefined;
2527
+ commitUrl?: undefined;
2528
+ } | {
2529
+ path: string | undefined;
2530
+ sha: string | undefined;
2531
+ commitSha: string | undefined;
2532
+ commitUrl: string | undefined;
2533
+ skipped?: undefined;
2534
+ message?: undefined;
2535
+ }>;
2536
+ declare const editFilesInputSchema: z.ZodObject<{
2537
+ owner: z.ZodString;
2538
+ repo: z.ZodString;
2539
+ branch: z.ZodString;
2540
+ baseBranch: z.ZodOptional<z.ZodString>;
2541
+ message: z.ZodString;
2542
+ edits: z.ZodArray<z.ZodObject<{
2543
+ path: z.ZodString;
2544
+ find: z.ZodOptional<z.ZodString>;
2545
+ replace: z.ZodOptional<z.ZodString>;
2546
+ content: z.ZodOptional<z.ZodString>;
2547
+ }, z.core.$strip>>;
2548
+ pullRequest: z.ZodOptional<z.ZodObject<{
2549
+ title: z.ZodString;
2550
+ body: z.ZodOptional<z.ZodString>;
2551
+ draft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2552
+ }, z.core.$strip>>;
2553
+ }, z.core.$strip>;
2554
+ declare const editFilesDescription = "Edit files and commit them in one call: replace exact text in a file without reading or resending the whole file, or write whole files, on a new or existing branch, and optionally open a pull request. Prefer this over createBranch + createOrUpdateFile + createPullRequest.";
2555
+ /** Not idempotent: each call makes a new commit. */
2556
+ declare function editFilesCore({ token, owner, repo, branch, baseBranch, message, edits, pullRequest, author, committer, coAuthors }: {
2557
+ token: string;
2558
+ owner: string;
2559
+ repo: string;
2560
+ branch: string;
2561
+ baseBranch?: string;
2562
+ message: string;
2563
+ edits: Array<{
2564
+ path: string;
2565
+ find?: string;
2566
+ replace?: string;
2567
+ content?: string;
2568
+ }>;
2569
+ pullRequest?: {
2570
+ title: string;
2571
+ body?: string;
2572
+ draft: boolean;
2573
+ };
2574
+ author?: CommitIdentity;
2575
+ committer?: CommitIdentity;
2576
+ coAuthors?: CommitIdentity[];
2577
+ }): Promise<{
2578
+ pullRequest?: {
2579
+ number: number;
2580
+ title: string;
2581
+ url: string;
2582
+ draft: boolean | undefined;
2583
+ existing: boolean;
2584
+ } | undefined;
2585
+ branch: string;
2586
+ baseBranch: string;
2587
+ createdBranch: boolean;
2588
+ files: {
2589
+ path: string;
2590
+ replacements: number;
2591
+ }[];
2592
+ commits: {
2593
+ sha?: string;
2594
+ url?: string;
2595
+ }[];
1948
2596
  }>;
1949
- declare const deleteReleaseInputSchema: z.ZodObject<{
2597
+ declare const getBranchRulesInputSchema: z.ZodObject<{
1950
2598
  owner: z.ZodString;
1951
2599
  repo: z.ZodString;
1952
- releaseId: z.ZodNumber;
2600
+ branch: z.ZodString;
1953
2601
  }, z.core.$strip>;
1954
- declare const deleteReleaseDescription = "Delete a release permanently (does not delete the underlying git tag)";
1955
- /** Not idempotent — deleting an already-deleted release returns 404 from GitHub. */
1956
- declare function deleteReleaseCore({ token, owner, repo, releaseId }: {
2602
+ declare const getBranchRulesDescription = "List what protects a branch: required status checks, required reviews, and the other ruleset and branch-protection rules. Use it to explain why a pull request cannot merge yet";
2603
+ declare function getBranchRulesCore({ token, owner, repo, branch }: {
1957
2604
  token: string;
1958
2605
  owner: string;
1959
2606
  repo: string;
1960
- releaseId: number;
2607
+ branch: string;
1961
2608
  }): Promise<{
1962
- deleted: boolean;
1963
- releaseId: number;
2609
+ branch: string;
2610
+ protected: boolean;
2611
+ requiredStatusChecks: string[];
2612
+ rules: {
2613
+ source?: string | undefined;
2614
+ parameters?: {
2615
+ update_allows_fetch_and_merge: boolean;
2616
+ } | {
2617
+ check_response_timeout_minutes: number;
2618
+ grouping_strategy: "ALLGREEN" | "HEADGREEN";
2619
+ max_entries_to_build: number;
2620
+ max_entries_to_merge: number;
2621
+ merge_method: "MERGE" | "SQUASH" | "REBASE";
2622
+ min_entries_to_merge: number;
2623
+ min_entries_to_merge_wait_minutes: number;
2624
+ } | {
2625
+ required_deployment_environments: string[];
2626
+ } | {
2627
+ allowed_merge_methods?: ("merge" | "squash" | "rebase")[];
2628
+ automatic_copilot_code_review_enabled?: boolean;
2629
+ dismiss_stale_reviews_on_push: boolean;
2630
+ require_code_owner_review: boolean;
2631
+ require_last_push_approval: boolean;
2632
+ required_approving_review_count: number;
2633
+ required_review_thread_resolution: boolean;
2634
+ } | {
2635
+ do_not_enforce_on_create?: boolean;
2636
+ required_status_checks: {
2637
+ context: string;
2638
+ integration_id?: number;
2639
+ }[];
2640
+ strict_required_status_checks_policy: boolean;
2641
+ } | {
2642
+ name?: string;
2643
+ negate?: boolean;
2644
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
2645
+ pattern: string;
2646
+ } | {
2647
+ name?: string;
2648
+ negate?: boolean;
2649
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
2650
+ pattern: string;
2651
+ } | {
2652
+ name?: string;
2653
+ negate?: boolean;
2654
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
2655
+ pattern: string;
2656
+ } | {
2657
+ name?: string;
2658
+ negate?: boolean;
2659
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
2660
+ pattern: string;
2661
+ } | {
2662
+ name?: string;
2663
+ negate?: boolean;
2664
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
2665
+ pattern: string;
2666
+ } | {
2667
+ restricted_file_paths: string[];
2668
+ } | {
2669
+ max_file_path_length: number;
2670
+ } | {
2671
+ restricted_file_extensions: string[];
2672
+ } | {
2673
+ max_file_size: number;
2674
+ } | {
2675
+ do_not_enforce_on_create?: boolean;
2676
+ workflows: {
2677
+ path: string;
2678
+ ref?: string;
2679
+ repository_id: number;
2680
+ sha?: string;
2681
+ }[];
2682
+ } | {
2683
+ code_scanning_tools: {
2684
+ alerts_threshold: "none" | "errors" | "errors_and_warnings" | "all";
2685
+ security_alerts_threshold: "none" | "critical" | "high_or_higher" | "medium_or_higher" | "all";
2686
+ tool: string;
2687
+ }[];
2688
+ } | {
2689
+ review_draft_pull_requests?: boolean;
2690
+ review_on_push?: boolean;
2691
+ } | undefined;
2692
+ type: "creation" | "update" | "deletion" | "required_linear_history" | "merge_queue" | "required_deployments" | "required_signatures" | "pull_request" | "required_status_checks" | "non_fast_forward" | "commit_message_pattern" | "commit_author_email_pattern" | "committer_email_pattern" | "branch_name_pattern" | "tag_name_pattern" | "file_path_restriction" | "max_file_path_length" | "file_extension_restriction" | "max_file_size" | "workflows" | "code_scanning" | "copilot_code_review";
2693
+ }[];
1964
2694
  }>;
1965
2695
  declare namespace search_d_exports {
1966
2696
  export { searchCodeCore, searchCodeDescription, searchCodeInputSchema, searchIssuesCore, searchIssuesDescription, searchIssuesInputSchema, searchRepositoriesCore, searchRepositoriesDescription, searchRepositoriesInputSchema };
@@ -2330,10 +3060,14 @@ declare const GITHUB_TOOL_CORES: {
2330
3060
  readonly forkRepository: typeof forkRepositoryCore;
2331
3061
  readonly createRepository: typeof createRepositoryCore;
2332
3062
  readonly createOrUpdateFile: typeof createOrUpdateFileCore;
3063
+ readonly editFiles: typeof editFilesCore;
3064
+ readonly getBranchRules: typeof getBranchRulesCore;
2333
3065
  readonly listPullRequests: typeof listPullRequestsCore;
2334
3066
  readonly getPullRequest: typeof getPullRequestCore;
2335
3067
  readonly createPullRequest: typeof createPullRequestCore;
2336
3068
  readonly mergePullRequest: typeof mergePullRequestCore;
3069
+ readonly enablePullRequestAutoMerge: typeof enablePullRequestAutoMergeCore;
3070
+ readonly disablePullRequestAutoMerge: typeof disablePullRequestAutoMergeCore;
2337
3071
  readonly updatePullRequest: typeof updatePullRequestCore;
2338
3072
  readonly addPullRequestComment: typeof addPullRequestCommentCore;
2339
3073
  readonly updatePullRequestComment: typeof updatePullRequestCommentCore;
@@ -2405,6 +3139,9 @@ declare const GITHUB_TOOL_CORES: {
2405
3139
  readonly createRelease: typeof createReleaseCore;
2406
3140
  readonly updateRelease: typeof updateReleaseCore;
2407
3141
  readonly deleteRelease: typeof deleteReleaseCore;
3142
+ readonly listCodeScanningAlerts: typeof listCodeScanningAlertsCore;
3143
+ readonly listDependabotAlerts: typeof listDependabotAlertsCore;
3144
+ readonly listSecretScanningAlerts: typeof listSecretScanningAlertsCore;
2408
3145
  };
2409
3146
  //#endregion
2410
3147
  //#region src/tanstack/tools.d.ts
@@ -2452,6 +3189,7 @@ type GithubEvaluationOptions = {
2452
3189
  /** Maximum number of combined presets. @default 2 */
2453
3190
  maxPresets?: number;
2454
3191
  };
3192
+ export declare function selectPresets(messages: readonly ModelMessage[], options?: GithubEvaluationOptions, signal?: AbortSignal): Promise<RoutablePreset[]>;
2455
3193
  //#endregion
2456
3194
  //#region src/tanstack/agent.d.ts
2457
3195
  type NativeOptions<A extends AnyTextAdapter> = Parameters<typeof chat<A, undefined, true>>[0];
@@ -2755,6 +3493,63 @@ export declare const createOrUpdateFile: (token: GithubTokenInput, options?: Tan
2755
3493
  message?: undefined;
2756
3494
  }>;
2757
3495
  };
3496
+ /** Create the TanStack `editFiles` server tool. */
3497
+ export declare const editFiles: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
3498
+ owner: import("zod").ZodString;
3499
+ repo: import("zod").ZodString;
3500
+ branch: import("zod").ZodString;
3501
+ baseBranch: import("zod").ZodOptional<import("zod").ZodString>;
3502
+ message: import("zod").ZodString;
3503
+ edits: import("zod").ZodArray<import("zod").ZodObject<{
3504
+ path: import("zod").ZodString;
3505
+ find: import("zod").ZodOptional<import("zod").ZodString>;
3506
+ replace: import("zod").ZodOptional<import("zod").ZodString>;
3507
+ content: import("zod").ZodOptional<import("zod").ZodString>;
3508
+ }, import("zod/v4/core").$strip>>;
3509
+ pullRequest: import("zod").ZodOptional<import("zod").ZodObject<{
3510
+ title: import("zod").ZodString;
3511
+ body: import("zod").ZodOptional<import("zod").ZodString>;
3512
+ draft: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
3513
+ }, import("zod/v4/core").$strip>>;
3514
+ }, import("zod/v4/core").$strip>, undefined, "editFiles", unknown, boolean, undefined>, "execute"> & {
3515
+ execute: (input: {
3516
+ owner: string;
3517
+ repo: string;
3518
+ branch: string;
3519
+ message: string;
3520
+ edits: {
3521
+ path: string;
3522
+ find?: string | undefined;
3523
+ replace?: string | undefined;
3524
+ content?: string | undefined;
3525
+ }[];
3526
+ baseBranch?: string | undefined;
3527
+ pullRequest?: {
3528
+ title: string;
3529
+ body?: string | undefined;
3530
+ draft?: boolean | undefined;
3531
+ } | undefined;
3532
+ }) => Promise<{
3533
+ pullRequest?: {
3534
+ number: number;
3535
+ title: string;
3536
+ url: string;
3537
+ draft: boolean | undefined;
3538
+ existing: boolean;
3539
+ } | undefined;
3540
+ branch: string;
3541
+ baseBranch: string;
3542
+ createdBranch: boolean;
3543
+ files: {
3544
+ path: string;
3545
+ replacements: number;
3546
+ }[];
3547
+ commits: {
3548
+ sha?: string;
3549
+ url?: string;
3550
+ }[];
3551
+ }>;
3552
+ };
2758
3553
  /** Create the TanStack `listPullRequests` server tool. */
2759
3554
  export declare const listPullRequests: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
2760
3555
  owner: import("zod").ZodString;
@@ -2816,6 +3611,11 @@ export declare const getPullRequest: (token: GithubTokenInput, options?: Tanstac
2816
3611
  draft: boolean | undefined;
2817
3612
  merged: boolean;
2818
3613
  mergeable: boolean | null;
3614
+ mergeableState: string;
3615
+ autoMerge: {
3616
+ mergeMethod: "merge" | "squash" | "rebase";
3617
+ enabledBy: string;
3618
+ } | null;
2819
3619
  additions: number;
2820
3620
  deletions: number;
2821
3621
  changedFiles: number;
@@ -2878,6 +3678,149 @@ export declare const mergePullRequest: (token: GithubTokenInput, options?: Tanst
2878
3678
  sha: string;
2879
3679
  }>;
2880
3680
  };
3681
+ /** Create the TanStack `enablePullRequestAutoMerge` server tool. */
3682
+ export declare const enablePullRequestAutoMerge: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
3683
+ owner: import("zod").ZodString;
3684
+ repo: import("zod").ZodString;
3685
+ pullNumber: import("zod").ZodNumber;
3686
+ mergeMethod: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
3687
+ merge: "merge";
3688
+ squash: "squash";
3689
+ rebase: "rebase";
3690
+ }>>>;
3691
+ commitTitle: import("zod").ZodOptional<import("zod").ZodString>;
3692
+ commitMessage: import("zod").ZodOptional<import("zod").ZodString>;
3693
+ }, import("zod/v4/core").$strip>, undefined, "enablePullRequestAutoMerge", unknown, boolean, undefined>, "execute"> & {
3694
+ execute: (input: {
3695
+ owner: string;
3696
+ repo: string;
3697
+ pullNumber: number;
3698
+ mergeMethod?: "merge" | "squash" | "rebase" | undefined;
3699
+ commitTitle?: string | undefined;
3700
+ commitMessage?: string | undefined;
3701
+ }) => Promise<{
3702
+ number: number;
3703
+ url: string;
3704
+ autoMerge: {
3705
+ enabledAt: string;
3706
+ mergeMethod: string;
3707
+ } | null;
3708
+ }>;
3709
+ };
3710
+ /** Create the TanStack `disablePullRequestAutoMerge` server tool. */
3711
+ export declare const disablePullRequestAutoMerge: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
3712
+ owner: import("zod").ZodString;
3713
+ repo: import("zod").ZodString;
3714
+ pullNumber: import("zod").ZodNumber;
3715
+ }, import("zod/v4/core").$strip>, undefined, "disablePullRequestAutoMerge", unknown, boolean, undefined>, "execute"> & {
3716
+ execute: (input: {
3717
+ owner: string;
3718
+ repo: string;
3719
+ pullNumber: number;
3720
+ }) => Promise<{
3721
+ number: number;
3722
+ url: string;
3723
+ autoMerge: null;
3724
+ }>;
3725
+ };
3726
+ /** Create the TanStack `getBranchRules` server tool. */
3727
+ export declare const getBranchRules: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
3728
+ owner: import("zod").ZodString;
3729
+ repo: import("zod").ZodString;
3730
+ branch: import("zod").ZodString;
3731
+ }, import("zod/v4/core").$strip>, undefined, "getBranchRules", unknown, boolean, undefined>, "execute"> & {
3732
+ execute: (input: {
3733
+ owner: string;
3734
+ repo: string;
3735
+ branch: string;
3736
+ }) => Promise<{
3737
+ branch: string;
3738
+ protected: boolean;
3739
+ requiredStatusChecks: string[];
3740
+ rules: {
3741
+ source?: string | undefined;
3742
+ parameters?: {
3743
+ update_allows_fetch_and_merge: boolean;
3744
+ } | {
3745
+ check_response_timeout_minutes: number;
3746
+ grouping_strategy: "ALLGREEN" | "HEADGREEN";
3747
+ max_entries_to_build: number;
3748
+ max_entries_to_merge: number;
3749
+ merge_method: "MERGE" | "SQUASH" | "REBASE";
3750
+ min_entries_to_merge: number;
3751
+ min_entries_to_merge_wait_minutes: number;
3752
+ } | {
3753
+ required_deployment_environments: string[];
3754
+ } | {
3755
+ allowed_merge_methods?: ("merge" | "squash" | "rebase")[];
3756
+ automatic_copilot_code_review_enabled?: boolean;
3757
+ dismiss_stale_reviews_on_push: boolean;
3758
+ require_code_owner_review: boolean;
3759
+ require_last_push_approval: boolean;
3760
+ required_approving_review_count: number;
3761
+ required_review_thread_resolution: boolean;
3762
+ } | {
3763
+ do_not_enforce_on_create?: boolean;
3764
+ required_status_checks: {
3765
+ context: string;
3766
+ integration_id?: number;
3767
+ }[];
3768
+ strict_required_status_checks_policy: boolean;
3769
+ } | {
3770
+ name?: string;
3771
+ negate?: boolean;
3772
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
3773
+ pattern: string;
3774
+ } | {
3775
+ name?: string;
3776
+ negate?: boolean;
3777
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
3778
+ pattern: string;
3779
+ } | {
3780
+ name?: string;
3781
+ negate?: boolean;
3782
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
3783
+ pattern: string;
3784
+ } | {
3785
+ name?: string;
3786
+ negate?: boolean;
3787
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
3788
+ pattern: string;
3789
+ } | {
3790
+ name?: string;
3791
+ negate?: boolean;
3792
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
3793
+ pattern: string;
3794
+ } | {
3795
+ restricted_file_paths: string[];
3796
+ } | {
3797
+ max_file_path_length: number;
3798
+ } | {
3799
+ restricted_file_extensions: string[];
3800
+ } | {
3801
+ max_file_size: number;
3802
+ } | {
3803
+ do_not_enforce_on_create?: boolean;
3804
+ workflows: {
3805
+ path: string;
3806
+ ref?: string;
3807
+ repository_id: number;
3808
+ sha?: string;
3809
+ }[];
3810
+ } | {
3811
+ code_scanning_tools: {
3812
+ alerts_threshold: "none" | "errors" | "errors_and_warnings" | "all";
3813
+ security_alerts_threshold: "none" | "critical" | "high_or_higher" | "medium_or_higher" | "all";
3814
+ tool: string;
3815
+ }[];
3816
+ } | {
3817
+ review_draft_pull_requests?: boolean;
3818
+ review_on_push?: boolean;
3819
+ } | undefined;
3820
+ type: "creation" | "update" | "deletion" | "required_linear_history" | "merge_queue" | "required_deployments" | "required_signatures" | "pull_request" | "required_status_checks" | "non_fast_forward" | "commit_message_pattern" | "commit_author_email_pattern" | "committer_email_pattern" | "branch_name_pattern" | "tag_name_pattern" | "file_path_restriction" | "max_file_path_length" | "file_extension_restriction" | "max_file_size" | "workflows" | "code_scanning" | "copilot_code_review";
3821
+ }[];
3822
+ }>;
3823
+ };
2881
3824
  /** Create the TanStack `updatePullRequest` server tool. */
2882
3825
  export declare const updatePullRequest: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
2883
3826
  owner: import("zod").ZodString;
@@ -3034,6 +3977,11 @@ export declare const createPullRequestReview: (token: GithubTokenInput, options?
3034
3977
  LEFT: "LEFT";
3035
3978
  RIGHT: "RIGHT";
3036
3979
  }>>;
3980
+ startLine: import("zod").ZodOptional<import("zod").ZodNumber>;
3981
+ startSide: import("zod").ZodOptional<import("zod").ZodEnum<{
3982
+ LEFT: "LEFT";
3983
+ RIGHT: "RIGHT";
3984
+ }>>;
3037
3985
  }, import("zod/v4/core").$strip>>>;
3038
3986
  }, import("zod/v4/core").$strip>, undefined, "createPullRequestReview", unknown, boolean, undefined>, "execute"> & {
3039
3987
  execute: (input: {
@@ -3047,6 +3995,8 @@ export declare const createPullRequestReview: (token: GithubTokenInput, options?
3047
3995
  body: string;
3048
3996
  line?: number | undefined;
3049
3997
  side?: "LEFT" | "RIGHT" | undefined;
3998
+ startLine?: number | undefined;
3999
+ startSide?: "LEFT" | "RIGHT" | undefined;
3050
4000
  }[] | undefined;
3051
4001
  }) => Promise<{
3052
4002
  id: number;
@@ -3180,6 +4130,7 @@ export declare const getPullRequestContext: (token: GithubTokenInput, options?:
3180
4130
  includeChecks: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
3181
4131
  includePatch: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
3182
4132
  filesPerPage: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
4133
+ includeLinkedIssues: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
3183
4134
  detail: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
3184
4135
  summary: "summary";
3185
4136
  full: "full";
@@ -3194,8 +4145,16 @@ export declare const getPullRequestContext: (token: GithubTokenInput, options?:
3194
4145
  includeChecks?: boolean | undefined;
3195
4146
  includePatch?: boolean | undefined;
3196
4147
  filesPerPage?: number | undefined;
4148
+ includeLinkedIssues?: boolean | undefined;
3197
4149
  detail?: "summary" | "full" | undefined;
3198
4150
  }) => Promise<{
4151
+ linkedIssues?: {
4152
+ repository: string;
4153
+ number: number;
4154
+ title: string;
4155
+ state: string;
4156
+ url: string;
4157
+ }[] | undefined;
3199
4158
  checks?: {
3200
4159
  checkRuns: {
3201
4160
  hasMore: boolean;
@@ -3255,6 +4214,11 @@ export declare const getPullRequestContext: (token: GithubTokenInput, options?:
3255
4214
  draft: boolean | undefined;
3256
4215
  merged: boolean;
3257
4216
  mergeable: boolean | null;
4217
+ mergeableState: string;
4218
+ autoMerge: {
4219
+ mergeMethod: "merge" | "squash" | "rebase";
4220
+ enabledBy: string;
4221
+ } | null;
3258
4222
  additions: number;
3259
4223
  deletions: number;
3260
4224
  changedFiles: number;
@@ -4638,17 +5602,55 @@ export declare const getCombinedStatus: (token: GithubTokenInput, options?: Tans
4638
5602
  export declare const getCiFailureContext: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
4639
5603
  owner: import("zod").ZodString;
4640
5604
  repo: import("zod").ZodString;
4641
- ref: import("zod").ZodString;
5605
+ ref: import("zod").ZodOptional<import("zod").ZodString>;
5606
+ runId: import("zod").ZodOptional<import("zod").ZodNumber>;
4642
5607
  maxFailedRuns: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
4643
5608
  maxFailedJobs: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
5609
+ logLines: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
4644
5610
  }, import("zod/v4/core").$strip>, undefined, "getCiFailureContext", unknown, boolean, undefined>, "execute"> & {
4645
5611
  execute: (input: {
4646
5612
  owner: string;
4647
5613
  repo: string;
4648
- ref: string;
5614
+ ref?: string | undefined;
5615
+ runId?: number | undefined;
4649
5616
  maxFailedRuns?: number | undefined;
4650
5617
  maxFailedJobs?: number | undefined;
5618
+ logLines?: number | undefined;
4651
5619
  }) => Promise<{
5620
+ run: {
5621
+ id: number;
5622
+ name: string | null | undefined;
5623
+ status: string | null;
5624
+ conclusion: string | null;
5625
+ branch: string | null;
5626
+ sha: string;
5627
+ event: string;
5628
+ url: string;
5629
+ actor: string | undefined;
5630
+ runNumber: number;
5631
+ runAttempt: number | undefined;
5632
+ createdAt: string;
5633
+ updatedAt: string;
5634
+ runStartedAt: string | undefined;
5635
+ };
5636
+ failedJobs: {
5637
+ id: number;
5638
+ name: string;
5639
+ status: "completed" | "in_progress" | "queued" | "requested" | "waiting" | "pending";
5640
+ conclusion: "success" | "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "timed_out" | null;
5641
+ url: string | null;
5642
+ startedAt: string;
5643
+ completedAt: string | null;
5644
+ steps: {
5645
+ name: string;
5646
+ status: "completed" | "in_progress" | "queued";
5647
+ conclusion: string | null;
5648
+ number: number;
5649
+ startedAt: string | null | undefined;
5650
+ completedAt: string | null | undefined;
5651
+ }[] | undefined;
5652
+ }[];
5653
+ } | {
4652
5654
  latestFailure?: {
4653
5655
  run: {
4654
5656
  id: number;
@@ -4664,23 +5666,23 @@ export declare const getCiFailureContext: (token: GithubTokenInput, options?: Ta
4664
5666
  runNumber: number;
4665
5667
  runAttempt: number | undefined;
4666
5668
  };
4667
- jobs: Array<{
5669
+ jobs: {
4668
5670
  id: number;
4669
5671
  name: string;
4670
- status: string;
4671
- conclusion: string | null;
5672
+ status: "completed" | "in_progress" | "queued" | "requested" | "waiting" | "pending";
5673
+ conclusion: "success" | "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "timed_out" | null;
4672
5674
  url: string | null;
4673
5675
  startedAt: string;
4674
5676
  completedAt: string | null;
4675
- steps?: Array<{
5677
+ steps: {
4676
5678
  name: string;
4677
- status: string;
5679
+ status: "completed" | "in_progress" | "queued";
4678
5680
  conclusion: string | null;
4679
5681
  number: number;
4680
- startedAt?: string | null;
4681
- completedAt?: string | null;
4682
- }>;
4683
- }>;
5682
+ startedAt: string | null | undefined;
5683
+ completedAt: string | null | undefined;
5684
+ }[] | undefined;
5685
+ }[];
4684
5686
  } | undefined;
4685
5687
  ref: string;
4686
5688
  combinedStatus: {
@@ -4785,7 +5787,8 @@ export declare const getLatestRelease: (token: GithubTokenInput, options?: Tanst
4785
5787
  export declare const getRelease: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
4786
5788
  owner: import("zod").ZodString;
4787
5789
  repo: import("zod").ZodString;
4788
- releaseId: import("zod").ZodNumber;
5790
+ releaseId: import("zod").ZodOptional<import("zod").ZodNumber>;
5791
+ tag: import("zod").ZodOptional<import("zod").ZodString>;
4789
5792
  detail: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
4790
5793
  summary: "summary";
4791
5794
  full: "full";
@@ -4794,7 +5797,8 @@ export declare const getRelease: (token: GithubTokenInput, options?: TanstackToo
4794
5797
  execute: (input: {
4795
5798
  owner: string;
4796
5799
  repo: string;
4797
- releaseId: number;
5800
+ releaseId?: number | undefined;
5801
+ tag?: string | undefined;
4798
5802
  detail?: "summary" | "full" | undefined;
4799
5803
  }) => Promise<{
4800
5804
  id: number;
@@ -4820,6 +5824,8 @@ export declare const getReleaseContext: (token: GithubTokenInput, options?: Tans
4820
5824
  owner: import("zod").ZodString;
4821
5825
  repo: import("zod").ZodString;
4822
5826
  releaseId: import("zod").ZodOptional<import("zod").ZodNumber>;
5827
+ tag: import("zod").ZodOptional<import("zod").ZodString>;
5828
+ previousTag: import("zod").ZodOptional<import("zod").ZodString>;
4823
5829
  includePrevious: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
4824
5830
  includeCompare: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
4825
5831
  detail: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
@@ -4831,6 +5837,8 @@ export declare const getReleaseContext: (token: GithubTokenInput, options?: Tans
4831
5837
  owner: string;
4832
5838
  repo: string;
4833
5839
  releaseId?: number | undefined;
5840
+ tag?: string | undefined;
5841
+ previousTag?: string | undefined;
4834
5842
  includePrevious?: boolean | undefined;
4835
5843
  includeCompare?: boolean | undefined;
4836
5844
  detail?: "summary" | "full" | undefined;
@@ -4866,6 +5874,23 @@ export declare const getReleaseContext: (token: GithubTokenInput, options?: Tans
4866
5874
  author: string;
4867
5875
  createdAt: string;
4868
5876
  publishedAt: string | null;
5877
+ } | {
5878
+ id: number;
5879
+ tagName: string;
5880
+ name: string | null;
5881
+ body: string | null | undefined;
5882
+ draft: boolean;
5883
+ prerelease: boolean;
5884
+ url: string;
5885
+ author: string;
5886
+ createdAt: string;
5887
+ publishedAt: string | null;
5888
+ assets: {
5889
+ name: string;
5890
+ downloadUrl: string;
5891
+ size: number;
5892
+ downloadCount: number;
5893
+ }[];
4869
5894
  } | undefined;
4870
5895
  release: {
4871
5896
  id: number;
@@ -4966,6 +5991,139 @@ export declare const deleteRelease: (token: GithubTokenInput, options?: Tanstack
4966
5991
  releaseId: number;
4967
5992
  }>;
4968
5993
  };
5994
+ /** Create the TanStack `listCodeScanningAlerts` server tool. */
5995
+ export declare const listCodeScanningAlerts: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
5996
+ owner: import("zod").ZodString;
5997
+ repo: import("zod").ZodString;
5998
+ state: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
5999
+ open: "open";
6000
+ dismissed: "dismissed";
6001
+ fixed: "fixed";
6002
+ }>>>;
6003
+ severity: import("zod").ZodOptional<import("zod").ZodEnum<{
6004
+ error: "error";
6005
+ critical: "critical";
6006
+ high: "high";
6007
+ medium: "medium";
6008
+ low: "low";
6009
+ warning: "warning";
6010
+ note: "note";
6011
+ }>>;
6012
+ ref: import("zod").ZodOptional<import("zod").ZodString>;
6013
+ perPage: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
6014
+ page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
6015
+ maxPages: import("zod").ZodOptional<import("zod").ZodNumber>;
6016
+ }, import("zod/v4/core").$strip>, undefined, "listCodeScanningAlerts", unknown, boolean, undefined>, "execute"> & {
6017
+ execute: (input: {
6018
+ owner: string;
6019
+ repo: string;
6020
+ state?: "open" | "dismissed" | "fixed" | undefined;
6021
+ severity?: "error" | "critical" | "high" | "medium" | "low" | "warning" | "note" | undefined;
6022
+ ref?: string | undefined;
6023
+ perPage?: number | undefined;
6024
+ page?: number | undefined;
6025
+ maxPages?: number | undefined;
6026
+ }) => Promise<PagedList<{
6027
+ number: number;
6028
+ state: "open" | "dismissed" | "fixed" | null;
6029
+ severity: "error" | "critical" | "high" | "medium" | "low" | "warning" | "note" | "none" | null | undefined;
6030
+ rule: {
6031
+ id: string | null | undefined;
6032
+ description: string | undefined;
6033
+ };
6034
+ tool: string | undefined;
6035
+ path: string | undefined;
6036
+ line: number | undefined;
6037
+ url: string;
6038
+ createdAt: string;
6039
+ dismissedReason: "false positive" | "won't fix" | "used in tests" | null;
6040
+ }>>;
6041
+ };
6042
+ /** Create the TanStack `listDependabotAlerts` server tool. */
6043
+ export declare const listDependabotAlerts: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
6044
+ owner: import("zod").ZodString;
6045
+ repo: import("zod").ZodString;
6046
+ state: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
6047
+ open: "open";
6048
+ dismissed: "dismissed";
6049
+ fixed: "fixed";
6050
+ auto_dismissed: "auto_dismissed";
6051
+ }>>>;
6052
+ severity: import("zod").ZodOptional<import("zod").ZodEnum<{
6053
+ critical: "critical";
6054
+ high: "high";
6055
+ medium: "medium";
6056
+ low: "low";
6057
+ }>>;
6058
+ ecosystem: import("zod").ZodOptional<import("zod").ZodString>;
6059
+ perPage: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
6060
+ after: import("zod").ZodOptional<import("zod").ZodString>;
6061
+ }, import("zod/v4/core").$strip>, undefined, "listDependabotAlerts", unknown, boolean, undefined>, "execute"> & {
6062
+ execute: (input: {
6063
+ owner: string;
6064
+ repo: string;
6065
+ state?: "open" | "dismissed" | "fixed" | "auto_dismissed" | undefined;
6066
+ severity?: "critical" | "high" | "medium" | "low" | undefined;
6067
+ ecosystem?: string | undefined;
6068
+ perPage?: number | undefined;
6069
+ after?: string | undefined;
6070
+ }) => Promise<{
6071
+ nextCursor?: string | undefined;
6072
+ items: {
6073
+ number: number;
6074
+ state: "open" | "dismissed" | "fixed" | "auto_dismissed";
6075
+ severity: "critical" | "high" | "medium" | "low";
6076
+ package: string | undefined;
6077
+ ecosystem: string | undefined;
6078
+ manifestPath: string | undefined;
6079
+ scope: "development" | "runtime" | null | undefined;
6080
+ advisory: {
6081
+ ghsaId: string;
6082
+ cveId: string | null;
6083
+ summary: string;
6084
+ };
6085
+ vulnerableVersionRange: string;
6086
+ firstPatchedVersion: string | undefined;
6087
+ url: string;
6088
+ createdAt: string;
6089
+ }[];
6090
+ hasMore: boolean;
6091
+ perPage: number;
6092
+ }>;
6093
+ };
6094
+ /** Create the TanStack `listSecretScanningAlerts` server tool. */
6095
+ export declare const listSecretScanningAlerts: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
6096
+ owner: import("zod").ZodString;
6097
+ repo: import("zod").ZodString;
6098
+ state: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
6099
+ open: "open";
6100
+ resolved: "resolved";
6101
+ }>>>;
6102
+ secretType: import("zod").ZodOptional<import("zod").ZodString>;
6103
+ perPage: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
6104
+ page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
6105
+ maxPages: import("zod").ZodOptional<import("zod").ZodNumber>;
6106
+ }, import("zod/v4/core").$strip>, undefined, "listSecretScanningAlerts", unknown, boolean, undefined>, "execute"> & {
6107
+ execute: (input: {
6108
+ owner: string;
6109
+ repo: string;
6110
+ state?: "open" | "resolved" | undefined;
6111
+ secretType?: string | undefined;
6112
+ perPage?: number | undefined;
6113
+ page?: number | undefined;
6114
+ maxPages?: number | undefined;
6115
+ }) => Promise<PagedList<{
6116
+ number: number | undefined;
6117
+ state: "open" | "resolved" | undefined;
6118
+ secretType: string | undefined;
6119
+ secretTypeDisplayName: string | undefined;
6120
+ validity: "unknown" | "active" | "inactive" | undefined;
6121
+ pushProtectionBypassed: boolean | null | undefined;
6122
+ resolution: "false_positive" | "wont_fix" | "revoked" | "used_in_tests" | null | undefined;
6123
+ url: string | undefined;
6124
+ createdAt: string | undefined;
6125
+ }>>;
6126
+ };
4969
6127
  //#endregion
4970
6128
  export { AUTO_APPROVAL_TOOLS, type ApprovalConfig, type CommitIdentity, type CreateGithubAgentOptions, type CreateGithubToolsOptions, DEFAULT_EVALUATION_MODEL, GITHUB_TOOL_NAMES, GITHUB_WRITE_TOOLS, type GithubAgent, type GithubAgentCallOptions, type GithubApprovalMiddlewareOptions, type GithubEvaluationOptions, type GithubTanstackTool, type GithubTokenCall, type GithubTokenInput, type GithubToolName, type GithubToolPreset, type GithubToolsContext, type GithubWriteToolName, PRESET_TOOLS, type TanstackToolOptions, type TanstackToolOverrides, type ToolApprovalMode };
4971
6129
  //# sourceMappingURL=tanstack.d.mts.map