attocode 0.2.1 → 0.2.3

package/dist/src/integrations/thinking-strategy.js

@@ -0,0 +1,129 @@
+/**
+ * Thinking/Reflection Strategy
+ *
+ * Generates thinking directives that guide LLMs to use their
+ * internal reasoning (extended thinking) for better planning,
+ * evaluation, and self-assessment.
+ *
+ * Following Anthropic's multi-agent research pattern:
+ * thinking is controlled through prompt engineering, not code mechanics.
+ */
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const DEFAULT_CONFIG = {
+    enablePreTaskPlanning: true,
+    enablePostToolEvaluation: true,
+    enableQualityAssessment: true,
+    minComplexityTier: 'medium',
+};
+/**
+ * Complexity tier ordering for comparison.
+ */
+const TIER_ORDER = {
+    simple: 0,
+    medium: 1,
+    complex: 2,
+    deep_research: 3,
+};
+// =============================================================================
+// DIRECTIVE GENERATORS
+// =============================================================================
+/**
+ * Generate thinking directives based on complexity and config.
+ */
+export function generateThinkingDirectives(complexityTier, config) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    // Check if thinking should be activated for this complexity level
+    if (TIER_ORDER[complexityTier] < TIER_ORDER[cfg.minComplexityTier]) {
+        return {}; // No thinking directives for simple tasks
+    }
+    const directive = {};
+    if (cfg.enablePreTaskPlanning) {
+        directive.preActionPrompt = getPreActionPrompt(complexityTier);
+    }
+    if (cfg.enablePostToolEvaluation) {
+        directive.postToolPrompt = getPostToolPrompt(complexityTier);
+    }
+    if (cfg.enableQualityAssessment) {
+        directive.qualityCheckPrompt = getQualityCheckPrompt(complexityTier);
+    }
+    return directive;
+}
+function getPreActionPrompt(tier) {
+    if (tier === 'deep_research' || tier === 'complex') {
+        return `Before taking any action, use your thinking to:
+1. Assess which tools are most relevant for this task
+2. Determine the optimal sequence of operations
+3. If complex, plan which subagents to spawn and what each should do
+4. Identify potential pitfalls or dependencies between subtasks
+5. Decide whether to explore more or act on what you know
+
+Then proceed with your plan.`;
+    }
+    return `Before acting, briefly assess in your thinking:
+1. What tools are most relevant for this task?
+2. What is the most efficient approach?
+3. Are there dependencies between steps?
+
+Then proceed.`;
+}
+function getPostToolPrompt(_tier) {
+    return `After receiving tool results, evaluate in your thinking:
+- Did the tool calls return useful information?
+- Is the information sufficient or do I need more?
+- Should I change approach based on what I learned?
+- Are there any errors or unexpected results to address?`;
+}
+function getQualityCheckPrompt(_tier) {
+    return `Before returning your final answer, evaluate in your thinking:
+1. Did I address all aspects of the objective?
+2. Is my output complete and in the correct format?
+3. Have I met all success criteria?
+4. Are there any gaps or issues I should flag?`;
+}
+// =============================================================================
+// SYSTEM PROMPT INTEGRATION
+// =============================================================================
+/**
+ * Generate thinking-related system prompt additions.
+ * Injected into buildMessages() for complex tasks.
+ */
+export function getThinkingSystemPrompt(complexityTier, config) {
+    const directive = generateThinkingDirectives(complexityTier, config);
+    if (!directive.preActionPrompt && !directive.postToolPrompt) {
+        return null;
+    }
+    const parts = ['## Thinking Guidelines'];
+    if (directive.preActionPrompt) {
+        parts.push(`### Before Acting\n${directive.preActionPrompt}`);
+    }
+    if (directive.postToolPrompt) {
+        parts.push(`### After Tool Results\n${directive.postToolPrompt}`);
+    }
+    return parts.join('\n\n');
+}
+/**
+ * Generate quality self-assessment prompt for subagents.
+ * Added to subagent constraints before they return.
+ */
+export function getSubagentQualityPrompt() {
+    return `Before returning your final result, evaluate your work:
+1. Did you fully address the objective given to you?
+2. Is your output in the expected format?
+3. Did you stay within scope (not doing more or less than asked)?
+4. Are there any unresolved issues or gaps to flag to the parent?
+
+If you find gaps, note them clearly in your response.`;
+}
+/**
+ * Create a thinking strategy manager.
+ */
+export function createThinkingStrategy(config) {
+    return {
+        generateDirectives: (tier) => generateThinkingDirectives(tier, config),
+        getSystemPrompt: (tier) => getThinkingSystemPrompt(tier, config),
+        getSubagentPrompt: getSubagentQualityPrompt,
+    };
+}
+//# sourceMappingURL=thinking-strategy.js.map

