FilterConfig

Opt-in, consumer-side filtering of a transcript event stream.

Usage

FilterConfig()

A back-compatible flag-bag that lowers to a ~cc_transcript.FilterSpec via to_spec(). Every flag defaults off, so a bare FilterConfig() passes events through untouched.

Parameter Attributes

keep_types: tuple[type[TranscriptEvent], …] | None = None
drop_sidechain: bool = False
drop_synthetic: bool = False
drop_compacted: bool = False
drop_empty: bool = False
drop_ephemeral_entrypoints: frozenset[str] = frozenset()
junk_pattern: re.Pattern[str] | None = None

Attributes

keep_types: tuple[type[TranscriptEvent], …] | None: When set, drop every event not an instance of one of these types; a type-level allowlist applied before the per-event rules.
drop_sidechain: bool: Drop events whose envelope marks a sidechain.
drop_synthetic: bool: Drop assistant events with model <synthetic>.
drop_compacted: bool: Drop compaction-summary and transcript-only entries (envelope flags on ~cc_transcript.models.EntryMeta).
drop_empty: bool: Drop user events with no text and assistant events with neither text nor a tool use.
drop_ephemeral_entrypoints: frozenset[str]: Drop events from these entrypoints.
junk_pattern: re.Pattern[str] | None: Drop user events whose text matches this pattern.

Methods

Name	Description
to_spec()	Lowers this flag-bag into an equivalent ordered FilterSpec.

to_spec()

Lowers this flag-bag into an equivalent ordered FilterSpec.

Usage

Source

to_spec()