decibel-tools-mcp 1.0.0

package/dist/lib/supabase.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Supabase Client
+ *
+ * Connects to senken.pro Supabase for Decibel Studio Cloud Spine.
+ * Uses environment variables for configuration.
+ *
+ * Environment:
+ *   SUPABASE_URL - Supabase project URL
+ *   SUPABASE_ANON_KEY - Supabase anon/public key
+ *   SUPABASE_SERVICE_KEY - Optional service role key for admin operations
+ */
+import { SupabaseClient } from '@supabase/supabase-js';
+export interface Project {
+    id: string;
+    owner_id: string;
+    name: string;
+    description: string | null;
+    created_at: string;
+    updated_at: string;
+    deleted_at: string | null;
+}
+export interface Artifact {
+    id: string;
+    project_id: string;
+    schema_version: string;
+    type: 'image' | 'video' | '3d' | 'audio' | 'text';
+    status: 'generating' | 'partial' | 'complete' | 'failed';
+    progress: number | null;
+    platform: 'ios' | 'web' | 'claude-code' | 'macos' | 'android';
+    app_version: string;
+    package_url: string | null;
+    package_sha256: string | null;
+    prompt: string | null;
+    model: string | null;
+    provider: string | null;
+    parent_artifact_id: string | null;
+    workflow_id: string | null;
+    workflow_step_id: string | null;
+    tags: string[];
+    is_pinned: boolean;
+    rating: number | null;
+    created_at: string;
+    updated_at: string;
+    deleted_at: string | null;
+}
+export interface ArtifactFile {
+    id: string;
+    artifact_id: string;
+    path: string;
+    role: 'preview' | 'render' | 'variant' | 'thumbnail';
+    mime_type: string;
+    bytes: number;
+    sha256: string;
+    width: number | null;
+    height: number | null;
+    storage_url: string | null;
+    created_at: string;
+}
+export interface Device {
+    id: string;
+    user_id: string;
+    name: string;
+    platform: 'ios' | 'web' | 'claude-code' | 'macos' | 'android';
+    capabilities: Record<string, unknown>;
+    push_token: string | null;
+    last_seen_at: string;
+    created_at: string;
+}
+export interface Event {
+    seq: number;
+    project_id: string;
+    type: string;
+    payload: Record<string, unknown>;
+    device_id: string | null;
+    created_at: string;
+}
+export interface Job {
+    id: string;
+    owner_id: string;
+    target_device_id: string | null;
+    claimed_by_device_id: string | null;
+    workflow_id: string | null;
+    project_id: string | null;
+    inputs: Record<string, unknown>;
+    status: 'pending' | 'claimed' | 'running' | 'complete' | 'failed' | 'cancelled';
+    progress: number | null;
+    error_message: string | null;
+    result_artifact_id: string | null;
+    created_at: string;
+    updated_at: string;
+    claimed_at: string | null;
+    completed_at: string | null;
+    expires_at: string | null;
+}
+/**
+ * Get the Supabase client (anon key - respects RLS)
+ */
+export declare function getSupabaseClient(): SupabaseClient<any>;
+/**
+ * Get the Supabase service client (service role key - bypasses RLS)
+ * Use only for admin operations that require elevated privileges.
+ */
+export declare function getSupabaseServiceClient(): SupabaseClient<any>;
+/**
+ * Check if Supabase is configured (for service-level operations like voice inbox)
+ * Requires URL and SERVICE_KEY for server-side writes
+ */
+export declare function isSupabaseConfigured(): boolean;
+/**
+ * Set access token for user-scoped requests
+ */
+export declare function setAccessToken(token: string): Promise<void>;
+export interface SupabaseError {
+    error: string;
+    code: string;
+    details?: string;
+}
+export declare function isSupabaseError(result: unknown): result is SupabaseError;
+export declare function formatSupabaseError(error: {
+    message: string;
+    code?: string;
+}): SupabaseError;
+//# sourceMappingURL=supabase.d.ts.map

package/dist/lib/supabase.d.ts.map

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

package/dist/lib/supabase.js

