@github-tools/sdk 1.19.0 → 1.21.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 (64) hide show
  1. package/README.md +97 -30
  2. package/dist/approval-policy-CEMMPq92.mjs +17 -0
  3. package/dist/approval-policy-CEMMPq92.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-meFAMt2D.mjs} +41 -2
  11. package/dist/cores-meFAMt2D.mjs.map +1 -0
  12. package/dist/{tool-types-CrC80SIL.d.mts → dry-run-DXckOam2.d.mts} +437 -54
  13. package/dist/dry-run-DXckOam2.d.mts.map +1 -0
  14. package/dist/evaluation-DJHINyAu.mjs +311 -0
  15. package/dist/evaluation-DJHINyAu.mjs.map +1 -0
  16. package/dist/{eve-runtime-DRh2QJI7.d.mts → eve-runtime-B_CJE9JV.d.mts} +21 -7
  17. package/dist/eve-runtime-B_CJE9JV.d.mts.map +1 -0
  18. package/dist/{eve-runtime-YTxfrWP-.mjs → eve-runtime-DPzMPCLt.mjs} +49 -15
  19. package/dist/eve-runtime-DPzMPCLt.mjs.map +1 -0
  20. package/dist/eve-runtime.d.mts +5 -5
  21. package/dist/eve-runtime.mjs +4 -4
  22. package/dist/eve.d.mts +95 -4
  23. package/dist/eve.d.mts.map +1 -1
  24. package/dist/eve.mjs +94 -3
  25. package/dist/eve.mjs.map +1 -1
  26. package/dist/{index-DkZvveZP.d.mts → index-CzzrtCVj.d.mts} +119 -348
  27. package/dist/index-CzzrtCVj.d.mts.map +1 -0
  28. package/dist/index.d.mts +3 -3
  29. package/dist/index.mjs +4 -3
  30. package/dist/{interrupts-C_lUXMdd.d.mts → interrupts-BSDPwdJ2.d.mts} +2 -2
  31. package/dist/interrupts-BSDPwdJ2.d.mts.map +1 -0
  32. package/dist/{src-Bx5p1Unc.mjs → src-BlhrSieS.mjs} +491 -23
  33. package/dist/src-BlhrSieS.mjs.map +1 -0
  34. package/dist/tanstack/interrupts.d.mts +1 -1
  35. package/dist/tanstack.d.mts +1705 -204
  36. package/dist/tanstack.d.mts.map +1 -1
  37. package/dist/tanstack.mjs +53 -19
  38. package/dist/tanstack.mjs.map +1 -1
  39. package/dist/{token-Bh8nPj66.mjs → token-BLps09gm.mjs} +36 -116
  40. package/dist/token-BLps09gm.mjs.map +1 -0
  41. package/dist/{types-BmwOpI5-.d.mts → types-Bln8U42J.d.mts} +3 -3
  42. package/dist/{types-BmwOpI5-.d.mts.map → types-Bln8U42J.d.mts.map} +1 -1
  43. package/dist/{types-CPAsEMzx.d.mts → types-C7O2lwwz.d.mts} +14 -2
  44. package/dist/{types-CPAsEMzx.d.mts.map → types-C7O2lwwz.d.mts.map} +1 -1
  45. package/dist/workflow.d.mts +41 -40
  46. package/dist/workflow.d.mts.map +1 -1
  47. package/dist/workflow.mjs +20 -47
  48. package/dist/workflow.mjs.map +1 -1
  49. package/dist/{write-tools-BaoTUCg7.mjs → write-tools-w-8tjnDQ.mjs} +1360 -124
  50. package/dist/write-tools-w-8tjnDQ.mjs.map +1 -0
  51. package/package.json +4 -6
  52. package/dist/cores-BeLZwcde.mjs.map +0 -1
  53. package/dist/evaluation-f-2QwBid.mjs +0 -210
  54. package/dist/evaluation-f-2QwBid.mjs.map +0 -1
  55. package/dist/eve-runtime-DRh2QJI7.d.mts.map +0 -1
  56. package/dist/eve-runtime-YTxfrWP-.mjs.map +0 -1
  57. package/dist/index-DkZvveZP.d.mts.map +0 -1
  58. package/dist/instructions-BuypoY0x.mjs +0 -148
  59. package/dist/instructions-BuypoY0x.mjs.map +0 -1
  60. package/dist/interrupts-C_lUXMdd.d.mts.map +0 -1
  61. package/dist/src-Bx5p1Unc.mjs.map +0 -1
  62. package/dist/token-Bh8nPj66.mjs.map +0 -1
  63. package/dist/tool-types-CrC80SIL.d.mts.map +0 -1
  64. 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";
