> This page is for NeMo Relay, version v0.10.0. > For other versions, use one of these documentation indexes: > - Latest (v0.10.0) (default): https://docs.nvidia.com/nemo/relay/latest/llms.txt > - dev: https://docs.nvidia.com/nemo/relay/dev/llms.txt > - v0.10.0: https://docs.nvidia.com/nemo/relay/v0.10.0/llms.txt > - v0.9.4: https://docs.nvidia.com/nemo/relay/v0.9.4/llms.txt > - v0.8.4: https://docs.nvidia.com/nemo/relay/v0.8.4/llms.txt > - v0.7.3: https://docs.nvidia.com/nemo/relay/v0.7.3/llms.txt > - v0.6.0: https://docs.nvidia.com/nemo/relay/v0.6.0/llms.txt > - v0.5.0: https://docs.nvidia.com/nemo/relay/v0.5.0/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.nvidia.com/nemo/relay/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo/relay/_mcp/server. # Module dynamic > Dynamic plugin control-plane and registry model. 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](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginfailure): One structured recent failure summary. * [DynamicPluginHostPolicy](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginhostpolicy): Effective host policy for dynamic plugins. * [DynamicPluginHostPolicyEffect](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginhostpolicyeffect): A partial policy effect that may overlay another effect. * [DynamicPluginHostPolicyRule](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginhostpolicyrule): One ordered policy rule. * [DynamicPluginManifest](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginmanifest): Authored `relay-plugin.toml` manifest. * [DynamicPluginManifestCapabilities](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginmanifestcapabilities): Capability declarations for authored manifests. * [DynamicPluginManifestCompat](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginmanifestcompat): Compatibility block for `relay-plugin.toml`. * [DynamicPluginManifestConfigSchema](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginmanifestconfigschema): Static configuration schema block for authored manifests. * [DynamicPluginManifestDefaults](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginmanifestdefaults): Defaults block for authored manifests. * [DynamicPluginManifestIntegrity](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginmanifestintegrity): Integrity/authenticity evidence block for authored manifests. * [DynamicPluginManifestPlugin](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginmanifestplugin): Plugin identity block for `relay-plugin.toml`. * [DynamicPluginManifestRustDynamicLoad](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginmanifestrustdynamicload): Native shared-library authored load block. * [DynamicPluginManifestSource](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginmanifestsource): Source block for authored manifests. * [DynamicPluginManifestWorkerLoad](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginmanifestworkerload): Worker lane authored load block. * [DynamicPluginMetadata](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginmetadata): Stable metadata for one durable plugin record. * [DynamicPluginRecord](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginrecord): Durable control-plane record for a dynamic plugin. * [DynamicPluginRegistry](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginregistry): In-memory dynamic plugin registry used by the control plane. * [DynamicPluginRuntimeStatus](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginruntimestatus): Observed runtime state for one plugin record. * [DynamicPluginRustCompatibility](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginrustcompatibility): Compatibility contract for native shared libraries. * [DynamicPluginRustLoadContract](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginrustloadcontract): Lane-specific load contract for native shared libraries. * [DynamicPluginSource](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginsource): Source and resolved artifact facts for a plugin. * [DynamicPluginSpec](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginspec): Desired-state fields owned by user-facing operations. * [DynamicPluginStatus](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginstatus): Durable observed state for a plugin record. * [DynamicPluginValidationReport](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginvalidationreport): One validation result produced by core before dynamic code is loaded. * [DynamicPluginValidationStatus](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginvalidationstatus): Decomposed validation results for one plugin record. * [DynamicPluginWorkerCompatibility](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginworkercompatibility): Compatibility contract for worker plugins. * [DynamicPluginWorkerLoadContract](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-dynamicpluginworkerloadcontract): Lane-specific load contract for worker plugins. * [EvaluatedDynamicPluginHostPolicy](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-evaluateddynamicpluginhostpolicy): The result of applying the effective host policy to one manifest. * [EvaluatedDynamicPluginTrust](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-evaluateddynamicplugintrust): Result of integrity and authenticity verification. * [FileDynamicPluginHostPolicy](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-filedynamicpluginhostpolicy): The TOML representation accepted below `[plugins.policy]`. * [FileDynamicPluginHostPolicyEffect](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-filedynamicpluginhostpolicyeffect): File-level partial policy effect. * [FileDynamicPluginHostPolicyRule](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-filedynamicpluginhostpolicyrule): File-level ordered policy rule. * [NativePluginActivation](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-nativepluginactivation): Owns native dynamic libraries registered into the plugin registry. * [NativePluginLoadSpec](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-nativepluginloadspec): Native plugin load request derived from host dynamic-plugin state. * [PluginHostActivation](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-pluginhostactivation): Owns one process-wide dynamic plugin configuration and its loaded runtimes. * [PluginHostReport](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-pluginhostreport): Combined static and dynamic host report. * [VerifiedDynamicPluginSpec](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-verifieddynamicpluginspec): One dynamic plugin component to load and activate in an embedding host. * [WorkerPluginActivation](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-workerpluginactivation): Owns gRPC worker processes registered into the plugin registry. * [WorkerPluginLoadSpec](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/struct-workerpluginloadspec): Worker plugin load request derived from host dynamic-plugin state. ## Enums * [DynamicPluginAttestationMode](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/enum-dynamicpluginattestationmode): Host attestation policy mode. * [DynamicPluginCapability](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/enum-dynamicplugincapability): Relay-enforced capability declared by a dynamic plugin. * [DynamicPluginCheckState](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/enum-dynamicplugincheckstate): High-level verification state for one validation axis. * [DynamicPluginCompatibility](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/enum-dynamicplugincompatibility): Lane-specific compatibility declarations and resolved compatibility facts. * [DynamicPluginFailurePhase](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/enum-dynamicpluginfailurephase): Recent failure phase for diagnostics and operator UX. * [DynamicPluginHostPolicyFailure](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/enum-dynamicpluginhostpolicyfailure): A policy refusal. * [DynamicPluginKind](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/enum-dynamicpluginkind): Plugin execution lane. * [DynamicPluginLoadContract](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/enum-dynamicpluginloadcontract): Runtime entry contract for the resolved plugin. * [DynamicPluginManifestLoad](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/enum-dynamicpluginmanifestload): Load block for authored manifests. * [DynamicPluginRuntimeState](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/enum-dynamicpluginruntimestate): Observed runtime state for a dynamic plugin. * [DynamicPluginStartupClass](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/enum-dynamicpluginstartupclass): Host policy startup classification for a plugin. * [DynamicPluginTrustFailure](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/enum-dynamicplugintrustfailure): A failed artifact trust check. * [WorkerRuntime](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/enum-workerruntime): Managed runtime identity for worker-based plugins. ## Constants * [DYNAMIC\_PLUGIN\_MANIFEST\_FILENAME](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/constant-dynamic-plugin-manifest-filename): Canonical filename for authored Relay plugin manifests. * [MAX\_DYNAMIC\_PLUGIN\_FILE\_BYTES](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/constant-max-dynamic-plugin-file-bytes): Maximum accepted size for one plugin manifest, artifact, schema, or signature. ## Functions * [evaluate\_dynamic\_plugin\_host\_policy](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/fn-evaluate-dynamic-plugin-host-policy): Evaluates a dynamic plugin manifest against a resolved host policy. * [evaluate\_dynamic\_plugin\_trust](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/fn-evaluate-dynamic-plugin-trust): Validates the manifest artifact under the already-evaluated host policy. * [initialize](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/fn-initialize): Initializes the process-wide static and dynamic plugin host. * [load\_native\_plugins](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/fn-load-native-plugins): Loads native dynamic plugins and registers their plugin kinds. * [load\_worker\_plugins](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/fn-load-worker-plugins): Loads gRPC worker plugins and registers their plugin kinds. * [read\_bounded\_regular\_file](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/fn-read-bounded-regular-file): Reads a regular file without following a Unix symlink and with a fixed byte budget. * [read\_regular\_file\_with\_limit](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/fn-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](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/fn-resolve-dynamic-plugin-artifact-path): Resolves an artifact or signature reference relative to its manifest. * [stream\_bounded\_regular\_file](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/fn-stream-bounded-regular-file): Streams a regular file through `consume` with a fixed byte budget. * [stream\_regular\_file\_with\_limit](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/fn-stream-regular-file-with-limit): Streams a regular file through `consume` with a caller-provided byte budget. * [validate](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/fn-validate): Validates the process-wide static and dynamic plugin host. * [validate\_dynamic\_plugin\_config\_schema](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/fn-validate-dynamic-plugin-config-schema): Validates dynamic component configuration against its manifest-declared local schema. * [validate\_exact](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/fn-validate-exact): Validates only the supplied static plugin configuration. ## Type Aliases * [DynamicPluginId](/reference/api/rust-library-reference/nemo-relay/plugin/dynamic/type-dynamicpluginid): Canonical identifier for one dynamic plugin record.