@agentshouse/mdruntime 0.1.0-cb1f56e16291b → 0.1.0-cb3bb3b233fa1

package/dist/saves.d.ts

@@ -0,0 +1,34 @@
+import { type ChangeBatch, type WrittenBy } from './change.js';
+import type { ConversationFiles } from './conversation.js';
+import { type AttachAnswer, type BinaryLinkAnswer, type HeldBinaryAnswer, type HeldShownAnswer } from './outcome.js';
+import { type RoomDraftParts } from './room-draft.js';
+import type { Runtime } from './runtime.js';
+import { type SaveRefusal } from './save.js';
+import type { Store } from './store.js';
+export type SaveResult = {
+    outcome: 'saved';
+    identifier: string;
+} | ({
+    outcome: 'refused';
+} & SaveRefusal);
+export type SavedRoomDraft = {
+    readonly path: string;
+    readonly revision: string;
+};
+export type SavedParts = {
+    readonly path: string;
+    readonly parts: RoomDraftParts;
+};
+export type BinaryFileSurface = {
+    read(room: string, path: string, revision?: string): Promise<HeldBinaryAnswer>;
+    link(room: string, path: string, revision?: string): Promise<BinaryLinkAnswer>;
+    show(room: string, path: string, revision?: string): Promise<HeldShownAnswer>;
+    attach(room: string, file: File): Promise<AttachAnswer>;
+    part(file: string, part: number): Promise<Uint8Array | null>;
+};
+export declare function saveRoomDrafts(runtime: Runtime, locator: string, named: readonly SavedRoomDraft[], writtenBy: WrittenBy | undefined): Promise<SaveResult>;
+export declare function saveParts(runtime: Runtime, locator: string, named: readonly SavedParts[], writtenBy: WrittenBy | undefined): Promise<SaveResult>;
+export declare function batchFile(store: Store, batch: ChangeBatch): (localId: string) => Promise<Blob>;
+export declare function conversationFiles(runtime: Runtime): ConversationFiles;
+export declare function binaryFileSurface(runtime: Runtime): BinaryFileSurface;
+//# sourceMappingURL=saves.d.ts.map

package/dist/saves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saves.d.ts","sourceRoot":"","sources":["../src/saves.ts"],"names":[],"mappings":"AAUA,OAAO,EAA2B,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAKxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,OAAO,EASL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAGrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AAatB,OAAO,EAQL,KAAK,cAAc,EAGpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAGL,KAAK,WAAW,EAGjB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAsB,KAAK,EAAoB,MAAM,YAAY,CAAC;AAK9E,MAAM,MAAM,UAAU,GAClB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxC,CAAC;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,GAAG,WAAW,CAAC,CAAC;AAE3C,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAElF,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAEnF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/E,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/E,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACxD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC9D,CAAC;AAYF,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,SAAS,EAAE,SAAS,GAAG,SAAS,GAC/B,OAAO,CAAC,UAAU,CAAC,CAsCrB;AAuBD,wBAAgB,SAAS,CACvB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,SAAS,EAAE,SAAS,GAAG,SAAS,GAC/B,OAAO,CAAC,UAAU,CAAC,CAyBrB;AAgOD,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAK9F;AA+PD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAKrE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAQrE"}

package/dist/saves.js

