GILD verdict
Choose the AI SDK for several model providers or streamed web output, and OpenAI's Agents SDK for agents on OpenAI models.
- The workflow
- a TypeScript team choosing the agent library its product calls models through
- The decisive evidence
- Reported3 of 6 named teams adopted one; What teams report below sets out each account.
- ReportedThe aicommits CLI replaced all its custom provider code with AI SDK 5 for its Oct 17, 2025 release, and Helpmaton streams production agents from AWS Lambda through the SDK, per its Feb 13, 2026 post.12
- DocumentedThe Agents SDK reaches other vendors' models through an AI SDK adapter, and an issue of Oct 8, 2026 reports that adapter splitting parallel tool results in a way Gemini rejects.832
- GILD analysisNo named team in GILD's research ran both on the same workload, so the engineering cost of each is unresolved. GILD's calculation from published rates puts 60,000 requests a month at US$1,656 on either, almost all of it model tokens.
- The tradeoff
- The Agents SDK brings handoffs, guardrails, sandboxes and tracing in OpenAI's dashboard. The AI SDK keeps every provider on one code path and ships UI hooks, while the Agents SDK gives OpenAI-first agents handoffs, guardrails and hosted tracing, which organizations under Zero Data Retention cannot use.1214202829
- What would change the call
- The call moves when a named team publishes a production account of the Agents SDK on other vendors' models, or when the adapter's parallel tool call issue closes.
Named teams on the AI SDK cite provider freedom and streaming UI. aicommits replaced all its custom provider code with AI SDK 5, and Helpmaton streams production agents from AWS Lambda through it. Octagon AI built its agent simulations on OpenAI's Agents SDK. The Agents SDK reaches other models through an AI SDK adapter, which an October 2026 issue shows breaking Gemini when tools run in parallel. Both are free, so the bill is the model's, US$1,656 a month for 60,000 requests in GILD's calculation.
What teams report
Failures and incidents 1
EarendilOn AI SDK
Ronacher's team kept only the AI SDK's provider abstractions under its own loop, and Anthropic's web search tool routinely broke the message history through the SDK, for a cause the team had not found by Nov 21, 2025.
“For instance, the web search tool from Anthropic routinely destroys the message history with the Vercel SDK, and we haven’t yet fully figured out the cause.”
Armin Ronacher, Founder, EarendilArmin Ronacher's Thoughts and Writings, , write-up
Switched 2
aicommits (open-source project)On AI SDK
For its 1.0.0 release, aicommits replaced every custom provider integration with AI SDK 5, which made adding AWS Bedrock a short task; Ollama support returned through a community provider (Oct 17, 2025).
“The migration replaced all custom AI provider implementations with AI SDK wrappers, now using generateText and streamText from the ‘ai’ package.”
Luca Becker, Maintainer, aicommits (open-source project)luca-becker.me, , write-up 21st.devOn AI SDK
21st.dev left the AI SDK for a vendor's agent SDK, the Claude Code SDK, to get a complete agent loop, and found it built for one user on a command line, so it built multi-tenant sessions and approval screens itself (Apr 7, 2026).
“…we went through this exact thing. started on vercel ai sdk, migrated to claude code sdk hoping to get the full agent loop out of the box. same conclusion - it's built for single-user cli, not multi-tenant web backends.”
SerafimKorablev, Agent infrastructure builder, 21st.devHacker News, , post
Adopted 3
Octagon AIOn OpenAI Agents SDK
Octagon AI built its open-source MCP server for venture capital agent simulations on OpenAI's Agents SDK, citing agentic workflows out of the box (Apr 26, 2025).
“It’s powered by OpenAI’s new Agents SDK, so you get true agentic workflows out of the box:…”
ag_21, Show HN author for Octagon AI, Octagon AIHacker News, , post HelpmatonOn AI SDK
Helpmaton streams its production agents from AWS Lambda Function URLs through the AI SDK, with credits and validation on the stream endpoints; separately, its REST API and webhooks sit behind API Gateway limits of 100 requests a second on Free and 2,000 on Pro (Feb 13, 2026).
“TL;DR: We kept the same foundation (Lambda Function URLs, AI SDK, Architect) and added production-ready patterns: multi-path streaming with secret-in-path auth, a credit system for cost protection, and subscription-based throttling for our REST API.”
Pedro Teixeira, Builder of Helpmaton, Helpmatonmetaduck.com (Pedro Teixeira), , write-up openstatusOn AI SDK
openstatus runs its production Slack agent on the AI SDK with Claude Sonnet and six tools, and a person confirms every change it drafts (Feb 27, 2026).
“We use the Vercel AI SDK with Claude Sonnet. The agent has 6 tools:…”
Thibault Le Ouay Ducasse, Engineer and author of the post, openstatusopenstatus blog, , write-up
Choosing between AI SDK and OpenAI Agents SDK
Choose AI SDK if
- You call several model providers, or expect to switch. aicommits dropped all its custom provider code for AI SDK 5 and then added AWS Bedrock as a short task (Oct 17, 2025).
- The agent sits inside a web product that needs streaming chat in React, Vue, Svelte, or Angular, as Helpmaton streams from Lambda to useChat (Feb 13, 2026).
- You want a 7.x release line with automated migrations between majors, and no 0.x SDK.
Choose OpenAI Agents SDK if
- You build on OpenAI models and the Responses API and want tracing in OpenAI's dashboard without setup.
- Your design hands work between specialist agents, with input, output, and tool guardrails around them.
- Agents need sandboxed workspaces with shell, file editing, and snapshots, or voice agents on the Realtime API. Test any other vendor's model first, since the AI SDK adapter split parallel tool results in a way Gemini rejects (Oct 8, 2026).
Side by side
| Dimension | AI SDK | OpenAI Agents SDK |
|---|---|---|
| What teams reportNamed accounts only. No team in GILD's research ran both on the same workload. | aicommits replaced all its custom provider code with AI SDK 5 (Oct 17, 2025), Helpmaton streams production agents from Lambda (Feb 13, 2026), and openstatus runs an approval-gated Slack agent (Feb 27, 2026). Earendil's founder found Anthropic's web search tool breaking message history through it (Nov 21, 2025).1234 | Octagon AI built its agent simulations on it for agentic workflows out of the box (Apr 26, 2025). Aurelio Labs used it, LangChain and LangGraph extensively and moved to its own framework (Oct 8, 2025).67 |
| What you pay | Free under the Apache 2.0 license; model tokens billed by each provider, or at provider list price through AI Gateway credits with no markup2425 | Free under the MIT license; model usage is billed on OpenAI's API pricing, or by another provider through the AI SDK adapter1133 |
| 60,000 requests a month, 10 engineersGILD's calculation from published rates, Oct 28, 2026. Inputs: 60,000 requests a month, each with 10,000 input tokens, 7,000 of them read from cache and 1,000 written to it, and 2,000 output tokens; Claude Sonnet 5.5 on the AI SDK side and GPT-6.1 Sol on the Agents SDK side, both at US$2, US$0.10, US$2.50 and US$10 per million; one US$24 DigitalOcean droplet; no high availability, managed database or paid tracing. | US$1,656 a month: US$1,632 of Claude Sonnet 5.5 tokens and US$24 for one 2-vCPU, 4 GiB server that runs the app and its state store. No license fee.101224 | US$1,656 a month: US$1,632 of GPT-6.1 Sol tokens and US$24 for the same server. No license fee.111233 |
| Models | 46 first-party provider integrations and 58 community providers; a plain model string routes through AI Gateway, the default global provider1415 | OpenAI models through the Responses or Chat Completions API by default, with gpt-5.6-luna as the default model; other models through @openai/agents-extensions and AI SDK provider packages. An open issue of Oct 8, 2026 reports the adapter splitting parallel tool results so Gemini rejects the next request82732 |
| Multi-agent design | Subagents called as tools, or a custom orchestrator implementing the Agent interface16 | Handoffs between agents within one run, and agents used as tools29 |
| Safety checks | Tool approvals per tool or by function, HMAC-signed approvals, and timeouts per run, step, chunk, and tool1721 | Input, output, and tool guardrails that run alongside the agent, plus run-wide approval interruptions that resume from saved run state2630 |
| Tracing | OpenTelemetry registered once for every call, Node.js tracing-channel events, and per-step timing, sent to Datadog, Langfuse, Braintrust, Sentry, LangSmith, or any OpenTelemetry backend19 | Built-in tracing, on by default in server runtimes and exported to OpenAI's Traces dashboard; unavailable to organizations under Zero Data Retention28 |
| Workspaces and harnesses | HarnessAgent runs Claude Code, Codex, or Pi in a sandbox; harness packages are experimental18 | Sandbox agents with filesystem workspaces, shell commands, file editing, and snapshots on local, Docker, or hosted clients31 |
| User interface | useChat, useCompletion, and useObject for React, Vue, Svelte, and Angular, plus AI Elements components20 | No UI hooks of its own; the AI SDK extension includes UI stream helpers32 |
| Release cadence | Apache 2.0, version 7.0.153 as of Oct 24, 202623 | MIT, @openai/agents 0.21.0 as of Oct 28, 2026 (released Oct 20), still before 1.034 |
What practitioners report, side by side
Each product's figures come from its own practitioners, for the group you pick.
Overall signal
All practitioners rate AI SDK +36, 53 points above OpenAI Agents SDK at −17. Most of the gap is in complaints, with 21 of OpenAI Agents SDK's 50 sources negative against 5 of AI SDK's 85.
The score counts the authors from all practitioners that take a side, one vote each with their latest view, and is how far positive votes lead negative ones, per 100 votes, so AI SDK's +36 rests on votes split 35 positive, 43 mixed and 5 negative and OpenAI Agents SDK's −17 on 11, 16 and 19.
A lead of a fifth of the votes reads positive and a lead of half strong positive, with the same lines below zero. The dots show each source, positive, mixed, negative. Build one pilot agent to measure the glue code and debugging time the framework adds.
Footprint on the AI Application Platform stack
They differ on four of 9 layers. AI SDK owns one that OpenAI Agents SDK does not. Coverage is each product's placement on this stack, as its product page shows it. Core is a job the product owns; Supports and Touches are jobs it helps with. Coverage says nothing about how well a product does them.
| Layer | AI SDK | OpenAI Agents SDK |
|---|---|---|
| Model | ||
| Model gateway | Supports | Touches |
| Build | ||
| Tool use | Core | Supports |
| Data | ||
| Retrieval | Supports | Touches |
| Operate | ||
| Guardrails | Touches | Supports |
The 5 layers where they match
| Layer | AI SDK | OpenAI Agents SDK |
|---|---|---|
| Model | ||
| Model APIs | Touches | Touches |
| Build | ||
| Orchestration | Core | Core |
| Evaluate | ||
| Evaluation | Touches | Touches |
| Operate | ||
| Observability | Supports | Supports |
| Cloud deployment | Touches | Touches |
What practitioners praise
Among all practitioners, AI SDK alone has four praise themes that reach 5 sources from 3 authors. One API Across Providers and Streaming Chat & Generative UI lead, at 16 of 17 and 10 of 12. A Small Set of Primitives and Agents Built and Shipped reach 5 sources from 3 authors only for OpenAI Agents SDK, at 11 of 11 and 9 of 9. AI SDK needs a pilot on the same agent task before you choose on either.
| Praised for | AI SDK | OpenAI Agents SDK |
|---|---|---|
| One API Across Providers | 16 of 17 | Not a theme in its sources |
| Streaming Chat & Generative UI | 10 of 12 | Not a theme in its sources |
| TypeScript Design & Types | 6 of 10 | Not a theme in its sources |
| Agent Loop, Tools & Approvals | 4 of 12 | Not a theme in its sources |
| A Small Set of Primitives | Not a theme in its sources | 11 of 11 |
| Agents Built and Shipped | Not a theme in its sources | 9 of 9 |
Each count is the sources that praise a theme, or raise it as a concern, out of those that discuss it. A row pairs the two products when both carry a theme under the same or an equivalent name.
A count ending in "so far" has under 5 sources from 3 authors among all practitioners. "Not a theme in its sources" means GILD found no theme of that name in that product's sources.
What practitioners raise as concerns
Among all practitioners, AI SDK alone has five concern themes that reach 5 sources from 3 authors. Provider Translation Bugs and Breaking Changes Between Majors lead, at 14 of 15 and 9 of 9. OpenAI Agents SDK alone has five concern themes that reach 5 sources from 3 authors. Runtime Defects in Production and Latency & Run Overhead lead, at 14 of 14 and 7 of 7.
| Raised as a concern | AI SDK | OpenAI Agents SDK |
|---|---|---|
| Provider Translation Bugs | 14 of 15 | Not a theme in its sources |
| Breaking Changes Between Majors | 9 of 9 | Not a theme in its sources |
| UI Hook Reliability | 8 of 8 | Not a theme in its sources |
| Durability & Production Gaps | 8 of 10 | Not a theme in its sources |
| Memory & Performance | 5 of 5 | Not a theme in its sources |
| Runtime Defects in Production | Not a theme in its sources | 14 of 14 |
| Latency & Run Overhead | Not a theme in its sources | 7 of 7 |
| OpenAI-First Design & Adapter Gaps | Not a theme in its sources | 7 of 8 |
| Hosting & Storage Left to the Team | Not a theme in its sources | 5 of 5 |
| Tracing Defaults & Export Gaps | Not a theme in its sources | 4 of 5 |
35 sources
- Luca Becker: aicommits v1.0.0 and the move to AI SDK 5 (Oct 17, 2025)
- Pedro Teixeira: Real-time AI streaming in production at Helpmaton (Feb 13, 2026)
- openstatus blog: How we built our Slack agent (Feb 27, 2026)
- Armin Ronacher: Agent design is still hard (Nov 21, 2025)
- Hacker News comment from a 21st.dev builder on moving from the AI SDK to the Claude Code SDK (Apr 7, 2026)
- Hacker News: Octagon AI's agent simulations built on the OpenAI Agents SDK (Apr 26, 2025)
- Hacker News comment from Aurelio Labs on leaving LangChain, LangGraph and the OpenAI Agents SDK for its own framework (Oct 8, 2025)
- openai/openai-agents-js issue #2048: the AI SDK adapter splits parallel tool results, which breaks Gemini (Oct 8, 2026)
- r/vercel: Claude Agent SDK vs OpenAI Agent SDK vs Vercel AI SDK (Feb 15, 2026)
- Anthropic: Claude API pricing, as listed on Oct 28, 2026
- OpenAI API docs: Pricing
- DigitalOcean: Droplet pricing, 2 vCPU and 4 GiB at US$24 a month, as listed on Oct 28, 2026
- AI SDK docs: Introduction
- AI SDK providers (46 first-party integrations)
- AI SDK docs: Choosing a provider (AI Gateway as the default global provider)
- AI SDK docs: Agents overview
- AI SDK docs: Tools and tool calling
- AI SDK docs: Harnesses overview
- AI SDK docs: Telemetry
- AI SDK docs: AI SDK UI overview
- Vercel blog: AI SDK 7 (Jun 25, 2026)
- vercel/ai releases on GitHub
- npm registry: the ai package, dist-tags and release times (as of Oct 24, 2026)
- vercel/ai LICENSE (Apache 2.0)
- Vercel docs: AI Gateway pricing
- OpenAI Agents SDK for TypeScript: Overview
- OpenAI Agents SDK for TypeScript: Models
- OpenAI Agents SDK for TypeScript: Tracing
- OpenAI Agents SDK for TypeScript: Handoffs
- OpenAI Agents SDK for TypeScript: Human-in-the-loop
- OpenAI Agents SDK for TypeScript: Sandbox agents
- OpenAI Agents SDK for TypeScript: AI SDK integration
- openai/openai-agents-js on GitHub (MIT license)
- openai/openai-agents-js releases on GitHub
- OpenAI API docs: Agents