客户端运行时
供 Web 和移动端共享的客户端(client)行为。公开 API 按包的子路径组织。该包有意不提供根导出。
公开子路径
| 子路径 | 职责 |
|---|---|
authorization | Bearer 与 DPoP 授权,以及令牌持久化契约 |
connection | 目标、目录、监督、重试、注册表和引导 |
environment | 环境(environment)身份、描述符、端点和作用域键 |
errors | 共享的客户端(client)错误检查 |
operations | 多步应用工作流 |
operations/projects | 多步项目(project)创建工作流 |
platform | 平台能力与持久化服务契约 |
relay | 托管中继(relay)API 与环境发现 |
rpc | HTTP/RPC 客户端、协议、提供方会话(session)和订阅 |
state/<domain> | 聚焦的共享状态、保留、归约器和 Atom 构造器 |
voice-input | 录制生命周期、转写契约和草稿插入 |
依赖方向
平台应用提供 platform 服务。connection 把这些能力与 authorization、relay 和 rpc 组合起来,用以监督环境(environment)的提供方会话(session)。独立的 state 模块使用连接注册表,并向应用自有的运行时暴露聚焦状态或 Atom 构造器。
voice-input 控制器接受采集回调和选定的 VoiceTranscriber。准备阶段把转写绑定到它的实现和已解析的区域设置;同一个取消信号覆盖这两项操作。应用提供录音器事件(event)、权限、原生转写实现和呈现。
应用应当导入最窄的相关子路径。没有宽泛的 state 导出:请使用领域路径,例如 state/shell、state/threads、state/terminal 或 state/vcs。子路径索引和显式导出的领域文件是公开 API 边界;其余文件仍是实现细节。