Skip to main content

ProviderNativeAgentGraph

Struct ProviderNativeAgentGraph 

Source
pub struct ProviderNativeAgentGraph { /* private fields */ }
Expand description

Compiled schemas, state machine, and declarative graph for one agent version.

Implementations§

Source§

impl ProviderNativeAgentGraph

Source

pub const MAX_CHECKPOINT_INVOCATION_REFERENCES: u64 = MAX_CHECKPOINT_INVOCATION_REFERENCES

Maximum tool invocation references retained across one checkpoint.

Source

pub fn compile( descriptor: AgentDescriptor, graph_identity: CapabilityIdentity, reducer_identity: CapabilityIdentity, state_schema_id: SchemaId, input_security_label: SecurityLabel, policy: Arc<dyn AgentToolPolicy>, accounting: Arc<dyn AgentInvocationAccounting>, ) -> Result<Self, ProviderNativeAgentGraphBuildError>

Compiles the supported v1 provider-native execution subset.

V1 deliberately rejects tool-call emulated final output. Model-native structured output supports finite durable repair turns. Sequential Tools and bounded parallel read-only Tools are supported without allowing writes or completion timing to reorder the durable transcript.

Source

pub const fn graph(&self) -> &CompiledGraph

Returns the exact compiled graph.

Source

pub const fn descriptor(&self) -> &AgentDescriptor

Returns the immutable agent descriptor snapshot.

Source

pub const fn contract_digest(&self) -> Digest

Returns the exact graph composition checksum.

Source

pub fn register_schema( &self, builder: &mut JsonSchemaRegistryBuilder, ) -> Result<(), JsonSchemaRegistryError>

Registers the generated state/update schema before the registry freezes.

Source

pub fn register_executable( &self, builder: &mut ExecutableGraphRegistryBuilder, store: PostgresStore, invocation_executor: DurableInvocationExecutor, schemas: JsonSchemaRegistry, ) -> Result<(), ProviderNativeAgentRegistrationError>

Registers the graph, reducer, and both executable nodes into one frozen deployment snapshot.

The supplied schema registry must be the exact registry used to create builder and must already contain the generated state schema, the descriptor input/output/tool schemas, and the standard invocation event schema. Registry closure is rechecked again when the builder freezes.

Source

pub fn initial_state( &self, ) -> Result<CheckpointState, ProviderNativeAgentStateError>

Generates a fresh bounded initial state before durable admission.

Source

pub fn restore_state( &self, state: &CheckpointState, ) -> Result<ProviderNativeAgentState, ProviderNativeAgentStateError>

Decodes and revalidates a checkpoint against this exact compiled composition contract.

This is the supported inspection boundary for recovery tooling; callers never need to duplicate the generated schema or state invariants.

Trait Implementations§

Source§

impl AgentServiceDeployment for ProviderNativeAgentGraph

Source§

fn descriptor(&self) -> &AgentDescriptor

Returns the immutable Agent descriptor selected at public ingress.
Source§

fn graph(&self) -> &CompiledGraph

Returns the exact executable graph pinned into durable admission.
Source§

fn initial_state(&self) -> Result<CheckpointState, AgentServiceDeploymentError>

Generates fresh bounded initial state for one candidate submission.
Source§

impl Clone for ProviderNativeAgentGraph

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for ProviderNativeAgentGraph

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DynClone for T
where T: Clone,

Source§

fn __clone_box(&self, _: Private) -> *mut ()

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more