package/dist/src/integrations/thinking-strategy.js.map

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

package/dist/src/integrations/tool-recommendation.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Tool Recommendation Engine
+ *
+ * Heuristic-based tool recommendation for subagents and swarm workers.
+ * Maps task types to tool categories and analyzes task descriptions
+ * for tool-relevant keywords.
+ *
+ * Key features:
+ * - Static task-type → tool-category mappings (no LLM call needed)
+ * - Keyword analysis for MCP tool preloading
+ * - Tool filtering for subagent specialization
+ * - Custom task types fall back to a known type's tools based on capability
+ */
+import type { WorkerCapability } from './swarm/types.js';
+export interface ToolRecommendation {
+    toolName: string;
+    relevanceScore: number;
+    reason: string;
+    source: 'builtin' | 'mcp';
+}
+export interface ToolRecommendationConfig {
+    /** Maximum tools to recommend per agent (default: 15) */
+    maxToolsPerAgent?: number;
+    /** Enable MCP tool preloading for known patterns (default: true) */
+    enablePreloading?: boolean;
+    /** Task-type to tool mapping overrides */
+    taskToolOverrides?: Record<string, string[]>;
+}
+export interface ToolCategory {
+    name: string;
+    tools: string[];
+    relevance: number;
+}
+export declare class ToolRecommendationEngine {
+    private config;
+    constructor(config?: ToolRecommendationConfig);
+    /**
+     * Recommend tools for a task based on type and description.
+     * Custom task types not in TASK_TYPE_TOOL_MAP fall back to a known type
+     * based on the custom type's capability (via TaskTypeConfig).
+     */
+    recommendTools(taskDescription: string, taskType: string, availableToolNames: string[], capability?: WorkerCapability): ToolRecommendation[];
+    /**
+     * Get MCP tool prefixes that should be preloaded for a task type.
+     */
+    getMCPPreloadPrefixes(taskDescription: string): string[];
+    /**
+     * Filter tools for an agent based on task type.
+     * Returns tool names that should be available to the agent.
+     */
+    getToolFilterForTaskType(taskType: string, availableToolNames: string[]): string[];
+    /**
+     * Infer a SubtaskType from an agent name.
+     */
+    static inferTaskType(agentName: string): string;
+}
+/**
+ * Create a tool recommendation engine with optional config.
+ */
+export declare function createToolRecommendationEngine(config?: ToolRecommendationConfig): ToolRecommendationEngine;
+//# sourceMappingURL=tool-recommendation.d.ts.map

package/dist/src/integrations/tool-recommendation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-recommendation.d.ts","sourceRoot":"","sources":["../../../src/integrations/tool-recommendation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAMzD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,KAAK,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AA0HD,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAqC;gBAEvC,MAAM,CAAC,EAAE,wBAAwB;IAQ7C;;;;OAIG;IACH,cAAc,CACZ,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,MAAM,EAAE,EAC5B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,kBAAkB,EAAE;IAoEvB;;OAEG;IACH,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE;IAgBxD;;;OAGG;IACH,wBAAwB,CACtB,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,MAAM,EAAE,GAC3B,MAAM,EAAE;IAKX;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAmChD;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,CAAC,EAAE,wBAAwB,GAChC,wBAAwB,CAE1B"}

