@agentshouse/mdruntime-adapter 0.1.0-cf22c8563f9f4 → 0.1.0-cf599f631976d

package/dist/refusal.d.ts

@@ -1,12 +1,7 @@
 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 doorRefusal(body: unknown): ProviderRefusal | null;
+export declare function resetOf(refusal: ProviderRefusal | null): string | undefined;
+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(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;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,CAYrF"}
+{"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,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAG3E;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,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAQrF"}

package/dist/refusal.js

@@ -6,11 +6,15 @@ 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 resetOf(refusal) {
+    const reset = refusal?.fields.retry_at;
+    return refusal?.retryable === true && typeof reset === 'string' ? reset : undefined;
 }
 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 };
 }
 function doorFailure(status, body) {
     if (status === 0)
@@ -18,8 +22,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)
@@ -38,11 +43,6 @@ export function classifyDoor(status, body, locator) {
         return scopedRefusal(locator, failure.scope, failure.refusal);
     return failure;
 }
-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)
@@ -50,11 +50,7 @@ export function discoveryFailure(status, body) {
     if (failure.kind === 'revoked-authorization')
         return failure;
     if (failure.kind === 'refused') {
-        return {
-            kind: 'contract-unavailable',
-            code: failure.refusal.code,
-            fields: failure.refusal.fields,
-        };
+        return { kind: 'contract-unavailable', ...failure.refusal };
     }
     return { kind: 'transport-uncertainty' };
 }

package/dist/room-types.d.ts

@@ -0,0 +1,5 @@
+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 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

@@ -0,0 +1 @@
+{"version":3,"file":"room-types.d.ts","sourceRoot":"","sources":["../src/room-types.ts"],"names":[],"mappings":"AAIA,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,yBAAyB,UAAiC,CAAC;AAyBxE,eAAO,MAAM,gBAAgB,QAyFjB,CAAC"}

package/dist/room-types.js

