@agentshouse/mdruntime 0.1.0-c5b50992a4193 → 0.1.0-c698c0ebd65bd

package/dist/conversation.d.ts

@@ -1,12 +1,13 @@
 import type { ConversationAction, ConversationAgents, ConversationEvent, ConversationMessage, ConversationStream, ProcessCommand, SessionOption, TurnContext } from './adapter.js';
 import { type ChangeSet } from './change-set.js';
 import { type ChatDraftFile } from './file.js';
-import type { CallResult } from './outcome.js';
+import type { Open } from './open.js';
+import { type CallResult, type Offline } from './outcome.js';
 import type { DocumentResult } from './query.js';
 import type { SearchedMessage } from './search.js';
 import type { CycleProgress } from './status.js';
 import type { ChatDraftRecord, HeldConversation, RuntimeStore } from './store.js';
-export type ConversationState = 'working' | 'asking' | 'idle';
+export type ConversationState = Open<'working' | 'asking' | 'idle'>;
 export type ConversationEntry = {
     conversation: string;
     agent: {
@@ -20,6 +21,10 @@ export type ConversationEntry = {
     state: ConversationState;
     started: string | null;
 };
+export type ConversationAgent = {
+    identity: string;
+    name: string;
+};
 export type RunningTurn = {
     turn: string;
     started: string | null;
@@ -43,13 +48,15 @@ export type ConversationView = {
     } | null;
     commands: readonly ProcessCommand[];
     options: readonly SessionOption[];
-    chatDraft: ChatDraft | null;
+    chatDraft: (ChatDraft & {
+        readonly revision: string;
+    }) | null;
 };
 export type ConversationSurface = {
     list(): Promise<readonly ConversationEntry[]>;
     read(conversation: string, options?: ConversationOptions): Promise<ConversationView>;
     create(input: unknown): Promise<CallResult>;
-    send(conversation: string): Promise<CallResult>;
+    send(conversation: string, operation?: string, draft?: ChatDraft): Promise<CallResult | Offline>;
     answer(conversation: string, answer: unknown): Promise<CallResult>;
     interrupt(conversation: string): Promise<CallResult>;
     kill(conversation: string): Promise<CallResult>;
@@ -57,7 +64,7 @@ export type ConversationSurface = {
     delete(conversation: string): Promise<CallResult>;
 };
 export type ChatDraftSurface = {
-    write(conversation: string, draft: ChatDraft): Promise<void>;
+    write(conversation: string, draft: ChatDraft, revision?: string): Promise<void>;
     discard(conversation: string): Promise<void>;
 };
 export type ConversationDependencies = {
@@ -67,6 +74,7 @@ export type ConversationDependencies = {
     durably<T>(work: (local: RuntimeStore) => Promise<T>): Promise<T>;
     stream(): ConversationStream | undefined;
     publish(set: ChangeSet): void;
+    online(): boolean;
     closed(): boolean;
 };
 export type ConversationStore = {
@@ -75,10 +83,12 @@ export type ConversationStore = {
     hydrate(held: readonly HeldConversation[], drafts: readonly ChatDraftRecord[]): void;
     reconcile(): Promise<void>;
     catchUp(progress: CycleProgress): Promise<void>;
+    resend(progress: CycleProgress): Promise<void>;
     current(): boolean;
     reconnected(): void;
     watch(conversation: string, options: ConversationOptions, deliver: (view: ConversationView) => void): () => void;
     watchList(deliver: (entries: readonly ConversationEntry[]) => void): () => void;
+    watchAgents(deliver: (agents: readonly ConversationAgent[]) => void): () => void;
     changed(set: ChangeSet): void;
     receive(event: ConversationEvent): boolean;
     messages(): readonly SearchedMessage[];

package/dist/conversation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../src/conversation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../src/conversation.ts"],"names":[],"mappings":"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"}

package/dist/conversation.js

@@ -1,5 +1,8 @@
 import { conversationChangeSet } from './change-set.js';
+import { runtimeError } from './failure.js';
 import { declaredFile } from './file.js';
+import { changeBatchIdentity, chatDraftRevision } from './identity.js';
+import { OFFLINE } from './outcome.js';
 const QUIET = {
     turn: null,
     questions: [],
@@ -152,15 +155,33 @@ function limitOf(options) {
     if (limit === undefined)
         return undefined;
     if (!Number.isInteger(limit) || limit < 0) {
-        throw new Error(`conversation limit must be a non-negative integer, got ${String(limit)}`);
+        throw runtimeError('invalid-limit', `conversation limit must be a non-negative integer, got ${String(limit)}`);
     }
     return limit;
 }
+function unwritten(draft) {
+    return draft.text === '' && draft.files.length === 0;
+}
+function pending(draft) {
+    return draft.submitted === undefined ? {} : { submitted: draft.submitted };
+}
+function withSubmitted(draft, submitted) {
+    const { submitted: _held, ...unsent } = draft;
+    return submitted.length === 0 ? unsent : { ...unsent, submitted };
+}
+function returned(draft, submission, others) {
+    return withSubmitted({
+        conversation: draft.conversation,
+        text: [submission.text, draft.text].filter((one) => one !== '').join('\n'),
+        files: [...submission.files, ...draft.files],
+        revision: chatDraftRevision(),
+    }, others);
+}
 export function createConversationStore(deps) {
     const messages = new Map();
     const reads = new Map();
     const drafts = new Map();
-    const sending = new Map();
+    const sending = new Set();
     const behind = new Set();
     const gaps = new Map();
     const lives = new Map();
@@ -168,7 +189,9 @@ export function createConversationStore(deps) {
     const listing = new Map();
     const listWatchers = new Set();
     let listKnown = false;
+    const agentWatchers = new Set();
     let agentNames = new Map();
+    let retiredAgents = new Set();
     let agentsRead = null;
     let replicated = new Set();
     let handedReplicated;
@@ -196,9 +219,9 @@ export function createConversationStore(deps) {
             process: facts.process === null ? null : { ...facts.process },
             commands: structuredClone(facts.commands),
             options: structuredClone(facts.options),
-            chatDraft: draft === undefined || draft.turn !== null || sending.get(conversation)?.draft === draft
+            chatDraft: draft === undefined || unwritten(draft)
                 ? null
-                : { text: draft.text, files: [...draft.files] },
+                : { text: draft.text, files: [...draft.files], revision: draft.revision },
         };
     }
     function emit(conversation, messagesChanged = true) {
@@ -243,6 +266,21 @@ export function createConversationStore(deps) {
         for (const watcher of listWatchers)
             watcher(value);
     }
+    function agents() {
+        return [...agentNames]
+            .filter(([identity]) => !retiredAgents.has(identity))
+            .map(([identity, name]) => ({ identity, name }))
+            .sort((left, right) => left.name === right.name
+            ? left.identity.localeCompare(right.identity)
+            : left.name.localeCompare(right.name));
+    }
+    function emitAgents() {
+        if (deps.closed() || agentWatchers.size === 0)
+            return;
+        const value = agents();
+        for (const watcher of agentWatchers)
+            watcher(value);
+    }
     function setLive(conversation, next) {
         const before = stateOf(conversation);
         const began = lives.get(conversation)?.turn?.started;
@@ -261,18 +299,27 @@ export function createConversationStore(deps) {
             return;
         const { documents } = await deps.documents(declaration.locator);
         const names = new Map();
+        const retired = new Set();
         for (const document of documents) {
             if (document.type !== declaration.type)
                 continue;
             const identity = document.fields?.[declaration.identity];
             const name = document.fields?.[declaration.name];
-            if (typeof identity === 'string' && typeof name === 'string')
-                names.set(identity, name);
+            if (typeof identity !== 'string' || typeof name !== 'string')
+                continue;
+            names.set(identity, name);
+            const ended = declaration.retired === undefined ? null : document.fields?.[declaration.retired];
+            if (ended !== undefined && ended !== null)
+                retired.add(identity);
         }
-        if (JSON.stringify([...names]) === JSON.stringify([...agentNames]))
+        const named = JSON.stringify([...names]) !== JSON.stringify([...agentNames]);
+        if (!named && JSON.stringify([...retired]) === JSON.stringify([...retiredAgents]))
             return;
         agentNames = names;
-        emitList();
+        retiredAgents = retired;
+        if (named)
+            emitList();
+        emitAgents();
     }
     function agentsReady() {
         agentsRead ??= readAgents().catch(() => {
@@ -342,18 +389,15 @@ export function createConversationStore(deps) {
             const advances = read !== undefined &&
                 !behind.has(conversation) &&
                 (read === null || message.position > read);
-            const sealed = drafts.get(conversation)?.turn === message.turn;
+            await sealed(local, conversation, new Set([message.turn]));
             await local.keepMessages({
                 conversation,
                 messages: [message],
                 ...(advances ? { read: message.position } : {}),
-                sealed,
             });
             messages.set(conversation, merged(messages.get(conversation) ?? [], [message]));
             if (advances)
                 reads.set(conversation, message.position);
-            if (sealed)
-                drafts.delete(conversation);
             sealTurns(conversation, new Set([message.turn]));
             deps.publish(conversationChangeSet([{ conversation, identity: message.identity }], [conversation]));
         });
@@ -405,17 +449,14 @@ export function createConversationStore(deps) {
             if (!replicated.has(conversation))
                 return;
             const newest = arriving.reduce((top, message) => (top === null || message.position > top ? message.position : top), from ?? null);
-            const turn = drafts.get(conversation)?.turn;
-            const sealed = arriving.some((message) => message.turn === turn);
-            await local.keepMessages({ conversation, messages: arriving, read: newest, sealed });
+            const sealing = await sealed(local, conversation, new Set(arriving.map((message) => message.turn)));
+            await local.keepMessages({ conversation, messages: arriving, read: newest });
             messages.set(conversation, merged(messages.get(conversation) ?? [], arriving));
             reads.set(conversation, newest);
-            if (sealed)
-                drafts.delete(conversation);
             sealTurns(conversation, new Set(arriving.map((message) => message.turn)));
             if ((gaps.get(conversation) ?? 0) === generation)
                 behind.delete(conversation);
-            if (arriving.length > 0 || sealed) {
+            if (arriving.length > 0 || sealing) {
                 deps.publish(conversationChangeSet(arriving.map((message) => ({ conversation, identity: message.identity })), [conversation]));
             }
         });
@@ -462,22 +503,89 @@ export function createConversationStore(deps) {
         if (sealTurns(conversation, new Set([arriving.turn])))
             emit(conversation);
     }
+    async function kept(local, conversation, following) {
+        if (following === null || (unwritten(following) && following.submitted === undefined)) {
+            await local.dropChatDraft(conversation);
+            drafts.delete(conversation);
+        }
+        else {
+            await local.keepChatDraft(following);
+            drafts.set(conversation, following);
+        }
+    }
+    async function sealed(local, conversation, turns) {
+        const held = drafts.get(conversation);
+        const submitted = held?.submitted ?? [];
+        const left = submitted.filter((one) => one.turn === null || !turns.has(one.turn));
+        if (held === undefined || left.length === submitted.length)
+            return false;
+        await kept(local, conversation, withSubmitted(held, left));
+        return true;
+    }
     function withDraft(conversation, next) {
         return deps.durably(async (local) => {
             const following = next(drafts.get(conversation));
             if (following === undefined)
                 return;
-            if (following === null) {
-                await local.dropChatDraft(conversation);
-                drafts.delete(conversation);
-            }
-            else {
-                await local.keepChatDraft(following);
-                drafts.set(conversation, following);
-            }
+            await kept(local, conversation, following);
             deps.publish(conversationChangeSet([], [conversation]));
         });
     }
+    async function submitted(conversation, operation, draft) {
+        let submission;
+        await withDraft(conversation, (current) => {
+            submission = current?.submitted?.find((one) => one.operation === operation);
+            if (submission !== undefined)
+                return undefined;
+            const said = draft ?? current;
+            submission = {
+                operation,
+                text: said?.text ?? '',
+                files: [...(said?.files ?? [])],
+                turn: null,
+            };
+            return {
+                conversation,
+                ...(draft === undefined || current === undefined
+                    ? { text: '', files: [], revision: chatDraftRevision() }
+                    : { text: current.text, files: current.files, revision: current.revision }),
+                submitted: [...(current?.submitted ?? []), submission],
+            };
+        });
+        return submission;
+    }
+    async function dispatched(conversation, submission) {
+        sending.add(submission.operation);
+        try {
+            const files = await Promise.all(submission.files.map(async (file) => ({ ...(await declaredFile(file)), blob: file.blob })));
+            const result = await invoke('conversation.send', conversation, {
+                text: submission.text,
+                files,
+                operation_id: submission.operation,
+            });
+            if (result.kind === 'revoked-authorization')
+                return result;
+            if (result.kind !== 'action' && result.retryable)
+                return result;
+            const turn = turnOf(result);
+            await withDraft(conversation, (current) => {
+                const held = current?.submitted?.find((one) => one.operation === submission.operation);
+                if (current === undefined || held === undefined || held.turn !== null)
+                    return undefined;
+                const others = current.submitted.filter((one) => one !== held);
+                if (result.kind !== 'action')
+                    return returned(current, held, others);
+                const arrived = (messages.get(conversation) ?? []).some((message) => message.turn === turn);
+                return withSubmitted(current, turn === null || arrived
+                    ? others
+                    : current.submitted.map((one) => (one === held ? { ...held, turn } : one)));
+            });
+            return result;
+        }
+        finally {
+            sending.delete(submission.operation);
+        }
+    }
     function invoke(name, conversation, extra = {}) {
         return deps.call(name, { conversation, ...extra });
     }
@@ -493,41 +601,16 @@ export function createConversationStore(deps) {
         create(input) {
             return deps.call('conversation.create', input);
         },
-        async send(conversation) {
-            const draft = drafts.get(conversation);
-            const pending = draft === undefined ? undefined : { draft };
-            if (pending !== undefined) {
-                sending.set(conversation, pending);
-                deps.publish(conversationChangeSet([], [conversation]));
+        async send(conversation, operation = changeBatchIdentity(), draft) {
+            if (deps.online()) {
+                return dispatched(conversation, await submitted(conversation, operation, draft));
             }
-            try {
-                const files = await Promise.all((draft?.files ?? []).map(async (file) => ({
-                    ...(await declaredFile(file)),
-                    blob: file.blob,
-                })));
-                const result = await invoke('conversation.send', conversation, {
-                    text: draft?.text ?? '',
-                    files,
-                });
-                const turn = turnOf(result);
-                if (turn === null || draft === undefined)
-                    return result;
-                await withDraft(conversation, (current) => {
-                    if (current !== draft)
-                        return undefined;
-                    const sealed = (messages.get(conversation) ?? []).some((message) => message.turn === turn);
-                    return sealed ? null : { ...draft, turn };
-                });
-                return result;
-            }
-            finally {
-                if (pending !== undefined && sending.get(conversation) === pending) {
-                    sending.delete(conversation);
-                    if (drafts.get(conversation) === draft) {
-                        deps.publish(conversationChangeSet([], [conversation]));
-                    }
-                }
+            if (draft !== undefined) {
+                await withDraft(conversation, (current) => current?.submitted?.some((one) => one.operation === operation) === true
+                    ? undefined
+                    : returned(current ?? { conversation, text: '', files: [], revision: '' }, { operation, ...draft, turn: null }, current?.submitted ?? []));
             }
+            return OFFLINE;
         },
         answer(conversation, answer) {
             return invoke('conversation.answer', conversation, { answer });
@@ -542,7 +625,12 @@ export function createConversationStore(deps) {
             const result = await invoke('conversation.cancel', conversation, { turn });
             if (result.kind !== 'action')
                 return result;
-            await withDraft(conversation, (current) => current === undefined || current.turn !== turn ? undefined : { ...current, turn: null });
+            await withDraft(conversation, (current) => {
+                const held = current?.submitted?.find((one) => one.turn === turn);
+                if (current === undefined || held === undefined)
+                    return undefined;
+                return returned(current, held, current.submitted.filter((one) => one !== held));
+            });
             return result;
         },
         delete(conversation) {
@@ -550,16 +638,25 @@ export function createConversationStore(deps) {
         },
     };
     const chatDraft = {
-        write(conversation, draft) {
-            return withDraft(conversation, () => ({
+        write(conversation, draft, revision = chatDraftRevision()) {
+            return withDraft(conversation, (current) => ({
                 conversation,
                 text: draft.text,
                 files: [...draft.files],
-                turn: null,
+                revision,
+                ...(current?.submitted === undefined ? {} : { submitted: current.submitted }),
             }));
         },
         discard(conversation) {
-            return withDraft(conversation, (current) => (current === undefined ? undefined : null));
+            return withDraft(conversation, (current) => current === undefined
+                ? undefined
+                : {
+                    conversation,
+                    text: '',
+                    files: [],
+                    revision: chatDraftRevision(),
+                    ...pending(current),
+                });
         },
     };
     return {
@@ -605,6 +702,23 @@ export function createConversationStore(deps) {
             if (behind.size > 0)
                 progress.complete = false;
         },
+        async resend(progress) {
+            for (const [conversation, held] of [...drafts]) {
+                for (const submission of held.submitted ?? []) {
+                    if (submission.turn !== null || sending.has(submission.operation))
+                        continue;
+                    if (deps.closed())
+                        return;
+                    const result = await dispatched(conversation, submission);
+                    if (result.kind === 'revoked-authorization')
+                        return;
+                    if (result.kind === 'transport-uncertainty') {
+                        progress.reachable = false;
+                        return;
+                    }
+                }
+            }
+        },
         current() {
             return behind.size === 0;
         },
@@ -650,6 +764,16 @@ export function createConversationStore(deps) {
                 listWatchers.delete(deliver);
             };
         },
+        watchAgents(deliver) {
+            agentWatchers.add(deliver);
+            void agentsReady().then(() => {
+                if (!deps.closed() && agentWatchers.has(deliver))
+                    deliver(agents());
+            });
+            return () => {
+                agentWatchers.delete(deliver);
+            };
+        },
         changed(set) {
             for (const conversation of set.conversations)
                 emit(conversation);
@@ -697,6 +821,7 @@ export function createConversationStore(deps) {
             views.clear();
             lives.clear();
             listWatchers.clear();
+            agentWatchers.clear();
         },
     };
 }

package/dist/entry.d.ts

@@ -0,0 +1,17 @@
+import { type QueryResult } from './query.js';
+export { QueryError } from './query.js';
+export type EntryRoom = {
+    locator: string;
+    schema: string | null;
+    documents: 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, QueryResult>>;
+};
+export declare function entryScope(rooms: readonly EntryRoom[]): 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":"AAGA,OAAO,EAML,KAAK,WAAW,EAEjB,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,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;CAC7C,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;AAkCD,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,WAAW,CAAC,CAAC,CAAC;CAC3F,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,UAAU,CAqDlE"}

package/dist/entry.js

@@ -0,0 +1,156 @@
+import { attachedModel } from './attached-model.js';
+import { collectionOf, passingDocument } from './collection.js';
+import { NO_MODEL } from './model.js';
+import { invalid, planOf, plain, QueryError, } from './query.js';
+import { createReadSide } from './read-side.js';
+import { rowsOf } from './rows.js';
+export { QueryError } from './query.js';
+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,
+    $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;
+}
+export function entryRefusal(template) {
+    try {
+        planOf(sampled(template, ''), { listed: false, rooms: [] });
+        return null;
+    }
+    catch (error) {
+        if (error instanceof QueryError)
+            return error.message;
+        throw error;
+    }
+}
+export function entryScope(rooms) {
+    const readSide = createReadSide();
+    const held = [];
+    const documents = rooms.flatMap((room) => {
+        const model = attachedModel({
+            kind: 'model',
+            snapshot: { identity: room.locator, version: '', schema: room.schema, revision: null },
+        }, NO_MODEL).state;
+        held.push({
+            locator: room.locator,
+            available: model.status !== 'unavailable',
+            types: model.status === 'unavailable' ? [] : Object.values(model.types),
+        });
+        const composition = { model, selection: null };
+        const collection = collectionOf(room.documents, composition);
+        return Object.keys(room.documents)
+            .sort()
+            .map((path) => ({
+            locator: room.locator,
+            path,
+            before: [],
+            after: rowsOf(room.locator, path, passingDocument(collection, path) ?? null, composition, null, null),
+        }));
+    });
+    readSide.apply({
+        documents,
+        drafts: [],
+        rooms: [],
+        queues: [],
+        presentations: [],
+        messages: [],
+        conversations: [],
+    });
+    const planned = { listed: true, rooms: held };
+    return {
+        async results(queries) {
+            const results = {};
+            for (const [name, query] of Object.entries(queries)) {
+                results[name] = await readSide.query(planOf(query, planned));
+            }
+            return results;
+        },
+    };
+}