@agentshouse/mdruntime-adapter 0.1.0-ce5ef9afd7e9a → 0.1.0-ce752a56d9714

package/dist/room-stream.js

@@ -0,0 +1,78 @@
+import { stepped } from '@agentshouse/mdruntime';
+import { manifestedModels, partModels } from './model.js';
+import { roomFrames } from './part.js';
+import { bootstrapping, housePart, manifested, roomHead, } from './read.js';
+const UNCERTAIN = { kind: 'transport-uncertainty' };
+export function roomStreams(mode) {
+    const open = new Map();
+    let opened = 0;
+    async function head(entry, room, arriving, signal) {
+        const frames = roomFrames(room, arriving, signal);
+        const first = await frames();
+        if (first.kind !== 'frame')
+            return UNCERTAIN;
+        const held = await roomHead(first.payload, mode);
+        if (held === null || held.anchor !== entry.authority)
+            return UNCERTAIN;
+        const { models, seen } = await manifestedModels(held, entry);
+        opened += 1;
+        const id = String(opened);
+        open.set(id, { entry, head: held, frames, next: 1, seen });
+        signal?.addEventListener('abort', () => open.delete(id), { once: true });
+        return { ...manifested(held, `${id}:1`, models), bytes: first.bytes };
+    }
+    async function part(entry, token) {
+        const [id = '', at = ''] = token.split(':');
+        const room = open.get(id);
+        if (room === undefined || room.entry.locator !== entry.locator || String(room.next) !== at)
+            return UNCERTAIN;
+        const frame = await room.frames();
+        if (frame.kind !== 'frame') {
+            open.delete(id);
+            return UNCERTAIN;
+        }
+        const read = await housePart(room.head, frame.payload, mode);
+        if ('kind' in read) {
+            open.delete(id);
+            return read;
+        }
+        const { scope, ended } = read;
+        const first = room.next === 1;
+        room.next += 1;
+        room.seen = [
+            ...room.seen,
+            ...(scope.files.some((file) => file.path === entry.schema) ? [entry.schema] : []),
+        ];
+        if (ended)
+            open.delete(id);
+        return {
+            scope,
+            first,
+            ended,
+            models: await partModels(scope, entry, new Set(room.seen), ended),
+            pageToken: ended ? undefined : `${id}:${room.next}`,
+            bytes: frame.bytes,
+        };
+    }
+    async function named(entry, room, signal) {
+        const opened = await head(entry, room, undefined, signal);
+        if (opened.kind !== 'bootstrap')
+            return opened;
+        const files = [];
+        const contents = [];
+        let last = null;
+        for (let token = opened.pageToken; token !== undefined;) {
+            const read = await part(entry, token);
+            if ('kind' in read)
+                return read;
+            files.push(...read.scope.files);
+            contents.push(...read.scope.contents);
+            last = read.scope;
+            token = read.pageToken;
+        }
+        if (last === null)
+            return UNCERTAIN;
+        return stepped(bootstrapping({ ...last, files, contents }));
+    }
+    return { head, part, named };
+}

package/dist/room-types.d.ts

@@ -1,6 +1,7 @@
-export declare const INBOX_CHANNEL_KINDS: readonly ['telegram-bot'];
+export declare const INBOX_CHANNEL_KINDS: readonly ['telegram-bot', 'telegram-business', 'whatsapp', 'messenger', 'instagram', 'viber', 'tiktok'];
 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 CHAT_TYPE = "chat";
+export declare const CHAT_MESSAGE_TYPE = "chat-message";
+export declare const HOUSE_NAMEABLE_ROOM_TYPES: string[];
 export declare const HOUSE_ROOM_TYPES: string;
 //# sourceMappingURL=room-types.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"room-types.d.ts","sourceRoot":"","sources":["../src/room-types.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,YAC9B,cAAc,EACd,mBAAmB,EACnB,UAAU,EACV,WAAW,EACX,WAAW,EACX,OAAO,EACP,QAAQ,CACA,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,SAAS,SAAS,CAAC;AAEhC,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD,eAAO,MAAM,yBAAyB,UAAiC,CAAC;AAyBxE,eAAO,MAAM,gBAAgB,QA6FjB,CAAC"}

package/dist/room-types.js

