@agentshouse/mdruntime-adapter 0.1.0-cd59fd8945dcb → 0.1.0-cdfc733e397ee

package/dist/read.js

@@ -1,4 +1,4 @@
-import { readPosition, roomVersion } from './version.js';
+import { DECIMAL, readPosition, roomVersion } from './version.js';
 export function authorityRoot(handle) {
     return `/rooms/${handle}`;
 }
@@ -51,8 +51,19 @@ export function headChange(held) {
 function headed(head) {
     return head === undefined ? {} : { head };
 }
-function declared(attachments) {
-    return attachments === undefined ? {} : { attachments };
+export function binaryFileOf(held) {
+    if (held.file === undefined)
+        return undefined;
+    const { file, bytes, media_type: mediaType, sha256 } = held;
+    if (typeof file !== 'string' ||
+        typeof bytes !== 'number' ||
+        typeof mediaType !== 'string' ||
+        typeof sha256 !== 'string')
+        return null;
+    return { fileRef: file, byteLength: bytes, mediaType, sha256 };
+}
+function binaried(binary) {
+    return binary === undefined ? {} : { binary };
 }
 function parseFile(value, mode) {
     if (typeof value !== 'object' || value === null)
@@ -61,16 +72,30 @@ function parseFile(value, mode) {
     if (typeof file.path !== 'string')
         return null;
     const head = headChange(file);
-    if (head === null)
+    const binary = binaryFileOf(file);
+    if (head === null || binary === null)
         return null;
     if (mode === 'site') {
         if (typeof file.sha256 !== 'string')
             return null;
-        return { path: file.path, revision: undefined, version: file.sha256, ...headed(head) };
+        return {
+            path: file.path,
+            revision: binary?.sha256,
+            version: file.sha256,
+            ...headed(head),
+            ...binaried(binary),
+        };
     }
     if (typeof file.revision !== 'string')
         return null;
-    return { path: file.path, revision: file.revision, version: file.revision, ...headed(head) };
+    return {
+        path: file.path,
+        revision: file.revision,
+        version: file.revision,
+        ...(typeof file.sha256 === 'string' ? { sha256: file.sha256 } : {}),
+        ...headed(head),
+        ...binaried(binary),
+    };
 }
 function parseScope(value, mode) {
     if (typeof value !== 'object' || value === null)
@@ -106,17 +131,28 @@ function parseScope(value, mode) {
             return null;
         contents.push({ path: content.path, content: content.content });
     }
-    if (mode === 'site')
-        return { anchor: manifest.anchor, ...at, files, contents };
-    return { anchor: manifest.anchor, ...at, files, contents, attachments: [] };
+    return { anchor: manifest.anchor, ...at, files, contents };
+}
+function parseCut(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'object' || value === null)
+        return null;
+    const { position, log_epoch: logEpoch } = value;
+    if (typeof position !== 'string' || typeof logEpoch !== 'string')
+        return null;
+    return { position, log_epoch: logEpoch };
 }
 function parseCursor(value) {
     if (typeof value !== 'object' || value === null)
         return null;
-    const { room, path } = value;
+    const { room, path, cut } = value;
     if (typeof room !== 'string' || (path !== null && typeof path !== 'string'))
         return null;
-    return { room, path };
+    const parsed = parseCut(cut);
+    if (parsed === null)
+        return null;
+    return { room, path, ...(parsed === undefined ? {} : { cut: parsed }) };
 }
 export function parseEnvelope(body) {
     if (typeof body !== 'object' || body === null)
@@ -138,6 +174,18 @@ export function parseEnvelope(body) {
 export function parseSiteBootstrap(body) {
     return parseScope(body, 'site');
 }
+export function siteBootstrapNext(body) {
+    if (typeof body !== 'object' || body === null || !('next' in body))
+        return null;
+    return typeof body.next === 'string' && body.next.length > 0 ? body.next : null;
+}
+export function siteBootstrapOffset(body) {
+    if (typeof body !== 'object' || body === null || !('offset' in body))
+        return null;
+    return Number.isSafeInteger(body.offset) && body.offset > 0
+        ? body.offset
+        : null;
+}
 function parseChange(value, mode) {
     if (typeof value !== 'object' || value === null)
         return null;
@@ -147,8 +195,15 @@ function parseChange(value, mode) {
     if (held.removed === true)
         return { path: held.path, removed: true };
     const head = headChange(held);
-    if (head === null)
+    const binary = binaryFileOf(held);
+    if (head === null || binary === null)
         return null;
+    if (binary !== undefined) {
+        if (mode === 'credential' && typeof held.revision !== 'string')
+            return null;
+        const revision = typeof held.revision === 'string' ? held.revision : binary.sha256;
+        return { path: held.path, binary, revision, version: revision, ...headed(head) };
+    }
     if (mode === 'site') {
         if (typeof held.content !== 'string' || typeof held.sha256 !== 'string')
             return null;
@@ -169,12 +224,6 @@ function parseChange(value, mode) {
             ...headed(head),
         };
     }
-    if (typeof held.reference === 'object' && held.reference !== null) {
-        const reference = held.reference;
-        if (typeof reference.revision !== 'string')
-            return null;
-        return { path: held.path, reference: { revision: reference.revision } };
-    }
     return null;
 }
 export function parseEnumeration(body, mode) {
@@ -199,14 +248,60 @@ export function parseEnumeration(body, mode) {
                 return null;
             changes.push(mapped);
         }
-        if (mode === 'site') {
-            authorities.push({ authority: held.authority, ...at, changes });
-            continue;
-        }
-        authorities.push({ authority: held.authority, ...at, changes, attachments: [] });
+        const next = held.next === undefined ? undefined : readPage(held.next);
+        if (next === null)
+            return null;
+        authorities.push({
+            authority: held.authority,
+            ...at,
+            changes,
+            ...(next === undefined ? {} : { next }),
+        });
     }
     return { authorities };
 }
+function readPage(held) {
+    if (typeof held !== 'object' || held === null)
+        return null;
+    const { after, through, read } = held;
+    if (typeof after !== 'string' || !DECIMAL.test(after))
+        return null;
+    if (typeof through !== 'string' || !DECIMAL.test(through))
+        return null;
+    if (typeof read !== 'number' || !Number.isSafeInteger(read) || read < 0)
+        return null;
+    return { after, through, read };
+}
+function advances(asked, next) {
+    const moved = BigInt(next.through) - BigInt(asked.through);
+    return moved > 0n || (moved === 0n && next.after === asked.after && next.read > asked.read);
+}
+export async function wholeView(first, more) {
+    const changes = new Map(first.changes.map((change) => [change.path, change]));
+    let view = first;
+    while (view.next !== undefined) {
+        const asked = view.next;
+        const page = await more(asked);
+        if ('kind' in page)
+            return page;
+        if (page.position !== asked.through ||
+            page.logEpoch !== first.logEpoch ||
+            (page.next !== undefined && !advances(asked, page.next))) {
+            return { kind: 'transport-uncertainty' };
+        }
+        for (const change of page.changes) {
+            changes.delete(change.path);
+            changes.set(change.path, change);
+        }
+        view = page;
+    }
+    return {
+        authority: first.authority,
+        position: view.position,
+        logEpoch: first.logEpoch,
+        changes: [...changes.values()],
+    };
+}
 export function advancedScope(scope, view) {
     const files = new Map(scope.files.map((file) => [file.path, file]));
     const contents = new Map(scope.contents.map((entry) => [entry.path, entry.content]));
@@ -215,18 +310,15 @@ export function advancedScope(scope, view) {
         contents.delete(change.path);
         if ('removed' in change)
             continue;
-        if ('content' in change) {
-            files.set(change.path, {
-                path: change.path,
-                revision: change.revision,
-                version: change.version,
-                ...headed(change.head),
-            });
+        files.set(change.path, {
+            path: change.path,
+            revision: change.revision,
+            version: change.version,
+            ...headed(change.head),
+            ...('binary' in change ? { binary: change.binary } : {}),
+        });
+        if ('content' in change)
             contents.set(change.path, change.content);
-            continue;
-        }
-        const { revision } = change.reference;
-        files.set(change.path, { path: change.path, revision, version: revision });
     }
     return {
         ...scope,
@@ -244,16 +336,16 @@ export function bootstrapOf(scope) {
     const documents = {};
     const revisions = {};
     const changes = {};
-    const binaryTargets = [];
+    const binaryFiles = {};
     for (const file of scope.files) {
         if (file.revision !== undefined)
             revisions[file.path] = file.revision;
         if (file.head !== undefined)
             changes[file.path] = file.head;
         const content = contents.get(file.path);
-        if (content === undefined)
-            binaryTargets.push(file.path);
-        else
+        if (file.binary !== undefined)
+            binaryFiles[file.path] = file.binary;
+        else if (content !== undefined)
             documents[file.path] = content;
     }
     return {
@@ -262,8 +354,7 @@ export function bootstrapOf(scope) {
         documents,
         revisions,
         changes,
-        binaryTargets: binaryTargets.sort(),
-        ...declared(scope.attachments),
+        binaryFiles,
     };
 }
 export function schemaOf(scope, schema) {
@@ -284,23 +375,21 @@ export function refreshFrom(view, fromRoomVersion) {
     const documents = {};
     const revisions = {};
     const changes = {};
-    const binaryTargets = [];
+    const binaryFiles = {};
     const removals = [];
     for (const change of view.changes) {
         if ('removed' in change) {
             removals.push(change.path);
             continue;
         }
-        if ('content' in change) {
+        if ('content' in change)
             documents[change.path] = change.content;
-            if (change.revision !== undefined)
-                revisions[change.path] = change.revision;
-            if (change.head !== undefined)
-                changes[change.path] = change.head;
-            continue;
-        }
-        binaryTargets.push(change.path);
-        revisions[change.path] = change.reference.revision;
+        else
+            binaryFiles[change.path] = change.binary;
+        if (change.revision !== undefined)
+            revisions[change.path] = change.revision;
+        if (change.head !== undefined)
+            changes[change.path] = change.head;
     }
     return {
         kind: 'net-advancement',
@@ -308,8 +397,7 @@ export function refreshFrom(view, fromRoomVersion) {
         documents,
         revisions,
         changes,
-        binaryTargets: binaryTargets.sort(),
+        binaryFiles,
         removals: removals.sort(),
-        ...declared(view.attachments),
     };
 }

package/dist/referrer.d.ts

@@ -0,0 +1,7 @@
+import type { TrackedAuthority } from './discovery.js';
+export type HouseReferrer = {
+    locator: string;
+    referrer: Readonly<Record<string, string>>;
+};
+export declare function houseReferrer(referrer: unknown, tracked: ReadonlyMap<string, TrackedAuthority>): HouseReferrer | null;
+//# sourceMappingURL=referrer.d.ts.map

package/dist/referrer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referrer.d.ts","sourceRoot":"","sources":["../src/referrer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC;AAgB5F,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC7C,aAAa,GAAG,IAAI,CAqBtB"}

package/dist/referrer.js

@@ -0,0 +1,35 @@
+function fields(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : null;
+}
+function named(held, ...keys) {
+    const present = Object.keys(held);
+    return (present.length === keys.length &&
+        keys.every((key) => typeof held[key] === 'string' && held[key] !== ''));
+}
+export function houseReferrer(referrer, tracked) {
+    const held = fields(referrer);
+    if (held === null)
+        return null;
+    if (named(held, 'room', 'path')) {
+        const entry = tracked.get(held.room);
+        if (entry === undefined)
+            return null;
+        return {
+            locator: entry.locator,
+            referrer: { room_ref: entry.authority, path: held.path },
+        };
+    }
+    if (named(held, 'room_ref', 'record')) {
+        const roomRef = held.room_ref;
+        const entry = [...tracked.values()].find((candidate) => candidate.authority === roomRef);
+        return {
+            locator: entry?.locator ?? roomRef,
+            referrer: { room_ref: roomRef, record: held.record },
+        };
+    }
+    if (named(held, 'message'))
+        return { locator: '', referrer: { message: held.message } };
+    return null;
+}

package/dist/refusal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refusal.d.ts","sourceRoot":"","sources":["../src/refusal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,aAAa,EACd,MAAM,wBAAwB,CAAC;AAEhC,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAOjE;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAC7B,OAAO,EAAE,eAAe,GACvB,aAAa,CAEf;AAmBD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,cAAc,GAAG,IAAI,CAMvB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAAG,IAAI,CAGpD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAQrF"}
+{"version":3,"file":"refusal.d.ts","sourceRoot":"","sources":["../src/refusal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,aAAa,EACd,MAAM,wBAAwB,CAAC;AAEhC,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAOjE;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAC7B,OAAO,EAAE,eAAe,GACvB,aAAa,CAEf;AAqBD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,cAAc,GAAG,IAAI,CAMvB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAAG,IAAI,CAGpD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAQrF"}

package/dist/refusal.js

@@ -18,8 +18,9 @@ function doorFailure(status, body) {
     const refusal = doorRefusal(body);
     if (status === 401)
         return { kind: 'revoked-authorization' };
-    if (refusal?.retryable === true)
+    if (refusal?.retryable === true || refusal?.code === 'update_required') {
         return { kind: 'transport-uncertainty' };
+    }
     if (status === 404 || refusal?.code === 'room_not_found')
         return { kind: 'room-not-readable' };
     if (status < 400)

package/dist/site.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAMR,MAAM,wBAAwB,CAAC;AAsBhC,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAgCxB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAwIxE"}
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAOR,MAAM,wBAAwB,CAAC;AA2BhC,OAAO,EAOL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAmCxB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAuQxE"}

package/dist/site.js

@@ -1,10 +1,12 @@
-import { actionOutcome } from './actions.js';
+import { actionOutcome, SITE_SUBMIT } from './actions.js';
 import { mapDiscovery, parseSiteDiscovery, siteCapabilities, siteTracked, } from './discovery.js';
-import { scopeModels, streamedModels, viewModels } from './model.js';
-import { advancedScope, bootstrapOf, parseEnumeration, parseSiteBootstrap, refreshFrom, viewOf, } from './read.js';
+import { partModels, streamedModels, viewModels } from './model.js';
+import { advancedScope, bootstrapOf, parseEnumeration, parseSiteBootstrap, refreshFrom, siteBootstrapNext, siteBootstrapOffset, viewOf, wholeView, } from './read.js';
+import { sha256Hex } from './digest.js';
 import { classifyDoor, classifyRead, discoveryFailure } from './refusal.js';
 import { houseNotifications } from './stream.js';
-import { SITE_DOOR_BOOTSTRAP, SITE_DOOR_DISCOVER, SITE_DOOR_ENUMERATE, SITE_DOOR_SUBMIT, } from './transport.js';
+import { SITE_DOOR_BOOTSTRAP, SITE_DOOR_DISCOVER, SITE_DOOR_ENUMERATE, SITE_DOOR_SUBMIT, SITE_FILE_RECORD, SITE_FILES, } from './transport.js';
+import { houseReferrer } from './referrer.js';
 import { followsVersion, logPosition, presented, reachedVersion, roomVersion, } from './version.js';
 const UNCERTAIN = { kind: 'transport-uncertainty' };
 function siteRoom(tracked) {
@@ -24,32 +26,94 @@ function settled(refused) {
 export function createSiteAdapter(transport) {
     const notifications = houseNotifications(transport, 'site');
     const tracked = new Map();
-    async function enumeration(entry, from) {
+    function published(referrer) {
+        const named = houseReferrer(referrer, tracked);
+        return named === null || !tracked.has(named.locator) ? null : named;
+    }
+    async function enumerated(entry, from, page) {
         const answer = await transport.door(SITE_DOOR_ENUMERATE, {
-            positions: [presented(entry.authority, from)],
+            positions: [
+                page === undefined
+                    ? presented(entry.authority, from)
+                    : {
+                        ...presented(entry.authority, { position: page.after, logEpoch: from.logEpoch }),
+                        page: { through: page.through, read: page.read },
+                    },
+            ],
         });
         const classified = classifyRead(answer.status, answer.body, entry.locator);
         if (classified !== null)
             return classified;
-        return parseEnumeration(answer.body, 'site') ?? UNCERTAIN;
+        const found = parseEnumeration(answer.body, 'site');
+        if (found === null)
+            return UNCERTAIN;
+        return viewOf(found, entry) ?? { kind: 'room-not-readable', locator: entry.locator };
+    }
+    async function enumeration(entry, from) {
+        const first = await enumerated(entry, from);
+        return 'kind' in first ? first : wholeView(first, (page) => enumerated(entry, from, page));
     }
-    async function caughtUp(entry) {
-        const answer = await transport.read(`${SITE_DOOR_BOOTSTRAP}${entry.authority}`);
+    async function bootstrapPart(entry, after, offset) {
+        const query = [
+            ...(after === null ? [] : [`after=${encodeURIComponent(after)}`]),
+            ...(offset === null ? [] : [`offset=${offset}`]),
+        ];
+        const answer = await transport.read(`${SITE_DOOR_BOOTSTRAP}${entry.authority}${query.length === 0 ? '' : `?${query.join('&')}`}`);
         const classified = classifyDoor(answer.status, answer.body, entry.locator);
         if (classified !== null)
             return { failure: classified };
         const scope = parseSiteBootstrap(answer.body);
-        if (scope === null)
-            return { failure: UNCERTAIN };
-        if (roomVersion(scope) === roomVersion(entry))
-            return { scope };
-        const found = await enumeration(entry, scope);
-        if ('kind' in found)
-            return { failure: settled(found) };
-        const view = viewOf(found, entry);
-        if (view === undefined)
-            return { failure: { kind: 'room-not-readable', locator: entry.locator } };
-        return { scope: advancedScope(scope, view) };
+        return scope === null ? { failure: UNCERTAIN } : { body: answer.body, scope };
+    }
+    async function assembled(entry, scope, path, offset) {
+        const opened = scope.contents.at(-1);
+        if (opened === undefined || opened.path !== path || opened.content.length !== offset) {
+            return UNCERTAIN;
+        }
+        let text = opened.content;
+        for (;;) {
+            const part = await bootstrapPart(entry, path, text.length);
+            if ('failure' in part)
+                return part.failure;
+            const [piece] = part.scope.contents;
+            if (piece === undefined ||
+                part.scope.contents.length !== 1 ||
+                piece.path !== path ||
+                piece.content.length === 0) {
+                return UNCERTAIN;
+            }
+            text += piece.content;
+            const more = siteBootstrapOffset(part.body);
+            if (more === null)
+                break;
+            if (more !== text.length)
+                return UNCERTAIN;
+        }
+        const file = scope.files.find((held) => held.path === path);
+        if (file === undefined || (await sha256Hex(text)) !== file.version)
+            return UNCERTAIN;
+        return { ...scope, contents: [...scope.contents.slice(0, -1), { path, content: text }] };
+    }
+    async function caughtUp(entry, after) {
+        const part = await bootstrapPart(entry, after, null);
+        if ('failure' in part)
+            return part;
+        const next = siteBootstrapNext(part.body);
+        const offset = siteBootstrapOffset(part.body);
+        if (offset !== null) {
+            if (next === null)
+                return { failure: UNCERTAIN };
+            const scope = await assembled(entry, part.scope, next, offset);
+            return 'kind' in scope ? { failure: scope } : { scope, next };
+        }
+        const { scope } = part;
+        if (after !== null || next !== null || roomVersion(scope) === roomVersion(entry)) {
+            return { scope, next };
+        }
+        const view = await enumeration(entry, scope);
+        if ('kind' in view)
+            return { failure: settled(view) };
+        return { scope: advancedScope(scope, view), next: null };
     }
     async function refreshed(entry, fromRoomVersion) {
         const from = logPosition(fromRoomVersion);
@@ -60,12 +124,9 @@ export function createSiteAdapter(transport) {
             const models = await streamedModels(streamed.schemas, entry, 'site');
             return models === undefined ? streamed.page : { ...streamed.page, models };
         }
-        const found = await enumeration(entry, from);
-        if ('kind' in found)
-            return found;
-        const view = viewOf(found, entry);
-        if (view === undefined)
-            return { kind: 'room-not-readable', locator: entry.locator };
+        const view = await enumeration(entry, from);
+        if ('kind' in view)
+            return view;
         notifications.reach(entry.authority, view);
         const answer = refreshFrom(view, fromRoomVersion);
         if (answer.kind !== 'net-advancement')
@@ -75,6 +136,7 @@ export function createSiteAdapter(transport) {
     }
     return {
         localSaves: true,
+        exhaustiveDiscovery: true,
         async authorize() {
             return {};
         },
@@ -97,14 +159,24 @@ export function createSiteAdapter(transport) {
             const entry = tracked.get(request.locator);
             if (entry === undefined)
                 return { kind: 'room-not-readable', locator: request.locator };
-            if (request.pageToken !== undefined)
-                return UNCERTAIN;
-            const held = await caughtUp(entry);
+            const continued = request.pageToken === undefined
+                ? null
+                : JSON.parse(request.pageToken);
+            const held = await caughtUp(entry, continued?.after ?? null);
             if ('failure' in held)
                 return held.failure;
             notifications.reach(entry.authority, held.scope);
-            const models = await scopeModels(held.scope, entry);
-            return { ...bootstrapOf(held.scope), ...(models === undefined ? {} : { models }) };
+            const seen = [
+                ...(continued?.seen ?? []),
+                ...entry.schemas.filter((schema) => held.scope.files.some((file) => file.path === schema)),
+            ];
+            const models = await partModels(held.scope, entry, new Set(seen), held.next === null);
+            const continuation = held.next === null ? null : { after: held.next, seen };
+            return {
+                ...bootstrapOf(held.scope),
+                ...(models === undefined ? {} : { models }),
+                ...(continuation === null ? {} : { pageToken: JSON.stringify(continuation) }),
+            };
         },
         async refresh(_authorization, request) {
             const entry = tracked.get(request.locator);
@@ -120,6 +192,32 @@ export function createSiteAdapter(transport) {
         async history() {
             return { kind: 'no-history' };
         },
+        async binary(_authorization, request) {
+            const named = published(request.kind === 'path' ? { room: request.locator, path: request.path } : request.referrer);
+            if (named === null) {
+                return { kind: 'rejected', code: 'referrer_unknown', fields: {}, retryable: false };
+            }
+            if (request.fileRef === undefined) {
+                return { kind: 'rejected', code: 'file_not_found', fields: {}, retryable: false };
+            }
+            const { room_ref, path, record } = named.referrer;
+            const read = await transport.download(`${SITE_FILES}${room_ref}/${encodeURIComponent(request.fileRef)}/${path === undefined
+                ? `${SITE_FILE_RECORD}/${encodeURIComponent(record)}`
+                : encodeURIComponent(path)}`);
+            if (read.status === 404) {
+                return { kind: 'rejected', code: 'file_not_found', fields: {}, retryable: false };
+            }
+            return read.status === 200 && read.blob !== null
+                ? { kind: 'binary', blob: read.blob }
+                : UNCERTAIN;
+        },
+        referrerScope(referrer) {
+            const named = published(referrer);
+            if (named === null)
+                return null;
+            const { path } = named.referrer;
+            return { kind: 'room', locator: named.locator, ...(path === undefined ? {} : { path }) };
+        },
         reached(locator, version, target) {
             return reachedVersion(version, target, tracked.get(locator)?.logEpoch);
         },
@@ -127,7 +225,7 @@ export function createSiteAdapter(transport) {
             return followsVersion(version, next);
         },
         async action(_authorization, request) {
-            if (request.name !== 'submit') {
+            if (request.name !== SITE_SUBMIT) {
                 return {
                     kind: 'rejected',
                     code: 'action-unimplemented',
@@ -137,7 +235,7 @@ export function createSiteAdapter(transport) {
             }
             if (!transport.online())
                 return UNCERTAIN;
-            return actionOutcome(await transport.door(SITE_DOOR_SUBMIT, request.input), 'submit');
+            return actionOutcome(await transport.door(SITE_DOOR_SUBMIT, request.input), SITE_SUBMIT);
         },
         roomStream: {
             hold(rooms) {
@@ -152,6 +250,11 @@ export function createSiteAdapter(transport) {
             },
             reopen: notifications.reopen,
             observe: notifications.observe,
+            published(locator, roomVersion) {
+                const at = logPosition(roomVersion);
+                if (at !== null)
+                    notifications.published(locator, at);
+            },
         },
         serviceMode: notifications.serviceMode,
     };

package/dist/stream.d.ts

@@ -1,4 +1,4 @@
-import type { ConversationStream, RefreshPage, RoomStreamEvent, ServiceModeSignal } from '@agentshouse/mdruntime';
+import type { ConversationStream, RefreshPage, RoomStreamEvent, ServiceModeSignal, StreamReceipts } from '@agentshouse/mdruntime';
 import type { TrackedAuthority } from './discovery.js';
 import type { HouseDoor, HouseHeldRoom, HouseMode, HouseStreamEntry } from './transport.js';
 import { type LogPosition } from './version.js';
@@ -10,8 +10,9 @@ export type StreamedAdvancement = {
 };
 export type HouseNotifications = {
     runtime: string;
-    observe(notify: (event: RoomStreamEvent) => void): () => void;
+    observe(notify: (event: RoomStreamEvent) => void, receipts: StreamReceipts): () => void;
     send(rooms: readonly HouseHeldRoom[]): void;
+    published(locator: string, at: LogPosition): void;
     reopen(): void;
     track(authorities: readonly TrackedAuthority[]): void;
     reach(authority: string, at: LogPosition): void;

package/dist/stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,kBAAkB,EAElB,WAAW,EACX,eAAe,EAEf,iBAAiB,EAElB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EAEb,SAAS,EAET,gBAAgB,EAEjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAgB7D,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;AAEvE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC9D,IAAI,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,CAAC;IAC5C,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI,CAAC;IACtD,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAAC;IAChD,OAAO,CACL,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,WAAW,EACjB,KAAK,CAAC,EAAE,YAAY,GACnB,mBAAmB,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,kBAAkB,CAAC;IAClC,WAAW,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAuBF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,kBAAkB,CAyS5F"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,kBAAkB,EAElB,WAAW,EACX,eAAe,EAEf,iBAAiB,EACjB,cAAc,EAEf,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EAEb,SAAS,EAET,gBAAgB,EAEjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AA0C7D,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;AAEvE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAAC;IACxF,IAAI,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,CAAC;IAC5C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAAC;IAClD,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI,CAAC;IACtD,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAAC;IAChD,OAAO,CACL,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,WAAW,EACjB,KAAK,CAAC,EAAE,YAAY,GACnB,mBAAmB,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,kBAAkB,CAAC;IAClC,WAAW,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAkFF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,kBAAkB,CAmhB5F"}