specmem-hardwicksoftware 3.5.99

package/dist/claude-sessions/sessionIntegration.d.ts

@@ -0,0 +1,48 @@
+/**
+ * sessionIntegration.ts - Integrates  session watcher with SpecMem server
+ *
+ * yo fr fr this is the glue that connects the session watcher to the MCP server
+ * handles initialization, lifecycle, and tool registration
+ *
+ * Features:
+ * - Initializes session watcher on server start
+ * - Registers session extraction MCP tools
+ * - Handles graceful shutdown
+ */
+import { SessionWatcher } from './sessionWatcher.js';
+import { EmbeddingProvider } from '../tools/index.js';
+import { ExtractSessions } from '../tools/goofy/extractClaudeSessions.js';
+import { GetSessionWatcherStatus } from '../tools/goofy/getSessionWatcherStatus.js';
+/**
+ * initializeSessionWatcher - initializes and starts the  session watcher
+ *
+ * nah bruh this starts the auto-extraction magic
+ */
+export declare function initializeSessionWatcher(embeddingProvider: EmbeddingProvider): Promise<SessionWatcher | null>;
+/**
+ * shutdownSessionWatcher - gracefully shuts down the session watcher
+ *
+ * fr fr clean shutdown when server stops
+ * Can optionally shutdown a specific project's watcher or all watchers
+ */
+export declare function shutdownSessionWatcher(projectPath?: string): Promise<void>;
+/**
+ * shutdownAllSessionWatchers - gracefully shuts down all project session watchers
+ */
+export declare function shutdownAllSessionWatchers(): Promise<void>;
+/**
+ * getSessionWatcher - returns the active session watcher instance for current project
+ *
+ * yo get the watcher to check status or trigger manual extraction
+ */
+export declare function getSessionWatcher(projectPath?: string): SessionWatcher | null;
+/**
+ * createSessionExtractionTools - creates the MCP tools for session extraction
+ *
+ * nah bruh register these tools with the MCP server
+ */
+export declare function createSessionExtractionTools(embeddingProvider: EmbeddingProvider): {
+    extractTool: ExtractSessions;
+    statusTool: GetSessionWatcherStatus;
+};
+//# sourceMappingURL=sessionIntegration.d.ts.map

package/dist/claude-sessions/sessionIntegration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionIntegration.d.ts","sourceRoot":"","sources":["../../src/claude-sessions/sessionIntegration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,oBAAoB,EAAwB,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAepF;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAsDtC;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBhF;AAED;;GAEG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAYhE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAGnF;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,iBAAiB,EAAE,iBAAiB,GACnC;IACD,WAAW,EAAE,qBAAqB,CAAC;IACnC,UAAU,EAAE,uBAAuB,CAAC;CACrC,CAgBA"}

package/dist/claude-sessions/sessionIntegration.js

