@agentshouse/mdruntime 0.1.0-ce41fec66d91b → 0.1.0-ce5b3c1e6ea87

package/dist/preparation.d.ts

@@ -0,0 +1,20 @@
+import type { PlanReach } from './query.js';
+import { type PortReach } from './reach.js';
+import { type CodeAvailability, type ConnectionAvailability, type Readiness } from './readiness.js';
+import type { Runtime } from './runtime.js';
+export type ReadinessPort = {
+    readonly target: string;
+    readonly code: CodeAvailability;
+};
+export type ReadinessWatch = {
+    readonly port: ReadinessPort;
+    readonly reach: PortReach | null;
+    readonly deliver: (readiness: Readiness) => void;
+};
+export declare function prepare(runtime: Runtime, locators?: readonly string[]): void;
+export declare function roomsOfReach(reach: PlanReach): ReadonlySet<string>;
+export declare function connectionNow(runtime: Runtime): Promise<ConnectionAvailability>;
+export declare function deliverOwedReadiness(runtime: Runtime, owed: readonly ReadinessWatch[]): Promise<void>;
+export declare function watchReadiness({ store }: Runtime, port: ReadinessPort, reach: PortReach | null, deliver: (readiness: Readiness) => void): () => void;
+export declare function filled(runtime: Runtime): void;
+//# sourceMappingURL=preparation.d.ts.map

package/dist/preparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preparation.d.ts","sourceRoot":"","sources":["../src/preparation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAE3B,KAAK,SAAS,EAEf,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAK5C,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;CAClD,CAAC;AAuCF,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,GAAE,SAAS,MAAM,EAAO,QA8BzE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAElE;AAmDD,wBAAsB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAMrF;AAkFD,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,cAAc,EAAE,iBAI3F;AAED,wBAAgB,cAAc,CAC5B,EAAE,KAAK,EAAE,EAAE,OAAO,EAClB,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,SAAS,GAAG,IAAI,EACvB,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,GACtC,MAAM,IAAI,CAQZ;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,QAMtC"}

package/dist/preparation.js

