@agentshouse/mdruntime 0.1.0-cc7bd7a53214e → 0.1.0-cd3486bd400ed

package/dist/conversation.d.ts

@@ -1,18 +1,33 @@
-import type { ConversationAction, ConversationCards, ConversationEvent, ConversationMessage, ConversationStream, ProcessCommand, SessionOption, TurnContext } from './adapter.js';
+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 { Open } from './open.js';
 import type { CallResult } from './outcome.js';
-import type { DocumentResult, QueryDocument } from './query.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 = Open<'working' | 'asking' | 'idle'>;
 export type ConversationEntry = {
     conversation: string;
-    card: Required<QueryDocument>;
-    agent: Required<QueryDocument> | null;
+    agent: {
+        identity: string;
+        name: string | null;
+    };
+    name: string;
+    created: string;
+    finished: string | null;
+    outcome: string | null;
+    state: ConversationState;
+    started: string | null;
+};
+export type ConversationAgent = {
+    identity: string;
+    name: string;
 };
 export type RunningTurn = {
     turn: string;
+    started: string | null;
     parts: readonly unknown[];
     context: TurnContext | null;
 };
@@ -33,7 +48,9 @@ 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[]>;
@@ -47,11 +64,11 @@ 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 = {
-    cards(): ConversationCards | undefined;
+    agents(): ConversationAgents | undefined;
     documents(locator: string): Promise<DocumentResult>;
     call(name: ConversationAction, input: unknown): Promise<CallResult>;
     durably<T>(work: (local: RuntimeStore) => Promise<T>): Promise<T>;
@@ -68,8 +85,10 @@ export type ConversationStore = {
     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): void;
+    receive(event: ConversationEvent): boolean;
     messages(): readonly SearchedMessage[];
     message(conversation: string, identity: string): SearchedMessage | null;
     close(): void;

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,7 @@
 import { conversationChangeSet } from './change-set.js';
+import { runtimeError } from './failure.js';
 import { declaredFile } from './file.js';
+import { chatDraftRevision } from './identity.js';
 const QUIET = {
     turn: null,
     questions: [],
@@ -20,11 +22,18 @@ export function unheldView(conversation) {
     };
 }
 function startedTurn(turn, operation) {
+    if (operation.op === 'begin')
+        return { turn, started: operation.at, parts: [], context: null };
     if (operation.op === 'context') {
-        return { turn, parts: [], context: { used: operation.used, window: operation.window } };
+        return {
+            turn,
+            started: null,
+            parts: [],
+            context: { used: operation.used, window: operation.window },
+        };
     }
     return operation.op === 'start' && operation.index === 0
-        ? { turn, parts: [structuredClone(operation.part)], context: null }
+        ? { turn, started: null, parts: [structuredClone(operation.part)], context: null }
         : null;
 }
 function changedFields(part, operation) {
@@ -39,6 +48,8 @@ function changedFields(part, operation) {
     return { entries: structuredClone(operation.entries) };
 }
 function appliedTurn(held, operation) {
+    if (operation.op === 'begin')
+        return { ...held, started: operation.at };
     if (operation.op === 'context') {
         return { ...held, context: { used: operation.used, window: operation.window } };
     }
@@ -143,7 +154,7 @@ 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;
 }
@@ -156,6 +167,13 @@ export function createConversationStore(deps) {
     const gaps = new Map();
     const lives = new Map();
     const views = new Map();
+    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;
     function liveOf(conversation) {
@@ -184,7 +202,7 @@ export function createConversationStore(deps) {
             options: structuredClone(facts.options),
             chatDraft: draft === undefined || draft.turn !== null || sending.get(conversation)?.draft === draft
                 ? null
-                : { text: draft.text, files: [...draft.files] },
+                : { text: draft.text, files: [...draft.files], revision: draft.revision },
         };
     }
     function emit(conversation, messagesChanged = true) {
@@ -204,8 +222,94 @@ export function createConversationStore(deps) {
                 watcher.notify(value);
         }
     }
+    function stateOf(conversation) {
+        const facts = liveOf(conversation);
+        if (facts.questions.length > 0)
+            return 'asking';
+        return facts.turn === null ? 'idle' : 'working';
+    }
+    function entries() {
+        return [...listing.values()].map((entry) => ({
+            conversation: entry.conversation,
+            agent: { identity: entry.agent, name: agentNames.get(entry.agent) ?? null },
+            name: entry.name,
+            created: entry.created,
+            finished: entry.finished,
+            outcome: entry.outcome,
+            state: stateOf(entry.conversation),
+            started: lives.get(entry.conversation)?.turn?.started ?? null,
+        }));
+    }
+    function emitList() {
+        if (deps.closed() || listWatchers.size === 0)
+            return;
+        const value = entries();
+        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;
+        if (next === null)
+            lives.delete(conversation);
+        else
+            lives.set(conversation, next);
+        if (!listing.has(conversation))
+            return;
+        if (stateOf(conversation) !== before || next?.turn?.started !== began)
+            emitList();
+    }
+    async function readAgents() {
+        const declaration = deps.agents();
+        if (declaration === undefined)
+            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')
+                continue;
+            names.set(identity, name);
+            const ended = declaration.retired === undefined ? null : document.fields?.[declaration.retired];
+            if (ended !== undefined && ended !== null)
+                retired.add(identity);
+        }
+        const named = JSON.stringify([...names]) !== JSON.stringify([...agentNames]);
+        if (!named && JSON.stringify([...retired]) === JSON.stringify([...retiredAgents]))
+            return;
+        agentNames = names;
+        retiredAgents = retired;
+        if (named)
+            emitList();
+        emitAgents();
+    }
+    function agentsReady() {
+        agentsRead ??= readAgents().catch(() => {
+            agentsRead = null;
+        });
+        return agentsRead;
+    }
     function live(conversation, change) {
-        lives.set(conversation, { ...liveOf(conversation), ...change });
+        setLive(conversation, { ...liveOf(conversation), ...change });
         emit(conversation, false);
     }
     function relayed(conversation, turn, operation) {
@@ -218,7 +322,7 @@ export function createConversationStore(deps) {
         const held = lives.get(conversation);
         if (held?.turn == null || !turns.has(held.turn.turn))
             return false;
-        lives.set(conversation, { ...held, turn: null });
+        setLive(conversation, { ...held, turn: null });
         return true;
     }
     function handReplicated() {
@@ -232,27 +336,6 @@ export function createConversationStore(deps) {
         handedReplicated = named;
         stream.replicate(held);
     }
-    async function documented() {
-        const declaration = deps.cards();
-        if (declaration === undefined)
-            return [];
-        const { documents } = await deps.documents(declaration.locator);
-        return documents.filter((document) => typeof document.type === 'string');
-    }
-    function carded(documents) {
-        const declaration = deps.cards();
-        if (declaration === undefined)
-            return [];
-        const cards = [];
-        for (const card of documents) {
-            if (card.type !== declaration.type)
-                continue;
-            const identity = card.fields[declaration.identity];
-            if (typeof identity === 'string')
-                cards.push({ conversation: identity, card });
-        }
-        return cards;
-    }
     async function remove(leaving) {
         await deps.durably(async (local) => {
             await local.dropConversations(leaving);
@@ -269,7 +352,7 @@ export function createConversationStore(deps) {
                 reads.delete(conversation);
                 drafts.delete(conversation);
                 behind.delete(conversation);
-                lives.delete(conversation);
+                setLive(conversation, null);
             }
             if (changed.length > 0)
                 deps.publish(conversationChangeSet(removed, changed));
@@ -365,6 +448,48 @@ export function createConversationStore(deps) {
             }
         });
     }
+    function heard(event) {
+        const { conversation } = event;
+        if (event.kind === 'gap') {
+            if (replicated.has(conversation))
+                gap(conversation);
+            const held = lives.get(conversation);
+            if (held === undefined)
+                return;
+            setLive(conversation, { ...QUIET, turn: held.turn });
+            emit(conversation, false);
+            return;
+        }
+        if (event.kind === 'turn') {
+            relayed(conversation, event.turn, event.operation);
+            return;
+        }
+        if (event.kind === 'questions') {
+            live(conversation, { questions: structuredClone(event.questions) });
+            return;
+        }
+        if (event.kind === 'process') {
+            live(conversation, { process: { running: event.running } });
+            return;
+        }
+        if (event.kind === 'commands') {
+            live(conversation, { commands: structuredClone(event.commands) });
+            return;
+        }
+        if (event.kind === 'options') {
+            live(conversation, { options: structuredClone(event.options) });
+            return;
+        }
+        const arriving = acceptedMessage(event.message);
+        if (arriving === null)
+            return;
+        if (replicated.has(conversation)) {
+            void keep(conversation, arriving).catch(() => { });
+            return;
+        }
+        if (sealTurns(conversation, new Set([arriving.turn])))
+            emit(conversation);
+    }
     function withDraft(conversation, next) {
         return deps.durably(async (local) => {
             const following = next(drafts.get(conversation));
@@ -386,17 +511,8 @@ export function createConversationStore(deps) {
     }
     const surface = {
         async list() {
-            const declaration = deps.cards();
-            if (declaration === undefined)
-                return [];
-            const documents = await documented();
-            const entries = carded(documents).map(({ conversation, card }) => ({
-                conversation,
-                card,
-                agent: documents.find((document) => document.backlinks.some((backlink) => backlink.path === card.path && backlink.field === declaration.agent)) ?? null,
-            }));
-            entries.sort((left, right) => (left.conversation < right.conversation ? -1 : 1));
-            return entries;
+            await agentsReady();
+            return entries();
         },
         async read(conversation, options = {}) {
             const limit = limitOf(options);
@@ -462,12 +578,13 @@ export function createConversationStore(deps) {
         },
     };
     const chatDraft = {
-        write(conversation, draft) {
+        write(conversation, draft, revision = chatDraftRevision()) {
             return withDraft(conversation, () => ({
                 conversation,
                 text: draft.text,
                 files: [...draft.files],
                 turn: null,
+                revision,
             }));
         },
         discard(conversation) {
@@ -492,7 +609,9 @@ export function createConversationStore(deps) {
                 drafts.set(record.conversation, record);
         },
         async reconcile() {
-            const named = new Set(carded(await documented()).map((entry) => entry.conversation));
+            if (!listKnown)
+                return;
+            const named = new Set(listing.keys());
             const leaving = [
                 ...new Set([...replicated, ...messages.keys(), ...reads.keys(), ...drafts.keys()]),
             ].filter((conversation) => !named.has(conversation));
@@ -550,53 +669,61 @@ export function createConversationStore(deps) {
                     views.delete(key);
             };
         },
+        watchList(deliver) {
+            listWatchers.add(deliver);
+            void agentsReady().then(() => {
+                if (!deps.closed() && listWatchers.has(deliver))
+                    deliver(entries());
+            });
+            return () => {
+                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);
+            const declaration = deps.agents();
+            if (declaration !== undefined &&
+                set.documents.some((change) => change.locator === declaration.locator)) {
+                agentsRead = readAgents().catch(() => {
+                    agentsRead = null;
+                });
+            }
         },
         receive(event) {
             if (deps.closed())
-                return;
-            const { conversation } = event;
-            if (event.kind === 'gap') {
-                if (replicated.has(conversation))
-                    gap(conversation);
-                const held = lives.get(conversation);
-                if (held === undefined)
-                    return;
-                lives.set(conversation, { ...QUIET, turn: held.turn });
-                emit(conversation, false);
-                return;
-            }
-            if (event.kind === 'turn') {
-                relayed(conversation, event.turn, event.operation);
-                return;
-            }
-            if (event.kind === 'questions') {
-                live(conversation, { questions: structuredClone(event.questions) });
-                return;
-            }
-            if (event.kind === 'process') {
-                live(conversation, { process: { running: event.running } });
-                return;
-            }
-            if (event.kind === 'commands') {
-                live(conversation, { commands: structuredClone(event.commands) });
-                return;
-            }
-            if (event.kind === 'options') {
-                live(conversation, { options: structuredClone(event.options) });
-                return;
-            }
-            const arriving = acceptedMessage(event.message);
-            if (arriving === null)
-                return;
-            if (replicated.has(conversation)) {
-                void keep(conversation, arriving).catch(() => { });
-                return;
+                return false;
+            if (event.kind === 'list' || event.kind === 'listed' || event.kind === 'unlisted') {
+                if (event.kind === 'list') {
+                    listing.clear();
+                    for (const entry of event.entries)
+                        listing.set(entry.conversation, { ...entry });
+                    listKnown = true;
+                }
+                else if (event.kind === 'listed') {
+                    listing.set(event.entry.conversation, { ...event.entry });
+                }
+                else {
+                    listing.delete(event.conversation);
+                }
+                emitList();
+                return (event.kind !== 'list' &&
+                    listKnown &&
+                    (listing.size !== replicated.size ||
+                        [...listing.keys()].some((conversation) => !replicated.has(conversation))));
             }
-            if (sealTurns(conversation, new Set([arriving.turn])))
-                emit(conversation);
+            heard(event);
+            return false;
         },
         messages() {
             return [...messages].flatMap(([conversation, held]) => held.map(({ identity, text }) => ({ conversation, identity, text })));
@@ -608,6 +735,8 @@ export function createConversationStore(deps) {
         close() {
             views.clear();
             lives.clear();
+            listWatchers.clear();
+            agentWatchers.clear();
         },
     };
 }

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/host.d.ts

@@ -15,5 +15,6 @@ export type MdRuntimeHost = {
 };
 export declare function serveMdRuntime(options: MdRuntimeHostOptions): MdRuntimeHost;
 export type { PortReach, ReachedDocument } from './reach.js';
+export { STORE_SCHEMA } from './store.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;AAGzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAML,KAAK,WAAW,EAOjB,MAAM,WAAW,CAAC;AAInB,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,IAAI,IAAI,CAAC;IACf,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAC1F,gBAAgB,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,CA+H3E;AAED,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,OAAO,EAGL,KAAK,WAAW,EAOjB,MAAM,WAAW,CAAC;AAInB,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,IAAI,IAAI,CAAC;IACf,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAC1F,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB,CAAC;AA8EF,wBAAgB,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAkH3E;AAED,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}