Source: https://docs.cumuluslabs.io/sdk-reference
Content version: f2b3bd11

# Customer SDK reference

Build agents in your application with the Cumulus TypeScript SDK. This reference covers all public exports of SDK 0.3.4: definitions and publication, authenticated customer HTTP handlers, typed API calls, and call/result helpers.

## Choose a language {#languages}

- [Python SDK](/docs/sdk-python): install `cumulus-sdk`, call the customer API and read typed results.
- **TypeScript and JavaScript:** use the module references below for `@cumulus/sdk`. The Python client does not include these authoring and server-helper modules.

## Choose a TypeScript module {#modules}

- [API client](/docs/sdk-reference/client): Make typed requests, stream events and handle API failures.
- [Agent authoring](/docs/sdk-reference/agent): Define graphs, bind customer services and publish reviewed changes.
- [Customer HTTP handlers](/docs/sdk-reference/server): Serve authenticated tools, inbound context and signed events in your backend.
- [Calls and results](/docs/sdk-reference/runtime): Prepare calls, wait for artifacts, page through records and follow events.

## A typical integration {#workflow}

1. Define nodes, tools and a graph with the [agent module](/docs/sdk-reference/agent#defineagent).
2. Bind endpoint URLs and secret references for your environment.
3. [Preview, apply, validate and publish](/docs/sdk-reference/agent#authoring) the graph.
4. Serve the tool implementation using the [server module](/docs/sdk-reference/server#createtoolhandler).
5. [Prepare and place a call](/docs/sdk-reference/runtime#preparecall), then follow its run and results.

Start with [Build an agent](/docs/sdk-tutorial) for a complete application. The [HTTP API reference](/docs/api-reference) documents individual REST operations used by the client.