会话事件与持久化提供方扩展
本页界定会话事件与持久化提供方扩展的源码核查范围。当前可取得的证据只确认仓库存在会话持久化相关的测试配置与会话 UI 入口，不足以确认扩展接口、事件语义或存储实现；以下明确区分已验证事实与待核查事项。
Purpose and Scope（目的与范围）
目标读者是需要定位会话事件、持久化实现及测试入口的开发者。本页聚焦扩展契约与持久化提供方的核查线索；会话格式版本迁移、检查点策略及 UI 交互细节应分别归入相应专题，而不在此推断其机制。仓库路径中可见独立的 session-format-catalog、session-checkpoint-policy 与 ui-session。这些路径仅证明模块存在，不证明它们之间的调用关系。
Overview（概览）
vitest.config.ts 第 105 行 出现 packages/session/session-persistence-jsonl/src/lease.ts，第 157 行出现 packages/session/session-persistence-jsonl/tests/jsonl.spec.ts。因此，JSONL 持久化及租约至少是测试配置引用的关注点；但实现细节未从源码取得，不能据此断定记录格式、锁语义或提供方生命周期。仓库还存在 session-provider.tsx 与相应的 session-provider.client.spec.tsx；名称相近不代表该 UI provider 就是磁盘持久化 provider。
Architecture（证据范围图）
下图仅表示已发现的目录归属及配置文件中的路径引用，不是运行时依赖图；不应从箭头推导调用顺序。
Source: vitest.config.ts
在未读取实现文件前，无法验证会话事件生产者、持久化提供方接口、依赖注入连接、数据库或磁盘写入路径。该图特意不连接 UI provider 与 JSONL 模块，以免把文件命名误当成架构证据。
实现与核查边界
持久化相关路径
已验证的配置引用如下；这是真实源码行的摘录，不是用于初始化提供方的调用示例：
'packages/session/session-persistence-jsonl/src/lease.ts',Source: vitest.config.ts
'packages/session/session-persistence-jsonl/tests/jsonl.spec.ts',Source: vitest.config.ts
前一项位于配置文件中的注释 “Windows suite through the real backend” 之后；后一项位于 processBoundTests 数组的开头。仅凭这些局部行不能确定 lease.ts 的导出 API、租约算法，也不能确定 jsonl.spec.ts 中的断言或测试隔离机制。
会话 UI 与其他会话模块
session-provider.tsx 是可定位的客户端文件；provider.client.spec.ts 则属于 workspace-files，不应仅因文件名含 provider 就视为会话持久化测试。会话格式目录下可定位 current.ts 和 historical.ts，但这些文件的类型定义、版本边界与扩展关系尚未核实。
Core Flow（待验证）
未找到经读取验证的事件产生、事件交付、写入、恢复或关闭流程。Implementation details not found in source：本次受限源码采集未能读取核心实现，不提供推测性的顺序图或调用链。扩展时应先检查实际接口和实现，再确定如何注册提供方、序列化事件以及恢复会话。
Usage Examples（已验证摘录）
上面的两段配置摘录是本页仅有的可核对源码示例；No code example available for provider registration, event subscription, persistence writes, or session replay. 它们不能直接作为应用程序中的用法复制。
Configuration Options
未读取到可验证的配置键、类型、默认值或环境变量覆盖规则。不要将测试配置中的文件路径误当作用户可配置选项。
API Reference
未取得任何经过实现核实的公开方法签名、参数、返回类型或异常信息，因此不列出未经验证的 API。
Failure Modes, Edge Cases & Concurrency
lease.ts 的路径与 processBoundTests 的名称提示值得调查跨进程测试和租约，但尚不足以声称存在特定锁策略、超时、重试、冲突处理或原子写保证。有关崩溃恢复，还可在独立的 crash-recovery.e2e.ts 找到测试路径；其行为不能在未读源码时迁移为本扩展的保证。
Performance, Operations & Extension Points
未验证缓冲、刷盘、批量写入、并发访问或扩展注册机制。上线或替换持久化实现前，应以实际实现和测试为依据核查这些性质；本页不为它们承诺默认行为。
Related Links
- 会话格式相关入口：
session-format-catalog/src/index.ts。 - 检查点策略相关入口：
session-checkpoint-policy/src/index.ts。 - UI 会话入口：
ui-session/src/client/session-provider.tsx。 - 已证实的测试配置引用：
vitest.config.ts。