npm / @ai-sdk/moonshotai

@ai-sdk/moonshotai

What changed in @ai-sdk/moonshotai 0.0 to 3, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.

1 breaking7 new APIs and options5 behavior and defaults14 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@ai-sdk/moonshotai 39 changes

Adds max as a portable reasoning level, widening LanguageModelV4CallOptions['reasoning'] and the derived ReasoningLevel type. Exhaustive switches and mappings must handle it.
3.0.64release notes

Unknown model IDs retain JSON schemas for structured output instead of silently falling back to JSON object mode, supporting future Moonshot models.
0.0.31, 2.0.63, 3.0.68release notes release notes release notes

The User-Agent header now complies with standards.
3.0.60release notes
Fixes streamed tool calls when their IDs are missing, blank, or repeated.
3.0.59release notes
Preserves reasoning streams across empty tool-call deltas.
3.0.49release notes
Preserves documented Moonshot API error codes in HTTP and streaming errors.
0.0.24, 2.0.53, 3.0.41release notes release notes release notes
Preserves complete raw usage objects.
2.0.53, 3.0.41release notes release notes
Prevents negative text output token counts when providers report reasoning tokens by treating Perplexity reasoning tokens separately from completion tokens.
2.0.49, 3.0.38release notes release notes
Fixes handling of empty string tool call IDs.
3.0.36release notes

Strict validation is enabled by default for Moonshot structured outputs.
2.0.51release notes

Adds provider-specific names for Moonshot AI system, user, and assistant messages.
0.0.24, 2.0.53release notes release notes
Adds first-class support for Moonshot V1 auto and vision-preview model IDs while retaining support for custom and retired model IDs.
0.0.24, 2.0.53release notes release notes
Adds Moonshot AI Partial Mode support for continuing a final assistant message.
2.0.53release notes
Adds predicted output support.
2.0.53release notes

Adds support for Kimi K3 dynamic tool-loading system messages.
0.0.24, 2.0.53release notes release notes
Maximum output tokens are sent using the current Moonshot request field.
2.0.51release notes
Official Moonshot V1 models use native JSON Schema structured outputs.
2.0.51release notes

Choice-level usage is preserved in Moonshot streaming responses.
2.0.51release notes
Moonshot streaming tool calls without indices are accepted.
2.0.51release notes
Moonshot structured output schemas are normalized.
2.0.51release notes
Unsupported image and video media types are rejected before Moonshot chat requests are sent.
2.0.51release notes
Non-object root schemas now fail with a clear client-side error instead of Moonshot's opaque 400.
2.0.47release notes
Tool schemas are normalized for Moonshot's MFJS validator: tuple items become prefixItems, and type next to anyOf moves into the branches. The original schema remains in use for AI SDK result validation.
2.0.47release notes

Preserves Moonshot chat response metadata in generated and streamed responses.
0.0.24release notes