@@ -0,0 +1,146 @@
+/**
+ * sessionIntegration.ts - Integrates  session watcher with SpecMem server
+ *
+ * yo fr fr this is the glue that connects the session watcher to the MCP server
+ * handles initialization, lifecycle, and tool registration
+ *
+ * Features:
+ * - Initializes session watcher on server start
+ * - Registers session extraction MCP tools
+ * - Handles graceful shutdown
+ */
+import { logger } from '../utils/logger.js';
+import { getConfig, getProjectPath } from '../config.js';
+import { createSessionWatcher } from './sessionWatcher.js';
+import { getDatabase } from '../database.js';
+import { ExtractSessions } from '../tools/goofy/extractClaudeSessions.js';
+import { GetSessionWatcherStatus } from '../tools/goofy/getSessionWatcherStatus.js';
+// Per-project session watcher Map - prevents cross-project pollution
+const sessionWatcherByProject = new Map();
+/**
+ * Check if session watcher is enabled - READS ENV DIRECTLY
+ * This is the source of truth, bypassing any config caching issues
+ */
+function isSessionWatcherEnabled() {
+    const envVal = process.env['SPECMEM_SESSION_WATCHER_ENABLED'];
+    // Default to true if not set, check for explicit 'false'
+    return envVal !== 'false' && envVal !== '0';
+}
+/**
+ * initializeSessionWatcher - initializes and starts the  session watcher
+ *
+ * nah bruh this starts the auto-extraction magic
+ */
+export async function initializeSessionWatcher(embeddingProvider) {
+    // Check ENV VAR DIRECTLY - this is the source of truth!
+    const envEnabled = isSessionWatcherEnabled();
+    const configEnabled = getConfig().sessionWatcher?.enabled ?? false;
+    logger.info({
+        envEnabled,
+        configEnabled,
+        envValue: process.env['SPECMEM_SESSION_WATCHER_ENABLED'] ?? 'NOT_SET'
+    }, 'Session watcher initialization check');
+    // Use ENV as source of truth - config might be stale
+    if (!envEnabled) {
+        logger.info(' session watcher disabled (SPECMEM_SESSION_WATCHER_ENABLED=false)');
+        return null;
+    }
+    logger.info('initializing  session watcher');
+    try {
+        const db = getDatabase();
+        // Get config options with sensible defaults (config.sessionWatcher might be undefined)
+        const sessionConfig = getConfig().sessionWatcher;
+        const claudeDir = sessionConfig?.claudeDir ?? process.env['SPECMEM_SESSION_CLAUDE_DIR'];
+        const debounceMs = sessionConfig?.debounceMs ?? parseInt(process.env['SPECMEM_SESSION_DEBOUNCE_MS'] || '2000', 10);
+        const importance = sessionConfig?.importance ?? (process.env['SPECMEM_SESSION_IMPORTANCE'] || 'medium');
+        const additionalTags = sessionConfig?.additionalTags ?? (process.env['SPECMEM_SESSION_TAGS'] || '').split(',').filter(t => t.trim());
+        // create watcher and store in per-project Map
+        const projectPath = getProjectPath();
+        const watcher = createSessionWatcher(embeddingProvider, db, {
+            claudeDir,
+            debounceMs,
+            importance,
+            additionalTags,
+            autoStart: true // auto-start watching
+        });
+        sessionWatcherByProject.set(projectPath, watcher);
+        logger.info({
+            claudeDir: claudeDir ?? '~/.claude',
+            debounceMs,
+            importance,
+            tags: additionalTags,
+            projectPath
+        }, ' session watcher initialized successfully');
+        return watcher;
+    }
+    catch (error) {
+        logger.error({ error }, 'failed to initialize  session watcher');
+        return null;
+    }
+}
+/**
+ * shutdownSessionWatcher - gracefully shuts down the session watcher
+ *
+ * fr fr clean shutdown when server stops
+ * Can optionally shutdown a specific project's watcher or all watchers
+ */
+export async function shutdownSessionWatcher(projectPath) {
+    const targetProject = projectPath || getProjectPath();
+    const watcher = sessionWatcherByProject.get(targetProject);
+    if (!watcher) {
+        return;
+    }
+    logger.info({ projectPath: targetProject }, 'shutting down  session watcher');
+    try {
+        await watcher.stopWatching();
+        sessionWatcherByProject.delete(targetProject);
+        logger.info({ projectPath: targetProject }, ' session watcher shutdown complete');
+    }
+    catch (error) {
+        logger.error({ error, projectPath: targetProject }, 'error shutting down session watcher');
+    }
+}
+/**
+ * shutdownAllSessionWatchers - gracefully shuts down all project session watchers
+ */
+export async function shutdownAllSessionWatchers() {
+    logger.info({ count: sessionWatcherByProject.size }, 'shutting down all session watchers');
+    for (const [projectPath, watcher] of sessionWatcherByProject) {
+        try {
+            await watcher.stopWatching();
+            logger.info({ projectPath }, 'session watcher shutdown');
+        }
+        catch (error) {
+            logger.error({ error, projectPath }, 'error shutting down session watcher');
+        }
+    }
+    sessionWatcherByProject.clear();
+}
+/**
+ * getSessionWatcher - returns the active session watcher instance for current project
+ *
+ * yo get the watcher to check status or trigger manual extraction
+ */
+export function getSessionWatcher(projectPath) {
+    const targetProject = projectPath || getProjectPath();
+    return sessionWatcherByProject.get(targetProject) || null;
+}
+/**
+ * createSessionExtractionTools - creates the MCP tools for session extraction
+ *
+ * nah bruh register these tools with the MCP server
+ */
+export function createSessionExtractionTools(embeddingProvider) {
+    const db = getDatabase();
+    // create extraction tool
+    const extractTool = new ExtractSessions(embeddingProvider, db);
+    // create status tool
+    const statusTool = new GetSessionWatcherStatus();
+    // inject watcher instance if available for current project
+    const watcher = sessionWatcherByProject.get(getProjectPath());
+    if (watcher) {
+        statusTool.setSessionWatcher(watcher);
+    }
+    return { extractTool, statusTool };
+}
+//# sourceMappingURL=sessionIntegration.js.map

