@agentshouse/mdruntime 0.1.0-c49444f2a8fc6 → 0.1.0-c4c5934c45f21

package/dist/queue.js

@@ -0,0 +1,455 @@
+import { changeSet, mergeChangeSets } from './change-set.js';
+import { leaving as leavingIn, partnerOf } from './change.js';
+import { composedOf, definitionsAt } from './collection.js';
+import { runtimeError } from './failure.js';
+import { roomDraftRevision } from './identity.js';
+import { landed, movedBy, overlayOf, replaying, slicing, slicingWith, standing, storedRecord, touchedBy, } from './replica.js';
+import { returnedBy, returnedInto } from './room-draft.js';
+import { documentKey } from './rows.js';
+import { stepped } from './turn.js';
+export function withdrawable(states) {
+    return (batch) => {
+        const state = states.get(batch.id);
+        return state !== undefined && state.submission.state !== 'submitted' && !state.lost;
+    };
+}
+export async function sliceAt(store, record, view, queue, extra = [], moved = []) {
+    const local = await store.open();
+    const needed = new Set([...touchedBy(queue), ...extra]);
+    const movedPaths = [...new Set([...movedBy(queue, record.locator), ...moved])];
+    if (movedPaths.length > 0) {
+        for (const { path } of await local.referrers(record.key, view, movedPaths)) {
+            needed.add(path);
+        }
+    }
+    const paths = [...needed];
+    return stepped(slicing(await local.entries(record.key, view, paths), paths));
+}
+async function landedWhole(store, record, batch, confirmedLayer, current) {
+    if (!landed(batch, confirmedLayer, store.composed(record), current))
+        return false;
+    const partner = partnerOf(batch, record.locator);
+    if (partner === null)
+        return true;
+    const other = await store.replica(partner);
+    const half = other?.queue.find((one) => one.id === batch.id);
+    if (other === undefined || half === undefined)
+        return false;
+    return landed(half, await sliceAt(store, other.record, 'confirmed', [half]), store.composed(other.record));
+}
+async function returnedDrafts(store, locator, work, leaving, composition) {
+    const written = new Map();
+    for (const { batch, returned } of leaving) {
+        if (returned === null || batch.between?.destination.room === locator)
+            continue;
+        for (const saved of work.states.get(batch.id)?.drafts ?? []) {
+            const existing = written.get(saved.path) ?? (await store.draft(locator, saved.path));
+            written.set(saved.path, {
+                locator,
+                path: saved.path,
+                revision: roomDraftRevision(),
+                parts: returnedInto(existing?.parts, saved.parts, composition === undefined ? undefined : definitionsAt(composition, saved.path)),
+                returned,
+            });
+        }
+    }
+    return written;
+}
+async function carriedBack(store, locator, unlanded, written) {
+    const back = new Map();
+    const taken = [];
+    for (const batch of unlanded) {
+        const between = batch.between;
+        if (between === undefined)
+            continue;
+        const source = between.source.room;
+        const destination = between.destination.room;
+        const local = await store.open();
+        const arrived = (await local.pending(destination, batch.id)).state?.drafts ?? [];
+        for (const { path: to } of arrived) {
+            const record = await store.draft(destination, to);
+            const path = between.moves.find((move) => move.to === to)?.path;
+            if (record === undefined || path === undefined)
+                continue;
+            const [into, key] = source === locator ? [written, path] : [back, documentKey(source, path)];
+            const existing = into.get(key) ?? (await store.draft(source, path));
+            const held = await store.record(source);
+            taken.push({ locator: destination, path: to });
+            into.set(key, {
+                locator: source,
+                path,
+                revision: roomDraftRevision(),
+                parts: returnedInto(existing?.parts, record.parts, held === undefined ? undefined : definitionsAt(store.composed(held), path)),
+                returned: existing?.returned ?? null,
+            });
+        }
+    }
+    const records = [...back.values()];
+    const elsewhere = taken.filter((one) => one.locator !== locator);
+    const rooms = new Set([...records, ...elsewhere].map((one) => one.locator));
+    return {
+        taken: taken.filter((one) => one.locator === locator).map(({ path }) => path),
+        writes: [...rooms].map((room) => ({
+            locator: room,
+            roomDrafts: records.filter((record) => record.locator === room),
+            consumedRoomDrafts: elsewhere.filter((one) => one.locator === room).map(({ path }) => path),
+        })),
+        changes: [...rooms].map((room) => changeSet(room, {
+            drafts: [...records, ...elsewhere]
+                .filter((one) => one.locator === room)
+                .map(({ path }) => path),
+        })),
+    };
+}
+function confirmedAgain(store, locator) {
+    store.installs.change(locator, (held) => ({
+        ...held,
+        confirmations: held.confirmations + 1,
+    }));
+}
+function replayed(store, record, confirmedLayer, queue) {
+    return stepped(replaying(confirmedLayer, queue, record.locator, store.composed(record)));
+}
+async function overlayDiff(record, before, visible, touched) {
+    const kept = before !== undefined && before.record.key === record.key ? before.overlaid : new Set();
+    return {
+        overlay: {
+            set: await stepped(overlayOf(visible, touched)),
+            cleared: [...kept].filter((path) => !touched.has(path)),
+        },
+        touched,
+    };
+}
+function unsent(state, batch, locator) {
+    if (state === undefined)
+        return false;
+    return !leavingIn(batch, locator) || withdrawable(new Map([[batch.id, state]]))(batch);
+}
+async function together(runtime, local, settlements) {
+    const settled = new Set(settlements.map(({ locator }) => locator));
+    const all = [...settlements];
+    for (let wave = settlements; wave.length > 0;) {
+        const partnered = new Map();
+        for (const { locator, left } of wave) {
+            for (const batch of left) {
+                const partner = partnerOf(batch, locator);
+                if (partner === null ||
+                    settled.has(partner) ||
+                    !unsent((await local.pending(partner, batch.id)).state, batch, partner)) {
+                    continue;
+                }
+                partnered.set(partner, [...(partnered.get(partner) ?? []), batch]);
+            }
+        }
+        const partners = [];
+        for (const [partner, batches] of partnered) {
+            settled.add(partner);
+            partners.push(await unpairing(runtime, local, partner, batches));
+        }
+        all.push(...partners);
+        wave = partners;
+    }
+    const answer = await local.commit({
+        rooms: all.flatMap(({ commit }) => commit.rooms),
+        writes: all.flatMap(({ commit }) => commit.writes),
+    });
+    return mergeChangeSets(all.map((one) => one.apply(answer)));
+}
+async function settlement(runtime, local, locator, work, record, queue, settling = {}) {
+    const { store, journal, localSaves } = runtime;
+    const before = work.replica;
+    const view = settling.view ?? 'confirmed';
+    const previousQueue = work.queue;
+    const overrides = settling.changes;
+    const read = await sliceAt(store, record, view, queue, [
+        ...(before !== undefined && before.record.key === record.key ? before.overlaid : []),
+        ...(overrides?.set.map(({ path }) => path) ?? []),
+        ...(overrides?.removed ?? []),
+    ]);
+    const confirmedLayer = overrides === undefined
+        ? read
+        : await stepped(slicingWith(read, overrides.set, overrides.removed));
+    const composition = store.composed(record);
+    const shown = queue.filter((batch) => {
+        const held = store.landed.of(locator, batch.id);
+        return (held !== undefined &&
+            Object.entries(held).some(([path, revision]) => confirmedLayer.revisions[path] !== revision));
+    });
+    const unshown = queue.filter((batch) => !shown.includes(batch));
+    const { withdrawn, kept } = await stepped(standing(confirmedLayer, unshown, withdrawable(work.states), localSaves, locator, composition));
+    const founded = kept.filter((batch) => !unshown.includes(batch));
+    const queueChanged = kept.length !== previousQueue.length || founded.length > 0;
+    const unqueued = shown.map((batch) => ({ batch, landed: true }));
+    for (const batch of withdrawn) {
+        unqueued.push({ batch, landed: await landedWhole(store, record, batch, confirmedLayer) });
+    }
+    const returning = [
+        ...[...unqueued].reverse().map(({ batch, landed: held }) => ({
+            batch,
+            returned: localSaves || held ? null : returnedBy(),
+        })),
+        ...(settling.leaving ?? []),
+    ];
+    const written = await returnedDrafts(store, locator, work, returning, composition);
+    const carried = await carriedBack(store, locator, [
+        ...[...unqueued].reverse().flatMap(({ batch, landed: held }) => (held ? [] : [batch])),
+        ...(settling.leaving ?? []).flatMap(({ batch, returned }) => returned === null ? [] : [batch]),
+    ], written);
+    const replayedLayer = await replayed(store, record, confirmedLayer, kept);
+    const { overlay } = await overlayDiff(record, before, replayedLayer.visible, replayedLayer.touched);
+    const commit = {
+        rooms: [
+            {
+                locator,
+                key: record.key,
+                record: storedRecord(record),
+                roots: record.declaration.typedSelection?.roots ?? [],
+                composed: composedOf(composition),
+                ...settling.commit,
+                ...(overrides === undefined
+                    ? {}
+                    : { confirmed: { set: overrides.set, removed: overrides.removed } }),
+                overlay,
+            },
+        ],
+        writes: [
+            {
+                locator,
+                queue: kept,
+                stored: previousQueue,
+                founded,
+                roomDrafts: [...written.values()],
+                consumedRoomDrafts: carried.taken,
+            },
+            ...carried.writes,
+        ],
+    };
+    const staying = new Set(kept.map((batch) => batch.id));
+    return {
+        locator,
+        left: previousQueue.filter((batch) => !staying.has(batch.id)),
+        commit,
+        apply: (answer) => {
+            for (const batch of previousQueue) {
+                if (!staying.has(batch.id))
+                    store.landed.drop(locator, batch.id);
+            }
+            const drafts = [...written.keys(), ...carried.taken];
+            for (const { batch, landed: held } of unqueued) {
+                const outcome = localSaves ? 'dropped' : held ? 'landed' : 'withdrawn';
+                journal.record(`outcome ${locator} ${batch.id} ${outcome}`);
+            }
+            const changed = answer.changed[locator];
+            if (settling.commit?.published !== undefined ||
+                settling.commit?.refreshed === true ||
+                overrides !== undefined) {
+                confirmedAgain(store, locator);
+            }
+            return mergeChangeSets([
+                changeSet(locator, {
+                    documents: changed === undefined ? [] : changed,
+                    room: settling.room,
+                    queue: queueChanged,
+                    drafts,
+                    unindexed: answer.indexed[locator] === false,
+                    due: kept.length > 0 && settling.refused !== true,
+                }),
+                ...carried.changes,
+            ]);
+        },
+    };
+}
+async function unpairing(runtime, local, locator, batches) {
+    const { store, journal, localSaves } = runtime;
+    const ids = new Set(batches.map(({ id }) => id));
+    const leaving = batches.map((batch) => ({
+        batch,
+        returned: !localSaves && leavingIn(batch, locator) ? returnedBy() : null,
+    }));
+    const outcome = localSaves ? 'dropped' : 'unpaired';
+    const work = await store.work(locator);
+    const current = work.replica;
+    if (current !== undefined) {
+        const settled = await settlement(runtime, local, locator, work, current.record, current.queue.filter((one) => !ids.has(one.id)), { leaving });
+        return {
+            ...settled,
+            apply(answer) {
+                for (const batch of batches)
+                    journal.record(`outcome ${locator} ${batch.id} ${outcome}`);
+                return settled.apply(answer);
+            },
+        };
+    }
+    const queue = work.queue.filter((one) => !ids.has(one.id));
+    const written = await returnedDrafts(store, locator, work, leaving, undefined);
+    const carried = await carriedBack(store, locator, leaving.flatMap(({ batch, returned }) => (returned === null ? [] : [batch])), written);
+    return {
+        locator,
+        left: batches,
+        commit: {
+            rooms: [],
+            writes: [
+                {
+                    locator,
+                    queue,
+                    stored: work.queue,
+                    roomDrafts: [...written.values()],
+                    consumedRoomDrafts: carried.taken,
+                },
+                ...carried.writes,
+            ],
+        },
+        apply() {
+            for (const batch of batches)
+                journal.record(`outcome ${locator} ${batch.id} ${outcome}`);
+            return mergeChangeSets([
+                changeSet(locator, {
+                    queue: true,
+                    drafts: [...written.keys(), ...carried.taken],
+                    due: queue.length > 0,
+                }),
+                ...carried.changes,
+            ]);
+        },
+    };
+}
+async function orphaned(local) {
+    const { queued, moving } = await local.moving();
+    const halves = new Map();
+    for (const { locator, batch, state } of moving) {
+        const partner = partnerOf(batch, locator);
+        if (partner === null || queued.get(partner)?.includes(batch.id) === true)
+            continue;
+        if (unsent(state, batch, locator))
+            halves.set(locator, [...(halves.get(locator) ?? []), batch]);
+    }
+    return halves;
+}
+async function sweep(runtime, local) {
+    if (!runtime.socket.continuing())
+        return;
+    const halves = await orphaned(local);
+    if (halves.size === 0)
+        return;
+    const settlements = [];
+    for (const [locator, batches] of halves) {
+        settlements.push(await unpairing(runtime, local, locator, batches));
+    }
+    void runtime.store.changed(await together(runtime, local, settlements));
+}
+async function settled(runtime, local, settlements, steps) {
+    const set = await together(runtime, local, settlements);
+    for (const step of steps)
+        step();
+    void runtime.store.changed(set);
+    await sweep(runtime, local);
+}
+export function settle(runtime, locators, decide) {
+    const { store } = runtime;
+    return store.exclusive(async () => {
+        const local = await store.open();
+        const held = new Map();
+        for (const locator of locators)
+            held.set(locator, await store.work(locator));
+        const decided = await decide(held);
+        if (decided.length === 0)
+            return;
+        const settlements = [];
+        for (const { locator, record, accepted, adopted, installed, refused } of decided) {
+            const work = held.get(locator) ?? (await store.work(locator));
+            settlements.push(await settlement(runtime, local, locator, work, record, work.queue.filter((batch) => batch.id !== accepted), {
+                room: true,
+                view: installed?.refreshed === true ? 'refreshed' : 'confirmed',
+                ...(installed === undefined ? {} : { commit: installed }),
+                ...(adopted === undefined ? {} : { changes: adopted }),
+                ...(refused === undefined ? {} : { refused }),
+            }));
+        }
+        await settled(runtime, local, settlements, decided.flatMap(({ after }) => (after === undefined ? [] : [after])));
+    });
+}
+export function answered(runtime, locator, head, answer) {
+    const { store, socket } = runtime;
+    return store.exclusive(async () => {
+        if (!socket.continuing())
+            return;
+        const local = await store.open();
+        const work = await store.work(locator);
+        const current = work.replica;
+        if (current === undefined || !current.queue.some((batch) => batch.id === head.id))
+            return;
+        const confirmedLayer = await sliceAt(store, current.record, 'confirmed', [head]);
+        const held = answer.kind === 'conflicted' &&
+            (await landedWhole(store, current.record, head, confirmedLayer, answer.affected));
+        if (held &&
+            partnerOf(head, locator) === null &&
+            !landed(head, confirmedLayer, store.composed(current.record))) {
+            store.landed.hold(locator, head.id, Object.fromEntries([...touchedBy([head])].map((path) => [path, confirmedLayer.revisions[path]])));
+            return;
+        }
+        const returned = {
+            kind: answer.kind,
+            code: answer.code,
+            fields: answer.fields,
+            retryable: answer.retryable,
+        };
+        await settled(runtime, local, [
+            await settlement(runtime, local, locator, work, current.record, current.queue.filter((batch) => batch.id !== head.id), { leaving: [{ batch: head, returned: held ? null : returned }] }),
+        ], []);
+    });
+}
+export function unpair(runtime) {
+    return runtime.store.durably((local) => sweep(runtime, local));
+}
+export async function append(runtime, appending) {
+    const { plan, files, held, after } = appending;
+    if (plan.kind === 'refused')
+        return { outcome: 'refused', ...plan.refusal };
+    const { store } = runtime;
+    const local = await store.open();
+    const rooms = [];
+    const writes = [];
+    for (const { locator, queue, saved, consumed, carried } of plan.rooms) {
+        const { replica, confirmed } = held.get(locator);
+        const { record } = replica;
+        const replayedLayer = await replayed(store, record, confirmed, queue);
+        const { overlay } = await overlayDiff(record, replica, replayedLayer.visible, replayedLayer.touched);
+        rooms.push({
+            locator,
+            key: record.key,
+            roots: record.declaration.typedSelection?.roots ?? [],
+            composed: composedOf(store.composed(record)),
+            overlay,
+        });
+        writes.push({
+            locator,
+            queue,
+            stored: replica.queue,
+            saved,
+            consumedRoomDrafts: consumed,
+            roomDrafts: carried,
+        });
+    }
+    let answer;
+    try {
+        answer = await local.commit({ rooms, writes, files, whole: true });
+    }
+    catch {
+        return { outcome: 'refused', code: 'durable-write', retryable: true };
+    }
+    const lost = answer.fenced ?? plan.rooms.find(({ locator }) => runtime.presence.lost(locator))?.locator;
+    if (lost !== undefined)
+        throw runtimeError('unknown-room', `Unknown Room ${lost}`);
+    const [saving] = plan.rooms;
+    await Promise.all([
+        store.changed(mergeChangeSets(plan.rooms.map(({ locator, consumed, carried }) => changeSet(locator, {
+            documents: answer.changed[locator] ?? [],
+            queue: true,
+            drafts: [...consumed, ...carried.map(({ path }) => path)],
+            unindexed: answer.indexed[locator] === false,
+            due: locator === saving?.locator,
+        })))),
+        after?.(),
+    ]);
+    return { outcome: 'saved', identifier: plan.identifier };
+}

