kkachi 0.1.8

High-performance, zero-copy library for optimizing language model prompts and programs
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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

// Copyright © 2025 lituus-io <spicyzhug@gmail.com>
// All Rights Reserved.
// Licensed under PolyForm Noncommercial 1.0.0

//! Public re-exports for convenient imports.
//!
//! # Examples
//!
//! ```
//! use kkachi::recursive::prelude::*;
//!
//! // Now you have access to all common types and functions
//! let validator = checks().require("fn ");
//! ```

// Core refinement
pub use crate::recursive::refine::{refine, Config, Refine};

// Validation
pub use crate::recursive::checks::{checks, Check, CheckKind, Checks};
pub use crate::recursive::cli::{cli, Cli, CliCapture, CliTool};
pub use crate::recursive::compose::{all, any, All, And, Any, Or, ValidateExt};
pub use crate::recursive::validate::{
    AlwaysFail, BoolValidator, FnValidator, NoValidation, Score, ScoreValidator, Validate,
};

// Memory/RAG
pub use crate::recursive::memory::{
    cosine_similarity, memory, mmr_select, Document, Embedder, HashEmbedder, LinearIndex, Memory,
    Recall, VectorIndex,
};

// Feature-gated exports
#[cfg(feature = "api")]
pub use crate::recursive::api_client::{ApiLlm, Provider};
#[cfg(feature = "hnsw")]
pub use crate::recursive::memory::HnswIndex;
#[cfg(feature = "embeddings-onnx")]
pub use crate::recursive::memory::{OnnxEmbedder, OnnxEmbedderError};

// LLM
pub use crate::recursive::boxed::BoxedLlm;
pub use crate::recursive::llm::{CliLlm, FailingLlm, IterativeMockLlm, Llm, LmOutput, MockLlm};

// Results
pub use crate::recursive::result::{
    Compiled, ContextId, Correction, Example, Iteration, OptimizedPrompt, RefineEvent,
    RefineResult, StopReason,
};

// Semantic validation
pub use crate::recursive::semantic::{semantic, SemanticBuilder, SemanticValidator};

// Markdown rewriting
pub use crate::recursive::rewrite::{
    extract_all_code, extract_code, extract_section, rewrite, Rewrite,
};

// DSPy-style patterns
pub use crate::recursive::agent::{agent, AgentResult, Step as AgentStep};

// Step trait — universal composable building block
pub use crate::recursive::best_of::{
    best_of, BestOfResult, CandidatePool, PoolStats, ScoredCandidate, Scorer,
};
pub use crate::recursive::cache::{CacheExt, CachedLlm};
pub use crate::recursive::ensemble::{
    ensemble, Aggregate, ChainResult, ConsensusPool, EnsembleResult,
};
pub use crate::recursive::executor::{
    bash_executor, node_executor, python_executor, CodeExecutor, ExecutionResult,
};
pub use crate::recursive::optimize::{
    Dataset, OptimizeResult, Optimizer, Strategy, TrainingExample,
};
pub use crate::recursive::pipeline::{
    pipeline, BranchBuilder, FanOutBranchResult, MergeStrategy, Pipeline, PipelineEvent,
    PipelineResult, StepResult,
};
pub use crate::recursive::program::{program, ProgramResult};
pub use crate::recursive::rate_limit::{RateLimitConfig, RateLimitExt, RateLimitedLlm};
pub use crate::recursive::reason::{reason, ReasonResult};
pub use crate::recursive::retry::{LlmExt, RetryConfig, RetryLlm};
pub use crate::recursive::step::{
    run_all, validate_step, Chain, DynStep, Fallback, FnStep, Map, Par, Race, Retry, Step, StepExt,
    StepOutput, ValidateStep, When,
};
pub use crate::recursive::template::{FormatType, Template};
pub use crate::recursive::tool::{tool, MockTool, Tool};

// Multi-turn conversation
pub use crate::recursive::conversation::{Conversation, Message, Role};

// Typed/structured output
pub use crate::recursive::typed::{parse_output, typed, FormatInstruction, TypedValidator};

// Prompt formatting
pub use crate::recursive::formatter::{FeedbackFormatter, PassthroughFormatter, PromptFormatter};

// Multi-objective / Pareto
pub use crate::recursive::pareto::{
    multi_objective, refine_pareto, refine_pareto_sync, Direction, MultiObjective,
    MultiObjectiveValidate, MultiScore, Objective, ParetoCandidate, ParetoFront,
    ParetoRefineResult, Scalarization,
};

// Builder configs
pub use crate::recursive::agent::AgentConfig;
pub use crate::recursive::best_of::BestOfConfig;
pub use crate::recursive::ensemble::EnsembleConfig;
pub use crate::recursive::reason::ReasonConfig;