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

package/AGENTS.md

@@ -10,7 +10,7 @@ App code reaches the MD Runtime through the remote client. The surfaces are
 Rooms, Query, Search, Observe, Types, Room Draft, Save, History, Call, Reached, Log,
 the reported persistence answer, reauthorization, conversation, the chat draft,
 and Presentation State. Sync Status, the Service Mode, the storage-loss
-statement and the deployment facts are observations only.
+statement, the deployment facts and the signed-in member are observations only.
 
 The host attaches each port with its reach, and every member and observation
 answers within it: a Room outside it answers as one the replica does not hold,
@@ -51,7 +51,9 @@ open one through the Provider Action that serves it.
 
 Rooms, Query, Search, Observe, Types, Room Draft, Save, and Reached never
 touch the network.
-History and Call go to the Provider through the Adapter. A Call result whose
+History and Call go to the Provider through the Adapter. Call takes the Action names
+the Adapter declares; any other name answers `undeclared` without reaching the
+Provider. A Call result whose
 effect the Provider places in a Room carries `at`, that Room and Room Version;
 `reached(room, roomVersion)` answers whether the Room's confirmed state has
 reached it, and the MD Runtime keeps refreshing that Room until it has;
@@ -66,9 +68,25 @@ client is asynchronous. Results are detached snapshots. Nothing in this
 surface returns the authorization, performs a request the App's code
 composes, or exposes the browser store.
 
+Every refusal and failure carries `code` and `retryable`: each Call and History answer
+other than its result, a refused Save or Room Draft write, a returned Room Draft's
+reason, a Room's refusal and the Connection Refusal, and every error a member rejects
+with, beside its message. A Provider refusal carries the Provider's own `retryable`.
+Every code and every value the API answers is open: handle one you do not know by its
+`code` and `retryable`.
+
 Read the deployment facts with `observe('deployment-facts')`. Interpret the
 opaque value using the host's contract.
 
+`observe('member')` answers who uses the App: the User the Provider signed in,
+`{ kind: 'user', id, name }` in the shape of a change's `author`, so a Document
+whose `change.author.id` equals its `id` is that User's own. It is `null` until
+the Provider first names one, and where it names none, such as a Site. The
+MD Runtime keeps it with the Local Replicas, so it answers offline once known,
+and every port hears the next member the Provider names; signing out answers
+`null`, then ends the observation with the authorization. It is the only way App code learns who
+uses it.
+
 The in-memory Adapter at `@agentshouse/mdruntime/memory` is for tests and
 ships in no bundle.
 
@@ -112,7 +130,7 @@ data:
   or `null` for a write the Provider made itself, and `time` is the Provider's
   ISO 8601 change time. It is `null` where the Provider delivered no time, as at
   a Site. An unsent edit or move keeps it, an unsent creation has none, and a
-  saved write takes the Provider's own once it is Accepted and refreshed. A
+  saved write takes the Provider's own once it is Accepted. A
   Room's last change is its Document with the latest `time`.
 - **Order and groups.** `orderBy` sorts by `room`, `path`, `type` or `{ field }`
   with TanStack DB's own options, and ties end with Room, then Path. `groupBy` by
@@ -120,9 +138,9 @@ data:
   over every match and ordered by `count` or a key. A sort or group takes only a
   pointer that holds one value. `limit` bounds the Documents or the groups.
 - **Results and errors.** A result carries no Room Version: read freshness from
-  Rooms and Sync Status. An invalid query fails with `invalid-query`,
-  `unknown-type`, `unknown-field` or `wrong-kind`, naming where, and never
-  answers an empty result in its place.
+  Rooms and Sync Status. An invalid query fails with the `code`
+  `invalid-query`, `unknown-type`, `unknown-field` or `wrong-kind`, naming where,
+  and never answers an empty result in its place.
 
 ## Local Search rules
 
@@ -160,9 +178,9 @@ the current Room Draft; read it and write again.
 
 Save takes one Room and the Room Drafts of it to save, each with its revision,
 validates locally, and on success appends one Change Batch to that Room's
-queue and removes those Room Drafts. It is refused as `stale`, as
+queue and removes those Room Drafts. It is refused with the `code` `stale`,
 `changed-underneath` naming each part whose base no longer matches the visible
