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

package/AGENTS.md

@@ -12,13 +12,26 @@ 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.
 
+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,
+Rooms lists only the Rooms reached whole, a Room reached for single Documents
+shows only those Documents and the Types of the models that govern them, and
+without conversations the conversation members, the chat draft and the
+conversation observation hold none.
+A change of the reach reaches every open observation as its new value, a query
+keeping every unchanged Document the same object.
+
 Every `observe` resolves, once its first value has arrived, to a handle:
 `current()` is the latest complete value, `subscribe(listener)` hears each later
 value whole and returns its unsubscribe, and `close()` ends the observation.
 Closing the port ends every handle and rejects every pending call and
 observation; a client that reconnects observes again.
 
-Each conversation a Provider card names is held complete in the browser.
+Each conversation the Provider's conversation list names is held complete in the
+browser. `conversation.list()` and `observe('conversations')` answer each with its
+Agent's identity and name, its name, created and finished times, last outcome and live
+`state`: `asking` while a question waits, `working` while a turn runs, else `idle`,
+and `started`, when the running turn began, or `null`.
 Observe one with `observe('conversation', id, { limit })`: the view
 holds its latest `limit` messages, or all of them, oldest first, its chat
 draft, and what the Provider streams for it whether or not anything views it:
@@ -44,7 +57,10 @@ effect the Provider places in a Room carries `at`, that Room and Room Version;
 reached it, and the MD Runtime keeps refreshing that Room until it has;
 `reached(room, roomVersion, path)` answers whether the held confirmed copy of
 that document was written at a later Room Version. Each History revision
-names its author, `{ kind: 'user', id }` or `{ kind: 'site', id, name }`. Every
+names its author, `{ kind: 'user', id }` or `{ kind: 'site', id, name }`.
+History of a Path no current document holds answers the removed document's
+revisions with `deleted: true`, newest first; that revision is what a link to
+the Path opens. Every
 member of the
 client is asynchronous. Results are detached snapshots. Nothing in this
 surface returns the authorization, performs a request the App's code
@@ -66,22 +82,28 @@ data:
 - **Filter.** `rooms` names Room locators and defaults to every Room. `types`
   names MD Types, and `any` names untyped Markdown Documents. `pathPrefix` is a
   directory: `notes` keeps `notes/a.md` and not `notes2/a.md`.
-- **Fields.** `where` names frontmatter fields, ANDs them, and nests `$and` and
-  `$or`. A bare value is equality; the operators are `$eq`, `$ne`, `$in`, `$nin`,
-  `$gt`, `$gte`, `$lt`, `$lte`, `$all`, `$size` and `$exists`. Equality on a list
-  asks whether it contains the value. Missing, null and empty differ:
+- **Fields.** Every frontmatter value is named by JSON Pointer: `/status`,
+  `/shipping/city`, `~1` for a `/` and `~0` for a `~` in a key. A segment that
+  meets a list applies to every item and a number names one item. `where` names
+  pointers, ANDs them, and nests `$and` and `$or`; a pointer through a list holds
+  when any item satisfies it. A bare value is equality; the operators are `$eq`,
+  `$ne`, `$in`, `$nin`, `$gt`, `$gte`, `$lt`, `$lte`, `$all`, `$size` and
+  `$exists`. Equality on a list asks whether it contains the value. Missing, null and empty differ:
   `$exists: false` keeps a missing field, `null` an explicit null, `''` empty
   text and `$size: 0` an empty list. A date compares in calendar order and never
   with a date-time. A reference compares by the Room Path it resolves to.
-  Untyped frontmatter is plain values. There is no text containment or regular
+  Untyped frontmatter, and a value under `oneOf` or a conditional, is plain
+  values. There is no text containment or regular
   expression.
 - **Relations.** `hop: { field, types, where, pathPrefix }` keeps Documents whose
-  reference `field` points to a matching Document of the same Room.
-  `backlinks: { field, types, where, pathPrefix }` keeps Documents that a
+  reference at pointer `field`, at any depth, points to a matching Document of the
+  same Room. `backlinks: { field, types, where, pathPrefix }` keeps Documents that a
   matching Document of the same Room references. Each keeps a Document once.
 - **Parts.** A Document query must `select`: `'all'`, or `fields`, `sections`,
