Skip to content

feat: add Eve adapter and scaffold CLI#34

Closed
bensabic wants to merge 1 commit into
mainfrom
feat/eve-adapter-and-cli
Closed

feat: add Eve adapter and scaffold CLI#34
bensabic wants to merge 1 commit into
mainfrom
feat/eve-adapter-and-cli

Conversation

@bensabic

Copy link
Copy Markdown
Contributor

Summary

Adds first-class support for the Eve agent framework to @github-tools/sdk, plus docs that feature Eve alongside the Vercel AI SDK.

SDK

  • @github-tools/sdk/eve subpathtoEveTool() adapts any tool from this SDK to Eve's defineTool shape; needsApproval: true maps to Eve's always() predicate, and the adapter accepts Eve predicates (once(), custom) as an override. githubToken() resolves the token from an argument or GITHUB_TOKEN.
  • github-tools eve CLI (npx @github-tools/sdk eve --preset code-review) — scaffolds one-liner Eve tool files into agent/tools/, with --preset, --tools, --all, --dir, --force, and --list flags. Built to dist/cli.mjs (the package bin).
  • New public exports: GITHUB_TOOL_NAMES, GITHUB_WRITE_TOOL_NAMES, PRESET_TOOLS, and the GithubToolName type (extracted to an import-free presets.ts so the CLI bundles without peer deps).
  • eve added as an optional peer dependency; the ai peer range now also accepts v7 canaries (Eve pins one).
  • TSDoc (@param/@returns/@throws/@typeParam/@see) added across the public surface (eve.ts, cli.ts, index.ts, agents.ts, workflow.ts).

Docs

  • New Eve agents guide (/guide/eve): adapter, scaffold CLI, and approval mapping.
  • Featured Eve as a supported integration across the homepage, introduction, installation, quick-start, and the assistant FAQ; broadened the site-wide "for the Vercel AI SDK" messaging to "…and Eve".

Verification

  • pnpm --filter @github-tools/sdk typecheck && lint && build — all pass; .d.mts regenerated.
  • Docs lint + build pass; new internal links resolve.
  • Scaffold CLI smoke-tested: --help/--list/--preset/--tools/--all/--force and error paths (unknown preset/tool/command, nothing-to-scaffold) all behave with correct exit codes.

Includes a changeset (@github-tools/sdk minor).

Add Eve framework support via a new @github-tools/sdk/eve subpath and a
github-tools eve scaffold CLI, plus docs that feature Eve as a first-class
integration alongside the Vercel AI SDK.

- toEveTool() adapter + githubToken() helper
- github-tools eve CLI scaffolds one-liner tool files into agent/tools/
- eve as optional peer dep; ai peer range accepts v7 canaries
- docs: Eve signposting across homepage, intro, installation, quick-start, FAQ
@vercel

vercel Bot commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
github-tools-docs Ready Ready Preview, Comment Jun 16, 2026 3:00pm

@github-actions

Copy link
Copy Markdown
Contributor

Thank you for following the naming conventions! 🙏

@socket-security

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security
Vulnerability Quality Maintenance License
Updatednpm/​nitro@​3.0.260429-beta ⏵ 3.0.260610-beta98 +101008293 +1100

View full report

@bensabic
bensabic requested a review from HugoRCD June 16, 2026 15:07
@HugoRCD

HugoRCD commented Jul 6, 2026

Copy link
Copy Markdown
Member

🖤

@HugoRCD HugoRCD closed this Jul 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants