Module dynamic

Generated from cargo doc --no-deps -p nemo-relay -p nemo-relay-adaptive -p nemo-relay-pii-redaction -p nemo-relay-ffi -p nemo-relay-types -p nemo-relay-plugin -p nemo-relay-worker-proto -p nemo-relay-worker.

Dynamic plugin control-plane and registry model.

This module owns the durable control-plane record shape for dynamic plugins. Authored manifest parsing/validation and in-memory registry mutation logic live in dedicated submodules so those responsibilities do not accumulate in one file as the feature grows.

Structs

• DynamicPluginFailure: One structured recent failure summary.
• DynamicPluginHostPolicy: Effective host policy for dynamic plugins.
• DynamicPluginHostPolicyEffect: A partial policy effect that may overlay another effect.
• DynamicPluginHostPolicyRule: One ordered policy rule.
• DynamicPluginManifest: Authored relay-plugin.toml manifest.
• DynamicPluginManifestCapabilities: Capability declarations for authored manifests.
• DynamicPluginManifestCompat: Compatibility block for relay-plugin.toml.
• DynamicPluginManifestConfigSchema: Static configuration schema block for authored manifests.
• DynamicPluginManifestDefaults: Defaults block for authored manifests.
• DynamicPluginManifestIntegrity: Integrity/authenticity evidence block for authored manifests.
• DynamicPluginManifestPlugin: Plugin identity block for relay-plugin.toml.
• DynamicPluginManifestRustDynamicLoad: Native shared-library authored load block.
• DynamicPluginManifestSource: Source block for authored manifests.
• DynamicPluginManifestWorkerLoad: Worker lane authored load block.
• DynamicPluginMetadata: Stable metadata for one durable plugin record.
• DynamicPluginRecord: Durable control-plane record for a dynamic plugin.
• DynamicPluginRegistry: In-memory dynamic plugin registry used by the control plane.
• DynamicPluginRuntimeStatus: Observed runtime state for one plugin record.
• DynamicPluginRustCompatibility: Compatibility contract for native shared libraries.
• DynamicPluginRustLoadContract: Lane-specific load contract for native shared libraries.
• DynamicPluginSource: Source and resolved artifact facts for a plugin.
• DynamicPluginSpec: Desired-state fields owned by user-facing operations.
• DynamicPluginStatus: Durable observed state for a plugin record.
• DynamicPluginValidationReport: One validation result produced by core before dynamic code is loaded.
• DynamicPluginValidationStatus: Decomposed validation results for one plugin record.
• DynamicPluginWorkerCompatibility: Compatibility contract for worker plugins.
• DynamicPluginWorkerLoadContract: Lane-specific load contract for worker plugins.
• EvaluatedDynamicPluginHostPolicy: The result of applying the effective host policy to one manifest.
• EvaluatedDynamicPluginTrust: Result of integrity and authenticity verification.
• FileDynamicPluginHostPolicy: The TOML representation accepted below [plugins.policy].
• FileDynamicPluginHostPolicyEffect: File-level partial policy effect.
• FileDynamicPluginHostPolicyRule: File-level ordered policy rule.
• NativePluginActivation: Owns native dynamic libraries registered into the plugin registry.
• NativePluginLoadSpec: Native plugin load request derived from host dynamic-plugin state.
• PluginHostActivation: Owns one process-wide dynamic plugin configuration and its loaded runtimes.
• PluginHostReport: Combined static and dynamic host report.
• VerifiedDynamicPluginSpec: One dynamic plugin component to load and activate in an embedding host.
• WorkerPluginActivation: Owns gRPC worker processes registered into the plugin registry.
• WorkerPluginLoadSpec: Worker plugin load request derived from host dynamic-plugin state.

Enums

• DynamicPluginAttestationMode: Host attestation policy mode.
• DynamicPluginCapability: Relay-enforced capability declared by a dynamic plugin.
• DynamicPluginCheckState: High-level verification state for one validation axis.
• DynamicPluginCompatibility: Lane-specific compatibility declarations and resolved compatibility facts.
• DynamicPluginFailurePhase: Recent failure phase for diagnostics and operator UX.
• DynamicPluginHostPolicyFailure: A policy refusal.
• DynamicPluginKind: Plugin execution lane.
• DynamicPluginLoadContract: Runtime entry contract for the resolved plugin.
• DynamicPluginManifestLoad: Load block for authored manifests.
• DynamicPluginRuntimeState: Observed runtime state for a dynamic plugin.
• DynamicPluginStartupClass: Host policy startup classification for a plugin.
• DynamicPluginTrustFailure: A failed artifact trust check.
• WorkerRuntime: Managed runtime identity for worker-based plugins.

Constants

• DYNAMIC_PLUGIN_MANIFEST_FILENAME: Canonical filename for authored Relay plugin manifests.
• MAX_DYNAMIC_PLUGIN_FILE_BYTES: Maximum accepted size for one plugin manifest, artifact, schema, or signature.

Functions

• evaluate_dynamic_plugin_host_policy: Evaluates a dynamic plugin manifest against a resolved host policy.
• evaluate_dynamic_plugin_trust: Validates the manifest artifact under the already-evaluated host policy.
• initialize: Initializes the process-wide static and dynamic plugin host.
• load_native_plugins: Loads native dynamic plugins and registers their plugin kinds.
• load_worker_plugins: Loads gRPC worker plugins and registers their plugin kinds.
• read_bounded_regular_file: Reads a regular file without following a Unix symlink and with a fixed byte budget.
• read_regular_file_with_limit: Reads a regular file without following a Unix symlink and with a caller-provided byte budget.
• resolve_dynamic_plugin_artifact_path: Resolves an artifact or signature reference relative to its manifest.
• stream_bounded_regular_file: Streams a regular file through consume with a fixed byte budget.
• stream_regular_file_with_limit: Streams a regular file through consume with a caller-provided byte budget.
• validate: Validates the process-wide static and dynamic plugin host.
• validate_dynamic_plugin_config_schema: Validates dynamic component configuration against its manifest-declared local schema.
• validate_exact: Validates only the supplied static plugin configuration.

Type Aliases

• DynamicPluginId: Canonical identifier for one dynamic plugin record.