@@ -0,0 +1,437 @@
+import { isImageType, parse } from '@agentshouse/mdmodel';
+import { binaryRecord } from './binary.js';
+import { changeSet } from './change-set.js';
+import { queuedFile } from './change.js';
+import { available, textType } from './collection.js';
+import { runtimeError } from './failure.js';
+import { attachedFile } from './file.js';
+import { roomDraftRevision } from './identity.js';
+import { compositionFor } from './listing.js';
+import { scoped } from './models.js';
+import { absentBinary, attachAnswer, binaryAnswer, binaryLinkAnswer, failure, linkedAnswer, OFFLINE, UNCERTAIN, } from './outcome.js';
+import { sameBinary } from './overlay.js';
+import { ancestors } from './paths.js';
+import { connectionNow } from './preparation.js';
+import { append, sliceAt, withdrawable } from './queue.js';
+import { entryAt, replaying, slicing, } from './replica.js';
+import { binaryBase, changesOf, held, heldFile, joinedOver, moveTarget, readSavedParts, } from './room-draft.js';
+import { refuse } from './refusal.js';
+import { visibleOf } from './room-drafts.js';
+import { destination, planSave, } from './save.js';
+import { pendingShown } from './shown.js';
+import { paced, ROW_WEIGHT, stepped } from './turn.js';
+import { validatedNeighbourhood } from './validation.js';
+const FULL = { outcome: 'refused', code: 'durable-write', retryable: true };
+async function savedRoom({ store, presence }, locator) {
+    const replica = await store.replica(locator);
+    if (replica === undefined || presence.lost(locator)) {
+        throw runtimeError('unknown-room', `Unknown Room ${locator}`);
+    }
+    return replica;
+}
+export function saveRoomDrafts(runtime, locator, named, writtenBy) {
+    const { store } = runtime;
+    return store.exclusive(async () => {
+        if (store.space.full())
+            return FULL;
+        const replica = await savedRoom(runtime, locator);
+        const drafts = new Map((await store.drafts(locator, named.map(({ path }) => path))).map((record) => [record.path, record]));
+        const saved = [];
+        for (const { path, revision } of named) {
+            const record = drafts.get(path);
+            if (record === undefined || record.revision !== revision) {
+                return { outcome: 'refused', code: 'stale', retryable: false, file: path };
+            }
+            if (!saved.some((draft) => draft.path === path))
+                saved.push({ path, parts: record.parts });
+        }
+        const result = await loaded(runtime, locator, replica, saved, new Set(saved.map(({ path }) => path)), [], writtenBy);
+        if (result.outcome !== 'refused' || result.code !== 'changed-underneath')
+            return result;
+        return joinedUnderneath(runtime, locator, saved.map(({ path }) => drafts.get(path)), result);
+    });
+}
+async function joinedUnderneath({ store }, locator, records, refused) {
+    const visible = (await visibleOf(store, locator, records.map(({ path }) => path)));
+    const joined = records.flatMap((record) => {
+        const join = joinedOver(record.parts, record.marks, record.path, visible);
+        return join === null ? [] : [{ ...record, ...join, revision: roomDraftRevision() }];
+    });
+    if (joined.length === 0)
+        return refused;
+    await (await store.open()).commit({ rooms: [], writes: [{ locator, roomDrafts: joined }] });
+    await store.changed(changeSet(locator, { drafts: joined.map(({ path }) => path) }));
+    return refused;
+}
+export function saveParts(runtime, locator, named, writtenBy) {
+    const { store } = runtime;
+    return store.exclusive(async () => {
+        const read = readSavedParts(named);
+        if (store.space.full())
+            return FULL;
+        const replica = await savedRoom(runtime, locator);
+        const saved = [];
+        const files = [];
+        const filed = read.filter(({ parts }) => parts.file !== undefined).map(({ path }) => path);
+        const visible = filed.length === 0 ? undefined : await visibleOf(store, locator, filed);
+        for (const { path, parts } of read) {
+            const file = parts.file === undefined
+                ? undefined
+                : await heldFile(parts.file.blob, parts.file.base === undefined ? binaryBase(visible, path) : parts.file.base);
+            if (parts.file !== undefined && file !== undefined) {
+                files.push({ key: file.localId, blob: parts.file.blob });
+            }
+            saved.push({ path, parts: held(undefined, parts, file) });
+        }
+        return loaded(runtime, locator, replica, saved, new Set(), files, writtenBy);
+    });
+}
+async function unmodeledIn(runtime, record) {
+    const composition = compositionFor(runtime, record);
+    if (available(composition))
+        return false;
+    const local = await runtime.store.open();
+    const roots = record.declaration.typedSelection?.roots ?? [];
+    return local.typedWithin(record.key, 'visible', roots, false);
+}
+async function savingRoom(runtime, replica, changes, extra, drafted) {
+    const { store } = runtime;
+    const { record, queue, states } = replica;
+    const local = await store.open();
+    const paths = [
+        ...extra,
+        ...changes.flatMap((change) => change.kind === 'move' ? [change.path, change.to] : [change.path]),
+    ];
+    const moved = changes.flatMap((change) => (change.kind === 'move' ? [change.path] : []));
+    const removed = changes.flatMap((change) => (change.kind === 'remove' ? [change.path] : []));
+    const referring = removed.length === 0
+        ? []
+        : (await local.referrers(record.key, 'confirmed', removed)).map(({ path }) => path);
+    const confirmed = await sliceAt(store, record, 'confirmed', queue, [...paths, ...paths.flatMap(ancestors), ...referring], moved);
+    const composition = store.composed(record);
+    const changeable = withdrawable(states);
+    return {
+        held: { replica, confirmed },
+        room: {
+            record,
+            rule: runtime.writeRule(record.declaration),
+            composition: compositionFor(runtime, record),
+            queue,
+            changeable: new Set(queue.filter(changeable).map(({ id }) => id)),
+            saved: new Map([...states].map(([id, state]) => [id, state.drafts])),
+            *replay(over) {
+                return (yield* replaying(confirmed, over, record.locator, composition)).visible;
+            },
+            folders: new Set(await local.folders(record.key, paths)),
+            modelled: !(await unmodeledIn(runtime, record)),
+            drafts: new Map(drafted.length === 0
+                ? []
+                : (await store.drafts(record.locator, drafted)).map((held) => [held.path, held])),
+            validate: validatorOf(runtime, record, confirmed),
+        },
+    };
+}
+function targetsOf(saved) {
+    return saved.flatMap(({ parts }) => (parts.move === undefined ? [] : [moveTarget(parts.move)]));
+}
+async function loaded(runtime, locator, replica, saved, consumed, files, writtenBy) {
+    const { store, localSaves } = runtime;
+    const into = destination(locator, saved);
+    const target = into === null ? undefined : await savedRoom(runtime, into);
+    const paths = saved.map(({ path }) => path);
+    const targets = targetsOf(saved);
+    const parts = saved.map(({ path, parts: held }) => changesOf(path, held));
+    const source = target === undefined
+        ? await savingRoom(runtime, replica, parts.flatMap(({ changes }) => changes), [...paths, ...parts.flatMap(({ bases }) => bases.map(({ path }) => path))], targets.length === 0 ? [] : [...paths, ...targets])
+        : await savingRoom(runtime, replica, paths.map((path) => ({ kind: 'remove', path })), paths, paths);
+    const arriving = target === undefined ? undefined : await savingRoom(runtime, target, [], targets, targets);
+    const { providerLimits } = await (await store.open()).facts();
+    const plan = await planSave({ saved, consumed, writtenBy, local: localSaves, providerLimits }, source.room, arriving?.room);
+    return append(runtime, {
+        plan,
+        files,
+        held: new Map([source, ...(arriving === undefined ? [] : [arriving])].map(({ room, held }) => [
+            room.record.locator,
+            held,
+        ])),
+        after: () => pendingShown(runtime),
+    });
+}
+function textDiffers(left, right) {
+    return ((left?.content ?? undefined) !== (right?.content ?? undefined) ||
+        !sameBinary(left?.binary ?? undefined, right?.binary ?? undefined));
+}
+function textOf(entry) {
+    if (entry === null)
+        return undefined;
+    return entry.binary !== null ? null : entry.content;
+}
+function lookupOf(local, key, view) {
+    return async (paths) => {
+        if (paths.length === 0)
+            return new Map();
+        return new Map((await local.typed(key, view, paths)).map(({ path, type, binary }) => [
+            path,
+            { type: type ?? undefined, binary },
+        ]));
+    };
+}
+function declaredOf(entry) {
+    if (entry.binary !== null)
+        return { type: undefined, binary: true };
+    return { type: textType(parse(entry.content ?? '')), binary: false };
+}
+function overriddenLookup(lookup, overrides) {
+    return async (paths) => {
+        const known = new Map(await lookup(paths.filter((path) => !overrides.has(path))));
+        for (const path of paths) {
+            const entry = overrides.get(path);
+            if (entry === undefined)
+                continue;
+            if (entry === null)
+                known.delete(path);
+            else
+                known.set(path, declaredOf(entry));
+        }
+        return known;
+    };
+}
+function validatorOf(runtime, record, confirmedLayer) {
+    return async (resulting, touched) => {
+        const local = await runtime.store.open();
+        const changes = [];
+        const overrides = new Map();
+        const pace = paced();
+        for (const path of new Set([...confirmedLayer.held, ...touched])) {
+            await pace(ROW_WEIGHT);
+            const was = entryAt(confirmedLayer, path);
+            const now = entryAt(resulting, path);
+            if (!textDiffers(was, now))
+                continue;
+            overrides.set(path, now);
+            if (textOf(was) !== textOf(now))
+                changes.push({ path, was: textOf(was), now: textOf(now) });
+        }
+        return validatedNeighbourhood(changes, compositionFor(runtime, record), {
+            lookup: overriddenLookup(lookupOf(local, record.key, 'confirmed'), overrides),
+            texts: textsOf(local, record.key, 'confirmed'),
+            referrers: referrersOf(local, record.key, 'confirmed'),
+        });
+    };
+}
+function textsOf(local, key, view) {
+    return async (paths) => new Map((await local.entries(key, view, paths)).map(({ path, content, binary }) => [
+        path,
+        binary !== null ? null : content,
+    ]));
+}
+function referrersOf(local, key, view) {
+    return async (targets) => [
+        ...new Set((await local.referrers(key, view, targets)).map(({ path }) => path)),
+    ];
+}
+async function queuedFacts(store, locator, path, localId) {
+    for (const batch of (await store.replica(locator))?.queue ?? []) {
+        const change = batch.changes[queuedFile(batch, path, localId)];
+        if (change?.kind === 'binary')
+            return change;
+    }
+    const drafted = (await store.draft(locator, path))?.parts.file;
+    return drafted?.localId === localId ? drafted : null;
+}
+export function batchFile(store, batch) {
+    return async (localId) => {
+        const change = batch.changes.find((held) => held.kind === 'binary' && held.localId === localId);
+        return (await store.open()).file(localId, change?.kind === 'binary' ? change.mediaType : '');
+    };
+}
+async function transferBinary(runtime, request, transfer, answer) {
+    const { store, socket, presence } = runtime;
+    const { session } = socket;
+    if (socket.closed() || session.now().refusal !== null)
+        return UNCERTAIN;
+    await socket.firstDiscovery;
+    if (!session.now().roomsNamed)
+        return UNCERTAIN;
+    try {
+        await socket.authorize();
+    }
+    catch {
+        return UNCERTAIN;
+    }
+    const { closed, authorization, refusal } = session.now();
+    if (closed || authorization === undefined || refusal !== null)
+        return UNCERTAIN;
+    const since = presence.losses();
+    try {
+        const result = await transfer(authorization);
+        const settled = result;
+        if (request.locator !== null && presence.lostSince(request.locator, since))
+            return failure({ kind: 'room-not-readable', locator: request.locator });
+        if (settled.kind === 'scoped-refusal') {
+            const room = await store.record(settled.locator);
+            if (room !== undefined)
+                await scoped(runtime, settled, room.locator, room.declaration);
+        }
+        if (settled.kind === 'revoked-authorization')
+            await refuse(runtime, 'revoked-authorization');
+        return answer(result);
+    }
+    catch {
+        return UNCERTAIN;
+    }
+}
+function fetchBinary(runtime, request, name) {
+    const { store, socket } = runtime;
+    return transferBinary(runtime, request, (authorization) => store.opened.fetch(name, () => socket.binary(authorization, request)), binaryAnswer);
+}
+async function readBinary(runtime, request, name) {
+    if (runtime.socket.closed())
+        return UNCERTAIN;
+    const held = await runtime.store.opened.find(name);
+    if (held !== null)
+        return held;
+    return fetchBinary(runtime, request, name);
+}
+async function binaryPath(store, locator, path, revision) {
+    if (revision !== undefined)
+        return { kind: 'path', locator, path, revision };
+    const replica = await store.replica(locator);
+    const local = await store.open();
+    const [held] = replica === undefined ? [] : await local.entries(replica.record.key, 'visible', [path]);
+    const attached = held === undefined ? store.attached.of(locator, path) : undefined;
+    if (attached !== undefined)
+        return { kind: 'path', locator, path, revision: attached.revision };
+    if (replica === undefined || held?.binary === undefined || held.binary === null)
+        return null;
+    if (held.binary.state === 'pending')
+        return { kind: 'pending', localId: held.binary.localId };
+    const record = binaryRecord(path, held.binary, held.revision ?? undefined);
+    if (record.state !== 'accepted')
+        return null;
+    const queued = replica.queue.flatMap((batch) => batch.changes);
+    const sources = queued.flatMap((change) => (change.kind === 'move' ? [change.path] : []));
+    const confirmedLayer = await stepped(slicing(await local.entries(replica.record.key, 'confirmed', [path, ...sources]), [
+        path,
+        ...sources,
+    ]));
+    const holds = (at) => {
+        const kept = confirmedLayer.binaries[at];
+        return (kept?.state === 'accepted' &&
+            kept.sha256 === record.sha256 &&
+            confirmedLayer.revisions[at] === record.revision);
+    };
+    let confirmedAt = path;
+    for (let index = queued.length - 1; index >= 0 && !holds(confirmedAt); index -= 1) {
+        const change = queued[index];
+        if (change.kind === 'move' && change.to === confirmedAt)
+            confirmedAt = change.path;
+    }
+    return {
+        kind: 'path',
+        locator,
+        path: confirmedAt,
+        revision: record.revision,
+    };
+}
+async function askedBinary({ store, socket }, locator, path, revision) {
+    await socket.ready;
+    const drafted = (await store.draft(locator, path))?.parts.file;
+    return drafted !== undefined && drafted.localId === revision
+        ? { kind: 'pending', localId: revision }
+        : binaryPath(store, locator, path, revision);
+}
+async function pendingBinary(store, locator, path, localId) {
+    const facts = await queuedFacts(store, locator, path, localId);
+    return facts === null
+        ? absentBinary(path)
+        : {
+            kind: 'binary',
+            file: localId,
+            byteLength: facts.byteLength,
+            mediaType: facts.mediaType,
+        };
+}
+async function readBinaryPath(runtime, locator, path, revision) {
+    const asked = await askedBinary(runtime, locator, path, revision);
+    if (asked === null)
+        return absentBinary(path);
+    if (asked.kind === 'pending')
+        return pendingBinary(runtime.store, locator, path, asked.localId);
+    return readBinary(runtime, asked, { locator, path: asked.path, revision: asked.revision });
+}
+async function heldMediaType(store, locator, path) {
+    const replica = await store.record(locator);
+    const [held] = replica === undefined ? [] : await (await store.open()).entries(replica.key, 'visible', [path]);
+    return held === undefined ? store.attached.of(locator, path)?.mediaType : held.binary?.mediaType;
+}
+function linkOf(runtime, asked, held) {
+    return transferBinary(runtime, asked, (authorization) => runtime.socket.link(authorization, asked), (result) => binaryLinkAnswer(result, held));
+}
+async function linkBinaryPath(runtime, locator, path, revision) {
+    const { store, socket } = runtime;
+    await socket.ready;
+    const asked = await binaryPath(store, locator, path, revision);
+    if (asked === null || asked.kind === 'pending')
+        return absentBinary(path);
+    return linkOf(runtime, asked, revision === undefined ? await heldMediaType(store, locator, path) : undefined);
+}
+async function showBinaryPath(runtime, locator, path, revision) {
+    const { store } = runtime;
+    const asked = await askedBinary(runtime, locator, path, revision);
+    if (asked === null)
+        return absentBinary(path);
+    if (asked.kind === 'pending')
+        return pendingBinary(store, locator, path, asked.localId);
+    if (runtime.socket.closed())
+        return UNCERTAIN;
+    const name = { locator, path: asked.path, revision: asked.revision };
+    const kept = await store.opened.find(name);
+    if (kept !== null)
+        return kept;
+    const mediaType = await heldMediaType(store, locator, path);
+    if (mediaType !== undefined && isImageType(mediaType))
+        return fetchBinary(runtime, asked, name);
+    return linkOf(runtime, asked, revision === undefined ? mediaType : undefined);
+}
+async function attachFile(runtime, locator, file, answer) {
+    const { store, socket } = runtime;
+    await socket.ready;
+    await socket.firstDiscovery;
+    if (socket.closed() ||
+        !socket.session.now().roomsNamed ||
+        (await connectionNow(runtime)) === 'unreachable' ||
+        socket.session.now().refusal !== null)
+        return OFFLINE;
+    const request = await attachedFile(locator, file);
+    return transferBinary(runtime, { locator }, async (held) => {
+        const result = await socket.attach(held, request);
+        if (result.kind === 'attached' && locator !== null) {
+            store.attached.hold(locator, result.path, {
+                revision: result.revision,
+                mediaType: request.mediaType,
+            });
+        }
+        return result;
+    }, answer);
+}
+async function keyedAttachment(runtime, link) {
+    await runtime.socket.ready;
+    const asked = { kind: 'key', link };
+    return transferBinary(runtime, { locator: null }, (authorization) => runtime.socket.link(authorization, asked), (result) => binaryLinkAnswer(result));
+}
+export function conversationFiles(runtime) {
+    return {
+        attach: (file) => attachFile(runtime, null, file, linkedAnswer),
+        attachment: (link) => keyedAttachment(runtime, link),
+    };
+}
+export function binaryFileSurface(runtime) {
+    return {
+        part: runtime.store.part,
+        read: (room, path, revision) => readBinaryPath(runtime, room, path, revision),
+        link: (room, path, revision) => linkBinaryPath(runtime, room, path, revision),
+        show: (room, path, revision) => showBinaryPath(runtime, room, path, revision),
+        attach: (room, file) => attachFile(runtime, room, file, attachAnswer),
+    };
+}

