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

package/dist/read.d.ts

@@ -1,4 +1,4 @@
-import type { BootstrapPage, RefreshResult, RoomAttachment } from '@agentshouse/mdruntime';
+import type { AdapterFailure, BinaryFile, BootstrapPage, RefreshResult } from '@agentshouse/mdruntime';
 import type { TrackedAuthority } from './discovery.js';
 import type { HouseMode } from './transport.js';
 import { type LogPosition } from './version.js';
@@ -7,7 +7,9 @@ export type HouseManifestFile = {
     path: string;
     revision: string | undefined;
     version: string;
+    sha256?: string;
     head?: HeadChange;
+    binary?: BinaryFile;
 };
 export type HouseContent = {
     path: string;
@@ -17,11 +19,15 @@ export type HouseScope = LogPosition & {
     anchor: string;
     files: readonly HouseManifestFile[];
     contents: readonly HouseContent[];
-    attachments?: readonly RoomAttachment[];
+};
+export type HouseCut = {
+    position: string;
+    log_epoch: string;
 };
 export type HouseCursor = {
     room: string;
     path: string | null;
+    cut?: HouseCut;
 };
 export type HouseEnvelope = {
     scopes: readonly HouseScope[];
@@ -46,14 +52,23 @@ export type HouseChange = {
     head?: HeadChange;
 } | {
     path: string;
-    reference: {
-        revision: string;
-    };
+    binary: BinaryFile;
+    revision: string | undefined;
+    version: string;
+    head?: HeadChange;
+};
+export type HousePage = {
+    after: string;
+    through: string;
+    read: number;
 };
 export type HouseView = LogPosition & {
     authority: string;
     changes: readonly HouseChange[];
-    attachments?: readonly RoomAttachment[];
+    next?: HousePage;
+};
+type PageFailure = AdapterFailure | {
+    kind: 'beyond-horizon';
 };
 export type HouseEnumeration = {
     authorities: readonly HouseView[];
@@ -66,10 +81,13 @@ export declare function headChange(held: {
     readonly author?: unknown;
     readonly created_at?: unknown;
 }): HeadChange | undefined | null;
-export declare function parseOriginals(value: unknown): readonly RoomAttachment[] | null;
+export declare function binaryFileOf(held: Readonly<Record<string, unknown>>): BinaryFile | undefined | null;
 export declare function parseEnvelope(body: unknown): HouseEnvelope | null;
 export declare function parseSiteBootstrap(body: unknown): HouseScope | null;
+export declare function siteBootstrapNext(body: unknown): string | null;
+export declare function siteBootstrapOffset(body: unknown): number | null;
 export declare function parseEnumeration(body: unknown, mode: HouseMode): HouseEnumeration | null;
+export declare function wholeView(first: HouseView, more: (page: HousePage) => Promise<HouseView | PageFailure>): Promise<HouseView | PageFailure>;
 export declare function advancedScope(scope: HouseScope, view: HouseView): HouseScope;
 export declare function matchesScope(scope: HouseScope, tracked: TrackedAuthority): boolean;
 export declare function bootstrapOf(scope: HouseScope): BootstrapPage;
@@ -81,4 +99,5 @@ export type HouseSchema = {
 export declare function schemaOf(scope: HouseScope, schema: string): HouseSchema | null;
 export declare function viewOf(enumeration: HouseEnumeration, tracked: TrackedAuthority): HouseView | undefined;
 export declare function refreshFrom(view: HouseView, fromRoomVersion: string): RefreshResult;
+export {};
 //# sourceMappingURL=read.d.ts.map

package/dist/read.d.ts.map

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

package/dist/read.js

@@ -1,4 +1,4 @@
-import { readPosition, roomVersion } from './version.js';
+import { DECIMAL, readPosition, roomVersion } from './version.js';
 export function authorityRoot(handle) {
     return `/rooms/${handle}`;
 }
@@ -51,32 +51,19 @@ export function headChange(held) {
 function headed(head) {
     return head === undefined ? {} : { head };
 }
-function parseOriginal(value) {
-    if (typeof value !== 'object' || value === null)
-        return null;
-    const { attachment, name, bytes, media_type: mediaType } = value;
-    if (typeof attachment !== 'string' || typeof name !== 'string')
-        return null;
-    if (typeof bytes !== 'number' || !Number.isSafeInteger(bytes) || bytes < 0)
-        return null;
-    if (mediaType !== null && typeof mediaType !== 'string')
-        return null;
-    return { reference: attachment, name, byteLength: bytes, mediaType, entry: value };
-}
-export function parseOriginals(value) {
-    if (!Array.isArray(value))
+export function binaryFileOf(held) {
+    if (held.file === undefined)
+        return undefined;
+    const { file, bytes, media_type: mediaType, sha256 } = held;
+    if (typeof file !== 'string' ||
+        typeof bytes !== 'number' ||
+        typeof mediaType !== 'string' ||
+        typeof sha256 !== 'string')
         return null;
-    const attachments = [];
-    for (const entry of value) {
-        const attachment = parseOriginal(entry);
-        if (attachment === null)
-            return null;
-        attachments.push(attachment);
-    }
-    return attachments;
+    return { fileRef: file, byteLength: bytes, mediaType, sha256 };
 }
-function declared(attachments) {
-    return attachments === undefined ? {} : { attachments };
+function binaried(binary) {
+    return binary === undefined ? {} : { binary };
 }
 function parseFile(value, mode) {
     if (typeof value !== 'object' || value === null)
@@ -85,16 +72,30 @@ function parseFile(value, mode) {
     if (typeof file.path !== 'string')
         return null;
     const head = headChange(file);
-    if (head === null)
+    const binary = binaryFileOf(file);
+    if (head === null || binary === null)
         return null;
     if (mode === 'site') {
         if (typeof file.sha256 !== 'string')
             return null;
-        return { path: file.path, revision: undefined, version: file.sha256, ...headed(head) };
+        return {
+            path: file.path,
+            revision: binary?.sha256,
+            version: file.sha256,
+            ...headed(head),
+            ...binaried(binary),
+        };
     }
     if (typeof file.revision !== 'string')
         return null;
-    return { path: file.path, revision: file.revision, version: file.revision, ...headed(head) };
+    return {
+        path: file.path,
+        revision: file.revision,
+        version: file.revision,
+        ...(typeof file.sha256 === 'string' ? { sha256: file.sha256 } : {}),
+        ...headed(head),
+        ...binaried(binary),
+    };
 }
 function parseScope(value, mode) {
     if (typeof value !== 'object' || value === null)
@@ -130,20 +131,28 @@ function parseScope(value, mode) {
             return null;
         contents.push({ path: content.path, content: content.content });
     }
-    if (mode === 'site')
-        return { anchor: manifest.anchor, ...at, files, contents };
-    const attachments = parseOriginals(held.originals);
-    if (attachments === null)
+    return { anchor: manifest.anchor, ...at, files, contents };
+}
+function parseCut(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'object' || value === null)
+        return null;
+    const { position, log_epoch: logEpoch } = value;
+    if (typeof position !== 'string' || typeof logEpoch !== 'string')
         return null;
-    return { anchor: manifest.anchor, ...at, files, contents, attachments };
+    return { position, log_epoch: logEpoch };
 }
 function parseCursor(value) {
     if (typeof value !== 'object' || value === null)
         return null;
-    const { room, path } = value;
+    const { room, path, cut } = value;
     if (typeof room !== 'string' || (path !== null && typeof path !== 'string'))
         return null;
-    return { room, path };
+    const parsed = parseCut(cut);
+    if (parsed === null)
+        return null;
+    return { room, path, ...(parsed === undefined ? {} : { cut: parsed }) };
 }
 export function parseEnvelope(body) {
     if (typeof body !== 'object' || body === null)
@@ -165,6 +174,18 @@ export function parseEnvelope(body) {
 export function parseSiteBootstrap(body) {
     return parseScope(body, 'site');
 }
+export function siteBootstrapNext(body) {
+    if (typeof body !== 'object' || body === null || !('next' in body))
+        return null;
+    return typeof body.next === 'string' && body.next.length > 0 ? body.next : null;
+}
+export function siteBootstrapOffset(body) {
+    if (typeof body !== 'object' || body === null || !('offset' in body))
+        return null;
+    return Number.isSafeInteger(body.offset) && body.offset > 0
+        ? body.offset
+        : null;
+}
 function parseChange(value, mode) {
     if (typeof value !== 'object' || value === null)
         return null;
@@ -174,8 +195,15 @@ function parseChange(value, mode) {
     if (held.removed === true)
         return { path: held.path, removed: true };
     const head = headChange(held);
-    if (head === null)
+    const binary = binaryFileOf(held);
+    if (head === null || binary === null)
         return null;
+    if (binary !== undefined) {
+        if (mode === 'credential' && typeof held.revision !== 'string')
+            return null;
+        const revision = typeof held.revision === 'string' ? held.revision : binary.sha256;
+        return { path: held.path, binary, revision, version: revision, ...headed(head) };
+    }
     if (mode === 'site') {
         if (typeof held.content !== 'string' || typeof held.sha256 !== 'string')
             return null;
@@ -196,12 +224,6 @@ function parseChange(value, mode) {
             ...headed(head),
         };
     }
-    if (typeof held.reference === 'object' && held.reference !== null) {
-        const reference = held.reference;
-        if (typeof reference.revision !== 'string')
-            return null;
-        return { path: held.path, reference: { revision: reference.revision } };
-    }
     return null;
 }
 export function parseEnumeration(body, mode) {
@@ -226,17 +248,60 @@ export function parseEnumeration(body, mode) {
                 return null;
             changes.push(mapped);
         }
-        if (mode === 'site') {
-            authorities.push({ authority: held.authority, ...at, changes });
-            continue;
-        }
-        const attachments = parseOriginals(held.originals);
-        if (attachments === null)
+        const next = held.next === undefined ? undefined : readPage(held.next);
+        if (next === null)
             return null;
-        authorities.push({ authority: held.authority, ...at, changes, attachments });
+        authorities.push({
+            authority: held.authority,
+            ...at,
+            changes,
+            ...(next === undefined ? {} : { next }),
+        });
     }
     return { authorities };
 }
+function readPage(held) {
+    if (typeof held !== 'object' || held === null)
+        return null;
+    const { after, through, read } = held;
+    if (typeof after !== 'string' || !DECIMAL.test(after))
+        return null;
+    if (typeof through !== 'string' || !DECIMAL.test(through))
+        return null;
+    if (typeof read !== 'number' || !Number.isSafeInteger(read) || read < 0)
+        return null;
+    return { after, through, read };
+}
+function advances(asked, next) {
+    const moved = BigInt(next.through) - BigInt(asked.through);
+    return moved > 0n || (moved === 0n && next.after === asked.after && next.read > asked.read);
+}
+export async function wholeView(first, more) {
+    const changes = new Map(first.changes.map((change) => [change.path, change]));
+    let view = first;
+    while (view.next !== undefined) {
+        const asked = view.next;
+        const page = await more(asked);
+        if ('kind' in page)
+            return page;
+        if (page.position !== asked.through ||
+            page.logEpoch !== first.logEpoch ||
+            (page.next !== undefined && !advances(asked, page.next))) {
+            return { kind: 'transport-uncertainty' };
+        }
+        for (const change of page.changes) {
+            changes.delete(change.path);
+            changes.set(change.path, change);
+        }
+        view = page;
+    }
+    return {
+        authority: first.authority,
+        position: view.position,
+        logEpoch: first.logEpoch,
+        changes: [...changes.values()],
+    };
+}
 export function advancedScope(scope, view) {
     const files = new Map(scope.files.map((file) => [file.path, file]));
     const contents = new Map(scope.contents.map((entry) => [entry.path, entry.content]));
@@ -245,18 +310,15 @@ export function advancedScope(scope, view) {
         contents.delete(change.path);
         if ('removed' in change)
             continue;
-        if ('content' in change) {
-            files.set(change.path, {
-                path: change.path,
-                revision: change.revision,
-                version: change.version,
-                ...headed(change.head),
-            });
+        files.set(change.path, {
+            path: change.path,
+            revision: change.revision,
+            version: change.version,
+            ...headed(change.head),
+            ...('binary' in change ? { binary: change.binary } : {}),
+        });
+        if ('content' in change)
             contents.set(change.path, change.content);
-            continue;
-        }
-        const { revision } = change.reference;
-        files.set(change.path, { path: change.path, revision, version: revision });
     }
     return {
         ...scope,
@@ -274,16 +336,16 @@ export function bootstrapOf(scope) {
     const documents = {};
     const revisions = {};
     const changes = {};
-    const binaryTargets = [];
+    const binaryFiles = {};
     for (const file of scope.files) {
         if (file.revision !== undefined)
             revisions[file.path] = file.revision;
         if (file.head !== undefined)
             changes[file.path] = file.head;
         const content = contents.get(file.path);
-        if (content === undefined)
-            binaryTargets.push(file.path);
-        else
+        if (file.binary !== undefined)
+            binaryFiles[file.path] = file.binary;
+        else if (content !== undefined)
             documents[file.path] = content;
     }
     return {
@@ -292,8 +354,7 @@ export function bootstrapOf(scope) {
         documents,
         revisions,
         changes,
-        binaryTargets: binaryTargets.sort(),
-        ...declared(scope.attachments),
+        binaryFiles,
     };
 }
 export function schemaOf(scope, schema) {
@@ -314,23 +375,21 @@ export function refreshFrom(view, fromRoomVersion) {
     const documents = {};
     const revisions = {};
     const changes = {};
-    const binaryTargets = [];
+    const binaryFiles = {};
     const removals = [];
     for (const change of view.changes) {
         if ('removed' in change) {
             removals.push(change.path);
             continue;
         }
-        if ('content' in change) {
+        if ('content' in change)
             documents[change.path] = change.content;
-            if (change.revision !== undefined)
-                revisions[change.path] = change.revision;
-            if (change.head !== undefined)
-                changes[change.path] = change.head;
-            continue;
-        }
-        binaryTargets.push(change.path);
-        revisions[change.path] = change.reference.revision;
+        else
+            binaryFiles[change.path] = change.binary;
+        if (change.revision !== undefined)
+            revisions[change.path] = change.revision;
+        if (change.head !== undefined)
+            changes[change.path] = change.head;
     }
     return {
         kind: 'net-advancement',
@@ -338,8 +397,7 @@ export function refreshFrom(view, fromRoomVersion) {
         documents,
         revisions,
         changes,
-        binaryTargets: binaryTargets.sort(),
+        binaryFiles,
         removals: removals.sort(),
-        ...declared(view.attachments),
     };
 }

package/dist/referrer.d.ts

@@ -0,0 +1,7 @@
+import type { TrackedAuthority } from './discovery.js';
+export type HouseReferrer = {
+    locator: string;
+    referrer: Readonly<Record<string, string>>;
+};
+export declare function houseReferrer(referrer: unknown, tracked: ReadonlyMap<string, TrackedAuthority>): HouseReferrer | null;
+//# sourceMappingURL=referrer.d.ts.map

package/dist/referrer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referrer.d.ts","sourceRoot":"","sources":["../src/referrer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC;AAgB5F,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC7C,aAAa,GAAG,IAAI,CAqBtB"}

package/dist/referrer.js

@@ -0,0 +1,35 @@
+function fields(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : null;
+}
+function named(held, ...keys) {
+    const present = Object.keys(held);
+    return (present.length === keys.length &&
+        keys.every((key) => typeof held[key] === 'string' && held[key] !== ''));
+}
+export function houseReferrer(referrer, tracked) {
+    const held = fields(referrer);
+    if (held === null)
+        return null;
+    if (named(held, 'room', 'path')) {
+        const entry = tracked.get(held.room);
+        if (entry === undefined)
+            return null;
+        return {
+            locator: entry.locator,
+            referrer: { room_ref: entry.authority, path: held.path },
+        };
+    }
+    if (named(held, 'room_ref', 'record')) {
+        const roomRef = held.room_ref;
+        const entry = [...tracked.values()].find((candidate) => candidate.authority === roomRef);
+        return {
+            locator: entry?.locator ?? roomRef,
+            referrer: { room_ref: roomRef, record: held.record },
+        };
+    }
+    if (named(held, 'message'))
+        return { locator: '', referrer: { message: held.message } };
+    return null;
+}

package/dist/refusal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refusal.d.ts","sourceRoot":"","sources":["../src/refusal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,aAAa,EACd,MAAM,wBAAwB,CAAC;AAEhC,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAOjE;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAC7B,OAAO,EAAE,eAAe,GACvB,aAAa,CAEf;AAmBD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,cAAc,GAAG,IAAI,CAMvB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAAG,IAAI,CAGpD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAQrF"}
+{"version":3,"file":"refusal.d.ts","sourceRoot":"","sources":["../src/refusal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,aAAa,EACd,MAAM,wBAAwB,CAAC;AAEhC,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAOjE;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAC7B,OAAO,EAAE,eAAe,GACvB,aAAa,CAEf;AAqBD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,cAAc,GAAG,IAAI,CAMvB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAAG,IAAI,CAGpD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAQrF"}

package/dist/refusal.js

@@ -18,8 +18,9 @@ function doorFailure(status, body) {
     const refusal = doorRefusal(body);
     if (status === 401)
         return { kind: 'revoked-authorization' };
-    if (refusal?.retryable === true)
+    if (refusal?.retryable === true || refusal?.code === 'update_required') {
         return { kind: 'transport-uncertainty' };
+    }
     if (status === 404 || refusal?.code === 'room_not_found')
         return { kind: 'room-not-readable' };
     if (status < 400)

package/dist/site.d.ts

@@ -1,4 +1,4 @@
 import type { Adapter } from '@agentshouse/mdruntime';
 import { type HouseSiteTransport } from './transport.js';
-export declare function createSiteAdapter(transport: HouseSiteTransport): Adapter;
+export declare function createSiteAdapter(transport: HouseSiteTransport, snapshot?: boolean): Adapter;
 //# sourceMappingURL=site.d.ts.map

package/dist/site.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAMR,MAAM,wBAAwB,CAAC;AAsBhC,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAgCxB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAwIxE"}
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAOR,MAAM,wBAAwB,CAAC;AA2BhC,OAAO,EAOL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAmCxB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,EAAE,QAAQ,UAAQ,GAAG,OAAO,CA+Q1F"}