intent_timeline

server.intent_timeline

module

Private ordered observations for debug and test capture.

This module deliberately has no public export. It stores only framework-owned, structural facts copied from typed traces; request/response bodies, headers, cookies, session data, rendered…

Private ordered observations for debug and test capture.

This module deliberately has no public export. It stores only framework-owned, structural facts copied from typed traces; request/response bodies, headers, cookies, session data, rendered HTML, and template context never enter the capture model.

server.intent_timeline

Name	Type	Default	Description
`type`		—
`qualified_name`		—
`element_type`		—
`description`		—
`source_file`		—
`line_number`		—
`is_autodoc`		—
`autodoc_element`		—
`_autodoc_template`		—
`_autodoc_url_path`		—
`_autodoc_page_type`		—
`title`		—
`doc_content_hash`		—

Symbols on this page

function _content_type_class

Keep the media type while dropping header parameters such as boundaries.

function _capture_request_id

Derive an opaque correlation ID without retaining a caller header value.

class _RequestObservation

Structural request facts copied from a typed return trace.

class _RenderIntentObservation

One typed render decision without template context or rendered HTML.

class _ResponseObservation

Final response and compiled-transition facts.

class _SSEObservation

Allowlisted SSE lifecycle metadata; event data and IDs are excluded.

class _DiagnosticObservation

Framework-owned diagnostic code with no arbitrary message payload.

class _ObservationDraft

Immutable structural facts awaiting sequence allocation.

class _IntentObservation

One immutable observation in an authoritative capture order.

class _TruncationMarker

Explicit evidence that a capture contains only a retained suffix.

class _CaptureSnapshot

Stable read model for one capture lifecycle.

class _IntentCapture

Locked, bounded, process-local capture for debug/test use only.

function _encoded_size

Return the canonical UTF-8 size used by the byte retention bound.

function _observation_mapping

Build the existing debug-record shape plus ordered capture metadata.

function _http_drafts

Copy a typed trace into request, render, and response observations.

function _sse_draft

Copy only allowlisted structural SSE metadata into an observation.

function _diagnostic_draft

Build a framework diagnostic without accepting arbitrary metadata.

_content_type_class

function

def _content_type_class(value: str | None) -> str | None

Keep the media type while dropping header parameters such as boundaries.

Parameters

Name	Type	Default	Description
`value`	`str \| None`	—

_capture_request_id

function

def _capture_request_id(value: str | None) -> str | None

Derive an opaque correlation ID without retaining a caller header value.

Parameters

Name	Type	Default	Description
`value`	`str \| None`	—

_RequestObservation

class

Structural request facts copied from a typed return trace.

_RenderIntentObservation

class

One typed render decision without template context or rendered HTML.

_ResponseObservation

class

Final response and compiled-transition facts.

_SSEObservation

class

Allowlisted SSE lifecycle metadata; event data and IDs are excluded.

_DiagnosticObservation

class

Framework-owned diagnostic code with no arbitrary message payload.

_ObservationDraft

class

Immutable structural facts awaiting sequence allocation.

_IntentObservation

class

One immutable observation in an authoritative capture order.

_TruncationMarker

class

Explicit evidence that a capture contains only a retained suffix.

_CaptureSnapshot

class

Stable read model for one capture lifecycle.

_IntentCapture

class

Locked, bounded, process-local capture for debug/test use only.

_encoded_size

function

def _encoded_size(observation: _IntentObservation) -> int

Return the canonical UTF-8 size used by the byte retention bound.

Parameters

Name	Type	Default	Description
`observation`	`_IntentObservation`	—

_observation_mapping

function

def _observation_mapping(observation: _IntentObservation) -> dict[str, Any]

Build the existing debug-record shape plus ordered capture metadata.

Parameters

Name	Type	Default	Description
`observation`	`_IntentObservation`	—

_http_drafts

function

def _http_drafts(trace: ReturnTrace, *, request_id: str, internal: bool, owner: str) -> tuple[_ObservationDraft, _ObservationDraft, _ObservationDraft]

Copy a typed trace into request, render, and response observations.

Parameters

Name	Type	Default
`trace`	`ReturnTrace`	—
`request_id`	`str`	—
`internal`	`bool`	—
`owner`	`str`	—

_sse_draft

function

def _sse_draft(*, phase: str, route_pattern: str, request_id: str, parent_sequence: int | None, internal: bool, owner: str, data: dict[str, Any] | None) -> _ObservationDraft

Copy only allowlisted structural SSE metadata into an observation.

Parameters

Name	Type	Default
`phase`	`str`	—
`route_pattern`	`str`	—
`request_id`	`str`	—
`parent_sequence`	`int \| None`	—
`internal`	`bool`	—
`owner`	`str`	—
`data`	`dict[str, Any] \| None`	—

_diagnostic_draft

function

def _diagnostic_draft(code: str) -> _ObservationDraft

Build a framework diagnostic without accepting arbitrary metadata.

Parameters

Name	Type	Default	Description
`code`	`str`	—

View source · /home/runner/work/chirp/chirp/site/../src/chirp/server/intent_timeline.py:1