package/dist/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGrD,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAExE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,CAAC;AAE7E,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,OAAO,GACP,CAAC,eAAe,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,GACxC,CAAC,eAAe,GAAG;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,GAC1C,OAAO,CAAC;AAEZ,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;CAAE,CAAC;AAE3E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAYvD"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAExE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,CAAC;AAE7E,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,OAAO,GACP,CAAC,eAAe,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,GACxC,CAAC,eAAe,GAAG;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,GAC1C,OAAO,CAAC;AAEZ,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;CAAE,CAAC;AAE3E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAYvD"}

package/dist/search.js

@@ -1,4 +1,4 @@
-import { invalid, known, plain } from './query.js';
+import { invalid, known, plain } from '@agentshouse/mdmodel';
 export function searchPlanOf(input) {
     if (!plain(input))
         invalid('search', 'expects a search object');

package/dist/seed.d.ts

@@ -1,5 +1,9 @@
-import type { KeyedResult } from './observation.js';
-import type { QueryRows } from './query.js';
+import type { Cover } from './live.js';
+import { type KeyedResult } from './observation.js';
+import type { Plan, QueryRows } from './query.js';
+import type { Deliver } from './reach.js';
+import type { Runtime } from './runtime.js';
+import type { HeldCover, Store } from './store.js';
 export type EntrySeed = {
     readonly at: Readonly<Record<string, string>>;
     readonly queries: readonly {
@@ -11,6 +15,11 @@ export type Seeded = {
     readonly rows: QueryRows;
     readonly at: Readonly<Record<string, string>>;
 };
+type SeededWatch = (coverOf: (cover: Cover, held: HeldCover) => Cover, deliver: (message: unknown) => void) => () => void;
 export declare function entrySeedOf(value: unknown): EntrySeed | null;
 export declare function seededResult(seed: Seeded): KeyedResult;
+export declare function seedApplies(runtime: Runtime, plan: Plan, held: HeldCover): Seeded | null;
+export declare function keepEntrySeed(store: Store, entry: EntrySeed): void;
+export declare function watchSeeded(runtime: Runtime, plan: Plan, deliver: Deliver, watch: SeededWatch): () => void;
+export {};
 //# sourceMappingURL=seed.d.ts.map

package/dist/seed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAA4C,SAAS,EAAE,MAAM,YAAY,CAAC;AAGtF,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;KAAE,EAAE,CAAC;CACpF,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC;AAwCjG,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAe5D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAoBtD"}
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAwB,KAAK,WAAW,EAAqB,MAAM,kBAAkB,CAAC;AAC7F,OAAO,KAAK,EAAE,IAAI,EAA4C,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;KAAE,EAAE,CAAC;CACpF,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC;AAEjG,KAAK,WAAW,GAAG,CACjB,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,KAAK,EACjD,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,KAChC,MAAM,IAAI,CAAC;AA0ChB,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAe5D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAmBtD;AA+BD,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAOxF;AAYD,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAMlE;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,WAAW,GACjB,MAAM,IAAI,CA4BZ"}

package/dist/seed.js

@@ -1,4 +1,7 @@
+import { queryKey } from '@agentshouse/mdmodel';
+import { pendingChange, whole } from './observation.js';
 import { documentKey } from './rows.js';
+const seedTopic = (key) => `seed\u0000${key}`;
 function plain(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -59,7 +62,6 @@ export function seededResult(seed) {
             generation,
             current: false,
         })),
-        indexes: [],
         overlay: [],
     };
     if ('groups' in seed.rows) {
@@ -73,3 +75,71 @@ export function seededResult(seed) {
         keys: seed.rows.documents.map((document) => documentKey(document.room, document.path)),
     };
 }
+function seedRoomHeld({ socket }, room, version, held) {
+    const stored = held.rooms.get(room);
+    return (stored !== undefined &&
+        stored.indexed &&
+        socket.reads.reached(room, stored.roomVersion, version));
+}
+function seedHeld(runtime, at, held) {
+    const { socket, presence } = runtime;
+    return Object.entries(at).every(([room, version]) => (socket.session.now().roomsListed &&
+        presence.room(room) === undefined &&
+        !held.rooms.has(room)) ||
+        seedRoomHeld(runtime, room, version, held));
+}
+export function seedApplies(runtime, plan, held) {
+    const { seeds } = runtime.store;
+    const seed = seeds.of(plan.key);
+    if (seed === undefined)
+        return null;
+    if (!seedHeld(runtime, seed.at, held))
+        return seed;
+    seeds.drop(plan.key);
+    return null;
+}
+function seedBehind(runtime, plan, cover, held) {
+    const seed = seedApplies(runtime, plan, held);
+    if (seed === null || 'pending' in cover)
+        return cover;
+    return {
+        pending: Object.entries(seed.at)
+            .filter(([room, version]) => !seedRoomHeld(runtime, room, version, held))
+            .map(([room]) => ({ room, awaits: 'acquisition' })),
+    };
+}
+export function keepEntrySeed(store, entry) {
+    for (const { query, rows } of entry.queries) {
+        const key = queryKey(query);
+        store.seeds.keep(key, { rows, at: entry.at });
+        for (const watcher of store.watching(seedTopic(key)))
+            watcher.answer(null);
+    }
+}
+export function watchSeeded(runtime, plan, deliver, watch) {
+    const { store } = runtime;
+    let seeded = false;
+    let pending = true;
+    const shown = () => {
+        const seed = store.seeds.of(plan.key);
+        if (seed === undefined || seeded || !pending)
+            return;
+        seeded = true;
+        deliver(seededResult(seed));
+    };
+    const watcher = store.watch(seedTopic(plan.key), shown);
+    const stop = watch((cover, held) => seedBehind(runtime, plan, cover, held), (message) => {
+        const answered = message;
+        pending = whole(answered) ? 'pending' in answered.result : pendingChange(answered);
+        if (pending && store.seeds.of(plan.key) !== undefined) {
+            shown();
+            return;
+        }
+        seeded = false;
+        deliver(message);
+    });
+    return () => {
+        watcher.stop();
+        stop();
+    };
+}

package/dist/shared.d.ts

@@ -1,14 +1,9 @@
 export type Paths<V> = Readonly<Record<string, V>>;
+export declare function guarding<V>(values: Paths<V>, handler: ProxyHandler<Paths<V>>): Paths<V>;
 export declare function entriesIn<V>(map: Paths<V>): Generator<readonly [string, V]>;
 export declare function sortedKeys(map: Paths<unknown>): Generator<number, readonly string[], void>;
 export declare function sorting(keys: Iterable<string>): Generator<number, readonly string[], void>;
-export declare function sharing<V>(map: Paths<V>): Generator<number, Paths<V>, void>;
-export declare function shared<V>(map: Paths<V>): Paths<V>;
-export declare function patched<V>(base: Paths<V>, set: Iterable<readonly [string, V]>, removed?: Iterable<string>): Paths<V>;
 export declare function patching<V>(base: Paths<V>, set: Iterable<readonly [string, V]>, removed?: Iterable<string>): Generator<number, Paths<V>, void>;
-export declare function sizeOf<V>(map: Paths<V>): number;
-export declare function differences<V>(left: Paths<V>, right: Paths<V>, same?: (left: V, right: V) => boolean): Generator<number, ReadonlySet<string>, void>;
-export declare function differing<V>(left: Paths<V>, right: Paths<V>, same?: (left: V, right: V) => boolean): ReadonlySet<string>;
 export declare function drafted<V>(base: Paths<V>): Record<string, V>;
 export declare function settled<V>(draft: Record<string, V>): Paths<V>;
 export declare function settling<V>(draft: Record<string, V>): Generator<number, Paths<V>, void>;

package/dist/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;AA+LnD,wBAAiB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAO5E;AAuCD,wBAAiB,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,CAAC,CAE3F;AAED,wBAAiB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,CAAC,CAoB3F;AAED,wBAAiB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAE5E;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAEjD;AAED,wBAAgB,OAAO,CAAC,CAAC,EACvB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EACnC,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAM,GAC7B,KAAK,CAAC,CAAC,CAAC,CAEV;AAED,wBAAiB,QAAQ,CAAC,CAAC,EACzB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EACnC,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAM,GAC7B,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAoBnC;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAE/C;AA8CD,wBAAiB,WAAW,CAAC,CAAC,EAC5B,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,IAAI,GAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,OAAmB,GAC/C,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAkB9C;AAED,wBAAgB,SAAS,CAAC,CAAC,EACzB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,IAAI,GAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,OAAmB,GAC/C,WAAW,CAAC,MAAM,CAAC,CAErB;AAMD,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAiD5D;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAE7D;AAED,wBAAiB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAUxF"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;AA8LnD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAIvF;AAED,wBAAiB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAQ5E;AAqCD,wBAAiB,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,CAAC,CAE3F;AAED,wBAAiB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,CAAC,CAoB3F;AAED,wBAAiB,QAAQ,CAAC,CAAC,EACzB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EACd,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EACnC,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAM,GAC7B,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAgBnC;AAMD,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAiD5D;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAE7D;AAED,wBAAiB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAUxF"}