Skip to content

storage:supervisor-runtime

FieldValue
Prefixstorage:supervisor-runtime
Namespace constantSupervisorRuntimeStorageNamespace
Subjects constantSupervisorRuntimeStorageSubjects
Kindstorage
Schema record<inline>
Tierframework
Package@makaio/native-session-supervisor
Defined inpackages/native-session-supervisor/src/storage/namespace.ts
KeyWireTypeSchema
deletestorage:supervisor-runtime.deleterpc
getstorage:supervisor-runtime.getrpc
liststorage:supervisor-runtime.listrpc
setstorage:supervisor-runtime.setrpc
updatestorage:supervisor-runtime.updaterpc

Delete a supervisor runtime record by its canonical ID.

Subject: storage:supervisor-runtime.delete Type: Request (RPC)

Request:

FieldTypeRequired
supervisorSessionIdstringyes

Response:

FieldTypeRequired
successbooleanyes

Get a single supervisor runtime by any correlation key.

Exactly one of the locator fields must be provided.

Subject: storage:supervisor-runtime.get Type: Request (RPC)

Response:

FieldTypeRequired
runtime{ supervisorSessionId: string; clientId: string; pid: number | null; status: "unknown" | "running" | "stopped" | "exited"; cwd: string; command: string; args: string[]; startedAt: number; env?: Record<string, string> | undefined; sessionId?: string | undefined; adapterSessionId?: string | undefined; stoppedAt?: number | undefined; metadata?: Record<string, unknown> | undefined; } | nullyes

List supervisor runtimes with optional status filter.

Returns full runtime records (not just snapshots) to allow the registry to fully hydrate its in-memory cache from a single storage query.

Subject: storage:supervisor-runtime.list Type: Request (RPC)

Request:

FieldTypeRequired
limitnumber | undefinedno
status"unknown" | "running" | "stopped" | "exited" | undefinedno

Response:

FieldTypeRequired
runtimes{ supervisorSessionId: string; clientId: string; pid: number | null; status: "unknown" | "running" | "stopped" | "exited"; cwd: string; command: string; args: string[]; startedAt: number; env?: Record<string, string> | undefined; sessionId?: string | undefined; adapterSessionId?: string | undefined; stoppedAt?: number | undefined; metadata?: Record<string, unknown> | undefined; }[]yes

Insert or fully replace a supervisor runtime record.

Subject: storage:supervisor-runtime.set Type: Request (RPC)

Request:

FieldTypeRequired
adapterSessionIdstring | undefinedno
argsstring[]yes
clientIdstringyes
commandstringyes
cwdstringyes
envRecord<string, string> | undefinedno
metadataRecord<string, unknown> | undefinedno
pidnumber | nullyes
sessionIdstring | undefinedno
startedAtnumberyes
status"unknown" | "running" | "stopped" | "exited"yes
stoppedAtnumber | undefinedno
supervisorSessionIdstringyes

Response:

FieldTypeRequired
successbooleanyes

Apply a partial update to an existing supervisor runtime.

Subject: storage:supervisor-runtime.update Type: Request (RPC)

Request:

FieldTypeRequired
adapterSessionIdstring | undefinedno
metadataRecord<string, unknown> | undefinedno
pidnumber | null | undefinedno
sessionIdstring | undefinedno
status"unknown" | "running" | "stopped" | "exited" | undefinedno
stoppedAtnumber | undefinedno
supervisorSessionIdstringyes

Response:

FieldTypeRequired
successbooleanyes

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