Skip to content

Home > intention-kernel > EffectReceipt

EffectReceipt interface ​

Durable evidence for an idempotent external effect.

Signature:

typescript
export interface EffectReceipt<T = unknown>

Properties ​

Property

Modifiers

Type

Description

capabilityId

readonly

CapabilityId

Capability that requested the effect.

createdAt

readonly

string

ISO timestamp when the receipt was first prepared.

data?

readonly

T

(Optional) Successful provider value when the effect completed.

id

readonly

EffectId

Durability-owned unique receipt identity.

idempotencyKey

readonly

string

Capability-prefixed logical-operation key, deduplicated across turns in the ledger's thread scope.

status

readonly

EffectStatus

Current durable lifecycle status.

stepId

readonly

StepId

Plan step that requested the effect.

turnId

readonly

TurnId

Turn recorded for the latest provider attempt; replay preserves this identity.

updatedAt

readonly

string

ISO timestamp of the latest durable status change.