@agentshouse/mdruntime 0.1.0-cb2e390ee7b89 → 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

@@ -1,105 +1,22 @@
-import type { ProviderRefusal } from './adapter.js';
-import type { ChangeSet } from './change-set.js';
-import { type CoveredRoom, type Filter, type PendingRoom } from './query.js';
-import type { Open } from './open.js';
-export type DocumentPart = Open<'fields' | 'sections' | 'preamble' | 'path'>;
+import type { ProviderRefusal, SearchHit } from './adapter.js';
+import type { Failure, Offline } from './outcome.js';
 export type SearchRequest = {
     text: string;
-    documents?: Filter;
-    collection?: true;
-    conversations?: readonly string[];
-    limit?: number;
-    after?: string;
-    total?: true;
+    rooms?: readonly string[];
 };
-export type DocumentHit = {
-    room: string;
-    path: string;
-    type: string;
-    score: number;
-    matches: Readonly<Record<string, readonly DocumentPart[]>>;
+export type { SearchHit } from './adapter.js';
+export type SearchFound = {
+    kind: 'found';
+    documents: readonly SearchHit[];
 };
-export type MessageHit = {
-    conversation: string;
-    identity: string;
-    score: number;
-    matches: Readonly<Record<string, readonly Open<'text'>[]>>;
-};
-export type SearchCoverage = {
-    rooms: readonly CoveredRoom[];
-    conversations: readonly string[];
-    index: string;
-    overlay: readonly string[];
-};
-export type PendingConversation = {
-    conversation: string;
-    awaits: Open<'index'>;
-};
-export type SearchHits = {
-    documents: readonly DocumentHit[];
-    messages: readonly MessageHit[];
-};
-export type SearchWindow = SearchHits & {
-    next?: string;
-    total?: {
-        documents: number;
-        messages: number;
-    };
-};
-export type SearchPending = SearchHits & {
-    pending: readonly (PendingRoom | PendingConversation)[];
-    coverage: SearchCoverage;
-};
-export type SearchUndeclared = ProviderRefusal & {
+export type SearchResult = SearchFound | Offline | (ProviderRefusal & {
+    kind: 'rejected';
+}) | (ProviderRefusal & {
     kind: 'undeclared';
-};
-export type SearchResult = (SearchWindow & {
-    coverage: SearchCoverage;
-}) | SearchPending | SearchUndeclared;
-export declare function undeclaredSearch(): SearchUndeclared;
-export type SearchedDocument = {
-    room: string;
-    path: string;
-    type: string;
-    fields: Readonly<Record<string, unknown>>;
-    preamble: string;
-    sections: Readonly<Record<string, string>>;
-};
-export type SearchedMessage = {
-    conversation: string;
-    identity: string;
-    text: string;
-};
-export type SearchSource = {
-    room(room: string): readonly string[];
-    document(room: string, path: string): SearchedDocument | null;
-};
-type HitCursor = readonly [number, string, string] | readonly [] | null;
+}) | Failure;
 export type SearchPlan = {
     text: string;
-    documents: unknown;
-    collection: boolean;
-    conversations: readonly string[] | null;
-    limit: number | null;
-    after: readonly [HitCursor, HitCursor] | null;
-    total: boolean;
-};
-export type SearchIndex = {
-    generation(): string;
-    rooms(): ReadonlySet<string>;
-    conversations(): ReadonlySet<string>;
-    indexRoom(room: string): Promise<void>;
-    indexMessages(conversation: string, messages: readonly SearchedMessage[], whole: boolean): void;
-    forget(rooms: readonly string[]): void;
-    changed(set: ChangeSet): void;
-    changes(): number;
-    caughtUp(): Promise<void>;
-    search(plan: SearchPlan, documents: readonly {
-        room: string;
-        path: string;
-    }[] | null, conversations: readonly string[], rooms: ReadonlySet<string> | null, selections: ReadonlyMap<string, readonly string[]> | null): SearchWindow;
+    rooms: readonly string[] | null;
 };
 export declare function searchPlanOf(input: unknown): SearchPlan;
-export declare function createSearchIndex(source: SearchSource): SearchIndex;
-export {};
 //# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"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"}
+{"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"}