agentkit

Feature-gated umbrella crate for assembling agent applications from the agentkit workspace. Enable only the features you need and access them through a single dependency.

Default features

core, capabilities, tools, loop, reporting. The loop feature transitively enables task-manager.

The agent loop module is re-exported as loop_ because loop is a Rust keyword.

Optional features

Quick start

Add agentkit with the features you need:

[dependencies]
agentkit = { version = "0.7", features = ["provider-openrouter", "tool-fs", "tool-shell"] }
tokio = { version = "1", features = ["full"] }

Examples

Minimal agent with OpenRouter

use agentkit::core::{Item, ItemKind};
use agentkit::loop_::{
    Agent, LoopInterrupt, LoopStep, PromptCacheRequest, PromptCacheRetention, SessionConfig,
};
use agentkit::provider_openrouter::{OpenRouterAdapter, OpenRouterConfig};
use agentkit::reporting::StdoutReporter;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let adapter = OpenRouterAdapter::new(OpenRouterConfig::from_env()?)?;

    // Preload the opening user turn through the builder.
    let agent = Agent::builder()
        .model(adapter)
        .observer(StdoutReporter::new(std::io::stdout()))
        .input(vec![Item::text(ItemKind::User, "What is the capital of France?")])
        .build()?;

    let mut driver = agent
        .start(SessionConfig::new("demo").with_cache(
            PromptCacheRequest::automatic().with_retention(PromptCacheRetention::Short),
        ))
        .await?;

    loop {
        match driver.next().await? {
            LoopStep::Finished(result) => {
                println!("Finished: {:?}", result.finish_reason);
                break;
            }
            LoopStep::Interrupt(LoopInterrupt::ApprovalRequest(approval)) => {
                approval.approve(&mut driver)?;
            }
            LoopStep::Interrupt(LoopInterrupt::AwaitingInput(req)) => {
                // Real apps would prompt the user; here we end the conversation.
                req.submit(&mut driver, vec![])?;
                break;
            }
            LoopStep::Interrupt(LoopInterrupt::AfterToolResult(_)) => {
                // Cooperative yield between tool rounds. Resume immediately.
                continue;
            }
        }
    }

    Ok(())
}

Agent with filesystem and shell tools

use agentkit::core::{Item, ItemKind};
use agentkit::loop_::{Agent, PromptCacheRequest, PromptCacheRetention, SessionConfig};
use agentkit::provider_openrouter::{OpenRouterAdapter, OpenRouterConfig};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let adapter = OpenRouterAdapter::new(OpenRouterConfig::from_env()?)?;

    let agent = Agent::builder()
        .model(adapter)
        // Each registry is its own ToolSource — register them independently
        // so collisions surface at registration time.
        .add_tool_source(agentkit::tool_fs::registry())
        .add_tool_source(agentkit::tool_shell::registry())
        .input(vec![Item::text(
            ItemKind::User,
            "List the files under ./src and summarise the entry point.",
        )])
        .build()?;

    let _driver = agent.start(
        SessionConfig::new("coding-agent").with_cache(
            PromptCacheRequest::automatic().with_retention(PromptCacheRetention::Short),
        ),
    ).await?;

    Ok(())
}

Composing reporters

use agentkit::reporting::{
    CompositeReporter, JsonlReporter, TranscriptReporter, UsageReporter,
};

let reporter = CompositeReporter::new()
    .with_observer(JsonlReporter::new(Vec::new()))
    .with_observer(UsageReporter::new())
    .with_observer(TranscriptReporter::new());

Bring-your-own ModelAdapter

When implementing a custom adapter, only the default features are needed:

[dependencies]
agentkit = "0.7"

use agentkit::loop_::{Agent, ModelAdapter, SessionConfig};

// Implement ModelAdapter for your backend, then:
// let agent = Agent::builder().model(my_adapter).build()?;

See the book and the in-tree examples/ directory for end-to-end programs covering streaming, MCP, compaction, parallel tools, session persistence, subagents, and Lua-driven multi-tool composition (openrouter-codemod).