3
- import { t as githubToolApproval } from "./interrupts-C_lUXMdd.mjs";
1
+ import { A as DEFAULT_EVALUATION_MODEL, B as PRESET_TOOLS, G as GithubWriteToolName, H as GITHUB_TOOL_NAMES, I as GithubGuardrails, M as GithubTokenCall, N as GithubTokenInput, O as GITHUB_WRITE_TOOLS, U as GITHUB_TOOL_CATALOG, V as PresetToolName, W as GithubToolName, c as CommitIdentity, d as Octokit, g as ToolApprovalMode, j as RoutablePreset, k as AUTO_APPROVAL_TOOLS, m as ApprovalConfig, n as GithubDryRunResult, s as GithubToolsContext, z as GithubToolPreset } from "./dry-run-DXckOam2.mjs";
2
+ import "./index-CzzrtCVj.mjs";
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: {
@@ -306,7 +380,7 @@ declare function getCiFailureContextCore({ token, owner, repo, ref, maxFailedRun
306
380
  }[];
307
381
  }>;
308
382
  declare namespace checks_d_exports {
309
- export { getCombinedStatusCore, getCombinedStatusDescription, getCombinedStatusInputSchema, listCheckRunsCore, listCheckRunsDescription, listCheckRunsInputSchema };
383
+ export { createCommitStatusCore, createCommitStatusDescription, createCommitStatusInputSchema, getCombinedStatusCore, getCombinedStatusDescription, getCombinedStatusInputSchema, listCheckRunsCore, listCheckRunsDescription, listCheckRunsInputSchema };
310
384
  }
311
385
  declare const listCheckRunsInputSchema: z.ZodObject<{
312
386
  owner: z.ZodString;
@@ -362,6 +436,50 @@ declare function getCombinedStatusCore({ token, owner, repo, ref }: {
362
436
  url: string | null;
363
437
  }[];
364
438
  }>;
439
+ declare const createCommitStatusInputSchema: z.ZodObject<{
440
+ owner: z.ZodString;
441
+ repo: z.ZodString;
442
+ sha: z.ZodString;
443
+ state: z.ZodEnum<{
444
+ error: "error";
445
+ success: "success";
446
+ failure: "failure";
447
+ pending: "pending";
448
+ }>;
449
+ context: z.ZodString;
450
+ description: z.ZodOptional<z.ZodString>;
451
+ targetUrl: z.ZodOptional<z.ZodString>;
452
+ }, z.core.$strip>;
453
+ declare const createCommitStatusDescription = "Report a result on a commit as a commit status (Statuses API), shown on its pull requests and usable as a required check. Works with personal access tokens and GitHub Apps, unlike check runs, which only GitHub Apps can create";
454
+ /** Not idempotent: each call adds a status, and GitHub shows the latest one for each context. */
455
+ declare function createCommitStatusCore({ token, owner, repo, sha, state, context, description, targetUrl }: {
456
+ token: string;
457
+ owner: string;
458
+ repo: string;
459
+ sha: string;
460
+ state: 'error' | 'failure' | 'pending' | 'success';
461
+ context: string;
462
+ description?: string;
463
+ targetUrl?: string;
464
+ }): Promise<{
465
+ id: number;
466
+ context: string;
467
+ state: string;
468
+ description: string | null;
469
+ url: string | null;
470
+ createdAt: string;
471
+ }>;
472
+ //#endregion
473
+ //#region src/core/pagination.d.ts
474
+ type PagingFields = {
475
+ hasMore: boolean;
476
+ page: number;
477
+ perPage: number;
478
+ nextPage?: number;
479
+ };
480
+ type PagedList<T> = {
481
+ items: T[];
482
+ } & PagingFields;
365
483
  declare namespace commits_d_exports {
366
484
  export { BLAME_QUERY, compareCommitsCore, compareCommitsDescription, compareCommitsInputSchema, getBlameCore, getBlameDescription, getBlameInputSchema, getCommitCore, getCommitDescription, getCommitInputSchema, listCommitsCore, listCommitsDescription, listCommitsInputSchema };
367
485
  }
@@ -776,7 +894,7 @@ declare function createGistCommentCore({ token, gistId, body }: {
776
894
  createdAt: string;
777
895
  }>;
778
896
  declare namespace issues_d_exports {
779
- export { addAssigneesCore, addAssigneesDescription, addAssigneesInputSchema, addIssueCommentCore, addIssueCommentDescription, addIssueCommentInputSchema, addLabelsCore, addLabelsDescription, addLabelsInputSchema, closeIssueCore, closeIssueDescription, closeIssueInputSchema, createIssueCore, createIssueDescription, createIssueInputSchema, createLabelCore, createLabelDescription, createLabelInputSchema, deleteIssueCommentCore, deleteIssueCommentDescription, deleteIssueCommentInputSchema, deleteLabelCore, deleteLabelDescription, deleteLabelInputSchema, getIssueCore, getIssueDescription, getIssueInputSchema, listIssueCommentsCore, listIssueCommentsDescription, listIssueCommentsInputSchema, listIssuesCore, listIssuesDescription, listIssuesInputSchema, listLabelsCore, listLabelsDescription, listLabelsInputSchema, removeAssigneesCore, removeAssigneesDescription, removeAssigneesInputSchema, removeLabelCore, removeLabelDescription, removeLabelInputSchema, updateIssueCommentCore, updateIssueCommentDescription, updateIssueCommentInputSchema, updateIssueCore, updateIssueDescription, updateIssueInputSchema, updateLabelCore, updateLabelDescription, updateLabelInputSchema };
897
+ export { addAssigneesCore, addAssigneesDescription, addAssigneesInputSchema, addIssueCommentCore, addIssueCommentDescription, addIssueCommentInputSchema, addLabelsCore, addLabelsDescription, addLabelsInputSchema, addSubIssueCore, addSubIssueDescription, addSubIssueInputSchema, closeIssueCore, closeIssueDescription, closeIssueInputSchema, createIssueCore, createIssueDescription, createIssueInputSchema, createLabelCore, createLabelDescription, createLabelInputSchema, deleteIssueCommentCore, deleteIssueCommentDescription, deleteIssueCommentInputSchema, deleteLabelCore, deleteLabelDescription, deleteLabelInputSchema, getIssueCore, getIssueDescription, getIssueInputSchema, listIssueCommentsCore, listIssueCommentsDescription, listIssueCommentsInputSchema, listIssuesCore, listIssuesDescription, listIssuesInputSchema, listLabelsCore, listLabelsDescription, listLabelsInputSchema, listMilestonesCore, listMilestonesDescription, listMilestonesInputSchema, listSubIssuesCore, listSubIssuesDescription, listSubIssuesInputSchema, removeAssigneesCore, removeAssigneesDescription, removeAssigneesInputSchema, removeLabelCore, removeLabelDescription, removeLabelInputSchema, updateIssueCommentCore, updateIssueCommentDescription, updateIssueCommentInputSchema, updateIssueCore, updateIssueDescription, updateIssueInputSchema, updateLabelCore, updateLabelDescription, updateLabelInputSchema };
780
898
  }
781
899
  declare const listIssuesInputSchema: z.ZodObject<{
782
900
  owner: z.ZodString;
@@ -876,10 +994,11 @@ declare const createIssueInputSchema: z.ZodObject<{
876
994
  body: z.ZodOptional<z.ZodString>;
877
995
  labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
878
996
  assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
997
+ milestone: z.ZodOptional<z.ZodNumber>;
879
998
  }, z.core.$strip>;
880
999
  declare const createIssueDescription = "Create a new issue in a GitHub repository";
881
1000
  /** Not idempotent — each call creates a new issue. */
882
- declare function createIssueCore({ token, owner, repo, title, body, labels, assignees }: {
1001
+ declare function createIssueCore({ token, owner, repo, title, body, labels, assignees, milestone }: {
883
1002
  token: string;
884
1003
  owner: string;
885
1004
  repo: string;
@@ -887,6 +1006,7 @@ declare function createIssueCore({ token, owner, repo, title, body, labels, assi
887
1006
  body?: string;
888
1007
  labels?: string[];
889
1008
  assignees?: string[];
1009
+ milestone?: number;
890
1010
  }): Promise<{
891
1011
  number: number;
892
1012
  title: string;
@@ -1171,6 +1291,84 @@ declare function removeAssigneesCore({ token, owner, repo, issueNumber, assignee
1171
1291
  number: number;
1172
1292
  assignees: string[] | undefined;
1173
1293
  }>;
1294
+ declare const listMilestonesInputSchema: z.ZodObject<{
1295
+ owner: z.ZodString;
1296
+ repo: z.ZodString;
1297
+ state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
1298
+ open: "open";
1299
+ closed: "closed";
1300
+ all: "all";
1301
+ }>>>;
1302
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1303
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1304
+ }, z.core.$strip>;
1305
+ declare const listMilestonesDescription = "List milestones in a GitHub repository with their due dates and open and closed issue counts. Pass a milestone number to createIssue or updateIssue. When hasMore, pass nextPage instead of repeating the same call.";
1306
+ declare function listMilestonesCore({ token, owner, repo, state, perPage, page }: {
1307
+ token: string;
1308
+ owner: string;
1309
+ repo: string;
1310
+ state: 'open' | 'closed' | 'all';
1311
+ perPage: number;
1312
+ page: number;
1313
+ }): Promise<PagedList<{
1314
+ number: number;
1315
+ title: string;
1316
+ state: "open" | "closed";
1317
+ description: string | null | undefined;
1318
+ dueOn: string | null;
1319
+ openIssues: number;
1320
+ closedIssues: number;
1321
+ url: string;
1322
+ }>>;
1323
+ declare const listSubIssuesInputSchema: z.ZodObject<{
1324
+ owner: z.ZodString;
1325
+ repo: z.ZodString;
1326
+ issueNumber: z.ZodNumber;
1327
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1328
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1329
+ }, z.core.$strip>;
1330
+ declare const listSubIssuesDescription = "List the sub-issues of an issue. A sub-issue can be in another repository of the same owner; its url says which. When hasMore, pass nextPage instead of repeating the same call.";
1331
+ declare function listSubIssuesCore({ token, owner, repo, issueNumber, perPage, page }: {
1332
+ token: string;
1333
+ owner: string;
1334
+ repo: string;
1335
+ issueNumber: number;
1336
+ perPage: number;
1337
+ page: number;
1338
+ }): Promise<PagedList<{
1339
+ number: number;
1340
+ title: string;
1341
+ state: string;
1342
+ url: string;
1343
+ assignees: string[] | undefined;
1344
+ }>>;
1345
+ declare const addSubIssueInputSchema: z.ZodObject<{
1346
+ owner: z.ZodString;
1347
+ repo: z.ZodString;
1348
+ issueNumber: z.ZodNumber;
1349
+ subIssueNumber: z.ZodNumber;
1350
+ subIssueRepo: z.ZodOptional<z.ZodString>;
1351
+ replaceParent: z.ZodOptional<z.ZodBoolean>;
1352
+ }, z.core.$strip>;
1353
+ declare const addSubIssueDescription = "Add an existing issue as a sub-issue of another issue, to split work into tracked steps. An issue has at most one parent; set replaceParent to move it from its current one";
1354
+ /** Not idempotent: GitHub rejects an issue that already has a parent unless replaceParent is set. */
1355
+ declare function addSubIssueCore({ token, owner, repo, issueNumber, subIssueNumber, subIssueRepo, replaceParent }: {
1356
+ token: string;
1357
+ owner: string;
1358
+ repo: string;
1359
+ issueNumber: number;
1360
+ subIssueNumber: number;
1361
+ subIssueRepo?: string;
1362
+ replaceParent?: boolean;
1363
+ }): Promise<{
1364
+ issueNumber: number;
1365
+ subIssue: {
1366
+ number: number;
1367
+ title: string;
1368
+ state: string;
1369
+ url: string;
1370
+ };
1371
+ }>;
1174
1372
  declare namespace notifications_d_exports {
1175
1373
  export { listNotificationsCore, listNotificationsDescription, listNotificationsInputSchema, markNotificationReadCore, markNotificationReadDescription, markNotificationReadInputSchema };
1176
1374
  }
@@ -1212,7 +1410,7 @@ declare function markNotificationReadCore({ token, threadId }: {
1212
1410
  threadId: string;
1213
1411
  }>;
1214
1412
  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 };
1413
+ 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, updatePullRequestBranchCore, updatePullRequestBranchDescription, updatePullRequestBranchInputSchema, updatePullRequestCommentCore, updatePullRequestCommentDescription, updatePullRequestCommentInputSchema, updatePullRequestCore, updatePullRequestDescription, updatePullRequestInputSchema };
1216
1414
  }
1217
1415
  declare const listPullRequestsInputSchema: z.ZodObject<{
1218
1416
  owner: z.ZodString;
@@ -1276,6 +1474,11 @@ declare function getPullRequestCore({ token, owner, repo, pullNumber, detail }:
1276
1474
  draft: boolean | undefined;
1277
1475
  merged: boolean;
1278
1476
  mergeable: boolean | null;
1477
+ mergeableState: string;
1478
+ autoMerge: {
1479
+ mergeMethod: "merge" | "squash" | "rebase";
1480
+ enabledBy: string;
1481
+ } | null;
1279
1482
  additions: number;
1280
1483
  deletions: number;
1281
1484
  changedFiles: number;
@@ -1360,7 +1563,7 @@ declare const mergePullRequestInputSchema: z.ZodObject<{
1360
1563
  }, z.core.$strip>;
1361
1564
  declare const mergePullRequestDescription = "Merge a pull request";
1362
1565
  /** Not idempotent — merging an already-merged PR returns an error from GitHub. */
1363
- declare function mergePullRequestCore({ token, owner, repo, pullNumber, commitTitle, commitMessage, mergeMethod, coAuthors }: {
1566
+ declare function mergePullRequestCore({ token, owner, repo, pullNumber, commitTitle, commitMessage, mergeMethod, coAuthors, branches }: {
1364
1567
  token: string;
1365
1568
  owner: string;
1366
1569
  repo: string;
@@ -1369,6 +1572,8 @@ declare function mergePullRequestCore({ token, owner, repo, pullNumber, commitTi
1369
1572
  commitMessage?: string;
1370
1573
  mergeMethod: 'merge' | 'squash' | 'rebase';
1371
1574
  coAuthors?: CommitIdentity[];
1575
+ /** `guardrails.branches`: the pull request's base branch must match. */
1576
+ branches?: string[];
1372
1577
  }): Promise<{
1373
1578
  merged: boolean;
1374
1579
  message: string;
@@ -1499,9 +1704,14 @@ declare const createPullRequestReviewInputSchema: z.ZodObject<{
1499
1704
  LEFT: "LEFT";
1500
1705
  RIGHT: "RIGHT";
1501
1706
  }>>;
1707
+ startLine: z.ZodOptional<z.ZodNumber>;
1708
+ startSide: z.ZodOptional<z.ZodEnum<{
1709
+ LEFT: "LEFT";
1710
+ RIGHT: "RIGHT";
1711
+ }>>;
1502
1712
  }, z.core.$strip>>>;
1503
1713
  }, z.core.$strip>;
1504
- declare const createPullRequestReviewDescription = "Submit a pull request review — approve, request changes, or comment with optional inline comments on specific lines";
1714
+ 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
1715
  /** Not idempotent — each call submits a new review. */
1506
1716
  declare function createPullRequestReviewCore({ token, owner, repo, pullNumber, body, event, comments }: {
1507
1717
  token: string;
@@ -1515,6 +1725,8 @@ declare function createPullRequestReviewCore({ token, owner, repo, pullNumber, b
1515
1725
  body: string;
1516
1726
  line?: number;
1517
1727
  side?: 'LEFT' | 'RIGHT';
1728
+ startLine?: number;
1729
+ startSide?: 'LEFT' | 'RIGHT';
1518
1730
  }>;
1519
1731
  }): Promise<{
1520
1732
  id: number;
@@ -1640,6 +1852,76 @@ declare function requestReviewersCore({ token, owner, repo, pullNumber, reviewer
1640
1852
  requestedReviewers: string[] | undefined;
1641
1853
  requestedTeams: string[] | undefined;
1642
1854
  }>;
1855
+ declare const enablePullRequestAutoMergeInputSchema: z.ZodObject<{
1856
+ owner: z.ZodString;
1857
+ repo: z.ZodString;
1858
+ pullNumber: z.ZodNumber;
1859
+ mergeMethod: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
1860
+ merge: "merge";
1861
+ squash: "squash";
1862
+ rebase: "rebase";
1863
+ }>>>;
1864
+ commitTitle: z.ZodOptional<z.ZodString>;
1865
+ commitMessage: z.ZodOptional<z.ZodString>;
1866
+ }, z.core.$strip>;
1867
+ 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";
1868
+ /** Idempotent: enabling auto-merge again replaces the pending request with the same settings. */
1869
+ declare function enablePullRequestAutoMergeCore({ token, owner, repo, pullNumber, mergeMethod, commitTitle, commitMessage, coAuthors, branches }: {
1870
+ token: string;
1871
+ owner: string;
1872
+ repo: string;
1873
+ pullNumber: number;
1874
+ mergeMethod: 'merge' | 'squash' | 'rebase';
1875
+ commitTitle?: string;
1876
+ commitMessage?: string;
1877
+ coAuthors?: CommitIdentity[];
1878
+ /** `guardrails.branches`: the pull request's base branch must match. */
1879
+ branches?: string[];
1880
+ }): Promise<{
1881
+ number: number;
1882
+ url: string;
1883
+ autoMerge: {
1884
+ enabledAt: string;
1885
+ mergeMethod: string;
1886
+ } | null;
1887
+ }>;
1888
+ declare const disablePullRequestAutoMergeInputSchema: z.ZodObject<{
1889
+ owner: z.ZodString;
1890
+ repo: z.ZodString;
1891
+ pullNumber: z.ZodNumber;
1892
+ }, z.core.$strip>;
1893
+ declare const disablePullRequestAutoMergeDescription = "Cancel a pending auto-merge, so the pull request stays open when its checks pass";
1894
+ /** Idempotent: a pull request without auto-merge stays without it. */
1895
+ declare function disablePullRequestAutoMergeCore({ token, owner, repo, pullNumber }: {
1896
+ token: string;
1897
+ owner: string;
1898
+ repo: string;
1899
+ pullNumber: number;
1900
+ }): Promise<{
1901
+ number: number;
1902
+ url: string;
1903
+ autoMerge: null;
1904
+ }>;
1905
+ declare const updatePullRequestBranchInputSchema: z.ZodObject<{
1906
+ owner: z.ZodString;
1907
+ repo: z.ZodString;
1908
+ pullNumber: z.ZodNumber;
1909
+ expectedHeadSha: z.ZodOptional<z.ZodString>;
1910
+ }, z.core.$strip>;
1911
+ declare const updatePullRequestBranchDescription = "Bring a pull request branch up to date by merging its base branch into it, like the \"Update branch\" button. Use it when getPullRequest reports mergeableState behind. GitHub runs the update in the background";
1912
+ /** Not idempotent: each call can add a merge commit to the pull request branch. */
1913
+ declare function updatePullRequestBranchCore({ token, owner, repo, pullNumber, expectedHeadSha, guardrails }: {
1914
+ token: string;
1915
+ owner: string;
1916
+ repo: string;
1917
+ pullNumber: number;
1918
+ expectedHeadSha?: string;
1919
+ /** `guardrails`: the pull request's head repository and branch must match. */
1920
+ guardrails?: Pick<GithubGuardrails, 'repositories' | 'branches'>;
1921
+ }): Promise<{
1922
+ message: string | undefined;
1923
+ url: string | undefined;
1924
+ }>;
1643
1925
  declare namespace reactions_d_exports {
1644
1926
  export { ReactionContent, addCommentReactionCore, addCommentReactionDescription, addCommentReactionInputSchema, addIssueReactionCore, addIssueReactionDescription, addIssueReactionInputSchema, listCommentReactionsCore, listCommentReactionsDescription, listCommentReactionsInputSchema, listIssueReactionsCore, listIssueReactionsDescription, listIssueReactionsInputSchema };
1645
1927
  }
@@ -1847,18 +2129,20 @@ declare function getLatestReleaseCore({ token, owner, repo, detail }: {
1847
2129
  declare const getReleaseInputSchema: z.ZodObject<{
1848
2130
  owner: z.ZodString;
1849
2131
  repo: z.ZodString;
1850
- releaseId: z.ZodNumber;
2132
+ releaseId: z.ZodOptional<z.ZodNumber>;
2133
+ tag: z.ZodOptional<z.ZodString>;
1851
2134
  detail: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
1852
2135
  summary: "summary";
1853
2136
  full: "full";
1854
2137
  }>>>;
1855
2138
  }, 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 }: {
2139
+ declare const getReleaseDescription = "Get a specific release by ID or tag, including its assets. Body truncated by default (detail: summary)";
2140
+ declare function getReleaseCore({ token, owner, repo, releaseId, tag, detail }: {
1858
2141
  token: string;
1859
2142
  owner: string;
1860
2143
  repo: string;
1861
- releaseId: number;
2144
+ releaseId?: number;
2145
+ tag?: string;
1862
2146
  detail?: DetailLevel;
1863
2147
  }): Promise<{
1864
2148
  id: number;
@@ -1962,23 +2246,622 @@ declare function deleteReleaseCore({ token, owner, repo, releaseId }: {
1962
2246
  deleted: boolean;
1963
2247
  releaseId: number;
1964
2248
  }>;
1965
- declare namespace search_d_exports {
1966
- export { searchCodeCore, searchCodeDescription, searchCodeInputSchema, searchIssuesCore, searchIssuesDescription, searchIssuesInputSchema, searchRepositoriesCore, searchRepositoriesDescription, searchRepositoriesInputSchema };
2249
+ declare namespace security_d_exports {
2250
+ export { listCodeScanningAlertsCore, listCodeScanningAlertsDescription, listCodeScanningAlertsInputSchema, listDependabotAlertsCore, listDependabotAlertsDescription, listDependabotAlertsInputSchema, listSecretScanningAlertsCore, listSecretScanningAlertsDescription, listSecretScanningAlertsInputSchema };
1967
2251
  }
1968
- declare const searchCodeInputSchema: z.ZodObject<{
1969
- query: z.ZodString;
2252
+ declare const listCodeScanningAlertsInputSchema: z.ZodObject<{
2253
+ owner: z.ZodString;
2254
+ repo: z.ZodString;
2255
+ state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2256
+ open: "open";
2257
+ dismissed: "dismissed";
2258
+ fixed: "fixed";
2259
+ }>>>;
2260
+ severity: z.ZodOptional<z.ZodEnum<{
2261
+ error: "error";
2262
+ critical: "critical";
2263
+ high: "high";
2264
+ medium: "medium";
2265
+ low: "low";
2266
+ warning: "warning";
2267
+ note: "note";
2268
+ }>>;
2269
+ ref: z.ZodOptional<z.ZodString>;
1970
2270
  perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2271
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2272
+ maxPages: z.ZodOptional<z.ZodNumber>;
1971
2273
  }, z.core.$strip>;
1972
- declare const searchCodeDescription = "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.";
1973
- declare function searchCodeCore({ token, query, perPage }: {
2274
+ 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.";
2275
+ declare function listCodeScanningAlertsCore({ token, owner, repo, state, severity, ref, perPage, page, maxPages }: {
1974
2276
  token: string;
1975
- query: string;
2277
+ owner: string;
2278
+ repo: string;
2279
+ state: 'open' | 'dismissed' | 'fixed';
2280
+ severity?: 'critical' | 'high' | 'medium' | 'low' | 'warning' | 'note' | 'error';
2281
+ ref?: string;
2282
+ perPage: number;
2283
+ page?: number;
2284
+ maxPages?: number;
2285
+ }): Promise<PagedList<{
2286
+ number: number;
2287
+ state: "open" | "dismissed" | "fixed" | null;
2288
+ severity: "error" | "critical" | "high" | "medium" | "low" | "warning" | "note" | "none" | null | undefined;
2289
+ rule: {
2290
+ id: string | null | undefined;
2291
+ description: string | undefined;
2292
+ };
2293
+ tool: string | undefined;
2294
+ path: string | undefined;
2295
+ line: number | undefined;
2296
+ url: string;
2297
+ createdAt: string;
2298
+ dismissedReason: "false positive" | "won't fix" | "used in tests" | null;
2299
+ }>>;
2300
+ declare const listDependabotAlertsInputSchema: z.ZodObject<{
2301
+ owner: z.ZodString;
2302
+ repo: z.ZodString;
2303
+ state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2304
+ open: "open";
2305
+ dismissed: "dismissed";
2306
+ fixed: "fixed";
2307
+ auto_dismissed: "auto_dismissed";
2308
+ }>>>;
2309
+ severity: z.ZodOptional<z.ZodEnum<{
2310
+ critical: "critical";
2311
+ high: "high";
2312
+ medium: "medium";
2313
+ low: "low";
2314
+ }>>;
2315
+ ecosystem: z.ZodOptional<z.ZodString>;
2316
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2317
+ after: z.ZodOptional<z.ZodString>;
2318
+ }, z.core.$strip>;
2319
+ 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.";
2320
+ declare function listDependabotAlertsCore({ token, owner, repo, state, severity, ecosystem, perPage, after }: {
2321
+ token: string;
2322
+ owner: string;
2323
+ repo: string;
2324
+ state: 'open' | 'fixed' | 'dismissed' | 'auto_dismissed';
2325
+ severity?: 'critical' | 'high' | 'medium' | 'low';
2326
+ ecosystem?: string;
1976
2327
  perPage: number;
2328
+ after?: string;
1977
2329
  }): Promise<{
1978
- totalCount: number;
2330
+ nextCursor?: string | undefined;
1979
2331
  items: {
1980
- name: string;
1981
- path: string;
2332
+ number: number;
2333
+ state: "open" | "dismissed" | "fixed" | "auto_dismissed";
2334
+ severity: "critical" | "high" | "medium" | "low";
2335
+ package: string | undefined;
2336
+ ecosystem: string | undefined;
2337
+ manifestPath: string | undefined;
2338
+ scope: "development" | "runtime" | null | undefined;
2339
+ advisory: {
2340
+ ghsaId: string;
2341
+ cveId: string | null;
2342
+ summary: string;
2343
+ };
2344
+ vulnerableVersionRange: string;
2345
+ firstPatchedVersion: string | undefined;
2346
+ url: string;
2347
+ createdAt: string;
2348
+ }[];
2349
+ hasMore: boolean;
2350
+ perPage: number;
2351
+ }>;
2352
+ declare const listSecretScanningAlertsInputSchema: z.ZodObject<{
2353
+ owner: z.ZodString;
2354
+ repo: z.ZodString;
2355
+ state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
2356
+ open: "open";
2357
+ resolved: "resolved";
2358
+ }>>>;
2359
+ secretType: z.ZodOptional<z.ZodString>;
2360
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2361
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2362
+ maxPages: z.ZodOptional<z.ZodNumber>;
2363
+ }, z.core.$strip>;
2364
+ 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.";
2365
+ declare function listSecretScanningAlertsCore({ token, owner, repo, state, secretType, perPage, page, maxPages }: {
2366
+ token: string;
2367
+ owner: string;
2368
+ repo: string;
2369
+ state: 'open' | 'resolved';
2370
+ secretType?: string;
2371
+ perPage: number;
2372
+ page?: number;
2373
+ maxPages?: number;
2374
+ }): Promise<PagedList<{
2375
+ number: number | undefined;
2376
+ state: "open" | "resolved" | undefined;
2377
+ secretType: string | undefined;
2378
+ secretTypeDisplayName: string | undefined;
2379
+ validity: "unknown" | "active" | "inactive" | undefined;
2380
+ pushProtectionBypassed: boolean | null | undefined;
2381
+ resolution: "false_positive" | "wont_fix" | "revoked" | "used_in_tests" | null | undefined;
2382
+ url: string | undefined;
2383
+ createdAt: string | undefined;
2384
+ }>>;
2385
+ declare namespace repository_d_exports {
2386
+ export { composeCommitMessage, createBranchCore, createBranchDescription, createBranchInputSchema, createCommitOnBranch, createOrUpdateFileCore, createOrUpdateFileDescription, createOrUpdateFileInputSchema, createRepositoryCore, createRepositoryDescription, createRepositoryInputSchema, deleteBranchCore, deleteBranchDescription, deleteBranchInputSchema, editFilesCore, editFilesDescription, editFilesInputSchema, forkRepositoryCore, forkRepositoryDescription, forkRepositoryInputSchema, getBranchRulesCore, getBranchRulesDescription, getBranchRulesInputSchema, getCollaboratorPermissionCore, getCollaboratorPermissionDescription, getCollaboratorPermissionInputSchema, getFileContentCore, getFileContentDescription, getFileContentInputSchema, getRepositoryCore, getRepositoryDescription, getRepositoryInputSchema, getRepositoryTreeCore, getRepositoryTreeDescription, getRepositoryTreeInputSchema, listBranchesCore, listBranchesDescription, listBranchesInputSchema };
2387
+ }
2388
+ declare function createCommitOnBranch(octokit: Octokit, input: {
2389
+ owner: string;
2390
+ repo: string;
2391
+ branch: string;
2392
+ expectedHeadOid: string;
2393
+ headline: string;
2394
+ body?: string;
2395
+ additions?: Array<{
2396
+ path: string;
2397
+ contents: string;
2398
+ }>;
2399
+ deletions?: Array<{
2400
+ path: string;
2401
+ }>;
2402
+ }): Promise<{
2403
+ commitSha: string;
2404
+ commitUrl: string;
2405
+ }>;
2406
+ declare function composeCommitMessage(message: string, coAuthors?: CommitIdentity[]): string;
2407
+ declare const getRepositoryInputSchema: z.ZodObject<{
2408
+ owner: z.ZodString;
2409
+ repo: z.ZodString;
2410
+ }, z.core.$strip>;
2411
+ declare const getRepositoryDescription = "Get information about a GitHub repository including description, stars, forks, language, and default branch";
2412
+ declare function getRepositoryCore({ token, owner, repo }: {
2413
+ token: string;
2414
+ owner: string;
2415
+ repo: string;
2416
+ }): Promise<{
2417
+ name: string;
2418
+ fullName: string;
2419
+ description: string | null;
2420
+ url: string;
2421
+ defaultBranch: string;
2422
+ stars: number;
2423
+ forks: number;
2424
+ openIssues: number;
2425
+ language: string | null;
2426
+ private: boolean;
2427
+ createdAt: string;
2428
+ updatedAt: string;
2429
+ }>;
2430
+ declare const listBranchesInputSchema: z.ZodObject<{
2431
+ owner: z.ZodString;
2432
+ repo: z.ZodString;
2433
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2434
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2435
+ }, z.core.$strip>;
2436
+ declare const listBranchesDescription = "List branches in a GitHub repository. When hasMore, pass nextPage — do not repeat the same call.";
2437
+ declare function listBranchesCore({ token, owner, repo, perPage, page }: {
2438
+ token: string;
2439
+ owner: string;
2440
+ repo: string;
2441
+ perPage: number;
2442
+ page?: number;
2443
+ }): Promise<PagedList<{
2444
+ name: string;
2445
+ sha: string;
2446
+ protected: boolean;
2447
+ }>>;
2448
+ declare const getFileContentInputSchema: z.ZodObject<{
2449
+ owner: z.ZodString;
2450
+ repo: z.ZodString;
2451
+ path: z.ZodString;
2452
+ ref: z.ZodOptional<z.ZodString>;
2453
+ startLine: z.ZodOptional<z.ZodNumber>;
2454
+ endLine: z.ZodOptional<z.ZodNumber>;
2455
+ maxLines: z.ZodOptional<z.ZodNumber>;
2456
+ }, z.core.$strip>;
2457
+ 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";
2458
+ declare function getFileContentCore({ token, owner, repo, path, ref, startLine, endLine, maxLines }: {
2459
+ token: string;
2460
+ owner: string;
2461
+ repo: string;
2462
+ path: string;
2463
+ ref?: string;
2464
+ startLine?: number;
2465
+ endLine?: number;
2466
+ maxLines?: number;
2467
+ }): Promise<{
2468
+ type: "directory";
2469
+ entries: {
2470
+ name: string;
2471
+ type: "file" | "dir" | "submodule" | "symlink";
2472
+ path: string;
2473
+ }[];
2474
+ path?: undefined;
2475
+ sha?: undefined;
2476
+ size?: undefined;
2477
+ totalLines?: undefined;
2478
+ content?: undefined;
2479
+ startLine?: undefined;
2480
+ endLine?: undefined;
2481
+ truncated?: undefined;
2482
+ } | {
2483
+ type: "submodule" | "symlink";
2484
+ path: string;
2485
+ entries?: undefined;
2486
+ sha?: undefined;
2487
+ size?: undefined;
2488
+ totalLines?: undefined;
2489
+ content?: undefined;
2490
+ startLine?: undefined;
2491
+ endLine?: undefined;
2492
+ truncated?: undefined;
2493
+ } | {
2494
+ type: "file";
2495
+ path: string;
2496
+ sha: string;
2497
+ size: number;
2498
+ totalLines: number;
2499
+ content: string;
2500
+ entries?: undefined;
2501
+ startLine?: undefined;
2502
+ endLine?: undefined;
2503
+ truncated?: undefined;
2504
+ } | {
2505
+ type: "file";
2506
+ path: string;
2507
+ sha: string;
2508
+ size: number;
2509
+ totalLines: number;
2510
+ startLine: number;
2511
+ endLine: number;
2512
+ truncated: boolean;
2513
+ content: string;
2514
+ entries?: undefined;
2515
+ }>;
2516
+ declare const getRepositoryTreeInputSchema: z.ZodObject<{
2517
+ owner: z.ZodString;
2518
+ repo: z.ZodString;
2519
+ ref: z.ZodOptional<z.ZodString>;
2520
+ path: z.ZodOptional<z.ZodString>;
2521
+ recursive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2522
+ }, z.core.$strip>;
2523
+ 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.";
2524
+ declare function getRepositoryTreeCore({ token, owner, repo, ref, path, recursive }: {
2525
+ token: string;
2526
+ owner: string;
2527
+ repo: string;
2528
+ ref?: string;
2529
+ path?: string;
2530
+ recursive: boolean;
2531
+ }): Promise<{
2532
+ sha: string;
2533
+ truncated: boolean;
2534
+ path: string | undefined;
2535
+ entries: {
2536
+ path: string;
2537
+ type: string;
2538
+ size: number | undefined;
2539
+ sha: string;
2540
+ }[];
2541
+ }>;
2542
+ declare const createBranchInputSchema: z.ZodObject<{
2543
+ owner: z.ZodString;
2544
+ repo: z.ZodString;
2545
+ branch: z.ZodString;
2546
+ from: z.ZodOptional<z.ZodString>;
2547
+ }, z.core.$strip>;
2548
+ declare const createBranchDescription = "Create a new branch in a GitHub repository from an existing branch or commit SHA";
2549
+ /** Idempotent when the branch already exists at the target SHA. Not idempotent otherwise. */
2550
+ declare function createBranchCore({ token, owner, repo, branch, from }: {
2551
+ token: string;
2552
+ owner: string;
2553
+ repo: string;
2554
+ branch: string;
2555
+ from?: string;
2556
+ }): Promise<{
2557
+ ref: string;
2558
+ sha: string;
2559
+ url: string;
2560
+ }>;
2561
+ declare const deleteBranchInputSchema: z.ZodObject<{
2562
+ owner: z.ZodString;
2563
+ repo: z.ZodString;
2564
+ branch: z.ZodString;
2565
+ }, z.core.$strip>;
2566
+ declare const deleteBranchDescription = "Delete a branch from a GitHub repository permanently";
2567
+ /** Not idempotent — deleting a branch that no longer exists fails with a 422. */
2568
+ declare function deleteBranchCore({ token, owner, repo, branch }: {
2569
+ token: string;
2570
+ owner: string;
2571
+ repo: string;
2572
+ branch: string;
2573
+ }): Promise<{
2574
+ deleted: boolean;
2575
+ branch: string;
2576
+ }>;
2577
+ declare const forkRepositoryInputSchema: z.ZodObject<{
2578
+ owner: z.ZodString;
2579
+ repo: z.ZodString;
2580
+ organization: z.ZodOptional<z.ZodString>;
2581
+ name: z.ZodOptional<z.ZodString>;
2582
+ }, z.core.$strip>;
2583
+ declare const forkRepositoryDescription = "Fork a GitHub repository to the authenticated user account or a specified organization";
2584
+ /** Not idempotent — each call may create another fork attempt. */
2585
+ declare function forkRepositoryCore({ token, owner, repo, organization, name }: {
2586
+ token: string;
2587
+ owner: string;
2588
+ repo: string;
2589
+ organization?: string;
2590
+ name?: string;
2591
+ }): Promise<{
2592
+ name: string;
2593
+ fullName: string;
2594
+ url: string;
2595
+ cloneUrl: string;
2596
+ sshUrl: string;
2597
+ defaultBranch: string;
2598
+ private: boolean;
2599
+ parent: {
2600
+ fullName: string;
2601
+ url: string;
2602
+ } | null;
2603
+ }>;
2604
+ declare const createRepositoryInputSchema: z.ZodObject<{
2605
+ name: z.ZodString;
2606
+ description: z.ZodOptional<z.ZodString>;
2607
+ isPrivate: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2608
+ autoInit: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2609
+ gitignoreTemplate: z.ZodOptional<z.ZodString>;
2610
+ licenseTemplate: z.ZodOptional<z.ZodString>;
2611
+ org: z.ZodOptional<z.ZodString>;
2612
+ }, z.core.$strip>;
2613
+ declare const createRepositoryDescription = "Create a new GitHub repository for the authenticated user or a specified organization";
2614
+ /** Not idempotent — each call creates a new repository. */
2615
+ declare function createRepositoryCore({ token, name, description, isPrivate, autoInit, gitignoreTemplate, licenseTemplate, org }: {
2616
+ token: string;
2617
+ name: string;
2618
+ description?: string;
2619
+ isPrivate: boolean;
2620
+ autoInit: boolean;
2621
+ gitignoreTemplate?: string;
2622
+ licenseTemplate?: string;
2623
+ org?: string;
2624
+ }): Promise<{
2625
+ name: string;
2626
+ fullName: string;
2627
+ description: string | null;
2628
+ url: string;
2629
+ cloneUrl: string;
2630
+ sshUrl: string;
2631
+ defaultBranch: string;
2632
+ private: boolean;
2633
+ createdAt: string;
2634
+ }>;
2635
+ declare const createOrUpdateFileInputSchema: z.ZodObject<{
2636
+ owner: z.ZodString;
2637
+ repo: z.ZodString;
2638
+ path: z.ZodString;
2639
+ message: z.ZodString;
2640
+ content: z.ZodString;
2641
+ branch: z.ZodOptional<z.ZodString>;
2642
+ sha: z.ZodOptional<z.ZodString>;
2643
+ }, z.core.$strip>;
2644
+ declare const createOrUpdateFileDescription = "Create or update a file in a GitHub repository. Provide the SHA when updating an existing file.";
2645
+ /** Idempotent when updating with sha and content is unchanged. Not idempotent for new commits. */
2646
+ declare function createOrUpdateFileCore({ token, owner, repo, path, message, content, branch, sha, author, committer, coAuthors }: {
2647
+ token: string;
2648
+ owner: string;
2649
+ repo: string;
2650
+ path: string;
2651
+ message: string;
2652
+ content: string;
2653
+ branch?: string;
2654
+ sha?: string;
2655
+ author?: CommitIdentity;
2656
+ committer?: CommitIdentity;
2657
+ coAuthors?: CommitIdentity[];
2658
+ }): Promise<{
2659
+ path: string;
2660
+ sha: string;
2661
+ skipped: true;
2662
+ message: string;
2663
+ commitSha?: undefined;
2664
+ commitUrl?: undefined;
2665
+ } | {
2666
+ path: string | undefined;
2667
+ sha: string | undefined;
2668
+ commitSha: string | undefined;
2669
+ commitUrl: string | undefined;
2670
+ skipped?: undefined;
2671
+ message?: undefined;
2672
+ }>;
2673
+ declare const editFilesInputSchema: z.ZodObject<{
2674
+ owner: z.ZodString;
2675
+ repo: z.ZodString;
2676
+ branch: z.ZodString;
2677
+ baseBranch: z.ZodOptional<z.ZodString>;
2678
+ message: z.ZodString;
2679
+ edits: z.ZodArray<z.ZodObject<{
2680
+ path: z.ZodString;
2681
+ find: z.ZodOptional<z.ZodString>;
2682
+ replace: z.ZodOptional<z.ZodString>;
2683
+ content: z.ZodOptional<z.ZodString>;
2684
+ }, z.core.$strip>>;
2685
+ pullRequest: z.ZodOptional<z.ZodObject<{
2686
+ title: z.ZodString;
2687
+ body: z.ZodOptional<z.ZodString>;
2688
+ draft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
2689
+ }, z.core.$strip>>;
2690
+ }, z.core.$strip>;
2691
+ 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.";
2692
+ /** Not idempotent: each call makes a new commit. */
2693
+ declare function editFilesCore({ token, owner, repo, branch, baseBranch, message, edits, pullRequest, author, committer, coAuthors }: {
2694
+ token: string;
2695
+ owner: string;
2696
+ repo: string;
2697
+ branch: string;
2698
+ baseBranch?: string;
2699
+ message: string;
2700
+ edits: Array<{
2701
+ path: string;
2702
+ find?: string;
2703
+ replace?: string;
2704
+ content?: string;
2705
+ }>;
2706
+ pullRequest?: {
2707
+ title: string;
2708
+ body?: string;
2709
+ draft: boolean;
2710
+ };
2711
+ author?: CommitIdentity;
2712
+ committer?: CommitIdentity;
2713
+ coAuthors?: CommitIdentity[];
2714
+ }): Promise<{
2715
+ pullRequest?: {
2716
+ number: number;
2717
+ title: string;
2718
+ url: string;
2719
+ draft: boolean | undefined;
2720
+ existing: boolean;
2721
+ } | undefined;
2722
+ branch: string;
2723
+ baseBranch: string;
2724
+ createdBranch: boolean;
2725
+ files: {
2726
+ path: string;
2727
+ replacements: number;
2728
+ }[];
2729
+ commits: {
2730
+ sha?: string;
2731
+ url?: string;
2732
+ }[];
2733
+ }>;
2734
+ declare const getBranchRulesInputSchema: z.ZodObject<{
2735
+ owner: z.ZodString;
2736
+ repo: z.ZodString;
2737
+ branch: z.ZodString;
2738
+ }, z.core.$strip>;
2739
+ 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";
2740
+ declare function getBranchRulesCore({ token, owner, repo, branch }: {
2741
+ token: string;
2742
+ owner: string;
2743
+ repo: string;
2744
+ branch: string;
2745
+ }): Promise<{
2746
+ branch: string;
2747
+ protected: boolean;
2748
+ requiredStatusChecks: string[];
2749
+ rules: {
2750
+ source?: string | undefined;
2751
+ parameters?: {
2752
+ update_allows_fetch_and_merge: boolean;
2753
+ } | {
2754
+ check_response_timeout_minutes: number;
2755
+ grouping_strategy: "ALLGREEN" | "HEADGREEN";
2756
+ max_entries_to_build: number;
2757
+ max_entries_to_merge: number;
2758
+ merge_method: "MERGE" | "SQUASH" | "REBASE";
2759
+ min_entries_to_merge: number;
2760
+ min_entries_to_merge_wait_minutes: number;
2761
+ } | {
2762
+ required_deployment_environments: string[];
2763
+ } | {
2764
+ allowed_merge_methods?: ("merge" | "squash" | "rebase")[];
2765
+ automatic_copilot_code_review_enabled?: boolean;
2766
+ dismiss_stale_reviews_on_push: boolean;
2767
+ require_code_owner_review: boolean;
2768
+ require_last_push_approval: boolean;
2769
+ required_approving_review_count: number;
2770
+ required_review_thread_resolution: boolean;
2771
+ } | {
2772
+ do_not_enforce_on_create?: boolean;
2773
+ required_status_checks: {
2774
+ context: string;
2775
+ integration_id?: number;
2776
+ }[];
2777
+ strict_required_status_checks_policy: boolean;
2778
+ } | {
2779
+ name?: string;
2780
+ negate?: boolean;
2781
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
2782
+ pattern: string;
2783
+ } | {
2784
+ name?: string;
2785
+ negate?: boolean;
2786
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
2787
+ pattern: string;
2788
+ } | {
2789
+ name?: string;
2790
+ negate?: boolean;
2791
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
2792
+ pattern: string;
2793
+ } | {
2794
+ name?: string;
2795
+ negate?: boolean;
2796
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
2797
+ pattern: string;
2798
+ } | {
2799
+ name?: string;
2800
+ negate?: boolean;
2801
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
2802
+ pattern: string;
2803
+ } | {
2804
+ restricted_file_paths: string[];
2805
+ } | {
2806
+ max_file_path_length: number;
2807
+ } | {
2808
+ restricted_file_extensions: string[];
2809
+ } | {
2810
+ max_file_size: number;
2811
+ } | {
2812
+ do_not_enforce_on_create?: boolean;
2813
+ workflows: {
2814
+ path: string;
2815
+ ref?: string;
2816
+ repository_id: number;
2817
+ sha?: string;
2818
+ }[];
2819
+ } | {
2820
+ code_scanning_tools: {
2821
+ alerts_threshold: "none" | "errors" | "errors_and_warnings" | "all";
2822
+ security_alerts_threshold: "none" | "critical" | "high_or_higher" | "medium_or_higher" | "all";
2823
+ tool: string;
2824
+ }[];
2825
+ } | {
2826
+ review_draft_pull_requests?: boolean;
2827
+ review_on_push?: boolean;
2828
+ } | undefined;
2829
+ 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";
2830
+ }[];
2831
+ }>;
2832
+ declare const getCollaboratorPermissionInputSchema: z.ZodObject<{
2833
+ owner: z.ZodString;
2834
+ repo: z.ZodString;
2835
+ username: z.ZodString;
2836
+ }, z.core.$strip>;
2837
+ declare const getCollaboratorPermissionDescription = "Get a user's permission on a repository: admin, write, read, or none, plus their role (admin, maintain, write, triage, read, or a custom role). Use it to check whether a user may trigger the bot or approve an action. On a public repository, every user has at least read";
2838
+ declare function getCollaboratorPermissionCore({ token, owner, repo, username }: {
2839
+ token: string;
2840
+ owner: string;
2841
+ repo: string;
2842
+ username: string;
2843
+ }): Promise<{
2844
+ username: string;
2845
+ permission: string;
2846
+ roleName: string;
2847
+ }>;
2848
+ declare namespace search_d_exports {
2849
+ export { searchCodeCore, searchCodeDescription, searchCodeInputSchema, searchIssuesCore, searchIssuesDescription, searchIssuesInputSchema, searchRepositoriesCore, searchRepositoriesDescription, searchRepositoriesInputSchema };
2850
+ }
2851
+ declare const searchCodeInputSchema: z.ZodObject<{
2852
+ query: z.ZodString;
2853
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
2854
+ }, z.core.$strip>;
2855
+ declare const searchCodeDescription = "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.";
2856
+ declare function searchCodeCore({ token, query, perPage }: {
2857
+ token: string;
2858
+ query: string;
2859
+ perPage: number;
2860
+ }): Promise<{
2861
+ totalCount: number;
2862
+ items: {
2863
+ name: string;
2864
+ path: string;
1982
2865
  url: string;
1983
2866
  repository: string;
1984
2867
  sha: string;
@@ -2330,11 +3213,17 @@ declare const GITHUB_TOOL_CORES: {
2330
3213
  readonly forkRepository: typeof forkRepositoryCore;
2331
3214
  readonly createRepository: typeof createRepositoryCore;
2332
3215
  readonly createOrUpdateFile: typeof createOrUpdateFileCore;
3216
+ readonly editFiles: typeof editFilesCore;
3217
+ readonly getBranchRules: typeof getBranchRulesCore;
3218
+ readonly getCollaboratorPermission: typeof getCollaboratorPermissionCore;
2333
3219
  readonly listPullRequests: typeof listPullRequestsCore;
2334
3220
  readonly getPullRequest: typeof getPullRequestCore;
2335
3221
  readonly createPullRequest: typeof createPullRequestCore;
2336
3222
  readonly mergePullRequest: typeof mergePullRequestCore;
3223
+ readonly enablePullRequestAutoMerge: typeof enablePullRequestAutoMergeCore;
3224
+ readonly disablePullRequestAutoMerge: typeof disablePullRequestAutoMergeCore;
2337
3225
  readonly updatePullRequest: typeof updatePullRequestCore;
3226
+ readonly updatePullRequestBranch: typeof updatePullRequestBranchCore;
2338
3227
  readonly addPullRequestComment: typeof addPullRequestCommentCore;
2339
3228
  readonly updatePullRequestComment: typeof updatePullRequestCommentCore;
2340
3229
  readonly deletePullRequestComment: typeof deletePullRequestCommentCore;
@@ -2364,6 +3253,9 @@ declare const GITHUB_TOOL_CORES: {
2364
3253
  readonly deleteLabel: typeof deleteLabelCore;
2365
3254
  readonly addAssignees: typeof addAssigneesCore;
2366
3255
  readonly removeAssignees: typeof removeAssigneesCore;
3256
+ readonly listMilestones: typeof listMilestonesCore;
3257
+ readonly listSubIssues: typeof listSubIssuesCore;
3258
+ readonly addSubIssue: typeof addSubIssueCore;
2367
3259
  readonly listIssueReactions: typeof listIssueReactionsCore;
2368
3260
  readonly addIssueReaction: typeof addIssueReactionCore;
2369
3261
  readonly listCommentReactions: typeof listCommentReactionsCore;
@@ -2397,6 +3289,7 @@ declare const GITHUB_TOOL_CORES: {
2397
3289
  readonly rerunWorkflowRun: typeof rerunWorkflowRunCore;
2398
3290
  readonly listCheckRuns: typeof listCheckRunsCore;
2399
3291
  readonly getCombinedStatus: typeof getCombinedStatusCore;
3292
+ readonly createCommitStatus: typeof createCommitStatusCore;
2400
3293
  readonly getCiFailureContext: typeof getCiFailureContextCore;
2401
3294
  readonly listReleases: typeof listReleasesCore;
2402
3295
  readonly getLatestRelease: typeof getLatestReleaseCore;
@@ -2405,13 +3298,20 @@ declare const GITHUB_TOOL_CORES: {
2405
3298
  readonly createRelease: typeof createReleaseCore;
2406
3299
  readonly updateRelease: typeof updateReleaseCore;
2407
3300
  readonly deleteRelease: typeof deleteReleaseCore;
3301
+ readonly listCodeScanningAlerts: typeof listCodeScanningAlertsCore;
3302
+ readonly listDependabotAlerts: typeof listDependabotAlertsCore;
3303
+ readonly listSecretScanningAlerts: typeof listSecretScanningAlertsCore;
2408
3304
  };
2409
3305
  //#endregion
2410
3306
  //#region src/tanstack/tools.d.ts
2411
3307
  type Catalog = typeof GITHUB_TOOL_CATALOG;
2412
- /** A TanStack server tool with the catalog's input schema and core return type. */
3308
+ type CoreResult<N extends GithubToolName> = Awaited<ReturnType<(typeof GITHUB_TOOL_CORES)[N]>>;
3309
+ /**
3310
+ * A TanStack server tool with the catalog's input schema and core return type. A write tool created
3311
+ * with `dryRun: true` returns a `GithubDryRunResult` instead, so narrow with `'dryRun' in result`.
3312
+ */
2413
3313
  type GithubTanstackTool<N extends GithubToolName = GithubToolName> = N extends GithubToolName ? Omit<ServerTool<Catalog[N]['inputSchema'], undefined, N, unknown, boolean>, 'execute'> & {
2414
- execute: (input: z.input<Catalog[N]['inputSchema']>) => ReturnType<(typeof GITHUB_TOOL_CORES)[N]>;
3314
+ execute: (input: z.input<Catalog[N]['inputSchema']>) => Promise<N extends GithubWriteToolName ? CoreResult<N> | GithubDryRunResult : CoreResult<N>>;
2415
3315
  } : never;
2416
3316
  /** Supported TanStack tool customizations. */
2417
3317
  type TanstackToolOverrides = {
@@ -2425,6 +3325,10 @@ type TanstackToolOptions = Omit<TanstackToolOverrides, 'needsApproval'> & {
2425
3325
  author?: CommitIdentity;
2426
3326
  committer?: CommitIdentity;
2427
3327
  coAuthors?: CommitIdentity[];
3328
+ /** Repositories and branches the tool may act on, checked before each call reaches GitHub. */
3329
+ guardrails?: GithubGuardrails;
3330
+ /** Send no write to GitHub: a write returns a `GithubDryRunResult` instead, after the guardrails check. */
3331
+ dryRun?: boolean;
2428
3332
  };
2429
3333
  /** Configuration for a native array of GitHub server tools. */
2430
3334
  type CreateGithubToolsOptions = Omit<TanstackToolOptions, 'description' | 'needsApproval'> & {
@@ -2452,6 +3356,7 @@ type GithubEvaluationOptions = {
2452
3356
  /** Maximum number of combined presets. @default 2 */
2453
3357
  maxPresets?: number;
2454
3358
  };
3359
+ export declare function selectPresets(messages: readonly ModelMessage[], options?: GithubEvaluationOptions, signal?: AbortSignal): Promise<RoutablePreset[]>;
2455
3360
  //#endregion
2456
3361
  //#region src/tanstack/agent.d.ts
2457
3362
  type NativeOptions<A extends AnyTextAdapter> = Parameters<typeof chat<A, undefined, true>>[0];
@@ -2485,7 +3390,7 @@ type GithubAgent<A extends AnyTextAdapter> = {
2485
3390
  stream: (options: GithubAgentCallOptions<A>) => ChatStream;
2486
3391
  };
2487
3392
  /** Create a GitHub agent with preset instructions, tools, and automatic approval middleware. */
2488
- export declare function createGithubAgent<A extends AnyTextAdapter>({ token, preset, requireApproval, overrides, context, author, committer, coAuthors, instructions, additionalInstructions, evaluation, middleware, ...settings }: CreateGithubAgentOptions<A>): GithubAgent<A>;
3393
+ export declare function createGithubAgent<A extends AnyTextAdapter>({ token, preset, requireApproval, overrides, context, author, committer, coAuthors, guardrails, dryRun, instructions, additionalInstructions, evaluation, middleware, ...settings }: CreateGithubAgentOptions<A>): GithubAgent<A>;
2489
3394
  //#endregion
2490
3395
  //#region src/tanstack/approval.d.ts
2491
3396
  /** Options for GitHub approval middleware. Register githubToolApproval with chat(). */
@@ -2532,11 +3437,13 @@ export declare const listBranches: (token: GithubTokenInput, options?: TanstackT
2532
3437
  repo: string;
2533
3438
  perPage?: number | undefined;
2534
3439
  page?: number | undefined;
2535
- }) => Promise<PagedList<{
2536
- name: string;
2537
- sha: string;
2538
- protected: boolean;
2539
- }>>;
3440
+ }) => Promise<{
3441
+ items: {
3442
+ name: string;
3443
+ sha: string;
3444
+ protected: boolean;
3445
+ }[];
3446
+ } & PagingFields>;
2540
3447
  };
2541
3448
  /** Create the TanStack `getFileContent` server tool. */
2542
3449
  export declare const getFileContent: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -2648,7 +3555,7 @@ export declare const createBranch: (token: GithubTokenInput, options?: TanstackT
2648
3555
  ref: string;
2649
3556
  sha: string;
2650
3557
  url: string;
2651
- }>;
3558
+ } | GithubDryRunResult>;
2652
3559
  };
2653
3560
  /** Create the TanStack `deleteBranch` server tool. */
2654
3561
  export declare const deleteBranch: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -2663,7 +3570,7 @@ export declare const deleteBranch: (token: GithubTokenInput, options?: TanstackT
2663
3570
  }) => Promise<{
2664
3571
  deleted: boolean;
2665
3572
  branch: string;
2666
- }>;
3573
+ } | GithubDryRunResult>;
2667
3574
  };
2668
3575
  /** Create the TanStack `forkRepository` server tool. */
2669
3576
  export declare const forkRepository: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -2689,7 +3596,7 @@ export declare const forkRepository: (token: GithubTokenInput, options?: Tanstac
2689
3596
  fullName: string;
2690
3597
  url: string;
2691
3598
  } | null;
2692
- }>;
3599
+ } | GithubDryRunResult>;
2693
3600
  };
2694
3601
  /** Create the TanStack `createRepository` server tool. */
2695
3602
  export declare const createRepository: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -2719,7 +3626,7 @@ export declare const createRepository: (token: GithubTokenInput, options?: Tanst
2719
3626
  defaultBranch: string;
2720
3627
  private: boolean;
2721
3628
  createdAt: string;
2722
- }>;
3629
+ } | GithubDryRunResult>;
2723
3630
  };
2724
3631
  /** Create the TanStack `createOrUpdateFile` server tool. */
2725
3632
  export declare const createOrUpdateFile: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -2753,7 +3660,64 @@ export declare const createOrUpdateFile: (token: GithubTokenInput, options?: Tan
2753
3660
  commitUrl: string | undefined;
2754
3661
  skipped?: undefined;
2755
3662
  message?: undefined;
2756
- }>;
3663
+ } | GithubDryRunResult>;
3664
+ };
3665
+ /** Create the TanStack `editFiles` server tool. */
3666
+ export declare const editFiles: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
3667
+ owner: import("zod").ZodString;
3668
+ repo: import("zod").ZodString;
3669
+ branch: import("zod").ZodString;
3670
+ baseBranch: import("zod").ZodOptional<import("zod").ZodString>;
3671
+ message: import("zod").ZodString;
3672
+ edits: import("zod").ZodArray<import("zod").ZodObject<{
3673
+ path: import("zod").ZodString;
3674
+ find: import("zod").ZodOptional<import("zod").ZodString>;
3675
+ replace: import("zod").ZodOptional<import("zod").ZodString>;
3676
+ content: import("zod").ZodOptional<import("zod").ZodString>;
3677
+ }, import("zod/v4/core").$strip>>;
3678
+ pullRequest: import("zod").ZodOptional<import("zod").ZodObject<{
3679
+ title: import("zod").ZodString;
3680
+ body: import("zod").ZodOptional<import("zod").ZodString>;
3681
+ draft: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
3682
+ }, import("zod/v4/core").$strip>>;
3683
+ }, import("zod/v4/core").$strip>, undefined, "editFiles", unknown, boolean, undefined>, "execute"> & {
3684
+ execute: (input: {
3685
+ owner: string;
3686
+ repo: string;
3687
+ branch: string;
3688
+ message: string;
3689
+ edits: {
3690
+ path: string;
3691
+ find?: string | undefined;
3692
+ replace?: string | undefined;
3693
+ content?: string | undefined;
3694
+ }[];
3695
+ baseBranch?: string | undefined;
3696
+ pullRequest?: {
3697
+ title: string;
3698
+ body?: string | undefined;
3699
+ draft?: boolean | undefined;
3700
+ } | undefined;
3701
+ }) => Promise<{
3702
+ pullRequest?: {
3703
+ number: number;
3704
+ title: string;
3705
+ url: string;
3706
+ draft: boolean | undefined;
3707
+ existing: boolean;
3708
+ } | undefined;
3709
+ branch: string;
3710
+ baseBranch: string;
3711
+ createdBranch: boolean;
3712
+ files: {
3713
+ path: string;
3714
+ replacements: number;
3715
+ }[];
3716
+ commits: {
3717
+ sha?: string;
3718
+ url?: string;
3719
+ }[];
3720
+ } | GithubDryRunResult>;
2757
3721
  };
2758
3722
  /** Create the TanStack `listPullRequests` server tool. */
2759
3723
  export declare const listPullRequests: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -2775,18 +3739,20 @@ export declare const listPullRequests: (token: GithubTokenInput, options?: Tanst
2775
3739
  perPage?: number | undefined;
2776
3740
  page?: number | undefined;
2777
3741
  maxPages?: number | undefined;
2778
- }) => Promise<PagedList<{
2779
- number: number;
2780
- title: string;
2781
- state: string;
2782
- url: string;
2783
- author: string | undefined;
2784
- branch: string;
2785
- base: string;
2786
- draft: boolean | undefined;
2787
- createdAt: string;
2788
- updatedAt: string;
2789
- }>>;
3742
+ }) => Promise<{
3743
+ items: {
3744
+ number: number;
3745
+ title: string;
3746
+ state: string;
3747
+ url: string;
3748
+ author: string | undefined;
3749
+ branch: string;
3750
+ base: string;
3751
+ draft: boolean | undefined;
3752
+ createdAt: string;
3753
+ updatedAt: string;
3754
+ }[];
3755
+ } & PagingFields>;
2790
3756
  };
2791
3757
  /** Create the TanStack `getPullRequest` server tool. */
2792
3758
  export declare const getPullRequest: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -2816,6 +3782,11 @@ export declare const getPullRequest: (token: GithubTokenInput, options?: Tanstac
2816
3782
  draft: boolean | undefined;
2817
3783
  merged: boolean;
2818
3784
  mergeable: boolean | null;
3785
+ mergeableState: string;
3786
+ autoMerge: {
3787
+ mergeMethod: "merge" | "squash" | "rebase";
3788
+ enabledBy: string;
3789
+ } | null;
2819
3790
  additions: number;
2820
3791
  deletions: number;
2821
3792
  changedFiles: number;
@@ -2850,7 +3821,7 @@ export declare const createPullRequest: (token: GithubTokenInput, options?: Tans
2850
3821
  draft: boolean | undefined;
2851
3822
  branch: string;
2852
3823
  base: string;
2853
- }>;
3824
+ } | GithubDryRunResult>;
2854
3825
  };
2855
3826
  /** Create the TanStack `mergePullRequest` server tool. */
2856
3827
  export declare const mergePullRequest: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -2876,6 +3847,165 @@ export declare const mergePullRequest: (token: GithubTokenInput, options?: Tanst
2876
3847
  merged: boolean;
2877
3848
  message: string;
2878
3849
  sha: string;
3850
+ } | GithubDryRunResult>;
3851
+ };
3852
+ /** Create the TanStack `enablePullRequestAutoMerge` server tool. */
3853
+ export declare const enablePullRequestAutoMerge: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
3854
+ owner: import("zod").ZodString;
3855
+ repo: import("zod").ZodString;
3856
+ pullNumber: import("zod").ZodNumber;
3857
+ mergeMethod: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
3858
+ merge: "merge";
3859
+ squash: "squash";
3860
+ rebase: "rebase";
3861
+ }>>>;
3862
+ commitTitle: import("zod").ZodOptional<import("zod").ZodString>;
3863
+ commitMessage: import("zod").ZodOptional<import("zod").ZodString>;
3864
+ }, import("zod/v4/core").$strip>, undefined, "enablePullRequestAutoMerge", unknown, boolean, undefined>, "execute"> & {
3865
+ execute: (input: {
3866
+ owner: string;
3867
+ repo: string;
3868
+ pullNumber: number;
3869
+ mergeMethod?: "merge" | "squash" | "rebase" | undefined;
3870
+ commitTitle?: string | undefined;
3871
+ commitMessage?: string | undefined;
3872
+ }) => Promise<{
3873
+ number: number;
3874
+ url: string;
3875
+ autoMerge: {
3876
+ enabledAt: string;
3877
+ mergeMethod: string;
3878
+ } | null;
3879
+ } | GithubDryRunResult>;
3880
+ };
3881
+ /** Create the TanStack `disablePullRequestAutoMerge` server tool. */
3882
+ export declare const disablePullRequestAutoMerge: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
3883
+ owner: import("zod").ZodString;
3884
+ repo: import("zod").ZodString;
3885
+ pullNumber: import("zod").ZodNumber;
3886
+ }, import("zod/v4/core").$strip>, undefined, "disablePullRequestAutoMerge", unknown, boolean, undefined>, "execute"> & {
3887
+ execute: (input: {
3888
+ owner: string;
3889
+ repo: string;
3890
+ pullNumber: number;
3891
+ }) => Promise<{
3892
+ number: number;
3893
+ url: string;
3894
+ autoMerge: null;
3895
+ } | GithubDryRunResult>;
3896
+ };
3897
+ /** Create the TanStack `getBranchRules` server tool. */
3898
+ export declare const getBranchRules: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
3899
+ owner: import("zod").ZodString;
3900
+ repo: import("zod").ZodString;
3901
+ branch: import("zod").ZodString;
3902
+ }, import("zod/v4/core").$strip>, undefined, "getBranchRules", unknown, boolean, undefined>, "execute"> & {
3903
+ execute: (input: {
3904
+ owner: string;
3905
+ repo: string;
3906
+ branch: string;
3907
+ }) => Promise<{
3908
+ branch: string;
3909
+ protected: boolean;
3910
+ requiredStatusChecks: string[];
3911
+ rules: {
3912
+ source?: string | undefined;
3913
+ parameters?: {
3914
+ update_allows_fetch_and_merge: boolean;
3915
+ } | {
3916
+ check_response_timeout_minutes: number;
3917
+ grouping_strategy: "ALLGREEN" | "HEADGREEN";
3918
+ max_entries_to_build: number;
3919
+ max_entries_to_merge: number;
3920
+ merge_method: "MERGE" | "SQUASH" | "REBASE";
3921
+ min_entries_to_merge: number;
3922
+ min_entries_to_merge_wait_minutes: number;
3923
+ } | {
3924
+ required_deployment_environments: string[];
3925
+ } | {
3926
+ allowed_merge_methods?: ("merge" | "squash" | "rebase")[];
3927
+ automatic_copilot_code_review_enabled?: boolean;
3928
+ dismiss_stale_reviews_on_push: boolean;
3929
+ require_code_owner_review: boolean;
3930
+ require_last_push_approval: boolean;
3931
+ required_approving_review_count: number;
3932
+ required_review_thread_resolution: boolean;
3933
+ } | {
3934
+ do_not_enforce_on_create?: boolean;
3935
+ required_status_checks: {
3936
+ context: string;
3937
+ integration_id?: number;
3938
+ }[];
3939
+ strict_required_status_checks_policy: boolean;
3940
+ } | {
3941
+ name?: string;
3942
+ negate?: boolean;
3943
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
3944
+ pattern: string;
3945
+ } | {
3946
+ name?: string;
3947
+ negate?: boolean;
3948
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
3949
+ pattern: string;
3950
+ } | {
3951
+ name?: string;
3952
+ negate?: boolean;
3953
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
3954
+ pattern: string;
3955
+ } | {
3956
+ name?: string;
3957
+ negate?: boolean;
3958
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
3959
+ pattern: string;
3960
+ } | {
3961
+ name?: string;
3962
+ negate?: boolean;
3963
+ operator: "starts_with" | "ends_with" | "contains" | "regex";
3964
+ pattern: string;
3965
+ } | {
3966
+ restricted_file_paths: string[];
3967
+ } | {
3968
+ max_file_path_length: number;
3969
+ } | {
3970
+ restricted_file_extensions: string[];
3971
+ } | {
3972
+ max_file_size: number;
3973
+ } | {
3974
+ do_not_enforce_on_create?: boolean;
3975
+ workflows: {
3976
+ path: string;
3977
+ ref?: string;
3978
+ repository_id: number;
3979
+ sha?: string;
3980
+ }[];
3981
+ } | {
3982
+ code_scanning_tools: {
3983
+ alerts_threshold: "none" | "errors" | "errors_and_warnings" | "all";
3984
+ security_alerts_threshold: "none" | "critical" | "high_or_higher" | "medium_or_higher" | "all";
3985
+ tool: string;
3986
+ }[];
3987
+ } | {
3988
+ review_draft_pull_requests?: boolean;
3989
+ review_on_push?: boolean;
3990
+ } | undefined;
3991
+ 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";
3992
+ }[];
3993
+ }>;
3994
+ };
3995
+ /** Create the TanStack `getCollaboratorPermission` server tool. */
3996
+ export declare const getCollaboratorPermission: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
3997
+ owner: import("zod").ZodString;
3998
+ repo: import("zod").ZodString;
3999
+ username: import("zod").ZodString;
4000
+ }, import("zod/v4/core").$strip>, undefined, "getCollaboratorPermission", unknown, boolean, undefined>, "execute"> & {
4001
+ execute: (input: {
4002
+ owner: string;
4003
+ repo: string;
4004
+ username: string;
4005
+ }) => Promise<{
4006
+ username: string;
4007
+ permission: string;
4008
+ roleName: string;
2879
4009
  }>;
2880
4010
  };
