SourceRange

The inclusive raw-record range a durable-sourced view event folded from — the reconciliation token: re-folding the cited records from the canonical fold state immediately before first — appended host-death terminals seed from the end-of-records state — reproduces the event. In v1 it is an opaque provenance token: no wire method reads what it points at.

Ephemeral-sourced events (item/delta, and an item/started that opens on an ephemeral record) carry no sourceRange — ephemeral records may be evicted by retention.

Fields and variants

• first
• last
• stream

Source

schema/msp/experimental/msp.schema.json#/types/SourceRange

{
  "description": "The inclusive raw-record range a durable-sourced view event folded from — the reconciliation token: re-folding the cited records from\nthe canonical fold state immediately before `first` — appended host-death\nterminals seed from the end-of-records state — reproduces the event. In v1 it is an **opaque provenance\ntoken**: no wire method reads what it points at.\n\nEphemeral-sourced events (`item/delta`, and an `item/started` that opens\non an ephemeral record) carry no `sourceRange` — ephemeral records may be\nevicted by retention.",
  "properties": {
    "first": {
      "$ref": "#/$defs/RecordPosition",
      "description": "The first record of the inclusive range."
    },
    "last": {
      "$ref": "#/$defs/RecordPosition",
      "description": "The last record of the inclusive range; equal to `first` for an event\nfolded from one record."
    },
    "stream": {
      "$ref": "#/$defs/StreamRef",
      "description": "The stream the folded records live on."
    }
  },
  "required": [
    "first",
    "last",
    "stream"
  ],
  "type": "object"
}