Skip to content

context.report

Self-report the calling agent’s current context-window budget (ephemeral telemetry, ADR 0035/0036). Provide window_total and any subset of the six canonical segments, each at most once (report an explicit 0 for a measured-empty segment; omitted segments are stored as absent, never zero-filled). tenant_id/agent_id derive from your token — do not supply them. NOT evidence, never audited; last write wins and is TTL’d. The ack echoes your stored snapshot.

FieldTypeRequiredDescription
modelstring
observed_atstring (nullable) (date-time)
personality_vectorobject
segmentsarray (nullable)yes(items 1–6)
window_totalintegeryes(range 1–1000000000)
FieldTypeRequiredDescription
labelSegmentLabelyes
tokensintegeryes(range 0–1000000000)
FieldTypeRequiredDescription
acceptedbooleanyes
agent_idstringyes
expires_atstring (date-time)yes
reported_atstring (date-time)yes
request_idstring
segmentsarray (nullable)yes
usedintegeryes
window_totalintegeryestotal context window in tokens
FieldTypeRequired
labelSegmentLabelyes
tokensintegeryes