-state, or by a local validation rule, and then creates nothing and leaves every
+state, or a local validation rule, and then creates nothing and leaves every
 Room Draft in place. A directory move or removal is a move or removal part on
 each Document and binary link target beneath it, saved together.
 
@@ -182,6 +200,13 @@ it names; the MD Runtime retries the same Change Batch identity and payload and
 never infers an outcome from transport uncertainty. The MD Runtime never
 combines, reorders, or rebases.
 
+On a Site, every Save stays in the visitor's browser. Write grants and
+revisions do not refuse it, and its Pending Change shows in every query and
+across reloads until the browser's storage is cleared. It is never sent:
+`observe('queue', room)` shows it `local`, and Sync Status never waits on it.
+Once the Room changes so that it no longer applies, it leaves the queue and
+returns no Room Draft.
+
 `observe('service-mode')` answers the Provider's Service
 Mode, `open` or `write-halted`. While writes are halted, Save still succeeds,
 its Change Batch waits unsent, and the queue is submitted in order once the
@@ -218,7 +243,7 @@ the network. Data lives only in the App Creator's browser and with the Provider.
 ## App code takes the client its host hands it and never constructs a Runtime
 
 App code takes the client its host hands it: in House,
-`connectHouseBridge().runtime` from `@agentshouse/app-bridge` resolves to the
+`houseBridge().runtime` from `@agentshouse/app-bridge` resolves to the
 client House built into the page. It never constructs a Runtime or a client.
 It imports only types from `@agentshouse/mdruntime/client`, does not call
 `connectMdRuntime` or `serveMdRuntime`, and does not import the package main,
@@ -227,9 +252,9 @@ served App does not.
 
 A React App may observe and save through `@agentshouse/mdruntime/react`, which
 names React as a peer dependency. `useObserve(client, topic, ...input)` takes
-the arguments of `observe` and returns the topic's current value, `undefined`
-until it arrives, re-rendering on each change; a `null` client observes
-nothing. `useSave(client)` returns `busy`, the last `outcome` or `failure`, and
+the arguments of `observe` and returns `{ state: 'loading' }` until the topic's
+first value arrives, then `{ state: 'ready', value }`, re-rendering on each
+change; a `null` client observes nothing and stays loading. `useSave(client)` returns `busy`, the last `outcome` or `failure`, and
 `save(room, roomDrafts)`, which writes each Path's parts onto the Room Draft
 already there, keeping the bases its parts have, or onto a new one, and saves
 them together. A refused Save leaves the Room Drafts for the App to save again

package/dist/actions.d.ts

@@ -1,8 +1,46 @@
-import { type AcceptedMessage, type ActionDeclaration, type ActionRequest, type ActionResult, type ConversationAgents } from '@agentshouse/mdruntime';
+import { type AcceptedMessage, type ActionDeclaration, type ActionRequest, type ActionResult, type ConversationAgents, type ConversationHistories, type ConversationHistoryRequest, type FileDeclaration } from '@agentshouse/mdruntime';
 import type { HouseDoorAnswer, HouseTransport } from './transport.js';
+type Operated = {
+    readonly operation_id?: string;
+};
+type ConversationControl = Operated & {
+    readonly conversation: string;
+};
+type SentFile = FileDeclaration & {
+    readonly blob: Blob;
+};
+export type AppInputs = {
+    readonly 'conversation.answer': ConversationControl & {
+        readonly answer: {
+            readonly interaction_id: string;
+            readonly response: unknown;
+        };
+    };
+    readonly 'conversation.create': Operated & {
+        readonly agent_id: string;
+    };
+    readonly 'conversation.delete': ConversationControl;
+    readonly 'conversation.history': ConversationHistoryRequest;
+    readonly 'conversation.interrupt': ConversationControl;
+    readonly 'conversation.kill': ConversationControl;
+    readonly 'conversation.send': ConversationControl & {
+        readonly text?: string;
+        readonly files?: readonly SentFile[];
+    };
+};
+export type AppAnswers = {
+    readonly 'conversation.history': ConversationHistories;
+};
+export type AppAnswerAdditions = {
+    readonly 'conversation.send': {
+        readonly turn: string;
+    };
+};
+export declare const HOUSE_APP_ACTS: Readonly<Record<string, string>>;
 export declare function houseConversationAgents(locator: string): ConversationAgents;
 export declare function declaredActions(routes: readonly string[]): readonly ActionDeclaration[];
 export declare function houseAction(transport: HouseTransport, request: ActionRequest): Promise<ActionResult>;
 export declare function actionOutcome(answer: HouseDoorAnswer, name: string): ActionResult;
 export declare function acceptedMessage(entry: unknown): AcceptedMessage | null;
