@agentshouse/mdruntime 0.1.0-cf28918c2bf91 → 0.1.0-cf53a3b60b194

package/dist/reach.js

@@ -0,0 +1,448 @@
+import { unheldView } from './conversation.js';
+import { modelTypes, NO_MODEL } from './model.js';
+import { changeOf, digestApplied, digestOf, observing, } from './observation.js';
+import { runtimeError } from './failure.js';
+import { failure, lockedRoom, ROOM_LOCKED, undeclared, UNREADABLE, } from './outcome.js';
+import { beneath } from './paths.js';
+import { moveTarget, readParts, staleWrite, } from './room-draft.js';
+import { documentKey } from './rows.js';
+import { undeclaredSearch } from './search.js';
+const UNHELD_TYPES = { collection: modelTypes(NO_MODEL), typedSelection: null };
+function unconversed(name) {
+    return () => Promise.resolve(undeclared(name));
+}
+const NO_CONVERSATION = {
+    list: () => Promise.resolve([]),
+    read: (conversation) => Promise.resolve(unheldView(conversation)),
+    create: unconversed('conversation.create'),
+    send: unconversed('conversation.send'),
+    answer: unconversed('conversation.answer'),
+    interrupt: unconversed('conversation.interrupt'),
+    kill: unconversed('conversation.kill'),
+    cancel: unconversed('conversation.cancel'),
+    delete: unconversed('conversation.delete'),
+};
+const NO_CHAT_DRAFT = {
+    write: () => Promise.resolve(),
+    prepend: () => Promise.resolve(),
+    discard: () => Promise.resolve(),
+};
+function areasOf(reach) {
+    return reach.areas ?? [];
+}
+function typedAreas(reach, room) {
+    return areasOf(reach).filter((area) => area.room === room && area.types.length > 0);
+}
+function fenced(reach, room, path) {
+    return areasOf(reach).some((area) => area.room === room && beneath(area.path, path));
+}
+export function holds(reach, room) {
+    return (reach === null ||
+        reach.rooms.includes(room) ||
+        reach.documents.some((document) => document.room === room) ||
+        typedAreas(reach, room).length > 0);
+}
+function wholly(reach, room) {
+    return reach === null || reach.rooms.includes(room);
+}
+export function governs(reach, room) {
+    if (wholly(reach, room.locator)) {
+        return { collection: true, selection: room.typedSelection !== null };
+    }
+    const selected = (path) => room.typedSelection?.roots.some((root) => beneath(root, path)) ?? false;
+    const paths = [
+        ...reach.documents
+            .filter((document) => document.room === room.locator)
+            .map(({ path }) => path),
+        ...typedAreas(reach, room.locator).map(({ path }) => path),
+    ];
+    return { collection: paths.some((path) => !selected(path)), selection: paths.some(selected) };
+}
+function covers(reach, room, path) {
+    return (reach === null ||
+        (!fenced(reach, room, path) &&
+            (reach.rooms.includes(room) ||
+                reach.documents.some((document) => document.room === room && document.path === path))));
+}
+function conversing(reach) {
+    return reach === null || reach.conversations;
+}
+export function planReach(reach) {
+    return reach === null
+        ? null
+        : {
+            rooms: [...new Set(reach.rooms)].sort(),
+            documents: [
+                ...new Set(reach.documents.map(({ room, path }) => documentKey(room, path))),
+            ].sort(),
+            areas: areasOf(reach)
+                .map(({ room, path, types }) => ({ room, path, types: [...new Set(types)].sort() }))
+                .sort((left, right) => documentKey(left.room, left.path) < documentKey(right.room, right.path) ? -1 : 1),
+        };
+}
+function roomsWithin(reach, rooms) {
+    return rooms.filter((room) => wholly(reach, room.locator));
+}
+function typesWithin(reach, room, types) {
+    if (room === undefined)
+        return structuredClone(UNHELD_TYPES);
+    const governed = governs(reach, room);
+    return {
+        collection: governed.collection ? types.collection : modelTypes(NO_MODEL),
+        typedSelection: governed.selection ? types.typedSelection : null,
+    };
+}
+function moves(reach, room, move) {
+    return move === undefined || covers(reach, move.room ?? room, moveTarget(move));
+}
+function draftWithin(reach, draft) {
+    return covers(reach, draft.room, draft.path) && moves(reach, draft.room, draft.parts.move);
+}
+function draftsWithin(reach, drafts) {
+    return drafts.filter((draft) => draftWithin(reach, draft));
+}
+function shownDraft(reach, draft) {
+    return draft !== null && draftWithin(reach, draft) ? draft : null;
+}
+function writeWithin(reach, write) {
+    return write.outcome === 'written'
+        ? { outcome: 'written', roomDraft: shownDraft(reach, write.roomDraft) }
+        : staleWrite(shownDraft(reach, write.current));
+}
+function savedWithin(reach, room, result) {
+    if (reach === null || result.outcome === 'saved')
+        return result;
+    const { file, location, referrers, ...refusal } = result;
+    const hidden = file !== undefined && !covers(reach, room, file);
+    return {
+        ...refusal,
+        ...(file === undefined || hidden ? {} : { file }),
+        ...(location === undefined || hidden ? {} : { location }),
+        ...(referrers === undefined
+            ? {}
+            : { referrers: referrers.filter((path) => covers(reach, room, path)) }),
+    };
+}
+function statusWithin(reach, status) {
+    return {
+        ...status,
+        attentionRequired: status.attentionRequired.filter((entry) => 'refusal' in entry ? wholly(reach, entry.room) : covers(reach, entry.room, entry.path)),
+        unsent: status.unsent.filter((change) => covers(reach, change.room, change.path)),
+    };
+}
+function queueWithin(reach, room, entries) {
+    return entries
+        .filter(({ batch }) => batch.changes.every((change) => covers(reach, room, change.path) &&
+        (change.kind !== 'move' || covers(reach, room, change.to))))
+        .map((entry) => {
+        const { between, ...batch } = entry.batch;
+        if (between === undefined)
+            return entry;
+        return wholly(reach, between.source.room) && wholly(reach, between.destination.room)
+            ? entry
+            : { ...entry, batch };
+    });
+}
+function unreached(room) {
+    return runtimeError('room-not-held', `No Local Replica for ${room}`);
+}
+function lockedError(room) {
+    return runtimeError(ROOM_LOCKED, `${room} is locked until House confirms its access`, true);
+}
+function deviceUnreached() {
+    return runtimeError('device-unreached', 'Only the panel cleans up this device');
+}
+const ATTACH_REQUIRED = 'attach-required';
+function attachRequired() {
+    return runtimeError(ATTACH_REQUIRED, 'App code takes a file in with binaryFile.attach');
+}
+function carriesFile(parts) {
+    return parts !== null && typeof parts === 'object' && Object.hasOwn(parts, 'file');
+}
+export function narrowed(runtime, given, told) {
+    const { md, watch } = runtime;
+    let reach = given;
+    let port = told;
+    const open = new Set();
+    function following(begin, locking = false) {
+        let stop = begin();
+        const restart = () => {
+            stop();
+            stop = begin();
+        };
+        open.add(restart);
+        const unwatch = locking ? runtime.watchLocks(restart) : () => { };
+        return () => {
+            open.delete(restart);
+            unwatch();
+            stop();
+        };
+    }
+    const unlocking = (rooms) => {
+        const locked = (rooms ?? []).filter((room) => runtime.locked(room));
+        return locked.length === 0
+            ? null
+            : { pending: locked.map((room) => ({ room, awaits: 'unlock' })) };
+    };
+    const unlocked = (entries) => entries.filter((entry) => !runtime.locked(entry.room));
+    const intoLocked = (held) => held.some((move) => move?.room !== undefined && runtime.locked(move.room));
+    const within = (topic, input, deliver) => {
+        if (topic === 'rooms') {
+            return following(() => watch(topic, input, (rooms) => deliver(roomsWithin(reach, rooms))));
+        }
+        if (topic === 'readiness') {
+            return following(() => runtime.watchReadiness(port, reach, deliver));
+        }
+        if (topic === 'sync-status') {
+            return following(() => watch(topic, input, (status) => {
+                const within = statusWithin(reach, status);
+                deliver({ ...within, attentionRequired: unlocked(within.attentionRequired) });
+            }), true);
+        }
+        if (topic === 'room-drafts') {
+            return following(() => watch(topic, input, (drafts) => deliver(unlocked(draftsWithin(reach, drafts)))), true);
+        }
+        if (topic === 'queue') {
+            const room = input[0];
+            return following(() => {
+                if (!holds(reach, room) || runtime.locked(room)) {
+                    deliver([]);
+                    return () => { };
+                }
+                return watch(topic, input, (entries) => deliver(queueWithin(reach, room, entries)));
+            }, true);
+        }
+        if (topic === 'query') {
+            const plan = runtime.plan(input[0], reach);
+            let held = null;
+            return following(() => {
+                const locked = unlocking(plan.rooms);
+                if (locked !== null) {
+                    const answer = { result: locked, keys: [] };
+                    if (held === null || changeOf(held, answer) !== null)
+                        deliver(answer);
+                    held = digestOf(answer);
+                    return () => { };
+                }
+                let first = true;
+                let open = true;
+                const heard = (message) => {
+                    if (!first) {
+                        held = digestApplied(held, message);
+                        deliver(message);
+                        return;
+                    }
+                    first = false;
+                    const change = held === null ? message : changeOf(held, message);
+                    held = digestOf(message);
+                    if (change !== null)
+                        deliver(change);
+                };
+                const current = { ...plan, reach: planReach(reach), locked: runtime.lockedRooms() };
+                const stop = runtime.watchPlan(current, (message) => {
+                    if (open)
+                        heard(message);
+                });
+                return () => {
+                    open = false;
+                    stop();
+                };
+            }, true);
+        }
+        if (topic === 'conversation') {
+            return following(() => {
+                if (conversing(reach))
+                    return watch(topic, input, deliver);
+                deliver(unheldView(input[0]));
+                return () => { };
+            });
+        }
+        if (topic === 'conversations' || topic === 'agents') {
+            return following(() => {
+                if (conversing(reach))
+                    return watch(topic, input, deliver);
+                deliver([]);
+                return () => { };
+            });
+        }
+        return watch(topic, input, deliver);
+    };
+    const files = new Map();
+    let handed = 0;
+    async function hand(reading) {
+        const answer = await reading;
+        if (answer.kind !== 'binary')
+            return answer;
+        handed += 1;
+        const file = String(handed);
+        files.set(file, answer.file);
+        return { ...answer, file };
+    }
+    const conversation = () => (conversing(reach) ? md.conversation : NO_CONVERSATION);
+    const chatDraft = () => (conversing(reach) ? md.chatDraft : NO_CHAT_DRAFT);
+    const view = {
+        ...md,
+        rooms: () => md.rooms().then((rooms) => roomsWithin(reach, rooms)),
+        query: ((input) => {
+            const plan = runtime.plan(input, reach);
+            return Promise.resolve(unlocking(plan.rooms) ?? runtime.query({ ...plan, locked: runtime.lockedRooms() }));
+        }),
+        search: (input) => port.search === 'required'
+            ? runtime.search(input, reach, runtime.lockedRooms())
+            : Promise.resolve(undeclaredSearch()),
+        types(room) {
+            if (holds(reach, room) && runtime.locked(room))
+                throw lockedError(room);
+            if (wholly(reach, room))
+                return md.types(room);
+            if (!holds(reach, room))
+                return structuredClone(UNHELD_TYPES);
+            return typesWithin(reach, runtime.room(room), md.types(room));
+        },
+        async save(room, roomDrafts, writtenBy) {
+            if (!holds(reach, room))
+                throw unreached(room);
+            if (runtime.locked(room))
+                return { outcome: 'refused', code: ROOM_LOCKED, retryable: true };
+            const held = (await Promise.all(roomDrafts.map(({ path }) => md.roomDraft.read(room, path)))).map((draft) => draft?.parts.move);
+            const outside = roomDrafts.find(({ path }, at) => !covers(reach, room, path) || !moves(reach, room, held[at]));
+            if (outside !== undefined) {
+                return { outcome: 'refused', code: 'stale', retryable: false, file: outside.path };
+            }
+            if (intoLocked(held))
+                return { outcome: 'refused', code: ROOM_LOCKED, retryable: true };
+            return savedWithin(reach, room, await md.save(room, roomDrafts, writtenBy));
+        },
+        async saveParts(room, parts, writtenBy) {
+            if (!holds(reach, room))
+                throw unreached(room);
+            const filed = reach === null ? undefined : parts.find(({ parts: one }) => carriesFile(one));
+            if (filed !== undefined) {
+                return { outcome: 'refused', code: ATTACH_REQUIRED, retryable: false, file: filed.path };
+            }
+            if (runtime.locked(room))
+                return { outcome: 'refused', code: ROOM_LOCKED, retryable: true };
+            const held = parts.map(({ parts: one }) => readParts(one).move);
+            if (parts.some(({ path }, at) => !covers(reach, room, path) || !moves(reach, room, held[at]))) {
+                throw unreached(room);
+            }
+            if (intoLocked(held))
+                return { outcome: 'refused', code: ROOM_LOCKED, retryable: true };
+            return savedWithin(reach, room, await md.saveParts(room, parts, writtenBy));
+        },
+        resolve(room, path, destination) {
+            const at = runtime.located(room, path, destination);
+            return at !== null && !covers(reach, at.room, at.path)
+                ? Promise.resolve(UNREADABLE)
+                : md.resolve(room, path, destination);
+        },
+        history: (room, path, query) => !covers(reach, room, path)
+            ? Promise.resolve(failure({ kind: 'room-not-readable', locator: room }))
+            : runtime.locked(room)
+                ? Promise.resolve(lockedRoom(room))
+                : md.history(room, path, query),
+        binaryFile: {
+            read: (room, path, revision) => !covers(reach, room, path)
+                ? Promise.resolve(failure({ kind: 'room-not-readable', locator: room }))
+                : runtime.locked(room)
+                    ? Promise.resolve(lockedRoom(room))
+                    : hand(md.binaryFile.read(room, path, revision)),
+            link: (room, path, revision) => !covers(reach, room, path)
+                ? Promise.resolve(failure({ kind: 'room-not-readable', locator: room }))
+                : runtime.locked(room)
+                    ? Promise.resolve(lockedRoom(room))
+                    : md.binaryFile.link(room, path, revision),
+            show: (room, path, revision) => !covers(reach, room, path)
+                ? Promise.resolve(failure({ kind: 'room-not-readable', locator: room }))
+                : runtime.locked(room)
+                    ? Promise.resolve(lockedRoom(room))
+                    : hand(md.binaryFile.show(room, path, revision)),
+            attach: (room, file) => !wholly(reach, room)
+                ? Promise.resolve(failure({ kind: 'room-not-readable', locator: room }))
+                : runtime.locked(room)
+                    ? Promise.resolve(lockedRoom(room))
+                    : md.binaryFile.attach(room, file),
+            async part(file, part) {
+                const key = files.get(file);
+                if (key === undefined)
+                    return null;
+                const bytes = await md.binaryFile.part(key, part);
+                if (bytes === null)
+                    files.delete(file);
+                return bytes;
+            },
+        },
+        reached: async (room, roomVersion, path) => (path === undefined ? wholly(reach, room) : covers(reach, room, path)) &&
+            !runtime.locked(room) &&
+            (await md.reached(room, roomVersion, path)),
+        log: () => (reach === null ? md.log() : ''),
+        cleanUp: () => (reach === null ? md.cleanUp() : Promise.reject(deviceUnreached())),
+        roomDraft: {
+            list: () => md.roomDraft.list().then((drafts) => unlocked(draftsWithin(reach, drafts))),
+            async read(room, path) {
+                if (!covers(reach, room, path))
+                    return null;
+                if (runtime.locked(room))
+                    throw lockedError(room);
+                return shownDraft(reach, await md.roomDraft.read(room, path));
+            },
+            write(room, path, revision, parts, next) {
+                try {
+                    if (reach !== null && carriesFile(parts))
+                        throw attachRequired();
+                    const move = readParts(parts).move;
+                    if (!covers(reach, room, path) || !moves(reach, room, move))
+                        throw unreached(room);
+                    if (runtime.locked(room))
+                        throw lockedError(room);
+                    if (intoLocked([move]))
+                        throw lockedError(move.room);
+                }
+                catch (error) {
+                    return Promise.reject(error);
+                }
+                return md.roomDraft
+                    .write(room, path, revision, parts, next)
+                    .then((written) => writeWithin(reach, written));
+            },
+            async discard(room, path, revision) {
+                if (!covers(reach, room, path))
+                    return staleWrite(null);
+                if (runtime.locked(room))
+                    throw lockedError(room);
+                return writeWithin(reach, await md.roomDraft.discard(room, path, revision));
+            },
+        },
+        conversation: {
+            list: () => conversation().list(),
+            read: (id, options) => conversation().read(id, options),
+            create: (input) => conversation().create(input),
+            send: (id, operation, draft) => conversation().send(id, operation, draft),
+            answer: (id, answer) => conversation().answer(id, answer),
+            interrupt: (id) => conversation().interrupt(id),
+            kill: (id) => conversation().kill(id),
+            cancel: (id, turn) => conversation().cancel(id, turn),
+            delete: (id) => conversation().delete(id),
+        },
+        chatDraft: {
+            write: (id, draft, revision) => chatDraft().write(id, draft, revision),
+            prepend: (id, draft) => chatDraft().prepend(id, draft),
+            discard: (id) => chatDraft().discard(id),
+        },
+        observe: observing(within),
+    };
+    return {
+        md: view,
+        watch: within,
+        narrow(next) {
+            reach = next;
+            for (const restart of [...open])
+                restart();
+        },
+        facts(next) {
+            port = next;
+            for (const restart of [...open])
+                restart();
+        },
+    };
+}

