All notable changes to this package are documented in this file. The format follows Keep a Changelog, and versions follow Semantic Versioning.
Compatibility promise: the public API is additive-only. Anything public is deprecated before it is removed, and every pull request is compared with the latest release by swift package diagnose-api-breaking-changes in CI. See the API stability section of CONTRIBUTING.md.
- CI: an API Breakage workflow fails a pull request that changes the public API compared with the latest release tag. Consciously accepted breaks are listed in
.github/api-breakage-allowlist.txtwith a matching changelog entry. - CI: the Swift Build workflow now builds and tests on Linux with Swift 5.10, 6.0 and 6.3 containers, tests on macOS and the iOS Simulator, and builds for tvOS, watchOS and visionOS with Xcode. Tests written with Swift Testing only exist on toolchains that ship it (Swift 6); the XCTest suite runs everywhere.
- CONTRIBUTING.md: API stability policy, including how new endpoint groups are added as namespaces and how generated
Components.Schemastypes are treated. - This changelog.
- Build warning in
ModelResponseEventsStreamInterpreterwhen logging a failed stream event decode in debug builds. - The test target compiles for the package's minimum iOS deployment target again; it used
Regex, which requires iOS 16. - Building on Linux with Swift 5.10 works again. swift-corelibs-foundation gained the async
URLSessionAPIs only in Swift 6, so the async client now bridges the completion-handler API on older Linux toolchains.
0.5.1 - 2026-07-21
refusalfield on the streaming chat completion delta (#408).reasoningContenton assistant chat messages for providers that return reasoning (#402).annotationsonChatStreamResult(#399).
- Regenerated
Components.Schemasfrom the updated OpenAPI spec (#433). This changed public generated types: transcription segment and word timestamps moved fromFloattoDouble,ImageGenTool.SizePayloadlost its fixed cases,responseIdwas removed from the response audio events, andChatResult.Choice.Message.Annotationmoved to a top-levelAnnotationtype. TwoChatCompletionMessageParaminitializers were removed. - swift-openapi-runtime 1.11.0 → 1.12.0 (#424).
0.5.0 - 2026-06-05
modelis optional inCreateModelResponseQueryfor the stored-prompt (prompt_id) flow (#419).
- Regenerated
Components.Schemasfrom the fresh OpenAPI spec (#423); the release notes flagged possible breaking changes. - swift-openapi-runtime 1.8.2 → 1.11.0 (#416).
- Missing
namefield onResponseFunctionCallArgumentsDoneEvent(#420).
0.4.9 - 2026-04-30
completion_tokens_detailsonCompletionUsage(#411).prompt_cache_keyonCreateModelResponseQuery(#412).- Dependabot configuration for GitHub Actions and Swift dependencies (#414).
ChoiceDeltaToolCall.indexis required again (#388).ChatQuerydescription output is easier to read (#394).- Documentation:
response_formatversustextfor structured outputs (#413); security policy points to the private reporting channel (#410).
Older releases are documented on the GitHub Releases page.