Skip to main content

Crate fiddlesticks

Crate fiddlesticks

Expand description

Unified facade over the Fiddlesticks workspace crates.

This crate is designed to be the single dependency for most applications. It exposes a curated, facade-owned API surface with stable namespace modules, runtime/provider helpers, and macros for common setup and request-building flows.

use fiddlesticks::prelude::*;

let session = fs_session!("session-1", openai, "gpt-4o-mini", "Be concise.");
let request = turn(session, "Summarize this change.");
let messages = fs_messages![
    system => "You are direct.",
    user => request.user_input,
];

assert_eq!(messages.len(), 2);

Re-exports§

pub use runtime::RuntimeBundle;
pub use runtime::build_runtime;
pub use runtime::build_runtime_with;
pub use runtime::build_runtime_with_memory;
pub use runtime::build_runtime_with_tooling;
pub use runtime::chat_service;
pub use runtime::chat_service_with_memory;
pub use runtime::in_memory_backend;
pub use util::assistant_message;
pub use util::parse_provider_id;
pub use util::session;
pub use util::streaming_turn;
pub use util::system_message;
pub use util::tool_message;
pub use util::turn;
pub use util::user_message;

Modules§

chat
harness
memory
prelude: Common imports for most Fiddlesticks applications.
provider
runtime: Runtime wiring helpers for chat and harness usage.
tooling
util: Small convenience constructors for common types.

Macros§

fs_messages: Creates a Vec<Message> from role/content pairs.
fs_msg: Creates a single chat Message from a role shorthand.
fs_session: Creates a ChatSession with provider shorthand support.

Structs§

Enums§

Traits§

ConversationStore
CredentialAccessObserver
FeatureSelector
HealthChecker
MemoryBackend
ModelEventStream: Provider stream contract.
ModelProvider
OutcomeValidator
ProviderOperationHooks
Tool
ToolRuntime
ToolRuntimeHooks

Functions§

build_provider_from_api_key
build_provider_with_config: Builds a provider from a strict ProviderBuildConfig.
create_default_memory_backend
create_memory_backend
execute_with_retry
list_models_with_api_key
parse_json_object
parse_json_value
required_string

Type Aliases§

AgentRuntime
BoxFuture
BoxedEventStream
ChatEventObserver
ChatEventStream
ChatTurnOptions
MetadataMap
ProviderFuture
ToolFuture