Skip to content

Sensorium Interface Subscription Status v1

Source schema: doc/schemas/sensorium-interface-subscription-status.v1.schema.json

Durable host projection of one caller-bound Sensorium Interface lease.

Fields

Field Required Shape Description
schema yes const: sensorium-interface-subscription-status.v1 Contract discriminator.
schema/v yes const: 1 Contract version.
subscription/id yes string Stable identifier of this lease.
interface/id yes string Interface resource bound to this lease.
lifecycle/status yes enum: requested, active, closing, closed Host-enforced lease lifecycle.
health/status yes enum: ready, degraded Current ability to serve read-next operations.
health/reason no string Required bounded diagnostic when health is degraded.
lease/expires-at yes string Hard expiry of the current lease grant.
cursor/current no string Last batch-level progress token committed for this lease.
terminal/reason no string Immutable closure reason required for a closed lease.
status/at yes string Time this status projection was recorded.

Conditional Rules

Rule 1

When:

{
  "properties": {
    "health/status": {
      "const": "degraded"
    }
  },
  "required": [
    "health/status"
  ]
}

Then:

{
  "required": [
    "health/reason"
  ]
}

Rule 2

When:

{
  "properties": {
    "lifecycle/status": {
      "const": "closed"
    }
  },
  "required": [
    "lifecycle/status"
  ]
}

Then:

{
  "required": [
    "terminal/reason"
  ]
}

Field Semantics

schema

  • Required: yes
  • Shape: const: sensorium-interface-subscription-status.v1

Contract discriminator.

schema/v

  • Required: yes
  • Shape: const: 1

Contract version.

subscription/id

  • Required: yes
  • Shape: string

Stable identifier of this lease.

interface/id

  • Required: yes
  • Shape: string

Interface resource bound to this lease.

lifecycle/status

  • Required: yes
  • Shape: enum: requested, active, closing, closed

Host-enforced lease lifecycle.

health/status

  • Required: yes
  • Shape: enum: ready, degraded

Current ability to serve read-next operations.

health/reason

  • Required: no
  • Shape: string

Required bounded diagnostic when health is degraded.

lease/expires-at

  • Required: yes
  • Shape: string

Hard expiry of the current lease grant.

cursor/current

  • Required: no
  • Shape: string

Last batch-level progress token committed for this lease.

terminal/reason

  • Required: no
  • Shape: string

Immutable closure reason required for a closed lease.

status/at

  • Required: yes
  • Shape: string

Time this status projection was recorded.