@agentshouse/mdruntime 0.1.0-ca7c26c6bc27e → 0.1.0-ca8707258fdde

package/dist/digest.d.ts

@@ -0,0 +1,7 @@
+export type Digest = {
+    update(bytes: Uint8Array): void;
+    hex(): string;
+};
+export declare function digest(): Digest;
+export declare function sha256(blob: Blob): Promise<string>;
+//# sourceMappingURL=digest.d.ts.map

package/dist/digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../src/digest.ts"],"names":[],"mappings":"AA0EA,MAAM,MAAM,MAAM,GAAG;IACnB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,GAAG,IAAI,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,MAAM,IAAI,MAAM,CAoC/B;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAMxD"}

package/dist/digest.js

@@ -0,0 +1,113 @@
+import { FILE_PART_BYTES } from './tables.js';
+const ROUNDS = new Uint32Array([
+    0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5,
+    0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174,
+    0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,
+    0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967,
+    0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85,
+    0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,
+    0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3,
+    0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2,
+]);
+const INITIAL = [
+    0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a, 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19,
+];
+const BLOCK = 64;
+function rotated(value, by) {
+    return (value >>> by) | (value << (32 - by));
+}
+function compressed(state, words, bytes, at) {
+    for (let index = 0; index < 16; index += 1) {
+        const from = at + index * 4;
+        words[index] =
+            (bytes[from] << 24) | (bytes[from + 1] << 16) | (bytes[from + 2] << 8) | bytes[from + 3];
+    }
+    for (let index = 16; index < 64; index += 1) {
+        const early = words[index - 15];
+        const late = words[index - 2];
+        const lower = rotated(early, 7) ^ rotated(early, 18) ^ (early >>> 3);
+        const upper = rotated(late, 17) ^ rotated(late, 19) ^ (late >>> 10);
+        words[index] = (words[index - 16] + lower + words[index - 7] + upper) | 0;
+    }
+    let a = state[0];
+    let b = state[1];
+    let c = state[2];
+    let d = state[3];
+    let e = state[4];
+    let f = state[5];
+    let g = state[6];
+    let h = state[7];
+    for (let index = 0; index < 64; index += 1) {
+        const chosen = (e & f) ^ (~e & g);
+        const first = (h +
+            (rotated(e, 6) ^ rotated(e, 11) ^ rotated(e, 25)) +
+            chosen +
+            ROUNDS[index] +
+            words[index]) |
+            0;
+        const second = ((rotated(a, 2) ^ rotated(a, 13) ^ rotated(a, 22)) + ((a & b) ^ (a & c) ^ (b & c))) | 0;
+        h = g;
+        g = f;
+        f = e;
+        e = (d + first) | 0;
+        d = c;
+        c = b;
+        b = a;
+        a = (first + second) | 0;
+    }
+    state[0] += a;
+    state[1] += b;
+    state[2] += c;
+    state[3] += d;
+    state[4] += e;
+    state[5] += f;
+    state[6] += g;
+    state[7] += h;
+}
+export function digest() {
+    const state = new Uint32Array(INITIAL);
+    const words = new Uint32Array(64);
+    const pending = new Uint8Array(BLOCK);
+    let held = 0;
+    let size = 0;
+    return {
+        update(bytes) {
+            size += bytes.length;
+            let from = 0;
+            if (held > 0) {
+                const taken = Math.min(BLOCK - held, bytes.length);
+                pending.set(bytes.subarray(0, taken), held);
+                held += taken;
+                from = taken;
+                if (held < BLOCK)
+                    return;
+                compressed(state, words, pending, 0);
+                held = 0;
+            }
+            for (; from + BLOCK <= bytes.length; from += BLOCK)
+                compressed(state, words, bytes, from);
+            pending.set(bytes.subarray(from), 0);
+            held = bytes.length - from;
+        },
+        hex() {
+            const bits = size * 8;
+            const tail = new Uint8Array(held < 56 ? BLOCK : BLOCK * 2);
+            tail.set(pending.subarray(0, held));
+            tail[held] = 0x80;
+            const length = new DataView(tail.buffer, tail.length - 8);
+            length.setUint32(0, Math.floor(bits / 0x1_0000_0000));
+            length.setUint32(4, bits >>> 0);
+            const final = new Uint32Array(state);
+            for (let from = 0; from < tail.length; from += BLOCK)
+                compressed(final, words, tail, from);
+            return [...final].map((word) => word.toString(16).padStart(8, '0')).join('');
+        },
+    };
+}
+export async function sha256(blob) {
+    const hashed = digest();
+    for (let at = 0; at < blob.size; at += FILE_PART_BYTES) {
+        hashed.update(new Uint8Array(await blob.slice(at, at + FILE_PART_BYTES).arrayBuffer()));
+    }
+    return hashed.hex();
+}

