@github-tools/sdk 1.20.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 (55) hide show
  1. package/README.md +45 -12
  2. package/dist/{approval-policy--kByBqhT.mjs → approval-policy-CEMMPq92.mjs} +2 -2
  3. package/dist/{approval-policy--kByBqhT.mjs.map → approval-policy-CEMMPq92.mjs.map} +1 -1
  4. package/dist/connect/eve.d.mts +1 -1
  5. package/dist/connect/eve.mjs +1 -1
  6. package/dist/connect.d.mts +5 -5
  7. package/dist/connect.d.mts.map +1 -1
  8. package/dist/connect.mjs +2 -2
  9. package/dist/{cores-FLzAv2tu.mjs → cores-meFAMt2D.mjs} +20 -2
  10. package/dist/cores-meFAMt2D.mjs.map +1 -0
  11. package/dist/{tool-types-OFyE3z0C.d.mts → dry-run-DXckOam2.d.mts} +172 -18
  12. package/dist/dry-run-DXckOam2.d.mts.map +1 -0
  13. package/dist/{evaluation-BtoHbxuQ.mjs → evaluation-DJHINyAu.mjs} +2 -2
  14. package/dist/{evaluation-BtoHbxuQ.mjs.map → evaluation-DJHINyAu.mjs.map} +1 -1
  15. package/dist/{eve-runtime-CflZNuXD.d.mts → eve-runtime-B_CJE9JV.d.mts} +20 -6
  16. package/dist/eve-runtime-B_CJE9JV.d.mts.map +1 -0
  17. package/dist/{eve-runtime-C-0doyHq.mjs → eve-runtime-DPzMPCLt.mjs} +40 -12
  18. package/dist/eve-runtime-DPzMPCLt.mjs.map +1 -0
  19. package/dist/eve-runtime.d.mts +5 -5
  20. package/dist/eve-runtime.mjs +4 -4
  21. package/dist/eve.d.mts +45 -3
  22. package/dist/eve.d.mts.map +1 -1
  23. package/dist/eve.mjs +45 -3
  24. package/dist/eve.mjs.map +1 -1
  25. package/dist/{index-C3wlz660.d.mts → index-CzzrtCVj.d.mts} +32 -5
  26. package/dist/index-CzzrtCVj.d.mts.map +1 -0
  27. package/dist/index.d.mts +3 -3
  28. package/dist/index.mjs +4 -4
  29. package/dist/{src-DyiAVHKl.mjs → src-BlhrSieS.mjs} +166 -21
  30. package/dist/src-BlhrSieS.mjs.map +1 -0
  31. package/dist/tanstack.d.mts +533 -190
  32. package/dist/tanstack.d.mts.map +1 -1
  33. package/dist/tanstack.mjs +32 -11
  34. package/dist/tanstack.mjs.map +1 -1
  35. package/dist/{token-DIwB-wtp.mjs → token-BLps09gm.mjs} +3 -2
  36. package/dist/token-BLps09gm.mjs.map +1 -0
  37. package/dist/{types-CJqhvQwi.d.mts → types-Bln8U42J.d.mts} +3 -3
  38. package/dist/{types-CJqhvQwi.d.mts.map → types-Bln8U42J.d.mts.map} +1 -1
  39. package/dist/{types-ITYfXMtY.d.mts → types-C7O2lwwz.d.mts} +14 -2
  40. package/dist/{types-ITYfXMtY.d.mts.map → types-C7O2lwwz.d.mts.map} +1 -1
  41. package/dist/workflow.d.mts +9 -2
  42. package/dist/workflow.d.mts.map +1 -1
  43. package/dist/workflow.mjs +6 -4
  44. package/dist/workflow.mjs.map +1 -1
  45. package/dist/{write-tools-DnGZw-RD.mjs → write-tools-w-8tjnDQ.mjs} +440 -33
  46. package/dist/write-tools-w-8tjnDQ.mjs.map +1 -0
  47. package/package.json +1 -1
  48. package/dist/cores-FLzAv2tu.mjs.map +0 -1
  49. package/dist/eve-runtime-C-0doyHq.mjs.map +0 -1
  50. package/dist/eve-runtime-CflZNuXD.d.mts.map +0 -1
  51. package/dist/index-C3wlz660.d.mts.map +0 -1
  52. package/dist/src-DyiAVHKl.mjs.map +0 -1
  53. package/dist/token-DIwB-wtp.mjs.map +0 -1
  54. package/dist/tool-types-OFyE3z0C.d.mts.map +0 -1
  55. package/dist/write-tools-DnGZw-RD.mjs.map +0 -1
@@ -1,5 +1,5 @@
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";
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
3
  import { t as githubToolApproval } from "./interrupts-BSDPwdJ2.mjs";
4
4
  import { z } from "zod";
5
5
  import { AnyTextAdapter, ChatMiddleware, ChatStream, EvaluateAdapter, ModelMessage, ServerTool, Tool, chat } from "@tanstack/ai";
@@ -380,7 +380,7 @@ declare function getCiFailureContextCore({ token, owner, repo, ref, runId, maxFa
380
380
  }[];
381
381
  }>;
382
382
  declare namespace checks_d_exports {
383
- export { getCombinedStatusCore, getCombinedStatusDescription, getCombinedStatusInputSchema, listCheckRunsCore, listCheckRunsDescription, listCheckRunsInputSchema };
383
+ export { createCommitStatusCore, createCommitStatusDescription, createCommitStatusInputSchema, getCombinedStatusCore, getCombinedStatusDescription, getCombinedStatusInputSchema, listCheckRunsCore, listCheckRunsDescription, listCheckRunsInputSchema };
384
384
  }
