@agentshouse/mdruntime 0.1.0-alpha.8 → 0.1.0-c436a939f2119

package/dist/memory.js

@@ -1,16 +1,15 @@
-import { ROOM_CONTRACT_VERSION } from './adapter.js';
+import { ROOM_CONTRACT_VERSION, } from './adapter.js';
 import { MD_MODEL } from './collection.js';
+import { sameChange } from './overlay.js';
 const FIXTURE_RETENTION = {
-    history: {
-        kind: 'duration',
-        seconds: 1
-    },
+    history: { kind: 'duration', seconds: 1 },
     outcome: 1,
-    refreshHorizon: 1
+    refreshHorizon: 1,
 };
 function declaredRetention(value) {
     const retention = value ?? FIXTURE_RETENTION;
-    if (retention.history.kind === 'no-declared-time-bound') return retention;
+    if (retention.history.kind === 'no-declared-time-bound')
+        return retention;
     if (Number.isFinite(retention.history.seconds) && retention.history.seconds > 0) {
         return retention;
     }
@@ -18,36 +17,68 @@ function declaredRetention(value) {
 }
 function named(source, paths) {
     const taken = {};
-    for (const path of paths){
+    for (const path of paths) {
         const value = source[path];
-        if (value !== undefined) taken[path] = value;
+        if (value !== undefined)
+            taken[path] = value;
     }
     return taken;
 }
 async function resolveScript(answer, fallback, request) {
-    if (answer === undefined) return fallback();
+    if (answer === undefined)
+        return fallback();
     return typeof answer === 'function' ? answer(request) : answer;
 }
 export function createMemoryAdapter(options = {}) {
-    let rooms = options.rooms === undefined ? [] : [
-        ...options.rooms
-    ];
+    let rooms = options.rooms === undefined ? [] : [...options.rooms];
     const mdModel = options.mdModel ?? MD_MODEL;
-    const supportedVersions = options.supportedVersions ?? [
-        ROOM_CONTRACT_VERSION
-    ];
+    const supportedVersions = options.supportedVersions ?? [ROOM_CONTRACT_VERSION];
     const capabilities = options.capabilities ?? [];
     const providerLimits = options.providerLimits ?? [];
     const retention = declaredRetention(options.retention);
-    const origins = options.origins ?? [
-        'https://origin.example'
-    ];
     const pageSize = options.pageSize;
     const scripts = {};
     const served = new Map();
     const refreshPages = new Map();
+    const observers = new Set();
+    const listeners = new Set();
+    const modeObservers = new Set();
+    const scripted = new Map();
+    const unsealed = new Map();
+    const sealed = new Set();
+    const historyPageSize = options.historyPageSize;
+    let selected = [];
+    let replicated = [];
+    let issued = 0;
+    function scriptConversations(entries) {
+        scripted.clear();
+        for (const entry of entries)
+            scripted.set(entry.conversation, entry);
+    }
+    scriptConversations(options.conversations ?? []);
+    const ordinals = new Map();
+    function note(locator, answer) {
+        const roomVersion = answer.roomVersion;
+        const key = `${locator}\u0000${String(roomVersion)}`;
+        if (typeof roomVersion === 'string' && !ordinals.has(key))
+            ordinals.set(key, ordinals.size);
+        return answer;
+    }
+    function reached(locator, roomVersion, target) {
+        const scripted = scripts.reached;
+        if (typeof scripted === 'boolean')
+            return scripted;
+        if (scripted !== undefined)
+            return scripted(locator, roomVersion, target);
+        if (roomVersion === target)
+            return true;
+        const held = ordinals.get(`${locator}\u0000${roomVersion}`);
+        const wanted = ordinals.get(`${locator}\u0000${target}`);
+        return held !== undefined && wanted !== undefined && held >= wanted;
+    }
     function retain(entries) {
-        for (const room of entries){
+        for (const room of entries) {
+            note(room.locator, room);
             const versions = served.get(room.locator) ?? new Map();
             versions.set(room.roomVersion, room);
             served.set(room.locator, versions);
@@ -58,12 +89,13 @@ export function createMemoryAdapter(options = {}) {
         return {
             name: room.name,
             locator: room.locator,
-            collectionRoot: room.collectionRoot,
             roomVersion: room.roomVersion,
             operations: room.operations,
             replica: room.replica,
             attachedModel: room.attachedModel,
-            providerOwnedPaths: room.providerOwnedPaths
+            ...(room.typedSelection === undefined ? {} : { typedSelection: room.typedSelection }),
+            ...(room.untypedFolders === undefined ? {} : { untypedFolders: room.untypedFolders }),
+            providerOwnedPaths: room.providerOwnedPaths,
         };
     }
     function page(room, from) {
@@ -71,15 +103,16 @@ export function createMemoryAdapter(options = {}) {
         const size = pageSize ?? paths.length;
         const taken = paths.slice(from, from + size);
         const next = from + taken.length;
+        const targets = from === 0 ? (room.binaryTargets ?? []) : [];
         return {
             kind: 'bootstrap',
             roomVersion: room.roomVersion,
             documents: named(room.documents ?? {}, taken),
             revisions: named(room.revisions ?? {}, taken),
-            binaryTargets: from === 0 ? room.binaryTargets ?? [] : [],
-            ...next < paths.length ? {
-                pageToken: String(next)
-            } : {}
+            changes: named(room.changes ?? {}, [...taken, ...targets]),
+            binaryTargets: targets,
+            ...(from === 0 && room.attachments !== undefined ? { attachments: room.attachments } : {}),
+            ...(next < paths.length ? { pageToken: String(next) } : {}),
         };
     }
     function advancement(room, from, at) {
@@ -87,36 +120,108 @@ export function createMemoryAdapter(options = {}) {
         const previous = from.documents ?? {};
         const currentTargets = new Set(room.binaryTargets ?? []);
         const previousTargets = new Set(from.binaryTargets ?? []);
-        const changed = Object.keys(current).filter((path)=>current[path] !== previous[path]).sort();
+        const headMoved = (path) => room.revisions?.[path] !== from.revisions?.[path] ||
+            !sameChange(room.changes?.[path], from.changes?.[path]);
+        const changed = Object.keys(current)
+            .filter((path) => current[path] !== previous[path] || headMoved(path))
+            .sort();
         const size = pageSize ?? changed.length;
         const taken = changed.slice(at, at + size);
         const next = at + taken.length;
         const opening = at === 0;
         const pageToken = next < changed.length ? `refresh-${refreshPages.size}` : undefined;
-        if (pageToken !== undefined) refreshPages.set(pageToken, {
-            room,
-            from,
-            at: next
-        });
+        if (pageToken !== undefined)
+            refreshPages.set(pageToken, { room, from, at: next });
+        const targets = opening
+            ? [...currentTargets].filter((target) => !previousTargets.has(target) || headMoved(target))
+            : [];
+        const attachments = room.attachments ?? [];
+        const declared = opening && JSON.stringify(attachments) !== JSON.stringify(from.attachments ?? []);
         return {
             kind: 'net-advancement',
             roomVersion: room.roomVersion,
             documents: named(current, taken),
             revisions: named(room.revisions ?? {}, taken),
-            binaryTargets: opening ? [
-                ...currentTargets
-            ].filter((target)=>!previousTargets.has(target)) : [],
-            removals: opening ? [
-                ...Object.keys(previous).filter((path)=>!(path in current) && !currentTargets.has(path)),
-                ...[
-                    ...previousTargets
-                ].filter((target)=>!currentTargets.has(target) && !(target in current))
-            ].sort() : [],
-            ...pageToken === undefined ? {} : {
-                pageToken
-            }
+            changes: named(room.changes ?? {}, [...taken, ...targets]),
+            binaryTargets: targets,
+            removals: opening
+                ? [
+                    ...Object.keys(previous).filter((path) => !(path in current) && !currentTargets.has(path)),
+                    ...[...previousTargets].filter((target) => !currentTargets.has(target) && !(target in current)),
+                ].sort()
+                : [],
+            ...(declared ? { attachments } : {}),
+            ...(pageToken === undefined ? {} : { pageToken }),
         };
     }
+    function pageOf(conversation, after) {
+        const messages = conversation.messages ?? [];
+        const first = typeof after === 'string' ? messages.findIndex((message) => message.position > after) : 0;
+        const from = first === -1 ? messages.length : first;
+        const page = messages.slice(from, from + (historyPageSize ?? messages.length));
+        const last = page.at(-1);
+        return {
+            conversation: conversation.conversation,
+            messages: page,
+            ...(last !== undefined && from + page.length < messages.length
+                ? { next: last.position }
+                : {}),
+        };
+    }
+    function historiesOf(input) {
+        const asked = input?.conversations;
+        if (!Array.isArray(asked))
+            return { kind: 'rejected', code: 'invalid_request', fields: {} };
+        const histories = [];
+        for (const entry of asked) {
+            const conversation = typeof entry.conversation === 'string' ? scripted.get(entry.conversation) : undefined;
+            if (conversation === undefined)
+                continue;
+            const outcome = conversation.outcomes?.['conversation.history'];
+            if (outcome !== undefined)
+                return outcome;
+            histories.push(pageOf(conversation, entry.after));
+        }
+        const result = { histories };
+        return { kind: 'action', result };
+    }
+    function conversationAction(request) {
+        const name = request.name;
+        const input = (request.input ?? {});
+        if (name === 'conversation.history')
+            return historiesOf(request.input);
+        if (name === 'conversation.create') {
+            issued += 1;
+            const conversation = `conversation-${issued}`;
+            scripted.set(conversation, { conversation });
+            return { kind: 'action', result: { conversation } };
+        }
+        const named = typeof input.conversation === 'string' ? input.conversation : '';
+        const conversation = scripted.get(named);
+        if (conversation === undefined) {
+            return { kind: 'rejected', code: 'unknown-conversation', fields: { conversation: named } };
+        }
+        const outcome = conversation.outcomes?.[name];
+        if (outcome !== undefined)
+            return outcome;
+        if (name === 'conversation.send') {
+            issued += 1;
+            const turn = `turn-${issued}`;
+            unsealed.set(turn, named);
+            return { kind: 'action', result: { turn } };
+        }
+        if (name === 'conversation.cancel') {
+            const turn = typeof input.turn === 'string' ? input.turn : '';
+            if (sealed.has(turn) || !unsealed.has(turn)) {
+                return { kind: 'rejected', code: 'turn-sealed', fields: { turn } };
+            }
+            unsealed.delete(turn);
+            return { kind: 'action', result: { turn, cancelled: true } };
+        }
+        if (name === 'conversation.delete')
+            scripted.delete(named);
+        return { kind: 'action', result: { conversation: named } };
+    }
     function discovery() {
         return {
             kind: 'discovery',
@@ -126,110 +231,161 @@ export function createMemoryAdapter(options = {}) {
             capabilities,
             providerLimits,
             retention,
-            origins
         };
     }
     return {
-        setRooms (next) {
-            rooms = [
-                ...next
-            ];
+        setRooms(next) {
+            rooms = [...next];
             retain(rooms);
         },
-        script (operation, answer) {
-            if (answer === undefined) delete scripts[operation];
-            else scripts[operation] = answer;
+        setConversations(next) {
+            scriptConversations(next);
+        },
+        notifyRoomVersion(notification) {
+            for (const observer of observers)
+                observer(notification);
         },
-        async model (_authorization, request) {
-            return resolveScript(scripts.model, ()=>rooms.find((room)=>room.locator === request.locator)?.model ?? {
-                    kind: 'model-unavailable',
-                    reason: 'not-readable'
-                }, request);
+        notifyConversation(event) {
+            if (event.kind === 'accepted-message') {
+                sealed.add(event.message.turn);
+                unsealed.delete(event.message.turn);
+            }
+            for (const listener of listeners)
+                listener(event);
         },
-        async authorize () {
-            return resolveScript(scripts.authorize, ()=>({}), undefined);
+        notifyServiceMode(mode) {
+            for (const observer of modeObservers)
+                observer(mode);
         },
-        async discover (_authorization) {
-            return resolveScript(scripts.discover, discovery, undefined);
+        selectedRooms() {
+            return selected;
         },
-        async bootstrap (_authorization, request) {
-            return resolveScript(scripts.bootstrap, ()=>{
-                const room = rooms.find((entry)=>entry.locator === request.locator);
+        replicatedConversations() {
+            return replicated;
+        },
+        conversations: {
+            replicate(next) {
+                replicated = [...next];
+            },
+            observe(notify) {
+                listeners.add(notify);
+                return () => {
+                    listeners.delete(notify);
+                };
+            },
+        },
+        serviceMode: {
+            observe(notify) {
+                modeObservers.add(notify);
+                return () => {
+                    modeObservers.delete(notify);
+                };
+            },
+        },
+        roomVersions: {
+            select(locators) {
+                selected = [...locators];
+            },
+            observe(notify) {
+                observers.add(notify);
+                return () => {
+                    observers.delete(notify);
+                };
+            },
+        },
+        script(operation, answer) {
+            if (answer === undefined)
+                delete scripts[operation];
+            else
+                scripts[operation] = answer;
+        },
+        async model(_authorization, request) {
+            return resolveScript(scripts.model, () => {
+                const room = rooms.find((entry) => entry.locator === request.locator);
+                const answer = request.attached === 'collection' ? room?.model : room?.selectionModel;
+                return answer ?? { kind: 'model-unavailable', reason: 'not-readable' };
+            }, request);
+        },
+        async authorize() {
+            return resolveScript(scripts.authorize, () => ({}), undefined);
+        },
+        async discover(_authorization) {
+            return resolveScript(scripts.discover, discovery, undefined).then((answer) => {
+                if (answer.kind === 'discovery')
+                    for (const room of answer.rooms)
+                        note(room.locator, room);
+                return answer;
+            });
+        },
+        reached,
+        async bootstrap(_authorization, request) {
+            return resolveScript(scripts.bootstrap, () => {
+                const room = rooms.find((entry) => entry.locator === request.locator);
                 if (room === undefined) {
-                    return {
-                        kind: 'room-not-readable',
-                        locator: request.locator
-                    };
+                    return { kind: 'room-not-readable', locator: request.locator };
                 }
                 return page(room, request.pageToken === undefined ? 0 : Number(request.pageToken));
-            }, request);
+            }, request).then((answer) => note(request.locator, answer));
         },
-        async refresh (_authorization, request) {
-            return resolveScript(scripts.refresh, ()=>{
-                const room = rooms.find((entry)=>entry.locator === request.locator);
+        async refresh(_authorization, request) {
+            return resolveScript(scripts.refresh, () => {
+                const room = rooms.find((entry) => entry.locator === request.locator);
                 if (room === undefined) {
-                    return {
-                        kind: 'room-not-readable',
-                        locator: request.locator
-                    };
+                    return { kind: 'room-not-readable', locator: request.locator };
                 }
                 if (request.pageToken !== undefined) {
                     const continuation = refreshPages.get(request.pageToken);
-                    if (continuation === undefined || continuation.room.locator !== request.locator || continuation.from.roomVersion !== request.fromRoomVersion) {
+                    if (continuation === undefined ||
+                        continuation.room.locator !== request.locator ||
+                        continuation.from.roomVersion !== request.fromRoomVersion) {
                         throw new Error('Invalid Refresh Page Token');
                     }
                     return advancement(continuation.room, continuation.from, continuation.at);
                 }
+                if (request.minPosition !== undefined &&
+                    !reached(room.locator, room.roomVersion, request.minPosition)) {
+                    return { kind: 'retryable-refusal', code: 'replica_behind', fields: {} };
+                }
                 if (request.fromRoomVersion === room.roomVersion) {
-                    return {
-                        kind: 'still-current'
-                    };
+                    return { kind: 'still-current' };
                 }
                 const from = served.get(room.locator)?.get(request.fromRoomVersion);
-                if (from === undefined) return {
-                    kind: 'beyond-horizon'
-                };
+                if (from === undefined)
+                    return { kind: 'beyond-horizon' };
                 return advancement(room, from, 0);
-            }, request);
+            }, request).then((answer) => note(request.locator, answer));
         },
-        async mutate (_authorization, request) {
-            return resolveScript(scripts.mutate, ()=>{
-                const room = rooms.find((entry)=>entry.locator === request.locator);
+        async mutate(_authorization, request) {
+            return resolveScript(scripts.mutate, () => {
+                const room = rooms.find((entry) => entry.locator === request.locator);
                 if (room === undefined) {
-                    return {
-                        kind: 'room-not-readable',
-                        locator: request.locator
-                    };
+                    return { kind: 'room-not-readable', locator: request.locator };
                 }
-                return {
-                    kind: 'rejected',
-                    text: '',
-                    affected: {}
-                };
-            }, request);
+                return { kind: 'rejected', code: 'unscripted-mutation', fields: {}, affected: {} };
+            }, request).then((answer) => note(request.locator, answer));
         },
-        async history (_authorization, request) {
-            return resolveScript(scripts.history, ()=>{
-                const room = rooms.find((entry)=>entry.locator === request.locator);
+        async history(_authorization, request) {
+            return resolveScript(scripts.history, () => {
+                const room = rooms.find((entry) => entry.locator === request.locator);
                 if (room === undefined) {
-                    return {
-                        kind: 'room-not-readable',
-                        locator: request.locator
-                    };
+                    return { kind: 'room-not-readable', locator: request.locator };
                 }
                 return {
                     kind: 'history',
-                    revisions: []
+                    revisions: [],
                 };
             }, request);
         },
-        async action (_authorization, request) {
-            return resolveScript(scripts.action, ()=>({
-                    kind: 'rejected',
-                    text: ''
-                }), request);
-        }
+        async action(_authorization, request) {
+            return resolveScript(scripts.action, () => {
+                if (request.name.startsWith('conversation.'))
+                    return conversationAction(request);
+                return { kind: 'rejected', code: 'unscripted-action', fields: {} };
+            }, request).then((answer) => {
+                if (answer.kind === 'action' && answer.at !== undefined)
+                    note(answer.at.locator, answer.at);
+                return answer;
+            });
+        },
     };
 }
-
-//# sourceMappingURL=memory.js.map

package/dist/model.d.ts

@@ -1,13 +1,12 @@
-import type { Validation } from '@agentshouse/mdmodel';
-import type { MdType } from './collection.js';
+import type { Definition, FieldSpec, SectionSpec, VerifiedModel } from '@agentshouse/mdmodel';
 export type ModelIdentity = {
     identity: string;
     version: string;
 };
 export type ModelSnapshot = ModelIdentity & {
-    definitions: Readonly<Record<string, string>>;
+    schema: string | null;
 };
-export type ModelUnavailableReason = 'not-readable' | 'revoked' | 'not-acquired' | 'version-changed' | 'invalid' | 'binding-unavailable';
+export type ModelUnavailableReason = 'not-readable' | 'revoked' | 'not-acquired' | 'version-changed' | 'invalid';
 export type ModelResult = {
     kind: 'model';
     snapshot: ModelSnapshot;
@@ -19,6 +18,11 @@ export type ModelResult = {
 } | {
     kind: 'revoked-authorization';
 };
+export type MdType = {
+    name: string;
+    fields: Readonly<Record<string, FieldSpec>>;
+    sections: Readonly<Record<string, SectionSpec>>;
+};
 export type ModelState = {
     status: 'unavailable';
     reason: ModelUnavailableReason;
@@ -26,7 +30,7 @@ export type ModelState = {
     status: 'current' | 'cached';
     snapshot: ModelSnapshot;
     verifiedWith: ModelIdentity;
-    types: readonly MdType[];
+    types: VerifiedModel['types'];
 };
 export type TypesResult = {
     status: 'unavailable';
@@ -38,32 +42,13 @@ export type TypesResult = {
     verifiedWith: ModelIdentity;
     types: readonly MdType[];
 };
-export type ModelValidation = {
-    verdict: 'accept';
-} | (Extract<Validation, {
-    verdict: 'refuse';
-}> & {
-    source: 'content' | 'model';
-});
-export type AttachedModelBinding = {
-    verify(snapshot: ModelSnapshot): {
-        kind: 'verified';
-        types: readonly MdType[];
-    } | {
-        kind: 'invalid';
-    };
-    validate(input: {
-        model: ModelSnapshot;
-        documents: Readonly<Record<string, string>>;
-        binaryTargets: readonly string[];
-    }): ModelValidation;
-};
 export type ValidationReceipt = {
     identity: string;
     version: string;
     source: 'current' | 'cached';
 };
 export declare const NO_MODEL: ModelState;
+export declare function definitionOf(state: ModelState, type: string | undefined): Definition | undefined;
 export declare function modelTypes(state: ModelState): TypesResult;
 export declare function cached(state: ModelState): ModelState;
 export declare function sameModel(left: ModelIdentity, right: ModelIdentity): boolean;

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,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG;IAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC;AAC9F,MAAM,MAAM,sBAAsB,GAC9B,cAAc,GACd,SAAS,GACT,cAAc,GACd,iBAAiB,GACjB,SAAS,GACT,qBAAqB,CAAC;AAC1B,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,uBAAuB,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,uBAAuB,CAAA;CAAE,CAAC;AACtC,MAAM,MAAM,UAAU,GAClB;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,GACzD;IACE,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,aAAa,CAAC;IAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B,CAAC;AACN,MAAM,MAAM,WAAW,GACnB;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,GACzD;IACE,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,aAAa,CAAC;IAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B,CAAC;AACN,MAAM,MAAM,eAAe,GACvB;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,GACrB,CAAC,OAAO,CAAC,UAAU,EAAE;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC,GAAG;IAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAA;CAAE,CAAC,CAAC;AACnF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CACJ,QAAQ,EAAE,aAAa,GACtB;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC;IACxE,QAAQ,CAAC,KAAK,EAAE;QACd,KAAK,EAAE,aAAa,CAAC;QACrB,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5C,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;KAClC,GAAG,eAAe,CAAC;CACrB,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAA;CAAE,CAAC;AACpG,eAAO,MAAM,QAAQ,EAAE,UAA8D,CAAC;AACtF,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAUzD;AACD,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAEpD;AACD,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAE5E"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE9F,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AACtE,MAAM,MAAM,sBAAsB,GAC9B,cAAc,GACd,SAAS,GACT,cAAc,GACd,iBAAiB,GACjB,SAAS,CAAC;AACd,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,uBAAuB,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,uBAAuB,CAAA;CAAE,CAAC;AACtC,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC5C,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;CACjD,CAAC;AACF,MAAM,MAAM,UAAU,GAClB;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,GACzD;IACE,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,aAAa,CAAC;IAC5B,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CAC/B,CAAC;AACN,MAAM,MAAM,WAAW,GACnB;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,GACzD;IACE,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,aAAa,CAAC;IAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B,CAAC;AACN,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAA;CAAE,CAAC;AACpG,eAAO,MAAM,QAAQ,EAAE,UAA8D,CAAC;AACtF,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAGhG;AACD,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAczD;AACD,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAEpD;AACD,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAE5E"}

package/dist/model.js

@@ -1,28 +1,25 @@
-export const NO_MODEL = {
-    status: 'unavailable',
-    reason: 'not-acquired'
-};
+export const NO_MODEL = { status: 'unavailable', reason: 'not-acquired' };
+export function definitionOf(state, type) {
+    if (state.status === 'unavailable' || type === undefined)
+        return undefined;
+    return Object.hasOwn(state.types, type) ? state.types[type] : undefined;
+}
 export function modelTypes(state) {
-    return state.status === 'unavailable' ? {
-        ...state
-    } : {
-        status: state.status,
-        identity: state.snapshot.identity,
-        version: state.snapshot.version,
-        verifiedWith: {
-            ...state.verifiedWith
-        },
-        types: structuredClone(state.types)
-    };
+    return state.status === 'unavailable'
+        ? { ...state }
+        : {
+            status: state.status,
+            identity: state.snapshot.identity,
+            version: state.snapshot.version,
+            verifiedWith: { ...state.verifiedWith },
+            types: structuredClone(Object.values(state.types)
+                .sort((left, right) => (left.name < right.name ? -1 : left.name > right.name ? 1 : 0))
+                .map(({ name, fields, sections }) => ({ name, fields, sections }))),
+        };
 }
 export function cached(state) {
-    return state.status === 'unavailable' ? state : {
-        ...state,
-        status: 'cached'
-    };
+    return state.status === 'unavailable' ? state : { ...state, status: 'cached' };
 }
 export function sameModel(left, right) {
     return left.identity === right.identity && left.version === right.version;
 }
-
-//# sourceMappingURL=model.js.map

package/dist/observation.d.ts

@@ -0,0 +1,25 @@
+import type { QueryDocument, QueryGroup, QueryResult } from './query.js';
+export type Observation<T> = {
+    current(): T;
+    subscribe(listener: (value: T) => void): () => void;
+    close(): void;
+};
+export type RowKey = string | number;
+export type KeyedResult = {
+    result: QueryResult;
+    keys: readonly RowKey[];
+};
+export type QueryChange = {
+    changed: readonly (readonly [RowKey, QueryDocument | QueryGroup])[];
+    removed: readonly RowKey[];
+    order: readonly RowKey[] | null;
+};
+export type Observed = {
+    observation: Observation<unknown>;
+    receive(message: unknown): void;
+    end(): void;
+};
+export declare function rowsOf(result: QueryResult): readonly (QueryDocument | QueryGroup)[];
+export declare function observed(first: unknown, stop: () => void, keyed: boolean): Observed;
+export declare function opened(watch: (deliver: (message: unknown) => void) => () => void, keyed: boolean): Promise<Observation<unknown>>;
+//# sourceMappingURL=observation.d.ts.map

package/dist/observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../src/observation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,OAAO,IAAI,CAAC,CAAC;IACb,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACpD,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAErC,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAE3E,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC;IACpE,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,GAAG,IAAI,IAAI,CAAC;CACb,CAAC;AAEF,wBAAgB,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC,aAAa,GAAG,UAAU,CAAC,EAAE,CAEnF;AA0BD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,QAAQ,CAkCnF;AAED,wBAAgB,MAAM,CACpB,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,EAC1D,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAiB/B"}