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

# Overview

> The Stateful Actor API surface — the StatefulActor base class, ActorContext, per-instance storage, the actor binding (ActorNamespace / ActorStub), alarms, configuration, and errors.

<Note>
  The types in this reference are exported from `@telnyx/edge-runtime` (TypeScript).
</Note>

The Stateful Actor surface at a glance — follow a link for the full page:

| Surface                                                                         | Where it lives                    | What it's for                                                                     |
| ------------------------------------------------------------------------------- | --------------------------------- | --------------------------------------------------------------------------------- |
| [`StatefulActor<E>`](/docs/edge-compute/stateful-actors/api-reference/base)     | `@telnyx/edge-runtime`            | Base class you extend. Holds `this.ctx` and `this.env`.                           |
| [`ActorContext`](/docs/edge-compute/stateful-actors/api-reference/context)      | `this.ctx` (runtime-injected)     | Per-instance identity, storage, single alarm, one-shot init.                      |
| [`ActorStorage`](/docs/edge-compute/stateful-actors/api-reference/storage)      | `this.ctx.storage`                | Per-key persistent storage.                                                       |
| [`ActorNamespace`](/docs/edge-compute/stateful-actors/api-reference/namespace)  | `env.<BINDING>`                   | The handle from your function. Returns stubs you call methods on.                 |
| [`ActorStub`](/docs/edge-compute/stateful-actors/api-reference/stub)            | from `idFromName` / `newUniqueId` | Per-name handle; an RPC to one instance.                                          |
| [Alarms](/docs/edge-compute/stateful-actors/alarms)                             | `ctx.storage` + `alarm()`         | Single per-actor alarm; at-least-once delivery.                                   |
| [Configuration](/docs/edge-compute/stateful-actors/api-reference/configuration) | `telnyx.toml` `[[actors]]`        | Declaring the actor binding.                                                      |
| [Errors](/docs/edge-compute/stateful-actors/api-reference/errors)               | `@telnyx/edge-runtime`            | `BlockConcurrencyTimeoutError`, `ActorOutputGateError`, timeout and codec errors. |

## Related Resources

* [Bindings](/docs/edge-compute/runtime/bindings) — how bindings resolve on `env`
* [KV](/docs/edge-compute/kv) — globally distributed key-value storage
* [Execution Model](/docs/edge-compute/runtime/execution-model) — function lifecycle and concurrency