385
385
  declare const listCheckRunsInputSchema: z.ZodObject<{
386
386
  owner: z.ZodString;
@@ -436,6 +436,39 @@ declare function getCombinedStatusCore({ token, owner, repo, ref }: {
436
436
  url: string | null;
437
437
  }[];
438
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
+ }>;
439
472
  //#endregion
440
473
  //#region src/core/pagination.d.ts
441
474
  type PagingFields = {
@@ -861,7 +894,7 @@ declare function createGistCommentCore({ token, gistId, body }: {
861
894
  createdAt: string;
862
895
  }>;
863
896
  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 };
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 };
865
898
  }
866
899
  declare const listIssuesInputSchema: z.ZodObject<{
867
900
  owner: z.ZodString;
@@ -961,10 +994,11 @@ declare const createIssueInputSchema: z.ZodObject<{
961
994
  body: z.ZodOptional<z.ZodString>;
962
995
  labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
963
996
  assignees: z.ZodOptional<z.ZodArray<z.ZodString>>;
997
+ milestone: z.ZodOptional<z.ZodNumber>;
964
998
  }, z.core.$strip>;
965
999
  declare const createIssueDescription = "Create a new issue in a GitHub repository";
966
1000
  /** Not idempotent — each call creates a new issue. */
967
- declare function createIssueCore({ token, owner, repo, title, body, labels, assignees }: {
1001
+ declare function createIssueCore({ token, owner, repo, title, body, labels, assignees, milestone }: {
968
1002
  token: string;
969
1003
  owner: string;
970
1004
  repo: string;
@@ -972,6 +1006,7 @@ declare function createIssueCore({ token, owner, repo, title, body, labels, assi
972
1006
  body?: string;
973
1007
  labels?: string[];
974
1008
  assignees?: string[];
1009
+ milestone?: number;
975
1010
  }): Promise<{
976
1011
  number: number;
977
1012
  title: string;
@@ -1256,6 +1291,84 @@ declare function removeAssigneesCore({ token, owner, repo, issueNumber, assignee
1256
1291
  number: number;
1257
1292
  assignees: string[] | undefined;
1258
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
+ }>;
1259
1372
  declare namespace notifications_d_exports {
1260
1373
  export { listNotificationsCore, listNotificationsDescription, listNotificationsInputSchema, markNotificationReadCore, markNotificationReadDescription, markNotificationReadInputSchema };
1261
1374
  }
@@ -1297,7 +1410,7 @@ declare function markNotificationReadCore({ token, threadId }: {
1297
1410
  threadId: string;
1298
1411
  }>;
1299
1412
  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 };
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 };
1301
1414
  }
1302
1415
  declare const listPullRequestsInputSchema: z.ZodObject<{
1303
1416
  owner: z.ZodString;
@@ -1450,7 +1563,7 @@ declare const mergePullRequestInputSchema: z.ZodObject<{
1450
1563
  }, z.core.$strip>;
1451
1564
  declare const mergePullRequestDescription = "Merge a pull request";
1452
1565
  /** Not idempotent — merging an already-merged PR returns an error from GitHub. */
1453
- declare function mergePullRequestCore({ token, owner, repo, pullNumber, commitTitle, commitMessage, mergeMethod, coAuthors }: {
1566
+ declare function mergePullRequestCore({ token, owner, repo, pullNumber, commitTitle, commitMessage, mergeMethod, coAuthors, branches }: {
1454
1567
  token: string;
1455
1568
  owner: string;
1456
1569
  repo: string;
@@ -1459,6 +1572,8 @@ declare function mergePullRequestCore({ token, owner, repo, pullNumber, commitTi
1459
1572
  commitMessage?: string;
1460
1573
  mergeMethod: 'merge' | 'squash' | 'rebase';
1461
1574
  coAuthors?: CommitIdentity[];
1575
+ /** `guardrails.branches`: the pull request's base branch must match. */
1576
+ branches?: string[];
1462
1577
  }): Promise<{
1463
1578
  merged: boolean;
1464
1579
  message: string;
@@ -1751,7 +1866,7 @@ declare const enablePullRequestAutoMergeInputSchema: z.ZodObject<{
1751
1866
  }, z.core.$strip>;
1752
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";
1753
1868
  /** 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 }: {
1869
+ declare function enablePullRequestAutoMergeCore({ token, owner, repo, pullNumber, mergeMethod, commitTitle, commitMessage, coAuthors, branches }: {
1755
1870
  token: string;
1756
1871
  owner: string;
1757
1872
  repo: string;
@@ -1760,6 +1875,8 @@ declare function enablePullRequestAutoMergeCore({ token, owner, repo, pullNumber
1760
1875
  commitTitle?: string;
1761
1876
  commitMessage?: string;
1762
1877
  coAuthors?: CommitIdentity[];
1878
+ /** `guardrails.branches`: the pull request's base branch must match. */
1879
+ branches?: string[];
1763
1880
  }): Promise<{
1764
1881
  number: number;
1765
1882
  url: string;
@@ -1785,6 +1902,26 @@ declare function disablePullRequestAutoMergeCore({ token, owner, repo, pullNumbe
1785
1902
  url: string;
1786
1903
  autoMerge: null;
1787
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
+ }>;
1788
1925
  declare namespace reactions_d_exports {
1789
1926
  export { ReactionContent, addCommentReactionCore, addCommentReactionDescription, addCommentReactionInputSchema, addIssueReactionCore, addIssueReactionDescription, addIssueReactionInputSchema, listCommentReactionsCore, listCommentReactionsDescription, listCommentReactionsInputSchema, listIssueReactionsCore, listIssueReactionsDescription, listIssueReactionsInputSchema };
1790
1927
  }
@@ -2246,7 +2383,7 @@ declare function listSecretScanningAlertsCore({ token, owner, repo, state, secre
2246
2383
  createdAt: string | undefined;
2247
2384
  }>>;
2248
2385
  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 };
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 };
2250
2387
  }
2251
2388
  declare function createCommitOnBranch(octokit: Octokit, input: {
2252
2389
  owner: string;
@@ -2692,6 +2829,22 @@ declare function getBranchRulesCore({ token, owner, repo, branch }: {
2692
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";
2693
2830
  }[];
2694
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
+ }>;
2695
2848
  declare namespace search_d_exports {
2696
2849
  export { searchCodeCore, searchCodeDescription, searchCodeInputSchema, searchIssuesCore, searchIssuesDescription, searchIssuesInputSchema, searchRepositoriesCore, searchRepositoriesDescription, searchRepositoriesInputSchema };
2697
2850
  }
@@ -3062,6 +3215,7 @@ declare const GITHUB_TOOL_CORES: {
3062
3215
  readonly createOrUpdateFile: typeof createOrUpdateFileCore;
3063
3216
  readonly editFiles: typeof editFilesCore;
3064
3217
  readonly getBranchRules: typeof getBranchRulesCore;
3218
+ readonly getCollaboratorPermission: typeof getCollaboratorPermissionCore;
3065
3219
  readonly listPullRequests: typeof listPullRequestsCore;
3066
3220
  readonly getPullRequest: typeof getPullRequestCore;
3067
3221
  readonly createPullRequest: typeof createPullRequestCore;
@@ -3069,6 +3223,7 @@ declare const GITHUB_TOOL_CORES: {
3069
3223
  readonly enablePullRequestAutoMerge: typeof enablePullRequestAutoMergeCore;
3070
3224
  readonly disablePullRequestAutoMerge: typeof disablePullRequestAutoMergeCore;
3071
3225
  readonly updatePullRequest: typeof updatePullRequestCore;
3226
+ readonly updatePullRequestBranch: typeof updatePullRequestBranchCore;
3072
3227
  readonly addPullRequestComment: typeof addPullRequestCommentCore;
3073
3228
  readonly updatePullRequestComment: typeof updatePullRequestCommentCore;
3074
3229
  readonly deletePullRequestComment: typeof deletePullRequestCommentCore;
@@ -3098,6 +3253,9 @@ declare const GITHUB_TOOL_CORES: {
3098
3253
  readonly deleteLabel: typeof deleteLabelCore;
3099
3254
  readonly addAssignees: typeof addAssigneesCore;
3100
3255
  readonly removeAssignees: typeof removeAssigneesCore;
3256
+ readonly listMilestones: typeof listMilestonesCore;
3257
+ readonly listSubIssues: typeof listSubIssuesCore;
3258
+ readonly addSubIssue: typeof addSubIssueCore;
3101
3259
  readonly listIssueReactions: typeof listIssueReactionsCore;
3102
3260
  readonly addIssueReaction: typeof addIssueReactionCore;
3103
3261
  readonly listCommentReactions: typeof listCommentReactionsCore;
@@ -3131,6 +3289,7 @@ declare const GITHUB_TOOL_CORES: {
3131
3289
  readonly rerunWorkflowRun: typeof rerunWorkflowRunCore;
3132
3290
  readonly listCheckRuns: typeof listCheckRunsCore;
3133
3291
  readonly getCombinedStatus: typeof getCombinedStatusCore;
3292
+ readonly createCommitStatus: typeof createCommitStatusCore;
3134
3293
  readonly getCiFailureContext: typeof getCiFailureContextCore;
3135
3294
  readonly listReleases: typeof listReleasesCore;
3136
3295
  readonly getLatestRelease: typeof getLatestReleaseCore;
@@ -3146,9 +3305,13 @@ declare const GITHUB_TOOL_CORES: {
3146
3305
  //#endregion
3147
3306
  //#region src/tanstack/tools.d.ts
3148
3307
  type Catalog = typeof GITHUB_TOOL_CATALOG;
3149
- /** 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
+ */
3150
3313
  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]>;
3314
+ execute: (input: z.input<Catalog[N]['inputSchema']>) => Promise<N extends GithubWriteToolName ? CoreResult<N> | GithubDryRunResult : CoreResult<N>>;
3152
3315
  } : never;
3153
3316
  /** Supported TanStack tool customizations. */
3154
3317
  type TanstackToolOverrides = {
@@ -3162,6 +3325,10 @@ type TanstackToolOptions = Omit<TanstackToolOverrides, 'needsApproval'> & {
3162
3325
  author?: CommitIdentity;
3163
3326
  committer?: CommitIdentity;
3164
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;
3165
3332
  };
3166
3333
  /** Configuration for a native array of GitHub server tools. */
3167
3334
  type CreateGithubToolsOptions = Omit<TanstackToolOptions, 'description' | 'needsApproval'> & {
@@ -3223,7 +3390,7 @@ type GithubAgent<A extends AnyTextAdapter> = {
3223
3390
  stream: (options: GithubAgentCallOptions<A>) => ChatStream;
3224
3391
  };
3225
3392
  /** 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>;
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>;
3227
3394
  //#endregion
3228
3395
  //#region src/tanstack/approval.d.ts
3229
3396
  /** Options for GitHub approval middleware. Register githubToolApproval with chat(). */
@@ -3270,11 +3437,13 @@ export declare const listBranches: (token: GithubTokenInput, options?: TanstackT
3270
3437
  repo: string;
3271
3438
  perPage?: number | undefined;
3272
3439
  page?: number | undefined;
3273
- }) => Promise<PagedList<{
3274
- name: string;
3275
- sha: string;
3276
- protected: boolean;
3277
- }>>;
3440
+ }) => Promise<{
3441
+ items: {
3442
+ name: string;
3443
+ sha: string;
3444
+ protected: boolean;
3445
+ }[];
3446
+ } & PagingFields>;
3278
3447
  };
3279
3448
  /** Create the TanStack `getFileContent` server tool. */
3280
3449
  export declare const getFileContent: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3386,7 +3555,7 @@ export declare const createBranch: (token: GithubTokenInput, options?: TanstackT
3386
3555
  ref: string;
3387
3556
  sha: string;
3388
3557
  url: string;
3389
- }>;
3558
+ } | GithubDryRunResult>;
3390
3559
  };
3391
3560
  /** Create the TanStack `deleteBranch` server tool. */
3392
3561
  export declare const deleteBranch: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3401,7 +3570,7 @@ export declare const deleteBranch: (token: GithubTokenInput, options?: TanstackT
3401
3570
  }) => Promise<{
3402
3571
  deleted: boolean;
3403
3572
  branch: string;
3404
- }>;
3573
+ } | GithubDryRunResult>;
3405
3574
  };
3406
3575
  /** Create the TanStack `forkRepository` server tool. */
3407
3576
  export declare const forkRepository: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3427,7 +3596,7 @@ export declare const forkRepository: (token: GithubTokenInput, options?: Tanstac
3427
3596
  fullName: string;
3428
3597
  url: string;
3429
3598
  } | null;
3430
- }>;
3599
+ } | GithubDryRunResult>;
3431
3600
  };
3432
3601
  /** Create the TanStack `createRepository` server tool. */
3433
3602
  export declare const createRepository: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3457,7 +3626,7 @@ export declare const createRepository: (token: GithubTokenInput, options?: Tanst
3457
3626
  defaultBranch: string;
3458
3627
  private: boolean;
3459
3628
  createdAt: string;
3460
- }>;
3629
+ } | GithubDryRunResult>;
3461
3630
  };
3462
3631
  /** Create the TanStack `createOrUpdateFile` server tool. */
3463
3632
  export declare const createOrUpdateFile: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3491,7 +3660,7 @@ export declare const createOrUpdateFile: (token: GithubTokenInput, options?: Tan
3491
3660
  commitUrl: string | undefined;
3492
3661
  skipped?: undefined;
3493
3662
  message?: undefined;
3494
- }>;
3663
+ } | GithubDryRunResult>;
3495
3664
  };
