SDK versions

Published packages

The OHM Studio SDK is split across three packages on npm. Use the short name in copy and conversation; install using the full name:

Short name	Full npm name	Latest	Status
OHM SDK	`@ohm_studio/sdk`	0.12.0	Stable
OHM RN SDK	`@ohm_studio/sdk-react-native`	0.12.0	Stable
OHM SDK core	`@ohm_studio/sdk-core`	0.10.0	Internal — pulled in by the platform wrappers
OHM Studio CLI	`@ohm_studio/cli`	0.1.0	Beta — codegen for typed `data`

Install

# Web / Node / Next.js
npm install @ohm_studio/sdk

# React Native / Expo
npm install @ohm_studio/sdk-react-native

Versioning policy

We follow Semantic Versioning.
Breaking changes bump the major version. Until v1.0, breaking changes can land on minor with a clear migration note in the Changelog.
Additive features bump the minor version.
Fixes bump the patch version.
All three SDK packages are versioned together — they always share the same 0.X.Y. If you upgrade @ohm_studio/sdk, upgrade the RN package to the same version.

Compatibility

SDK version	Studio API	Foundation Block	Notes
0.12.0	`/api/studio/v1` (hospital-deployed)	`foundation@v3`	Hospital-deployed architecture: `baseUrl` should point at your hospital's API URL (each hospital has its own). All endpoints surface a consistent `usage` block. Vendor-neutral error codes (`ENGINE_VENDOR_UNAVAILABLE`, `ENGINE_RATE_LIMITED`, `ENGINE_TIMEOUT`). Backward-compatible with 0.11.x code.
0.11.1	`/api/studio/v1`	`foundation@v3`	+ `chunked` / `chunkCount` on `JobDetail` + streaming transcript chunk (was only on sync responses in 0.11.0). Server-side: hard LLM timeouts on every Studio service (`insights`, `summarize`, `ai-assist`) for parity with `extract`
0.11.0	`/api/studio/v1`	`foundation@v3`	+ `chunked` / `chunkCount` on `AudioTranscribeResult` / `AudioExtractResult` (server long-audio chunking past 1-hour STT cap), pre-upload 500 MB file-size guard (`OHMValidationError` thrown synchronously), 240-sec hard LLM timeout on `extract`
0.10.0	`/api/studio/v1`	`foundation@v3`	+ `totalTimeoutMs` total-deadline budget, auto-generated `Idempotency-Key` for POST, `withOverrides()`, `warmUp()`, `extractBulk()`, hooks `{ onRequest, onResponse, onError }`, `User-Agent` on Node, `responseHeaders` + `responseBody` on every server-originated error, `jobs.poll` exponential backoff, opt-in `enableHttp2()`
0.9.0	`/api/studio/v1`	`foundation@v3`	+ 4 granular error classes (`OHMTimeoutError`, `OHMNetworkError`, `OHMNotFoundError`, `OHMQuotaExceededError`), `OHM_ERROR_CODES` const, Studio Playground async-job UI
0.8.0	`/api/studio/v1`	`foundation@v3`	+ `ohm.audio.jobs.{create,get,cancel,poll}`, `ohm.audio.extractAsync()`, signed webhook callbacks
0.7.0	`/api/studio/v1`	`foundation@v3`	+ `ohm.apis.get(slug)`, `ohm.invocations.searchByPatient(...)`, `restoreTokens()` PHI helper, RN `OhmQueue`
0.6.0	`/api/studio/v1`	`foundation@v3`	+ AbortSignal, onProgress, apis.list, CLI codegen
0.5.2–0.5.3	`/api/studio/v1`	`foundation@v3`
0.5.0–0.5.1	`/api/studio/v1`	`foundation@v1`
0.4.x	`/api/studio/v1`	`foundation@v1`
0.3.x	`/api/studio/v1`	`foundation@v1`
0.2.x	`/api/studio/v1`	`foundation@v1`

Already-published Studio APIs keep the foundation snapshot they were published with — v3 only applies to new publishes. Republish to pick up the upgrade.

The Studio API is forward-compatible — calls from older SDKs keep working as new fields are added to responses. Breaking server changes will gate behind a new URL prefix (/api/studio/v2) so v0.1 SDKs are never broken silently.

Release cadence

Patch releases — within a few hours of a customer-facing bug report
Minor releases — every 2-4 weeks while we're under v1.0
Major releases — driven by API or schema breaking changes; never surprise

Subscribe to GitHub releases at github.com/open-holistic-medicine/ohm-sdk/releases to get notified.

Need to pin?

npm install @ohm_studio/sdk@0.12.0

Or the React Native flavor:

npm install @ohm_studio/sdk-react-native@0.12.0