Dream 是一次异步记忆整理任务。调用方创建任务后，通过列表或详情接口查询执行状态和结果。
Dream 是一次异步记忆整理任务。调用方创建任务后，通过列表或详情接口查询执行状态和结果。
创建、列表、详情、取消和归档接口均使用以下 Dream 对象：
直接以
创建任务时解析并记录指定 Identity 与 Template 当前的 Default Memory。任务完成后，输出 Memory Store 自动成为同一 Identity 与 Template 的新 Default Memory。
如果任务执行期间 Default Memory 已被其他操作替换，不会覆盖新的挂载关系，而是将 Dream 标记为
Dream 完成后，
Dream 对象
创建、列表、详情、取消和归档接口均使用以下 Dream 对象：
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | Dream ID，前缀为 drm_。 |
type | string | 固定为 dream。 |
status | string | 执行状态，见 Dream 状态。 |
inputs | object[] | 创建任务时提交的输入。identity_template 输入保持原始形式返回，不展开内部解析出的 Memory Store ID。 |
outputs | object[] | 整理结果。任务完成前以及执行失败或取消时返回空数组。 |
model | object | 本次任务使用的模型配置。 |
model.id | string | 模型档位：auto、lite 或 ultimate。 |
instructions | string | 创建任务时提交的整理指令；未提交时为空字符串。 |
usage | object | Token 用量，见 Dream usage。任务尚未产生用量时各字段为 0。 |
error | object/null | 任务失败时的错误详情，见 Dream error；其他状态为 null。 |
created_at | string | 创建时间，UTC RFC 3339 格式。 |
ended_at | string/null | 进入终态的时间，UTC RFC 3339 格式；尚未结束时为 null。 |
archived_at | string/null | 归档时间，UTC RFC 3339 格式；未归档时为 null。 |
Dream 状态
| 值 | 说明 |
|---|---|
pending | 已创建，等待执行。 |
running | 正在整理记忆。 |
completed | 整理完成，outputs 包含结果 Memory Store。 |
failed | 执行或结果应用失败，具体原因见 error。 |
canceled | 任务已取消。 |
completed、failed 和 canceled 是终态。
Dream input
inputs 必须包含且仅包含一个主要输入，并可以附加 Session 输入：
type | 字段 | 说明 |
|---|---|---|
memory_store | memory_store_id | 直接整理当前调用方可访问的 Memory Store。 |
identity_template | identity_id、template_id | 整理指定 Identity 与 Template 当前挂载的 Default Memory。 |
sessions | session_ids | 可选的重点回顾 Session ID 数组；所有 sessions 输入合计最多 100 个 ID。 |
memory_store 和 identity_template 互斥，不能在同一次请求中同时提交。每种输入只能携带该类型定义的字段。
memory_store 的处理方式
直接以 memory_store_id 指定的 Memory Store 作为输入。任务完成后，输出是一个新的 Memory Store；原输入 Store 不会被覆盖，也不会自动修改任何 Identity 与 Template 的挂载关系。
identity_template 的处理方式
创建任务时解析并记录指定 Identity 与 Template 当前的 Default Memory。任务完成后，输出 Memory Store 自动成为同一 Identity 与 Template 的新 Default Memory。
如果任务执行期间 Default Memory 已被其他操作替换，不会覆盖新的挂载关系，而是将 Dream 标记为 failed，并返回错误码 memory_changed_during_dream。
Dream output
Dream 完成后，outputs 包含一个元素：
| 字段 | 类型 | 说明 |
|---|---|---|
type | string | 固定为 memory_store。 |
memory_store_id | string | 整理后生成的 Memory Store ID。 |
files_touched | string[] | 本次整理创建、修改或删除的记忆文件路径；没有明细时省略。 |
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。 |
code | string | 可选的稳定错误码；未提供时不返回此字段。 |
message | string | 面向排查的错误描述，不应作为程序判断依据。 |