claudecode-rlm 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 tekcin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,209 @@
+# claudecode-rlm
+
+**Advanced RLM (Recursive Language Model) plugin for [Claude Code](https://github.com/tekcin/claude-code) - Knowledge graph-based context storage with 74x faster reads.**
+
+**Author:** Michael Thornton (tekcin@yahoo.com)
+**Repository:** https://github.com/tekcin/claudecode-rlm
+
+## Features
+
+- **Automatic Context Injection** - Proactively injects relevant context when reference patterns detected
+- **Knowledge Graph Storage** - Hierarchical context storage (Document → Section → Chunk → Entity)
+- **74x Faster Reads** - LRU cache with inverted index for instant retrieval
+- **40+ Reference Patterns** - Extended pattern detection for context references
+- **Enhanced Hybrid Search** - Keyword matching with recency weighting and entity boost
+- **Entity Extraction** - Automatic extraction of code elements, files, and concepts
+- **Custom Tools** - `graph_query`, `memory_enhanced`, `list_entities`, `graph_stats`
+
+## Installation
+
+```bash
+npm install claudecode-rlm
+```
+
+Or add to your Claude Code configuration:
+
+```jsonc
+// .claude/claudecode.jsonc
+{
+  "plugin": ["claudecode-rlm"],
+  "claudecode-rlm": {
+    "graph": {
+      "enabled": true,
+      "auto_ingest": true
+    },
+    "enhanced_search": {
+      "additional_patterns": true,
+      "recency_weight": 0.3,
+      "entity_boost": 0.2
+    }
+  }
+}
+```
+
+## Performance
+
+Benchmarks comparing basic vs optimized storage (10,000 nodes):
+
+| Operation | Basic | Optimized | Speedup |
+|-----------|-------|-----------|---------|
+| Node reads | 21.3µs | 0.3µs | **74x** |
+| Get by type | 1.1ms | 21µs | **54x** |
+| Bulk insert | 6.07s | 1.21s | **5x** |
+| Search | 0.45ms | 0.65ms | ~1x |
+
+The LRU cache achieves **100% hit rate** after initial population, ideal for read-heavy RLM workloads.
+
+## Architecture
+
+### Knowledge Graph Structure
+
+```
+Document (archived context block)
+├── Section (markdown header or paragraph group)
+│   ├── Chunk (retrieval unit, ~300 chars)
+│   │   ├── Entity (code element)
+│   │   ├── Entity (file path)
+│   │   └── Entity (concept)
+│   └── Chunk
+│       └── [FOLLOWS] → next chunk
+└── Section
+```
+
+### Storage Optimizations
+
+1. **LRU Cache** (2000 nodes/session) - Eliminates repeated disk reads
+2. **Inverted Index** - O(1) keyword lookup instead of O(n) scan
+3. **Batched Writes** - Flushes every 100ms or 50 ops, reducing I/O ~90%
+
+### Reference Patterns
+
+The plugin detects 40+ patterns that trigger proactive context retrieval:
+
+```javascript
+// Explicit memory references
+"do you remember..."
+"we discussed..."
+"earlier we..."
+
+// Task references
+"what did we do..."
+"where were we..."
+"let's continue..."
+
+// Code references
+"that function we..."
+"the class that..."
+"the file where..."
+```
+
+## Configuration
+
+```jsonc
+{
+  "claudecode-rlm": {
+    "graph": {
+      "enabled": true,           // Enable graph features
+      "auto_ingest": true,       // Auto-ingest archived context
+      "max_traversal_nodes": 50, // Max nodes in traversal
+      "max_traversal_depth": 3   // Max BFS depth
+    },
+    "enhanced_search": {
+      "additional_patterns": true, // Use extended patterns
+      "recency_weight": 0.3,       // Recency scoring weight (0-1)
+      "entity_boost": 0.2,         // Entity match boost (0-1)
+      "max_age_days": 30,          // Max age for recency
+      "min_score_threshold": 0.3   // Min score for results
+    },
+    "task_detection": {
+      "auto_archive_on_completion": true
+    }
+  }
+}
+```
+
+## Tools
+
+### graph_query
+
+Query the knowledge graph directly:
+
+```
+Operations:
+- search: Find chunks matching a query
+- entity: Find chunks mentioning an entity
+- expand: Get related context around a node
+- path: Find connection between entities
+```
+
+### memory_enhanced
+
+Search with enhanced scoring:
+
+```
+- Keyword matching with recency weighting
+- Entity-aware boosting
+- Graph traversal for related context
+```
+
+### list_entities
+
+List tracked entities (code elements, files, concepts).
+
+### graph_stats
+
+Get knowledge graph statistics and cache performance.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Type check
+npm run typecheck
+
+# Build
+npm run build
+
+# Run benchmarks
+npm run test
+npm run test:optimized
+```
+
+## How It Works
+
+1. **Context Archival**: When Claude Code archives context (RLM threshold reached), claudecode-rlm:
+   - Creates a Document node for the archived block
+   - Splits content into Sections (by headers or paragraphs)
+   - Chunks sections into retrieval units (~300 chars with overlap)
+   - Extracts entities (code elements, file paths, concepts)
+   - Links everything with typed edges
+
+2. **Context Injection**: When a user message matches reference patterns (e.g., "do you remember...", "we discussed..."):
+   - claudecode-rlm detects the pattern via `experimental.chat.messages.transform` hook
+   - Searches the inverted index for matching chunks
+   - Boosts results by entity matches and recency
+   - Expands context via graph traversal
+   - **Injects relevant context into the message stream before the LLM sees it**
+
+3. **Caching**: The LRU cache ensures:
+   - Recently accessed nodes are instant to retrieve
+   - Cache hit rate approaches 100% in typical usage
+   - Memory usage bounded by cache size (2000 nodes)
+
+## License
+
+MIT
+
+## Author
+
+**Michael Thornton**
+- Email: tekcin@yahoo.com
+- GitHub: [@tekcin](https://github.com/tekcin)
+
+## Links
+
+- [claudecode-rlm Repository](https://github.com/tekcin/claudecode-rlm)
+- [Claude Code](https://github.com/tekcin/claude-code)
+- [Issues](https://github.com/tekcin/claudecode-rlm/issues)

package/dist/config.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Plugin configuration schema.
+ *
+ * Configuration is loaded from .claude/claudecode.jsonc under the
+ * "claudecode-rlm" key.
+ */
+import { z } from "zod";
+/**
+ * Graph configuration schema.
+ */
+export declare const GraphConfigSchema: z.ZodObject<{
+    /** Whether graph features are enabled */
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    /** Whether to automatically ingest archived context into graph */
+    auto_ingest: z.ZodDefault<z.ZodBoolean>;
+    /** Maximum nodes to traverse in a search */
+    max_traversal_nodes: z.ZodDefault<z.ZodNumber>;
+    /** Maximum depth for graph traversal */
+    max_traversal_depth: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    auto_ingest: boolean;
+    max_traversal_nodes: number;
+    max_traversal_depth: number;
+}, {
+    enabled?: boolean | undefined;
+    auto_ingest?: boolean | undefined;
+    max_traversal_nodes?: number | undefined;
+    max_traversal_depth?: number | undefined;
+}>;
+/**
+ * Enhanced search configuration schema.
+ */
+export declare const EnhancedSearchConfigSchema: z.ZodObject<{
+    /** Use additional reference patterns from PinkyClawd */
+    additional_patterns: z.ZodDefault<z.ZodBoolean>;
+    /** Weight for recency in scoring (0-1) */
+    recency_weight: z.ZodDefault<z.ZodNumber>;
+    /** Weight for entity matches in scoring (0-1) */
+    entity_boost: z.ZodDefault<z.ZodNumber>;
+    /** Maximum age in days for recency scoring */
+    max_age_days: z.ZodDefault<z.ZodNumber>;
+    /** Minimum score threshold for results */
+    min_score_threshold: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    additional_patterns: boolean;
+    recency_weight: number;
+    entity_boost: number;
+    max_age_days: number;
+    min_score_threshold: number;
+}, {
+    additional_patterns?: boolean | undefined;
+    recency_weight?: number | undefined;
+    entity_boost?: number | undefined;
+    max_age_days?: number | undefined;
+    min_score_threshold?: number | undefined;
+}>;
+/**
+ * Task detection configuration schema.
+ */
+export declare const TaskDetectionConfigSchema: z.ZodObject<{
+    /** Archive context when task completion is detected */
+    auto_archive_on_completion: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    auto_archive_on_completion: boolean;
+}, {
+    auto_archive_on_completion?: boolean | undefined;
+}>;
+/**
+ * Full plugin configuration schema.
+ */
+export declare const PluginConfigSchema: z.ZodObject<{
+    /** Graph-based context storage */
+    graph: z.ZodDefault<z.ZodObject<{
+        /** Whether graph features are enabled */
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        /** Whether to automatically ingest archived context into graph */
+        auto_ingest: z.ZodDefault<z.ZodBoolean>;
+        /** Maximum nodes to traverse in a search */
+        max_traversal_nodes: z.ZodDefault<z.ZodNumber>;
+        /** Maximum depth for graph traversal */
+        max_traversal_depth: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        auto_ingest: boolean;
+        max_traversal_nodes: number;
+        max_traversal_depth: number;
+    }, {
+        enabled?: boolean | undefined;
+        auto_ingest?: boolean | undefined;
+        max_traversal_nodes?: number | undefined;
+        max_traversal_depth?: number | undefined;
+    }>>;
+    /** Enhanced search settings */
+    enhanced_search: z.ZodDefault<z.ZodObject<{
+        /** Use additional reference patterns from PinkyClawd */
+        additional_patterns: z.ZodDefault<z.ZodBoolean>;
+        /** Weight for recency in scoring (0-1) */
+        recency_weight: z.ZodDefault<z.ZodNumber>;
+        /** Weight for entity matches in scoring (0-1) */
+        entity_boost: z.ZodDefault<z.ZodNumber>;
+        /** Maximum age in days for recency scoring */
+        max_age_days: z.ZodDefault<z.ZodNumber>;
+        /** Minimum score threshold for results */
+        min_score_threshold: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        additional_patterns: boolean;
+        recency_weight: number;
+        entity_boost: number;
+        max_age_days: number;
+        min_score_threshold: number;
+    }, {
+        additional_patterns?: boolean | undefined;
+        recency_weight?: number | undefined;
+        entity_boost?: number | undefined;
+        max_age_days?: number | undefined;
+        min_score_threshold?: number | undefined;
+    }>>;
+    /** Task detection settings */
+    task_detection: z.ZodDefault<z.ZodObject<{
+        /** Archive context when task completion is detected */
+        auto_archive_on_completion: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        auto_archive_on_completion: boolean;
+    }, {
+        auto_archive_on_completion?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    graph: {
+        enabled: boolean;
+        auto_ingest: boolean;
+        max_traversal_nodes: number;
+        max_traversal_depth: number;
+    };
+    enhanced_search: {
+        additional_patterns: boolean;
+        recency_weight: number;
+        entity_boost: number;
+        max_age_days: number;
+        min_score_threshold: number;
+    };
+    task_detection: {
+        auto_archive_on_completion: boolean;
+    };
+}, {
+    graph?: {
+        enabled?: boolean | undefined;
+        auto_ingest?: boolean | undefined;
+        max_traversal_nodes?: number | undefined;
+        max_traversal_depth?: number | undefined;
+    } | undefined;
+    enhanced_search?: {
+        additional_patterns?: boolean | undefined;
+        recency_weight?: number | undefined;
+        entity_boost?: number | undefined;
+        max_age_days?: number | undefined;
+        min_score_threshold?: number | undefined;
+    } | undefined;
+    task_detection?: {
+        auto_archive_on_completion?: boolean | undefined;
+    } | undefined;
+}>;
+export type PluginConfig = z.infer<typeof PluginConfigSchema>;
+/**
+ * Default configuration.
+ */
+export declare const DEFAULT_CONFIG: PluginConfig;
+/**
+ * Parse and validate configuration.
+ */
+export declare function parseConfig(config: unknown): PluginConfig;
+/**
+ * Merge partial config with defaults.
+ */
+export declare function mergeConfig(partial: Partial<PluginConfig>): PluginConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,yCAAyC;;IAEzC,kEAAkE;;IAElE,4CAA4C;;IAE5C,wCAAwC;;;;;;;;;;;;EAExC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B;IACrC,wDAAwD;;IAExD,0CAA0C;;IAE1C,iDAAiD;;IAEjD,8CAA8C;;IAE9C,0CAA0C;;;;;;;;;;;;;;EAE1C,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB;IACpC,uDAAuD;;;;;;EAEvD,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B,kCAAkC;;QAtClC,yCAAyC;;QAEzC,kEAAkE;;QAElE,4CAA4C;;QAE5C,wCAAwC;;;;;;;;;;;;;IAkCxC,+BAA+B;;QA1B/B,wDAAwD;;QAExD,0CAA0C;;QAE1C,iDAAiD;;QAEjD,8CAA8C;;QAE9C,0CAA0C;;;;;;;;;;;;;;;IAoB1C,8BAA8B;;QAZ9B,uDAAuD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcvD,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,YAiB5B,CAAA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,CAOzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAYxE"}

package/dist/config.js

@@ -0,0 +1,103 @@
+/**
+ * Plugin configuration schema.
+ *
+ * Configuration is loaded from .claude/claudecode.jsonc under the
+ * "claudecode-rlm" key.
+ */
+import { z } from "zod";
+/**
+ * Graph configuration schema.
+ */
+export const GraphConfigSchema = z.object({
+    /** Whether graph features are enabled */
+    enabled: z.boolean().default(true),
+    /** Whether to automatically ingest archived context into graph */
+    auto_ingest: z.boolean().default(true),
+    /** Maximum nodes to traverse in a search */
+    max_traversal_nodes: z.number().default(50),
+    /** Maximum depth for graph traversal */
+    max_traversal_depth: z.number().default(3),
+});
+/**
+ * Enhanced search configuration schema.
+ */
+export const EnhancedSearchConfigSchema = z.object({
+    /** Use additional reference patterns from PinkyClawd */
+    additional_patterns: z.boolean().default(true),
+    /** Weight for recency in scoring (0-1) */
+    recency_weight: z.number().min(0).max(1).default(0.3),
+    /** Weight for entity matches in scoring (0-1) */
+    entity_boost: z.number().min(0).max(1).default(0.2),
+    /** Maximum age in days for recency scoring */
+    max_age_days: z.number().default(30),
+    /** Minimum score threshold for results */
+    min_score_threshold: z.number().default(0.3),
+});
+/**
+ * Task detection configuration schema.
+ */
+export const TaskDetectionConfigSchema = z.object({
+    /** Archive context when task completion is detected */
+    auto_archive_on_completion: z.boolean().default(true),
+});
+/**
+ * Full plugin configuration schema.
+ */
+export const PluginConfigSchema = z.object({
+    /** Graph-based context storage */
+    graph: GraphConfigSchema.default({}),
+    /** Enhanced search settings */
+    enhanced_search: EnhancedSearchConfigSchema.default({}),
+    /** Task detection settings */
+    task_detection: TaskDetectionConfigSchema.default({}),
+});
+/**
+ * Default configuration.
+ */
+export const DEFAULT_CONFIG = {
+    graph: {
+        enabled: true,
+        auto_ingest: true,
+        max_traversal_nodes: 50,
+        max_traversal_depth: 3,
+    },
+    enhanced_search: {
+        additional_patterns: true,
+        recency_weight: 0.3,
+        entity_boost: 0.2,
+        max_age_days: 30,
+        min_score_threshold: 0.3,
+    },
+    task_detection: {
+        auto_archive_on_completion: true,
+    },
+};
+/**
+ * Parse and validate configuration.
+ */
+export function parseConfig(config) {
+    try {
+        return PluginConfigSchema.parse(config ?? {});
+    }
+    catch {
+        // Return defaults on parse error
+        return DEFAULT_CONFIG;
+    }
+}
+/**
+ * Merge partial config with defaults.
+ */
+export function mergeConfig(partial) {
+    return {
+        graph: { ...DEFAULT_CONFIG.graph, ...partial.graph },
+        enhanced_search: {
+            ...DEFAULT_CONFIG.enhanced_search,
+            ...partial.enhanced_search,
+        },
+        task_detection: {
+            ...DEFAULT_CONFIG.task_detection,
+            ...partial.task_detection,
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/graph/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Graph module exports.
+ *
+ * RLM-Graph: Knowledge graph-based context storage and retrieval.
+ */
+export * from "./types.js";
+export { GraphStorage } from "./storage.js";
+export { EntityExtractor, ContentChunker, GraphIngester } from "./ingestion.js";
+export { GraphTraverser, GraphSearcher } from "./traversal.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC/E,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/graph/index.js

@@ -0,0 +1,10 @@
+/**
+ * Graph module exports.
+ *
+ * RLM-Graph: Knowledge graph-based context storage and retrieval.
+ */
+export * from "./types.js";
+export { GraphStorage } from "./storage.js";
+export { EntityExtractor, ContentChunker, GraphIngester } from "./ingestion.js";
+export { GraphTraverser, GraphSearcher } from "./traversal.js";
+//# sourceMappingURL=index.js.map

package/dist/graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC/E,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/graph/ingestion.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Graph ingestion: Entity extraction and content chunking.
+ *
+ * Provides utilities for processing text content:
+ * - EntityExtractor: Identifies named entities and code elements
+ * - ContentChunker: Splits content into hierarchical chunks
+ * - GraphIngester: Converts content into graph structure
+ */
+import { type GraphNode, type Entity } from "./types.js";
+/**
+ * Extracts entities from text content.
+ */
+export declare namespace EntityExtractor {
+    /**
+     * Extract entities from text.
+     */
+    function extract(text: string): Entity[];
+    /**
+     * Extract top keywords based on frequency.
+     */
+    function extractKeywords(text: string, topN?: number): string[];
+}
+/**
+ * Splits content into hierarchical chunks.
+ */
+export declare namespace ContentChunker {
+    /**
+     * Split content into sections.
+     */
+    function splitIntoSections(content: string, minChars?: number): Array<{
+        title: string;
+        content: string;
+    }>;
+    /**
+     * Split content into overlapping chunks.
+     */
+    function splitIntoChunks(content: string, targetChars?: number, overlap?: number): string[];
+}
+/**
+ * Ingests content into the knowledge graph.
+ */
+export declare namespace GraphIngester {
+    /**
+     * Context block interface (compatible with Claude Code RLM types).
+     */
+    interface ContextBlock {
+        id: string;
+        sessionID: string;
+        content: string;
+        tokens: number;
+        summary?: string;
+        taskID?: string;
+        taskDescription?: string;
+        createdAt: number;
+    }
+    /**
+     * Ingest a context block into the graph.
+     */
+    function ingestContextBlock(block: ContextBlock): GraphNode;
+    /**
+     * Ingest messages into the graph.
+     */
+    function ingestMessages(sessionID: string, messages: Array<{
+        role: string;
+        content: string;
+    }>): GraphNode | null;
+}
+//# sourceMappingURL=ingestion.d.ts.map

package/dist/graph/ingestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingestion.d.ts","sourceRoot":"","sources":["../../src/graph/ingestion.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,MAAM,EAIZ,MAAM,YAAY,CAAA;AAsCnB;;GAEG;AACH,yBAAiB,eAAe,CAAC;IAe/B;;OAEG;IACH,SAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA2C9C;IAED;;OAEG;IACH,SAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,GAAG,MAAM,EAAE,CAgBzE;CACF;AAED;;GAEG;AACH,yBAAiB,cAAc,CAAC;IAK9B;;OAEG;IACH,SAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAkC,GAC3C,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CA+D3C;IAED;;OAEG;IACH,SAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAAmC,EAChD,OAAO,GAAE,MAA8B,GACtC,MAAM,EAAE,CAyCV;CACF;AAED;;GAEG;AACH,yBAAiB,aAAa,CAAC;IAc7B;;OAEG;IACH,UAAiB,YAAY;QAC3B,EAAE,EAAE,MAAM,CAAA;QACV,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,SAAS,EAAE,MAAM,CAAA;KAClB;IAED;;OAEG;IACH,SAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CA6CjE;IA+ID;;OAEG;IACH,SAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;KAChB,CAAC,GACD,SAAS,GAAG,IAAI,CAsBlB;CACF"}