Rust AI agent harness — LLM abstraction, process sandboxing, tool-loop runtime, knowledge store, and recursive task orchestration.
flick (leaf) LLM provider abstraction
lot (leaf) Cross-platform process sandboxing
traits (leaf) Shared trait definitions (EventEmitter<E>)
reel → flick, lot Agent session runtime + tool loop
vault → reel File-based knowledge store
cue → traits Generic recursive task orchestration framework
mech → cue, reel Declarative YAML workflow format (in development)
epic → cue, reel, vault, traits Recursive problem-solver orchestrator
gate (binary) End-to-end test harness (manual)
| Crate | Description | README |
|---|---|---|
| flick | Single-shot LLM primitive. Takes a request config + query, calls one model, returns JSON. Declares tools but never executes them — the caller drives the agent loop. Library + CLI. | flick/README.md |
| lot | Cross-platform process sandboxing. Launches child processes with restricted filesystem and network access using namespaces+seccomp (Linux), Seatbelt (macOS), or AppContainer (Windows). Library + CLI. | lot/README.md |
| traits | Shared trait definitions. Contains EventEmitter<E> for cross-crate event propagation without coupling emitters to consumers. |
|
| reel | Agent session runtime. Owns the tool loop (50 rounds / 200 tool calls), a sandboxed NuShell MCP session via lot, and 6 built-in tools (Read, Write, Edit, Glob, Grep, NuShell). Library + CLI. | reel/README.md |
| vault | Persistent file-based knowledge store. Accumulates project knowledge through four operations (bootstrap, record, query, reorganize) backed by a reel agent. Library + CLI. | vault/README.md |
| cue | Generic recursive task orchestration framework. Defines the TaskNode and TaskStore traits, coordination algorithm (DFS traversal, retry, escalation, fix loops, recovery), CueEvent enum, and shared orchestration types. Orchestrator is generic over EventEmitter<CueEvent>. No AI dependencies. |
|
| mech | Declarative YAML workflow engine for LLM-driven control and dataflow. Prompt and call blocks in a unified CDFG, CEL expressions for guards and templates, reel agent execution, cue integration for retry and escalation. See docs/MECH_SPEC.md for the full specification. |
mech/README.md |
| epic | Recursive problem-solver. Implements cue's TaskNode and TaskStore traits with AI agent calls (via reel), vault knowledge persistence, prompts, wire formats, EventLog (append-only event store with subscriptions), and TUI. |
epic/README.md |
| gate | Manually-invoked end-to-end test harness exercising the full backlot stack against real LLM providers and OS sandboxing. Binary-only — no library component. See docs/GATE_DESIGN.md. |
Per-crate design documents, status tracking, and issue lists live under docs/:
FLICK_DESIGN.md— LLM provider abstraction designLOT_DESIGN.md— Process sandboxing designREEL_DESIGN.md— Agent runtime designVAULT_DESIGN.md— Document store designEPIC_DESIGN.md— Orchestrator designGATE_DESIGN.md— End-to-end test harness designSTATUS.md— Cross-crate status and next work
Requires Rust 1.85+ (edition 2024).
cargo build --workspace
cargo test --workspace
cargo clippy --workspace -- -D warnings
cargo fmt --all --checkDual-licensed under MIT or Apache-2.0, at your option.