Dream 对象
创建、查询、列表、取消和归档接口都会返回 Dream 对象。| 字段 | 类型 | 说明 |
|---|---|---|
id | string | Dream ID，前缀为 drm_ |
type | string | 固定值 "dream" |
status | string | Dream 状态，见 Dream status |
inputs | array | 输入列表，见 Dream input |
outputs | array | 输出列表，见 Dream output |
model | object | 使用的模型，格式 {"id": "auto"} |
instructions | string | 自定义整理指令，最长 4096 字符 |
session_id | string 或 null | 关联的 Dreaming Session ID（运行后填充） |
usage | object | Token 用量统计 |
error | object 或 null | 失败时的错误详情 |
created_at | string | UTC 创建时间（ISO 8601） |
ended_at | string 或 null | UTC 结束时间（仅终态时有值） |
archived_at | string 或 null | UTC 归档时间 |
Dream status
| 值 | 说明 |
|---|---|
pending | 已创建，等待执行 |
running | 正在执行记忆整理 |
completed | 整理完成，outputs 中有结果 |
failed | 执行失败，error 中有原因 |
canceled | 被用户取消 |
Dream input
inputs 数组中的每个元素：
| type 值 | 必填字段 | 说明 |
|---|---|---|
memory_store | memory_store_id | 指定输入 Memory Store（必选，且仅允许一个） |
sessions | session_ids | 指定重点回顾的 Session（可选，最多 100 个 ID） |
Dream output
Dream 完成后，outputs 数组中的元素：
| 字段 | 类型 | 说明 |
|---|---|---|
type | string | 固定值 "memory_store" |
memory_store_id | string | 整理后的输出 Memory Store ID |
files_touched | array | 被创建/修改/删除的 memory 文件路径列表 |
Dream usage
| 字段 | 类型 | 说明 |
|---|---|---|
input_tokens | integer | 输入 token 数 |
output_tokens | integer | 输出 token 数 |
cache_creation_input_tokens | integer | 缓存创建 token 数 |
cache_read_input_tokens | integer | 缓存读取 token 数 |
Dream error
失败时返回的错误对象：| 字段 | 类型 | 说明 |
|---|---|---|
type | string | 错误类型（如 "no_output"、"internal_error"） |
message | string | 错误描述 |