@mirnoorata/codexa 0.2.0

package/dist/mcp/prompts.js

@@ -0,0 +1,109 @@
+import { z } from "zod";
+export function registerWorkflowPrompts(server) {
+    server.registerPrompt("impact_before_edit", {
+        title: "Codexa impact before edit",
+        description: "Use Codexa to gather blast-radius context before changing a file or symbol.",
+        argsSchema: {
+            target: z.string().describe("File path, symbol name, or symbol id to inspect before editing."),
+            task: z.string().optional().describe("Short task description.")
+        }
+    }, async ({ target, task }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        `Use Codexa before editing ${target}.`,
+                        task ? `Task: ${task}` : undefined,
+                        "If the target is unclear, call first-class `search` before planning.",
+                        "Call `change_plan` with `saveSnapshot: true` for the target and task before editing.",
+                        "Call `impact` only if the plan reports medium/low quality, broad fanout, or a high-risk public contract.",
+                        "After editing, call `post_edit_review` with the returned task snapshot id.",
+                        "Read the returned freshness, confidence labels, known gaps, affected files, and likely tests before modifying code."
+                    ]
+                        .filter((line) => Boolean(line))
+                        .join("\n")
+                }
+            }
+        ]
+    }));
+    server.registerPrompt("dirty_diff_review", {
+        title: "Codexa dirty diff review",
+        description: "Review the current dirty tree with grouped impact and targeted verification.",
+        argsSchema: {
+            task: z.string().optional().describe("What the dirty diff is supposed to accomplish.")
+        }
+    }, async ({ task }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "Use Codexa to review the current dirty diff.",
+                        task ? `Expected intent: ${task}` : undefined,
+                        "Call `post_edit_review` first if a change_plan snapshot exists; otherwise call `search` for target discovery or `task_brief` with `diff: true` when the target is already clear.",
+                        "Then call `diff_impact` or `test_plan` only if the review or brief leaves a gap.",
+                        "Check changed-but-unindexed files, parser errors, heuristic-only links, and candidate test command provenance."
+                    ]
+                        .filter((line) => Boolean(line))
+                        .join("\n")
+                }
+            }
+        ]
+    }));
+    server.registerPrompt("snapshot_edit_loop", {
+        title: "Codexa snapshot edit loop",
+        description: "Use a plan-time snapshot before editing and a drift review after editing.",
+        argsSchema: {
+            task: z.string().describe("Short description of the intended edit."),
+            target: z.string().optional().describe("Optional file path, symbol name, or symbol id to change.")
+        }
+    }, async ({ task, target }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "Use Codexa's snapshot edit loop.",
+                        `Task: ${task}`,
+                        target ? `Target: ${target}` : undefined,
+                        "Before editing, call first-class `search` if the target is unclear, then `change_plan` with `saveSnapshot: true` and a short `taskId`.",
+                        "Use the returned planned files, tests, workflows, quality, and gaps to guide source reads.",
+                        "After editing, call go-to `post_edit_review` with that `taskId` and any tests already run.",
+                        "If the review says `inspect` or `replan`, resolve that drift before claiming the edit is complete."
+                    ]
+                        .filter((line) => Boolean(line))
+                        .join("\n")
+                }
+            }
+        ]
+    }));
+    server.registerPrompt("targeted_test_plan", {
+        title: "Codexa targeted test plan",
+        description: "Generate a focused test plan with command provenance for current changes.",
+        argsSchema: {
+            task: z.string().optional().describe("Short description of the change being verified.")
+        }
+    }, async ({ task }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "Use Codexa to create a targeted test plan.",
+                        task ? `Change under test: ${task}` : undefined,
+                        "Call `test_plan` with `diff: true` and prefer tests whose commands have package or Python metadata provenance.",
+                        "If command provenance is missing, inspect the repo scripts before running a command."
+                    ]
+                        .filter((line) => Boolean(line))
+                        .join("\n")
+                }
+            }
+        ]
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/dist/mcp/prompts.js.map

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

package/dist/mcp/resources.d.ts

@@ -0,0 +1,2 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerArtifactResources(server: McpServer, resolveRepoRoot: () => Promise<string>): Promise<void>;

