@agentshouse/mdruntime 0.1.0-c3903a68dcbbf → 0.1.0-c56daf494ecb4

package/dist/conversation.d.ts

@@ -1,19 +1,35 @@
-import type { ConversationAction, ConversationCards, ConversationEvent, ConversationMessage, ConversationStream, PlanStep, ProcessCommand, SessionOption, WorkingNote } 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 GrowingText = {
+export type ConversationAgent = {
+    identity: string;
+    name: string;
+};
+export type RunningTurn = {
     turn: string;
-    text: string;
+    started: string | null;
+    parts: readonly unknown[];
+    context: TurnContext | null;
 };
 export type ChatDraft = {
     text: string;
@@ -25,16 +41,16 @@ export type ConversationOptions = {
 export type ConversationView = {
     conversation: string;
     messages: readonly ConversationMessage[];
-    growingText: GrowingText | null;
-    workingNote: WorkingNote | null;
-    plan: readonly PlanStep[] | null;
+    turn: RunningTurn | null;
     questions: readonly unknown[];
     process: {
         running: boolean;
     } | null;
     commands: readonly ProcessCommand[];
     options: readonly SessionOption[];
-    chatDraft: ChatDraft | null;
+    chatDraft: (ChatDraft & {
+        readonly revision: string;
+    }) | null;
 };
 export type ConversationSurface = {
     list(): Promise<readonly ConversationEntry[]>;
@@ -48,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>;
@@ -69,11 +85,14 @@ 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;
 };
+export declare function unheldView(conversation: string): ConversationView;
 export declare function createConversationStore(deps: ConversationDependencies): ConversationStore;
 //# sourceMappingURL=conversation.d.ts.map

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,14 +1,75 @@
 import { conversationChangeSet } from './change-set.js';
+import { runtimeError } from './failure.js';
 import { declaredFile } from './file.js';
+import { chatDraftRevision } from './identity.js';
 const QUIET = {
-    growingText: null,
-    plan: null,
-    workingNote: null,
+    turn: null,
     questions: [],
     process: null,
     commands: [],
     options: [],
 };
+export function unheldView(conversation) {
+    return {
+        conversation,
+        messages: [],
+        turn: null,
+        questions: [],
+        process: null,
+        commands: [],
+        options: [],
+        chatDraft: null,
+    };
+}
+function startedTurn(turn, operation) {
+    if (operation.op === 'begin')
+        return { turn, started: operation.at, parts: [], context: null };
+    if (operation.op === 'context') {
+        return {
+            turn,
+            started: null,
+            parts: [],
+            context: { used: operation.used, window: operation.window },
+        };
+    }
+    return operation.op === 'start' && operation.index === 0
+        ? { turn, started: null, parts: [structuredClone(operation.part)], context: null }
+        : null;
+}
+function changedFields(part, operation) {
+    if (operation.op === 'append') {
+        return { text: `${String(part.text ?? '')}${operation.text}` };
+    }
+    if (operation.op === 'status') {
+        return { status: operation.status, result: structuredClone(operation.result) };
+    }
+    if (operation.op === 'count')
+        return { count: operation.count };
+    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 } };
+    }
+    if (operation.op === 'start') {
+        if (operation.index !== 0 && operation.index !== held.parts.length)
+            return null;
+        return {
+            ...held,
+            parts: [...held.parts.slice(0, operation.index), structuredClone(operation.part)],
+        };
+    }
+    const part = held.parts[operation.index];
+    if (typeof part !== 'object' || part === null)
+        return null;
+    const changed = { ...part, ...changedFields(part, operation) };
+    return {
+        ...held,
+        parts: held.parts.map((kept, at) => (at === operation.index ? changed : kept)),
+    };
+}
 function ordered(left, right) {
     if (left.position !== right.position)
         return left.position < right.position ? -1 : 1;
@@ -93,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;
 }
@@ -106,63 +167,162 @@ 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) {
         return lives.get(conversation) ?? QUIET;
     }
