Crate katu_core 

katu-core

职责

定义 Katu AI Agent 框架的核心 trait 与类型。 零外部 katu 依赖，是整个系统的“接口契约“层。

对外接口

• types — newtype ID 与基础枚举 (SessionId, MessageId, Role, FinishReason…)
• error — 全局错误类型 (Error, ProviderErrorKind, AuthErrorKind, Result)
• usage — token 用量与费用类型 (Usage, Cost)
• message — 对话消息类型 (Message, ContentBlock, AssistantBlock…)
• generation — LLM 生成参数 (GenerationOptions)
• event — LLM 流式事件 (StreamEvent, ToolResultValue)
• agent_event — Agent 语义层事件 (AgentEvent, AgentEventKind, AgentFinishReason…)
• tool — 工具类型与执行契约 (Tool, ToolDefinition, ToolOutput, ToolCallContext…)
• agent — Agent 定义数据模型 (AgentDefinition, AgentRole, ToolFilter…)
• hook — Hook 系统类型与执行契约 (Hook, HookEvent, HookInput, HookOutput, HookRegistry…)
• permission — 权限系统类型与规则引擎 (PermissionRule, Ruleset, PermissionDecision, PermissionMode…)

Re-exports

pub use agent::AgentDefinition;

pub use agent::AgentModelRef;

pub use agent::AgentName;

pub use agent::AgentRole;

pub use agent::ToolFilter;

pub use agent_event::AgentEvent;

pub use agent_event::AgentEventKind;

pub use agent_event::AgentFinishReason;

pub use compaction::CompactTrigger;

pub use compaction::CompactionConfig;

pub use compaction::CompactionResult;

pub use compaction::TokenBudgetState;

pub use error::Error;

pub use error::Result;

pub use generation::GenerationOptions;

pub use event::StreamEvent;

pub use event::ToolResultValue;

pub use message::AssistantBlock;

pub use message::AssistantMessage;

pub use message::ContentBlock;

pub use message::Message;

pub use message::ToolResultMessage;

pub use message::UserContent;

pub use message::UserMessage;

pub use tool::ConcurrencyMode;

pub use tool::Tool;

pub use tool::ToolCallContext;

pub use tool::ToolChoice;

pub use tool::ToolDefinition;

pub use tool::ToolOutput;

pub use usage::Cost;

pub use usage::Usage;

pub use types::*;

Modules

agent

katu_core::agent

agent_event

katu_core::agent_event

compaction

katu_core::compaction

error

katu_core::error

event

katu_core::event

generation

katu_core::generation

hook

katu_core::hook

message

katu_core::message

permission

katu_core::permission

tool

katu_core::tool

types

katu_core::types

usage

katu_core::usage

Structs

CancellationToken

取消令牌 — re-export tokio_util::sync::CancellationToken。