@agentshouse/mdruntime 0.1.0-cb1f56e16291b → 0.1.0-cb3bb3b233fa1

package/dist/reach.js

@@ -1,8 +1,10 @@
+import { QueryError } from '@agentshouse/mdmodel';
+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 { failure, lockedRoom, ROOM_LOCKED, undeclared, UNREADABLE, } from './outcome.js';
+import { changeOf, digestApplied, digestOf, observing, unchanged, } from './observation.js';
+import { runtimeError, uncaught } from './failure.js';
+import { absentBinary, 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';
@@ -19,10 +21,21 @@ 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'),
+    pin: () => Promise.resolve(),
+    openTurn: () => Promise.resolve(),
+    dismissSuggestion: () => Promise.resolve(),
+    attach: () => Promise.resolve(undeclared('conversation.attach')),
+    attachment: (link) => Promise.resolve(absentBinary(link)),
 };
 const NO_CHAT_DRAFT = {
     write: () => Promise.resolve(),
     prepend: () => Promise.resolve(),
+    append: () => Promise.resolve(),
     discard: () => Promise.resolve(),
 };
 function areasOf(reach) {
@@ -45,11 +58,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 ||
@@ -60,6 +73,19 @@ function covers(reach, room, path) {
 function conversing(reach) {
     return reach === null || reach.conversations;
 }
+function roomsAwaited(error, reach) {
+    return error.code === 'unknown-type' && reach !== null && reach.rooms.length === 0;
+}
+async function planInReach(runtime, input, reach, answered) {
+    try {
+        return await runtime.plan(input, reach);
+    }
+    catch (error) {
+        if (error instanceof QueryError && (answered || roomsAwaited(error, reach)))
+            return null;
+        throw error;
+    }
+}
 export function planReach(reach) {
     return reach === null
         ? null
@@ -76,6 +102,14 @@ export function planReach(reach) {
 function roomsWithin(reach, rooms) {
     return rooms.filter((room) => wholly(reach, room.locator));
 }
+function roomsChangeWithin(reach, { changed, removed, order }) {
+    const within = {
+        changed: changed.filter(([locator]) => wholly(reach, locator)),
+        removed,
+        order: order === null ? null : order.filter((locator) => wholly(reach, locator)),
+    };
+    return unchanged(within) ? null : within;
+}
 function typesWithin(reach, room, types) {
     if (room === undefined)
         return structuredClone(UNHELD_TYPES);
@@ -105,12 +139,13 @@ function writeWithin(reach, write) {
 function savedWithin(reach, room, result) {
     if (reach === null || result.outcome === 'saved')
         return result;
-    const { file, location, referrers, ...refusal } = result;
+    const { file, location, line, referrers, ...refusal } = result;
     const hidden = file !== undefined && !covers(reach, room, file);
     return {
         ...refusal,
         ...(file === undefined || hidden ? {} : { file }),
         ...(location === undefined || hidden ? {} : { location }),
+        ...(line === undefined || hidden ? {} : { line }),
         ...(referrers === undefined
             ? {}
             : { referrers: referrers.filter((path) => covers(reach, room, path)) }),
@@ -143,7 +178,7 @@ 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');
+    return runtimeError('device-unreached', 'Only the panel reaches this device');
 }
 const ATTACH_REQUIRED = 'attach-required';
 function attachRequired() {
@@ -152,10 +187,9 @@ function attachRequired() {
 function carriesFile(parts) {
     return parts !== null && typeof parts === 'object' && Object.hasOwn(parts, 'file');
 }
-export function narrowed(runtime, given, told) {
+export function narrowed(runtime, given, port) {
     const { md, watch } = runtime;
     let reach = given;
-    let port = told;
     const open = new Set();
     function following(begin, locking = false) {
         let stop = begin();
@@ -171,71 +205,137 @@ export function narrowed(runtime, given, told) {
             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 unlocking = (rooms, locked) => {
+        const held = (rooms ?? []).filter((room) => locked.includes(room));
+        return held.length === 0 ? null : { pending: held.map((room) => ({ room, awaits: 'unlock' })) };
+    };
+    const unlocked = (entries, locked) => entries.filter((entry) => !locked.includes(entry.room));
+    const intoLocked = async (held) => {
+        for (const move of held) {
+            if (move?.room !== undefined && (await runtime.locked(move.room)))
+                return true;
+        }
+        return false;
     };
-    const unlocked = (entries) => entries.filter((entry) => !runtime.locked(entry.room));
-    const intoLocked = (held) => held.some((move) => move?.room !== undefined && runtime.locked(move.room));
+    function ordered(deliver) {
+        let open = true;
+        let shown = Promise.resolve();
+        return {
+            push(making) {
+                shown = shown.then(() => making.then((value) => {
+                    if (open)
+                        deliver(value);
+                }, uncaught), uncaught);
+            },
+            stop() {
+                open = false;
+            },
+        };
+    }
+    function unlockedWatch(topic, input, deliver, fail, within) {
+        const shown = ordered(deliver);
+        const stop = watch(topic, input, (message) => {
+            shown.push(runtime.lockedRooms().then((locked) => within(message, locked)));
+        }, fail);
+        return () => {
+            shown.stop();
+            stop();
+        };
+    }
+    function lockedFirst(room, start, shut) {
+        let open = true;
+        let stop = () => { };
+        void (async () => {
+            const closed = !holds(reach, room) || (await runtime.locked(room));
+            if (!open)
+                return;
+            if (closed)
+                shut();
+            else
+                stop = start();
+        })();
+        return () => {
+            open = false;
+            stop();
+        };
+    }
     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));
+            return following(() => watch(topic, input, (rooms) => {
+                const shown = Array.isArray(rooms)
+                    ? roomsWithin(reach, rooms)
+                    : roomsChangeWithin(reach, rooms);
+                if (shown !== null)
+                    deliver(shown);
+            }, fail));
         }
         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) });
-            }, fail), true);
+            return following(() => unlockedWatch(topic, input, deliver, fail, (status, locked) => {
+                const shown = statusWithin(reach, status);
+                return { ...shown, attentionRequired: unlocked(shown.attentionRequired, locked) };
+            }), true);
         }
         if (topic === 'room-drafts') {
-            return following(() => watch(topic, input, (drafts) => deliver(unlocked(draftsWithin(reach, drafts))), fail), true);
+            return following(() => unlockedWatch(topic, input, deliver, fail, (drafts, locked) => unlocked(draftsWithin(reach, drafts), locked)), 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)), fail);
-            }, true);
+            return following(() => lockedFirst(room, () => watch(topic, input, (entries) => deliver(queueWithin(reach, room, entries)), fail), () => deliver([])), true);
         }
         if (topic === 'query') {
-            const plan = runtime.plan(input[0], reach);
             let held = null;
+            let planning = null;
+            const waiting = (result) => {
+                const answer = { result, keys: [] };
+                if (held === null || changeOf(held, answer) !== null)
+                    deliver(answer);
+                held = digestOf(answer);
+            };
             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);