2881
4011
  /** Create the TanStack `updatePullRequest` server tool. */
@@ -2909,7 +4039,24 @@ export declare const updatePullRequest: (token: GithubTokenInput, options?: Tans
2909
4039
  url: string;
2910
4040
  base: string;
2911
4041
  updatedAt: string;
2912
- }>;
4042
+ } | GithubDryRunResult>;
4043
+ };
4044
+ /** Create the TanStack `updatePullRequestBranch` server tool. */
4045
+ export declare const updatePullRequestBranch: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
4046
+ owner: import("zod").ZodString;
4047
+ repo: import("zod").ZodString;
4048
+ pullNumber: import("zod").ZodNumber;
4049
+ expectedHeadSha: import("zod").ZodOptional<import("zod").ZodString>;
4050
+ }, import("zod/v4/core").$strip>, undefined, "updatePullRequestBranch", unknown, boolean, undefined>, "execute"> & {
4051
+ execute: (input: {
4052
+ owner: string;
4053
+ repo: string;
4054
+ pullNumber: number;
4055
+ expectedHeadSha?: string | undefined;
4056
+ }) => Promise<{
4057
+ message: string | undefined;
4058
+ url: string | undefined;
4059
+ } | GithubDryRunResult>;
2913
4060
  };
2914
4061
  /** Create the TanStack `addPullRequestComment` server tool. */
