Struct RawWorkflow 

pub struct RawWorkflow {

    pub schema: Spanned<String>,
    pub workflow: Option<Spanned<String>>,
    pub description: Option<Spanned<String>>,
    pub provider: Option<Spanned<String>>,
    pub model: Option<Spanned<String>>,
    pub mcp: Option<Spanned<RawMcpConfig>>,
    pub pkg: Option<Spanned<RawPkgConfig>>,
    pub context: Option<Spanned<RawContextConfig>>,
    pub imports: Option<Spanned<Vec<Spanned<RawImportSpec>>>>,
    pub inputs: Option<Spanned<IndexMap<Spanned<String>, Spanned<Value>>>>,
    pub artifacts: Option<Spanned<Value>>,
    pub log: Option<Spanned<Value>>,
    pub agents: Option<Spanned<Value>>,
    pub skills: Option<Spanned<IndexMap<Spanned<String>, Spanned<String>>>>,
    pub tasks: Spanned<Vec<Spanned<RawTask>>>,
    pub span: Span,
}

Raw workflow as parsed from YAML.

All fields preserve source positions via Spanned<T>. This is Phase 1 of the Two-Phase IR - no validation, just structure.

Fields

schema: Spanned<String>

Schema version: “nika/workflow@0.12”

workflow: Option<Spanned<String>>

Workflow identifier (optional in YAML, defaults to filename)

description: Option<Spanned<String>>

Optional description

provider: Option<Spanned<String>>

Default provider (e.g., “claude”, “openai”)

model: Option<Spanned<String>>

Default model (e.g., “claude-sonnet-4-6”)

mcp: Option<Spanned<RawMcpConfig>>

MCP server configuration

pkg: Option<Spanned<RawPkgConfig>>

Package includes: pkg: { include: […] }

context: Option<Spanned<RawContextConfig>>

Context files configuration

imports: Option<Spanned<Vec<Spanned<RawImportSpec>>>>

Import external workflows/modules

imports:
  - path: ./partials/setup.nika.yaml
    prefix: setup_
  - path: pkg:@nika/core@1.0/seo.nika.yaml

inputs: Option<Spanned<IndexMap<Spanned<String>, Spanned<Value>>>>

Input parameters with defaults

artifacts: Option<Spanned<Value>>

Artifact output configuration

log: Option<Spanned<Value>>

Log configuration

agents: Option<Spanned<Value>>

Reusable agent definitions

skills: Option<Spanned<IndexMap<Spanned<String>, Spanned<String>>>>

Workflow-level skills mapping (alias -> file path)

Parsed from skills: block at workflow root. Maps skill aliases to file paths (local or pkg: URIs) for prompt augmentation.

tasks: Spanned<Vec<Spanned<RawTask>>>

Task definitions (order matters for implicit flow)

span: Span

The span of the entire workflow document

Implementations

impl RawWorkflow

pub fn new() -> RawWorkflow

Create a new empty raw workflow.

pub fn name(&self) -> &str

Get the workflow name, falling back to “unnamed”.

pub fn task_count(&self) -> usize

Get the number of tasks.

pub fn iter_tasks(&self) -> impl Iterator<Item = &Spanned<RawTask>>

Iterate over tasks.

pub fn get_task(&self, id: &str) -> Option<&Spanned<RawTask>>

Get a task by ID (linear search - Phase 2 uses interned IDs).

Trait Implementations

impl Clone for RawWorkflow

fn clone(&self) -> RawWorkflow

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RawWorkflow

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

Formats the value using the given formatter.

impl Default for RawWorkflow

fn default() -> RawWorkflow

Returns the “default value” for a type.