@agentshouse/mdruntime 0.1.0-cd50a4607cb7d → 0.1.0-cd71aba4d0215

package/dist/failure.js

@@ -8,11 +8,17 @@ function coded(error) {
         'retryable' in error &&
         typeof error.retryable === 'boolean');
 }
+export function refusalError(refusal) {
+    return runtimeError(refusal.code, refusal.code, refusal.retryable);
+}
 export function failed(error) {
     if (coded(error))
         return error;
     return runtimeError('runtime-failure', error instanceof Error ? error.message : String(error));
 }
+export function uncaught(error) {
+    reportError(error);
+}
 export function described(error) {
     const { message, code, retryable } = failed(error);
     return { message, code, retryable };

package/dist/figures.d.ts

@@ -0,0 +1,49 @@
+import type { ChangeSet } from './change-set.js';
+import type { GroupTotal, PendingResult } from './query.js';
+import type { Deliver, Fail } from './reach.js';
+import type { ConversationTally, RoomTally } from './tallies.js';
+import type { QueryRoom } from './tables.js';
+export declare const HOUSE_DIRECTORY = "house";
+export declare const ROOM_TOTALS: {
+    readonly outside: readonly ["house"];
+    readonly groupBy: readonly ["room"];
+    readonly select: {
+        readonly size: true;
+    };
+};
+export declare const FIGURES_DAY_MS = 86400000;
+export type DayFigures = {
+    readonly created: number;
+    readonly changed: number;
+    readonly chats: number;
+    readonly messages: number;
+};
+export type RoomFigures = {
+    readonly room: string;
+    readonly day: DayFigures;
+    readonly total: {
+        readonly documents: GroupTotal;
+        readonly files: GroupTotal;
+    };
+};
+export type Figures = {
+    readonly rooms: readonly RoomFigures[];
+    readonly agentMessages: number;
+};
+export type FiguresResult = Figures | PendingResult;
+export type FiguresCover = PendingResult | {
+    readonly rooms: readonly QueryRoom[];
+};
+export type FiguresSources = {
+    cover(): Promise<FiguresCover>;
+    rooms(rooms: readonly QueryRoom[], since: string): Promise<readonly RoomTally[]>;
+    conversations(conversations: readonly string[] | null, since: string): Promise<readonly ConversationTally[]>;
+};
+export type FiguresRead = {
+    watch(deliver: Deliver, fail: Fail): () => void;
+    touched(set: ChangeSet): void;
+    recover(): void;
+    close(): void;
+};
+export declare function createFigures(sources: FiguresSources): FiguresRead;
+//# sourceMappingURL=figures.d.ts.map

package/dist/figures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figures.d.ts","sourceRoot":"","sources":["../src/figures.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC,eAAO,MAAM,WAAW;;;;iBAGZ,IAAI;;CACe,CAAC;AAGhC,eAAO,MAAM,cAAc,WAAa,CAAC;AAQzC,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC;CAChF,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,aAAa,CAAC;AAEpD,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,CAAC;AAEpF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,KAAK,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;IACjF,aAAa,CACX,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,EACvC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,IAAI,CAAC;IAChD,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IAC9B,OAAO,IAAI,IAAI,CAAC;IAChB,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAgDF,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,WAAW,CAsIlE"}

package/dist/figures.js

@@ -0,0 +1,197 @@
+import { instantKey } from '@agentshouse/mdmodel';
+export const HOUSE_DIRECTORY = 'house';
+export const ROOM_TOTALS = {
+    outside: [HOUSE_DIRECTORY],
+    groupBy: ['room'],
+    select: { size: true },
+};
+// Today's Last 24 hours is the day that ends as the read answers.
+export const FIGURES_DAY_MS = 86_400_000;
+// An install or a catch-up commits many times a second, so the figures answer again once changes rest this long, never per commit.
+const SETTLED_MS = 1_000;
+// Changes that never rest, such as an Agent writing all afternoon, still reach the figures this long after the first of them.
+const LONGEST_UNSETTLED_MS = 5_000;
+function dayOf(tally, since) {
+    const after = (at) => at !== null && at >= since;
+    return {
+        created: tally.documentTimes.filter(([created]) => after(created)).length,
+        changed: tally.documentTimes.filter(([created, changed]) => !after(created) && after(changed))
+            .length,
+        chats: tally.chatTimes.filter(after).length,
+        messages: tally.messageTimes.filter(after).length,
+    };
+}
+function figuresOf(rooms, held, since) {
+    return {
+        rooms: rooms.map(({ locator }) => {
+            const tally = held.rooms.get(locator);
+            return {
+                room: locator,
+                day: dayOf(tally, since),
+                total: { documents: tally.documents, files: tally.files },
+            };
+        }),
+        agentMessages: [...held.said.values()].reduce((sum, said) => sum + said.filter((at) => at >= since).length, 0),
+    };
+}
+function unheld() {
+    return {
+        rooms: new Map(),
+        said: new Map(),
+        staleRooms: new Set(),
+        staleConversations: new Set(),
+        everyConversation: true,
+    };
+}
+export function createFigures(sources) {
+    const listeners = new Map();
+    const answered = new Set();
+    let held = unheld();
+    let shown = null;
+    let running = false;
+    let again = false;
+    let quiet = null;
+    let longest = null;
+    let closed = false;
+    function unscheduled() {
+        if (quiet !== null)
+            clearTimeout(quiet);
+        if (longest !== null)
+            clearTimeout(longest);
+        quiet = null;
+        longest = null;
+    }
+    function deliver(answer) {
+        const text = JSON.stringify(answer);
+        const changed = text !== shown;
+        shown = text;
+        for (const listener of listeners.keys()) {
+            if (changed || !answered.has(listener))
+                listener(structuredClone(answer));
+            answered.add(listener);
+        }
+    }
+    async function tallied(rooms, since) {
+        for (const locator of held.rooms.keys()) {
+            if (!rooms.some((room) => room.locator === locator))
+                held.rooms.delete(locator);
+        }
+        const asked = rooms.filter(({ locator, key }) => held.staleRooms.has(locator) || held.rooms.get(locator)?.key !== key);
+        for (const { locator } of asked)
+            held.staleRooms.delete(locator);
+        const every = held.everyConversation;
+        const conversations = every ? null : [...held.staleConversations];
+        held.everyConversation = false;
+        held.staleConversations.clear();
+        const kept = held;
+        const [roomTallies, said] = await Promise.all([
+            asked.length === 0 ? [] : sources.rooms(asked, since),
+            conversations?.length === 0 ? [] : sources.conversations(conversations, since),
+        ]);
+        if (kept !== held)
+            return false;
+        for (const tally of roomTallies) {
+            const room = asked.find(({ key }) => key === tally.key);
+            if (room !== undefined)
+                held.rooms.set(room.locator, tally);
+        }
+        if (every)
+            held.said.clear();
+        for (const { conversation, said: times } of said) {
+            if (times.length === 0)
+                held.said.delete(conversation);
+            else
+                held.said.set(conversation, times);
+        }
+        return true;
+    }
+    async function answer() {
+        const window = new Date(Date.now() - FIGURES_DAY_MS).toISOString();
+        const cover = await sources.cover();
+        if ('pending' in cover)
+            return cover;
+        if (!(await tallied(cover.rooms, window)))
+            return null;
+        return figuresOf(cover.rooms, held, instantKey(window));
+    }
+    async function run() {
+        if (running) {
+            again = true;
+            return;
+        }
+        running = true;
+        try {
+            do {
+                again = false;
+                const result = await answer();
+                if (closed || listeners.size === 0)
+                    return;
+                if (result === null)
+                    again = true;
+                else
+                    deliver(result);
+            } while (again && !closed && listeners.size > 0);
+        }
+        catch (error) {
+            for (const [listener, failed] of listeners) {
+                if (!answered.has(listener))
+                    failed(error);
+            }
+        }
+        finally {
+            running = false;
+        }
+    }
+    function stop(listener) {
+        return () => {
+            listeners.delete(listener);
+            answered.delete(listener);
+            if (listeners.size > 0)
+                return;
+            unscheduled();
+            held = unheld();
+            shown = null;
+        };
+    }
+    function settle() {
+        if (closed || listeners.size === 0)
+            return;
+        const now = () => {
+            unscheduled();
+            void run();
+        };
+        if (quiet !== null)
+            clearTimeout(quiet);
+        quiet = setTimeout(now, SETTLED_MS);
+        longest ??= setTimeout(now, LONGEST_UNSETTLED_MS);
+    }
+    return {
+        watch(listener, failed) {
+            listeners.set(listener, failed);
+            void run();
+            return stop(listener);
+        },
+        touched(set) {
+            if (listeners.size === 0)
+                return;
+            for (const { locator } of set.documents)
+                held.staleRooms.add(locator);
+            for (const locator of set.rooms)
+                held.staleRooms.add(locator);
+            for (const conversation of set.conversations)
+                held.staleConversations.add(conversation);
+            if (set.documents.length + set.rooms.length + set.conversations.length > 0)
+                settle();
+        },
+        recover() {
+            if (listeners.size > 0)
+                settle();
+        },
+        close() {
+            closed = true;
+            unscheduled();
+            listeners.clear();
+            answered.clear();
+        },
+    };
+}

package/dist/file.d.ts

@@ -1,20 +1,3 @@
-export type ChatDraftFile = {
-    name: string;
-    blob: Blob;
-};
-export type FileDeclaration = {
-    name: string;
-    mediaType: string;
-    byteLength: number;
-    contentHash: string;
-    width?: number;
-    height?: number;
-};
-export type Extent = {
-    width: number;
-    height: number;
-};
-export declare function extentOf(bytes: Uint8Array): Extent | null;
-export declare function hexDigest(digest: ArrayBuffer): string;
-export declare function declaredFile(file: ChatDraftFile): Promise<FileDeclaration>;
+import type { AttachRequest } from './adapter.js';
+export declare function attachedFile(locator: string, file: File): Promise<AttachRequest>;
 //# sourceMappingURL=file.d.ts.map

package/dist/file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AA2GvD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAQzD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAErD;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAUhF"}
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../src/file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAStF"}

package/dist/file.js

@@ -1,126 +1,11 @@
-const PNG_SIGNATURE = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
-const WEBP_SYNC = [0x9d, 0x01, 0x2a];
-const SHAPELESS_JPEG_MARKERS = new Set([0xc4, 0xc8, 0xcc]);
-const BMFF_CONTAINERS = new Set(['meta', 'iprp', 'ipco']);
-function starts(bytes, signature, at = 0) {
-    return signature.every((value, index) => bytes[at + index] === value);
-}
-function text(bytes, at, length) {
-    return String.fromCharCode(...bytes.subarray(at, at + length));
-}
-function bigEndian(bytes, at, length) {
-    let value = 0;
-    for (let index = 0; index < length; index += 1)
-        value = value * 256 + (bytes[at + index] ?? 0);
-    return value;
-}
-function littleEndian(bytes, at, length) {
-    let value = 0;
-    for (let index = length - 1; index >= 0; index -= 1)
-        value = value * 256 + (bytes[at + index] ?? 0);
-    return value;
-}
-function pngExtent(bytes) {
-    if (bytes.length < 24 || !starts(bytes, PNG_SIGNATURE))
-        return null;
-    if (text(bytes, 12, 4) !== 'IHDR')
-        return null;
-    return { width: bigEndian(bytes, 16, 4), height: bigEndian(bytes, 20, 4) };
-}
-function gifExtent(bytes) {
-    if (bytes.length < 10 || text(bytes, 0, 3) !== 'GIF')
-        return null;
-    return { width: littleEndian(bytes, 6, 2), height: littleEndian(bytes, 8, 2) };
-}
-function jpegExtent(bytes) {
-    if (bytes.length < 4 || bytes[0] !== 0xff || bytes[1] !== 0xd8)
-        return null;
-    let at = 2;
-    while (at + 9 < bytes.length) {
-        if (bytes[at] !== 0xff)
-            return null;
-        const marker = bytes[at + 1] ?? 0;
-        if (marker === 0xd8 || marker === 0x01 || (marker >= 0xd0 && marker <= 0xd7)) {
-            at += 2;
-            continue;
-        }
-        const length = bigEndian(bytes, at + 2, 2);
-        if (marker >= 0xc0 && marker <= 0xcf && !SHAPELESS_JPEG_MARKERS.has(marker)) {
-            return { width: bigEndian(bytes, at + 7, 2), height: bigEndian(bytes, at + 5, 2) };
-        }
-        if (length < 2)
-            return null;
-        at += 2 + length;
-    }
-    return null;
-}
-function webpExtent(bytes) {
-    if (bytes.length < 30 || text(bytes, 0, 4) !== 'RIFF' || text(bytes, 8, 4) !== 'WEBP')
-        return null;
-    const chunk = text(bytes, 12, 4);
-    if (chunk === 'VP8X') {
-        return {
-            width: littleEndian(bytes, 24, 3) + 1,
-            height: littleEndian(bytes, 27, 3) + 1,
-        };
-    }
-    if (chunk === 'VP8 ' && starts(bytes, WEBP_SYNC, 23)) {
-        return {
-            width: littleEndian(bytes, 26, 2) & 0x3fff,
-            height: littleEndian(bytes, 28, 2) & 0x3fff,
-        };
-    }
-    if (chunk === 'VP8L' && bytes[20] === 0x2f) {
-        const packed = littleEndian(bytes, 21, 4);
-        return { width: (packed & 0x3fff) + 1, height: ((packed >>> 14) & 0x3fff) + 1 };
-    }
-    return null;
-}
-function spatialExtent(bytes, from, to) {
-    let at = from;
-    while (at + 8 <= to) {
-        const size = bigEndian(bytes, at, 4);
-        const name = text(bytes, at + 4, 4);
-        const end = size === 0 ? to : at + size;
-        if (size === 1 || end <= at || end > to)
-            return null;
-        if (name === 'ispe') {
-            if (end < at + 20)
-                return null;
-            return { width: bigEndian(bytes, at + 12, 4), height: bigEndian(bytes, at + 16, 4) };
-        }
-        if (BMFF_CONTAINERS.has(name)) {
-            const inner = spatialExtent(bytes, at + (name === 'meta' ? 12 : 8), end);
-            if (inner !== null)
-                return inner;
-        }
-        at = end;
-    }
-    return null;
-}
-function bmffExtent(bytes) {
-    if (bytes.length < 16 || text(bytes, 4, 4) !== 'ftyp')
-        return null;
-    return spatialExtent(bytes, 0, bytes.length);
-}
-export function extentOf(bytes) {
-    return (pngExtent(bytes) ??
-        jpegExtent(bytes) ??
-        gifExtent(bytes) ??
-        webpExtent(bytes) ??
-        bmffExtent(bytes));
-}
-export function hexDigest(digest) {
-    return [...new Uint8Array(digest)].map((value) => value.toString(16).padStart(2, '0')).join('');
-}
-export async function declaredFile(file) {
-    const bytes = new Uint8Array(await file.blob.arrayBuffer());
-    const extent = file.blob.type.startsWith('image/') ? extentOf(bytes) : null;
+import { sha256 } from './digest.js';
+export async function attachedFile(locator, file) {
     return {
+        locator,
         name: file.name,
-        mediaType: file.blob.type,
-        byteLength: bytes.byteLength,
-        contentHash: hexDigest(await crypto.subtle.digest('SHA-256', bytes)),
-        ...(extent === null ? {} : extent),
+        mediaType: file.type,
+        byteLength: file.size,
+        sha256: await sha256(file),
+        blob: file,
     };
 }

package/dist/holdings.d.ts

@@ -0,0 +1,29 @@
+import type { AppCode } from './durability.js';
+import type { GroupTotal, PendingResult } from './query.js';
+import type { Deliver, Fail } from './reach.js';
+import type { Runtime } from './runtime.js';
+import type { OpenedRoom } from './tables.js';
+export type RoomDocuments = {
+    readonly room: string;
+    readonly documents: GroupTotal;
+};
+export type HeldApp = ({
+    readonly app: string;
+    readonly state: 'measured';
+} & AppCode) | {
+    readonly app: string;
+    readonly state: 'asking' | 'unknown';
+};
+export type Holdings = {
+    readonly rooms: readonly RoomDocuments[] | PendingResult;
+    readonly opened: GroupTotal & {
+        readonly rooms: readonly OpenedRoom[];
+    };
+    readonly apps: readonly HeldApp[];
+    readonly house: number | null;
+    readonly total: number | null;
+    readonly cleanUp: number | null;
+};
+export declare const CLEANED_TOPIC = "cleaned";
+export declare function watchHoldings({ store, figures, shell }: Runtime, deliver: Deliver, fail: Fail): () => void;
+//# sourceMappingURL=holdings.d.ts.map

package/dist/holdings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"holdings.d.ts","sourceRoot":"","sources":["../src/holdings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,iBAAiB,CAAC;AAEzD,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAA;CAAE,CAAC;AAEtF,MAAM,MAAM,OAAO,GACf,CAAC;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,OAAO,CAAC,GAChE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,aAAa,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAA;KAAE,CAAC;IACxE,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAIF,eAAO,MAAM,aAAa,YAAY,CAAC;AA6CvC,wBAAgB,aAAa,CAC3B,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAClC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,IAAI,GACT,MAAM,IAAI,CA4DZ"}

package/dist/holdings.js

@@ -0,0 +1,95 @@
+const NO_CODE = { house: 0, apps: [] };
+export const CLEANED_TOPIC = 'cleaned';
+function heldRooms(figures) {
+    if ('pending' in figures)
+        return figures;
+    return figures.rooms.map(({ room, total }) => ({ room, documents: total.documents }));
+}
+function heldApp(app, measured) {
+    if (!measured.has(app))
+        return { app, state: 'asking' };
+    const code = measured.get(app) ?? null;
+    return code === null ? { app, state: 'unknown' } : { app, state: 'measured', ...code };
+}
+function summed(values) {
+    return values.reduce((sum, value) => sum + value, 0);
+}
+function holdingsOf(rooms, opened, code, measured) {
+    const apps = code.apps.map((app) => heldApp(app, measured));
+    const known = apps.flatMap((app) => (app.state === 'measured' ? [app] : []));
+    const whole = known.length === apps.length;
+    const files = {
+        count: summed(opened.rooms.map(({ count }) => count)),
+        size: summed(opened.rooms.map(({ size }) => size)),
+    };
+    const documents = 'pending' in rooms ? null : summed(rooms.map(({ documents: d }) => d.size));
+    const older = whole ? summed(known.map((app) => app.older)) : null;
+    return {
+        rooms,
+        opened: { ...files, rooms: opened.rooms },
+        apps,
+        house: code.house,
+        total: documents === null || code.house === null || older === null
+            ? null
+            : documents + files.size + summed(known.map((app) => app.running)) + older + code.house,
+        cleanUp: older === null ? null : opened.cleanable + older,
+    };
+}
+export function watchHoldings({ store, figures, shell }, deliver, fail) {
+    let open = true;
+    let asked = 0;
+    let rooms = null;
+    let opened = null;
+    let code = null;
+    let measured = new Map();
+    function told() {
+        if (open && rooms !== null && opened !== null && code !== null) {
+            deliver(holdingsOf(rooms, opened, code, measured));
+        }
+    }
+    function failed(error) {
+        if (!open)
+            return;
+        stop();
+        fail(error);
+    }
+    function ask() {
+        asked += 1;
+        const at = asked;
+        const current = () => open && at === asked;
+        opened = null;
+        code = null;
+        measured = new Map();
+        store.ask({ kind: 'opened.held' }).then((held) => {
+            if (!current())
+                return;
+            opened = held;
+            told();
+        }, failed);
+        const answers = measured;
+        const measuring = shell.measure?.((app, answer) => {
+            if (!current())
+                return;
+            answers.set(app, answer);
+            told();
+        }) ?? Promise.resolve(NO_CODE);
+        measuring.then((held) => {
+            if (!current())
+                return;
+            code = held;
+            told();
+        }, failed);
+    }
+    const stopFigures = figures.watch((answer) => {
+        rooms = heldRooms(answer);
+        told();
+    }, failed);
+    const cleaned = store.watch(CLEANED_TOPIC, ask);
+    function stop() {
+        open = false;
+        stopFigures();
+        cleaned.stop();
+    }
+    ask();
+    return stop;
+}

package/dist/host.d.ts

@@ -1,22 +1,44 @@
 import { type MdRuntimeOptions } from './connection.js';
 import type { PortReach } from './reach.js';
+import type { CodeAvailability, Persistence, Readiness } from './readiness.js';
+import type { EntrySeed } from './seed.js';
+import { type CallResult } from './outcome.js';
 import { type RuntimePort } from './wire.js';
 export type MdRuntimeHostOptions = MdRuntimeOptions & {
     deploymentFacts?: unknown;
 };
+export type Admitted = {
+    readonly admitted: unknown;
+} | {
+    readonly refused: CallResult;
+};
+export type ActionAdmission = (name: string, input: unknown) => Promise<Admitted>;
+export type AttachOptions = {
+    readonly app: string;
+    readonly release?: string;
+    readonly reach?: PortReach;
+    readonly admission?: ActionAdmission;
+    readonly code?: CodeAvailability;
+};
 export type AttachedPort = {
     detach(): void;
     narrow(reach: PortReach): void;
+    readiness(deliver: (readiness: Readiness) => void): () => void;
+    answered(queries: readonly unknown[], done: () => void): void;
 };
 export type MdRuntimeHost = {
-    attach(port: RuntimePort, app: string, release?: string, reach?: PortReach): AttachedPort;
+    attach(port: RuntimePort, options: AttachOptions): AttachedPort;
+    present(app: string, members: Readonly<Record<string, unknown>>): Promise<void>;
+    seed(entry: EntrySeed): void;
+    persisted(answer: Persistence): void;
     endAuthorization(holder?: string): Promise<void>;
-    lose(locators: readonly string[]): Promise<void>;
     stop(): Promise<void>;
 };
 export declare function serveMdRuntime(options: MdRuntimeHostOptions): MdRuntimeHost;
+export { entrySeedOf, type EntrySeed } from './seed.js';
 export type { PortReach, ReachedDocument } from './reach.js';
+export type { CodeAvailability, Persistence, Space } from './readiness.js';
 export { createRecovery, retryDelay, type Attempt, type Attempted, type AttemptOptions, type Recovery, type RecoveryOptions, } from './recovery.js';
-export { AUTHORED_SCHEMA, authoredBinding, authoredBy, authoredHolder, bindAuthored, STORE_SCHEMA, } from './store.js';
-export type { RuntimePort } from './wire.js';
+export { undeclared } from './outcome.js';
+export { wireAnswer, wireRequest, type RuntimePort, type WireAnswer, type WireRequest, } from './wire.js';
 //# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,OAAO,EAGL,KAAK,WAAW,EAOjB,MAAM,WAAW,CAAC;AAInB,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,IAAI,IAAI,CAAC;IACf,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAC1F,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB,CAAC;AA0FF,wBAAgB,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAoH3E;AAED,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EACL,cAAc,EACd,UAAU,EACV,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,eAAe,EACf,eAAe,EACf,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"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"}