package/dist/reach.d.ts

@@ -1,4 +1,6 @@
-import type { AppRoom, MdRuntime, ReadinessPort, RuntimeTopic } from './connection.js';
+import type { AppRoom } from './listing.js';
+import type { ReadinessPort } from './preparation.js';
+import type { MdRuntime, RuntimeTopic } from './surface.js';
 import type { Plan, PlanReach, QueryResult } from './query.js';
 import type { Readiness } from './readiness.js';
 import type { SearchResult } from './search.js';

package/dist/reach.d.ts.map

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

package/dist/reach.js

@@ -1,7 +1,8 @@
+import { selected } from './collection.js';
 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 { runtimeError, uncaught } 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';
@@ -19,6 +20,15 @@ const NO_CONVERSATION = {
     interrupt: unconversed('conversations/interrupt'),
     kill: unconversed('conversations/kill'),
     delete: unconversed('conversations/delete'),
+    takeOut: unconversed('conversations/take-out'),
+    decide: unconversed('agent-functions/decide'),
+    rename: unconversed('conversations/rename'),
+    option: unconversed('conversations/option/set'),
+    retry: unconversed('conversations/retry'),
+    pins: () => Promise.resolve([]),
+    pin: () => Promise.resolve(),
+    openedTurns: () => Promise.resolve({}),
+    openTurn: () => Promise.resolve(),
 };
 const NO_CHAT_DRAFT = {
     write: () => Promise.resolve(),
@@ -45,11 +55,11 @@ 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 within = (path) => selected({ selection: room.typedSelection }, path);
     const paths = reach.documents
         .filter((document) => document.room === room.locator)
         .map(({ path }) => path);
-    return { collection: paths.some((path) => !selected(path)), selection: paths.some(selected) };
+    return { collection: paths.some((path) => !within(path)), selection: paths.some(within) };
 }
 function covers(reach, room, path) {
     return (reach === null ||
@@ -190,7 +200,7 @@ export function narrowed(runtime, given, port) {
                 shown = shown.then(() => making.then((value) => {
                     if (open)
                         deliver(value);
-                }, () => { }), () => { });
+                }, uncaught), uncaught);
             },
             stop() {
                 open = false;
@@ -225,6 +235,10 @@ export function narrowed(runtime, given, port) {
         };
     }
     const within = (topic, input, deliver, fail) => {
+        if (topic === 'read' && reach !== null) {
+            fail(deviceUnreached());
+            return () => { };
+        }
         if (topic === 'rooms') {
             return following(() => watch(topic, input, (rooms) => deliver(roomsWithin(reach, rooms)), fail));
         }
@@ -310,6 +324,12 @@ export function narrowed(runtime, given, port) {
                 return () => { };
             });
         }