2915
4062
  export declare const addPullRequestComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -2929,7 +4076,7 @@ export declare const addPullRequestComment: (token: GithubTokenInput, options?:
2929
4076
  body: string | undefined;
2930
4077
  author: string | undefined;
2931
4078
  createdAt: string;
2932
- }>;
4079
+ } | GithubDryRunResult>;
2933
4080
  };
2934
4081
  /** Create the TanStack `updatePullRequestComment` server tool. */
2935
4082
  export declare const updatePullRequestComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -2948,7 +4095,7 @@ export declare const updatePullRequestComment: (token: GithubTokenInput, options
2948
4095
  url: string;
2949
4096
  body: string | undefined;
2950
4097
  updatedAt: string;
2951
- }>;
4098
+ } | GithubDryRunResult>;
2952
4099
  };
2953
4100
  /** Create the TanStack `deletePullRequestComment` server tool. */
2954
4101
  export declare const deletePullRequestComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -2963,7 +4110,7 @@ export declare const deletePullRequestComment: (token: GithubTokenInput, options
2963
4110
  }) => Promise<{
2964
4111
  deleted: boolean;
2965
4112
  commentId: number;
2966
- }>;
4113
+ } | GithubDryRunResult>;
2967
4114
  };
2968
4115
  /** Create the TanStack `listPullRequestFiles` server tool. */