3496
3665
  /** Create the TanStack `editFiles` server tool. */
3497
3666
  export declare const editFiles: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3548,7 +3717,7 @@ export declare const editFiles: (token: GithubTokenInput, options?: TanstackTool
3548
3717
  sha?: string;
3549
3718
  url?: string;
3550
3719
  }[];
3551
- }>;
3720
+ } | GithubDryRunResult>;
3552
3721
  };
3553
3722
  /** Create the TanStack `listPullRequests` server tool. */
3554
3723
  export declare const listPullRequests: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3570,18 +3739,20 @@ export declare const listPullRequests: (token: GithubTokenInput, options?: Tanst
3570
3739
  perPage?: number | undefined;
3571
3740
  page?: number | undefined;
3572
3741
  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
- }>>;
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>;
3585
3756
  };
3586
3757
  /** Create the TanStack `getPullRequest` server tool. */
3587
3758
  export declare const getPullRequest: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3650,7 +3821,7 @@ export declare const createPullRequest: (token: GithubTokenInput, options?: Tans
3650
3821
  draft: boolean | undefined;
3651
3822
  branch: string;
3652
3823
  base: string;
3653
- }>;
3824
+ } | GithubDryRunResult>;
3654
3825
  };
3655
3826
  /** Create the TanStack `mergePullRequest` server tool. */
