Przejdź do treści

Component Trace Session V1

Source schema: doc/schemas/component-trace-session.v1.schema.json

Host capture-session lifecycle and bounded counters.

Governing Basis

Project Lineage

Fields

Field Required Shape Description
schema yes const: component-trace-session.v1
schema/v yes const: 1
session/ref yes ref: #/$defs/ref
node/ref yes ref: #/$defs/ref
observation/generation yes ref: #/$defs/ref
policy/ref yes ref: #/$defs/ref
policy/digest yes ref: #/$defs/digest
status yes enum: disabled, active, stopping, closed, expired, revoked, interrupted, failed
started/at yes ref: #/$defs/timestamp
expires/at yes ref: #/$defs/timestamp
start/cursor yes ref: #/$defs/cursor
start/resume-token yes string
final/cursor no ref: #/$defs/cursor
final/resume-token no string
observations/accepted yes ref: #/$defs/cursor
observations/dropped yes ref: #/$defs/cursor
gaps/emitted yes ref: #/$defs/cursor
terminal/reason-code no ref: #/$defs/ref
links yes object

Definitions

Definition Shape Description
ref string
digest string
timestamp string
cursor integer

Conditional Rules

Rule 1

When:

{
  "required": [
    "final/cursor"
  ]
}

Then:

{
  "required": [
    "final/resume-token"
  ]
}

Rule 2

When:

{
  "properties": {
    "status": {
      "enum": [
        "disabled",
        "active",
        "stopping"
      ]
    }
  },
  "required": [
    "status"
  ]
}

Then:

{
  "not": {
    "required": [
      "terminal/reason-code"
    ]
  }
}

Field Semantics

schema

  • Required: yes
  • Shape: const: component-trace-session.v1

schema/v

  • Required: yes
  • Shape: const: 1

session/ref

  • Required: yes
  • Shape: ref: #/$defs/ref

node/ref

  • Required: yes
  • Shape: ref: #/$defs/ref

observation/generation

  • Required: yes
  • Shape: ref: #/$defs/ref

policy/ref

  • Required: yes
  • Shape: ref: #/$defs/ref

policy/digest

  • Required: yes
  • Shape: ref: #/$defs/digest

status

  • Required: yes
  • Shape: enum: disabled, active, stopping, closed, expired, revoked, interrupted, failed

started/at

  • Required: yes
  • Shape: ref: #/$defs/timestamp

expires/at

  • Required: yes
  • Shape: ref: #/$defs/timestamp

start/cursor

  • Required: yes
  • Shape: ref: #/$defs/cursor

start/resume-token

  • Required: yes
  • Shape: string

final/cursor

  • Required: no
  • Shape: ref: #/$defs/cursor

final/resume-token

  • Required: no
  • Shape: string

observations/accepted

  • Required: yes
  • Shape: ref: #/$defs/cursor

observations/dropped

  • Required: yes
  • Shape: ref: #/$defs/cursor

gaps/emitted

  • Required: yes
  • Shape: ref: #/$defs/cursor

terminal/reason-code

  • Required: no
  • Shape: ref: #/$defs/ref

  • Required: yes
  • Shape: object

Definition Semantics

$defs.ref

  • Shape: string

$defs.digest

  • Shape: string

$defs.timestamp

  • Shape: string

$defs.cursor

  • Shape: integer