@agentshouse/mdruntime 0.1.0-ce531b51ff088 → 0.1.0-ce6bc9239a3ee

package/dist/attempt.js

@@ -0,0 +1,70 @@
+import { changeBatchIdentity } from './identity.js';
+export function identities(mint = () => changeBatchIdentity()) {
+    const kept = new Map();
+    let used = new Map();
+    return {
+        of(intent) {
+            const one = used.get(intent) ?? kept.get(intent) ?? mint();
+            used.set(intent, one);
+            return one;
+        },
+        settle(answered) {
+            if (answered !== 'offline') {
+                for (const [intent, one] of used) {
+                    if (answered === 'unanswered')
+                        kept.set(intent, one);
+                    else
+                        kept.delete(intent);
+                }
+            }
+            used = new Map();
+        },
+    };
+}
+const blobs = new WeakMap();
+export function intentOf(name, about) {
+    const carried = [];
+    const json = JSON.stringify(about, (_key, value) => {
+        if (!(value instanceof Blob))
+            return value;
+        let identity = blobs.get(value);
+        if (identity === undefined) {
+            identity = changeBatchIdentity();
+            blobs.set(value, identity);
+        }
+        carried.push(identity);
+        return null;
+    });
+    return `${name}\u0000${json}\u0000${carried.join(',')}`;
+}
+export function attempts(mint) {
+    const numbers = identities(mint);
+    const waiting = new Map();
+    return {
+        begin(act) {
+            const intents = [];
+            return {
+                identity(intent) {
+                    intents.push(intent);
+                    return numbers.of(intent);
+                },
+                settle(answered, drop) {
+                    numbers.settle(answered);
+                    if (answered === 'refused' || answered === 'offline')
+                        drop(act);
+                    if (answered === 'offline')
+                        return;
+                    for (const intent of intents) {
+                        const earlier = waiting.get(intent);
+                        if (earlier !== undefined && earlier !== act)
+                            drop(earlier);
+                        if (answered === 'unanswered')
+                            waiting.set(intent, act);
+                        else
+                            waiting.delete(intent);
+                    }
+                },
+            };
+        },
+    };
+}

package/dist/binary.d.ts

@@ -0,0 +1,18 @@
+import type { HeldBinary } from './overlay.js';
+export type BinaryFileRecord = {
+    readonly state: 'accepted';
+    readonly revision: string;
+    readonly path: string;
+    readonly byteLength: number;
+    readonly mediaType: string;
+    readonly sha256: string;
+} | {
+    readonly state: 'pending';
+    readonly localId: string;
+    readonly path: string;
+    readonly byteLength: number;
+    readonly mediaType: string;
+    readonly sha256: string;
+};
+export declare function binaryRecord(path: string, held: HeldBinary, revision: string | undefined): BinaryFileRecord;
+//# sourceMappingURL=binary.d.ts.map

package/dist/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../src/binary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GACxB;IACE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,gBAAgB,CAKlB"}

package/dist/binary.js

@@ -0,0 +1,8 @@
+export function binaryRecord(path, held, revision) {
+    const facts = { byteLength: held.byteLength, mediaType: held.mediaType, sha256: held.sha256 };
+    if (held.state === 'pending')
+        return { state: 'pending', localId: held.localId, path, ...facts };
+    if (revision === undefined)
+        throw new Error(`the accepted binary file ${path} has no revision`);
+    return { state: 'accepted', revision, path, ...facts };
+}

package/dist/bootstrap.d.ts

@@ -1,10 +1,44 @@
 import type { ModelState } from './model.js';
-import type { Adapter, AdapterFailure, Authorization, DiscoveredRoom } from './adapter.js';
-import { type Staged } from './replica.js';
+import type { Adapter, TypedPath, AdapterFailure, Authorization, BootstrapPart, DiscoveredRoom, NotReady, RetryableRefusal, RoomModels } from './adapter.js';
+import type { Composition } from './collection.js';
+import type { InstallationStep } from './readiness.js';
+import { type Refreshing } from './refresh.js';
+import type { ReplicaRecord } from './replica.js';
+import type { StagedPage, TransferRecord } from './store.js';
 import { type Unconfirmed } from './transfer.js';
