[{"data":1,"prerenderedAt":904},["ShallowReactive",2],{"navigation_docs":3,"-api-tools-catalog":66,"-api-tools-catalog-surround":899},[4,22,54],{"title":5,"path":6,"stem":7,"children":8,"page":21},"Getting Started","\u002Fgetting-started","docs",[9,13,17],{"title":10,"path":11,"stem":12},"Introduction","\u002Fgetting-started\u002Fintroduction","docs\u002F1.getting-started\u002F1.introduction",{"title":14,"path":15,"stem":16},"Installation","\u002Fgetting-started\u002Finstallation","docs\u002F1.getting-started\u002F2.installation",{"title":18,"path":19,"stem":20},"Agent Skills","\u002Fgetting-started\u002Fagent-skills","docs\u002F1.getting-started\u002F3.agent-skills",false,{"title":23,"path":24,"stem":7,"children":25,"page":21},"Guide","\u002Fguide",[26,30,34,38,42,46,50],{"title":27,"path":28,"stem":29},"Quick Start","\u002Fguide\u002Fquick-start","docs\u002F2.guide\u002F1.quick-start",{"title":31,"path":32,"stem":33},"Scope with Presets","\u002Fguide\u002Fpresets","docs\u002F2.guide\u002F2.presets",{"title":35,"path":36,"stem":37},"Control Write Safety","\u002Fguide\u002Fapproval-control","docs\u002F2.guide\u002F3.approval-control",{"title":39,"path":40,"stem":41},"Commit Attribution","\u002Fguide\u002Fcommit-attribution","docs\u002F2.guide\u002F4.commit-attribution",{"title":43,"path":44,"stem":45},"Configure Token Scopes","\u002Fguide\u002Ftoken-permissions","docs\u002F2.guide\u002F5.token-and-permissions",{"title":47,"path":48,"stem":49},"Examples","\u002Fguide\u002Fexamples","docs\u002F2.guide\u002F6.examples",{"title":51,"path":52,"stem":53},"Durable workflows (Vercel Workflow)","\u002Fguide\u002Fdurable-workflows","docs\u002F2.guide\u002F7.durable-workflows",{"title":55,"path":56,"stem":7,"children":57,"page":21},"Api","\u002Fapi",[58,62],{"title":59,"path":60,"stem":61},"Tools Catalog","\u002Fapi\u002Ftools-catalog","docs\u002F3.api\u002F1.tools-catalog",{"title":63,"path":64,"stem":65},"API Reference","\u002Fapi\u002Freference","docs\u002F3.api\u002F2.reference",{"id":67,"title":59,"body":68,"description":882,"extension":883,"links":884,"meta":896,"navigation":131,"path":60,"seo":897,"stem":61,"__hash__":898},"docs\u002Fdocs\u002F3.api\u002F1.tools-catalog.md",{"type":69,"value":70,"toc":871},"minimark",[71,103,108,151,155,158,267,271,282,392,396,403,513,517,525,623,627,638,736,740,743,817,821,833,854,858,867],[72,73,74,75,79,80,84,85,92,93,98,99,102],"p",{},"Each tool is implemented with a ",[76,77,78],"strong",{},"durable"," ",[81,82,83],"code",{},"\"use step\""," boundary, so calls are proper workflow steps (retries, observability, full Node) when you run inside the ",[86,87,91],"a",{"href":88,"rel":89},"https:\u002F\u002Fvercel.com\u002Fdocs\u002Fworkflow",[90],"nofollow","Vercel Workflow SDK",". For a full agent loop that is also durable, use ",[86,94,95],{"href":52},[81,96,97],{},"createDurableGithubAgent"," from ",[81,100,101],{},"@github-tools\u002Fsdk\u002Fworkflow",".",[104,105,107],"h2",{"id":106},"ai-assistant-prompt-cherry-pick-tools","AI assistant prompt (cherry-pick tools)",[109,110,116],"pre",{"className":111,"code":112,"filename":113,"language":114,"meta":115,"style":115},"language-txt shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","Replace createGithubTools() with cherry-picked tool factories from @github-tools\u002Fsdk in this file.\n\n- Import only the factories needed; pass the GitHub token string to each\n- Keep existing model and prompts unchanged\n- Note: each factory still uses durable \"use step\" when running under Vercel Workflow (https:\u002F\u002Fgithub-tools.com\u002Fguide\u002Fdurable-workflows)\n","Prompt","txt","",[81,117,118,126,133,139,145],{"__ignoreMap":115},[119,120,123],"span",{"class":121,"line":122},"line",1,[119,124,125],{},"Replace createGithubTools() with cherry-picked tool factories from @github-tools\u002Fsdk in this file.\n",[119,127,129],{"class":121,"line":128},2,[119,130,132],{"emptyLinePlaceholder":131},true,"\n",[119,134,136],{"class":121,"line":135},3,[119,137,138],{},"- Import only the factories needed; pass the GitHub token string to each\n",[119,140,142],{"class":121,"line":141},4,[119,143,144],{},"- Keep existing model and prompts unchanged\n",[119,146,148],{"class":121,"line":147},5,[119,149,150],{},"- Note: each factory still uses durable \"use step\" when running under Vercel Workflow (https:\u002F\u002Fgithub-tools.com\u002Fguide\u002Fdurable-workflows)\n",[104,152,154],{"id":153},"repository-tools","Repository tools",[72,156,157],{},"Available in all presets. These tools manage repositories, branches, and file content:",[159,160,161,177],"table",{},[162,163,164],"thead",{},[165,166,167,171,174],"tr",{},[168,169,170],"th",{},"Tool",[168,172,173],{},"Capability",[168,175,176],{},"Write",[178,179,180,194,206,218,231,243,255],"tbody",{},[165,181,182,188,191],{},[183,184,185],"td",{},[81,186,187],{},"getRepository",[183,189,190],{},"read repository metadata (name, description, stars, language)",[183,192,193],{},"—",[165,195,196,201,204],{},[183,197,198],{},[81,199,200],{},"listBranches",[183,202,203],{},"list branches and their HEAD commits",[183,205,193],{},[165,207,208,213,216],{},[183,209,210],{},[81,211,212],{},"getFileContent",[183,214,215],{},"read a file at a specific path and ref",[183,217,193],{},[165,219,220,225,228],{},[183,221,222],{},[81,223,224],{},"createBranch",[183,226,227],{},"create a new branch from an existing branch or commit SHA",[183,229,230],{},"Yes",[165,232,233,238,241],{},[183,234,235],{},[81,236,237],{},"forkRepository",[183,239,240],{},"fork a repository to your account or an organization",[183,242,230],{},[165,244,245,250,253],{},[183,246,247],{},[81,248,249],{},"createRepository",[183,251,252],{},"create a new repository for the authenticated user or an organization",[183,254,230],{},[165,256,257,262,265],{},[183,258,259],{},[81,260,261],{},"createOrUpdateFile",[183,263,264],{},"create or update a file in the repository",[183,266,230],{},[104,268,270],{"id":269},"pull-request-tools","Pull request tools",[72,272,273,274,277,278,281],{},"Available in ",[81,275,276],{},"code-review"," and ",[81,279,280],{},"maintainer"," presets:",[159,283,284,294],{},[162,285,286],{},[165,287,288,290,292],{},[168,289,170],{},[168,291,173],{},[168,293,176],{},[178,295,296,308,320,332,344,356,368,380],{},[165,297,298,303,306],{},[183,299,300],{},[81,301,302],{},"listPullRequests",[183,304,305],{},"list pull requests filtered by state",[183,307,193],{},[165,309,310,315,318],{},[183,311,312],{},[81,313,314],{},"getPullRequest",[183,316,317],{},"read PR details including diff stats",[183,319,193],{},[165,321,322,327,330],{},[183,323,324],{},[81,325,326],{},"listPullRequestFiles",[183,328,329],{},"list files changed in a PR with diff status and patches",[183,331,193],{},[165,333,334,339,342],{},[183,335,336],{},[81,337,338],{},"listPullRequestReviews",[183,340,341],{},"list reviews on a PR (approvals, change requests, comments)",[183,343,193],{},[165,345,346,351,354],{},[183,347,348],{},[81,349,350],{},"createPullRequest",[183,352,353],{},"open a new pull request",[183,355,230],{},[165,357,358,363,366],{},[183,359,360],{},[81,361,362],{},"mergePullRequest",[183,364,365],{},"merge a pull request",[183,367,230],{},[165,369,370,375,378],{},[183,371,372],{},[81,373,374],{},"addPullRequestComment",[183,376,377],{},"post a review comment",[183,379,230],{},[165,381,382,387,390],{},[183,383,384],{},[81,385,386],{},"createPullRequestReview",[183,388,389],{},"submit a formal review (approve, request changes, or comment) with inline comments",[183,391,230],{},[104,393,395],{"id":394},"issue-tools","Issue tools",[72,397,273,398,277,401,281],{},[81,399,400],{},"issue-triage",[81,402,280],{},[159,404,405,415],{},[162,406,407],{},[165,408,409,411,413],{},[168,410,170],{},[168,412,173],{},[168,414,176],{},[178,416,417,429,441,453,465,477,489,501],{},[165,418,419,424,427],{},[183,420,421],{},[81,422,423],{},"listIssues",[183,425,426],{},"list issues filtered by state and labels",[183,428,193],{},[165,430,431,436,439],{},[183,432,433],{},[81,434,435],{},"getIssue",[183,437,438],{},"read issue details and comments",[183,440,193],{},[165,442,443,448,451],{},[183,444,445],{},[81,446,447],{},"createIssue",[183,449,450],{},"create a new issue",[183,452,230],{},[165,454,455,460,463],{},[183,456,457],{},[81,458,459],{},"addIssueComment",[183,461,462],{},"post a comment on an issue",[183,464,230],{},[165,466,467,472,475],{},[183,468,469],{},[81,470,471],{},"closeIssue",[183,473,474],{},"close an issue thread",[183,476,230],{},[165,478,479,484,487],{},[183,480,481],{},[81,482,483],{},"listLabels",[183,485,486],{},"list labels available in a repository",[183,488,193],{},[165,490,491,496,499],{},[183,492,493],{},[81,494,495],{},"addLabels",[183,497,498],{},"add labels to an issue or pull request",[183,500,230],{},[165,502,503,508,511],{},[183,504,505],{},[81,506,507],{},"removeLabel",[183,509,510],{},"remove a label from an issue or pull request",[183,512,230],{},[104,514,516],{"id":515},"gist-tools","Gist tools",[72,518,273,519,522,523,281],{},[81,520,521],{},"repo-explorer"," (read-only) and ",[81,524,280],{},[159,526,527,537],{},[162,528,529],{},[165,530,531,533,535],{},[168,532,170],{},[168,534,173],{},[168,536,176],{},[178,538,539,551,563,575,587,599,611],{},[165,540,541,546,549],{},[183,542,543],{},[81,544,545],{},"listGists",[183,547,548],{},"list gists for the authenticated user or a specific user",[183,550,193],{},[165,552,553,558,561],{},[183,554,555],{},[81,556,557],{},"getGist",[183,559,560],{},"read a gist including file contents",[183,562,193],{},[165,564,565,570,573],{},[183,566,567],{},[81,568,569],{},"listGistComments",[183,571,572],{},"list comments on a gist",[183,574,193],{},[165,576,577,582,585],{},[183,578,579],{},[81,580,581],{},"createGist",[183,583,584],{},"create a new gist with one or more files",[183,586,230],{},[165,588,589,594,597],{},[183,590,591],{},[81,592,593],{},"updateGist",[183,595,596],{},"update gist description, files, or remove files",[183,598,230],{},[165,600,601,606,609],{},[183,602,603],{},[81,604,605],{},"deleteGist",[183,607,608],{},"permanently delete a gist",[183,610,230],{},[165,612,613,618,621],{},[183,614,615],{},[81,616,617],{},"createGistComment",[183,619,620],{},"post a comment on a gist",[183,622,230],{},[104,624,626],{"id":625},"workflow-tools","Workflow tools",[72,628,273,629,631,632,635,636,281],{},[81,630,521],{}," (read-only), ",[81,633,634],{},"ci-ops",", and ",[81,637,280],{},[159,639,640,650],{},[162,641,642],{},[165,643,644,646,648],{},[168,645,170],{},[168,647,173],{},[168,649,176],{},[178,651,652,664,676,688,700,712,724],{},[165,653,654,659,662],{},[183,655,656],{},[81,657,658],{},"listWorkflows",[183,660,661],{},"list GitHub Actions workflows in a repository",[183,663,193],{},[165,665,666,671,674],{},[183,667,668],{},[81,669,670],{},"listWorkflowRuns",[183,672,673],{},"list workflow runs filtered by workflow, branch, status, or event",[183,675,193],{},[165,677,678,683,686],{},[183,679,680],{},[81,681,682],{},"getWorkflowRun",[183,684,685],{},"read a workflow run's status, timing, and trigger info",[183,687,193],{},[165,689,690,695,698],{},[183,691,692],{},[81,693,694],{},"listWorkflowJobs",[183,696,697],{},"list jobs in a workflow run with step-level status",[183,699,193],{},[165,701,702,707,710],{},[183,703,704],{},[81,705,706],{},"triggerWorkflow",[183,708,709],{},"trigger a workflow via workflow_dispatch event",[183,711,230],{},[165,713,714,719,722],{},[183,715,716],{},[81,717,718],{},"cancelWorkflowRun",[183,720,721],{},"cancel an in-progress workflow run",[183,723,230],{},[165,725,726,731,734],{},[183,727,728],{},[81,729,730],{},"rerunWorkflowRun",[183,732,733],{},"re-run a workflow run, optionally only failed jobs",[183,735,230],{},[104,737,739],{"id":738},"search-and-commit-tools","Search and commit tools",[72,741,742],{},"Available in all presets:",[159,744,745,755],{},[162,746,747],{},[165,748,749,751,753],{},[168,750,170],{},[168,752,173],{},[168,754,176],{},[178,756,757,769,781,793,805],{},[165,758,759,764,767],{},[183,760,761],{},[81,762,763],{},"listCommits",[183,765,766],{},"list commit history for a branch",[183,768,193],{},[165,770,771,776,779],{},[183,772,773],{},[81,774,775],{},"getCommit",[183,777,778],{},"read a single commit with its diff",[183,780,193],{},[165,782,783,788,791],{},[183,784,785],{},[81,786,787],{},"getBlame",[183,789,790],{},"line-level git blame for a file (GraphQL)",[183,792,193],{},[165,794,795,800,803],{},[183,796,797],{},[81,798,799],{},"searchCode",[183,801,802],{},"search code across repository files",[183,804,193],{},[165,806,807,812,815],{},[183,808,809],{},[81,810,811],{},"searchRepositories",[183,813,814],{},"search repositories by query",[183,816,193],{},[104,818,820],{"id":819},"identify-write-operations","Identify write operations",[72,822,823,824,826,827,832],{},"All tools marked ",[76,825,176],{}," can be gated with ",[86,828,829],{"href":36},[81,830,831],{},"requireApproval",". In production, always pair them with:",[834,835,836,844,851],"ul",{},[837,838,839,840,843],"li",{},"a scoped ",[86,841,842],{"href":32},"preset"," to limit which writes are available",[837,845,846,847,850],{},"a fine-grained ",[86,848,849],{"href":44},"token"," to limit what the token can do",[837,852,853],{},"an explicit approval policy to intercept mutations before execution",[104,855,857],{"id":856},"external-references","External references",[834,859,860],{},[837,861,862],{},[86,863,866],{"href":864,"rel":865},"https:\u002F\u002Fdocs.github.com\u002Fen\u002Frest",[90],"GitHub REST API endpoints",[868,869,870],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":115,"searchDepth":128,"depth":128,"links":872},[873,874,875,876,877,878,879,880,881],{"id":106,"depth":128,"text":107},{"id":153,"depth":128,"text":154},{"id":269,"depth":128,"text":270},{"id":394,"depth":128,"text":395},{"id":515,"depth":128,"text":516},{"id":625,"depth":128,"text":626},{"id":738,"depth":128,"text":739},{"id":819,"depth":128,"text":820},{"id":856,"depth":128,"text":857},"Every available tool, grouped by domain and write-safety status. Tools run as durable workflow steps when used with Vercel Workflow.","md",[885,890,893],{"label":886,"icon":887,"to":52,"color":888,"variant":889},"Durable workflows","i-lucide-refresh-cw","neutral","subtle",{"label":891,"icon":892,"to":32,"color":888,"variant":889},"Scope with presets","i-lucide-layers",{"label":894,"icon":895,"to":36,"color":888,"variant":889},"Control write safety","i-lucide-shield-check",{},{"title":59,"description":882},"5mMrFcGwb_tGdFpVLRG4fWU1S1z25l8djc-NW806LFc",[900,902],{"title":51,"path":52,"stem":53,"description":901,"children":-1},"Run GitHub tools as durable, retryable steps with createDurableGithubAgent and the Vercel Workflow SDK.",{"title":63,"path":64,"stem":65,"description":903,"children":-1},"Type signatures for createGithubTools, createGithubAgent, createDurableGithubAgent, and createOctokit.",1779365451999]