@scitrera/memorylayer-cc-plugin 0.0.5 → 0.2.0

package/dist/src/hooks/handlers/session-start.js

@@ -0,0 +1,111 @@
+/**
+ * SessionStart hook handler
+ * Retrieves briefing and relevant memories at session start
+ */
+import { getClient } from "../client.js";
+import { formatSessionStart } from "../formatters.js";
+import { markRecallDone } from "../state.js";
+/**
+ * Extract a topic from the user's first message in transcript
+ */
+function extractTopic(input) {
+    if (!input.transcript || input.transcript.length === 0) {
+        return undefined;
+    }
+    // Find first user messageno
+    const userMsg = input.transcript.find(m => m.role === "user");
+    if (!userMsg) {
+        return undefined;
+    }
+    // Use first 100 chars as topic query (truncate for API efficiency)
+    const content = userMsg.content.trim();
+    if (content.length > 100) {
+        return content.substring(0, 100);
+    }
+    return content || undefined;
+}
+/**
+ * Check for existing sandbox state from a prior session or pre-compaction.
+ * Returns the inspect result if a sandbox exists, null otherwise.
+ */
+async function checkSandboxState(client) {
+    try {
+        const status = await client.contextStatus();
+        if (status.exists && (status.variable_count ?? 0) > 0) {
+            // Sandbox has variables — fetch the overview
+            return await client.contextInspect({});
+        }
+    }
+    catch {
+        // Context environment may not be available, that's fine
+    }
+    return null;
+}
+/**
+ * Handle SessionStart event
+ */
+export async function handleSessionStart(input) {
+    try {
+        const client = getClient();
+        const topic = extractTopic(input);
+        const sessionId = client.getSessionId();
+        if (sessionId) {
+            try {
+                const pack = await client.getContextPack(sessionId, {
+                    topic,
+                    budgetTokens: 2048,
+                    includeSandboxSummary: true,
+                    includeCheckpointRecovery: true,
+                });
+                if (topic)
+                    markRecallDone(topic);
+                return {
+                    success: true,
+                    additionalContext: `${pack.rendered}\n\nMemoryLayer context cursor: ${pack.cursor}`,
+                };
+            }
+            catch (error) {
+                console.error("[session-start] context pack unavailable; using compatibility retrieval:", error instanceof Error ? error.message : error);
+            }
+        }
+        // Compatibility path for servers that do not yet expose context packs.
+        const [briefingResult, directiveResult, sandboxResult] = await Promise.allSettled([
+            client.getBriefing({ limit: 10, includeMemories: false }),
+            client.recall({
+                query: "user directives and preferences",
+                subtypes: ["directive", "preference"],
+                limit: 10,
+            }),
+            checkSandboxState(client),
+        ]);
+        const briefing = briefingResult.status === "fulfilled" ? briefingResult.value : null;
+        const directives = directiveResult.status === "fulfilled"
+            ? directiveResult.value.memories
+            : [];
+        const sandboxState = sandboxResult.status === "fulfilled" ? sandboxResult.value : null;
+        // If there's a topic in the transcript, recall for it too
+        let topicRecall = null;
+        if (topic) {
+            try {
+                topicRecall = await client.recall({ query: topic, limit: 10, detail_level: "abstract", });
+                markRecallDone(topic);
+            }
+            catch {
+                // Topic recall is optional, continue without it
+            }
+        }
+        // Format the combined output
+        const context = formatSessionStart(briefing, directives, topicRecall, topic, sandboxState);
+        return {
+            success: true,
+            additionalContext: context,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `SessionStart handler error: ${error instanceof Error ? error.message : error}`,
+        };
+    }
+}
+//# sourceMappingURL=session-start.js.map

package/dist/src/hooks/handlers/session-start.js.map

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

package/dist/src/hooks/handlers/stop.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Stop hook handler
+ * Commits session and persists working memory at session end
+ */
+import type { HookOutput } from "../types.js";
+/**
+ * Handle Stop event -- commit and end the server session.
+ *
+ * Stop hooks cannot inject additional context (Claude Code is shutting down),
+ * so this handler performs side effects only: committing working memory
+ * to long-term storage and ending the server session.
+ */
+export declare function handleStop(): Promise<HookOutput>;
+//# sourceMappingURL=stop.d.ts.map

package/dist/src/hooks/handlers/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../../../src/hooks/handlers/stop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C;;;;;;GAMG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,CAqCtD"}

package/dist/src/hooks/handlers/stop.js