@@ -0,0 +1,226 @@
+import { changeSet } from './change-set.js';
+import { installationOf } from './install.js';
+import { listedLocators } from './listing.js';
+import { planReach } from './reach.js';
+import { readinessOf, } from './readiness.js';
+import { roomOfKey } from './rows.js';
+import { recoverReads } from './shown.js';
+import { yielded } from './turn.js';
+async function prepareReplica(runtime, locator) {
+    const { store, socket } = runtime;
+    for (;;) {
+        const held = (await store.rooms([locator])).get(locator);
+        if (held === undefined || socket.closed() || held.indexed)
+            return;
+        const key = held.record.key;
+        const done = await store.exclusive(async () => {
+            const local = await store.open();
+            return store.rederive(local, key, store.composed(held.record));
+        });
+        if (!done.done)
+            continue;
+        if ((await store.rooms([locator])).get(locator)?.record.key !== key)
+            continue;
+        store.changed(changeSet(locator, { documents: null }));
+        recoverReads(runtime);
+        store.readiness.queue();
+        return;
+    }
+}
+async function unprepared({ store, socket }) {
+    const held = (await store.covering()).rooms;
+    return [...store.device.now().unpreparedDemand, ...held.keys()].find((locator) => !(held.get(locator)?.indexed ?? false) && !socket.rooms.standing(locator).unpreparable);
+}
+function unpreparedBy({ store, socket, journal }, locator, error) {
+    socket.rooms.stand(locator, { unpreparable: true });
+    journal.record(`preparation failed ${locator} ${error instanceof Error ? error.name : 'unknown'}`);
+    store.readiness.queue();
+}
+export function prepare(runtime, locators = []) {
+    const { store, socket, journal } = runtime;
+    const { device } = store;
+    if (locators.length > 0) {
+        device.set({ unpreparedDemand: new Set([...device.now().unpreparedDemand, ...locators]) });
+    }
+    if (device.now().preparing)
+        return;
+    device.set({ preparing: true });
+    void (async () => {
+        try {
+            for (let waiting = await unprepared(runtime); waiting !== undefined; waiting = await unprepared(runtime)) {
+                await yielded();
+                if (socket.closed())
+                    return;
+                const demand = new Set(device.now().unpreparedDemand);
+                demand.delete(waiting);
+                device.set({ unpreparedDemand: demand });
+                await prepareReplica(runtime, waiting).catch((error) => unpreparedBy(runtime, waiting, error));
+            }
+        }
+        catch {
+            journal.record('preparation failed');
+        }
+        finally {
+            device.set({ preparing: false });
+        }
+    })();
+}
+export function roomsOfReach(reach) {
+    return new Set([...reach.rooms, ...reach.documents.map(roomOfKey)]);
+}
+function requiredRooms(runtime, given, held) {
+    const { roomsListed } = runtime.socket.session.now();
+    const reach = planReach(given);
+    const listed = new Set(listedLocators(runtime, held));
+    if (reach === null)
+        return { listed: roomsListed, rooms: [...listed].sort() };
+    const named = [...roomsOfReach(reach)].sort();
+    if (roomsListed)
+        return { listed: true, rooms: named.filter((room) => listed.has(room)) };
+    return { listed: named.every((room) => held.has(room)), rooms: named };
+}
+function roomState({ socket }, locator, held) {
+    const listedRoom = socket.rooms.discovered(locator);
+    if (socket.session.now().roomsListed &&
+        (listedRoom === undefined ||
+            listedRoom.replica.admission !== 'admitted' ||
+            socket.rooms.standing(locator).unreadable))
+        return 'unadmitted';
+    const stored = held.get(locator);
+    if (stored === undefined)
+        return 'acquiring';
+    if (!stored.indexed)
+        return 'preparing';
+    return 'complete';
+}
+function conversationCoverage({ socket, conversations }, reach) {
+    const declaredConversations = reach === null || reach.conversations;
+    if (!declaredConversations || socket.conversations() === undefined)
+        return 'undeclared';
+    if (!conversations.known() || !conversations.current())
+        return 'acquiring';
+    return 'complete';
+}
+function connectionOf({ socket }, lastCompleted) {
+    if (socket.isOpen())
+        return 'connected';
+    if (socket.session.now().moving.providerUnreachable)
+        return 'unreachable';
+    return !socket.streamed && lastCompleted !== null ? 'connected' : 'connecting';
+}
+export async function connectionNow(runtime) {
+    const { store, socket } = runtime;
+    if (socket.isOpen() || socket.session.now().moving.providerUnreachable || socket.streamed) {
+        return connectionOf(runtime, null);
+    }
+    return connectionOf(runtime, (await (await store.open()).facts()).lastCompleted);
+}
+async function readinessHeld({ store }) {
+    const local = await store.open();
+    const [held, facts] = await Promise.all([store.covering(), local.facts()]);
+    return { held: held.rooms, facts };
+}
+function readinessFor(runtime, port, reach, { held, facts }) {
+    const { store, socket, usableWhenHeld } = runtime;
+    const required = requiredRooms(runtime, reach, held);
+    const coverage = required.rooms.map((room) => ({ room, state: roomState(runtime, room, held) }));
+    const preparing = coverage
+        .filter((room) => room.state === 'preparing' && !socket.rooms.standing(room.room).unpreparable)
+        .map(({ room }) => room);
+    if (preparing.length > 0)
+        prepare(runtime, preparing);
+    const { persistence, storageLoss, heldWhenOpened } = store.device.now();
+    return readinessOf({
+        code: port.code,
+        coverage: {
+            listed: required.listed,
+            rooms: coverage,
+            conversations: conversationCoverage(runtime, reach),
+        },
+        persistence,
+        connection: connectionOf(runtime, facts.lastCompleted),
+        house: socket.session.now().refusal !== null
+            ? 'refused'
+            : socket.writesHeld()
+                ? 'write-halted'
+                : 'open',
+        space: store.space.full() ? 'full' : null,
+        installation: installationOf(store, coverage, held),
+        lost: storageLoss !== null,
+        established: facts.targets[port.target]?.established === true ||
+            (heldWhenOpened && usableWhenHeld.includes(port.target)),
+    });
+}
+function establish(runtime, name) {
+    const { store, journal } = runtime;
+    const { device } = store;
+    if (device.now().establishing.has(name))
+        return;
+    device.set({ establishing: new Set([...device.now().establishing, name]) });
+    void store
+        .durably(async (local) => {
+        const { targets } = await local.facts();
+        await local.fact('targets', { ...targets, [name]: { established: true } });
+    })
+        .then(() => {
+        store.readiness.queue();
+        void probeEachMinute(runtime);
+    }, () => {
+        journal.record(`target record failed ${name}`);
+    })
+        .finally(() => {
+        const establishing = new Set(device.now().establishing);
+        establishing.delete(name);
+        device.set({ establishing });
+    });
+}
+function deliverReadiness(runtime, watch, held) {
+    if (!runtime.store.readiness.held(watch))
+        return;
+    const readiness = readinessFor(runtime, watch.port, watch.reach, held);
+    if (readiness.ready && held.facts.targets[watch.port.target]?.established !== true) {
+        establish(runtime, watch.port.target);
+    }
+    if (!runtime.store.readiness.changed(watch, JSON.stringify(readiness)))
+        return;
+    watch.deliver(structuredClone(readiness));
+}
+export async function deliverOwedReadiness(runtime, owed) {
+    const held = await readinessHeld(runtime);
+    if (runtime.socket.closed())
+        return;
+    for (const watch of owed)
+        deliverReadiness(runtime, watch, held);
+}
+export function watchReadiness({ store }, port, reach, deliver) {
+    const watch = { port, reach, deliver };
+    const stop = store.readiness.add(watch);
+    void store.open().then(() => store.readiness.owe([watch]), () => store.readiness.owe([watch]));
+    return stop;
+}
+export function filled(runtime) {
+    const { store, socket, journal } = runtime;
+    if (socket.closed() || !store.space.fill())
+        return;
+    journal.record('space full');
+    store.readiness.queue();
+    void probeEachMinute(runtime);
+}
+async function installedTarget({ store, usableWhenHeld }) {
+    if (store.device.now().heldWhenOpened && usableWhenHeld.length > 0)
+        return true;
+    const { targets } = await (await store.open()).facts();
+    return Object.values(targets).some((target) => target.established);
+}
+async function probeEachMinute(runtime) {
+    const { store, socket } = runtime;
+    const { space } = store;
+    const idle = () => !space.full() || space.probing() || socket.closed();
+    if (idle())
+        return;
+    if (!(await installedTarget(runtime).catch(() => false)))
+        return;
+    if (idle())
+        return;
+    space.probeEachMinute();
+}

