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 用量统计
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	错误描述