AI SDK 7.0.0: what breaks when you upgrade ai from 6.x

AI SDK 7.0.0 removes exports that earlier renames left behind as deprecated aliases, and deletes a long tail of internal types alongside them. Four experimental-prefixed functions, two names v6 already deprecated, and the types for streamText’s finish callbacks are gone or renamed. Anyone importing the old names from ai needs a typecheck to find every site before upgrading. Many more break code whose imports are already correct: four experimental_ option keys on the two generation calls, the two token counts v7 moved under detail objects, the property the response helpers take their stream on, the options object handed to a tool’s execute, and a middleware written against the v3 provider types.

What changed

• Two experimental-prefixed exports are gone outright. experimental_customProvider and experimental_generateImage are no longer published; customProvider and generateImage are the names.
• Two more keep working under the old name, for now. experimental_transcribe and experimental_generateSpeech are still exported in v7, but deprecated: transcribe and generateSpeech are what the documentation uses.
• Two names AI SDK 6.0 deprecated are deleted in v7. ToolCallOptions is gone; ToolExecutionOptions is the type a tool’s execute function receives. isToolOrDynamicToolUIPart is gone; isToolUIPart means what it meant.
• Two more are renamed with the old name kept. stepCountIs is isStepCount now, and CallSettings is LanguageModelCallOptions, which also split request-level options into a separate RequestOptions type.
• streamText’s finish callbacks were retyped and renamed together. StreamTextOnFinishCallback, StreamTextOnStepFinishCallback and TelemetrySettings are no longer exported; onFinish became onEnd and onStepFinish became onStepEnd in the same release. UIMessageStreamOptions and DirectChatTransportOptions gain the same onEnd, and on UIMessageStreamOptions the deprecated onFinish is now typed UIMessageStreamOnEndCallback. DirectChatTransportOptions.agent also takes the new runtime context type parameter, as Agent<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, OUTPUT>.
• Two keys on the telemetry options object stop type checking. metadata and tracer under experimental_telemetry are both gone in v7, which renamed that type from TelemetrySettings to TelemetryOptions. These fire at the call rather than at an import, on generateText, streamText, generateObject, streamObject, embed, embedMany and rerank.
• The experimental_ prefix comes off four options on the generation calls. experimental_activeTools, experimental_output and experimental_context are gone from both generateText and streamText, and experimental_prepareStep from generateText, which is the only one of the two that ever declared it. Three of them simply lose the prefix. experimental_context becomes runtimeContext, and v7 types that value through the call rather than as unknown. experimental_output is gone from generateText’s result as well, where output is the read.
• The two token counts moved under detail objects. usage.reasoningTokens is usage.outputTokenDetails.reasoningTokens now, and usage.cachedInputTokens is usage.inputTokenDetails.cacheReadTokens. Both are matched on the usage and totalUsage of a generateText or streamText result rather than on the property name alone, so a provider’s own usage object beside them is not reported. Tokens written to the cache are a separate count at v7, cacheWriteTokens, which 6.0.282 did not report at all.
• createTextStreamResponse and pipeTextStreamToResponse renamed textStream to stream. The value is the same ReadableStream<string>, and status and response beside it are unchanged.
• generateObject and streamObject no longer take a timeout. v7 takes Omit<RequestOptions, 'timeout'> for those two and no other member of the options intersection declares the name, so the option is gone rather than moved. generateText and streamText keep it, which is why the two object calls are named one at a time.
• Two telemetry values are no longer copied onto each step. functionId and metadata are gone from StepResult. v7’s callId is not the same value: it identifies the generation call the step belongs to rather than carrying your grouping key. A step’s experimental_context is runtimeContext there too, matching the option.
• streamText’s result names its parts stream. The result declares stream at 7.0.0 and marks fullStream deprecated in its favour, with the same TextStreamPart type and the same order. Nothing is removed: fullStream is still declared at 7.0.105. streamObject’s result keeps fullStream with no marker, so a loop over that one is not a finding.
• A tool’s execute requires a context in its options. v7 takes its tool types from @ai-sdk/provider-utils 5.0.0, whose ToolExecutionOptions declares context as required; 6.0.282 took them from 4.0.51, which declared an optional experimental_context and no context. The SDK supplies the options for its own calls, so this lands on tests and wrappers that call execute themselves and build the literal by hand.
• LanguageModelMiddleware is declared against the v4 provider types. v7 aliases it to LanguageModelV4Middleware where v6 aliased LanguageModelV3Middleware. The seven members keep their names, but transformParams, wrapGenerate, wrapStream, overrideProvider, overrideModelId and overrideSupportedUrls now receive and return LanguageModelV4 values. v7 keeps specificationVersion optional and typed as a string on purpose, so a middleware declaring 'v3' still checks; what stops checking is code inside the middleware that names a v3 type or reads a call option or result field v4 no longer carries. EmbeddingModelMiddleware and ImageModelMiddleware move the same way: every hook now receives an EmbeddingModelV4 or ImageModelV4, and specificationVersion is an optional string where v6 required 'v3'.
• Two things late 6.x releases added are not in 7.0.0. The 6.x line kept shipping after 7.0.0, and the entries compare 7.0.0 with 6.0.288. Coming from there, reconnectToStream on ChatTransport, DefaultChatTransport and TextStreamChatTransport no longer receives abortSignal; and Provider.rerankingModel is required again, so a Provider without one stops type checking. ai@7.0.56 restores the first, and AI SDK 7.0.63 makes Provider.rerankingModel optional again.
• A long tail of internal type exports, gone or newly deprecated. Telemetry hooks (TelemetryIntegration, bindTelemetryIntegration, registerTelemetryIntegration), prepareToolsAndToolChoice from ai/internal, the abortSignal option of convertToLanguageModelPrompt in the same module, OutputInterface, and the callback and event types the on*Event naming replaced are removed or marked deprecated. The table below names each one.

