coalesce-transform-mcp 0.3.0 → 0.4.2

package/dist/services/pipelines/intent-parsing.js

@@ -0,0 +1,245 @@
+// ---------------------------------------------------------------------------
+// Intent parsing — pure text analysis, no API calls
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Patterns
+// ---------------------------------------------------------------------------
+const AGGREGATE_PATTERNS = [
+    { pattern: /\b(?:total|sum(?:\s+of)?)\s+(\w+)/gi, fn: "SUM" },
+    { pattern: /\b(?:count(?:\s+of)?)\s+(\w+)/gi, fn: "COUNT" },
+    { pattern: /\b(?:average|avg(?:\s+of)?)\s+(\w+)/gi, fn: "AVG" },
+    { pattern: /\b(?:max(?:imum)?(?:\s+of)?)\s+(\w+)/gi, fn: "MAX" },
+    { pattern: /\b(?:min(?:imum)?(?:\s+of)?)\s+(\w+)/gi, fn: "MIN" },
+];
+const JOIN_KEYWORDS = /\b(?:combine|join|merge|link|connect|match)\b/i;
+const AGGREGATE_KEYWORDS = /\b(?:aggregate|group|sum|total|count|average|avg|rollup|summarize|summarise)\b/i;
+const FILTER_KEYWORDS = /\b(?:filter|where|only|exclude|remove|active|inactive)\b/i;
+const UNION_KEYWORDS = /\b(?:union|stack|append|combine\s+all)\b/i;
+const STAGE_KEYWORDS = /\b(?:stage|load|ingest|source|land|raw)\b/i;
+const GROUP_BY_PATTERN = /\b(?:(?:group|aggregate|summarize|summarise|rollup)\s+by|per|by)\s+([\w\s,]+?)(?:\s+(?:and|then|with|from|where|filter)|$)/gi;
+const FILTER_PATTERN = /\b(?:filter(?:ed)?(?:\s+(?:to|for|by|on))?|where|only(?:\s+(?:include|keep|show))?)\s+([\w\s=<>!']+?)(?:\s+(?:and\s+(?:group|aggregate|join)|then|from)|$)/gi;
+// Matches "on COLUMN_NAME" or "using COLUMN_NAME" near join context
+const JOIN_ON_PATTERN = /\b(?:(?:left|right|inner|full|outer|cross)\s+)?(?:join|combine|merge|link|connect|match)\s+[\w_]+\s+(?:and|with|to)\s+[\w_]+\s+(?:on|using)\s+([\w_]+)/gi;
+const ENTITY_PATTERNS = [
+    // "join X and Y", "combine X with Y", "left join X and Y"
+    /\b(?:(?:left|right|inner|full|outer|cross)\s+)?(?:join|combine|merge|link|connect|match)\s+([\w_]+)\s+(?:and|with|to)\s+([\w_]+)/gi,
+    // "from X and Y"
+    /\bfrom\s+([\w_]+)\s+(?:and|,)\s+([\w_]+)/gi,
+    // "stage/load/ingest X" — single entity after staging verb
+    /\b(?:stage|load|ingest)\s+(?:the\s+)?(?:raw\s+)?([\w_]+)/gi,
+    // standalone table-like names (2+ uppercase chars with underscores)
+    /\b([A-Z][A-Z0-9_]{2,})\b/g,
+];
+// ---------------------------------------------------------------------------
+// Extraction helpers
+// ---------------------------------------------------------------------------
+function extractEntityNames(intent) {
+    const entities = new Set();
+    for (const pattern of ENTITY_PATTERNS.slice(0, 3)) {
+        let match;
+        const re = new RegExp(pattern.source, pattern.flags);
+        while ((match = re.exec(intent)) !== null) {
+            if (match[1])
+                entities.add(match[1].toUpperCase());
+            if (match[2])
+                entities.add(match[2].toUpperCase());
+        }
+    }
+    if (entities.size > 0) {
+        return Array.from(entities);
+    }
+    const uppercasePattern = ENTITY_PATTERNS[3];
+    let match;
+    const re = new RegExp(uppercasePattern.source, uppercasePattern.flags);
+    const STOP_WORDS = new Set([
+        "SUM", "COUNT", "AVG", "MAX", "MIN", "GROUP", "TOTAL", "FILTER",
+        "WHERE", "JOIN", "AND", "FROM", "INTO", "INNER", "LEFT", "FULL",
+        "OUTER", "UNION", "ALL", "SELECT", "WITH", "THE", "FOR",
+    ]);
+    while ((match = re.exec(intent)) !== null) {
+        if (match[1] && !STOP_WORDS.has(match[1])) {
+            entities.add(match[1]);
+        }
+    }
+    return Array.from(entities);
+}
+function extractAggregateColumns(intent) {
+    const columns = [];
+    const seen = new Set();
+    for (const { pattern, fn } of AGGREGATE_PATTERNS) {
+        let match;
+        const re = new RegExp(pattern.source, pattern.flags);
+        while ((match = re.exec(intent)) !== null) {
+            const colName = match[1]?.toUpperCase();
+            if (colName && !seen.has(`${fn}:${colName}`)) {
+                seen.add(`${fn}:${colName}`);
+                columns.push({
+                    name: `${fn}_${colName}`,
+                    aggregateFunction: fn,
+                    expression: `${fn}(${colName})`,
+                });
+            }
+        }
+    }
+    return columns;
+}
+function extractGroupByColumns(intent) {
+    const columns = [];
+    const seen = new Set();
+    let match;
+    const re = new RegExp(GROUP_BY_PATTERN.source, GROUP_BY_PATTERN.flags);
+    while ((match = re.exec(intent)) !== null) {
+        if (match[1]) {
+            const parts = match[1].split(/[,\s]+/).filter((p) => p.length > 0);
+            for (const part of parts) {
+                const col = part.toUpperCase().replace(/[^A-Z0-9_]/g, "");
+                if (col.length > 0 && !seen.has(col)) {
+                    seen.add(col);
+                    columns.push(col);
+                }
+            }
+        }
+    }
+    return columns;
+}
+function extractFilters(intent) {
+    const filters = [];
+    let match;
+    const re = new RegExp(FILTER_PATTERN.source, FILTER_PATTERN.flags);
+    while ((match = re.exec(intent)) !== null) {
+        if (match[1]) {
+            const filter = match[1].trim();
+            if (filter.length > 2) {
+                filters.push(filter);
+            }
+        }
+    }
+    return filters;
+}
+function extractJoinKey(intent) {
+    let match;
+    const re = new RegExp(JOIN_ON_PATTERN.source, JOIN_ON_PATTERN.flags);
+    while ((match = re.exec(intent)) !== null) {
+        if (match[1]) {
+            return match[1].toUpperCase();
+        }
+    }
+    return null;
+}
+function detectJoinType(intent) {
+    if (/\bleft\s+(?:outer\s+)?join\b/i.test(intent))
+        return "LEFT";
+    if (/\bfull\s+(?:outer\s+)?join\b/i.test(intent))
+        return "FULL OUTER";
+    if (/\b(?:inner\s+)?join\b/i.test(intent))
+        return "INNER";
+    if (JOIN_KEYWORDS.test(intent))
+        return "INNER";
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Main parser
+// ---------------------------------------------------------------------------
+export function parseIntent(intentText) {
+    const warnings = [];
+    const openQuestions = [];
+    const steps = [];
+    const entityNames = extractEntityNames(intentText);
+    const hasJoin = JOIN_KEYWORDS.test(intentText);
+    const hasAggregate = AGGREGATE_KEYWORDS.test(intentText);
+    const hasFilter = FILTER_KEYWORDS.test(intentText);
+    const hasUnion = UNION_KEYWORDS.test(intentText);
+    const hasStage = STAGE_KEYWORDS.test(intentText) && !hasJoin && !hasAggregate;
+    if (entityNames.length === 0) {
+        openQuestions.push("Could not identify source tables or nodes from the description. " +
+            "Please mention the table/node names explicitly (e.g., 'combine CUSTOMERS and ORDERS').");
+    }
+    // Build steps based on detected operations
+    if (hasUnion) {
+        steps.push({
+            operation: "union",
+            entityNames,
+            targetName: null,
+            columns: [],
+            groupByColumns: [],
+            filters: [],
+            joinKey: null,
+            joinType: null,
+        });
+    }
+    else if (hasJoin && entityNames.length < 2) {
+        openQuestions.push(`A join operation requires at least two source tables, but only ${entityNames.length === 0 ? "none were" : `"${entityNames[0]}" was`} found. ` +
+            `Please mention both tables (e.g., 'join CUSTOMERS and ORDERS on CUSTOMER_ID').`);
+    }
+    else if (hasJoin && entityNames.length >= 2) {
+        const joinKey = extractJoinKey(intentText);
+        const joinType = detectJoinType(intentText);
+        steps.push({
+            operation: "join",
+            entityNames,
+            targetName: null,
+            columns: [],
+            groupByColumns: [],
+            filters: [],
+            joinKey,
+            joinType,
+        });
+        if (!joinKey) {
+            openQuestions.push(`What column should be used to join ${entityNames.join(" and ")}? ` +
+                `(e.g., 'join on CUSTOMER_ID')`);
+        }
+    }
+    else if (hasStage || (!hasJoin && !hasAggregate && entityNames.length > 0)) {
+        for (const entityName of entityNames) {
+            steps.push({
+                operation: "stage",
+                entityNames: [entityName],
+                targetName: null,
+                columns: [],
+                groupByColumns: [],
+                filters: [],
+                joinKey: null,
+                joinType: null,
+            });
+        }
+    }
+    // Add aggregate step if detected
+    if (hasAggregate) {
+        const aggregateColumns = extractAggregateColumns(intentText);
+        const groupByColumns = extractGroupByColumns(intentText);
+        if (groupByColumns.length === 0 && aggregateColumns.length > 0) {
+            openQuestions.push("Aggregation detected but no GROUP BY columns found. " +
+                "Which columns should be used for grouping? (e.g., 'group by REGION, CATEGORY')");
+        }
+        const aggEntities = steps.length > 0
+            ? [] // will reference previous step's output
+            : entityNames;
+        steps.push({
+            operation: "aggregate",
+            entityNames: aggEntities,
+            targetName: null,
+            columns: aggregateColumns,
+            groupByColumns,
+            filters: [],
+            joinKey: null,
+            joinType: null,
+        });
+    }
+    // Add filter to the last step if detected
+    if (hasFilter && steps.length > 0) {
+        const filters = extractFilters(intentText);
+        const lastStep = steps[steps.length - 1];
+        lastStep.filters.push(...filters);
+    }
+    if (steps.length === 0) {
+        openQuestions.push("Could not determine what pipeline operations to perform. " +
+            "Please describe the transformation (e.g., 'join CUSTOMERS and ORDERS on CUSTOMER_ID, then aggregate total REVENUE by REGION').");
+    }
+    return {
+        steps,
+        rawIntent: intentText,
+        warnings,
+        openQuestions,
+    };
+}
+//# sourceMappingURL=intent-parsing.js.map

package/dist/services/pipelines/intent-parsing.js.map

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

package/dist/services/pipelines/intent-resolution.d.ts

@@ -0,0 +1,24 @@
+import { type CoalesceClient } from "../../client.js";
+type ResolvedEntityCandidate = {
+    id: string;
+    name: string;
+    locationName: string | null;
+};
+export type ResolvedEntity = {
+    rawName: string;
+    confidence: "exact" | "fuzzy";
+    resolvedNodeID: string;
+    resolvedNodeName: string;
+    resolvedLocationName: string | null;
+    candidates: ResolvedEntityCandidate[];
+} | {
+    rawName: string;
+    confidence: "unresolved";
+    resolvedNodeID: null;
+    resolvedNodeName: null;
+    resolvedLocationName: null;
+    candidates: ResolvedEntityCandidate[];
+};
+export declare function resolveIntentEntities(client: CoalesceClient, workspaceID: string, entityNames: string[]): Promise<ResolvedEntity[]>;
+export {};
+//# sourceMappingURL=intent-resolution.d.ts.map

package/dist/services/pipelines/intent-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-resolution.d.ts","sourceRoot":"","sources":["../../../src/services/pipelines/intent-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAUtD,KAAK,uBAAuB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAEzF,MAAM,MAAM,cAAc,GACtB;IACE,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,UAAU,EAAE,uBAAuB,EAAE,CAAC;CACvC,GACD;IACE,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,YAAY,CAAC;IACzB,cAAc,EAAE,IAAI,CAAC;IACrB,gBAAgB,EAAE,IAAI,CAAC;IACvB,oBAAoB,EAAE,IAAI,CAAC;IAC3B,UAAU,EAAE,uBAAuB,EAAE,CAAC;CACvC,CAAC;AAwGN,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,cAAc,EAAE,CAAC,CA4D3B"}

package/dist/services/pipelines/intent-resolution.js

@@ -0,0 +1,141 @@
+import { listWorkspaceNodes } from "../../coalesce/api/nodes.js";
+import { isPlainObject } from "../../utils.js";
+import { normalizeSqlIdentifier } from "./sql-parsing.js";
+// ---------------------------------------------------------------------------
+// Workspace node listing
+// ---------------------------------------------------------------------------
+const WORKSPACE_NODE_PAGE_LIMIT = 200;
+async function listAllWorkspaceNodes(client, workspaceID) {
+    const nodes = [];
+    const seenCursors = new Set();
+    let next;
+    let isFirstPage = true;
+    while (isFirstPage || next) {
+        const response = await listWorkspaceNodes(client, {
+            workspaceID,
+            limit: WORKSPACE_NODE_PAGE_LIMIT,
+            orderBy: "id",
+            ...(next ? { startingFrom: next } : {}),
+        });
+        if (!isPlainObject(response)) {
+            throw new Error("Workspace node list response was not an object");
+        }
+        if (Array.isArray(response.data)) {
+            for (const item of response.data) {
+                if (!isPlainObject(item) || typeof item.id !== "string" || typeof item.name !== "string") {
+                    continue;
+                }
+                nodes.push({
+                    id: item.id,
+                    name: item.name,
+                    nodeType: typeof item.nodeType === "string" ? item.nodeType : null,
+                    locationName: typeof item.locationName === "string" ? item.locationName : null,
+                });
+            }
+        }
+        const responseNext = typeof response.next === "string" && response.next.trim().length > 0
+            ? response.next
+            : typeof response.next === "number"
+                ? String(response.next)
+                : undefined;
+        if (responseNext) {
+            if (seenCursors.has(responseNext)) {
+                throw new Error(`Workspace node pagination repeated cursor ${responseNext}`);
+            }
+            seenCursors.add(responseNext);
+        }
+        next = responseNext;
+        isFirstPage = false;
+    }
+    return nodes;
+}
+// ---------------------------------------------------------------------------
+// Fuzzy matching
+// ---------------------------------------------------------------------------
+function fuzzyMatchScore(queryNormalized, candidateNormalized) {
+    // Exact match
+    if (queryNormalized === candidateNormalized)
+        return 100;
+    // Candidate ends with the query (e.g. "CUSTOMERS" matches "STG_CUSTOMERS")
+    if (candidateNormalized.endsWith(`_${queryNormalized}`))
+        return 90;
+    // Candidate starts with the query
+    if (candidateNormalized.startsWith(`${queryNormalized}_`))
+        return 80;
+    // Query is contained in candidate
+    if (candidateNormalized.includes(queryNormalized))
+        return 70;
+    // Strip common prefixes and compare
+    const stripped = candidateNormalized.replace(/^(SRC[_-]?|STG[_-]?|DIM[_-]?|FACT[_-]?|FCT[_-]?|INT[_-]?|WORK[_-]?|WRK[_-]?|VW[_-]?|RAW[_-]?)/, "");
+    if (stripped === queryNormalized)
+        return 85;
+    // Pluralization — try adding/removing trailing S
+    const queryPlural = queryNormalized.endsWith("S")
+        ? queryNormalized.slice(0, -1)
+        : `${queryNormalized}S`;
+    if (candidateNormalized === queryPlural || stripped === queryPlural)
+        return 82;
+    if (candidateNormalized.endsWith(`_${queryPlural}`))
+        return 78;
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Entity resolution
+// ---------------------------------------------------------------------------
+export async function resolveIntentEntities(client, workspaceID, entityNames) {
+    const workspaceNodes = await listAllWorkspaceNodes(client, workspaceID);
+    const resolved = [];
+    for (const rawName of entityNames) {
+        const queryNormalized = normalizeSqlIdentifier(rawName);
+        const scored = workspaceNodes
+            .map((node) => ({
+            node,
+            score: fuzzyMatchScore(queryNormalized, normalizeSqlIdentifier(node.name)),
+        }))
+            .filter(({ score }) => score > 0)
+            .sort((a, b) => b.score - a.score);
+        if (scored.length === 0) {
+            resolved.push({
+                rawName,
+                resolvedNodeID: null,
+                resolvedNodeName: null,
+                resolvedLocationName: null,
+                confidence: "unresolved",
+                candidates: [],
+            });
+            continue;
+        }
+        const best = scored[0];
+        const topTier = scored.filter(({ score }) => score === best.score);
+        if (topTier.length === 1) {
+            resolved.push({
+                rawName,
+                resolvedNodeID: best.node.id,
+                resolvedNodeName: best.node.name,
+                resolvedLocationName: best.node.locationName,
+                confidence: best.score >= 85 ? "exact" : "fuzzy",
+                candidates: scored.slice(0, 5).map(({ node }) => ({
+                    id: node.id,
+                    name: node.name,
+                    locationName: node.locationName,
+                })),
+            });
+        }
+        else {
+            resolved.push({
+                rawName,
+                resolvedNodeID: null,
+                resolvedNodeName: null,
+                resolvedLocationName: null,
+                confidence: "unresolved",
+                candidates: topTier.map(({ node }) => ({
+                    id: node.id,
+                    name: node.name,
+                    locationName: node.locationName,
+                })),
+            });
+        }
+    }
+    return resolved;
+}
+//# sourceMappingURL=intent-resolution.js.map

package/dist/services/pipelines/intent-resolution.js.map

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

package/dist/services/pipelines/intent.d.ts

@@ -1,46 +1,8 @@
 import { type CoalesceClient } from "../../client.js";
-type IntentOperation = "stage" | "join" | "aggregate" | "union";
-type IntentColumn = {
-    name: string;
-    aggregateFunction: string | null;
-    expression: string | null;
-};
-type IntentStep = {
-    operation: IntentOperation;
-    entityNames: string[];
-    targetName: string | null;
-    columns: IntentColumn[];
-    groupByColumns: string[];
-    filters: string[];
-    joinKey: string | null;
-    joinType: "INNER" | "LEFT" | "FULL OUTER" | null;
-};
-export type ParsedIntent = {
-    steps: IntentStep[];
-    rawIntent: string;
-    warnings: string[];
-    openQuestions: string[];
-};
-type ResolvedEntityCandidate = {
-    id: string;
-    name: string;
-    locationName: string | null;
-};
-type ResolvedEntity = {
-    rawName: string;
-    confidence: "exact" | "fuzzy";
-    resolvedNodeID: string;
-    resolvedNodeName: string;
-    resolvedLocationName: string | null;
-    candidates: ResolvedEntityCandidate[];
-} | {
-    rawName: string;
-    confidence: "unresolved";
-    resolvedNodeID: null;
-    resolvedNodeName: null;
-    resolvedLocationName: null;
-    candidates: ResolvedEntityCandidate[];
-};
+export { parseIntent, type ParsedIntent } from "./intent-parsing.js";
+export { resolveIntentEntities, type ResolvedEntity } from "./intent-resolution.js";
+import { type ParsedIntent } from "./intent-parsing.js";
+import { type ResolvedEntity } from "./intent-resolution.js";
 export type IntentPipelineResult = {
     status: "ready" | "needs_clarification" | "needs_entity_resolution";
     intent: ParsedIntent;
@@ -49,8 +11,6 @@ export type IntentPipelineResult = {
     openQuestions: string[];
     warnings: string[];
 };
-export declare function parseIntent(intentText: string): ParsedIntent;
-export declare function resolveIntentEntities(client: CoalesceClient, workspaceID: string, entityNames: string[]): Promise<ResolvedEntity[]>;
 export declare function buildPipelinePlanFromIntent(client: CoalesceClient, params: {
     workspaceID: string;
     intent: string;
@@ -61,5 +21,4 @@ export declare function buildPipelinePlanFromIntent(client: CoalesceClient, para
     database?: string;
     schema?: string;
 }): Promise<IntentPipelineResult>;
-export {};
 //# sourceMappingURL=intent.d.ts.map

package/dist/services/pipelines/intent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../src/services/pipelines/intent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../src/services/pipelines/intent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAetD,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEpF,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAMpF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,OAAO,GAAG,qBAAqB,GAAG,yBAAyB,CAAC;IACpE,MAAM,EAAE,YAAY,CAAC;IACrB,gBAAgB,EAAE,cAAc,EAAE,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACrC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAuDF,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE;IACN,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC,oBAAoB,CAAC,CAwS/B"}