Fiddlesticks Facade

fiddlesticks is the single-dependency gateway for the Fiddlesticks workspace.

It re-exports the underlying crates and adds curated utilities for common runtime wiring and request-building flows.

Add dependency

[dependencies]
fiddlesticks = { path = "../fiddlesticks" }

Enable provider adapters from one place:

[dependencies]
fiddlesticks = { path = "../fiddlesticks", features = ["provider-opencode-zen"] }

API surface

• Full crate aliases: fiddlesticks::fprovider, fiddlesticks::fchat, fiddlesticks::fharness, etc.
• Curated top-level exports for common types (ChatService, Harness, ModelProvider, ToolRegistry, ...)
• prelude module for ergonomic imports
• Runtime helpers: build_runtime*, chat_service*, in_memory_backend
• Utility constructors: message/session/turn helpers
• Macros: fs_msg!, fs_messages!, fs_session!

Basic usage

use std::sync::Arc;

use fiddlesticks::prelude::*;

fn _example(provider: Arc<dyn ModelProvider>) -> Result<(), HarnessError> {
    let runtime = build_runtime(provider)?;

    let session = fs_session!(
        "session-1",
        openai,
        "gpt-4o-mini",
        "You are concise and practical."
    );

    let request = turn(session, "Summarize this repository architecture");
    let _ = (runtime, request);
    Ok(())
}

Runtime wiring helpers

use std::sync::Arc;

use fiddlesticks::prelude::*;

fn _wire(provider: Arc<dyn ModelProvider>, tool_runtime: Arc<dyn ToolRuntime>) -> Result<(), HarnessError> {
    let runtime = build_runtime_with_tooling(provider, tool_runtime)?;
    let _chat = runtime.chat;
    let _harness = runtime.harness;
    Ok(())
}

Utility helpers and macros

use fiddlesticks::prelude::*;

let messages = fs_messages![
    system => "You are a strict reviewer.",
    user => "Review this patch.",
];

let user = user_message("hello");
let _ = (messages, user);