Dream 对象、输入/输出、状态及用量结构的完整定义。
所有 Dream 接口返回该对象。
整合完成后，
失败时返回的错误对象：
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 用量统计。参见 Dream usage |
error | object | null | 失败时的错误详情。参见 Dream error |
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
整合完成后，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 | 错误描述 |