Method remove

crates/core/src/api/runtime/scope_stack.rs:125–150

Remove the current top scope if it matches `uuid`. # Parameters - `uuid`: UUID of the scope expected to be at the top of the stack. # Returns A [`Result`] containing the removed [`ScopeHandle`]. # Errors Returns [`FlowError::InvalidArgument`] when the scope exists but is not the current top of the stack or when the caller attempts to remove the implicit root scope. Returns [`FlowError::NotFound

(&mut self, uuid: &Uuid)

    /// implicit root scope. Returns [`FlowError::NotFound`] when the UUID is
    /// not present on the stack.
    pub fn remove(&mut self, uuid: &Uuid) -> Result<ScopeHandle> {
        let top = self
            .stack
            .last()
            .expect("scope stack should never be empty");
        if top.uuid == *uuid {
            if self.stack.len() == 1 {
                return Err(FlowError::InvalidArgument(
                    "root scope cannot be removed".into(),
                ));
            }
            self.scope_registries.remove(uuid);
            return Ok(self
                .stack
                .pop()
                .expect("scope stack should contain a removable top scope"));
        }

        if self.stack.iter().any(|handle| handle.uuid == *uuid) {
            return Err(FlowError::InvalidArgument(
                "scope handle is not at the top of the stack".into(),
            ));
        }

        Err(FlowError::NotFound("scope handle not found".into()))
    }

    /// Get or create the scope-local registries for an active scope.
    ///