Struct ProjectionKey 

pub struct ProjectionKey {
    pub task_id: String,
    pub run_id: Option<String>,
    pub step: Option<String>,
    pub path: Option<String>,
}

Addressing for one projection target. ID axis (task_id / run_id) + Name axis (step) + Path axis (path) — the one addressing type both FileProjectionAdapter and the future McpQueryAdapter (ST2) accept.

Fields

task_id: String

Task identity (StepId’s Display string form, the same shape AgentContextView.task_id uses).

run_id: Option<String>

Run identity. None means “the latest run”.

step: Option<String>

Step / agent name — the key directly under ctx.data this projection narrows to. None means “the whole ctx”.

path: Option<String>

Field path within the step’s value, $.a.b dot-path form (the leading $. is optional). None means “the whole step value”.

Implementations

impl ProjectionKey

pub fn resolve<'a>(&self, ctx_data: &'a Value) -> Option<&'a Value>

Pure narrowing helper: resolves self against ctx_data, first by step (a direct key lookup) then by path (a .-separated walk of nested object fields, or — GH #36 ST2 — RFC 9535-style bracket notation for keys containing a literal ., e.g. $.parts["plan.md"]). Returns None if any segment is absent, or if a [-containing path is malformed — this is a pure lookup, not a fallible parse (an unparseable path simply yields no match rather than an error, matching the Option-returning contract callers expect from a resolve step).

Bracket syntax is kept in lockstep with flow-ir-core::read_path (mlua-flow-ir 0.1.2)’s parse_path_segments: bracket segments ["name"] (double-quoted, no escaping — a literal " inside a name cannot be represented) may be chained directly ($.a["x"]["y"]) or combined with .-separated plain segments in either order ($.a["x"].b, $["x.y"].inner). A path containing no [ takes the original dot-split code path unchanged — no behavioural change for existing callers.

Trait Implementations

impl Clone for ProjectionKey

fn clone(&self) -> ProjectionKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProjectionKey

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProjectionKey

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for ProjectionKey

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 ProjectionKey

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ProjectionKey

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 ProjectionKey