Before and after

The clearest deterministic patch is the experimental-prefix rename, on a file that calls four of them and re-exports one under another name:

import {
  experimental_customProvider,
  experimental_generateImage,
  experimental_generateSpeech,
  experimental_transcribe,
} from 'ai';

export const registry = experimental_customProvider({ languageModels: {} });
export const image = () => experimental_generateImage({ model: null as never, prompt: 'a cat' });
export const speech = () => experimental_generateSpeech({ model: null as never, text: 'hello' });
export const text = () => experimental_transcribe({ model: null as never, audio: new Uint8Array() });

export { experimental_transcribe as transcribeAudio };

After npx emendant fix, every import and every reference is renamed, including inside the re-export:

import {
  customProvider,
  generateImage,
  generateSpeech,
  transcribe,
} from 'ai';

export const registry = customProvider({ languageModels: {} });
export const image = () => generateImage({ model: null as never, prompt: 'a cat' });
export const speech = () => generateSpeech({ model: null as never, text: 'hello' });
export const text = () => transcribe({ model: null as never, audio: new Uint8Array() });

export { transcribe as transcribeAudio };

The other four deterministic patches are the same specifier rewrite: ToolCallOptions to ToolExecutionOptions, isToolOrDynamicToolUIPart to isToolUIPart, stepCountIs to isStepCount, and CallSettings to LanguageModelCallOptions.

Fourteen more rename a property rather than an import specifier. One of them rewrites fullStream to stream, and only where the receiver is what streamText returned, so the read on streamObject’s result beside it is left alone:

const result = streamText({ model, prompt: 'hi' });
for await (const part of result.fullStream) console.log(part);
const object = streamObject({ model, prompt: 'hi', schema: undefined as never });
for await (const part of object.fullStream) console.log(part);

After the patch the first loop reads result.stream and the second is unchanged. A pipeThrough or a tee over the same read is the same site and needs no other edit.

The largest group of property renames is the four experimental_ options, reported at the key in the options literal:

return generateText({
  model,
  prompt: 'hi',
  experimental_activeTools: ['weather'],
  experimental_output: undefined,
  experimental_prepareStep: () => undefined,
  experimental_context: { tenant: 'acme' },
});

After the patches, three keys have lost the prefix and the fourth has a new name:

return generateText({
  model,
  prompt: 'hi',
  activeTools: ['weather'],
  output: undefined,
  prepareStep: () => undefined,
  runtimeContext: { tenant: 'acme' },
});