+                let stop = () => { };
+                if (planning?.reach !== reach) {
+                    planning = { reach, plan: planInReach(runtime, input[0], reach, held !== null) };
+                }
+                const planned = planning.plan;
+                void (async () => {
+                    const plan = await planned;
+                    const locked = await runtime.lockedRooms();
+                    if (!open)
                         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);
-                }, (error) => {
+                    if (plan === null)
+                        return waiting({ pending: [] });
+                    const pending = unlocking(plan.rooms, locked);
+                    if (pending !== null)
+                        return waiting(pending);
+                    let first = 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);
+                    };
+                    stop = runtime.watchPlan({ ...plan, locked }, (message) => {
+                        if (open)
+                            heard(message);
+                    }, (error) => {
+                        if (open)
+                            fail(error);
+                    });
+                })().catch((error) => {
                     if (open)
                         fail(error);
                 });
@@ -261,6 +361,15 @@ export function narrowed(runtime, given, told) {
                 return () => { };
             });
         }
+        if (topic === 'figures' ||
+            topic === 'holdings' ||
+            topic === 'listed-agents' ||
+            topic === 'room-list') {
+            if (reach === null)
+                return watch(topic, input, deliver, fail);
+            fail(deviceUnreached());
+            return () => { };
+        }
         return watch(topic, input, deliver, fail);
     };
     const files = new Map();
@@ -279,31 +388,35 @@ export function narrowed(runtime, given, told) {
     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() }));
+        query: (async (input) => {
+            const plan = await planInReach(runtime, input, reach, false);
+            if (plan === null)
+                return { pending: [] };
+            const locked = await runtime.lockedRooms();
+            return unlocking(plan.rooms, locked) ?? runtime.query({ ...plan, locked });
         }),
         search: (input) => runtime.search(input, reach),
