Enum NikaError 

pub enum NikaError {
    ParseError {
        details: String,
    },
    InvalidSchemaVersion {
        version: String,
    },
    WorkflowNotFound {
        path: String,
    },
    ValidationError {
        reason: String,
    },
    SchemaValidationFailed {
        errors: Vec<SchemaError>,
    },
    HomeDirectoryNotFound,
    SchemaFileNotFound {
        task_id: String,
        path: String,
    },
    SchemaFileInvalid {
        task_id: String,
        path: String,
        reason: String,
    },
    CycleDetected {
        cycle: String,
    },
    MissingDependency {
        task_id: String,
        dep_id: String,
    },
    DuplicateTaskId {
        task_id: String,
    },
    DependencyChainFailed {
        count: usize,
        blocked_tasks: Vec<String>,
        root_failure: Option<String>,
    },
    TaskCancelled {
        task_id: String,
        reason: String,
    },
    ProviderNotConfigured {
        provider: String,
    },
    ProviderApiError {
        message: String,
    },
    MissingApiKey {
        provider: String,
    },
    InvalidConfig {
        message: String,
    },
    Execution(String),
    TemplateError {
        template: String,
        reason: String,
    },
    ExecError {
        reason: String,
    },
    FetchError {
        reason: String,
    },
    ExtractError {
        reason: String,
    },
    InvokeParamError {
        reason: String,
    },
    WorkflowCancelled {
        phase: String,
    },
    TaskPanicked {
        reason: String,
    },
    BindingNotFound {
        alias: String,
    },
    BindingTypeMismatch {
        expected: String,
        actual: String,
        path: String,
    },
    InvalidPath {
        path: String,
    },
    PathNotFound {
        path: String,
    },
    BlockedCommand {
        command: String,
        reason: String,
    },
    InvalidTaskId {
        id: String,
        reason: String,
    },
    InvalidDefault {
        raw: String,
        reason: String,
    },
    InvalidJson {
        details: String,
    },
    SchemaFailed {
        details: String,
    },
    SerializationError {
        details: String,
    },
    UnknownAlias {
        alias: String,
        task_id: String,
    },
    NullValue {
        path: String,
        alias: String,
    },
    InvalidTraversal {
        segment: String,
        value_type: String,
        full_path: String,
    },
    TemplateParse {
        position: usize,
        details: String,
    },
    WithUnknownTask {
        alias: String,
        from_task: String,
        task_id: String,
    },
    WithNotUpstream {
        alias: String,
        from_task: String,
        task_id: String,
    },
    WithCircularDep {
        alias: String,
        from_task: String,
        task_id: String,
    },
    RuntimeDeadlock {
        details: String,
    },
    JsonPathUnsupported {
        path: String,
    },
    IoError(Error),
    JsonError(Error),
    YamlParse(Error),
    McpNotConnected {
        name: String,
    },
    McpStartError {
        name: String,
        reason: String,
    },
    McpToolError {
        tool: String,
        reason: String,
        error_code: Option<McpErrorCode>,
    },
    McpResourceNotFound {
        uri: String,
    },
    McpProtocolError {
        reason: String,
    },
    McpNotConfigured {
        name: String,
    },
    McpInvalidResponse {
        tool: String,
        reason: String,
    },
    McpValidationFailed {
        tool: String,
        details: String,
        missing: Vec<String>,
        suggestions: Vec<String>,
    },
    McpSchemaError {
        tool: String,
        reason: String,
    },
    McpTimeout {
        name: String,
        operation: String,
        timeout_secs: u64,
    },
    AgentValidationError {
        reason: String,
    },
    AgentExecutionError {
        task_id: String,
        reason: String,
    },
    ThinkingCaptureFailed {
        reason: String,
    },
    GuardrailViolation {
        task_id: String,
        violations: Vec<String>,
    },
    Timeout {
        operation: String,
        duration_ms: u64,
    },
    McpToolCallFailed {
        tool: String,
        reason: String,
    },
    TuiError {
        reason: String,
    },
    ConfigError {
        reason: String,
    },
    PolicyViolation {
        reason: String,
    },
    BootFailed {
        phase: String,
        reason: String,
    },
    StartupError {
        phase: String,
        reason: String,
    },
    DecomposeTimeout {
        task_id: String,
        timeout_secs: u64,
    },
    ToolError {
        code: String,
        message: String,
    },
    BuiltinToolError {
        tool: String,
        reason: String,
    },
    BuiltinInvalidParams {
        tool: String,
        reason: String,
    },
    AssertionFailed {
        message: String,
        condition: String,
    },
    ContextLoadError {
        alias: String,
        path: String,
        reason: String,
    },
    MediaError(MediaError),
    InvalidPkgUri {
        uri: String,
        reason: String,
    },
    PackageNotFound {
        name: String,
        version: String,
    },
    SkillLoadError {
        skill: String,
        reason: String,
    },
    ArtifactPathError {
        path: String,
        reason: String,
    },
    ArtifactWriteError {
        path: String,
        reason: String,
    },
    ArtifactSizeExceeded {
        path: String,
        size: u64,
        max_size: u64,
    },
    MediaStoreLocked {
        reason: String,
    },
    StructuredOutputExtractionFailed {
        task_id: String,
        layer: String,
        reason: String,
    },
    StructuredOutputValidationFailed {
        task_id: String,
        layer: String,
        attempt: u32,
        errors: Vec<String>,
    },
    StructuredOutputRepairFailed {
        task_id: String,
        original_errors: Vec<String>,
        repair_errors: Vec<String>,
    },
    StructuredOutputAllLayersFailed {
        task_id: String,
        attempts: u32,
        final_errors: Vec<String>,
    },
    CourseNotFound {
        path: String,
    },
    CourseCheckFailed {
        exercise: String,
        reason: String,
    },
    CourseLevelLocked {
        level: String,
        prerequisite: u8,
    },
    CourseProgressCorrupted {
        reason: String,
    },
    CourseWatchError {
        reason: String,
    },
}

