Struct DiscoveredSoftware 

pub struct DiscoveredSoftware {
    pub package_identifier: String,
    pub name: String,
    pub installed_version: String,
    pub targets: Vec<DiscoveryTarget>,
    pub extra: Option<Value>,
    pub qualifier: Option<String>,
    pub plugin_package_identifier: Option<String>,
    pub featured: bool,
    pub installed_display_version: Option<String>,
}

A piece of software discovered on the local system by a plugin.

installed_version is required — plugins that cannot determine a version must omit the item from results entirely.

This type is the canonical shared definition used in both the agent/plugin layer and the wire protocol. The uptrakit-plugin-core crate re-exports it.

Discovery targets

The targets field drives plugin-config creation and role assignment on the controller. When non-empty, the controller processes each target generically (find-or-create plugin config, create role assignments). When empty, the controller falls back to the plugin_config_id on the enclosing DiscoveryPluginResult.

The extra field is purely informational metadata (e.g. Docker’s container names) — the controller never interprets it for config synthesis.

Per-row qualifier

The qualifier field selects which host_software_item row to create or reuse. None = unqualified (default behaviour, one row per software item per host). Docker uses the container name here so that each container gets its own tracking row even when multiple containers run the same image.

Plugin package identifier

plugin_package_identifier, when set, overrides package_identifier as the value stored in host_software_item_plugin.package_identifier for plugin operations. None = use package_identifier (existing behaviour).

Pinning

When featured is true, the controller marks the software item as featured on first creation so it gets individual MQTT entities and prominent visibility. Default false — item starts unfeatured (bulk/aggregate view only). The controller only applies featured: true when creating a new software_items row. Subsequent discoveries do not override a user’s manual feature/unfeature choice.

Fields

package_identifier: String

Plugin-specific identifier for this software (e.g., package name, app slug).

name: String

Human-readable display name.

installed_version: String

Currently installed version (required; plugins omit items with unknown versions).

targets: Vec<DiscoveryTarget>

Target plugin configurations for managing this item.

Empty = use the discovering plugin’s own config for all roles.

extra: Option<Value>

Optional informational metadata (not used for config synthesis).

Example: Docker’s {"containers": ["web-server"]}.

qualifier: Option<String>

Row discriminator within host_software_items.

None = unqualified (default). Docker sets this to the container name so that each container produces its own host_software_item row even when multiple containers run the same image.

plugin_package_identifier: Option<String>

Override for the package_identifier stored in host_software_item_plugin.package_identifier.

None = use package_identifier (existing behaviour).

featured: bool

When true, the controller marks the software item as featured on first creation. Default false — item starts unfeatured.

installed_display_version: Option<String>

Plugin-provided display version for the installed version (e.g. Docker image publish date). None when the plugin cannot determine a display version during discovery.

Trait Implementations

impl Clone for DiscoveredSoftware

fn clone(&self) -> DiscoveredSoftware

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DiscoveredSoftware

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DiscoveredSoftware

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for DiscoveredSoftware

impl PartialEq for DiscoveredSoftware

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Serialize for DiscoveredSoftware

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for DiscoveredSoftware

impl WireValidate for DiscoveredSoftware

fn wire_validate(&self) -> Result<(), WireValidationError>

Validate that all fields are within wire protocol size limits.