@agentshouse/mdruntime 0.1.0-cd50a4607cb7d → 0.1.0-cdb8840578a20

package/dist/connection.js

@@ -21,6 +21,8 @@ import { applyReturned, compositionOf, confirmedOf, landed, readReclassified, re
 import { binaryBase, changedParts, changesOf, held, heldFile, joinedDraft, readParts, returnedBy, returnedInto, staleWrite, underneath, withdrawnDrafts, } from './room-draft.js';
 import { same, saving, STARTING, transferring, } from './status.js';
 import { detectStorageLoss, nextGeneration } from './durability.js';
+import { demanded, narrower, WHOLE_DEMAND, wider } from './acquisition.js';
+import { readinessOf, SETTLED_ROOMS, } from './readiness.js';
 import { FencedMap } from './fence.js';
 import { tally } from './shared.js';
 import { inChunks, ROW_WEIGHT, yielded } from './turn.js';
@@ -166,8 +168,18 @@ export function composeRuntime(options) {
     const memberListeners = new Set();
     const prepared = new Set();
     const projecting = new Set();
-    const demanded = new Set();
+    const unpreparedDemand = new Set();
+    const unindexable = new Set();
     let preparing = false;
+    let demand = WHOLE_DEMAND;
+    let narrowing = null;
+    let targets = {};
+    let persistence = options.shell.persistence;
+    let capacity = null;
+    const paused = new Set();
+    let rechecking = null;
+    const readinessWatches = new Set();
+    let readinessQueued = false;
     const catching = new Set();
     const transfers = new FencedMap(isFenced);
     const conversations = createConversationStore({
@@ -325,15 +337,18 @@ export function composeRuntime(options) {
     }
     function emitRooms() {
         readSide.recover();
+        queueReadiness();
         const value = listed();
         for (const listener of roomListeners)
             listener(value);
     }
     function emitRefusal() {
+        queueReadiness();
         for (const listener of refusalListeners)
             listener(refusal);
     }
     function emitStorageLoss() {
+        queueReadiness();
         for (const listener of storageLossListeners)
             listener(storageLoss);
     }
@@ -350,7 +365,8 @@ export function composeRuntime(options) {
     function show() {
         if (closed)
             return;
-        const next = status.state === 'synced' && !conversations.current()
+        queueReadiness();
+        const next = status.state === 'synced' && demand.conversations && !conversations.current()
             ? { ...status, state: 'syncing' }
             : status;
         if (same(shown, next))
@@ -427,13 +443,19 @@ export function composeRuntime(options) {
         }
         conversations.changed(mergeChangeSets(entered));
         readSide.recover();
+        queueReadiness();
     }
     function unprepared() {
-        return [...demanded, ...replicas.keys()].find((locator) => !prepared.has(locator));
+        return [...unpreparedDemand, ...replicas.keys()].find((locator) => !prepared.has(locator) && !unindexable.has(locator));
+    }
+    function unbuilt(locator, error) {
+        unindexable.add(locator);
+        journal.record(`index failed ${locator} ${error instanceof Error ? error.name : 'unknown'}`);
+        queueReadiness();
     }
     function prepare(locators = []) {
         for (const locator of locators)
-            demanded.add(locator);
+            unpreparedDemand.add(locator);
         if (preparing)
             return;
         preparing = true;
@@ -443,8 +465,8 @@ export function composeRuntime(options) {
                     await yielded();
                     if (closed)
                         return;
-                    demanded.delete(waiting);
-                    await prepareReplica(waiting);
+                    unpreparedDemand.delete(waiting);
+                    await prepareReplica(waiting).catch((error) => unbuilt(waiting, error));
                 }
             }
             finally {
@@ -502,6 +524,292 @@ export function composeRuntime(options) {
         if (waiting.length > 0)
             prepare(waiting.map(({ room }) => room));
     }
+    function acquires(room) {
+        return (demanded(demand, room) ||
+            (replicas.get(room.locator)?.queue.length ?? 0) > 0 ||
+            queuesWithoutReplica.has(room.locator));
+    }
+    function acquiredLocators() {
+        return [...discovered.values()]
+            .filter(acquires)
+            .map((room) => room.locator)
+            .sort();
+    }
+    function heldDemand(acquired) {
+        if (demand.whole)
+            return null;
+        return { rooms: acquired.map((room) => room.locator), conversations: demand.conversations };
+    }
+    function applyDemand(next) {
+        const before = acquiredLocators();
+        const conversed = demand.conversations;
+        demand = next;
+        const after = acquiredLocators();
+        queueReadiness();
+        if (!conversed && next.conversations)
+            scheduleCurrency();
+        if (JSON.stringify(before) === JSON.stringify(after) && conversed === next.conversations)
+            return;
+        journal.record(`acquisition ${next.whole ? 'whole' : after.length}`);
+        if (options.adapter.roomStream === undefined)
+            void sync('unstreamed');
+        else if (socketOpen)
+            options.adapter.roomStream.reopen();
+    }
+    function acquire(next) {
+        if (closed)
+            return;
+        if (narrowing !== null)
+            clearTimeout(narrowing);
+        narrowing = null;
+        const widening = wider(next, demand);
+        if (!widening && !narrower(next, demand))
+            return;
+        if (widening || !roomsListed) {
+            applyDemand(next);
+            return;
+        }
+        // A narrower demand waits five seconds, so a tab that reloads returns before the stream reopens twice.
+        narrowing = setTimeout(() => {
+            narrowing = null;
+            applyDemand(next);
+        }, 5_000);
+    }
+    function requiredRooms(reach) {
+        if (reach === null)
+            return { listed: roomsListed, rooms: [...rooms.keys()].sort() };
+        const named = [...new Set(reach.rooms)].sort();
+        if (roomsListed)
+            return { listed: true, rooms: named.filter((room) => rooms.has(room)) };
+        return { listed: named.every((room) => replicas.has(room)), rooms: named };
+    }
+    function roomState(locator, search) {
+        if (sourceRefusals.has(locator))
+            return 'refused';
+        const listedRoom = discovered.get(locator);
+        if (roomsListed &&
+            (listedRoom === undefined ||
+                listedRoom.replica.admission !== 'admitted' ||
+                unreadable.has(locator)))
+            return 'unadmitted';
+        if (!replicas.has(locator))
+            return 'acquiring';
+        if (!prepared.has(locator))
+            return 'preparing';
+        if (search && !searchIndex.rooms().has(locator))
+            return 'indexing';
+        return 'complete';
+    }
+    function conversationCoverage(reach, search) {
+        const declared = reach === null || reach.conversations;
+        if (!declared || options.adapter.conversations === undefined || declaredAgents() === undefined)
+            return 'undeclared';
+        if (!conversations.known() || !conversations.current())
+            return 'acquiring';
+        if (!search)
+            return 'complete';
+        const unindexed = conversations
+            .searchable()
+            .filter((one) => conversations.acquired(one) && !searchIndex.conversations().has(one));
+        if (unindexed.length === 0)
+            return 'complete';
+        index([], unindexed);
+        return 'indexing';
+    }
+    function connectionOf() {
+        if (socketOpen)
+            return 'connected';
+        if (status.providerUnreachable)
+            return 'unreachable';
+        return options.adapter.roomStream === undefined && status.lastCompleted !== null
+            ? 'connected'
+            : 'connecting';
+    }
+    function refusedIn(locators) {
+        return locators.flatMap((room) => {
+            const held = sourceRefusals.get(room);
+            if (held === undefined)
+                return [];
+            const { file, location } = held.fields;
+            return [
+                {
+                    room,
+                    file: typeof file === 'string' ? file : '',
+                    rule: held.code,
+                    location: typeof location === 'string' ? location : null,
+                },
+            ];
+        });
+    }
+    function readinessFor(port, reach) {
+        const required = requiredRooms(reach);
+        const target = targets[port.target];
+        const search = target?.search === true;
+        const coverage = required.rooms.map((room) => ({ room, state: roomState(room, search) }));
+        const building = (state) => coverage
+            .filter((room) => room.state === state && !unindexable.has(room.room))
+            .map(({ room }) => room);
+        const preparing = building('preparing');
+        if (preparing.length > 0)
+            prepare(preparing);
+        const indexing = building('indexing');
+        if (indexing.length > 0)
+            index(indexing, []);
+        return readinessOf({
+            code: port.code,
+            coverage: {
+                listed: required.listed,
+                rooms: coverage,
+                conversations: conversationCoverage(reach, search),
+                search: search ? 'required' : 'unused',
+            },
+            persistence,
+            connection: connectionOf(),
+            house: refusal !== null ? 'refused' : writesHeld() ? 'write-halted' : 'open',
+            capacity: capacity !== null &&
+                coverage.some(({ room, state }) => paused.has(room) || !SETTLED_ROOMS.has(state))
+                ? capacity
+                : port.capacity,
+            refused: refusedIn(required.rooms),
+            lost: storageLoss !== null,
+            established: target?.established === true,
+        });
+    }
+    function keepTarget(name, change) {
+        const held = targets[name] ?? { established: false, search: false };
+        const next = { ...held, ...change };
+        if (next.established === held.established && next.search === held.search)
+            return;
+        targets = { ...targets, [name]: next };
+        queueReadiness();
+        void durably((local) => local.keepTargets(targets)).catch(() => {
+            journal.record(`target record failed ${name}`);
+        });
+    }
+    function deliverReadiness(watch) {
+        if (!readinessWatches.has(watch))
+            return;
+        const readiness = readinessFor(watch.port, watch.reach);
+        if (readiness.ready && targets[watch.port.target]?.established !== true) {
+            keepTarget(watch.port.target, { established: true });
+        }
+        const shown = JSON.stringify(readiness);
+        if (shown === watch.last)
+            return;
+        watch.last = shown;
+        watch.deliver(structuredClone(readiness));
+    }
+    function queueReadiness() {
+        if (readinessQueued || closed || readinessWatches.size === 0)
+            return;
+        readinessQueued = true;
+        queueMicrotask(() => {
+            readinessQueued = false;
+            if (closed)
+                return;
+            for (const watch of [...readinessWatches])
+                deliverReadiness(watch);
+        });
+    }
+    function watchReadiness(port, reach, deliver) {
+        const watch = { port, reach, deliver, last: null };
+        readinessWatches.add(watch);
+        void openLocal().then(() => deliverReadiness(watch), () => deliverReadiness(watch));
+        return () => {
+            readinessWatches.delete(watch);
+        };
+    }
+    function searching(target) {
+        if (targets[target]?.search !== true)
+            keepTarget(target, { search: true });
+    }
+    function layerBytes(layer) {
+        let bytes = 0;
+        for (const [path, text] of Object.entries(layer.documents))
+            bytes += (path.length + text.length) * 2;
+        return bytes;
+    }
+    function grownBy(next, previous) {
+        if (previous === undefined)
+            return layerBytes(next);
+        const documents = Object.fromEntries(Object.entries(next.documents).filter(([path, text]) => previous.documents[path] !== text));
+        return layerBytes({ ...next, documents });
+    }
+    function exceeded(error) {
+        return (typeof error === 'object' &&
+            error !== null &&
+            error.name === 'QuotaExceededError');
+    }
+    async function estimated() {
+        const estimate = options.shell.estimate === undefined ? null : await options.shell.estimate();
+        return estimate === null ? null : Math.max(0, estimate.quota - estimate.usage);
+    }
+    function pause(locator, cause) {
+        paused.add(locator);
+        capacity = cause;
+        journal.record(`capacity ${cause.cause} ${locator} ${cause.needed} ${cause.available ?? '-'}`);
+        queueReadiness();
+        if (rechecking !== null)
+            return;
+        // A paused preparation measures the browser's space again each minute, so space freed elsewhere resumes it without a retry.
+        rechecking = setInterval(() => {
+            void recheck();
+        }, 60_000);
+    }
+    async function recheck() {
+        const held = capacity;
+        if (held === null || closed)
+            return;
+        const available = await estimated().catch(() => null);
+        if (available === null || available < (held.needed ?? 0))
+            return;
+        if (held.cause === 'quota-exceeded' && (held.available === null || available <= held.available))
+            return;
+        resume();
+    }
+    function resume() {
+        if (rechecking !== null)
+            clearInterval(rechecking);
+        rechecking = null;
+        if (paused.size === 0 && capacity === null)
+            return;
+        paused.clear();
+        capacity = null;
+        journal.record('capacity resumed');
+        queueReadiness();
+        if (!closed && authorization !== undefined)
+            void sync('unstreamed');
+    }
+    async function reclaimed(local) {
+        const unreferenced = [...transfers.keys()].filter((locator) => {
+            const room = discovered.get(locator);
+            return room === undefined || !acquires(room);
+        });
+        for (const locator of unreferenced) {
+            await local.abandon(locator);
+            transfers.delete(locator);
+        }
+        if (unreferenced.length > 0)
+            journal.record(`capacity reclaimed ${unreferenced.length}`);
+        return unreferenced.length > 0;
+    }
+    async function admitted(local, locator, needed) {
+        if (paused.has(locator))
+            return false;
+        let available = await estimated().catch(() => null);
+        if (available === null || available >= needed)
+            return true;
+        if (await reclaimed(local))
+            available = await estimated().catch(() => null);
+        if (available === null || available >= needed)
+            return true;
+        pause(locator, { cause: 'insufficient-space', needed, available });
+        return false;
+    }
+    async function exceededOn(locator, bytes) {
+        const available = await estimated().catch(() => null);
+        pause(locator, { cause: 'quota-exceeded', needed: bytes, available });
+    }
     async function rowsQuery(plan) {
         const before = covered(plan);
         awaitPreparation(before);
@@ -529,10 +837,12 @@ export function composeRuntime(options) {
         }
     }
     function indexNext() {
-        const room = [...roomsToIndex].find((locator) => !searchIndex.rooms().has(locator));
+        const room = [...roomsToIndex].find((locator) => !searchIndex.rooms().has(locator) && !unindexable.has(locator));
         if (room !== undefined) {
             roomsToIndex.delete(room);
-            return () => (prepared.has(room) ? searchIndex.indexRoom(room) : undefined);
+            return () => prepared.has(room)
+                ? searchIndex.indexRoom(room).catch((error) => unbuilt(room, error))
+                : undefined;
         }
         const conversation = [...conversationsToIndex].find((one) => !searchIndex.conversations().has(one));
         if (conversation === undefined)
@@ -553,6 +863,7 @@ export function composeRuntime(options) {
                 for (let unit = indexNext(); unit !== null && !closed; unit = indexNext()) {
                     await yielded();
                     await unit();
+                    queueReadiness();
                 }
             }
             finally {
@@ -726,6 +1037,8 @@ export function composeRuntime(options) {
             unreadable.delete(locator);
             stale.delete(locator);
             repairable.delete(locator);
+            unindexable.delete(locator);
+            paused.delete(locator);
             scopedRefusals.delete(locator);
             sourceRefusals.delete(locator);
             declarationRefusals.delete(locator);
@@ -779,7 +1092,7 @@ export function composeRuntime(options) {
         return model;
     }
     async function hydrate(opened) {
-        const [records, queues, kept, presented, held, chatDrafts, lastCompleted, declared, named, known, staged,] = await Promise.all([
+        const [records, queues, kept, presented, held, chatDrafts, lastCompleted, declared, named, known, staged, heldTargets,] = await Promise.all([
             opened.all(),
             opened.queues(),
             opened.roomDrafts(),
@@ -791,7 +1104,9 @@ export function composeRuntime(options) {
             opened.capabilities(),
             opened.member(),
             opened.transfers(),
+            opened.targets(),
         ]);
+        targets = heldTargets;
         transfers.clear();
         for (const record of staged)
             transfers.set(record.locator, record);
@@ -1037,7 +1352,18 @@ export function composeRuntime(options) {
                 const accepted = pendings.get(batch.id)?.accepted;
                 return (accepted !== undefined && options.adapter.reached(room.locator, roomVersion, accepted));
             });
-            const set = (await settle(local, room.locator, prior, confirmed, queue.filter((batch) => !accepted.includes(batch)), { room: true, ...(stored === undefined ? {} : { stored }) }))();
+            let settled;
+            try {
+                settled = await settle(local, room.locator, prior, confirmed, queue.filter((batch) => !accepted.includes(batch)), { room: true, ...(stored === undefined ? {} : { stored }) });
+            }
+            catch (error) {
+                if (!exceeded(error))
+                    throw error;
+                await exceededOn(room.locator, grownBy(confirmed.record, prior?.confirmed.record));
+                caughtUpTo(room.locator);
+                return true;
+            }
+            const set = settled();
             if (stored !== undefined) {
                 transfers.delete(room.locator);
                 catching.delete(room.locator);
@@ -1045,6 +1371,7 @@ export function composeRuntime(options) {
             for (const batch of accepted)
                 pendings.delete(batch.id);
             stale.delete(room.locator);
+            unindexable.delete(room.locator);
             if (unreadable.delete(room.locator))
                 scopedRefusals.delete(room.locator);
             sourceRefusals.delete(room.locator);
@@ -1453,7 +1780,18 @@ export function composeRuntime(options) {
             stage: (record, page) => exclusive(async () => {
                 if (!live())
                     return false;
-                await local.stage(record, page);
+                const bytes = layerBytes(page);
+                if (!(await admitted(local, record.locator, bytes)))
+                    return false;
+                try {
+                    await local.stage(record, page);
+                }
+                catch (error) {
+                    if (!exceeded(error))
+                        throw error;
+                    await exceededOn(record.locator, bytes);
+                    return false;
+                }
                 transfers.set(record.locator, record);
                 readSide.recover();
                 return true;
@@ -1503,7 +1841,7 @@ export function composeRuntime(options) {
     }
     async function advance(room, local, authorized, live) {
         await referenced(room.locator);
-        if (!live())
+        if (!live() || paused.has(room.locator))
             return unconfirmed;
         const held = replicas.get(room.locator);
         if (held !== undefined) {
@@ -1984,15 +2322,16 @@ export function composeRuntime(options) {
         });
     }
     async function synchronize(listed, local, progress, attempt, live) {
-        const prepared = await Promise.allSettled(listed.map((room) => prepareRoom(room, local, progress)));
+        const acquired = listed.filter(acquires);
+        const prepared = await Promise.allSettled(acquired.map((room) => prepareRoom(room, local, progress)));
         if (!live())
             return;
-        const ready = listed.filter((_, index) => {
+        const ready = acquired.filter((_, index) => {
             const outcome = prepared[index];
             return outcome?.status === 'fulfilled' && outcome.value;
         });
         if (attempt === 'opened') {
-            options.adapter.roomStream?.hold(heldRooms(ready));
+            options.adapter.roomStream?.hold(heldRooms(ready), heldDemand(acquired));
             handed = true;
         }
         discovering?.release();
@@ -2457,7 +2796,8 @@ export function composeRuntime(options) {
             if (status.providerUnreachable)
                 conversations.reconnected();
             const reading = { complete: true, reachable: true };
-            await conversations.catchUp(reading);
+            if (demand.conversations)
+                await conversations.catchUp(reading);
             if (progress.reachable && reading.reachable)
                 await conversations.resend(reading);
             if (!reading.reachable) {
@@ -2520,7 +2860,7 @@ export function composeRuntime(options) {
                 return;
             const room = discovered.get(locator);
             const held = replicas.get(locator);
-            if (room === undefined || room.replica.admission !== 'admitted')
+            if (room === undefined || room.replica.admission !== 'admitted' || !acquires(room))
                 return;
             if (held !== undefined &&
                 (held.confirmed.record.replica.selection !== room.replica.selection ||
@@ -2597,6 +2937,7 @@ export function composeRuntime(options) {
             haltedRefusal = false;
         if (mode !== serviceMode) {
             serviceMode = mode;
+            queueReadiness();
             journal.record(`service mode ${mode}`);
             for (const listener of serviceModeListeners)
                 listener(mode);
@@ -2609,6 +2950,8 @@ export function composeRuntime(options) {
         if (stream === undefined || withdrawConversations !== undefined)
             return;
         withdrawConversations = stream.observe((event) => {
+            if (event.kind === 'list' || event.kind === 'listed' || event.kind === 'unlisted')
+                queueReadiness();
             if (conversations.receive(event)) {
                 void ready.then(scheduleCurrency);
                 return;
@@ -2631,7 +2974,7 @@ export function composeRuntime(options) {
         if (!live())
             return;
         await conversations.reconcile();
-        if (conversations.current()) {
+        if (conversations.current() || !demand.conversations) {
             show();
             return;
         }
@@ -2649,6 +2992,11 @@ export function composeRuntime(options) {
         if (closed)
             return;
         closed = true;
+        if (narrowing !== null)
+            clearTimeout(narrowing);
+        if (rechecking !== null)
+            clearInterval(rechecking);
+        readinessWatches.clear();
         withdrawStream?.();
         withdrawStream = undefined;
         withdrawConversations?.();
@@ -2709,40 +3057,55 @@ export function composeRuntime(options) {
             const cover = covered(filter);
             awaitPreparation(cover);
             const pending = 'pending' in cover ? [...cover.pending] : [];
-            const covering = 'pending' in cover ? [] : cover.coverage.rooms;
+            const awaited = new Set('pending' in cover ? cover.pending.map(({ room }) => room) : []);
+            const held = covered({
+                ...filter,
+                rooms: reachedRooms(filter).filter((room) => !awaited.has(room)),
+            });
+            const covering = 'pending' in held ? [] : held.coverage.rooms;
             const unindexed = covering
                 .filter(({ room }) => !searchIndex.rooms().has(room))
                 .map(({ room }) => room);
             for (const room of unindexed)
                 pending.push({ room, awaits: 'index' });
-            const held = conversations.searchable();
+            const listed = conversations.searchable();
             const named = reach !== null && !reach.conversations
                 ? []
-                : (plan.conversations ?? held).filter((one) => held.includes(one) && conversations.acquired(one));
+                : (plan.conversations ?? listed).filter((one) => listed.includes(one) && conversations.acquired(one));
             const waiting = named.filter((one) => !searchIndex.conversations().has(one));
             for (const conversation of waiting)
                 pending.push({ conversation, awaits: 'index' });
             if (unindexed.length > 0 || waiting.length > 0)
                 index(unindexed, waiting);
-            if (pending.length > 0 || 'pending' in cover)
-                return { pending };
+            const complete = pending.length === 0 && !('pending' in cover);
+            const answering = complete
+                ? filter
+                : {
+                    ...filter,
+                    rooms: covering
+                        .filter(({ room }) => searchIndex.rooms().has(room))
+                        .map(({ room }) => room),
+                };
+            const answered = covered(answering);
+            if ('pending' in answered)
+                continue;
+            const searchedConversations = named.filter((one) => searchIndex.conversations().has(one));
             const seen = searchIndex.changes();
             await searchIndex.caughtUp();
-            const selected = plan.documents === undefined && reach === null ? null : await rowsQuery(filter);
+            const selected = plan.documents === undefined && reach === null ? null : await rowsQuery(answering);
             if (selected !== null && 'pending' in selected)
-                return selected;
+                continue;
             if (searchIndex.changes() !== seen ||
-                JSON.stringify(covered(filter)) !== JSON.stringify(cover))
+                JSON.stringify(covered(answering)) !== JSON.stringify(answered))
                 continue;
-            return {
-                ...searchIndex.search(plan, selected === null ? null : selected.documents, named),
-                coverage: {
-                    rooms: covering,
-                    conversations: named,
-                    index: searchIndex.generation(),
-                    overlay: cover.coverage.overlay,
-                },
+            const hits = searchIndex.search(plan, selected === null ? null : selected.documents, searchedConversations, complete ? null : new Set(answering.rooms));
+            const coverage = {
+                rooms: answered.coverage.rooms,
+                conversations: searchedConversations,
+                index: searchIndex.generation(),
+                overlay: answered.coverage.overlay,
             };
+            return complete ? { ...hits, coverage } : { pending, ...hits, coverage };
         }
     }
     const watch = (topic, input, deliver) => {
@@ -2789,6 +3152,9 @@ export function composeRuntime(options) {
                 presentationListeners.delete(listener);
             };
         }
+        if (topic === 'readiness') {
+            return watchReadiness({ target: '', code: 'stored', capacity: null }, null, deliver);
+        }
         if (topic === 'rooms') {
             roomListeners.add(deliver);
             deliver(listed());
@@ -2955,7 +3321,13 @@ export function composeRuntime(options) {
             return journal.export();
         },
         persistence() {
-            return options.shell.persistentStorage;
+            return persistence === 'granted';
+        },
+        async retry() {
+            journal.record('retry');
+            unindexable.clear();
+            queueReadiness();
+            resume();
         },
         observe: observing(watch),
         async reauthorize() {
@@ -2982,6 +3354,22 @@ export function composeRuntime(options) {
         query: (plan) => rowsQuery(plan),
         watchPlan,
         search: searched,
+        searching,
+        watchReadiness,
+    };
+    return {
+        md,
+        stop,
+        lose: loseRooms,
+        watch,
+        acquire,
+        persisted(answer) {
+            if (answer === persistence)
+                return;
+            persistence = answer;
+            journal.record(`persistence ${answer}`);
+            queueReadiness();
+        },
+        within: (reach, port) => narrowed(reachable, reach, port),
     };
-    return { md, stop, lose: loseRooms, watch, within: (reach) => narrowed(reachable, reach) };
 }