AI SDK 7

AI SDK, with over 16 million weekly downloads, is the TypeScript SDK for building AI applications, features, frameworks, and agents across any model provider. It's the same layer, Vercel's open-source agent framework, is built on. eveAI SDK 7 adds production depth for agent work across five areas:Building well-behaved agents requires fine-grained control over model reasoning, tool context, and file handling. Most frontier models support configurable reasoning, but every provider API exposes it differently.

AI SDK 7 standardizes this with a option for and. It maps to provider-native reasoning settings, letting you control reasoning effort in a single line. You can also still fall back to provider options when you need more detailed provider-specific reasoning configuration. reasoninggenerateTextstreamTextLearn more in the. reasoning documentationTools are increasingly developed independently of specific agents or applications. For example, third-party companies offer tools that enable agents to use their APIs.

Therefore, tools require additional inputs that are not generated by LLMs, such as API keys or configuration settings. AI SDK 7 adds a fully typed tool context that can be specified for each tool via a schema. The context is limited to the tool to prevent 3rd-party tools from accessing context they do not need. Learn more about Tool ContextFor more complex agentic loops, you often need variables that you can access and modify in to adjust prompts, model selection, and more.

prepareStepAI SDK 7 introduces a typed runtime context available during step preparation and tool approval functions, with optional telemetry support. This enables you to encapsulate more logic in and share those agents with that internal logic. ToolLoopAgentLearn more about. Runtime ContextMany agent workflows require handling large inputs, such as PDFs, images, datasets, or other artifacts.

Sending those files inline is slow and wasteful, especially for stateless inference, where they get sent over and over again. AI SDK 7 adds a top-level API that lets you upload a file once and then pass a lightweight reference into subsequent model calls. This avoids re-uploading the same bytes repeatedly, making inference faster and saving bandwidth during repeated or multi-step runs. uploadFile can be used with any providers that offer a file uploading endpoint.

The function returns a provider reference object that is portable across providers. uploadFileLearn more about Provider File UploadsSending skills inline on every request to provider-managed container environments has the same overhead problem as sending files inline. AI SDK 7 adds a top-level API that lets you upload a skill once and then use a reference to it in subsequent inference calls. Similar to, the function returns a provider reference object. uploadSkilluploadFileLearn more about.

Provider Skill UploadsMCP has become a common way to connect agents to tools and resources. But not every tool should be model-visible, and some MCP servers need to expose specialized UI alongside their tools. AI SDK 7 adds support for MCP Apps. MCP servers can now separate model-visible tools from app-only tools, preserve app metadata, and render app UIs inside sandboxed iframes. A JSON-RPC bridge connects tools, resources, and display interactions.

This lets you build richer agent experiences where the model can use the tools it needs, while the user sees an app-specific interface for review, configuration, or interaction. Start building your first today. MCP App with AI SDKWhen developing agents, you need to be able to quickly test them without writing a full app. AI SDK 7 adds a terminal UI (TUI) package that lets you run agents with just a few lines of code:The TUI is interactive, supports reasoning and tools, and renders markdown as formatted text.

Learn more about. creating your own terminal agentAs agents become more autonomous and longer running, the need for approvals, durability, sandboxing, and robustness increases. AI SDK 7 supports agent-level tool approvals that can be automatic or involve a human in the loop, with these approval types:Tool approvals are defined on,, and, because the usage scenario of a particular tool drives the need for approvals.

ToolLoopAgentgenerateTextstreamTextFor higher-risk workflows, AI SDK 7 introduces opt-in HMAC-signed tool approvals to prevent forged approvals. The SDK also hardens replay behavior by revalidating tool inputs and policies before continuing execution. See. how tool approvals workWhen an agent run spans multiple steps or waits for a human approval, a process restart or deployment in the middle of that run means starting over.

AI SDK 7 introduces and for durable, resumable agent execution that survives process restarts, deploys, interruptions, and delayed approvals. @ai-sdk/workflowWorkflowAgent supports workflow-based streaming, tools, approvals, callbacks,, and provider model serialization across workflow step boundaries. It also supports typed runtime context for shared agent state and stable telemetry.

WorkflowAgentprepareCallCallbacks now include richer execution data such as step numbers, previous results, duration, and success or failure information. Invalid tool calls are preserved without executing invalid tools, and tool conversion can preserve raw outputs for UI and callbacks. toModelOutputLearn how to.