@grackle-ai/knowledge 0.62.2 → 0.64.0

package/dist/search.js

@@ -1,123 +0,0 @@
-/**
- * Vector-based semantic search across the knowledge graph.
- *
- * Embeds a text query, runs k-NN vector search against Neo4j's vector index,
- * and returns ranked results with similarity scores and immediate edges.
- *
- * @module
- */
-import { getSession } from "./client.js";
-import { logger } from "./logger.js";
-import { NODE_LABEL, VECTOR_INDEX_NAME } from "./constants.js";
-import { recordToNode, recordToEdge } from "./node-store.js";
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-/** Default number of results to return. */
-const DEFAULT_LIMIT = 10;
-/** Default minimum similarity score. */
-const DEFAULT_MIN_SCORE = 0;
-// ---------------------------------------------------------------------------
-// Cypher
-// ---------------------------------------------------------------------------
-/**
- * Build the Cypher query for vector search with optional filters.
- *
- * Neo4j's `db.index.vector.queryNodes` does not support WHERE clauses
- * directly, so we apply post-filters on the yielded results.
- */
-function buildSearchCypher(options) {
-    const filters = ["score >= $minScore"];
-    if (options.nodeKinds && options.nodeKinds.length > 0) {
-        filters.push("node.kind IN $nodeKinds");
-    }
-    if (options.workspaceId !== undefined) {
-        filters.push("node.workspaceId = $workspaceId");
-    }
-    const whereClause = filters.length > 0
-        ? `WHERE ${filters.join(" AND ")}`
-        : "";
-    // Neo4j requires integer literals for LIMIT and the vector query count.
-    return `
-    CALL db.index.vector.queryNodes($indexName, ${options.candidateLimit}, $queryVector)
-    YIELD node, score
-    ${whereClause}
-    WITH node, score
-    ORDER BY score DESC
-    LIMIT ${options.limit}
-    OPTIONAL MATCH (node)-[r]-(m:${NODE_LABEL})
-    RETURN node, score,
-      collect(DISTINCT {
-        fromId: CASE WHEN startNode(r) = node THEN node.id ELSE m.id END,
-        toId: CASE WHEN endNode(r) = node THEN node.id ELSE m.id END,
-        type: type(r),
-        metadata: r.metadata,
-        createdAt: r.createdAt
-      }) AS edges`;
-}
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-/**
- * Search the knowledge graph by semantic similarity.
- *
- * Embeds the query text, runs k-NN vector search in Neo4j, and returns
- * ranked results with similarity scores and immediate edges.
- *
- * @param query - The text to search for.
- * @param embedder - Produces the query embedding vector.
- * @param options - Optional search filters and limits.
- * @returns Ranked search results, highest similarity first.
- */
-export async function knowledgeSearch(query, embedder, options) {
-    const limit = options?.limit ?? DEFAULT_LIMIT;
-    const minScore = options?.minScore ?? DEFAULT_MIN_SCORE;
-    // Embed the query
-    const { vector: queryVector } = await embedder.embed(query);
-    // Over-fetch when filtering so we still get enough results after post-filter
-    const hasFilters = !!(options?.nodeKinds?.length || options?.workspaceId !== undefined);
-    const candidateLimit = hasFilters ? limit * 3 : limit;
-    const cypher = buildSearchCypher({
-        limit,
-        candidateLimit,
-        nodeKinds: options?.nodeKinds,
-        workspaceId: options?.workspaceId,
-    });
-    const params = {
-        indexName: VECTOR_INDEX_NAME,
-        queryVector,
-        minScore,
-        ...(options?.nodeKinds ? { nodeKinds: options.nodeKinds } : {}),
-        ...(options?.workspaceId !== undefined ? { workspaceId: options.workspaceId } : {}),
-    };
-    const session = getSession();
-    try {
-        const result = await session.run(cypher, params);
-        const searchResults = result.records.map((record) => {
-            const neo4jNode = record.get("node");
-            const nodeProps = neo4jNode.properties;
-            const score = record.get("score");
-            const rawEdges = record.get("edges");
-            // Filter out null edges (from OPTIONAL MATCH with no relationships)
-            const edges = rawEdges
-                .filter((e) => e.fromId !== null && e.toId !== null)
-                .map(recordToEdge);
-            return {
-                node: recordToNode(nodeProps),
-                score,
-                edges,
-            };
-        });
-        logger.debug({ query: query.substring(0, 50), results: searchResults.length, limit }, "Knowledge search completed");
-        return searchResults;
-    }
-    finally {
-        try {
-            await session.close();
-        }
-        catch (closeError) {
-            logger.warn({ err: closeError }, "Failed to close session after knowledgeSearch");
-        }
-    }
-}
-//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/transcript-chunker.d.ts

