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

# DynamoDB Storage

> AWS DynamoDB storage driver with on-demand billing

## Setup

```bash theme={null}
npm install @aws-sdk/client-dynamodb
```

```typescript theme={null}
import { DynamoDBStorage } from "@agentium/core";

const storage = new DynamoDBStorage({
  region: "us-east-1",
  tableName: "agentium_kv",
});

// Local development
const storage = new DynamoDBStorage({
  endpoint: "http://localhost:8000",
  region: "local",
});
```

## Configuration

| Option        | Type     | Default         | Description                     |
| ------------- | -------- | --------------- | ------------------------------- |
| `tableName`   | `string` | `"agentium_kv"` | DynamoDB table name             |
| `region`      | `string` | —               | AWS region                      |
| `endpoint`    | `string` | —               | Custom endpoint (for local dev) |
| `credentials` | `object` | —               | AWS credentials override        |

The table is auto-created on first `initialize()` with partition key `namespace` and sort key `key`, using PAY\_PER\_REQUEST billing.