@agentshouse/mdruntime 0.1.0-ce531b51ff088 → 0.1.0-ce6bc9239a3ee

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.
+const 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() - 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/host.d.ts

@@ -1,13 +1,29 @@
 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 RuntimePort } from './wire.js';
 export type MdRuntimeHostOptions = MdRuntimeOptions & {
     deploymentFacts?: unknown;
 };
+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): () => void;
-    endAuthorization(): Promise<void>;
+    attach(port: RuntimePort, app: string, release?: string, reach?: PortReach, code?: CodeAvailability): AttachedPort;
+    present(app: string, members: Readonly<Record<string, unknown>>): Promise<void>;
+    seed(entry: EntrySeed): void;
+    persisted(answer: Persistence): void;
+    endAuthorization(holder?: 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 type { RuntimePort } 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":"AACA,OAAO,EAIL,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EAML,KAAK,WAAW,EAIjB,MAAM,WAAW,CAAC;AAEnB,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IACrE,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB,CAAC;AA0EF,wBAAgB,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAwG3E;AAED,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAG3C,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;IAC/B,SAAS,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC/D,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CACJ,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,SAAS,EACjB,IAAI,CAAC,EAAE,gBAAgB,GACtB,YAAY,CAAC;IAChB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB,CAAC;AAsIF,wBAAgB,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAuL3E;AAED,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC3E,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,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}