@agentshouse/mdruntime 0.1.0-cc7bd7a53214e → 0.1.0-ccbe92df1c4f6

package/dist/client.js

@@ -1,5 +1,11 @@
 import { observed } from './observation.js';
-import { answer, AUTHORIZATION_ENDED, carried, envelope, PORT_CLOSED, PROTOCOL_MISMATCH, } from './wire.js';
+import { runtimeError } from './failure.js';
+import { answer, AUTHORIZATION_ENDED, PORT_CLOSED, } from './wire.js';
+// React renders an arrived value in a later task and opens what that render observes as it commits, so this many frames opening nothing mean the page drew what it observes.
+const SETTLED_FRAMES = 2;
+function refused(refusal) {
+    return runtimeError(refusal.code, refusal.code, refusal.retryable);
+}
 export function connectMdRuntime(port) {
     let sequence = 0;
     let refusal = null;
@@ -7,8 +13,10 @@ export function connectMdRuntime(port) {
     const calls = new Map();
     const opening = new Map();
     const observations = new Map();
+    let drawing = null;
+    let settling = null;
     const send = (message) => {
-        port.postMessage(envelope(message));
+        port.postMessage(message);
     };
     function begin(id, topic, first) {
         const handle = observed(first, () => {
@@ -25,7 +33,7 @@ export function connectMdRuntime(port) {
             if (topic === 'connection-refusal')
                 handle.receive(reported);
         }
-        const failure = new Error(reported.reason);
+        const failure = refused(reported);
         for (const [id, waiting] of opening) {
             if (waiting.topic === 'connection-refusal')
                 waiting.settle(begin(id, waiting.topic, reported));
@@ -36,12 +44,12 @@ export function connectMdRuntime(port) {
         for (const waiting of calls.values())
             waiting.fail(failure);
         calls.clear();
+        drawing?.();
     }
-    function end(reason) {
+    function end(failure) {
         if (ended !== null)
             return;
-        ended = reason;
-        const failure = new Error(reason);
+        ended = failure;
         for (const waiting of opening.values())
             waiting.fail(failure);
         opening.clear();
@@ -51,16 +59,10 @@ export function connectMdRuntime(port) {
         for (const { handle } of observations.values())
             handle.end();
         observations.clear();
+        drawing?.();
     }
     port.addEventListener('message', (event) => {
-        const wire = carried(event.data);
-        if (wire === null)
-            return;
-        if (!wire.matching) {
-            refuse(PROTOCOL_MISMATCH);
-            return;
-        }
-        const message = answer(wire.message);
+        const message = answer(event.data);
         if (message === null)
             return;
         if (message.kind === 'refusal') {
@@ -68,7 +70,11 @@ export function connectMdRuntime(port) {
             return;
         }
         if (message.kind === 'ended') {
-            end(AUTHORIZATION_ENDED);
+            for (const { topic, handle } of observations.values()) {
+                if (topic === 'member')
+                    handle.receive(null);
+            }
+            end(runtimeError('authorization-ended', AUTHORIZATION_ENDED));
             return;
         }
         if (message.kind === 'event') {
@@ -78,31 +84,34 @@ export function connectMdRuntime(port) {
         const waiting = opening.get(message.id);
         if (waiting !== undefined) {
             opening.delete(message.id);
-            if (message.kind === 'failure')
-                waiting.fail(new Error(message.message));
+            if (message.kind === 'failure') {
+                waiting.fail(runtimeError(message.code, message.message, message.retryable));
+            }
             else
                 waiting.settle(begin(message.id, waiting.topic, message.value));
+            drawing?.();
             return;
         }
         const called = calls.get(message.id);
         if (called === undefined)
             return;
         calls.delete(message.id);
-        if (message.kind === 'failure')
-            called.fail(new Error(message.message));
+        if (message.kind === 'failure') {
+            called.fail(runtimeError(message.code, message.message, message.retryable));
+        }
         else
             called.settle(message.value);
     });
     port.addEventListener('close', () => {
-        end(PORT_CLOSED);
+        end(runtimeError('port-closed', PORT_CLOSED));
     });
     port.start();
     send({ kind: 'hello' });
     function ask(member, input) {
         if (ended !== null)
-            return Promise.reject(new Error(ended));
+            return Promise.reject(ended);
         if (refusal !== null)
-            return Promise.reject(new Error(refusal.reason));
+            return Promise.reject(refused(refusal));
         const id = (sequence += 1);
         return new Promise((settle, fail) => {
             calls.set(id, { settle: settle, fail });
@@ -111,18 +120,71 @@ export function connectMdRuntime(port) {
     }
     function watch(topic, input) {
         if (ended !== null)
-            return Promise.reject(new Error(ended));
+            return Promise.reject(ended);
         const id = (sequence += 1);
         if (refusal !== null) {
             return topic === 'connection-refusal'
                 ? Promise.resolve(begin(id, topic, refusal))
-                : Promise.reject(new Error(refusal.reason));
+                : Promise.reject(refused(refusal));
         }
         return new Promise((settle, fail) => {
             opening.set(id, { topic, settle, fail });
             send({ kind: 'observe', id, topic, input });
+            drawing?.();
         });
     }
+    function streamed(answer) {
+        if (answer.kind !== 'binary')
+            return answer;
+        const { file, byteLength, mediaType } = answer;
+        let part = 0;
+        let received = 0;
+        const stream = new ReadableStream({
+            async pull(controller) {
+                const bytes = await ask('binaryFile.part', [file, part]);
+                if (bytes === null) {
+                    if (received === byteLength)
+                        controller.close();
+                    else
+                        controller.error(runtimeError('binary-file-absent', 'The file ended early'));
+                    return;
+                }
+                part += 1;
+                received += bytes.byteLength;
+                controller.enqueue(bytes);
+            },
+        }, { highWaterMark: 0 });
+        return { kind: 'binary', stream, byteLength, mediaType };
+    }
+    function settled() {
+        if (settling !== null)
+            return settling;
+        settling = new Promise((resolve) => {
+            let moved = 0;
+            const check = () => {
+                moved += 1;
+                if (opening.size > 0)
+                    return;
+                const at = moved;
+                const waited = (frames) => {
+                    requestAnimationFrame(() => {
+                        if (frames < SETTLED_FRAMES) {
+                            waited(frames + 1);
+                            return;
+                        }
+                        if (moved !== at || opening.size > 0)
+                            return;
+                        drawing = null;
+                        resolve();
+                    });
+                };
+                waited(1);
+            };
+            drawing = check;
+            check();
+        });
+        return settling;
+    }
     return {
         rooms: () => ask('rooms', []),
         query: ((query) => ask('query', [query])),
@@ -135,15 +197,18 @@ export function connectMdRuntime(port) {
             discard: (room, path, revision) => ask('roomDraft.discard', [room, path, revision]),
         },
         save: (room, roomDrafts) => ask('save', [room, roomDrafts]),
+        saveParts: (room, parts) => ask('saveParts', [room, parts]),
         presentation: {
             read: () => ask('presentation.read', []),
             write: (value) => ask('presentation.write', [value]),
+            edit: (members) => ask('presentation.edit', [members]),
         },
         conversation: {
             list: () => ask('conversation.list', []),
             read: (conversation, options) => ask('conversation.read', [conversation, options]),
             create: (input) => ask('conversation.create', [input]),
-            send: (conversation) => ask('conversation.send', [conversation]),
+            send: (conversation, operation, draft) => ask('conversation.send', [conversation, operation, draft]),
+            attach: (room, file) => ask('conversation.attach', [room, file]),
             answer: (conversation, answer) => ask('conversation.answer', [conversation, answer]),
             interrupt: (conversation) => ask('conversation.interrupt', [conversation]),
             kill: (conversation) => ask('conversation.kill', [conversation]),
@@ -151,15 +216,32 @@ export function connectMdRuntime(port) {
             delete: (conversation) => ask('conversation.delete', [conversation]),
         },
         chatDraft: {
-            write: (conversation, draft) => ask('chatDraft.write', [conversation, draft]),
+            write: (conversation, draft, revision) => ask('chatDraft.write', [conversation, draft, revision]),
+            prepend: (conversation, draft) => ask('chatDraft.prepend', [conversation, draft]),
             discard: (conversation) => ask('chatDraft.discard', [conversation]),
         },
         history: (locator, path, query) => ask('history', [locator, path, query]),
+        resolve: (room, path, destination) => ask('resolve', [room, path, destination]),
+        binaryFile: {
+            read: (room, path, revision) => ask('binaryFile.read', [room, path, revision]).then(streamed),
+            link: (room, path, revision) => ask('binaryFile.link', [room, path, revision]),
+        },
         call: (name, input) => ask('call', [name, input]),
         reached: (locator, roomVersion, path) => ask('reached', [locator, roomVersion, path]),
         log: () => ask('log', []),
         persistence: () => ask('persistence', []),
+        retry: () => ask('retry', []),
+        cleanUp: () => ask('cleanUp', []),
         observe: ((topic, ...input) => watch(topic, input)),
         reauthorize: () => ask('reauthorize', []),
+        settled,
     };
 }
+const turns = new WeakMap();
+export function inTurn(client, work) {
+    const turn = (turns.get(client) ?? Promise.resolve()).then(work);
+    turns.set(client, turn.then(() => undefined, () => undefined));
+    return turn;
+}
+export { chainedWindows } from './chain.js';
+export { unanswered } from './wire.js';

package/dist/collection.d.ts

@@ -1,11 +1,13 @@
-import { type Document, type Validation } from '@agentshouse/mdmodel';
+import { type Document } from '@agentshouse/mdmodel';
 import type { ModelState } from './model.js';
 import type { MdModelIdentity } from './adapter.js';
+import { type Paths } from './shared.js';
 import type { Refused } from './transfer.js';
 export declare const MD_MODEL: MdModelIdentity;
 export type Collection = {
-    documents: Readonly<Record<string, Document>>;
+    text: Readonly<Record<string, string>>;
     composition: Composition;
+    document(path: string): Document | undefined;
 };
 export type Composition = {
     model: ModelState;
@@ -14,17 +16,11 @@ export type Composition = {
         model: ModelState;
     } | null;
 };
+export declare function selected(composition: Composition, path: string): boolean;
 export declare function governing(composition: Composition, path: string): ModelState;
-type Previous = {
-    text: Readonly<Record<string, string>>;
-    collection: Collection;
-};
-export declare function parseCollection(text: Readonly<Record<string, string>>, composition: Composition, previous?: Previous): Collection;
-export declare function readCollection(text: Readonly<Record<string, string>>, composition: Composition, previous?: Previous): {
-    kind: 'read';
-    collection: Collection;
-} | Refused;
+export declare function collectionOf(text: Readonly<Record<string, string>>, composition: Composition): Collection;
+export declare function documentsOf(collection: Collection): Generator<number, Iterable<readonly [string, Document]>, void>;
+export declare function unreadable(text: Paths<string>, paths?: Iterable<string> | null): Generator<number, Refused | null, void>;
 export declare function validRoot(root: unknown): root is string;
-export declare function validateCollection(text: Readonly<Record<string, string>>, binaryTargets: readonly string[], composition: Composition): Validation;
-export {};
+export declare function available(composition: Composition): boolean;
 //# sourceMappingURL=collection.d.ts.map

package/dist/collection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,QAAQ,EAEb,KAAK,UAAU,EAEhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAO,MAAM,QAAQ,EAAE,eAAwE,CAAC;AAIhG,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC9C,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE;QAAE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI,CAAC;CACnE,CAAC;AASF,wBAAgB,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAI5E;AAED,KAAK,QAAQ,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAAC;AAanF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACtC,WAAW,EAAE,WAAW,EACxB,QAAQ,CAAC,EAAE,QAAQ,GAClB,UAAU,CAOZ;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACtC,WAAW,EAAE,WAAW,EACxB,QAAQ,CAAC,EAAE,QAAQ,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,GAAG,OAAO,CAQpD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAEvD;AAwBD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACtC,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,WAAW,EAAE,WAAW,GACvB,UAAU,CA0BZ"}
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAsB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,eAAO,MAAM,QAAQ,EAAE,eAAwE,CAAC;AAEhG,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvC,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE;QAAE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI,CAAC;CACnE,CAAC;AAEF,wBAAgB,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKxE;AAED,wBAAgB,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAI5E;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACtC,WAAW,EAAE,WAAW,GACvB,UAAU,CAcZ;AAED,wBAAiB,WAAW,CAC1B,UAAU,EAAE,UAAU,GACrB,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAQhE;AAED,wBAAiB,UAAU,CACzB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EACnB,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAW,GACpC,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,IAAI,CAAC,CAazC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAEvD;AAED,wBAAgB,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAK3D"}

package/dist/collection.js

@@ -1,8 +1,9 @@
-import { parse, validate, VERSION, } from '@agentshouse/mdmodel';
+import { parse, VERSION } from '@agentshouse/mdmodel';
 import { beneath, normalize } from './paths.js';
+import { keysIn, sortedKeys } from './shared.js';
+import { ROW_WEIGHT } from './turn.js';
 export const MD_MODEL = { identity: '@agentshouse/mdmodel', version: VERSION };
-const NO_TYPES = { types: {} };
-function selected(composition, path) {
+export function selected(composition, path) {
     return (composition.selection !== null &&
         composition.selection.roots.some((root) => beneath(root, path)));
 }
@@ -11,62 +12,52 @@ export function governing(composition, path) {
         ? composition.selection.model
         : composition.model;
 }
-function parsedAt(text, path, previous) {
-    const retained = previous?.collection.documents[path];
-    return retained !== undefined && previous?.text[path] === text[path]
-        ? { ok: true, document: retained }
-        : parse(text[path], path);
-}
-export function parseCollection(text, composition, previous) {
-    const documents = {};
-    for (const path of Object.keys(text).sort()) {
-        const parsed = parsedAt(text, path, previous);
-        if (parsed.ok)
-            documents[path] = parsed.document;
-    }
-    return { documents, composition };
-}
-export function readCollection(text, composition, previous) {
-    const documents = {};
-    for (const path of Object.keys(text).sort()) {
-        const parsed = parsedAt(text, path, previous);
-        if (!parsed.ok)
-            return { kind: 'refused', refusal: parsed.refusal };
-        documents[path] = parsed.document;
+export function collectionOf(text, composition) {
+    const parsed = new Map();
+    return {
+        text,
+        composition,
+        document(path) {
+            if (parsed.has(path))
+                return parsed.get(path) ?? undefined;
+            const content = text[path];
+            if (content === undefined)
+                return undefined;
+            const read = parse(content, path);
+            parsed.set(path, read.ok ? read.document : null);
+            return read.ok ? read.document : undefined;
+        },
+    };
+}
+export function* documentsOf(collection) {
+    const paths = yield* sortedKeys(collection.text);
+    return (function* () {
+        for (const path of paths) {
+            const document = collection.document(path);
+            if (document !== undefined)
+                yield [path, document];
+        }
+    })();
+}
+export function* unreadable(text, paths = null) {
+    const named = paths ?? (yield* keysIn(text));
+    let least = null;
+    for (const path of named) {
+        const content = Object.hasOwn(text, path) ? text[path] : undefined;
+        if (content === undefined)
+            continue;
+        const read = parse(content, path);
+        if (!read.ok && (least === null || path < least.path)) {
+            least = { path, refused: { kind: 'refused', refusal: read.refusal } };
+        }
+        yield ROW_WEIGHT + content.length;
     }
-    return { kind: 'read', collection: { documents, composition } };
+    return least?.refused ?? null;
 }
 export function validRoot(root) {
     return typeof root === 'string' && normalize(root) === root;
 }
-function validateAgainst(documents, binaryTargets, model) {
-    if (model.status === 'unavailable') {
-        const typed = Object.entries(documents).find(([, content]) => {
-            const parsed = parse(content);
-            return parsed.ok && parsed.document.type !== undefined && parsed.document.type !== 'any';
-        });
-        if (typed !== undefined)
-            return { verdict: 'refuse', rule: 'model-unavailable', file: typed[0] };
-    }
-    return validate(documents, { binaryTargets }, model.status === 'unavailable' ? NO_TYPES : { types: model.types });
-}
-export function validateCollection(text, binaryTargets, composition) {
-    const collection = {};
-    const selection = {};
-    for (const [path, content] of Object.entries(text)) {
-        if (selected(composition, path))
-            selection[path] = content;
-        else
-            collection[path] = content;
-    }
-    const verdicts = [
-        validateAgainst(collection, binaryTargets.filter((path) => !selected(composition, path)), composition.model),
-    ];
-    if (composition.selection !== null) {
-        verdicts.push(validateAgainst(selection, binaryTargets.filter((path) => selected(composition, path)), composition.selection.model));
-    }
-    const refusals = verdicts.filter((verdict) => verdict.verdict === 'refuse');
-    if (refusals.length === 0)
-        return verdicts[0];
-    return refusals.find((refusal) => refusal.rule !== 'model-unavailable') ?? refusals[0];
+export function available(composition) {
+    return (composition.model.status !== 'unavailable' &&
+        (composition.selection === null || composition.selection.model.status !== 'unavailable'));
 }

package/dist/compile.d.ts

@@ -0,0 +1,16 @@
+import type { Plan, QueryRows } from './query.js';
+import type { Connection, Value } from './tables.js';
+export type QueryRoom = {
+    readonly locator: string;
+    readonly key: number;
+};
+export type Fragment = {
+    readonly sql: string;
+    readonly bind: readonly Value[];
+};
+export type QueryAnswer = QueryRows & {
+    readonly more?: string;
+};
+export declare function selected(connection: Connection, plan: Plan, rooms: readonly QueryRoom[]): Fragment;
+export declare function answerQuery(connection: Connection, plan: Plan, rooms: readonly QueryRoom[], budget?: number | null): QueryAnswer;
+//# sourceMappingURL=compile.d.ts.map

package/dist/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAOV,IAAI,EAGJ,SAAS,EAIV,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,UAAU,EAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAU1D,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,KAAK,EAAE,CAAA;CAAE,CAAC;AA+pBjF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AA8SjE,wBAAgB,QAAQ,CACtB,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,SAAS,SAAS,EAAE,GAC1B,QAAQ,CAEV;AAED,wBAAgB,WAAW,CACzB,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,MAAM,GAAE,MAAM,GAAG,IAAW,GAC3B,WAAW,CAUb"}