Skip to main content

ProposalOperation

Safe durable progress; reconnect never replays an uncertain dispatch.

operationIdOperationid (string)required

Accepted owner action ID.

Possible values: Value must match regular expression ^[a-f0-9]{32}$

reference objectrequired

Exact retained proposal reference.

pluginIdPluginid (string)required

Exact installed managed plugin identity.

Possible values: Value must match regular expression ^managed\.[a-z0-9][a-z0-9._-]{0,80}$

nodeIdNodeid (string)required

Stable installed node identity.

Possible values: non-empty and <= 128 characters, Value must match regular expression ^[a-zA-Z0-9._:@-]+$

proposalIdProposalid (string)required

Provider-owned opaque identifier, never a path or canonical input.

Possible values: non-empty and <= 128 characters, Value must match regular expression ^[a-zA-Z0-9._:@-]+$

proposalDigestProposaldigest (string)required

Digest of the provider's complete immutable proposal intent.

Possible values: Value must match regular expression ^[a-f0-9]{64}$

phasePhase (string)required

Last durable observation, not a new execution grant.

Possible values: [accepted, approving, approved, dispatching, acknowledged, succeeded, refused, approval_interrupted, uncertain]

updatedAtUpdatedat (integer)required

Observation time as UTC Unix seconds.

Possible values: > 0

reconciliation object

Later cleanup evidence; never changes submission history.

anyOf
stateState (string)required

Correlated lifecycle state; absence requires retained evidence.

Possible values: [pending, active, releasing, absent, attention, unknown]

observedAt object

Cleanup journal read time, UTC seconds; null before observation.

anyOf
integer

Possible values: > 0 and <= 253402300799

staleStale (boolean)required

Current cleanup access or worker health is unconfirmed.

code object

Safe reconciliation status code, separate from submission errors.

anyOf
string

Possible values: Value must match regular expression ^[a-z][a-z0-9_]{0,127}$

code object

Safe status code.

anyOf
string

Possible values: Value must match regular expression ^[a-z][a-z0-9_]{0,127}$

correctiveAction object

Safe owner recovery guidance.

anyOf
string

Possible values: <= 512 characters

ProposalOperation
{
  "operationId": "string",
  "reference": {
    "pluginId": "string",
    "nodeId": "string",
    "proposalId": "string",
    "proposalDigest": "string"
  },
  "phase": "accepted",
  "updatedAt": 0,
  "reconciliation": {
    "state": "pending",
    "observedAt": 0,
    "stale": true,
    "code": "string"
  },
  "code": "string",
  "correctiveAction": "string"
}