> ## Documentation Index
> Fetch the complete documentation index at: https://docs.strait.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# SDK Overview
> Official Strait SDKs for TypeScript, Python, Go, Ruby, and Rust — each in its own dedicated repository.
Strait provides official SDKs for **TypeScript**, **Python**, **Go**, **Ruby**, and **Rust**. All five SDKs share the same feature set, configuration model, and API coverage.
The **Python**, **Go**, **Ruby**, **Rust**, and **MCP** SDKs have moved to dedicated repositories. The TypeScript SDK remains in this monorepo.
## Repositories
| SDK | Repository | Install |
| -------------- | ----------------------------------------------------------------------- | ---------------------------------------- |
| **TypeScript** | [strait-dev/strait-ts](https://github.com/strait-dev/strait-ts) | `npm install @strait/ts` |
| **Python** | [strait-dev/strait-python](https://github.com/strait-dev/strait-python) | `pip install strait-python` |
| **Go** | [strait-dev/strait-go](https://github.com/strait-dev/strait-go) | `go get github.com/strait-dev/strait-go` |
| **Ruby** | [strait-dev/strait-ruby](https://github.com/strait-dev/strait-ruby) | `gem install strait` |
| **Rust** | [strait-dev/strait-rust](https://github.com/strait-dev/strait-rust) | `cargo add strait` |
| **MCP** | [strait-dev/mcp](https://github.com/strait-dev/mcp) | See repository README |
## Feature Parity
All five SDKs implement the same capabilities:
| Feature | TypeScript | Python | Go | Ruby | Rust |
| ---------------------------------- | ------------------------------------------- | ---------------------------------------------- | ------------------------------------------- | ----------------------------------------- | ---------------------------------------------- |
| **API operations** (186 endpoints) | `client.jobs.list()` | `client.jobs.list()` | `jobs.List(ctx)` | `jobs.list` | `jobs.list().await` |
| **Config from `strait.json`** | `createClientFromConfigFile()` | `Client.from_file()` | `NewClientFromFile()` | `Client.from_file` | `Client::from_file()` |
| **Config from env vars** | `createClientFromEnv()` | `Client.from_env()` | `NewClientFromEnv()` | `Client.from_env` | `Client::from_env()` |
| **Authoring DSL** | `defineJob()` / `defineWorkflow()` | `define_job()` / `define_workflow()` | `DefineJob()` / `DefineWorkflow()` | `define_job` / `define_workflow` | `define_job()` / `define_workflow()` |
| **Composition helpers** | `withRetry()`, `waitForRun()`, `paginate()` | `with_retry()`, `wait_for_run()`, `paginate()` | `WithRetry()`, `WaitForRun()`, `Paginate()` | `with_retry`, `wait_for_run`, `paginate` | `with_retry()`, `wait_for_run()`, `paginate()` |
| **FSM state machines** | XState v5 actors | `transition_run()` | `CanTransitionRun()` | `can_transition_run?` | `can_transition_run()` |
| **DAG validation** | Kahn's algorithm | Kahn's algorithm | Kahn's algorithm | Kahn's algorithm | Kahn's algorithm |
| **Middleware hooks** | `onRequest` / `onResponse` / `onError` | `on_request` / `on_response` / `on_error` | `OnRequest` / `OnResponse` / `OnError` | `on_request` / `on_response` / `on_error` | `on_request` / `on_response` / `on_error` |
| **Typed errors** | 10 error classes | 10 exception types | 10 error types | 10 error classes | 10 error variants |
| **Custom HTTP client** | Custom `fetch` | `httpx.Client` | `HTTPDoer` interface | `#call` interface | `reqwest::Client` |
## Quick Start
The fastest way to get started is with a `strait.json` config file and the `STRAIT_API_KEY` environment variable.
**1. Set your API key:**
```bash theme={null}
export STRAIT_API_KEY="sk_live_..."
```
**2. Create a client:**
```ts TypeScript theme={null}
import { createClientFromConfigFile } from "@strait/ts/node";
const client = await createClientFromConfigFile();
const jobs = await client.jobs.list({ query: { project_id: "proj_1" } });
```
```python Python theme={null}
from strait import Client
client = Client.from_file()
jobs = client.jobs.list()
```
```go Go theme={null}
import (
strait "github.com/strait-dev/strait-go"
)
client, err := strait.NewClientFromFile(nil)
jobs := operations.NewJobsService(client)
result, err := jobs.List(ctx, nil)
```
## SDK Architecture
Each SDK is organized into the same five layers:
```
+-------------------------------------------+
| Authoring DSL | defineJob() / defineWorkflow()
+-------------------------------------------+
| Composition Helpers | retry, wait, paginate, deploy
+-------------------------------------------+
| Domain Operations (19 services) | jobs, runs, workflows, ...
+-------------------------------------------+
| HTTP Client + Middleware | auth, headers, error mapping
+-------------------------------------------+
| Configuration | strait.json / env vars / inline
+-------------------------------------------+
```
### Domain Operations (19 Services)
All 186 API operations are organized into typed service classes:
| Service | Operations |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `jobs` | list, create, get, update, delete, trigger, bulk\_trigger, clone |
| `runs` | list, get, delete, replay, bulk\_cancel, get\_dlq |
| `workflows` | list, create, get, update, delete, trigger, get\_diff, get\_policy |
| `workflow_runs` | list, get, pause, resume, approve\_step, skip\_step |
| `deployments` | list, create, finalize, promote, rollback |
| `environments` | list, create, get, update, delete |
| `secrets` | list, create, delete |
| `api_keys` | list, create, delete, rotate |
| `webhooks` | list\_subscriptions, create\_subscription, delete\_subscription, list\_deliveries, get\_delivery, retry\_delivery |
| `event_triggers` | list\_events, get\_event, delete\_event, send\_event, send\_prefix, purge\_event, get\_stat |
| `event_sources` | list, get, create, update, delete |
| `batch_operations` | list, get |
| `stats` | list |
| `analytics` | get\_performance |
| `log_drains` | list, create, get, update, delete |
| `sdk_runs` | annotate, checkpoint, complete, continue, fail, heartbeat, log, output, progress, spawn, tool\_call, usage, wait\_for\_event |
| `rbac` | list\_audit\_events, list\_members, create\_member, delete\_member, bulk\_member, list\_roles, create\_role, get\_role, update\_role, delete\_role, list\_resource\_policies, create\_resource\_policy, delete\_resource\_policy, list\_tag\_policies, create\_tag\_policy, delete\_tag\_policy, seed\_roles |
| `job_groups` | list, create, get, update, delete, list\_jobs, pause\_all, resume\_all, get\_stats |
| `health` | list, get\_ready, list\_metrics |
## What's Next?
`strait.json` schema reference, environment variable overrides, and config file discovery.
Effect-first SDK with generated operations, authoring DSL, and XState FSMs.
Now in its own repository at github.com/strait-dev/strait-python.
Now in its own repository at github.com/strait-dev/strait-go.
Now in its own repository at github.com/strait-dev/strait-ruby.
Now in its own repository at github.com/strait-dev/strait-rust.