@github-tools/sdk 1.20.0 → 1.22.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 (66) hide show
  1. package/README.md +50 -17
  2. package/dist/{approval-policy--kByBqhT.mjs → approval-policy-C2rcAY77.mjs} +3 -4
  3. package/dist/{approval-policy--kByBqhT.mjs.map → approval-policy-C2rcAY77.mjs.map} +1 -1
  4. package/dist/connect/eve.d.mts +2 -4
  5. package/dist/connect/eve.d.mts.map +1 -1
  6. package/dist/connect/eve.mjs +3 -4
  7. package/dist/connect/eve.mjs.map +1 -1
  8. package/dist/connect.d.mts +5 -11
  9. package/dist/connect.d.mts.map +1 -1
  10. package/dist/connect.mjs +3 -4
  11. package/dist/{cores-FLzAv2tu.mjs → cores-CMUr_SEv.mjs} +21 -4
  12. package/dist/cores-CMUr_SEv.mjs.map +1 -0
  13. package/dist/{tool-types-OFyE3z0C.d.mts → dry-run-BAbes7Mv.d.mts} +168 -40
  14. package/dist/dry-run-BAbes7Mv.d.mts.map +1 -0
  15. package/dist/{evaluation-BtoHbxuQ.mjs → evaluation-DskA4Lzk.mjs} +4 -6
  16. package/dist/{evaluation-BtoHbxuQ.mjs.map → evaluation-DskA4Lzk.mjs.map} +1 -1
  17. package/dist/eve-runtime-Bmdw1C-K.d.mts +127 -0
  18. package/dist/eve-runtime-Bmdw1C-K.d.mts.map +1 -0
  19. package/dist/{eve-runtime-C-0doyHq.mjs → eve-runtime-DM9yjOsG.mjs} +193 -22
  20. package/dist/eve-runtime-DM9yjOsG.mjs.map +1 -0
  21. package/dist/eve-runtime.d.mts +5 -5
  22. package/dist/eve-runtime.mjs +4 -4
  23. package/dist/eve.d.mts +103 -63
  24. package/dist/eve.d.mts.map +1 -1
  25. package/dist/eve.mjs +104 -63
  26. package/dist/eve.mjs.map +1 -1
  27. package/dist/{index-C3wlz660.d.mts → index-DgCZi9Ns.d.mts} +52 -56
  28. package/dist/index-DgCZi9Ns.d.mts.map +1 -0
  29. package/dist/index.d.mts +3 -3
  30. package/dist/index.mjs +4 -4
  31. package/dist/{interrupts-BSDPwdJ2.d.mts → interrupts-MwQ_v_PF.d.mts} +1 -3
  32. package/dist/interrupts-MwQ_v_PF.d.mts.map +1 -0
  33. package/dist/rolldown-runtime-D8jQpDG7.mjs +12 -0
  34. package/dist/{src-DyiAVHKl.mjs → src-Djn_FFj1.mjs} +183 -55
  35. package/dist/src-Djn_FFj1.mjs.map +1 -0
  36. package/dist/tanstack/interrupts.d.mts +1 -1
  37. package/dist/tanstack/interrupts.mjs +1 -2
  38. package/dist/tanstack.d.mts +534 -208
  39. package/dist/tanstack.d.mts.map +1 -1
  40. package/dist/tanstack.mjs +37 -21
  41. package/dist/tanstack.mjs.map +1 -1
  42. package/dist/{token-DIwB-wtp.mjs → token-HpJhSRkl.mjs} +7 -10
  43. package/dist/token-HpJhSRkl.mjs.map +1 -0
  44. package/dist/{types-CJqhvQwi.d.mts → types-8KtcPTao.d.mts} +3 -7
  45. package/dist/types-8KtcPTao.d.mts.map +1 -0
  46. package/dist/{types-ITYfXMtY.d.mts → types-C-BIKmas.d.mts} +14 -4
  47. package/dist/types-C-BIKmas.d.mts.map +1 -0
  48. package/dist/workflow.d.mts +9 -4
  49. package/dist/workflow.d.mts.map +1 -1
  50. package/dist/workflow.mjs +7 -6
  51. package/dist/workflow.mjs.map +1 -1
  52. package/dist/{write-tools-DnGZw-RD.mjs → write-tools-BR29EOoM.mjs} +483 -113
  53. package/dist/write-tools-BR29EOoM.mjs.map +1 -0
  54. package/package.json +1 -1
  55. package/dist/cores-FLzAv2tu.mjs.map +0 -1
  56. package/dist/eve-runtime-C-0doyHq.mjs.map +0 -1
  57. package/dist/eve-runtime-CflZNuXD.d.mts +0 -85
  58. package/dist/eve-runtime-CflZNuXD.d.mts.map +0 -1
  59. package/dist/index-C3wlz660.d.mts.map +0 -1
  60. package/dist/interrupts-BSDPwdJ2.d.mts.map +0 -1
  61. package/dist/src-DyiAVHKl.mjs.map +0 -1
  62. package/dist/token-DIwB-wtp.mjs.map +0 -1
  63. package/dist/tool-types-OFyE3z0C.d.mts.map +0 -1
  64. package/dist/types-CJqhvQwi.d.mts.map +0 -1
  65. package/dist/types-ITYfXMtY.d.mts.map +0 -1
  66. package/dist/write-tools-DnGZw-RD.mjs.map +0 -1
@@ -1,10 +1,8 @@
1
- import { A as GithubTokenCall, B as GithubToolName, D as AUTO_APPROVAL_TOOLS, E as GITHUB_WRITE_TOOLS, F as GithubToolPreset, I as PRESET_TOOLS, L as PresetToolName, O as DEFAULT_EVALUATION_MODEL, R as GITHUB_TOOL_NAMES, V as GithubWriteToolName, a as GithubToolsContext, f as ApprovalConfig, j as GithubTokenInput, k as RoutablePreset, l as Octokit, m as ToolApprovalMode, o as CommitIdentity, z as GITHUB_TOOL_CATALOG } from "./tool-types-OFyE3z0C.mjs";
2
- import "./index-C3wlz660.mjs";
3
- import { t as githubToolApproval } from "./interrupts-BSDPwdJ2.mjs";
1
+ import { A as DEFAULT_EVALUATION_MODEL, B as GithubToolPreset, G as GithubToolName, H as PresetToolName, K as GithubWriteToolName, L as GithubGuardrails, M as GithubTokenCall, N as GithubTokenInput, O as GITHUB_WRITE_TOOLS, U as GITHUB_TOOL_NAMES, V as PRESET_TOOLS, W as GITHUB_TOOL_CATALOG, 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 } from "./dry-run-BAbes7Mv.mjs";
2
+ import { t as githubToolApproval } from "./interrupts-MwQ_v_PF.mjs";
3
+ import "./index-DgCZi9Ns.mjs";
4
4
  import { z } from "zod";
5
5
  import { AnyTextAdapter, ChatMiddleware, ChatStream, EvaluateAdapter, ModelMessage, ServerTool, Tool, chat } from "@tanstack/ai";
6
- //#endregion
7
- //#region src/core/detail.d.ts
8
6
  type DetailLevel = 'summary' | 'full';
