@agentshouse/mdruntime 0.1.0-cee9c8aa4cd86 → 0.1.0-cef76ea952695

package/dist/live.js

@@ -1,4 +1,5 @@
 import { changeOf, digestOf, } from './observation.js';
+import { uncaught } from './failure.js';
 import { roomOfKey } from './rows.js';
 function narrowed(plan) {
     return (plan.paths !== null &&
@@ -22,13 +23,15 @@ function affected(plan, set) {
     const paths = narrowed(plan) ? new Set(plan.paths) : null;
     return set.documents.some(({ locator, path }) => reads(plan, locator) && (paths === null || path === null || paths.has(path)));
 }
-function shown(entry) {
-    const cover = entry.cover();
+function shown(entry, held) {
+    const cover = entry.cover(held);
     return JSON.stringify('pending' in cover ? cover : cover.coverage);
 }
-export function createLiveQueries(run) {
+export function createLiveQueries(run, holding) {
     const entries = new Map();
     let closed = false;
+    let recovering = false;
+    let recoverAgain = false;
     function deliver(entry, next) {
         const previous = entry.digest;
         entry.digest = digestOf(next);
@@ -38,12 +41,19 @@ export function createLiveQueries(run) {
             for (const listener of entry.ready)
                 listener(change);
         }
-        for (const listener of entry.fresh) {
+        for (const listener of entry.fresh.keys()) {
             entry.ready.add(listener);
             listener(next);
         }
         entry.fresh.clear();
     }
+    async function delivered(entry) {
+        const { current, ...next } = await run(entry.plan, async () => entry.cover(await holding()));
+        if (closed || entry.listeners.size === 0)
+            return null;
+        deliver(entry, next);
+        return current;
+    }
     function schedule(entry) {
         if (closed || entry.listeners.size === 0)
             return;
@@ -56,22 +66,61 @@ export function createLiveQueries(run) {
             try {
                 for (;;) {
                     entry.dirty = false;
-                    const { current, ...next } = await run(entry.plan, entry.cover);
-                    if (closed || entry.listeners.size === 0)
+                    const current = await delivered(entry);
+                    if (current === null)
                         return;
-                    deliver(entry, next);
-                    if (!(entry.dirty && !current()) && shown(entry) === entry.covered)
+                    const held = await holding();
+                    if (entry.fresh.size > 0 || (entry.dirty && !current()))
+                        continue;
+                    if (shown(entry, held) === entry.covered)
                         break;
                 }
             }
-            catch {
-                entry.dirty = false;
+            catch (error) {
+                const unanswered = [...entry.fresh.values()];
+                entry.fresh.clear();
+                for (const failed of unanswered)
+                    failed(error);
             }
             finally {
                 entry.running = false;
             }
         })();
     }
+    function recovered() {
+        if (recovering) {
+            recoverAgain = true;
+            return;
+        }
+        recovering = true;
+        void (async () => {
+            try {
+                do {
+                    recoverAgain = false;
+                    for (const entry of entries.values()) {
+                        if (entry.running)
+                            entry.dirty = true;
+                    }
+                    const waiting = [...entries.values()].filter((entry) => !entry.running);
+                    if (waiting.length === 0 || closed)
+                        continue;
+                    const held = await holding();
+                    for (const entry of waiting) {
+                        if (entry.running)
+                            continue;
+                        if (entry.digest === undefined || shown(entry, held) !== entry.covered)
+                            schedule(entry);
+                    }
+                } while (recoverAgain && !closed);
+            }
+            catch (error) {
+                uncaught(error);
+            }
+            finally {
+                recovering = false;
+            }
+        })();
+    }
     return {
         touched(set) {
             for (const entry of entries.values()) {
@@ -79,22 +128,15 @@ export function createLiveQueries(run) {
                     schedule(entry);
             }
         },
-        recover() {
-            for (const entry of entries.values()) {
-                if (entry.running)
-                    continue;
-                if (entry.digest === undefined || shown(entry) !== entry.covered)
-                    schedule(entry);
-            }
-        },
-        watch(plan, identity, cover, listener) {
+        recover: recovered,
+        watch(plan, identity, cover, listener, failed) {
             let entry = entries.get(identity);
             if (entry === undefined) {
                 entry = {
                     plan,
                     cover,
                     listeners: new Set(),
-                    fresh: new Set(),
+                    fresh: new Map(),
                     ready: new Set(),
                     digest: undefined,
                     covered: '',
@@ -105,7 +147,7 @@ export function createLiveQueries(run) {
             }
             const held = entry;
             held.listeners.add(listener);
-            held.fresh.add(listener);
+            held.fresh.set(listener, failed);
             schedule(held);
             return () => {
                 held.listeners.delete(listener);

package/dist/locks.d.ts

@@ -0,0 +1,9 @@
+import type { DiscoveredRoom } from './adapter.js';
+import type { Runtime } from './runtime.js';
+export declare function locked({ store, socket }: Runtime, locator: string): Promise<boolean>;
+export declare function lockedRooms(runtime: Runtime): Promise<readonly string[]>;
+export declare function relocked(runtime: Runtime, before: readonly string[]): Promise<void>;
+export declare function confirmLocks({ socket }: Runtime, listed: readonly DiscoveredRoom[]): void;
+export declare function connectionLost(runtime: Runtime): void;
+export declare function watchLocks({ store }: Runtime, notify: () => void): () => void;
+//# sourceMappingURL=locks.d.ts.map

package/dist/locks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locks.d.ts","sourceRoot":"","sources":["../src/locks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAa5C,wBAAsB,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAK1F;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAW9E;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,iBAMzE;AAED,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,cAAc,EAAE,QAOlF;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,QAU9C;AAED,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAE7E"}

package/dist/locks.js

@@ -0,0 +1,62 @@
+import { uncaught } from './failure.js';
+import { emitRooms, LOCKS_TOPIC } from './shown.js';
+async function offlineModes({ store, socket }) {
+    const modes = new Map();
+    for (const [locator, { room }] of socket.rooms.declarations()) {
+        const declaration = room ?? socket.rooms.discovered(locator);
+        if (declaration !== undefined)
+            modes.set(locator, declaration.replica.offline);
+    }
+    for (const [locator, { offline }] of (await store.covering()).rooms)
+        modes.set(locator, offline);
+    return modes;
+}
+export async function locked({ store, socket }, locator) {
+    if (store.fences.has(locator) || socket.rooms.standing(locator).confirmed)
+        return false;
+    const held = socket.rooms.declared(locator)?.room ?? socket.rooms.discovered(locator);
+    const mode = (await (await store.open()).offline(locator)) ?? held?.replica.offline;
+    return mode === 'locked';
+}
+export async function lockedRooms(runtime) {
+    const { store, socket } = runtime;
+    return [...(await offlineModes(runtime))]
+        .filter(([locator, mode]) => mode === 'locked' &&
+        !socket.rooms.standing(locator).confirmed &&
+        !store.fences.has(locator))
+        .map(([locator]) => locator)
+        .sort();
+}
+export async function relocked(runtime, before) {
+    const after = await lockedRooms(runtime);
+    if (JSON.stringify(after) === JSON.stringify(before))
+        return;
+    runtime.journal.record(`locked ${after.length}`);
+    emitRooms(runtime);
+    runtime.store.tell(LOCKS_TOPIC, undefined);
+}
+export function confirmLocks({ socket }, listed) {
+    if (!socket.isOpen())
+        return;
+    for (const room of listed) {
+        if (room.replica.admission === 'admitted') {
+            socket.rooms.stand(room.locator, { confirmed: true });
+        }
+    }
+}
+export function connectionLost(runtime) {
+    const { socket } = runtime;
+    if (socket.closed())
+        return;
+    socket.rooms.connectionLost(() => {
+        if (socket.isOpen() || socket.closed())
+            return;
+        void lockedRooms(runtime).then((before) => {
+            socket.rooms.standAll({ confirmed: false });
+            return relocked(runtime, before);
+        }, uncaught);
+    });
+}
+export function watchLocks({ store }, notify) {
+    return store.watch(LOCKS_TOPIC, notify).stop;
+}

package/dist/log.d.ts

@@ -2,4 +2,5 @@ export declare function createLog(): {
     record(event: string): void;
     export(): string;
 };
+export type Log = ReturnType<typeof createLog>;
 //# sourceMappingURL=log.d.ts.map

package/dist/log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS;IAGrB,MAAM,QAAQ,MAAM;IAIpB,MAAM;EAIT"}
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS;IAGrB,MAAM,QAAQ,MAAM;IAIpB,MAAM;EAIT;AAED,MAAM,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/dist/lost.d.ts

@@ -0,0 +1,5 @@
+import type { Runtime } from './runtime.js';
+export declare function eraseFenced({ store }: Runtime, locators: readonly string[]): Promise<void>;
+export declare function fenceLive(runtime: Runtime, locators: readonly string[]): void;
+export declare function loseRooms(runtime: Runtime, locators: readonly string[]): Promise<void>;
+//# sourceMappingURL=lost.d.ts.map

package/dist/lost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lost.d.ts","sourceRoot":"","sources":["../src/lost.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAU5C,wBAAsB,WAAW,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,iBAIhF;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,QAOtE;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,iBAqC5E"}

package/dist/lost.js

@@ -0,0 +1,61 @@
+import { changeSet, mergeChangeSets } from './change-set.js';
+import { ERASE_BATCH, forgetInstall } from './install.js';
+import { recoverReads, statusShown } from './shown.js';
+import { yielded } from './turn.js';
+function forget({ store, socket }, locator) {
+    forgetInstall(store, locator);
+    socket.rooms.forget(locator);
+    store.forget(locator);
+}
+export async function eraseFenced({ store }, locators) {
+    for (const locator of locators) {
+        while (await store.durably((local) => local.erase(locator, ERASE_BATCH)))
+            await yielded();
+    }
+}
+export function fenceLive(runtime, locators) {
+    const { store, socket, journal } = runtime;
+    for (const locator of new Set(locators)) {
+        if (!store.fences.raise(locator, socket.session.now().discoveries))
+            continue;
+        forget(runtime, locator);
+        journal.record(`room lost ${locator}`);
+    }
+}
+export async function loseRooms(runtime, locators) {
+    const { store } = runtime;
+    fenceLive(runtime, locators);
+    const fresh = [...new Set(locators)].filter((locator) => {
+        const fence = store.fences.of(locator);
+        if (fence === undefined || fence.written)
+            return false;
+        store.fences.mark(locator, true);
+        return true;
+    });
+    if (fresh.length === 0)
+        return;
+    let held = [];
+    try {
+        await store.durably(async (local) => {
+            held = await local.roomDrafts();
+            await local.fence(fresh);
+        });
+    }
+    catch (error) {
+        for (const locator of fresh)
+            store.fences.mark(locator, false);
+        throw error;
+    }
+    finally {
+        store.changed(mergeChangeSets(fresh.map((locator) => changeSet(locator, {
+            documents: null,
+            room: true,
+            queue: true,
+            drafts: held.filter((draft) => draft.locator === locator).map(({ path }) => path),
+        }))));
+        recoverReads(runtime);
+        statusShown(runtime);
+    }
+    await store.durably((local) => runtime.unpair(local));
+    await eraseFenced(runtime, fresh);
+}

package/dist/media.d.ts

@@ -0,0 +1,8 @@
+import type { MdRuntimeClient } from './client.js';
+import { type ShownAnswer } from './outcome.js';
+export declare const ROOM_MEDIA = "room-media";
+type Show = (room: string, path: string, revision?: string) => Promise<ShownAnswer>;
+export declare function shownBy(show: Show, client: MdRuntimeClient): MdRuntimeClient;
+export declare function defineRoomMedia(client: Promise<MdRuntimeClient> | MdRuntimeClient): void;
+export {};
+//# sourceMappingURL=media.d.ts.map

package/dist/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3D,eAAO,MAAM,UAAU,eAAe,CAAC;AAwBvC,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAIpF,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,GAAG,eAAe,CAG5E;AAsBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,GAAG,IAAI,CA0LxF"}

package/dist/media.js

@@ -0,0 +1,218 @@
+import { UNCERTAIN } from './outcome.js';
+export const ROOM_MEDIA = 'room-media';
+const ATTRIBUTES = ['room', 'path', 'revision', 'width', 'height', 'alt'];
+const LOADING = new Set(['room', 'path', 'revision']);
+const NEARING = '600px 0px';
+const RELINKS = 2;
+// The Room's stream brings a file seconds after the text that links it, minutes after on a first open, and a page's reach of its Rooms settles seconds after it opens, so a file not shown yet is asked for again every three seconds.
+const UNSHOWN_MS = 3_000;
+const SHAPE = '16 / 9';
+const STYLE = `:host{display:block}
+[part=box]{position:relative;overflow:hidden}
+[part=box]>img,[part=box]>video,[part=box]>audio{display:block;width:100%;height:100%;object-fit:contain}
+[part=box]>slot{display:flex;align-items:center;justify-content:center;width:100%;height:100%;text-align:center}`;
+const shows = new WeakMap();
+export function shownBy(show, client) {
+    shows.set(client, show);
+    return client;
+}
+function ratioOf(width, height) {
+    const across = Number(width);
+    const down = Number(height);
+    return Number.isFinite(across) && Number.isFinite(down) && across > 0 && down > 0
+        ? `${across} / ${down}`
+        : SHAPE;
+}
+function refusedForGood(shown) {
+    if (shown.kind === 'revoked-authorization')
+        return true;
+    return (shown.kind === 'rejected' || shown.kind === 'scoped-refusal') && !shown.retryable;
+}
+function drawnFor(mediaType) {
+    if (mediaType.startsWith('image/'))
+        return 'img';
+    if (mediaType.startsWith('video/'))
+        return 'video';
+    if (mediaType.startsWith('audio/'))
+        return 'audio';
+    return null;
+}
+export function defineRoomMedia(client) {
+    if (customElements.get(ROOM_MEDIA) !== undefined)
+        return;
+    const connected = Promise.resolve(client);
+    class RoomMedia extends HTMLElement {
+        static observedAttributes = ATTRIBUTES;
+        #root = this.attachShadow({ mode: 'open' });
+        #box = document.createElement('div');
+        #fallback = document.createElement('slot');
+        #watching = null;
+        #near = false;
+        #asked = 0;
+        #shown = null;
+        #drawn = null;
+        #loaded = false;
+        #relinked = 0;
+        constructor() {
+            super();
+            this.#box.setAttribute('part', 'box');
+            this.#root.append(Object.assign(document.createElement('style'), { textContent: STYLE }), this.#box);
+            this.#shape();
+        }
+        connectedCallback() {
+            this.#label();
+            this.#watching ??= new IntersectionObserver((seen) => {
+                if (!seen.some((entry) => entry.isIntersecting) || this.#near)
+                    return;
+                this.#near = true;
+                void this.#load();
+            }, { rootMargin: NEARING });
+            this.#watching.observe(this);
+        }
+        disconnectedCallback() {
+            this.#watching?.disconnect();
+            this.#watching = null;
+            this.#near = false;
+            this.#asked += 1;
+            this.#show(null);
+        }
+        attributeChangedCallback(name, before, after) {
+            if (before === after)
+                return;
+            this.#shape();
+            if (this.isConnected)
+                this.#label();
+            if (!LOADING.has(name) || !this.#near)
+                return;
+            this.#relinked = 0;
+            void this.#load();
+        }
+        #shape() {
+            this.#box.style.aspectRatio = ratioOf(this.getAttribute('width'), this.getAttribute('height'));
+        }
+        #label() {
+            const alt = this.getAttribute('alt') ?? '';
+            const drawn = this.#drawn;
+            if (drawn instanceof HTMLMediaElement) {
+                this.removeAttribute('role');
+                this.removeAttribute('aria-label');
+                drawn.setAttribute('aria-label', alt);
+                return;
+            }
+            this.setAttribute('role', 'img');
+            this.setAttribute('aria-label', alt);
+            if (drawn !== null)
+                drawn.alt = '';
+        }
+        async #load() {
+            const asked = (this.#asked += 1);
+            this.#loaded = false;
+            const room = this.getAttribute('room');
+            const path = this.getAttribute('path');
+            const revision = this.getAttribute('revision') ?? undefined;
+            if (room === null || path === null) {
+                this.#unreadable();
+                return;
+            }
+            const show = shows.get(await connected);
+            const shown = show === undefined ? null : await show(room, path, revision).catch(() => UNCERTAIN);
+            if (asked !== this.#asked)
+                return;
+            if (shown?.kind === 'link') {
+                this.#draw({ url: shown.url, copy: false }, shown.mediaType);
+                return;
+            }
+            if (shown?.kind !== 'binary') {
+                if (shown === null || refusedForGood(shown))
+                    this.#unreadable();
+                else
+                    this.#unshown(asked);
+                return;
+            }
+            const copy = await new Response(shown.stream, {
+                headers: { 'content-type': shown.mediaType },
+            })
+                .blob()
+                .catch(() => null);
+            if (asked !== this.#asked)
+                return;
+            if (copy === null)
+                this.#unshown(asked);
+            else
+                this.#draw({ url: URL.createObjectURL(copy), copy: true }, shown.mediaType);
+        }
+        #unshown(asked) {
+            this.#unreadable();
+            setTimeout(() => {
+                if (asked === this.#asked && this.#near)
+                    void this.#load();
+            }, UNSHOWN_MS);
+        }
+        #show(shown, content = null) {
+            if (this.#shown?.copy === true)
+                URL.revokeObjectURL(this.#shown.url);
+            this.#shown = shown;
+            if (content !== this.#drawn)
+                this.#drawn = null;
+            if (content === null)
+                this.#box.replaceChildren();
+            else if (content.parentNode !== this.#box)
+                this.#box.replaceChildren(content);
+            this.#label();
+        }
+        #unreadable() {
+            this.#show(null, this.#fallback);
+        }
+        #draw(shown, mediaType) {
+            const tag = drawnFor(mediaType);
+            if (tag === null) {
+                if (shown.copy)
+                    URL.revokeObjectURL(shown.url);
+                this.#unreadable();
+                return;
+            }
+            const kept = this.#drawn?.localName === tag ? this.#drawn : null;
+            const drawn = kept ?? document.createElement(tag);
+            if (kept === null) {
+                if (drawn instanceof HTMLImageElement)
+                    drawn.decoding = 'async';
+                if (drawn instanceof HTMLMediaElement) {
+                    drawn.controls = true;
+                    drawn.preload = 'metadata';
+                    if (drawn instanceof HTMLVideoElement)
+                        drawn.playsInline = true;
+                }
+                drawn.addEventListener(drawn instanceof HTMLImageElement ? 'load' : 'loadedmetadata', () => {
+                    if (drawn !== this.#drawn)
+                        return;
+                    this.#loaded = true;
+                    this.#relinked = 0;
+                });
+                drawn.addEventListener('error', () => this.#failed(drawn));
+            }
+            this.#drawn = drawn;
+            this.#show(shown, drawn);
+            drawn.src = shown.url;
+        }
+        #failed(drawn) {
+            if (drawn !== this.#drawn)
+                return;
+            if (this.#shown?.copy !== false || !this.#loaded || this.#relinked >= RELINKS) {
+                this.#unreadable();
+                return;
+            }
+            this.#relinked += 1;
+            if (drawn instanceof HTMLMediaElement) {
+                const at = drawn.currentTime;
+                const playing = !drawn.paused;
+                drawn.addEventListener('loadedmetadata', () => {
+                    drawn.currentTime = at;
+                    if (playing)
+                        void drawn.play().catch(() => undefined);
+                }, { once: true });
+            }
+            void this.#load();
+        }
+    }
+    customElements.define(ROOM_MEDIA, RoomMedia);
+}

package/dist/memory.d.ts

@@ -1,11 +1,12 @@
 import type { ModelResult } from './model.js';
-import { type AcceptedMessage, type ActionResult, type Adapter, type BinaryFile, type Capability, type ConversationAction, type ConversationEvent, type DiscoveryScope, type DiscoveredRoom, type HeadChange, type ListedConversation, type Member, type ProviderLimit, type Retention, type ServiceMode } from './adapter.js';
+import { type AcceptedMessage, type ActionResult, type Adapter, type BinaryFile, type Capability, type ConversationAction, type ConversationEvent, type DiscoveredRoom, type SavedFacts, type HeadChange, type ListedAgent, type ListedConversation, type Member, type ProviderLimit, type Retention, type ServiceMode, type TypedPath } from './adapter.js';
 export type MemoryRoom = DiscoveredRoom & {
     model?: ModelResult;
-    selectionModel?: ModelResult;
     documents?: Readonly<Record<string, string>>;
+    facts?: Readonly<Record<string, SavedFacts>>;
     revisions?: Readonly<Record<string, string>>;
     fileIds?: Readonly<Record<string, string>>;
+    created?: Readonly<Record<string, string>>;
     changes?: Readonly<Record<string, HeadChange>>;
     binaryFiles?: Readonly<Record<string, BinaryFile>>;
     folders?: readonly string[];
@@ -13,13 +14,14 @@ export type MemoryRoom = DiscoveredRoom & {
 };
 export type MemoryConversation = {
     conversation: string;
-    listed?: Omit<ListedConversation, 'conversation'>;
+    listed?: Omit<ListedConversation, 'conversation' | 'newest'>;
     messages?: readonly AcceptedMessage[];
-    outcomes?: Partial<Record<ConversationAction, ActionResult>>;
+    outcomes?: Partial<Record<ConversationAction | 'history', ActionResult>>;
 };
 export type MemoryAdapterOptions = {
     rooms?: readonly MemoryRoom[];
     conversations?: readonly MemoryConversation[];
+    agents?: readonly ListedAgent[];
     historyPageSize?: number;
     pageSize?: number;
     capabilities?: readonly Capability[];
@@ -27,9 +29,12 @@ export type MemoryAdapterOptions = {
     retention?: Retention;
     member?: Member;
     unopened?: boolean;
-    exhaustiveDiscovery?: true;
+    roomTypes?: string;
+    typedPaths?: readonly TypedPath[];
 };
 export type MemoryAdapter = Adapter & {
+    discover: NonNullable<Adapter['discover']>;
+    refresh: NonNullable<Adapter['refresh']>;
     setRooms(rooms: readonly MemoryRoom[]): void;
     setConversations(conversations: readonly MemoryConversation[]): void;
     script(operation: keyof Adapter, answer: unknown): void;
@@ -37,17 +42,19 @@ export type MemoryAdapter = Adapter & {
     close(closing?: {
         revoked?: boolean;
         lost?: boolean;
+        authorityChanged?: boolean;
     }): void;
     expire(locators: readonly string[]): void;
     notifyRoomVersion(notification: {
         locator: string;
         roomVersion: string;
     }): void;
-    notifyAuthorityChanged(scope?: DiscoveryScope): void;
+    notifyAuthorityChanged(locators?: readonly string[]): void;
     notifyConversation(event: ConversationEvent): void;
     notifyServiceMode(mode: ServiceMode): void;
     heldRooms(): readonly string[];
     replicatedConversations(): readonly string[];
+    heldConversationCursor(): string | null;
 };
 export declare function createMemoryAdapter(options?: MemoryAdapterOptions): MemoryAdapter;
 //# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

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