docsParity
vercel/ai26,166TypeScript

vs https://ai-sdk.dev/docs/introduction

The documentation provided is a high-level introduction page for the AI SDK and does not contain detailed API reference material. It does not make specific claims about function signatures, export paths, or configuration options that would directly contradict the code API surface. However, the docs do not mention several important exported APIs from the main 'ai' package (gateway, tool utilities, schema helpers, experimental features, etc.), which represents incomplete documentation coverage rather than outright contradictions.

0 high3 medium2 low
Open issue with all findings ↗
12
Files analyzed
110
API symbols
1
Doc pages
44.0s
Analyzed in
34%
API coverage: Poorly documented
37 of 110 exported symbols mentioned in docs
12 source files inspected · claude-haiku-4-5-20251001 · Aug 13, 2026

5 mismatches found

01

Tool and schema utility exports undocumented

packages/ai/src/index.ts

medium
In the code
export { tool } from '@ai-sdk/provider-utils'
export { dynamicTool } from '@ai-sdk/provider-utils'
export { jsonSchema } from '@ai-sdk/provider-utils'
export { zodSchema } from '@ai-sdk/provider-utils'
export { asSchema } from '@ai-sdk/provider-utils'
In the docs
(not documented)

The main AI SDK exports multiple tool and schema utilities (tool, dynamicTool, jsonSchema, zodSchema, asSchema) but these are not mentioned in the introduction documentation, making it unclear to developers that these utilities are available from the main package.

Suggested fix
Document these exported utilities in the AI SDK Core reference section, particularly in the tool calling and structured data generation documentation pages.
02

Gateway API exports undocumented

packages/ai/src/index.ts

medium
In the code
export { createGateway } from '@ai-sdk/gateway'
export { gateway } from '@ai-sdk/gateway'
export { type GatewayModelId } from '@ai-sdk/gateway'
In the docs
(not documented)

The main AI SDK package exports gateway-related APIs (createGateway, gateway, GatewayModelId) from @ai-sdk/gateway, but the introduction documentation does not mention or describe these exports or how to use them.

Suggested fix
Add documentation for the gateway API in the main AI SDK reference, explaining what createGateway does, how to use the gateway export, and what GatewayModelId represents.
03

Experimental tool caller API undocumented

packages/ai/src/index.ts

medium
In the code
export { experimental_toolCaller } from '@ai-sdk/provider-utils'
In the docs
(not documented)

An experimental tool caller function is exported from the main AI SDK package but is not documented anywhere. Developers cannot discover or understand how to use this experimental feature.

Suggested fix
Add documentation for experimental_toolCaller, noting that it is experimental and describing its purpose and usage. Consider adding to an 'Experimental Features' section.
04

ID generator and schema inference utilities undocumented

packages/ai/src/index.ts

low
In the code
export { createIdGenerator } from '@ai-sdk/provider-utils'
export { generateId } from '@ai-sdk/provider-utils'
export { type InferSchema } from '@ai-sdk/provider-utils'
export { type InferToolInput } from '@ai-sdk/provider-utils'
export { type InferToolOutput } from '@ai-sdk/provider-utils'
In the docs
(not documented)

Several utility functions and types for ID generation and type inference are exported but not documented, limiting discoverability of these utilities.

Suggested fix
Document these utilities in the AI SDK Core reference, particularly in tool calling and provider utility sections.
05

Experimental sandbox types undocumented

packages/ai/src/index.ts

low
In the code
export { type Experimental_SandboxSession } from '@ai-sdk/provider-utils'
export { type Experimental_SandboxProcess } from '@ai-sdk/provider-utils'
In the docs
(not documented)

Experimental sandbox-related types are exported from the main package but not documented. These appear to be important experimental APIs that users cannot discover from the documentation.

Suggested fix
Document these experimental types in an experimental features section, explaining what sandboxing capabilities they enable.