Skip to content

PURISTA API


PURISTA API / @purista/ai / AgentHandlerContext

Type Alias: AgentHandlerContext<Payload, Parameter, Resources, Models, KnowledgeAliases, AgentInvokes>

AgentHandlerContext<Payload, Parameter, Resources, Models, KnowledgeAliases, AgentInvokes> = object

Defined in: packages/ai/src/runtime/context.ts:625

Type Parameters

Payload

Payload = unknown

Parameter

Parameter = unknown

Resources

Resources extends Record<string, unknown> = Record<string, unknown>

Models

Models extends Record<string, ModelProvider> = Record<string, ModelProvider>

KnowledgeAliases

KnowledgeAliases extends string = never

AgentInvokes

AgentInvokes extends AgentInvokeList = AgentInvokeList

Properties

agents

agents: object

Defined in: packages/ai/src/runtime/context.ts:646

invoke

invoke: AgentInvokes & (options) => Promise<AgentProtocolEnvelope[]>

Invokes another agent via EventBridge and returns its emitted envelopes. Supports both direct options-based calls and typed chained access: context.agents.invoke({ agentName, agentVersion, payload }) and context.agents.invoke.someAgent['1'].call(payload, parameter).

runObject()

runObject<T>(options): Promise<T>

Invokes another agent and parses the final assistant message as JSON.

Type Parameters
T

T = unknown

Parameters
options

AgentInvocationOptions

Returns

Promise<T>

runText()

runText(options): Promise<string>

Invokes another agent and extracts a best-effort assistant text output from message frames.

Parameters
options

AgentInvocationOptions

Returns

Promise<string>


configs

configs: ProtocolContext["configs"]

Defined in: packages/ai/src/runtime/context.ts:680


conversation

conversation: ConversationHelpers

Defined in: packages/ai/src/runtime/context.ts:638


embeddings

embeddings: { [Alias in keyof Models as Models[Alias] extends { embed: (args: any[]) => any } ? Alias : never]: { name: string; embed: any; embedMany?: any } }

Defined in: packages/ai/src/runtime/context.ts:663


emit

emit: ProtocolContext["emit"]

Defined in: packages/ai/src/runtime/context.ts:637


knowledge

knowledge: KnowledgeHelpers<KnowledgeAliases>

Defined in: packages/ai/src/runtime/context.ts:640


logger

logger: Logger

Defined in: packages/ai/src/runtime/context.ts:633


manifest

manifest: AgentManifest

Defined in: packages/ai/src/runtime/context.ts:682


message

message: ProtocolContext["message"]

Defined in: packages/ai/src/runtime/context.ts:636


models

models: Models

Defined in: packages/ai/src/runtime/context.ts:645


parameter

parameter: Parameter

Defined in: packages/ai/src/runtime/context.ts:635


payload

payload: Payload

Defined in: packages/ai/src/runtime/context.ts:634


protocol

protocol: ProtocolEmitter

Defined in: packages/ai/src/runtime/context.ts:642


rerankers

rerankers: { [Alias in keyof Models as Models[Alias] extends { rerank: (args: any[]) => any } ? Alias : never]: { name: string; rerank: any } }

Defined in: packages/ai/src/runtime/context.ts:670


resources

resources: Resources

Defined in: packages/ai/src/runtime/context.ts:644


secrets

secrets: ProtocolContext["secrets"]

Defined in: packages/ai/src/runtime/context.ts:679


serviceContext

serviceContext: ProtocolContext

Defined in: packages/ai/src/runtime/context.ts:678


session

session: SessionHelpers

Defined in: packages/ai/src/runtime/context.ts:639


states

states: ProtocolContext["states"]

Defined in: packages/ai/src/runtime/context.ts:681


stream

stream: AgentStreamEmitter

Defined in: packages/ai/src/runtime/context.ts:641


tools

tools: ToolInvoker

Defined in: packages/ai/src/runtime/context.ts:643