Crate wauldo 

Wauldo Rust SDK

Provides two client interfaces:

• AgentClient — MCP server client (stdio JSON-RPC) for reasoning, planning, tools
• HttpClient — REST API client (OpenAI-compatible) for chat, embeddings, RAG, orchestrator

Quick Start (HTTP API)

use wauldo::{HttpClient, ChatRequest, ChatMessage, Result};

#[tokio::main]
async fn main() -> Result<()> {
    let client = HttpClient::localhost()?;

    let models = client.list_models().await?;
    println!("Models: {:?}", models.data.iter().map(|m| &m.id).collect::<Vec<_>>());

    let req = ChatRequest::new("qwen2.5:7b", vec![ChatMessage::user("Hello!")]);
    let resp = client.chat(req).await?;
    println!("{}", resp.choices[0].message.content.as_deref().unwrap_or(""));

    Ok(())
}

Re-exports

pub use conversation::Conversation;

pub use http_client::HttpClient;

pub use http_config::HttpConfig;

pub use mock_client::MockHttpClient;

pub use http_types::*;

Modules

conversation

Conversation helper — manages chat history automatically

http_client

HTTP client for Wauldo REST API (OpenAI-compatible)

http_config

Configuration types for the HTTP client

http_types

HTTP API request/response types (OpenAI-compatible)

mock_client

Mock HTTP client for deterministic testing

Structs

AgentClient

Client for Wauldo MCP Server

Chunk

A text chunk from document processing

ChunkResult

Result from document chunking

ClientOptions

Client configuration options

Concept

A single extracted concept

ConceptResult

Result from concept extraction

GraphNode

A node in the knowledge graph

KnowledgeGraphResult

Result from knowledge graph operations

PlanOptions

Options for task planning

PlanResult

Result from task planning

PlanStep

A single step in a task plan

ReasoningOptions

Options for reasoning

ReasoningResult

Reasoning result from Tree-of-Thought

RetrievalResult

Result from context retrieval

ToolDefinition

Tool definition from MCP

Enums

DetailLevel

Detail level for task planning

Error

SDK error types

SourceType

Source type for concept extraction

Type Aliases

Result

Result type alias for SDK operations