3656
3827
  export declare const mergePullRequest: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3676,7 +3847,7 @@ export declare const mergePullRequest: (token: GithubTokenInput, options?: Tanst
3676
3847
  merged: boolean;
3677
3848
  message: string;
3678
3849
  sha: string;
3679
- }>;
3850
+ } | GithubDryRunResult>;
3680
3851
  };
3681
3852
  /** Create the TanStack `enablePullRequestAutoMerge` server tool. */
3682
3853
  export declare const enablePullRequestAutoMerge: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3705,7 +3876,7 @@ export declare const enablePullRequestAutoMerge: (token: GithubTokenInput, optio
3705
3876
  enabledAt: string;
3706
3877
  mergeMethod: string;
3707
3878
  } | null;
3708
- }>;
3879
+ } | GithubDryRunResult>;
3709
3880
  };
3710
3881
  /** Create the TanStack `disablePullRequestAutoMerge` server tool. */
3711
3882
  export declare const disablePullRequestAutoMerge: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3721,7 +3892,7 @@ export declare const disablePullRequestAutoMerge: (token: GithubTokenInput, opti
3721
3892
  number: number;
3722
3893
  url: string;
3723
3894
  autoMerge: null;
3724
- }>;
3895
+ } | GithubDryRunResult>;
3725
3896
  };
3726
3897
  /** Create the TanStack `getBranchRules` server tool. */
3727
3898
  export declare const getBranchRules: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3821,6 +3992,22 @@ export declare const getBranchRules: (token: GithubTokenInput, options?: Tanstac
3821
3992
  }[];
