Executions
Running a capability of this registry as work that can be watched: started, followed event by event over the live channel, read back afterwards, and asked to stop. In memory; an execution does not outlive the process that accepted it.
Running a capability of this registry as work that can be watched: started, followed event by event over the live channel, read back afterwards, and asked to stop. In memory; an execution does not outlive the process that accepted it.
- module executions
- builtin
- behaviorally_verified
- 7 capabilities
Capabilities
Each composed in this module's file; each with its own page.
executions.cancelSet the execution's cancellation flag and say so on its stream. Cancellation is cooperative: a task looks at its flag and stops, and a capability whose policy says it is not cancellable runs to completion — which the answer says rather than pretending otherwise.command · behaviorally_verified · majordomus_execution_cancel · POST /api/v1/executions/cancelexecutions.demonstrateWalk a given number of steps, reporting each one, logging a line and advancing progress, then finish — or fail at a step you name. It exists so that an operator, a probe and an end-to-end test can prove the whole path works without waiting for real work: it reads nothing, writes nothing, and its only effect is the events it produces. It looks at its cancellation flag between steps and while it waits, so cancelling it stops it.query · behaviorally_verified · majordomus_demonstrate_execution · GET /api/v1/executions/demonstrateexecutions.eventsThe retained events of one execution, oldest first, after a sequence number. This is what a browser reads after a reload and what a client reads after a reconnect: the page carries the cursor to open the live channel with, so nothing is missed between the history and the stream.query · behaviorally_verified · majordomus_execution_events · GET /api/v1/executions/eventsexecutions.getThe whole of what is known about one execution: its state, its input as it was stored, its steps, its progress, its diagnostics, and its output or its error. Taken under one lock, so a snapshot that says it succeeded carries what it produced.query · behaviorally_verified · majordomus_execution · GET /api/v1/executions/getexecutions.listEvery execution this process remembers, newest first, narrowed by state or by capability. The counts beside them — remembered, active, queued, live channels — are what a control plane shows without asking a second question.query · behaviorally_verified · majordomus_executions · GET /api/v1/executionsexecutions.protocolWhere the WebSocket is, how a subscription and a reconnect are expressed, what the server writes, and the JSON Schema of every message — derived from the Rust types that implement it, so a client validating against this is validating against the implementation. OpenAPI cannot describe a socket; this is where that contract lives.query · behaviorally_verified · majordomus_execution_protocol · GET /api/v1/executions/protocolexecutions.startRun any executable capability of this registry as an execution: the input is checked against that capability's own input schema, the work is queued, and this answers at once with the execution's id and the links to follow it. Nothing waits for the handler. The capability runs through the same executor every other interface calls, so there is no second implementation of anything.command · behaviorally_verified · majordomus_execution_start · POST /api/v1/executions/start