storage:agent

storage:agent

Field	Value
Prefix	storage:agent
Namespace constant	AgentStorageNamespace
Subjects constant	AgentStorageSubjects
Kind	storage
Schema record	<inline>
Tier	framework
Package	@makaio/services-core
Defined in	packages/services/core/src/session/storage/agent-namespace.ts

Subjects

Key	Wire	Type	Schema
delete	storage:agent.delete	rpc	—
get	storage:agent.get	rpc	—
listByAdapter	storage:agent.listByAdapter	rpc	—
listBySession	storage:agent.listBySession	rpc	—
set	storage:agent.set	rpc	—
updateActivity	storage:agent.updateActivity	rpc	—
updateRuntime	storage:agent.updateRuntime	rpc	—
updateStatus	storage:agent.updateStatus	rpc	—

Subject Details

storage:agent.delete (rpc)

Delete an agent by ID.

Subject: storage:agent.delete Type: Request (RPC)

Request:

Field	Type	Required
agentId	string	yes

Response:

Field	Type	Required
success	boolean	yes

storage:agent.get (rpc)

Get an agent by ID.

Subject: storage:agent.get Type: Request (RPC)

Request:

Field	Type	Required
agentId	string	yes

Response:

Field	Type	Required
agent	{ agentId: string; adapterId: string; adapterName: string; sessionId: string; role: "lead" | "member"; status: "active" | "idle" | "dead" | "disposed"; createdAt: number; lastActivityAt: number; adapterSessionId?: string | undefined; model?: string | undefined; cwd?: string | undefined; providerConfigId?: string | undefined; personaId?: string | undefined; profileId?: string | undefined; harnessId?: string | undefined; clientId?: string | undefined; compressionMode?: "auto" | "manual" | "off" | undefined; } | null	yes

storage:agent.listByAdapter (rpc)

List agents by adapter name with optional status filter.

Subject: storage:agent.listByAdapter Type: Request (RPC)

Request:

Field	Type	Required
adapterName	string	yes
status	"active" | "all" | "idle" | "dead" | "disposed" | undefined	no

Response:

Field	Type	Required
agents	{ agentId: string; adapterId: string; adapterName: string; sessionId: string; role: "lead" | "member"; status: "active" | "idle" | "dead" | "disposed"; createdAt: number; lastActivityAt: number; adapterSessionId?: string | undefined; model?: string | undefined; cwd?: string | undefined; providerConfigId?: string | undefined; personaId?: string | undefined; profileId?: string | undefined; harnessId?: string | undefined; clientId?: string | undefined; compressionMode?: "auto" | "manual" | "off" | undefined; }[]	yes

storage:agent.listBySession (rpc)

List agents by session ID.

Subject: storage:agent.listBySession Type: Request (RPC)

Request:

Field	Type	Required
sessionId	string	yes

Response:

Field	Type	Required
agents	{ agentId: string; adapterId: string; adapterName: string; sessionId: string; role: "lead" | "member"; status: "active" | "idle" | "dead" | "disposed"; createdAt: number; lastActivityAt: number; adapterSessionId?: string | undefined; model?: string | undefined; cwd?: string | undefined; providerConfigId?: string | undefined; personaId?: string | undefined; profileId?: string | undefined; harnessId?: string | undefined; clientId?: string | undefined; compressionMode?: "auto" | "manual" | "off" | undefined; }[]	yes

storage:agent.set (rpc)

Store or update an agent.

Subject: storage:agent.set Type: Request (RPC)

Request:

Field	Type	Required
agent	{ agentId: string; adapterId: string; adapterName: string; sessionId: string; role: "lead" | "member"; status: "active" | "idle" | "dead" | "disposed"; createdAt: number; lastActivityAt: number; adapterSessionId?: string | undefined; model?: string | undefined; cwd?: string | undefined; providerConfigId?: string | undefined; personaId?: string | undefined; profileId?: string | undefined; harnessId?: string | undefined; clientId?: string | undefined; compressionMode?: "auto" | "manual" | "off" | undefined; }	yes
agentId	string	yes

Response:

Field	Type	Required
success	boolean	yes

storage:agent.updateActivity (rpc)

Update agent last activity timestamp.

Subject: storage:agent.updateActivity Type: Request (RPC)

Request:

Field	Type	Required
agentId	string	yes
lastActivityAt	number	yes

Response:

Field	Type	Required
success	boolean	yes

storage:agent.updateRuntime (rpc)

Update runtime-mutable agent fields without full record overwrite.

Subject: storage:agent.updateRuntime Type: Request (RPC)

Request:

Field	Type	Required
agentId	string	yes
cwd	string | undefined	no
model	string | undefined	no
providerConfigId	string | undefined	no

Response:

Field	Type	Required
success	boolean	yes

storage:agent.updateStatus (rpc)

Update agent status.

Subject: storage:agent.updateStatus Type: Request (RPC)

Request:

Field	Type	Required
agentId	string	yes
status	"active" | "idle" | "dead" | "disposed"	yes

Response:

Field	Type	Required
success	boolean	yes

---

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