@@ -0,0 +1,91 @@
+/**
+ * Supabase Client
+ *
+ * Connects to senken.pro Supabase for Decibel Studio Cloud Spine.
+ * Uses environment variables for configuration.
+ *
+ * Environment:
+ *   SUPABASE_URL - Supabase project URL
+ *   SUPABASE_ANON_KEY - Supabase anon/public key
+ *   SUPABASE_SERVICE_KEY - Optional service role key for admin operations
+ */
+import { createClient } from '@supabase/supabase-js';
+import { log } from '../config.js';
+// ============================================================================
+// Client Singleton
+// ============================================================================
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let _client = null;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let _serviceClient = null;
+/**
+ * Get the Supabase client (anon key - respects RLS)
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function getSupabaseClient() {
+    if (_client)
+        return _client;
+    const url = process.env.SUPABASE_URL;
+    const anonKey = process.env.SUPABASE_ANON_KEY;
+    if (!url || !anonKey) {
+        throw new Error('Supabase not configured. Set SUPABASE_URL and SUPABASE_ANON_KEY environment variables.');
+    }
+    log('[Supabase] Initializing client');
+    _client = createClient(url, anonKey, {
+        auth: {
+            persistSession: false,
+            autoRefreshToken: false,
+        },
+    });
+    return _client;
+}
+/**
+ * Get the Supabase service client (service role key - bypasses RLS)
+ * Use only for admin operations that require elevated privileges.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function getSupabaseServiceClient() {
+    if (_serviceClient)
+        return _serviceClient;
+    const url = process.env.SUPABASE_URL;
+    const serviceKey = process.env.SUPABASE_SERVICE_KEY;
+    if (!url || !serviceKey) {
+        throw new Error('Supabase service client not configured. Set SUPABASE_URL and SUPABASE_SERVICE_KEY.');
+    }
+    log('[Supabase] Initializing service client');
+    _serviceClient = createClient(url, serviceKey, {
+        auth: {
+            persistSession: false,
+            autoRefreshToken: false,
+        },
+    });
+    return _serviceClient;
+}
+/**
+ * Check if Supabase is configured (for service-level operations like voice inbox)
+ * Requires URL and SERVICE_KEY for server-side writes
+ */
+export function isSupabaseConfigured() {
+    return !!(process.env.SUPABASE_URL && process.env.SUPABASE_SERVICE_KEY);
+}
+/**
+ * Set access token for user-scoped requests
+ */
+export async function setAccessToken(token) {
+    const client = getSupabaseClient();
+    await client.auth.setSession({
+        access_token: token,
+        refresh_token: '',
+    });
+}
+export function isSupabaseError(result) {
+    return typeof result === 'object' && result !== null && 'error' in result && 'code' in result;
+}
+export function formatSupabaseError(error) {
+    return {
+        error: error.message,
+        code: error.code || 'SUPABASE_ERROR',
+        details: JSON.stringify(error),
+    };
+}
+//# sourceMappingURL=supabase.js.map

package/dist/lib/supabase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.js","sourceRoot":"","sources":["../../src/lib/supabase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAkB,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AA8FnC,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,8DAA8D;AAC9D,IAAI,OAAO,GAA+B,IAAI,CAAC;AAC/C,8DAA8D;AAC9D,IAAI,cAAc,GAA+B,IAAI,CAAC;AAEtD;;GAEG;AACH,8DAA8D;AAC9D,MAAM,UAAU,iBAAiB;IAC/B,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAE9C,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,wFAAwF,CACzF,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,gCAAgC,CAAC,CAAC;IACtC,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE;QACnC,IAAI,EAAE;YACJ,cAAc,EAAE,KAAK;YACrB,gBAAgB,EAAE,KAAK;SACxB;KACF,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,8DAA8D;AAC9D,MAAM,UAAU,wBAAwB;IACtC,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAE1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACrC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAEpD,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,wCAAwC,CAAC,CAAC;IAC9C,cAAc,GAAG,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE;QAC7C,IAAI,EAAE;YACJ,cAAc,EAAE,KAAK;YACrB,gBAAgB,EAAE,KAAK;SACxB;KACF,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAa;IAChD,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;QAC3B,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,EAAE;KAClB,CAAC,CAAC;AACL,CAAC;AAYD,MAAM,UAAU,eAAe,CAAC,MAAe;IAC7C,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAyC;IAC3E,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,OAAO;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,gBAAgB;QACpC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;KAC/B,CAAC;AACJ,CAAC"}

package/dist/projectPaths.d.ts