-  `preamble`, `markdown`, `backlinks` and `change`, where `fields` and `sections`
-  are `'all'` or a list of names. Room and Path always return; a Markdown
+  `preamble`, `markdown`, `backlinks` and `change`, where `fields` is `'all'` or a
+  list of pointers and `sections` `'all'` or a list of names. Selected pointers
+  return the frontmatter holding only them, nested as written. A backlink names
+  the referring Path, MD Type and the pointer it came from as `field`. Room and Path always return; a Markdown
   Document also returns its MD Type. A non-Markdown Document or binary link
   target returns only Room and Path. An unselected part is absent. Select only
   what a screen shows: a list that selects the Markdown hears every edit of it.
@@ -95,8 +117,8 @@ data:
 - **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
   `room`, `type` or `{ field }` answers `{ groups: [{ key, count }] }`, counted
-  over every match and ordered by `count` or a key. `limit` bounds the Documents
-  or the groups.
+  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
@@ -193,13 +215,28 @@ an App's override respected. What an App Creator's agent adds carries none
 of these promises by itself. Reading, querying and searching never wait for
 the network. Data lives only in the App Creator's browser and with the Provider.
 
-## App code imports only the client entry and never constructs a Runtime
-
-App code imports only `@agentshouse/mdruntime/client` and calls
-`connectMdRuntime` on the port the host hands it. It never constructs a
-Runtime. It does not import the package main, the host entry, or the Adapter
-package, and it does not call `serveMdRuntime`. Hosts
-and tests use those entries; the served App does not.
+## 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
+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,
+the host entry, or the Adapter package. Hosts and tests use those entries; the
+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
+`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
+or discard; a failure is recorded and rejects. `saveRoomDrafts(client, room,
+roomDrafts)` is that save outside a component. A react-admin or Refine App
+reads and writes its Rooms through the data providers of
+`@agentshouse/mdruntime-families`.
 
 ## What an agent must never do
 

package/README.md

@@ -19,12 +19,12 @@ import { serveMdRuntime } from '@agentshouse/mdruntime/host';
 import { createAgentsHouseAdapter } from '@agentshouse/mdruntime-adapter';
 
 const adapter = createAgentsHouseAdapter({ transport, authorize });
-const host = serveMdRuntime({ adapter, shell, requiredGuarantees: [] });
+const host = serveMdRuntime({ adapter, shell });
 host.attach(port, 'my-app');
 ```
 
-App code never imports this package; it reaches the Runtime only through
-`@agentshouse/mdruntime/client`. The rules an App's agent follows are in the
+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 in the
 package's `AGENTS.md`.
 
 ## License

package/dist/actions.d.ts

@@ -1,6 +1,6 @@
-import { type AcceptedMessage, type ActionDeclaration, type ActionRequest, type ActionResult, type ConversationCards } from '@agentshouse/mdruntime';
+import { type AcceptedMessage, type ActionDeclaration, type ActionRequest, type ActionResult, type ConversationAgents } from '@agentshouse/mdruntime';
 import type { HouseDoorAnswer, HouseTransport } from './transport.js';
-export declare const HOUSE_CONVERSATION_CARDS: ConversationCards;
+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;

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,iBAAiB,EAGvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAkBtE,eAAO,MAAM,wBAAwB,EAAE,iBAKtC,CAAC;AAEF,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,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"}

package/dist/actions.js

@@ -1,6 +1,5 @@
 import { changeBatchIdentity, } from '@agentshouse/mdruntime';
 import { doorRefusal } from './refusal.js';
-import { PRIVATE_LOCATOR } from './transport.js';
 const HISTORY_PAGE = 100;
 const HISTORY_CONVERSATIONS = 64;
 const OCTET_STREAM = 'application/octet-stream';
@@ -13,12 +12,9 @@ const CONVERSATION_ROUTES = new Map([
     ['conversation.delete', '/door/conversations/delete'],
     ['conversation.history', '/door/conversations/history'],
 ]);