-export type BootstrapOutcome = Staged | Unconfirmed | AdapterFailure;
-export declare function bootstrapRoom(adapter: Adapter, authorization: Authorization, room: DiscoveredRoom, models: {
+export type Bootstrapped = {
+    kind: 'staged';
+    record: ReplicaRecord;
+    refreshed: boolean;
+};
+export type BootstrapOutcome = Bootstrapped | Unconfirmed | NotReady | RetryableRefusal | AdapterFailure;
+export type HeldModels = {
     collection: ModelState;
-    selection: ModelState;
-}, continuing: () => boolean): Promise<BootstrapOutcome>;
+};
+export type Remodel = (models: RoomModels | undefined, held: HeldModels) => HeldModels;
+export type Reads = Pick<Adapter, 'bootstrap' | 'refresh' | 'reached'>;
+export type Arriving = {
+    at(bytes: number): void;
+    end(): void;
+};
+export type Resumed = {
+    readonly record: TransferRecord | null;
+    readonly staged: ReadonlySet<string>;
+};
+export type Staging = {
+    held(locator: string): TransferRecord | null;
+    turn(locator: string, step: InstallationStep): Promise<() => void>;
+    unqueued(): Promise<void>;
+    queued(text: number): () => void;
+    arriving(locator: string): Arriving;
+    readonly streamed: boolean;
+    stage(record: TransferRecord, page: StagedPage, composition: Composition): Promise<TransferRecord | null>;
+    resume(record: TransferRecord, parts: readonly BootstrapPart[], composition: Composition): Promise<Resumed | null>;
+    derive(locator: string, key: number, composition: Composition): Promise<boolean>;
+    refreshing(locator: string, key: number, composition: Composition): Promise<Refreshing>;
+    abandon(locator: string): Promise<void>;
+    setAside(locator: string): Promise<void>;
+    release(key: number): Promise<void>;
+};
+export declare function bootstrapRoom(adapter: Reads, authorization: Authorization, room: DiscoveredRoom, held: HeldModels, builtIn: ModelState, typedPaths: readonly TypedPath[], remodel: Remodel, continuing: () => boolean, staging: Staging): Promise<BootstrapOutcome>;
 //# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,aAAa,EACb,cAAc,EAGf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,WAAW,GAAG,cAAc,CAAC;AAErE,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,aAAa,EAC5B,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,UAAU,CAAA;CAAE,EACzD,UAAU,EAAE,MAAM,OAAO,GACxB,OAAO,CAAC,gBAAgB,CAAC,CA+C3B"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"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"}

package/dist/bootstrap.js

@@ -1,56 +1,341 @@
-import { declaredAttachments } from './attachment.js';
-import { readStaged } from './replica.js';
+import { transferIdentity } from './identity.js';
+import { advancement, pageEntries } from './refresh.js';
+import { entriesIn } from './shared.js';
 import { unconfirmed } from './transfer.js';
