Struct Handle 

pub struct Handle {
    pub plugin_id: Uuid,
    pub version: String,
    pub method: String,
    pub meta: Vec<String>,
}

Handle pointing to external data with versioning

Display format: {plugin_id}@{version}::{method}:meta[0]:meta[1]:...

Examples:

• 550e8400-e29b-41d4-a716-446655440000@1.0.0::chat:msg-123:user:bob
• 123e4567-e89b-12d3-a456-426614174000@1.0.0::execute:cmd-789

Fields

plugin_id: Uuid

Stable plugin instance identifier (UUID)

version: String

Plugin version (semantic version: “MAJOR.MINOR.PATCH”) Used for schema/type lookup

method: String

Creation method that produced this handle (e.g., “chat”, “execute”)

meta: Vec<String>

Metadata parts - variable length list of strings For messages: typically [message_uuid, role, optional_extra…]

Implementations

impl Handle

pub fn new( plugin_id: Uuid, version: impl Into<String>, method: impl Into<String>, ) -> Handle

Create a new handle with plugin UUID

pub fn with_meta(self, meta: Vec<String>) -> Handle

Add metadata to the handle

pub fn push_meta(self, item: impl Into<String>) -> Handle

Add a single metadata item

pub fn origin(&self) -> Origin

Get the origin for this handle (for provenance tracking)

Trait Implementations

impl Clone for Handle

fn clone(&self) -> Handle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Handle

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Handle

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Handle

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

Formats the value using the given formatter.

impl From<ClaudeCodeHandle> for Handle

fn from(h: ClaudeCodeHandle) -> Handle

Converts to this type from the input type.

impl From<ConeHandle> for Handle

fn from(h: ConeHandle) -> Handle

Converts to this type from the input type.

impl FromStr for Handle

type Err = String

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Handle, <Handle as FromStr>::Err>

Parses a string s to return a value of this type.

impl JsonSchema for Handle

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 Handle

fn eq(&self, other: &Handle) -> 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 Handle

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 TryFrom<&Handle> for ClaudeCodeHandle

type Error = HandleParseError

The type returned in the event of a conversion error.

fn try_from(handle: &Handle) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&Handle> for ConeHandle

type Error = HandleParseError

The type returned in the event of a conversion error.

fn try_from(handle: &Handle) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for Handle

impl StructuralPartialEq for Handle