附录 A：模块 API 速查
表 A-1 核心模块的包路径与职责
| 模块 | 包路径 | 主要导出 |
|---|---|---|
| coordinator | runtime.coordinator |
CoordinatorAgent, Intent, INTENT_REGEXES |
| rule_registry | runtime.rule_registry |
BaseRule, RuleRegistry, RuleResult |
| rule_engine | runtime.rule_engine |
RuleEngine |
| audit_engine | runtime.audit_engine |
AuditEngine, HIGH_RISK_ACTIONS |
| permission | runtime.permission |
PermissionSystem, ROLE_*, AGENT_ROLE_ACCESS |
| sod | runtime.sod |
SODChecker |
| agent_security | runtime.agent_security |
AgentSecurity, SecurityResult |
| module_toggles | runtime.module_toggles |
ModuleToggleManager, require_module |
| chain_gate | runtime.chain_gate |
ChainGateChecker, GateResult |
| workflow_enforcer | runtime.workflow_enforcer |
WorkflowEnforcer |
| intent_recognition | runtime.intent_recognition |
IntentRecognizer, Intent |
| sub_intent_engine | runtime.sub_intent_engine |
recognize_sub_intent, get_sub_intent_defs, invalidate_cache |
| slot_engine | runtime.slot_engine |
extract_slots, merge_uploaded_files |
| query_param_parser | runtime.query_param_parser |
parse_query_filters, llm_complete_filters |
| multi_hop | runtime.multi_hop |
split_compound, is_ordered_chain, chain_context_inject |
| trace | runtime.trace |
new_trace, get_trace_id, set_trace_id, clear_trace |
| session_manager | runtime.session_manager |
SessionManager |
| logger | runtime.logger |
Logger |
| cache | runtime.cache |
CacheManager, get_cache |
| event_bus | runtime.event_bus |
EventBus, RedisStreamBus, publish_event |
| file_storage | runtime.file_storage |
FileStorageBase, S3Storage, get_file_storage |
| streaming | runtime.streaming |
StreamingResponse, SSEHelper |
| scheduler | runtime.scheduler |
TaskScheduler, ScheduledTask |
| auth | runtime.auth |
TokenSigner, Authenticator, MockUserSource |
| database | runtime.database |
get_database, set_database |
| debug | runtime.debug |
DEBUG, set_debug |
| numbering | runtime.numbering |
load_numbering_prefix |
| number_builder | runtime.number_builder |
build_number |
| id_registry | runtime.id_registry |
get_id_specs, submit_id_specs_change, apply_id_specs_change |
| session_golden | eval.session_golden |
extract, diff_golden, commit_golden |