The token counts move a path rather than a name, so usage.reasoningTokens becomes usage.outputTokenDetails.reasoningTokens and usage.cachedInputTokens becomes usage.inputTokenDetails.cacheReadTokens, on the usage and the totalUsage of both results. generateText’s result.experimental_output becomes result.output. The two response helpers take stream where they took textStream, and a shorthand property is rewritten as a pair: createTextStreamResponse({ status: 200, textStream }) becomes createTextStreamResponse({ status: 200, stream: textStream }).

Thirty-eight changes are assisted rather than deterministic, and two of them are worth showing. The first is the streamText callback types. Emendant reports the import of StreamTextOnFinishCallback, StreamTextOnStepFinishCallback or TelemetrySettings, but writing the replacement means typing the callback from the option it fills (onEnd or onStepEnd) rather than from a name that no longer exists, and that needs a named model provider.

The second is the tool options literal, which is reported at the literal rather than at an import, because the key that would be the site is the one that is missing:

await weather.execute({ city: 'Exeter' }, { toolCallId: 'a', messages: [] });

The value to add is the tool’s context, an empty object where the tool declares no contextSchema and otherwise a value of that schema’s type. toolCallId and messages stay as they are. An options object passed by name, or a literal holding a spread, is not reported, since the key may be there at runtime.

The other thirty-six assisted changes are the removed and newly deprecated exports the table names, and the option keys on consumeStream, experimental_generateVideo and the two internal helpers. Use assisted fixes for these sites and check each replacement against the migration guide.

Migration guidance and its limits

Apply the twenty-two deterministic patches. Eight rename an import specifier and fourteen rename a property, which is an option key in a literal or a read on a result. The values either side are unchanged, so the call sites are correct once the name is, with one thing to check after: runtimeContext is typed through the call’s own runtime context parameter where experimental_context was unknown, so a context object that carried no type of its own may now need one.

The forty-seven assisted changes need a model provider named on the command line or in emendant.json. Without one they are reported with their guidance and nothing is sent anywhere. For callbacks, use the type of the option they fill. For tool calls, supply context that matches the tool’s contextSchema. Review the remaining replacements against the release guidance.

Read those patches before applying them. Each patch is limited to the affected file and checked, in a copy of your repository moved to 7.0.0 and put through whichever of your own typecheck and tests it finds there, and a patch that fails is withheld. A repository declaring neither gets its patches graded structurally checked (what each patch grade means), which says the edits applied and the workspace matched again, and that nothing compiled or ran the code. Removed names without a documented replacement, such as OutputInterface and the telemetry hooks, may need developer changes instead of an offered patch.

Seven findings are report only, and each for its own reason. The two telemetry keys are the first: neither has a destination inside the call. A custom Tracer now goes to the OpenTelemetry constructor from @ai-sdk/otel and is registered once with registerTelemetry, which the migration guide places at application startup rather than in the file the finding is in. metadata has no replacement key at all; per-call attributes reach telemetry through includeRuntimeContext and includeToolsContext, which name properties of a runtime context rather than carrying a literal map.

timeout on generateObject and streamObject is report only because there is no option to rename it to. Pass an abortSignal from a timer instead, which both releases accept.

StepResult’s functionId and metadata are report only for the same reason as the telemetry keys: v7 keeps no per-step copy of what you passed in. Read them from the telemetry settings you handed to the call, which still declares both.

LanguageModelMiddleware is report only for a third reason: the edit is inside your middleware’s own body, wherever it names a v3 type or reads a field the v4 call options and results dropped. The finding says a value is built against the type, not which members that value names, which is why its confidence is medium and no patch is offered.

This page needs emendant@0.3.0 or later. Older clients cannot read all the coverage for this release and skip it with a coverage warning. Update the CLI before scanning for this migration.

This release also renamed the system prompt option to instructions, and moved onRerankFinish and onEmbedFinish to onRerankEnd and onEmbedEnd. Neither is a name the table below covers, so nothing here detects them. A clean scan says a file uses none of the constructs below, nothing more.

One measured 6.x to 7.0 migration of a public repository shows the completed migration, the patch Emendant prepared, and the additional developer changes needed to pass the repository checks.

What Emendant detects, fixes and verifies

77 changes in ai 7.0.0. 22 automatic fixes, 48 fixes requiring a model provider you choose, 7 report only. Each patch states which checks passed. Understand patch evidence.

error TS2305: Module '"ai"' has no exported member 'experimental_customProvider'.

