@lzehrung/codegraph 2.1.0

package/dist/agent/query-index/update.js

@@ -0,0 +1,309 @@
+import fs from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import path from "node:path";
+import { getCodegraphVersion } from "../../util/packageInfo.js";
+import { normalizePath } from "../../util/paths.js";
+import { errorMessage } from "../../util/errors.js";
+import { createProjectRootIdentity, normalizeQueryIndexRelativePath, resolveQueryIndexPaths, resolveQueryIndexSourcePath, } from "./paths.js";
+import { createQuerySourceIdentity } from "./sourceIdentity.js";
+import { expectedQueryIndexVersionMetadata, QueryIndexFutureSchemaError, QueryIndexSchemaError, QUERY_INDEX_SCHEMA_VERSION, } from "./schema.js";
+import { isSqliteBusyError, isSqliteCorruptionError, QueryIndexStore } from "./store.js";
+const QUERY_INDEX_TEMP_RETENTION_MS = 24 * 60 * 60 * 1000;
+const QUERY_INDEX_TEMP_PATTERN = /^search-v1(?:\.v\d+)?\.tmp-\d+-[0-9a-f-]+\.sqlite$/u;
+function emptyDiagnostics(sidecarState) {
+    return {
+        sidecarState,
+        filesRead: 0,
+        filesAdded: 0,
+        filesUpdated: 0,
+        filesDeleted: 0,
+        fileCandidates: 0,
+        chunkCandidates: 0,
+        openMs: 0,
+        updateMs: 0,
+        candidateMs: 0,
+        scoringMs: 0,
+    };
+}
+function elapsedMs(startedAt) {
+    return performance.now() - startedAt;
+}
+function lookupManifestEntry(snapshot, file) {
+    const entries = snapshot.index.manifestEntries;
+    return entries?.get(file) ?? entries?.get(normalizePath(file));
+}
+function currentQueryState(snapshot) {
+    const projectSnapshotIdentity = snapshot.index.projectSnapshotIdentity;
+    if (!projectSnapshotIdentity || !snapshot.index.manifestEntries?.size)
+        return null;
+    const files = [];
+    const identities = new Map();
+    for (const file of snapshot.files) {
+        const relativePath = normalizeQueryIndexRelativePath(snapshot.root, file);
+        const entry = lookupManifestEntry(snapshot, file);
+        if (!entry)
+            return null;
+        const sourceIdentity = createQuerySourceIdentity(relativePath, entry);
+        files.push({ path: relativePath, sourceIdentity });
+        identities.set(relativePath, sourceIdentity);
+    }
+    files.sort((left, right) => left.path.localeCompare(right.path));
+    return {
+        files,
+        identities,
+        projectSnapshotIdentity,
+        projectRootIdentity: createProjectRootIdentity(snapshot.root),
+    };
+}
+function metadataMatchesCurrent(metadata, current) {
+    const versions = expectedQueryIndexVersionMetadata();
+    return (metadata.schemaVersion === versions.schemaVersion &&
+        metadata.normalizerVersion === versions.normalizerVersion &&
+        metadata.chunkerVersion === versions.chunkerVersion &&
+        metadata.projectRootIdentity === current.projectRootIdentity &&
+        metadata.projectSnapshotIdentity === current.projectSnapshotIdentity);
+}
+function sourceIdentitiesMatch(left, right) {
+    if (left.size !== right.size)
+        return false;
+    for (const [file, identity] of left) {
+        if (right.get(file) !== identity)
+            return false;
+    }
+    return true;
+}
+function assertStoredPaths(snapshot, identities) {
+    for (const relativePath of identities.keys())
+        resolveQueryIndexSourcePath(snapshot.root, relativePath);
+}
+function buildMetadata(current) {
+    return {
+        ...expectedQueryIndexVersionMetadata(),
+        projectSnapshotIdentity: current.projectSnapshotIdentity,
+        projectRootIdentity: current.projectRootIdentity,
+        createdByCodegraphVersion: getCodegraphVersion(),
+        updatedAt: new Date().toISOString(),
+    };
+}
+async function prepareFiles(projectRoot, files, diagnostics) {
+    try {
+        // Loaded lazily on purpose: importing the worker pool pulls in Piscina, and CLI startup
+        // time is asserted by tests/cli-startup-eager-modules.test.ts.
+        const { prepareQueryIndexFilesInWorker } = await import("./workerPool.js");
+        const prepared = await prepareQueryIndexFilesInWorker(projectRoot, files.map((file) => ({
+            relativePath: file.path,
+            sourceIdentity: file.sourceIdentity,
+        })));
+        if (prepared && prepared.length < files.length) {
+            diagnostics.filesSkipped = files.length - prepared.length;
+        }
+        return prepared;
+    }
+    catch (error) {
+        diagnostics.fallbackReason = errorMessage(error);
+        return null;
+    }
+}
+async function pathIsSymlink(filePath) {
+    try {
+        return (await fs.lstat(filePath)).isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function fsyncFile(filePath) {
+    const handle = await fs.open(filePath, "r+");
+    try {
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function removeSqliteCompanions(filePath) {
+    await Promise.all([fs.rm(`${filePath}-wal`, { force: true }), fs.rm(`${filePath}-shm`, { force: true })]);
+}
+async function cleanupAbandonedQueryIndexFiles(paths) {
+    let entries;
+    try {
+        entries = await fs.readdir(paths.cacheRoot, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    const cutoff = Date.now() - QUERY_INDEX_TEMP_RETENTION_MS;
+    for (const entry of entries) {
+        if (!QUERY_INDEX_TEMP_PATTERN.test(entry.name))
+            continue;
+        const candidate = path.join(paths.cacheRoot, entry.name);
+        try {
+            const stat = await fs.lstat(candidate);
+            if (stat.mtimeMs > cutoff)
+                continue;
+            await fs.rm(candidate, { force: true });
+            await removeSqliteCompanions(candidate);
+        }
+        catch {
+            // Abandoned artifact cleanup must not block a query.
+        }
+    }
+}
+async function rebuildCorruptSidecar(paths, current, prepared) {
+    const temporary = path.join(paths.cacheRoot, `search-v1.v${QUERY_INDEX_SCHEMA_VERSION}.tmp-${process.pid}-${randomUUID()}.sqlite`);
+    await fs.rm(paths.corrupt, { force: true });
+    await removeSqliteCompanions(paths.corrupt);
+    if (await fileExists(paths.sidecar))
+        await fs.rename(paths.sidecar, paths.corrupt);
+    await removeSqliteCompanions(paths.sidecar);
+    let temporaryStore;
+    try {
+        temporaryStore = new QueryIndexStore(temporary);
+        temporaryStore.replaceFiles(prepared, [], buildMetadata(current));
+        temporaryStore.checkpoint();
+        temporaryStore.close();
+        temporaryStore = undefined;
+        await fsyncFile(temporary);
+        await fs.rename(temporary, paths.sidecar);
+        return new QueryIndexStore(paths.sidecar);
+    }
+    catch (error) {
+        temporaryStore?.close();
+        await fs.rm(temporary, { force: true });
+        await removeSqliteCompanions(temporary);
+        throw error;
+    }
+}
+function safeClose(store) {
+    try {
+        store?.close();
+    }
+    catch {
+        // Closing is best effort on a fallback path.
+    }
+}
+export async function ensureQueryIndex(snapshot) {
+    const diagnostics = emptyDiagnostics("unavailable");
+    if (process.env.CODEGRAPH_DISABLE_QUERY_SIDECAR === "1")
+        return { store: null, diagnostics };
+    if (snapshot.index.cacheMode !== "disk" || !snapshot.index.cacheRootDir)
+        return { store: null, diagnostics };
+    const current = currentQueryState(snapshot);
+    if (!current)
+        return { store: null, diagnostics };
+    const requestedPaths = resolveQueryIndexPaths(snapshot.index.cacheRootDir);
+    await fs.mkdir(requestedPaths.cacheRoot, { recursive: true });
+    const paths = resolveQueryIndexPaths(await fs.realpath(requestedPaths.cacheRoot));
+    await cleanupAbandonedQueryIndexFiles(paths);
+    if (await pathIsSymlink(paths.sidecar))
+        return { store: null, diagnostics };
+    const existedBefore = await fileExists(paths.sidecar);
+    const openStarted = performance.now();
+    let store;
+    try {
+        store = new QueryIndexStore(paths.sidecar);
+        store.assertReadable();
+        diagnostics.openMs = elapsedMs(openStarted);
+    }
+    catch (error) {
+        diagnostics.openMs = elapsedMs(openStarted);
+        safeClose(store);
+        if (error instanceof QueryIndexFutureSchemaError) {
+            diagnostics.fallbackReason = errorMessage(error);
+            return { store: null, diagnostics };
+        }
+        if (!(error instanceof QueryIndexSchemaError) && !isSqliteCorruptionError(error)) {
+            diagnostics.fallbackReason = errorMessage(error);
+            return { store: null, diagnostics };
+        }
+        const prepared = await prepareFiles(snapshot.root, current.files, diagnostics);
+        if (!prepared)
+            return { store: null, diagnostics };
+        diagnostics.filesRead = prepared.filter((file) => file.sourceRead).length;
+        diagnostics.filesAdded = prepared.length;
+        const rebuildStarted = performance.now();
+        try {
+            const rebuilt = await rebuildCorruptSidecar(paths, current, prepared);
+            diagnostics.sidecarState = "rebuilt-corrupt";
+            diagnostics.updateMs = elapsedMs(rebuildStarted);
+            return { store: rebuilt, diagnostics };
+        }
+        catch (rebuildError) {
+            diagnostics.fallbackReason = errorMessage(rebuildError);
+            return { store: null, diagnostics };
+        }
+    }
+    const storedIdentities = store.sourceIdentities();
+    try {
+        assertStoredPaths(snapshot, storedIdentities);
+    }
+    catch {
+        safeClose(store);
+        const prepared = await prepareFiles(snapshot.root, current.files, diagnostics);
+        if (!prepared)
+            return { store: null, diagnostics };
+        diagnostics.filesRead = prepared.filter((file) => file.sourceRead).length;
+        diagnostics.filesAdded = prepared.length;
+        const rebuildStarted = performance.now();
+        try {
+            const rebuilt = await rebuildCorruptSidecar(paths, current, prepared);
+            diagnostics.sidecarState = "rebuilt-corrupt";
+            diagnostics.updateMs = elapsedMs(rebuildStarted);
+            return { store: rebuilt, diagnostics };
+        }
+        catch (rebuildError) {
+            diagnostics.fallbackReason = errorMessage(rebuildError);
+            return { store: null, diagnostics };
+        }
+    }
+    if (metadataMatchesCurrent(store.metadata(), current) &&
+        sourceIdentitiesMatch(storedIdentities, current.identities)) {
+        diagnostics.sidecarState = "hit";
+        return { store, diagnostics };
+    }
+    const versions = expectedQueryIndexVersionMetadata();
+    const metadata = store.metadata();
+    const contentVersionsMatch = metadata.schemaVersion === versions.schemaVersion &&
+        metadata.normalizerVersion === versions.normalizerVersion &&
+        metadata.chunkerVersion === versions.chunkerVersion &&
+        metadata.projectRootIdentity === current.projectRootIdentity;
+    const changed = contentVersionsMatch
+        ? current.files.filter((file) => storedIdentities.get(file.path) !== file.sourceIdentity)
+        : current.files;
+    const deleted = contentVersionsMatch
+        ? [...storedIdentities.keys()].filter((file) => !current.identities.has(file))
+        : [...storedIdentities.keys()];
+    const prepared = await prepareFiles(snapshot.root, changed, diagnostics);
+    if (!prepared) {
+        store.close();
+        return { store: null, diagnostics };
+    }
+    diagnostics.filesRead = prepared.filter((file) => file.sourceRead).length;
+    diagnostics.filesAdded = prepared.filter((file) => !storedIdentities.has(file.path)).length;
+    diagnostics.filesUpdated = prepared.length - diagnostics.filesAdded;
+    diagnostics.filesDeleted = deleted.length;
+    const updateStarted = performance.now();
+    try {
+        store.replaceFiles(prepared, deleted, buildMetadata(current));
+        diagnostics.updateMs = elapsedMs(updateStarted);
+        diagnostics.sidecarState = existedBefore ? "updated" : "created";
+        return { store, diagnostics };
+    }
+    catch (error) {
+        diagnostics.updateMs = elapsedMs(updateStarted);
+        store.close();
+        diagnostics.sidecarState = isSqliteBusyError(error) ? "writer-busy" : "unavailable";
+        diagnostics.fallbackReason = errorMessage(error);
+        return { store: null, diagnostics };
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/agent/query-index/update.js.map

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

package/dist/agent/query-index/workerPool.d.ts

@@ -0,0 +1,5 @@
+import { type PreparedQueryIndexFile } from "./content.js";
+import type { QueryIndexWorkerTask } from "./queryIndexWorker.js";
+export declare function resolveQueryIndexWorkerPath(): string;
+export declare function prepareQueryIndexFilesInWorker(projectRoot: string, files: readonly Pick<QueryIndexWorkerTask, "relativePath" | "sourceIdentity">[]): Promise<PreparedQueryIndexFile[] | null>;
+//# sourceMappingURL=workerPool.d.ts.map

package/dist/agent/query-index/workerPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerPool.d.ts","sourceRoot":"","sources":["../../../src/agent/query-index/workerPool.ts"],"names":[],"mappings":"AAKA,OAAO,EAAyB,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGlF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAQlE,wBAAgB,2BAA2B,IAAI,MAAM,CAUpD;AAoBD,wBAAsB,8BAA8B,CAClD,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,IAAI,CAAC,oBAAoB,EAAE,cAAc,GAAG,gBAAgB,CAAC,EAAE,GAC9E,OAAO,CAAC,sBAAsB,EAAE,GAAG,IAAI,CAAC,CA0C1C"}

package/dist/agent/query-index/workerPool.js

@@ -0,0 +1,82 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { Piscina } from "piscina";
+import { findPackageRoot } from "../../util/packageInfo.js";
+import { prepareQueryIndexFile } from "./content.js";
+import { resolveQueryIndexSourcePath } from "./paths.js";
+import { resolveWorkerThreadCount } from "../../util/workerThreads.js";
+const QUERY_INDEX_MAX_THREADS = 4;
+function resolveWorkerThreads() {
+    return resolveWorkerThreadCount({ max: QUERY_INDEX_MAX_THREADS });
+}
+export function resolveQueryIndexWorkerPath() {
+    const selfDir = path.dirname(fileURLToPath(import.meta.url));
+    const sibling = path.resolve(selfDir, "queryIndexWorker.js");
+    if (fs.existsSync(sibling))
+        return sibling;
+    const packageRoot = findPackageRoot(selfDir);
+    const compiled = path.join(packageRoot, "dist", "agent", "query-index", "queryIndexWorker.js");
+    if (fs.existsSync(compiled))
+        return compiled;
+    const bundled = path.join(packageRoot, "dist", "bin", "queryIndexWorker.js");
+    if (fs.existsSync(bundled))
+        return bundled;
+    throw new Error(`Query index worker file not found: ${bundled}`);
+}
+async function prepareQueryIndexFilesInProcess(projectRoot, files) {
+    const prepared = await Promise.all(files.map(async (file) => {
+        const absolutePath = resolveQueryIndexSourcePath(projectRoot, file.relativePath);
+        return await prepareQueryIndexFile({
+            absolutePath,
+            path: file.relativePath,
+            sourceIdentity: file.sourceIdentity,
+        });
+    }));
+    const usable = prepared.flatMap((file) => (file ? [file] : []));
+    if (!usable.length)
+        return null;
+    return usable;
+}
+export async function prepareQueryIndexFilesInWorker(projectRoot, files) {
+    if (!files.length)
+        return [];
+    const threads = Math.min(resolveWorkerThreads(), files.length);
+    let workerPath;
+    try {
+        workerPath = resolveQueryIndexWorkerPath();
+    }
+    catch {
+        return await prepareQueryIndexFilesInProcess(projectRoot, files);
+    }
+    const pool = new Piscina({
+        filename: workerPath,
+        minThreads: 1,
+        maxThreads: threads,
+        maxQueue: Math.max(threads * 4, files.length),
+        idleTimeout: 10_000,
+    });
+    try {
+        const prepared = await Promise.all(files.map((file) => pool.run({
+            projectRoot,
+            relativePath: file.relativePath,
+            sourceIdentity: file.sourceIdentity,
+        })));
+        const usable = prepared.flatMap((file) => (file ? [file] : []));
+        // A file that cannot be prepared (removed mid-scan, or a transient EMFILE/ENOMEM on a
+        // loaded machine) must not discard the whole batch: indexing the remaining files keeps
+        // the sidecar usable and self-heals on the next run, because the stored source
+        // identities will not match the current snapshot. Only a batch that produced nothing
+        // is treated as a real preparation failure worth degrading to the in-memory matcher.
+        if (!usable.length)
+            return null;
+        return usable;
+    }
+    catch {
+        return await prepareQueryIndexFilesInProcess(projectRoot, files);
+    }
+    finally {
+        await pool.destroy();
+    }
+}
+//# sourceMappingURL=workerPool.js.map

package/dist/agent/query-index/workerPool.js.map

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

package/dist/agent/refactorPlan.d.ts

@@ -0,0 +1,40 @@
+import type { BuildOptions } from "../indexer/types.js";
+import { type RenameCandidateTest, type RenamePreviewResponse } from "./renamePreview.js";
+import type { CallHierarchyEntry } from "./callHierarchy.js";
+import type { ImplementationEntry, TypeHierarchyRelation } from "./typeHierarchy.js";
+import type { SemanticLocation, SemanticResponseEnvelope, SemanticSymbol } from "./semantic.js";
+import { type AgentFreshnessResult, type AgentProjectSnapshot, type AgentSession } from "./session.js";
+import { type AgentFollowUp } from "./followUps.js";
+export type RefactorPlanRequest = {
+    root: string;
+    handle: string;
+    renameTo?: string;
+    maxReferences?: number;
+    maxCallers?: number;
+    maxHierarchy?: number;
+    includeSource?: boolean;
+    buildOptions?: BuildOptions;
+};
+export type RefactorPlanSectionIssue = {
+    section: "implementations";
+    status: "not_found" | "invalid_target" | "unsupported_target";
+    reason: string;
+};
+export type RefactorPlanResponse = SemanticResponseEnvelope & {
+    target: SemanticSymbol;
+    definition: SemanticLocation;
+    references: SemanticLocation[];
+    callers: CallHierarchyEntry[];
+    callees: CallHierarchyEntry[];
+    supertypes: TypeHierarchyRelation[];
+    subtypes: TypeHierarchyRelation[];
+    implementations: ImplementationEntry[];
+    sectionIssues: RefactorPlanSectionIssue[];
+    rename?: RenamePreviewResponse;
+    candidateTests: RenameCandidateTest[];
+    followUps: AgentFollowUp[];
+};
+export declare function buildRefactorPlan(request: RefactorPlanRequest): Promise<RefactorPlanResponse>;
+export declare function buildRefactorPlanWithSession(session: AgentSession, request: RefactorPlanRequest): Promise<RefactorPlanResponse>;
+export declare function buildRefactorPlanInSnapshot(snapshot: AgentProjectSnapshot, request: Omit<RefactorPlanRequest, "buildOptions">, freshness?: AgentFreshnessResult): Promise<RefactorPlanResponse>;
+//# sourceMappingURL=refactorPlan.d.ts.map

package/dist/agent/refactorPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactorPlan.d.ts","sourceRoot":"","sources":["../../src/agent/refactorPlan.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD,OAAO,EAA2B,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACnH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAsB,wBAAwB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,gBAAgB,CAAC;AAElE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,WAAW,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;IAC9D,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,GAAG;IAC5D,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,eAAe,EAAE,mBAAmB,EAAE,CAAC;IACvC,aAAa,EAAE,wBAAwB,EAAE,CAAC;IAC1C,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,cAAc,EAAE,mBAAmB,EAAE,CAAC;IACtC,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B,CAAC;AAMF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAMnG;AAED,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAI/B;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,EAClD,SAAS,GAAE,oBAAyC,GACnD,OAAO,CAAC,oBAAoB,CAAC,CAsJ/B"}