@agentshouse/mdruntime-adapter 0.1.0-cd028205a5103 → 0.1.0-ce3fe65a95f49

package/dist/adapter.js

@@ -1,14 +1,15 @@
 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';
+import { acceptedHanded, enumeratedHanded, heldHanded, scopeHanded, streamedHanded, } from './handed.js';
 import { houseAction } from './actions.js';
 import { classifyDoor, classifyRead, discoveryFailure, doorRefusal } from './refusal.js';
 import { houseNotifications } from './stream.js';
-import { DOOR_BATCH, DOOR_BATCH_UPLOAD, DOOR_BOOTSTRAP, DOOR_DISCOVER, DOOR_ENUMERATE, DOOR_REVISIONS, } from './transport.js';
+import { DOOR_BATCH, DOOR_BATCH_UPLOAD, DOOR_BOOTSTRAP, DOOR_DISCOVER, DOOR_ENUMERATE, DOOR_FILES_GET, DOOR_REVISIONS, } from './transport.js';
 import { batchPaths, deltaBody, deltaBytes, deltaDigest, historyOutcome, houseChanges, mutationOutcome, operationHead, rejectedMapping, revisionBody, uploadable, } from './write.js';
+import { houseReferrer } from './referrer.js';
 import { followsVersion, logPosition, presented, reachedVersion, roomVersion, } from './version.js';
 const UNCERTAIN = { kind: 'transport-uncertainty' };
 const UNCERTAIN_READ = { kind: 'transport-uncertainty' };
@@ -28,14 +29,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, scopeHanded(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);
@@ -45,21 +58,18 @@ export function createAgentsHouseAdapter(options) {
         const answer = refreshFrom(view, ask.fromRoomVersion);
         if (answer.kind !== 'net-advancement')
             return answer;
-        handed.set(ask.entry.locator, enumeratedLinks(view, handed.get(ask.entry.locator)));
+        handed.set(ask.entry.locator, enumeratedHanded(view, handed.get(ask.entry.locator)));
         const models = await viewModels(view, ask.entry);
         return models === undefined ? answer : { ...answer, models };
     }
     async function streamed(entry, request, from) {
-        const links = handed.get(entry.locator);
-        if (links?.roomVersion !== request.fromRoomVersion)
+        const held = handed.get(entry.locator);
+        if (held?.roomVersion !== request.fromRoomVersion)
             return null;
-        const advanced = notifications.advance(entry, from, (path, revision) => links.revisions.get(path) === revision);
+        const advanced = notifications.advance(entry, from, (path, revision) => held.revisions.get(path) === revision);
         if (advanced === null)
             return null;
-        const relinked = streamedLinks(links, advanced);
-        if (relinked === null)
-            return null;
-        handed.set(entry.locator, relinked);
+        handed.set(entry.locator, streamedHanded(held, advanced));
         const models = await streamedModels(advanced.schemas, entry, 'credential');
         return models === undefined ? advanced.page : { ...advanced.page, models };
     }
@@ -69,7 +79,7 @@ export function createAgentsHouseAdapter(options) {
             const at = logPosition(room.roomVersion);
             if (entry === undefined || at === null)
                 return [];
-            handed.set(room.locator, heldLinks(room));
+            handed.set(room.locator, heldHanded(room));
             notifications.reach(entry.authority, at);
             return [presented(entry.authority, at)];
         });