@@ -1,6 +1,26 @@
-export const INBOX_CHANNEL_KINDS = ['telegram-bot'];
-export const INBOX_CHAT_TYPE = 'inbox-chat';
-export const INBOX_MESSAGE_TYPE = 'inbox-message';
+import { APP_REFERENCE_PATTERN } from './app-reference.js';
+import { HOUSE_MODEL_TYPES } from './house-model.js';
+export const INBOX_CHANNEL_KINDS = [
+    'telegram-bot',
+    'telegram-business',
+    'whatsapp',
+    'messenger',
+    'instagram',
+    'viber',
+    'tiktok',
+];
+export const CHAT_TYPE = 'chat';
+export const CHAT_MESSAGE_TYPE = 'chat-message';
+export const HOUSE_NAMEABLE_ROOM_TYPES = [CHAT_TYPE, CHAT_MESSAGE_TYPE];
+const WAYFINDING_MAP_TYPE = 'wayfinding-map';
+const WAYFINDING_TICKET_TYPE = 'wayfinding-ticket';
+const WAYFINDING_MAP_SECTIONS = [
+    'Destination',
+    'Notes',
+    'Decisions so far',
+    'Not yet specified',
+    'Out of scope',
+];
 const IDENTITY = "{ type: string, pattern: '^\\S+$' }";
 const AGENT = ['        agent: { type: string, format: uuid }', '        name: { type: string }'];
 const ASSIGNEE = [
@@ -10,7 +30,7 @@ const ASSIGNEE = [
     ...AGENT,
 ];
 export const HOUSE_ROOM_TYPES = [
-    `${INBOX_CHAT_TYPE}:`,
+    `${CHAT_TYPE}:`,
     '  properties:',
     '    inbox: { type: string, format: uuid }',
     `    channel: { enum: [${INBOX_CHANNEL_KINDS.join(', ')}] }`,
@@ -27,9 +47,8 @@ export const HOUSE_ROOM_TYPES = [
     '      type: object',
     '      properties:',
     ...AGENT,
-    '    conversation: { type: string, format: uuid }',
     '  required: [inbox, channel, chat, customer]',
-    `${INBOX_MESSAGE_TYPE}:`,
+    `${CHAT_MESSAGE_TYPE}:`,
     '  properties:',
     '    direction: { enum: [in, out] }',
     '    sender:',
@@ -41,6 +60,7 @@ export const HOUSE_ROOM_TYPES = [
     `    channel_message: ${IDENTITY}`,
     '    state: { enum: [sending, sent, failed] }',
     '    reason: { type: string }',
+    '    labelled: { const: true }',
     '    reactions:',
     '      type: array',
     '      items:',
@@ -59,8 +79,47 @@ export const HOUSE_ROOM_TYPES = [
     '    assignee:',
     ...ASSIGNEE,
     '    sent_outside: { const: true }',
+    '    template:',
+    '      type: object',
+    '      properties:',
+    '        name: { type: string, minLength: 1 }',
+    '        language: { type: string, minLength: 1 }',
+    '      required: [name, language]',
+    '    values:',
+    '      type: object',
+    '      additionalProperties: { type: string }',
+    '    withheld: { const: true }',
     '  required: [direction]',
     '  if: { properties: { direction: { const: in } } }',
     '  then: { required: [sent_at] }',
-    '',
+    `${WAYFINDING_MAP_TYPE}:`,
+    '  properties:',
+    '    title: { type: string }',
+    '  required: [title]',
+    '  sections:',
+    ...WAYFINDING_MAP_SECTIONS.map((name) => `    ${name}: { kind: text, required: true }`),
+    `${WAYFINDING_TICKET_TYPE}:`,
+    '  properties:',
+    '    title: { type: string }',
+    '    kind: { enum: [research, prototype, grilling, task] }',
+    '    status: { enum: [open, in-progress, done, out-of-scope] }',
+    `    map: { type: string, reference: ${WAYFINDING_MAP_TYPE} }`,
+    `    blocked_by: { type: array, items: { type: string, reference: ${WAYFINDING_TICKET_TYPE} } }`,
+    '    assignee:',
+    ...ASSIGNEE,
+    '    conversation: { type: string, format: uuid }',
+    `    app: { type: string, pattern: '${APP_REFERENCE_PATTERN.source}' }`,
+    '  required: [title, kind, status, map, blocked_by]',
+    '  sections:',
+    '    Question: { kind: text }',
+    '    Answer: { kind: text }',
+    '  allOf:',
+    '    - if: { properties: { status: { enum: [in-progress, done, out-of-scope] } }, required: [status] }',
+    '      then: { required: [assignee] }',
+    '      else: { properties: { assignee: false } }',
+    '    - if: { properties: { assignee: { required: [agent] } }, required: [assignee] }',
+    '      else: { properties: { conversation: false } }',
+    '    - if: { properties: { status: { enum: [done, out-of-scope] } }, required: [status] }',
+    '      then: { sections: { Answer: { kind: text, required: true } } }',
+    HOUSE_MODEL_TYPES,
 ].join('\n');

package/dist/search.d.ts

@@ -0,0 +1,5 @@
+import type { SearchAnswer, SearchAsk } from '@agentshouse/mdruntime';
+import type { TrackedAuthority } from './discovery.js';
+import { type HouseTransport } from './transport.js';
+export declare function houseSearch(transport: Pick<HouseTransport, 'door'>, tracked: readonly TrackedAuthority[], request: SearchAsk): Promise<SearchAnswer>;
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAa,MAAM,wBAAwB,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAsBrE,wBAAsB,WAAW,CAC/B,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,EACvC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,YAAY,CAAC,CAoBvB"}

package/dist/search.js

@@ -0,0 +1,47 @@
+import { doorRefusal } from './refusal.js';
+import { houseDoorRoute } from './transport.js';
+const ROOMS = '/rooms/';
+const UNCERTAIN = { kind: 'transport-uncertainty' };
+function hitOf(file, locators) {
+    if (typeof file !== 'object' || file === null)
+        return null;
+    const { path, line, snippet } = file;
+    if (typeof path !== 'string' || !path.startsWith(ROOMS))
+        return null;
+    const slash = path.indexOf('/', ROOMS.length);
+    if (slash < 0)
+        return null;
+    const room = locators.get(path.slice(ROOMS.length, slash));
+    if (room === undefined)
+        return null;
+    return {
+        room,
+        path: path.slice(slash + 1),
+        ...(typeof line === 'number' ? { line } : {}),
+        ...(typeof snippet === 'string' ? { snippet } : {}),
+    };
+}
+export async function houseSearch(transport, tracked, request) {
+    const named = request.rooms === null
+        ? null
+        : tracked.filter((entry) => request.rooms.includes(entry.locator));
+    if (named !== null && named.length === 0)
+        return { kind: 'found', documents: [] };
+    const answer = await transport.door(houseDoorRoute('search'), {
+        query: request.text,
+        ...(named === null ? {} : { paths: named.map((entry) => `${ROOMS}${entry.handle}`) }),
+    });
+    if (answer.status === 401)
+        return { kind: 'revoked-authorization' };
+    const refusal = doorRefusal(answer.body);
+    if (refusal !== null)
+        return { kind: 'rejected', ...refusal };
+    const files = answer.body?.files;
+    if (answer.status !== 200 || !Array.isArray(files))
+        return UNCERTAIN;
+    const locators = new Map(tracked.map((entry) => [entry.handle, entry.locator]));
+    return {
+        kind: 'found',
+        documents: files.flatMap((file) => hitOf(file, locators) ?? []),
+    };
+}

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,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"}
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAQR,MAAM,wBAAwB,CAAC;AAgBhC,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAuBxB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAsL1F"}

package/dist/site.js

@@ -1,15 +1,14 @@
 import { stepped } from '@agentshouse/mdruntime';
-import { actionOutcome, SITE_SUBMIT } from './actions.js';
+import { actionOutcome } from './actions.js';
 import { mapDiscovery, parseSiteDiscovery, siteCapabilities, siteTracked, } from './discovery.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 { bootstrapping } from './read.js';
+import { roomStreams } from './room-stream.js';
+import { classifyDoor, discoveryFailure } from './refusal.js';
+import { HOUSE_TYPED_PATHS } from './house-model.js';
+import { HOUSE_NAMEABLE_ROOM_TYPES, HOUSE_ROOM_TYPES } from './room-types.js';
 import { houseNotifications } from './stream.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';
+import { houseSiteRoute, SITE_DOOR_SUBMIT, SITE_FILES, SITE_SUBMISSION, } from './transport.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 };
@@ -25,177 +24,106 @@ function siteRoom(tracked) {
         providerOwnedPaths: [],
     };
 }
-function settled(refused) {
-    return refused.kind === 'beyond-horizon' ? UNCERTAIN : refused;
-}
 export function createSiteAdapter(transport, snapshot = false) {
-    const notifications = houseNotifications(transport, 'site');
+    const notifications = houseNotifications(transport, 'site', {
+        opened: async () => {
+            const found = await discovered();
+            return found.kind === 'discovery' ? found : null;
+        },
+        changed: () => null,
+    });
     const tracked = new Map();
-    const expired = new Map();
-    function published(referrer) {
-        const named = houseReferrer(referrer, tracked);
-        return named === null || !tracked.has(named.locator) ? null : named;
-    }
+    const read = new Map();
+    const rooms = roomStreams('site');
     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: [
-                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;
-        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));
+        const entry = tracked.get(request.locator);
+        if (entry === undefined)
+            return { kind: 'room-not-readable', locator: request.locator };
+        return `${SITE_FILES}${entry.authority}/${encodeURIComponent(request.revision)}/${encodeURIComponent(request.path)}`;
     }
-    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 classified;
-        const room = parseSiteParted(answer.body);
-        return room === null || room.anchor !== entry.authority ? UNCERTAIN : room;
+    async function openedRoom(entry, arriving, signal) {
+        const cut = read.get(entry.locator);
+        const answered = await transport.streamed(`${houseSiteRoute('bootstrap')}/${entry.authority}${cut === undefined ? '' : `?expired=${cut}`}`, signal ?? new AbortController().signal);
+        if (answered.room === null)
+            return classifyDoor(answered.status, answered.body, entry.locator) ?? UNCERTAIN;
+        const head = await rooms.head(entry, answered.room, arriving, signal);
+        const at = head.kind === 'bootstrap' ? logPosition(head.roomVersion) : null;
+        if (at !== null)
+            read.set(entry.locator, at.position);
+        return head;
     }
-    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 namedDocument(entry, path, signal) {
+        const answered = await transport.streamed(`${houseSiteRoute('bootstrap')}/${entry.authority}?path=${encodeURIComponent(path)}`, signal ?? new AbortController().signal);
+        if (answered.room === null)
+            return classifyDoor(answered.status, answered.body, entry.locator) ?? UNCERTAIN;
+        return rooms.named(entry, answered.room, signal);
     }
-    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 streamedPage(entry, token) {
+        const part = await rooms.part(entry, token);
+        if ('kind' in part)
+            return part;
+        const { folders: _folders, ...page } = await stepped(bootstrapping(part.scope));
+        return {
+            ...page,
+            ...(part.models === undefined ? {} : { models: part.models }),
+            ...(part.pageToken === undefined ? {} : { pageToken: part.pageToken }),
+            bytes: part.bytes,
+        };
     }
-    async function refreshed(entry, fromRoomVersion) {
-        const from = logPosition(fromRoomVersion);
-        if (from === null)
-            return { kind: 'beyond-horizon' };
-        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 view = await enumeration(entry, from);
-        if ('kind' in view)
-            return view;
-        notifications.reach(entry.authority, view);
-        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 };
+    async function discovered() {
+        const answer = await transport.read(houseSiteRoute('discover'));
+        const failed = discoveryFailure(answer.status, answer.body);
+        if (failed !== null)
+            return failed;
+        const document = parseSiteDiscovery(answer.body);
+        if (document === null)
+            return UNCERTAIN;
+        const entries = siteTracked(document);
+        tracked.clear();
+        for (const entry of entries)
+            tracked.set(entry.locator, entry);
+        notifications.track(entries);
+        return mapDiscovery(document, entries.map(siteRoom), siteCapabilities());
     }
     return {
         localSaves: true,
-        exhaustiveDiscovery: true,
         roomTypes: HOUSE_ROOM_TYPES,
+        nameableRoomTypes: HOUSE_NAMEABLE_ROOM_TYPES,
+        typedPaths: HOUSE_TYPED_PATHS,
         async authorize() {
             return {};
         },
-        async discover() {
-            const answer = await transport.read(SITE_DOOR_DISCOVER);
-            const failed = discoveryFailure(answer.status, answer.body);
-            if (failed !== null)
-                return failed;
-            const document = parseSiteDiscovery(answer.body);
-            if (document === null)
-                return UNCERTAIN;
-            const entries = siteTracked(document);
-            tracked.clear();
-            for (const entry of entries)
-                tracked.set(entry.locator, entry);
-            notifications.track(entries);
-            return mapDiscovery(document, entries.map(siteRoom), siteCapabilities());
-        },
         async bootstrap(_authorization, request) {
             const entry = tracked.get(request.locator);
             if (entry === undefined)
                 return { kind: 'room-not-readable', locator: request.locator };
-            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 }) } : {}),
-            };
+            if (request.path !== undefined)
+                return namedDocument(entry, request.path, request.signal);
+            return request.pageToken === undefined
+                ? openedRoom(entry, request.arriving, request.signal)
+                : streamedPage(entry, request.pageToken);
         },
