Struct ClientPluginCustomization 

pub struct ClientPluginCustomization {

    pub id: String,
    pub uri: Uri,
    pub name: String,
    pub icons: Option<Vec<Icon>>,
    pub range: Option<TextRange>,
    pub meta: Option<JsonObject>,
    pub client_id: Option<String>,
    pub load: Option<CustomizationLoadState>,
    pub children: Option<Vec<ChildCustomization>>,
    pub enablement: Option<Vec<CustomizationEnablement>>,
    pub version: Option<String>,
    pub nonce: Option<String>,
    pub child_enablement: Option<HashMap<String, Vec<CustomizationEnablement>>>,
}

A {@link PluginCustomization} as published by a client. Extends the server-facing shape with an opaque nonce so the host can detect when the client’s view of a plugin has changed and re-parse only as needed.

Clients SHOULD include a nonce. Server-side fields like {@link ContainerCustomizationBase.children | children} and {@link ContainerCustomizationBase.load | load} are typically left absent on publication and populated by the host when the resolved plugin appears in {@link SessionState.customizations}.

Fields

id: String

Session-unique opaque identifier. Used by every action that targets a specific customization. Minted by whoever publishes the customization (typically the agent host).

uri: Uri

Source URI for this customization. A plugin URL, a file URI, or a directory URI.

For declarations that live inside a larger file — e.g. an MCP server declared inline in a plugins.json manifest — uri points to the containing file and {@link CustomizationBase.range | range} narrows it to the declaration’s span.

name: String

Human-readable name.

icons: Option<Vec<Icon>>

Icons for UI display.

range: Option<TextRange>

Optional span within {@link CustomizationBase.uri | uri} when this customization is a subset of a larger file (for example, one entry in an inline mcpServers block of a plugins.json manifest). Absent when the customization covers the whole resource.

meta: Option<JsonObject>

Additional provider-specific metadata for this customization.

Mirrors the MCP _meta convention. Optional and opaque to the protocol; producers and consumers agree on its contents out-of-band.

client_id: Option<String>

clientId of the client that contributed this container. Absent for server-originated entries.

load: Option<CustomizationLoadState>

Host-reported load state. Absent means the host has not yet reported a load state for this container.

children: Option<Vec<ChildCustomization>>

Children discovered inside this container.

Absent means the host has not parsed this container yet. An empty array means the host parsed the container and it contributes nothing.

enablement: Option<Vec<CustomizationEnablement>>

Explicit enablement decisions. See {@link McpServerCustomization.enablement}.

version: Option<String>

Version of the plugin, sourced from the Open Plugins manifest’s optional version field (semver, e.g. "1.2.0"). Absent when the manifest declares no version — the field is optional there — or the source has no version concept. Provenance / display only: the host neither parses nor enforces it.

nonce: Option<String>

Opaque version token used by the host to detect changes.

child_enablement: Option<HashMap<String, Vec<CustomizationEnablement>>>

Explicit enablement decisions for children this plugin contributes, keyed by child name (for MCP servers, the server name as it appears in the bundled .mcp.json).

Bundled children are discovered by the host rather than published by the client, so the client cannot attach enablement to them directly. This carries the client’s global decision for each one; the host applies it under the child’s durable key.

Trait Implementations

impl Clone for ClientPluginCustomization

fn clone(&self) -> ClientPluginCustomization

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientPluginCustomization

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ClientPluginCustomization

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ClientPluginCustomization

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ClientPluginCustomization

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ClientPluginCustomization