+export {};
 //# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EAGxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAkBtE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAE3E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,iBAAiB,EAAE,CASvF;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAQvB;AA4DD,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAWjF;AAuLD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAUtE"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAE1B,KAAK,0BAA0B,EAC/B,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAQtE,KAAK,QAAQ,GAAG;IAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnD,KAAK,mBAAmB,GAAG,QAAQ,GAAG;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,KAAK,QAAQ,GAAG,eAAe,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAE1D,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,qBAAqB,EAAE,mBAAmB,GAAG;QACpD,QAAQ,CAAC,MAAM,EAAE;YAAE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;SAAE,CAAC;KAClF,CAAC;IACF,QAAQ,CAAC,qBAAqB,EAAE,QAAQ,GAAG;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,QAAQ,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;IACpD,QAAQ,CAAC,sBAAsB,EAAE,0BAA0B,CAAC;IAC5D,QAAQ,CAAC,wBAAwB,EAAE,mBAAmB,CAAC;IACvD,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAClD,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,GAAG;QAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;KACtC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,sBAAsB,EAAE,qBAAqB,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,mBAAmB,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD,CAAC;AAkEF,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3D,CAAC;AAMF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAE3E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,iBAAiB,EAAE,CAMvF;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAQvB;AA2DD,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAOjF;AAqJD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAUtE"}

package/dist/actions.js

@@ -3,44 +3,72 @@ import { doorRefusal } from './refusal.js';
 const HISTORY_PAGE = 100;
 const HISTORY_CONVERSATIONS = 64;
 const OCTET_STREAM = 'application/octet-stream';