package/dist/react.d.ts

@@ -0,0 +1,43 @@
+import type { MdRuntimeClient } from './client.js';
+import type { AppRoom, ConnectionRefusal, SavedRoomDraft, SaveResult } from './connection.js';
+import type { Member, ServiceMode } from './adapter.js';
+import type { ConversationAgent, ConversationEntry, ConversationOptions, ConversationView } from './conversation.js';
+import { type RuntimeError } from './failure.js';
+import type { QueueEntry } from './outcome.js';
+import type { DocumentQuery, DocumentResult, GroupQuery, GroupResult, PendingResult } from './query.js';
+import type { Readiness } from './readiness.js';
+import type { RoomDraft, RoomDraftParts } from './room-draft.js';
+import type { SyncStatus } from './status.js';
+type Client = MdRuntimeClient | null;
+export type Observed<T> = {
+    readonly state: 'loading';
+} | {
+    readonly state: 'ready';
+    readonly value: T;
+};
+export declare function useObserve(client: Client, topic: 'deployment-facts'): Observed<unknown>;
+export declare function useObserve(client: Client, topic: 'rooms'): Observed<readonly AppRoom[]>;
+export declare function useObserve(client: Client, topic: 'readiness'): Observed<Readiness>;
+export declare function useObserve(client: Client, topic: 'connection-refusal'): Observed<ConnectionRefusal | null>;
+export declare function useObserve(client: Client, topic: 'storage-loss'): Observed<string | null>;
+export declare function useObserve(client: Client, topic: 'sync-status'): Observed<SyncStatus>;
+export declare function useObserve(client: Client, topic: 'service-mode'): Observed<ServiceMode>;
+export declare function useObserve(client: Client, topic: 'member'): Observed<Member | null>;
+export declare function useObserve(client: Client, topic: 'query', query: DocumentQuery): Observed<DocumentResult | PendingResult>;
+export declare function useObserve(client: Client, topic: 'query', query: GroupQuery): Observed<GroupResult | PendingResult>;
+export declare function useObserve(client: Client, topic: 'queue', locator: string): Observed<readonly QueueEntry[]>;
+export declare function useObserve(client: Client, topic: 'room-drafts'): Observed<readonly RoomDraft[]>;
+export declare function useObserve(client: Client, topic: 'presentation'): Observed<unknown>;
+export declare function useObserve(client: Client, topic: 'conversation', conversation: string, options: ConversationOptions): Observed<ConversationView>;
+export declare function useObserve(client: Client, topic: 'conversations'): Observed<readonly ConversationEntry[]>;
+export declare function useObserve(client: Client, topic: 'agents'): Observed<readonly ConversationAgent[]>;
+export type Saving = {
+    readonly busy: boolean;
+    readonly outcome: SaveResult | null;
+    readonly failure: RuntimeError | null;
+    save(room: string, parts: ReadonlyMap<string, RoomDraftParts>): Promise<SaveResult>;
+    saveWritten(room: string, roomDrafts: readonly SavedRoomDraft[]): Promise<SaveResult>;
+};
+export declare function useSave(client: MdRuntimeClient): Saving;
+export {};
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

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