@@ -0,0 +1,27 @@
+export interface ProjectConfig {
+    projectId: string;
+    projectName?: string;
+    root: string;
+}
+/**
+ * Resolve project configuration from a project ID.
+ *
+ * Resolution strategy (via projectRegistry):
+ * 1. Check registry for exact ID or alias match
+ * 2. Check DECIBEL_PROJECT_ROOT env var
+ * 3. Check if projectId is a valid absolute path
+ * 4. Walk up from cwd looking for matching project
+ *
+ * @param projectId - The unique identifier for the project (ID, alias, or path)
+ * @returns The project configuration including root path
+ * @throws Error if the project cannot be resolved
+ */
+export declare function resolveProjectRoot(projectId: string): Promise<ProjectConfig>;
+/**
+ * List all known project IDs.
+ * Returns projects from the registry plus any discovered from cwd.
+ *
+ * @returns Array of discovered project IDs
+ */
+export declare function listProjectIds(): string[];
+//# sourceMappingURL=projectPaths.d.ts.map

package/dist/projectPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectPaths.d.ts","sourceRoot":"","sources":["../src/projectPaths.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAkCD;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CAYxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAezC"}

package/dist/projectPaths.js

@@ -0,0 +1,86 @@
+// ============================================================================
+// Project Path Resolution
+// ============================================================================
+// Helps MCP tools resolve project roots from project IDs.
+// Uses registry-based resolution with fallback to dynamic discovery.
+// ============================================================================
+import fs from 'fs';
+import path from 'path';
+import { resolveProject, listProjects } from './projectRegistry.js';
+// ============================================================================
+// Path Resolution Helpers
+// ============================================================================
+/**
+ * Walk up directory tree looking for a .decibel folder
+ */
+function findDecibelDir(start) {
+    let current = path.resolve(start);
+    while (true) {
+        const candidate = path.join(current, '.decibel');
+        if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+            return current; // Return the project root, not the .decibel folder
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return undefined;
+}
+/**
+ * Get the project name from a project root directory
+ */
+function getProjectNameFromDir(projectRoot) {
+    return path.basename(projectRoot);
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Resolve project configuration from a project ID.
+ *
+ * Resolution strategy (via projectRegistry):
+ * 1. Check registry for exact ID or alias match
+ * 2. Check DECIBEL_PROJECT_ROOT env var
+ * 3. Check if projectId is a valid absolute path
+ * 4. Walk up from cwd looking for matching project
+ *
+ * @param projectId - The unique identifier for the project (ID, alias, or path)
+ * @returns The project configuration including root path
+ * @throws Error if the project cannot be resolved
+ */
+export async function resolveProjectRoot(projectId) {
+    try {
+        const entry = resolveProject(projectId);
+        return {
+            projectId: entry.id,
+            projectName: entry.name || entry.id,
+            root: entry.path,
+        };
+    }
+    catch (err) {
+        // Re-throw with the helpful error message from registry
+        throw err;
+    }
+}
+/**
+ * List all known project IDs.
+ * Returns projects from the registry plus any discovered from cwd.
+ *
+ * @returns Array of discovered project IDs
+ */
+export function listProjectIds() {
+    const registeredProjects = listProjects();
+    const ids = registeredProjects.map((p) => p.id);
+    // Also check cwd for a local project not in registry
+    const currentProjectRoot = process.env.DECIBEL_PROJECT_ROOT || process.cwd();
+    const discoveredRoot = findDecibelDir(currentProjectRoot);
+    if (discoveredRoot) {
+        const localId = getProjectNameFromDir(discoveredRoot);
+        if (!ids.includes(localId)) {
+            ids.push(localId);
+        }
+    }
+    return ids;
+}
+//# sourceMappingURL=projectPaths.js.map

package/dist/projectPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectPaths.js","sourceRoot":"","sources":["../src/projectPaths.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAC/E,0DAA0D;AAC1D,qEAAqE;AACrE,+EAA+E;AAE/E,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,cAAc,EAAgB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAYlF,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;GAEG;AACH,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACjD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACrE,OAAO,OAAO,CAAC,CAAC,mDAAmD;QACrE,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,MAAM;QAC9B,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,WAAmB;IAChD,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC;AAED,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,KAAK,GAAiB,cAAc,CAAC,SAAS,CAAC,CAAC;QACtD,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,EAAE;YACnB,WAAW,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE;YACnC,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,wDAAwD;QACxD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,kBAAkB,GAAG,YAAY,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAe,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE9D,qDAAqD;IACrD,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC7E,MAAM,cAAc,GAAG,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAC1D,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,qBAAqB,CAAC,cAAc,CAAC,CAAC;QACtD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/projectRegistry.d.ts

@@ -0,0 +1,97 @@
+export interface ProjectEntry {
+    /** Primary ID (usually directory name) */
+    id: string;
+    /** Human-readable name */
+    name?: string;
+    /** Absolute path to project root (contains .decibel/) */
+    path: string;
+    /** Optional aliases (e.g., "senken" -> "senken-trading-agent") */
+    aliases?: string[];
+    /** If true, this is the default project when none specified */
+    default?: boolean;
+}
+export interface ProjectRegistry {
+    version: 1;
+    projects: ProjectEntry[];
+}
+/**
+ * Resolve a project ID or alias to its filesystem path.
+ *
+ * Resolution order:
+ * 1. Check registry for exact ID match
+ * 2. Check registry for alias match
+ * 3. Check DECIBEL_PROJECT_ROOT env var (if ID matches basename)
+ * 4. Check if ID is an absolute path with .decibel
+ * 5. Walk up from cwd looking for .decibel (if ID matches discovered project)
+ *
+ * @param projectId - Project ID, alias, or path
+ * @returns Absolute path to the project root
+ * @throws Error if project cannot be resolved
+ */
+export declare function resolveProject(projectId: string): ProjectEntry;
+/**
+ * List all registered projects
+ */
+export declare function listProjects(): ProjectEntry[];
+/**
+ * Register a new project or update an existing one
+ */
+export declare function registerProject(entry: ProjectEntry): void;
+/**
+ * Remove a project from the registry
+ */
+export declare function unregisterProject(projectId: string): boolean;
+/**
+ * Add an alias to an existing project
+ */
+export declare function addProjectAlias(projectId: string, alias: string): void;
+/**
+ * Get the registry file path (for display/debugging)
+ */
+export declare function getRegistryFilePath(): string;
+/**
+ * Get the default project.
+ * Resolution order:
+ * 1. Project explicitly marked as default
+ * 2. DECIBEL_DEFAULT_PROJECT env var
+ * 3. If only one project registered, use it
+ * 4. Discover from cwd
+ *
+ * @returns The default project entry or undefined if none can be determined
+ */
+export declare function getDefaultProject(): ProjectEntry | undefined;
+/**
+ * Set a project as the default
+ */
+export declare function setDefaultProject(projectId: string): void;
+/**
+ * Normalize projectId from various input formats.
+ * Handles both camelCase (projectId) and snake_case (project_id).
+ * This allows tools to accept inputs from Claude regardless of which format it uses.
+ */
+export declare function normalizeProjectId(input: Record<string, unknown>): string | undefined;
+export interface ResolvedProjectPaths {
+    /** Project ID */
+    id: string;
+    /** Absolute path to project root */
+    projectPath: string;
+    /** Absolute path to .decibel folder */
+    decibelPath: string;
+    /** Helper to get a subdirectory under .decibel */
+    subPath: (...segments: string[]) => string;
+}
+/**
+ * Resolve project and return useful paths.
+ * This is the primary helper for tools to get project paths.
+ *
+ * @param projectId - Project ID, alias, or path (optional, uses default if not provided)
+ * @returns Resolved project paths
+ * @throws Error if project cannot be resolved
+ */
+export declare function resolveProjectPaths(projectId?: string): ResolvedProjectPaths;
+/**
+ * Validate that a write path is within the project's .decibel folder.
+ * Call this before any file write to prevent escaping project boundaries.
+ */
+export declare function validateWritePath(targetPath: string, resolved: ResolvedProjectPaths): void;
+//# sourceMappingURL=projectRegistry.d.ts.map

package/dist/projectRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectRegistry.d.ts","sourceRoot":"","sources":["../src/projectRegistry.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AA2FD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAyE9D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,YAAY,EAAE,CAG7C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CA8BzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAa5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CActE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,YAAY,GAAG,SAAS,CA8C5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAiBzD;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAErF;AAMD,MAAM,WAAW,oBAAoB;IACnC,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,OAAO,EAAE,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAwB5E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAQ1F"}