Struct StepSummary 

pub struct StepSummary {
    pub name: String,
    pub size_bytes: u64,
    pub content_type: String,
    pub sha256: String,
    pub source: ProjectionSource,
    pub file_path: Option<String>,
    pub content_url: String,
    pub preview: String,
    pub truncated: bool,
}

One step’s metadata (operator / debug plane) — GET /v1/tasks/:id/runs/:run/steps/:step, and each entry of StepList::steps.

Fields

name: String

The producing step’s name.

size_bytes: u64

Byte length of the body Self::content_url serves (the exact bytes a GET of that URL returns for this same ?path=, if any).

content_type: String

MIME type Self::content_url serves this body as (text/markdown; charset=utf-8 when materialized-file-backed, application/json otherwise — see the module doc’s Content-Type rule).

sha256: String

SHA-256 hex digest of the body, matching the content endpoint’s ETag value (sha256:<hex>, minus the sha256: prefix).

source: ProjectionSource

Which backing produced this entry.

file_path: Option<String>

Absolute filesystem path to the materialized projection file (crate::core::projection::FileProjectionAdapter’s ProjectionPlacement resolver’s target — byte-compat default layout <root>/workspace/tasks/<step_id>/ctx/<name>.md), when one exists AND this entry addresses the whole step (no ?path= narrowing — a narrowed fragment is never file-backed). None otherwise.

content_url: String

Fetch URL for this step’s content (GET /v1/tasks/:id/runs/:run/steps/:step/content, ?path= echoed when this entry is narrowed) — absolute (AppState.base_url-prefixed) when the server has a configured base URL, relative otherwise.

preview: String

First <= 512 bytes of the body, UTF-8-boundary-safe (never splits a multi-byte character), with a trailing … when truncated.

truncated: bool

true when Self::preview’s underlying byte count is shorter than Self::size_bytes (the body was truncated to build the preview).

Trait Implementations

impl Clone for StepSummary

fn clone(&self) -> StepSummary

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StepSummary

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

Formats the value using the given formatter.

impl JsonSchema for StepSummary

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 Serialize for StepSummary

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

where __S: Serializer,

Serialize this value into the given Serde serializer.