@agentshouse/mdruntime-adapter 0.1.0-cb0bbc4ccacd0 → 0.1.0-cb3cb6f7673f1

package/README.md

@@ -25,7 +25,7 @@ host.attach(port, 'my-app');
 
 App code never imports this package; it reaches the Runtime only through the
 client its host hands it. The rules an App's agent follows are the `apps/` pages
-of House's Guide, which House's `open_guide` opens.
+of House's Guide, which House's `guide/open` opens.
 
 ## License
 

package/dist/actions.d.ts

@@ -1,6 +1,7 @@
 import type { ActionDeclaration, ActionRequest, ActionResult } from '@agentshouse/mdruntime';
 import type { HouseDoorAnswer, HouseTransport } from './transport.js';
 export type HouseActDoor = Pick<HouseTransport, 'door'>;
+export declare const HOUSE_UNKEPT_READS: readonly string[];
 export declare function declaredActions(routes: readonly string[]): readonly ActionDeclaration[];
 export declare function houseAction(transport: HouseActDoor, request: ActionRequest): Promise<ActionResult>;
 export declare function actionOutcome(answer: HouseDoorAnswer, name: string, input: unknown): ActionResult;

package/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE7F,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtE,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;AAExD,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,iBAAiB,EAAE,CAEvF;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAIvB;AAwBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,CAUjG"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE7F,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtE,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;AAExD,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAG/C,CAAC;AAEF,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,iBAAiB,EAAE,CAEvF;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAIvB;AAwBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,CAUjG"}

package/dist/actions.js

@@ -1,4 +1,8 @@
 import { doorRefusal } from './refusal.js';
+export const HOUSE_UNKEPT_READS = [
+    'account/security/read',
+    'clients/last-use/list',
+];
 export function declaredActions(routes) {
     return routes.map((name) => ({ name, inputShape: {}, resultKind: 'house', room: 'room_ref' }));
 }

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,OAAO,EAIP,aAAa,EAgBd,MAAM,wBAAwB,CAAC;AAiChC,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAoBxB,MAAM,MAAM,yBAAyB,GACjC;IACE,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACrC,GACD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AA6DrD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAqapF"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,OAAO,EAIP,aAAa,EAed,MAAM,wBAAwB,CAAC;AAyBhC,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAoBxB,MAAM,MAAM,yBAAyB,GACjC;IACE,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACrC,GACD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAoBrD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAibpF"}

package/dist/adapter.js

@@ -1,12 +1,11 @@
 import { stepped } from '@agentshouse/mdruntime';
 import { capabilities, discoveredRoom, mapDiscovery, parseAuthorityChange, parseDiscovery, trackedFrom, } from './discovery.js';
 import { createSiteAdapter } from './site.js';
-import { authorityRoot, bootstrapping, parseFileAddress, parseGrant, } from './read.js';
-import { roomStreams } from './room-stream.js';
+import { parseFileAddress, parseGrant } from './read.js';
+import { chunkedHead, chunkLister, chunkPart } from './chunks.js';
 import { spaceSchemas } from './space-schema.js';
-import { sha256Hex } from './digest.js';
 import { finishedUpload, houseUpload } from './upload.js';
-import { houseAction } from './actions.js';
+import { houseAction, HOUSE_UNKEPT_READS } from './actions.js';
 import { houseSearch } from './search.js';
 import { classifyDoor, doorRefusal } from './refusal.js';
 import { houseNotifications, } from './stream.js';
@@ -14,7 +13,7 @@ import { houseDoorRoute, } from './transport.js';
 import { batchPaths, deltaBody, deltaBytes, deltaDigest, historyOutcome, houseChanges, houseMove, mutationOutcome, operationHead, rejectedMapping, revisionBody, uploadable, } from './write.js';
 import { HOUSE_TYPED_PATHS } from './house-model.js';
 import { HOUSE_NAMEABLE_ROOM_TYPES, HOUSE_ROOM_TYPES } from './room-types.js';