-        types(room) {
-            if (holds(reach, room) && runtime.locked(room))
+        async types(room) {
+            if (holds(reach, room) && (await 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));
+            return typesWithin(reach, await runtime.room(room), await md.types(room));
         },
         async save(room, roomDrafts, writtenBy) {
             if (!holds(reach, room))
                 throw unreached(room);
-            if (runtime.locked(room))
+            if (await 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))
+            if (await intoLocked(held))
                 return { outcome: 'refused', code: ROOM_LOCKED, retryable: true };
             return savedWithin(reach, room, await md.save(room, roomDrafts, writtenBy));
         },
@@ -314,47 +427,48 @@ export function narrowed(runtime, given, told) {
             if (filed !== undefined) {
                 return { outcome: 'refused', code: ATTACH_REQUIRED, retryable: false, file: filed.path };
             }
-            if (runtime.locked(room))
+            if (await runtime.locked(room)) {
                 return { outcome: 'refused', code: ROOM_LOCKED, retryable: true };
+            }
             const held = parts.map(({ path, parts: one }) => readParts(one, path).move);
             if (parts.some(({ path }, at) => !covers(reach, room, path) || !moves(reach, room, held[at]))) {
                 throw unreached(room);
             }
-            if (intoLocked(held))
+            if (await 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);
+        async resolve(room, path, destination) {
+            const at = await runtime.located(room, path, destination);
             return at !== null && !covers(reach, at.room, at.path)
-                ? Promise.resolve(UNREADABLE)
+                ? 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))
+        history: async (room, path, query) => !covers(reach, room, path)
+            ? failure({ kind: 'room-not-readable', locator: room })
+            : (await runtime.locked(room))
+                ? 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))
+            read: async (room, path, revision) => !covers(reach, room, path)
+                ? failure({ kind: 'room-not-readable', locator: room })
+                : (await runtime.locked(room))
+                    ? 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))
+            link: async (room, path, revision) => !covers(reach, room, path)
+                ? failure({ kind: 'room-not-readable', locator: room })
+                : (await runtime.locked(room))
+                    ? 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))
+            show: async (room, path, revision) => !covers(reach, room, path)
+                ? failure({ kind: 'room-not-readable', locator: room })
+                : (await runtime.locked(room))
+                    ? 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))
+            attach: async (room, file) => !wholly(reach, room)
+                ? failure({ kind: 'room-not-readable', locator: room })
+                : (await runtime.locked(room))
+                    ? lockedRoom(room)
                     : md.binaryFile.attach(room, file),
             async part(file, part) {
                 const key = files.get(file);
@@ -367,42 +481,37 @@ export function narrowed(runtime, given, told) {
             },
         },
         reached: async (room, roomVersion, path) => (path === undefined ? wholly(reach, room) : covers(reach, room, path)) &&
-            !runtime.locked(room) &&
+            !(await runtime.locked(room)) &&
             (await md.reached(room, roomVersion, path)),
-        log: () => (reach === null ? md.log() : ''),
         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: () => md.roomDraft.list().then((drafts) => unlocked(draftsWithin(reach, drafts))),
+            list: async () => unlocked(draftsWithin(reach, await md.roomDraft.list()), await runtime.lockedRooms()),
             async read(room, path) {
                 if (!covers(reach, room, path))
                     return null;
-                if (runtime.locked(room))
+                if (await 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, path).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 write(room, path, revision, parts, next) {
+                if (reach !== null && carriesFile(parts))
+                    throw attachRequired();
+                const move = readParts(parts, path).move;
+                if (!covers(reach, room, path) || !moves(reach, room, move))
+                    throw unreached(room);
+                if (await runtime.locked(room))
+                    throw lockedError(room);
+                if (await intoLocked([move]))
+                    throw lockedError(move.room);
+                return writeWithin(reach, await md.roomDraft.write(room, path, revision, parts, next));
             },
             async discard(room, path, revision) {
                 if (!covers(reach, room, path))
                     return staleWrite(null);
-                if (runtime.locked(room))
+                if (await runtime.locked(room))
                     throw lockedError(room);
                 return writeWithin(reach, await md.roomDraft.discard(room, path, revision));
             },
@@ -412,14 +521,25 @@ export function narrowed(runtime, given, told) {
             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),
+            pin: (figures) => conversation().pin(figures),
+            openTurn: (id, turn) => conversation().openTurn(id, turn),
+            dismissSuggestion: (id, suggestion) => conversation().dismissSuggestion(id, suggestion),
+            attach: (file) => conversation().attach(file),
+            attachment: (link) => conversation().attachment(link),
         },
         chatDraft: {
             write: (id, draft, revision) => chatDraft().write(id, draft, revision),
             prepend: (id, draft) => chatDraft().prepend(id, draft),
+            append: (id, draft) => chatDraft().append(id, draft),
             discard: (id) => chatDraft().discard(id),
         },
         observe: observing(within),
