@agentshouse/mdruntime-adapter 0.1.0-cc63dd043d0e2 → 0.1.0-cc710a8825617

package/dist/read.js

@@ -1,9 +1,20 @@
-import { readPosition, roomVersion } from './version.js';
+import { DECIMAL, readPosition, roomVersion } from './version.js';
+const REVISION_FILE = /^fr_([0-9a-z]+)\.[0-9a-z]+\.[0-9a-z]$/u;
+export function identities(revisions) {
+    const fileIds = Object.fromEntries(Object.entries(revisions).flatMap(([path, revision]) => {
+        const file = REVISION_FILE.exec(revision)?.[1];
+        return file === undefined ? [] : [[path, file]];
+    }));
+    return Object.keys(fileIds).length === 0 ? {} : { fileIds };
+}
 export function authorityRoot(handle) {
     return `/rooms/${handle}`;
 }
 export function contentPrefixes(tracked) {
-    return [authorityRoot(tracked.handle)];
+    return [
+        authorityRoot(tracked.handle),
+        ...tracked.schemas.map((schema) => schemaPath(tracked.handle, schema)),
+    ];
 }
 export function schemaPath(handle, schema) {
     return `${authorityRoot(handle)}/${schema}`;
@@ -48,32 +59,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 };
-}
-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)
@@ -82,16 +80,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)
@@ -127,12 +139,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 { position, log_epoch: logEpoch };
+}
+function parseCursor(value) {
+    if (typeof value !== 'object' || value === null)
+        return null;
+    const { room, path, cut } = value;
+    if (typeof room !== 'string' || (path !== null && typeof path !== 'string'))
         return null;
-    return { anchor: manifest.anchor, ...at, files, contents, attachments };
+    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)
@@ -146,11 +174,26 @@ export function parseEnvelope(body) {
             return null;
         scopes.push(scope);
     }
-    return { scopes };
+    if (!('next' in body) || body.next === undefined)
+        return { scopes };
+    const next = parseCursor(body.next);
+    return next === null ? null : { scopes, next };
 }
 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;
@@ -160,8 +203,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;
@@ -182,12 +232,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) {
@@ -212,17 +256,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]));
@@ -231,18 +318,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,
@@ -260,16 +344,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 {
@@ -277,23 +361,19 @@ export function bootstrapOf(scope) {
         roomVersion: roomVersion(scope),
         documents,
         revisions,
+        ...identities(revisions),
         changes,
-        binaryTargets: binaryTargets.sort(),
-        ...declared(scope.attachments),
+        binaryFiles,
     };
 }