@@ -1,29 +0,0 @@
-/**
- * Session transcript chunker that splits JSONL session logs by conversation turn.
- *
- * Accepts the raw JSONL content of a session's `stream.jsonl` file and groups
- * events into semantic turns (user input → agent response) for embedding.
- *
- * @module
- */
-import type { Chunker } from "./chunker.js";
-/** Options for the session transcript chunker. */
-export interface TranscriptChunkerOptions {
-    /** Max characters per chunk before splitting (default 4000). */
-    maxChunkSize?: number;
-    /** Event types to skip (default: status, signal, usage, system). */
-    skipEventTypes?: string[];
-}
-/**
- * Create a chunker that splits JSONL session transcripts by conversation turn.
- *
- * A "turn" starts at a `user_input` event and includes all subsequent events
- * until the next `user_input`. Events before the first `user_input` are grouped
- * into an initial turn (turn 0). Turns exceeding {@link TranscriptChunkerOptions.maxChunkSize}
- * are split into sub-chunks.
- *
- * @param options - Optional chunker configuration.
- * @returns A {@link Chunker} for session transcript JSONL content.
- */
-export declare function createTranscriptChunker(options?: TranscriptChunkerOptions): Chunker;
-//# sourceMappingURL=transcript-chunker.d.ts.map

package/dist/transcript-chunker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transcript-chunker.d.ts","sourceRoot":"","sources":["../src/transcript-chunker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAS,OAAO,EAAE,MAAM,cAAc,CAAC;AAgBnD,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAmBD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAkDnF"}

package/dist/transcript-chunker.js

