Skip to main content

phi_agent/
lib.rs

1//! phi-agent: General-purpose AI Agent framework
2//!
3//! Built on agent-base and agent-works, providing builder factory, renderer,
4//! config resolution, session management, and other infrastructure.
5//! **Does not bundle any tools** — tools are injected by consumers.
6
7pub mod agent;
8pub mod cli;
9pub mod config;
10pub mod event_log;
11pub mod prompt;
12pub mod render;
13pub mod session;
14
15// ── Common agent-base types ──
16// Only re-export the types consumers use most often.
17// For the full type set, import directly from agent-base.
18pub use agent_base::{
19    AgentBuilder, AgentError, AgentResult, AgentRuntime, ApprovalHandler, ConsecutiveFailureRecovery, LlmClient,
20    OpenAiClient, PlanItem, PlanStepStatus, ReasoningConfig, ReasoningEffort, RunOutcome, RuntimeEvent, SafetyConfig,
21    SessionId, Tool, ToolContext, ToolControlFlow, ToolOutput, TurnFactMiddleware, TurnToolLimitMiddleware,
22    UpdatePlanTool,
23};
24
25// ── phi-telemetry (metrics types and storage) ──
26#[cfg(feature = "telemetry")]
27pub use phi_telemetry::{
28    SessionMetrics, SessionOutcome, SessionSummary, TurnMetrics, TurnOutcome, list_all_metrics, load_metrics,
29    save_metrics, try_load_metrics,
30};
31
32// ── agent-works ──
33pub use agent_works::focus::{Context as FocusContext, Focus, FocusError, FocusInput, FocusOutput};
34
35// ── phi-agent types ──
36pub use agent::{PhiAgent, PhiAgentConfig, base_agent_builder};
37pub use cli::{ApprovalMode, AutoApprovalHandler};
38pub use config::{LlmConfig, resolve_llm_config};
39pub use event_log::{event_to_jsonl, event_to_value, save_turn_log};
40pub use prompt::{build_system_prompt, build_system_prompt_cn};
41pub use render::{
42    EventRenderer, JsonStreamRenderer, NullRenderer, OutputFormat, create_renderer, create_stdout_renderer,
43};
44pub use session::SessionContext;