diff --git a/quickstart.mdx b/quickstart.mdx index a8ea2c7..a9a3b4f 100644 --- a/quickstart.mdx +++ b/quickstart.mdx @@ -98,11 +98,11 @@ Saturday publishes SDKs for Python and TypeScript: ```bash Python -pip install saturday +pip install 'saturday>=0.6.0' ``` ```bash TypeScript -npm install @saturdayinc/sdk +npm install '@saturdayinc/sdk@^0.6.0' ``` @@ -148,7 +148,9 @@ console.log(result); Both SDKs default to `https://api.saturday.fit` and accept a base URL override (`base_url` in Python, `baseUrl` in TypeScript) for sandbox work. -The SDKs cover the calculation methods shown here. For activity prescriptions and AI streaming, call the HTTP endpoints directly. +SDK 0.6.0 aligns prescription, batch, import, pagination, and athlete-settings types with the API while preserving raw response objects. Activity calculations return a tiered envelope; stored-prescription reads return `{prescription, safety}`, not the flat nutrition response above. Safety warnings may be `null`. Existing typed callers should read the migration notes in the [TypeScript SDK](https://github.com/SaturdayInc/saturday-node#readme) or [Python SDK](https://github.com/SaturdayInc/saturday-python#readme). + +AI coaching remains [feature-gated](/guides/feature-gates). With `ai_coach` access, use `ai.createConversationStream` / `ai.sendMessageStream` in TypeScript, or the async context-managed `ai.create_conversation_stream` / `ai.send_message_stream` methods in Python. Consume all events, including safety warnings and errors. These writes are never automatically replayed, and a partial stream is not a complete answer. Legacy AI JSON-write methods fail locally with migration guidance; conversation metadata/history reads remain JSON. The SDK READMEs include executable stream examples and cancellation guidance. ## 3. Read the response