/**
 * ============================================================
 *  src/types.ts —— 全局核心类型定义
 * ------------------------------------------------------------
 *  这个文件是项目的"类型字典"，所有模块都从这里 import 类型。
 *  新手阅读建议：从上往下，每个类型上方有"何时用 / 为何这么设计"的注释。
 *
 *  设计原则：
 *  - 形状跟 OpenAI Chat Completions API 对齐（多 provider 兼容性最好）
 *  - 不用 class，全用 interface / type alias（更轻、更易读）
 *  - 一切尽量简单：能用基本类型就不引第三方
 * ============================================================
 */
export {};
// 注：插件私有事件（如 workflow-runner 的 workflow_*）不再写在这里。
// 插件通过 PluginEvent 开放契约 yield 任意 type 字符串的事件，UI 静默忽略未识别项。
