Skip to content

smelt.transcript.groups

Tier: Host - Available in every runtime, including headless mode.

Visibility: Public - Stable Lua API intended for user config and plugins.

Declarative transcript display grouping. Register adjacent-run group rules and group-node renderers while the host owns deterministic planning and cache invalidation.

smelt.transcript.groups.cache_key

fun(): integer?

Current group-registry cache key, or nil when any active group opted out of persisted planning/layout caches.

smelt.transcript.groups.generation

fun(): integer

Current group-registry generation. Rust render planning uses this to invalidate plan/cache state once group planning is enabled.

smelt.transcript.groups.list

fun(): smelt.transcript.GroupSpec[]

Types: smelt.transcript.GroupSpec

Return group specs in planner order: higher priority first, then registration order.

smelt.transcript.groups.register

fun(spec: smelt.transcript.GroupSpec): smelt.Reg

Types: smelt.transcript.GroupSpec, smelt.Reg

Register or replace a declarative transcript group type. This only declares planning metadata and a renderer for future virtual group nodes; Rust owns deterministic adjacent-run planning.