Runtime API

Everything the Agent SDK adds lives on the Agent base class, imported from @telnyx/edge-runtime:

import { Agent } from "@telnyx/edge-runtime";

The surface splits into four areas:

Area	Entry points	Reference
The base class itself	type parameters, hooks, reserved methods	Agent Class
Conversation history	`this.messages.*`	Message Log
Durable timers	`this.queue()`, `this.schedule()`, `this.every()`, `this.cancelSchedule()`, `this.listSchedules()`	Scheduling
Durable state	`this.getState()`, `this.setState()`, `this.replaceState()`	State

Two rules apply across the whole surface:

Every member is protected — this is an inside-the-class API, called from your own methods. It is not part of the RPC surface your subclass exposes to stubs.
alarm() is claimed by the SDK. The task scheduler runs on the actor’s single alarm slot. Do not override alarm() in an Agent subclass — schedule a task instead. (On a plain StatefulActor, alarm() remains yours — see Alarms.)

Everything from StatefulActor is still there — this.ctx, this.env, RPC dispatch, fetch() — see the StatefulActor Runtime API.

⌘I