-    function viewOf(conversation, limit) {
+    function shownMessages(conversation, limit) {
         const held = messages.get(conversation) ?? [];
         const shown = limit === undefined ? held : held.slice(Math.max(0, held.length - limit));
+        return shown.map(({ identity, turn, text, message }) => ({
+            identity,
+            turn,
+            text,
+            message: structuredClone(message),
+        }));
+    }
+    function viewOf(conversation, limit, shown = shownMessages(conversation, limit)) {
         const draft = drafts.get(conversation);
         const facts = liveOf(conversation);
         return {
             conversation,
-            messages: shown.map(({ identity, turn, text, message }) => ({
-                identity,
-                turn,
-                text,
-                message: structuredClone(message),
-            })),
-            growingText: facts.growingText === null ? null : { ...facts.growingText },
-            workingNote: facts.workingNote === null ? null : { ...facts.workingNote },
-            plan: structuredClone(facts.plan?.plan ?? null),
+            messages: shown,
+            turn: structuredClone(facts.turn),
             questions: structuredClone(facts.questions),
             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
                 ? null
-                : { text: draft.text, files: [...draft.files] },
+                : { text: draft.text, files: [...draft.files], revision: draft.revision },
         };
     }
-    function emit(conversation) {
+    function emit(conversation, messagesChanged = true) {
         if (deps.closed())
             return;
         for (const view of views.values()) {
             if (view.conversation !== conversation)
                 continue;
+            if (messagesChanged)
+                view.messages = null;
             const ready = [...view.watchers].filter((watcher) => watcher.ready);
             if (ready.length === 0)
                 continue;
-            const value = viewOf(conversation, view.limit);
+            view.messages ??= shownMessages(conversation, view.limit);
+            const value = viewOf(conversation, view.limit, view.messages);
             for (const watcher of ready)
                 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 });
-        emit(conversation);
+        setLive(conversation, { ...liveOf(conversation), ...change });
+        emit(conversation, false);
+    }
+    function relayed(conversation, turn, operation) {
+        const held = liveOf(conversation).turn;
+        const next = held?.turn === turn ? appliedTurn(held, operation) : startedTurn(turn, operation);
+        if (next !== null)
+            live(conversation, { turn: next });
     }
     function sealTurns(conversation, turns) {
         const held = lives.get(conversation);
-        if (held === undefined)
-            return false;
-        const growingText = held.growingText !== null && turns.has(held.growingText.turn) ? null : held.growingText;
-        const plan = held.plan !== null && turns.has(held.plan.turn) ? null : held.plan;
-        if (growingText === held.growingText && plan === held.plan)
+        if (held?.turn == null || !turns.has(held.turn.turn))
             return false;
-        lives.set(conversation, { ...held, growingText, plan });
+        setLive(conversation, { ...held, turn: null });
         return true;
     }
     function handReplicated() {
@@ -176,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);
@@ -213,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));
@@ -309,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));
@@ -330,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);
@@ -406,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) {
@@ -424,6 +597,8 @@ export function createConversationStore(deps) {
         hydrate(held, stored) {
             messages.clear();
             reads.clear();
+            for (const view of views.values())
+                view.messages = null;
             for (const entry of held) {
                 messages.set(entry.conversation, [...entry.messages].sort(ordered));
                 if (entry.read !== undefined)
@@ -434,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));
@@ -467,7 +644,12 @@ export function createConversationStore(deps) {
         watch(conversation, options, deliver) {
             const limit = limitOf(options);
             const key = JSON.stringify([conversation, limit ?? null]);
-            const view = views.get(key) ?? { conversation, limit, watchers: new Set() };
+            const view = views.get(key) ?? {
+                conversation,
+                limit,
+                watchers: new Set(),
+                messages: null,
+            };
             views.set(key, view);
             const watcher = { notify: deliver, ready: false };
             view.watchers.add(watcher);
@@ -487,60 +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);
-                if (lives.delete(conversation))
-                    emit(conversation);
-                return;
-            }
-            if (event.kind === 'growing-text') {
-                live(conversation, { growingText: { turn: event.turn, text: event.text } });
-                return;
-            }
-            if (event.kind === 'plan') {
-                live(conversation, { plan: { turn: event.turn, plan: structuredClone(event.plan) } });
-                return;
-            }
-            if (event.kind === 'working-note') {
-                live(conversation, {
-                    workingNote: event.note === null ? null : { noteId: event.note.noteId, text: event.note.text },
-                });
-                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 })));
@@ -552,6 +735,8 @@ export function createConversationStore(deps) {
         close() {
             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"}