@@ -0,0 +1,49 @@
+/**
+ * Stop hook handler
+ * Commits session and persists working memory at session end
+ */
+import { getClient, checkHealth } from "../client.js";
+/**
+ * Handle Stop event -- commit and end the server session.
+ *
+ * Stop hooks cannot inject additional context (Claude Code is shutting down),
+ * so this handler performs side effects only: committing working memory
+ * to long-term storage and ending the server session.
+ */
+export async function handleStop() {
+    const healthy = await checkHealth();
+    if (!healthy) {
+        return { success: true };
+    }
+    // getClient() syncs session ID from env/hook-state via resolveSessionId
+    const client = getClient();
+    const sessionId = client.getSessionId();
+    if (!sessionId) {
+        console.error("[stop] no session ID available, skipping commit/end");
+        return { success: true };
+    }
+    try {
+        // Commit working memory to long-term storage
+        try {
+            await client.commitSession(sessionId, { importance_threshold: 0.5 });
+        }
+        catch {
+            // Commit may fail if session expired or not supported
+        }
+        // End the server session
+        try {
+            await client.endSession(sessionId, {
+                commit: true,
+                importance_threshold: 0.5,
+            });
+        }
+        catch {
+            // Session may already be ended
+        }
+    }
+    catch {
+        // Best-effort -- don't fail the hook on shutdown
+    }
+    return { success: true };
+}
+//# sourceMappingURL=stop.js.map

package/dist/src/hooks/handlers/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../../../src/hooks/handlers/stop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,OAAO,GAAG,MAAM,WAAW,EAAE,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,wEAAwE;IACxE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;IACxC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACrE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC;QAEH,6CAA6C;QAC7C,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,oBAAoB,EAAE,GAAG,EAAE,CAAC,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,sDAAsD;QACxD,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE;gBACjC,MAAM,EAAE,IAAI;gBACZ,oBAAoB,EAAE,GAAG;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/src/hooks/handlers/user-prompt.d.ts

@@ -0,0 +1,10 @@
+/**
+ * UserPromptSubmit hook handler
+ * Detects patterns in user prompts and provides recall guidance
+ */
+import type { HookInput, HookOutput } from "../types.js";
+/**
+ * Handle UserPromptSubmit event
+ */
+export declare function handleUserPromptSubmit(input: HookInput): Promise<HookOutput>;
+//# sourceMappingURL=user-prompt.d.ts.map

package/dist/src/hooks/handlers/user-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-prompt.d.ts","sourceRoot":"","sources":["../../../../src/hooks/handlers/user-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAE,UAAU,EAAC,MAAM,aAAa,CAAC;AAgEvD;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CA0DlF"}

package/dist/src/hooks/handlers/user-prompt.js