9
7
  declare namespace bundles_d_exports {
10
8
  export { getCiFailureContextCore, getCiFailureContextDescription, getCiFailureContextInputSchema, getIssueContextCore, getIssueContextDescription, getIssueContextInputSchema, getPullRequestContextCore, getPullRequestContextDescription, getPullRequestContextInputSchema, getReleaseContextCore, getReleaseContextDescription, getReleaseContextInputSchema };
@@ -380,7 +378,7 @@ declare function getCiFailureContextCore({ token, owner, repo, ref, runId, maxFa
380
378
  }[];
381
379
  }>;
382
380
  declare namespace checks_d_exports {
383
- export { getCombinedStatusCore, getCombinedStatusDescription, getCombinedStatusInputSchema, listCheckRunsCore, listCheckRunsDescription, listCheckRunsInputSchema };
381
+ export { createCommitStatusCore, createCommitStatusDescription, createCommitStatusInputSchema, getCombinedStatusCore, getCombinedStatusDescription, getCombinedStatusInputSchema, listCheckRunsCore, listCheckRunsDescription, listCheckRunsInputSchema };
384
382
  }
385
383
  declare const listCheckRunsInputSchema: z.ZodObject<{
386
384
  owner: z.ZodString;
@@ -436,8 +434,39 @@ declare function getCombinedStatusCore({ token, owner, repo, ref }: {
436
434
  url: string | null;
437
435
  }[];
438
436
  }>;
439
- //#endregion
440
- //#region src/core/pagination.d.ts
437
+ declare const createCommitStatusInputSchema: z.ZodObject<{
438
+ owner: z.ZodString;
439
+ repo: z.ZodString;
440
+ sha: z.ZodString;
441
+ state: z.ZodEnum<{
442
+ error: "error";
443
+ success: "success";
444
+ failure: "failure";
445
+ pending: "pending";
446
+ }>;
447
+ context: z.ZodString;
448
+ description: z.ZodOptional<z.ZodString>;
449
+ targetUrl: z.ZodOptional<z.ZodString>;
450
+ }, z.core.$strip>;
451
+ 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";
452
+ /** Not idempotent: each call adds a status, and GitHub shows the latest one for each context. */
453
+ declare function createCommitStatusCore({ token, owner, repo, sha, state, context, description, targetUrl }: {
454
+ token: string;
455
+ owner: string;
456
+ repo: string;
457
+ sha: string;
458
+ state: 'error' | 'failure' | 'pending' | 'success';
459
+ context: string;
460
+ description?: string;
461
+ targetUrl?: string;
462
+ }): Promise<{
463
+ id: number;
464
+ context: string;
465
+ state: string;
466
+ description: string | null;
467
+ url: string | null;
468
+ createdAt: string;
469
+ }>;
441
470
  type PagingFields = {
442
471
  hasMore: boolean;
443
472
  page: number;
@@ -861,7 +890,7 @@ declare function createGistCommentCore({ token, gistId, body }: {
861
890
  createdAt: string;
862
891
  }>;
863
892
  declare namespace issues_d_exports {
864
- 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 };
893
+ 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 };
865
894
  }
866
895
  declare const listIssuesInputSchema: z.ZodObject<{
867
896
  owner: z.ZodString;
@@ -961,10 +990,11 @@ declare const createIssueInputSchema: z.ZodObject<{
961
990
  body: z.ZodOptional<z.ZodString>;
962
991
  labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
963
992
  assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
993
+ milestone: z.ZodOptional<z.ZodNumber>;
964
994
  }, z.core.$strip>;
965
995
  declare const createIssueDescription = "Create a new issue in a GitHub repository";
966
996
  /** Not idempotent — each call creates a new issue. */
967
- declare function createIssueCore({ token, owner, repo, title, body, labels, assignees }: {
997
+ declare function createIssueCore({ token, owner, repo, title, body, labels, assignees, milestone }: {
968
998
  token: string;
969
999
  owner: string;
970
1000
  repo: string;
@@ -972,6 +1002,7 @@ declare function createIssueCore({ token, owner, repo, title, body, labels, assi
972
1002
  body?: string;
973
1003
  labels?: string[];
974
1004
  assignees?: string[];
1005
+ milestone?: number;
975
1006
  }): Promise<{
976
1007
  number: number;
977
1008
  title: string;
@@ -1256,6 +1287,84 @@ declare function removeAssigneesCore({ token, owner, repo, issueNumber, assignee
1256
1287
  number: number;
1257
1288
  assignees: string[] | undefined;
1258
1289
  }>;
1290
+ declare const listMilestonesInputSchema: z.ZodObject<{
1291
+ owner: z.ZodString;
1292
+ repo: z.ZodString;
1293
+ state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
1294
+ open: "open";
1295
+ closed: "closed";
1296
+ all: "all";
1297
+ }>>>;
1298
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1299
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1300
+ }, z.core.$strip>;
1301
+ 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.";
1302
+ declare function listMilestonesCore({ token, owner, repo, state, perPage, page }: {
1303
+ token: string;
1304
+ owner: string;
1305
+ repo: string;
1306
+ state: 'open' | 'closed' | 'all';
1307
+ perPage: number;
1308
+ page: number;
1309
+ }): Promise<PagedList<{
1310
+ number: number;
1311
+ title: string;
1312
+ state: "open" | "closed";
1313
+ description: string | null | undefined;
1314
+ dueOn: string | null;
1315
+ openIssues: number;
1316
+ closedIssues: number;
1317
+ url: string;
1318
+ }>>;
1319
+ declare const listSubIssuesInputSchema: z.ZodObject<{
1320
+ owner: z.ZodString;
1321
+ repo: z.ZodString;
1322
+ issueNumber: z.ZodNumber;
1323
+ perPage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1324
+ page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1325
+ }, z.core.$strip>;
1326
+ 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.";
1327
+ declare function listSubIssuesCore({ token, owner, repo, issueNumber, perPage, page }: {
1328
+ token: string;
1329
+ owner: string;
1330
+ repo: string;
1331
+ issueNumber: number;
1332
+ perPage: number;
1333
+ page: number;
1334
+ }): Promise<PagedList<{
1335
+ number: number;
1336
+ title: string;
1337
+ state: string;
1338
+ url: string;
1339
+ assignees: string[] | undefined;
1340
+ }>>;
1341
+ declare const addSubIssueInputSchema: z.ZodObject<{
1342
+ owner: z.ZodString;
1343
+ repo: z.ZodString;
1344
+ issueNumber: z.ZodNumber;
1345
+ subIssueNumber: z.ZodNumber;
1346
+ subIssueRepo: z.ZodOptional<z.ZodString>;
1347
+ replaceParent: z.ZodOptional<z.ZodBoolean>;
1348
+ }, z.core.$strip>;
1349
+ 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";
1350
+ /** Not idempotent: GitHub rejects an issue that already has a parent unless replaceParent is set. */
1351
+ declare function addSubIssueCore({ token, owner, repo, issueNumber, subIssueNumber, subIssueRepo, replaceParent }: {
1352
+ token: string;
1353
+ owner: string;
1354
+ repo: string;
1355
+ issueNumber: number;
1356
+ subIssueNumber: number;
1357
+ subIssueRepo?: string;
1358
+ replaceParent?: boolean;
1359
+ }): Promise<{
1360
+ issueNumber: number;
1361
+ subIssue: {
1362
+ number: number;
1363
+ title: string;
1364
+ state: string;
1365
+ url: string;
1366
+ };
1367
+ }>;
1259
1368
  declare namespace notifications_d_exports {
1260
1369
  export { listNotificationsCore, listNotificationsDescription, listNotificationsInputSchema, markNotificationReadCore, markNotificationReadDescription, markNotificationReadInputSchema };
1261
1370
  }
@@ -1297,7 +1406,7 @@ declare function markNotificationReadCore({ token, threadId }: {
1297
1406
  threadId: string;
1298
1407
  }>;
1299
1408
  declare namespace pull_requests_d_exports {
1300
- export { addPullRequestCommentCore, addPullRequestCommentDescription, addPullRequestCommentInputSchema, createPullRequestCore, createPullRequestDescription, createPullRequestInputSchema, createPullRequestReviewCore, createPullRequestReviewDescription, createPullRequestReviewInputSchema, deletePullRequestCommentCore, deletePullRequestCommentDescription, deletePullRequestCommentInputSchema, disablePullRequestAutoMergeCore, disablePullRequestAutoMergeDescription, disablePullRequestAutoMergeInputSchema, enablePullRequestAutoMergeCore, enablePullRequestAutoMergeDescription, enablePullRequestAutoMergeInputSchema, getPullRequestCore, getPullRequestDescription, getPullRequestInputSchema, listPullRequestFilesCore, listPullRequestFilesDescription, listPullRequestFilesInputSchema, listPullRequestReviewThreadsCore, listPullRequestReviewThreadsDescription, listPullRequestReviewThreadsInputSchema, listPullRequestReviewsCore, listPullRequestReviewsDescription, listPullRequestReviewsInputSchema, listPullRequestsCore, listPullRequestsDescription, listPullRequestsInputSchema, mergePullRequestCore, mergePullRequestDescription, mergePullRequestInputSchema, replyToReviewCommentCore, replyToReviewCommentDescription, replyToReviewCommentInputSchema, requestReviewersCore, requestReviewersDescription, requestReviewersInputSchema, resolveReviewThreadCore, resolveReviewThreadDescription, resolveReviewThreadInputSchema, updatePullRequestCommentCore, updatePullRequestCommentDescription, updatePullRequestCommentInputSchema, updatePullRequestCore, updatePullRequestDescription, updatePullRequestInputSchema };
1409
+ 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 };
1301
1410
  }
1302
1411
  declare const listPullRequestsInputSchema: z.ZodObject<{
1303
1412
  owner: z.ZodString;
@@ -1450,7 +1559,7 @@ declare const mergePullRequestInputSchema: z.ZodObject<{
1450
1559
  }, z.core.$strip>;
1451
1560
  declare const mergePullRequestDescription = "Merge a pull request";
1452
1561
  /** Not idempotent — merging an already-merged PR returns an error from GitHub. */
1453
- declare function mergePullRequestCore({ token, owner, repo, pullNumber, commitTitle, commitMessage, mergeMethod, coAuthors }: {
1562
+ declare function mergePullRequestCore({ token, owner, repo, pullNumber, commitTitle, commitMessage, mergeMethod, coAuthors, branches }: {
1454
1563
  token: string;
1455
1564
  owner: string;
1456
1565
  repo: string;
@@ -1459,6 +1568,8 @@ declare function mergePullRequestCore({ token, owner, repo, pullNumber, commitTi
1459
1568
  commitMessage?: string;
1460
1569
  mergeMethod: 'merge' | 'squash' | 'rebase';
1461
1570
  coAuthors?: CommitIdentity[];
1571
+ /** `guardrails.branches`: the pull request's base branch must match. */
1572
+ branches?: string[];
1462
1573
  }): Promise<{
1463
1574
  merged: boolean;
1464
1575
  message: string;
@@ -1751,7 +1862,7 @@ declare const enablePullRequestAutoMergeInputSchema: z.ZodObject<{
1751
1862
  }, z.core.$strip>;
1752
1863
  declare const enablePullRequestAutoMergeDescription = "Merge a pull request automatically once its required checks and reviews pass. The repository must allow auto-merge; a pull request that can already merge needs mergePullRequest instead";
1753
1864
  /** Idempotent: enabling auto-merge again replaces the pending request with the same settings. */
1754
- declare function enablePullRequestAutoMergeCore({ token, owner, repo, pullNumber, mergeMethod, commitTitle, commitMessage, coAuthors }: {
1865
+ declare function enablePullRequestAutoMergeCore({ token, owner, repo, pullNumber, mergeMethod, commitTitle, commitMessage, coAuthors, branches }: {
1755
1866
  token: string;
1756
1867
  owner: string;
1757
1868
  repo: string;
@@ -1760,6 +1871,8 @@ declare function enablePullRequestAutoMergeCore({ token, owner, repo, pullNumber
1760
1871
  commitTitle?: string;
1761
1872
  commitMessage?: string;
1762
1873
  coAuthors?: CommitIdentity[];
1874
+ /** `guardrails.branches`: the pull request's base branch must match. */
1875
+ branches?: string[];
1763
1876
  }): Promise<{
1764
1877
  number: number;
1765
1878
  url: string;
@@ -1785,6 +1898,26 @@ declare function disablePullRequestAutoMergeCore({ token, owner, repo, pullNumbe
1785
1898
  url: string;
1786
1899
  autoMerge: null;
1787
1900
  }>;
1901
+ declare const updatePullRequestBranchInputSchema: z.ZodObject<{
1902
+ owner: z.ZodString;
1903
+ repo: z.ZodString;
1904
+ pullNumber: z.ZodNumber;
1905
+ expectedHeadSha: z.ZodOptional<z.ZodString>;
1906
+ }, z.core.$strip>;
1907
+ 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";
1908
+ /** Not idempotent: each call can add a merge commit to the pull request branch. */
1909
+ declare function updatePullRequestBranchCore({ token, owner, repo, pullNumber, expectedHeadSha, guardrails }: {
1910
+ token: string;
1911
+ owner: string;
1912
+ repo: string;
1913
+ pullNumber: number;
1914
+ expectedHeadSha?: string;
1915
+ /** `guardrails`: the pull request's head repository and branch must match. */
1916
+ guardrails?: Pick<GithubGuardrails, 'repositories' | 'branches'>;
1917
+ }): Promise<{
1918
+ message: string | undefined;
1919
+ url: string | undefined;
1920
+ }>;
1788
1921
  declare namespace reactions_d_exports {
1789
1922
  export { ReactionContent, addCommentReactionCore, addCommentReactionDescription, addCommentReactionInputSchema, addIssueReactionCore, addIssueReactionDescription, addIssueReactionInputSchema, listCommentReactionsCore, listCommentReactionsDescription, listCommentReactionsInputSchema, listIssueReactionsCore, listIssueReactionsDescription, listIssueReactionsInputSchema };
1790
1923
  }
@@ -2246,7 +2379,7 @@ declare function listSecretScanningAlertsCore({ token, owner, repo, state, secre
2246
2379
  createdAt: string | undefined;
2247
2380
  }>>;
2248
2381
  declare namespace repository_d_exports {
2249
- export { composeCommitMessage, createBranchCore, createBranchDescription, createBranchInputSchema, createCommitOnBranch, createOrUpdateFileCore, createOrUpdateFileDescription, createOrUpdateFileInputSchema, createRepositoryCore, createRepositoryDescription, createRepositoryInputSchema, deleteBranchCore, deleteBranchDescription, deleteBranchInputSchema, editFilesCore, editFilesDescription, editFilesInputSchema, forkRepositoryCore, forkRepositoryDescription, forkRepositoryInputSchema, getBranchRulesCore, getBranchRulesDescription, getBranchRulesInputSchema, getFileContentCore, getFileContentDescription, getFileContentInputSchema, getRepositoryCore, getRepositoryDescription, getRepositoryInputSchema, getRepositoryTreeCore, getRepositoryTreeDescription, getRepositoryTreeInputSchema, listBranchesCore, listBranchesDescription, listBranchesInputSchema };
2382
+ 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 };
2250
2383
  }
2251
2384
  declare function createCommitOnBranch(octokit: Octokit, input: {
2252
2385
  owner: string;
@@ -2692,6 +2825,22 @@ declare function getBranchRulesCore({ token, owner, repo, branch }: {
2692
2825
  type: "creation" | "update" | "deletion" | "required_linear_history" | "merge_queue" | "required_deployments" | "required_signatures" | "pull_request" | "required_status_checks" | "non_fast_forward" | "commit_message_pattern" | "commit_author_email_pattern" | "committer_email_pattern" | "branch_name_pattern" | "tag_name_pattern" | "file_path_restriction" | "max_file_path_length" | "file_extension_restriction" | "max_file_size" | "workflows" | "code_scanning" | "copilot_code_review";
2693
2826
  }[];
2694
2827
  }>;
2828
+ declare const getCollaboratorPermissionInputSchema: z.ZodObject<{
2829
+ owner: z.ZodString;
2830
+ repo: z.ZodString;
2831
+ username: z.ZodString;
2832
+ }, z.core.$strip>;
2833
+ 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";
2834
+ declare function getCollaboratorPermissionCore({ token, owner, repo, username }: {
2835
+ token: string;
2836
+ owner: string;
2837
+ repo: string;
2838
+ username: string;
2839
+ }): Promise<{
2840
+ username: string;
2841
+ permission: string;
2842
+ roleName: string;
2843
+ }>;
2695
2844
  declare namespace search_d_exports {
2696
2845
  export { searchCodeCore, searchCodeDescription, searchCodeInputSchema, searchIssuesCore, searchIssuesDescription, searchIssuesInputSchema, searchRepositoriesCore, searchRepositoriesDescription, searchRepositoriesInputSchema };
2697
2846
  }
@@ -3039,8 +3188,6 @@ declare function rerunWorkflowRunCore({ token, owner, repo, runId, onlyFailedJob
3039
3188
  runId: number;
3040
3189
  onlyFailedJobs: boolean;
3041
3190
  }>;
3042
- //#endregion
3043
- //#region src/core/cores.d.ts
3044
3191
  /**
3045
3192
  * The `*Core` implementation of every tool, keyed by tool name.
3046
3193
  *
@@ -3062,6 +3209,7 @@ declare const GITHUB_TOOL_CORES: {
3062
3209
  readonly createOrUpdateFile: typeof createOrUpdateFileCore;
3063
3210
  readonly editFiles: typeof editFilesCore;
3064
3211
  readonly getBranchRules: typeof getBranchRulesCore;
3212
+ readonly getCollaboratorPermission: typeof getCollaboratorPermissionCore;
3065
3213
  readonly listPullRequests: typeof listPullRequestsCore;
3066
3214
  readonly getPullRequest: typeof getPullRequestCore;
3067
3215
  readonly createPullRequest: typeof createPullRequestCore;
@@ -3069,6 +3217,7 @@ declare const GITHUB_TOOL_CORES: {
3069
3217
  readonly enablePullRequestAutoMerge: typeof enablePullRequestAutoMergeCore;
3070
3218
  readonly disablePullRequestAutoMerge: typeof disablePullRequestAutoMergeCore;
3071
3219
  readonly updatePullRequest: typeof updatePullRequestCore;
3220
+ readonly updatePullRequestBranch: typeof updatePullRequestBranchCore;
3072
3221
  readonly addPullRequestComment: typeof addPullRequestCommentCore;
3073
3222
  readonly updatePullRequestComment: typeof updatePullRequestCommentCore;
3074
3223
  readonly deletePullRequestComment: typeof deletePullRequestCommentCore;
@@ -3098,6 +3247,9 @@ declare const GITHUB_TOOL_CORES: {
3098
3247
  readonly deleteLabel: typeof deleteLabelCore;
3099
3248
  readonly addAssignees: typeof addAssigneesCore;
3100
3249
  readonly removeAssignees: typeof removeAssigneesCore;
3250
+ readonly listMilestones: typeof listMilestonesCore;
3251
+ readonly listSubIssues: typeof listSubIssuesCore;
3252
+ readonly addSubIssue: typeof addSubIssueCore;
3101
3253
  readonly listIssueReactions: typeof listIssueReactionsCore;
3102
3254
  readonly addIssueReaction: typeof addIssueReactionCore;
3103
3255
  readonly listCommentReactions: typeof listCommentReactionsCore;
@@ -3131,6 +3283,7 @@ declare const GITHUB_TOOL_CORES: {
3131
3283
  readonly rerunWorkflowRun: typeof rerunWorkflowRunCore;
3132
3284
  readonly listCheckRuns: typeof listCheckRunsCore;
3133
3285
  readonly getCombinedStatus: typeof getCombinedStatusCore;
3286
+ readonly createCommitStatus: typeof createCommitStatusCore;
3134
3287
  readonly getCiFailureContext: typeof getCiFailureContextCore;
3135
3288
  readonly listReleases: typeof listReleasesCore;
3136
3289
  readonly getLatestRelease: typeof getLatestReleaseCore;
@@ -3143,12 +3296,14 @@ declare const GITHUB_TOOL_CORES: {
3143
3296
  readonly listDependabotAlerts: typeof listDependabotAlertsCore;
3144
3297
  readonly listSecretScanningAlerts: typeof listSecretScanningAlertsCore;
3145
3298
  };
3146
- //#endregion
3147
- //#region src/tanstack/tools.d.ts
3148
3299
  type Catalog = typeof GITHUB_TOOL_CATALOG;
3149
- /** A TanStack server tool with the catalog's input schema and core return type. */
3300
+ type CoreResult<N extends GithubToolName> = Awaited<ReturnType<(typeof GITHUB_TOOL_CORES)[N]>>;
3301
+ /**
3302
+ * A TanStack server tool with the catalog's input schema and core return type. A write tool created
3303
+ * with `dryRun: true` returns a `GithubDryRunResult` instead, so narrow with `'dryRun' in result`.
3304
+ */
3150
3305
  type GithubTanstackTool<N extends GithubToolName = GithubToolName> = N extends GithubToolName ? Omit<ServerTool<Catalog[N]['inputSchema'], undefined, N, unknown, boolean>, 'execute'> & {
3151
- execute: (input: z.input<Catalog[N]['inputSchema']>) => ReturnType<(typeof GITHUB_TOOL_CORES)[N]>;
3306
+ execute: (input: z.input<Catalog[N]['inputSchema']>) => Promise<N extends GithubWriteToolName ? CoreResult<N> | GithubDryRunResult : CoreResult<N>>;
3152
3307
  } : never;
3153
3308
  /** Supported TanStack tool customizations. */
3154
3309
  type TanstackToolOverrides = {
@@ -3162,6 +3317,10 @@ type TanstackToolOptions = Omit<TanstackToolOverrides, 'needsApproval'> & {
3162
3317
  author?: CommitIdentity;
3163
3318
  committer?: CommitIdentity;
3164
3319
  coAuthors?: CommitIdentity[];
3320
+ /** Repositories and branches the tool may act on, checked before each call reaches GitHub. */
3321
+ guardrails?: GithubGuardrails;
3322
+ /** Send no write to GitHub: a write returns a `GithubDryRunResult` instead, after the guardrails check. */
3323
+ dryRun?: boolean;
3165
3324
  };
3166
3325
  /** Configuration for a native array of GitHub server tools. */
3167
3326
  type CreateGithubToolsOptions = Omit<TanstackToolOptions, 'description' | 'needsApproval'> & {
@@ -3174,8 +3333,6 @@ type CreateGithubToolsOptions = Omit<TanstackToolOptions, 'description' | 'needs
3174
3333
  export declare function createGithubTools<const P extends GithubToolPreset | readonly GithubToolPreset[] | undefined = undefined>(options?: CreateGithubToolsOptions & {
3175
3334
  preset?: P;
3176
3335
  }): GithubTanstackTool<P extends GithubToolPreset ? PresetToolName<P> : P extends readonly GithubToolPreset[] ? PresetToolName<P[number]> : GithubToolName>[];
3177
- //#endregion
3178
- //#region src/tanstack/evaluation.d.ts
3179
3336
  /** Jev configuration for TanStack automatic approval and preset selection. */
3180
3337
  type GithubEvaluationOptions = {
3181
3338
  /** Defaults to vercelGatewayDecider('typesafe-ai/jev') using Gateway authentication. */
@@ -3190,8 +3347,6 @@ type GithubEvaluationOptions = {
3190
3347
  maxPresets?: number;
3191
3348
  };
3192
3349
  export declare function selectPresets(messages: readonly ModelMessage[], options?: GithubEvaluationOptions, signal?: AbortSignal): Promise<RoutablePreset[]>;
3193
- //#endregion
3194
- //#region src/tanstack/agent.d.ts
3195
3350
  type NativeOptions<A extends AnyTextAdapter> = Parameters<typeof chat<A, undefined, true>>[0];
3196
3351
  type ChatSettings<A extends AnyTextAdapter> = Omit<NativeOptions<A>, 'tools' | 'messages' | 'systemPrompts' | 'context' | 'middleware' | 'interrupts' | 'stream' | 'outputSchema'>;
3197
3352
  /** Configure a GitHub agent backed by TanStack chat(). */
@@ -3223,9 +3378,7 @@ type GithubAgent<A extends AnyTextAdapter> = {
3223
3378
  stream: (options: GithubAgentCallOptions<A>) => ChatStream;
3224
3379
  };
3225
3380
  /** Create a GitHub agent with preset instructions, tools, and automatic approval middleware. */
3226
- export declare function createGithubAgent<A extends AnyTextAdapter>({ token, preset, requireApproval, overrides, context, author, committer, coAuthors, instructions, additionalInstructions, evaluation, middleware, ...settings }: CreateGithubAgentOptions<A>): GithubAgent<A>;
3227
- //#endregion
3228
- //#region src/tanstack/approval.d.ts
3381
+ 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>;
3229
3382
  /** Options for GitHub approval middleware. Register githubToolApproval with chat(). */
3230
3383
  type GithubApprovalMiddlewareOptions = {
3231
3384
  tools: readonly Tool[];
@@ -3233,8 +3386,6 @@ type GithubApprovalMiddlewareOptions = {
3233
3386
  };
3234
3387
  /** Evaluate automatic GitHub writes before execution and request review through githubToolApproval. */
3235
3388
  export declare function createGithubApprovalMiddleware({ tools, evaluation }: GithubApprovalMiddlewareOptions): ChatMiddleware<unknown, typeof githubToolApproval>;
3236
- //#endregion
3237
- //#region src/tanstack/factories.d.ts
3238
3389
  /** Create the TanStack `getRepository` server tool. */
3239
3390
  export declare const getRepository: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
3240
3391
  owner: import("zod").ZodString;
@@ -3270,11 +3421,13 @@ export declare const listBranches: (token: GithubTokenInput, options?: TanstackT
3270
3421
  repo: string;
3271
3422
  perPage?: number | undefined;
3272
3423
  page?: number | undefined;
3273
- }) => Promise<PagedList<{
3274
- name: string;
3275
- sha: string;
3276
- protected: boolean;
3277
- }>>;
3424
+ }) => Promise<{
3425
+ items: {
3426
+ name: string;
3427
+ sha: string;
3428
+ protected: boolean;
3429
+ }[];
3430
+ } & PagingFields>;
3278
3431
  };
3279
3432
  /** Create the TanStack `getFileContent` server tool. */
3280
3433
  export declare const getFileContent: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3386,7 +3539,7 @@ export declare const createBranch: (token: GithubTokenInput, options?: TanstackT
3386
3539
  ref: string;
3387
3540
  sha: string;
3388
3541
  url: string;
3389
- }>;
3542
+ } | GithubDryRunResult>;
3390
3543
  };
3391
3544
  /** Create the TanStack `deleteBranch` server tool. */
3392
3545
  export declare const deleteBranch: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3401,7 +3554,7 @@ export declare const deleteBranch: (token: GithubTokenInput, options?: TanstackT
3401
3554
  }) => Promise<{
3402
3555
  deleted: boolean;
3403
3556
  branch: string;
3404
- }>;
3557
+ } | GithubDryRunResult>;
3405
3558
  };
3406
3559
  /** Create the TanStack `forkRepository` server tool. */
3407
3560
  export declare const forkRepository: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3427,7 +3580,7 @@ export declare const forkRepository: (token: GithubTokenInput, options?: Tanstac
3427
3580
  fullName: string;
3428
3581
  url: string;
3429
3582
  } | null;
3430
- }>;
3583
+ } | GithubDryRunResult>;
3431
3584
  };
3432
3585
  /** Create the TanStack `createRepository` server tool. */
3433
3586
  export declare const createRepository: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3457,7 +3610,7 @@ export declare const createRepository: (token: GithubTokenInput, options?: Tanst
3457
3610
  defaultBranch: string;
3458
3611
  private: boolean;
3459
3612
  createdAt: string;
3460
- }>;
3613
+ } | GithubDryRunResult>;
3461
3614
  };
3462
3615
  /** Create the TanStack `createOrUpdateFile` server tool. */
3463
3616
  export declare const createOrUpdateFile: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3491,7 +3644,7 @@ export declare const createOrUpdateFile: (token: GithubTokenInput, options?: Tan
3491
3644
  commitUrl: string | undefined;
3492
3645
  skipped?: undefined;
3493
3646
  message?: undefined;
3494
- }>;
3647
+ } | GithubDryRunResult>;
3495
3648
  };
3496
3649
  /** Create the TanStack `editFiles` server tool. */
3497
3650
  export declare const editFiles: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3548,7 +3701,7 @@ export declare const editFiles: (token: GithubTokenInput, options?: TanstackTool
3548
3701
  sha?: string;
3549
3702
  url?: string;
3550
3703
  }[];
3551
- }>;
3704
+ } | GithubDryRunResult>;
3552
3705
  };
3553
3706
  /** Create the TanStack `listPullRequests` server tool. */
3554
3707
  export declare const listPullRequests: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3570,18 +3723,20 @@ export declare const listPullRequests: (token: GithubTokenInput, options?: Tanst
3570
3723
  perPage?: number | undefined;
3571
3724
  page?: number | undefined;
3572
3725
  maxPages?: number | undefined;
3573
- }) => Promise<PagedList<{
3574
- number: number;
3575
- title: string;
3576
- state: string;
3577
- url: string;
3578
- author: string | undefined;
3579
- branch: string;
3580
- base: string;
3581
- draft: boolean | undefined;
3582
- createdAt: string;
3583
- updatedAt: string;
3584
- }>>;
3726
+ }) => Promise<{
3727
+ items: {
3728
+ number: number;
3729
+ title: string;
3730
+ state: string;
3731
+ url: string;
3732
+ author: string | undefined;
3733
+ branch: string;
3734
+ base: string;
3735
+ draft: boolean | undefined;
3736
+ createdAt: string;
3737
+ updatedAt: string;
3738
+ }[];
3739
+ } & PagingFields>;
3585
3740
  };
3586
3741
  /** Create the TanStack `getPullRequest` server tool. */
3587
3742
  export declare const getPullRequest: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3650,7 +3805,7 @@ export declare const createPullRequest: (token: GithubTokenInput, options?: Tans
3650
3805
  draft: boolean | undefined;
3651
3806
  branch: string;
3652
3807
  base: string;
3653
- }>;
3808
+ } | GithubDryRunResult>;
3654
3809
  };
3655
3810
  /** Create the TanStack `mergePullRequest` server tool. */
3656
3811
  export declare const mergePullRequest: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3676,7 +3831,7 @@ export declare const mergePullRequest: (token: GithubTokenInput, options?: Tanst
3676
3831
  merged: boolean;
3677
3832
  message: string;
3678
3833
  sha: string;
3679
- }>;
3834
+ } | GithubDryRunResult>;
3680
3835
  };