error TS2724: '"ai"' has no exported member named 'experimental_generateImage'. Did you mean 'Experimental_GeneratedImage'?

error TS2305: Module '"ai"' has no exported member 'ToolCallOptions'.

error TS2724: '"ai"' has no exported member named 'isToolOrDynamicToolUIPart'. Did you mean 'isDynamicToolUIPart'?

error TS2724: '"ai"' has no exported member named 'StreamTextOnFinishCallback'. Did you mean 'StreamObjectOnFinishCallback'?

error TS2724: '"ai"' has no exported member named 'Experimental_GenerateImageResult'. Did you mean 'Experimental_GeneratedImage'?

error TS2724: '"ai"' has no exported member named 'GenerateTextOnToolCallFinishCallback'. Did you mean 'GenerateTextOnFinishCallback'?

error TS2724: '"ai"' has no exported member named 'GenerateTextOnToolCallStartCallback'. Did you mean 'GenerateTextOnStartCallback'?

error TS2305: Module '"ai"' has no exported member 'OutputInterface'.

error TS2724: '"ai"' has no exported member named 'StreamTextOnStartCallback'. Did you mean 'StreamTextOnErrorCallback'?

error TS2724: '"ai"' has no exported member named 'StreamTextOnStepStartCallback'. Did you mean 'GenerateTextOnStepStartCallback'?

error TS2305: Module '"ai"' has no exported member 'StreamTextOnToolCallFinishCallback'.

error TS2305: Module '"ai"' has no exported member 'StreamTextOnToolCallStartCallback'.

error TS2305: Module '"ai"' has no exported member 'TelemetryIntegration'.

error TS2305: Module '"ai"' has no exported member 'ToolLoopAgentOnFinishCallback'.

error TS2305: Module '"ai"' has no exported member 'ToolLoopAgentOnStepFinishCallback'.

error TS2305: Module '"ai"' has no exported member 'bindTelemetryIntegration'.

error TS2305: Module '"ai"' has no exported member 'registerTelemetryIntegration'.

error TS2724: '"ai/internal"' has no exported member named 'prepareToolsAndToolChoice'. Did you mean 'prepareToolChoice'?

error TS2305: Module '"ai"' has no exported member 'StreamTextEndEvent'.

error TS2724: '"ai"' has no exported member named 'StreamTextOnEndCallback'. Did you mean 'StreamTextOnChunkCallback'?

error TS2305: Module '"ai"' has no exported member 'ToolChoiceViolationError'.

error TS2724: '"ai"' has no exported member named 'UIMessageStreamOutcome'. Did you mean 'UIMessageStreamOptions'?

error TS2305: Module '"ai"' has no exported member 'UIMessageStreamWriterWithOutcome'.

error TS2353: Object literal may only specify known properties, and 'abortSignal' does not exist in type '{ stream: ReadableStream<any>; onError?: ((error: unknown) => void) | undefined; }'.

error TS2353: Object literal may only specify known properties, and 'frameImages' does not exist in type '{ model: VideoModel; prompt: GenerateVideoPrompt; n?: number | undefined; maxVideosPerCall?: number | undefined; aspectRatio?: `${number}:${number}` | undefined; ... 9 more ...; download?: ((options: { ...; }) => Promise<...>) | undefined; }'.

error TS2353: Object literal may only specify known properties, and 'inputReferences' does not exist in type '{ model: VideoModel; prompt: GenerateVideoPrompt; n?: number | undefined; maxVideosPerCall?: number | undefined; aspectRatio?: `${number}:${number}` | undefined; ... 9 more ...; download?: ((options: { ...; }) => Promise<...>) | undefined; }'.

error TS2353: Object literal may only specify known properties, and 'timeout' does not exist in type 'LanguageModelCallOptions'.

error TS2353: Object literal may only specify known properties, and 'additionalRetryableError' does not exist in type '{ maxRetries: number | undefined; abortSignal: AbortSignal | undefined; }'.

error TS2353: Object literal may only specify known properties, and 'metadata' does not exist in type 'TelemetryOptions<Context, NoInfer<ToolSet>>'.

error TS2353: Object literal may only specify known properties, and 'metadata' does not exist in type 'TelemetryOptions<Context, ToolSet>'.