All error variants are part of the public API.

Implements both thiserror::Error for std error compatibility and miette::Diagnostic for fancy terminal error display.

Variants

ParseError

Fields

details: String

InvalidSchemaVersion

Fields

version: String

WorkflowNotFound

Fields

path: String

ValidationError

Fields

reason: String

SchemaValidationFailed

Fields

errors: Vec<SchemaError>

HomeDirectoryNotFound

SchemaFileNotFound

Fields

task_id: String

path: String

SchemaFileInvalid

Fields

task_id: String

path: String

reason: String

CycleDetected

Fields

cycle: String

MissingDependency

Fields

task_id: String

dep_id: String

DuplicateTaskId

Fields

task_id: String

DependencyChainFailed

Fields

count: usize

Number of tasks blocked

blocked_tasks: Vec<String>

List of blocked task IDs

root_failure: Option<String>

The root failure that caused the chain

TaskCancelled

Fields

task_id: String

reason: String

ProviderNotConfigured

Fields

provider: String

ProviderApiError

Fields

message: String

MissingApiKey

Fields

provider: String

InvalidConfig

Fields

message: String

Execution(String)

Simple execution error (catch-all for genuinely misc errors)

TemplateError

Fields

template: String

reason: String

ExecError

[NIKA-044] Exec verb command error (spawn, cwd, shell)

Fields

reason: String

FetchError

[NIKA-045] Fetch verb HTTP error (request, response, URL)

Fields

reason: String

ExtractError

[NIKA-046] Fetch extract mode error (readability, feed, CSS, markdown)

Fields

reason: String

InvokeParamError

[NIKA-047] Invoke parameter serialization error

Fields

reason: String

WorkflowCancelled

[NIKA-097] Workflow cancelled by user

Fields

phase: String

TaskPanicked

[NIKA-098] Task panicked during execution

Fields

reason: String

BindingNotFound

Fields

alias: String

BindingTypeMismatch

Fields

expected: String

actual: String

path: String

InvalidPath

Fields

path: String

PathNotFound

Fields

path: String

BlockedCommand

Fields

command: String

reason: String

InvalidTaskId

Fields

id: String

reason: String

InvalidDefault

Fields

raw: String

reason: String

InvalidJson

Fields

details: String

SchemaFailed

Fields

details: String

SerializationError

Fields

details: String

UnknownAlias

Fields

alias: String

task_id: String

NullValue

Fields

path: String

alias: String

InvalidTraversal

Fields

segment: String

value_type: String

full_path: String

TemplateParse

Fields

position: usize

details: String

WithUnknownTask

Fields

alias: String

from_task: String

task_id: String

WithNotUpstream

Fields

alias: String

from_task: String

task_id: String

WithCircularDep

Fields

alias: String

from_task: String

task_id: String

RuntimeDeadlock

[NIKA-083] Runtime deadlock – no tasks ready but workflow not complete

Fields

details: String

JsonPathUnsupported

Fields

path: String

IoError(Error)

JsonError(Error)

YamlParse(Error)

McpNotConnected

Fields

name: String

McpStartError

Fields

name: String

reason: String

McpToolError

Fields

tool: String

reason: String

error_code: Option<McpErrorCode>

JSON-RPC error code from MCP server

McpResourceNotFound

Fields

uri: String

McpProtocolError

Fields

reason: String

McpNotConfigured

Fields

name: String

McpInvalidResponse

Fields

tool: String

reason: String

McpValidationFailed

Fields

tool: String

details: String

missing: Vec<String>

Required fields that are missing

suggestions: Vec<String>

Suggested corrections

McpSchemaError

Fields

tool: String

reason: String

McpTimeout

Fields

name: String

operation: String

timeout_secs: u64

AgentValidationError

Fields

reason: String

AgentExecutionError

Fields

task_id: String

reason: String

ThinkingCaptureFailed

Fields

reason: String

GuardrailViolation

Fields

task_id: String

