agentRuntime
agentRuntime
Section titled “agentRuntime”| Field | Value |
|---|---|
| Prefix | agentRuntime |
| Namespace constant | AgentRuntimeNamespace |
| Subjects constant | AgentRuntimeSubjects |
| Kind | bus |
| Schema record | AgentRuntimeSchemas |
| Tier | framework |
| Package | @makaio/services-core |
| Defined in | packages/services/core/src/agent-runtime/namespace.ts |
Subjects
Section titled “Subjects”| Key | Wire | Type | Schema |
|---|---|---|---|
completed | agentRuntime.completed | event | schemas.ts |
get | agentRuntime.get | rpc | schemas.ts |
kill | agentRuntime.kill | rpc | schemas.ts |
send | agentRuntime.send | rpc | schemas.ts |
spawn | agentRuntime.spawn | rpc | schemas.ts |
spawned | agentRuntime.spawned | event | schemas.ts |
Subject Details
Section titled “Subject Details”agentRuntime.completed (event)
Section titled “agentRuntime.completed (event)”Emitted when an agent instance completes or fails.
Subject: agentRuntime.completed
Type: Event (fire-and-forget)
| Field | Type | Required |
|---|---|---|
error | string | undefined | no |
instanceId | string | yes |
result | string | undefined | no |
success | boolean | yes |
agentRuntime.get (rpc)
Section titled “agentRuntime.get (rpc)”Get the status of a spawned agent instance.
Subject: agentRuntime.get
Type: Request (RPC)
Request:
| Field | Type | Required |
|---|---|---|
instanceId | string | yes |
Response:
| Field | Type | Required |
|---|---|---|
displayName | string | yes |
error | string | undefined | no |
instanceId | string | yes |
kind | string | yes |
progress | string[] | undefined | no |
result | string | undefined | no |
status | "completed" | "cancelled" | "failed" | "running" | "waiting_input" | yes |
subagentId | string | yes |
agentRuntime.kill (rpc)
Section titled “agentRuntime.kill (rpc)”Kill a running agent instance.
Subject: agentRuntime.kill
Type: Request (RPC)
Request:
| Field | Type | Required |
|---|---|---|
instanceId | string | yes |
Response:
| Field | Type | Required |
|---|---|---|
killed | boolean | yes |
agentRuntime.send (rpc)
Section titled “agentRuntime.send (rpc)”Send a message to a running agent instance.
Subject: agentRuntime.send
Type: Request (RPC)
Request:
| Field | Type | Required |
|---|---|---|
content | string | yes |
instanceId | string | yes |
Response:
| Field | Type | Required |
|---|---|---|
sent | boolean | yes |
agentRuntime.spawn (rpc)
Section titled “agentRuntime.spawn (rpc)”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:
| Field | Type | Required |
|---|---|---|
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 |
projectId | string | undefined | no |
prompt | string | yes |
sessionId | string | yes |
Response:
| Field | Type | Required |
|---|---|---|
instanceId | string | yes |
agentRuntime.spawned (event)
Section titled “agentRuntime.spawned (event)”Emitted when an agent instance is spawned.
Subject: agentRuntime.spawned
Type: Event (fire-and-forget)
| Field | Type | Required |
|---|---|---|
displayName | string | yes |
instanceId | string | yes |
kind | string | yes |
Auto-generated by yarn docs:bus. Do not edit manually.