Skip to main content

​
Execution budgets

Do LLM and outbound API work in tasks, not inbound methods — see How Agents Run. Full platform numbers live in the StatefulActor API reference.

​
Task retries

A task that throws retries up to its maxRetries (default 5) with exponential backoff, then is parked — it stops retrying and no longer fires. every() tasks reset their attempt count after each successful run.

​
Storage

Message history and state live in the actor’s durable storage and are subject to its key/value size caps — see the storage reference. Message history is append-only — there is no delete or trim API. last(n) reads a bounded window, but writes accumulate forever. For relational or queryable data, use the actor’s embedded SQL database instead — up to 1 GB per agent.

​
What’s shipped vs. in development

Shipped today:
  • Agent base class with message history, scheduled tasks, and merge-patch state
  • WebSocket termination via webSocket() — see WebSockets
  • BlobStore for blob access within actors
In development:
  • AgentClient browser SDK — browser clients connecting straight to an agent, with automatic reconnect and state sync on top of onStateChanged. onConnect() is the seam it lands on.
The Agent API surface is Beta and may change as pieces land.