-export function schemaFrom(envelope, tracked, schema) {
-    const scope = envelope.scopes.find((entry) => matchesScope(entry, tracked));
-    if (scope === undefined)
-        return null;
-    return schemaOf(scope, schema);
-}
 export function schemaOf(scope, schema) {
     const file = scope.files.find((entry) => entry.path === schema);
     if (file === undefined)
-        return { schema: null, version: null };
+        return { schema: null, version: null, revision: null };
     const content = scope.contents.find((entry) => entry.path === schema);
-    return content === undefined ? null : { schema: content.content, version: file.version };
+    return content === undefined
+        ? null
+        : { schema: content.content, version: file.version, revision: file.revision ?? null };
 }
 export function viewOf(enumeration, tracked) {
     return enumeration.authorities.find((entry) => entry.authority === tracked.authority);
@@ -304,32 +384,30 @@ 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',
         roomVersion: roomVersion(view),
         documents,
         revisions,
+        ...identities(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

@@ -1,13 +1,9 @@
 import type { AdapterFailure, DiscoverResult, ProviderRefusal, ScopedRefusal } from '@agentshouse/mdruntime';
-export type DoorRefusal = ProviderRefusal & {
-    retryable: boolean;
-};
-export declare function doorRefusal(body: unknown): DoorRefusal | null;
-export declare function scopedRefusal(locator: string, scope: ScopedRefusal['scope'], refusal: DoorRefusal): ScopedRefusal;
-export declare function classifyDoor(status: number, body: unknown, locator: string): AdapterFailure | {
+export declare function doorRefusal(body: unknown): ProviderRefusal | null;
+export declare function scopedRefusal(locator: string, scope: ScopedRefusal['scope'], refusal: ProviderRefusal): ScopedRefusal;
+export declare function classifyDoor(status: number, body: unknown, locator: string): AdapterFailure | null;
+export declare function classifyRead(status: number, body: unknown, locator: string): AdapterFailure | {
     kind: 'beyond-horizon';
 } | null;
-export declare function discoveryFailure(classified: AdapterFailure | {
-    kind: 'beyond-horizon';
-}): DiscoverResult;
+export declare function discoveryFailure(status: number, body: unknown): DiscoverResult | null;
 //# sourceMappingURL=refusal.d.ts.map

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,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC;AAEnE,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAO7D;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAC7B,OAAO,EAAE,WAAW,GACnB,aAAa,CAEf;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,CAapD;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GACtD,cAAc,CAMhB"}
+{"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

@@ -6,38 +6,52 @@ export function doorRefusal(body) {
     const error = body.error;
     if (typeof error.code !== 'string')
         return null;
-    const { code, ...fields } = error;
-    return { code, fields, retryable: error.retryable === true };
+    const { code, retryable, ...fields } = error;
+    return { code, fields, retryable: retryable === true };
 }
 export function scopedRefusal(locator, scope, refusal) {
-    return { kind: 'scoped-refusal', locator, scope, code: refusal.code, fields: refusal.fields };
+    return { kind: 'scoped-refusal', locator, scope, ...refusal };
 }
-export function classifyDoor(status, body, locator) {
+function doorFailure(status, body) {
     if (status === 0)
         return { kind: 'transport-uncertainty' };
     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 (refusal !== null && refusal.code === 'position_expired')
-        return { kind: 'beyond-horizon' };
-    if (status === 404 || refusal?.code === 'room_not_found') {
-        return { kind: 'room-not-readable', locator };
     }
+    if (status === 404 || refusal?.code === 'room_not_found')
+        return { kind: 'room-not-readable' };
     if (status < 400)
         return null;
     if (refusal === null)
         return { kind: 'transport-uncertainty' };
-    if (status === 403)
-        return scopedRefusal(locator, 'operation', refusal);
-    return scopedRefusal(locator, 'undisclosed', refusal);
+    return { kind: 'refused', scope: status === 403 ? 'operation' : 'undisclosed', refusal };
+}
+export function classifyDoor(status, body, locator) {
+    const failure = doorFailure(status, body);
+    if (failure === null)
+        return null;
+    if (failure.kind === 'room-not-readable')
+        return { kind: 'room-not-readable', locator };
+    if (failure.kind === 'refused')
+        return scopedRefusal(locator, failure.scope, failure.refusal);
+    return failure;
 }
-export function discoveryFailure(classified) {
-    if (classified.kind === 'revoked-authorization')
-        return classified;
-    if (classified.kind === 'scoped-refusal') {
-        return { kind: 'contract-unavailable', code: classified.code, fields: classified.fields };
+export function classifyRead(status, body, locator) {
+    if (doorRefusal(body)?.code === 'expired')
+        return { kind: 'beyond-horizon' };
+    return classifyDoor(status, body, locator);
+}
+export function discoveryFailure(status, body) {
+    const failure = doorFailure(status, body);
+    if (failure === null)
+        return null;
+    if (failure.kind === 'revoked-authorization')
+        return failure;
+    if (failure.kind === 'refused') {
+        return { kind: 'contract-unavailable', ...failure.refusal };
     }
     return { kind: 'transport-uncertainty' };
 }

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,EAQR,MAAM,wBAAwB,CAAC;AA+BhC,OAAO,EAML,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAsCxB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAuKxE"}
+{"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"}