@agentshouse/mdruntime 0.1.0-cdf06805b9658 → 0.1.0-ce06b735d6c6d

package/README.md

@@ -12,14 +12,14 @@ npm install @agentshouse/mdruntime
 
 ## Entries
 
-| Entry                           | For                                                                                 |
-| ------------------------------- | ----------------------------------------------------------------------------------- |
-| `@agentshouse/mdruntime/client` | The host's client: `connectMdRuntime(port)`                                         |
-| `@agentshouse/mdruntime/host`   | The host that serves a Runtime: `serveMdRuntime`                                    |
-| `@agentshouse/mdruntime`        | Shared types                                                                        |
-| `@agentshouse/mdruntime/memory` | Tests: `createMemoryAdapter`, an in-memory Adapter                                  |
-| `@agentshouse/mdruntime/tables` | The host's database: the Authored store's and opened files' tables, `answerRuntime` |
-| `@agentshouse/mdruntime/react`  | React over the client: `useObserve`, `useSave`                                      |
+| Entry                           | For                                                                                                                                 |
+| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `@agentshouse/mdruntime/client` | The host's client: `connectMdRuntime(port)`                                                                                         |
+| `@agentshouse/mdruntime/host`   | The host that serves a Runtime: `serveMdRuntime`                                                                                    |
+| `@agentshouse/mdruntime`        | Shared types                                                                                                                        |
+| `@agentshouse/mdruntime/memory` | Tests: `createMemoryAdapter`, an in-memory Adapter                                                                                  |
+| `@agentshouse/mdruntime/tables` | The host's database: the Authored store's and opened files' tables, `answerRuntime`                                                 |
+| `@agentshouse/mdruntime/react`  | React over the client: `useObserve`, `useSave`; `useExpected`, a reader of an expectation store; `useLane`, a reader of an act lane |
 
 ## Usage
 
@@ -33,23 +33,26 @@ const rooms = await runtime.rooms();
 const notes = await runtime.query({ types: ['note'], select: 'all', limit: 20 });
 ```
 
-`observe('storage-loss')` reports `null` or the stable code
-`storage-loss` when unsynchronized Room Drafts and Pending Changes were lost.
-The host supplies the user-facing wording.
+`observe('storage-loss')` reports `null`, the stable code `storage-loss` when
+unsynchronized Room Drafts and Pending Changes were lost, or `visit` while the host holds
+the database in memory, which ends with the visit; the readiness `persistence` answer is then
+`memory`. The host supplies the user-facing wording.
 
 In House the bridge object the page holds as `window.houseBridge` places the Chat, which
-House serves with the page: install and bundle nothing for it. Mount it in an element,
-themed by CSS custom properties on that element, docked at a third of the window:
+House serves with the page: install and bundle nothing for it. Mount it in an element it
+fills, where it lays out the User's chats by the element's width, themed by CSS custom
+properties on that element:
 
 ```ts
-const chat = await window.houseBridge.chat.mount(element, { width: '1/3', showChats: true });
+const chat = await window.houseBridge.chat.mount(element, { conversation });
 element.style.setProperty('--chat-accent', '#2a6cf0');
