nika 0.35.4

Semantic YAML workflow engine for AI tasks - DAG execution, MCP integration, multi-provider LLM support
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

//! Nika - DAG workflow runner for AI tasks
//!
//! ## Module Architecture
//!
//! ```text
//! ┌──────────────────────────────────────────────────────────────┐
//! │                        DOMAIN MODEL                          │
//! │  ast/       YAML → Rust types (Workflow, Task, TaskAction)   │
//! └──────────────────────────────────────────────────────────────┘
//!                              │
//!                              ▼
//! ┌──────────────────────────────────────────────────────────────┐
//! │                      APPLICATION LAYER                       │
//! │  runtime/   DAG execution (Runner, TaskExecutor)             │
//! │  dag/       DAG structure (Dag, validate)                    │
//! │  binding/   Data binding (WithSpec, ResolvedBindings)        │
//! └──────────────────────────────────────────────────────────────┘
//!                              │
//!                              ▼
//! ┌──────────────────────────────────────────────────────────────┐
//! │                    INFRASTRUCTURE LAYER                      │
//! │  store/     State management (RunContext, TaskResult)         │
//! │  event/     Event sourcing (EventLog, EventKind)             │
//! │  provider/  LLM abstraction (rig-core wrapper)               │
//! └──────────────────────────────────────────────────────────────┘
//! ```

// YAML parsing alias (serde-saphyr)
pub use serde_saphyr as serde_yaml;

// Source tracking for precise error locations
pub mod source;

// Public modules (used by main.rs, tests, or benches)
pub mod ast;
pub mod binding;
pub mod config;
pub mod core;
pub mod dag;
pub mod display;
pub mod error;
pub mod event;
pub mod init;
pub mod mcp;
pub mod media;
pub mod new;
pub mod provider;
pub mod registry;
pub mod runtime;
pub mod store;
pub mod tools;

// Internal modules (only used within the crate)
pub(crate) mod io;
pub(crate) mod util;

// Feature-gated modules
pub mod secrets;
#[cfg(feature = "tui")]
pub mod tui;

#[cfg(feature = "lsp")]
pub mod lsp;

// ── Public API re-exports ────────────────────────────────────

// Source tracking
pub use source::{ByteOffset, FileId, SourceFile, SourceRegistry, Span, Spanned};

// Error types
pub use error::NikaError;

// AST types
pub use ast::{
    AgentParams, ExecParams, FetchParams, InferParams, InvokeParams, Task, TaskAction, Workflow,
};

// Runtime
pub use runtime::{Runner, TaskExecutor};

// DAG
pub use dag::{validate_bindings, Dag, StableDag};

// Binding
pub use binding::{validate_task_id, BindingEntry, BindingSpec, ResolvedBindings};

// Events
pub use event::{list_traces, prune_traces, Event, EventKind, EventLog};

// Store
pub use store::{RunContext, TaskResult};

// MCP
pub use mcp::{McpClient, McpConfig};