-const CONVERSATION_ROUTES = new Map([
-    ['conversation.create', '/door/conversations/create'],
-    ['conversation.send', '/door/conversations/send'],
-    ['conversation.answer', '/door/conversations/interaction/answer'],
-    ['conversation.interrupt', '/door/conversations/interrupt'],
-    ['conversation.kill', '/door/conversations/kill'],
-    ['conversation.delete', '/door/conversations/delete'],
-    ['conversation.history', '/door/conversations/history'],
-]);
+function mapped(door, input = (given) => given) {
+    return {
+        door,
+        async carry(transport, given, name) {
+            return actionOutcome(await transport.door(`/door/${door}`, input(given)), name);
+        },
+    };
+}
+function carried(door, carry) {
+    return {
+        door,
+        carry: (transport, input, name) => carry(transport, `/door/${door}`, input, name),
+    };
+}
+const APP_ACTS = {
+    'access.read': mapped('rooms/access/read'),
+    'conversation.answer': mapped('conversations/interaction/answer', answerBody),
+    'conversation.create': mapped('conversations/create', createBody),
+    'conversation.delete': mapped('conversations/delete', controlBody),
+    'conversation.history': carried('conversations/history', historyAction),
+    'conversation.interrupt': mapped('conversations/interrupt', controlBody),
+    'conversation.kill': mapped('conversations/kill', controlBody),
+    'conversation.markDone': mapped('conversations/done'),
+    'conversation.rename': mapped('conversations/rename'),
+    'conversation.send': carried('conversations/send', sendAction),
+    'conversation.setOption': mapped('conversations/option'),
+    'feature.list': mapped('apps/features/read'),
+    'holder.list': mapped('apps/holders'),
+    'holder.ring': mapped('apps/ring'),
+    'member.list': mapped('rooms/members'),
+    'message.send': mapped('apps/messages/send'),
+    'processing.read': mapped('rooms/settings/processing/read'),
+    'record.list': mapped('records/read'),
+    'relay.read': mapped('apps/relay'),
+    'routine.list': mapped('routines/access'),
+    'routineAccess.list': mapped('routines/granted'),
+    'routineAllowance.list': mapped('routines/allowance'),
+    'routineRequest.list': mapped('routines/requests'),
+    'storage.read': mapped('storage/inventory'),
+    'trigger.list': mapped('triggers/read'),
+    'triggerOccurrence.list': mapped('triggers/fired'),
+};
+export const HOUSE_APP_ACTS = Object.fromEntries(Object.entries(APP_ACTS).map(([name, act]) => [name, act.door]));
+const APP_NAMES = new Map(Object.entries(APP_ACTS).map(([name, act]) => [act.door, name]));
 export function houseConversationAgents(locator) {
     return { locator, type: 'house-agent', identity: 'agent', name: 'name' };
 }
 export function declaredActions(routes) {
-    const mapped = new Map([...CONVERSATION_ROUTES].map(([name, route]) => [route.slice('/door/'.length), name]));
     return routes.map((route) => ({
-        name: mapped.get(route) ?? route,
+        name: APP_NAMES.get(route) ?? route,
         inputShape: {},
         resultKind: 'house',
     }));
 }
 export function houseAction(transport, request) {
-    if (request.name === 'conversation.send')
-        return sendAction(transport, request.input);
-    if (request.name === 'conversation.history')
-        return historyAction(transport, request.input);
-    if (request.name === 'attachments/upload')
-        return attachAction(transport, request.input);
-    if (request.name === 'attachments/get')
-        return openAction(transport, request.input);
+    if (Object.hasOwn(APP_ACTS, request.name)) {
+        return APP_ACTS[request.name].carry(transport, request.input, request.name);
+    }
+    if (APP_NAMES.has(request.name))
+        return Promise.resolve(unimplemented(request.name));
     const route = routeOf(request.name);
     if (route === null)
         return Promise.resolve(malformed());
     return carry(transport, route, request.name, request.input);
 }
 function routeOf(name) {
-    const mapped = CONVERSATION_ROUTES.get(name);
-    if (mapped !== undefined)
-        return mapped;
     const parts = name.split('/');
     if (parts.some((part) => part === '.' || part === '..'))
         return null;
@@ -62,51 +90,47 @@ function operationId(input) {
     return text(input, 'operation_id') ?? changeBatchIdentity();
 }
 function malformed() {
-    return { kind: 'rejected', code: 'invalid_request', fields: {} };
+    return { kind: 'rejected', code: 'invalid_request', fields: {}, retryable: false };
 }
-function bodyOf(name, input) {
-    if (name === 'conversation.create') {
-        return { agent_id: text(input, 'agent_id'), operation_id: operationId(input) };
-    }
-    if (name === 'conversation.interrupt' ||
-        name === 'conversation.kill' ||
-        name === 'conversation.delete') {
-        return { conversation_id: text(input, 'conversation'), operation_id: operationId(input) };
-    }
-    if (name === 'conversation.answer') {
-        const nested = record(record(input).answer);
-        return {
-            conversation_id: text(input, 'conversation'),
-            operation_id: operationId(input),
-            interaction_id: text(nested, 'interaction_id'),
-            response: nested.response,
-        };
-    }
-    return input;
+function unimplemented(name) {
+    return { kind: 'rejected', code: 'action-unimplemented', fields: { name }, retryable: false };
+}
+function createBody(input) {
+    return { agent_id: text(input, 'agent_id'), operation_id: operationId(input) };
+}
+function controlBody(input) {
+    return { conversation_id: text(input, 'conversation'), operation_id: operationId(input) };
+}
+function answerBody(input) {
+    const nested = record(record(input).answer);
+    return {
+        conversation_id: text(input, 'conversation'),
+        operation_id: operationId(input),
+        interaction_id: text(nested, 'interaction_id'),
+        response: nested.response,
+    };
 }
 function withTurn(body) {
     const held = record(body);
     const turn = text(held, 'message_id');
-    return turn === undefined ? body : { ...held, turn };
+    return turn === undefined
+        ? body
+        : { ...held, turn };
 }
 export function actionOutcome(answer, name) {
     if (answer.status === 401)
         return { kind: 'revoked-authorization' };
     const refusal = doorRefusal(answer.body);
-    if (refusal !== null) {
-        return { kind: 'rejected', code: refusal.code, fields: refusal.fields };
-    }
+    if (refusal !== null)
+        return { kind: 'rejected', ...refusal };
     if (answer.status === 404)
-        return { kind: 'rejected', code: 'action-unimplemented', fields: { name } };
+        return unimplemented(name);
     if (answer.status === 0 || answer.status >= 400)
         return { kind: 'transport-uncertainty' };
-    if (name === 'conversation.send')
-        return { kind: 'action', result: withTurn(answer.body) };
     return { kind: 'action', result: answer.body };
 }
 async function carry(transport, route, name, input) {
-    const answer = await transport.door(route, bodyOf(name, input));
-    return actionOutcome(answer, name);
+    return actionOutcome(await transport.door(route, input), name);
 }
 function sendFile(entry) {
     const file = record(entry);
@@ -176,12 +200,12 @@ function uploadGrant(entry) {
         return null;
     return { method: 'POST', operation: upload.operation, url: upload.url };
 }
-async function uploadOriginals(transport, input, result) {
-    const originals = record(result).originals;
-    if (!Array.isArray(originals) || originals.length === 0)
+async function uploadFiles(transport, input, result, name) {
+    const sent = record(result).files;
+    if (!Array.isArray(sent) || sent.length === 0)
         return null;
     const files = Array.isArray(record(input).files) ? record(input).files : [];
-    for (const [index, entry] of originals.entries()) {
+    for (const [index, entry] of sent.entries()) {
         const grant = uploadGrant(entry);
         if (grant === 'absent')
             continue;
@@ -189,81 +213,35 @@ async function uploadOriginals(transport, input, result) {
             return malformed();
         const bytes = index < files.length ? await fileBytes(files[index]) : null;
         if (bytes === null) {
-            return { kind: 'rejected', code: 'conversation_original_descriptor_required', fields: {} };
+            return {
+                kind: 'rejected',
+                code: 'conversation_file_descriptor_required',
+                fields: {},
+                retryable: false,
+            };
         }
         const failed = delivered(await transport.transfer({
-            act: 'conversation_original_upload',
-            method: 'POST',
+            act: 'conversation_file_upload',
             url: grant.url,
-            answer: 'json',
             body: bytes,
             operation: grant.operation,
-        }), 'conversation.send');
+        }), name);
         if (failed !== null)
             return failed;
     }
     return null;
 }
-async function attachAction(transport, input) {
-    const { blob, ...descriptor } = record(input);
-    const bytes = await fileBytes({ blob });
-    if (bytes === null)
-        return malformed();
-    const answer = await transport.door('/door/attachments/upload', descriptor);
-    const outcome = actionOutcome(answer, 'attachments/upload');
-    if (outcome.kind !== 'action')
-        return outcome;
-    const grant = uploadGrant(outcome.result);
-    if (grant === 'absent')
-        return outcome;
-    if (grant === null)
-        return malformed();
-    const stored = await transport.transfer({
-        act: 'original_upload',
-        method: 'POST',
-        url: grant.url,
-        answer: 'json',
-        body: bytes,
-        operation: grant.operation,
-    });
-    return delivered(stored, 'attachments/upload') ?? { kind: 'action', result: stored.body };
-}
-async function openAction(transport, input) {
-    const answer = await transport.door('/door/attachments/get', input);
-    const outcome = actionOutcome(answer, 'attachments/get');
-    if (outcome.kind !== 'action')
-        return outcome;
-    const { download, ...opened } = record(outcome.result);
-    if (download === undefined)
-        return outcome;
-    const grant = record(download);
-    if (grant.method !== 'GET' || typeof grant.url !== 'string')
-        return malformed();
-    const read = await transport.transfer({
-        act: 'original_download',
-        method: 'GET',
-        url: grant.url,
-        answer: 'bytes',
-    });
-    const failed = delivered(read, 'attachments/get');
-    if (failed !== null)
-        return failed;
-    if (!(read.body instanceof Blob))
-        return { kind: 'transport-uncertainty' };
-    return { kind: 'action', result: { ...opened, blob: read.body } };
-}
-async function sendAction(transport, input) {
+async function sendAction(transport, route, input, name) {
     const body = sendBody(input);
     if (body === null)
         return malformed();
-    const answer = await transport.door('/door/conversations/send', body);
-    const outcome = actionOutcome(answer, 'conversation.send');
+    const outcome = actionOutcome(await transport.door(route, body), name);
     if (outcome.kind !== 'action')
         return outcome;
-    const uploaded = await uploadOriginals(transport, input, outcome.result);
+    const uploaded = await uploadFiles(transport, input, outcome.result, name);
     if (uploaded !== null)
         return uploaded;
-    return outcome;
+    return { ...outcome, result: withTurn(outcome.result) };
 }
 function historyCursor(value) {
     const acceptedAt = text(value, 'accepted_at');
@@ -329,17 +307,17 @@ function historyAsks(input) {
     }
     return asks;
 }
-async function historyAction(transport, input) {
+async function historyAction(transport, route, input, name) {
     const asks = historyAsks(input);
     if (asks === null)
         return malformed();
     const histories = [];
     for (let at = 0; at < asks.length; at += HISTORY_CONVERSATIONS) {
-        const answer = await transport.door('/door/conversations/history', {
+        const answer = await transport.door(route, {
             conversations: asks.slice(at, at + HISTORY_CONVERSATIONS),
             limit: HISTORY_PAGE,
         });
-        const outcome = actionOutcome(answer, 'conversation.history');
+        const outcome = actionOutcome(answer, name);
         if (outcome.kind !== 'action')
             return outcome;
         const answered = record(outcome.result).histories;

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,OAAO,EACP,aAAa,EAWd,MAAM,wBAAwB,CAAC;AAqChC,OAAO,EAOL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAyBxB,MAAM,MAAM,yBAAyB,GACjC;IACE,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACrC,GACD;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAsBjC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAuWpF"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,OAAO,EACP,aAAa,EAWd,MAAM,wBAAwB,CAAC;AAuChC,OAAO,EAOL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAyBxB,MAAM,MAAM,yBAAyB,GACjC;IACE,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACrC,GACD;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAwBjC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAuYpF"}

package/dist/adapter.js

@@ -1,6 +1,6 @@
 import { DISCOVER_PREFIXES, capabilities, discoveredRoom, mapDiscovery, parseDiscovery, trackedFrom, } from './discovery.js';
-import { scopeModels, streamedModels, viewModels } from './model.js';
-import { gathered, selections } from './gather.js';
+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';
@@ -28,14 +28,26 @@ export function createAgentsHouseAdapter(options) {
             throw new Error('no Discovery declared the bounds');
         return bounds;
     }
-    async function bootstrappedRoom(envelope, entry) {
-        const scope = envelope.scopes.find((candidate) => matchesScope(candidate, entry));
+    async function bootstrappedRoom(envelope, scope, entry, continued) {
         if (scope === undefined)
             return { kind: 'room-not-readable', locator: entry.locator };
-        handed.set(entry.locator, scopeLinks(scope));
+        const next = envelope.next?.room === entry.authority ? envelope.next.path : null;
+        if (continued === null && next === null)
+            handed.set(entry.locator, scopeLinks(scope));
+        else
+            handed.delete(entry.locator);
         notifications.reach(entry.authority, scope);
-        const models = await scopeModels(scope, entry);
-        return { ...bootstrapOf(scope), ...(models === undefined ? {} : { models }) };
+        const seen = [
+            ...(continued?.seen ?? []),
+            ...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 };
+        return {
+            ...bootstrapOf(scope),
+            ...(models === undefined ? {} : { models }),
+            ...(continuation === null ? {} : { pageToken: JSON.stringify(continuation) }),
+        };
     }
     async function enumeratedRoom(enumeration, ask) {
         const view = viewOf(enumeration, ask.entry);
@@ -109,41 +121,54 @@ export function createAgentsHouseAdapter(options) {
             return result;
         return { ...result, at: { locator, roomVersion: roomVersion({ position, logEpoch }) } };
     }
-    async function bundled(body) {
-        const grant = parseGrant(body);
-        if (grant === null)
-            return body;
-        if (grant.method !== 'GET')
-            return null;
-        const answer = await transport.transfer({
-            act: 'local_copy_bundle',
-            method: 'GET',
-            url: grant.url,
-            answer: 'json',
-        });
-        return answer.status === 200 ? answer.body : null;
-    }
     function weight(entry) {
         return contentPrefixes(entry).length;
     }
-    async function bootstrapped(entries) {
-        const answers = [];
-        for (const part of selections(entries, weight, declared().max_prefixes)) {
-            const answer = await transport.door(DOOR_BOOTSTRAP, {
-                prefixes: part.flatMap((entry) => contentPrefixes(entry)),
-            });
-            const classified = part.map((entry) => classifyDoor(answer.status, answer.body, entry.locator));
-            const envelope = classified[0] === null ? parseEnvelope(await bundled(answer.body)) : null;
-            for (const [index, entry] of part.entries()) {
-                const failure = classified[index];
-                if (failure === null || failure === undefined) {
-                    answers.push(envelope === null ? UNCERTAIN_READ : await bootstrappedRoom(envelope, entry));
-                    continue;
+    async function bootstrapped(entries, answer) {
+        let open = entries.map((entry, ask) => ({ entry, ask }));
+        while (open.length > 0) {
+            const unreached = [];
+            for (const part of selections(open, ({ entry }) => weight(entry), declared().max_prefixes)) {
+                const answered = await transport.door(DOOR_BOOTSTRAP, {
+                    prefixes: part.flatMap(({ entry }) => contentPrefixes(entry)),
+                });
+                const classified = part.map(({ entry }) => classifyDoor(answered.status, answered.body, entry.locator));
+                const envelope = classified[0] === null ? parseEnvelope(answered.body) : null;
+                for (const [index, asked] of part.entries()) {
+                    const failure = classified[index];
+                    if (failure !== null && failure !== undefined) {
+                        answer(asked.ask, failure);
+                        continue;
+                    }
+                    if (envelope === null) {
+                        answer(asked.ask, UNCERTAIN_READ);
+                        continue;
+                    }
+                    const scope = envelope.scopes.find((candidate) => matchesScope(candidate, asked.entry));
+                    if (scope === undefined && envelope.next !== undefined) {
+                        unreached.push(asked);
+                        continue;
+                    }
+                    answer(asked.ask, await bootstrappedRoom(envelope, scope, asked.entry, null));
                 }
-                answers.push(failure);
             }
+            open = unreached;
         }
-        return answers;
+    }
+    async function continuedBootstrap(entry, continued) {
+        const after = { room: entry.authority, path: continued.after };
+        const answered = await transport.door(DOOR_BOOTSTRAP, {
+            prefixes: contentPrefixes(entry),
+            after,
+        });
+        const failure = classifyDoor(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);
     }
     function layered(asks) {
         const depths = new Map();
@@ -190,7 +215,7 @@ export function createAgentsHouseAdapter(options) {
         }
         return asks.map((ask) => answers.get(ask) ?? UNCERTAIN_READ);
     }
-    const bootstrapTogether = gathered(bootstrapped);
+    const bootstrapTogether = gatheredEach(bootstrapped);
     const enumerateTogether = gathered(enumerated);
     async function uploaded(head, changes, delta, bytes, entry, handed, keep) {
         const paths = batchPaths(changes);
@@ -207,9 +232,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)
@@ -252,14 +275,18 @@ export function createAgentsHouseAdapter(options) {
                 if (!tracked.has(locator))
                     handed.delete(locator);
             notifications.track(entries);
-            return mapDiscovery(document, document.authorities.map((authority) => discoveredRoom(authority)), capabilities(document));
+            return {
+                ...mapDiscovery(document, document.authorities.map((authority) => discoveredRoom(authority)), capabilities(document)),
+                member: document.member,
+            };
         },
         async bootstrap(_authorization, request) {
             const entry = authorityFor(request.locator);
             if (entry === undefined)
                 return { kind: 'room-not-readable', locator: request.locator };
-            if (request.pageToken !== undefined)
-                return { kind: 'transport-uncertainty' };
+            if (request.pageToken !== undefined) {
+                return continuedBootstrap(entry, JSON.parse(request.pageToken));
+            }
             return bootstrapTogether(entry);
         },
         async refresh(_authorization, request) {
@@ -316,7 +343,7 @@ export function createAgentsHouseAdapter(options) {
         async action(_authorization, request) {
             return withAt(await houseAction(transport, request));
         },
-        roomStream: { hold: held, observe: notifications.observe },
+        roomStream: { hold: held, reopen: notifications.reopen, observe: notifications.observe },
         conversations: notifications.conversations,
         serviceMode: notifications.serviceMode,
     };