会话
会话是创建应用的一个工作单元。智能体修改文件，这些变更以提交的形式累积，必要时可以回退。
创建会话
POST /api/session
响应中的 id 即为后续所有会话调用所使用的 {sessionId}。
保持活跃
POST /api/session/{sessionId}/ping
定期发送，避免会话因空闲被清理。Web UI 在打开工作界面期间应持续调用。
文件
| 方法 | 路径 | 作用 |
|---|---|---|
GET | /api/session/{sessionId}/files | 文件列表 |
GET | /api/session/{sessionId}/file?path={path} | 单个文件的内容 |
GET | /api/session/{sessionId}/download | 下载整个项目 |
path 需要进行 URL 编码。
历史与回退
| 方法 | 路径 | 作用 |
|---|---|---|
GET | /api/session/{sessionId}/history | 提交历史 |
GET | /api/session/{sessionId}/transcript | 完整对话记录 |
GET | /api/session/{sessionId}/diff?hash={hash} | 指定提交的变更内容 |
POST | /api/session/{sessionId}/revert | 回退到指定提交（正文中包含 hash） |
回退不会删除历史 —— 回退操作本身也会作为新的提交保留。
确认与丢弃
| 方法 | 路径 | 作用 |
|---|---|---|
POST | /api/session/{id}/commit | 提交此前的全部变更（正文中包含 message，可省略） |
POST | /api/session/{id}/discard | 丢弃变更，将会话恢复为初始状态 |
POST | /api/session/{id}/verify | 验证应用能否实际运行 |
DELETE | /api/session/{sessionId} | 删除会话 |
共享
PUT /api/session/{id}/share
在正文中发送允许查看的用户 ID 数组。
{ "users": ["kim.cs", "park.jh"] }
发送空数组即可取消共享。
数据上下文
PUT /api/session/{id}/data-context
指定会话面向哪些设备和标签。智能体创建应用时会参考该范围。发送 null 即可解除。