3822
3993
  }>;
3823
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;
4009
+ }>;
4010
+ };
3824
4011
  /** Create the TanStack `updatePullRequest` server tool. */
3825
4012
  export declare const updatePullRequest: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
3826
4013
  owner: import("zod").ZodString;
@@ -3852,7 +4039,24 @@ export declare const updatePullRequest: (token: GithubTokenInput, options?: Tans
3852
4039
  url: string;
3853
4040
  base: string;
3854
4041
  updatedAt: string;
3855
- }>;
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>;
3856
4060
  };
3857
4061
  /** Create the TanStack `addPullRequestComment` server tool. */
3858
4062
  export declare const addPullRequestComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3872,7 +4076,7 @@ export declare const addPullRequestComment: (token: GithubTokenInput, options?:
3872
4076
  body: string | undefined;
3873
4077
  author: string | undefined;
3874
4078
  createdAt: string;
3875
- }>;
4079
+ } | GithubDryRunResult>;
3876
4080
  };
3877
4081
  /** Create the TanStack `updatePullRequestComment` server tool. */
3878
4082
  export declare const updatePullRequestComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3891,7 +4095,7 @@ export declare const updatePullRequestComment: (token: GithubTokenInput, options
3891
4095
  url: string;
3892
4096
  body: string | undefined;
3893
4097
  updatedAt: string;
3894
- }>;
4098
+ } | GithubDryRunResult>;
3895
4099
  };
3896
4100
  /** Create the TanStack `deletePullRequestComment` server tool. */
3897
4101
  export declare const deletePullRequestComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3906,7 +4110,7 @@ export declare const deletePullRequestComment: (token: GithubTokenInput, options
3906
4110
  }) => Promise<{
3907
4111
  deleted: boolean;
3908
4112
  commentId: number;
3909
- }>;
4113
+ } | GithubDryRunResult>;
3910
4114
  };
3911
4115
  /** Create the TanStack `listPullRequestFiles` server tool. */
3912
4116
  export declare const listPullRequestFiles: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3926,14 +4130,16 @@ export declare const listPullRequestFiles: (token: GithubTokenInput, options?: T
3926
4130
  filenames?: string[] | undefined;
3927
4131
  perPage?: number | undefined;
3928
4132
  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
- }>>;
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>;
3937
4143
  };
3938
4144
  /** Create the TanStack `listPullRequestReviews` server tool. */
3939
4145
  export declare const listPullRequestReviews: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -3949,14 +4155,16 @@ export declare const listPullRequestReviews: (token: GithubTokenInput, options?:
3949
4155
  pullNumber: number;
3950
4156
  perPage?: number | undefined;
3951
4157
  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
- }>>;
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>;
3960
4168
  };
3961
4169
  /** Create the TanStack `createPullRequestReview` server tool. */
3962
4170
  export declare const createPullRequestReview: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4005,7 +4213,7 @@ export declare const createPullRequestReview: (token: GithubTokenInput, options?
4005
4213
  url: string;
4006
4214
  author: string | undefined;
4007
4215
  submittedAt: string | undefined;
4008
- }>;
4216
+ } | GithubDryRunResult>;
4009
4217
  };
4010
4218
  /** Create the TanStack `listPullRequestReviewThreads` server tool. */
4011
4219
  export declare const listPullRequestReviewThreads: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4081,7 +4289,7 @@ export declare const replyToReviewComment: (token: GithubTokenInput, options?: T
4081
4289
  url: string;
4082
4290
  author: string;
4083
4291
  createdAt: string;
4084
- }>;
4292
+ } | GithubDryRunResult>;
4085
4293
  };
4086
4294
  /** Create the TanStack `resolveReviewThread` server tool. */
4087
4295
  export declare const resolveReviewThread: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4097,7 +4305,7 @@ export declare const resolveReviewThread: (token: GithubTokenInput, options?: Ta
4097
4305
  threadId: string;
4098
4306
  isResolved: boolean;
4099
4307
  error?: undefined;
4100
- }>;
4308
+ } | GithubDryRunResult>;
4101
4309
  };
4102
4310
  /** Create the TanStack `requestReviewers` server tool. */
4103
4311
  export declare const requestReviewers: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4118,7 +4326,7 @@ export declare const requestReviewers: (token: GithubTokenInput, options?: Tanst
4118
4326
  url: string;
4119
4327
  requestedReviewers: string[] | undefined;
4120
4328
  requestedTeams: string[] | undefined;
4121
- }>;
4329
+ } | GithubDryRunResult>;
4122
4330
  };
4123
4331
  /** Create the TanStack `getPullRequestContext` server tool. */
4124
4332
  export declare const getPullRequestContext: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4298,16 +4506,18 @@ export declare const listIssues: (token: GithubTokenInput, options?: TanstackToo
4298
4506
  perPage?: number | undefined;
4299
4507
  page?: number | undefined;
4300
4508
  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
- }>>;
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>;
4311
4521
  };
4312
4522
  /** Create the TanStack `getIssue` server tool. */
4313
4523
  export declare const getIssue: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4358,14 +4568,16 @@ export declare const listIssueComments: (token: GithubTokenInput, options?: Tans
4358
4568
  perPage?: number | undefined;
4359
4569
  page?: number | undefined;
4360
4570
  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
- }>>;
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>;
4369
4581
  };
4370
4582
  /** Create the TanStack `createIssue` server tool. */
