@mcoda/codali 0.1.134 → 0.1.135-codali.4

package/dist/docdex/DocdexClient.d.ts

@@ -1,5 +1,10 @@
 import type { DocdexCapabilitySnapshot } from "../cognitive/Types.js";
 export interface DocdexClientOptions {
+    /** Trusted host accounting hook; each retrieval HTTP attempt reserves before dispatch. */
+    beforeRequest?: (url: string) => void | Promise<void>;
+    signal?: () => AbortSignal | undefined;
+    timeoutMs?: number;
+    localSearchOnly?: boolean;
     baseUrl: string;
     repoRoot?: string;
     repoId?: string;
@@ -15,7 +20,7 @@ export interface DocdexClientOptions {
     dagSessionId?: string;
 }
 export type DocdexRuntimeErrorCode = "missing_credentials" | "repo_access_denied" | "scope_denied" | "encrypted_operation_disabled" | "docdex_context_missing" | "docdex_api_key_missing" | "docdex_operation_not_allowed" | "docdex_auth_failed" | "docdex_repo_access_denied" | "docdex_unavailable";
-export type DocdexRuntimeOperation = "health" | "initialize" | "search" | "snippet" | "open" | "symbols" | "ast" | "impact_graph" | "impact_diagnostics" | "dag_export" | "tree" | "memory_save" | "memory_recall" | "profile_read" | "profile_write" | "web_research" | "chat_context" | "rerank" | "batch_search" | "capabilities" | "stats" | "files" | "repo_inspect" | "index_rebuild" | "index_ingest" | "delegate" | "hooks_validate";
+export type DocdexRuntimeOperation = "health" | "initialize" | "search" | "snippet" | "open" | "symbols" | "ast" | "impact_graph" | "impact_diagnostics" | "dag_export" | "tree" | "memory_save" | "memory_recall" | "wakeup" | "diary_read" | "diary_write" | "conversation_read" | "conversation_search" | "kg_query" | "profile_read" | "profile_write" | "web_research" | "chat_context" | "rerank" | "batch_search" | "capabilities" | "stats" | "files" | "repo_inspect" | "index_rebuild" | "index_ingest" | "delegate" | "hooks_validate";
 export interface DocdexRuntimeErrorOptions {
     status?: number;
     retryable?: boolean;
@@ -114,7 +119,10 @@ export declare class DocdexClient {
     private healthChecked;
     private repoInitializeAttempted;
     private capabilitySnapshot?;
+    private mcpSessionId?;
+    private mcpInitialize?;
     constructor(options: DocdexClientOptions);
+    private fetch;
     setRepoId(repoId: string): void;
     getRepoId(): string | undefined;
     getRepoRoot(): string | undefined;
@@ -145,6 +153,8 @@ export declare class DocdexClient {
     }>;
     private initializeRepo;
     private ensureRepoInitialized;
+    /** Wait locally for a warming index instead of paying for model polling. */
+    waitForIndex(timeoutMs?: number, onProgress?: (status: string) => void): Promise<unknown>;
     private withRepoId;
     private extractErrorCode;
     private mapResponseErrorCode;
@@ -162,6 +172,7 @@ export declare class DocdexClient {
     delegate(payload: Record<string, unknown>): Promise<unknown>;
     chatContext(messages: DocdexChatMessage[], options?: DocdexChatContextOptions): Promise<unknown>;
     dagExport(sessionId: string, options?: DocdexDagOptions): Promise<unknown>;
+    private ensureMcpSession;
     callMcp<T>(method: string, params: Record<string, unknown>): Promise<T>;
     private normalizeMcpResult;
     private tryParseJson;
@@ -176,6 +187,12 @@ export declare class DocdexClient {
     repoInspect(): Promise<unknown>;
     memorySave(text: string, metadata?: DocdexWriteMetadata): Promise<unknown>;
     memoryRecall(query: string, topK?: number): Promise<unknown>;
+    wakeup(query: string, agentId?: string, maxTokens?: number): Promise<unknown>;
+    diaryRead(limit?: number): Promise<unknown>;
+    diaryWrite(content: string): Promise<unknown>;
+    conversationSearch(query: string, limit?: number): Promise<unknown>;
+    conversationRead(sessionId: string): Promise<unknown>;
+    knowledgeQuery(query: string, limit?: number): Promise<unknown>;
     tree(options?: DocdexTreeOptions): Promise<unknown>;
     openFile(pathValue: string, options?: DocdexOpenFileOptions): Promise<unknown>;
     getProfile(agentId?: string): Promise<unknown>;

package/dist/docdex/DocdexClient.d.ts.map

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

package/dist/docdex/DocdexClient.js

@@ -1,5 +1,6 @@
 import { randomUUID } from "node:crypto";
 import path from "node:path";
+import { setTimeout as delay } from "node:timers/promises";
 import { pathToFileURL } from "node:url";
 import { mswarmClientProductHeaders } from "@mcoda/shared";
 export class DocdexRuntimeError extends Error {
@@ -45,6 +46,12 @@ const DOCDEX_RUNTIME_OPERATIONS = new Set([
     "tree",
     "memory_save",
     "memory_recall",
+    "wakeup",
+    "diary_read",
+    "diary_write",
+    "conversation_read",
+    "conversation_search",
+    "kg_query",
     "profile_read",
     "profile_write",
     "web_research",
@@ -68,6 +75,12 @@ const MCP_OPERATION_BY_METHOD = {
     docdex_repo_inspect: "repo_inspect",
     docdex_memory_save: "memory_save",
     docdex_memory_recall: "memory_recall",
+    docdex_wakeup: "wakeup",
+    docdex_diary_read: "diary_read",
+    docdex_diary_write: "diary_write",
+    docdex_conversation_read: "conversation_read",
+    docdex_conversation_search: "conversation_search",
+    docdex_kg_query: "kg_query",
     docdex_tree: "tree",
     docdex_open: "open",
     docdex_get_profile: "profile_read",
@@ -147,6 +160,14 @@ export class DocdexClient {
         this.repoId = options.repoId;
         this.dagSessionId = options.dagSessionId;
     }
+    async fetch(input, init = {}) {
+        const signals = [init.signal, this.options.signal?.(), AbortSignal.timeout(this.options.timeoutMs ?? 60000)].filter((signal) => !!signal);
+        const signal = AbortSignal.any(signals);
+        signal.throwIfAborted();
+        await this.options.beforeRequest?.(input);
+        signal.throwIfAborted();
+        return globalThis.fetch(input, { ...init, signal, redirect: "error" });
+    }
     setRepoId(repoId) {
         this.repoId = repoId;
     }
@@ -352,7 +373,7 @@ export class DocdexClient {
         }
         let response;
         try {
-            response = await fetch(`${this.resolveBaseUrl()}/healthz`);
+            response = await this.fetch(`${this.resolveBaseUrl()}/healthz`);
         }
         catch (error) {
             throw this.runtimeError("docdex_unavailable", `Docdex health check failed: ${error instanceof Error ? error.message : String(error)}`, { retryable: true });
@@ -366,7 +387,7 @@ export class DocdexClient {
     }
     async initializeRepo(rootUri) {
         await this.ensureHealth();
-        const response = await fetch(`${this.resolveBaseUrl()}/v1/initialize`, {
+        const response = await this.fetch(`${this.resolveBaseUrl()}/v1/initialize`, {
             method: "POST",
             headers: this.buildHeaders(),
             body: JSON.stringify({ rootUri }),
@@ -395,6 +416,31 @@ export class DocdexClient {
             // Single-repo daemons can still accept repo_root without a prior initialize.
         }
     }
+    /** Wait locally for a warming index instead of paying for model polling. */
+    async waitForIndex(timeoutMs = 30000, onProgress) {
+        if (this.isEncryptedSearchGateway())
+            return { managed: true };
+        this.assertOperationAllowed("stats");
+        const deadline = Date.now() + timeoutMs;
+        await this.ensureHealth();
+        await this.ensureRepoInitialized();
+        while (Date.now() < deadline) {
+            this.options.signal?.()?.throwIfAborted();
+            const response = await this.fetch(`${this.resolveBaseUrl()}/v1/index/status`, {
+                headers: this.buildHeaders(), signal: AbortSignal.timeout(Math.max(1, deadline - Date.now())),
+            });
+            if (!response.ok)
+                await this.throwResponseError(response, "index readiness");
+            const status = await response.json();
+            if (status.ready === true && status.indexing_in_progress !== true)
+                return status;
+            if (status.status === "failed")
+                throw this.runtimeError("docdex_unavailable", "Repository indexing failed; inspect Docdex diagnostics", { retryable: false });
+            onProgress?.(status.status ?? "indexing");
+            await delay(Math.min(1000, Math.max(1, deadline - Date.now())), undefined, { signal: this.options.signal?.() });
+        }
+        throw this.runtimeError("docdex_unavailable", "Repository index did not become ready within the bounded wait; inspect Docdex health and memory pressure", { retryable: false });
+    }
     withRepoId(params) {
         if (this.repoId)
             params.set("repo_id", this.repoId);
@@ -465,6 +511,9 @@ export class DocdexClient {
         return undefined;
     }
     attachResponseMetadata(payload, response, operation) {
+        if (payload && typeof payload === "object" && !Array.isArray(payload) && payload.error) {
+            this.throwResponseBodyError(response.status, JSON.stringify(payload), operation, this.responseRequestId(response));
+        }
         const headerRequestId = this.responseRequestId(response);
         if (!headerRequestId || !payload || typeof payload !== "object" || Array.isArray(payload)) {
             return payload;
@@ -500,13 +549,15 @@ export class DocdexClient {
         });
     }
     async search(query, options = {}) {
+        if (this.options.localSearchOnly && options.forceWeb)
+            throw new Error("Use the separately authorized web research tool");
         this.assertOperationAllowed("search");
         await this.ensureHealth();
         await this.ensureRepoInitialized();
         const dagSessionId = options.dagSessionId ?? this.dagSessionId;
         const executeSearch = (searchQuery) => {
             if (this.isEncryptedSearchGateway()) {
-                return fetch(`${this.resolveBaseUrl()}/search`, {
+                return this.fetch(`${this.resolveBaseUrl()}/search`, {
                     method: "POST",
                     headers: this.buildHeaders(dagSessionId),
                     body: JSON.stringify({
@@ -517,6 +568,8 @@ export class DocdexClient {
                 });
             }
             const params = new URLSearchParams({ q: searchQuery });
+            if (this.options.localSearchOnly)
+                params.set("repo_only", "true");
             if (options.limit !== undefined)
                 params.set("limit", String(options.limit));
             if (dagSessionId)
@@ -526,7 +579,7 @@ export class DocdexClient {
                 params.set("skip_local_search", "true");
             }
             this.withRepoId(params);
-            return fetch(`${this.resolveBaseUrl()}/search?${params.toString()}`, {
+            return this.fetch(`${this.resolveBaseUrl()}/search?${params.toString()}`, {
                 headers: this.buildHeaders(dagSessionId),
             });
         };
@@ -584,7 +637,7 @@ export class DocdexClient {
         if (options.query)
             params.set("q", options.query);
         this.withRepoId(params);
-        const response = await fetch(`${this.resolveBaseUrl()}/snippet/${encodeURIComponent(docId)}?${params.toString()}`, {
+        const response = await this.fetch(`${this.resolveBaseUrl()}/snippet/${encodeURIComponent(docId)}?${params.toString()}`, {
             headers: this.buildHeaders(),
         });
         if (!response.ok) {
@@ -608,7 +661,7 @@ export class DocdexClient {
         if (options.edgeTypes?.length)
             params.set("edge_types", options.edgeTypes.join(","));
         this.withRepoId(params);
-        const response = await fetch(`${this.resolveBaseUrl()}/v1/graph/impact?${params.toString()}`, {
+        const response = await this.fetch(`${this.resolveBaseUrl()}/v1/graph/impact?${params.toString()}`, {
             headers: this.buildHeaders(),
         });
         if (!response.ok) {
@@ -628,7 +681,7 @@ export class DocdexClient {
         if (options.offset !== undefined)
             params.set("offset", String(options.offset));
         this.withRepoId(params);
-        const response = await fetch(`${this.resolveBaseUrl()}/v1/graph/impact/diagnostics?${params.toString()}`, {
+        const response = await this.fetch(`${this.resolveBaseUrl()}/v1/graph/impact/diagnostics?${params.toString()}`, {
             headers: this.buildHeaders(),
         });
         if (!response.ok) {
@@ -639,7 +692,7 @@ export class DocdexClient {
     async indexRebuild(libsSources) {
         this.assertOperationAllowed("index_rebuild");
         await this.ensureHealth();
-        const response = await fetch(`${this.resolveBaseUrl()}/v1/index/rebuild`, {
+        const response = await this.fetch(`${this.resolveBaseUrl()}/v1/index/rebuild`, {
             method: "POST",
             headers: this.buildHeaders(),
             body: JSON.stringify(libsSources ? { libs_sources: libsSources } : {}),
@@ -652,10 +705,17 @@ export class DocdexClient {
     async indexIngest(file) {
         this.assertOperationAllowed("index_ingest");
         await this.ensureHealth();
-        const response = await fetch(`${this.resolveBaseUrl()}/v1/index/ingest`, {
+        await this.ensureRepoInitialized();
+        // The HTTP ingest endpoint resolves filesystem paths against the daemon cwd.
+        // Send an absolute path bound to this client, never that incidental cwd.
+        const root = this.options.repoRoot ? path.resolve(this.options.repoRoot) : undefined;
+        const target = root ? path.resolve(root, file) : file;
+        if (root && !target.startsWith(`${root}${path.sep}`))
+            throw new Error("Index path escapes the bound repository");
+        const response = await this.fetch(`${this.resolveBaseUrl()}/v1/index/ingest`, {
             method: "POST",
             headers: this.buildHeaders(),
-            body: JSON.stringify({ file }),
+            body: JSON.stringify({ file: target }),
         });
         if (!response.ok) {
             await this.throwResponseError(response, "index ingest");
@@ -665,7 +725,7 @@ export class DocdexClient {
     async hooksValidate(files) {
         this.assertOperationAllowed("hooks_validate");
         await this.ensureHealth();
-        const response = await fetch(`${this.resolveBaseUrl()}/v1/hooks/validate`, {
+        const response = await this.fetch(`${this.resolveBaseUrl()}/v1/hooks/validate`, {
             method: "POST",
             headers: this.buildHeaders(),
             body: JSON.stringify({ files }),
@@ -678,7 +738,7 @@ export class DocdexClient {
     async delegate(payload) {
         this.assertOperationAllowed("delegate");
         await this.ensureHealth();
-        const response = await fetch(`${this.resolveBaseUrl()}/v1/delegate`, {
+        const response = await this.fetch(`${this.resolveBaseUrl()}/v1/delegate`, {
             method: "POST",
             headers: this.buildHeaders(),
             body: JSON.stringify(payload),
@@ -704,7 +764,7 @@ export class DocdexClient {
             body.temperature = options.temperature;
         if (options.docdex)
             body.docdex = options.docdex;
-        const response = await fetch(`${this.resolveBaseUrl()}/v1/chat/completions`, {
+        const response = await this.fetch(`${this.resolveBaseUrl()}/v1/chat/completions`, {
             method: "POST",
             headers: this.buildHeaders(this.dagSessionId),
             body: JSON.stringify(body),
@@ -724,7 +784,7 @@ export class DocdexClient {
         if (options.maxNodes !== undefined)
             params.set("max_nodes", String(options.maxNodes));
         this.withRepoId(params);
-        const response = await fetch(`${this.resolveBaseUrl()}/v1/dag/export?${params.toString()}`, {
+        const response = await this.fetch(`${this.resolveBaseUrl()}/v1/dag/export?${params.toString()}`, {
             headers: this.buildHeaders(),
         });
         const body = await response.text();
@@ -750,24 +810,58 @@ export class DocdexClient {
         }
         return body;
     }
+    async ensureMcpSession() {
+        if (!this.options.authToken || this.options.apiKey || this.mcpSessionId)
+            return;
+        if (!this.mcpInitialize) {
+            this.mcpInitialize = (async () => {
+                const response = await this.fetch(`${this.resolveBaseUrl()}/v1/mcp`, {
+                    method: "POST", headers: this.buildHeaders(),
+                    body: JSON.stringify({ jsonrpc: "2.0", id: randomUUID(), method: "initialize", params: {
+                            protocolVersion: "2024-11-05", capabilities: {}, clientInfo: { name: "codali", version: "1" },
+                            auth_token: this.options.authToken,
+                            ...(this.options.repoRoot ? { rootUri: pathToFileURL(path.resolve(this.options.repoRoot)).toString() } : {}),
+                        } }),
+                });
+                if (!response.ok)
+                    await this.throwResponseError(response, "MCP initialize");
+                const payload = await response.json();
+                if (payload.error)
+                    throw this.runtimeError("docdex_auth_failed", payload.error.message ?? "MCP authentication failed", { retryable: false });
+                const sessionId = response.headers.get("mcp-session-id") ?? response.headers.get("x-docdex-mcp-session");
+                if (!sessionId)
+                    throw this.runtimeError("docdex_unavailable", "Docdex did not issue an authenticated MCP session", { retryable: false });
+                this.mcpSessionId = sessionId;
+            })();
+        }
+        try {
+            await this.mcpInitialize;
+        }
+        finally {
+            this.mcpInitialize = undefined;
+        }
+    }
     async callMcp(method, params) {
         const operation = MCP_OPERATION_BY_METHOD[method];
         if (operation) {
             this.assertOperationAllowed(operation);
         }
         await this.ensureHealth();
+        await this.ensureMcpSession();
         const payload = {
             jsonrpc: "2.0",
             id: randomUUID(),
             method,
             params,
         };
-        const response = await fetch(`${this.resolveBaseUrl()}/v1/mcp`, {
+        const response = await this.fetch(`${this.resolveBaseUrl()}/v1/mcp`, {
             method: "POST",
-            headers: this.buildHeaders(),
+            headers: { ...this.buildHeaders(), ...(this.mcpSessionId ? { "mcp-session-id": this.mcpSessionId } : {}) },
             body: JSON.stringify(payload),
         });
         if (!response.ok) {
+            if (response.status === 404)
+                this.mcpSessionId = undefined;
             await this.throwResponseError(response, "MCP");
         }
         const raw = (await response.json());
@@ -785,6 +879,10 @@ export class DocdexClient {
         if (!payload || typeof payload !== "object")
             return payload;
         const record = payload;
+        if (record.isError === true) {
+            const body = JSON.stringify(record.structuredContent ?? record.content ?? "Docdex tool failed");
+            throw this.runtimeError(this.mapResponseErrorCode(500, body), body.slice(0, 4000), { retryable: false });
+        }
         if (record.structuredContent !== undefined) {
             return record.structuredContent;
         }
@@ -910,6 +1008,24 @@ export class DocdexClient {
     memoryRecall(query, topK) {
         return this.callMcp("docdex_memory_recall", this.buildProjectParams({ query, top_k: topK }));
     }
+    wakeup(query, agentId = "codali-terminal", maxTokens = 1500) {
+        return this.callMcp("docdex_wakeup", this.buildProjectParams({ query, agent_id: agentId, max_tokens: maxTokens }));
+    }
+    diaryRead(limit = 5) {
+        return this.callMcp("docdex_diary_read", this.buildProjectParams({ agent_id: "codali-terminal", limit }));
+    }
+    diaryWrite(content) {
+        return this.callMcp("docdex_diary_write", this.buildProjectParams({ agent_id: "codali-terminal", content, entry_type: "handoff" }));
+    }
+    conversationSearch(query, limit = 5) {
+        return this.callMcp("docdex_conversation_search", this.buildProjectParams({ query, limit }));
+    }
+    conversationRead(sessionId) {
+        return this.callMcp("docdex_conversation_read", this.buildProjectParams({ session_id: sessionId }));
+    }
+    knowledgeQuery(query, limit = 5) {
+        return this.callMcp("docdex_kg_query", this.buildProjectParams({ query, limit }));
+    }
     tree(options = {}) {
         return this.callMcp("docdex_tree", this.buildProjectParams({
             path: options.path,
@@ -959,7 +1075,7 @@ export class DocdexClient {
         await this.ensureHealth();
         await this.ensureRepoInitialized();
         if (this.isEncryptedSearchGateway()) {
-            const response = await fetch(`${this.resolveBaseUrl()}/web/search`, {
+            const response = await this.fetch(`${this.resolveBaseUrl()}/web/search`, {
                 method: "POST",
                 headers: this.buildHeaders(this.dagSessionId),
                 body: JSON.stringify({
@@ -985,7 +1101,7 @@ export class DocdexClient {
             params.set("no_cache", String(options.noCache));
         }
         this.withRepoId(params);
-        const response = await fetch(`${this.resolveBaseUrl()}/search?${params.toString()}`, {
+        const response = await this.fetch(`${this.resolveBaseUrl()}/search?${params.toString()}`, {
             headers: this.buildHeaders(this.dagSessionId),
         });
         if (!response.ok) {
@@ -1004,7 +1120,7 @@ export class DocdexClient {
         if (this.isEncryptedSearchGateway()) {
             this.assertOperationAllowed("batch_search");
             await this.ensureHealth();
-            const response = await fetch(`${this.resolveBaseUrl()}/search`, {
+            const response = await this.fetch(`${this.resolveBaseUrl()}/search`, {
                 method: "POST",
                 headers: this.buildHeaders(this.dagSessionId),
                 body: JSON.stringify({

package/dist/docdex/ManagedDocdex.d.ts

@@ -0,0 +1,29 @@
+import type { Provider } from "../providers/ProviderTypes.js";
+import { ConfiguredEmbeddings } from "../providers/ConfiguredEmbeddings.js";
+import { DocdexClient } from "./DocdexClient.js";
+/** A private Docdex process whose inference is routed through the owning controller. */
+export declare class ManagedDocdex {
+    private readonly options;
+    private child?;
+    private bridge?;
+    private launchDirectory?;
+    private abort?;
+    private diagnostic;
+    private activeRequests;
+    private readonly lifetime;
+    constructor(options: {
+        workspaceRoot: string;
+        stateRoot: string;
+        embeddings: ConfiguredEmbeddings;
+        provider: Provider;
+        binary?: string;
+        binarySha256?: string;
+        signal?: AbortSignal;
+        allowWeb?: boolean;
+        startupTimeoutMs?: number;
+        onStatus?: (status: string) => void;
+    });
+    start(): Promise<DocdexClient>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=ManagedDocdex.d.ts.map

package/dist/docdex/ManagedDocdex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManagedDocdex.d.ts","sourceRoot":"","sources":["../../src/docdex/ManagedDocdex.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAajD,wFAAwF;AACxF,qBAAa,aAAa;IAQZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,KAAK,CAAC,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,KAAK,CAAC,CAAa;IAC3B,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;gBACrB,OAAO,EAAE;QACpC,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,oBAAoB,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAC;QAC/F,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC5G,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;KACrC;IAEK,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;IAyG9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B"}