@agentshouse/mdruntime-adapter 0.1.0-ccd2ccb1f7214 → 0.1.0-ccda1a2da11c3

package/dist/adapter.js

@@ -1,46 +1,48 @@
+import { stepped } from '@agentshouse/mdruntime';
 import { DISCOVER_PREFIXES, capabilities, discoveredRoom, mapDiscovery, parseDiscovery, trackedFrom, } from './discovery.js';
 import { partModels, streamedModels, viewModels } from './model.js';
 import { gathered, gatheredEach, selections } from './gather.js';
 import { createSiteAdapter } from './site.js';
-import { bootstrapOf, contentPrefixes, matchesScope, parseEnumeration, parseEnvelope, parseGrant, refreshFrom, viewOf, wholeView, } from './read.js';
+import { authorityRoot, bootstrapping, emptyScope, housePart, parseEnumeration, parseFileAddress, parseGrant, parseParted, refreshFrom, viewOf, wholeView, } from './read.js';
+import { PART_ATTEMPTS, unverifiedPart } from './part.js';
 import { sha256Hex } from './digest.js';
-import { acceptedHanded, enumeratedHanded, heldHanded, scopeHanded, streamedHanded, } from './handed.js';
 import { houseAction } from './actions.js';
 import { classifyDoor, classifyRead, discoveryFailure, doorRefusal } from './refusal.js';
 import { houseNotifications } from './stream.js';
 import { DOOR_BATCH, DOOR_BATCH_UPLOAD, DOOR_BOOTSTRAP, DOOR_DISCOVER, DOOR_ENUMERATE, DOOR_FILES_GET, DOOR_REVISIONS, } from './transport.js';
-import { batchPaths, deltaBody, deltaBytes, deltaDigest, historyOutcome, houseChanges, mutationOutcome, operationHead, rejectedMapping, revisionBody, uploadable, } from './write.js';
-import { houseReferrer } from './referrer.js';
+import { batchPaths, deltaBody, deltaBytes, deltaDigest, historyOutcome, houseChanges, houseMove, mutationOutcome, operationHead, rejectedMapping, revisionBody, uploadable, } from './write.js';
+import { houseReferrer, houseReferrerScope } from './referrer.js';
+import { HOUSE_ROOM_TYPES } from './room-types.js';
 import { followsVersion, logPosition, presented, reachedVersion, roomVersion, } from './version.js';
 const UNCERTAIN = { kind: 'transport-uncertainty' };
 const UNCERTAIN_READ = { kind: 'transport-uncertainty' };
+const EXPIRED_ADDRESS = 403;
 function lapsedGrant(outcome) {
     return outcome.kind === 'rejected' && outcome.code === 'upload_unavailable';
 }
