Skip to main content

RuntimePackage

Struct RuntimePackage 

Source
pub struct RuntimePackage {
Show 15 fields pub schema_version: u16, pub package_id: RuntimePackageId, pub agent: AgentSnapshot, pub provider_route: ProviderRouteSnapshot, pub provider_capabilities: ProviderCapabilitySnapshot, pub output_contracts: Vec<OutputContractSnapshot>, pub output_sinks: Vec<OutputSinkSnapshot>, pub capabilities: Vec<CapabilitySpec>, pub sidecars: Vec<PackageSidecarSnapshot>, pub isolation_requirements: Vec<IsolationRequirementSnapshot>, pub catalogs: Vec<CapabilityCatalogSnapshot>, pub child_lifecycle: ChildLifecyclePolicySnapshot, pub policies: PolicySnapshot, pub fingerprint_manifest: FingerprintInputManifest, pub volatile: VolatileRuntimeFields,
}
Expand description

Describes the runtime package portion of a runtime package snapshot. Use it when package authors or tests need explicit package configuration; validation and activation happen in package/runtime coordinators.

Fields§

§schema_version: u16

Wire schema version used for compatibility checks.

§package_id: RuntimePackageId

Runtime package identifier for the immutable per-run package snapshot.

§agent: AgentSnapshot

Agent snapshot frozen into this package or record.

§provider_route: ProviderRouteSnapshot

Provider route snapshot selected for this runtime package.

§provider_capabilities: ProviderCapabilitySnapshot

Provider capability hints frozen into this package snapshot.

§output_contracts: Vec<OutputContractSnapshot>

Output contracts frozen into this package or request.

§output_sinks: Vec<OutputSinkSnapshot>

Output sink snapshots available to this run.

§capabilities: Vec<CapabilitySpec>

Capabilities frozen into the package or returned by an adapter health check.

§sidecars: Vec<PackageSidecarSnapshot>

Typed sidecar snapshots included in a package or delta.

§isolation_requirements: Vec<IsolationRequirementSnapshot>

Isolation requirements frozen into the package snapshot.

§catalogs: Vec<CapabilityCatalogSnapshot>

Catalog snapshots contributed to or returned with a runtime package delta.

§child_lifecycle: ChildLifecyclePolicySnapshot

Child-run lifecycle policy frozen into the package snapshot.

§policies: PolicySnapshot

Policies used by this record or request.

§fingerprint_manifest: FingerprintInputManifest

Manifest describing which fields entered or were excluded from fingerprinting.

§volatile: VolatileRuntimeFields

Volatile used by this record or request.

Implementations§

Source§

impl RuntimePackage

Source

pub fn builder(package_id: RuntimePackageId) -> RuntimePackageBuilder

Starts a builder for this package value. Building is data-only; runtime side effects occur only when a later coordinator or host port executes the built configuration.

Source

pub fn for_agent( agent_id: AgentId, agent_name: impl Into<String>, ) -> RuntimePackageBuilder

Returns for agent for the current value. This is a read-only or data-construction helper unless the method body explicitly calls a port or store.

Source

pub fn canonical_snapshot( &self, ) -> Result<RuntimePackageCanonicalV1, AgentError>

Computes the stable canonical snapshot for this package value. The computation is deterministic and side-effect free so it can be used in package, journal, or test evidence.

Source

pub fn fingerprint(&self) -> Result<RuntimePackageFingerprint, AgentError>

Computes the stable fingerprint for this package value. The computation is deterministic and side-effect free so it can be used in package, journal, or test evidence.

Source

pub fn validate(&self) -> Result<(), AgentError>

Validates the package invariants and returns a typed error on failure. Validation is pure and does not perform I/O, dispatch, journal appends, or adapter calls.

Source

pub fn provider_tool_specs( &self, ) -> Result<Vec<ProviderCapabilityProjection>, AgentError>

Returns provider tool specs for the current value. This is a read-only or data-construction helper unless the method body explicitly calls a port or store.

Source

pub fn executable_routes( &self, ) -> Result<Vec<ExecutableCapabilityRoute>, AgentError>

Returns executable routes for the current value. This is a read-only or data-construction helper unless the method body explicitly calls a port or store.

Source

pub fn sidecar(&self, sidecar_id: &str) -> Option<&PackageSidecarSnapshot>

Returns sidecar for the current value. This is a read-only or data-construction helper unless the method body explicitly calls a port or store.

Source

pub fn with_output_contract( self, output_contract: &OutputContract, ) -> Result<Self, AgentError>

Returns this value with its output contract setting replaced. The method follows builder-style data construction and does not execute external work.

Source

pub fn catalog(&self, catalog_id: &str) -> Option<&CapabilityCatalogSnapshot>

Returns catalog for the current value. This is a read-only or data-construction helper unless the method body explicitly calls a port or store.

Source

pub fn apply_delta(&self, delta: PackageDelta) -> Result<Self, AgentError>

Validates a package delta against this snapshot and returns a new runtime package. The method is pure with respect to the existing package and does not mutate ambient registries or execute activated capabilities.

Source

pub fn conformance_report( &self, ) -> Result<RuntimePackageConformanceReport, AgentError>

Returns conformance report for the current value. This is a read-only or data-construction helper unless the method body explicitly calls a port or store.

Trait Implementations§

Source§

impl Clone for RuntimePackage

Source§

fn clone(&self) -> RuntimePackage

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 RuntimePackage

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'de> Deserialize<'de> for RuntimePackage

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl PartialEq for RuntimePackage

Source§

fn eq(&self, other: &RuntimePackage) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl Serialize for RuntimePackage

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl Eq for RuntimePackage

Source§

impl StructuralPartialEq for RuntimePackage

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<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> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

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> 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 = Infallible

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

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

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<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,