bodhi-realtime-agent / AgentContext
Interface: AgentContext
Defined in: types/agent.ts:12
Runtime context passed to agent lifecycle hooks (onEnter, onExit, onTurnCompleted). Provides read access to session state and the ability to inject messages.
Properties
agentName
agentName:
string
Defined in: types/agent.ts:16
Name of the agent receiving this context.
sessionId
sessionId:
string
Defined in: types/agent.ts:14
Current session identifier.
Methods
getMemoryFacts()
getMemoryFacts():
MemoryFact[]
Defined in: types/agent.ts:22
Retrieve all memory facts currently stored for this user.
Returns
getRecentTurns()
getRecentTurns(
count?):ConversationItem[]
Defined in: types/agent.ts:20
Retrieve the most recent conversation turns (default 10).
Parameters
count?
number
Returns
injectSystemMessage()
injectSystemMessage(
text):void
Defined in: types/agent.ts:18
Inject a system-level message into the conversation (visible to the model on next turn).
Parameters
text
string
Returns
void
requestTransfer()
requestTransfer(
toAgent):void
Defined in: types/agent.ts:24
Request an asynchronous transfer to another agent (fires on next tick to avoid re-entrancy).
Parameters
toAgent
string
Returns
void
sendAudioToClient()?
optionalsendAudioToClient(data):void
Defined in: types/agent.ts:31
Send raw PCM audio to the connected client as a binary frame.
Parameters
data
Buffer
Returns
void
sendJsonToClient()
sendJsonToClient(
message):void
Defined in: types/agent.ts:29
Send a JSON message to the connected client.
Parameters
message
Record<string, unknown>
Returns
void
setExternalAudioHandler()?
optionalsetExternalAudioHandler(handler):void
Defined in: types/agent.ts:33
Register/unregister an external audio handler for client mic frames.
Parameters
handler
(data) => void | null
Returns
void
stopBufferingAndDrain()
stopBufferingAndDrain(
handler):void
Defined in: types/agent.ts:27
Stop buffering client audio and drain buffered chunks through the handler. Used by external audio agents (e.g., Twilio) to flush audio accumulated during the dial gap.
Parameters
handler
(chunk) => void
Returns
void