4371
4583
  export declare const createIssue: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4375,6 +4587,7 @@ export declare const createIssue: (token: GithubTokenInput, options?: TanstackTo
4375
4587
  body: import("zod").ZodOptional<import("zod").ZodString>;
4376
4588
  labels: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
4377
4589
  assignees: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
4590
+ milestone: import("zod").ZodOptional<import("zod").ZodNumber>;
4378
4591
  }, import("zod/v4/core").$strip>, undefined, "createIssue", unknown, boolean, undefined>, "execute"> & {
4379
4592
  execute: (input: {
4380
4593
  owner: string;
@@ -4383,13 +4596,14 @@ export declare const createIssue: (token: GithubTokenInput, options?: TanstackTo
4383
4596
  body?: string | undefined;
4384
4597
  labels?: string[] | undefined;
4385
4598
  assignees?: string[] | undefined;
4599
+ milestone?: number | undefined;
4386
4600
  }) => Promise<{
4387
4601
  number: number;
4388
4602
  title: string;
4389
4603
  url: string;
4390
4604
  state: string;
4391
4605
  labels: (string | undefined)[];
4392
- }>;
4606
+ } | GithubDryRunResult>;
4393
4607
  };
4394
4608
  /** Create the TanStack `addIssueComment` server tool. */
4395
4609
  export declare const addIssueComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4409,7 +4623,7 @@ export declare const addIssueComment: (token: GithubTokenInput, options?: Tansta
4409
4623
  body: string | undefined;
4410
4624
  author: string | undefined;
4411
4625
  createdAt: string;
4412
- }>;
4626
+ } | GithubDryRunResult>;
4413
4627
  };
4414
4628
  /** Create the TanStack `updateIssueComment` server tool. */
4415
4629
  export declare const updateIssueComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4428,7 +4642,7 @@ export declare const updateIssueComment: (token: GithubTokenInput, options?: Tan
4428
4642
  url: string;
4429
4643
  body: string | undefined;
4430
4644
  updatedAt: string;
4431
- }>;
4645
+ } | GithubDryRunResult>;
4432
4646
  };
4433
4647
  /** Create the TanStack `deleteIssueComment` server tool. */
4434
4648
  export declare const deleteIssueComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4443,7 +4657,7 @@ export declare const deleteIssueComment: (token: GithubTokenInput, options?: Tan
4443
4657
  }) => Promise<{
4444
4658
  deleted: boolean;
4445
4659
  commentId: number;
4446
- }>;
4660
+ } | GithubDryRunResult>;
4447
4661
  };
4448
4662
  /** Create the TanStack `closeIssue` server tool. */
4449
4663
  export declare const closeIssue: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4466,7 +4680,7 @@ export declare const closeIssue: (token: GithubTokenInput, options?: TanstackToo
4466
4680
  state: string;
4467
4681
  url: string;
4468
4682
  closedAt: string | null;
4469
- }>;
4683
+ } | GithubDryRunResult>;
4470
4684
  };
4471
4685
  /** Create the TanStack `updateIssue` server tool. */
4472
4686
  export declare const updateIssue: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4509,7 +4723,7 @@ export declare const updateIssue: (token: GithubTokenInput, options?: TanstackTo
4509
4723
  milestone: number | null;
4510
4724
  closedAt: string | null;
4511
4725
  updatedAt: string;
4512
- }>;
4726
+ } | GithubDryRunResult>;
4513
4727
  };
4514
4728
  /** Create the TanStack `listLabels` server tool. */
4515
4729
  export declare const listLabels: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4523,11 +4737,13 @@ export declare const listLabels: (token: GithubTokenInput, options?: TanstackToo
4523
4737
  repo: string;
4524
4738
  perPage?: number | undefined;
4525
4739
  page?: number | undefined;
4526
- }) => Promise<PagedList<{
4527
- name: string;
4528
- color: string;
4529
- description: string | null;
4530
- }>>;
4740
+ }) => Promise<{
4741
+ items: {
4742
+ name: string;
4743
+ color: string;
4744
+ description: string | null;
4745
+ }[];
4746
+ } & PagingFields>;
4531
4747
  };
4532
4748
  /** Create the TanStack `addLabels` server tool. */
4533
4749
  export declare const addLabels: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4545,7 +4761,7 @@ export declare const addLabels: (token: GithubTokenInput, options?: TanstackTool
4545
4761
  name: string;
4546
4762
  color: string;
4547
4763
  description: string | null;
4548
- }[]>;
4764
+ }[] | GithubDryRunResult>;
4549
4765
  };
4550
4766
  /** Create the TanStack `removeLabel` server tool. */
4551
4767
  export declare const removeLabel: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4563,7 +4779,7 @@ export declare const removeLabel: (token: GithubTokenInput, options?: TanstackTo
4563
4779
  removed: boolean;
4564
4780
  label: string;
4565
4781
  issueNumber: number;
4566
- }>;
4782
+ } | GithubDryRunResult>;
4567
4783
  };
4568
4784
  /** Create the TanStack `createLabel` server tool. */
4569
4785
  export declare const createLabel: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4583,7 +4799,7 @@ export declare const createLabel: (token: GithubTokenInput, options?: TanstackTo
4583
4799
  name: string;
4584
4800
  color: string;
4585
4801
  description: string | null;
4586
- }>;
4802
+ } | GithubDryRunResult>;
4587
4803
  };
4588
4804
  /** Create the TanStack `updateLabel` server tool. */
4589
4805
  export declare const updateLabel: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4605,7 +4821,7 @@ export declare const updateLabel: (token: GithubTokenInput, options?: TanstackTo
4605
4821
  name: string;
4606
4822
  color: string;
4607
4823
  description: string | null;
4608
- }>;
4824
+ } | GithubDryRunResult>;
4609
4825
  };