error TS2345: Argument of type '{ toolCallId: string; messages: never[]; }' is not assignable to parameter of type 'ToolExecutionOptions<NoInfer<Context>>'.
  Property 'context' is missing in type '{ toolCallId: string; messages: never[]; }' but required in type 'ToolExecutionOptions<NoInfer<Context>>'.

error TS2345: Argument of type '{ toolCallId: string; messages: never[]; abortSignal: undefined; }' is not assignable to parameter of type 'ToolExecutionOptions<NoInfer<Context>>'.
  Property 'context' is missing in type '{ toolCallId: string; messages: never[]; abortSignal: undefined; }' but required in type 'ToolExecutionOptions<NoInfer<Context>>'.

error TS2339: Property 'experimental_output' does not exist on type 'GenerateTextResult<ToolSet, Context, Output<string, string, any>>'.

error TS2339: Property 'reasoningTokens' does not exist on type 'LanguageModelUsage'.

error TS2339: Property 'cachedInputTokens' does not exist on type 'LanguageModelUsage'.

error TS2353: Object literal may only specify known properties, and 'experimental_activeTools' does not exist in type 'LanguageModelCallOptions & RequestOptions<ToolSet> & { instructions?: Instructions | undefined; system?: Instructions | undefined; allowSystemInMessages?: boolean | undefined; } & { ...; } & { ...; } & { ...; } & { ...; }'.

error TS2353: Object literal may only specify known properties, and 'experimental_activeTools' does not exist in type 'LanguageModelCallOptions & RequestOptions<ToolSet> & { instructions?: Instructions | undefined; system?: Instructions | undefined; allowSystemInMessages?: boolean | undefined; } & { ...; } & { ...; } & { ...; } & { ...; }'.

error TS2353: Object literal may only specify known properties, and 'textStream' does not exist in type 'ResponseInit & { stream: ReadableStream<string>; }'.

error TS2353: Object literal may only specify known properties, and 'textStream' does not exist in type '{ response: ServerResponse<IncomingMessage>; stream: ReadableStream<string>; } & ResponseInit'.

error TS2339: Property 'functionId' does not exist on type 'StepResult<ToolSet, Context>'.

error TS2339: Property 'metadata' does not exist on type 'StepResult<ToolSet, Context>'.

error TS2339: Property 'experimental_context' does not exist on type 'StepResult<ToolSet, Context>'.

error TS2353: Object literal may only specify known properties, and 'abortSignal' does not exist in type '{ prompt: StandardizedPrompt; supportedUrls: Record<string, RegExp[]>; download: DownloadFunction | undefined; provider?: string | undefined; }'.

emendant explain <change-id> prints any row's entry, guidance and sources at the terminal.

The error TS lines are what TypeScript 5.9.3 printed when code that compiled against ai 6.0.309 was compiled against 7.0.0. A row without one is a change the compiler does not report, such as a deprecation or a change in behaviour.

Coverage

Requires emendant@0.3.0 or later. Run emendant feed update to get the latest coverage.

Primary sources

• Migration guidevercel/ai at ai@7.0.0
• package.jsonvercel/ai at ai@7.0.0
• ai@7.0.0npm registry, the published package
• ai@6.0.258npm registry, the published package
• ai@6.0.279npm registry, the published package
• ai@6.0.280npm registry, the published package
• ai@6.0.0npm registry, the published package
• Changelogvercel/ai at ai@7.0.0
• ai@6.0.282npm registry, the published package
• ai@7.0.105npm registry, the published package
• @ai-sdk/provider-utils@5.0.0npm registry, the published package
• @ai-sdk/provider-utils@4.0.51npm registry, the published package
• @ai-sdk/provider@4.0.0npm registry, the published package
• @ai-sdk/provider@3.0.16npm registry, the published package
• ai@6.0.288npm registry, the published package
• ai@6.0.303npm registry, the published package

Scan your repository

Find affected code without editing your files.

npx emendant scan

Then npx emendant fix writes the patches the table says exist. The getting started guide covers the flags and the patch grades.

Related release pages

• Earlier ai release: ai@6.0.312: metadata type changed on TelemetrySettings
• Later ai release: AI SDK 7.0.14: MockTranscriptionModelV4 gains a doStream member

The AI SDK migration guide lists every release page and says which to read for your upgrade.