@agentshouse/mdruntime-adapter 0.1.0-cb89e0425af50 → 0.1.0-cbbc9b36e7fd4

package/dist/adapter.js

@@ -2,22 +2,51 @@ import { DISCOVER_PREFIXES, capabilities, discoveredRoom, mapDiscovery, parseDis
 import { partModels, streamedModels, viewModels } from './model.js';
 import { gathered, gatheredEach, selections } from './gather.js';
 import { createSiteAdapter } from './site.js';
-import { bootstrapOf, contentPrefixes, matchesScope, parseEnumeration, parseEnvelope, parseGrant, refreshFrom, viewOf, } from './read.js';
-import { acceptedLinks, enumeratedLinks, heldLinks, scopeLinks, streamedLinks, } from './links.js';
+import { bootstrapOf, contentPrefixes, matchesScope, parseEnumeration, parseEnvelope, parseGrant, refreshFrom, viewOf, wholeView, } from './read.js';
+import { sha256Hex } from './digest.js';
+import { acceptedHanded, enumeratedHanded, heldHanded, scopeHanded, streamedHanded, } from './handed.js';
 import { houseAction } from './actions.js';
 import { classifyDoor, classifyRead, discoveryFailure, doorRefusal } from './refusal.js';
 import { houseNotifications } from './stream.js';
-import { DOOR_BATCH, DOOR_BATCH_UPLOAD, DOOR_BOOTSTRAP, DOOR_DISCOVER, DOOR_ENUMERATE, DOOR_REVISIONS, } from './transport.js';
+import { DOOR_BATCH, DOOR_BATCH_UPLOAD, DOOR_BOOTSTRAP, DOOR_DISCOVER, DOOR_ENUMERATE, DOOR_FILES_GET, DOOR_REVISIONS, } from './transport.js';
 import { batchPaths, deltaBody, deltaBytes, deltaDigest, historyOutcome, houseChanges, mutationOutcome, operationHead, rejectedMapping, revisionBody, uploadable, } from './write.js';
+import { houseReferrer } from './referrer.js';
 import { followsVersion, logPosition, presented, reachedVersion, roomVersion, } from './version.js';
 const UNCERTAIN = { kind: 'transport-uncertainty' };
 const UNCERTAIN_READ = { kind: 'transport-uncertainty' };
 function lapsedGrant(outcome) {
     return outcome.kind === 'rejected' && outcome.code === 'upload_unavailable';
 }
+function heldFiles(authority, held, after, budget) {
+    if (held === undefined || budget === 0)
+        return null;
+    const paths = Object.keys(held.revisions)
+        .filter((path) => held.documents[path] !== undefined && (after === null || path > after))
+        .sort();
+    if (paths.length === 0)
+        return null;
+    const files = paths.slice(0, budget).map((path) => ({ path, revision: held.revisions[path] }));
+    return { room: authority, through: paths.length > budget ? files.at(-1).path : null, files };
+}
+async function reused(scope, held) {
+    const sent = new Set(scope.contents.map((entry) => entry.path));
+    const contents = [...scope.contents];
+    for (const file of scope.files) {
+        if (file.binary !== undefined || sent.has(file.path))
+            continue;
+        const content = held?.documents[file.path];
+        if (content === undefined ||
+            held?.revisions[file.path] !== file.revision ||
+            (await sha256Hex(content)) !== file.sha256) {
+            return null;
+        }
+        contents.push({ path: file.path, content });
+    }
+    return { ...scope, contents };
+}
 export function createAgentsHouseAdapter(options) {
     if ('site' in options)
-        return createSiteAdapter(options.site);
+        return createSiteAdapter(options.site, options.snapshot === true);
     const transport = options.transport;
     const notifications = houseNotifications(transport, 'credential');
     const tracked = new Map();
@@ -28,12 +57,22 @@ export function createAgentsHouseAdapter(options) {
             throw new Error('no Discovery declared the bounds');
         return bounds;
     }
-    async function bootstrappedRoom(envelope, scope, entry, continued) {
-        if (scope === undefined)
+    async function bootstrappedRoom(envelope, sent, asked, continued) {
+        const { entry } = asked;
+        if (sent === undefined)
             return { kind: 'room-not-readable', locator: entry.locator };
-        const next = envelope.next?.room === entry.authority ? envelope.next.path : null;
+        const scope = await reused(sent, asked.held);
+        if (scope === null) {
+            return asked.held === undefined
+                ? UNCERTAIN_READ
+                : continued === null
+                    ? bootstrapTogether({ entry, held: undefined })
+                    : continuedBootstrap({ entry, held: undefined }, continued);
+        }
+        const cursor = envelope.next?.room === entry.authority ? envelope.next : undefined;
+        const next = cursor?.path ?? null;
         if (continued === null && next === null)
-            handed.set(entry.locator, scopeLinks(scope));
+            handed.set(entry.locator, scopeHanded(scope));
         else
             handed.delete(entry.locator);
         notifications.reach(entry.authority, scope);
@@ -42,67 +81,91 @@ export function createAgentsHouseAdapter(options) {
             ...entry.schemas.filter((schema) => scope.files.some((file) => file.path === schema)),
         ];
         const models = await partModels(scope, entry, new Set(seen), next === null);
-        const continuation = next === null ? null : { after: next, seen };
+        const continuation = next === null
+            ? null
+            : { after: next, seen, ...(cursor?.cut === undefined ? {} : { cut: cursor.cut }) };
         return {
             ...bootstrapOf(scope),
             ...(models === undefined ? {} : { models }),
             ...(continuation === null ? {} : { pageToken: JSON.stringify(continuation) }),
         };
     }
+    async function enumeratedPage(ask, page) {
+        const answer = await transport.door(DOOR_ENUMERATE, {
+            prefixes: contentPrefixes(ask.entry),
+            positions: [
+                {
+                    ...presented(ask.entry.authority, { position: page.after, logEpoch: ask.from.logEpoch }),
+                    page: { through: page.through, read: page.read },
+                },
+            ],
+        });
+        const failure = classifyRead(answer.status, answer.body, ask.entry.locator);
+        if (failure !== null)
+            return failure;
+        const enumeration = parseEnumeration(answer.body, 'credential');
+        if (enumeration === null)
+            return UNCERTAIN_READ;
+        return (viewOf(enumeration, ask.entry) ?? { kind: 'room-not-readable', locator: ask.entry.locator });
+    }
     async function enumeratedRoom(enumeration, ask) {
-        const view = viewOf(enumeration, ask.entry);
-        if (view === undefined)
+        const first = viewOf(enumeration, ask.entry);
+        if (first === undefined)
             return { kind: 'room-not-readable', locator: ask.entry.locator };
+        const view = await wholeView(first, (page) => enumeratedPage(ask, page));
+        if ('kind' in view)
+            return view;
         notifications.reach(ask.entry.authority, view);
         const answer = refreshFrom(view, ask.fromRoomVersion);
         if (answer.kind !== 'net-advancement')
             return answer;
-        handed.set(ask.entry.locator, enumeratedLinks(view, handed.get(ask.entry.locator)));
+        handed.set(ask.entry.locator, enumeratedHanded(view, handed.get(ask.entry.locator)));
         const models = await viewModels(view, ask.entry);
         return models === undefined ? answer : { ...answer, models };
     }
     async function streamed(entry, request, from) {
-        const links = handed.get(entry.locator);
-        if (links?.roomVersion !== request.fromRoomVersion)
+        const held = handed.get(entry.locator);
+        if (held?.roomVersion !== request.fromRoomVersion)
             return null;
-        const advanced = notifications.advance(entry, from, (path, revision) => links.revisions.get(path) === revision);
+        const advanced = notifications.advance(entry, from, (path, revision) => held.revisions.get(path) === revision);
         if (advanced === null)
             return null;
-        const relinked = streamedLinks(links, advanced);
-        if (relinked === null)
-            return null;
-        handed.set(entry.locator, relinked);
+        handed.set(entry.locator, streamedHanded(held, advanced));
         const models = await streamedModels(advanced.schemas, entry, 'credential');
         return models === undefined ? advanced.page : { ...advanced.page, models };
     }
-    function held(rooms) {
+    function held(rooms, demand) {
         const kept = rooms.flatMap((room) => {
             const entry = tracked.get(room.locator);
             const at = logPosition(room.roomVersion);
             if (entry === undefined || at === null)
                 return [];
-            handed.set(room.locator, heldLinks(room));
+            handed.set(room.locator, heldHanded(room));
             notifications.reach(entry.authority, at);
             return [presented(entry.authority, at)];
         });
-        notifications.send(kept);
+        notifications.send(kept, demand === null
+            ? null
+            : {
+                rooms: demand.rooms.flatMap((locator) => {
+                    const entry = tracked.get(locator);
+                    return entry === undefined ? [] : [entry.authority];
+                }),
+                conversations: demand.conversations,
+            });
     }
     function adopted(entry, outcome) {
         if (outcome.kind !== 'accepted')
             return outcome;
-        const { originals, ...accepted } = outcome;
-        const links = handed.get(entry.locator);
-        if (links === undefined)
-            return accepted;
-        const follows = followsVersion(links.roomVersion, accepted.roomVersion);
-        const relinked = acceptedLinks(links, accepted, follows ? accepted.roomVersion : links.roomVersion, originals);
-        handed.set(entry.locator, relinked.links);
-        const at = logPosition(accepted.roomVersion);
+        const held = handed.get(entry.locator);
+        if (held === undefined)
+            return outcome;
+        const follows = followsVersion(held.roomVersion, outcome.roomVersion);
+        handed.set(entry.locator, acceptedHanded(held, outcome, follows ? outcome.roomVersion : held.roomVersion));
+        const at = logPosition(outcome.roomVersion);
         if (follows && at !== null)
             notifications.reach(entry.authority, at);
-        return relinked.attachments === undefined
-            ? accepted
-            : { ...accepted, attachments: relinked.attachments };
+        return outcome;
     }
     function authorityFor(locator) {
         return tracked.get(locator);
@@ -124,13 +187,19 @@ export function createAgentsHouseAdapter(options) {
     function weight(entry) {
         return contentPrefixes(entry).length;
     }
-    async function bootstrapped(entries, answer) {
-        let open = entries.map((entry, ask) => ({ entry, ask }));
+    function holding(asks, after) {
+        const budget = Math.floor(declared().max_held_files / Math.max(1, asks.filter((ask) => ask.held !== undefined).length));
+        return asks.flatMap((ask) => heldFiles(ask.entry.authority, ask.held, after, budget) ?? []);
+    }
+    async function bootstrapped(asks, answer) {
+        let open = asks.map((asked, ask) => ({ entry: asked.entry, asked, ask }));
         while (open.length > 0) {
             const unreached = [];
             for (const part of selections(open, ({ entry }) => weight(entry), declared().max_prefixes)) {
+                const held = holding(part.map(({ asked }) => asked), null);
                 const answered = await transport.door(DOOR_BOOTSTRAP, {
                     prefixes: part.flatMap(({ entry }) => contentPrefixes(entry)),
+                    ...(held.length === 0 ? {} : { held }),
                 });
                 const classified = part.map(({ entry }) => classifyDoor(answered.status, answered.body, entry.locator));
                 const envelope = classified[0] === null ? parseEnvelope(answered.body) : null;
@@ -149,71 +218,79 @@ export function createAgentsHouseAdapter(options) {
                         unreached.push(asked);
                         continue;
                     }
-                    answer(asked.ask, await bootstrappedRoom(envelope, scope, asked.entry, null));
+                    answer(asked.ask, await bootstrappedRoom(envelope, scope, asked.asked, null));
                 }
             }
             open = unreached;
         }
     }
-    async function continuedBootstrap(entry, continued) {
-        const after = { room: entry.authority, path: continued.after };
+    async function continuedBootstrap(asked, continued) {
+        const { entry } = asked;
+        const after = {
+            room: entry.authority,
+            path: continued.after,
+            ...(continued.cut === undefined ? {} : { cut: continued.cut }),
+        };
+        const held = holding([asked], continued.after);
         const answered = await transport.door(DOOR_BOOTSTRAP, {
             prefixes: contentPrefixes(entry),
             after,
+            ...(held.length === 0 ? {} : { held }),
         });
-        const failure = classifyDoor(answered.status, answered.body, entry.locator);
+        const failure = classifyRead(answered.status, answered.body, entry.locator);
         if (failure !== null)
             return failure;
         const envelope = parseEnvelope(answered.body);
         if (envelope === null)
             return UNCERTAIN_READ;
         const scope = envelope.scopes.find((candidate) => matchesScope(candidate, entry));
-        return bootstrappedRoom(envelope, scope, entry, continued);
+        return bootstrappedRoom(envelope, scope, asked, continued);
     }
     function layered(asks) {
         const depths = new Map();
         const layers = [];
         for (const ask of asks) {
-            const depth = depths.get(ask.entry.authority) ?? 0;
-            depths.set(ask.entry.authority, depth + 1);
+            const depth = depths.get(ask.ask.entry.authority) ?? 0;
+            depths.set(ask.ask.entry.authority, depth + 1);
             (layers[depth] ??= []).push(ask);
         }
         return layers;
     }
     async function enumerated(asks) {
-        const answers = new Map();
-        const parts = layered(asks).flatMap((layer) => selections(layer, (ask) => weight(ask.entry), declared().max_prefixes));
+        const answers = [];
+        const parts = layered(asks.map((ask, index) => ({ ask, index }))).flatMap((layer) => selections(layer, ({ ask }) => weight(ask.entry), declared().max_prefixes));
         for (const part of parts) {
             let open = [...part];
             while (open.length > 0) {
                 const answer = await transport.door(DOOR_ENUMERATE, {
-                    prefixes: open.flatMap((ask) => contentPrefixes(ask.entry)),
-                    positions: open.map((ask) => presented(ask.entry.authority, ask.from)),
+                    prefixes: open.flatMap(({ ask }) => contentPrefixes(ask.entry)),
+                    positions: open.map(({ ask }) => presented(ask.entry.authority, ask.from)),
                 });
-                const classified = open.map((ask) => classifyRead(answer.status, answer.body, ask.entry.locator));
+                const classified = open.map(({ ask }) => classifyRead(answer.status, answer.body, ask.entry.locator));
                 if (classified[0]?.kind === 'beyond-horizon') {
                     const named = doorRefusal(answer.body)?.fields.authority;
-                    const expired = open.filter((ask) => ask.entry.authority === named);
+                    const expired = open.filter(({ ask }) => ask.entry.authority === named);
                     const answered = expired.length === 0 ? UNCERTAIN_READ : { kind: 'beyond-horizon' };
                     const gone = expired.length === 0 ? open : expired;
                     for (const ask of gone)
-                        answers.set(ask, answered);
+                        answers[ask.index] = answered;
                     open = open.filter((ask) => !gone.includes(ask));
                     continue;
                 }
                 const enumeration = classified[0] === null ? parseEnumeration(answer.body, 'credential') : null;
-                for (const [index, ask] of open.entries()) {
-                    const failure = classified[index];
+                for (const [answerIndex, { ask, index }] of open.entries()) {
+                    const failure = classified[answerIndex];
                     if (failure !== null && failure !== undefined) {
-                        answers.set(ask, failure);
+                        answers[index] = failure;
                         continue;
                     }
-                    answers.set(ask, enumeration === null ? UNCERTAIN_READ : await enumeratedRoom(enumeration, ask));
+                    answers[index] =
+                        enumeration === null ? UNCERTAIN_READ : await enumeratedRoom(enumeration, ask);
                 }
                 open = [];
             }
         }
-        return asks.map((ask) => answers.get(ask) ?? UNCERTAIN_READ);
+        return answers;
     }
     const bootstrapTogether = gatheredEach(bootstrapped);
     const enumerateTogether = gathered(enumerated);
@@ -232,9 +309,7 @@ export function createAgentsHouseAdapter(options) {
             return { outcome: UNCERTAIN };
         const delivered = await transport.transfer({
             act: 'authored_batch_upload',
-            method: 'POST',
             url: grant.url,
-            answer: 'json',
             body: `${grant.operation}\n${delta}`,
         });
         if (delivered.status !== 200)
@@ -246,7 +321,30 @@ export function createAgentsHouseAdapter(options) {
         await keep(upload);
         return { body: { ...head, paths, upload, runtime: notifications.runtime } };
     }
-    async function submit(head, changes, delta, bytes, entry, handed, keep) {
+    async function staged(answer, batch) {
+        const refusal = doorRefusal(answer.body);
+        if (refusal?.code !== 'files_unstaged')
+            return null;
+        const grants = refusal.fields.upload;
+        if (!Array.isArray(grants))
+            return false;
+        for (const grant of grants) {
+            const { url, operation, sha256 } = grant;
+            const change = batch.changes.find((held) => held.kind === 'binary' && held.sha256 === sha256);
+            if (typeof url !== 'string' || typeof operation !== 'string' || change === undefined)
+                return false;
+            const delivered = await transport.transfer({
+                act: 'binary_stage',
+                url,
+                body: change.blob,
+                operation,
+            });
+            if (delivered.status !== 200)
+                return false;
+        }
+        return true;
+    }
+    async function submit(batch, head, changes, delta, bytes, entry, handed, keep) {
         const inline = { ...head, changes, runtime: notifications.runtime };
         const prepared = uploadable(inline, bytes, declared())
             ? await uploaded(head, changes, delta, bytes, entry, handed, keep)
@@ -254,7 +352,33 @@ export function createAgentsHouseAdapter(options) {
         if ('outcome' in prepared)
             return prepared.outcome;
         const answer = await transport.door(DOOR_BATCH, prepared.body);
-        return mutationOutcome(answer.status, answer.body, entry.locator, entry.handle);
+        const stagedFiles = await staged(answer, batch);
+        if (stagedFiles === false)
+            return UNCERTAIN;
+        const settled = stagedFiles === null ? answer : await transport.door(DOOR_BATCH, prepared.body);
+        if (stagedFiles === true && (await staged(settled, batch)) !== null)
+            return UNCERTAIN;
+        return mutationOutcome(settled.status, settled.body, entry.locator, entry.handle);
+    }
+    async function downloaded(answer, locator) {
+        const failure = classifyDoor(answer.status, answer.body, locator);
+        if (failure !== null) {
+            return failure.kind === 'scoped-refusal'
+                ? {
+                    kind: 'rejected',
+                    code: failure.code,
+                    fields: failure.fields,
+                    retryable: failure.retryable,
+                }
+                : failure;
+        }
+        const grant = parseGrant(answer.body);
+        if (grant === null || grant.method !== 'GET')
+            return UNCERTAIN_READ;
+        const read = await transport.download(grant.url);
+        if (read.status !== 200 || read.blob === null)
+            return UNCERTAIN_READ;
+        return { kind: 'binary', blob: read.blob };
     }
     return {
         async authorize() {
@@ -286,10 +410,11 @@ export function createAgentsHouseAdapter(options) {
             const entry = authorityFor(request.locator);
             if (entry === undefined)
                 return { kind: 'room-not-readable', locator: request.locator };
+            const asked = { entry, held: request.held };
             if (request.pageToken !== undefined) {
-                return continuedBootstrap(entry, JSON.parse(request.pageToken));
+                return continuedBootstrap(asked, JSON.parse(request.pageToken));
             }
-            return bootstrapTogether(entry);
+            return bootstrapTogether(asked);
         },
         async refresh(_authorization, request) {
             const entry = authorityFor(request.locator);
@@ -316,10 +441,11 @@ export function createAgentsHouseAdapter(options) {
             const delta = deltaBody(mapped.changes);
             const bytes = deltaBytes(delta);
             const handed = request.upload;
-            const outcome = await submit(head, mapped.changes, delta, bytes, entry, handed, keep);
+            const batch = request.changeBatch;
+            const outcome = await submit(batch, head, mapped.changes, delta, bytes, entry, handed, keep);
             if (handed === undefined || !lapsedGrant(outcome))
                 return adopted(entry, outcome);
-            return adopted(entry, await submit(head, mapped.changes, delta, bytes, entry, undefined, keep));
+            return adopted(entry, await submit(batch, head, mapped.changes, delta, bytes, entry, undefined, keep));
         },
         async history(_authorization, request) {
             const entry = authorityFor(request.locator);
@@ -336,6 +462,37 @@ export function createAgentsHouseAdapter(options) {
                 ...(request.revision === undefined ? {} : { revision: request.revision }),
             });
         },
+        async binary(_authorization, request) {
+            if (request.kind === 'path') {
+                const entry = authorityFor(request.locator);
+                if (entry === undefined)
+                    return { kind: 'room-not-readable', locator: request.locator };
+                const answer = await transport.door(DOOR_FILES_GET, {
+                    room_ref: entry.authority,
+                    path: request.path,
+                    revision: request.revision,
+                });
+                return downloaded(answer, request.locator);
+            }
+            const referrer = houseReferrer(request.referrer, tracked);
+            if (referrer === null) {
+                return { kind: 'rejected', code: 'referrer_unknown', fields: {}, retryable: false };
+            }
+            const answer = await transport.door(DOOR_FILES_GET, {
+                file: request.fileRef,
+                referrer: referrer.referrer,
+            });
+            return downloaded(answer, referrer.locator);
+        },
+        referrerScope(referrer) {
+            const held = houseReferrer(referrer, tracked);
+            if (held === null)
+                return null;
+            if (held.locator === '')
+                return { kind: 'conversations' };
+            const { path } = held.referrer;
+            return { kind: 'room', locator: held.locator, ...(path === undefined ? {} : { path }) };
+        },
         reached(locator, version, target) {
             return reachedVersion(version, target, authorityFor(locator)?.logEpoch);
         },
@@ -345,7 +502,16 @@ export function createAgentsHouseAdapter(options) {
         async action(_authorization, request) {
             return withAt(await houseAction(transport, request));
         },
-        roomStream: { hold: held, reopen: notifications.reopen, observe: notifications.observe },
+        roomStream: {
+            hold: held,
+            reopen: notifications.reopen,
+            observe: notifications.observe,
+            published(locator, roomVersion) {
+                const at = logPosition(roomVersion);
+                if (at !== null)
+                    notifications.published(locator, at);
+            },
+        },
         conversations: notifications.conversations,
         serviceMode: notifications.serviceMode,
     };

package/dist/discovery.d.ts

@@ -13,6 +13,7 @@ export type HouseBounds = {
     max_inline_body_bytes: number;
     max_upload_bytes: number;
     max_prefixes: number;
+    max_held_files: number;
     change_retention_seconds: number;
     operation_retention_seconds: number;
 };

package/dist/discovery.d.ts.map

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

package/dist/discovery.js

@@ -1,4 +1,4 @@
-import { declaredActions, houseConversationAgents } from './actions.js';
+import { declaredActions, houseConversationAgents, SITE_SUBMIT } from './actions.js';
 import { readPosition, roomVersion } from './version.js';
 export const PROVIDER_ACTIONS = 'provider-actions';
 export const DISCOVER_PREFIXES = ['/'];
@@ -13,6 +13,7 @@ const BOUND_KEYS = [
     'max_inline_body_bytes',
     'max_upload_bytes',
     'max_prefixes',
+    'max_held_files',
     'change_retention_seconds',
     'operation_retention_seconds',
 ];
@@ -229,7 +230,10 @@ export function capabilities(document) {
 }
 export function siteCapabilities() {
     return [
-        { name: PROVIDER_ACTIONS, actions: [{ name: 'submit', inputShape: {}, resultKind: 'house' }] },
+        {
+            name: PROVIDER_ACTIONS,
+            actions: [{ name: SITE_SUBMIT, inputShape: {}, resultKind: 'house' }],
+        },
     ];
 }
 export function discoveredRoom(authority) {

package/dist/handed.d.ts

@@ -0,0 +1,15 @@
+import type { HeldRoom, MutationResult } from '@agentshouse/mdruntime';
+import type { HouseScope, HouseView } from './read.js';
+import type { StreamedAdvancement } from './stream.js';
+export type HandedRoom = {
+    roomVersion: string;
+    revisions: ReadonlyMap<string, string>;
+};
+export declare function scopeHanded(scope: HouseScope): HandedRoom;
+export declare function heldHanded(held: HeldRoom): HandedRoom;
+export declare function acceptedHanded(held: HandedRoom, accepted: Extract<MutationResult, {
+    kind: 'accepted';
+}>, roomVersion: string): HandedRoom;
+export declare function enumeratedHanded(view: HouseView, earlier: HandedRoom | undefined): HandedRoom;
+export declare function streamedHanded(held: HandedRoom, advanced: StreamedAdvancement): HandedRoom;
+//# sourceMappingURL=handed.d.ts.map

package/dist/handed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handed.d.ts","sourceRoot":"","sources":["../src/handed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,MAAM,MAAM,UAAU,GAAG;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CASzD;AAOD,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAErD;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,OAAO,CAAC,cAAc,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,EACvD,WAAW,EAAE,MAAM,GAClB,UAAU,CAKZ;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,CAM7F;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,mBAAmB,GAAG,UAAU,CAM1F"}

package/dist/handed.js

@@ -0,0 +1,38 @@
+import { roomVersion } from './version.js';
+export function scopeHanded(scope) {
+    return {
+        roomVersion: roomVersion(scope),
+        revisions: new Map(scope.files.flatMap(({ path, revision }) => revision === undefined ? [] : [[path, revision]])),
+    };
+}
+function revised(revisions, path, revision) {
+    if (revision === undefined)
+        revisions.delete(path);
+    else
+        revisions.set(path, revision);
+}
+export function heldHanded(held) {
+    return { roomVersion: held.roomVersion, revisions: new Map(Object.entries(held.revisions)) };
+}
+export function acceptedHanded(held, accepted, roomVersion) {
+    const revisions = new Map(held.revisions);
+    for (const [path, revision] of Object.entries(accepted.revisions))
+        revisions.set(path, revision);
+    for (const path of accepted.removals)
+        revisions.delete(path);
+    return { roomVersion, revisions };
+}
+export function enumeratedHanded(view, earlier) {
+    const revisions = new Map(earlier?.revisions);
+    for (const change of view.changes) {
+        revised(revisions, change.path, 'removed' in change ? undefined : change.revision);
+    }
+    return { roomVersion: roomVersion(view), revisions };
+}
+export function streamedHanded(held, advanced) {
+    const revisions = new Map(held.revisions);
+    for (const entry of advanced.entries) {
+        revised(revisions, entry.path, entry.kind === 'removed' ? undefined : entry.revision);
+    }
+    return { roomVersion: advanced.page.roomVersion, revisions };
+}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { createAgentsHouseAdapter, type AgentsHouseAdapterOptions } from './adapter.js';
-export { HOUSE_APP_ACTS } from './actions.js';
-export type { HouseByteAct, HouseByteAnswer, HouseByteTransfer, HouseDoorAnswer, HouseHeldRoom, HouseOpening, HouseStream, HouseStreamEntry, HouseStreamFrame, HouseSiteTransport, HouseTransport, } from './transport.js';
+export { HOUSE_APP_ACTS, HOUSE_APP_BATCHES, HOUSE_SITE_ACTS } from './actions.js';
+export type { HouseByteAct, HouseByteTransfer, HouseBytesAnswer, HouseDemand, HouseDoorAnswer, HouseHeldRoom, HouseOpening, HouseStream, HouseStreamEntry, HouseStreamFrame, HouseSiteTransport, HouseTransport, } from './transport.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EACV,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAClF,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
 export { createAgentsHouseAdapter } from './adapter.js';
-export { HOUSE_APP_ACTS } from './actions.js';
+export { HOUSE_APP_ACTS, HOUSE_APP_BATCHES, HOUSE_SITE_ACTS } from './actions.js';

package/dist/model.d.ts

@@ -3,7 +3,6 @@ import type { TrackedAuthority } from './discovery.js';
 import { type HouseScope, type HouseView } from './read.js';
 import type { HouseMode, HouseStreamEntry } from './transport.js';
 export declare function partModels(scope: HouseScope, tracked: TrackedAuthority, seen: ReadonlySet<string>, final: boolean): Promise<RoomModels | undefined>;
-export declare function scopeModels(scope: HouseScope, tracked: TrackedAuthority): Promise<RoomModels | undefined>;
 export declare function viewModels(view: HouseView, tracked: TrackedAuthority): Promise<RoomModels | undefined>;
 export declare function streamedModels(schemas: ReadonlyMap<string, HouseStreamEntry>, tracked: TrackedAuthority, mode: HouseMode): Promise<RoomModels | undefined>;
 //# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAA0C,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AACpG,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAoClE,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EACzB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAKjC;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAEjC;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAcjC;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC9C,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,SAAS,GACd,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAWjC"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAA0C,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AACpG,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAoClE,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EACzB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAKjC;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAcjC;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC9C,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,SAAS,GACd,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAWjC"}

package/dist/model.js

@@ -33,9 +33,6 @@ export function partModels(scope, tracked, seen, final) {
         return final && !seen.has(schema) ? ABSENT_SCHEMA : undefined;
     });
 }
-export function scopeModels(scope, tracked) {
-    return partModels(scope, tracked, new Set(), true);
-}
 export function viewModels(view, tracked) {
     return modelsOf(tracked, (schema) => {
         const change = view.changes.find((candidate) => candidate.path === schema);