4610
4826
  /** Create the TanStack `deleteLabel` server tool. */
4611
4827
  export declare const deleteLabel: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4620,7 +4836,7 @@ export declare const deleteLabel: (token: GithubTokenInput, options?: TanstackTo
4620
4836
  }) => Promise<{
4621
4837
  deleted: boolean;
4622
4838
  name: string;
4623
- }>;
4839
+ } | GithubDryRunResult>;
4624
4840
  };
4625
4841
  /** Create the TanStack `addAssignees` server tool. */
4626
4842
  export declare const addAssignees: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4637,7 +4853,7 @@ export declare const addAssignees: (token: GithubTokenInput, options?: TanstackT
4637
4853
  }) => Promise<{
4638
4854
  number: number;
4639
4855
  assignees: string[] | undefined;
4640
- }>;
4856
+ } | GithubDryRunResult>;
4641
4857
  };
4642
4858
  /** Create the TanStack `removeAssignees` server tool. */
4643
4859
  export declare const removeAssignees: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4654,7 +4870,88 @@ export declare const removeAssignees: (token: GithubTokenInput, options?: Tansta
4654
4870
  }) => Promise<{
4655
4871
  number: number;
4656
4872
  assignees: string[] | undefined;
4657
- }>;
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>;
4658
4955
  };
4659
4956
  /** Create the TanStack `listIssueReactions` server tool. */
4660
4957
  export declare const listIssueReactions: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4720,7 +5017,7 @@ export declare const addIssueReaction: (token: GithubTokenInput, options?: Tanst
4720
5017
  content: "+1" | "-1" | "laugh" | "confused" | "heart" | "hooray" | "rocket" | "eyes";
4721
5018
  user: string | undefined;
4722
5019
  issueNumber: number;
4723
- }>;
5020
+ } | GithubDryRunResult>;
4724
5021
  };
4725
5022
  /** Create the TanStack `listCommentReactions` server tool. */
4726
5023
  export declare const listCommentReactions: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4786,7 +5083,7 @@ export declare const addCommentReaction: (token: GithubTokenInput, options?: Tan
4786
5083
  content: "+1" | "-1" | "laugh" | "confused" | "heart" | "hooray" | "rocket" | "eyes";
4787
5084
  user: string | undefined;
4788
5085
  commentId: number;
4789
- }>;
5086
+ } | GithubDryRunResult>;
4790
5087
  };
4791
5088
  /** Create the TanStack `listDiscussions` server tool. */
4792
5089
  export declare const listDiscussions: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4893,7 +5190,7 @@ export declare const addDiscussionComment: (token: GithubTokenInput, options?: T
4893
5190
  author: string | null;
4894
5191
  createdAt: string;
4895
5192
  error?: undefined;
4896
- }>;
5193
+ } | GithubDryRunResult>;
4897
5194
  };
4898
5195
  /** Create the TanStack `listNotifications` server tool. */
4899
5196
  export declare const listNotifications: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4907,18 +5204,20 @@ export declare const listNotifications: (token: GithubTokenInput, options?: Tans
4907
5204
  participating?: boolean | undefined;
4908
5205
  perPage?: number | undefined;
4909
5206
  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
- }>>;
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>;
4922
5221
  };
4923
5222
  /** Create the TanStack `markNotificationRead` server tool. */
4924
5223
  export declare const markNotificationRead: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -4929,7 +5228,7 @@ export declare const markNotificationRead: (token: GithubTokenInput, options?: T
4929
5228
  }) => Promise<{
4930
5229
  marked: boolean;
4931
5230
  threadId: string;
4932
- }>;
5231
+ } | GithubDryRunResult>;
4933
5232
  };
4934
5233
  /** Create the TanStack `searchCode` server tool. */
4935
5234
  export declare const searchCode: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5049,14 +5348,16 @@ export declare const listCommits: (token: GithubTokenInput, options?: TanstackTo
5049
5348
  perPage?: number | undefined;
5050
5349
  page?: number | undefined;
5051
5350
  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
- }>>;
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>;
5060
5361
  };
5061
5362
  /** Create the TanStack `getCommit` server tool. */
5062
5363
  export declare const getCommit: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5184,17 +5485,19 @@ export declare const listGists: (token: GithubTokenInput, options?: TanstackTool
5184
5485
  username?: string | undefined;
5185
5486
  perPage?: number | undefined;
5186
5487
  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
- }>>;
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>;
5198
5501
  };
5199
5502
  /** Create the TanStack `getGist` server tool. */
5200
5503
  export declare const getGist: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5229,14 +5532,16 @@ export declare const listGistComments: (token: GithubTokenInput, options?: Tanst
5229
5532
  gistId: string;
5230
5533
  perPage?: number | undefined;
5231
5534
  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
- }>>;
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>;
5240
5545
  };
5241
5546
  /** Create the TanStack `createGist` server tool. */
5242
5547
  export declare const createGist: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5259,7 +5564,7 @@ export declare const createGist: (token: GithubTokenInput, options?: TanstackToo
5259
5564
  url: string | undefined;
5260
5565
  files: string[];
5261
5566
  owner: string | undefined;
5262
- }>;
5567
+ } | GithubDryRunResult>;
5263
5568
  };
5264
5569
  /** Create the TanStack `updateGist` server tool. */
5265
5570
  export declare const updateGist: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5282,7 +5587,7 @@ export declare const updateGist: (token: GithubTokenInput, options?: TanstackToo
5282
5587
  description: string | null | undefined;
5283
5588
  url: string | undefined;
5284
5589
  files: string[];
5285
- }>;
5590
+ } | GithubDryRunResult>;
5286
5591
  };