-export const HOUSE_CONVERSATION_CARDS = {
-    locator: PRIVATE_LOCATOR,
-    type: 'house-conversation',
-    identity: 'conversation',
-    agent: 'agent',
-};
+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) => ({

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,EAad,MAAM,wBAAwB,CAAC;AAyChC,OAAO,EAQL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAuBxB,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;AAiCjC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CA2ZpF"}
+{"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"}

package/dist/adapter.js

@@ -1,26 +1,20 @@
-import { DISCOVER_PREFIXES, capabilities, discoveredRoom, locatorOf, mapDiscovery, parseDiscovery, trackedFrom, } from './discovery.js';
-import { MODEL_ABSENT, failedModel, heldModel, modelKey, modelShelf, } from './model.js';
+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 { createSiteAdapter } from './site.js';
-import { bootstrapOf, contentPrefixes, matchesScope, parseEnumeration, parseEnvelope, parseGrant, refreshFrom, schemaFrom, schemaPath, viewOf, } from './read.js';
-import { enumeratedLinks, scopeLinks, streamedLinks } from './links.js';
+import { bootstrapOf, contentPrefixes, matchesScope, parseEnumeration, parseEnvelope, parseGrant, refreshFrom, viewOf, } from './read.js';
+import { acceptedLinks, enumeratedLinks, heldLinks, scopeLinks, streamedLinks, } from './links.js';
 import { houseAction } from './actions.js';
-import { classifyDoor, discoveryFailure, doorRefusal } from './refusal.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, PRIVATE_LOCATOR, } from './transport.js';
+import { DOOR_BATCH, DOOR_BATCH_UPLOAD, DOOR_BOOTSTRAP, DOOR_DISCOVER, DOOR_ENUMERATE, DOOR_REVISIONS, } from './transport.js';
 import { batchPaths, deltaBody, deltaBytes, deltaDigest, historyOutcome, houseChanges, mutationOutcome, operationHead, rejectedMapping, revisionBody, uploadable, } from './write.js';
-import { logPosition, presented, reachedVersion, roomVersion, } from './version.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 modelFailure(classified, envelope) {
-    if (classified === null) {
-        return envelope === null ? { kind: 'transport-uncertainty' } : MODEL_ABSENT;
-    }
-    return failedModel(classified);
-}
 export function createAgentsHouseAdapter(options) {
     if ('site' in options)
         return createSiteAdapter(options.site);
@@ -28,80 +22,75 @@ export function createAgentsHouseAdapter(options) {
     const notifications = houseNotifications(transport, 'credential');
     const tracked = new Map();
     const handed = new Map();
-    const models = modelShelf();
     let bounds;
     function declared() {
         if (bounds === undefined)
             throw new Error('no Discovery declared the bounds');
         return bounds;
     }
-    function bootstrappedRoom(envelope, entry) {
+    async function bootstrappedRoom(envelope, entry) {
         const scope = envelope.scopes.find((candidate) => matchesScope(candidate, entry));
         if (scope === undefined)
             return { kind: 'room-not-readable', locator: entry.locator };
         handed.set(entry.locator, scopeLinks(scope));
-        notifications.hold(entry.authority, scope);
-        return bootstrapOf(scope);
+        notifications.reach(entry.authority, scope);
+        const models = await scopeModels(scope, entry);
+        return { ...bootstrapOf(scope), ...(models === undefined ? {} : { models }) };
     }
-    function enumeratedRoom(enumeration, ask) {
+    async function enumeratedRoom(enumeration, ask) {
         const view = viewOf(enumeration, ask.entry);
         if (view === undefined)
             return { kind: 'room-not-readable', locator: ask.entry.locator };
-        notifications.hold(ask.entry.authority, view);
+        notifications.reach(ask.entry.authority, view);
         const answer = refreshFrom(view, ask.fromRoomVersion);
-        if (answer.kind === 'net-advancement') {
-            handed.set(ask.entry.locator, enumeratedLinks(view, handed.get(ask.entry.locator)));
-        }
-        return answer;
+        if (answer.kind !== 'net-advancement')
+            return answer;
+        handed.set(ask.entry.locator, enumeratedLinks(view, handed.get(ask.entry.locator)));
+        const models = await viewModels(view, ask.entry);
+        return models === undefined ? answer : { ...answer, models };
     }
-    function streamed(entry, request, from) {
+    async function streamed(entry, request, from) {
         const links = handed.get(entry.locator);
         if (links?.roomVersion !== request.fromRoomVersion)
             return null;
         const advanced = notifications.advance(entry, from, (path, revision) => links.revisions.get(path) === revision);
         if (advanced === null)
             return null;
-        if (request.minPosition !== undefined &&
-            !reachedVersion(advanced.page.roomVersion, request.minPosition, entry.logEpoch))
-            return null;
         const relinked = streamedLinks(links, advanced);
         if (relinked === null)
             return null;
         handed.set(entry.locator, relinked);
-        return advanced.page;
-    }
-    function held(envelope, entry, schema, failure) {
-        return heldModel(envelope === null ? null : schemaFrom(envelope, entry, schema), schemaPath(entry.handle, schema), failure);
-    }
-    function modelPrefixes(entry) {
-        return entry.schemas.map((schema) => schemaPath(entry.handle, schema));
+        const models = await streamedModels(advanced.schemas, entry, 'credential');
+        return models === undefined ? advanced.page : { ...advanced.page, models };
     }
-    async function acquireModels(entries) {
-        const acquired = new Map();
-        for (const part of selections(entries, (entry) => modelPrefixes(entry).length, declared().max_prefixes)) {
-            const answer = await transport.door(DOOR_BOOTSTRAP, {
-                prefixes: part.flatMap((entry) => modelPrefixes(entry)),
-            });
-            const classified = classifyDoor(answer.status, answer.body, PRIVATE_LOCATOR);
-            const envelope = classified === null ? parseEnvelope(await bundled(answer.body)) : null;
-            const failure = modelFailure(classified, envelope);
-            for (const entry of part) {
-                acquired.set(modelKey(entry.locator, 'collection'), await held(envelope, entry, entry.schema, failure));
-                if (entry.houseModel === null)
-                    continue;
-                acquired.set(modelKey(entry.locator, 'typed-selection'), await held(envelope, entry, entry.houseModel.root, failure));
-            }
-        }
-        return acquired;
+    function held(rooms) {
+        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));
+            notifications.reach(entry.authority, at);
+            return [presented(entry.authority, at)];
+        });
+        notifications.send(kept);
     }
-    function roomOf(authority, acquired) {
-        const locator = locatorOf(authority);
-        const key = modelKey(locator, 'collection');
-        const collection = models.retain(key, acquired.get(key));
-        const selection = authority.houseModel === null
-            ? undefined
-            : models.retain(modelKey(locator, 'typed-selection'), acquired.get(modelKey(locator, 'typed-selection')));
-        return discoveredRoom(authority, collection?.identity ?? null, selection?.identity ?? null);
+    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);
+        if (follows && at !== null)
+            notifications.reach(entry.authority, at);
+        return relinked.attachments === undefined
+            ? accepted
+            : { ...accepted, attachments: relinked.attachments };
     }
     function authorityFor(locator) {
         return tracked.get(locator);
@@ -115,9 +104,7 @@ export function createAgentsHouseAdapter(options) {
         const { authority, position, log_epoch: logEpoch } = body;
         if (typeof position !== 'string' || typeof logEpoch !== 'string')
             return result;
-        const locator = authority === undefined
-            ? PRIVATE_LOCATOR
-            : [...tracked.values()].find((entry) => entry.authority === authority)?.locator;
+        const locator = [...tracked.values()].find((entry) => entry.authority === authority)?.locator;
         if (locator === undefined)
             return result;
         return { ...result, at: { locator, roomVersion: roomVersion({ position, logEpoch }) } };
@@ -147,14 +134,14 @@ export function createAgentsHouseAdapter(options) {
             });
             const classified = part.map((entry) => classifyDoor(answer.status, answer.body, entry.locator));
             const envelope = classified[0] === null ? parseEnvelope(await bundled(answer.body)) : null;
-            part.forEach((entry, index) => {
+            for (const [index, entry] of part.entries()) {
                 const failure = classified[index];
                 if (failure === null || failure === undefined) {
-                    answers.push(envelope === null ? UNCERTAIN_READ : bootstrappedRoom(envelope, entry));
-                    return;
+                    answers.push(envelope === null ? UNCERTAIN_READ : await bootstrappedRoom(envelope, entry));
+                    continue;
                 }
-                answers.push(failure.kind === 'beyond-horizon' ? UNCERTAIN_READ : failure);
-            });
+                answers.push(failure);
+            }
         }
         return answers;
     }
@@ -176,24 +163,9 @@ export function createAgentsHouseAdapter(options) {
             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),
-                        ...(ask.minPosition === undefined ? {} : { min_position: ask.minPosition }),
-                    })),
+                    positions: open.map((ask) => presented(ask.entry.authority, ask.from)),
                 });
