@oharness/engine 0.11.0 → 0.14.0

package/dist/runtime-plugins/builtin/dreaming.js

@@ -0,0 +1,231 @@
+import { noteHash, memoryNote } from "../../agent/memory.js";
+import { consolidationEnabled } from "../../agent/memory-limits.js";
+import { DEFAULT_DREAMING, DreamCoordinator } from "./dreaming-coordinator.js";
+import { BackgroundUsage } from "../../agent/background-usage.js";
+import { localDay } from "../../agent/memory-ledger.js";
+import { usageFor } from "./memory.js";
+import { updateRuntimePluginConfig } from "../../config-files.js";
+const SETTING_RANGES = {
+    idleHours: [0, 24 * 30], minUserTurns: [1, 1_000], startDelayMinutes: [0, 24 * 60],
+    minClaims: [1, 1_000], maxWaitHours: [1, 24 * 365], maxClaims: [1, 200], dailyTokens: [0, 10_000_000],
+};
+export function parseDreamingConfig(raw) {
+    if (raw === undefined || raw === null)
+        return { ...DEFAULT_DREAMING };
+    if (typeof raw !== "object" || Array.isArray(raw))
+        throw new Error("Invalid dreaming config");
+    const value = raw;
+    const settings = { ...DEFAULT_DREAMING };
+    if (value.auto !== undefined) {
+        if (value.auto !== true && value.auto !== false && value.auto !== "subscribers")
+            throw new Error("dreaming.auto must be true, false or \"subscribers\"");
+        settings.auto = value.auto;
+    }
+    for (const [key, [min, max]] of Object.entries(SETTING_RANGES)) {
+        const field = value[key];
+        if (field === undefined)
+            continue;
+        if (typeof field !== "number" || !Number.isFinite(field) || field < min || field > max)
+            throw new Error(`dreaming.${key} must be a number from ${min} to ${max}`);
+        settings[key] = field;
+    }
+    return settings;
+}
+/**
+ * What the page shows for a change: its kind, the notes before, the notes as
+ * the change left them (when they still are), and its evidence.
+ */
+function changeView(change, notes) {
+    return {
+        id: change.id, op: change.op, summary: change.summary, evidence: change.evidence,
+        before: change.before.map((one) => one.note ? { id: one.id, summary: one.note.summary, body: one.note.body } : { id: one.id }),
+        after: change.after.map((one) => {
+            if (!one.hash)
+                return { id: one.id, removed: true };
+            const now = notes.get(one.id);
+            return now && now.hash === one.hash ? { id: one.id, summary: now.summary, body: now.body } : { id: one.id, editedSince: true };
+        }),
+        ...(change.run ? { run: change.run } : {}),
+        ...(change.fromProposal ? { fromProposal: true } : {}),
+    };
+}
+function proposalView(op, notes) {
+    const ids = op.op === "merge" ? op.ids : "id" in op ? [op.id] : [];
+    return {
+        op: op.op,
+        targets: ids.map((id) => notes.get(id) ?? { id, summary: id, body: "" }),
+        ...("summary" in op ? { summary: op.summary, body: op.body, tags: op.tags } : {}),
+        ...("reason" in op ? { reason: op.reason } : {}),
+    };
+}
+function runView(run) {
+    return {
+        at: run.at, digested: run.digested, ...(run.budgetStopped ? { budgetStopped: true } : {}),
+        applied: run.scopes.reduce((sum, scope) => sum + scope.applied.length, 0),
+        proposals: run.scopes.reduce((sum, scope) => sum + scope.proposals, 0),
+        errors: run.scopes.flatMap((scope) => scope.error ? [scope.error] : []),
+    };
+}
+/** This month's dreaming, across every project: what the usage page also counts. */
+async function monthSpend(now = Date.now()) {
+    const month = localDay(now).slice(0, 7);
+    const records = (await BackgroundUsage.shared.records("dreaming")).filter((record) => record.day.startsWith(month));
+    return {
+        month,
+        calls: records.reduce((sum, r) => sum + r.calls, 0),
+        tokens: records.reduce((sum, r) => sum + r.input + r.output + r.cacheRead + r.cacheWrite, 0),
+        costUsd: records.reduce((sum, r) => sum + r.costUsd, 0),
+    };
+}
+/**
+ * Whether dreaming runs on its own, as last chosen on a page in this process.
+ *
+ * The choice is the user's, not a project's, and every harness in the process
+ * has a dreaming plugin with the settings it booted with; this is what keeps
+ * them agreeing after someone flips the switch, until they next boot from the
+ * file the choice was written to.
+ */
+let chosenAuto;
+/** Set the choice, for every project open in this process, and keep it. */
+export async function chooseAuto(auto, persist = true) {
+    chosenAuto = auto;
+    if (auto === undefined)
+        return;
+    // A new entry says it is not required: an app built before dreaming existed
+    // reads the same file, and would otherwise refuse to start without it.
+    if (persist)
+        await updateRuntimePluginConfig("dreaming", (config) => ({ ...config, auto }), { required: false });
+}
+export function createDreamingPlugin(options) {
+    return {
+        id: "dreaming", version: "1.0.0", apiVersion: 1, title: "Dreaming",
+        description: "Reads quiet conversations and keeps your notes current: corrections, patterns across conversations, merges. Changes can be undone.",
+        parseConfig: parseDreamingConfig,
+        setup(ctx, booted) {
+            const coordinator = options.coordinator ?? DreamCoordinator.shared;
+            // Read on every use: the switch on the page changes it while running.
+            const current = () => chosenAuto === undefined ? booted : { ...booted, auto: chosenAuto };
+            const services = options.memory();
+            const bridge = options.bridge;
+            if (!services.project || !options.generate || !bridge) {
+                // Nothing to build on: no notes to dream over, or no way to write them.
+                ctx.logger.info(services.project ? "dreaming idle: no model or no memory bridge" : "dreaming idle: memory is off");
+                return;
+            }
+            const generate = options.generate;
+            const project = services.project, user = services.user;
+            const notes = async (scope) => {
+                const service = scope === "user" ? user : project;
+                if (!service)
+                    return undefined;
+                const usage = usageFor(scope === "user" ? "user" : `project:${options.projectId}`);
+                return (await service.store.load()).map((entry) => {
+                    const note = memoryNote(entry);
+                    const recalled = usage.get(note.id);
+                    return {
+                        id: note.id, summary: note.summary, body: note.body, tags: note.tags, createdAt: note.createdAt, scope,
+                        ...(note.type ? { type: note.type } : {}), ...(note.updatedAt ? { updatedAt: note.updatedAt } : {}),
+                        hash: noteHash(note), ...(recalled ? { recalled: { count: recalled.count, last: recalled.last } } : {}),
+                    };
+                });
+            };
+            const maintenance = () => {
+                if (!bridge.maintenance)
+                    throw new Error("Memory is not running");
+                return bridge.maintenance;
+            };
+            const target = {
+                projectId: options.projectId,
+                sessions: options.sessions,
+                notes,
+                generate: (system, prompt, signal) => generate(system, prompt, signal),
+                settings: current,
+                autoOn: () => consolidationEnabled(current().auto, [project.tier, user?.tier]),
+                commit: (scope, changes) => maintenance().commit(scope, changes),
+                announce: (summaries) => { bridge.maintenance?.announce(summaries); },
+            };
+            // Background work waits while the person is working.
+            ctx.hooks.on("UserPromptSubmit", () => { coordinator.activity(); });
+            ctx.hooks.on("Stop", () => { coordinator.activity(); });
+            let error;
+            let controller;
+            const scopeOf = (value) => value === "user" && user ? "user" : "project";
+            const unregisterSection = bridge.sections.register({
+                id: "dreaming",
+                async read() {
+                    const [state, pending, projectNotes, userNotes, runs, spend, schedule] = await Promise.all([
+                        coordinator.state(target), coordinator.pending(target), notes("project"), notes("user"),
+                        coordinator.store.runs(options.projectId, 50), monthSpend(), coordinator.nextDream(target),
+                    ]);
+                    const labels = new Map();
+                    for (const note of [...(projectNotes ?? []), ...(userNotes ?? [])])
+                        labels.set(note.id, { id: note.id, summary: note.summary, body: note.body, hash: note.hash });
+                    const run = coordinator.lastRun(target);
+                    return {
+                        auto: target.autoOn(), autoSetting: current().auto, running: !!controller || coordinator.isRunning(), pending, spend, schedule,
+                        settings: (({ minClaims, maxWaitHours, idleHours, dailyTokens }) => ({ minClaims, maxWaitHours, idleHours, dailyTokens }))(current()),
+                        runs,
+                        ...(run ? { lastRun: runView(run) } : {}),
+                        proposals: state.proposals.slice(0, 30).map((one) => ({
+                            id: one.id, scope: one.scope, at: one.at, ...(one.why ? { why: one.why } : {}), evidence: one.evidence,
+                            ...proposalView(one.op, labels),
+                        })).map(({ targets, ...rest }) => ({
+                            ...rest, targets: targets.map(({ hash: _hash, ...target }) => target),
+                        })),
+                        log: state.log.map((one) => ({ scope: one.scope, at: one.at, undone: one.undone, ...changeView(one.change, labels) })),
+                        ...(error ? { error } : {}),
+                    };
+                },
+                async act(input) {
+                    error = undefined;
+                    if (input.action === "dreamNow") {
+                        if (controller)
+                            return;
+                        // Started, not awaited: reading ten conversations and dreaming two
+                        // scopes outlasts a page request. The page polls while `running`.
+                        controller = new AbortController();
+                        const signal = AbortSignal.any([ctx.signal, controller.signal]);
+                        void coordinator.dreamNow(target, signal)
+                            .catch((failure) => {
+                            error = failure instanceof Error ? failure.message : String(failure);
+                            ctx.logger.warn("dream now failed", { error });
+                        })
+                            .finally(() => { controller = undefined; });
+                        return;
+                    }
+                    if (input.action === "setAuto") {
+                        if (typeof input.auto !== "boolean")
+                            throw new Error("auto must be true or false");
+                        await chooseAuto(input.auto);
+                        return;
+                    }
+                    const id = typeof input.id === "string" ? input.id : "";
+                    const scope = scopeOf(input.scope);
+                    try {
+                        if (input.action === "applyProposal")
+                            await coordinator.applyProposal(target, scope, id);
+                        else if (input.action === "dismissProposal")
+                            await coordinator.dismissProposal(target, scope, id);
+                        else if (input.action === "undo")
+                            await coordinator.undo(target, scope, id);
+                        else
+                            throw new Error("Unknown dreaming action");
+                    }
+                    catch (failure) {
+                        // Shown in the section, not as a page failure: the page itself is fine.
+                        error = failure instanceof Error ? failure.message : String(failure);
+                    }
+                },
+            });
+            ctx.onDispose(unregisterSection);
+            ctx.onStart(() => {
+                const unregister = coordinator.register(target, ctx.logger);
+                // While automatic passes are on, memory's own end-of-run extraction
+                // and background merging stand down: one maintainer, not two.
+                const release = bridge.maintenance?.claim("dreaming", () => target.autoOn());
+                ctx.onDispose(() => { controller?.abort(); unregister(); release?.(); });
+            });
+        },
+    };
+}
+//# sourceMappingURL=dreaming.js.map

