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

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,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,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,CAoBtB;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC7C,aAAa,GAAG,IAAI,CAOtB"}

package/dist/referrer.js

@@ -0,0 +1,41 @@
+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 },
+        };
+    }
+    return null;
+}
+export function houseReferrerScope(referrer, tracked) {
+    const held = fields(referrer);
+    if (held !== null && named(held, 'room', 'path')) {
+        return { locator: held.room, path: held.path };
+    }
+    const found = houseReferrer(referrer, tracked);
+    return found === null ? null : { locator: found.locator };
+}

package/dist/refusal.d.ts

@@ -1,13 +1,9 @@
 import type { AdapterFailure, DiscoverResult, ProviderRefusal, ScopedRefusal } from '@agentshouse/mdruntime';
-export type DoorRefusal = ProviderRefusal & {
-    retryable: boolean;
-};
-export declare function doorRefusal(body: unknown): DoorRefusal | null;
-export declare function scopedRefusal(locator: string, scope: ScopedRefusal['scope'], refusal: DoorRefusal): ScopedRefusal;
-export declare function classifyDoor(status: number, body: unknown, locator: string): AdapterFailure | {
+export declare function doorRefusal(body: unknown): ProviderRefusal | null;
+export declare function scopedRefusal(locator: string, scope: ScopedRefusal['scope'], refusal: ProviderRefusal): ScopedRefusal;
+export declare function classifyDoor(status: number, body: unknown, locator: string): AdapterFailure | null;
+export declare function classifyRead(status: number, body: unknown, locator: string): AdapterFailure | {
     kind: 'beyond-horizon';
 } | null;
-export declare function discoveryFailure(classified: AdapterFailure | {
-    kind: 'beyond-horizon';
-}): DiscoverResult;
+export declare function discoveryFailure(status: number, body: unknown): DiscoverResult | null;
 //# sourceMappingURL=refusal.d.ts.map

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,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC;AAEnE,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAO7D;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAC7B,OAAO,EAAE,WAAW,GACnB,aAAa,CAEf;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,CAapD;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GACtD,cAAc,CAMhB"}
+{"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

@@ -6,38 +6,52 @@ export function doorRefusal(body) {
     const error = body.error;
     if (typeof error.code !== 'string')
         return null;
-    const { code, ...fields } = error;
-    return { code, fields, retryable: error.retryable === true };
+    const { code, retryable, ...fields } = error;
+    return { code, fields, retryable: retryable === true };
 }
 export function scopedRefusal(locator, scope, refusal) {
-    return { kind: 'scoped-refusal', locator, scope, code: refusal.code, fields: refusal.fields };
+    return { kind: 'scoped-refusal', locator, scope, ...refusal };
 }
-export function classifyDoor(status, body, locator) {
+function doorFailure(status, body) {
     if (status === 0)
         return { kind: 'transport-uncertainty' };
     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 (refusal !== null && refusal.code === 'position_expired')
-        return { kind: 'beyond-horizon' };
-    if (status === 404 || refusal?.code === 'room_not_found') {
-        return { kind: 'room-not-readable', locator };
     }
+    if (status === 404 || refusal?.code === 'room_not_found')
+        return { kind: 'room-not-readable' };
     if (status < 400)
         return null;
     if (refusal === null)
         return { kind: 'transport-uncertainty' };
-    if (status === 403)
-        return scopedRefusal(locator, 'operation', refusal);
-    return scopedRefusal(locator, 'undisclosed', refusal);
+    return { kind: 'refused', scope: status === 403 ? 'operation' : 'undisclosed', refusal };
+}
+export function classifyDoor(status, body, locator) {
+    const failure = doorFailure(status, body);
+    if (failure === null)
+        return null;
+    if (failure.kind === 'room-not-readable')
+        return { kind: 'room-not-readable', locator };
+    if (failure.kind === 'refused')
+        return scopedRefusal(locator, failure.scope, failure.refusal);
+    return failure;
 }
-export function discoveryFailure(classified) {
-    if (classified.kind === 'revoked-authorization')
-        return classified;
-    if (classified.kind === 'scoped-refusal') {
-        return { kind: 'contract-unavailable', code: classified.code, fields: classified.fields };
+export function classifyRead(status, body, locator) {
+    if (doorRefusal(body)?.code === 'expired')
+        return { kind: 'beyond-horizon' };
+    return classifyDoor(status, body, locator);
+}
+export function discoveryFailure(status, body) {
+    const failure = doorFailure(status, body);
+    if (failure === null)
+        return null;
+    if (failure.kind === 'revoked-authorization')
+        return failure;
+    if (failure.kind === 'refused') {
+        return { kind: 'contract-unavailable', ...failure.refusal };
     }
     return { kind: 'transport-uncertainty' };
 }

package/dist/room-types.d.ts

@@ -0,0 +1,6 @@
+export declare const INBOX_CHANNEL_KINDS: readonly ['telegram-bot'];
+export type InboxChannelKind = (typeof INBOX_CHANNEL_KINDS)[number];
+export declare const INBOX_CHAT_TYPE = "inbox-chat";
+export declare const INBOX_MESSAGE_TYPE = "inbox-message";
+export declare const HOUSE_ROOM_TYPES: string;
+//# sourceMappingURL=room-types.d.ts.map

package/dist/room-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-types.d.ts","sourceRoot":"","sources":["../src/room-types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,YAAI,cAAc,CAAU,CAAC;AAE7D,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAalD,eAAO,MAAM,gBAAgB,QAsDjB,CAAC"}

package/dist/room-types.js

@@ -0,0 +1,66 @@
+export const INBOX_CHANNEL_KINDS = ['telegram-bot'];
+export const INBOX_CHAT_TYPE = 'inbox-chat';
+export const INBOX_MESSAGE_TYPE = 'inbox-message';
+const IDENTITY = "{ type: string, pattern: '^\\S+$' }";
+const AGENT = ['        agent: { type: string, format: uuid }', '        name: { type: string }'];
+const ASSIGNEE = [
+    '      type: object',
+    '      properties:',
+    '        user: { type: string, format: uuid }',
+    ...AGENT,
+];
+export const HOUSE_ROOM_TYPES = [
+    `${INBOX_CHAT_TYPE}:`,
+    '  properties:',
+    '    inbox: { type: string, format: uuid }',
+    `    channel: { enum: [${INBOX_CHANNEL_KINDS.join(', ')}] }`,
+    `    chat: ${IDENTITY}`,
+    '    customer:',
+    '      type: object',
+    '      properties:',
+    '        name: { type: string }',
+    `        username: ${IDENTITY}`,
+    `        phone: ${IDENTITY}`,
+    '    assignee:',
+    ...ASSIGNEE,
+    '    return_to:',
+    '      type: object',
+    '      properties:',
+    ...AGENT,
+    '    conversation: { type: string, format: uuid }',
+    '  required: [inbox, channel, chat, customer]',
+    `${INBOX_MESSAGE_TYPE}:`,
+    '  properties:',
+    '    direction: { enum: [in, out] }',
+    '    sender:',
+    '      type: object',
+    '      properties:',
+    '        name: { type: string }',
+    `        username: ${IDENTITY}`,
+    '    sent_at: { type: string, format: date-time }',
+    `    channel_message: ${IDENTITY}`,
+    '    state: { enum: [sending, sent, failed] }',
+    '    reason: { type: string }',
+    '    reactions:',
+    '      type: array',
+    '      items:',
+    '        type: object',
+    '        properties:',
+    '          reaction: { type: string, minLength: 1 }',
+    '          sender:',
+    '            type: object',
+    '            properties:',
+    `              id: ${IDENTITY}`,
+    '              name: { type: string }',
+    `              username: ${IDENTITY}`,
+    '          count: { type: integer, minimum: 1 }',
+    '        required: [reaction]',
+    `    post: ${IDENTITY}`,
+    '    assignee:',
+    ...ASSIGNEE,
+    '    sent_outside: { const: true }',
+    '  required: [direction]',
+    '  if: { properties: { direction: { const: in } } }',
+    '  then: { required: [sent_at] }',
+    '',
+].join('\n');

package/dist/site.d.ts

@@ -1,4 +1,4 @@
 import type { Adapter } from '@agentshouse/mdruntime';
 import { type HouseSiteTransport } from './transport.js';
-export declare function createSiteAdapter(transport: HouseSiteTransport): Adapter;
+export declare function createSiteAdapter(transport: HouseSiteTransport, snapshot?: boolean): Adapter;
 //# sourceMappingURL=site.d.ts.map

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,EAML,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AA+BxB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAiIxE"}
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAUR,MAAM,wBAAwB,CAAC;AA8BhC,OAAO,EAOL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAuCxB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAoQ1F"}

package/dist/site.js

@@ -1,86 +1,144 @@
-import { actionOutcome } from './actions.js';
+import { stepped } from '@agentshouse/mdruntime';
+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 { classifyDoor, discoveryFailure } from './refusal.js';
+import { partModels, streamedModels, viewModels } from './model.js';
+import { advancedScope, bootstrapping, emptyScope, housePart, parseEnumeration, parseSiteParted, refreshFrom, viewOf, wholeView, } from './read.js';
+import { PART_ATTEMPTS, unverifiedPart } from './part.js';
+import { classifyDoor, classifyRead, discoveryFailure } from './refusal.js';
+import { HOUSE_ROOM_TYPES } from './room-types.js';
 import { houseNotifications } from './stream.js';
-import { PRIVATE_LOCATOR, 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 unfound() {
+    return { kind: 'rejected', code: 'file_not_found', fields: {}, retryable: false };
+}
 function siteRoom(tracked) {
     return {
         name: tracked.handle,
         locator: tracked.locator,
+        handle: tracked.handle,
         roomVersion: roomVersion(tracked),
-        operations: { read: [''], sync: [''], write: [], delete: [] },
-        replica: { selection: tracked.locator, admission: 'admitted' },
+        operations: { write: [], delete: [] },
+        replica: { selection: tracked.locator, admission: 'admitted', offline: 'open' },
         providerOwnedPaths: [],
     };
 }
 function settled(refused) {
     return refused.kind === 'beyond-horizon' ? UNCERTAIN : refused;
 }
-export function createSiteAdapter(transport) {
+export function createSiteAdapter(transport, snapshot = false) {
     const notifications = houseNotifications(transport, 'site');
     const tracked = new Map();
-    async function enumeration(entry, from) {
+    const expired = new Map();
+    function published(referrer) {
+        const named = houseReferrer(referrer, tracked);
+        return named === null || !tracked.has(named.locator) ? null : named;
+    }
+    function fileRoute(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 unfound();
+        const { room_ref, path, record } = named.referrer;
+        return `${SITE_FILES}${room_ref}/${encodeURIComponent(request.fileRef)}/${path === undefined
+            ? `${SITE_FILE_RECORD}/${encodeURIComponent(record)}`
+            : encodeURIComponent(path)}`;
+    }
+    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 = classifyDoor(answer.status, answer.body, entry.locator);
+        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 partedRoom(entry) {
+        const cut = expired.get(entry.locator);
+        const answer = await transport.read(`${SITE_DOOR_BOOTSTRAP}${entry.authority}${cut === undefined ? '' : `?expired=${cut}`}`);
         const classified = classifyDoor(answer.status, answer.body, entry.locator);
         if (classified !== null)
-            return { failure: settled(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 classified;
+        const room = parseSiteParted(answer.body);
+        return room === null || room.anchor !== entry.authority ? UNCERTAIN : room;
+    }
+    async function fetchedPart(entry, room, listed) {
+        for (let attempt = 0; attempt < PART_ATTEMPTS; attempt += 1) {
+            const answer = await transport.read(`${SITE_DOOR_BOOTSTRAP}${entry.authority}?part=${encodeURIComponent(listed.part)}`);
+            const failure = classifyRead(answer.status, answer.body, entry.locator);
+            if (failure?.kind === 'beyond-horizon')
+                expired.set(entry.locator, room.position);
+            if (failure !== null)
+                return failure;
+            const scope = await housePart(room, answer.body, listed, 'site');
+            if (scope !== null)
+                return scope;
+        }
+        return unverifiedPart(entry.locator);
+    }
+    async function caughtUp(entry, continued) {
+        const listed = continued.room.parts[continued.next];
+        const scope = listed === undefined
+            ? emptyScope(continued.room)
+            : await fetchedPart(entry, continued.room, listed);
+        if ('kind' in scope)
+            return scope;
+        if (continued.room.parts.length > 1 || roomVersion(scope) === roomVersion(entry))
+            return scope;
+        const view = await enumeration(entry, scope);
+        if ('kind' in view)
+            return settled(view);
+        return stepped(advancedScope(scope, view));
     }
     async function refreshed(entry, fromRoomVersion) {
         const from = logPosition(fromRoomVersion);
         if (from === null)
             return { kind: 'beyond-horizon' };
-        const streamed = notifications.advance(entry, from);
+        const streamed = await stepped(notifications.advance(entry, from));
         if (streamed !== null) {
             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);
+        const answer = await refreshFrom(view, fromRoomVersion);
         if (answer.kind !== 'net-advancement')
             return answer;
         const models = await viewModels(view, entry);
         return models === undefined ? answer : { ...answer, models };
     }
     return {
+        localSaves: true,
+        exhaustiveDiscovery: true,
+        roomTypes: HOUSE_ROOM_TYPES,
         async authorize() {
             return {};
         },
         async discover() {
             const answer = await transport.read(SITE_DOOR_DISCOVER);
-            const classified = classifyDoor(answer.status, answer.body, PRIVATE_LOCATOR);
-            if (classified !== null)
-                return discoveryFailure(classified);
+            const failed = discoveryFailure(answer.status, answer.body);
+            if (failed !== null)
+                return failed;
             const document = parseSiteDiscovery(answer.body);
             if (document === null)
                 return UNCERTAIN;
@@ -95,14 +153,32 @@ 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);
-            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 }) };
+            let continued;
+            if (request.pageToken === undefined) {
+                const room = await partedRoom(entry);
+                if ('kind' in room)
+                    return room;
+                continued = { room, next: 0, seen: [] };
+            }
+            else
+                continued = JSON.parse(request.pageToken);
+            const scope = await caughtUp(entry, continued);
+            if ('kind' in scope)
+                return scope;
+            notifications.reach(entry.authority, scope);
+            const next = continued.next + 1;
+            const more = next < continued.room.parts.length;
+            const seen = [
+                ...continued.seen,
+                ...entry.schemas.filter((schema) => scope.files.some((file) => file.path === schema)),
+            ];
+            const models = await partModels(scope, entry, new Set(seen), !more);
+            const { folders: _folders, ...page } = await stepped(bootstrapping(scope));
+            return {
+                ...page,
+                ...(models === undefined ? {} : { models }),
+                ...(more ? { pageToken: JSON.stringify({ ...continued, next, seen }) } : {}),
+            };
         },
         async refresh(_authorization, request) {
             const entry = tracked.get(request.locator);
@@ -110,14 +186,47 @@ export function createSiteAdapter(transport) {
                 return { kind: 'room-not-readable', locator: request.locator };
             if (request.pageToken !== undefined)
                 return UNCERTAIN;
+            if (snapshot) {
+                return request.fromRoomVersion === roomVersion(entry)
+                    ? { kind: 'still-current' }
+                    : { kind: 'beyond-horizon' };
+            }
             return refreshed(entry, request.fromRoomVersion);
         },
         async mutate() {
-            return { kind: 'rejected', affected: {}, code: 'write-grant', fields: {} };
+            return { kind: 'rejected', affected: {}, code: 'write-grant', fields: {}, retryable: false };
         },
         async history() {
             return { kind: 'no-history' };
         },
+        async binary(_authorization, request) {
+            const route = fileRoute(request);
+            if (typeof route !== 'string')
+                return route;
+            const read = await transport.download(route);
+            if (read.status === 404)
+                return unfound();
+            return read.status === 200 && read.body !== null
+                ? { kind: 'binary', body: read.body, mediaType: read.mediaType }
+                : UNCERTAIN;
+        },
+        async link(_authorization, request) {
+            const route = fileRoute(request);
+            if (typeof route !== 'string')
+                return route;
+            return {
+                kind: 'link',
+                url: route,
+                name: request.path.slice(request.path.lastIndexOf('/') + 1),
+            };
+        },
+        referrerScope(referrer) {
+            const named = published(referrer);
+            if (named === null)
+                return null;
+            const { path } = named.referrer;
+            return { locator: named.locator, ...(path === undefined ? {} : { path }) };
+        },
         reached(locator, version, target) {
             return reachedVersion(version, target, tracked.get(locator)?.logEpoch);
         },
@@ -125,26 +234,39 @@ export function createSiteAdapter(transport) {
             return followsVersion(version, next);
         },
         async action(_authorization, request) {
-            if (request.name !== 'submit') {
-                return { kind: 'rejected', code: 'action-unimplemented', fields: { name: request.name } };
+            if (request.name !== SITE_SUBMIT) {
+                return {
+                    kind: 'rejected',
+                    code: 'action-unimplemented',
+                    fields: { name: request.name },
+                    retryable: false,
+                };
             }
             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) {
-                notifications.send(rooms.flatMap((room) => {
-                    const entry = tracked.get(room.locator);
-                    const at = logPosition(room.roomVersion);
-                    if (entry === undefined || at === null)
-                        return [];
-                    notifications.reach(entry.authority, at);
-                    return [presented(entry.authority, at)];
-                }));
+        roomStream: snapshot
+            ? undefined
+            : {
+                hold(rooms) {
+                    notifications.send(rooms.flatMap((room) => {
+                        const entry = tracked.get(room.locator);
+                        const at = logPosition(room.roomVersion);
+                        if (entry === undefined || at === null)
+                            return [];
+                        notifications.reach(entry.authority, at);
+                        return [presented(entry.authority, at)];
+                    }));
+                },
+                reopen: notifications.reopen,
+                observe: notifications.observe,
+                published(locator, roomVersion) {
+                    const at = logPosition(roomVersion);
+                    if (at !== null)
+                        notifications.published(locator, at);
+                },
             },
-            observe: notifications.observe,
-        },
         serviceMode: notifications.serviceMode,
     };
 }

package/dist/stream.d.ts

@@ -1,20 +1,22 @@
-import type { ConversationStream, RefreshPage, RoomStreamEvent, ServiceModeSignal } from '@agentshouse/mdruntime';
+import { type ConversationStream, type RefreshPage, type RoomStreamEvent, type ServiceModeSignal, type 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';
 export type HeldRevision = (path: string, revision: string) => boolean;
 export type StreamedAdvancement = {
     page: RefreshPage;
-    entries: readonly HouseStreamEntry[];
     schemas: ReadonlyMap<string, HouseStreamEntry>;
 };
 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;
-    advance(tracked: TrackedAuthority, from: LogPosition, holds?: HeldRevision): StreamedAdvancement | null;
+    edited(tracked: TrackedAuthority, from: LogPosition): readonly string[];
+    advance(tracked: TrackedAuthority, from: LogPosition, holds?: HeldRevision): Generator<number, StreamedAdvancement | null, void>;
     conversations: ConversationStream;
     serviceMode: ServiceModeSignal;
 };

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,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,CAoS5F"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,kBAAkB,EAEvB,KAAK,WAAW,EAChB,KAAK,eAAe,EAEpB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAEpB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAUvD,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,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,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,SAAS,MAAM,EAAE,CAAC;IACxE,OAAO,CACL,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,WAAW,EACjB,KAAK,CAAC,EAAE,YAAY,GACnB,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;IACvD,aAAa,EAAE,kBAAkB,CAAC;IAClC,WAAW,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAmFF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,kBAAkB,CA8jB5F"}