2969
4116
  export declare const listPullRequestFiles: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -2983,14 +4130,16 @@ export declare const listPullRequestFiles: (token: GithubTokenInput, options?: T
2983
4130
  filenames?: string[] | undefined;
2984
4131
  perPage?: number | undefined;
2985
4132
  page?: number | undefined;
2986
- }) => Promise<PagedList<{
2987
- patch?: string | undefined;
2988
- filename: string;
2989
- status: "added" | "removed" | "modified" | "renamed" | "copied" | "changed" | "unchanged";
2990
- additions: number;
2991
- deletions: number;
2992
- changes: number;
2993
- }>>;
4133
+ }) => Promise<{
4134
+ items: {
4135
+ patch?: string | undefined;
4136
+ filename: string;
4137
+ status: "added" | "removed" | "modified" | "renamed" | "copied" | "changed" | "unchanged";
4138
+ additions: number;
4139
+ deletions: number;
4140
+ changes: number;
4141
+ }[];
4142
+ } & PagingFields>;
2994
4143
  };
2995
4144
  /** Create the TanStack `listPullRequestReviews` server tool. */
2996
4145
  export declare const listPullRequestReviews: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3006,14 +4155,16 @@ export declare const listPullRequestReviews: (token: GithubTokenInput, options?:
3006
4155
  pullNumber: number;
3007
4156
  perPage?: number | undefined;
3008
4157
  page?: number | undefined;
3009
- }) => Promise<PagedList<{
3010
- id: number;
3011
- state: string;
3012
- body: string;
3013
- author: string | undefined;
3014
- url: string;
3015
- submittedAt: string | undefined;
3016
- }>>;
4158
+ }) => Promise<{
4159
+ items: {
4160
+ id: number;
4161
+ state: string;
4162
+ body: string;
4163
+ author: string | undefined;
4164
+ url: string;
4165
+ submittedAt: string | undefined;
4166
+ }[];
4167
+ } & PagingFields>;
3017
4168
  };
