Skip to main content

ProposalReview

Fresh review of exact retained intent, without executable input.

proposal objectrequired

Safe plain-text listing metadata; status never grants execution authority.

reference objectrequired

Exact journal lookup 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}$

summarySummary (string)required

Plain-text operation, selected resources and spending summary.

Possible values: non-empty and <= 1024 characters

expiresAtExpiresat (integer)required

Proposal expiry as UTC Unix seconds.

Possible values: > 0

stateState (string)required

Observed journal state; execution_recorded does not imply success.

Possible values: [pending_approval, approved, execution_recorded, expired, unavailable]

observedAtObservedat (integer)required

UTC Unix seconds of this review read.

Possible values: > 0

approvalRevision object

Current approval fence, or null when approval is unavailable.

anyOf
string

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

fields object[]required

Safe facts including model, context, resource, price, limits and cleanup terms as applicable.

Possible values: >= 1, <= 32

  • Array [
    • labelLabel (string)required

    Owner-facing fact label.

    Possible values: non-empty and <= 64 characters

    valueValue (string)required

    Safe plain-text value.

    Possible values: non-empty and <= 2048 characters

  • ]
    • ProposalReview
    {
      "proposal": {
        "reference": {
          "pluginId": "string",
          "nodeId": "string",
          "proposalId": "string",
          "proposalDigest": "string"
        },
        "summary": "string",
        "expiresAt": 0,
        "state": "pending_approval"
      },
      "observedAt": 0,
      "approvalRevision": "string",
      "fields": [
        {
          "label": "string",
          "value": "string"
        }
      ]
    }