> This page is for NeMo Relay, version dev.
> For other versions, use one of these documentation indexes:
> - Latest (v0.11.1) (default): https://docs.nvidia.com/nemo/relay/latest/llms.txt
> - dev: https://docs.nvidia.com/nemo/relay/dev/llms.txt
> - v0.11.1: https://docs.nvidia.com/nemo/relay/v0.11.1/llms.txt
> - v0.10.4: https://docs.nvidia.com/nemo/relay/v0.10.4/llms.txt
> - v0.9.4: https://docs.nvidia.com/nemo/relay/v0.9.4/llms.txt
> - v0.8.4: https://docs.nvidia.com/nemo/relay/v0.8.4/llms.txt
> - v0.7.3: https://docs.nvidia.com/nemo/relay/v0.7.3/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/relay/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo/relay/_mcp/server.

# Module scope

> Scope lifecycle and event emission.

Generated from `cargo doc --no-deps -p nemo-relay-builtins -p nemo-relay-diagnostics -p nemo-relay-logging -p nemo-relay-plugin-host -p nemo-relay-codecs -p nemo-relay -p nemo-relay-runtime -p nemo-relay-model-pricing -p nemo-relay-resource-metrics -p nemo-relay-observability -p nemo-relay-adaptive -p nemo-relay-pii-redaction -p nemo-relay-ffi -p nemo-relay-types -p nemo-relay-plugin -p nemo-relay-worker-proto -p nemo-relay-worker`.

Scope lifecycle and event emission.

## Structs

* [EmitMarkEventParams](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/struct-emitmarkeventparams): Builder parameters for [`event`](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/fn-event).
* [EmitMetricEventParams](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/struct-emitmetriceventparams): Builder parameters for [`metric`](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/fn-metric).
* [PopScopeParams](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/struct-popscopeparams): Builder parameters for [`pop_scope`](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/fn-pop-scope).
* [PushScopeParams](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/struct-pushscopeparams): Builder parameters for [`push_scope`](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/fn-push-scope).
* [ScopeAttributes](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/struct-scopeattributes): Bitflags that modify scope behavior and observability.
* [ScopeHandle](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/struct-scopehandle): Runtime-owned handle identifying an active or completed scope.
* [ScopeStackEntry](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/struct-scopestackentry): Identity of one entry in the visible Relay scope stack.
* [ScopeStackSnapshot](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/struct-scopestacksnapshot): Owned root-to-top values from one coherent read of a visible scope stack.

## Enums

* [HandleAttributes](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/enum-handleattributes): Attribute bitflags attached to a concrete handle kind.
* [ScopeType](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/enum-scopetype): Semantic category attached to a scope lifecycle span.

## Constants

* [COMPACTION_EVENT_NAME](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/constant-compaction-event-name): Canonical mark-event name used to indicate agent context compaction.

## Functions

* [event](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/fn-event): Emit a standalone mark event under the current or provided scope.
* [get_handle](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/fn-get-handle): Return the current scope at the top of the active stack.
* [metric](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/fn-metric): Emit a Relay metric mark under the current or provided scope.
* [pop_scope](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/fn-pop-scope): Pop the current scope from the active scope stack.
* [push_scope](/nemo/relay/dev/reference/api/rust-library-reference/nemo-relay/scope/fn-push-scope): Push a new scope onto the active scope stack.