Struct CompositionContext 

pub struct CompositionContext { /* private fields */ }

Host context supplied to a composition request. It is not deserialized from the model response and therefore cannot be expanded by model text.

Implementations

impl CompositionContext

pub fn new(surface_id: impl Into<String>) -> Result<Self, CompositionError>

pub fn scoped( surface_id: impl Into<String>, session_id: impl Into<String>, principal: impl Into<String>, context_id: impl Into<String>, generation: u64, ) -> Result<Self, CompositionError>

Create a context bound to a session, principal, and monotonic context generation. These values are host-owned and never model-deserializable.

pub fn insert_data( &mut self, handle: TrustedDataHandle, ) -> Result<(), CompositionError>

pub fn insert_action( &mut self, handle: TrustedActionHandle, ) -> Result<(), CompositionError>

pub fn replace_data( &mut self, handle: impl Into<String>, generation: u64, component: Component, ) -> Result<(), CompositionError>

pub fn replace_action( &mut self, handle: impl Into<String>, action: Action, ) -> Result<(), CompositionError>

pub fn revoke_action(&mut self, handle: &str) -> bool

pub fn require_data_handle( &mut self, handle: &str, ) -> Result<(), CompositionError>

Mark a host-owned data projection as mandatory. A model proposal that omits it, duplicates it, or hides it under an unsupported subtree is rejected before a Surface is accepted.

pub fn require_authority_ref( &mut self, handle: &str, ) -> Result<(), CompositionError>

pub fn require_action_handle( &mut self, handle: &str, ) -> Result<(), CompositionError>

pub fn advance_generation( &mut self, generation: u64, ) -> Result<(), CompositionError>

pub fn session_id(&self) -> &str

pub fn principal(&self) -> &str

pub fn context_id(&self) -> &str

pub fn generation(&self) -> u64

pub fn required_authority_refs(&self) -> Vec<String>

pub fn surface_id(&self) -> &str

pub fn prompt(&self) -> Result<CompositionPrompt, CompositionError>

Build a provider-neutral prompt projection. Authoritative strings are nested under untrusted_content; they are data, never instructions.

Trait Implementations

impl Clone for CompositionContext

fn clone(&self) -> CompositionContext

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CompositionContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.