3018
4169
  /** Create the TanStack `createPullRequestReview` server tool. */
3019
4170
  export declare const createPullRequestReview: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3034,6 +4185,11 @@ export declare const createPullRequestReview: (token: GithubTokenInput, options?
3034
4185
  LEFT: "LEFT";
3035
4186
  RIGHT: "RIGHT";
3036
4187
  }>>;
4188
+ startLine: import("zod").ZodOptional<import("zod").ZodNumber>;
4189
+ startSide: import("zod").ZodOptional<import("zod").ZodEnum<{
4190
+ LEFT: "LEFT";
4191
+ RIGHT: "RIGHT";
4192
+ }>>;
3037
4193
  }, import("zod/v4/core").$strip>>>;
3038
4194
  }, import("zod/v4/core").$strip>, undefined, "createPullRequestReview", unknown, boolean, undefined>, "execute"> & {
3039
4195
  execute: (input: {
@@ -3047,6 +4203,8 @@ export declare const createPullRequestReview: (token: GithubTokenInput, options?
3047
4203
  body: string;
3048
4204
  line?: number | undefined;
3049
4205
  side?: "LEFT" | "RIGHT" | undefined;
4206
+ startLine?: number | undefined;
4207
+ startSide?: "LEFT" | "RIGHT" | undefined;
3050
4208
  }[] | undefined;
3051
4209
  }) => Promise<{
3052
4210
  id: number;
@@ -3055,7 +4213,7 @@ export declare const createPullRequestReview: (token: GithubTokenInput, options?
3055
4213
  url: string;
3056
4214
  author: string | undefined;
3057
4215
  submittedAt: string | undefined;
3058
- }>;
4216
+ } | GithubDryRunResult>;
3059
4217
  };
3060
4218
  /** Create the TanStack `listPullRequestReviewThreads` server tool. */
3061
4219
  export declare const listPullRequestReviewThreads: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3131,7 +4289,7 @@ export declare const replyToReviewComment: (token: GithubTokenInput, options?: T
3131
4289
  url: string;
3132
4290
  author: string;
3133
4291
  createdAt: string;
3134
- }>;
4292
+ } | GithubDryRunResult>;
3135
4293
  };
3136
4294
  /** Create the TanStack `resolveReviewThread` server tool. */
3137
4295
  export declare const resolveReviewThread: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3147,7 +4305,7 @@ export declare const resolveReviewThread: (token: GithubTokenInput, options?: Ta
3147
4305
  threadId: string;
3148
4306
  isResolved: boolean;
3149
4307
  error?: undefined;
3150
- }>;
4308
+ } | GithubDryRunResult>;
3151
4309
  };
3152
4310
  /** Create the TanStack `requestReviewers` server tool. */
3153
4311
  export declare const requestReviewers: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3168,7 +4326,7 @@ export declare const requestReviewers: (token: GithubTokenInput, options?: Tanst
3168
4326
  url: string;
3169
4327
  requestedReviewers: string[] | undefined;
3170
4328
  requestedTeams: string[] | undefined;
3171
- }>;
4329
+ } | GithubDryRunResult>;
3172
4330
  };
3173
4331
  /** Create the TanStack `getPullRequestContext` server tool. */
3174
4332
  export declare const getPullRequestContext: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3180,6 +4338,7 @@ export declare const getPullRequestContext: (token: GithubTokenInput, options?:
3180
4338
  includeChecks: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
3181
4339
  includePatch: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
3182
4340
  filesPerPage: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
4341
+ includeLinkedIssues: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
3183
4342
  detail: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
3184
4343
  summary: "summary";
3185
4344
  full: "full";
@@ -3194,8 +4353,16 @@ export declare const getPullRequestContext: (token: GithubTokenInput, options?:
3194
4353
  includeChecks?: boolean | undefined;
3195
4354
  includePatch?: boolean | undefined;
3196
4355
  filesPerPage?: number | undefined;
4356
+ includeLinkedIssues?: boolean | undefined;
3197
4357
  detail?: "summary" | "full" | undefined;
3198
4358
  }) => Promise<{
4359
+ linkedIssues?: {
4360
+ repository: string;
4361
+ number: number;
4362
+ title: string;
4363
+ state: string;
4364
+ url: string;
4365
+ }[] | undefined;
3199
4366
  checks?: {
3200
4367
  checkRuns: {
3201
4368
  hasMore: boolean;
@@ -3255,6 +4422,11 @@ export declare const getPullRequestContext: (token: GithubTokenInput, options?:
3255
4422
  draft: boolean | undefined;
3256
4423
  merged: boolean;
3257
4424
  mergeable: boolean | null;
4425
+ mergeableState: string;
4426
+ autoMerge: {
4427
+ mergeMethod: "merge" | "squash" | "rebase";
4428
+ enabledBy: string;
4429
+ } | null;
3258
4430
  additions: number;
3259
4431
  deletions: number;
3260
4432
  changedFiles: number;
@@ -3334,16 +4506,18 @@ export declare const listIssues: (token: GithubTokenInput, options?: TanstackToo
3334
4506
  perPage?: number | undefined;
3335
4507
  page?: number | undefined;
3336
4508
  maxPages?: number | undefined;
3337
- }) => Promise<PagedList<{
3338
- number: number;
3339
- title: string;
3340
- state: string;
3341
- url: string;
3342
- author: string | undefined;
3343
- labels: (string | undefined)[];
3344
- createdAt: string;
3345
- updatedAt: string;
3346
- }>>;
4509
+ }) => Promise<{
4510
+ items: {
4511
+ number: number;
4512
+ title: string;
4513
+ state: string;
4514
+ url: string;
4515
+ author: string | undefined;
4516
+ labels: (string | undefined)[];
4517
+ createdAt: string;
4518
+ updatedAt: string;
4519
+ }[];
4520
+ } & PagingFields>;
3347
4521
  };
3348
4522
  /** Create the TanStack `getIssue` server tool. */
3349
4523
  export declare const getIssue: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3394,14 +4568,16 @@ export declare const listIssueComments: (token: GithubTokenInput, options?: Tans
3394
4568
  perPage?: number | undefined;
3395
4569
  page?: number | undefined;
3396
4570
  detail?: "summary" | "full" | undefined;
3397
- }) => Promise<PagedList<{
3398
- id: number;
3399
- url: string;
3400
- body: string | null | undefined;
3401
- author: string | undefined;
3402
- createdAt: string;
3403
- updatedAt: string;
3404
- }>>;
4571
+ }) => Promise<{
4572
+ items: {
4573
+ id: number;
4574
+ url: string;
4575
+ body: string | null | undefined;
4576
+ author: string | undefined;
4577
+ createdAt: string;
4578
+ updatedAt: string;
4579
+ }[];
4580
+ } & PagingFields>;
3405
4581
  };
3406
4582
  /** Create the TanStack `createIssue` server tool. */
3407
4583
  export declare const createIssue: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3411,6 +4587,7 @@ export declare const createIssue: (token: GithubTokenInput, options?: TanstackTo
3411
4587
  body: import("zod").ZodOptional<import("zod").ZodString>;
3412
4588
  labels: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
3413
4589
  assignees: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
4590
+ milestone: import("zod").ZodOptional<import("zod").ZodNumber>;
3414
4591
  }, import("zod/v4/core").$strip>, undefined, "createIssue", unknown, boolean, undefined>, "execute"> & {
3415
4592
  execute: (input: {
3416
4593
  owner: string;
@@ -3419,13 +4596,14 @@ export declare const createIssue: (token: GithubTokenInput, options?: TanstackTo
3419
4596
  body?: string | undefined;
3420
4597
  labels?: string[] | undefined;
3421
4598
  assignees?: string[] | undefined;
4599
+ milestone?: number | undefined;
3422
4600
  }) => Promise<{
3423
4601
  number: number;
3424
4602
  title: string;
3425
4603
  url: string;
3426
4604
  state: string;
3427
4605
  labels: (string | undefined)[];
3428
- }>;
4606
+ } | GithubDryRunResult>;
3429
4607
  };
3430
4608
  /** Create the TanStack `addIssueComment` server tool. */
3431
4609
  export declare const addIssueComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3445,7 +4623,7 @@ export declare const addIssueComment: (token: GithubTokenInput, options?: Tansta
3445
4623
  body: string | undefined;
3446
4624
  author: string | undefined;
3447
4625
  createdAt: string;
3448
- }>;
4626
+ } | GithubDryRunResult>;
3449
4627
  };
3450
4628
  /** Create the TanStack `updateIssueComment` server tool. */
3451
4629
  export declare const updateIssueComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3464,7 +4642,7 @@ export declare const updateIssueComment: (token: GithubTokenInput, options?: Tan
3464
4642
  url: string;
3465
4643
  body: string | undefined;
3466
4644
  updatedAt: string;
3467
- }>;
4645
+ } | GithubDryRunResult>;
3468
4646
  };
3469
4647
  /** Create the TanStack `deleteIssueComment` server tool. */
3470
4648
  export declare const deleteIssueComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3479,7 +4657,7 @@ export declare const deleteIssueComment: (token: GithubTokenInput, options?: Tan
3479
4657
  }) => Promise<{
3480
4658
  deleted: boolean;
3481
4659
  commentId: number;
3482
- }>;
4660
+ } | GithubDryRunResult>;
3483
4661
  };
3484
4662
  /** Create the TanStack `closeIssue` server tool. */
3485
4663
  export declare const closeIssue: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3502,7 +4680,7 @@ export declare const closeIssue: (token: GithubTokenInput, options?: TanstackToo
3502
4680
  state: string;
3503
4681
  url: string;
3504
4682
  closedAt: string | null;
3505
- }>;
4683
+ } | GithubDryRunResult>;
3506
4684
  };
3507
4685
  /** Create the TanStack `updateIssue` server tool. */
3508
4686
  export declare const updateIssue: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3545,7 +4723,7 @@ export declare const updateIssue: (token: GithubTokenInput, options?: TanstackTo
3545
4723
  milestone: number | null;
3546
4724
  closedAt: string | null;
3547
4725
  updatedAt: string;
3548
- }>;
4726
+ } | GithubDryRunResult>;
3549
4727
  };
3550
4728
  /** Create the TanStack `listLabels` server tool. */
3551
4729
  export declare const listLabels: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3559,11 +4737,13 @@ export declare const listLabels: (token: GithubTokenInput, options?: TanstackToo
3559
4737
  repo: string;
3560
4738
  perPage?: number | undefined;
3561
4739
  page?: number | undefined;
3562
- }) => Promise<PagedList<{
3563
- name: string;
3564
- color: string;
3565
- description: string | null;
3566
- }>>;
4740
+ }) => Promise<{
4741
+ items: {
4742
+ name: string;
4743
+ color: string;
4744
+ description: string | null;
4745
+ }[];
4746
+ } & PagingFields>;
3567
4747
  };
3568
4748
  /** Create the TanStack `addLabels` server tool. */
3569
4749
  export declare const addLabels: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3581,7 +4761,7 @@ export declare const addLabels: (token: GithubTokenInput, options?: TanstackTool
3581
4761
  name: string;
3582
4762
  color: string;
3583
4763
  description: string | null;
3584
- }[]>;
4764
+ }[] | GithubDryRunResult>;
3585
4765
  };
3586
4766
  /** Create the TanStack `removeLabel` server tool. */
3587
4767
  export declare const removeLabel: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3599,7 +4779,7 @@ export declare const removeLabel: (token: GithubTokenInput, options?: TanstackTo
3599
4779
  removed: boolean;
3600
4780
  label: string;
3601
4781
  issueNumber: number;
3602
- }>;
4782
+ } | GithubDryRunResult>;
3603
4783
  };
3604
4784
  /** Create the TanStack `createLabel` server tool. */
3605
4785
  export declare const createLabel: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3619,7 +4799,7 @@ export declare const createLabel: (token: GithubTokenInput, options?: TanstackTo
3619
4799
  name: string;
3620
4800
  color: string;
3621
4801
  description: string | null;
3622
- }>;
4802
+ } | GithubDryRunResult>;
3623
4803
  };
3624
4804
  /** Create the TanStack `updateLabel` server tool. */
3625
4805
  export declare const updateLabel: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3641,7 +4821,7 @@ export declare const updateLabel: (token: GithubTokenInput, options?: TanstackTo
3641
4821
  name: string;
3642
4822
  color: string;
3643
4823
  description: string | null;
3644
- }>;
4824
+ } | GithubDryRunResult>;
3645
4825
  };