-export async function bootstrapRoom(adapter, authorization, room, models, continuing) {
-    const first = await adapter.bootstrap(authorization, {
-        locator: room.locator,
-        selection: room.replica.selection,
-    });
-    if (first.kind !== 'bootstrap')
+const NOTHING_PRIOR = () => Promise.resolve(new Map());
+const PARTS_IN_FLIGHT = 6;
+function textOf(page) {
+    let text = 0;
+    for (const [, content] of entriesIn(page.documents))
+        text += content.length;
+    return text;
+}
+async function pageOf(page, part) {
+    return {
+        entries: await pageEntries(page, [], page.roomVersion, NOTHING_PRIOR),
+        folders: page.folders ?? [],
+        ...(part === undefined ? {} : { part }),
+    };
+}
+export async function bootstrapRoom(adapter, authorization, room, held, builtIn, typedPaths, remodel, continuing, staging) {
+    if (staging.held(room.locator) !== null)
+        await staging.abandon(room.locator);
+    const begun = () => started(adapter, authorization, room, held, builtIn, typedPaths, remodel, continuing, staging);
+    const first = await begun();
+    if (first.kind !== 'expired')
         return first;
-    const roomVersion = first.roomVersion;
-    const documents = { ...first.documents };
-    const revisions = { ...first.revisions };
-    const changes = { ...first.changes };
-    const binaryTargets = new Set(first.binaryTargets);
-    const attachments = [first.attachments ?? []];
-    let pageToken = first.pageToken;
-    while (pageToken !== undefined) {
-        if (!continuing())
-            return unconfirmed;
-        const page = await adapter.bootstrap(authorization, {
-            locator: room.locator,
-            selection: room.replica.selection,
-            pageToken,
-        });
-        if (page.kind !== 'bootstrap')
-            return page;
-        if (page.roomVersion !== roomVersion)
-            return unconfirmed;
-        Object.assign(documents, page.documents);
-        Object.assign(revisions, page.revisions);
-        Object.assign(changes, page.changes);
-        for (const target of page.binaryTargets)
-            binaryTargets.add(target);
-        attachments.push(page.attachments ?? []);
-        pageToken = page.pageToken;
-    }
-    return readStaged({
-        locator: room.locator,
-        name: room.name,
-        operations: room.operations,
-        replica: room.replica,
-        attachedModel: room.attachedModel,
+    await staging.setAside(room.locator);
+    try {
+        const replacement = await begun();
+        if (replacement.kind !== 'expired')
+            return replacement;
+        await staging.abandon(room.locator);
+        return unconfirmed;
+    }
+    finally {
+        if (first.key !== null)
+            await staging.release(first.key);
+    }
+}
+function dropped(ahead) {
+    void ahead?.fetched.then(({ next, written }) => {
+        written();
+        dropped(next);
+    }, () => { });
+}
+function compositionFor(room, models, builtIn, typedPaths) {
+    return {
         model: models.collection,
-        typedSelection: room.typedSelection ?? null,
-        selectionModel: models.selection,
-        providerOwnedPaths: room.providerOwnedPaths,
-        roomVersion,
-        documents,
-        binaryTargets: [...binaryTargets].sort(),
-        revisions,
-        changes,
-        written: Object.fromEntries(Object.keys(documents).map((path) => [path, roomVersion])),
-        attachments: declaredAttachments(attachments),
+        selection: room.typedSelection === undefined
+            ? null
+            : { roots: room.typedSelection.roots, model: builtIn },
+        typedPaths,
+    };
+}
+async function started(adapter, authorization, room, held, builtIn, typedPaths, remodel, continuing, staging) {
+    const mode = { paged: false };
+    let outcome;
+    try {
+        outcome = await bundle(adapter, authorization, room, held, builtIn, typedPaths, remodel, continuing, staging, mode);
+    }
+    catch (error) {
+        await stopped(staging, room.locator, mode).catch(() => { });
+        throw error;
+    }
+    if (outcome.kind !== 'staged' && outcome.kind !== 'expired') {
+        await stopped(staging, room.locator, mode);
+    }
+    return outcome;
+}
+function stopped(staging, locator, mode) {
+    return mode.paged ? staging.abandon(locator) : staging.setAside(locator);
+}
+async function bundle(adapter, authorization, room, held, builtIn, typedPaths, remodel, continuing, staging, mode) {
+    const locator = room.locator;
+    const selection = room.replica.selection;
+    const ending = new AbortController();
+    const arriving = staging.arriving(locator);
+    const downloaded = await staging.turn(locator, 'downloading');
+    const asking = (token) => adapter.bootstrap(authorization, {
+        locator,
+        selection,
+        signal: ending.signal,
+        ...(token === null
+            ? { arriving: (bytes) => arriving.at(bytes) }
+            : { pageToken: token }),
     });
+    const fetching = (token) => {
+        const fetched = (async () => {
+            await staging.unqueued();
+            const page = continuing() ? await asking(token) : unconfirmed;
+            if (page.kind !== 'bootstrap')
+                return { page, next: null, written: () => { } };
+            const written = staging.queued(textOf(page));
+            const later = page.pageToken;
+            if (later === undefined && page.parts === undefined) {
+                downloaded();
+                arriving.end();
+            }
+            return { page, written, next: later === undefined || !continuing() ? null : fetching(later) };
+        })();
+        fetched.catch(() => { });
+        return { fetched };
+    };
+    let transfer = null;
+    let ahead = fetching(null);
+    try {
+        while (ahead !== null) {
+            if (!continuing())
+                return unconfirmed;
+            const fetched = await ahead.fetched;
+            ahead = fetched.next;
+            try {
+                if (!continuing())
+                    return unconfirmed;
+                const page = fetched.page;
+                if (page.kind === 'beyond-horizon')
+                    return { kind: 'expired', key: transfer?.key ?? null };
+                if (page.kind !== 'bootstrap')
+                    return page;
+                if (transfer === null && page.parts !== undefined) {
+                    const parted = await parts(page, page.parts);
+                    if (parted.kind !== 'parted')
+                        return parted;
+                    transfer = parted.transfer;
+                    continue;
+                }
+                if (transfer === null)
+                    mode.paged = true;
+                const models = remodel(page.models, transfer?.models ?? held);
+                const staged = await staging.stage({
+                    locator,
+                    transfer: transfer?.transfer ?? transferIdentity(),
+                    selection,
+                    from: transfer !== null && adapter.reached(locator, page.roomVersion, transfer.from)
+                        ? transfer.from
+                        : page.roomVersion,
+                    last: transfer !== null && !adapter.reached(locator, page.roomVersion, transfer.last)
+                        ? transfer.last
+                        : page.roomVersion,
+                    done: { bytes: (transfer?.done.bytes ?? 0) + (page.bytes ?? 0) },
+                    models,
+                    key: transfer?.key ?? null,
+                }, await pageOf(page), compositionFor(room, models, builtIn, typedPaths));
+                if (staged === null)
+                    return unconfirmed;
+                transfer = staged;
+            }
+            finally {
+                fetched.written();
+            }
+        }
+    }
+    finally {
+        ending.abort();
+        downloaded();
+        arriving.end();
+        dropped(ahead);
+    }
+    if (transfer === null)
+        return unconfirmed;
+    return installed(transfer);
+    async function parts(head, listed) {
+        const models = remodel(head.models, held);
+        const composition = compositionFor(room, models, builtIn, typedPaths);
+        const resumed = await staging.resume({
+            locator,
+            transfer: transferIdentity(),
+            selection,
+            from: head.roomVersion,
+            last: head.roomVersion,
+            done: { bytes: 0 },
+            models,
+            key: null,
+        }, listed, composition);
+        if (resumed === null)
+            return unconfirmed;
+        let staged = resumed.record ?? {
+            locator,
+            transfer: transferIdentity(),
+            selection,
+            from: head.roomVersion,
+            last: head.roomVersion,
+            done: { bytes: 0 },
+            models,
+            key: null,
+        };
+        const wanted = listed.filter((part) => !resumed.staged.has(part.id));
+        let arrived = staged.done.bytes;
+        const partial = new Map();
+        const report = () => {
+            let bytes = arrived;
+            for (const held of partial.values())
+                bytes += held;
+            arriving.at(bytes);
+        };
+        report();
+        const arrivals = [];
+        let woken = null;
+        let next = 0;
+        let flying = 0;
+        let halted = false;
+        let stopped = false;
+        let admitted = Promise.resolve();
+        const fetched = () => {
+            if ((next < wanted.length && !halted) || flying > 0)
+                return;
+            downloaded();
+            arriving.end();
+        };
+        const landed = (one) => {
+            flying -= 1;
+            if (stopped)
+                one.written();
+            else
+                arrivals.push(one);
+            woken?.();
+            ask();
+            fetched();
+        };
+        const fetch = async (part) => {
+            let written = () => { };
+            const admission = admitted.then(async () => {
+                await staging.unqueued();
+                written = staging.queued(part.bytes);
+            });
+            admitted = admission;
+            await admission;
+            const page = continuing()
+                ? await adapter.bootstrap(authorization, {
+                    locator,
+                    selection,
+                    signal: ending.signal,
+                    pageToken: part.id,
+                    arriving: (bytes) => {
+                        partial.set(part.id, Math.min(bytes, part.bytes));
+                        report();
+                    },
+                })
+                : unconfirmed;
+            landed({ part, page, written });
+        };
+        const ask = () => {
+            while (!stopped && !halted && flying < PARTS_IN_FLIGHT && next < wanted.length) {
+                const part = wanted[next];
+                next += 1;
+                flying += 1;
+                fetch(part).catch((error) => landed({ part, page: unconfirmed, written: () => { }, error }));
+            }
+        };
+        let failed = null;
+        ask();
+        fetched();
+        try {
+            for (;;) {
+                while (arrivals.length === 0) {
+                    if (flying === 0 && (halted || next >= wanted.length))
+                        break;
+                    await new Promise((wake) => (woken = wake));
+                    woken = null;
+                }
+                const one = arrivals.shift();
+                if (one === undefined)
+                    break;
+                const { part, page, written, error } = one;
+                try {
+                    if (error !== undefined)
+                        throw error;
+                    if (!continuing())
+                        return unconfirmed;
+                    if (page.kind !== 'bootstrap') {
+                        halted = true;
+                        failed ??= page.kind === 'beyond-horizon' ? unconfirmed : page;
+                        continue;
+                    }
+                    partial.delete(part.id);
+                    arrived += part.bytes;
+                    report();
+                    const kept = await staging.stage({ ...staged, done: { bytes: staged.done.bytes + part.bytes } }, await pageOf({ ...page, roomVersion: head.roomVersion }, part.id), composition);
+                    if (kept === null)
+                        return unconfirmed;
+                    staged = kept;
+                }
+                finally {
+                    written();
+                }
+            }
+        }
+        finally {
+            stopped = true;
+            for (const one of arrivals.splice(0))
+                one.written();
+        }
+        if (failed !== null)
+            return failed;
+        if (staged.key === null) {
+            const empty = await staging.stage(staged, { entries: [], folders: [] }, composition);
+            if (empty === null)
+                return unconfirmed;
+            staged = empty;
+        }
+        return { kind: 'parted', transfer: staged };
+    }
+    async function installed(transfer) {
+        const composition = compositionFor(room, transfer.models, builtIn, typedPaths);
+        if (!(await staging.derive(locator, transfer.key, composition)))
+            return unconfirmed;
+        await staging.turn(locator, 'replaying');
+        if (!continuing())
+            return unconfirmed;
+        const record = {
+            locator,
+            name: room.name,
+            handle: room.handle,
+            operations: room.operations,
+            replica: room.replica,
+            model: transfer.models.collection,
+            typedSelection: room.typedSelection ?? null,
+            providerOwnedPaths: room.providerOwnedPaths,
+            roomVersion: transfer.from,
+            transfer: transfer.transfer,
+            inventory: transfer.done,
+            key: transfer.key,
+        };
+        const last = transfer.last;
+        const refresh = adapter.refresh;
+        const reconciled = last === transfer.from &&
+            (staging.streamed || adapter.reached(locator, last, room.roomVersion))
+            ? { kind: 'still-current' }
+            : refresh === undefined
+                ? unconfirmed
+                : await advancement(refresh, authorization, record, remodel, continuing, await staging.refreshing(locator, record.key, composition));
+        if (reconciled.kind === 'advanced') {
+            return { kind: 'staged', record: reconciled.record, refreshed: true };
+        }
+        if (reconciled.kind === 'still-current')
+            return { kind: 'staged', record, refreshed: false };
+        if (reconciled.kind === 'beyond-horizon')
+            return { kind: 'expired', key: record.key };
+        return reconciled;
+    }
 }

package/dist/chain.d.ts

@@ -0,0 +1,12 @@
+import type { DocumentQuery, GroupQuery } from '@agentshouse/mdmodel';
+import type { MdRuntimeClient } from './client.js';
+import type { DocumentResult, GroupResult, PendingResult } from './query.js';
+type Rows = DocumentResult | GroupResult;
+export type WindowAnswer = Rows | PendingResult;
+export type WindowChain = {
+    want(count: number): void;
+    close(): void;
+};
+export declare function chainedWindows(runtime: MdRuntimeClient, query: DocumentQuery | GroupQuery, count: number, publish: (answers: readonly (WindowAnswer | null)[], settled: boolean) => void): WindowChain;
+export {};
+//# sourceMappingURL=chain.d.ts.map

package/dist/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7E,KAAK,IAAI,GAAG,cAAc,GAAG,WAAW,CAAC;AAEzC,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,aAAa,CAAC;AAEhD,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAaF,wBAAgB,cAAc,CAC5B,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,aAAa,GAAG,UAAU,EACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,GAC7E,WAAW,CAkEb"}

package/dist/chain.js

@@ -0,0 +1,64 @@
+function answered(answer) {
+    return answer !== null && !('pending' in answer);
+}
+export function chainedWindows(runtime, query, count, publish) {
+    let links = [];
+    let wanted = count;
+    let closed = false;
+    const observe = runtime.observe;
+    const open = (after, shown) => {
+        const link = { after, observation: null, value: shown, fresh: false };
+        void observe('query', after === undefined ? query : { ...query, after }).then((observation) => {
+            if (closed || !links.includes(link)) {
+                observation.close();
+                return;
+            }
+            link.observation = observation;
+            const take = (value) => {
+                link.value = value;
+                link.fresh = true;
+                settle();
+            };
+            observation.subscribe(take);
+            take(observation.current());
+        }, () => { });
+        return link;
+    };
+    const settle = () => {
+        if (closed)
+            return;
+        const next = [];
+        for (let at = 0; at < wanted; at += 1) {
+            const before = next[at - 1];
+            if (before !== undefined && !before.fresh) {
+                next.push(...links.slice(at, wanted));
+                break;
+            }
+            if (before !== undefined && (!answered(before.value) || before.value.next === undefined)) {
+                break;
+            }
+            const after = before === undefined ? undefined : before.value.next;
+            const held = links[at];
+            next.push(held !== undefined && held.after === after ? held : open(after, held?.value ?? null));
+        }
+        for (const link of links)
+            if (!next.includes(link))
+                link.observation?.close();
+        links = next;
+        publish(links.map((link) => link.value), links.every((link) => link.fresh));
+    };
+    settle();
+    return {
+        want(count) {
+            if (count === wanted)
+                return;
+            wanted = count;
+            settle();
+        },
+        close() {
+            closed = true;
+            for (const link of links)
+                link.observation?.close();
+        },
+    };
+}