package/dist/src/integrations/tool-recommendation.js

@@ -0,0 +1,268 @@
+/**
+ * Tool Recommendation Engine
+ *
+ * Heuristic-based tool recommendation for subagents and swarm workers.
+ * Maps task types to tool categories and analyzes task descriptions
+ * for tool-relevant keywords.
+ *
+ * Key features:
+ * - Static task-type → tool-category mappings (no LLM call needed)
+ * - Keyword analysis for MCP tool preloading
+ * - Tool filtering for subagent specialization
+ * - Custom task types fall back to a known type's tools based on capability
+ */
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+/**
+ * Static mapping from subtask types to tool categories.
+ * Core heuristic: task type determines which tools are most useful.
+ */
+const TASK_TYPE_TOOL_MAP = {
+    research: [
+        { name: 'file_reading', tools: ['read_file', 'glob', 'grep', 'list_files', 'search_files', 'search_code', 'get_file_info'], relevance: 1.0 },
+        { name: 'web', tools: ['web_search'], relevance: 0.8 },
+        { name: 'file_writing', tools: ['write_file', 'edit_file'], relevance: 0.6 },
+        { name: 'bash_readonly', tools: ['bash'], relevance: 0.5 },
+        { name: 'task_coordination', tools: ['task_get', 'task_list'], relevance: 0.3 },
+    ],
+    analysis: [
+        { name: 'file_reading', tools: ['read_file', 'glob', 'grep', 'list_files', 'search_files', 'search_code'], relevance: 1.0 },
+        { name: 'bash_readonly', tools: ['bash'], relevance: 0.6 },
+        { name: 'web', tools: ['web_search'], relevance: 0.5 },
+    ],
+    design: [
+        { name: 'file_reading', tools: ['read_file', 'glob', 'grep', 'list_files'], relevance: 0.9 },
+        { name: 'file_writing', tools: ['write_file'], relevance: 0.4 },
+    ],
+    implement: [
+        { name: 'file_reading', tools: ['read_file', 'glob', 'grep', 'list_files'], relevance: 0.8 },
+        { name: 'file_writing', tools: ['write_file', 'edit_file'], relevance: 1.0 },
+        { name: 'execution', tools: ['bash'], relevance: 0.7 },
+        { name: 'task_coordination', tools: ['task_create', 'task_update', 'task_get', 'task_list'], relevance: 0.3 },
+    ],
+    test: [
+        { name: 'execution', tools: ['bash'], relevance: 1.0 },
+        { name: 'file_reading', tools: ['read_file', 'glob', 'grep'], relevance: 0.7 },
+        { name: 'file_writing', tools: ['write_file', 'edit_file'], relevance: 0.5 },
+    ],
+    refactor: [
+        { name: 'file_reading', tools: ['read_file', 'glob', 'grep', 'list_files', 'search_code'], relevance: 0.9 },
+        { name: 'file_writing', tools: ['write_file', 'edit_file'], relevance: 1.0 },
+        { name: 'execution', tools: ['bash'], relevance: 0.5 },
+    ],
+    review: [
+        { name: 'file_reading', tools: ['read_file', 'glob', 'grep', 'list_files', 'search_files'], relevance: 1.0 },
+        { name: 'file_writing', tools: ['write_file', 'edit_file'], relevance: 0.4 },
+        { name: 'bash_readonly', tools: ['bash'], relevance: 0.3 },
+    ],
+    document: [
+        { name: 'file_reading', tools: ['read_file', 'glob', 'grep'], relevance: 0.8 },
+        { name: 'file_writing', tools: ['write_file', 'edit_file'], relevance: 1.0 },
+    ],
+    integrate: [
+        { name: 'file_reading', tools: ['read_file', 'glob', 'grep'], relevance: 0.8 },
+        { name: 'file_writing', tools: ['write_file', 'edit_file'], relevance: 0.9 },
+        { name: 'execution', tools: ['bash'], relevance: 0.8 },
+    ],
+    deploy: [
+        { name: 'execution', tools: ['bash'], relevance: 1.0 },
+        { name: 'file_reading', tools: ['read_file', 'glob'], relevance: 0.5 },
+        { name: 'file_writing', tools: ['write_file', 'edit_file'], relevance: 0.4 },
+    ],
+    merge: [
+        { name: 'file_reading', tools: ['read_file', 'glob', 'grep'], relevance: 0.9 },
+        { name: 'file_writing', tools: ['write_file', 'edit_file'], relevance: 1.0 },
+        { name: 'execution', tools: ['bash'], relevance: 0.5 },
+        { name: 'task_coordination', tools: ['task_get', 'task_list'], relevance: 0.3 },
+    ],
+};
+/**
+ * Map a WorkerCapability to the closest built-in task type for tool recommendations.
+ * Used as a fallback when a custom task type isn't in TASK_TYPE_TOOL_MAP.
+ */
+const CAPABILITY_TO_TOOL_MAP_KEY = {
+    code: 'implement',
+    research: 'research',
+    review: 'review',
+    test: 'test',
+    document: 'document',
+    write: 'merge',
+};
+/**
+ * Keyword patterns that suggest specific MCP tools.
+ */
+const MCP_KEYWORD_PATTERNS = [
+    {
+        keywords: ['browser', 'screenshot', 'click', 'navigate', 'page', 'web page', 'UI test'],
+        mcpPrefix: 'mcp_playwright',
+        description: 'Playwright browser automation',
+    },
+    {
+        keywords: ['database', 'sql', 'query', 'table', 'schema'],
+        mcpPrefix: 'mcp_sqlite',
+        description: 'SQLite database operations',
+    },
+    {
+        keywords: ['documentation', 'library docs', 'api docs', 'npm package'],
+        mcpPrefix: 'mcp_context7',
+        description: 'Context7 documentation lookup',
+    },
+    {
+        keywords: ['web search', 'google', 'search online', 'look up'],
+        mcpPrefix: 'mcp_serper',
+        description: 'Web search via Serper',
+    },
+    {
+        keywords: ['github', 'pull request', 'issue', 'repository'],
+        mcpPrefix: 'mcp_github',
+        description: 'GitHub API operations',
+    },
+];
+// =============================================================================
+// ENGINE
+// =============================================================================
+export class ToolRecommendationEngine {
+    config;
+    constructor(config) {
+        this.config = {
+            maxToolsPerAgent: config?.maxToolsPerAgent ?? 15,
+            enablePreloading: config?.enablePreloading ?? true,
+            taskToolOverrides: config?.taskToolOverrides ?? {},
+        };
+    }
+    /**
+     * Recommend tools for a task based on type and description.
+     * Custom task types not in TASK_TYPE_TOOL_MAP fall back to a known type
+     * based on the custom type's capability (via TaskTypeConfig).
+     */
+    recommendTools(taskDescription, taskType, availableToolNames, capability) {
+        const recommendations = new Map();
+        const availableSet = new Set(availableToolNames);
+        // Phase 1: Task-type based recommendations
+        // For custom types not in the map, fall back to a known type via capability
+        let categories;
+        if (this.config.taskToolOverrides[taskType]) {
+            categories = [{ name: 'override', tools: this.config.taskToolOverrides[taskType], relevance: 1.0 }];
+        }
+        else if (TASK_TYPE_TOOL_MAP[taskType]) {
+            categories = TASK_TYPE_TOOL_MAP[taskType];
+        }
+        else {
+            // Custom type fallback: use capability to find closest built-in tool map
+            const fallbackType = capability
+                ? CAPABILITY_TO_TOOL_MAP_KEY[capability] ?? 'implement'
+                : 'implement';
+            categories = TASK_TYPE_TOOL_MAP[fallbackType] ?? [];
+        }
+        for (const category of categories) {
+            for (const toolName of category.tools) {
+                if (availableSet.has(toolName) && !recommendations.has(toolName)) {
+                    recommendations.set(toolName, {
+                        toolName,
+                        relevanceScore: category.relevance,
+                        reason: `${category.name} tool for ${taskType} tasks`,
+                        source: 'builtin',
+                    });
+                }
+            }
+        }
+        // Phase 2: Keyword-based MCP tool recommendations
+        const taskLower = taskDescription.toLowerCase();
+        for (const pattern of MCP_KEYWORD_PATTERNS) {
+            const matchCount = pattern.keywords.filter(kw => taskLower.includes(kw)).length;
+            if (matchCount > 0) {
+                // Find available MCP tools matching the prefix
+                for (const toolName of availableToolNames) {
+                    if (toolName.startsWith(pattern.mcpPrefix) && !recommendations.has(toolName)) {
+                        const relevance = Math.min(0.5 + matchCount * 0.15, 1.0);
+                        recommendations.set(toolName, {
+                            toolName,
+                            relevanceScore: relevance,
+                            reason: `${pattern.description} (matched: ${matchCount} keywords)`,
+                            source: 'mcp',
+                        });
+                    }
+                }
+            }
+        }
+        // Phase 3: Always include spawn_agent for complex tasks
+        if (availableSet.has('spawn_agent') && !recommendations.has('spawn_agent')) {
+            recommendations.set('spawn_agent', {
+                toolName: 'spawn_agent',
+                relevanceScore: 0.3,
+                reason: 'Available for delegation',
+                source: 'builtin',
+            });
+        }
+        // Sort by relevance and limit
+        return [...recommendations.values()]
+            .sort((a, b) => b.relevanceScore - a.relevanceScore)
+            .slice(0, this.config.maxToolsPerAgent);
+    }
+    /**
+     * Get MCP tool prefixes that should be preloaded for a task type.
+     */
+    getMCPPreloadPrefixes(taskDescription) {
+        if (!this.config.enablePreloading)
+            return [];
+        const taskLower = taskDescription.toLowerCase();
+        const prefixes = [];
+        for (const pattern of MCP_KEYWORD_PATTERNS) {
+            const matches = pattern.keywords.filter(kw => taskLower.includes(kw));
+            if (matches.length > 0) {
+                prefixes.push(pattern.mcpPrefix);
+            }
+        }
+        return prefixes;
+    }
+    /**
+     * Filter tools for an agent based on task type.
+     * Returns tool names that should be available to the agent.
+     */
+    getToolFilterForTaskType(taskType, availableToolNames) {
+        const recommendations = this.recommendTools('', taskType, availableToolNames);
+        return recommendations.map(r => r.toolName);
+    }
+    /**
+     * Infer a SubtaskType from an agent name.
+     */
+    static inferTaskType(agentName) {
+        const nameToType = {
+            researcher: 'research',
+            coder: 'implement',
+            reviewer: 'review',
+            architect: 'design',
+            debugger: 'analysis',
+            tester: 'test',
+            documenter: 'document',
+            synthesizer: 'merge',
+            writer: 'document',
+            merger: 'merge',
+        };
+        const lower = agentName.toLowerCase();
+        if (nameToType[lower]) {
+            return nameToType[lower];
+        }
+        // Dynamic swarm names like "swarm-coder-task-1" should resolve by role token.
+        const tokens = lower.split(/[^a-z0-9]+/).filter(Boolean);
+        for (const token of tokens) {
+            if (nameToType[token]) {
+                return nameToType[token];
+            }
+        }
+        // For swarm workers, default to implementation rather than research so
+        // write-capable profiles are selected unless explicitly constrained.
+        if (lower.startsWith('swarm-')) {
+            return 'implement';
+        }
+        return 'research';
+    }
+}
+/**
+ * Create a tool recommendation engine with optional config.
+ */
+export function createToolRecommendationEngine(config) {
+    return new ToolRecommendationEngine(config);
+}
+//# sourceMappingURL=tool-recommendation.js.map