3646
4826
  /** Create the TanStack `deleteLabel` server tool. */
3647
4827
  export declare const deleteLabel: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3656,7 +4836,7 @@ export declare const deleteLabel: (token: GithubTokenInput, options?: TanstackTo
3656
4836
  }) => Promise<{
3657
4837
  deleted: boolean;
3658
4838
  name: string;
3659
- }>;
4839
+ } | GithubDryRunResult>;
3660
4840
  };
3661
4841
  /** Create the TanStack `addAssignees` server tool. */
3662
4842
  export declare const addAssignees: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3673,7 +4853,7 @@ export declare const addAssignees: (token: GithubTokenInput, options?: TanstackT
3673
4853
  }) => Promise<{
3674
4854
  number: number;
3675
4855
  assignees: string[] | undefined;
3676
- }>;
4856
+ } | GithubDryRunResult>;
3677
4857
  };
3678
4858
  /** Create the TanStack `removeAssignees` server tool. */
3679
4859
  export declare const removeAssignees: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3690,7 +4870,88 @@ export declare const removeAssignees: (token: GithubTokenInput, options?: Tansta
3690
4870
  }) => Promise<{
3691
4871
  number: number;
3692
4872
  assignees: string[] | undefined;
3693
- }>;
4873
+ } | GithubDryRunResult>;
4874
+ };
4875
+ /** Create the TanStack `listMilestones` server tool. */
4876
+ export declare const listMilestones: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
4877
+ owner: import("zod").ZodString;
4878
+ repo: import("zod").ZodString;
4879
+ state: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
4880
+ open: "open";
4881
+ closed: "closed";
4882
+ all: "all";
4883
+ }>>>;
4884
+ perPage: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
4885
+ page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
4886
+ }, import("zod/v4/core").$strip>, undefined, "listMilestones", unknown, boolean, undefined>, "execute"> & {
4887
+ execute: (input: {
4888
+ owner: string;
4889
+ repo: string;
4890
+ state?: "open" | "closed" | "all" | undefined;
4891
+ perPage?: number | undefined;
4892
+ page?: number | undefined;
4893
+ }) => Promise<{
4894
+ items: {
4895
+ number: number;
4896
+ title: string;
4897
+ state: "open" | "closed";
4898
+ description: string | null | undefined;
4899
+ dueOn: string | null;
4900
+ openIssues: number;
4901
+ closedIssues: number;
4902
+ url: string;
4903
+ }[];
4904
+ } & PagingFields>;
4905
+ };
4906
+ /** Create the TanStack `listSubIssues` server tool. */
4907
+ export declare const listSubIssues: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
4908
+ owner: import("zod").ZodString;
4909
+ repo: import("zod").ZodString;
4910
+ issueNumber: import("zod").ZodNumber;
4911
+ perPage: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
4912
+ page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
4913
+ }, import("zod/v4/core").$strip>, undefined, "listSubIssues", unknown, boolean, undefined>, "execute"> & {
4914
+ execute: (input: {
4915
+ owner: string;
4916
+ repo: string;
4917
+ issueNumber: number;
4918
+ perPage?: number | undefined;
4919
+ page?: number | undefined;
4920
+ }) => Promise<{
4921
+ items: {
4922
+ number: number;
4923
+ title: string;
4924
+ state: string;
4925
+ url: string;
4926
+ assignees: string[] | undefined;
4927
+ }[];
4928
+ } & PagingFields>;
4929
+ };
4930
+ /** Create the TanStack `addSubIssue` server tool. */
4931
+ export declare const addSubIssue: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
4932
+ owner: import("zod").ZodString;
4933
+ repo: import("zod").ZodString;
4934
+ issueNumber: import("zod").ZodNumber;
4935
+ subIssueNumber: import("zod").ZodNumber;
4936
+ subIssueRepo: import("zod").ZodOptional<import("zod").ZodString>;
4937
+ replaceParent: import("zod").ZodOptional<import("zod").ZodBoolean>;
4938
+ }, import("zod/v4/core").$strip>, undefined, "addSubIssue", unknown, boolean, undefined>, "execute"> & {
4939
+ execute: (input: {
4940
+ owner: string;
4941
+ repo: string;
4942
+ issueNumber: number;
4943
+ subIssueNumber: number;
4944
+ subIssueRepo?: string | undefined;
4945
+ replaceParent?: boolean | undefined;
4946
+ }) => Promise<{
4947
+ issueNumber: number;
4948
+ subIssue: {
4949
+ number: number;
4950
+ title: string;
4951
+ state: string;
4952
+ url: string;
4953
+ };
4954
+ } | GithubDryRunResult>;
3694
4955
  };
3695
4956
  /** Create the TanStack `listIssueReactions` server tool. */
3696
4957
  export declare const listIssueReactions: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3756,7 +5017,7 @@ export declare const addIssueReaction: (token: GithubTokenInput, options?: Tanst
3756
5017
  content: "+1" | "-1" | "laugh" | "confused" | "heart" | "hooray" | "rocket" | "eyes";
3757
5018
  user: string | undefined;
3758
5019
  issueNumber: number;
3759
- }>;
5020
+ } | GithubDryRunResult>;
3760
5021
  };
3761
5022
  /** Create the TanStack `listCommentReactions` server tool. */
3762
5023
  export declare const listCommentReactions: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3822,7 +5083,7 @@ export declare const addCommentReaction: (token: GithubTokenInput, options?: Tan
3822
5083
  content: "+1" | "-1" | "laugh" | "confused" | "heart" | "hooray" | "rocket" | "eyes";
3823
5084
  user: string | undefined;
3824
5085
  commentId: number;
3825
- }>;
5086
+ } | GithubDryRunResult>;
3826
5087
  };
3827
5088
  /** Create the TanStack `listDiscussions` server tool. */
3828
5089
  export declare const listDiscussions: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3929,7 +5190,7 @@ export declare const addDiscussionComment: (token: GithubTokenInput, options?: T
3929
5190
  author: string | null;
3930
5191
  createdAt: string;
3931
5192
  error?: undefined;
3932
- }>;
5193
+ } | GithubDryRunResult>;
3933
5194
  };
3934
5195
  /** Create the TanStack `listNotifications` server tool. */
3935
5196
  export declare const listNotifications: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3943,18 +5204,20 @@ export declare const listNotifications: (token: GithubTokenInput, options?: Tans
3943
5204
  participating?: boolean | undefined;
3944
5205
  perPage?: number | undefined;
3945
5206
  page?: number | undefined;
3946
- }) => Promise<PagedList<{
3947
- threadId: string;
3948
- repository: string;
3949
- subject: {
3950
- title: string;
3951
- type: string;
3952
- url: string;
3953
- };
3954
- reason: string;
3955
- unread: boolean;
3956
- updatedAt: string;
3957
- }>>;
5207
+ }) => Promise<{
5208
+ items: {
5209
+ threadId: string;
5210
+ repository: string;
5211
+ subject: {
5212
+ title: string;
5213
+ type: string;
5214
+ url: string;
5215
+ };
5216
+ reason: string;
5217
+ unread: boolean;
5218
+ updatedAt: string;
5219
+ }[];
5220
+ } & PagingFields>;
3958
5221
  };
3959
5222
  /** Create the TanStack `markNotificationRead` server tool. */
3960
5223
  export declare const markNotificationRead: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3965,7 +5228,7 @@ export declare const markNotificationRead: (token: GithubTokenInput, options?: T
3965
5228
  }) => Promise<{
3966
5229
  marked: boolean;
3967
5230
  threadId: string;
3968
- }>;
5231
+ } | GithubDryRunResult>;
3969
5232
  };
3970
5233
  /** Create the TanStack `searchCode` server tool. */
3971
5234
  export declare const searchCode: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4085,14 +5348,16 @@ export declare const listCommits: (token: GithubTokenInput, options?: TanstackTo
4085
5348
  perPage?: number | undefined;
4086
5349
  page?: number | undefined;
4087
5350
  maxPages?: number | undefined;
4088
- }) => Promise<PagedList<{
4089
- sha: string;
4090
- message: string;
4091
- author: string | undefined;
4092
- authorLogin: string | undefined;
4093
- date: string | undefined;
4094
- url: string;
4095
- }>>;
5351
+ }) => Promise<{
5352
+ items: {
5353
+ sha: string;
5354
+ message: string;
5355
+ author: string | undefined;
5356
+ authorLogin: string | undefined;
5357
+ date: string | undefined;
5358
+ url: string;
5359
+ }[];
5360
+ } & PagingFields>;
4096
5361
  };
4097
5362
  /** Create the TanStack `getCommit` server tool. */
4098
5363
  export declare const getCommit: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4220,17 +5485,19 @@ export declare const listGists: (token: GithubTokenInput, options?: TanstackTool
4220
5485
  username?: string | undefined;
4221
5486
  perPage?: number | undefined;
4222
5487
  page?: number | undefined;
4223
- }) => Promise<PagedList<{
4224
- id: string;
4225
- description: string | null;
4226
- public: boolean;
4227
- url: string;
4228
- files: string[];
4229
- owner: string | undefined;
4230
- comments: number;
4231
- createdAt: string;
4232
- updatedAt: string;
4233
- }>>;
5488
+ }) => Promise<{
5489
+ items: {
5490
+ id: string;
5491
+ description: string | null;
5492
+ public: boolean;
5493
+ url: string;
5494
+ files: string[];
5495
+ owner: string | undefined;
5496
+ comments: number;
5497
+ createdAt: string;
5498
+ updatedAt: string;
5499
+ }[];
5500
+ } & PagingFields>;
4234
5501
  };
4235
5502
  /** Create the TanStack `getGist` server tool. */
4236
5503
  export declare const getGist: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4265,14 +5532,16 @@ export declare const listGistComments: (token: GithubTokenInput, options?: Tanst
4265
5532
  gistId: string;
4266
5533
  perPage?: number | undefined;
4267
5534
  page?: number | undefined;
4268
- }) => Promise<PagedList<{
4269
- id: number;
4270
- body: string;
4271
- author: string | undefined;
4272
- url: string;
4273
- createdAt: string;
4274
- updatedAt: string;
4275
- }>>;
5535
+ }) => Promise<{
5536
+ items: {
5537
+ id: number;
5538
+ body: string;
5539
+ author: string | undefined;
5540
+ url: string;
5541
+ createdAt: string;
5542
+ updatedAt: string;
5543
+ }[];
5544
+ } & PagingFields>;
4276
5545
  };
4277
5546
  /** Create the TanStack `createGist` server tool. */
4278
5547
  export declare const createGist: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4295,7 +5564,7 @@ export declare const createGist: (token: GithubTokenInput, options?: TanstackToo
4295
5564
  url: string | undefined;
4296
5565
  files: string[];
4297
5566
  owner: string | undefined;
4298
- }>;
5567
+ } | GithubDryRunResult>;
4299
5568
  };
4300
5569
  /** Create the TanStack `updateGist` server tool. */
4301
5570
  export declare const updateGist: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4318,7 +5587,7 @@ export declare const updateGist: (token: GithubTokenInput, options?: TanstackToo
4318
5587
  description: string | null | undefined;
4319
5588
  url: string | undefined;
4320
5589
  files: string[];
4321
- }>;
5590
+ } | GithubDryRunResult>;
4322
5591
  };
4323
5592
  /** Create the TanStack `deleteGist` server tool. */
4324
5593
  export declare const deleteGist: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4329,7 +5598,7 @@ export declare const deleteGist: (token: GithubTokenInput, options?: TanstackToo
4329
5598
  }) => Promise<{
4330
5599
  deleted: boolean;
4331
5600
  gistId: string;
4332
- }>;
5601
+ } | GithubDryRunResult>;
4333
5602
  };
4334
5603
  /** Create the TanStack `createGistComment` server tool. */
4335
5604
  export declare const createGistComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4345,7 +5614,7 @@ export declare const createGistComment: (token: GithubTokenInput, options?: Tans
4345
5614
  body: string;
4346
5615
  author: string | undefined;
4347
5616
  createdAt: string;
4348
- }>;
5617
+ } | GithubDryRunResult>;
4349
5618
  };
4350
5619
  /** Create the TanStack `listWorkflows` server tool. */
4351
5620
  export declare const listWorkflows: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4545,7 +5814,7 @@ export declare const triggerWorkflow: (token: GithubTokenInput, options?: Tansta
4545
5814
  triggered: boolean;
4546
5815
  workflowId: string | number;
4547
5816
  ref: string;
4548
- }>;
5817
+ } | GithubDryRunResult>;
4549
5818
  };
4550
5819
  /** Create the TanStack `cancelWorkflowRun` server tool. */
4551
5820
  export declare const cancelWorkflowRun: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4560,7 +5829,7 @@ export declare const cancelWorkflowRun: (token: GithubTokenInput, options?: Tans
4560
5829
  }) => Promise<{
4561
5830
  cancelled: boolean;
4562
5831
  runId: number;
4563
- }>;
5832
+ } | GithubDryRunResult>;
4564
5833
  };
4565
5834
  /** Create the TanStack `rerunWorkflowRun` server tool. */
4566
5835
  export declare const rerunWorkflowRun: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4578,7 +5847,7 @@ export declare const rerunWorkflowRun: (token: GithubTokenInput, options?: Tanst
4578
5847
  rerun: boolean;
4579
5848
  runId: number;
4580
5849
  onlyFailedJobs: boolean;
4581
- }>;
5850
+ } | GithubDryRunResult>;
4582
5851
  };
4583
5852
  /** Create the TanStack `listCheckRuns` server tool. */
4584
5853
  export declare const listCheckRuns: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4634,21 +5903,91 @@ export declare const getCombinedStatus: (token: GithubTokenInput, options?: Tans
4634
5903
  }[];
4635
5904
  }>;
4636
5905
  };
5906
+ /** Create the TanStack `createCommitStatus` server tool. */
5907
+ export declare const createCommitStatus: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
5908
+ owner: import("zod").ZodString;
5909
+ repo: import("zod").ZodString;
5910
+ sha: import("zod").ZodString;
5911
+ state: import("zod").ZodEnum<{
5912
+ error: "error";
5913
+ success: "success";
5914
+ failure: "failure";
5915
+ pending: "pending";
5916
+ }>;
5917
+ context: import("zod").ZodString;
5918
+ description: import("zod").ZodOptional<import("zod").ZodString>;
5919
+ targetUrl: import("zod").ZodOptional<import("zod").ZodString>;
5920
+ }, import("zod/v4/core").$strip>, undefined, "createCommitStatus", unknown, boolean, undefined>, "execute"> & {
5921
+ execute: (input: {
5922
+ owner: string;
5923
+ repo: string;
5924
+ sha: string;
5925
+ state: "error" | "success" | "failure" | "pending";
5926
+ context: string;
5927
+ description?: string | undefined;
5928
+ targetUrl?: string | undefined;
5929
+ }) => Promise<{
5930
+ id: number;
5931
+ context: string;
5932
+ state: string;
5933
+ description: string | null;
5934
+ url: string | null;
5935
+ createdAt: string;
5936
+ } | GithubDryRunResult>;
5937
+ };
4637
5938
  /** Create the TanStack `getCiFailureContext` server tool. */
