@github-tools/sdk 1.8.1 → 1.8.2

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 (2) hide show
  1. package/README.md +15 -2
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -284,6 +284,8 @@ connectGithubTools('github/my-connector', {
284
284
 
285
285
  [eve](https://eve.dev) is Vercel's filesystem-first agent framework. The `@github-tools/sdk/eve` subpath registers all GitHub tools via `defineDynamic` — one file, zero CLI.
286
286
 
287
+ > A mountable [eve extension](https://eve.dev/docs/extensions), `@github-tools/eve-extension`, is also available and is the direction this integration is moving toward — it will become the recommended way to add GitHub tools to an eve agent. The direct import below remains supported. See [`packages/github-tools-eve-extension`](../github-tools-eve-extension) and [`examples/eve-extension-agent`](../../examples/eve-extension-agent).
288
+
287
289
  ```sh
288
290
  pnpm add @github-tools/sdk eve ai zod
289
291
  ```
@@ -343,9 +345,20 @@ eve replays completed steps but re-runs steps interrupted mid-execution. Write t
343
345
 
344
346
  Gate non-idempotent writes behind `always()` or `once()` where replay safety matters.
345
347
 
346
- ### Roadmap
348
+ ### Vercel Connect
349
+
350
+ 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:
351
+
352
+ ```ts
353
+ // agent/tools/github.ts
354
+ import { connectGithubTools } from '@github-tools/sdk/connect/eve'
355
+
356
+ export default connectGithubTools('github/my-connector', {
357
+ preset: 'maintainer',
358
+ })
359
+ ```
347
360
 
348
- `// TODO(eve-auth)`: per-session GitHub tokens via eve connections (`auth: 'eve'`). For now, pass `token` explicitly or set `GITHUB_TOKEN`.
361
+ Add `build: { externalDependencies: ['@vercel/connect'] }` to `agent.ts` — see [Vercel Connect](#vercel-connect) above for the full setup checklist.
349
362
 
350
363
  > `eve` is an optional peer dependency — install it only when using the `/eve` subpath.
351
364
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@github-tools/sdk",
3
- "version": "1.8.1",
3
+ "version": "1.8.2",
4
4
  "description": "42 typed GitHub tools with presets, human approval, and durable execution — for the AI SDK, eve, Vercel Workflow, and Chat SDK",
5
5
  "author": "HugoRCD <hugo.richard@vercel.com",
6
6
  "repository": {