Skip to main content

Module jsonrpc

Module jsonrpc 

Expand description

Shared JSON-RPC 2.0 types for the ACP server and runtime RPC layer.

Modules§

error_codes
field

Structs§

FetchedCatalog
One fetched catalogue’s bytes, returned over the wire so the client writes them into its own config dir (keeping the write in the caller’s permission scope).
FsEntry
A single directory entry returned by fs.list_dir.
FsListDirRequest
Request payload for fs.list_dir.
FsListDirResponse
Response for fs.list_dir.
FsStatError
Filesystem stat error payload (used inside JsonRpcError.data).
FsStatResult
Filesystem stat result (success case). Matches FsEntry shape with extra fields.
JsonRpcError
JsonRpcNotification
JsonRpcRequest
JsonRpcResponse
LocaleOption
One selectable locale from the build’s embedded locales.toml registry.
LocalesFetchRequest
Request payload for locales/fetch. catalog restricts which catalogues are downloaded; None/empty means all. The daemon validates locale against the embedded registry and catalog against the fixed catalog set.
LocalesFetchResponse
Response for locales/fetch.
LocalesListResponse
Response for locales/list — the in-memory locale registry.
RpcOutbound
SopDecideRequest
Request payload for sops/decide: resolve a paused checkpoint. name and run_id select the run; decision is the raw ApprovalDecision wire value ("approve" or {"deny": {"reason": "..."}}), deserialized into the canonical runtime enum by the handler so no parallel decision enum exists here to drift from it.
SopRunOverlayRequest
Request payload for sops/run-overlay: project a run’s state onto a SOP’s graph. Selects the SOP by name and the run by run_id.
SopRunRequest
Request payload for sops/run: fire a Manual trigger for the named SOP. payload is an optional JSON string handed to the run as the step-1 input; omitting it starts the run with no payload. The daemon builds the Manual SopEvent and dispatches it on the same path as the sop_execute tool.
SopRunResponse
Response payload for sops/run: the id of the run that was started, which feeds straight into sops/run-overlay to animate the run on the canvas.
SopRunsRequest
Request payload for sops/runs: enumerate runs the engine currently holds (active plus retained terminal), newest first. sop optionally scopes the listing to a single SOP by name; omitting it lists every SOP’s runs.
SopSaveRequest
Request payload for sops/save and sops/create. The sop field is the wire form of the runtime Sop; the daemon deserializes and validates it. sops/validate also accepts this form to validate an unsaved draft.
SopSelectRequest
Request payload for SOP read/delete methods that select one SOP by name: sops/get, sops/graph, sops/validate (by name), sops/delete.

Constants§

ACP_PROTOCOL_VERSION
JSONRPC_VERSION
JSON-RPC protocol version string. Used in every frame’s jsonrpc field.
OUTBOUND_ID_PREFIX
Prefix for server-originated outbound request IDs, disjoint from any client-issued id space.