Enum NodeRef 

pub enum NodeRef {
    Plain(String),
    Keyed {
        name: String,
        instance_id: Option<String>,
        camera_id: Option<String>,
    },
}

A single entry in a target’s node list, either a plain node identifier or a named instance for a node that needs to run as more than one instance under the same target.

Variants

Plain(String)

A node running as its default, single instance.

Keyed

A node running as one of several keyed instances of the same node type, and/or with a camera_id override (video-streamer’s relay/diagnostics identity). LAB-4747 tracks letting one video-streamer process stream multiple cameras at once - a separate, not-yet-started follow-up to this field. instance_id and camera_id are deliberately independent: instance_id is this process’s own identity (so e.g. two video-streamer processes under the same robot_id don’t collide in the dashboard’s node registry), while camera_id is purely which camera this video-streamer reports to the relay - the two never need to match, and either can be set without the other.

Fields

name: String

Node identifier (e.g. @mecha10/camera).

instance_id: Option<String>

Which instance of name this is (e.g. real or sim). Optional - a keyed entry may exist purely to set camera_id with no need for a distinct process identity.

camera_id: Option<String>

video-streamer-specific: which camera this process reports to the relay/dashboard (sets MECHA10_CAMERA_ID on the spawned process’s environment - see VideoStreamerNode::init()/run() in mecha10-nodes). Threaded directly through mecha10.json rather than the node’s own configs/config.json so it never depends on mecha10-api’s node-catalog schema being in sync with the node’s actual struct.

Implementations

impl NodeRef

pub fn name(&self) -> &str

The node identifier (e.g. "@mecha10/camera"), regardless of entry shape.

pub fn instance_id(&self) -> Option<&str>

The instance id, if this entry names a specific keyed instance.

pub fn camera_id(&self) -> Option<&str>

The camera_id override, if this entry sets one. See the Keyed variant’s doc comment - independent of instance_id.

pub fn wire_identifier(&self) -> String

The plain-string identifier this entry round-trips to wherever the CLI’s node-spawning pipeline (mecha10 dev’s CliLifecycleManager/spawn_nodes_by_name, all the way down to ProcessService::spawn_node_runner/spawn_node_direct) still deals in bare Vec<String> node identifiers, rather than threading NodeRef itself through every layer. A plain entry’s identifier is just its name, unchanged; a keyed entry’s instance id is encoded as a "::" -suffixed segment, and a camera_id as a trailing "#" -suffixed segment ("name::instance_id#camera_id", "name#camera_id" when instance_id is absent) - neither "::" nor "#" can appear in a node identifier (see the name/package patterns in schemas/mecha10.schema.json, limited to [a-z0-9_/-]), so both are unambiguous to split back out (rsplit_once('#') first, then split_once("::") on what’s left) at the call sites that need them separately (to pass node-runner --instance-id/--camera-id and set NODE_INSTANCE_ID/MECHA10_CAMERA_ID on the spawned process’s environment).

pub fn process_key(&self) -> String

A key that’s unique per distinct (name, instance_id) pair within a target’s nodes list - name itself for a plain entry, "{name}/{instance_id}" for a keyed one with an instance id, or just name for a keyed entry that only sets camera_id. Used wherever a single string key is needed to track/identify a running node process (e.g. the CLI’s running-node registry, mode-diffing), mirroring the node_id shape the running process itself reports (Context::with_instance).

Trait Implementations

impl Clone for NodeRef

fn clone(&self) -> NodeRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NodeRef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NodeRef

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for NodeRef

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

Formats the value using the given formatter.

impl Eq for NodeRef

impl From<&str> for NodeRef

fn from(name: &str) -> NodeRef

Converts to this type from the input type.

impl From<String> for NodeRef

fn from(name: String) -> NodeRef

Converts to this type from the input type.

impl Hash for NodeRef

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl JsonSchema for NodeRef

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for NodeRef

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<&str> for NodeRef

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<String> for NodeRef

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<str> for NodeRef

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for NodeRef

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 NodeRef