package/dist/claude-sessions/sessionIntegration.js.map

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

package/dist/claude-sessions/sessionParser.d.ts

@@ -0,0 +1,293 @@
+/**
+ * sessionParser.ts -  Code Session File Parser
+ *
+ * Parses  Code session files to extract conversations:
+ * - Reads from ~/.claude/history.jsonl (user prompts with metadata)
+ * - Reads from ~/.claude/projects/ directories (full conversations)
+ *
+ * Features:
+ * - Parses both history.jsonl and project session files (JSONL format)
+ * - Extracts USER messages and ASSISTANT messages
+ * - Extracts thinking blocks from 's responses
+ * - Extracts tool_use blocks for context
+ * - Tags messages properly: role:user, role:assistant, has-thinking
+ * - Formats content: [USER] prefix or [CLAUDE] prefix with [THINKING] blocks
+ * - Hash-based deduplication using session_id + timestamp
+ * - Chunked loading with ACK verification
+ *
+ * DEDUPLICATION STRATEGY (FIX MED-44):
+ * All entry points use standardized deduplication:
+ * - generateEntryHash: sessionId + timestamp (for session-level dedup)
+ * - generateContentHash: role + content (for content-level dedup)
+ * - CASE-SENSITIVE: Do NOT lowercase content (FIX MED-28)
+ *
+ * USER/CLAUDE PAIRING METADATA:
+ * convertToMemoryParams() sets these fields for find_memory pairing:
+ * - sessionId: Same for all messages in a session (enables grouping)
+ * - timestamp: ISO string from JSONL entry (when message was sent)
+ * - timestampMs: Numeric ms since epoch (efficient comparison/ordering)
+ * - role: 'user' or 'assistant' (message direction)
+ * - messageId: Unique ID for this message (from uuid field in JSONL)
+ */
+import { StoreMemoryParams, MemoryType, ImportanceLevelType } from '../types/index.js';
+import type { DatabaseManager } from '../database.js';
+/**
+ * Generate hash for deduplication based on session_id + timestamp
+ * LEGACY: Used for backwards compatibility with existing hashes
+ */
+export declare function generateEntryHash(sessionId: string, timestamp: number | string): string;
+/**
+ * Generate content hash for deduplication based on actual content
+ * This prevents storing the same message multiple times even if from different sources
+ *
+ * FIX MED-28: Removed .toLowerCase() - case normalization caused false deduplication
+ * where "Fix bug" and "FIX BUG" would be treated as the same message.
+ * We still normalize whitespace and remove prefixes but preserve case.
+ */
+export declare function generateContentHash(content: string, role: 'user' | 'assistant'): string;
+/**
+ * Message entry structure from session files (project/*.jsonl)
+ */
+export interface SessionMessageEntry {
+    type: 'user' | 'assistant' | 'file-history-snapshot' | 'system' | 'summary' | 'queue-operation';
+    userType?: string;
+    message?: {
+        role?: string;
+        content?: string | Array<{
+            type: string;
+            text?: string;
+            thinking?: string;
+            name?: string;
+            input?: unknown;
+        }>;
+        model?: string;
+        id?: string;
+    };
+    timestamp: number | string;
+    sessionId: string;
+    uuid: string;
+    parentUuid?: string;
+    cwd?: string;
+    project?: string;
+    teamMemberId?: string;
+}
+/**
+ * History.jsonl entry structure (user prompts only)
+ */
+export interface HistoryEntry {
+    display: string;
+    pastedContents: Record<string, unknown>;
+    timestamp: number;
+    project: string;
+    sessionId: string;
+}
+export type SessionEntry = HistoryEntry;
+/**
+ * Parsed session data with metadata
+ */
+export interface ParsedSession {
+    id: string;
+    hash: string;
+    content: string;
+    formattedContent: string;
+    role: 'user' | 'assistant';
+    timestamp: Date;
+    project: string;
+    sessionId: string;
+    messageId?: string;
+    model?: string;
+    thinking?: string;
+    toolCalls?: Array<{
+        name: string;
+        input: unknown;
+    }>;
+    pastedContent?: Record<string, unknown>;
+    isContextRestoration?: boolean;
+}
+/**
+ * Session extraction stats
+ */
+export interface SessionStats {
+    totalEntries: number;
+    validEntries: number;
+    invalidEntries: number;
+    uniqueSessions: number;
+    userMessages: number;
+    assistantMessages: number;
+    oldestEntry: Date | null;
+    newestEntry: Date | null;
+    projectsFound: Set<string>;
+}
+/**
+ * Rate limiting configuration for chunked loading
+ * Target: 100MB/s throughput
+ */
+export interface ChunkingConfig {
+    targetBytesPerSecond: number;
+    chunkDelayMs: number;
+    batchSize: number;
+}
+/**
+ * ACK result for verified database writes
+ */
+export interface AckResult {
+    success: boolean;
+    insertedId?: string;
+    error?: string;
+    hash: string;
+}
+/**
+ * SessionParser - parses  Code session files
+ *
+ * Reads from:
+ * - ~/.claude/history.jsonl (user prompts)
+ * - ~/.claude/projects/ directories (full conversations with assistant responses)
+ *
+ * PROJECT FILTERING (FIX Task #13):
+ * When projectPathFilter is provided, only parses session files that match the project.
+ * This prevents wasted parsing of sessions from other projects.
+ */
+export declare class SessionParser {
+    private claudeDir;
+    private projectsDir;
+    private historyPath;
+    private projectPathFilter;
+    constructor(claudeDir?: string, projectPathFilter?: string | null);
+    /**
+     * FIX Task #13: Set project path filter after construction
+     * Allows updating the filter for existing parser instances
+     */
+    setProjectPathFilter(projectPath: string | null): void;
+    /**
+     * Get all project directories containing session files
+     *
+     * FIX Task #13: When projectPathFilter is set, only returns directories
+     * that match the current project path (encoded in directory name).
+     * This enables early filtering BEFORE parsing files.
+     */
+    private getProjectDirectories;
+    /**
+     * Get all session files from all project directories
+     * SORTED BY MODIFICATION TIME (newest first) for efficient catch-up
+     */
+    private getAllSessionFiles;
+    /**
+     * parseAllSessions - reads ALL session files from history.jsonl and project directories
+     *
+     * Reads both user prompts and 's responses including thinking blocks
+     */
+    parseAllSessions(): Promise<ParsedSession[]>;
+    /**
+     * parseHistoryJsonl - parses the history.jsonl file (user prompts only)
+     *
+     * FIX HIGH-30: Added parse error stats and warning logs instead of silent skip
+     * FIX Task #13: Added early project filtering at entry level
+     */
+    private parseHistoryJsonl;
+    /**
+     * convertHistoryEntry - converts a history.jsonl entry to ParsedSession
+     */
+    private convertHistoryEntry;
+    /**
+     * parseSessionFile - reads and parses a single session file
+     *
+     * FIX HIGH-30: Added parse error stats and warning logs instead of silent skip
+     * FIX Task #13: Added early project filtering at entry level
+     */
+    parseSessionFile(filePath: string): Promise<ParsedSession[]>;
+    /**
+     * FIX Task #13: Check if a project path matches the filter
+     * Handles exact match, subdirectory match, and parent directory match
+     */
+    private matchesProjectFilter;
+    /**
+     * streamAllSessions - streams all session files with chunked loading and rate limiting
+     *
+     * Features:
+     * - NEWEST FIRST: Files sorted by mtime, entries reversed within each file
+     * - Memory-efficient: processes files in chunks
+     * - Rate limited: 100MB/s throughput via QOMS
+     * - Hash-based deduplication: skips entries with matching session_id + timestamp hash
+     * - EARLY EXIT: Stops processing a file after N consecutive duplicates (already indexed)
+     * - ACK logging: logs SKIP or INSERT for each entry
+     */
+    streamAllSessions(existingHashes: Set<string>, onBatch: (sessions: ParsedSession[]) => Promise<void>, batchSize?: number, config?: ChunkingConfig): Promise<{
+        total: number;
+        processed: number;
+        skipped: number;
+        bytesProcessed: number;
+        earlyExitFiles: number;
+        parseErrors: number;
+    }>;
+    /**
+     * convertMessageEntry - converts a session entry to ParsedSession
+     */
+    private convertMessageEntry;
+    /**
+     * parseHistoryFile - LEGACY: reads history.jsonl for backwards compatibility
+     * Now uses convertHistoryEntry for consistent formatting
+     */
+    parseHistoryFile(): Promise<ParsedSession[]>;
+    /**
+     * parseNewEntries - reads only new entries since a given timestamp
+     *
+     * FIX MED-47: Optimized to only parse files modified after sinceTimestamp
+     * Uses file mtime filtering + streaming with early exit to avoid re-parsing all sessions
+     */
+    parseNewEntries(sinceTimestamp: number): Promise<ParsedSession[]>;
+    /**
+     * getSessionStats - analyzes session files and returns stats
+     */
+    getSessionStats(): Promise<SessionStats>;
+    /**
+     * convertToMemoryParams - converts parsed sessions to memory storage params
+     *
+     * Uses formattedContent which includes:
+     * - [USER] prefix for user messages
+     * - [CLAUDE] prefix for assistant messages with [THINKING] blocks
+     *
+     * Tags include:
+     * - role:user or role:assistant
+     * - has-thinking for messages with thinking blocks
+     */
+    convertToMemoryParams(sessions: ParsedSession[], options?: {
+        importance?: ImportanceLevelType;
+        memoryType?: MemoryType;
+        additionalTags?: string[];
+    }): StoreMemoryParams[];
+    /**
+     * getLastProcessedTimestamp - helper to get the last processed timestamp from DB
+     */
+    getLastProcessedTimestamp(db: DatabaseManager): Promise<number>;
+    private isValidLegacyEntry;
+}
+/**
+ * Helper function to create parser with default config
+ *
+ * FIX Task #13: Now accepts optional projectPathFilter for early filtering.
+ * When provided, the parser will only process session files from directories
+ * that could match the specified project path, avoiding wasteful parsing.
+ */
+export declare function createSessionParser(claudeDir?: string, projectPathFilter?: string): SessionParser;
+/**
+ * isToolOrThinkingContent - checks if content is a tool call
+ * These should be SKIPPED from memory storage as they pollute the database
+ *
+ * Patterns to skip:
+ * - [Tools: ...] - tool call descriptions
+ * - [Tool: ...] - individual tool patterns
+ *
+ * NOTE: We KEEP thinking blocks - they contain valuable reasoning!
+ */
+export declare function isToolOrThinkingContent(content: string): boolean;
+/**
+ * isContextRestoration - detects context restoration summaries
+ *
+ * Context restorations are injected when 's context window overflows.
+ * They look like user messages but are actually system-generated summaries.
+ *
+ * These should be tagged differently so they don't pollute find_memory results
+ * for actual user prompts.
+ */
+export declare function isContextRestoration(content: string): boolean;
+//# sourceMappingURL=sessionParser.d.ts.map