@@ -432,10 +552,5 @@ export function narrowed(runtime, given, told) {
             for (const restart of [...open])
                 restart();
         },
-        facts(next) {
-            port = next;
-            for (const restart of [...open])
-                restart();
-        },
     };
 }

package/dist/react.d.ts

@@ -1,10 +1,17 @@
+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 { Member, ServiceMode } from './adapter.js';
+import type { AppRoom } from './listing.js';
+import type { ConnectionRefusal } from './socket.js';
+import type { SavedRoomDraft, SaveResult } from './saves.js';
+import type { ListedAgent, Member, RoomList, 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 { Descriptor, Expecting } from './expectation.js';
 import type { QueueEntry } from './outcome.js';
-import type { DocumentQuery, DocumentResult, GroupQuery, GroupResult, PendingResult } from './query.js';
+import type { DocumentResult, 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';
@@ -32,6 +39,13 @@ 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: 'listed-agents'): Observed<readonly ListedAgent[]>;
+export declare function useObserve(client: Client, topic: 'room-list'): Observed<RoomList | null>;
+export declare function useObserve(client: Client, topic: 'figures'): Observed<FiguresResult>;
+export declare function useObserve(client: Client, topic: 'holdings'): Observed<Holdings>;
+export declare function useExpected<A, T>(store: Expecting, descriptor: Descriptor<A, T>, places: readonly A[], held: ReadonlyMap<A, T> | null): (place: A, held: T) => T;
+export type LaneHeld<O> = LaneShown<O> & Pick<Lane<O>, 'run' | 'forget'>;
+export declare function useLane<O>(lanes: Acting<O>): LaneHeld<O>;
 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,38 @@ export function useObserve(client, topic, ...input) {
     }, [client, key]);
     return held !== null && held.client === client && held.key === key ? held.observed : LOADING;
 }
+function sameHeld(descriptor, was, now) {
+    if (was === now)
+        return true;
+    if (was === null || now === null || was.size !== now.size)
+        return false;
+    const before = new Map([...was].map(([place, value]) => [descriptor.place(place), value]));
+    return [...now].every(([place, value]) => {
+        const at = descriptor.place(place);
+        return before.has(at) && Object.is(before.get(at), value);
+    });
+}
+export function useExpected(store, descriptor, places, held) {
+    const reader = useId();
+    const version = useSyncExternalStore(store.subscribe, store.version);
+    const asked = JSON.stringify(places.map((one) => descriptor.place(one)));
+    const kept = useRef(held);
+    if (!sameHeld(descriptor, kept.current, held))
+        kept.current = held;
+    const shown = kept.current;
+    useLayoutEffect(() => store.reads(reader, descriptor, places), [store, reader, descriptor, asked]);
+    useLayoutEffect(() => () => store.left(reader), [store, reader]);
+    useEffect(() => {
+        if (shown !== null)
+            store.heard(reader, descriptor, shown);
+    }, [store, reader, descriptor, shown]);
+    return useCallback((place, value) => store.draw(descriptor, place, value), [store, descriptor, version]);
+}
+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/read.d.ts

@@ -0,0 +1,7 @@
+export type Fields = Readonly<Record<string, unknown>>;
+export declare const EXCERPT = 512;
+export declare function excerpt(said: string): string;
+export declare function record(entry: unknown): Fields;
+export declare function text(fields: Fields, name: string): string | null;
+export declare function list(fields: Fields, name: string): readonly unknown[];
+//# sourceMappingURL=read.d.ts.map

package/dist/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEvD,eAAO,MAAM,OAAO,MAAM,CAAC;AAE3B,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI7C;AAED,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhE;AAED,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,OAAO,EAAE,CAGrE"}