package/dist/src/integrations/tool-recommendation.js.map

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

package/dist/src/integrations/verification-gate.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Verification Gate - Opt-in Completion Verification
+ *
+ * Prevents premature completion by checking if required verification
+ * steps (like running tests) have been performed before allowing
+ * the agent to stop.
+ *
+ * Configuration:
+ * - TUI mode: off by default
+ * - Eval mode: auto-configured from FAIL_TO_PASS tests
+ * - Swarm mode: set by orchestrator per worker
+ */
+export interface VerificationCriteria {
+    /** Tests that must be run (e.g., pytest test paths) */
+    requiredTests?: string[];
+    /** Must have edited at least one file */
+    requireFileChanges?: boolean;
+    /** Max nudges before giving up and allowing completion */
+    maxAttempts?: number;
+}
+export interface VerificationState {
+    /** Tests that have been detected as run */
+    testsRun: Set<string>;
+    /** Whether any test passed */
+    anyTestPassed: boolean;
+    /** Whether file changes were made */
+    hasFileChanges: boolean;
+    /** Number of verification nudges already sent */
+    nudgeCount: number;
+}
+export interface VerificationCheckResult {
+    /** Whether verification criteria are satisfied */
+    satisfied: boolean;
+    /** If not satisfied, a nudge message to inject */
+    nudge?: string;
+    /** If max attempts exceeded, allow anyway */
+    forceAllow: boolean;
+    /** What's still missing */
+    missing: string[];
+}
+export declare class VerificationGate {
+    private criteria;
+    private state;
+    constructor(criteria: VerificationCriteria);
+    /**
+     * Record that a bash command was executed.
+     * Detects test execution from command patterns and output.
+     */
+    recordBashExecution(command: string, output: string, exitCode: number | null): void;
+    /**
+     * Record that a file was modified.
+     */
+    recordFileChange(): void;
+    /**
+     * Check if the agent can complete.
+     * Returns satisfied=true if criteria are met, or a nudge message if not.
+     */
+    check(): VerificationCheckResult;
+    /**
+     * Get the current verification state.
+     */
+    getState(): {
+        testsRun: number;
+        anyTestPassed: boolean;
+        hasFileChanges: boolean;
+        nudgeCount: number;
+        maxAttempts: number;
+    };
+    /**
+     * Reset the gate state (for reuse).
+     */
+    reset(): void;
+    private buildNudge;
+}
+/**
+ * Create a verification gate from criteria.
+ * Returns null if no criteria provided (gate disabled).
+ */
+export declare function createVerificationGate(criteria?: VerificationCriteria | null): VerificationGate | null;
+//# sourceMappingURL=verification-gate.d.ts.map

package/dist/src/integrations/verification-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-gate.d.ts","sourceRoot":"","sources":["../../../src/integrations/verification-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,8BAA8B;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,qCAAqC;IACrC,cAAc,EAAE,OAAO,CAAC;IACxB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,UAAU,EAAE,OAAO,CAAC;IACpB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAMD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,KAAK,CAAoB;gBAErB,QAAQ,EAAE,oBAAoB;IAe1C;;;OAGG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAoBnF;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAIxB;;;OAGG;IACH,KAAK,IAAI,uBAAuB;IAkChC;;OAEG;IACH,QAAQ,IAAI;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,OAAO,CAAC;QACvB,cAAc,EAAE,OAAO,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB;IAUD;;OAEG;IACH,KAAK,IAAI,IAAI;IAab,OAAO,CAAC,UAAU;CAcnB;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,CAAC,EAAE,oBAAoB,GAAG,IAAI,GACrC,gBAAgB,GAAG,IAAI,CAKzB"}