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: u16Wire schema version used for compatibility checks.
package_id: RuntimePackageIdRuntime package identifier for the immutable per-run package snapshot.
agent: AgentSnapshotAgent snapshot frozen into this package or record.
provider_route: ProviderRouteSnapshotProvider route snapshot selected for this runtime package.
provider_capabilities: ProviderCapabilitySnapshotProvider 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: ChildLifecyclePolicySnapshotChild-run lifecycle policy frozen into the package snapshot.
policies: PolicySnapshotPolicies used by this record or request.
fingerprint_manifest: FingerprintInputManifestManifest describing which fields entered or were excluded from fingerprinting.
volatile: VolatileRuntimeFieldsVolatile used by this record or request.
Implementations§
Source§impl RuntimePackage
impl RuntimePackage
Sourcepub fn builder(package_id: RuntimePackageId) -> RuntimePackageBuilder
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.
Sourcepub fn for_agent(
agent_id: AgentId,
agent_name: impl Into<String>,
) -> RuntimePackageBuilder
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.
Sourcepub fn canonical_snapshot(
&self,
) -> Result<RuntimePackageCanonicalV1, AgentError>
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.
Sourcepub fn fingerprint(&self) -> Result<RuntimePackageFingerprint, AgentError>
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.
Sourcepub fn validate(&self) -> Result<(), AgentError>
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.
Sourcepub fn provider_tool_specs(
&self,
) -> Result<Vec<ProviderCapabilityProjection>, AgentError>
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.
Sourcepub fn executable_routes(
&self,
) -> Result<Vec<ExecutableCapabilityRoute>, AgentError>
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.
Sourcepub fn sidecar(&self, sidecar_id: &str) -> Option<&PackageSidecarSnapshot>
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.
Sourcepub fn with_output_contract(
self,
output_contract: &OutputContract,
) -> Result<Self, AgentError>
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.
Sourcepub fn catalog(&self, catalog_id: &str) -> Option<&CapabilityCatalogSnapshot>
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.
Sourcepub fn apply_delta(&self, delta: PackageDelta) -> Result<Self, AgentError>
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.
Sourcepub fn conformance_report(
&self,
) -> Result<RuntimePackageConformanceReport, AgentError>
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
impl Clone for RuntimePackage
Source§fn clone(&self) -> RuntimePackage
fn clone(&self) -> RuntimePackage
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moreSource§impl Debug for RuntimePackage
impl Debug for RuntimePackage
Source§impl<'de> Deserialize<'de> for RuntimePackage
impl<'de> Deserialize<'de> for RuntimePackage
Source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
Source§impl PartialEq for RuntimePackage
impl PartialEq for RuntimePackage
Source§fn eq(&self, other: &RuntimePackage) -> bool
fn eq(&self, other: &RuntimePackage) -> bool
self and other values to be equal, and is used by ==.