3681
3836
  /** Create the TanStack `enablePullRequestAutoMerge` server tool. */
3682
3837
  export declare const enablePullRequestAutoMerge: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3705,7 +3860,7 @@ export declare const enablePullRequestAutoMerge: (token: GithubTokenInput, optio
3705
3860
  enabledAt: string;
3706
3861
  mergeMethod: string;
3707
3862
  } | null;
3708
- }>;
3863
+ } | GithubDryRunResult>;
3709
3864
  };
3710
3865
  /** Create the TanStack `disablePullRequestAutoMerge` server tool. */
3711
3866
  export declare const disablePullRequestAutoMerge: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3721,7 +3876,7 @@ export declare const disablePullRequestAutoMerge: (token: GithubTokenInput, opti
3721
3876
  number: number;
3722
3877
  url: string;
3723
3878
  autoMerge: null;
3724
- }>;
3879
+ } | GithubDryRunResult>;
3725
3880
  };
3726
3881
  /** Create the TanStack `getBranchRules` server tool. */
3727
3882
  export declare const getBranchRules: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3821,6 +3976,22 @@ export declare const getBranchRules: (token: GithubTokenInput, options?: Tanstac
3821
3976
  }[];
3822
3977
  }>;
3823
3978
  };
3979
+ /** Create the TanStack `getCollaboratorPermission` server tool. */
3980
+ export declare const getCollaboratorPermission: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
3981
+ owner: import("zod").ZodString;
3982
+ repo: import("zod").ZodString;
3983
+ username: import("zod").ZodString;
3984
+ }, import("zod/v4/core").$strip>, undefined, "getCollaboratorPermission", unknown, boolean, undefined>, "execute"> & {
3985
+ execute: (input: {
3986
+ owner: string;
3987
+ repo: string;
3988
+ username: string;
3989
+ }) => Promise<{
3990
+ username: string;
3991
+ permission: string;
3992
+ roleName: string;
3993
+ }>;
3994
+ };
3824
3995
  /** Create the TanStack `updatePullRequest` server tool. */
