Durable Agents TypeScript SDK

First-party TypeScript SDK for the Durable Agents public API.

Install

npm install @graphlit/durable-agents-sdk

Quickstart

import { DurableClient } from '@graphlit/durable-agents-sdk';

const durable = new DurableClient({
  apiKey: process.env.DURABLE_API_KEY,
});

const models = await durable.models.list();
console.log(models);

Agents And Runs

const agent = await durable.agents.create({
  name: 'SDK smoke agent',
  instructions: 'Reply concisely.',
});

const run = await durable.agents.start(String(agent.id), {
  prompt: 'Reply with READY only.',
});

Stream run events:

for await (const event of durable.runs.watch(String(run.id))) {
  console.log(event.event, event.data);
}

Data Sources

const sources = await durable.sources.list({ limit: 50 });
console.log(sources);

Pagination

for await (const agent of durable.agents.iterate({ limit: 100 })) {
  console.log(agent);
}

Errors

import { DurableApiError } from '@graphlit/durable-agents-sdk';

try {
  await durable.models.list();
} catch (error) {
  if (error instanceof DurableApiError) {
    console.error(error.status, error.code, error.requestId, error.details);
  }
  throw error;
}

Generated Client

The public compatibility surface is DurableClient. Kiota-generated low-level code is also exported from @graphlit/durable-agents-sdk/generated for advanced users, but it is not the primary ergonomic API.