-        async refresh(_authorization, request) {
-            const entry = tracked.get(request.locator);
-            if (entry === undefined)
-                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' };
+        ...(snapshot
+            ? {
+                discover: discovered,
+                async refresh(_authorization, request) {
+                    const entry = tracked.get(request.locator);
+                    if (entry === undefined)
+                        return { kind: 'room-not-readable', locator: request.locator };
+                    if (request.pageToken !== undefined)
+                        return UNCERTAIN;
+                    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: {}, retryable: false };
         },
+        async attach() {
+            return { kind: 'rejected', code: 'write-grant', fields: {}, retryable: false };
+        },
         async history() {
             return { kind: 'no-history' };
         },
@@ -220,13 +148,6 @@ export function createSiteAdapter(transport, snapshot = false) {
                 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);
         },
@@ -234,7 +155,7 @@ export function createSiteAdapter(transport, snapshot = false) {
             return followsVersion(version, next);
         },
         async action(_authorization, request) {
-            if (request.name !== SITE_SUBMIT) {
+            if (request.name !== SITE_SUBMISSION) {
                 return {
                     kind: 'rejected',
                     code: 'action-unimplemented',
@@ -244,7 +165,7 @@ export function createSiteAdapter(transport, snapshot = false) {
             }
             if (!transport.online())
                 return UNCERTAIN;
-            return actionOutcome(await transport.door(SITE_DOOR_SUBMIT, request.input), SITE_SUBMIT);
+            return actionOutcome(await transport.door(SITE_DOOR_SUBMIT, request.input), SITE_SUBMISSION, request.input);
         },
         roomStream: snapshot
             ? undefined
@@ -253,19 +174,10 @@ export function createSiteAdapter(transport, snapshot = false) {
                     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)];
+                        return entry === undefined || at === null ? [] : [presented(entry.authority, at)];
                     }));
                 },
