> ## Documentation Index
> Fetch the complete documentation index at: https://darwin.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Darwin TypeScript SDK

> Use a typed Darwin client in TypeScript and Node.js applications.

The TypeScript SDK provides a typed client for Darwin's public v2 contract.

```bash theme={null}
npm install @darwinso/sdk
```

Import `DarwinClient` from `@darwinso/sdk` and pass a server-side token. Keep the token outside browser bundles and client-visible configuration.

## Contract and types

Generated request and response types track the schemas shown in the [API Reference](/docs/reference/search). Regenerate rather than hand-editing SDK models when the public contract changes.

[Run the SDK quickstart](/docs/sdks/quickstart).

## Operations

```typescript theme={null}
const found = await darwin.search({ query, limit: 5 });
const action = await darwin.startAction({
  capabilityId: found.results[0].capabilityId,
  capabilityRevision: found.results[0].capabilityRevision,
  requestId: crypto.randomUUID(),
});
const current = await darwin.getAction({ actionId: action.actionId });
```