3825
3996
  export declare const updatePullRequest: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
3826
3997
  owner: import("zod").ZodString;
@@ -3852,7 +4023,24 @@ export declare const updatePullRequest: (token: GithubTokenInput, options?: Tans
3852
4023
  url: string;
3853
4024
  base: string;
3854
4025
  updatedAt: string;
3855
- }>;
4026
+ } | GithubDryRunResult>;
4027
+ };
4028
+ /** Create the TanStack `updatePullRequestBranch` server tool. */
4029
+ export declare const updatePullRequestBranch: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
4030
+ owner: import("zod").ZodString;
4031
+ repo: import("zod").ZodString;
4032
+ pullNumber: import("zod").ZodNumber;
4033
+ expectedHeadSha: import("zod").ZodOptional<import("zod").ZodString>;
4034
+ }, import("zod/v4/core").$strip>, undefined, "updatePullRequestBranch", unknown, boolean, undefined>, "execute"> & {
4035
+ execute: (input: {
4036
+ owner: string;
4037
+ repo: string;
4038
+ pullNumber: number;
4039
+ expectedHeadSha?: string | undefined;
4040
+ }) => Promise<{
4041
+ message: string | undefined;
4042
+ url: string | undefined;
4043
+ } | GithubDryRunResult>;
3856
4044
  };