@@ -1,142 +0,0 @@
-/**
- * Session transcript chunker that splits JSONL session logs by conversation turn.
- *
- * Accepts the raw JSONL content of a session's `stream.jsonl` file and groups
- * events into semantic turns (user input → agent response) for embedding.
- *
- * @module
- */
-/** Default event types that are excluded from chunks. */
-const DEFAULT_SKIP_TYPES = ["status", "signal", "usage", "system"];
-/** Default maximum characters per chunk. */
-const DEFAULT_MAX_CHUNK_SIZE = 4000;
-/** Labels used when rendering events into readable text. */
-const EVENT_LABELS = {
-    user_input: "User",
-    text: "Assistant",
-    tool_use: "Tool",
-    tool_result: "Result",
-    error: "Error",
-    finding: "Finding",
-    subtask_create: "Subtask",
-};
-/**
- * Create a chunker that splits JSONL session transcripts by conversation turn.
- *
- * A "turn" starts at a `user_input` event and includes all subsequent events
- * until the next `user_input`. Events before the first `user_input` are grouped
- * into an initial turn (turn 0). Turns exceeding {@link TranscriptChunkerOptions.maxChunkSize}
- * are split into sub-chunks.
- *
- * @param options - Optional chunker configuration.
- * @returns A {@link Chunker} for session transcript JSONL content.
- */
-export function createTranscriptChunker(options) {
-    const maxChunkSize = options?.maxChunkSize ?? DEFAULT_MAX_CHUNK_SIZE;
-    const skipTypes = new Set(options?.skipEventTypes ?? DEFAULT_SKIP_TYPES);
-    return {
-        chunk(content, metadata) {
-            const entries = parseJsonl(content);
-            if (entries.length === 0) {
-                return [];
-            }
-            // Group on all entries first so user_input boundaries are preserved
-            // even if user_input is in skipTypes. Filter when rendering.
-            const turns = groupByTurn(entries);
-            const chunks = [];
-            for (let turnIndex = 0; turnIndex < turns.length; turnIndex++) {
-                const turnEntries = turns[turnIndex];
-                const visible = turnEntries.filter((e) => !skipTypes.has(e.type));
-                if (visible.length === 0) {
-                    continue;
-                }
-                const text = renderTurn(visible);
-                const timestamps = visible.map((e) => e.timestamp);
-                const eventTypes = [...new Set(visible.map((e) => e.type))];
-                const turnMetadata = {
-                    ...metadata,
-                    turnIndex,
-                    timestampStart: timestamps[0],
-                    timestampEnd: timestamps[timestamps.length - 1],
-                    eventTypes,
-                };
-                if (text.length <= maxChunkSize) {
-                    chunks.push({ text, index: chunks.length, metadata: turnMetadata });
-                }
-                else {
-                    const subChunks = splitText(text, maxChunkSize);
-                    for (const subChunk of subChunks) {
-                        chunks.push({ text: subChunk, index: chunks.length, metadata: turnMetadata });
-                    }
-                }
-            }
-            return chunks;
-        },
-    };
-}
-/** Parse a JSONL string into an array of log entries, skipping malformed lines. */
-function parseJsonl(content) {
-    const entries = [];
-    for (const line of content.split("\n")) {
-        const trimmed = line.trim();
-        if (!trimmed) {
-            continue;
-        }
-        try {
-            entries.push(JSON.parse(trimmed));
-        }
-        catch {
-            // Skip malformed lines
-        }
-    }
-    return entries;
-}
-/** Group log entries into turns, splitting on `user_input` events. */
-function groupByTurn(entries) {
-    const turns = [];
-    let current = [];
-    for (const entry of entries) {
-        if (entry.type === "user_input" && current.length > 0) {
-            turns.push(current);
-            current = [];
-        }
-        current.push(entry);
-    }
-    if (current.length > 0) {
-        turns.push(current);
-    }
-    return turns;
-}
-/** Render a turn's events into human-readable text. */
-function renderTurn(entries) {
-    return entries
-        .map((e) => {
-        const label = EVENT_LABELS[e.type] ?? e.type;
-        return `${label}: ${e.content}`;
-    })
-        .join("\n");
-}
-/**
- * Split text into sub-chunks at line boundaries, targeting at most maxSize characters.
- * A single line longer than maxSize will be emitted as-is (not split mid-line).
- */
-function splitText(text, maxSize) {
-    const lines = text.split("\n");
-    const subChunks = [];
-    let current = "";
-    for (const line of lines) {
-        const candidate = current ? current + "\n" + line : line;
-        if (candidate.length > maxSize && current) {
-            subChunks.push(current);
-            current = line;
-        }
-        else {
-            current = candidate;
-        }
-    }
-    if (current) {
-        subChunks.push(current);
-    }
-    return subChunks;
-}
-//# sourceMappingURL=transcript-chunker.js.map

package/dist/transcript-chunker.js.map

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

package/dist/types.d.ts