package/dist/react.js

@@ -0,0 +1,54 @@
+import { useCallback, useLayoutEffect, useRef, useState } from 'react';
+import { failed } from './failure.js';
+const LOADING = { state: 'loading' };
+export function useObserve(client, topic, ...input) {
+    const key = JSON.stringify([topic, ...input]);
+    const [held, setHeld] = useState(null);
+    const opened = useRef(input);
+    opened.current = input;
+    useLayoutEffect(() => {
+        if (client === null)
+            return;
+        let live = true;
+        let observation = null;
+        const observe = client.observe;
+        void observe(topic, ...opened.current).then((open) => {
+            if (!live) {
+                open.close();
+                return;
+            }
+            observation = open;
+            const take = (value) => {
+                if (live)
+                    setHeld({ client, key, observed: { state: 'ready', value } });
+            };
+            take(open.current());
+            open.subscribe(take);
+        });
+        return () => {
+            live = false;
+            observation?.close();
+        };
+    }, [client, key]);
+    return held !== null && held.client === client && held.key === key ? held.observed : LOADING;
+}
+const IDLE = { busy: false, outcome: null, failure: null };
+export function useSave(client) {
+    const [state, setState] = useState(IDLE);
+    const settled = useCallback(async (saving) => {
+        setState({ busy: true, outcome: null, failure: null });
+        try {
+            const outcome = await saving();
+            setState({ busy: false, outcome, failure: null });
+            return outcome;
+        }
+        catch (error) {
+            const failure = failed(error);
+            setState({ busy: false, outcome: null, failure });
+            throw failure;
+        }
+    }, []);
+    const save = useCallback((room, parts) => settled(() => client.saveParts(room, [...parts].map(([path, one]) => ({ path, parts: one })))), [client, settled]);
+    const saveWritten = useCallback((room, roomDrafts) => settled(() => client.save(room, roomDrafts)), [client, settled]);
+    return { ...state, save, saveWritten };
+}