3857
4045
  /** Create the TanStack `addPullRequestComment` server tool. */
3858
4046
  export declare const addPullRequestComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3872,7 +4060,7 @@ export declare const addPullRequestComment: (token: GithubTokenInput, options?:
3872
4060
  body: string | undefined;
3873
4061
  author: string | undefined;
3874
4062
  createdAt: string;
3875
- }>;
4063
+ } | GithubDryRunResult>;
3876
4064
  };
3877
4065
  /** Create the TanStack `updatePullRequestComment` server tool. */
3878
4066
  export declare const updatePullRequestComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3891,7 +4079,7 @@ export declare const updatePullRequestComment: (token: GithubTokenInput, options
3891
4079
  url: string;
3892
4080
  body: string | undefined;
3893
4081
  updatedAt: string;
3894
- }>;
4082
+ } | GithubDryRunResult>;
3895
4083
  };
3896
4084
  /** Create the TanStack `deletePullRequestComment` server tool. */
3897
4085
  export declare const deletePullRequestComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3906,7 +4094,7 @@ export declare const deletePullRequestComment: (token: GithubTokenInput, options
3906
4094
  }) => Promise<{
3907
4095
  deleted: boolean;
3908
4096
  commentId: number;
3909
- }>;
4097
+ } | GithubDryRunResult>;
3910
4098
  };
3911
4099
  /** Create the TanStack `listPullRequestFiles` server tool. */
3912
4100
  export declare const listPullRequestFiles: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3926,14 +4114,16 @@ export declare const listPullRequestFiles: (token: GithubTokenInput, options?: T
3926
4114
  filenames?: string[] | undefined;
3927
4115
  perPage?: number | undefined;
3928
4116
  page?: number | undefined;
3929
- }) => Promise<PagedList<{
3930
- patch?: string | undefined;
3931
- filename: string;
3932
- status: "added" | "removed" | "modified" | "renamed" | "copied" | "changed" | "unchanged";
3933
- additions: number;
3934
- deletions: number;
3935
- changes: number;
3936
- }>>;
4117
+ }) => Promise<{
4118
+ items: {
4119
+ patch?: string | undefined;
4120
+ filename: string;
4121
+ status: "added" | "removed" | "modified" | "renamed" | "copied" | "changed" | "unchanged";
4122
+ additions: number;
4123
+ deletions: number;
4124
+ changes: number;
4125
+ }[];
4126
+ } & PagingFields>;
3937
4127
  };
3938
4128
  /** Create the TanStack `listPullRequestReviews` server tool. */
3939
4129
  export declare const listPullRequestReviews: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3949,14 +4139,16 @@ export declare const listPullRequestReviews: (token: GithubTokenInput, options?:
3949
4139
  pullNumber: number;
3950
4140
  perPage?: number | undefined;
3951
4141
  page?: number | undefined;
3952
- }) => Promise<PagedList<{
3953
- id: number;
3954
- state: string;
3955
- body: string;
3956
- author: string | undefined;
3957
- url: string;
3958
- submittedAt: string | undefined;
3959
- }>>;
4142
+ }) => Promise<{
4143
+ items: {
4144
+ id: number;
4145
+ state: string;
4146
+ body: string;
4147
+ author: string | undefined;
4148
+ url: string;
4149
+ submittedAt: string | undefined;
4150
+ }[];
4151
+ } & PagingFields>;
3960
4152
  };
3961
4153
  /** Create the TanStack `createPullRequestReview` server tool. */
3962
4154
  export declare const createPullRequestReview: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4005,7 +4197,7 @@ export declare const createPullRequestReview: (token: GithubTokenInput, options?
4005
4197
  url: string;
4006
4198
  author: string | undefined;
4007
4199
  submittedAt: string | undefined;
4008
- }>;
4200
+ } | GithubDryRunResult>;
4009
4201
  };
4010
4202
  /** Create the TanStack `listPullRequestReviewThreads` server tool. */
4011
4203
  export declare const listPullRequestReviewThreads: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4081,7 +4273,7 @@ export declare const replyToReviewComment: (token: GithubTokenInput, options?: T
4081
4273
  url: string;
4082
4274
  author: string;
4083
4275
  createdAt: string;
4084
- }>;
4276
+ } | GithubDryRunResult>;
4085
4277
  };
4086
4278
  /** Create the TanStack `resolveReviewThread` server tool. */
4087
4279
  export declare const resolveReviewThread: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4097,7 +4289,7 @@ export declare const resolveReviewThread: (token: GithubTokenInput, options?: Ta
4097
4289
  threadId: string;
4098
4290
  isResolved: boolean;
4099
4291
  error?: undefined;
4100
- }>;
4292
+ } | GithubDryRunResult>;
4101
4293
  };
4102
4294
  /** Create the TanStack `requestReviewers` server tool. */
4103
4295
  export declare const requestReviewers: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4118,7 +4310,7 @@ export declare const requestReviewers: (token: GithubTokenInput, options?: Tanst
4118
4310
  url: string;
4119
4311
  requestedReviewers: string[] | undefined;
4120
4312
  requestedTeams: string[] | undefined;
4121
- }>;
4313
+ } | GithubDryRunResult>;
4122
4314
  };
4123
4315
  /** Create the TanStack `getPullRequestContext` server tool. */
4124
4316
  export declare const getPullRequestContext: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4298,16 +4490,18 @@ export declare const listIssues: (token: GithubTokenInput, options?: TanstackToo
4298
4490
  perPage?: number | undefined;
4299
4491
  page?: number | undefined;
4300
4492
  maxPages?: number | undefined;
4301
- }) => Promise<PagedList<{
4302
- number: number;
4303
- title: string;
4304
- state: string;
4305
- url: string;
4306
- author: string | undefined;
4307
- labels: (string | undefined)[];
4308
- createdAt: string;
4309
- updatedAt: string;
4310
- }>>;
4493
+ }) => Promise<{
4494
+ items: {
4495
+ number: number;
4496
+ title: string;
4497
+ state: string;
4498
+ url: string;
4499
+ author: string | undefined;
4500
+ labels: (string | undefined)[];
4501
+ createdAt: string;
4502
+ updatedAt: string;
4503
+ }[];
4504
+ } & PagingFields>;
4311
4505
  };