@@ -1,102 +0,0 @@
-/**
- * Core domain types for the knowledge graph.
- *
- * Defines the two node kinds (reference and native), edge types, and
- * runtime type guards for discriminating between node variants.
- *
- * @module
- */
-/** Discriminator for knowledge graph node kinds. */
-export declare const NODE_KIND: {
-    /** Points to an entity in Grackle's relational DB. No duplicated content. */
-    readonly REFERENCE: "reference";
-    /** Exists only in the graph. Owns its content. */
-    readonly NATIVE: "native";
-};
-/** Union of all node kind values. */
-export type NodeKind = (typeof NODE_KIND)[keyof typeof NODE_KIND];
-/** Entity types that a reference node can point to. */
-export declare const REFERENCE_SOURCE: {
-    readonly TASK: "task";
-    readonly SESSION: "session";
-    readonly FINDING: "finding";
-    readonly WORKSPACE: "workspace";
-};
-/** Union of all reference source values. */
-export type ReferenceSource = (typeof REFERENCE_SOURCE)[keyof typeof REFERENCE_SOURCE];
-/** Categories for native nodes that exist only in the knowledge graph. */
-export declare const NATIVE_CATEGORY: {
-    readonly DECISION: "decision";
-    readonly INSIGHT: "insight";
-    readonly CONCEPT: "concept";
-    readonly SNIPPET: "snippet";
-};
-/** Union of all native category values. */
-export type NativeCategory = (typeof NATIVE_CATEGORY)[keyof typeof NATIVE_CATEGORY];
-/** Relationship types between knowledge graph nodes. */
-export declare const EDGE_TYPE: {
-    readonly RELATES_TO: "RELATES_TO";
-    readonly DEPENDS_ON: "DEPENDS_ON";
-    readonly DERIVED_FROM: "DERIVED_FROM";
-    readonly MENTIONS: "MENTIONS";
-    readonly PART_OF: "PART_OF";
-};
-/** Union of all edge type values. */
-export type EdgeType = (typeof EDGE_TYPE)[keyof typeof EDGE_TYPE];
-/** Properties common to all knowledge graph nodes. */
-export interface KnowledgeNodeBase {
-    /** Unique node identifier (UUID). */
-    id: string;
-    /** Which kind of node this is. */
-    kind: NodeKind;
-    /** Dense vector embedding for similarity search. */
-    embedding: number[];
-    /** ISO 8601 creation timestamp. */
-    createdAt: string;
-    /** ISO 8601 last-updated timestamp. */
-    updatedAt: string;
-    /** Workspace scope (empty string = global). */
-    workspaceId: string;
-}
-/** A reference node — points to an entity in Grackle's relational DB. */
-export interface ReferenceNode extends KnowledgeNodeBase {
-    kind: typeof NODE_KIND.REFERENCE;
-    /** Which entity type this refers to. */
-    sourceType: ReferenceSource;
-    /** The ID of the entity in Grackle's relational DB. */
-    sourceId: string;
-    /** Human-readable label derived from the source (e.g., task title). */
-    label: string;
-}
-/** A native node — owns its content directly. */
-export interface NativeNode extends KnowledgeNodeBase {
-    kind: typeof NODE_KIND.NATIVE;
-    /** Subcategory of the native node. */
-    category: NativeCategory;
-    /** Title or summary. */
-    title: string;
-    /** Full content owned by this node. */
-    content: string;
-    /** Free-form tags for categorization. */
-    tags: string[];
-}
-/** Discriminated union of all knowledge graph node types. */
-export type KnowledgeNode = ReferenceNode | NativeNode;
-/** An edge (relationship) in the knowledge graph. */
-export interface KnowledgeEdge {
-    /** Source node ID. */
-    fromId: string;
-    /** Target node ID. */
-    toId: string;
-    /** Relationship type. */
-    type: EdgeType;
-    /** Optional metadata (e.g., confidence score, context snippet). */
-    metadata?: Record<string, unknown>;
-    /** ISO 8601 timestamp when the edge was created. */
-    createdAt: string;
-}
-/** Returns true if the node is a {@link ReferenceNode}. */
-export declare function isReferenceNode(node: KnowledgeNode): node is ReferenceNode;
-/** Returns true if the node is a {@link NativeNode}. */
-export declare function isNativeNode(node: KnowledgeNode): node is NativeNode;
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,oDAAoD;AACpD,eAAO,MAAM,SAAS;IACpB,6EAA6E;;IAE7E,kDAAkD;;CAE1C,CAAC;AAEX,qCAAqC;AACrC,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAMlE,uDAAuD;AACvD,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAEX,4CAA4C;AAC5C,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAM3D,0EAA0E;AAC1E,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AAEX,2CAA2C;AAC3C,MAAM,MAAM,cAAc,GACxB,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAMzD,wDAAwD;AACxD,eAAO,MAAM,SAAS;;;;;;CAMZ,CAAC;AAEX,qCAAqC;AACrC,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAMlE,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,oDAAoD;IACpD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,IAAI,EAAE,OAAO,SAAS,CAAC,SAAS,CAAC;IACjC,wCAAwC;IACxC,UAAU,EAAE,eAAe,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iDAAiD;AACjD,MAAM,WAAW,UAAW,SAAQ,iBAAiB;IACnD,IAAI,EAAE,OAAO,SAAS,CAAC,MAAM,CAAC;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,cAAc,CAAC;IACzB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,6DAA6D;AAC7D,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,UAAU,CAAC;AAMvD,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,IAAI,aAAa,CAE1E;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,IAAI,UAAU,CAEpE"}