package/dist/queries.d.ts

@@ -0,0 +1,16 @@
+import { type FiguresCover } from './figures.js';
+import type { Cover, Ran } from './live.js';
+import { type Plan, type QueryResult } from './query.js';
+import { type Deliver, type Fail, type PortReach } from './reach.js';
+import type { Runtime } from './runtime.js';
+import { type SearchResult } from './search.js';
+import type { QueryRoom } from './store.js';
+export declare function figuresCover(runtime: Runtime): Promise<FiguresCover>;
+export declare function answeredPlan(runtime: Runtime, plan: Plan, cover: () => Promise<Cover>): Promise<Ran>;
+export declare function rowsQuery(runtime: Runtime, plan: Plan): Promise<QueryResult>;
+export declare function planned(runtime: Runtime, input: unknown, reach: PortReach | null): Promise<Plan>;
+export declare function roomTallies(runtime: Runtime, rooms: readonly QueryRoom[], since: string): Promise<readonly import("./tallies.js").RoomTally[]>;
+export declare function watchPlan(runtime: Runtime, plan: Plan, deliver: Deliver, fail: Fail): () => void;
+export declare function watchPlanned(runtime: Runtime, planning: Promise<Plan>, deliver: Deliver, fail: Fail): () => void;
+export declare function searched(runtime: Runtime, input: unknown, reach: PortReach | null): Promise<SearchResult>;
+//# sourceMappingURL=queries.d.ts.map