package/dist/readiness.d.ts

@@ -0,0 +1,64 @@
+import type { Open } from './open.js';
+export type CodeAvailability = Open<'stored' | 'absent'>;
+export type RoomPreparation = Open<'complete' | 'acquiring' | 'preparing' | 'refused' | 'unadmitted'>;
+export type RoomCoverage = {
+    readonly room: string;
+    readonly state: RoomPreparation;
+};
+export type ConversationCoverage = Open<'complete' | 'acquiring' | 'undeclared'>;
+export type SearchObligation = Open<'required' | 'unused'>;
+export type TargetCoverage = {
+    readonly complete: boolean;
+    readonly listed: boolean;
+    readonly rooms: readonly RoomCoverage[];
+    readonly conversations: ConversationCoverage;
+    readonly search: SearchObligation;
+};
+export type Persistence = Open<'granted' | 'denied' | 'unavailable'>;
+export type Durability = Open<'persistent' | 'best-effort'>;
+export type ConnectionAvailability = Open<'connected' | 'connecting' | 'unreachable'>;
+export type HouseOutcome = Open<'open' | 'write-halted' | 'refused'>;
+export type Space = Open<'full'>;
+export type RefusedRoom = {
+    readonly room: string;
+    readonly name: string;
+    readonly file: string;
+    readonly rule: string;
+    readonly location: string | null;
+};
+export type InstallationStep = Open<'listing' | 'downloading' | 'writing' | 'replaying'>;
+export type InstallationPause = Open<'hidden'>;
+export type InstallationAmount = {
+    readonly done: number;
+    readonly total: number;
+};
+export type Installation = {
+    readonly step: InstallationStep | null;
+    readonly paused: InstallationPause | null;
+    readonly rooms: InstallationAmount;
+    readonly parts: InstallationAmount;
+    readonly bytes: InstallationAmount;
+    readonly received: InstallationAmount;
+};
+export type ReadinessStatus = Open<'preparing' | 'paused' | 'refused' | 'ready' | 'lost'>;
+export type Readiness = {
+    readonly status: ReadinessStatus;
+    readonly ready: boolean;
+    readonly usable: boolean;
+    readonly code: CodeAvailability;
+    readonly coverage: TargetCoverage;
+    readonly durability: Durability;
+    readonly persistence: Persistence;
+    readonly connection: ConnectionAvailability;
+    readonly house: HouseOutcome;
+    readonly space: Space | null;
+    readonly installation: Installation;
+    readonly refused: readonly RefusedRoom[];
+    readonly lost: boolean;
+};
+export type ReadinessFacts = Omit<Readiness, 'status' | 'ready' | 'usable' | 'durability' | 'coverage'> & {
+    readonly coverage: Omit<TargetCoverage, 'complete'>;
+    readonly established: boolean;
+};
+export declare function readinessOf(facts: ReadinessFacts): Readiness;
+//# sourceMappingURL=readiness.d.ts.map

