Durable Objects
Durable Objects provide persistent state for edge-deployed agents. Each agent instance gets its own isolated storage that persists across requests.
What Are Durable Objects?
Cloudflare Durable Objects are:
- Stateful — maintain state between requests
- Consistent — strong consistency guarantees
- Global — automatically placed near users
- Isolated — each instance is independent
How Nexus OS Uses Them
When you deploy an agent to the edge, Nexus OS automatically creates a Durable Object namespace for it:
Agent (WASM) → Cloudflare Worker → Durable Object (state)
The agent can read and write state that persists across invocations:
Request 1: agent processes task, saves state
Request 2: agent reads previous state, continues work
Enabling Durable Objects
edge:
provider: cloudflare
durableObjects: true
State API
Edge-deployed agents can use these state functions:
| Function | Description |
|---|---|
state_get(key) |
Read a value from persistent storage |
state_put(key, value) |
Write a value to persistent storage |
state_delete(key) |
Delete a value from storage |
state_list(prefix) |
List keys with a given prefix |
Limitations
| Limit | Value |
|---|---|
| Storage per object | 256KB (free) / 10GB (paid) |
| Request duration | 30 seconds |
| Concurrent requests | Serialized per object |
| Objects per namespace | Unlimited |