-                const refusal = doorRefusal(answer.body);
-                if (refusal?.code === 'replica_behind') {
-                    const named = open.filter((ask) => ask.entry.authority === refusal.fields.authority);
-                    const behind = named.length === 0 ? open : named;
-                    for (const ask of behind) {
-                        answers.set(ask, refusal.retryable
-                            ? { kind: 'retryable-refusal', code: refusal.code, fields: refusal.fields }
-                            : (classifyDoor(answer.status, answer.body, ask.entry.locator) ?? UNCERTAIN_READ));
-                    }
-                    open = open.filter((ask) => !behind.includes(ask));
-                    continue;
-                }
-                const classified = open.map((ask) => classifyDoor(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);
@@ -205,14 +177,14 @@ export function createAgentsHouseAdapter(options) {
                     continue;
                 }
                 const enumeration = classified[0] === null ? parseEnumeration(answer.body, 'credential') : null;
-                open.forEach((ask, index) => {
+                for (const [index, ask] of open.entries()) {
                     const failure = classified[index];
                     if (failure !== null && failure !== undefined) {
                         answers.set(ask, failure);
-                        return;
+                        continue;
                     }
-                    answers.set(ask, enumeration === null ? UNCERTAIN_READ : enumeratedRoom(enumeration, ask));
-                });
+                    answers.set(ask, enumeration === null ? UNCERTAIN_READ : await enumeratedRoom(enumeration, ask));
+                }
                 open = [];
             }
         }
