Skip to content

Backport tracking: bug fixes and docs improvements from main (v7) not yet on release-v6.0 #16767

Description

@gr2m

Goal

Track backporting of bug fixes and documentation improvements that were merged into main (AI SDK 7) but are not yet on release-v6.0 (AI SDK 6).

Method: Compared all 375 fix/docs commits on main since the branches diverged (b145dce, 2026-03-05) against release-v6.0 (matching backport commit titles and PR references), then assessed each remaining candidate's applicability by reading the diff and checking whether the affected code/docs — and the bug — exist on release-v6.0.

Snapshot (2026-07-06): 158 already backported · 4 in-flight · 213 candidates assessed below.

✅ Recommended for backport

These fix problems that exist on release-v6.0 and apply without v7-only dependencies.

Bug fixes

Docs (version-agnostic)

🤔 Maybe — applicable but lower value or needs a closer look

Bug fixes (10)
Docs (13)
  • #null — docs(contributing): add npm dist-tag step to pre-release cycle guide — Version-agnostic contributor doc (npm dist-tag step in pre-release-cycle.md, which exists on v6 without it), but low value since pre-release cycles are run from main.
  • docs: mention isLoopFinished() stop condition in context of agent loops #14539 — docs: document isLoopFinished() stop condition for agent loops — Only the ToolLoopAgent stopWhen reference hunk applies to v6 (its description lacks the isLoopFinished mention), and it needs adaptation (stepCountIs naming, non-/v7/ docs link); the workflow-agent files do not exist on v6.
  • docs(contributing): publishing new packages #14814 — docs(contributing): publishing new packages — Provenance/package-bootstrapping documentation in contributing/ is version-agnostic and releases also run from the v6 branch, but it is internal non-deployed contributor docs of modest value.
  • docs: tool types #14946 — docs: tool types — The function/dynamic tool taxonomy rewrite conceptually applies to v6 (dynamicTool exists there and v6 still says 'three types of tools'), but the commit also changes provider-utils JSDoc code and needs wording review for v7-isms.
  • docs: Improve prepareStep messages documentation #15111 — docs: Improve prepareStep messages documentation — prepareStep messages and pruneMessages exist on v6, but the new compaction guide and rewritten sections use v7 API names (e.g. isStepCount vs v6's stepCountIs) and only some hunks apply.
  • docs(contributing): publishConfig and repository keys are not needed #15524 — docs(contributing): publishConfig and repository keys are not needed — Fixes the package-bootstrap template in contributing/releases.md, but the section it edits was added by docs(contributing): publishing new packages #14814 and does not exist on v6; only applicable if docs(contributing): publishing new packages #14814 is backported, and it is internal contributor docs.
  • docs(examples): update examples/ai-functions/.env.example #15549 — docs(examples): update examples/ai-functions/.env.example — The rewritten .env.example is generated from main's provider set and is not deployed docs; a v6 backport would need regeneration against v6's providers rather than a cherry-pick.
  • docs(examples): bump @angular/* to patched 20.3.25 #16150 — docs(examples): bump @angular/* to patched 20.3.25 — Security patch bump for the angular example is version-agnostic, but v6 pins ^20.3.2 (caret already allows 20.3.25) and the large pnpm-lock diff would not cherry-pick; would need a fresh bump on v6 if desired.
  • docs(skill): add warning about version mismatch #16391 — docs(skill): add warning about version mismatch — Both files exist on v6 and a skill/SDK version-mismatch warning is useful there too, but the added text says 'AI SDK 7' and would need adaptation; internal skill/contributing docs, not deployed.
  • docs(examples/node-http-server): improve example documentation #16388 — docs(examples/node-http-server): improve example documentation — The improved README applies verbatim (the v6 example has the same server with /stream-data and the same outdated README), but it is an example README, not deployed versioned docs, so the value is low.
  • docs(contributing): clarify when to make changeset #16416 — docs(contributing): clarify when to make changeset — Version-agnostic CONTRIBUTING.md changeset clarification that applies to the v6 branch too, but it is non-deployed contributor docs and low value (and carries a 'behaivor' typo).
  • docs(openai): update token usage docs #16528 — docs(openai): update token usage docs — v6 openai docs have the same stale guidance (providerMetadata.openai.reasoningTokens/cachedPromptTokens are not populated by the v6 provider either), but the corrected property paths differ on v6 (usage.outputTokens.reasoning, usage.inputTokens.cacheRead), so the fix needs adaptation rather than a cherry-pick.
  • docs(skill): remove version specific info from use-ai-sdk skill #16557 — docs(skill): remove version specific info from use-ai-sdk skill — Evergreen rewrite of the use-ai-sdk skill would fix the same version-drift problem in the v6 skill, but skills are repo tooling (not deployed versioned docs) and the v6 skill's version-specific references would need separate removal.

🚫 Assessed as not applicable to v6

Mostly fixes for v7-only code or bugs introduced on main after the branch point. Listed for completeness — no action needed unless the assessment is wrong.

Bug fixes (110)
Docs (50)

🚧 In-flight — open backport PRs against release-v6.0


Assessments were made by inspecting each commit's diff against release-v6.0; individual verdicts may need human review.

Metadata

Metadata

Assignees

Labels

backportAdmins only: add this label to a pull request in order to backport it to the prior versiontask-identify-issue-type-donetype:epicAdmins only: assign to issues with sub issues that are batches of tasks

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions