Skip to content

agentRuntime

FieldValue
PrefixagentRuntime
Namespace constantAgentRuntimeNamespace
Subjects constantAgentRuntimeSubjects
Kindbus
Schema recordAgentRuntimeSchemas
Tierframework
Package@makaio/services-core
Defined inpackages/services/core/src/agent-runtime/namespace.ts
KeyWireTypeSchema
completedagentRuntime.completedeventschemas.ts
getagentRuntime.getrpcschemas.ts
killagentRuntime.killrpcschemas.ts
sendagentRuntime.sendrpcschemas.ts
spawnagentRuntime.spawnrpcschemas.ts
spawnedagentRuntime.spawnedeventschemas.ts

Emitted when an agent instance completes or fails.

Subject: agentRuntime.completed Type: Event (fire-and-forget)

FieldTypeRequired
errorstring | undefinedno
instanceIdstringyes
resultstring | undefinedno
successbooleanyes

Get the status of a spawned agent instance.

Subject: agentRuntime.get Type: Request (RPC)

Request:

FieldTypeRequired
instanceIdstringyes

Response:

FieldTypeRequired
displayNamestringyes
errorstring | undefinedno
instanceIdstringyes
kindstringyes
progressstring[] | undefinedno
resultstring | undefinedno
status"completed" | "cancelled" | "failed" | "running" | "waiting_input"yes
subagentIdstringyes

Kill a running agent instance.

Subject: agentRuntime.kill Type: Request (RPC)

Request:

FieldTypeRequired
instanceIdstringyes

Response:

FieldTypeRequired
killedbooleanyes

Send a message to a running agent instance.

Subject: agentRuntime.send Type: Request (RPC)

Request:

FieldTypeRequired
contentstringyes
instanceIdstringyes

Response:

FieldTypeRequired
sentbooleanyes

Spawn an agent from a runtime-compatible selection.

Subject: agentRuntime.spawn Type: Request (RPC)

The host-tier handler resolves the selection (persona → profile → config), creates a subagent via SubagentSubjects.spawn, and returns the instance ID.

Request:

FieldTypeRequired
agent{ [x: string]: unknown; kind: string; providerConfigId?: string | undefined; model?: string | undefined; reasoningEffort?: "none" | "low" | "medium" | "high" | "extra-high" | undefined; cwd?: string | undefined; systemPrompt?: string | { mode: "append"; content: string; } | undefined; allowedTools?: string[] | undefined; disallowedTools?: string[] | undefined; allowedDirectories?: string[] | undefined; } & { [x: string]: unknown; kind: "adapter"; providerConfigId?: string | undefined; model?: string | undefined; reasoningEffort?: "none" | "low" | "medium" | "high" | "extra-high" | undefined; cwd?: string | undefined; systemPrompt?: string | { mode: "append"; content: string; } | undefined; allowedTools?: string[] | undefined; disallowedTools?: string[] | undefined; allowedDirectories?: string[] | undefined; adapterName?: string | undefined; adapterId?: string | undefined; }yes
projectIdstring | undefinedno
promptstringyes
sessionIdstringyes

Response:

FieldTypeRequired
instanceIdstringyes

Emitted when an agent instance is spawned.

Subject: agentRuntime.spawned Type: Event (fire-and-forget)

FieldTypeRequired
displayNamestringyes
instanceIdstringyes
kindstringyes

Auto-generated by yarn docs:bus. Do not edit manually.