@@ -224,7 +196,7 @@ export function createAgentsHouseAdapter(options) {
         const paths = batchPaths(changes);
         const sha256 = await deltaDigest(delta);
         if (handed !== undefined && handed.sha256 === sha256) {
-            return { body: { ...head, paths, upload: handed } };
+            return { body: { ...head, paths, upload: handed, runtime: notifications.runtime } };
         }
         const minted = await transport.door(DOOR_BATCH_UPLOAD, { ...head, paths, bytes, sha256 });
         if (minted.status !== 200) {
@@ -247,10 +219,10 @@ export function createAgentsHouseAdapter(options) {
             return { outcome: UNCERTAIN };
         const upload = { url: holding.url, operation: holding.operation, bytes, sha256 };
         await keep(upload);
-        return { body: { ...head, paths, upload } };
+        return { body: { ...head, paths, upload, runtime: notifications.runtime } };
     }
     async function submit(head, changes, delta, bytes, entry, handed, keep) {
-        const inline = { ...head, changes };
+        const inline = { ...head, changes, runtime: notifications.runtime };
         const prepared = uploadable(inline, bytes, declared())
             ? await uploaded(head, changes, delta, bytes, entry, handed, keep)
             : { body: inline };
@@ -263,14 +235,11 @@ export function createAgentsHouseAdapter(options) {
         async authorize() {
             return options.authorize();
         },
-        async model(_authorization, request) {
-            return models.answer(request);
-        },
         async discover(_authorization) {
             const answer = await transport.door(DOOR_DISCOVER, { prefixes: [...DISCOVER_PREFIXES] });
-            const classified = classifyDoor(answer.status, answer.body, PRIVATE_LOCATOR);
-            if (classified !== null)
-                return discoveryFailure(classified);
+            const failed = discoveryFailure(answer.status, answer.body);
+            if (failed !== null)
+                return failed;
             const document = parseDiscovery(answer.body);
             if (document === null)
                 return { kind: 'transport-uncertainty' };
@@ -283,9 +252,7 @@ export function createAgentsHouseAdapter(options) {
                 if (!tracked.has(locator))
                     handed.delete(locator);
             notifications.track(entries);
-            const acquired = await acquireModels(entries);
-            models.keep(entries.map((entry) => entry.locator));
-            return mapDiscovery(document, document.authorities.map((authority) => roomOf(authority, acquired)), capabilities(document.actions));
+            return mapDiscovery(document, document.authorities.map((authority) => discoveredRoom(authority)), capabilities(document));
         },
         async bootstrap(_authorization, request) {
             const entry = authorityFor(request.locator);
@@ -304,16 +271,10 @@ export function createAgentsHouseAdapter(options) {
             const from = logPosition(request.fromRoomVersion);
             if (from === null)
                 return { kind: 'beyond-horizon' };
-            const answered = streamed(entry, request, from);
+            const answered = await streamed(entry, request, from);
             if (answered !== null)
                 return answered;
-            const minPosition = request.minPosition === undefined ? null : logPosition(request.minPosition);
-            return enumerateTogether({
-                entry,
-                from,
-                fromRoomVersion: request.fromRoomVersion,
-                ...(minPosition?.logEpoch === from.logEpoch ? { minPosition: minPosition.position } : {}),
-            });
+            return enumerateTogether({ entry, from, fromRoomVersion: request.fromRoomVersion });
         },
         async mutate(_authorization, request, keep) {
             const entry = authorityFor(request.locator);
@@ -328,8 +289,8 @@ export function createAgentsHouseAdapter(options) {
             const handed = request.upload;
             const outcome = await submit(head, mapped.changes, delta, bytes, entry, handed, keep);
             if (handed === undefined || !lapsedGrant(outcome))
-                return outcome;
-            return submit(head, mapped.changes, delta, bytes, entry, undefined, keep);
+                return adopted(entry, outcome);
+            return adopted(entry, await submit(head, mapped.changes, delta, bytes, entry, undefined, keep));
         },
         async history(_authorization, request) {
             const entry = authorityFor(request.locator);
@@ -349,10 +310,13 @@ export function createAgentsHouseAdapter(options) {
         reached(locator, version, target) {
             return reachedVersion(version, target, authorityFor(locator)?.logEpoch);
         },
+        follows(_locator, version, next) {
+            return followsVersion(version, next);
+        },
         async action(_authorization, request) {
             return withAt(await houseAction(transport, request));
         },
-        roomVersions: notifications,
+        roomStream: { hold: held, observe: notifications.observe },
         conversations: notifications.conversations,
         serviceMode: notifications.serviceMode,
     };

package/dist/discovery.d.ts

@@ -1,12 +1,7 @@
-import type { Capability, DiscoveredRoom, Discovery, ModelIdentity, ProviderLimit, Retention } from '@agentshouse/mdruntime';
+import type { Capability, DiscoveredRoom, Discovery, ProviderLimit, Retention } from '@agentshouse/mdruntime';
 import { type LogPosition } from './version.js';
-export declare const ROOM_CONTRACT_VERSION = 1;
-export declare const MD_MODEL_IDENTITY = "@agentshouse/mdmodel";
-export declare const ROOM_VERSION_NOTIFICATIONS = "room-version-notifications";
 export declare const PROVIDER_ACTIONS = "provider-actions";
-export declare const MOVE_REFERENCE_REWRITES = "move-reference-rewrites";
 export declare const DISCOVER_PREFIXES: readonly string[];
-export declare const PRIVATE_HANDLE = "private";
 export type HouseBounds = {
     max_authored_file_bytes: number;
     max_batch_operations: number;
@@ -43,7 +38,6 @@ export type HouseAuthority = LogPosition & {
 };
 export type HouseDiscoveryDocument = {
     bounds: HouseBounds;
-    mdModelVersion: string;
     authorities: readonly HouseAuthority[];
     actions: readonly string[];
 };
@@ -62,18 +56,16 @@ export type HouseSiteAuthority = LogPosition & {
 };
 export type HouseSiteDiscovery = {
     bounds: HouseBounds;
-    mdModelVersion: string;
     authorities: readonly HouseSiteAuthority[];
 };
 export declare function parseDiscovery(body: unknown): HouseDiscoveryDocument | null;
 export declare function parseSiteDiscovery(body: unknown): HouseSiteDiscovery | null;
 export declare function siteTracked(document: HouseSiteDiscovery): TrackedAuthority[];
-export declare function locatorOf(authority: HouseAuthority): string;
 export declare function trackedFrom(document: HouseDiscoveryDocument): TrackedAuthority[];
 export declare function providerLimits(bounds: HouseBounds): readonly ProviderLimit[];
 export declare function declaredRetention(bounds: HouseBounds): Retention;
-export declare function capabilities(actions: readonly string[]): readonly Capability[];
+export declare function capabilities(document: HouseDiscoveryDocument): readonly Capability[];
 export declare function siteCapabilities(): readonly Capability[];
-export declare function discoveredRoom(authority: HouseAuthority, attachedModel: DiscoveredRoom['attachedModel'], selectionModel: ModelIdentity | null): DiscoveredRoom;
-export declare function mapDiscovery(document: Pick<HouseDiscoveryDocument, 'bounds' | 'mdModelVersion'>, rooms: readonly DiscoveredRoom[], declared: readonly Capability[]): Discovery;
+export declare function discoveredRoom(authority: HouseAuthority): DiscoveredRoom;
+export declare function mapDiscovery(document: Pick<HouseDiscoveryDocument, 'bounds'>, rooms: readonly DiscoveredRoom[], declared: readonly Capability[]): Discovery;
 //# sourceMappingURL=discovery.d.ts.map

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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"}