TypeScript SDK

@duraton/sdk is how you author workflows, run them on a runner, and talk to Duraton from app code. Install it and import from the package root:

npm install @duraton/sdk

pnpm add @duraton/sdk

yarn add @duraton/sdk

bun add @duraton/sdk

import {
  workflow,
  connect,
  createClient,
  NonRetriableError,
  RetryAfterError,
  PollTimeoutError,
} from "@duraton/sdk";

Entry points

Every export is reachable from the package root. The scoped entries are subsets, for code that should not pull in the rest.

import { createClient } from "@duraton/sdk/client";   // no workflow authoring, no runner
import { createMemoryCache } from "@duraton/sdk/ai";  // the AI ports and their adapters

Entry	Contains	Use it when
`@duraton/sdk`	Everything below, plus `workflow`, `connect`, `hashStepId`, and the error types.	Authoring workflows and running a runner.
`@duraton/sdk/client`	`createClient`, `DuratonApiError`, and the REST DTOs.	App code that only calls Duraton - an admin tool, a frontend, a script.
`@duraton/sdk/ai`	The `AIProvider` and `AICache` ports, their adapters, and the AI journal types.	Supplying your own model provider or cache store.

The surface

Defining workflows

workflow: name, triggers, retry, flow control.

Steps

The handler context and the durable step API.

connect

Run a runner over an outbound WebSocket - no inbound URL.

REST client

createClient: trigger events, read and control runs.

AI steps

step.ai: durable model calls, agent loops, providers, cache.

Start with code

Agent kit

AI

Durable runs

Integrations

REST API

Protocol

TypeScript SDK

Entry points

The surface

Defining workflows

Steps

connect

REST client

AI steps

​Entry points

​The surface

Defining workflows

Steps

connect

REST client

AI steps

Entry points

The surface