@ai-sdk/provider
4.0.31 · 20 Oct 2026Apache-2.041.8M / weekRepositoryHomepagenpmAtom feed
101 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 4.x · latest line
4.0.29
16 Oct 20260957554: Add
boxdecision question type with image bounds for TypeSafe AI.
4.0.28
15 Oct 2026130e871: Restore raw OpenAI custom-tool input deltas for consumers that forward them to Responses API clients. Mark streamed input with
inputEncoding: 'text'so UI clients can display it progressively without JSON parsing. Preserve the encoding when partial UI messages are saved and resumed. Final provider tool-call inputs remain JSON-encoded.
4.0.27
12 Oct 2026e57803c: Add an optional shared citation representation to generated text and text-end stream events, separate from retrieved sources. Preserve citations in core result content and UI message text parts, including validation and persistence, without changing content or stream event discriminants.
4.0.25
8 Oct 20269184a35: Add ordered text, file, and JSON parts to experimental decision state. Support image input in OpenAI Decisions and language model adapters. Gateway retains its existing string and JSON request format and rejects files, as does TypeSafe AI.
Arrays passed directly as state now contain decision state parts. Wrap JSON arrays in an object or a json part.
Normalize all public state forms into an array of parts before calling decision providers. Providers receive text and JSON objects as text and json parts.
Serialize decision file bytes as base64 in OpenTelemetry state attributes. Model-call spans record normalized state parts, while outer spans retain public state inputs.
Preserve native JSON state in TypeSafe AI when state contains one JSON part. Label shared state in language-model decision prompts.
4.0.23
6 Oct 2026268225c: feat(provider): add a portable
maxreasoning level with native provider mappings, compatibility coercions, and budget-based fallback support.Compatibility notes:
Release classification: This remains a patch changeset under the repository's explicit release policy, which uses patch releases for both fixes and features. The TypeScript source-compatibility caveat for exhaustive consumers is disclosed above. Maintainers can override this classification with a
majorlabel if they decide to align the provider-spec addition with a future AI SDK major release.
4.0.19
28 Sep 2026525efc5: feat(provider): advertise image model file and mask input support
Use confirmed model IDs for capability declarations so unrecognized model names remain unknown. Include Together AI FLUX.2 Pro and Flex single-image editing, and allow asynchronous capability lookups and middleware overrides to resolve to unknown.
Advertise QuiverAI Arrow 2 and Arrow 2 Telos file-input support, and mark Together AI Gemini image inputs unsupported by the current single-image request mapping.
4.0.17
16 Sep 2026a7dd893: Add experimental evaluation model aliases and registry resolution.
customProvideracceptsevaluationModels, registries exposeevaluationModel, andexperimental_evaluateaccepts string IDs when an evaluation-capable default provider is explicitly configured. Evaluation never implicitly falls back to Gateway. Model-resolution errors now identifyevaluationModelwhile stable provider contracts remain unchanged.
4.0.16
16 Sep 2026d06bb2a: Allow readonly arrays and objects containing them to be used as JSON values.
123d71f: Add
experimental_evaluateand the isolated experimental v4 evaluation model specification for Choice, Score, and Boolean questions against shared state. Includes typed answers, optional Choice/Score distributions, required Boolean probabilities, validation, retries, cancellation, andExperimental_EvaluationUnsupportedQuestionTypeErrorfor unsupported questions.
4.0.15
15 Sep 20265c0054d: Add optional browser-direct WebRTC for experimental client-delegated Live conversations alongside the existing WebSocket path. Exchange SDP through an application endpoint with
api.session, configure server-owned data-channel permissions, and preserve committed React session ownership. Capture follows the selected sender track, borrowed tracks remain caller-owned, and disconnect recovery and finalization stay bounded. Applications continue to handle client delegation and submit context; Live session updates and Responses delegation remain unsupported.Serialize microphone sender changes and close the peer if detachment fails, without stopping borrowed tracks. Validate nonempty SDP setup answers with a bounded response body, and document the same-origin broker authentication contract.
39535af: Add experimental OpenAI Live provider support through the unified
openai.experimental_realtimefactory for server WebSocket sessions with client delegation. Applications own their agents and tools, receive continuous audio/transcript events and delegation metadata, and return context through validated channels. Support immutable startup options, microphone mute controls, graceful session close, and cumulative voice usage. Responses delegation and Live session updates reject before sending.Route known Live model IDs to Live, allow an OpenAI-specific
apioverride for early-access models, and preserve legacy Realtime defaults for unknown IDs. Token minting follows the same selection rules and rejects Live before requesting unsupported credentials. Extend the realtime v4 specification with optional server WebSocket configuration, per-connection raw-event parsers, and model-wide startup/finalization capabilities. This provider layer supplies connection settings and protocol mapping for server adapters; browser lifecycle and UI integration belong to the core runtime and framework hooks.Preserve Realtime client event IDs for session updates and audio appends, and correlate server errors with the originating client event.
4.0.13
9 Sep 20269942196: feat: add batch cancel and list APIs
4.0.10
1 Sep 20265190b67: feat(provider): extend the FilesV4 interface with optional
getFileMetadata,downloadFile(streaming), anddeleteFileoperations, plusabortSignal/headerscall options and a{ type: 'stream' }upload data variant; upload results now exposebyteSize,createdAt, andexpiresAt(also surfaced by the coreuploadFile()helper, which now forwardsabortSignal/headers); addpostMultipartStreamToApi(streaming multipart uploads with deterministic part ordering and failure-path stream teardown),deleteFromApi, andcreateBinaryStreamResponseHandlerto provider-utils
4.0.8
25 Aug 2026591d25b: feat: add batch completion webhooks.
experimental_startTextBatchaccepts awebhookUrl, and the gateway provider registers it through the batchcallbackUrlcontract and exports typed async-job metadata. Direct Anthropic and OpenAI batch providers return an unsupported warning when the option is provided.
4.0.7
7 Aug 2026ad6a650: feat(video): allow
aspectRatio: 'adaptive'ongenerateVideoSome video models derive the output ratio from the input and reject explicit
{width}:{height}values — BytePlus Seedance 2.5 does this for first-frame, first-and-last-frame, editing, and extension tasks.aspectRatioonVideoModelV3CallOptions,VideoModelV4CallOptions, andexperimental_generateVideois now`${number}:${number}` | 'adaptive', so those calls no longer need a type assertion. Support is provider-specific.
4.0.5
3 Aug 202679e133c: async APIs for generateVideo (poll, webhook)
Adds an asynchronous start/status flow to the experimental video model interface (
VideoModelV4): models may now implementdoStart,doStatus, andhandleWebhookOptioninstead of (or in addition to)doGenerate, andexperimental_generateVideoacceptspollandwebhookoptions to orchestrate completion via polling or webhooks. Polling configuration can use a custom delay implementation for durable workflow compatibility.
4.0.3
9 Jul 2026Reading the note…
4.0.2
2 Jul 2026Reading the note…
4.0.1
30 Jun 2026Reading the note…
4.0.0
25 Jun 2026Reading the note…
- 3.x
3.0.19
15 Oct 2026739e9f6: Restore raw OpenAI custom-tool input deltas for consumers that forward them to Responses API clients. Mark streamed input with
inputEncoding: 'text'so UI clients can display it progressively without JSON parsing. Preserve the encoding when partial UI messages are saved and resumed. Final provider tool-call inputs remain JSON-encoded.
3.0.15 – 3.0.184 releases without a noteShow each
- 3.0.1827 Sep 2026no note
- 3.0.1723 Sep 2026no note
- 3.0.169 Sep 2026no note
- 3.0.1511 Aug 2026no note
3.0.14
9 Jul 2026Reading the note…
3.0.13
30 Jun 2026Reading the note…
3.0.12
26 Jun 2026Reading the note…
3.0.11
25 Jun 2026Reading the note…
3.0.10
30 Apr 2026Reading the note…
3.0.9
29 Apr 2026Reading the note…
3.0.8
6 Feb 2026Reading the note…
3.0.7
1 Feb 2026Reading the note…
3.0.6
29 Jan 2026Reading the note…
3.0.5
22 Jan 2026Reading the note…
3.0.4
16 Jan 2026Reading the note…
3.0.3
14 Jan 2026Reading the note…
3.0.2
6 Jan 2026Reading the note…