flowchart TB
    LOG["会话事件日志\nappend-only，唯一权威"]

    subgraph L1 ["第一层：Provider KV / 前缀缓存（省钱省延迟，命中在提供方侧）"]
        DM["deriveMessages 纯投影\n每个 surface 节点只投影一次"]
        SP["system-prompt 组装\n静态 section 在前 / 动态 context 置于历史之后"]
        HDR["EpochHeader\nsystem + tools 快照"]
        REQ["请求 = 前一次请求的追加延伸\n→ 前缀稳定是推论，不是管理出来的"]
        DM --> REQ
        SP --> HDR --> REQ
    end

    subgraph L2 ["第二层：会话投影缓存（唯一持久缓存，加速冷读列表）"]
        PC["ctx.sessionProjectionCache\nsession_projcache 域"]
        ROW["行 (key → ver,seq,val)\n是折叠快捷方式，永不作为权威"]
        LADDER["冷读阶梯：缓存行 → readFrom 尾部 → restore → 回写"]
        PC --> ROW --> LADDER
    end

    subgraph L3 ["第三层：进程内派生缓存（存活于单进程，随对象回收）"]
        CRED["credentials-local / settings-file\n内存快照 + 文件监听热更新"]
        WM["WeakMap 按对象缓存\nhook / effect / 配置刷新"]
    end

    LOG --> DM
    LOG --> SP
    LOG -->|turn/end、销毁、阈值触发写回| PC
    LOG -.->|派生| CRED

    REQ -->|发往提供方| PROVIDER["模型提供方\n按前缀 token 序列命中 KV 缓存"]
    PROVIDER -->|usage 回传| METER["TokenUsage 不相交口径\ncacheReadTokens 单列计量"]

sequenceDiagram
    participant L as 主循环
    participant J as 事件日志
    participant P as 提示词组装
    participant M as 大模型
    participant T as 工具注册表
    L->>J: 记录「轮次开始」
    loop 每个步骤，直到没有待处理的工作
        L->>L: 从收件箱认领输入
        L->>J: 记录「步骤开始」与用户消息
        L->>P: 请求本次的提示词前缀
        P-->>L: 静态片段、动态上下文、工具描述
        L->>J: 从日志投影出消息历史
        J-->>L: 消息列表
        L->>M: 发起流式请求
        M-->>L: 增量分片
        L->>J: 记录分片与完整回复
        opt 模型要求调用工具
            L->>J: 记录工具调用
            L->>T: 分发执行
            T-->>L: 结果或结构化失败
            L->>J: 记录工具结果
        end
        L->>J: 记录「步骤结束」
    end
    L->>J: 记录「轮次结束」与结束原因