Dream (nightly consolidation)
dreamDreaming: a scheduled consolidation sweep over this vault. Light stages what changed since the last dream (near-duplicate concepts, finished task outcomes, hygiene counts); REM asks an LLM for proposals; deep applies the ones that pass threshold gates: merges duplicates (edges redirected, the other tombstoned), promotes outcome knowledge into concepts, adds missing links, and files a task for each contradiction. A sweep that would touch too much of the vault is rejected; every applied dream keeps preimages and can be reverted. {action: "status"} shows schedule + last dream; {action: "run"} dreams now; {action: "diary"} reads the Dream Diary; {action: "revert", id} undoes one dream; {action: "configure", ...} sets the schedule, mode (apply, propose, light-only), phases, thresholds, caps, a stricter loss rail and the LLM choice; {action: "apply", id, proposals?} decides a proposed dream. Without an LLM only light runs.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "dream"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | With "revert" or "apply": the dream id (from "diary" or "status"). | |
| llm | No | With "configure": Cloud: which LLM the REM step uses — "auto" (default), "workers-ai", or "byok" (only the account's own key) — and a model id for the account's own key; null clears it. | |
| caps | No | With "configure": Most changes per dream: maxMerges 5 (1-20), maxPromotions 5 (1-20), maxLinks 10 (1-50), maxContradictions 3 (1-10). | |
| mode | No | With "configure": "apply" writes the changes that pass the gates (default); "propose" holds them in the Dream Diary until approved with {action: "apply"}; "light-only" never calls an LLM. | |
| limit | No | With "diary": how many entries to return (default 10). | |
| action | Yes | "status" reports the settings, the last/next dream and any sweep in flight. "run" starts (or continues) a sweep NOW and advances it as far as one request allows. "diary" returns recent Dream Diary entries (newest first). "revert" undoes one dream via its preimages (requires `id`). "configure" changes this vault's dreaming settings. "apply" decides a proposed dream (propose mode): applies the listed `proposals` (all when omitted) and rejects the rest (requires `id`). | |
| phases | No | With "configure": Turn individual kinds of change on or off: merges, promotions, links, contradictions. | |
| enabled | No | With "configure": Turn scheduled dreaming on or off. | |
| lossRail | No | With "configure": How much of the vault one dream may modify: maxTouchFraction (0.01-0.2) and minTouchAllowance (0-3). Can only be made stricter than the defaults. | |
| proposals | No | With "apply": the proposal numbers (`n`) to approve; omit for all, [] to reject all. | |
| runHourUtc | No | With "configure": Preferred UTC hour for a dream when the cadence is 24h or more; null clears it. | |
| thresholds | No | With "configure": Minimum confidence (0.5-1) per kind: merge 0.8, promote 0.7, link 0.7, contradiction 0.6 by default. | |
| cadenceHours | No | With "configure": Hours between dreams (default 24). |