package/dist/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAK5C,OAAO,EAIL,KAAK,IAAI,EACT,KAAK,WAAW,EAEjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAa,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAGhF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,KAAK,EAAa,SAAS,EAAgB,MAAM,YAAY,CAAC;AAuFrE,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAa1E;AA2ED,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,GAC1B,OAAO,CAAC,GAAG,CAAC,CAQd;AAQD,wBAAsB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAWlF;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,SAAS,GAAG,IAAI,GACtB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,wDAO7F;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,IAAI,CAchG;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,EACvB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,IAAI,GACT,MAAM,IAAI,CAeZ;AAED,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,SAAS,GAAG,IAAI,GACtB,OAAO,CAAC,YAAY,CAAC,CAqDvB"}

package/dist/queries.js

@@ -0,0 +1,272 @@
+import { identityOf } from '@agentshouse/mdmodel';
+import { ROOM_TOTALS } from './figures.js';
+import { roomInFlight } from './install.js';
+import { roomFacts } from './listing.js';
+import { lockedRooms } from './locks.js';
+import { OFFLINE, UNCERTAIN, failure } from './outcome.js';
+import { connectionNow, prepare, roomsOfReach } from './preparation.js';
+import { planWithin, } from './query.js';
+import { planReach } from './reach.js';
+import { refuse } from './refusal.js';
+import { documentKey } from './rows.js';
+import { searchPlanOf } from './search.js';
+import { seedApplies, seededResult, watchSeeded } from './seed.js';
+import { capped, MAXIMUM_WINDOW } from './windows.js';
+const QUERY_BYTES = 1 << 20;
+function everyRoom({ socket }, held) {
+    return [
+        ...new Set([
+            ...socket.rooms.declarations().keys(),
+            ...held.rooms.keys(),
+            ...held.queues.keys(),
+        ]),
+    ];
+}
+function reachedRooms(runtime, plan, held) {
+    const reached = plan.reach === null ? null : roomsOfReach(plan.reach);
+    const named = plan.rooms ?? (reached === null ? everyRoom(runtime, held) : [...reached]);
+    return [...new Set(named)]
+        .filter((locator) => (reached === null || reached.has(locator)) && !plan.locked.includes(locator))
+        .sort();
+}
+function awaited({ socket }, locator) {
+    return (!socket.session.now().roomsListed ||
+        (socket.rooms.declared(locator) !== undefined &&
+            socket.rooms.discovered(locator)?.replica.admission === 'admitted'));
+}
+function coveredRooms(runtime, locators, whole, held) {
+    const { store, socket } = runtime;
+    if (locators.length === 0 && whole && !socket.session.now().roomsListed)
+        return { pending: [] };
+    const pending = [];
+    const coverage = [];
+    const overlay = [];
+    const read = [];
+    for (const locator of locators) {
+        const replica = held.rooms.get(locator);
+        if (replica === undefined) {
+            if (awaited(runtime, locator))
+                pending.push({ room: locator, awaits: 'acquisition' });
+            continue;
+        }
+        if (!replica.indexed) {
+            pending.push({ room: locator, awaits: 'preparation' });
+            continue;
+        }
+        coverage.push({
+            room: locator,
+            generation: replica.transfer,
+            current: !roomInFlight(store, locator),
+        });
+        read.push({ locator, key: replica.key });
+        for (const id of held.queues.get(locator) ?? [])
+            overlay.push(id);
+    }
+    if (pending.length > 0)
+        return { pending };
+    return { coverage: { rooms: coverage, indexes: [], overlay }, rooms: read };
+}
+function covered(runtime, plan, held) {
+    return coveredRooms(runtime, reachedRooms(runtime, plan, held), plan.rooms === null && plan.reach === null, held);
+}
+function awaitPreparation(runtime, cover) {
+    if (!('pending' in cover))
+        return;
+    const waiting = cover.pending.filter(({ awaits }) => awaits === 'preparation');
+    if (waiting.length > 0) {
+        prepare(runtime, waiting.map(({ room }) => room));
+    }
+}
+export async function figuresCover(runtime) {
+    const held = await runtime.store.covering();
+    const locked = await lockedRooms(runtime);
+    const cover = coveredRooms(runtime, everyRoom(runtime, held)
+        .filter((locator) => !locked.includes(locator))
+        .sort(), true, held);
+    awaitPreparation(runtime, cover);
+    return 'pending' in cover ? cover : { rooms: cover.rooms };
+}
+function sameCover(left, right) {
+    return JSON.stringify(left) === JSON.stringify(right);
+}
+async function windowRows(local, plan, rooms, unchanged) {
+    const first = await local.query(plan, rooms, QUERY_BYTES);
+    if (first.more === undefined || !('documents' in first)) {
+        const { more: _more, ...rows } = first;
+        return rows;
+    }
+    const documents = [...first.documents];
+    for (let more = first.more; more !== undefined;) {
+        if (!unchanged())
+            return null;
+        const page = await local.query({
+            ...plan,
+            after: { text: more, values: JSON.parse(more) },
+            limit: plan.limit === null ? null : plan.limit - documents.length,
+            total: false,
+        }, rooms, QUERY_BYTES);
+        if (!('documents' in page))
+            return null;
+        documents.push(...page.documents);
+        more = page.more;
+        if (more === undefined) {
+            return {
+                documents,
+                ...(page.next === undefined ? {} : { next: page.next }),
+                ...(first.total === undefined ? {} : { total: first.total }),
+            };
+        }
+    }
+    return null;
+}
+async function coveredRows({ store }, plan, cover) {
+    for (;;) {
+        const before = await cover();
+        if ('pending' in before)
+            return { pending: before };
+        const local = await store.open();
+        const keys = before.rooms.map(({ key }) => key);
+        const changes = local.changes(keys);
+        const current = () => local.changes(keys) === changes;
+        const rows = await windowRows(local, plan, before.rooms, current);
+        const after = await cover();
+        if (rows !== null && sameCover(before, after))
+            return { rows, cover: before, current };
+    }
+}
+function keyedOf(rows, coverage) {
+    if ('groups' in rows) {
+        return {
+            result: { ...rows, coverage },
+            keys: rows.groups.map((group) => JSON.stringify(group.key)),
+        };
+    }
+    return {
+        result: { ...rows, coverage },
+        keys: rows.documents.map((document) => documentKey(document.room, document.path)),
+    };
+}
+export async function answeredPlan(runtime, plan, cover) {
+    const answered = await coveredRows(runtime, plan, cover);
+    if ('pending' in answered) {
+        const pending = answered.pending;
+        return { result: pending, keys: [], current: () => true };
+    }
+    const held = answered.cover;
+    return { ...keyedOf(answered.rows, held.coverage), current: answered.current };
+}
+async function coverNow(runtime, plan) {
+    const cover = covered(runtime, plan, await runtime.store.covering());
+    awaitPreparation(runtime, cover);
+    return cover;
+}
+export async function rowsQuery(runtime, plan) {
+    const held = await runtime.store.covering();
+    const before = covered(runtime, plan, held);
+    awaitPreparation(runtime, before);
+    const seeded = seedApplies(runtime, plan, held);
+    if (seeded !== null)
+        return seededResult(seeded).result;
+    if ('pending' in before)
+        return before;
+    const answered = await coveredRows(runtime, plan, () => coverNow(runtime, plan));
+    if ('pending' in answered)
+        return answered.pending;
+    const shownCover = answered.cover;
+    return { ...answered.rows, coverage: shownCover.coverage };
+}
+export async function planned(runtime, input, reach) {
+    const plan = planWithin(input, await roomFacts(runtime, reach), planReach(reach));
+    const named = plan.paths !== null &&
+        plan.rooms !== null &&
+        plan.paths.length * plan.rooms.length <= MAXIMUM_WINDOW;
+    return plan.limit === null && named ? plan : { ...plan, limit: capped(plan.limit) };
+}
+export async function roomTallies(runtime, rooms, since) {
+    return runtime.store.ask({
+        kind: 'replica.tallies',
+        totals: { ...(await planned(runtime, ROOM_TOTALS, null)), limit: null },
+        rooms,
+        since,
+    });
+}
+export function watchPlan(runtime, plan, deliver, fail) {
+    return watchSeeded(runtime, plan, deliver, (behind, answered) => runtime.liveQueries.watch(plan, identityOf(plan), (held) => {
+        const cover = covered(runtime, plan, held);
+        awaitPreparation(runtime, cover);
+        return behind(cover, held);
+    }, answered, fail));
+}
+export function watchPlanned(runtime, planning, deliver, fail) {
+    let stop = null;
+    let stopped = false;
+    planning.then((plan) => {
+        if (!stopped)
+            stop = watchPlan(runtime, plan, deliver, fail);
+    }, (error) => {
+        if (!stopped)
+            fail(error);
+    });
+    return () => {
+        stopped = true;
+        stop?.();
+    };
+}
+export async function searched(runtime, input, reach) {
+    const { store, socket, journal } = runtime;
+    const { session } = socket;
+    const asked = searchPlanOf(input);
+    await socket.ready;
+    const search = socket.search();
+    if (search === undefined) {
+        return {
+            kind: 'undeclared',
+            code: 'action-undeclared',
+            fields: { name: 'search' },
+            retryable: false,
+        };
+    }
+    if (socket.closed() ||
+        session.now().refusal !== null ||
+        (await connectionNow(runtime)) !== 'connected')
+        return OFFLINE;
+    const reached = reach === null ? null : new Set(reach.rooms);
+    const named = asked.rooms === null
+        ? reached === null
+            ? null
+            : [...reached]
+        : asked.rooms.filter((room) => reached === null || reached.has(room));
+    const held = named === null ? null : await store.rooms(named);
+    const rooms = named === null ? null : named.filter((room) => held.has(room)).sort();
+    if (rooms !== null && rooms.length === 0)
+        return { kind: 'found', documents: [] };
+    try {
+        await socket.authorize();
+    }
+    catch {
+        return UNCERTAIN;
+    }
+    const { closed, authorization, refusal } = session.now();
+    if (closed || authorization === undefined || refusal !== null)
+        return UNCERTAIN;
+    journal.record('transfer search');
+    try {
+        const result = await search(authorization, { text: asked.text, rooms });
+        if (result.kind === 'revoked-authorization')
+            await refuse(runtime, 'revoked-authorization');
+        journal.record(`outcome search ${result.kind}`);
+        if (result.kind === 'rejected')
+            return result;
+        if (result.kind !== 'found')
+            return failure(result);
+        const kept = rooms === null ? null : new Set(rooms);
+        return {
+            kind: 'found',
+            documents: result.documents.filter((hit) => kept === null || kept.has(hit.room)),
+        };
+    }
+    catch {
+        journal.record('outcome search transport-uncertainty');
+        return UNCERTAIN;
+    }
+}