4312
4506
  /** Create the TanStack `getIssue` server tool. */
4313
4507
  export declare const getIssue: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4358,14 +4552,16 @@ export declare const listIssueComments: (token: GithubTokenInput, options?: Tans
4358
4552
  perPage?: number | undefined;
4359
4553
  page?: number | undefined;
4360
4554
  detail?: "summary" | "full" | undefined;
4361
- }) => Promise<PagedList<{
4362
- id: number;
4363
- url: string;
4364
- body: string | null | undefined;
4365
- author: string | undefined;
4366
- createdAt: string;
4367
- updatedAt: string;
4368
- }>>;
4555
+ }) => Promise<{
4556
+ items: {
4557
+ id: number;
4558
+ url: string;
4559
+ body: string | null | undefined;
4560
+ author: string | undefined;
4561
+ createdAt: string;
4562
+ updatedAt: string;
4563
+ }[];
4564
+ } & PagingFields>;
4369
4565
  };
4370
4566
  /** Create the TanStack `createIssue` server tool. */
4371
4567
  export declare const createIssue: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4375,6 +4571,7 @@ export declare const createIssue: (token: GithubTokenInput, options?: TanstackTo
4375
4571
  body: import("zod").ZodOptional<import("zod").ZodString>;
4376
4572
  labels: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
4377
4573
  assignees: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
4574
+ milestone: import("zod").ZodOptional<import("zod").ZodNumber>;
4378
4575
  }, import("zod/v4/core").$strip>, undefined, "createIssue", unknown, boolean, undefined>, "execute"> & {
4379
4576
  execute: (input: {
4380
4577
  owner: string;
@@ -4383,13 +4580,14 @@ export declare const createIssue: (token: GithubTokenInput, options?: TanstackTo
4383
4580
  body?: string | undefined;
4384
4581
  labels?: string[] | undefined;
4385
4582
  assignees?: string[] | undefined;
4583
+ milestone?: number | undefined;
4386
4584
  }) => Promise<{
4387
4585
  number: number;
4388
4586
  title: string;
4389
4587
  url: string;
4390
4588
  state: string;
4391
4589
  labels: (string | undefined)[];
4392
- }>;
4590
+ } | GithubDryRunResult>;
4393
4591
  };
4394
4592
  /** Create the TanStack `addIssueComment` server tool. */
4395
4593
  export declare const addIssueComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4409,7 +4607,7 @@ export declare const addIssueComment: (token: GithubTokenInput, options?: Tansta
4409
4607
  body: string | undefined;
4410
4608
  author: string | undefined;
4411
4609
  createdAt: string;
4412
- }>;
4610
+ } | GithubDryRunResult>;
4413
4611
  };
4414
4612
  /** Create the TanStack `updateIssueComment` server tool. */
4415
4613
  export declare const updateIssueComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4428,7 +4626,7 @@ export declare const updateIssueComment: (token: GithubTokenInput, options?: Tan
4428
4626
  url: string;
4429
4627
  body: string | undefined;
4430
4628
  updatedAt: string;
4431
- }>;
4629
+ } | GithubDryRunResult>;
4432
4630
  };
4433
4631
  /** Create the TanStack `deleteIssueComment` server tool. */
4434
4632
  export declare const deleteIssueComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4443,7 +4641,7 @@ export declare const deleteIssueComment: (token: GithubTokenInput, options?: Tan
4443
4641
  }) => Promise<{
4444
4642
  deleted: boolean;
4445
4643
  commentId: number;
4446
- }>;
4644
+ } | GithubDryRunResult>;
4447
4645
  };
4448
4646
  /** Create the TanStack `closeIssue` server tool. */
4449
4647
  export declare const closeIssue: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4466,7 +4664,7 @@ export declare const closeIssue: (token: GithubTokenInput, options?: TanstackToo
4466
4664
  state: string;
4467
4665
  url: string;
4468
4666
  closedAt: string | null;
4469
- }>;
4667
+ } | GithubDryRunResult>;
4470
4668
  };
4471
4669
  /** Create the TanStack `updateIssue` server tool. */
4472
4670
  export declare const updateIssue: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4509,7 +4707,7 @@ export declare const updateIssue: (token: GithubTokenInput, options?: TanstackTo
4509
4707
  milestone: number | null;
4510
4708
  closedAt: string | null;
4511
4709
  updatedAt: string;
4512
- }>;
4710
+ } | GithubDryRunResult>;
4513
4711
  };
4514
4712
  /** Create the TanStack `listLabels` server tool. */
4515
4713
  export declare const listLabels: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4523,11 +4721,13 @@ export declare const listLabels: (token: GithubTokenInput, options?: TanstackToo
4523
4721
  repo: string;
4524
4722
  perPage?: number | undefined;
4525
4723
  page?: number | undefined;
4526
- }) => Promise<PagedList<{
4527
- name: string;
4528
- color: string;
4529
- description: string | null;
4530
- }>>;
4724
+ }) => Promise<{
4725
+ items: {
4726
+ name: string;
4727
+ color: string;
4728
+ description: string | null;
4729
+ }[];
4730
+ } & PagingFields>;
4531
4731
  };
4532
4732
  /** Create the TanStack `addLabels` server tool. */
4533
4733
  export declare const addLabels: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4545,7 +4745,7 @@ export declare const addLabels: (token: GithubTokenInput, options?: TanstackTool
4545
4745
  name: string;
4546
4746
  color: string;
4547
4747
  description: string | null;
4548
- }[]>;
4748
+ }[] | GithubDryRunResult>;
4549
4749
  };
4550
4750
  /** Create the TanStack `removeLabel` server tool. */
4551
4751
  export declare const removeLabel: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4563,7 +4763,7 @@ export declare const removeLabel: (token: GithubTokenInput, options?: TanstackTo
4563
4763
  removed: boolean;
4564
4764
  label: string;
4565
4765
  issueNumber: number;
4566
- }>;
4766
+ } | GithubDryRunResult>;
4567
4767
  };
4568
4768
  /** Create the TanStack `createLabel` server tool. */
4569
4769
  export declare const createLabel: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4583,7 +4783,7 @@ export declare const createLabel: (token: GithubTokenInput, options?: TanstackTo
4583
4783
  name: string;
4584
4784
  color: string;
4585
4785
  description: string | null;
4586
- }>;
4786
+ } | GithubDryRunResult>;
4587
4787
  };
4588
4788
  /** Create the TanStack `updateLabel` server tool. */
4589
4789
  export declare const updateLabel: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4605,7 +4805,7 @@ export declare const updateLabel: (token: GithubTokenInput, options?: TanstackTo
4605
4805
  name: string;
4606
4806
  color: string;
4607
4807
  description: string | null;
4608
- }>;
4808
+ } | GithubDryRunResult>;
4609
4809
  };
4610
4810
  /** Create the TanStack `deleteLabel` server tool. */
4611
4811
  export declare const deleteLabel: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4620,7 +4820,7 @@ export declare const deleteLabel: (token: GithubTokenInput, options?: TanstackTo
4620
4820
  }) => Promise<{
4621
4821
  deleted: boolean;
4622
4822
  name: string;
4623
- }>;
4823
+ } | GithubDryRunResult>;
4624
4824
  };
4625
4825
  /** Create the TanStack `addAssignees` server tool. */
4626
4826
  export declare const addAssignees: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4637,7 +4837,7 @@ export declare const addAssignees: (token: GithubTokenInput, options?: TanstackT
4637
4837
  }) => Promise<{
4638
4838
  number: number;
4639
4839
  assignees: string[] | undefined;
4640
- }>;
4840
+ } | GithubDryRunResult>;
4641
4841
  };
4642
4842
  /** Create the TanStack `removeAssignees` server tool. */
