Expand description
Allocation-free operation preparation and checked response policy.
Structs§
- Attempt
Budget - Nonzero maximum number of attempts sharing one authority.
- Canonical
Plan Fingerprint - Caller-buffer exact plan-confirm input, cleared in full on drop.
- Checked
Response - Response that passed one operation’s complete provider-neutral policy.
- Checked
Response Guard - Policy-checked response that owns cleanup of its caller storage.
- Cost
Permit - Single-owner authority for one exact price-bounded cost plan.
- Currency
Code - Exact ISO-style uppercase currency code.
- Destructive
Permit - Single-owner authority for one destructive mutation plan.
- Mutation
Permit - Single-owner authority for one non-destructive mutation plan.
- Operation
Id - Validated static identifier assigned by a provider specification.
- Operation
Metadata - Complete operation safety metadata without permissive defaults.
- Owned
Preparation Storage - Fallibly allocated preparation buffers cleared in full on drop.
- Permit
Attempt - One in-flight attempt. Dropping it records uncertain delivery.
- Permit
Context - Exact bounded context binding a permit to caller policy.
- Permit
Execution Error - Prepared execution failure plus the fail-closed permit disposition.
- Permit
Idempotency Key - Borrowed caller-owned identity used only for exact reconciliation matching.
- Permit
Timestamp - Caller-observed wall-clock timestamp in Unix seconds.
- Permit
Validity - Caller-owned issuance and expiry observations.
- Plan
Confirmation - Complete immutable plan-confirm inputs.
- Plan
Cost - Exact caller-observed price and spending ceiling in common scaled units.
- Plan
Fingerprint Digest - Caller-buffer strong digest of a plan confirmation, cleared on drop.
- Plan
Fingerprint Ref - Borrowed exact or strong-digest plan identity.
- Plan
Subject - One prepared request inseparably bound to a validated plan confirmation.
- Preparation
Capacity Profile - Named, bounded storage capacities for request preparation.
- Preparation
Storage - Caller-owned target and request-body storage supplied to preparation.
- Preparation
Storage Guard - Caller-owned preparation buffers that are cleared together on drop.
- Prepared
Request - Complete request, endpoint, operation metadata, and response policy.
- Provider
Service - Provider service and immutable endpoint trust policy.
- Reconciliation
Token - Generation-bound reconciliation authority returned after uncertain delivery.
- Recovery
Token - Generation-bound recovery authority returned only for
NotSent. - Response
Policy - Complete checked-response policy.
- Shared
Cost Permit - Shared atomic price-bounded authority.
- Shared
Destructive Permit - Shared atomic destructive authority.
- Shared
Mutation Permit - Shared atomic mutation authority.
- Shared
Permit State - Caller-owned atomic authority shared by all explicit permit-handle clones.
Enums§
- Attempt
Budget Error - Invalid attempt budget.
- Body
Replayability - Whether one prepared request body can be sent again byte-for-byte.
- Content
Type Policy - Response content-type requirement and accepted media types.
- Cost
Intent - Whether executing the operation may directly incur provider charges.
- Currency
Code Error - Invalid three-letter currency code.
- Execution
Permit Error - Permit authorization or lifecycle failure.
- Operation
IdError - Invalid provider operation identifier.
- Operation
Impact - Provider operation impact.
- Operation
Metadata Error - Incoherent operation metadata.
- Permit
Context Error - Invalid account, tenant, or permit-context value.
- Permit
Disposition - State transition produced by one completed or failed attempt.
- Permit
Idempotency KeyError - Invalid caller-provided repetition identity.
- Permit
Scope - Runtime execution authority required by an operation.
- Permit
State - Observable permit lifecycle state.
- Permit
Validity Error - Invalid bounded permit-validity interval.
- Plan
Change - Caller assessment of whether the planned request changes effective state.
- Plan
Cost Error - Invalid cost confirmation.
- Plan
Fingerprint Build Error - Plan-confirm construction failure.
- Plan
Fingerprint Scope - Optional exact account or tenant identity.
- Preparation
Capacity Error - Failure while selecting or allocating preparation storage.
- Prepared
Execution Error - Prepared execution failure with transport details redacted from diagnostics.
- Prepared
Request Policy Error - Incoherent policy supplied while constructing a prepared request.
- Replay
Policy - Repetition policy selected during plan confirmation.
- Request
IdPolicy - Lifecycle policy for provider request identifiers.
- Request
Semantics - HTTP request semantics independent of provider impact.
- Response
Body Policy - Expected response-body shape.
- Response
Policy Error - Response rejected before provider decoding.
- Response
Policy Validation Error - Invalid response-policy construction.
- Retry
Eligibility - Whether caller-owned retry policy may retry the operation.
Constants§
- DEFAULT_
BODY_ BYTES - Default request-body capacity in bytes.
- EMBEDDED_
BODY_ BYTES - Embedded request-body capacity in bytes.
- LARGE_
BODY_ BYTES - Large request-body capacity in bytes.
Traits§
- Permit
Clock - Time source sampled inside permit execution immediately before dispatch.
- Prepare
Operation - Typed provider operation that can prepare one complete request.
Functions§
- build_
canonical_ plan - Builds exact canonical plan-confirm bytes into caller-owned storage.
- build_
plan_ digest - Builds a caller-selected collision-resistant digest and clears scratch.