This page is generated by loom-commission-docs from the ESS specification in ess/commission/ (system commission, version 1). Do not edit it by hand; run task commission:docs.
Value types
The types the ports speak and the entities' identifiers. Each entity's lifecycle states are listed with the entity on the domain model page.
Unions
Admission
Tagged by kind.
| Variant | Payload |
|---|---|
Admissible | none |
NeedsAuthority | AdmissionNeedsAuthority |
Refused | AdmissionRefused |
More columns: swipe horizontally, or focus the table and use the arrow keys.
AuthorityVerdict
Tagged by kind.
| Variant | Payload |
|---|---|
Allow | none |
ApprovalRequired | AuthorityVerdictApprovalRequired |
Deny | AuthorityVerdictDeny |
More columns: swipe horizontally, or focus the table and use the arrow keys.
CompletionDetermination
Tagged by kind.
| Variant | Payload |
|---|---|
Complete | CompletionDeterminationComplete |
Open | none |
More columns: swipe horizontally, or focus the table and use the arrow keys.
EffectOutcome
Tagged by kind.
| Variant | Payload |
|---|---|
Pending | EffectOutcomePending |
Performed | EffectOutcomePerformed |
Refused | EffectOutcomeRefused |
More columns: swipe horizontally, or focus the table and use the arrow keys.
ExecutorOutcome
Tagged by kind.
| Variant | Payload |
|---|---|
CaseMoved | ExecutorOutcomeCaseMoved |
CompletedLocalReasoning | none |
NeedsHumanJudgment | ExecutorOutcomeNeedsHumanJudgment |
NoUsefulAction | none |
ProposedAction | ExecutorOutcomeProposedAction |
ProposedReads | ExecutorOutcomeProposedReads |
Suspended | ExecutorOutcomeSuspended |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RunOutcome
Tagged by kind.
| Variant | Payload |
|---|---|
AwaitingApproval | RunOutcomeAwaitingApproval |
CaseMovedOn | RunOutcomeCaseMovedOn |
Completed | RunOutcomeCompleted |
EffectRefused | RunOutcomeEffectRefused |
IdleBound | RunOutcomeIdleBound |
NeedsAuthority | RunOutcomeNeedsAuthority |
NeedsExternalEvidence | RunOutcomeNeedsExternalEvidence |
NeedsHumanJudgment | RunOutcomeNeedsHumanJudgment |
NoAdmissibleAction | none |
NoPerformableAction | RunOutcomeNoPerformableAction |
Suspended | RunOutcomeSuspended |
Waiting | RunOutcomeWaiting |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RuntimeEvent
Tagged by kind.
| Variant | Payload |
|---|---|
ActionSelected | RuntimeEventActionSelected |
AuthorityDecided | RuntimeEventAuthorityDecided |
EffectInvoked | RuntimeEventEffectInvoked |
Proposed | RuntimeEventProposed |
SessionClosed | RuntimeEventSessionClosed |
StepStarted | RuntimeEventStepStarted |
Stopped | RuntimeEventStopped |
More columns: swipe horizontally, or focus the table and use the arrow keys.
SuspensionReason
Tagged by kind.
| Variant | Payload |
|---|---|
Authority | json |
Budget | json |
Dependency | list of CaseId |
Evidence | list of string |
ExternalAvailability | json |
HostStop | HostStop |
Human | HumanDecisionRequest |
LoopBudget | json |
RunBudget | RunBudgetBreach |
Time | json |
More columns: swipe horizontally, or focus the table and use the arrow keys.
Structs
ActionBindingKey
| Field | Type |
|---|---|
commission_id | CommissionId |
| action | string |
More columns: swipe horizontally, or focus the table and use the arrow keys.
ActionBudget
| Field | Type |
|---|---|
| action | string |
max_trials | optional integer |
max_tokens_in | optional integer |
max_tokens_out | optional integer |
max_duration_ms | optional integer |
max_cost_micro_usd | optional integer |
More columns: swipe horizontally, or focus the table and use the arrow keys.
ActionCharge
| Field | Type |
|---|---|
| action | string |
charged | ChargedUsage |
More columns: swipe horizontally, or focus the table and use the arrow keys.
AdmissionNeedsAuthority
| Field | Type |
|---|---|
capability | string |
More columns: swipe horizontally, or focus the table and use the arrow keys.
AdmissionRefused
| Field | Type |
|---|---|
| action | string |
reasons | list of string |
More columns: swipe horizontally, or focus the table and use the arrow keys.
AuthorityVerdictApprovalRequired
| Field | Type |
|---|---|
request | string |
More columns: swipe horizontally, or focus the table and use the arrow keys.
AuthorityVerdictDeny
| Field | Type |
|---|---|
reason | string |
More columns: swipe horizontally, or focus the table and use the arrow keys.
ChargedUsage
| Field | Type |
|---|---|
trials | integer |
input_tokens | integer |
output_tokens | integer |
duration_ms | integer |
cost_micro_usd | optional integer |
More columns: swipe horizontally, or focus the table and use the arrow keys.
CompletionDeterminationComplete
| Field | Type |
|---|---|
| outcome | string |
More columns: swipe horizontally, or focus the table and use the arrow keys.
EffectOutcomePending
| Field | Type |
|---|---|
report | json |
ends_run | boolean |
More columns: swipe horizontally, or focus the table and use the arrow keys.
EffectOutcomePerformed
| Field | Type |
|---|---|
report | json |
attempt | optional ConnectorAttemptId |
audit | optional ConnectorAuditRef |
usage | optional EffectUsage |
More columns: swipe horizontally, or focus the table and use the arrow keys.
EffectOutcomeRefused
| Field | Type |
|---|---|
reason | string |
ends_run | boolean |
More columns: swipe horizontally, or focus the table and use the arrow keys.
EffectUsage
| Field | Type |
|---|---|
input_tokens | integer |
output_tokens | integer |
duration_ms | integer |
cost_micro_usd | optional integer |
More columns: swipe horizontally, or focus the table and use the arrow keys.
ExecutorOutcomeCaseMoved
| Field | Type |
|---|---|
expected_case_revision | integer |
More columns: swipe horizontally, or focus the table and use the arrow keys.
ExecutorOutcomeNeedsHumanJudgment
| Field | Type |
|---|---|
request | HumanDecisionRequest |
More columns: swipe horizontally, or focus the table and use the arrow keys.
ExecutorOutcomeProposedAction
| Field | Type |
|---|---|
| action | string |
arguments | ProposedActionArguments |
More columns: swipe horizontally, or focus the table and use the arrow keys.
ExecutorOutcomeProposedReads
| Field | Type |
|---|---|
reads | list of ExecutorOutcomeProposedAction |
More columns: swipe horizontally, or focus the table and use the arrow keys.
ExecutorOutcomeSuspended
| Field | Type |
|---|---|
reason | SuspensionReason |
More columns: swipe horizontally, or focus the table and use the arrow keys.
ExecutorStep
| Field | Type |
|---|---|
| outcome | ExecutorOutcome |
usage | optional ExecutorUsage |
transcript_digest | optional string |
summary | optional string |
More columns: swipe horizontally, or focus the table and use the arrow keys.
ExecutorUsage
| Field | Type |
|---|---|
input_tokens | integer |
output_tokens | integer |
duration_ms | integer |
cost_micro_usd | optional integer |
More columns: swipe horizontally, or focus the table and use the arrow keys.
FrontierAction
| Field | Type |
|---|---|
| action | string |
status | ActionStatus |
capability | optional string |
reasons | list of string |
More columns: swipe horizontally, or focus the table and use the arrow keys.
FrontierClaim
| Field | Type |
|---|---|
| claim | string |
value | Truth |
More columns: swipe horizontally, or focus the table and use the arrow keys.
FrontierObligation
| Field | Type |
|---|---|
| obligation | string |
open | boolean |
More columns: swipe horizontally, or focus the table and use the arrow keys.
HostStop
| Field | Type |
|---|---|
name | string |
detail | json |
More columns: swipe horizontally, or focus the table and use the arrow keys.
LimitBreachStep
| Field | Type |
|---|---|
limit | BudgetLimit |
step | BreachStep |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RunBudget
| Field | Type |
|---|---|
max_steps | optional integer |
max_tokens_in | optional integer |
max_tokens_out | optional integer |
max_duration_ms | optional integer |
max_cost_micro_usd | optional integer |
max_tokens | optional integer |
deadline | optional timestamp |
per_action | list of ActionBudget |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RunBudgetBreach
| Field | Type |
|---|---|
| action | optional string |
limit | BudgetLimit |
max | integer |
charged | optional integer |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RunCharges
| Field | Type |
|---|---|
run | ChargedUsage |
actions | list of ActionCharge |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RunOutcomeAwaitingApproval
| Field | Type |
|---|---|
actions | list of string |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RunOutcomeCaseMovedOn
| Field | Type |
|---|---|
bound_case_revision | integer |
current_case_revision | integer |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RunOutcomeCompleted
| Field | Type |
|---|---|
| outcome | string |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RunOutcomeEffectRefused
| Field | Type |
|---|---|
action_request_id | ActionRequestId |
reason | string |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RunOutcomeIdleBound
| Field | Type |
|---|---|
idle_iterations | integer |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RunOutcomeNeedsAuthority
| Field | Type |
|---|---|
request | string |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RunOutcomeNeedsExternalEvidence
| Field | Type |
|---|---|
requirements | list of string |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RunOutcomeNeedsHumanJudgment
| Field | Type |
|---|---|
request | HumanDecisionRequest |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RunOutcomeNoPerformableAction
| Field | Type |
|---|---|
actions | list of string |
open_claims | list of string |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RunOutcomeSuspended
| Field | Type |
|---|---|
reason | SuspensionReason |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RunOutcomeWaiting
| Field | Type |
|---|---|
action_request_ids | list of ActionRequestId |
reason | SuspensionReason |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RuntimeEventActionSelected
| Field | Type |
|---|---|
run_id | RunId |
| action | string |
arguments | ProposedActionArguments |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RuntimeEventAuthorityDecided
| Field | Type |
|---|---|
run_id | RunId |
action_request_id | ActionRequestId |
capability | string |
verdict | optional AuthorityVerdict |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RuntimeEventEffectInvoked
| Field | Type |
|---|---|
run_id | RunId |
action_request_id | ActionRequestId |
| action | string |
| outcome | EffectOutcome |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RuntimeEventProposed
| Field | Type |
|---|---|
run_id | RunId |
action_request_id | ActionRequestId |
| action | string |
arguments | ProposedActionArguments |
case_revision | integer |
answer | RevalidationAnswer |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RuntimeEventSessionClosed
| Field | Type |
|---|---|
run_id | RunId |
step | integer |
transcript_digest | optional string |
summary | optional string |
usage | optional ExecutorUsage |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RuntimeEventStepStarted
| Field | Type |
|---|---|
run_id | RunId |
step | integer |
case_revision | integer |
frontier_id | optional FrontierId |
More columns: swipe horizontally, or focus the table and use the arrow keys.
RuntimeEventStopped
| Field | Type |
|---|---|
run_id | RunId |
| outcome | optional RunOutcome |
failure | optional string |
More columns: swipe horizontally, or focus the table and use the arrow keys.
StopPolicy
| Field | Type |
|---|---|
approval_gate | boolean |
idle_bound | optional integer |
on_breach | BreachStep |
breach_by_limit | list of LimitBreachStep |
More columns: swipe horizontally, or focus the table and use the arrow keys.
SuspensionKey
| Field | Type |
|---|---|
commission_id | CommissionId |
More columns: swipe horizontally, or focus the table and use the arrow keys.
Enums
ActionStatus
Variants: Admissible, ApprovalRequired, Blocked.
BreachStep
Variants: DiscardStep, KeepStep.
BudgetLimit
Variants: MaxSteps, MaxTrials, MaxTokensIn, MaxTokensOut, MaxDurationMs, MaxCostMicroUsd, MaxTokens, Deadline.
ConnectorOperationEffect
Variants: Read, Write.
GovernorError
Variants: UnknownCase, GovernorUnavailable.
RevalidationAnswer
Variants: Admitted, NeedsAuthority, NotAdmitted, Stale.
Truth
Variants: True, False, Unknown.
Identifiers and wrapped values
ActionRequestId
Wraps uuid.
AgentId
Wraps uuid.
AgentRevisionId
Wraps uuid.
AuthorityContext
Wraps json.
AuthorityDecisionId
Wraps uuid.
CaseId
Wraps string.
CommissionId
Wraps uuid.
ConnectorAttemptId
Wraps string.
ConnectorAuditRef
Wraps string.
ConnectorCredentialRef
Wraps string.
ConnectorEndpointUrl
Wraps string.
ConnectorInstanceId
Wraps string.
ConnectorOperationId
Wraps string.
EvidenceId
Wraps uuid.
FrontierId
Wraps uuid.
HumanDecisionRequest
Wraps json.
ObservationId
Wraps uuid.
PrincipalId
Wraps string.
ProposedActionArguments
Wraps json.
RunId
Wraps uuid.