-import { followsVersion, logPosition, presented, reachedVersion, roomVersion } from './version.js';
+import { followsVersion, reachedVersion, roomVersion } from './version.js';
 const UNCERTAIN = { kind: 'transport-uncertainty' };
 const UNCERTAIN_READ = { kind: 'transport-uncertainty' };
 const OCTET_STREAM = 'application/octet-stream';
@@ -22,32 +21,6 @@ const EXPIRED_ADDRESS = 403;
 function lapsedGrant(outcome) {
     return outcome.kind === 'rejected' && outcome.code === 'upload_unavailable';
 }
-async function heldFiles(authority, held, bound) {
-    const listed = await held.files(null, bound + 1);
-    const files = listed.slice(0, bound);
-    const through = listed.length > bound ? (files.at(-1)?.path ?? null) : null;
-    return files.length === 0 ? null : { room: authority, through, files };
-}
-async function reused(scope, held) {
-    const sent = new Set(scope.contents.map((entry) => entry.path));
-    const contents = [...scope.contents];
-    const asked = scope.files.filter((file) => file.binary === undefined && !sent.has(file.path));
-    if (asked.length === 0)
-        return scope;
-    if (held === undefined)
-        return null;
-    const kept = await held.contents(asked.map(({ path }) => path));
-    for (const file of asked) {
-        const found = kept.get(file.path);
-        if (found === undefined ||
-            found.revision !== file.revision ||
-            (await sha256Hex(found.content)) !== file.sha256) {
-            return null;
-        }
-        contents.push({ path: file.path, content: found.content });
-    }
-    return { ...scope, contents };
-}
 export function createAgentsHouseAdapter(options) {
     if ('site' in options)
         return createSiteAdapter(options.site, options.snapshot === true);
@@ -56,10 +29,12 @@ export function createAgentsHouseAdapter(options) {
     const notifications = houseNotifications(transport, 'credential', {
         opened: async (frame) => (frame === null ? null : opened(frame)),
         changed,
+        expired: (authorities) => lister.askAll(authorities.flatMap((authority) => [...tracked.values()].filter((entry) => entry.authority === authority))),
     }, spaces);
     const tracked = new Map();
-    const rooms = roomStreams('credential', spaces);
-    const unreused = new Set();
+    const lister = chunkLister(transport, () => declared().max_prefixes);
+    const chunked = new Map();
+    const renewals = new WeakMap();
     let bounds;
     function declared() {
         if (bounds === undefined)
@@ -72,6 +47,7 @@ export function createAgentsHouseAdapter(options) {
             return null;
         bounds = document.bounds;
         tracked.clear();
+        lister.forget();
         for (const entry of trackedFrom(document))
             tracked.set(entry.locator, entry);
         notifications.track([...tracked.values()]);
@@ -96,42 +72,52 @@ export function createAgentsHouseAdapter(options) {
             member: change.member,
         };
     }
-    async function streamedPage(entry, token, held) {
-        const part = await rooms.part(entry, token);
-        if ('kind' in part)
-            return part;
-        const scope = await reused(part.scope, held);
-        if (scope === null) {
-            unreused.add(entry.locator);
-            return UNCERTAIN_READ;
-        }
-        return {
-            ...(await stepped(bootstrapping(scope))),
-            ...(part.models === undefined ? {} : { models: part.models }),
-            ...(part.pageToken === undefined ? {} : { pageToken: part.pageToken }),
-            bytes: part.bytes,
-        };
+    async function listedRoom(entry) {
+        const listed = await lister.list(entry);
+        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 openedRoom(entry, request) {
-        const reusing = unreused.delete(entry.locator) ? undefined : request.held;
-        const files = reusing === undefined
-            ? null
-            : await heldFiles(entry.authority, reusing, declared().max_held_files);
-        const answered = await transport.streamed(houseDoorRoute('bootstrap'), {
-            room_ref: entry.authority,
-            prefixes: [authorityRoot(entry.handle)],
-            ...(files === null ? {} : { held: [files] }),
-        }, request.signal ?? new AbortController().signal);
-        if (answered.room === null)
-            return classifyDoor(answered.status, answered.body, entry.locator) ?? UNCERTAIN_READ;
-        return rooms.head(entry, answered.room, request.arriving, request.signal);
+    async function chunkRead(entry, id) {
+        const room = chunked.get(entry.locator);
+        const address = room?.chunks.get(id);
+        if (room === undefined || address === undefined)
+            return null;
+        const read = await transport.download(address.url);
+        if (read.status !== EXPIRED_ADDRESS)
+            return { room, read };
+        const renewed = await renewal(entry, room);
+        if ('kind' in renewed || !renewed.chunks.has(id))
+            return null;
+        chunked.set(entry.locator, renewed);
+        return { room: renewed, read: await transport.download(renewed.chunks.get(id).url) };
     }
-    function held(rooms) {
-        notifications.send(rooms.flatMap((room) => {
-            const entry = tracked.get(room.locator);
-            const at = logPosition(room.roomVersion);
-            return entry === undefined || at === null ? [] : [presented(entry.authority, at)];
-        }));
+    function renewal(entry, stale) {
+        const held = renewals.get(stale);
+        if (held !== undefined)
+            return held;
+        const renewed = lister.renew(entry, [...chunked.keys()].flatMap((locator) => tracked.get(locator) ?? []));
+        renewals.set(stale, renewed);
+        return renewed;
+    }
+    function hold(rooms) {
+        for (const room of rooms) {
+            const listed = chunked.get(room.locator);
+            if (listed !== undefined &&
+                room.roomVersion !== null &&
+                reachedVersion(room.roomVersion, roomVersion(listed), listed.logEpoch))
+                chunked.delete(room.locator);
+        }
+        notifications.send(rooms);
+    }
+    async function chunkPage(entry, id, arriving) {
+        const fetched = await chunkRead(entry, id);
+        if (fetched === null || fetched.read.status !== 200)
+            return UNCERTAIN_READ;
+        return chunkPart(fetched.read.body, fetched.room, id, arriving);
     }
     function authorityFor(locator) {
         return tracked.get(locator);
@@ -156,7 +142,7 @@ export function createAgentsHouseAdapter(options) {
         if (handed !== undefined && handed.sha256 === sha256) {
             return { body: { ...head, paths, upload: handed, runtime: notifications.runtime } };
         }
-        const minted = await transport.door(houseDoorRoute('batch-upload'), {
+        const minted = await transport.door(houseDoorRoute('files/batch-upload'), {
             ...head,
             paths,
             bytes,
@@ -209,11 +195,13 @@ export function createAgentsHouseAdapter(options) {
             : { body: inline };
         if ('outcome' in prepared)
             return prepared.outcome;
-        const answer = await transport.door(houseDoorRoute('batch'), prepared.body);
+        const answer = await transport.door(houseDoorRoute('files/batch'), prepared.body);
         const stagedFiles = await staged(answer, request);
         if (stagedFiles === false)
             return UNCERTAIN;
-        const settled = stagedFiles === null ? answer : await transport.door(houseDoorRoute('batch'), prepared.body);
+        const settled = stagedFiles === null
+            ? answer
+            : await transport.door(houseDoorRoute('files/batch'), prepared.body);
         if (stagedFiles === true && (await staged(settled, request)) !== null)
             return UNCERTAIN;
         return stepped(mutationOutcome(settled.status, settled.body, entry.locator, entry.handle, into === undefined
@@ -281,7 +269,7 @@ export function createAgentsHouseAdapter(options) {
         const entry = authorityFor(request.locator);
         if (entry === undefined)
             return null;
-        return () => transport.door(houseDoorRoute('files/get'), {
+        return () => transport.door(houseDoorRoute('files/read'), {
             room_ref: entry.authority,
             path: request.path,
             revision: request.revision,
@@ -291,6 +279,7 @@ export function createAgentsHouseAdapter(options) {
         roomTypes: HOUSE_ROOM_TYPES,
         nameableRoomTypes: HOUSE_NAMEABLE_ROOM_TYPES,
         typedPaths: HOUSE_TYPED_PATHS,
+        unkeptReads: HOUSE_UNKEPT_READS,
         async authorize() {
             return options.authorize();
         },
@@ -299,8 +288,8 @@ export function createAgentsHouseAdapter(options) {
             if (entry === undefined)
                 return { kind: 'room-not-readable', locator: request.locator };
             return request.pageToken === undefined
-                ? openedRoom(entry, request)
-                : streamedPage(entry, request.pageToken, request.held);
+                ? listedRoom(entry)
+                : chunkPage(entry, request.pageToken, request.arriving);
         },
         async mutate(_authorization, request, keep) {
             const entry = authorityFor(request.locator);
@@ -331,7 +320,7 @@ export function createAgentsHouseAdapter(options) {
             const entry = authorityFor(request.locator);
             if (entry === undefined)
                 return { kind: 'room-not-readable', locator: request.locator };
-            const answer = await transport.door(houseDoorRoute('revisions'), revisionBody({
+            const answer = await transport.door(houseDoorRoute('files/revisions/list'), revisionBody({
                 path: request.path,
                 handle: entry.handle,
                 ...(request.revision === undefined ? {} : { revision: request.revision }),
@@ -396,7 +385,7 @@ export function createAgentsHouseAdapter(options) {
             return houseSearch(transport, [...tracked.values()], request);
         },
         roomStream: {
-            hold: held,
+            hold,
             observe: notifications.observe,
         },
         conversations: notifications.conversations,

package/dist/chunks.d.ts

@@ -0,0 +1,38 @@
+import { type AdapterFailure, type BootstrapPart, type BootstrapResult } from '@agentshouse/mdruntime';
+import type { TrackedAuthority } from './discovery.js';
+import { type HouseModels, type HouseScope } from './read.js';
+import type { SpaceSchemas } from './space-schema.js';
+import { type HouseDoor, type HouseMode } from './transport.js';
+import { type LogPosition } from './version.js';
+export type ChunkAddress = {
+    readonly url: string;
+    readonly bytes: number;
+};
+export type ChunkedRoom = LogPosition & {
+    readonly anchor: string;
+    readonly mode: HouseMode;
+    readonly chunks: ReadonlyMap<string, ChunkAddress>;
+    readonly parts: readonly BootstrapPart[];
+    readonly names: ReadonlyMap<string, string>;
+    readonly models: HouseModels;
+};
+export type Listed = ChunkedRoom | {
+    readonly kind: 'not-ready';
+} | AdapterFailure;
+type Answered = {
+    readonly status: number;
+    readonly body: unknown;
+};
+export declare function partId(logEpoch: string, hash: string): string;
+export declare function siteChunkList(answer: Answered, locator: string): Listed;
+export declare function chunkedHead(listed: ChunkedRoom, entry: TrackedAuthority, spaces: SpaceSchemas): Promise<BootstrapResult>;
+export declare function chunkPart(body: ReadableStream<Uint8Array> | null, room: ChunkedRoom, id: string, arriving: ((bytes: number) => void) | undefined): Promise<BootstrapResult>;
+export declare function chunkLister(transport: HouseDoor, most: () => number): {
+    askAll: (entries: readonly TrackedAuthority[]) => void;
+    list: (entry: TrackedAuthority) => Promise<Listed>;
+    renew(entry: TrackedAuthority, installing: readonly TrackedAuthority[]): Promise<Listed>;
+    forget(): void;
+};
+export declare function chunkScope(body: ReadableStream<Uint8Array>, room: ChunkedRoom, arriving: ((bytes: number) => void) | undefined): Promise<HouseScope | null>;
+export {};
+//# sourceMappingURL=chunks.d.ts.map

package/dist/chunks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunks.d.ts","sourceRoot":"","sources":["../src/chunks.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAkB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,WAAW,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAAG,cAAc,CAAC;AAEnF,KAAK,QAAQ,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAoCpE,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AA4BD,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,eAAe,CAAC,CAuB1B;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,EACvC,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,GAC9C,OAAO,CAAC,eAAe,CAAC,CAM1B;AAgBD,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,MAAM;sBAwCzC,SAAS,gBAAgB,EAAE;kBAU/B,gBAAgB,KAAG,OAAO,CAAC,MAAM,CAAC;iBASxC,gBAAgB,cAAc,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;;EAc3F;AAuCD,wBAAsB,UAAU,CAC9B,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,GAC9C,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAgC5B"}

package/dist/chunks.js

@@ -0,0 +1,247 @@
+import { paced, ROW_WEIGHT, stepped, } from '@agentshouse/mdruntime';
+import { manifestedModels } from './model.js';
+import { authorityRoot, bootstrapping, parseFile, } from './read.js';
+import { classifyDoor } from './refusal.js';
+import { houseDoorRoute } from './transport.js';
+import { readPosition, roomVersion } from './version.js';
+function authorKey(author) {
+    for (const kind of ['user', 'site', 'inbox']) {
+        if (typeof author[kind] === 'string')
+            return `${kind}:${author[kind]}`;
+    }
+    const { app, release, function: named } = author;
+    return typeof app === 'string' && typeof release === 'string' && typeof named === 'string'
+        ? `app:${app}:${release}:${named}`
+        : null;
+}
+function namesOf(authors) {
+    if (!Array.isArray(authors))
+        return null;
+    const names = new Map();
+    for (const author of authors) {
+        const key = typeof author === 'object' && author !== null ? authorKey(author) : null;
+        if (key === null || typeof author.name !== 'string')
+            return null;
+        names.set(key, author.name);
+    }
+    return names;
+}
+function modelsOf(models, mode) {
+    if (!Array.isArray(models))
+        return null;
+    const files = [];
+    const contents = [];
+    for (const entry of models) {
+        const file = parseFile(entry, mode);
+        if (file === null || typeof entry.content !== 'string')
+            return null;
+        files.push(file);
+        contents.push({ path: file.path, content: entry.content });
+    }
+    return { files, contents };
+}
+export function partId(logEpoch, hash) {
+    return `${logEpoch}:${hash}`;
+}
+function chunkedRoom(room, mode) {
+    const at = readPosition(room);
+    const names = mode === 'site' ? new Map() : namesOf(room.authors);
+    const models = modelsOf(room.models, mode);
+    if (at === null || names === null || models === null || !Array.isArray(room.chunks))
+        return null;
+    const chunks = new Map();
+    const parts = [];
+    for (const chunk of room.chunks) {
+        const { hash, bytes, download } = chunk;
+        if (typeof hash !== 'string' || typeof bytes !== 'number' || typeof download !== 'string')
+            return null;
+        const id = partId(at.logEpoch, hash);
+        chunks.set(id, { url: download, bytes });
+        parts.push({ id, bytes });
+    }
+    return { anchor: room.room_ref, ...at, mode, chunks, parts, names, models };
+}
+function listedRoom(room, mode) {
+    if (typeof room !== 'object' || room === null)
+        return null;
+    const held = room;
+    if (typeof held.room_ref !== 'string')
+        return null;
+    if (held.ready === false)
+        return { kind: 'not-ready' };
+    return held.ready === true ? chunkedRoom(held, mode) : null;
+}
+export function siteChunkList(answer, locator) {
+    const failure = classifyDoor(answer.status, answer.body, locator);
+    if (failure !== null)
+        return failure;
+    return listedRoom(answer.body, 'site') ?? { kind: 'transport-uncertainty' };
+}
+export async function chunkedHead(listed, entry, spaces) {
+    if (listed.anchor !== entry.authority)
+        return { kind: 'transport-uncertainty' };
+    const models = await manifestedModels({
+        anchor: listed.anchor,
+        position: listed.position,
+        logEpoch: listed.logEpoch,
+        models: listed.models,
+    }, entry, spaces);
+    return {
+        kind: 'bootstrap',
+        roomVersion: roomVersion(listed),
+        documents: {},
+        facts: {},
+        revisions: {},
+        changes: {},
+        binaryFiles: {},
+        parts: listed.parts,
+        ...(models === undefined ? {} : { models }),
+    };
+}
+export async function chunkPart(body, room, id, arriving) {
+    const address = room.chunks.get(id);
+    if (body === null || address === undefined)
+        return { kind: 'transport-uncertainty' };
+    const scope = await chunkScope(body, room, arriving).catch(() => null);
+    if (scope === null)
+        return { kind: 'transport-uncertainty' };
+    return { ...(await stepped(bootstrapping(scope))), bytes: address.bytes };
+}
+function listedRooms(answer) {
+    const rooms = answer.body?.rooms;
+    if (!Array.isArray(rooms))
+        return null;
+    const listed = new Map();
+    for (const room of rooms) {
+        const held = listedRoom(room, 'credential');
+        if (held === null)
+            return null;
+        listed.set(room.room_ref, held);
+    }
+    return listed;
+}
+export function chunkLister(transport, most) {
+    const asked = new Map();
+    function answered(entries, whole) {
+        const prefixes = whole ? ['/'] : entries.map((entry) => authorityRoot(entry.handle));
+        return transport.door(houseDoorRoute('room-chunks/list'), { prefixes }).then((answer) => {
+            const failure = classifyDoor(answer.status, answer.body, '');
+            if (failure !== null)
+                return failed(entries, failure);
+            const listed = listedRooms(answer);
+            return listed ?? failed(entries, { kind: 'transport-uncertainty' });
+        }, () => failed(entries, { kind: 'transport-uncertainty' }));
+    }
+    function failed(entries, failure) {
+        return new Map(entries.map((entry) => [
+            entry.authority,
+            failure.kind === 'room-not-readable' || failure.kind === 'scoped-refusal'
+                ? { ...failure, locator: entry.locator }
+                : failure,
+        ]));
+    }
+    function settled(entry, lists) {
+        return lists.then((listed) => listed.get(entry.authority) ?? { kind: 'room-not-readable', locator: entry.locator });
+    }
+    function askAll(entries) {
+        if (entries.length === 0)
+            return;
+        const lists = answered(entries, entries.length > most());
+        for (const entry of entries) {
+            const listed = settled(entry, lists);
+            listed.catch(() => { });
+            asked.set(entry.authority, { entry, listed });
+        }
+    }
+    function list(entry) {
+        const held = asked.get(entry.authority);
+        asked.delete(entry.authority);
+        return held?.listed ?? settled(entry, answered([entry], false));
+    }
+    return {
+        askAll,
+        list,
+        renew(entry, installing) {
+            if (!asked.has(entry.authority)) {
+                const waiting = [...asked.values()].map((held) => held.entry);
+                const due = new Map([entry, ...installing, ...waiting].map((held) => [held.authority, held]));
+                askAll([...due.values()]);
+            }
+            return list(entry);
+        },
+        forget() {
+            asked.clear();
+        },
+    };
+}
+function folderLine(entry) {
+    return typeof entry.folder === 'string' && Object.keys(entry).length === 1 ? entry.folder : null;
+}
+function chunkEntry(line, room, read) {
+    let entry;
+    try {
+        entry = JSON.parse(line);
+    }
+    catch {
+        return false;
+    }
+    if (typeof entry !== 'object' || entry === null)
+        return false;
+    const folder = folderLine(entry);
+    if (folder !== null) {
+        read.folders.push(folder);
+        return true;
+    }
+    const author = entry.author;
+    let named = entry;
+    if (author !== undefined) {
+        const key = typeof author === 'object' && author !== null ? authorKey(author) : null;
+        const name = key === null ? undefined : room.names.get(key);
+        if (name === undefined)
+            return false;
+        named = { ...entry, author: { ...author, name } };
+    }
+    const file = parseFile(named, room.mode);
+    if (file === null)
+        return false;
+    read.files.push(file);
+    if (typeof entry.content === 'string')
+        read.contents.push({ path: file.path, content: entry.content });
+    return true;
+}
+export async function chunkScope(body, room, arriving) {
+    const read = {
+        files: [],
+        contents: [],
+        folders: [],
+    };
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    const pace = paced();
+    const unfinished = [];
+    let bytes = 0;
+    for (let chunk = await reader.read(); chunk.done !== true; chunk = await reader.read()) {
+        bytes += chunk.value.length;
+        arriving?.(bytes);
+        const text = decoder.decode(chunk.value, { stream: true });
+        let start = 0;
+        for (let end = text.indexOf('\n'); end !== -1; end = text.indexOf('\n', start)) {
+            const piece = text.slice(start, end);
+            const line = unfinished.length === 0 ? piece : unfinished.splice(0).join('') + piece;
+            start = end + 1;
+            if (line.length > 0 && !chunkEntry(line, room, read)) {
+                await reader.cancel();
+                return null;
+            }
+            const due = pace(line.length + ROW_WEIGHT);
+            if (due instanceof Promise)
+                await due;
+        }
+        if (start < text.length)
+            unfinished.push(text.slice(start));
+    }
+    const rest = unfinished.join('') + decoder.decode();
+    if (rest.length > 0 && !chunkEntry(rest, room, read))
+        return null;
+    return { anchor: room.anchor, position: room.position, logEpoch: room.logEpoch, ...read };
+}

package/dist/discovery.d.ts

@@ -12,7 +12,6 @@ export type HouseBounds = {
     max_inline_body_bytes: number;
     max_upload_bytes: number;
     max_prefixes: number;
-    max_held_files: number;
     change_retention_seconds: number;
     max_move_documents?: 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,5 +1,5 @@
 import { declaredActions } from './actions.js';
-import { SITE_SUBMISSION } from './transport.js';
+import { SITES_SUBMISSIONS_CREATE } from './transport.js';
 import { readPosition, roomVersion } from './version.js';
 export const PROVIDER_ACTIONS = 'provider-actions';
 const BOUND_KEYS = [
@@ -13,7 +13,6 @@ const BOUND_KEYS = [
     'max_inline_body_bytes',
     'max_upload_bytes',
     'max_prefixes',
-    'max_held_files',
     'change_retention_seconds',
 ];
 const OPERATION_KEYS = ['write', 'erase'];
@@ -268,7 +267,7 @@ export function siteCapabilities() {
     return [
         {
             name: PROVIDER_ACTIONS,
-            actions: [{ name: SITE_SUBMISSION, inputShape: {}, resultKind: 'house' }],
+            actions: [{ name: SITES_SUBMISSIONS_CREATE, inputShape: {}, resultKind: 'house' }],
         },
     ];
 }

package/dist/history.js

@@ -1,7 +1,7 @@
 import { actionOutcome } from './actions.js';
 import { houseDoorRoute } from './transport.js';
 export const HISTORY_PAGE = 100;
-const HISTORY = 'conversations/history';
+const HISTORY = 'conversations/history/list';
 function record(value) {
     return typeof value === 'object' && value !== null ? value : {};
 }