-chat.update({ width: 'full', showChats: true });
+chat.update({ conversation: null, agent });
 chat.unmount();
 ```
 
-The rules an App's agent follows, including Local Query, Local Search, Room
-Draft, Save and the Chat, are in [`AGENTS.md`](AGENTS.md).
+The rules an App's agent follows, including Local Query, search, Room
+Draft, Save and the Chat, are the `apps/` pages of House's Guide, which House's
+`guide/open` opens.
 
 ## License
 

package/dist/acceptance.d.ts

@@ -0,0 +1,3 @@
+import type { Runtime } from './runtime.js';
+export declare function submitLater(runtime: Runtime, locator: string): void;
+//# sourceMappingURL=acceptance.d.ts.map

package/dist/acceptance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance.d.ts","sourceRoot":"","sources":["../src/acceptance.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA0V5C,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,QAK5D"}

package/dist/acceptance.js

@@ -0,0 +1,299 @@
+import { refusalError } from './failure.js';
+import { changeSet } from './change-set.js';
+import { declared } from './declaration.js';
+import { leaving as leavingIn, partnerOf } from './change.js';
+import { olderThan, showing } from './install.js';
+import { scoped } from './models.js';
+import { answered, settle } from './queue.js';
+import { refuse } from './refusal.js';
+import { returnedPaths, returning, slicing } from './replica.js';
+import { batchFile } from './saves.js';
+import { rest, roomUnreadable, statusShown } from './shown.js';
+import { advanced, withhold } from './sync.js';
+import { unconfirmed } from './transfer.js';
+import { stepped } from './turn.js';
+async function mark(runtime, local, locator, batch, submission, lost) {
+    const { store, socket, presence } = runtime;
+    const partner = partnerOf(batch, locator);
+    for (const held of partner === null ? [locator] : [locator, partner]) {
+        const { state, room } = await local.pending(held, batch.id);
+        if (!socket.continuing() ||
+            state === undefined ||
+            (JSON.stringify(state.submission) === JSON.stringify(submission) && state.lost === lost)) {
+            continue;
+        }
+        await local.submit(held, batch.id, submission, lost);
+        if (presence.lost(held))
+            continue;
+        if (room)
+            store.changed(changeSet(held, { queue: true }));
+    }
+    statusShown(runtime);
+}
+async function keepUpload({ socket, presence }, local, locator, identifier, upload) {
+    if (!socket.continuing())
+        throw new Error();
+    await local.keepUpload(locator, identifier, upload);
+    if (presence.lost(locator))
+        throw new Error();
+    if (!socket.continuing())
+        throw new Error();
+}
+function restands(adoptions) {
+    return adoptions.flatMap((one) => (one === null || !('record' in one) ? [] : [one]));
+}
+async function adoption(runtime, room, current, local, submitted, accepted) {
+    const { store, socket } = runtime;
+    if (!socket.continuing())
+        return unconfirmed;
+    if (current === undefined || !current.queue.some((batch) => batch.id === submitted.id)) {
+        return null;
+    }
+    const held = current.record.roomVersion;
+    let record = current.record;
+    let adopted;
+    if (!socket.reads.reached(room.locator, held, accepted.roomVersion) &&
+        !olderThan(runtime, room.locator, accepted.roomVersion, held)) {
+        const paths = [...returnedPaths(submitted, accepted)];
+        const confirmedLayer = await stepped(slicing(await local.entries(record.key, 'confirmed', paths), paths));
+        adopted = await stepped(returning(confirmedLayer, submitted, accepted, accepted.roomVersion, store.composed(record)));
+        record = {
+            ...record,
+            roomVersion: socket.follows(room.locator, held, accepted.roomVersion)
+                ? accepted.roomVersion
+                : held,
+        };
+    }
+    const reached = record.roomVersion;
+    return {
+        locator: room.locator,
+        record,
+        accepted: submitted.id,
+        ...(adopted === undefined ? {} : { adopted }),
+        after() {
+            showing(runtime, room.locator, accepted.roomVersion, reached);
+            runtime.presence.readable(room.locator);
+        },
+    };
+}
+async function adopted(runtime, room, local, submitted, accepted) {
+    let kept = true;
+    await settle(runtime, [room.locator], async (held) => {
+        const adopting = await adoption(runtime, room, held.get(room.locator)?.replica, local, submitted, accepted);
+        kept = adopting !== unconfirmed;
+        return restands([adopting]);
+    });
+    return kept;
+}
+async function adoptedMove(runtime, room, partner, local, submitted, accepted) {
+    const other = runtime.presence.room(partner);
+    let kept = true;
+    await settle(runtime, [room.locator, partner], async (held) => {
+        const left = await adoption(runtime, room, held.get(room.locator)?.replica, local, submitted, accepted);
+        const there = held.get(partner)?.replica;
+        const arriving = there?.queue.find((batch) => batch.id === submitted.id);
+        const arrived = other === undefined || arriving === undefined || accepted.destination === undefined
+            ? null
+            : await adoption(runtime, other, there, local, arriving, {
+                kind: 'accepted',
+                ...accepted.destination,
+            });
+        kept = left !== unconfirmed;
+        return restands([left, arrived]);
+    });
+    submitLater(runtime, partner);
+    return kept;
+}
+async function behindIn({ store }, locator, batch) {
+    const local = await store.open();
+    const [order, { room }] = await Promise.all([
+        local.order(locator),
+        local.pending(locator, batch.id),
+    ]);
+    return room ? order.indexOf(batch.id) > 0 : order.length > 0;
+}
+async function submitRoom(runtime, room, local, authorized, progress, signal) {
+    const { store, socket, presence } = runtime;
+    while (socket.continuing() &&
+        socket.session.now().authorization !== undefined &&
+        !signal.aborted) {
+        const headId = (await local.order(room.locator)).find((id) => store.landed.of(room.locator, id) === undefined);
+        if (headId === undefined)
+            return 'done';
+        const [head, pending] = await Promise.all([
+            local.batch(room.locator, headId),
+            local.pending(room.locator, headId),
+        ]);
+        if (head === null || !pending.room)
+            return 'done';
+        const { state } = pending;
+        const partner = partnerOf(head, room.locator);
+        if (partner !== null && !leavingIn(head, room.locator)) {
+            submitLater(runtime, partner);
+            return 'done';
+        }
+        if (partner !== null && (await behindIn(runtime, partner, head))) {
+            progress.complete = false;
+            return 'done';
+        }
+        const { submission, lost: earlier } = state ?? {
+            submission: { state: 'waiting' },
+            lost: false,
+        };
+        if (submission.state === 'reset' && Date.now() < Date.parse(submission.reset)) {
+            progress.complete = false;
+            return { at: Date.parse(submission.reset) };
+        }
+        if (socket.writesHeld()) {
+            progress.complete = false;
+            return 'done';
+        }
+        const lost = earlier || submission.state === 'submitted';
+        let result;
+        await store.exclusive(() => mark(runtime, local, room.locator, head, { state: 'submitted' }, lost));
+        if (socket.session.now().paused || presence.lost(room.locator))
+            return 'done';
+        if (signal.aborted || socket.writesHeld()) {
+            await store.exclusive(() => mark(runtime, local, room.locator, head, submission, earlier));
+            if (signal.aborted)
+                return 'done';
+            progress.complete = false;
+            return 'done';
+        }
+        const opensBefore = socket.session.now().openSignals;
+        const answeredHere = socket.awaitingAnswer(room.locator);
+        const answeredThere = partner === null ? () => { } : socket.awaitingAnswer(partner);
+        const heard = () => {
+            answeredHere();
+            answeredThere();
+        };
+        try {
+            result = await socket.mutate(authorized, {
+                locator: room.locator,
+                changeBatch: head,
+                file: batchFile(store, head),
+                ...(state?.upload === undefined ? {} : { upload: state.upload }),
+            }, (upload) => store.exclusive(() => keepUpload(runtime, local, room.locator, head.id, upload)));
+        }
+        catch (error) {
+            runtime.retries.failed('sending', submitting(room.locator), error);
+            heard();
+            progress.complete = false;
+            if (socket.continuing())
+                progress.reachable = false;
+            return 'again';
+        }
+        if (signal.aborted) {
+            heard();
+            return 'done';
+        }
+        if (result.kind !== 'accepted' || !socket.continuing())
+            heard();
+        if (!socket.continuing())
+            return 'done';
+        if (result.kind === 'accepted')
+            runtime.retries.succeeded('sending', submitting(room.locator));
+        if (result.kind === 'transport-uncertainty') {
+            runtime.retries.uncertain('sending', submitting(room.locator), result);
+            progress.complete = false;
+            progress.reachable = false;
+            return 'again';
+        }
+        if (result.kind === 'room-not-readable') {
+            progress.complete = false;
+            roomUnreadable(runtime, (presence.room(result.locator) ?? room).locator);
+            return 'done';
+        }
+        if (result.kind === 'revoked-authorization') {
+            await refuse(runtime, 'revoked-authorization');
+            return 'done';
+        }
+        if (result.kind === 'scoped-refusal') {
+            await scoped(runtime, result, room.locator, declared(room));
+            progress.complete = false;
+            return 'done';
+        }
+        if (result.kind === 'write-halted') {
+            await store.exclusive(() => mark(runtime, local, room.locator, head, { state: 'waiting' }, lost));
+            if (!socket.haltedSince(opensBefore))
+                continue;
+            progress.complete = false;
+            return 'done';
+        }
+        const other = partner === null ? undefined : presence.room(partner);
+        if (result.kind === 'retryable-refusal') {
+            runtime.retries.failed('sending', submitting(room.locator), refusalError(result));
+            const reset = result.reset;
+            progress.complete = false;
+            await store.exclusive(() => mark(runtime, local, room.locator, head, reset === undefined ? { state: 'waiting' } : { state: 'reset', reset }, lost));
+            return reset === undefined ? 'again' : { at: Date.parse(reset) };
+        }
+        if (result.kind === 'conflicted' || result.kind === 'rejected') {
+            const refreshed = async () => ({
+                there: other === undefined ? null : await advanced(runtime, other, local, authorized),
+                here: await advanced(runtime, room, local, authorized),
+            });
+            const judged = result.kind === 'conflicted' && other !== undefined ? await refreshed() : null;
+            if (judged !== null && (judged.there !== null || judged.here !== null)) {
+                await store.exclusive(() => mark(runtime, local, room.locator, head, { state: 'waiting' }, lost));
+                if (other !== undefined && judged.there !== null) {
+                    await withhold(runtime, judged.there, other, local, progress);
+                }
+                if (judged.here !== null)
+                    await withhold(runtime, judged.here, room, local, progress);
+                return 'done';
+            }
+            await answered(runtime, room.locator, head, result);
+            const { there, here } = judged ?? (await refreshed());
+            if (other !== undefined && there !== null) {
+                await withhold(runtime, there, other, local, progress);
+            }
+            if (here !== null) {
+                await withhold(runtime, here, room, local, progress);
+                return 'done';
+            }
+            continue;
+        }
+        const kept = await (partner === null
+            ? adopted(runtime, room, local, head, result)
+            : adoptedMove(runtime, room, partner, local, head, result)).finally(heard);
+        if (!kept) {
+            progress.complete = false;
+            return 'done';
+        }
+    }
+    return 'done';
+}
+function submitting(locator) {
+    return `submit ${locator}`;
+}
+export function submitLater(runtime, locator) {
+    if (runtime.localSaves)
+        return;
+    void runtime.recovery.attempt(submitting(locator), (signal) => submitPass(runtime, locator, signal));
+}
+async function submitPass(runtime, locator, signal) {
+    const { store, socket, presence } = runtime;
+    const room = presence.room(locator);
+    if (!socket.continuing() || socket.stopping() || room === undefined) {
+        return 'done';
+    }
+    const progress = { complete: true, reachable: true };
+    let next;
+    try {
+        await socket.authorize();
+        const { authorization } = socket.session.now();
+        if (authorization === undefined)
+            return 'done';
+        next = await submitRoom(runtime, room, await store.open(), authorization, progress, signal);
+    }
+    catch (error) {
+        runtime.retries.failed('sending', submitting(locator), error);
+        progress.reachable = false;
+        next = 'again';
+    }
+    if (signal.aborted)
+        return 'done';
+    await rest(runtime, progress);
+    return next === 'again' && !socket.isOpen() ? 'done' : next;
+}

package/dist/act-lanes.d.ts

@@ -0,0 +1,30 @@
+import { type Expected, type Expecting } from './expectation.js';
+export type Ended = 'accepted' | 'refused' | 'unanswered' | 'unsent';
+export type Send<O> = {
+    (name: string, input: unknown, sending: (operation: string) => Promise<O>): Promise<O>;
+    expect(expected: Expected): void;
+};
+export type LaneShown<O> = {
+    readonly busy: boolean;
+    readonly drawn: boolean;
+    readonly ended: O | null;
+};
+export type Lane<O> = {
+    run(steps: (send: Send<O>) => Promise<O>, expected?: Expected): Promise<O>;
+    shown(): LaneShown<O>;
+    subscribe(listener: () => void): () => void;
+    forget(): void;
+};
+export type Acting<O> = {
+    open(): Lane<O>;
+};
+export type ActingRules<O> = {
+    readonly store: Pick<Expecting, 'begin' | 'expect' | 'drop'>;
+    readonly uncertain: O;
+    ending(outcome: O): Ended;
+    acted?(): void;
+    mint?(): string;
+    settles?(operation: string): Promise<boolean>;
+};
+export declare function acting<O>(rules: ActingRules<O>): Acting<O>;
+//# sourceMappingURL=act-lanes.d.ts.map

package/dist/act-lanes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"act-lanes.d.ts","sourceRoot":"","sources":["../src/act-lanes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG/E,MAAM,MAAM,KAAK,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;AAErE,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI;IACpB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvF,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI;IACpB,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3E,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC;IACtB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,MAAM,IAAI,IAAI,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;IACtB,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;IAC7D,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IACtB,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC;IAC1B,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,IAAI,CAAC,IAAI,MAAM,CAAC;IAChB,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/C,CAAC;AAUF,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CA6N1D"}

package/dist/act-lanes.js

@@ -0,0 +1,225 @@
+import { expectedList } from './expectation.js';
+import { changeBatchIdentity } from './identity.js';
+const IDLE = { busy: false, drawn: false, ended: null };
+export function acting(rules) {
+    const { store, uncertain, ending, settles } = rules;
+    const mint = rules.mint ?? (() => changeBatchIdentity());
+    const identities = new Map();
+    const waiting = new Map();
+    const settling = new Map();
+    const blobs = new WeakMap();
+    let counted = 0;
+    let touches = 0;
+    const requestOf = (name, input) => {
+        const carried = [];
+        const json = JSON.stringify(input, (_key, value) => {
+            if (!(value instanceof Blob))
+                return value;
+            let one = blobs.get(value);
+            if (one === undefined) {
+                counted += 1;
+                one = counted;
+                blobs.set(value, one);
+            }
+            carried.push(one);
+            return null;
+        });
+        return `${name}\u0000${json}\u0000${carried.join(',')}`;
+    };
+    const identityOf = (request) => {
+        const held = identities.get(request);
+        if (held !== undefined)
+            return held;
+        const fresh = { operation: mint(), touched: 0, flying: 0 };
+        identities.set(request, fresh);
+        return fresh;
+    };
+    const settled = (act, ended, calls) => {
+        const released = new Map();
+        for (const { request, identity, ended: answered } of calls) {
+            const heard = answered === 'accepted' || answered === 'refused';
+            if (ended === 'accepted' && heard)
+                released.set(request, identity.touched);
+            else {
+                touches += 1;
+                identity.touched = touches;
+                identities.set(request, identity);
+            }
+        }
+        if (ended === 'refused' || ended === 'unsent')
+            store.drop(act);
+        for (const { request, ended: answered } of calls) {
+            const earlier = waiting.get(request);
+            if (answered === 'unsent' && earlier !== undefined)
+                continue;
+            if (earlier !== undefined && earlier !== act)
+                store.drop(earlier);
+            if (ended === 'unanswered')
+                waiting.set(request, act);
+            else
+                waiting.delete(request);
+        }
+        if (ended === 'accepted' || calls.some((one) => one.ended === 'accepted'))
+            rules.acted?.();
+        return released;
+    };
+    const release = (released) => {
+        for (const [request, touched] of released) {
+            const held = identities.get(request);
+            if (held !== undefined && held.touched === touched && held.flying === 0) {
+                identities.delete(request);
+            }
+        }
+    };
+    return {
+        open() {
+            const listeners = new Set();
+            const releasing = new Map();
+            let tail = Promise.resolve();
+            let pressed = 0;
+            let drawing = 0;
+            let ended = null;
+            let held = null;
+            let presses = 0;
+            let shown = IDLE;
+            const show = () => {
+                const busy = pressed > 0;
+                const drawn = drawing > 0;
+                if (shown.busy === busy && shown.drawn === drawn && shown.ended === ended)
+                    return;
+                shown = { busy, drawn, ended };
+                for (const listener of listeners)
+                    listener();
+            };
+            const awaiting = (outcome, operations, heard, again) => new Promise((resolve) => {
+                const forgotten = () => {
+                    for (const operation of operations)
+                        if (settling.get(operation) === record)
+                            settling.delete(operation);
+                };
+                const record = {
+                    supersede() {
+                        if (held !== record)
+                            return;
+                        held = null;
+                        forgotten();
+                        resolve(outcome);
+                    },
+                };
+                held = record;
+                for (const operation of operations)
+                    settling.set(operation, record);
+                const answers = operations.map((operation) => heard(operation).then((answered) => {
+                    if (!answered)
+                        record.supersede();
+                    return answered;
+                }));
+                void Promise.all(answers).then(() => {
+                    if (held !== record)
+                        return;
+                    held = null;
+                    forgotten();
+                    resolve(again());
+                }, () => record.supersede());
+            });
+            const attempt = (steps, expected, press) => {
+                const act = store.begin();
+                let drew = false;
+                const expect = (more) => {
+                    if (expectedList(more).length === 0)
+                        return;
+                    store.expect(act, more);
+                    if (drew)
+                        return;
+                    drew = true;
+                    drawing += 1;
+                    show();
+                };
+                pressed += 1;
+                expect(expected);
+                show();
+                const calls = [];
+                const send = Object.assign(async (name, input, sending) => {
+                    const request = requestOf(name, input);
+                    const identity = identityOf(request);
+                    settling.get(identity.operation)?.supersede();
+                    const called = { request, identity, ended: null };
+                    calls.push(called);
+                    touches += 1;
+                    identity.touched = touches;
+                    identity.flying += 1;
+                    let outcome;
+                    try {
+                        outcome = await sending(identity.operation);
+                    }
+                    catch {
+                        outcome = uncertain;
+                    }
+                    finally {
+                        identity.flying -= 1;
+                    }
+                    called.ended = ending(outcome);
+                    return outcome;
+                }, { expect });
+                const end = (outcome, how) => {
+                    for (const [request, touched] of settled(act, how, calls))
+                        releasing.set(request, touched);
+                    pressed -= 1;
+                    if (drew)
+                        drawing -= 1;
+                    ended = outcome;
+                    if (pressed === 0) {
+                        release(releasing);
+                        releasing.clear();
+                    }
+                    show();
+                };
+                const turn = tail.then(async () => {
+                    ended = null;
+                    show();
+                    let outcome;
+                    try {
+                        outcome = await steps(send);
+                    }
+                    catch (error) {
+                        end(uncertain, 'unanswered');
+                        throw error;
+                    }
+                    const how = ending(outcome);
+                    end(outcome, how);
+                    return { outcome, how };
+                });
+                tail = turn.catch(() => undefined);
+                return turn.then(({ outcome, how }) => {
+                    const lost = calls.flatMap(({ identity, ended: answered }) => answered === 'unanswered' ? [identity.operation] : []);
+                    if (how !== 'unanswered' || lost.length === 0 || settles === undefined)
+                        return outcome;
+                    if (press !== presses)
+                        return outcome;
+                    return awaiting(outcome, lost, settles, () => attempt(steps, expected, press));
+                });
+            };
+            const run = (steps, expected = null) => {
+                held?.supersede();
+                presses += 1;
+                return attempt(steps, expected, presses);
+            };
+            return {
+                run,
+                shown: () => shown,
+                subscribe(listener) {
+                    listeners.add(listener);
+                    return () => {
+                        listeners.delete(listener);
+                    };
+                },
+                forget() {
+                    if (pressed > 0 || ended === null)
+                        return;
+                    ended = null;
+                    show();
+                },
+            };
+        },
+    };
+}

package/dist/actions.d.ts

@@ -0,0 +1,26 @@
+import type { ConversationHistoryRequest } from './adapter.js';
+import { type CallResult, type HistoryAnswer, type Resolution } from './outcome.js';
+import type { Attempted } from './recovery.js';
+import type { Attempt } from './retried.js';
+import type { Runtime } from './runtime.js';
+export type HistoryQuery = {
+    revision?: string;
+    pageToken?: string;
+};
+export declare function readHistory(runtime: Runtime, locator: string, path: string, query?: HistoryQuery): Promise<HistoryAnswer>;
+export declare function located(runtime: Runtime, room: string, path: string, destination: string): Promise<{
+    room: string;
+    path: string;
+} | null>;
+export declare function resolveReference(runtime: Runtime, room: string, path: string, destination: string): Promise<Resolution>;
+export type Invoked = {
+    readonly dispatching?: () => Promise<void>;
+    readonly attempt?: Attempt;
+};
+export declare function invokeAction(runtime: Runtime, name: string, input: unknown, { dispatching, attempt }?: Invoked): Promise<CallResult>;
+export declare function readConversationHistory(runtime: Runtime, request: ConversationHistoryRequest): Promise<CallResult>;
+export declare function called(runtime: Runtime, name: string, input: unknown, attempt?: Attempt): Promise<CallResult>;
+export declare function answeredCall(runtime: Runtime, operation: string): Promise<boolean>;
+export declare function resendCalls(runtime: Runtime, signal: AbortSignal): Promise<Attempted>;
+export declare function resendLater(runtime: Runtime): void;
+//# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAM/D,OAAO,EAWL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAOF,wBAAsB,WAAW,CAC/B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,YAAiB,GACvB,OAAO,CAAC,aAAa,CAAC,CA+BxB;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAShD;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CAuBrB;AAwBD,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,EAAE,WAAW,EAAE,OAAO,EAAE,GAAE,OAAY,GACrC,OAAO,CAAC,UAAU,CAAC,CA6BrB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,UAAU,CAAC,CAerB;AA4GD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,UAAU,CAAC,CAKrB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAaxF;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAe3F;AAiBD,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,QAG3C"}