violations: Vec<String>

Timeout

Fields

operation: String

duration_ms: u64

McpToolCallFailed

Fields

tool: String

reason: String

TuiError

Fields

reason: String

ConfigError

Fields

reason: String

PolicyViolation

Fields

reason: String

BootFailed

Fields

phase: String

reason: String

StartupError

Fields

phase: String

reason: String

DecomposeTimeout

Fields

task_id: String

timeout_secs: u64

ToolError

Fields

code: String

message: String

BuiltinToolError

Fields

tool: String

reason: String

BuiltinInvalidParams

Fields

tool: String

reason: String

AssertionFailed

Fields

message: String

condition: String

ContextLoadError

Fields

alias: String

path: String

reason: String

MediaError(MediaError)

Media pipeline error (NIKA-251..259) Note: miette diagnostic codes are forwarded via MediaError’s own Diagnostic derive.

InvalidPkgUri

Fields

uri: String

reason: String

PackageNotFound

Fields

name: String

version: String

SkillLoadError

Fields

skill: String

reason: String

ArtifactPathError

Fields

path: String

reason: String

ArtifactWriteError

Fields

path: String

reason: String

ArtifactSizeExceeded

Fields

path: String

size: u64

max_size: u64

MediaStoreLocked

Fields

reason: String

StructuredOutputExtractionFailed

Fields

task_id: String

layer: String

reason: String

StructuredOutputValidationFailed

Fields

task_id: String

layer: String

attempt: u32

errors: Vec<String>

StructuredOutputRepairFailed

Fields

task_id: String

original_errors: Vec<String>

repair_errors: Vec<String>

StructuredOutputAllLayersFailed

Fields

task_id: String

attempts: u32

final_errors: Vec<String>

CourseNotFound

Fields

path: String

CourseCheckFailed

Fields

exercise: String

reason: String

CourseLevelLocked

Fields

level: String

prerequisite: u8

CourseProgressCorrupted

Fields

reason: String

CourseWatchError

Fields

reason: String

Implementations

impl NikaError

pub fn code(&self) -> &'static str

Get the error code (e.g., “NIKA-001”)

pub fn is_recoverable(&self) -> bool

Check if error is recoverable (can be retried)

Trait Implementations

impl Debug for NikaError

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

Formats the value using the given formatter.

impl Diagnostic for NikaError

fn code(&self) -> Option<Box<dyn Display + '_>>

Unique diagnostic code that can be used to look up more information about this Diagnostic. Ideally also globally unique, and documented in the toplevel crate’s documentation for easy searching. Rust path format (foo::bar::baz) is recommended, but more classic codes like E0123 or enums will work just fine.

fn help(&self) -> Option<Box<dyn Display + '_>>

Additional help text related to this Diagnostic. Do you have any advice for the poor soul who’s just run into this issue?

fn url(&self) -> Option<Box<dyn Display + '_>>

URL to visit for a more detailed explanation/help about this Diagnostic.

fn severity(&self) -> Option<Severity>

Diagnostic severity. This may be used by ReportHandlers to change the display format of this diagnostic.

fn source_code(&self) -> Option<&dyn SourceCode>

Source code to apply this Diagnostic’s Diagnostic::labels to.

fn labels(&self) -> Option<Box<dyn Iterator<Item = LabeledSpan> + '_>>

Labels to apply to this Diagnostic’s Diagnostic::source_code

fn related<'a>( &'a self, ) -> Option<Box<dyn Iterator<Item = &'a dyn Diagnostic> + 'a>>

Additional related Diagnostics.

fn diagnostic_source(&self) -> Option<&dyn Diagnostic>

The cause of the error.

impl Display for NikaError

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

Formats the value using the given formatter.

impl Error for NikaError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl FixSuggestion for NikaError

fn fix_suggestion(&self) -> Option<&str>

impl From<BindingError> for NikaError

fn from(e: BindingError) -> Self

Converts to this type from the input type.

impl From<CoreError> for NikaError

fn from(e: CoreError) -> Self

Converts to this type from the input type.

impl From<DagError> for NikaError

fn from(e: DagError) -> Self

Converts to this type from the input type.

impl From<Error> for NikaError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for NikaError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for NikaError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<EventError> for NikaError

fn from(e: EventError) -> Self

Converts to this type from the input type.

impl From<ExecutionError> for NikaError

fn from(e: ExecutionError) -> Self

Converts to this type from the input type.

impl From<McpError> for NikaError

fn from(e: McpError) -> Self

Converts to this type from the input type.

impl From<MediaError> for NikaError

fn from(source: MediaError) -> Self

Converts to this type from the input type.

impl From<MediaToolError> for NikaError

fn from(e: MediaToolError) -> Self

Converts to this type from the input type.

impl From<NikaInitError> for NikaError

fn from(e: NikaInitError) -> Self

Converts to this type from the input type.

impl From<ProviderError> for NikaError

fn from(e: ProviderError) -> Self

Converts to this type from the input type.