-function heldFiles(authority, held, after, budget) {
-    if (held === undefined || budget === 0)
-        return null;
-    const paths = Object.keys(held.revisions)
-        .filter((path) => held.documents[path] !== undefined && (after === null || path > after))
-        .sort();
-    if (paths.length === 0)
-        return null;
-    const files = paths.slice(0, budget).map((path) => ({ path, revision: held.revisions[path] }));
-    return { room: authority, through: paths.length > budget ? files.at(-1).path : null, files };
+async function heldFiles(authority, held, bound) {
+    const listed = await held.files(null, bound + 1);
+    const files = listed.slice(0, bound);
+    const through = listed.length > bound ? (files.at(-1)?.path ?? null) : null;
+    return files.length === 0 ? null : { room: authority, through, files };
 }
 async function reused(scope, held) {
     const sent = new Set(scope.contents.map((entry) => entry.path));
     const contents = [...scope.contents];
-    for (const file of scope.files) {
-        if (file.binary !== undefined || sent.has(file.path))
-            continue;
-        const content = held?.documents[file.path];
-        if (content === undefined ||
-            held?.revisions[file.path] !== file.revision ||
-            (await sha256Hex(content)) !== file.sha256) {
+    const asked = scope.files.filter((file) => file.binary === undefined && !sent.has(file.path));
+    if (asked.length === 0)
+        return scope;
+    if (held === undefined)
+        return null;
+    const kept = await held.contents(asked.map(({ path }) => path));
+    for (const file of asked) {
+        const found = kept.get(file.path);
+        if (found === undefined ||
+            found.revision !== file.revision ||
+            (await sha256Hex(found.content)) !== file.sha256) {
             return null;
         }
-        contents.push({ path: file.path, content });
+        contents.push({ path: file.path, content: found.content });
     }
     return { ...scope, contents };
 }
@@ -51,48 +53,64 @@ export function createAgentsHouseAdapter(options) {
     const notifications = houseNotifications(transport, 'credential');
     const tracked = new Map();
     const handed = new Map();
+    let heldRevisions;
     let bounds;
     function declared() {
         if (bounds === undefined)
             throw new Error('no Discovery declared the bounds');
         return bounds;
     }
-    async function bootstrappedRoom(envelope, sent, asked, continued) {
+    async function fetchedPart(entry, continued, listed) {
+        for (let attempt = 0; attempt < PART_ATTEMPTS; attempt += 1) {
+            const answered = await transport.door(DOOR_BOOTSTRAP, {
+                prefixes: [authorityRoot(entry.handle)],
+                part: listed.part,
+                ...(continued.held === undefined ? {} : { held: [continued.held] }),
+            });
+            const failure = classifyRead(answered.status, answered.body, entry.locator);
+            if (failure !== null)
+                return failure;
+            const scope = await housePart(continued.room, answered.body, listed, 'credential');
+            if (scope !== null)
+                return scope;
+        }
+        return unverifiedPart(entry.locator);
+    }
+    async function partPage(asked, continued) {
         const { entry } = asked;
-        if (sent === undefined)
-            return { kind: 'room-not-readable', locator: entry.locator };
+        const listed = continued.room.parts[continued.next];
+        const sent = listed === undefined
+            ? emptyScope(continued.room)
+            : await fetchedPart(entry, continued, listed);
+        if ('kind' in sent)
+            return sent;
         const scope = await reused(sent, asked.held);
         if (scope === null) {
             return asked.held === undefined
                 ? UNCERTAIN_READ
-                : continued === null
-                    ? bootstrapTogether({ entry, held: undefined })
-                    : continuedBootstrap({ entry, held: undefined }, continued);
+                : bootstrapTogether({ entry, held: undefined });
         }
-        const cursor = envelope.next?.room === entry.authority ? envelope.next : undefined;
-        const next = cursor?.path ?? null;
-        if (continued === null && next === null)
-            handed.set(entry.locator, scopeHanded(scope));
+        const next = continued.next + 1;
+        const more = next < continued.room.parts.length;
+        if (continued.next === 0 && !more)
+            handed.set(entry.locator, roomVersion(scope));
         else
             handed.delete(entry.locator);
         notifications.reach(entry.authority, scope);
         const seen = [
-            ...(continued?.seen ?? []),
+            ...continued.seen,
             ...entry.schemas.filter((schema) => scope.files.some((file) => file.path === schema)),
         ];
-        const models = await partModels(scope, entry, new Set(seen), next === null);
-        const continuation = next === null
-            ? null
-            : { after: next, seen, ...(cursor?.cut === undefined ? {} : { cut: cursor.cut }) };
+        const models = await partModels(scope, entry, new Set(seen), !more);
         return {
-            ...bootstrapOf(scope),
+            ...(await stepped(bootstrapping(scope))),
             ...(models === undefined ? {} : { models }),
-            ...(continuation === null ? {} : { pageToken: JSON.stringify(continuation) }),
+            ...(more ? { pageToken: JSON.stringify({ ...continued, next, seen }) } : {}),
         };
     }
     async function enumeratedPage(ask, page) {
         const answer = await transport.door(DOOR_ENUMERATE, {
-            prefixes: contentPrefixes(ask.entry),
+            prefixes: [authorityRoot(ask.entry.handle)],
             positions: [
                 {
                     ...presented(ask.entry.authority, { position: page.after, logEpoch: ask.from.logEpoch }),
@@ -116,21 +134,24 @@ export function createAgentsHouseAdapter(options) {
         if ('kind' in view)
             return view;
         notifications.reach(ask.entry.authority, view);
-        const answer = refreshFrom(view, ask.fromRoomVersion);
+        const answer = await refreshFrom(view, ask.fromRoomVersion);
         if (answer.kind !== 'net-advancement')
             return answer;
-        handed.set(ask.entry.locator, enumeratedHanded(view, handed.get(ask.entry.locator)));
+        handed.set(ask.entry.locator, roomVersion(view));
         const models = await viewModels(view, ask.entry);
         return models === undefined ? answer : { ...answer, models };
     }
     async function streamed(entry, request, from) {
-        const held = handed.get(entry.locator);
-        if (held?.roomVersion !== request.fromRoomVersion)
+        if (handed.get(entry.locator) !== request.fromRoomVersion)
             return null;
-        const advanced = notifications.advance(entry, from, (path, revision) => held.revisions.get(path) === revision);
+        const asked = notifications.edited(entry, from);
+        const kept = asked.length === 0 || heldRevisions === undefined
+            ? new Map()
+            : await heldRevisions(entry.locator, asked);
+        const advanced = await stepped(notifications.advance(entry, from, (path, revision) => kept.get(path) === revision));
         if (advanced === null)
             return null;
-        handed.set(entry.locator, streamedHanded(held, advanced));
+        handed.set(entry.locator, advanced.page.roomVersion);
         const models = await streamedModels(advanced.schemas, entry, 'credential');
         return models === undefined ? advanced.page : { ...advanced.page, models };
     }
@@ -140,20 +161,27 @@ export function createAgentsHouseAdapter(options) {
             const at = logPosition(room.roomVersion);
             if (entry === undefined || at === null)
                 return [];
-            handed.set(room.locator, heldHanded(room));
+            handed.set(room.locator, room.roomVersion);
             notifications.reach(entry.authority, at);
             return [presented(entry.authority, at)];
         });
         notifications.send(kept);
     }
-    function adopted(entry, outcome) {
+    async function adoptedMove(entry, into, outcome) {
+        if (outcome.kind === 'accepted' && outcome.destination !== undefined) {
+            await adopted(into, { kind: 'accepted', ...outcome.destination });
+        }
+        return adopted(entry, outcome);
+    }
+    async function adopted(entry, outcome) {
         if (outcome.kind !== 'accepted')
             return outcome;
         const held = handed.get(entry.locator);
         if (held === undefined)
             return outcome;
-        const follows = followsVersion(held.roomVersion, outcome.roomVersion);
-        handed.set(entry.locator, acceptedHanded(held, outcome, follows ? outcome.roomVersion : held.roomVersion));
+        const follows = followsVersion(held, outcome.roomVersion);
+        if (follows)
+            handed.set(entry.locator, outcome.roomVersion);
         const at = logPosition(outcome.roomVersion);
         if (follows && at !== null)
             notifications.reach(entry.authority, at);
@@ -176,68 +204,61 @@ export function createAgentsHouseAdapter(options) {
             return result;
         return { ...result, at: { locator, roomVersion: roomVersion({ position, logEpoch }) } };
     }
-    function weight(entry) {
-        return contentPrefixes(entry).length;
-    }
-    function holding(asks, after) {
-        const budget = Math.floor(declared().max_held_files / Math.max(1, asks.filter((ask) => ask.held !== undefined).length));
-        return asks.flatMap((ask) => heldFiles(ask.entry.authority, ask.held, after, budget) ?? []);
+    async function holding(asks) {
+        const bound = Math.floor(declared().max_held_files / Math.max(1, asks.filter((ask) => ask.held !== undefined).length));
+        const held = [];
+        for (const ask of asks) {
+            if (ask.held === undefined || bound === 0)
+                continue;
+            const files = await heldFiles(ask.entry.authority, ask.held, bound);
+            if (files !== null)
+                held.push(files);
+        }
+        return held;
     }
     async function bootstrapped(asks, answer) {
         let open = asks.map((asked, ask) => ({ entry: asked.entry, asked, ask }));
         while (open.length > 0) {
             const unreached = [];
-            for (const part of selections(open, ({ entry }) => weight(entry), declared().max_prefixes)) {
-                const held = holding(part.map(({ asked }) => asked), null);
+            for (const part of selections(open, declared().max_prefixes)) {
+                const held = await holding(part.map(({ asked }) => asked));
                 const answered = await transport.door(DOOR_BOOTSTRAP, {
-                    prefixes: part.flatMap(({ entry }) => contentPrefixes(entry)),
+                    prefixes: part.map(({ entry }) => authorityRoot(entry.handle)),
                     ...(held.length === 0 ? {} : { held }),
                 });
                 const classified = part.map(({ entry }) => classifyDoor(answered.status, answered.body, entry.locator));
-                const envelope = classified[0] === null ? parseEnvelope(answered.body) : null;
+                const parted = classified[0] === null ? parseParted(answered.body) : null;
                 for (const [index, asked] of part.entries()) {
                     const failure = classified[index];
                     if (failure !== null && failure !== undefined) {
                         answer(asked.ask, failure);
                         continue;
                     }
-                    if (envelope === null) {
+                    if (parted === null) {
                         answer(asked.ask, UNCERTAIN_READ);
                         continue;
                     }
-                    const scope = envelope.scopes.find((candidate) => matchesScope(candidate, asked.entry));
-                    if (scope === undefined && envelope.next !== undefined) {
+                    const room = parted.rooms.find((candidate) => candidate.anchor === asked.entry.authority);
+                    if (room === undefined && parted.next !== undefined) {
                         unreached.push(asked);
                         continue;
                     }
-                    answer(asked.ask, await bootstrappedRoom(envelope, scope, asked.asked, null));
+                    if (room === undefined) {
+                        answer(asked.ask, { kind: 'room-not-readable', locator: asked.entry.locator });
+                        continue;
+                    }
+                    const kept = held.find((files) => files.room === asked.entry.authority);
+                    answer(asked.ask, await partPage(asked.asked, {
+                        room,
+                        next: 0,
+                        seen: [],
+                        ...(kept === undefined ? {} : { held: kept }),
+                    }));
                 }
             }
             open = unreached;
         }
     }
-    async function continuedBootstrap(asked, continued) {
-        const { entry } = asked;
-        const after = {
-            room: entry.authority,
-            path: continued.after,
-            ...(continued.cut === undefined ? {} : { cut: continued.cut }),
-        };
-        const held = holding([asked], continued.after);
-        const answered = await transport.door(DOOR_BOOTSTRAP, {
-            prefixes: contentPrefixes(entry),
-            after,
-            ...(held.length === 0 ? {} : { held }),
-        });
-        const failure = classifyRead(answered.status, answered.body, entry.locator);
-        if (failure !== null)
-            return failure;
-        const envelope = parseEnvelope(answered.body);
-        if (envelope === null)
-            return UNCERTAIN_READ;
-        const scope = envelope.scopes.find((candidate) => matchesScope(candidate, entry));
-        return bootstrappedRoom(envelope, scope, asked, continued);
-    }
     function layered(asks) {
         const depths = new Map();
         const layers = [];
@@ -250,12 +271,12 @@ export function createAgentsHouseAdapter(options) {
     }
     async function enumerated(asks) {
         const answers = [];
-        const parts = layered(asks.map((ask, index) => ({ ask, index }))).flatMap((layer) => selections(layer, ({ ask }) => weight(ask.entry), declared().max_prefixes));
+        const parts = layered(asks.map((ask, index) => ({ ask, index }))).flatMap((layer) => selections(layer, declared().max_prefixes));
         for (const part of parts) {
             let open = [...part];
             while (open.length > 0) {
                 const answer = await transport.door(DOOR_ENUMERATE, {
-                    prefixes: open.flatMap(({ ask }) => contentPrefixes(ask.entry)),
+                    prefixes: open.map(({ ask }) => authorityRoot(ask.entry.handle)),
                     positions: open.map(({ ask }) => presented(ask.entry.authority, ask.from)),
                 });
                 const classified = open.map(({ ask }) => classifyRead(answer.status, answer.body, ask.entry.locator));
@@ -294,10 +315,12 @@ export function createAgentsHouseAdapter(options) {
         }
         const minted = await transport.door(DOOR_BATCH_UPLOAD, { ...head, paths, bytes, sha256 });
         if (minted.status !== 200) {
-            return { outcome: mutationOutcome(minted.status, minted.body, entry.locator, entry.handle) };
+            return {
+                outcome: await stepped(mutationOutcome(minted.status, minted.body, entry.locator, entry.handle)),
+            };
         }
         const grant = parseGrant(minted.body);
-        if (grant === null || grant.method !== 'POST')
+        if (grant === null)
             return { outcome: UNCERTAIN };
         const delivered = await transport.transfer({
             act: 'authored_batch_upload',
@@ -307,13 +330,13 @@ export function createAgentsHouseAdapter(options) {
         if (delivered.status !== 200)
             return { outcome: UNCERTAIN };
         const holding = parseGrant(delivered.body);
-        if (holding === null || holding.method !== 'POST')
+        if (holding === null)
             return { outcome: UNCERTAIN };
         const upload = { url: holding.url, operation: holding.operation, bytes, sha256 };
         await keep(upload);
         return { body: { ...head, paths, upload, runtime: notifications.runtime } };
     }
-    async function staged(answer, batch) {
+    async function staged(answer, { changeBatch: batch, file }) {
         const refusal = doorRefusal(answer.body);
         if (refusal?.code !== 'files_unstaged')
             return null;
@@ -328,7 +351,7 @@ export function createAgentsHouseAdapter(options) {
             const delivered = await transport.transfer({
                 act: 'binary_stage',
                 url,
-                body: change.blob,
+                body: await file(change.localId),
                 operation,
             });
             if (delivered.status !== 200)
@@ -336,7 +359,7 @@ export function createAgentsHouseAdapter(options) {
         }
         return true;
     }
-    async function submit(batch, head, changes, delta, bytes, entry, handed, keep) {
+    async function submit(request, head, changes, delta, bytes, entry, handed, keep, into) {
         const inline = { ...head, changes, runtime: notifications.runtime };
         const prepared = uploadable(inline, bytes, declared())
             ? await uploaded(head, changes, delta, bytes, entry, handed, keep)
@@ -344,15 +367,20 @@ export function createAgentsHouseAdapter(options) {
         if ('outcome' in prepared)
             return prepared.outcome;
         const answer = await transport.door(DOOR_BATCH, prepared.body);
-        const stagedFiles = await staged(answer, batch);
+        const stagedFiles = await staged(answer, request);
         if (stagedFiles === false)
             return UNCERTAIN;
         const settled = stagedFiles === null ? answer : await transport.door(DOOR_BATCH, prepared.body);
-        if (stagedFiles === true && (await staged(settled, batch)) !== null)
+        if (stagedFiles === true && (await staged(settled, request)) !== null)
             return UNCERTAIN;
-        return mutationOutcome(settled.status, settled.body, entry.locator, entry.handle);
+        return stepped(mutationOutcome(settled.status, settled.body, entry.locator, entry.handle, into === undefined
+            ? undefined
+            : {
+                source: { authority: entry.authority, handle: entry.handle },
+                destination: { authority: into.authority, handle: into.handle },
+            }));
     }
-    function granted(answer, locator) {
+    function addressed(answer, locator) {
         const failure = classifyDoor(answer.status, answer.body, locator);
         if (failure !== null) {
             return failure.kind === 'scoped-refusal'
@@ -364,33 +392,47 @@ export function createAgentsHouseAdapter(options) {
                 }
                 : failure;
         }
-        const grant = parseGrant(answer.body);
-        const name = answer.body.name;
-        if (grant === null || grant.method !== 'GET' || typeof name !== 'string') {
-            return UNCERTAIN_READ;
-        }
-        return { kind: 'link', url: grant.url, name };
+        const address = parseFileAddress(answer.body);
+        return address === null ? UNCERTAIN_READ : { kind: 'address', ...address };
+    }
+    function linked(answer, locator) {
+        const address = addressed(answer, locator);
+        return address.kind === 'address'
+            ? { kind: 'link', url: address.url, name: address.name }
+            : address;
     }
-    async function downloaded(answer, locator) {
-        const link = granted(answer, locator);
-        if (link.kind !== 'link')
-            return link;
-        const read = await transport.download(link.url);
-        if (read.status !== 200 || read.blob === null)
+    async function downloaded(ask, locator) {
+        let address = addressed(await ask(), locator);
+        if (address.kind !== 'address')
+            return address;
+        let read = await transport.download(address.url);
+        if (read.status === EXPIRED_ADDRESS) {
+            address = addressed(await ask(), locator);
+            if (address.kind !== 'address')
+                return address;
+            read = await transport.download(address.url);
+        }
+        if (read.status !== 200 || read.body === null)
             return UNCERTAIN_READ;
-        return { kind: 'binary', blob: read.blob };
+        return {
+            kind: 'binary',
+            body: read.body,
+            mediaType: address.mediaType,
+            sha256: address.sha256,
+        };
     }
-    function pathGrant(request) {
+    function pathAddress(request) {
         const entry = authorityFor(request.locator);
         if (entry === undefined)
             return null;
-        return transport.door(DOOR_FILES_GET, {
+        return () => transport.door(DOOR_FILES_GET, {
             room_ref: entry.authority,
             path: request.path,
             revision: request.revision,
         });
     }
     return {
+        roomTypes: HOUSE_ROOM_TYPES,
         async authorize() {
             return options.authorize();
         },
@@ -440,7 +482,7 @@ export function createAgentsHouseAdapter(options) {
                 return { kind: 'room-not-readable', locator: request.locator };
             const asked = { entry, held: request.held };
             if (request.pageToken !== undefined) {
-                return continuedBootstrap(asked, JSON.parse(request.pageToken));
+                return partPage(asked, JSON.parse(request.pageToken));
             }
             return bootstrapTogether(asked);
         },
@@ -462,18 +504,27 @@ export function createAgentsHouseAdapter(options) {
             const entry = authorityFor(request.locator);
             if (entry === undefined)
                 return { kind: 'room-not-readable', locator: request.locator };
-            const mapped = houseChanges(request.changeBatch, entry.handle);
+            const batch = request.changeBatch;
+            const destination = batch.between?.destination.room;
+            const into = destination === undefined ? undefined : authorityFor(destination);
+            if (destination !== undefined && into === undefined) {
+                return { kind: 'room-not-readable', locator: destination };
+            }
+            const mapped = into === undefined
+                ? houseChanges(batch, entry.handle)
+                : houseMove(batch, entry.handle, into.handle);
             if (mapped.kind === 'unmapped')
                 return rejectedMapping(mapped);
-            const head = operationHead(request.changeBatch);
+            const head = operationHead(batch);
             const delta = deltaBody(mapped.changes);
             const bytes = deltaBytes(delta);
             const handed = request.upload;
-            const batch = request.changeBatch;
-            const outcome = await submit(batch, head, mapped.changes, delta, bytes, entry, handed, keep);
+            const answer = (upload) => submit(request, head, mapped.changes, delta, bytes, entry, upload, keep, into);
+            const settle = (outcome) => into === undefined ? adopted(entry, outcome) : adoptedMove(entry, into, outcome);
+            const outcome = await answer(handed);
             if (handed === undefined || !lapsedGrant(outcome))
-                return adopted(entry, outcome);
-            return adopted(entry, await submit(batch, head, mapped.changes, delta, bytes, entry, undefined, keep));
+                return settle(outcome);
+            return settle(await answer(undefined));
         },
         async history(_authorization, request) {
             const entry = authorityFor(request.locator);
@@ -492,35 +543,25 @@ export function createAgentsHouseAdapter(options) {
         },
         async binary(_authorization, request) {
             if (request.kind === 'path') {
-                const asked = pathGrant(request);
-                if (asked === null)
+                const ask = pathAddress(request);
+                if (ask === null)
                     return { kind: 'room-not-readable', locator: request.locator };
-                return downloaded(await asked, request.locator);
+                return downloaded(ask, request.locator);
             }
             const referrer = houseReferrer(request.referrer, tracked);
             if (referrer === null) {
                 return { kind: 'rejected', code: 'referrer_unknown', fields: {}, retryable: false };
             }
-            const answer = await transport.door(DOOR_FILES_GET, {
-                file: request.fileRef,
-                referrer: referrer.referrer,
-            });
-            return downloaded(answer, referrer.locator);
+            return downloaded(() => transport.door(DOOR_FILES_GET, { file: request.fileRef, referrer: referrer.referrer }), referrer.locator);
         },
         async link(_authorization, request) {
-            const asked = pathGrant(request);
-            if (asked === null)
+            const ask = pathAddress(request);
+            if (ask === null)
                 return { kind: 'room-not-readable', locator: request.locator };
-            return granted(await asked, request.locator);
+            return linked(await ask(), request.locator);
         },
         referrerScope(referrer) {
-            const held = houseReferrer(referrer, tracked);
-            if (held === null)
-                return null;
-            if (held.locator === '')
-                return { kind: 'conversations' };
-            const { path } = held.referrer;
-            return { kind: 'room', locator: held.locator, ...(path === undefined ? {} : { path }) };
+            return houseReferrerScope(referrer, tracked);
         },
         reached(locator, version, target) {
             return reachedVersion(version, target, authorityFor(locator)?.logEpoch);
@@ -534,7 +575,10 @@ export function createAgentsHouseAdapter(options) {
         roomStream: {
             hold: held,
             reopen: notifications.reopen,
-            observe: notifications.observe,
+            observe(notify, receipts, revisions) {
+                heldRevisions = revisions;
+                return notifications.observe(notify, receipts);
+            },
             published(locator, roomVersion) {
                 const at = logPosition(roomVersion);
                 if (at !== null)

package/dist/discovery.d.ts

@@ -16,13 +16,13 @@ export type HouseBounds = {
     max_held_files: number;
     change_retention_seconds: number;
     operation_retention_seconds: number;
+    max_move_documents?: number;
 };
 export type HouseOperations = {
-    read: readonly string[];
-    sync: readonly string[];
     write: readonly string[];
     delete: readonly string[];
 };
+export type HouseReadLevel = 'mcp' | 'online' | 'local';
 export type HouseModel = {
     root: string;
     paths: readonly string[];
@@ -35,6 +35,7 @@ export type HouseAuthority = LogPosition & {
     houseModel: HouseModel | null;
     managedReplication: 'admitted' | 'unavailable';
     protectedPaths: readonly string[];
+    read: HouseReadLevel;
     operations: HouseOperations;
 };
 export type HouseDiscoveryDocument = {

package/dist/discovery.d.ts.map

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