Versions and availability
The examples use the current Modem SDK interfaces. Install the client and admin SDKs separately; they serve different credentials and workflows. Check your installed package version before copying an example from a newer guide.
| Package | Purpose |
|---|---|
@preternatural-js/client-sdk | Customer identity, sessions, chat, products and usage |
@preternatural-js/admin-sdk | Server-side administration and automation |
@preternatural-js/api-schema | Shared request, response and error schemas |
@preternatural-js/self-hosted-app-server-sdk | Optional server and resumable-stream integrations |
Current-source integrations
Claude subscription relay instructions describe the current source integration. Use the source-build instructions where indicated; those instructions do not establish availability in a hosted deployment or an older installed CLI. See subscription setup and client compatibility.
Other providers’ API-key credentials and subscription credentials are separate integrations. A model available through one does not imply that it is available through the other.
The current-source app-server text response adapter works with AI SDK 6 and 7. The published app-server SDK 9.2.0 uses AI SDK 6’s response-helper signature; use AI SDK 6 with that release, or build the updated app-server SDK before using AI SDK 7. See app-server integration.
Check compatibility
- Use the generated API reference for the exact interfaces documented here.
- Use CLI installation for its distribution and source prerequisites.
- Use model discovery to check the models available to the actual customer or relay.
- Check the gateway protocol matrix before selecting a provider SDK.
When reporting a problem, include the SDK or CLI version, environment, API route and request ID. Exclude tokens, provider credentials and relay keys.