4643
4843
  export declare const removeAssignees: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4654,7 +4854,88 @@ export declare const removeAssignees: (token: GithubTokenInput, options?: Tansta
4654
4854
  }) => Promise<{
4655
4855
  number: number;
4656
4856
  assignees: string[] | undefined;
4657
- }>;
4857
+ } | GithubDryRunResult>;
4858
+ };
4859
+ /** Create the TanStack `listMilestones` server tool. */
4860
+ export declare const listMilestones: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
4861
+ owner: import("zod").ZodString;
4862
+ repo: import("zod").ZodString;
4863
+ state: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
4864
+ open: "open";
4865
+ closed: "closed";
4866
+ all: "all";
4867
+ }>>>;
4868
+ perPage: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
4869
+ page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
4870
+ }, import("zod/v4/core").$strip>, undefined, "listMilestones", unknown, boolean, undefined>, "execute"> & {
4871
+ execute: (input: {
4872
+ owner: string;
4873
+ repo: string;
4874
+ state?: "open" | "closed" | "all" | undefined;
4875
+ perPage?: number | undefined;
4876
+ page?: number | undefined;
4877
+ }) => Promise<{
4878
+ items: {
4879
+ number: number;
4880
+ title: string;
4881
+ state: "open" | "closed";
4882
+ description: string | null | undefined;
4883
+ dueOn: string | null;
4884
+ openIssues: number;
4885
+ closedIssues: number;
4886
+ url: string;
4887
+ }[];
4888
+ } & PagingFields>;
4889
+ };
4890
+ /** Create the TanStack `listSubIssues` server tool. */
4891
+ export declare const listSubIssues: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
4892
+ owner: import("zod").ZodString;
4893
+ repo: import("zod").ZodString;
4894
+ issueNumber: import("zod").ZodNumber;
4895
+ perPage: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
4896
+ page: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodNumber>>;
4897
+ }, import("zod/v4/core").$strip>, undefined, "listSubIssues", unknown, boolean, undefined>, "execute"> & {
4898
+ execute: (input: {
4899
+ owner: string;
4900
+ repo: string;
4901
+ issueNumber: number;
4902
+ perPage?: number | undefined;
4903
+ page?: number | undefined;
4904
+ }) => Promise<{
4905
+ items: {
4906
+ number: number;
4907
+ title: string;
4908
+ state: string;
4909
+ url: string;
4910
+ assignees: string[] | undefined;
4911
+ }[];
4912
+ } & PagingFields>;
4913
+ };
4914
+ /** Create the TanStack `addSubIssue` server tool. */
4915
+ export declare const addSubIssue: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
4916
+ owner: import("zod").ZodString;
4917
+ repo: import("zod").ZodString;
4918
+ issueNumber: import("zod").ZodNumber;
4919
+ subIssueNumber: import("zod").ZodNumber;
4920
+ subIssueRepo: import("zod").ZodOptional<import("zod").ZodString>;
4921
+ replaceParent: import("zod").ZodOptional<import("zod").ZodBoolean>;
4922
+ }, import("zod/v4/core").$strip>, undefined, "addSubIssue", unknown, boolean, undefined>, "execute"> & {
4923
+ execute: (input: {
4924
+ owner: string;
4925
+ repo: string;
4926
+ issueNumber: number;
4927
+ subIssueNumber: number;
4928
+ subIssueRepo?: string | undefined;
4929
+ replaceParent?: boolean | undefined;
4930
+ }) => Promise<{
4931
+ issueNumber: number;
4932
+ subIssue: {
4933
+ number: number;
4934
+ title: string;
4935
+ state: string;
4936
+ url: string;
4937
+ };
4938
+ } | GithubDryRunResult>;
4658
4939
  };
4659
4940
  /** Create the TanStack `listIssueReactions` server tool. */
4660
4941
  export declare const listIssueReactions: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4720,7 +5001,7 @@ export declare const addIssueReaction: (token: GithubTokenInput, options?: Tanst
4720
5001
  content: "+1" | "-1" | "laugh" | "confused" | "heart" | "hooray" | "rocket" | "eyes";
4721
5002
  user: string | undefined;
4722
5003
  issueNumber: number;
4723
- }>;
5004
+ } | GithubDryRunResult>;
4724
5005
  };
4725
5006
  /** Create the TanStack `listCommentReactions` server tool. */
4726
5007
  export declare const listCommentReactions: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4786,7 +5067,7 @@ export declare const addCommentReaction: (token: GithubTokenInput, options?: Tan
4786
5067
  content: "+1" | "-1" | "laugh" | "confused" | "heart" | "hooray" | "rocket" | "eyes";
4787
5068
  user: string | undefined;
4788
5069
  commentId: number;
4789
- }>;
5070
+ } | GithubDryRunResult>;
4790
5071
  };
4791
5072
  /** Create the TanStack `listDiscussions` server tool. */
4792
5073
  export declare const listDiscussions: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4893,7 +5174,7 @@ export declare const addDiscussionComment: (token: GithubTokenInput, options?: T
4893
5174
  author: string | null;
4894
5175
  createdAt: string;
4895
5176
  error?: undefined;
4896
- }>;
5177
+ } | GithubDryRunResult>;
4897
5178
  };
4898
5179
  /** Create the TanStack `listNotifications` server tool. */
4899
5180
  export declare const listNotifications: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4907,18 +5188,20 @@ export declare const listNotifications: (token: GithubTokenInput, options?: Tans
4907
5188
  participating?: boolean | undefined;
4908
5189
  perPage?: number | undefined;
4909
5190
  page?: number | undefined;
4910
- }) => Promise<PagedList<{
4911
- threadId: string;
4912
- repository: string;
4913
- subject: {
4914
- title: string;
4915
- type: string;
4916
- url: string;
4917
- };
4918
- reason: string;
4919
- unread: boolean;
4920
- updatedAt: string;
4921
- }>>;
5191
+ }) => Promise<{
5192
+ items: {
5193
+ threadId: string;
5194
+ repository: string;
5195
+ subject: {
5196
+ title: string;
5197
+ type: string;
5198
+ url: string;
5199
+ };
5200
+ reason: string;
5201
+ unread: boolean;
5202
+ updatedAt: string;
5203
+ }[];
5204
+ } & PagingFields>;
4922
5205
  };
4923
5206
  /** Create the TanStack `markNotificationRead` server tool. */
4924
5207
  export declare const markNotificationRead: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4929,7 +5212,7 @@ export declare const markNotificationRead: (token: GithubTokenInput, options?: T
4929
5212
  }) => Promise<{
4930
5213
  marked: boolean;
4931
5214
  threadId: string;
4932
- }>;
5215
+ } | GithubDryRunResult>;
4933
5216
  };
4934
5217
  /** Create the TanStack `searchCode` server tool. */
4935
5218
  export declare const searchCode: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5049,14 +5332,16 @@ export declare const listCommits: (token: GithubTokenInput, options?: TanstackTo
5049
5332
  perPage?: number | undefined;
5050
5333
  page?: number | undefined;
5051
5334
  maxPages?: number | undefined;
5052
- }) => Promise<PagedList<{
5053
- sha: string;
5054
- message: string;
5055
- author: string | undefined;
5056
- authorLogin: string | undefined;
5057
- date: string | undefined;
5058
- url: string;
5059
- }>>;
5335
+ }) => Promise<{
5336
+ items: {
5337
+ sha: string;
5338
+ message: string;
5339
+ author: string | undefined;
5340
+ authorLogin: string | undefined;
5341
+ date: string | undefined;
5342
+ url: string;
5343
+ }[];
5344
+ } & PagingFields>;
5060
5345
  };
5061
5346
  /** Create the TanStack `getCommit` server tool. */
5062
5347
  export declare const getCommit: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5184,17 +5469,19 @@ export declare const listGists: (token: GithubTokenInput, options?: TanstackTool
5184
5469
  username?: string | undefined;
5185
5470
  perPage?: number | undefined;
5186
5471
  page?: number | undefined;
5187
- }) => Promise<PagedList<{
5188
- id: string;
5189
- description: string | null;
5190
- public: boolean;
5191
- url: string;
5192
- files: string[];
5193
- owner: string | undefined;
5194
- comments: number;
5195
- createdAt: string;
5196
- updatedAt: string;
5197
- }>>;
5472
+ }) => Promise<{
5473
+ items: {
5474
+ id: string;
5475
+ description: string | null;
5476
+ public: boolean;
5477
+ url: string;
5478
+ files: string[];
5479
+ owner: string | undefined;
5480
+ comments: number;
5481
+ createdAt: string;
5482
+ updatedAt: string;
5483
+ }[];
5484
+ } & PagingFields>;
5198
5485
  };
5199
5486
  /** Create the TanStack `getGist` server tool. */
5200
5487
  export declare const getGist: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5229,14 +5516,16 @@ export declare const listGistComments: (token: GithubTokenInput, options?: Tanst
5229
5516
  gistId: string;
5230
5517
  perPage?: number | undefined;
5231
5518
  page?: number | undefined;
5232
- }) => Promise<PagedList<{
5233
- id: number;
5234
- body: string;
5235
- author: string | undefined;
5236
- url: string;
5237
- createdAt: string;
5238
- updatedAt: string;
5239
- }>>;
5519
+ }) => Promise<{
5520
+ items: {
5521
+ id: number;
5522
+ body: string;
5523
+ author: string | undefined;
5524
+ url: string;
5525
+ createdAt: string;
5526
+ updatedAt: string;
5527
+ }[];
5528
+ } & PagingFields>;
5240
5529
  };
5241
5530
  /** Create the TanStack `createGist` server tool. */
5242
5531
  export declare const createGist: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5259,7 +5548,7 @@ export declare const createGist: (token: GithubTokenInput, options?: TanstackToo
5259
5548
  url: string | undefined;
5260
5549
  files: string[];
5261
5550
  owner: string | undefined;
5262
- }>;
5551
+ } | GithubDryRunResult>;
5263
5552
  };
5264
5553
  /** Create the TanStack `updateGist` server tool. */
5265
5554
  export declare const updateGist: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5282,7 +5571,7 @@ export declare const updateGist: (token: GithubTokenInput, options?: TanstackToo
5282
5571
  description: string | null | undefined;
5283
5572
  url: string | undefined;
5284
5573
  files: string[];
5285
- }>;
5574
+ } | GithubDryRunResult>;
5286
5575
  };
5287
5576
  /** Create the TanStack `deleteGist` server tool. */
5288
5577
  export declare const deleteGist: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5293,7 +5582,7 @@ export declare const deleteGist: (token: GithubTokenInput, options?: TanstackToo
5293
5582
  }) => Promise<{
5294
5583
  deleted: boolean;
5295
5584
  gistId: string;
5296
- }>;
5585
+ } | GithubDryRunResult>;
5297
5586
  };
