Crate agent_framework_core 

agent-framework-core

Core abstractions for agent-framework-rs, a Rust implementation of the Microsoft Agent Framework. This crate provides the building blocks:

• types — the data model: messages, content, responses, options.
• client — the ChatClient trait and the automatic function-invocation loop.
• agent — the SupportsAgentRun trait and Agent.
• compaction — conversation-history compaction strategies and the Tokenizer abstraction.
• tools — executable tools and hosted-tool markers.
• session — AgentSession, a lightweight conversation identity + state container.
• history — HistoryProviders: conversation history as a ContextProvider.
• memory — context / memory providers.
• middleware — agent, chat, and function middleware pipelines.
• observability — OpenTelemetry GenAI-style tracing instrumentation.
• skills — Skill capability packages, surfaced via SkillsProvider, a ContextProvider that progressively discloses skill instructions and resources through framework-generated tools.
• settings — secret-masking SecretString and precedence-based setting resolution.
• workflow — graph-based multi-agent workflow orchestration.

Example

use agent_framework_core::prelude::*;
let agent = Agent::builder(client)
    .name("assistant")
    .instructions("You are a helpful assistant.")
    .build();

let response = agent.run_once("Hello!").await?;
println!("{}", response.text());

Re-exports

pub use error::Error;

pub use error::Result;

Modules

agent

Agents: the SupportsAgentRun trait and the concrete Agent.

client

The chat client trait and the automatic function-invocation loop.

compaction

Conversation-history compaction.

error

Error types for the agent framework.

history

Conversation-history context providers.

memory

Context / memory providers.

middleware

Middleware pipelines for agents, chat clients, and function invocation.

observability

Lightweight OpenTelemetry GenAI-style span instrumentation, built on the tracing crate, plus optional GenAI metrics behind the otel-metrics feature.

prelude

Commonly used imports.

session

Conversation sessions.

settings

Lightweight settings helpers: a secret-masking string newtype and a precedence-based value loader.

skills

Skills: progressive-disclosure capability packages.

streaming

Utilities for decoding streamed bytes.

tools

Tools: executable functions and hosted-tool markers.

types

Core data model: content, messages, responses, and options.

workflow

Graph-based multi-agent workflow orchestration.