Function push_scope

Generated from cargo doc --no-deps -p nemo-relay -p nemo-relay-adaptive -p nemo-relay-ffi.

pub fn push_scope(params: PushScopeParams<'_>) -> Result<ScopeHandle>

Push a new scope onto the active scope stack.

This creates a new ScopeHandle, emits a scope-start event to global and scope-local subscribers, and makes the new scope the current top of stack.

Parameters

• name: Human-readable scope name recorded on emitted lifecycle events.
• scope_type: Semantic category for the new scope.
• parent: Optional explicit parent scope. When None, the current top of stack is used as the parent.
• attributes: Bitflags that modify scope behavior and observability.
• data: Optional application payload stored on the returned handle.
• metadata: Optional JSON metadata recorded on the emitted start event.
• input: Optional JSON payload exported as the Agent Trajectory Observability Format (ATOF) data payload.
• timestamp: Optional timestamp recorded as the handle start time and on the emitted start event. When None, the current UTC time is used.

Returns

A Result containing the newly created ScopeHandle.

Errors

Returns an error when the runtime owner check fails or when internal state cannot be read safely.

Notes

Scope-local subscribers attached to ancestor scopes observe the emitted start event before the function returns.