package/dist/readiness.d.ts.map

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

package/dist/readiness.js

@@ -0,0 +1,33 @@
+const COMPLETE_ROOMS = new Set(['complete', 'unadmitted']);
+const SETTLED_ROOMS = new Set([...COMPLETE_ROOMS, 'refused']);
+export function readinessOf(facts) {
+    const { established, coverage: held, ...reported } = facts;
+    const settledConversations = held.conversations === 'complete' || held.conversations === 'undeclared';
+    const complete = held.listed &&
+        settledConversations &&
+        held.rooms.every((room) => COMPLETE_ROOMS.has(room.state));
+    const settled = held.listed &&
+        settledConversations &&
+        held.rooms.every((room) => SETTLED_ROOMS.has(room.state));
+    const coverage = { ...held, complete };
+    const stored = facts.code === 'stored';
+    const ready = stored && complete;
+    const usable = stored && (ready || established);
+    const status = ready
+        ? 'ready'
+        : facts.space !== null || facts.installation.paused !== null
+            ? 'paused'
+            : settled && !complete
+                ? 'refused'
+                : facts.lost && !established
+                    ? 'lost'
+                    : 'preparing';
+    return {
+        ...reported,
+        coverage,
+        status,
+        ready,
+        usable,
+        durability: facts.persistence === 'granted' ? 'persistent' : 'best-effort',
+    };
+}

package/dist/reads.d.ts

@@ -0,0 +1,11 @@
+import type { Adapter } from './adapter.js';
+import type { Reads } from './bootstrap.js';
+export type DoorReads = Reads & {
+    carried(locator: string): number;
+    finished(locator: string, turn: number): void;
+    opened(): void;
+    applied(): void;
+    lost(): void;
+};
+export declare function doorReads(adapter: Adapter, declaration: (locator: string) => unknown, generation: () => number): DoorReads;
+//# sourceMappingURL=reads.d.ts.map