5298
5587
  /** Create the TanStack `createGistComment` server tool. */
5299
5588
  export declare const createGistComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5309,7 +5598,7 @@ export declare const createGistComment: (token: GithubTokenInput, options?: Tans
5309
5598
  body: string;
5310
5599
  author: string | undefined;
5311
5600
  createdAt: string;
5312
- }>;
5601
+ } | GithubDryRunResult>;
5313
5602
  };
5314
5603
  /** Create the TanStack `listWorkflows` server tool. */
5315
5604
  export declare const listWorkflows: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5509,7 +5798,7 @@ export declare const triggerWorkflow: (token: GithubTokenInput, options?: Tansta
5509
5798
  triggered: boolean;
5510
5799
  workflowId: string | number;
5511
5800
  ref: string;
5512
- }>;
5801
+ } | GithubDryRunResult>;
5513
5802
  };
5514
5803
  /** Create the TanStack `cancelWorkflowRun` server tool. */
5515
5804
  export declare const cancelWorkflowRun: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5524,7 +5813,7 @@ export declare const cancelWorkflowRun: (token: GithubTokenInput, options?: Tans
5524
5813
  }) => Promise<{
5525
5814
  cancelled: boolean;
5526
5815
  runId: number;
5527
- }>;
5816
+ } | GithubDryRunResult>;
5528
5817
  };
5529
5818
  /** Create the TanStack `rerunWorkflowRun` server tool. */
5530
5819
  export declare const rerunWorkflowRun: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5542,7 +5831,7 @@ export declare const rerunWorkflowRun: (token: GithubTokenInput, options?: Tanst
5542
5831
  rerun: boolean;
5543
5832
  runId: number;
5544
5833
  onlyFailedJobs: boolean;
5545
- }>;
5834
+ } | GithubDryRunResult>;
5546
5835
  };
5547
5836
  /** Create the TanStack `listCheckRuns` server tool. */
5548
5837
  export declare const listCheckRuns: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5598,6 +5887,38 @@ export declare const getCombinedStatus: (token: GithubTokenInput, options?: Tans
5598
5887
  }[];
5599
5888
  }>;
5600
5889
  };
5890
+ /** Create the TanStack `createCommitStatus` server tool. */
5891
+ export declare const createCommitStatus: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
5892
+ owner: import("zod").ZodString;
5893
+ repo: import("zod").ZodString;
5894
+ sha: import("zod").ZodString;
5895
+ state: import("zod").ZodEnum<{
5896
+ error: "error";
5897
+ success: "success";
5898
+ failure: "failure";
5899
+ pending: "pending";
5900
+ }>;
5901
+ context: import("zod").ZodString;
5902
+ description: import("zod").ZodOptional<import("zod").ZodString>;
5903
+ targetUrl: import("zod").ZodOptional<import("zod").ZodString>;
5904
+ }, import("zod/v4/core").$strip>, undefined, "createCommitStatus", unknown, boolean, undefined>, "execute"> & {
5905
+ execute: (input: {
5906
+ owner: string;
5907
+ repo: string;
5908
+ sha: string;
5909
+ state: "error" | "success" | "failure" | "pending";
5910
+ context: string;
5911
+ description?: string | undefined;
5912
+ targetUrl?: string | undefined;
5913
+ }) => Promise<{
5914
+ id: number;
5915
+ context: string;
5916
+ state: string;
5917
+ description: string | null;
5918
+ url: string | null;
5919
+ createdAt: string;
5920
+ } | GithubDryRunResult>;
5921
+ };
5601
5922
  /** Create the TanStack `getCiFailureContext` server tool. */
5602
5923
  export declare const getCiFailureContext: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
5603
5924
  owner: import("zod").ZodString;
@@ -5740,18 +6061,20 @@ export declare const listReleases: (token: GithubTokenInput, options?: TanstackT
5740
6061
  page?: number | undefined;
5741
6062
  maxPages?: number | undefined;
5742
6063
  detail?: "summary" | "full" | undefined;
5743
- }) => Promise<PagedList<{
5744
- id: number;
5745
- tagName: string;
5746
- name: string | null;
5747
- body: string | null | undefined;
5748
- draft: boolean;
5749
- prerelease: boolean;
5750
- url: string;
5751
- author: string;
5752
- createdAt: string;
5753
- publishedAt: string | null;
5754
- }>>;
6064
+ }) => Promise<{
6065
+ items: {
6066
+ id: number;
6067
+ tagName: string;
6068
+ name: string | null;
6069
+ body: string | null | undefined;
6070
+ draft: boolean;
6071
+ prerelease: boolean;
6072
+ url: string;
6073
+ author: string;
6074
+ createdAt: string;
6075
+ publishedAt: string | null;
6076
+ }[];
6077
+ } & PagingFields>;
5755
6078
  };
5756
6079
  /** Create the TanStack `getLatestRelease` server tool. */
5757
6080
  export declare const getLatestRelease: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5941,7 +6264,7 @@ export declare const createRelease: (token: GithubTokenInput, options?: Tanstack
5941
6264
  draft: boolean;
5942
6265
  prerelease: boolean;
5943
6266
  createdAt: string;
5944
- }>;
6267
+ } | GithubDryRunResult>;
5945
6268
  };
5946
6269
  /** Create the TanStack `updateRelease` server tool. */
5947
6270
  export declare const updateRelease: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5974,7 +6297,7 @@ export declare const updateRelease: (token: GithubTokenInput, options?: Tanstack
5974
6297
  draft: boolean;
5975
6298
  prerelease: boolean;
5976
6299
  publishedAt: string | null;
5977
- }>;
6300
+ } | GithubDryRunResult>;
5978
6301
  };
5979
6302
  /** Create the TanStack `deleteRelease` server tool. */
5980
6303
  export declare const deleteRelease: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5989,7 +6312,7 @@ export declare const deleteRelease: (token: GithubTokenInput, options?: Tanstack
5989
6312
  }) => Promise<{
5990
6313
  deleted: boolean;
5991
6314
  releaseId: number;
5992
- }>;
6315
+ } | GithubDryRunResult>;
5993
6316
  };
5994
6317
  /** Create the TanStack `listCodeScanningAlerts` server tool. */
5995
6318
  export declare const listCodeScanningAlerts: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -6023,21 +6346,23 @@ export declare const listCodeScanningAlerts: (token: GithubTokenInput, options?:
6023
6346
  perPage?: number | undefined;
6024
6347
  page?: number | undefined;
6025
6348
  maxPages?: number | undefined;
6026
- }) => Promise<PagedList<{
6027
- number: number;
6028
- state: "open" | "dismissed" | "fixed" | null;
6029
- severity: "error" | "critical" | "high" | "medium" | "low" | "warning" | "note" | "none" | null | undefined;
6030
- rule: {
6031
- id: string | null | undefined;
6032
- description: string | undefined;
6033
- };
6034
- tool: string | undefined;
6035
- path: string | undefined;
6036
- line: number | undefined;
6037
- url: string;
6038
- createdAt: string;
6039
- dismissedReason: "false positive" | "won't fix" | "used in tests" | null;
6040
- }>>;
6349
+ }) => Promise<{
6350
+ items: {
6351
+ number: number;
6352
+ state: "open" | "dismissed" | "fixed" | null;
6353
+ severity: "error" | "critical" | "high" | "medium" | "low" | "warning" | "note" | "none" | null | undefined;
6354
+ rule: {
6355
+ id: string | null | undefined;
6356
+ description: string | undefined;
6357
+ };
6358
+ tool: string | undefined;
6359
+ path: string | undefined;
6360
+ line: number | undefined;
6361
+ url: string;
6362
+ createdAt: string;
6363
+ dismissedReason: "false positive" | "won't fix" | "used in tests" | null;
6364
+ }[];
6365
+ } & PagingFields>;
6041
6366
  };
6042
6367
  /** Create the TanStack `listDependabotAlerts` server tool. */
6043
6368
  export declare const listDependabotAlerts: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -6112,18 +6437,19 @@ export declare const listSecretScanningAlerts: (token: GithubTokenInput, options
6112
6437
  perPage?: number | undefined;
6113
6438
  page?: number | undefined;
6114
6439
  maxPages?: number | undefined;
6115
- }) => Promise<PagedList<{
6116
- number: number | undefined;
6117
- state: "open" | "resolved" | undefined;
6118
- secretType: string | undefined;
6119
- secretTypeDisplayName: string | undefined;
6120
- validity: "unknown" | "active" | "inactive" | undefined;
6121
- pushProtectionBypassed: boolean | null | undefined;
6122
- resolution: "false_positive" | "wont_fix" | "revoked" | "used_in_tests" | null | undefined;
6123
- url: string | undefined;
6124
- createdAt: string | undefined;
6125
- }>>;
6440
+ }) => Promise<{
6441
+ items: {
6442
+ number: number | undefined;
6443
+ state: "open" | "resolved" | undefined;
6444
+ secretType: string | undefined;
6445
+ secretTypeDisplayName: string | undefined;
6446
+ validity: "unknown" | "active" | "inactive" | undefined;
6447
+ pushProtectionBypassed: boolean | null | undefined;
6448
+ resolution: "false_positive" | "wont_fix" | "revoked" | "used_in_tests" | null | undefined;
6449
+ url: string | undefined;
6450
+ createdAt: string | undefined;
6451
+ }[];
6452
+ } & PagingFields>;
6126
6453
  };
6127
- //#endregion
6128
6454
  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 };
6129
6455
  //# sourceMappingURL=tanstack.d.mts.map