package/dist/claude-sessions/sessionParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionParser.d.ts","sourceRoot":"","sources":["../../src/claude-sessions/sessionParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AASH,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAUvF;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAYvF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,uBAAuB,GAAG,QAAQ,GAAG,SAAS,GAAG,iBAAiB,CAAC;IAChG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;YACvB,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,OAAO,CAAC;SACjB,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IACF,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAQD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;GAUG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,iBAAiB,CAAgB;gBAE7B,SAAS,GAAE,MAAsC,EAAE,iBAAiB,GAAE,MAAM,GAAG,IAAW;IAOtG;;;OAGG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAItD;;;;;;OAMG;YACW,qBAAqB;IA0CnC;;;OAGG;YACW,kBAAkB;IA6ChC;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IA4BlD;;;;;OAKG;YACW,iBAAiB;IAsE/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0B3B;;;;;OAKG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA2ElE;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;;;;;;;;;OAUG;IACG,iBAAiB,CACrB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,EAC3B,OAAO,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,EACrD,SAAS,GAAE,MAAY,EACvB,MAAM,GAAE,cAAwC,GAC/C,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAkKtI;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgI3B;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAgClD;;;;;OAKG;IACG,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAiFvE;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC;IA0B9C;;;;;;;;;;OAUG;IACH,qBAAqB,CACnB,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,mBAAmB,CAAC;QACjC,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,GACL,iBAAiB,EAAE;IA8GtB;;OAEG;IACG,yBAAyB,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBrE,OAAO,CAAC,kBAAkB;CAY3B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAEvG;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAchE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAa7D"}