package/dist/mcp/resources.js

@@ -0,0 +1,132 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { statusQuery } from "../queries.js";
+export async function registerArtifactResources(server, resolveRepoRoot) {
+    const artifacts = [
+        ["codebase-readme", "codexa://repo/codebase/README.md", ".codex/codebase/README.md", "text/markdown", "Codexa artifact overview"],
+        ["codex-contract", "codexa://repo/codebase/codex-contract.md", ".codex/codebase/codex-contract.md", "text/markdown", "Codex automatic-use contract"],
+        ["repo-map", "codexa://repo/codebase/repo-map.md", ".codex/codebase/repo-map.md", "text/markdown", "Ranked repository map"],
+        ["risk-map", "codexa://repo/codebase/risk-map.md", ".codex/codebase/risk-map.md", "text/markdown", "Risk-ranked files and signals"],
+        ["placeholder-map", "codexa://repo/codebase/placeholder-map.md", ".codex/codebase/placeholder-map.md", "text/markdown", "Placeholder and dummy code/data signals"],
+        ["test-map", "codexa://repo/codebase/test-map.md", ".codex/codebase/test-map.md", "text/markdown", "Detected test files and test edges"],
+        ["conventions", "codexa://repo/codebase/conventions.md", ".codex/codebase/conventions.md", "text/markdown", "Detected project conventions"],
+        ["workflows", "codexa://repo/codebase/workflows.md", ".codex/codebase/workflows.md", "text/markdown", "Detected workflow traces"],
+        ["playbooks", "codexa://repo/codebase/playbooks/README.md", ".codex/codebase/playbooks/README.md", "text/markdown", "Generated Codexa change playbook index"],
+        ["freshness-json", "codexa://repo/codebase/freshness.json", ".codex/codebase/freshness.json", "application/json", "Codexa freshness snapshot"]
+    ];
+    for (const [name, uri, relativePath, mimeType, description] of artifacts) {
+        server.registerResource(name, uri, {
+            title: `Codexa ${name}`,
+            description,
+            mimeType
+        }, async () => ({
+            contents: [
+                {
+                    uri,
+                    mimeType,
+                    text: relativePath === ".codex/codebase/freshness.json"
+                        ? await readLiveFreshnessArtifact(await resolveRepoRoot())
+                        : await readArtifact(await resolveRepoRoot(), relativePath)
+                }
+            ]
+        }));
+    }
+    server.registerResource("module-index", "codexa://repo/codebase/modules", {
+        title: "Codexa module index",
+        description: "List generated Codexa module artifact names.",
+        mimeType: "text/markdown"
+    }, async () => {
+        const repoRoot = await resolveRepoRoot();
+        const modulesDir = path.join(repoRoot, ".codex/codebase/modules");
+        let text = "# Codexa Modules\n\n";
+        try {
+            const allNames = (await fs.readdir(modulesDir)).filter((name) => name.endsWith(".md")).sort();
+            const names = allNames.slice(0, 80);
+            text += names.map((name) => `- codexa://repo/codebase/modules/${encodeURIComponent(name)}`).join("\n") || "- none";
+            if (allNames.length > names.length) {
+                text += `\n- ... ${allNames.length - names.length} more modules omitted from this bounded index`;
+            }
+        }
+        catch {
+            text += "- modules unavailable; run `codexa index <repo>` first";
+        }
+        return { contents: [{ uri: "codexa://repo/codebase/modules", mimeType: "text/markdown", text }] };
+    });
+    server.registerResource("module-artifact", new ResourceTemplate("codexa://repo/codebase/modules/{name}", {
+        list: async () => ({
+            resources: await listMarkdownArtifacts(await resolveRepoRoot(), ".codex/codebase/modules", "codexa://repo/codebase/modules", "Codexa module", "Generated Codexa module artifact")
+        })
+    }), {
+        title: "Codexa module artifact",
+        description: "Read a generated Codexa module artifact by filename.",
+        mimeType: "text/markdown"
+    }, async (uri, variables) => {
+        const name = artifactNameVariable(variables.name);
+        return {
+            contents: [
+                {
+                    uri: uri.toString(),
+                    mimeType: "text/markdown",
+                    text: await readArtifact(await resolveRepoRoot(), `.codex/codebase/modules/${name}`)
+                }
+            ]
+        };
+    });
+    server.registerResource("playbook-artifact", new ResourceTemplate("codexa://repo/codebase/playbooks/{name}", {
+        list: async () => ({
+            resources: await listMarkdownArtifacts(await resolveRepoRoot(), ".codex/codebase/playbooks", "codexa://repo/codebase/playbooks", "Codexa playbook", "Generated Codexa change playbook", (name) => name !== "README.md")
+        })
+    }), {
+        title: "Codexa playbook artifact",
+        description: "Read a generated Codexa change playbook by filename.",
+        mimeType: "text/markdown"
+    }, async (uri, variables) => {
+        const name = artifactNameVariable(variables.name);
+        return {
+            contents: [
+                {
+                    uri: uri.toString(),
+                    mimeType: "text/markdown",
+                    text: await readArtifact(await resolveRepoRoot(), `.codex/codebase/playbooks/${name}`)
+                }
+            ]
+        };
+    });
+}
+async function readArtifact(repoRoot, relativePath) {
+    try {
+        return await fs.readFile(path.join(repoRoot, relativePath), "utf8");
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Codexa artifact missing: ${relativePath}. Run: codexa index ${repoRoot}. ${message}`);
+    }
+}
+async function readLiveFreshnessArtifact(repoRoot) {
+    const status = await statusQuery(repoRoot, { recover: false });
+    return `${JSON.stringify(status.data, null, 2)}\n`;
+}
+async function listMarkdownArtifacts(repoRoot, relativeDir, uriPrefix, titlePrefix, descriptionPrefix, include = () => true) {
+    try {
+        const names = (await fs.readdir(path.join(repoRoot, relativeDir))).filter((name) => name.endsWith(".md") && include(name)).sort().slice(0, 80);
+        return names.map((name) => ({
+            name: `${titlePrefix} ${name}`,
+            uri: `${uriPrefix}/${encodeURIComponent(name)}`,
+            title: `${titlePrefix} ${name}`,
+            description: `${descriptionPrefix} ${name}`,
+            mimeType: "text/markdown"
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+function artifactNameVariable(value) {
+    const name = Array.isArray(value) ? value.join("/") : value;
+    if (!name || name.includes("/") || name.includes("\\") || name === "." || name === ".." || !name.endsWith(".md")) {
+        throw new Error(`Invalid Codexa artifact name: ${name}`);
+    }
+    return name;
+}
+//# sourceMappingURL=resources.js.map

package/dist/mcp/resources.js.map

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

package/dist/mcp/runtime.d.ts

@@ -0,0 +1,15 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type QuerySession } from "../query/session.js";
+import type { QueryOptions, QueryResult } from "../types.js";
+export interface McpRuntime {
+    resolveActiveRepoRoot(): Promise<string>;
+    createQuerySession(activeRepoRoot: string): Promise<QuerySession>;
+}
+export interface CreateMcpRuntimeOptions {
+    configuredRepoRoot: string;
+    queryOptions: QueryOptions;
+    preferConfiguredRoot: boolean;
+}
+export declare function createMcpRuntime({ configuredRepoRoot, queryOptions, preferConfiguredRoot }: CreateMcpRuntimeOptions): McpRuntime;
+export declare function notifyResourceListChangedAfterRefresh(server: McpServer, session: QuerySession): Promise<void>;
+export declare function withSessionRuntime(result: QueryResult, session: QuerySession): QueryResult;

package/dist/mcp/runtime.js

@@ -0,0 +1,122 @@
+import { getFreshness } from "../indexer.js";
+import { resolveMcpRepoRoot } from "../mcp-repo-root.js";
+import { requireIndex } from "../query/runtime.js";
+import { createQuerySessionFromIndexState } from "../query/session.js";
+export function createMcpRuntime({ configuredRepoRoot, queryOptions, preferConfiguredRoot }) {
+    let cachedIndexState;
+    let cachedIndexStateRepoRoot;
+    let indexStateInflight;
+    let activeResolution;
+    const resolveActiveRepoRoot = async () => {
+        const resolution = await resolveMcpRepoRoot(configuredRepoRoot, {
+            workspaceFocusFile: queryOptions.workspaceFocusFile,
+            workspaceSessionId: queryOptions.workspaceSessionId,
+            preferConfiguredRoot
+        });
+        if (activeResolution?.repoRoot !== resolution.repoRoot) {
+            cachedIndexState = undefined;
+            cachedIndexStateRepoRoot = undefined;
+            indexStateInflight = undefined;
+        }
+        if (!sameResolution(activeResolution, resolution)) {
+            activeResolution = resolution;
+            if (resolution.source !== "configured-root") {
+                const via = resolution.focusFile ? `${resolution.source}:${resolution.focusFile}` : resolution.source;
+                console.error(`codexa MCP resolved ${resolution.configuredRoot} to focused repo ${resolution.repoRoot} via ${via}`);
+            }
+        }
+        return resolution.repoRoot;
+    };
+    const loadIndexState = async (activeRepoRoot) => {
+        if (indexStateInflight?.repoRoot === activeRepoRoot) {
+            return indexStateInflight.promise;
+        }
+        const pending = (async () => {
+            if (cachedIndexState && cachedIndexStateRepoRoot === activeRepoRoot) {
+                const freshness = await getFreshness(activeRepoRoot, cachedIndexState.index, { recover: false });
+                if (!freshness.stale || !queryOptions.autoRefresh) {
+                    cachedIndexState = { ...cachedIndexState, freshness, refresh: { refreshed: false } };
+                    return cachedIndexState;
+                }
+            }
+            const loaded = await requireIndex(activeRepoRoot, queryOptions);
+            cachedIndexState = loaded;
+            cachedIndexStateRepoRoot = activeRepoRoot;
+            return loaded;
+        })();
+        indexStateInflight = { repoRoot: activeRepoRoot, promise: pending };
+        void pending
+            .finally(() => {
+            if (indexStateInflight?.promise === pending) {
+                indexStateInflight = undefined;
+            }
+        })
+            .catch(() => undefined);
+        return pending;
+    };
+    return {
+        resolveActiveRepoRoot,
+        async createQuerySession(activeRepoRoot) {
+            const state = await loadIndexState(activeRepoRoot);
+            return createQuerySessionFromIndexState(activeRepoRoot, state, queryOptions);
+        }
+    };
+}
+export async function notifyResourceListChangedAfterRefresh(server, session) {
+    if (!session.refresh?.refreshed) {
+        return;
+    }
+    await Promise.resolve(server.sendResourceListChanged());
+}
+export function withSessionRuntime(result, session) {
+    const runtime = {
+        repoRoot: session.repoRoot,
+        indexLoaded: Boolean(session.index),
+        freshness: session.freshness.reason,
+        stale: session.freshness.stale,
+        gitHead: session.gitState.headCommit,
+        dirtyFileCount: session.gitState.dirtyFiles.length,
+        changedFilesLoaded: session.provenance.some((entry) => entry.startsWith("changed-files:")),
+        commandBudgetMs: session.commandBudgetMs,
+        commandBudgetUsedMs: session.commandBudgetUsedMs(),
+        commandBudgetRemainingMs: session.commandBudgetRemainingMs(),
+        maxResultBytes: session.maxResultBytes,
+        resultBytes: Buffer.byteLength(result.text, "utf8"),
+        maxResults: session.maxResults,
+        warnings: session.warnings.slice(0, 20),
+        provenance: session.provenance.slice(0, 30)
+    };
+    let text = result.text;
+    let data = addRuntimeData(result.data, runtime);
+    if (runtime.resultBytes > session.maxResultBytes) {
+        const suffix = `\n\n[Codexa result truncated to ${session.maxResultBytes} bytes for MCP transport.]`;
+        text = `${result.text.slice(0, Math.max(0, session.maxResultBytes - suffix.length))}${suffix}`;
+        session.warnings.push(`result truncated to ${session.maxResultBytes} bytes`);
+        data = addRuntimeData(result.data, {
+            ...runtime,
+            resultBytes: Buffer.byteLength(text, "utf8"),
+            resultTruncated: true,
+            warnings: session.warnings.slice(0, 20)
+        });
+    }
+    return {
+        ...result,
+        text,
+        data
+    };
+}
+function sameResolution(previous, next) {
+    return (previous !== undefined &&
+        previous.repoRoot === next.repoRoot &&
+        previous.source === next.source &&
+        previous.focusFile === next.focusFile &&
+        previous.focusReason === next.focusReason &&
+        previous.workspaceSessionId === next.workspaceSessionId);
+}
+function addRuntimeData(data, runtime) {
+    if (data && typeof data === "object" && !Array.isArray(data)) {
+        return { ...data, runtime };
+    }
+    return { value: data, runtime };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/mcp/runtime.js.map

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

package/dist/mcp/session-memory.d.ts

@@ -0,0 +1,3 @@
+import type { QuerySession } from "../query/session.js";
+import type { QueryResult } from "../types.js";
+export declare function withAutoRecordedSessionMemory(session: QuerySession, result: QueryResult, toolName: string, input: Record<string, unknown> | undefined): Promise<QueryResult>;

package/dist/mcp/session-memory.js

@@ -0,0 +1,61 @@
+import { recordViewedMemoryForTool } from "../session-memory.js";
+export async function withAutoRecordedSessionMemory(session, result, toolName, input) {
+    try {
+        const writes = await recordViewedMemoryForTool({
+            repoRoot: session.repoRoot,
+            taskId: typeof input?.taskId === "string" ? input.taskId : undefined,
+            task: typeof input?.task === "string" ? input.task : undefined,
+            toolName,
+            result,
+            index: session.index
+        });
+        if (!writes) {
+            return result;
+        }
+        return {
+            ...result,
+            data: addSessionMemoryWrite(result.data, writes)
+        };
+    }
+    catch (error) {
+        const warning = `session memory auto-record failed for ${toolName}: ${error instanceof Error ? error.message : String(error)}`;
+        return {
+            ...result,
+            data: addSessionMemoryWarning(result.data, warning)
+        };
+    }
+}
+function addSessionMemoryWrite(data, writes) {
+    if (!isRecord(data)) {
+        return data;
+    }
+    const existing = isRecord(data.sessionMemory) ? data.sessionMemory : {};
+    return {
+        ...data,
+        sessionMemory: {
+            ...existing,
+            autoRecorded: true,
+            writes
+        }
+    };
+}
+function addSessionMemoryWarning(data, warning) {
+    if (!isRecord(data)) {
+        return data;
+    }
+    const warnings = Array.isArray(data.warnings) ? data.warnings.filter((entry) => typeof entry === "string") : [];
+    const existing = isRecord(data.sessionMemory) ? data.sessionMemory : {};
+    return {
+        ...data,
+        warnings: [...warnings, warning],
+        sessionMemory: {
+            ...existing,
+            autoRecorded: false,
+            warning
+        }
+    };
+}
+function isRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+//# sourceMappingURL=session-memory.js.map

package/dist/mcp/session-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-memory.js","sourceRoot":"","sources":["../../src/mcp/session-memory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAGjE,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,OAAqB,EAAE,MAAmB,EAAE,QAAgB,EAAE,KAA0C;IAC1J,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC;YAC7C,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YACpE,IAAI,EAAE,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YAC9D,QAAQ;YACR,MAAM;YACN,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO;YACL,GAAG,MAAM;YACT,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;SACjD,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,yCAAyC,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/H,OAAO;YACL,GAAG,MAAM;YACT,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC;SACpD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAa,EAAE,MAAe;IAC3D,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,OAAO;QACL,GAAG,IAAI;QACP,aAAa,EAAE;YACb,GAAG,QAAQ;YACX,YAAY,EAAE,IAAI;YAClB,MAAM;SACP;KACF,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAa,EAAE,OAAe;IAC7D,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjI,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,OAAO;QACL,GAAG,IAAI;QACP,QAAQ,EAAE,CAAC,GAAG,QAAQ,EAAE,OAAO,CAAC;QAChC,aAAa,EAAE;YACb,GAAG,QAAQ;YACX,YAAY,EAAE,KAAK;YACnB,OAAO;SACR;KACF,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9E,CAAC"}