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

package/dist/read.d.ts

@@ -1,4 +1,4 @@
-import type { BootstrapPage, RefreshResult, RoomAttachment } from '@agentshouse/mdruntime';
+import type { BinaryFile, BootstrapPage, RefreshResult } from '@agentshouse/mdruntime';
 import type { TrackedAuthority } from './discovery.js';
 import type { HouseMode } from './transport.js';
 import { type LogPosition } from './version.js';
@@ -8,6 +8,7 @@ export type HouseManifestFile = {
     revision: string | undefined;
     version: string;
     head?: HeadChange;
+    binary?: BinaryFile;
 };
 export type HouseContent = {
     path: string;
@@ -17,10 +18,14 @@ export type HouseScope = LogPosition & {
     anchor: string;
     files: readonly HouseManifestFile[];
     contents: readonly HouseContent[];
-    attachments?: readonly RoomAttachment[];
+};
+export type HouseCursor = {
+    room: string;
+    path: string | null;
 };
 export type HouseEnvelope = {
     scopes: readonly HouseScope[];
+    next?: HouseCursor;
 };
 export type HouseGrant = {
     method: 'GET';
@@ -41,14 +46,14 @@ export type HouseChange = {
     head?: HeadChange;
 } | {
     path: string;
-    reference: {
-        revision: string;
-    };
+    binary: BinaryFile;
+    revision: string | undefined;
+    version: string;
+    head?: HeadChange;
 };
 export type HouseView = LogPosition & {
     authority: string;
     changes: readonly HouseChange[];
-    attachments?: readonly RoomAttachment[];
 };
 export type HouseEnumeration = {
     authorities: readonly HouseView[];
@@ -61,7 +66,7 @@ export declare function headChange(held: {
     readonly author?: unknown;
     readonly created_at?: unknown;
 }): HeadChange | undefined | null;
-export declare function parseOriginals(value: unknown): readonly RoomAttachment[] | null;
+export declare function binaryFileOf(held: Readonly<Record<string, unknown>>): BinaryFile | undefined | null;
 export declare function parseEnvelope(body: unknown): HouseEnvelope | null;
 export declare function parseSiteBootstrap(body: unknown): HouseScope | null;
 export declare function parseEnumeration(body: unknown, mode: HouseMode): HouseEnumeration | null;
@@ -71,6 +76,7 @@ export declare function bootstrapOf(scope: HouseScope): BootstrapPage;
 export type HouseSchema = {
     schema: string | null;
     version: string | null;
+    revision: string | null;
 };
 export declare function schemaOf(scope: HouseScope, schema: string): HouseSchema | null;
 export declare function viewOf(enumeration: HouseEnumeration, tracked: TrackedAuthority): HouseView | undefined;

package/dist/read.d.ts.map

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

package/dist/read.js

@@ -51,32 +51,19 @@ export function headChange(held) {
 function headed(head) {
     return head === undefined ? {} : { head };
 }
-function parseOriginal(value) {
-    if (typeof value !== 'object' || value === null)
-        return null;
-    const { attachment, name, bytes, media_type: mediaType } = value;
-    if (typeof attachment !== 'string' || typeof name !== 'string')
-        return null;
-    if (typeof bytes !== 'number' || !Number.isSafeInteger(bytes) || bytes < 0)
-        return null;
-    if (mediaType !== null && typeof mediaType !== 'string')
+export function binaryFileOf(held) {
+    if (held.file === undefined)
+        return undefined;
+    const { file, bytes, media_type: mediaType, sha256 } = held;
+    if (typeof file !== 'string' ||
+        typeof bytes !== 'number' ||
+        typeof mediaType !== 'string' ||
+        typeof sha256 !== 'string')
         return null;
-    return { reference: attachment, name, byteLength: bytes, mediaType, entry: value };
+    return { fileRef: file, byteLength: bytes, mediaType, sha256 };
 }
-export function parseOriginals(value) {
-    if (!Array.isArray(value))
-        return null;
-    const attachments = [];
-    for (const entry of value) {
-        const attachment = parseOriginal(entry);
-        if (attachment === null)
-            return null;
-        attachments.push(attachment);
-    }
-    return attachments;
-}
-function declared(attachments) {
-    return attachments === undefined ? {} : { attachments };
+function binaried(binary) {
+    return binary === undefined ? {} : { binary };
 }
 function parseFile(value, mode) {
     if (typeof value !== 'object' || value === null)
@@ -85,16 +72,29 @@ function parseFile(value, mode) {
     if (typeof file.path !== 'string')
         return null;
     const head = headChange(file);
-    if (head === null)
+    const binary = binaryFileOf(file);
+    if (head === null || binary === null)
         return null;
     if (mode === 'site') {
         if (typeof file.sha256 !== 'string')
             return null;
-        return { path: file.path, revision: undefined, version: file.sha256, ...headed(head) };
+        return {
+            path: file.path,
+            revision: binary?.sha256,
+            version: file.sha256,
+            ...headed(head),
+            ...binaried(binary),
+        };
     }
     if (typeof file.revision !== 'string')
         return null;
-    return { path: file.path, revision: file.revision, version: file.revision, ...headed(head) };
+    return {
+        path: file.path,
+        revision: file.revision,
+        version: file.revision,
+        ...headed(head),
+        ...binaried(binary),
+    };
 }
 function parseScope(value, mode) {
     if (typeof value !== 'object' || value === null)
@@ -130,12 +130,15 @@ function parseScope(value, mode) {
             return null;
         contents.push({ path: content.path, content: content.content });
     }
-    if (mode === 'site')
-        return { anchor: manifest.anchor, ...at, files, contents };
-    const attachments = parseOriginals(held.originals);
-    if (attachments === null)
+    return { anchor: manifest.anchor, ...at, files, contents };
+}
+function parseCursor(value) {
+    if (typeof value !== 'object' || value === null)
+        return null;
+    const { room, path } = value;
+    if (typeof room !== 'string' || (path !== null && typeof path !== 'string'))
         return null;
-    return { anchor: manifest.anchor, ...at, files, contents, attachments };
+    return { room, path };
 }
 export function parseEnvelope(body) {
     if (typeof body !== 'object' || body === null)
@@ -149,7 +152,10 @@ export function parseEnvelope(body) {
             return null;
         scopes.push(scope);
     }
-    return { scopes };
+    if (!('next' in body) || body.next === undefined)
+        return { scopes };
+    const next = parseCursor(body.next);
+    return next === null ? null : { scopes, next };
 }
 export function parseSiteBootstrap(body) {
     return parseScope(body, 'site');
@@ -163,8 +169,15 @@ function parseChange(value, mode) {
     if (held.removed === true)
         return { path: held.path, removed: true };
     const head = headChange(held);
-    if (head === null)
+    const binary = binaryFileOf(held);
+    if (head === null || binary === null)
         return null;
+    if (binary !== undefined) {
+        if (mode === 'credential' && typeof held.revision !== 'string')
+            return null;
+        const revision = typeof held.revision === 'string' ? held.revision : binary.sha256;
+        return { path: held.path, binary, revision, version: revision, ...headed(head) };
+    }
     if (mode === 'site') {
         if (typeof held.content !== 'string' || typeof held.sha256 !== 'string')
             return null;
@@ -185,12 +198,6 @@ function parseChange(value, mode) {
             ...headed(head),
         };
     }
-    if (typeof held.reference === 'object' && held.reference !== null) {
-        const reference = held.reference;
-        if (typeof reference.revision !== 'string')
-            return null;
-        return { path: held.path, reference: { revision: reference.revision } };
-    }
     return null;
 }
 export function parseEnumeration(body, mode) {
@@ -215,14 +222,7 @@ export function parseEnumeration(body, mode) {
                 return null;
             changes.push(mapped);
         }
-        if (mode === 'site') {
-            authorities.push({ authority: held.authority, ...at, changes });
-            continue;
-        }
-        const attachments = parseOriginals(held.originals);
-        if (attachments === null)
-            return null;
-        authorities.push({ authority: held.authority, ...at, changes, attachments });
+        authorities.push({ authority: held.authority, ...at, changes });
     }
     return { authorities };
 }
@@ -234,18 +234,15 @@ export function advancedScope(scope, view) {
         contents.delete(change.path);
         if ('removed' in change)
             continue;
-        if ('content' in change) {
-            files.set(change.path, {
-                path: change.path,
-                revision: change.revision,
-                version: change.version,
-                ...headed(change.head),
-            });
+        files.set(change.path, {
+            path: change.path,
+            revision: change.revision,
+            version: change.version,
+            ...headed(change.head),
+            ...('binary' in change ? { binary: change.binary } : {}),
+        });
+        if ('content' in change)
             contents.set(change.path, change.content);
-            continue;
-        }
-        const { revision } = change.reference;
-        files.set(change.path, { path: change.path, revision, version: revision });
     }
     return {
         ...scope,
@@ -263,16 +260,16 @@ export function bootstrapOf(scope) {
     const documents = {};
     const revisions = {};
     const changes = {};
-    const binaryTargets = [];
+    const binaryFiles = {};
     for (const file of scope.files) {
         if (file.revision !== undefined)
             revisions[file.path] = file.revision;
         if (file.head !== undefined)
             changes[file.path] = file.head;
         const content = contents.get(file.path);
-        if (content === undefined)
-            binaryTargets.push(file.path);
-        else
+        if (file.binary !== undefined)
+            binaryFiles[file.path] = file.binary;
+        else if (content !== undefined)
             documents[file.path] = content;
     }
     return {
@@ -281,16 +278,17 @@ export function bootstrapOf(scope) {
         documents,
         revisions,
         changes,
-        binaryTargets: binaryTargets.sort(),
-        ...declared(scope.attachments),
+        binaryFiles,
     };
 }
 export function schemaOf(scope, schema) {
     const file = scope.files.find((entry) => entry.path === schema);
     if (file === undefined)
-        return { schema: null, version: null };
+        return { schema: null, version: null, revision: null };
     const content = scope.contents.find((entry) => entry.path === schema);
-    return content === undefined ? null : { schema: content.content, version: file.version };
+    return content === undefined
+        ? null
+        : { schema: content.content, version: file.version, revision: file.revision ?? null };
 }
 export function viewOf(enumeration, tracked) {
     return enumeration.authorities.find((entry) => entry.authority === tracked.authority);
@@ -301,23 +299,21 @@ export function refreshFrom(view, fromRoomVersion) {
     const documents = {};
     const revisions = {};
     const changes = {};
-    const binaryTargets = [];
+    const binaryFiles = {};
     const removals = [];
     for (const change of view.changes) {
         if ('removed' in change) {
             removals.push(change.path);
             continue;
         }
-        if ('content' in change) {
+        if ('content' in change)
             documents[change.path] = change.content;
-            if (change.revision !== undefined)
-                revisions[change.path] = change.revision;
-            if (change.head !== undefined)
-                changes[change.path] = change.head;
-            continue;
-        }
-        binaryTargets.push(change.path);
-        revisions[change.path] = change.reference.revision;
+        else
+            binaryFiles[change.path] = change.binary;
+        if (change.revision !== undefined)
+            revisions[change.path] = change.revision;
+        if (change.head !== undefined)
+            changes[change.path] = change.head;
     }
     return {
         kind: 'net-advancement',
@@ -325,8 +321,7 @@ export function refreshFrom(view, fromRoomVersion) {
         documents,
         revisions,
         changes,
-        binaryTargets: binaryTargets.sort(),
+        binaryFiles,
         removals: removals.sort(),
-        ...declared(view.attachments),
     };
 }

package/dist/referrer.d.ts

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

package/dist/referrer.d.ts.map

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

package/dist/referrer.js

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

package/dist/refusal.d.ts

@@ -1,9 +1,6 @@
 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 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';

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,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAC7B,OAAO,EAAE,eAAe,GACvB,aAAa,CAEf;AAmBD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,cAAc,GAAG,IAAI,CAMvB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAAG,IAAI,CAGpD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAQrF"}

package/dist/refusal.js

@@ -6,11 +6,11 @@ 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 };
 }
 function doorFailure(status, body) {
     if (status === 0)
@@ -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/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,EAOR,MAAM,wBAAwB,CAAC;AAsBhC,OAAO,EAOL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAiCxB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,GAAG,OAAO,CA8KxE"}

package/dist/site.js

@@ -1,10 +1,11 @@
-import { actionOutcome } from './actions.js';
+import { actionOutcome, SITE_SUBMIT } from './actions.js';
 import { mapDiscovery, parseSiteDiscovery, siteCapabilities, siteTracked, } from './discovery.js';
 import { scopeModels, streamedModels, viewModels } from './model.js';
 import { advancedScope, bootstrapOf, parseEnumeration, parseSiteBootstrap, refreshFrom, viewOf, } from './read.js';
 import { classifyDoor, classifyRead, discoveryFailure } from './refusal.js';
 import { houseNotifications } from './stream.js';
-import { SITE_DOOR_BOOTSTRAP, SITE_DOOR_DISCOVER, SITE_DOOR_ENUMERATE, SITE_DOOR_SUBMIT, } from './transport.js';
+import { SITE_DOOR_BOOTSTRAP, SITE_DOOR_DISCOVER, SITE_DOOR_ENUMERATE, SITE_DOOR_SUBMIT, SITE_FILE_RECORD, SITE_FILES, } from './transport.js';
+import { houseReferrer } from './referrer.js';
 import { followsVersion, logPosition, presented, reachedVersion, roomVersion, } from './version.js';
 const UNCERTAIN = { kind: 'transport-uncertainty' };
 function siteRoom(tracked) {
@@ -24,6 +25,10 @@ function settled(refused) {
 export function createSiteAdapter(transport) {
     const notifications = houseNotifications(transport, 'site');
     const tracked = new Map();
+    function published(referrer) {
+        const named = houseReferrer(referrer, tracked);
+        return named === null || !tracked.has(named.locator) ? null : named;
+    }
     async function enumeration(entry, from) {
         const answer = await transport.door(SITE_DOOR_ENUMERATE, {
             positions: [presented(entry.authority, from)],
@@ -74,6 +79,7 @@ export function createSiteAdapter(transport) {
         return models === undefined ? answer : { ...answer, models };
     }
     return {
+        localSaves: true,
         async authorize() {
             return {};
         },
@@ -114,11 +120,37 @@ export function createSiteAdapter(transport) {
             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 named = published(request.kind === 'path' ? { room: request.locator, path: request.path } : request.referrer);
+            if (named === null) {
+                return { kind: 'rejected', code: 'referrer_unknown', fields: {}, retryable: false };
+            }
+            if (request.fileRef === undefined) {
+                return { kind: 'rejected', code: 'file_not_found', fields: {}, retryable: false };
+            }
+            const { room_ref, path, record } = named.referrer;
+            const read = await transport.download(`${SITE_FILES}${room_ref}/${encodeURIComponent(request.fileRef)}/${path === undefined
+                ? `${SITE_FILE_RECORD}/${encodeURIComponent(record)}`
+                : encodeURIComponent(path)}`);
+            if (read.status === 404) {
+                return { kind: 'rejected', code: 'file_not_found', fields: {}, retryable: false };
+            }
+            return read.status === 200 && read.blob !== null
+                ? { kind: 'binary', blob: read.blob }
+                : UNCERTAIN;
+        },
+        referrerScope(referrer) {
+            const named = published(referrer);
+            if (named === null)
+                return null;
+            const { path } = named.referrer;
+            return { kind: 'room', locator: named.locator, ...(path === undefined ? {} : { path }) };
+        },
         reached(locator, version, target) {
             return reachedVersion(version, target, tracked.get(locator)?.logEpoch);
         },
@@ -126,12 +158,17 @@ 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) {
@@ -144,6 +181,7 @@ export function createSiteAdapter(transport) {
                     return [presented(entry.authority, at)];
                 }));
             },
+            reopen: notifications.reopen,
             observe: notifications.observe,
         },
         serviceMode: notifications.serviceMode,

package/dist/stream.d.ts

@@ -12,6 +12,7 @@ export type HouseNotifications = {
     runtime: string;
     observe(notify: (event: RoomStreamEvent) => void): () => void;
     send(rooms: readonly HouseHeldRoom[]): void;
+    reopen(): void;
     track(authorities: readonly TrackedAuthority[]): void;
     reach(authority: string, at: LogPosition): void;
     advance(tracked: TrackedAuthority, from: LogPosition, holds?: HeldRevision): StreamedAdvancement | null;

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,KAAK,EAGV,kBAAkB,EAElB,WAAW,EACX,eAAe,EAEf,iBAAiB,EAElB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EAEb,SAAS,EAET,gBAAgB,EAEjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAgB7D,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;AAEvE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC9D,IAAI,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,CAAC;IAC5C,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI,CAAC;IACtD,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAAC;IAChD,OAAO,CACL,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,WAAW,EACjB,KAAK,CAAC,EAAE,YAAY,GACnB,mBAAmB,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,kBAAkB,CAAC;IAClC,WAAW,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAuBF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,kBAAkB,CA8S5F"}

package/dist/stream.js

@@ -1,5 +1,5 @@
 import { acceptedMessage } from './actions.js';
-import { headChange } from './read.js';
+import { binaryFileOf, headChange } from './read.js';
 import { roomVersion } from './version.js';
 const HELD_FRAMES_MAX = 256;
 function turnOperation(frame) {
@@ -222,6 +222,11 @@ export function houseNotifications(transport, mode) {
             opening = null;
             current?.hold(rooms, runtime);
         },
+        reopen() {
+            const current = opening;
+            opening = null;
+            current?.close();
+        },
         track(entries) {
             locators.clear();
             for (const entry of entries) {
@@ -260,6 +265,7 @@ export function houseNotifications(transport, mode) {
             const documents = {};
             const revisions = {};
             const changes = {};
+            const binaryFiles = {};
             const removals = [];
             const applied = [];
             const schemas = new Map();
@@ -267,6 +273,7 @@ export function houseNotifications(transport, mode) {
                 delete documents[path];
                 delete revisions[path];
                 delete changes[path];
+                delete binaryFiles[path];
                 const removed = removals.indexOf(path);
                 if (removed !== -1)
                     removals.splice(removed, 1);
@@ -287,7 +294,8 @@ export function houseNotifications(transport, mode) {
                         removals.push(entry.path);
                         continue;
                     }
-                    if (entry.text === undefined)
+                    const binary = binaryFileOf(entry);
+                    if (binary === null || (binary === undefined && entry.text === undefined))
                         return null;
                     if (mode === 'credential' && entry.revision === undefined)
                         return null;
@@ -295,9 +303,13 @@ export function houseNotifications(transport, mode) {
                     if (head === null)
                         return null;
                     forget(entry.path);
-                    documents[entry.path] = entry.text;
-                    if (entry.revision !== undefined)
-                        revisions[entry.path] = entry.revision;
+                    if (binary === undefined)
+                        documents[entry.path] = entry.text;
+                    else
+                        binaryFiles[entry.path] = binary;
+                    const revision = entry.revision ?? binary?.sha256;
+                    if (revision !== undefined)
+                        revisions[entry.path] = revision;
                     if (head !== undefined)
                         changes[entry.path] = head;
                 }
@@ -311,7 +323,7 @@ export function houseNotifications(transport, mode) {
                     documents,
                     revisions,
                     changes,
-                    binaryTargets: [],
+                    binaryFiles,
                     removals: removals.sort(),
                 },
                 entries: applied,