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) ──
26pub use phi_telemetry::{
27    SessionMetrics, SessionOutcome, SessionSummary, TurnMetrics, TurnOutcome, list_all_metrics, load_metrics,
28    save_metrics, try_load_metrics,
29};
30
31// ── agent-works ──
32pub use agent_works::focus::{Context as FocusContext, Focus, FocusError, FocusInput, FocusOutput};
33
34// ── phi-agent types ──
35pub use agent::{PhiAgent, PhiAgentConfig, base_agent_builder};
36pub use cli::{ApprovalMode, AutoApprovalHandler};
37pub use config::{LlmConfig, resolve_llm_config};
38pub use event_log::{event_to_jsonl, event_to_value, save_turn_log};
39pub use prompt::{build_system_prompt, build_system_prompt_cn};
40pub use render::{
41    EventRenderer, JsonStreamRenderer, NullRenderer, OutputFormat, create_renderer, create_stdout_renderer,
42};
43pub use session::SessionContext;