package/dist/durability.d.ts

@@ -1,9 +1,18 @@
+import type { Persistence } from './readiness.js';
+export type UnsentKind = 'pending-change' | 'call' | 'room-draft' | 'chat-draft';
+export type UnsentWork = {
+    readonly kind: UnsentKind;
+    readonly count: number;
+};
 export type RuntimeShell = {
-    persistentStorage: boolean;
+    persistence: Persistence;
     generation: string | null;
     keepGeneration(value: string): void | Promise<void>;
     dropGeneration(): void | Promise<void>;
+    cleanUp?(): Promise<number>;
+    reset(): Promise<void>;
 };
+export declare function refusedForSpace(error: unknown): boolean;
 export declare function detectStorageLoss(stored: string | null, reported: string | null): string | null;
 export declare function nextGeneration(stored: string | null, reported: string | null): string;
 //# sourceMappingURL=durability.d.ts.map

package/dist/durability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"durability.d.ts","sourceRoot":"","sources":["../src/durability.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,cAAc,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAG/F;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGrF"}
+{"version":3,"file":"durability.d.ts","sourceRoot":"","sources":["../src/durability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAIlD,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,MAAM,GAAG,YAAY,GAAG,YAAY,CAAC;AAEjF,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,cAAc,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMvD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAG/F;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGrF"}

package/dist/durability.js

@@ -1,4 +1,9 @@
 const STORAGE_LOSS_CODE = 'storage-loss';
+export function refusedForSpace(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        error.name === 'QuotaExceededError');
+}
 export function detectStorageLoss(stored, reported) {
     if (reported === null || reported === stored)
         return null;

package/dist/entry.d.ts

@@ -0,0 +1,20 @@
+import { type VerifiedModel } from '@agentshouse/mdmodel';
+import { type QueryRows } from './query.js';
+import type { Connection } from './tables.js';
+export { QueryError } from '@agentshouse/mdmodel';
+export type EntryRoom = {
+    locator: string;
+    schema: string | null;
+    documents: Readonly<Record<string, string>>;
+    revisions?: Readonly<Record<string, string>>;
+};
+export type EntryArguments = Readonly<Record<string, string>>;
+export type EntryParameterKind = 'string' | 'integer' | 'number' | 'boolean';
+export declare function boundQuery(template: unknown, args: EntryArguments): unknown;
+export declare function entryParameters(template: unknown): readonly string[];
+export declare function entryRefusal(template: unknown): string | null;
+export type EntryScope = {
+    results(queries: Readonly<Record<string, unknown>>): Promise<Record<string, QueryRows>>;
+};
+export declare function entryScope(rooms: readonly EntryRoom[], roomTypes: VerifiedModel, connection: Connection): EntryScope;
+//# sourceMappingURL=entry.d.ts.map

package/dist/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAGnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5C,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE9D,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AA0D7E,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAE3E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAMpE;AAyCD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQ7D;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CACzF,CAAC;AAEF,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,SAAS,EAAE,aAAa,EACxB,UAAU,EAAE,UAAU,GACrB,UAAU,CAoDZ"}

package/dist/entry.js

@@ -0,0 +1,161 @@
+import { invalid, plain, QueryError, } from '@agentshouse/mdmodel';
+import { attachedModel } from './attached-model.js';
+import { answerQuery } from './compile.js';
+import { planWithin } from './query.js';
+import { writtenFacts } from './rows.js';
+import { entered, REPLICA_TABLES } from './stored.js';
+export { QueryError } from '@agentshouse/mdmodel';
+const PARAMETER = '$param';
+const KIND = 'as';
+const INTEGER = /^-?(?:0|[1-9][0-9]*)$/u;
+const NUMBER = /^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?$/u;
+function parameterOf(value) {
+    if (!plain(value) || !Object.hasOwn(value, PARAMETER))
+        return null;
+    const { [PARAMETER]: name, [KIND]: kind = 'string', ...rest } = value;
+    if (typeof name !== 'string' || Object.keys(rest).length > 0)
+        return null;
+    if (kind !== 'string' && kind !== 'integer' && kind !== 'number' && kind !== 'boolean') {
+        return null;
+    }
+    return { name, kind };
+}
+function converted(text, kind, at) {
+    if (kind === 'string')
+        return text;
+    if (kind === 'boolean') {
+        if (text === 'true' || text === 'false')
+            return text === 'true';
+        return invalid(at, 'expects true or false');
+    }
+    if (!(kind === 'integer' ? INTEGER : NUMBER).test(text))
+        invalid(at, `expects ${kind === 'integer' ? 'an integer' : 'a number'}`);
+    const number = Number(text);
+    if (!Number.isFinite(number) || (kind === 'integer' && !Number.isSafeInteger(number))) {
+        invalid(at, 'is out of range');
+    }
+    return number;
+}
+function bound(template, args, at) {
+    const parameter = parameterOf(template);
+    if (parameter !== null) {
+        const text = args[parameter.name];
+        if (text === undefined || !Object.hasOwn(args, parameter.name)) {
+            invalid(at, `names the parameter ${parameter.name}, which the route lacks`);
+        }
+        return converted(text, parameter.kind, at);
+    }
+    if (Array.isArray(template)) {
+        return template.map((item, index) => bound(item, args, `${at}[${index}]`));
+    }
+    if (plain(template)) {
+        return Object.fromEntries(Object.entries(template).map(([name, value]) => [
+            name,
+            bound(value, args, at === '' ? name : `${at}.${name}`),
+        ]));
+    }
+    return template;
+}
+export function boundQuery(template, args) {
+    return bound(template, args, '');
+}
+export function entryParameters(template) {
+    const parameter = parameterOf(template);
+    if (parameter !== null)
+        return [parameter.name];
+    if (Array.isArray(template))
+        return [...new Set(template.flatMap(entryParameters))];
+    if (plain(template))
+        return [...new Set(Object.values(template).flatMap(entryParameters))];
+    return [];
+}
+const SAMPLED = {
+    direction: 'asc',
+    nulls: 'last',
+    stringSort: 'lexical',
+    locale: 'en',
+    limit: 0,
+    pathPrefix: 'entry',
+    field: '/entry',
+    fields: '/entry',
+    types: 'any',
+    $in: 'entry',
+    $nin: 'entry',
+    $all: 'entry',
+    $size: 0,
+    $exists: true,
+    $prefix: 'entry',
+    $gt: 0,
+    $gte: 0,
+    $lt: 0,
+    $lte: 0,
+};
+function sampled(template, key) {
+    if (parameterOf(template) !== null)
+        return Object.hasOwn(SAMPLED, key) ? SAMPLED[key] : null;
+    if (Array.isArray(template))
+        return template.map((item) => sampled(item, key));
+    if (plain(template)) {
+        return Object.fromEntries(Object.entries(template).map(([name, value]) => [name, sampled(value, name)]));
+    }
+    return template;
+}
+function entryPlan(query, facts) {
+    const plan = planWithin(query, facts);
+    if (plan.fileIds !== null)
+        invalid('fileIds', 'an entry Room holds no file IDs');
+    return plan;
+}
+export function entryRefusal(template) {
+    try {
+        entryPlan(sampled(template, ''), { listed: false, rooms: [] });
+        return null;
+    }
+    catch (error) {
+        if (error instanceof QueryError)
+            return error.message;
+        throw error;
+    }
+}
+export function entryScope(rooms, roomTypes, connection) {
+    for (const table of REPLICA_TABLES)
+        connection.run(table);
+    const held = [];
+    const keys = rooms.map((room) => {
+        const model = attachedModel({
+            kind: 'model',
+            snapshot: { identity: room.locator, version: '', schema: room.schema, revision: null },
+        }, roomTypes);
+        held.push({
+            locator: room.locator,
+            available: model.status !== 'unavailable',
+            types: model.status === 'unavailable' ? [] : Object.values(model.types),
+        });
+        const composition = { model, selection: null, typedPaths: [] };
+        const key = entered(connection, room.locator, composition, Object.keys(room.documents)
+            .sort()
+            .map((path) => ({
+            path,
+            content: room.documents[path],
+            facts: writtenFacts(path, room.documents[path], composition),
+            binary: null,
+            revision: room.revisions?.[path] ?? null,
+            fileId: null,
+            created: null,
+            change: null,
+            written: null,
+        })));
+        return { locator: room.locator, key };
+    });
+    const planned = { listed: true, rooms: held };
+    return {
+        async results(queries) {
+            const results = {};
+            for (const [name, query] of Object.entries(queries)) {
+                const plan = entryPlan(query, planned);
+                results[name] = answerQuery(connection, plan, keys.filter(({ locator }) => plan.rooms === null || plan.rooms.includes(locator)));
+            }
+            return results;
+        },
+    };
+}

package/dist/expectation.d.ts

@@ -0,0 +1,21 @@
+export type ExpectedOf<E extends {
+    readonly key: string;
+}> = E | readonly E[] | null;
+export type Expecting<E extends {
+    readonly key: string;
+}> = {
+    subscribe(listener: () => void): () => void;
+    version(): number;
+    begin(): number;
+    expect(act: number, expected: ExpectedOf<E>, settled?: (one: E) => boolean): void;
+    drop(act: number): void;
+    heard(shown: (one: E) => boolean): void;
+    drawn(): readonly E[];
+};
+export declare function expectedList<E extends {
+    readonly key: string;
+}>(expected: ExpectedOf<E>): readonly E[];
+export declare function expecting<E extends {
+    readonly key: string;
+}>(): Expecting<E>;
+//# sourceMappingURL=expectation.d.ts.map

package/dist/expectation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expectation.d.ts","sourceRoot":"","sources":["../src/expectation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,IAAI,CAAC,GAAG,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC;AAErF,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,IAAI;IAC1D,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,OAAO,IAAI,MAAM,CAAC;IAClB,KAAK,IAAI,MAAM,CAAC;IAChB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,CAAC;IAClF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,CAAC;IACxC,KAAK,IAAI,SAAS,CAAC,EAAE,CAAC;CACvB,CAAC;AAIF,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAC7D,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,GACtB,SAAS,CAAC,EAAE,CAGd;AAwBD,wBAAgB,SAAS,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,KAAK,SAAS,CAAC,CAAC,CAAC,CA4C5E"}

package/dist/expectation.js

@@ -0,0 +1,70 @@
+export function expectedList(expected) {
+    if (expected === null)
+        return [];
+    return 'key' in expected ? [expected] : expected;
+}
+function superseded(entries, at) {
+    const key = entries[at]?.expectation.key;
+    return entries.slice(at + 1).some((later) => later.expectation.key === key);
+}
+function unended(entries, ends) {
+    const ended = new Set();
+    const kept = [];
+    for (const one of [...entries].reverse()) {
+        if (ended.has(one.expectation.key))
+            continue;
+        if (ends(one.expectation))
+            ended.add(one.expectation.key);
+        else
+            kept.unshift(one);
+    }
+    return kept;
+}
+export function expecting() {
+    let entries = [];
+    let version = 0;
+    let acts = 0;
+    const listeners = new Set();
+    const set = (next) => {
+        if (next.length === entries.length && next.every((one, at) => one === entries[at]))
+            return;
+        entries = next;
+        version += 1;
+        for (const listener of listeners)
+            listener();
+    };
+    return {
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        version: () => version,
+        begin() {
+            acts += 1;
+            return acts;
+        },
+        expect(act, expected, settled = () => false) {
+            const fresh = expectedList(expected);
+            if (fresh.length === 0)
+                return;
+            const keys = new Set(fresh.map((one) => one.key));
+            const kept = entries.filter((one) => one.act !== act || !keys.has(one.expectation.key));
+            const over = new Set(kept.map((one) => one.expectation.key));
+            set([
+                ...kept,
+                ...fresh
+                    .filter((one) => over.has(one.key) || !settled(one))
+                    .map((expectation) => ({ act, expectation })),
+            ]);
+        },
+        drop(act) {
+            set(entries.filter((one) => one.act !== act));
+        },
+        heard(shown) {
+            set(unended(entries, shown));
+        },
+        drawn: () => entries.flatMap((one, at) => (superseded(entries, at) ? [] : [one.expectation])),
+    };
+}

package/dist/failure.d.ts

@@ -0,0 +1,13 @@
+export type RuntimeError = Error & {
+    readonly code: string;
+    readonly retryable: boolean;
+};
+export type Described = {
+    message: string;
+    code: string;
+    retryable: boolean;
+};
+export declare function runtimeError(code: string, message?: string, retryable?: boolean): RuntimeError;
+export declare function failed(error: unknown): RuntimeError;
+export declare function described(error: unknown): Described;
+//# sourceMappingURL=failure.d.ts.map

package/dist/failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.d.ts","sourceRoot":"","sources":["../src/failure.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC;AAE1F,MAAM,MAAM,SAAS,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9E,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAa,EACtB,SAAS,UAAQ,GAChB,YAAY,CAEd;AAYD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAGnD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAGnD"}

package/dist/failure.js

@@ -0,0 +1,19 @@
+export function runtimeError(code, message = code, retryable = false) {
+    return Object.assign(new Error(message), { code, retryable });
+}
+function coded(error) {
+    return (error instanceof Error &&
+        'code' in error &&
+        typeof error.code === 'string' &&
+        'retryable' in error &&
+        typeof error.retryable === 'boolean');
+}
+export function failed(error) {
+    if (coded(error))
+        return error;
+    return runtimeError('runtime-failure', error instanceof Error ? error.message : String(error));
+}
+export function described(error) {
+    const { message, code, retryable } = failed(error);
+    return { message, code, retryable };
+}

package/dist/figures.d.ts

@@ -0,0 +1,48 @@
+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 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;AAWhC,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"}