What agents should know before contributing
vercel/ai
The AI Toolkit for TypeScript. From the creators of Next.js, the AI SDK is a free open-source library for building AI-powered applications and agents
Read by Bluet from 2 files written for agents and 300 merged pull requests on 2026-09-24. Not reviewed by the maintainers.
Rules its files tell agents (6)
- AGENTS.md
mustNever use JSON.parse directly in production code to prevent security risks.
Never use JSON.parse directly in production code to prevent security risks. Instead use parseJSON or safeParseJSON from @ai-sdk/provider-utils.
- AGENTS.md
mustEvery getFromApi call in this repository must set validateUrl explicitly (the option is optional for backwards…
Every getFromApi call in this repository must set validateUrl explicitly (the option is optional for backwards compatibility with external callers, but omitting it skips validation — never rely on that; the ai-sdk/require-validate-url oxlint rule fails pnpm check otherwise). Use true when the URL comes from a provider response body (image/audio/video download or a polling URL); use false only for URLs built from a configured baseURL.
- CONTRIBUTING.md
shouldYou don't need to create changesets for docs or any of the examples/* packages, as they are not released.
You don't need to create changesets for docs or any of the examples/* packages, as they are not released. But, if you change a README.md, create a changeset so that the package's documentation on npm's website is updated.
- CONTRIBUTING.md
shouldPlease do not use minor or major changesets, we'll let you know when you need to use a different changeset typ…
Please do not use minor or major changesets, we'll let you know when you need to use a different changeset type than patch.
- AGENTS.md
shouldNote: Don't select example packages - they're not published
- AGENTS.md
shouldDo not create flat top-level provider files like src/stream-text/openai.ts
Decisions its pull requests settled (7)
- #20757preserve JSON Schema instead of converting to OpenAPI schema
- #20788remove Chat Completions API
- #20858add experimental evaluation models and shared adapter to openai, google, anthropic
- #20859add experimental evaluation models
- #20863add experimental evaluation models
- #20885add experimental evaluation model support
- #21270clarify ai package resolution in monorepo workspaces