-                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,24 +1,23 @@
-import { type ConversationStream, type RefreshPage, type RoomStreamEvent, type ServiceModeSignal, type StreamReceipts } from '@agentshouse/mdruntime';
+import { type AuthorityChange, type Discovery, type ConversationStream, type RoomStreamEvent, type ServiceModeSignal } 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;
-    schemas: ReadonlyMap<string, HouseStreamEntry>;
+import { type HouseDoor, type HouseHeldRoom, type HouseMode, type HouseStreamFrame } from './transport.js';
+export type HouseOpeningFrame = Extract<HouseStreamFrame, {
+    type: 'opening';
+}>;
+export type HouseAuthorityChangedFrame = Extract<HouseStreamFrame, {
+    type: 'authority_changed';
+}>;
+export type HouseDiscovering = {
+    opened(frame: HouseOpeningFrame | null): Promise<Discovery | null>;
+    changed(frame: HouseAuthorityChangedFrame): AuthorityChange | null;
 };
 export type HouseNotifications = {
     runtime: string;
-    observe(notify: (event: RoomStreamEvent) => void, receipts: StreamReceipts): () => void;
+    observe(notify: (event: RoomStreamEvent) => void): () => 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;
-    edited(tracked: TrackedAuthority, from: LogPosition): readonly string[];
-    advance(tracked: TrackedAuthority, from: LogPosition, holds?: HeldRevision): Generator<number, StreamedAdvancement | null, void>;
     conversations: ConversationStream;
     serviceMode: ServiceModeSignal;
 };
-export declare function houseNotifications(transport: HouseDoor, mode: HouseMode): HouseNotifications;
+export declare function houseNotifications(transport: HouseDoor, mode: HouseMode, discovering: HouseDiscovering): HouseNotifications;
 //# sourceMappingURL=stream.d.ts.map