@@ -0,0 +1,120 @@
+import { CHAT_MESSAGE_TYPE, CHAT_TYPE } from '@agentshouse/mdruntime';
+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 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 = [
+    '      type: object',
+    '      properties:',
+    '        user: { type: string, format: uuid }',
+    ...AGENT,
+];
+export const HOUSE_ROOM_TYPES = [
+    `${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,
+    '  required: [chat, customer]',
+    `${CHAT_MESSAGE_TYPE}:`,
+    '  properties:',
+    '    direction: { enum: [in, out] }',
+    '    sender:',
+    ...ASSIGNEE,
+    `        username: ${IDENTITY}`,
+    '    sent_at: { type: string, format: date-time }',
+    `    channel_message: ${IDENTITY}`,
+    '    labelled: { const: true }',
+    '    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 }',
+    '    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('rooms/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

@@ -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,EAKL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAgCxB,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,EAQR,MAAM,wBAAwB,CAAC;AAehC,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAuBxB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAiK1F"}

package/dist/site.js

@@ -1,124 +1,141 @@
 import { actionOutcome } from './actions.js';
+import { chunkedHead, chunkPart, siteChunkList } from './chunks.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, classifyRead, discoveryFailure } from './refusal.js';
+import { spaceSchemas } from './space-schema.js';
+import { 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, } from './transport.js';
-import { followsVersion, logPosition, presented, reachedVersion, roomVersion, } from './version.js';
+import { houseSiteRoute, SITE_DOOR_SUBMIT, SITE_FILES, SITES_SUBMISSIONS_CREATE, } from './transport.js';
+import { followsVersion, 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: [], erase: [] },
+        replica: { selection: tracked.locator, admission: 'admitted', offline: 'open' },
         providerOwnedPaths: [],
     };
 }
-function settled(refused) {
-    return refused.kind === 'beyond-horizon' ? UNCERTAIN : refused;
-}
-export function createSiteAdapter(transport) {
-    const notifications = houseNotifications(transport, 'site');
+export function createSiteAdapter(transport, snapshot = false) {
+    const spaces = spaceSchemas();
+    const notifications = houseNotifications(transport, 'site', {
+        opened: async () => {
+            const found = await discovered();
+            return found.kind === 'discovery' ? found : null;
+        },
+        changed: () => null,
+    }, spaces);
     const tracked = new Map();
-    async function enumeration(entry, from) {
-        const answer = await transport.door(SITE_DOOR_ENUMERATE, {
-            positions: [presented(entry.authority, from)],
-        });
-        const classified = classifyRead(answer.status, answer.body, entry.locator);
-        if (classified !== null)
-            return classified;
-        return parseEnumeration(answer.body, 'site') ?? UNCERTAIN;
+    const chunked = new Map();
+    function fileRoute(request) {
+        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 caughtUp(entry) {
-        const answer = await transport.read(`${SITE_DOOR_BOOTSTRAP}${entry.authority}`);
-        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) };
+    async function listedRoom(entry) {
+        const past = chunked.get(entry.locator)?.position;
+        const listed = siteChunkList(await transport.read(`${houseSiteRoute('chunks')}/${entry.authority}${past === undefined ? '' : `?expired=${past}`}`), entry.locator);
+        if ('kind' in listed)
+            return listed;
+        const head = await chunkedHead(listed, entry, spaces);
+        if (head.kind === 'bootstrap')
+            chunked.set(entry.locator, listed);
+        return head;
     }
-    async function refreshed(entry, fromRoomVersion) {
-        const from = logPosition(fromRoomVersion);
-        if (from === null)
-            return { kind: 'beyond-horizon' };
-        const streamed = 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 };
-        notifications.reach(entry.authority, view);
-        const answer = refreshFrom(view, fromRoomVersion);
-        if (answer.kind !== 'net-advancement')
-            return answer;
-        const models = await viewModels(view, entry);
-        return models === undefined ? answer : { ...answer, models };
+    async function chunkPage(entry, id, arriving) {
+        const room = chunked.get(entry.locator);
+        const address = room?.chunks.get(id);
+        if (room === undefined || address === undefined)
+            return UNCERTAIN;
+        const read = await transport.download(address.url);
+        if (read.status !== 200)
+            return UNCERTAIN;
+        return chunkPart(read.body, room, id, arriving);
+    }
+    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,
+        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 };
-            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 }) };
-        },
-        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 refreshed(entry, request.fromRoomVersion);
+            return request.pageToken === undefined
+                ? listedRoom(entry)
+                : chunkPage(entry, request.pageToken, request.arriving);
         },
+        ...(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' };
+                },
+            }
+            : {}),
         async mutate() {
-            return { kind: 'rejected', affected: {}, code: 'write-grant', fields: {} };
+            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' };
         },
+        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),
+            };
+        },
         reached(locator, version, target) {
             return reachedVersion(version, target, tracked.get(locator)?.logEpoch);
         },
@@ -126,26 +143,24 @@ 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 !== SITES_SUBMISSIONS_CREATE) {
+                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), SITES_SUBMISSIONS_CREATE, request.input);
         },
-        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: notifications.send,
+                observe: notifications.observe,
             },
-            observe: notifications.observe,
-        },
         serviceMode: notifications.serviceMode,
     };
 }

package/dist/space-schema.d.ts

@@ -0,0 +1,7 @@
+export type SpaceSchemas = {
+    held(space: string, revision: string): string | undefined;
+    keep(space: string, revision: string, text: string): void;
+};
+export declare function spaceSchemas(): SpaceSchemas;
+export declare function spaceIdentity(space: string): string;
+//# sourceMappingURL=space-schema.d.ts.map

package/dist/space-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-schema.d.ts","sourceRoot":"","sources":["../src/space-schema.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC1D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3D,CAAC;AAEF,wBAAgB,YAAY,IAAI,YAAY,CAY3C;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/space-schema.js

@@ -0,0 +1,18 @@
+const HELD_TEXTS = 16;
+export function spaceSchemas() {
+    const texts = new Map();
+    const key = (space, revision) => `${space} ${revision}`;
+    return {
+        held: (space, revision) => texts.get(key(space, revision)),
+        keep(space, revision, text) {
+            const named = key(space, revision);
+            texts.delete(named);
+            texts.set(named, text);
+            if (texts.size > HELD_TEXTS)
+                texts.delete(texts.keys().next().value);
+        },
+    };
+}
+export function spaceIdentity(space) {
+    return `space:${space}`;
+}

package/dist/stream.d.ts

@@ -1,22 +1,25 @@
-import type { ConversationStream, RefreshPage, RoomStreamEvent, ServiceModeSignal } from '@agentshouse/mdruntime';
+import { type AuthorityChange, type Discovery, type ConversationStream, type HeldRoom, 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;
-    entries: readonly HouseStreamEntry[];
-    schemas: ReadonlyMap<string, HouseStreamEntry>;
+import type { SpaceSchemas } from './space-schema.js';
+import { type HouseDoor, 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;
+    expired?(authorities: readonly string[]): void;
 };
 export type HouseNotifications = {
     runtime: string;
     observe(notify: (event: RoomStreamEvent) => void): () => void;
-    send(rooms: readonly HouseHeldRoom[]): void;
+    send(rooms: readonly HeldRoom[]): void;
     track(authorities: readonly TrackedAuthority[]): void;
-    reach(authority: string, at: LogPosition): void;
-    advance(tracked: TrackedAuthority, from: LogPosition, holds?: HeldRevision): StreamedAdvancement | null;
     conversations: ConversationStream;
     serviceMode: ServiceModeSignal;
 };
-export declare function houseNotifications(transport: HouseDoor, mode: HouseMode): HouseNotifications;
+export declare function houseNotifications(transport: HouseDoor, mode: HouseMode, discovering: HouseDiscovering, spaces: SpaceSchemas): HouseNotifications;
 //# sourceMappingURL=stream.d.ts.map

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,eAAe,EAEpB,KAAK,SAAS,EACd,KAAK,kBAAkB,EAEvB,KAAK,QAAQ,EAGb,KAAK,eAAe,EAEpB,KAAK,iBAAiB,EAEvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWtD,OAAO,EAEL,KAAK,SAAS,EAEd,KAAK,SAAS,EAGd,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAaxB,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAE/E,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAAC,gBAAgB,EAAE;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAAC;AAElG,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,KAAK,EAAE,0BAA0B,GAAG,eAAe,GAAG,IAAI,CAAC;IACnE,OAAO,CAAC,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,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,QAAQ,EAAE,GAAG,IAAI,CAAC;IACvC,KAAK,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI,CAAC;IACtD,aAAa,EAAE,kBAAkB,CAAC;IAClC,WAAW,EAAE,iBAAiB,CAAC;CAChC,CAAC;AA6FF,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,SAAS,EACf,WAAW,EAAE,gBAAgB,EAC7B,MAAM,EAAE,YAAY,GACnB,kBAAkB,CA8XpB"}