@@ -78,19 +88,15 @@ export function createAgentsHouseAdapter(options) {
     function adopted(entry, outcome) {
         if (outcome.kind !== 'accepted')
             return outcome;
-        const { originals, ...accepted } = outcome;
-        const links = handed.get(entry.locator);
-        if (links === undefined)
-            return accepted;
-        const follows = followsVersion(links.roomVersion, accepted.roomVersion);
-        const relinked = acceptedLinks(links, accepted, follows ? accepted.roomVersion : links.roomVersion, originals);
-        handed.set(entry.locator, relinked.links);
-        const at = logPosition(accepted.roomVersion);
+        const held = handed.get(entry.locator);
+        if (held === undefined)
+            return outcome;
+        const follows = followsVersion(held.roomVersion, outcome.roomVersion);
+        handed.set(entry.locator, acceptedHanded(held, outcome, follows ? outcome.roomVersion : held.roomVersion));
+        const at = logPosition(outcome.roomVersion);
         if (follows && at !== null)
             notifications.reach(entry.authority, at);
-        return relinked.attachments === undefined
-            ? accepted
-            : { ...accepted, attachments: relinked.attachments };
+        return outcome;
     }
     function authorityFor(locator) {
         return tracked.get(locator);
@@ -109,41 +115,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 +209,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 +226,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)
@@ -221,7 +238,30 @@ export function createAgentsHouseAdapter(options) {
         await keep(upload);
         return { body: { ...head, paths, upload, runtime: notifications.runtime } };
     }
-    async function submit(head, changes, delta, bytes, entry, handed, keep) {
+    async function staged(answer, batch) {
+        const refusal = doorRefusal(answer.body);
+        if (refusal?.code !== 'files_unstaged')
+            return null;
+        const grants = refusal.fields.upload;
+        if (!Array.isArray(grants))
+            return false;
+        for (const grant of grants) {
+            const { url, operation, sha256 } = grant;
+            const change = batch.changes.find((held) => held.kind === 'binary' && held.sha256 === sha256);
+            if (typeof url !== 'string' || typeof operation !== 'string' || change === undefined)
+                return false;
+            const delivered = await transport.transfer({
+                act: 'binary_stage',
+                url,
+                body: change.blob,
+                operation,
+            });
+            if (delivered.status !== 200)
+                return false;
+        }
+        return true;
+    }
+    async function submit(batch, head, changes, delta, bytes, entry, handed, keep) {
         const inline = { ...head, changes, runtime: notifications.runtime };
         const prepared = uploadable(inline, bytes, declared())
             ? await uploaded(head, changes, delta, bytes, entry, handed, keep)
@@ -229,7 +269,33 @@ export function createAgentsHouseAdapter(options) {
         if ('outcome' in prepared)
             return prepared.outcome;
         const answer = await transport.door(DOOR_BATCH, prepared.body);
-        return mutationOutcome(answer.status, answer.body, entry.locator, entry.handle);
+        const stagedFiles = await staged(answer, batch);
+        if (stagedFiles === false)
+            return UNCERTAIN;
+        const settled = stagedFiles === null ? answer : await transport.door(DOOR_BATCH, prepared.body);
+        if (stagedFiles === true && (await staged(settled, batch)) !== null)
+            return UNCERTAIN;
+        return mutationOutcome(settled.status, settled.body, entry.locator, entry.handle);
+    }
+    async function downloaded(answer, locator) {
+        const failure = classifyDoor(answer.status, answer.body, locator);
+        if (failure !== null) {
+            return failure.kind === 'scoped-refusal'
+                ? {
+                    kind: 'rejected',
+                    code: failure.code,
+                    fields: failure.fields,
+                    retryable: failure.retryable,
+                }
+                : failure;
+        }
+        const grant = parseGrant(answer.body);
+        if (grant === null || grant.method !== 'GET')
+            return UNCERTAIN_READ;
+        const read = await transport.download(grant.url);
+        if (read.status !== 200 || read.blob === null)
+            return UNCERTAIN_READ;
+        return { kind: 'binary', blob: read.blob };
     }
     return {
         async authorize() {
@@ -252,14 +318,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) {
@@ -287,10 +357,11 @@ export function createAgentsHouseAdapter(options) {
             const delta = deltaBody(mapped.changes);
             const bytes = deltaBytes(delta);
             const handed = request.upload;
-            const outcome = await submit(head, mapped.changes, delta, bytes, entry, handed, keep);
+            const batch = request.changeBatch;
+            const outcome = await submit(batch, head, mapped.changes, delta, bytes, entry, handed, keep);
             if (handed === undefined || !lapsedGrant(outcome))
                 return adopted(entry, outcome);
-            return adopted(entry, await submit(head, mapped.changes, delta, bytes, entry, undefined, keep));
+            return adopted(entry, await submit(batch, head, mapped.changes, delta, bytes, entry, undefined, keep));
         },
         async history(_authorization, request) {
             const entry = authorityFor(request.locator);
@@ -307,6 +378,37 @@ export function createAgentsHouseAdapter(options) {
                 ...(request.revision === undefined ? {} : { revision: request.revision }),
             });
         },
+        async binary(_authorization, request) {
+            if (request.kind === 'path') {
+                const entry = authorityFor(request.locator);
+                if (entry === undefined)
+                    return { kind: 'room-not-readable', locator: request.locator };
+                const answer = await transport.door(DOOR_FILES_GET, {
+                    room_ref: entry.authority,
+                    path: request.path,
+                    revision: request.revision,
+                });
+                return downloaded(answer, request.locator);
+            }
+            const referrer = houseReferrer(request.referrer, tracked);
+            if (referrer === null) {
+                return { kind: 'rejected', code: 'referrer_unknown', fields: {}, retryable: false };
+            }
+            const answer = await transport.door(DOOR_FILES_GET, {
+                file: request.fileRef,
+                referrer: referrer.referrer,
+            });
+            return downloaded(answer, referrer.locator);
+        },
+        referrerScope(referrer) {
+            const held = houseReferrer(referrer, tracked);
+            if (held === null)
+                return null;
+            if (held.locator === '')
+                return { kind: 'conversations' };
+            const { path } = held.referrer;
+            return { kind: 'room', locator: held.locator, ...(path === undefined ? {} : { path }) };
+        },
         reached(locator, version, target) {
             return reachedVersion(version, target, authorityFor(locator)?.logEpoch);
         },

package/dist/discovery.d.ts

@@ -1,4 +1,4 @@
-import type { Capability, DiscoveredRoom, Discovery, ProviderLimit, Retention } from '@agentshouse/mdruntime';
+import type { Capability, DiscoveredRoom, Discovery, Member, ProviderLimit, Retention } from '@agentshouse/mdruntime';
 import { type LogPosition } from './version.js';
 export declare const PROVIDER_ACTIONS = "provider-actions";
 export declare const DISCOVER_PREFIXES: readonly string[];
@@ -37,6 +37,7 @@ export type HouseAuthority = LogPosition & {
     operations: HouseOperations;
 };
 export type HouseDiscoveryDocument = {
+    member: Member;
     bounds: HouseBounds;
     authorities: readonly HouseAuthority[];
     actions: readonly string[];

package/dist/discovery.d.ts.map

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

package/dist/discovery.js

@@ -1,4 +1,4 @@
-import { declaredActions, houseConversationAgents } from './actions.js';
+import { declaredActions, houseConversationAgents, SITE_SUBMIT } from './actions.js';
 import { readPosition, roomVersion } from './version.js';
 export const PROVIDER_ACTIONS = 'provider-actions';
 export const DISCOVER_PREFIXES = ['/'];
@@ -46,6 +46,14 @@ function parseHouseModel(value) {
         return undefined;
     return { root: held.root, paths };
 }
+function parseMember(value) {
+    if (typeof value !== 'object' || value === null)
+        return null;
+    const { user, name } = value;
+    if (typeof user !== 'string' || typeof name !== 'string')
+        return null;
+    return { kind: 'user', id: user, name };
+}
 function parseOperations(value) {
     if (typeof value !== 'object' || value === null)
         return null;
@@ -98,6 +106,9 @@ export function parseDiscovery(body) {
     if (typeof body !== 'object' || body === null)
         return null;
     const held = body;
+    const member = parseMember(held.member);
+    if (member === null)
+        return null;
     const bounds = parseBounds(held.bounds);
     if (bounds === null)
         return null;
@@ -115,7 +126,7 @@ export function parseDiscovery(body) {
             return null;
         authorities.push(authority);
     }
-    return { bounds, authorities, actions };
+    return { member, bounds, authorities, actions };
 }
 function parseSiteAuthority(value) {
     if (typeof value !== 'object' || value === null)
@@ -218,7 +229,10 @@ export function capabilities(document) {
 }
 export function siteCapabilities() {
     return [
-        { name: PROVIDER_ACTIONS, actions: [{ name: 'submit', inputShape: {}, resultKind: 'house' }] },
+        {
+            name: PROVIDER_ACTIONS,
+            actions: [{ name: SITE_SUBMIT, inputShape: {}, resultKind: 'house' }],
+        },
     ];
 }
 export function discoveredRoom(authority) {

package/dist/gather.d.ts

@@ -1,3 +1,4 @@
+export declare function gatheredEach<A, R>(send: (asks: readonly A[], answer: (ask: number, result: R) => void) => Promise<void>): (ask: A) => Promise<R>;
 export declare function gathered<A, R>(send: (asks: readonly A[]) => Promise<readonly R[]>): (ask: A) => Promise<R>;
 export declare function selections<T>(items: readonly T[], weight: (item: T) => number, limit: number): readonly (readonly T[])[];
 //# sourceMappingURL=gather.d.ts.map

package/dist/gather.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gather.d.ts","sourceRoot":"","sources":["../src/gather.ts"],"names":[],"mappings":"AAMA,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,KAAK,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,GAClD,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CA0BxB;AAED,wBAAgB,UAAU,CAAC,CAAC,EAC1B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC3B,KAAK,EAAE,MAAM,GACZ,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAgB3B"}
+{"version":3,"file":"gather.d.ts","sourceRoot":"","sources":["../src/gather.ts"],"names":[],"mappings":"AAMA,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAC/B,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,GACpF,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAwBxB;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,KAAK,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,GAClD,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAMxB;AAED,wBAAgB,UAAU,CAAC,CAAC,EAC1B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC3B,KAAK,EAAE,MAAM,GACZ,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAgB3B"}

package/dist/gather.js

@@ -1,13 +1,11 @@
-export function gathered(send) {
+export function gatheredEach(send) {
     let held = [];
     function flush() {
         const taken = held;
         held = [];
-        send(taken.map((entry) => entry.ask)).then((answers) => {
-            taken.forEach((entry, index) => {
-                entry.resolve(answers[index]);
-            });
-        }, (reason) => {
+        send(taken.map((entry) => entry.ask), (ask, result) => {
+            taken[ask]?.resolve(result);
+        }).catch((reason) => {
             for (const entry of taken)
                 entry.reject(reason);
         });
@@ -20,6 +18,13 @@ export function gathered(send) {
         held.push({ ask, resolve, reject });
     });
 }
+export function gathered(send) {
+    return gatheredEach(async (asks, answer) => {
+        (await send(asks)).forEach((result, ask) => {
+            answer(ask, result);
+        });
+    });
+}
 export function selections(items, weight, limit) {
     const parts = [];
     let part = [];

package/dist/handed.d.ts

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

package/dist/handed.d.ts.map

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

package/dist/handed.js

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

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

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

package/dist/model.d.ts

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

package/dist/model.d.ts.map

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

package/dist/model.js

@@ -26,8 +26,12 @@ async function modelsOf(tracked, read) {
     }
     return models.collection === undefined && models.selection === undefined ? undefined : models;
 }
-export function scopeModels(scope, tracked) {
-    return modelsOf(tracked, (schema) => schemaOf(scope, schema));
+export function partModels(scope, tracked, seen, final) {
+    return modelsOf(tracked, (schema) => {
+        if (scope.files.some((file) => file.path === schema))
+            return schemaOf(scope, schema);
+        return final && !seen.has(schema) ? ABSENT_SCHEMA : undefined;
+    });
 }
 export function viewModels(view, tracked) {
     return modelsOf(tracked, (schema) => {