@github-tools/sdk 1.8.1 → 1.9.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.
- package/README.md +195 -68
- package/dist/connect/eve.d.mts +11 -5
- package/dist/connect/eve.d.mts.map +1 -1
- package/dist/connect/eve.mjs +10 -2
- package/dist/connect/eve.mjs.map +1 -1
- package/dist/connect.d.mts +23 -11
- package/dist/connect.d.mts.map +1 -1
- package/dist/connect.mjs +6 -3
- package/dist/connect.mjs.map +1 -1
- package/dist/eve-DmiXBuli.mjs +864 -0
- package/dist/eve-DmiXBuli.mjs.map +1 -0
- package/dist/eve.d.mts +338 -90
- package/dist/eve.d.mts.map +1 -1
- package/dist/eve.mjs +3 -3
- package/dist/index-CtID5dUi.d.mts +606 -0
- package/dist/index-CtID5dUi.d.mts.map +1 -0
- package/dist/index.d.mts +2 -2
- package/dist/index.mjs +3 -3
- package/dist/{src-CfzZfU82.mjs → src-D6vC3V8r.mjs} +293 -20
- package/dist/src-D6vC3V8r.mjs.map +1 -0
- package/dist/{token-CW8lQBND.mjs → token-sbepWIkd.mjs} +45 -7
- package/dist/token-sbepWIkd.mjs.map +1 -0
- package/dist/{types-B0mvQgJf.d.mts → types-BOnJ0Rou.d.mts} +28 -8
- package/dist/types-BOnJ0Rou.d.mts.map +1 -0
- package/dist/types-BVLof-5R.d.mts +39 -0
- package/dist/types-BVLof-5R.d.mts.map +1 -0
- package/dist/workflow.d.mts +7 -7
- package/dist/workflow.d.mts.map +1 -1
- package/dist/workflow.mjs +6 -4
- package/dist/workflow.mjs.map +1 -1
- package/dist/{write-tools-Dx9LfYlU.mjs → write-tools-cg_ialNd.mjs} +1009 -107
- package/dist/write-tools-cg_ialNd.mjs.map +1 -0
- package/package.json +13 -13
- package/dist/eve-UPaHEGVi.mjs +0 -512
- package/dist/eve-UPaHEGVi.mjs.map +0 -1
- package/dist/index-Cs1Kebmt.d.mts +0 -463
- package/dist/index-Cs1Kebmt.d.mts.map +0 -1
- package/dist/src-CfzZfU82.mjs.map +0 -1
- package/dist/token-CW8lQBND.mjs.map +0 -1
- package/dist/types-B0mvQgJf.d.mts.map +0 -1
- package/dist/types-DwHrGKWO.d.mts +0 -27
- package/dist/types-DwHrGKWO.d.mts.map +0 -1
- package/dist/write-tools-Dx9LfYlU.mjs.map +0 -1
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<img src="https://github.com/vercel-labs/github-tools/blob/main/assets/banner.jpg" width="100%" alt="GitHub
|
|
1
|
+
<img src="https://github.com/vercel-labs/github-tools/blob/main/assets/banner.jpg" width="100%" alt="GitHub tools banner" />
|
|
2
2
|
|
|
3
3
|
# @github-tools/sdk
|
|
4
4
|
|
|
@@ -7,11 +7,33 @@
|
|
|
7
7
|
[](https://www.typescriptlang.org/)
|
|
8
8
|
[](https://github.com/vercel-labs/github-tools/blob/main/LICENSE)
|
|
9
9
|
|
|
10
|
-
**
|
|
10
|
+
**Give any agent GitHub access.** A typed tool layer for GitHub AI agents, with presets, human approval, and durable execution. Works with [eve](https://eve.dev), the [AI SDK](https://ai-sdk.dev), Vercel Workflow, and [Chat SDK](https://chat-sdk.dev).
|
|
11
11
|
|
|
12
12
|
Docs: **[github-tools.com](https://github-tools.com)**
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
## Why not the GitHub MCP server, `gh` CLI, or raw Octokit?
|
|
15
|
+
|
|
16
|
+
They all reach the GitHub API, but none of them were built as an agent's tool layer. An agent still needs a schema it can fill reliably, a safety gate before it merges a PR, output shaped to fit a context window, and a way to survive a crash mid-task.
|
|
17
|
+
|
|
18
|
+
| | `@github-tools/sdk` | GitHub MCP server | `gh` CLI | Raw Octokit |
|
|
19
|
+
|---|---|---|---|---|
|
|
20
|
+
| Integration | Native AI SDK `tool()` objects | MCP wire protocol via a separate process | Shell-out from the agent | Hand-written per call |
|
|
21
|
+
| Human approval | Built in, on by default | Host-dependent, inconsistent | None | You build it |
|
|
22
|
+
| Durable / retryable | Every call is a `"use step"` | No | No | No |
|
|
23
|
+
| Scoped by task | Presets (7 built-in) | Full server surface, or manual filtering | Full CLI surface | You build it |
|
|
24
|
+
| Token-efficient output | Shaped and truncated by design | Raw API responses | Raw text, needs parsing | Raw API responses |
|
|
25
|
+
| Native eve / Workflow / Chat SDK | Yes | No | No | No |
|
|
26
|
+
|
|
27
|
+
## Pick your path
|
|
28
|
+
|
|
29
|
+
| What are you building | Start here |
|
|
30
|
+
|---|---|
|
|
31
|
+
| A standalone GitHub agent, fast: 3 files, durable approval | [eve extension](#eve-extension-recommended) |
|
|
32
|
+
| Scripts, chat backends, or an existing AI SDK app | Quick Start below |
|
|
33
|
+
| Production agents that must survive restarts and timeouts | [Durable Agents](#durable-agents-vercel-workflow-sdk) |
|
|
34
|
+
| A GitHub, Slack, or Discord bot | [Chat SDK docs](https://github-tools.com/frameworks/chat-sdk) |
|
|
35
|
+
|
|
36
|
+
53 tools cover repositories, branches, pull requests, issues, commits, releases, checks and statuses, search, gists, and workflows. See the full [Tools Catalog](https://github-tools.com/api/tools-catalog). Write operations support granular approval control out of the box.
|
|
15
37
|
|
|
16
38
|
## Installation
|
|
17
39
|
|
|
@@ -28,6 +50,7 @@ pnpm add ai zod
|
|
|
28
50
|
## Quick Start
|
|
29
51
|
|
|
30
52
|
```ts
|
|
53
|
+
// list-prs.ts
|
|
31
54
|
import { createGithubTools } from '@github-tools/sdk'
|
|
32
55
|
import { generateText } from 'ai'
|
|
33
56
|
|
|
@@ -43,20 +66,26 @@ const result = await generateText({
|
|
|
43
66
|
Use `preset` to get only the tools relevant to a specific use case:
|
|
44
67
|
|
|
45
68
|
```ts
|
|
46
|
-
// Code-review agent
|
|
69
|
+
// Code-review agent: PRs, commits, file content, and comments
|
|
47
70
|
createGithubTools({ token, preset: 'code-review' })
|
|
48
71
|
|
|
49
|
-
// Issue triage
|
|
72
|
+
// Issue triage: read/create/close issues, search
|
|
50
73
|
createGithubTools({ token, preset: 'issue-triage' })
|
|
51
74
|
|
|
52
|
-
// Read-only exploration
|
|
75
|
+
// Read-only exploration: browse repos without write access
|
|
53
76
|
createGithubTools({ token, preset: 'repo-explorer' })
|
|
54
77
|
|
|
55
|
-
//
|
|
78
|
+
// Security audit: read-only exploration, PR/CI visibility, plus issue creation to report findings
|
|
79
|
+
createGithubTools({ token, preset: 'security-audit' })
|
|
80
|
+
|
|
81
|
+
// Release manager: releases, compare diff, commits, workflow runs, pull requests
|
|
82
|
+
createGithubTools({ token, preset: 'release-manager' })
|
|
83
|
+
|
|
84
|
+
// Full maintenance: all tools
|
|
56
85
|
createGithubTools({ token, preset: 'maintainer' })
|
|
57
86
|
```
|
|
58
87
|
|
|
59
|
-
Presets are composable
|
|
88
|
+
Presets are composable, pass an array to combine them:
|
|
60
89
|
|
|
61
90
|
```ts
|
|
62
91
|
createGithubTools({ token, preset: ['code-review', 'issue-triage'] })
|
|
@@ -64,13 +93,15 @@ createGithubTools({ token, preset: ['code-review', 'issue-triage'] })
|
|
|
64
93
|
|
|
65
94
|
| Preset | Tools included |
|
|
66
95
|
|---|---|
|
|
67
|
-
| `code-review` | `getPullRequest`, `listPullRequests`, `listPullRequestFiles`, `listPullRequestReviews`, `getFileContent`, `listCommits`, `getCommit`, `getBlame`, `getRepository`, `listBranches`, `searchCode`, `addPullRequestComment`, `createPullRequestReview` |
|
|
68
|
-
| `issue-triage` | `listIssues`, `getIssue`, `createIssue`, `addIssueComment`, `closeIssue`, `listLabels`, `addLabels`, `removeLabel`, `getRepository`, `searchRepositories`, `searchCode` |
|
|
69
|
-
| `repo-explorer` | All read-only tools including gists and
|
|
70
|
-
| `ci-ops` | `listWorkflows`, `listWorkflowRuns`, `getWorkflowRun`, `listWorkflowJobs`, `triggerWorkflow`, `cancelWorkflowRun`, `rerunWorkflowRun`, `getRepository`, `listBranches`, `listCommits`, `getCommit` |
|
|
71
|
-
| `
|
|
96
|
+
| `code-review` | `getPullRequest`, `listPullRequests`, `listPullRequestFiles`, `listPullRequestReviews`, `getPullRequestContext`, `getFileContent`, `listCommits`, `getCommit`, `getBlame`, `compareCommits`, `getRepository`, `listBranches`, `searchCode`, `listCheckRuns`, `getCombinedStatus`, `addPullRequestComment`, `createPullRequestReview`, `requestReviewers` |
|
|
97
|
+
| `issue-triage` | `listIssues`, `getIssue`, `getIssueContext`, `createIssue`, `addIssueComment`, `closeIssue`, `listLabels`, `addLabels`, `removeLabel`, `addAssignees`, `removeAssignees`, `getRepository`, `searchRepositories`, `searchCode` |
|
|
98
|
+
| `repo-explorer` | All read-only tools including gists, workflows, checks/statuses, and releases (no write operations) |
|
|
99
|
+
| `ci-ops` | `listWorkflows`, `listWorkflowRuns`, `getWorkflowRun`, `listWorkflowJobs`, `listCheckRuns`, `getCombinedStatus`, `getCiFailureContext`, `triggerWorkflow`, `cancelWorkflowRun`, `rerunWorkflowRun`, `getRepository`, `listBranches`, `listCommits`, `getCommit` |
|
|
100
|
+
| `security-audit` | Read-only exploration (`getFileContent`, `getRepositoryTree`, `searchCode`, `listCommits`, `getCommit`, `getBlame`, `compareCommits`), PR and CI visibility, plus `createIssue`, `addIssueComment`, `addLabels` to report findings (no destructive writes) |
|
|
101
|
+
| `release-manager` | `listReleases`, `getLatestRelease`, `getRelease`, `getReleaseContext`, `createRelease`, `compareCommits`, `listCommits`, `getCommit`, `listWorkflowRuns`, `getWorkflowRun`, `listPullRequests`, `getPullRequest`, `getRepository`, `listBranches` |
|
|
102
|
+
| `maintainer` | All 57 tools |
|
|
72
103
|
|
|
73
|
-
Omit `preset` to get all tools (same as `maintainer`).
|
|
104
|
+
Omit `preset` to get all tools (same as `maintainer`). Full breakdown: [Tools Catalog](https://github-tools.com/api/tools-catalog).
|
|
74
105
|
|
|
75
106
|
### Cherry-Picking Tools
|
|
76
107
|
|
|
@@ -115,7 +146,7 @@ createGithubTools({
|
|
|
115
146
|
})
|
|
116
147
|
```
|
|
117
148
|
|
|
118
|
-
Write tools: `createOrUpdateFile`, `createPullRequest`, `mergePullRequest`, `addPullRequestComment`, `createPullRequestReview`, `createIssue`, `addIssueComment`, `closeIssue`, `addLabels`, `removeLabel`, `createGist`, `updateGist`, `deleteGist`, `createGistComment`, `triggerWorkflow`, `cancelWorkflowRun`, `rerunWorkflowRun`.
|
|
149
|
+
Write tools: `createBranch`, `forkRepository`, `createRepository`, `createOrUpdateFile`, `createPullRequest`, `mergePullRequest`, `addPullRequestComment`, `createPullRequestReview`, `requestReviewers`, `createIssue`, `addIssueComment`, `closeIssue`, `addLabels`, `removeLabel`, `addAssignees`, `removeAssignees`, `createGist`, `updateGist`, `deleteGist`, `createGistComment`, `triggerWorkflow`, `cancelWorkflowRun`, `rerunWorkflowRun`, `createRelease`.
|
|
119
150
|
|
|
120
151
|
All other tools are read-only and never require approval.
|
|
121
152
|
|
|
@@ -191,7 +222,7 @@ const result = await generateText({
|
|
|
191
222
|
})
|
|
192
223
|
```
|
|
193
224
|
|
|
194
|
-
Each step, toolpick picks the best ~5 tools using keyword + semantic search. All tools remain callable
|
|
225
|
+
Each step, toolpick picks the best ~5 tools using keyword + semantic search. All tools remain callable, only the visible set changes. See [toolpick docs](https://github.com/pontusab/toolpick) for LLM re-ranking, caching, and model-driven discovery options.
|
|
195
226
|
|
|
196
227
|
## Durable Agents (Vercel Workflow SDK)
|
|
197
228
|
|
|
@@ -209,13 +240,13 @@ const agent = createDurableGithubAgent({
|
|
|
209
240
|
})
|
|
210
241
|
```
|
|
211
242
|
|
|
212
|
-
All presets work with `createDurableGithubAgent`. Write tools honor `requireApproval` via `needsApproval
|
|
243
|
+
All presets work with `createDurableGithubAgent`. Write tools honor `requireApproval` via `needsApproval`: the workflow pauses until the user approves or denies.
|
|
213
244
|
|
|
214
|
-
> `workflow` and `@ai-sdk/workflow` are optional peer dependencies
|
|
245
|
+
> `workflow` and `@ai-sdk/workflow` are optional peer dependencies, install them only when using the workflow subpath.
|
|
215
246
|
|
|
216
247
|
## Vercel Connect
|
|
217
248
|
|
|
218
|
-
[Vercel Connect](https://vercel.com/docs/connect) mints short-lived GitHub tokens from a connector
|
|
249
|
+
[Vercel Connect](https://vercel.com/docs/connect) mints short-lived GitHub tokens from a connector, with no PAT to store. The `@github-tools/sdk/connect` subpath derives scopes from your preset automatically.
|
|
219
250
|
|
|
220
251
|
```sh
|
|
221
252
|
pnpm add @vercel/connect
|
|
@@ -229,28 +260,21 @@ const tools = connectGithubTools('github/my-connector', {
|
|
|
229
260
|
})
|
|
230
261
|
```
|
|
231
262
|
|
|
232
|
-
For eve agents, import
|
|
233
|
-
|
|
234
|
-
```ts
|
|
235
|
-
// agent/agent.ts — TODO(eve-connect-bundle): drop externalDependencies when eve fixes upstream
|
|
236
|
-
import { defineAgent } from 'eve'
|
|
237
|
-
|
|
238
|
-
export default defineAgent({
|
|
239
|
-
model: 'anthropic/claude-sonnet-5',
|
|
240
|
-
build: { externalDependencies: ['@vercel/connect'] },
|
|
241
|
-
})
|
|
242
|
-
```
|
|
263
|
+
For eve agents, pass `connector` directly to the [eve extension](#eve-extension-recommended) (recommended): no separate Connect import, and no `build.externalDependencies` workaround needed:
|
|
243
264
|
|
|
244
265
|
```ts
|
|
245
|
-
// agent/
|
|
246
|
-
import
|
|
266
|
+
// agent/extensions/github.ts
|
|
267
|
+
import githubExtension from '@github-tools/eve-extension'
|
|
247
268
|
|
|
248
|
-
export default
|
|
269
|
+
export default githubExtension({
|
|
270
|
+
connector: 'github/my-connector',
|
|
249
271
|
preset: 'maintainer',
|
|
250
272
|
})
|
|
251
273
|
```
|
|
252
274
|
|
|
253
|
-
`connectGithubTools`
|
|
275
|
+
For the deprecated direct import, use `connectGithubTools` from `@github-tools/sdk/connect/eve` the same way inside `agent/tools/github.ts`. That path does need `build: { externalDependencies: ['@vercel/connect'] }` in `agent.ts` (see [eve, direct import](#eve-direct-import-deprecated) below).
|
|
276
|
+
|
|
277
|
+
`connectGithubTools` mints tokens lazily at tool execution. Do not `await getToken(...)` at module top level in `agent/tools/` (that runs at import/build time).
|
|
254
278
|
|
|
255
279
|
Token provider only (custom factories):
|
|
256
280
|
|
|
@@ -263,7 +287,7 @@ createGithubTools({
|
|
|
263
287
|
})
|
|
264
288
|
```
|
|
265
289
|
|
|
266
|
-
Pass the same `preset` to `connectGithubToken
|
|
290
|
+
Pass the same `preset` to `connectGithubToken`: it derives Connect scopes independently of the `preset` given to `createGithubTools`.
|
|
267
291
|
|
|
268
292
|
Override installation, repositories, or scopes via `connect`:
|
|
269
293
|
|
|
@@ -278,11 +302,65 @@ connectGithubTools('github/my-connector', {
|
|
|
278
302
|
})
|
|
279
303
|
```
|
|
280
304
|
|
|
281
|
-
> `@vercel/connect` is an optional peer dependency
|
|
305
|
+
> `@vercel/connect` is an optional peer dependency, install it only when using the `/connect` subpath.
|
|
306
|
+
|
|
307
|
+
`connector` accepts a `() => string | Promise<string>` resolver instead of a static name, re-resolved on every call. Useful to pick a connector per environment or tenant:
|
|
308
|
+
|
|
309
|
+
```ts
|
|
310
|
+
connectGithubTools(
|
|
311
|
+
() => (process.env.VERCEL_ENV === 'production' ? 'github/prod-connector' : 'github/preview-connector'),
|
|
312
|
+
{ preset: 'code-review' },
|
|
313
|
+
)
|
|
314
|
+
```
|
|
282
315
|
|
|
283
316
|
## eve
|
|
284
317
|
|
|
285
|
-
[eve](https://eve.dev) is Vercel's filesystem-first agent framework.
|
|
318
|
+
[eve](https://eve.dev) is Vercel's filesystem-first agent framework. `@github-tools/eve-extension` is the **recommended** way to add GitHub tools to an eve agent: a mountable [eve extension](https://eve.dev/docs/extensions), no CLI setup, no direct SDK import in `agent/tools/`. The lower-level `@github-tools/sdk/eve` subpath (`defineDynamic`) is **deprecated** in its favor; it keeps working and is documented below for existing agents.
|
|
319
|
+
|
|
320
|
+
### eve extension (recommended)
|
|
321
|
+
|
|
322
|
+
```sh
|
|
323
|
+
pnpm add @github-tools/eve-extension eve
|
|
324
|
+
```
|
|
325
|
+
|
|
326
|
+
`eve` is a required peer dependency (itself requiring **`ai` v7**).
|
|
327
|
+
|
|
328
|
+
```ts
|
|
329
|
+
// agent/extensions/github.ts
|
|
330
|
+
import githubExtension from '@github-tools/eve-extension'
|
|
331
|
+
|
|
332
|
+
export default githubExtension({
|
|
333
|
+
preset: ['code-review', 'issue-triage'],
|
|
334
|
+
requireApproval: {
|
|
335
|
+
mergePullRequest: true,
|
|
336
|
+
createIssue: 'once',
|
|
337
|
+
addPullRequestComment: false,
|
|
338
|
+
createOrUpdateFile: ({ toolInput }) => toolInput?.owner !== 'vercel-labs',
|
|
339
|
+
},
|
|
340
|
+
})
|
|
341
|
+
```
|
|
342
|
+
|
|
343
|
+
Tools are exposed to the model as `<namespace>__<toolName>`, where `<namespace>` comes from the mount file's name: `agent/extensions/github.ts` yields `github__listPullRequests`, `github__createIssue`, and so on.
|
|
344
|
+
|
|
345
|
+
For Vercel Connect, pass `connector` directly, no separate import needed:
|
|
346
|
+
|
|
347
|
+
```ts
|
|
348
|
+
// agent/extensions/github.ts
|
|
349
|
+
import githubExtension from '@github-tools/eve-extension'
|
|
350
|
+
|
|
351
|
+
export default githubExtension({
|
|
352
|
+
connector: 'github/my-connector',
|
|
353
|
+
preset: 'maintainer',
|
|
354
|
+
})
|
|
355
|
+
```
|
|
356
|
+
|
|
357
|
+
No `build.externalDependencies` workaround is needed here. Unlike the deprecated direct import below, the extension is pre-built via `eve extension build` and loaded through eve's extension mechanism rather than inlined from a workspace-linked source import.
|
|
358
|
+
|
|
359
|
+
See [`packages/github-tools-eve-extension`](../github-tools-eve-extension) and [`examples/eve-extension-agent`](../../examples/eve-extension-agent) for the full package README and a runnable agent.
|
|
360
|
+
|
|
361
|
+
### eve, direct import (deprecated)
|
|
362
|
+
|
|
363
|
+
The `@github-tools/sdk/eve` subpath registers all GitHub tools via `defineDynamic`: one file, zero CLI. This keeps working but new agents should use the extension above.
|
|
286
364
|
|
|
287
365
|
```sh
|
|
288
366
|
pnpm add @github-tools/sdk eve ai zod
|
|
@@ -305,9 +383,9 @@ export default createGithubTools({
|
|
|
305
383
|
})
|
|
306
384
|
```
|
|
307
385
|
|
|
308
|
-
Dynamic tools are named by their **bare map key
|
|
386
|
+
Dynamic tools are named by their **bare map key**: the model sees `listPullRequests`, `createIssue`, and so on (same names as the AI SDK package). There is no automatic file-slug prefix when returning a tool map from `defineDynamic`.
|
|
309
387
|
|
|
310
|
-
|
|
388
|
+
#### Approval (eve)
|
|
311
389
|
|
|
312
390
|
| Value | Maps to | Behavior |
|
|
313
391
|
|---|---|---|
|
|
@@ -319,9 +397,9 @@ Dynamic tools are named by their **bare map key** — the model sees `listPullRe
|
|
|
319
397
|
|
|
320
398
|
Default (no `requireApproval`): all write tools → `always()`. Unlisted write tools keep the `always()` fail-safe default.
|
|
321
399
|
|
|
322
|
-
Unlike the Workflow SDK subpath, eve approval **works durably
|
|
400
|
+
Unlike the Workflow SDK subpath, eve approval **works durably**: gated tools pause the session until a human approves.
|
|
323
401
|
|
|
324
|
-
|
|
402
|
+
#### Cherry-picking (one tool per file)
|
|
325
403
|
|
|
326
404
|
```ts
|
|
327
405
|
// agent/tools/list_pull_requests.ts
|
|
@@ -330,7 +408,7 @@ import { listPullRequests } from '@github-tools/sdk/eve'
|
|
|
330
408
|
export default listPullRequests()
|
|
331
409
|
```
|
|
332
410
|
|
|
333
|
-
|
|
411
|
+
#### Idempotency
|
|
334
412
|
|
|
335
413
|
eve replays completed steps but re-runs steps interrupted mid-execution. Write tools vary:
|
|
336
414
|
|
|
@@ -339,27 +417,45 @@ eve replays completed steps but re-runs steps interrupted mid-execution. Write t
|
|
|
339
417
|
| `createOrUpdateFile` | Natural when content + `sha` unchanged (skips no-op updates) |
|
|
340
418
|
| `closeIssue` | Natural when already closed |
|
|
341
419
|
| `createBranch` | Natural when branch exists at same SHA |
|
|
342
|
-
| `
|
|
420
|
+
| `removeAssignees` | Natural: removing an assignee that isn't assigned is a no-op on GitHub |
|
|
421
|
+
| `addIssueComment`, `createIssue`, `mergePullRequest`, `createRelease`, … | **Not** idempotent: each call creates new side effects |
|
|
343
422
|
|
|
344
423
|
Gate non-idempotent writes behind `always()` or `once()` where replay safety matters.
|
|
345
424
|
|
|
346
|
-
|
|
425
|
+
#### Vercel Connect
|
|
347
426
|
|
|
348
|
-
|
|
427
|
+
Mint the token from a Connect connector instead of `GITHUB_TOKEN`. `connectGithubTools` derives scopes from `preset` and fetches the token lazily inside each tool call:
|
|
349
428
|
|
|
350
|
-
|
|
429
|
+
```ts
|
|
430
|
+
// agent/tools/github.ts
|
|
431
|
+
import { connectGithubTools } from '@github-tools/sdk/connect/eve'
|
|
432
|
+
|
|
433
|
+
export default connectGithubTools('github/my-connector', {
|
|
434
|
+
preset: 'maintainer',
|
|
435
|
+
})
|
|
436
|
+
```
|
|
437
|
+
|
|
438
|
+
Add `build: { externalDependencies: ['@vercel/connect'] }` to `agent.ts`. See [Vercel Connect](#vercel-connect) above for the full setup checklist.
|
|
439
|
+
|
|
440
|
+
> `eve` is an optional peer dependency, install it only when using the `/eve` subpath.
|
|
351
441
|
|
|
352
442
|
See [`examples/eve-agent`](../../examples/eve-agent) for a minimal agent.
|
|
353
443
|
|
|
354
444
|
## Available Tools
|
|
355
445
|
|
|
446
|
+
List tools (`listCommits`, `listPullRequests`, `listIssues`, `listWorkflowRuns`, `listCheckRuns`, `listReleases`) accept an optional `maxPages` alongside `perPage`. Set it to sequentially fetch and combine up to that many pages in one call, stopping early once a page comes back short.
|
|
447
|
+
|
|
356
448
|
### Repository
|
|
357
449
|
|
|
358
450
|
| Tool | Description |
|
|
359
451
|
|---|---|
|
|
360
452
|
| `getRepository` | Get repository metadata (stars, language, default branch, …) |
|
|
361
453
|
| `listBranches` | List branches |
|
|
362
|
-
| `getFileContent` | Read a file or directory listing |
|
|
454
|
+
| `getFileContent` | Read a file or directory listing (prefer `startLine`/`endLine` or `maxLines` for large files) |
|
|
455
|
+
| `getRepositoryTree` | List the file and directory structure at a given ref |
|
|
456
|
+
| `createBranch` | Create a new branch from an existing branch or commit SHA |
|
|
457
|
+
| `forkRepository` | Fork a repository to a user or organization |
|
|
458
|
+
| `createRepository` | Create a new repository for a user or organization |
|
|
363
459
|
| `createOrUpdateFile` | Create or update a file and commit it |
|
|
364
460
|
|
|
365
461
|
### Pull Requests
|
|
@@ -367,26 +463,31 @@ See [`examples/eve-agent`](../../examples/eve-agent) for a minimal agent.
|
|
|
367
463
|
| Tool | Description |
|
|
368
464
|
|---|---|
|
|
369
465
|
| `listPullRequests` | List PRs filtered by state |
|
|
370
|
-
| `getPullRequest` | Get a PR's full details (diff stats, body, merge status) |
|
|
371
|
-
| `listPullRequestFiles` | List files changed in a PR
|
|
466
|
+
| `getPullRequest` | Get a PR's full details (diff stats, body, merge status; body truncated by default) |
|
|
467
|
+
| `listPullRequestFiles` | List files changed in a PR (patches omitted by default; set `includePatch` / `filenames` for diffs) |
|
|
372
468
|
| `listPullRequestReviews` | List reviews on a PR (approvals, change requests, comments) |
|
|
469
|
+
| `getPullRequestContext` | Fetch PR details plus files, reviews, and optional CI checks in one call |
|
|
373
470
|
| `createPullRequest` | Open a new PR |
|
|
374
471
|
| `mergePullRequest` | Merge a PR (merge, squash, or rebase) |
|
|
375
472
|
| `addPullRequestComment` | Post a comment on a PR |
|
|
376
473
|
| `createPullRequestReview` | Submit a formal review (approve, request changes, or comment) with inline comments |
|
|
474
|
+
| `requestReviewers` | Request reviews from users or teams on a PR |
|
|
377
475
|
|
|
378
476
|
### Issues
|
|
379
477
|
|
|
380
478
|
| Tool | Description |
|
|
381
479
|
|---|---|
|
|
382
480
|
| `listIssues` | List issues filtered by state and labels |
|
|
383
|
-
| `getIssue` | Get an issue's full
|
|
481
|
+
| `getIssue` | Get an issue's details (body truncated by default; set `detail: full` for complete text) |
|
|
482
|
+
| `getIssueContext` | Fetch an issue plus available labels and recent comments in one call |
|
|
384
483
|
| `createIssue` | Open a new issue |
|
|
385
484
|
| `addIssueComment` | Post a comment on an issue |
|
|
386
485
|
| `closeIssue` | Close an issue (completed or not planned) |
|
|
387
486
|
| `listLabels` | List labels available in a repository |
|
|
388
487
|
| `addLabels` | Add labels to an issue or pull request |
|
|
389
488
|
| `removeLabel` | Remove a label from an issue or pull request |
|
|
489
|
+
| `addAssignees` | Assign users to an issue or pull request |
|
|
490
|
+
| `removeAssignees` | Remove assignees from an issue or pull request |
|
|
390
491
|
|
|
391
492
|
### Gists
|
|
392
493
|
|
|
@@ -412,6 +513,24 @@ See [`examples/eve-agent`](../../examples/eve-agent) for a minimal agent.
|
|
|
412
513
|
| `cancelWorkflowRun` | Cancel an in-progress workflow run |
|
|
413
514
|
| `rerunWorkflowRun` | Re-run a workflow run, optionally only failed jobs |
|
|
414
515
|
|
|
516
|
+
### Checks and Statuses
|
|
517
|
+
|
|
518
|
+
| Tool | Description |
|
|
519
|
+
|---|---|
|
|
520
|
+
| `listCheckRuns` | List check runs (Checks API: GitHub Actions and other CI providers) for a commit, branch, or tag |
|
|
521
|
+
| `getCombinedStatus` | Get the combined commit status (Statuses API: legacy CI integrations) for a commit, branch, or tag |
|
|
522
|
+
| `getCiFailureContext` | Diagnose CI failures for a ref — combined status, failing checks, and failed workflow jobs in one call |
|
|
523
|
+
|
|
524
|
+
### Releases
|
|
525
|
+
|
|
526
|
+
| Tool | Description |
|
|
527
|
+
|---|---|
|
|
528
|
+
| `listReleases` | List releases, newest first (includes drafts and prereleases) |
|
|
529
|
+
| `getLatestRelease` | Get the latest published release (body truncated by default; set `detail: full` for complete notes) |
|
|
530
|
+
| `getRelease` | Get a specific release by ID, including its assets |
|
|
531
|
+
| `getReleaseContext` | Fetch a release plus the previous release and tag comparison in one call |
|
|
532
|
+
| `createRelease` | Create a new release (and its tag if needed) |
|
|
533
|
+
|
|
415
534
|
### Commits
|
|
416
535
|
|
|
417
536
|
| Tool | Description |
|
|
@@ -419,6 +538,7 @@ See [`examples/eve-agent`](../../examples/eve-agent) for a minimal agent.
|
|
|
419
538
|
| `listCommits` | List commits, optionally filtered by file path, author, or date range |
|
|
420
539
|
| `getCommit` | Get a commit's full details including changed files and diffs |
|
|
421
540
|
| `getBlame` | Line-level git blame for a file (GitHub GraphQL) |
|
|
541
|
+
| `compareCommits` | Compare two branches, tags, or commits: ahead/behind counts, commits in between, and files that differ |
|
|
422
542
|
|
|
423
543
|
### Search
|
|
424
544
|
|
|
@@ -438,17 +558,19 @@ Create one at **GitHub → Settings → Developer settings → Personal access t
|
|
|
438
558
|
| Permission | Level | Required for |
|
|
439
559
|
|---|---|---|
|
|
440
560
|
| **Metadata** | Read-only | Always required (auto-included) |
|
|
441
|
-
| **Contents** | Read-only | `getRepository`, `listBranches`, `getFileContent`, `listCommits`, `getCommit`, `getBlame` |
|
|
442
|
-
| **Contents** | Read and write | `createOrUpdateFile` |
|
|
443
|
-
| **
|
|
444
|
-
| **Pull requests** | Read
|
|
445
|
-
| **
|
|
446
|
-
| **Issues** | Read
|
|
447
|
-
|
|
561
|
+
| **Contents** | Read-only | `getRepository`, `listBranches`, `getFileContent`, `getRepositoryTree`, `listCommits`, `getCommit`, `getBlame`, `compareCommits`, `listReleases`, `getLatestRelease`, `getRelease`, `getReleaseContext` |
|
|
562
|
+
| **Contents** | Read and write | `createBranch`, `createOrUpdateFile`, `createRelease` |
|
|
563
|
+
| **Administration** | Read and write | `forkRepository`, `createRepository` |
|
|
564
|
+
| **Pull requests** | Read-only | `listPullRequests`, `getPullRequest`, `listPullRequestFiles`, `listPullRequestReviews`, `getPullRequestContext` |
|
|
565
|
+
| **Pull requests** | Read and write | `createPullRequest`, `mergePullRequest`, `addPullRequestComment`, `createPullRequestReview`, `requestReviewers` |
|
|
566
|
+
| **Issues** | Read-only | `listIssues`, `getIssue`, `getIssueContext`, `listLabels` |
|
|
567
|
+
| **Issues** | Read and write | `createIssue`, `addIssueComment`, `closeIssue`, `addLabels`, `removeLabel`, `addAssignees`, `removeAssignees` |
|
|
448
568
|
| **Gists** | Read-only | `listGists`, `getGist`, `listGistComments` |
|
|
449
569
|
| **Gists** | Read and write | `createGist`, `updateGist`, `deleteGist`, `createGistComment` |
|
|
450
|
-
| **Actions** | Read-only | `listWorkflows`, `listWorkflowRuns`, `getWorkflowRun`, `listWorkflowJobs` |
|
|
570
|
+
| **Actions** | Read-only | `listWorkflows`, `listWorkflowRuns`, `getWorkflowRun`, `listWorkflowJobs`, `getCiFailureContext` |
|
|
451
571
|
| **Actions** | Read and write | `triggerWorkflow`, `cancelWorkflowRun`, `rerunWorkflowRun` |
|
|
572
|
+
| **Checks** | Read-only | `listCheckRuns`, `getCiFailureContext` |
|
|
573
|
+
| **Commit statuses** | Read-only | `getCombinedStatus`, `getCiFailureContext` |
|
|
452
574
|
|
|
453
575
|
Search tools (`searchCode`, `searchRepositories`) work with any token.
|
|
454
576
|
|
|
@@ -470,11 +592,12 @@ type GithubToolsOptions = {
|
|
|
470
592
|
token?: GithubTokenInput // defaults to process.env.GITHUB_TOKEN
|
|
471
593
|
requireApproval?: boolean | Partial<Record<GithubWriteToolName, boolean>>
|
|
472
594
|
preset?: GithubToolPreset | GithubToolPreset[]
|
|
595
|
+
context?: GithubToolsContext // default owner / repo / PR / issue / ref
|
|
473
596
|
}
|
|
474
597
|
|
|
475
598
|
type GithubTokenInput = string | (() => Promise<string>)
|
|
476
599
|
|
|
477
|
-
type GithubToolPreset = 'code-review' | 'issue-triage' | 'repo-explorer' | 'ci-ops' | 'maintainer'
|
|
600
|
+
type GithubToolPreset = 'code-review' | 'issue-triage' | 'repo-explorer' | 'ci-ops' | 'security-audit' | 'release-manager' | 'maintainer'
|
|
478
601
|
```
|
|
479
602
|
|
|
480
603
|
### `createGithubAgent(options)`
|
|
@@ -484,17 +607,18 @@ Returns a `ToolLoopAgent` instance with `.generate()` and `.stream()` methods, p
|
|
|
484
607
|
```ts
|
|
485
608
|
import { createGithubAgent } from '@github-tools/sdk'
|
|
486
609
|
|
|
487
|
-
// Minimal
|
|
610
|
+
// Minimal: all tools, generic prompt
|
|
488
611
|
const agent = createGithubAgent({
|
|
489
612
|
model: 'anthropic/claude-sonnet-4.6',
|
|
490
613
|
token: process.env.GITHUB_TOKEN!,
|
|
491
614
|
})
|
|
492
615
|
|
|
493
|
-
// With preset
|
|
616
|
+
// With preset: scoped tools + tailored prompt
|
|
494
617
|
const reviewer = createGithubAgent({
|
|
495
618
|
model: 'anthropic/claude-sonnet-4.6',
|
|
496
619
|
token: process.env.GITHUB_TOKEN!,
|
|
497
620
|
preset: 'code-review',
|
|
621
|
+
context: { owner: 'vercel', repo: 'ai', pullNumber: 42 },
|
|
498
622
|
})
|
|
499
623
|
|
|
500
624
|
// Add context to the built-in prompt
|
|
@@ -505,7 +629,7 @@ const triager = createGithubAgent({
|
|
|
505
629
|
additionalInstructions: 'Focus on the nuxt/ui repository. Always respond in French.',
|
|
506
630
|
})
|
|
507
631
|
|
|
508
|
-
// Full override
|
|
632
|
+
// Full override: replace the built-in prompt entirely
|
|
509
633
|
const custom = createGithubAgent({
|
|
510
634
|
model: 'anthropic/claude-sonnet-4.6',
|
|
511
635
|
token: process.env.GITHUB_TOKEN!,
|
|
@@ -513,17 +637,18 @@ const custom = createGithubAgent({
|
|
|
513
637
|
})
|
|
514
638
|
|
|
515
639
|
// Use the agent
|
|
516
|
-
const result = await reviewer.generate({ prompt: 'Review PR
|
|
517
|
-
const stream = reviewer.stream({ prompt: 'Review PR
|
|
640
|
+
const result = await reviewer.generate({ prompt: 'Review this PR' })
|
|
641
|
+
const stream = reviewer.stream({ prompt: 'Review this PR' })
|
|
518
642
|
```
|
|
519
643
|
|
|
520
644
|
| Option | Description |
|
|
521
645
|
|---|---|
|
|
522
|
-
| `model` | Language model
|
|
646
|
+
| `model` | Language model: string (`'anthropic/claude-sonnet-4.6'`) or provider instance |
|
|
523
647
|
| `token` | GitHub token string or async provider |
|
|
524
648
|
| `preset` | Optional preset or array of presets to scope tools |
|
|
649
|
+
| `context` | Default owner / repo / pullNumber / issueNumber / ref for tools and the system prompt |
|
|
525
650
|
| `requireApproval` | Approval config (same as `createGithubTools`) |
|
|
526
|
-
| `instructions` | Replaces the built-in system prompt entirely |
|
|
651
|
+
| `instructions` | Replaces the built-in system prompt entirely (`context` is still appended) |
|
|
527
652
|
| `additionalInstructions` | Appended to the built-in system prompt |
|
|
528
653
|
|
|
529
654
|
All other `ToolLoopAgent` options (`stopWhen`, `toolChoice`, `onStepFinish`, etc.) are passed through.
|
|
@@ -543,6 +668,7 @@ pnpm add workflow @workflow/ai
|
|
|
543
668
|
#### Streaming (chat UI)
|
|
544
669
|
|
|
545
670
|
```ts
|
|
671
|
+
// durable-chat.workflow.ts
|
|
546
672
|
import { createDurableGithubAgent } from '@github-tools/sdk/workflow'
|
|
547
673
|
import { getWritable } from 'workflow'
|
|
548
674
|
import type { ModelMessage, UIMessageChunk } from 'ai'
|
|
@@ -559,9 +685,10 @@ async function chatWorkflow(messages: ModelMessage[], token: string) {
|
|
|
559
685
|
}
|
|
560
686
|
```
|
|
561
687
|
|
|
562
|
-
#### Non-streaming (bot / background job
|
|
688
|
+
#### Non-streaming (bot / background job, needs `"use step"`)
|
|
563
689
|
|
|
564
690
|
```ts
|
|
691
|
+
// agent-turn.step.ts
|
|
565
692
|
import { createGithubAgent } from '@github-tools/sdk'
|
|
566
693
|
|
|
567
694
|
async function agentTurn(prompt: string) {
|
|
@@ -578,7 +705,7 @@ async function agentTurn(prompt: string) {
|
|
|
578
705
|
|
|
579
706
|
> See [`examples/pr-review-agent`](../../examples/pr-review-agent) for a complete PR review agent built with Chat SDK and Vercel Workflow.
|
|
580
707
|
|
|
581
|
-
All presets (`code-review`, `issue-triage`, `ci-ops`, `repo-explorer`, `maintainer`) work with `createDurableGithubAgent`. Options mirror `createGithubAgent` with additional pass-through for `WorkflowAgentOptions` fields like `experimental_telemetry`, `onStepEnd`, `onEnd`, and `prepareStep`. Write tools honor `requireApproval` via `needsApproval`.
|
|
708
|
+
All presets (`code-review`, `issue-triage`, `ci-ops`, `repo-explorer`, `security-audit`, `release-manager`, `maintainer`) work with `createDurableGithubAgent`. Options mirror `createGithubAgent` with additional pass-through for `WorkflowAgentOptions` fields like `experimental_telemetry`, `onStepEnd`, `onEnd`, and `prepareStep`. Write tools honor `requireApproval` via `needsApproval`.
|
|
582
709
|
|
|
583
710
|
### `resolveGithubToken(token?)`
|
|
584
711
|
|
package/dist/connect/eve.d.mts
CHANGED
|
@@ -1,18 +1,24 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { t as ConnectGithubEveToolsOptions } from "../types-
|
|
3
|
-
import * as _$eve_tools0 from "eve/tools";
|
|
4
|
-
|
|
1
|
+
import { jt as GithubToolName } from "../index-CtID5dUi.mjs";
|
|
2
|
+
import { a as GithubConnectorInput, t as ConnectGithubEveToolsOptions } from "../types-BVLof-5R.mjs";
|
|
5
3
|
//#region src/connect/eve.d.ts
|
|
6
4
|
/**
|
|
7
5
|
* Register eve GitHub tools backed by a Vercel Connect connector.
|
|
8
6
|
* Scopes are derived from `preset` unless overridden in `connect.scopes`.
|
|
9
7
|
*
|
|
8
|
+
* `connector` may be a static name or a resolver function — e.g. to pick a
|
|
9
|
+
* different connector per environment (production vs. preview) or tenant.
|
|
10
|
+
*
|
|
10
11
|
* TODO(eve-connect-bundle): eve's authored-module bundler inlines workspace-linked
|
|
11
12
|
* SDK code and code-splits `@vercel/connect` unless the agent sets
|
|
12
13
|
* `build.externalDependencies: ['@vercel/connect']` in `agent.ts`. Remove that
|
|
13
14
|
* requirement when upstream eve externalizes this path.
|
|
15
|
+
*
|
|
16
|
+
* @deprecated Use the mountable `@github-tools/eve-extension` instead and pass `connector`
|
|
17
|
+
* directly to `githubExtension(...)` — no separate Connect import is needed. This direct
|
|
18
|
+
* import keeps working but is no longer the recommended path. See
|
|
19
|
+
* https://github-tools.com/frameworks/eve-extension#vercel-connect.
|
|
14
20
|
*/
|
|
15
|
-
declare function connectGithubTools(connector:
|
|
21
|
+
declare function connectGithubTools(connector: GithubConnectorInput, options?: ConnectGithubEveToolsOptions): import("eve/tools").DynamicSentinel<Partial<Record<GithubToolName, import("eve/tools").ToolDefinition<unknown, unknown>>>>;
|
|
16
22
|
//#endregion
|
|
17
23
|
export { connectGithubTools };
|
|
18
24
|
//# sourceMappingURL=eve.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"eve.d.mts","names":[],"sources":["../../src/connect/eve.ts"],"mappings":"
|
|
1
|
+
{"version":3,"file":"eve.d.mts","names":[],"sources":["../../src/connect/eve.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;iBAsBgB,mBACd,WAAW,sBACX,UAAS,mDAAiC,gBAAA,QAAA,OAAjC,oCAAiC"}
|
package/dist/connect/eve.mjs
CHANGED
|
@@ -1,14 +1,22 @@
|
|
|
1
|
-
import { l as createGithubTools } from "../eve-
|
|
2
|
-
import { t as connectGithubToken } from "../token-
|
|
1
|
+
import { l as createGithubTools } from "../eve-DmiXBuli.mjs";
|
|
2
|
+
import { t as connectGithubToken } from "../token-sbepWIkd.mjs";
|
|
3
3
|
//#region src/connect/eve.ts
|
|
4
4
|
/**
|
|
5
5
|
* Register eve GitHub tools backed by a Vercel Connect connector.
|
|
6
6
|
* Scopes are derived from `preset` unless overridden in `connect.scopes`.
|
|
7
7
|
*
|
|
8
|
+
* `connector` may be a static name or a resolver function — e.g. to pick a
|
|
9
|
+
* different connector per environment (production vs. preview) or tenant.
|
|
10
|
+
*
|
|
8
11
|
* TODO(eve-connect-bundle): eve's authored-module bundler inlines workspace-linked
|
|
9
12
|
* SDK code and code-splits `@vercel/connect` unless the agent sets
|
|
10
13
|
* `build.externalDependencies: ['@vercel/connect']` in `agent.ts`. Remove that
|
|
11
14
|
* requirement when upstream eve externalizes this path.
|
|
15
|
+
*
|
|
16
|
+
* @deprecated Use the mountable `@github-tools/eve-extension` instead and pass `connector`
|
|
17
|
+
* directly to `githubExtension(...)` — no separate Connect import is needed. This direct
|
|
18
|
+
* import keeps working but is no longer the recommended path. See
|
|
19
|
+
* https://github-tools.com/frameworks/eve-extension#vercel-connect.
|
|
12
20
|
*/
|
|
13
21
|
function connectGithubTools(connector, options = {}) {
|
|
14
22
|
const { connect, preset, ...rest } = options;
|
package/dist/connect/eve.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"eve.mjs","names":["createEveGithubTools"],"sources":["../../src/connect/eve.ts"],"sourcesContent":["import { createGithubTools as createEveGithubTools } from '../eve'\nimport { connectGithubToken } from './token'\nimport type { ConnectGithubEveToolsOptions } from './types'\n\n/**\n * Register eve GitHub tools backed by a Vercel Connect connector.\n * Scopes are derived from `preset` unless overridden in `connect.scopes`.\n *\n * TODO(eve-connect-bundle): eve's authored-module bundler inlines workspace-linked\n * SDK code and code-splits `@vercel/connect` unless the agent sets\n * `build.externalDependencies: ['@vercel/connect']` in `agent.ts`. Remove that\n * requirement when upstream eve externalizes this path.\n */\nexport function connectGithubTools(\n connector:
|
|
1
|
+
{"version":3,"file":"eve.mjs","names":["createEveGithubTools"],"sources":["../../src/connect/eve.ts"],"sourcesContent":["import { createGithubTools as createEveGithubTools } from '../eve'\nimport type { GithubConnectorInput } from './connector'\nimport { connectGithubToken } from './token'\nimport type { ConnectGithubEveToolsOptions } from './types'\n\n/**\n * Register eve GitHub tools backed by a Vercel Connect connector.\n * Scopes are derived from `preset` unless overridden in `connect.scopes`.\n *\n * `connector` may be a static name or a resolver function — e.g. to pick a\n * different connector per environment (production vs. preview) or tenant.\n *\n * TODO(eve-connect-bundle): eve's authored-module bundler inlines workspace-linked\n * SDK code and code-splits `@vercel/connect` unless the agent sets\n * `build.externalDependencies: ['@vercel/connect']` in `agent.ts`. Remove that\n * requirement when upstream eve externalizes this path.\n *\n * @deprecated Use the mountable `@github-tools/eve-extension` instead and pass `connector`\n * directly to `githubExtension(...)` — no separate Connect import is needed. This direct\n * import keeps working but is no longer the recommended path. See\n * https://github-tools.com/frameworks/eve-extension#vercel-connect.\n */\nexport function connectGithubTools(\n connector: GithubConnectorInput,\n options: ConnectGithubEveToolsOptions = {},\n) {\n const { connect, preset, ...rest } = options\n\n return createEveGithubTools({\n ...rest,\n preset,\n token: connectGithubToken(connector, { preset, params: connect }),\n })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,mBACd,WACA,UAAwC,CAAC,GACzC;CACA,MAAM,EAAE,SAAS,QAAQ,GAAG,SAAS;CAErC,OAAOA,kBAAqB;EAC1B,GAAG;EACH;EACA,OAAO,mBAAmB,WAAW;GAAE;GAAQ,QAAQ;EAAQ,CAAC;CAClE,CAAC;AACH"}
|