package/dist/types.js

@@ -1,61 +0,0 @@
-/**
- * Core domain types for the knowledge graph.
- *
- * Defines the two node kinds (reference and native), edge types, and
- * runtime type guards for discriminating between node variants.
- *
- * @module
- */
-// ---------------------------------------------------------------------------
-// Node kind discriminator
-// ---------------------------------------------------------------------------
-/** Discriminator for knowledge graph node kinds. */
-export const NODE_KIND = {
-    /** Points to an entity in Grackle's relational DB. No duplicated content. */
-    REFERENCE: "reference",
-    /** Exists only in the graph. Owns its content. */
-    NATIVE: "native",
-};
-// ---------------------------------------------------------------------------
-// Reference node source types
-// ---------------------------------------------------------------------------
-/** Entity types that a reference node can point to. */
-export const REFERENCE_SOURCE = {
-    TASK: "task",
-    SESSION: "session",
-    FINDING: "finding",
-    WORKSPACE: "workspace",
-};
-// ---------------------------------------------------------------------------
-// Native node categories
-// ---------------------------------------------------------------------------
-/** Categories for native nodes that exist only in the knowledge graph. */
-export const NATIVE_CATEGORY = {
-    DECISION: "decision",
-    INSIGHT: "insight",
-    CONCEPT: "concept",
-    SNIPPET: "snippet",
-};
-// ---------------------------------------------------------------------------
-// Edge types
-// ---------------------------------------------------------------------------
-/** Relationship types between knowledge graph nodes. */
-export const EDGE_TYPE = {
-    RELATES_TO: "RELATES_TO",
-    DEPENDS_ON: "DEPENDS_ON",
-    DERIVED_FROM: "DERIVED_FROM",
-    MENTIONS: "MENTIONS",
-    PART_OF: "PART_OF",
-};
-// ---------------------------------------------------------------------------
-// Type guards
-// ---------------------------------------------------------------------------
-/** Returns true if the node is a {@link ReferenceNode}. */
-export function isReferenceNode(node) {
-    return node.kind === NODE_KIND.REFERENCE;
-}
-/** Returns true if the node is a {@link NativeNode}. */
-export function isNativeNode(node) {
-    return node.kind === NODE_KIND.NATIVE;
-}
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,oDAAoD;AACpD,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,6EAA6E;IAC7E,SAAS,EAAE,WAAW;IACtB,kDAAkD;IAClD,MAAM,EAAE,QAAQ;CACR,CAAC;AAKX,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,uDAAuD;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;CACd,CAAC;AAMX,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,0EAA0E;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACV,CAAC;AAMX,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,wDAAwD;AACxD,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,cAAc;IAC5B,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;CACV,CAAC;AAsEX,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,2DAA2D;AAC3D,MAAM,UAAU,eAAe,CAAC,IAAmB;IACjD,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,SAAS,CAAC;AAC3C,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,MAAM,CAAC;AACxC,CAAC"}