@@ -0,0 +1,128 @@
+/**
+ * UserPromptSubmit hook handler
+ * Detects patterns in user prompts and provides recall guidance
+ */
+import { getClient, checkHealth } from "../client.js";
+import { formatRecallResult } from "../formatters.js";
+import { wasRecallDoneThisTurn, markRecallDone, setCurrentTopic, setCurrentPrompt } from "../state.js";
+/** Pattern categories and their recall queries */
+const PATTERNS = {
+    preference: {
+        regex: /\b(which\s+\w+\s+should|should\s+we\s+use|what\s+do\s+we\s+use|how\s+do\s+we|what'?s\s+our|preferred|convention|do\s+we\s+have\s+a|what'?s\s+the\s+(default|standard|preferred))\b/i,
+        queries: ["directive", "preference", "convention"],
+    },
+    recall: {
+        regex: /\b(remember|recall|what did we|how did we|remind me|what was the|what were the|what do you (know|remember))\b/i,
+        queries: ["context", "history", "decision"],
+    },
+    analysis: {
+        regex: /\b(review|assess|analyze|evaluate|audit|investigate|explore|research|compare|status|state of|readiness|gap analysis)\b/i,
+        queries: ["status", "assessment", "gaps", "problems"],
+    },
+    implementation: {
+        regex: /\b(implement|build|create|add|fix|refactor|update|change|modify)\b/i,
+        queries: ["patterns", "solutions", "issues"],
+    },
+    error: {
+        regex: /\b(error|bug|issue|broken|failing|crash|exception|doesn't work|not working)\b/i,
+        queries: ["fix", "error", "solution"],
+    },
+};
+/**
+ * Detect which pattern category matches the prompt
+ */
+function detectPattern(prompt) {
+    for (const [category, config] of Object.entries(PATTERNS)) {
+        if (config.regex.test(prompt)) {
+            return category;
+        }
+    }
+    return null;
+}
+/**
+ * Extract key terms from the prompt for recall query
+ */
+function extractKeyTerms(prompt) {
+    // Remove common words and extract meaningful terms
+    const stopWords = new Set([
+        "the", "a", "an", "is", "are", "was", "were", "be", "been",
+        "have", "has", "had", "do", "does", "did", "will", "would",
+        "could", "should", "may", "might", "must", "can", "this",
+        "that", "these", "those", "i", "you", "we", "they", "it",
+        "my", "your", "our", "their", "its", "please", "help", "me",
+        "want", "need", "like", "to", "for", "with", "on", "in", "at",
+    ]);
+    const words = prompt.toLowerCase()
+        .replace(/[^\w\s]/g, " ")
+        .split(/\s+/)
+        .filter(w => w.length > 2 && !stopWords.has(w));
+    // Take first 5 meaningful words
+    return words.slice(0, 5).join(" ");
+}
+/**
+ * Handle UserPromptSubmit event
+ */
+export async function handleUserPromptSubmit(input) {
+    const prompt = input.user_prompt;
+    if (!prompt) {
+        return { success: true };
+    }
+    // Persist the user's prompt for intent detection in PostToolUse
+    setCurrentPrompt(prompt);
+    // Skip if recall was already done this turn
+    if (wasRecallDoneThisTurn()) {
+        return { success: true };
+    }
+    // Check server health
+    const healthy = await checkHealth();
+    if (!healthy) {
+        return { success: true };
+    }
+    // Store the user's topic for cross-hook context (Edit/Write recall)
+    const keyTerms = extractKeyTerms(prompt);
+    if (keyTerms) {
+        setCurrentTopic(keyTerms);
+    }
+    // Detect pattern category
+    const pattern = detectPattern(prompt);
+    if (!pattern) {
+        return { success: true };
+    }
+    try {
+        // Build recall query from prompt + pattern-specific terms
+        const patternQueries = PATTERNS[pattern].queries;
+        const query = `${keyTerms} ${patternQueries[0]}`.trim();
+        // Perform recall using the same client as MCP tools
+        const client = getClient();
+        const result = await client.recall({ query, limit: 10 });
+        markRecallDone(query);
+        if (result.memories.length === 0) {
+            return { success: true };
+        }
+        // Format guidance based on pattern
+        const guidance = getPatternGuidance(pattern);
+        const recallOutput = formatRecallResult(result, query);
+        return {
+            success: true,
+            additionalContext: `${guidance}\n\n${recallOutput}`,
+        };
+    }
+    catch {
+        // Don't fail the hook on recall errors
+        return { success: true };
+    }
+}
+/**
+ * Get guidance text for each pattern type
+ */
+function getPatternGuidance(pattern) {
+    const guidance = {
+        preference: "This is a preference/convention question. Relevant directives and decisions found:",
+        recall: "Recalled memories matching this request:",
+        analysis: "This request involves analysis/research. Relevant prior context found:",
+        implementation: "This request involves implementation. Relevant patterns/solutions found:",
+        error: "This request mentions an error/bug. Relevant prior fixes found:",
+    };
+    return guidance[pattern] || "Relevant memories found:";
+}
+//# sourceMappingURL=user-prompt.js.map

package/dist/src/hooks/handlers/user-prompt.js.map

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

package/dist/src/hooks/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * MemoryLayer Claude Code hooks
+ *
+ * This module provides TypeScript-based hooks for Claude Code integration.
+ * Hooks inject memory context into Claude's processing at key points,
+ * using the same MemoryLayerClient as the MCP tools.
+ */
+export { HookEvent, type HookInput, type HookOutput, type TranscriptMessage, type HookState, } from "./types.js";
+export { readHookState, writeHookState, markRecallDone, wasRecallDoneThisTurn, resetRecallStatus, updateSessionInfo, getWorkspaceId, getSessionIdFromHookState, resolveSessionId, getCheckpointBoundary, acknowledgeCheckpointBoundary, } from "./state.js";
+export { getClient, checkHealth, } from "./client.js";
+export { formatRecallResult, formatBriefing, formatDirectives, formatSessionStart, formatSandboxState, formatStorageGuidance, } from "./formatters.js";
+export { handleSessionStart } from "./handlers/session-start.js";
+export { handleUserPromptSubmit } from "./handlers/user-prompt.js";
+export { handlePreToolUse } from "./handlers/pre-tool.js";
+export { handlePostToolUse } from "./handlers/post-tool.js";
+export { handleStop } from "./handlers/stop.js";
+export { handlePreCompact } from "./handlers/pre-compact.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,SAAS,EACT,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,SAAS,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,yBAAyB,EACzB,gBAAgB,EAChB,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,SAAS,EACT,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/src/hooks/index.js

@@ -0,0 +1,23 @@
+/**
+ * MemoryLayer Claude Code hooks
+ *
+ * This module provides TypeScript-based hooks for Claude Code integration.
+ * Hooks inject memory context into Claude's processing at key points,
+ * using the same MemoryLayerClient as the MCP tools.
+ */
+// Types
+export { HookEvent, } from "./types.js";
+// State management
+export { readHookState, writeHookState, markRecallDone, wasRecallDoneThisTurn, resetRecallStatus, updateSessionInfo, getWorkspaceId, getSessionIdFromHookState, resolveSessionId, getCheckpointBoundary, acknowledgeCheckpointBoundary, } from "./state.js";
+// Client (same MemoryLayerClient used by MCP tools)
+export { getClient, checkHealth, } from "./client.js";
+// Formatters
+export { formatRecallResult, formatBriefing, formatDirectives, formatSessionStart, formatSandboxState, formatStorageGuidance, } from "./formatters.js";
+// Handlers
+export { handleSessionStart } from "./handlers/session-start.js";
+export { handleUserPromptSubmit } from "./handlers/user-prompt.js";
+export { handlePreToolUse } from "./handlers/pre-tool.js";
+export { handlePostToolUse } from "./handlers/post-tool.js";
+export { handleStop } from "./handlers/stop.js";
+export { handlePreCompact } from "./handlers/pre-compact.js";
+//# sourceMappingURL=index.js.map

package/dist/src/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,QAAQ;AACR,OAAO,EACL,SAAS,GAKV,MAAM,YAAY,CAAC;AAEpB,mBAAmB;AACnB,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,yBAAyB,EACzB,gBAAgB,EAChB,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,YAAY,CAAC;AAEpB,oDAAoD;AACpD,OAAO,EACL,SAAS,EACT,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,aAAa;AACb,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/src/hooks/observation.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Observation extraction for auto-capture hooks.
+ * Extracts structured observation data from tool usage.
+ */
+import type { HookInput } from './types.js';
+export declare function shouldSkipTool(toolName: string): boolean;
+export type ObservationType = 'read' | 'write' | 'execute' | 'search' | 'other';
+export interface ObservationData {
+    type: ObservationType;
+    title: string;
+    toolName: string;
+    filesRead: string[];
+    filesModified: string[];
+    facts: string[];
+    concepts: string[];
+    intent: string | null;
+    contentHash: string;
+    summary: string;
+}
+/**
+ * Classify tool as read/write/execute/search/other
+ */
+export declare function getObservationType(toolName: string): ObservationType;
+/**
+ * Extract file paths from tool input, classified as read or modified
+ */
+export declare function extractFilePaths(toolName: string, toolInput: unknown): {
+    filesRead: string[];
+    filesModified: string[];
+};
+/**
+ * Generate observation title from tool usage
+ */
+export declare function generateTitle(toolName: string, toolInput: unknown): string;
+/**
+ * Extract facts from tool input/response
+ */
+export declare function extractFacts(toolName: string, toolInput: unknown, toolOutput?: string): string[];
+/**
+ * Extract concepts/topics from tool usage
+ */
+export declare function extractConcepts(toolName: string, toolInput: unknown): string[];
+/**
+ * Detect intent from tool usage and user prompt
+ */
+export declare function detectIntent(toolName: string, toolInput: unknown, prompt?: string): string | null;
+/**
+ * Compute content hash for deduplication
+ */
+export declare function computeContentHash(...parts: string[]): string;
+/**
+ * Truncate string to max length
+ */
+export declare function truncate(str: string, maxLen?: number): string;
+/**
+ * Build observation from hook input
+ */
+export declare function buildObservation(input: HookInput, currentPrompt?: string): ObservationData | null;
+//# sourceMappingURL=observation.d.ts.map

package/dist/src/hooks/observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../../../src/hooks/observation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAiB5C,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGxD;AAGD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAWpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,CA+BvH;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAgC1E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAuDhG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,EAAE,CAgG9E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8CjG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAK7D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAY,GAAG,MAAM,CAGlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAuCjG"}