package/dist/runtime-plugins/builtin/dreaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dreaming.js","sourceRoot":"","sources":["../../../src/runtime-plugins/builtin/dreaming.ts"],"names":[],"mappings":"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"}

package/dist/runtime-plugins/builtin/memory.d.ts

@@ -1,10 +1,11 @@
 import { MemoryStore } from "../../agent/memory.ts";
 import type { MemoryNote, MemoryStores } from "../../agent/memory.ts";
-import type { MemoryPolicy, MemoryScope } from "../../agent/memory-limits.ts";
+import type { MemoryPolicy, MemoryScope, MemoryType } from "../../agent/memory-limits.ts";
+import { MemoryUsage } from "../../agent/memory-usage.ts";
 import type { BackupReason } from "../../agent/memory-backup.ts";
 import type { MemoryFailureInfo } from "../../agent/memory-errors.ts";
 import type { MergeField } from "../../agent/memory-merge.ts";
-import type { ExtractedNote, ExtractionResult } from "../../agent/memory-provider.ts";
+import type { ExtractedNote, ExtractedSummary, ExtractionResult } from "../../agent/memory-provider.ts";
 import type { RuntimePlugin } from "../types.ts";
 import { MemorySyncCoordinator } from "./memory-coordinator.ts";
 type Identity = {
@@ -62,6 +63,91 @@ export interface MemoryPluginOptions extends Omit<Options, "scope"> {
     userDirectory?: string;
     /** One reply from the small model, for merge proposals. Without it merges are drafted by hand. */
     generate?(system: string, prompt: string, signal?: AbortSignal): Promise<string>;
+    /** Where plugins that build on memory, such as dreaming, reach it. */
+    bridge?: MemoryBridge;
+}
+/** A note's content as a dream proposes it. */
+export interface DreamDraft {
+    summary: string;
+    body: string;
+    tags: string[];
+    type?: MemoryType;
+}
+/** One change a dream commits; `restore` puts back what a change replaced (undo). */
+export type DreamChange = {
+    kind: "create";
+    draft: DreamDraft;
+} | {
+    kind: "update";
+    id: string;
+    expectedHash: string;
+    draft: DreamDraft;
+} | {
+    kind: "merge";
+    ids: string[];
+    expectedHashes: string[];
+    draft: DreamDraft;
+} | {
+    kind: "restore";
+    id: string;
+    expectedHash: string | null;
+    note: MemoryNote | null;
+};
+/** What a committed change did: each note it touched, before and after. */
+export interface DreamCommitted {
+    ids: string[];
+    before: Array<{
+        id: string;
+        note: MemoryNote | null;
+    }>;
+    after: Array<{
+        id: string;
+        hash: string | null;
+    }>;
+}
+/**
+ * What memory lets a maintenance plugin do. Every write goes through memory's
+ * own path: expected hashes, backups, and with sync on, the cloud first.
+ */
+export interface MemoryMaintenance {
+    /**
+     * Take over background upkeep while `active()` holds: memory's own
+     * end-of-run extraction and background merging stand down. Returns the
+     * release, which restores them.
+     */
+    claim(owner: string, active: () => boolean): () => void;
+    /** All changes in one scope, as one batch; nothing is written if any is stale. */
+    commit(scope: MemoryScope, changes: readonly DreamChange[]): Promise<DreamCommitted[]>;
+    /** Told at the start of the next run in this project. */
+    announce(notes: ExtractedSummary[]): void;
+}
+/**
+ * What the harness hands both memory and a plugin built on it. Plugins cannot
+ * reach each other; memory fills `maintenance` while it runs and reads
+ * `sections`, the other plugin does the reverse.
+ */
+export declare class MemoryBridge {
+    readonly sections: MemoryPageSections;
+    maintenance?: MemoryMaintenance;
+}
+/** A part of the Memory page another plugin supplies, rendered by the host. */
+export interface MemoryPageSection {
+    id: string;
+    read(): Promise<unknown>;
+    act(input: Record<string, unknown>): Promise<void>;
+}
+/**
+ * Where plugins that build on memory, such as dreaming, put what they show on
+ * the Memory page. Plugins cannot reach each other, so the harness hands one
+ * of these to both: memory reads it, the other plugin fills it. Empty, the
+ * page is exactly what it was.
+ */
+export declare class MemoryPageSections {
+    private readonly sections;
+    register(section: MemoryPageSection): () => void;
+    /** Every section's state; one that fails is left out rather than failing the page. */
+    read(): Promise<Record<string, unknown>>;
+    act(id: string, input: Record<string, unknown>): Promise<void>;
 }
 type Conflict = {
     id: string;
@@ -202,6 +288,7 @@ export declare function acquireMemoryService(options: Options): {
     service: MemoryService;
     release(): Promise<void>;
 };
+export declare function usageFor(stateKey: string): MemoryUsage;
 /**
  * Write what an extraction pass proposed. New notes first, so every
  * `[[new:N]]` placeholder has an id to become; then the notes that used a

package/dist/runtime-plugins/builtin/memory.js

@@ -4,7 +4,7 @@ import { createHash } from "node:crypto";
 import { AUTO_KINDS, reviewNotes } from "../../agent/memory-review.js";
 import { CONSOLIDATE_PROMPT, draftByHand, mergePrompt, parseMergeReply, planMerge } from "../../agent/memory-consolidate.js";
 import { rm } from "node:fs/promises";
-import { MemoryStore, loadScoped, memoryIndexSection, memoryNote, noteHash, recallFromStores, storeFor, validateNote, validMemoryId } from "../../agent/memory.js";
+import { MemoryStore, loadScoped, memoryIndexSection, memoryNote, newNoteId, noteHash, recallFromStores, storeFor, validateNote, validMemoryId } from "../../agent/memory.js";
 import { DEFAULT_MEMORY_POLICY, MEMORY_SAFETY, consolidationEnabled, isMemoryType } from "../../agent/memory-limits.js";
 import { rankNotes } from "../../agent/memory-recall.js";
 import { findSecrets } from "../../agent/memory-redact.js";
@@ -20,6 +20,48 @@ import { readPluginFile, readUserFile, updateRuntimePluginConfig, writeUserFile
 import { projectId } from "../../storage/project.js";
 import { resolveSyncUrl } from "../../sync/settings.js";
 import { MemorySyncCoordinator } from "./memory-coordinator.js";
+/**
+ * What the harness hands both memory and a plugin built on it. Plugins cannot
+ * reach each other; memory fills `maintenance` while it runs and reads
+ * `sections`, the other plugin does the reverse.
+ */
+export class MemoryBridge {
+    sections = new MemoryPageSections();
+    maintenance;
+}
+/**
+ * Where plugins that build on memory, such as dreaming, put what they show on
+ * the Memory page. Plugins cannot reach each other, so the harness hands one
+ * of these to both: memory reads it, the other plugin fills it. Empty, the
+ * page is exactly what it was.
+ */
+export class MemoryPageSections {
+    sections = new Map();
+    register(section) {
+        if (!/^[a-z][a-z0-9-]{0,63}$/.test(section.id) || this.sections.has(section.id))
+            throw new Error("Invalid or duplicate memory page section");
+        this.sections.set(section.id, section);
+        return () => { if (this.sections.get(section.id) === section)
+            this.sections.delete(section.id); };
+    }
+    /** Every section's state; one that fails is left out rather than failing the page. */
+    async read() {
+        const out = {};
+        await Promise.all([...this.sections.values()].map(async (section) => {
+            try {
+                out[section.id] = await section.read();
+            }
+            catch { /* left out */ }
+        }));
+        return out;
+    }
+    async act(id, input) {
+        const section = this.sections.get(id);
+        if (!section)
+            throw new MemoryError("unknownAction");
+        await section.act(input);
+    }
+}
 const digest = (x) => createHash("sha256").update(x).digest("hex");
 const object = (x) => !!x && typeof x === "object" && !Array.isArray(x);
 const HASH = /^[a-f0-9]{64}$/;
@@ -859,7 +901,7 @@ export function acquireMemoryService(options) {
 }
 /** Recall counts per logical scope, shared so one Home-side file has one writer. */
 const sharedUsage = new Map();
-function usageFor(stateKey) {
+export function usageFor(stateKey) {
     const key = stateKey;
     let usage = sharedUsage.get(key);
     if (!usage) {
@@ -949,7 +991,10 @@ export function createMemoryPlugin(options, onReady) {
                 ctx.tools.register(tool);
             ctx.prompts.register(async () => {
                 try {
-                    return memoryIndexSection((await loadScoped(stores)).notes, policy.indexChars, { showScope: !!user });
+                    return memoryIndexSection((await loadScoped(stores)).notes, policy.indexChars, {
+                        showScope: !!user,
+                        recency: (note) => (usage[note.scope] ?? usage.project).recency(note, noteHash(memoryNote(note.entry))),
+                    });
                 }
                 catch {
                     ctx.logger.warn("Memory prompt unavailable; check local note files");
@@ -958,14 +1003,26 @@ export function createMemoryPlugin(options, onReady) {
             });
             const inUse = () => { for (const one of services)
                 one.activity(); };
+            const maintainers = new Set();
+            const maintained = () => [...maintainers].some((active) => { try {
+                return active();
+            }
+            catch {
+                return false;
+            } });
+            const notices = [];
             const provider = {
                 recall: (input) => {
                     // A message is being sent in this project: its notes should be current.
                     inUse();
                     return recallFromStores(stores, input, policy.recall, usage);
                 },
+                // What dreaming changed while nobody was looking, told at the next run.
+                notices: async () => notices.splice(0),
                 extraction: {
-                    policy: () => policy.autoExtract,
+                    // A plugin maintaining these notes in the background reads the
+                    // conversation itself; two writers would each act on it.
+                    policy: () => maintained() ? { ...policy.autoExtract, onStop: false, onCompaction: false } : policy.autoExtract,
                     async candidates(text, limit) {
                         const { notes } = await loadScoped(stores);
                         const chosen = new Map(rankNotes(notes, text.slice(-8_000)).slice(0, limit).map((entry) => [entry.note.id, entry.note]));
@@ -1074,11 +1131,130 @@ export function createMemoryPlugin(options, onReady) {
                     await store.apply(edit.id, edit.note, edit.expectedHash, "local");
                 }
             };
+            /**
+             * Commit a dream's changes to one scope as one batch, by the merge path:
+             * with sync on, synced first and committed to the cloud before this
+             * machine, so an edit from another device in between refuses the whole
+             * batch; otherwise local edits, each against the hash it was planned
+             * from and backed up first. Nothing is written if any change is stale.
+             */
+            const commitDream = async (scope, changes) => {
+                if (scope === "user" && !user)
+                    throw new MemoryError("unknownAction");
+                const service = serviceFor(scope);
+                const cloudFirst = await service.syncReady();
+                if (cloudFirst)
+                    await service.sync();
+                const all = await allNotes();
+                const strip = ({ scope: _scope, ...note }) => note;
+                const inScope = new Map(all.filter((note) => note.scope === scope).map((note) => [note.id, note]));
+                const now = Date.now();
+                const edits = [];
+                const touched = new Set();
+                const add = (edit) => {
+                    const key = `${edit.scope}:${edit.id}`;
+                    if (touched.has(key))
+                        throw new MemoryError("invalidBatch");
+                    touched.add(key);
+                    edits.push(edit);
+                };
+                const current = (id, expected) => {
+                    const note = inScope.get(id);
+                    if (noteHash(note ? strip(note) : undefined) !== expected)
+                        throw new MemoryError("mergeStale");
+                    return note ? strip(note) : undefined;
+                };
+                const draftNote = (id, draft, createdAt) => ({
+                    id, summary: draft.summary, body: draft.body, tags: [...draft.tags], createdAt, updatedAt: now,
+                    ...(draft.type ? { type: draft.type } : {}),
+                });
+                const results = [];
+                for (const change of changes) {
+                    if (change.kind === "create") {
+                        const note = draftNote(newNoteId(change.draft.summary), change.draft, now);
+                        add({ scope, id: note.id, note, expectedHash: null });
+                        results.push({ ids: [note.id], before: [{ id: note.id, note: null }], after: [{ id: note.id, hash: noteHash(note) }] });
+                    }
+                    else if (change.kind === "update") {
+                        const old = current(change.id, change.expectedHash);
+                        if (!old)
+                            throw new MemoryError("mergeStale");
+                        const note = draftNote(old.id, { ...change.draft, ...(change.draft.type ?? old.type ? { type: change.draft.type ?? old.type } : {}) }, old.createdAt);
+                        add({ scope, id: old.id, note, expectedHash: change.expectedHash });
+                        results.push({ ids: [old.id], before: [{ id: old.id, note: old }], after: [{ id: old.id, hash: noteHash(note) }] });
+                    }
+                    else if (change.kind === "merge") {
+                        const group = change.ids.map((id, i) => current(id, change.expectedHashes[i] ?? null));
+                        if (group.some((note) => !note))
+                            throw new MemoryError("mergeGone");
+                        const planned = planMerge({ all, scope, ids: change.ids, draft: change.draft, hash: noteHash, now });
+                        for (const edit of planned)
+                            add(edit);
+                        results.push({
+                            ids: [...change.ids],
+                            before: group.map((note) => ({ id: note.id, note: note })),
+                            after: planned.filter((edit) => edit.scope === scope && change.ids.includes(edit.id)).map((edit) => ({ id: edit.id, hash: noteHash(edit.note) })),
+                        });
+                    }
+                    else {
+                        const old = current(change.id, change.expectedHash);
+                        add({ scope, id: change.id, ...(change.note ? { note: change.note } : {}), expectedHash: change.expectedHash });
+                        results.push({ ids: [change.id], before: [{ id: change.id, note: old ?? null }], after: [{ id: change.id, hash: noteHash(change.note ?? undefined) }] });
+                    }
+                }
+                for (const edit of edits) {
+                    if (!edit.note)
+                        continue;
+                    if (findSecrets(`${edit.note.summary}\n${edit.note.body}`).length)
+                        throw new MemoryError("mergedSecret");
+                    validateNote(edit.note, serviceFor(edit.scope).noteBytesLimit());
+                }
+                // How recent each rewritten note was, before the dream touched it.
+                const recencies = new Map(edits.filter((edit) => edit.scope === scope && edit.note && inScope.has(edit.id)).map((edit) => {
+                    const old = strip(inScope.get(edit.id));
+                    return [edit.id, (usage[scope] ?? usage.project).recency(old, noteHash(old))];
+                }));
+                const own = edits.filter((edit) => edit.scope === scope);
+                if (cloudFirst)
+                    await service.commitFirst(own.map(({ id, note, expectedHash }) => ({ id, expectedHash, ...(note ? { note } : {}) })), "dream");
+                for (const edit of cloudFirst ? edits.filter((one) => one.scope !== scope) : edits) {
+                    const store = serviceFor(edit.scope).store;
+                    const live = (await store.load()).find((entry) => entry.id === edit.id);
+                    if (noteHash(live ? memoryNote(live) : undefined) !== edit.expectedHash)
+                        throw new MemoryError("mergeStale");
+                    if (live)
+                        await backupNote(store, memoryNote(live), "dream");
+                    await store.apply(edit.id, edit.note, edit.expectedHash, "local");
+                }
+                // A rewrite keeps the place in the index its use earned (an undo
+                // restores the old content, whose hash no longer matches, so it does too).
+                for (const result of results)
+                    for (const after of result.after) {
+                        const before = recencies.get(after.id);
+                        if (after.hash && before !== undefined && changes.some((change) => change.kind !== "restore"))
+                            (usage[scope] ?? usage.project).markDreamed(after.id, after.hash, before);
+                    }
+                return results;
+            };
+            if (options.bridge) {
+                const bridge = options.bridge;
+                const maintenance = {
+                    claim(_owner, active) {
+                        maintainers.add(active);
+                        return () => { maintainers.delete(active); };
+                    },
+                    commit: commitDream,
+                    announce(notes) { notices.push(...notes); },
+                };
+                bridge.maintenance = maintenance;
+                ctx.onDispose(() => { if (bridge.maintenance === maintenance)
+                    bridge.maintenance = undefined; });
+            }
             const autoOn = () => consolidationEnabled(policy.consolidate.auto, services.map((one) => one.tier));
             /** The background pass: duplicates only, merged by the model, within a cooldown. */
             const autoConsolidate = async () => {
                 const settings = policy.consolidate;
-                if (!autoOn() || !options.generate || settings.maxMerges === 0 || lifetime.signal.aborted)
+                if (!autoOn() || !options.generate || settings.maxMerges === 0 || lifetime.signal.aborted || maintained())
                     return;
                 const state = readReview();
                 if (Date.now() - (state.lastAuto ?? 0) < settings.cooldownHours * 3_600_000)
@@ -1120,7 +1296,9 @@ export function createMemoryPlugin(options, onReady) {
                 const backups = (await listBackups(50).catch(() => [])).filter((backup) => backup.scope === "user" || backup.projectId === options.projectId);
                 const findings = await review().catch(() => []);
                 const reviewState = readReview();
+                const sections = options.bridge ? await options.bridge.sections.read() : {};
                 return {
+                    ...(Object.keys(sections).length ? { sections } : {}),
                     review: findings.slice(0, 100),
                     reviewTotal: findings.length,
                     ...(proposal ? { proposal } : {}),
@@ -1227,6 +1405,9 @@ export function createMemoryPlugin(options, onReady) {
                     else if (input.action === "cancelMerge") {
                         proposal = undefined;
                     }
+                    else if (input.action === "section" && typeof input.section === "string" && options.bridge) {
+                        await options.bridge.sections.act(input.section, object(input.input) ? input.input : {});
+                    }
                     else if (input.action === "merge" && proposal && object(input.note)) {
                         const note = input.note;
                         const draft = {