+        if (topic === 'figures' || topic === 'holdings') {
+            if (reach === null)
+                return watch(topic, input, deliver, fail);
+            fail(deviceUnreached());
+            return () => { };
+        }
         return watch(topic, input, deliver, fail);
     };
     const files = new Map();
@@ -425,6 +445,7 @@ export function narrowed(runtime, given, port) {
         cleanUp: () => (reach === null ? md.cleanUp() : Promise.reject(deviceUnreached())),
         unsent: () => (reach === null ? md.unsent() : Promise.reject(deviceUnreached())),
         reset: () => (reach === null ? md.reset() : Promise.reject(deviceUnreached())),
+        readAgain: () => (reach === null ? md.readAgain() : Promise.reject(deviceUnreached())),
         roomDraft: {
             list: async () => unlocked(draftsWithin(reach, await md.roomDraft.list()), await runtime.lockedRooms()),
             async read(room, path) {
@@ -459,10 +480,19 @@ export function narrowed(runtime, given, port) {
             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),
-            delete: (id) => conversation().delete(id),
+            answer: (id, answer, operation) => conversation().answer(id, answer, operation),
+            interrupt: (id, operation) => conversation().interrupt(id, operation),
+            kill: (id, operation) => conversation().kill(id, operation),
+            delete: (id, operation) => conversation().delete(id, operation),
+            takeOut: (id, message, operation) => conversation().takeOut(id, message, operation),
+            decide: (request, decision, operation) => conversation().decide(request, decision, operation),
+            rename: (id, name, operation) => conversation().rename(id, name, operation),
+            option: (id, option, value, operation) => conversation().option(id, option, value, operation),
+            retry: (id, message, operation) => conversation().retry(id, message, operation),
+            pins: () => conversation().pins(),
+            pin: (figures) => conversation().pin(figures),
+            openedTurns: () => conversation().openedTurns(),
+            openTurn: (id, turn) => conversation().openTurn(id, turn),
         },
         chatDraft: {
             write: (id, draft, revision) => chatDraft().write(id, draft, revision),

package/dist/react.d.ts

@@ -1,9 +1,15 @@
 import type { DocumentQuery, GroupQuery } from '@agentshouse/mdmodel';
+import type { Acting, Lane, LaneShown } from './act-lanes.js';
 import type { MdRuntimeClient } from './client.js';
-import type { AppRoom, ConnectionRefusal, SavedRoomDraft, SaveResult } from './connection.js';
+import type { AppRoom } from './listing.js';
+import type { ConnectionRefusal } from './socket.js';
+import type { SavedRoomDraft, SaveResult } from './saves.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 { FiguresResult } from './figures.js';
+import type { Holdings } from './holdings.js';
+import type { Expecting } from './expectation.js';
 import type { QueueEntry } from './outcome.js';
 import type { DocumentResult, GroupResult, PendingResult } from './query.js';
 import type { Readiness } from './readiness.js';
@@ -33,6 +39,17 @@ export declare function useObserve(client: Client, topic: 'presentation'): Obser
 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 declare function useObserve(client: Client, topic: 'figures'): Observed<FiguresResult>;
+export declare function useObserve(client: Client, topic: 'holdings'): Observed<Holdings>;
+export declare function useReading<E extends {
+    readonly key: string;
+}>(store: Pick<Expecting<E>, 'reads' | 'heard' | 'left'>, asks: (one: E) => boolean, shown: ((one: E) => boolean) | null): void;
+export type LaneHeld<O, E extends {
+    readonly key: string;
+}> = LaneShown<O> & Pick<Lane<O, E>, 'run' | 'forget'>;
+export declare function useLane<O, E extends {
+    readonly key: string;
+}>(lanes: Acting<O, E>): LaneHeld<O, E>;
 export type Saving = {
     readonly busy: boolean;
     readonly outcome: SaveResult | null;

package/dist/react.d.ts.map

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

package/dist/react.js

@@ -1,4 +1,4 @@
-import { useCallback, useLayoutEffect, useRef, useState } from 'react';
+import { useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore, } from 'react';
 import { failed } from './failure.js';
 const LOADING = { state: 'loading' };
 export function useObserve(client, topic, ...input) {
@@ -32,6 +32,20 @@ export function useObserve(client, topic, ...input) {
     }, [client, key]);
     return held !== null && held.client === client && held.key === key ? held.observed : LOADING;
 }
+export function useReading(store, asks, shown) {
+    const reader = useId();
+    useLayoutEffect(() => store.reads(reader, asks), [store, reader, asks]);
+    useLayoutEffect(() => () => store.left(reader), [store, reader]);
+    useEffect(() => {
+        if (shown !== null)
+            store.heard(reader, shown);
+    }, [store, reader, shown]);
+}
+export function useLane(lanes) {
+    const lane = useMemo(() => lanes.open(), [lanes]);
+    const shown = useSyncExternalStore(lane.subscribe, lane.shown);
+    return useMemo(() => ({ ...shown, run: lane.run, forget: lane.forget }), [shown, lane]);
+}
 const IDLE = { busy: false, outcome: null, failure: null };
 export function useSave(client) {
     const [state, setState] = useState(IDLE);

package/dist/readiness.d.ts

@@ -24,7 +24,6 @@ export type InstallationAmount = {
 };
 export type Installation = {
     readonly step: InstallationStep | null;
-    readonly rooms: InstallationAmount;
     readonly bytes: InstallationAmount;
 };
 export type ReadinessStatus = Open<'preparing' | 'paused' | 'ready' | 'lost'>;