4638
5939
  export declare const getCiFailureContext: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
4639
5940
  owner: import("zod").ZodString;
4640
5941
  repo: import("zod").ZodString;
4641
- ref: import("zod").ZodString;
5942
+ ref: import("zod").ZodOptional<import("zod").ZodString>;
5943
+ runId: import("zod").ZodOptional<import("zod").ZodNumber>;
4642
5944
  maxFailedRuns: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
4643
5945
  maxFailedJobs: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
5946
+ logLines: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
4644
5947
  }, import("zod/v4/core").$strip>, undefined, "getCiFailureContext", unknown, boolean, undefined>, "execute"> & {
4645
5948
  execute: (input: {
4646
5949
  owner: string;
4647
5950
  repo: string;
4648
- ref: string;
5951
+ ref?: string | undefined;
5952
+ runId?: number | undefined;
4649
5953
  maxFailedRuns?: number | undefined;
4650
5954
  maxFailedJobs?: number | undefined;
5955
+ logLines?: number | undefined;
4651
5956
  }) => Promise<{
5957
+ run: {
5958
+ id: number;
5959
+ name: string | null | undefined;
5960
+ status: string | null;
5961
+ conclusion: string | null;
5962
+ branch: string | null;
5963
+ sha: string;
5964
+ event: string;
5965
+ url: string;
5966
+ actor: string | undefined;
5967
+ runNumber: number;
5968
+ runAttempt: number | undefined;
5969
+ createdAt: string;
5970
+ updatedAt: string;
5971
+ runStartedAt: string | undefined;
5972
+ };
5973
+ failedJobs: {
5974
+ id: number;
5975
+ name: string;
5976
+ status: "completed" | "in_progress" | "queued" | "requested" | "waiting" | "pending";
5977
+ conclusion: "success" | "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "timed_out" | null;
5978
+ url: string | null;
5979
+ startedAt: string;
5980
+ completedAt: string | null;
5981
+ steps: {
5982
+ name: string;
5983
+ status: "completed" | "in_progress" | "queued";
5984
+ conclusion: string | null;
5985
+ number: number;
5986
+ startedAt: string | null | undefined;
5987
+ completedAt: string | null | undefined;
5988
+ }[] | undefined;
5989
+ }[];
5990
+ } | {
4652
5991
  latestFailure?: {
4653
5992
  run: {
4654
5993
  id: number;
@@ -4664,23 +6003,23 @@ export declare const getCiFailureContext: (token: GithubTokenInput, options?: Ta
4664
6003
  runNumber: number;
4665
6004
  runAttempt: number | undefined;
4666
6005
  };
4667
- jobs: Array<{
6006
+ jobs: {
4668
6007
  id: number;
4669
6008
  name: string;
4670
- status: string;
4671
- conclusion: string | null;
6009
+ status: "completed" | "in_progress" | "queued" | "requested" | "waiting" | "pending";
6010
+ conclusion: "success" | "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "timed_out" | null;
4672
6011
  url: string | null;
4673
6012
  startedAt: string;
4674
6013
  completedAt: string | null;
4675
- steps?: Array<{
6014
+ steps: {
4676
6015
  name: string;
4677
- status: string;
6016
+ status: "completed" | "in_progress" | "queued";
4678
6017
  conclusion: string | null;
4679
6018
  number: number;
4680
- startedAt?: string | null;
4681
- completedAt?: string | null;
4682
- }>;
4683
- }>;
6019
+ startedAt: string | null | undefined;
6020
+ completedAt: string | null | undefined;
6021
+ }[] | undefined;
6022
+ }[];
4684
6023
  } | undefined;
4685
6024
  ref: string;
4686
6025
  combinedStatus: {
@@ -4738,18 +6077,20 @@ export declare const listReleases: (token: GithubTokenInput, options?: TanstackT
4738
6077
  page?: number | undefined;
4739
6078
  maxPages?: number | undefined;
4740
6079
  detail?: "summary" | "full" | undefined;
4741
- }) => Promise<PagedList<{
4742
- id: number;
4743
- tagName: string;
4744
- name: string | null;
4745
- body: string | null | undefined;
4746
- draft: boolean;
4747
- prerelease: boolean;
4748
- url: string;
4749
- author: string;
4750
- createdAt: string;
4751
- publishedAt: string | null;
4752
- }>>;
6080
+ }) => Promise<{
6081
+ items: {
6082
+ id: number;
6083
+ tagName: string;
6084
+ name: string | null;
6085
+ body: string | null | undefined;
6086
+ draft: boolean;
6087
+ prerelease: boolean;
6088
+ url: string;
6089
+ author: string;
6090
+ createdAt: string;
6091
+ publishedAt: string | null;
6092
+ }[];
6093
+ } & PagingFields>;
4753
6094
  };
4754
6095
  /** Create the TanStack `getLatestRelease` server tool. */
4755
6096
  export declare const getLatestRelease: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4785,7 +6126,8 @@ export declare const getLatestRelease: (token: GithubTokenInput, options?: Tanst
4785
6126
  export declare const getRelease: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
4786
6127
  owner: import("zod").ZodString;
4787
6128
  repo: import("zod").ZodString;
4788
- releaseId: import("zod").ZodNumber;
6129
+ releaseId: import("zod").ZodOptional<import("zod").ZodNumber>;
6130
+ tag: import("zod").ZodOptional<import("zod").ZodString>;
4789
6131
  detail: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
4790
6132
  summary: "summary";
4791
6133
  full: "full";
@@ -4794,7 +6136,8 @@ export declare const getRelease: (token: GithubTokenInput, options?: TanstackToo
4794
6136
  execute: (input: {
4795
6137
  owner: string;
4796
6138
  repo: string;
4797
- releaseId: number;
6139
+ releaseId?: number | undefined;
6140
+ tag?: string | undefined;
4798
6141
  detail?: "summary" | "full" | undefined;
4799
6142
  }) => Promise<{
4800
6143
  id: number;
@@ -4820,6 +6163,8 @@ export declare const getReleaseContext: (token: GithubTokenInput, options?: Tans
4820
6163
  owner: import("zod").ZodString;
4821
6164
  repo: import("zod").ZodString;
4822
6165
  releaseId: import("zod").ZodOptional<import("zod").ZodNumber>;
6166
+ tag: import("zod").ZodOptional<import("zod").ZodString>;
6167
+ previousTag: import("zod").ZodOptional<import("zod").ZodString>;
4823
6168
  includePrevious: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
4824
6169
  includeCompare: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
4825
6170
  detail: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
@@ -4831,6 +6176,8 @@ export declare const getReleaseContext: (token: GithubTokenInput, options?: Tans
4831
6176
  owner: string;
4832
6177
  repo: string;
4833
6178
  releaseId?: number | undefined;
6179
+ tag?: string | undefined;
6180
+ previousTag?: string | undefined;
4834
6181
  includePrevious?: boolean | undefined;
4835
6182
  includeCompare?: boolean | undefined;
4836
6183
  detail?: "summary" | "full" | undefined;
@@ -4866,6 +6213,23 @@ export declare const getReleaseContext: (token: GithubTokenInput, options?: Tans
4866
6213
  author: string;
4867
6214
  createdAt: string;
4868
6215
  publishedAt: string | null;
6216
+ } | {
6217
+ id: number;
6218
+ tagName: string;
6219
+ name: string | null;
6220
+ body: string | null | undefined;
6221
+ draft: boolean;
6222
+ prerelease: boolean;
6223
+ url: string;
6224
+ author: string;
6225
+ createdAt: string;
6226
+ publishedAt: string | null;
6227
+ assets: {
6228
+ name: string;
6229
+ downloadUrl: string;
6230
+ size: number;
6231
+ downloadCount: number;
6232
+ }[];
4869
6233
  } | undefined;
4870
6234
  release: {
4871
6235
  id: number;
@@ -4916,7 +6280,7 @@ export declare const createRelease: (token: GithubTokenInput, options?: Tanstack
4916
6280
  draft: boolean;
4917
6281
  prerelease: boolean;
4918
6282
  createdAt: string;
4919
- }>;
6283
+ } | GithubDryRunResult>;
4920
6284
  };
4921
6285
  /** Create the TanStack `updateRelease` server tool. */
4922
6286
  export declare const updateRelease: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4949,7 +6313,7 @@ export declare const updateRelease: (token: GithubTokenInput, options?: Tanstack
4949
6313
  draft: boolean;
4950
6314
  prerelease: boolean;
4951
6315
  publishedAt: string | null;
4952
- }>;
6316
+ } | GithubDryRunResult>;
4953
6317
  };
4954
6318
  /** Create the TanStack `deleteRelease` server tool. */
4955
6319
  export declare const deleteRelease: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4964,8 +6328,145 @@ export declare const deleteRelease: (token: GithubTokenInput, options?: Tanstack
4964
6328
  }) => Promise<{
4965
6329
  deleted: boolean;
4966
6330
  releaseId: number;
6331
+ } | GithubDryRunResult>;
6332
+ };
6333
+ /** Create the TanStack `listCodeScanningAlerts` server tool. */
6334
+ export declare const listCodeScanningAlerts: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
6335
+ owner: import("zod").ZodString;
6336
+ repo: import("zod").ZodString;
6337
+ state: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
6338
+ open: "open";
6339
+ dismissed: "dismissed";
6340
+ fixed: "fixed";
6341
+ }>>>;
6342
+ severity: import("zod").ZodOptional<import("zod").ZodEnum<{
6343
+ error: "error";
6344
+ critical: "critical";
6345
+ high: "high";
6346
+ medium: "medium";
6347
+ low: "low";
6348
+ warning: "warning";
6349
+ note: "note";
6350
+ }>>;
6351
+ ref: import("zod").ZodOptional<import("zod").ZodString>;
6352
+ perPage: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
6353
+ page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
6354
+ maxPages: import("zod").ZodOptional<import("zod").ZodNumber>;
6355
+ }, import("zod/v4/core").$strip>, undefined, "listCodeScanningAlerts", unknown, boolean, undefined>, "execute"> & {
6356
+ execute: (input: {
6357
+ owner: string;
6358
+ repo: string;
6359
+ state?: "open" | "dismissed" | "fixed" | undefined;
6360
+ severity?: "error" | "critical" | "high" | "medium" | "low" | "warning" | "note" | undefined;
6361
+ ref?: string | undefined;
6362
+ perPage?: number | undefined;
6363
+ page?: number | undefined;
6364
+ maxPages?: number | undefined;
6365
+ }) => Promise<{
6366
+ items: {
6367
+ number: number;
6368
+ state: "open" | "dismissed" | "fixed" | null;
6369
+ severity: "error" | "critical" | "high" | "medium" | "low" | "warning" | "note" | "none" | null | undefined;
6370
+ rule: {
6371
+ id: string | null | undefined;
6372
+ description: string | undefined;
6373
+ };
6374
+ tool: string | undefined;
6375
+ path: string | undefined;
6376
+ line: number | undefined;
6377
+ url: string;
6378
+ createdAt: string;
6379
+ dismissedReason: "false positive" | "won't fix" | "used in tests" | null;
6380
+ }[];
6381
+ } & PagingFields>;
6382
+ };
6383
+ /** Create the TanStack `listDependabotAlerts` server tool. */
6384
+ export declare const listDependabotAlerts: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
6385
+ owner: import("zod").ZodString;
6386
+ repo: import("zod").ZodString;
6387
+ state: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
6388
+ open: "open";
6389
+ dismissed: "dismissed";
6390
+ fixed: "fixed";
6391
+ auto_dismissed: "auto_dismissed";
6392
+ }>>>;
6393
+ severity: import("zod").ZodOptional<import("zod").ZodEnum<{
6394
+ critical: "critical";
6395
+ high: "high";
6396
+ medium: "medium";
6397
+ low: "low";
6398
+ }>>;
6399
+ ecosystem: import("zod").ZodOptional<import("zod").ZodString>;
6400
+ perPage: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
6401
+ after: import("zod").ZodOptional<import("zod").ZodString>;
6402
+ }, import("zod/v4/core").$strip>, undefined, "listDependabotAlerts", unknown, boolean, undefined>, "execute"> & {
6403
+ execute: (input: {
6404
+ owner: string;
6405
+ repo: string;
6406
+ state?: "open" | "dismissed" | "fixed" | "auto_dismissed" | undefined;
6407
+ severity?: "critical" | "high" | "medium" | "low" | undefined;
6408
+ ecosystem?: string | undefined;
6409
+ perPage?: number | undefined;
6410
+ after?: string | undefined;
6411
+ }) => Promise<{
6412
+ nextCursor?: string | undefined;
6413
+ items: {
6414
+ number: number;
6415
+ state: "open" | "dismissed" | "fixed" | "auto_dismissed";
6416
+ severity: "critical" | "high" | "medium" | "low";
6417
+ package: string | undefined;
6418
+ ecosystem: string | undefined;
6419
+ manifestPath: string | undefined;
6420
+ scope: "development" | "runtime" | null | undefined;
6421
+ advisory: {
6422
+ ghsaId: string;
6423
+ cveId: string | null;
6424
+ summary: string;
6425
+ };
6426
+ vulnerableVersionRange: string;
6427
+ firstPatchedVersion: string | undefined;
6428
+ url: string;
6429
+ createdAt: string;
6430
+ }[];
6431
+ hasMore: boolean;
6432
+ perPage: number;
4967
6433
  }>;
4968
6434
  };
6435
+ /** Create the TanStack `listSecretScanningAlerts` server tool. */
6436
+ export declare const listSecretScanningAlerts: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
6437
+ owner: import("zod").ZodString;
6438
+ repo: import("zod").ZodString;
6439
+ state: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
6440
+ open: "open";
6441
+ resolved: "resolved";
6442
+ }>>>;
6443
+ secretType: import("zod").ZodOptional<import("zod").ZodString>;
6444
+ perPage: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
6445
+ page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
6446
+ maxPages: import("zod").ZodOptional<import("zod").ZodNumber>;
6447
+ }, import("zod/v4/core").$strip>, undefined, "listSecretScanningAlerts", unknown, boolean, undefined>, "execute"> & {
6448
+ execute: (input: {
6449
+ owner: string;
6450
+ repo: string;
6451
+ state?: "open" | "resolved" | undefined;
6452
+ secretType?: string | undefined;
6453
+ perPage?: number | undefined;
6454
+ page?: number | undefined;
6455
+ maxPages?: number | undefined;
6456
+ }) => Promise<{
6457
+ items: {
6458
+ number: number | undefined;
6459
+ state: "open" | "resolved" | undefined;
6460
+ secretType: string | undefined;
6461
+ secretTypeDisplayName: string | undefined;
6462
+ validity: "unknown" | "active" | "inactive" | undefined;
6463
+ pushProtectionBypassed: boolean | null | undefined;
6464
+ resolution: "false_positive" | "wont_fix" | "revoked" | "used_in_tests" | null | undefined;
6465
+ url: string | undefined;
6466
+ createdAt: string | undefined;
6467
+ }[];
6468
+ } & PagingFields>;
6469
+ };
4969
6470
  //#endregion
4970
6471
  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
6472
  //# sourceMappingURL=tanstack.d.mts.map