Module jsonrpc
Expand description
Shared JSON-RPC 2.0 types for the ACP server and runtime RPC layer.
Modules§
Structs§
- Fetched
Catalog - 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. - FsList
DirRequest - Request payload for
fs.list_dir. - FsList
DirResponse - Response for
fs.list_dir. - FsStat
Error - Filesystem stat error payload (used inside
JsonRpcError.data). - FsStat
Result - Filesystem stat result (success case). Matches FsEntry shape with extra fields.
- Json
RpcError - Json
RpcNotification - Json
RpcRequest - Json
RpcResponse - Locale
Option - One selectable locale from the build’s embedded
locales.tomlregistry. - Locales
Fetch Request - Request payload for
locales/fetch.catalogrestricts which catalogues are downloaded;None/empty means all. The daemon validateslocaleagainst the embedded registry andcatalogagainst the fixed catalog set. - Locales
Fetch Response - Response for
locales/fetch. - Locales
List Response - Response for
locales/list— the in-memory locale registry. - RpcOutbound
- SopDecide
Request - Request payload for
sops/decide: resolve a paused checkpoint.nameandrun_idselect the run;decisionis the rawApprovalDecisionwire 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. - SopRun
Overlay Request - Request payload for
sops/run-overlay: project a run’s state onto a SOP’s graph. Selects the SOP bynameand the run byrun_id. - SopRun
Request - Request payload for
sops/run: fire a Manual trigger for the named SOP.payloadis 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 ManualSopEventand dispatches it on the same path as thesop_executetool. - SopRun
Response - Response payload for
sops/run: the id of the run that was started, which feeds straight intosops/run-overlayto animate the run on the canvas. - SopRuns
Request - Request payload for
sops/runs: enumerate runs the engine currently holds (active plus retained terminal), newest first.sopoptionally scopes the listing to a single SOP by name; omitting it lists every SOP’s runs. - SopSave
Request - Request payload for
sops/saveandsops/create. Thesopfield is the wire form of the runtimeSop; the daemon deserializes and validates it.sops/validatealso accepts this form to validate an unsaved draft. - SopSelect
Request - 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
jsonrpcfield. - OUTBOUND_
ID_ PREFIX - Prefix for server-originated outbound request IDs, disjoint from any client-issued id space.