5287
5592
  /** Create the TanStack `deleteGist` server tool. */
5288
5593
  export declare const deleteGist: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5293,7 +5598,7 @@ export declare const deleteGist: (token: GithubTokenInput, options?: TanstackToo
5293
5598
  }) => Promise<{
5294
5599
  deleted: boolean;
5295
5600
  gistId: string;
5296
- }>;
5601
+ } | GithubDryRunResult>;
5297
5602
  };
5298
5603
  /** Create the TanStack `createGistComment` server tool. */
5299
5604
  export declare const createGistComment: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5309,7 +5614,7 @@ export declare const createGistComment: (token: GithubTokenInput, options?: Tans
5309
5614
  body: string;
5310
5615
  author: string | undefined;
5311
5616
  createdAt: string;
5312
- }>;
5617
+ } | GithubDryRunResult>;
5313
5618
  };
5314
5619
  /** Create the TanStack `listWorkflows` server tool. */
5315
5620
  export declare const listWorkflows: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5509,7 +5814,7 @@ export declare const triggerWorkflow: (token: GithubTokenInput, options?: Tansta
5509
5814
  triggered: boolean;
5510
5815
  workflowId: string | number;
5511
5816
  ref: string;
5512
- }>;
5817
+ } | GithubDryRunResult>;
5513
5818
  };
5514
5819
  /** Create the TanStack `cancelWorkflowRun` server tool. */
5515
5820
  export declare const cancelWorkflowRun: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5524,7 +5829,7 @@ export declare const cancelWorkflowRun: (token: GithubTokenInput, options?: Tans
5524
5829
  }) => Promise<{
5525
5830
  cancelled: boolean;
5526
5831
  runId: number;
5527
- }>;
5832
+ } | GithubDryRunResult>;
5528
5833
  };
5529
5834
  /** Create the TanStack `rerunWorkflowRun` server tool. */
5530
5835
  export declare const rerunWorkflowRun: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5542,7 +5847,7 @@ export declare const rerunWorkflowRun: (token: GithubTokenInput, options?: Tanst
5542
5847
  rerun: boolean;
5543
5848
  runId: number;
5544
5849
  onlyFailedJobs: boolean;
5545
- }>;
5850
+ } | GithubDryRunResult>;
5546
5851
  };
5547
5852
  /** Create the TanStack `listCheckRuns` server tool. */
5548
5853
  export declare const listCheckRuns: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5598,6 +5903,38 @@ export declare const getCombinedStatus: (token: GithubTokenInput, options?: Tans
5598
5903
  }[];
5599
5904
  }>;
5600
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
+ };
5601
5938
  /** Create the TanStack `getCiFailureContext` server tool. */
5602
5939
  export declare const getCiFailureContext: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
5603
5940
  owner: import("zod").ZodString;
@@ -5740,18 +6077,20 @@ export declare const listReleases: (token: GithubTokenInput, options?: TanstackT
5740
6077
  page?: number | undefined;
5741
6078
  maxPages?: number | undefined;
5742
6079
  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
- }>>;
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>;
5755
6094
  };
5756
6095
  /** Create the TanStack `getLatestRelease` server tool. */
5757
6096
  export declare const getLatestRelease: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5941,7 +6280,7 @@ export declare const createRelease: (token: GithubTokenInput, options?: Tanstack
5941
6280
  draft: boolean;
5942
6281
  prerelease: boolean;
5943
6282
  createdAt: string;
5944
- }>;
6283
+ } | GithubDryRunResult>;
5945
6284
  };
5946
6285
  /** Create the TanStack `updateRelease` server tool. */
5947
6286
  export declare const updateRelease: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5974,7 +6313,7 @@ export declare const updateRelease: (token: GithubTokenInput, options?: Tanstack
5974
6313
  draft: boolean;
5975
6314
  prerelease: boolean;
5976
6315
  publishedAt: string | null;
5977
- }>;
6316
+ } | GithubDryRunResult>;
5978
6317
  };
5979
6318
  /** Create the TanStack `deleteRelease` server tool. */
5980
6319
  export declare const deleteRelease: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -5989,7 +6328,7 @@ export declare const deleteRelease: (token: GithubTokenInput, options?: Tanstack
5989
6328
  }) => Promise<{
5990
6329
  deleted: boolean;
5991
6330
  releaseId: number;
5992
- }>;
6331
+ } | GithubDryRunResult>;
5993
6332
  };
5994
6333
  /** Create the TanStack `listCodeScanningAlerts` server tool. */
5995
6334
  export declare const listCodeScanningAlerts: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -6023,21 +6362,23 @@ export declare const listCodeScanningAlerts: (token: GithubTokenInput, options?:
6023
6362
  perPage?: number | undefined;
6024
6363
  page?: number | undefined;
6025
6364
  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
- }>>;
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>;
6041
6382
  };
6042
6383
  /** Create the TanStack `listDependabotAlerts` server tool. */
6043
6384
  export declare const listDependabotAlerts: (token: GithubTokenInput, options?: TanstackToolOptions) => Omit<import("@tanstack/ai").ServerTool<import("zod").ZodObject<{
@@ -6112,17 +6453,19 @@ export declare const listSecretScanningAlerts: (token: GithubTokenInput, options
6112
6453
  perPage?: number | undefined;
6113
6454
  page?: number | undefined;
6114
6455
  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
- }>>;
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>;
6126
6469
  };
6127
6470
  //#endregion
6128
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 };