@nahisaho/musubix-agent-orchestrator 2.4.1

package/dist/application/ContextManager.d.ts

@@ -0,0 +1,90 @@
+/**
+ * ContextManager Application Service
+ *
+ * Manages execution contexts for task sharing
+ *
+ * @see REQ-SDD-003 - Context Sharing
+ * @see DES-SDD-003 - ContextManager
+ */
+import { type ExecutionContext } from '../domain/entities/ExecutionContext.js';
+import type { Artifact } from '../domain/entities/Artifact.js';
+/**
+ * Context manager interface
+ */
+export interface IContextManager {
+    /**
+     * Create a new execution context
+     * @param taskId - Task ID
+     * @param parent - Optional parent context
+     * @returns New execution context
+     */
+    create(taskId: string, parent?: ExecutionContext): ExecutionContext;
+    /**
+     * Share knowledge in context
+     * @param context - Context to update
+     * @param key - Knowledge key
+     * @param value - Knowledge value
+     * @returns Updated context (immutable)
+     */
+    share(context: ExecutionContext, key: string, value: unknown): ExecutionContext;
+    /**
+     * Add artifact to context
+     * @param context - Context to update
+     * @param artifact - Artifact to add
+     * @returns Updated context (immutable)
+     */
+    addArtifact(context: ExecutionContext, artifact: Artifact): ExecutionContext;
+    /**
+     * Merge multiple contexts
+     * @param contexts - Contexts to merge
+     * @returns Merged context
+     */
+    merge(contexts: ExecutionContext[]): ExecutionContext;
+    /**
+     * Get value from context (including parents)
+     * @param context - Context to search
+     * @param key - Knowledge key
+     * @returns Value or undefined
+     */
+    get<T>(context: ExecutionContext, key: string): T | undefined;
+    /**
+     * Get all artifacts from context (including parents)
+     * @param context - Context to search
+     * @returns All artifacts
+     */
+    getArtifacts(context: ExecutionContext): Artifact[];
+}
+/**
+ * Context manager configuration
+ */
+export interface ContextManagerConfig {
+    /** Default project path */
+    defaultProjectPath?: string;
+    /** Default source */
+    defaultSource?: 'user' | 'agent' | 'system';
+}
+/**
+ * Create a context manager
+ *
+ * @param config - Optional configuration
+ * @returns IContextManager implementation
+ */
+export declare function createContextManager(config?: ContextManagerConfig): IContextManager;
+/**
+ * Context snapshot for serialization
+ */
+export interface ContextSnapshot {
+    taskId: string;
+    knowledge: Record<string, unknown>;
+    artifactIds: string[];
+    metadata: ExecutionContext['metadata'];
+    timestamp: string;
+}
+/**
+ * Create a snapshot of context for persistence
+ *
+ * @param context - Context to snapshot
+ * @returns Serializable snapshot
+ */
+export declare function createContextSnapshot(context: ExecutionContext): ContextSnapshot;
+//# sourceMappingURL=ContextManager.d.ts.map

package/dist/application/ContextManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextManager.d.ts","sourceRoot":"","sources":["../../src/application/ContextManager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,gBAAgB,EAKtB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAAC;IAEpE;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAEhF;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,CAAC;IAE7E;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAAC;IAEtD;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAE9D;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,QAAQ,EAAE,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2BAA2B;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CAC7C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,GAAE,oBAAyB,GAChC,eAAe,CA6GjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAahF"}

package/dist/application/ContextManager.js

@@ -0,0 +1,130 @@
+/**
+ * ContextManager Application Service
+ *
+ * Manages execution contexts for task sharing
+ *
+ * @see REQ-SDD-003 - Context Sharing
+ * @see DES-SDD-003 - ContextManager
+ */
+import { createExecutionContext, getFromContext, getAllArtifacts, } from '../domain/entities/ExecutionContext.js';
+/**
+ * Create a context manager
+ *
+ * @param config - Optional configuration
+ * @returns IContextManager implementation
+ */
+export function createContextManager(config = {}) {
+    const defaultSource = config.defaultSource ?? 'system';
+    return {
+        create(taskId, parent) {
+            const input = {
+                taskId,
+                parentContext: parent,
+                metadata: {
+                    source: defaultSource,
+                    projectPath: config.defaultProjectPath,
+                    relatedFiles: [],
+                    tags: [],
+                },
+            };
+            return createExecutionContext(input);
+        },
+        share(context, key, value) {
+            // Create new Map with existing knowledge plus new entry
+            const newKnowledge = new Map(context.sharedKnowledge);
+            newKnowledge.set(key, value);
+            return createExecutionContext({
+                taskId: context.taskId,
+                parentContext: context.parentContext,
+                sharedKnowledge: newKnowledge,
+                artifacts: [...context.artifacts],
+                metadata: context.metadata,
+            });
+        },
+        addArtifact(context, artifact) {
+            return createExecutionContext({
+                taskId: context.taskId,
+                parentContext: context.parentContext,
+                sharedKnowledge: new Map(context.sharedKnowledge),
+                artifacts: [...context.artifacts, artifact],
+                metadata: context.metadata,
+            });
+        },
+        merge(contexts) {
+            if (contexts.length === 0) {
+                throw new Error('Cannot merge empty context array');
+            }
+            if (contexts.length === 1) {
+                return contexts[0];
+            }
+            // Merge all knowledge
+            const mergedKnowledge = new Map();
+            for (const ctx of contexts) {
+                for (const [key, value] of ctx.sharedKnowledge) {
+                    // Later contexts override earlier ones
+                    mergedKnowledge.set(key, value);
+                }
+            }
+            // Merge all artifacts (deduplicate by ID)
+            const artifactMap = new Map();
+            for (const ctx of contexts) {
+                for (const artifact of getAllArtifacts(ctx)) {
+                    artifactMap.set(artifact.id, artifact);
+                }
+            }
+            // Merge related files
+            const relatedFilesSet = new Set();
+            for (const ctx of contexts) {
+                for (const file of ctx.metadata.relatedFiles) {
+                    relatedFilesSet.add(file);
+                }
+            }
+            // Merge tags
+            const tagsSet = new Set();
+            for (const ctx of contexts) {
+                for (const tag of ctx.metadata.tags) {
+                    tagsSet.add(tag);
+                }
+            }
+            // Use first context's taskId as merged ID
+            const mergedTaskId = `merged-${contexts.map((c) => c.taskId).join('-')}`;
+            return createExecutionContext({
+                taskId: mergedTaskId,
+                sharedKnowledge: mergedKnowledge,
+                artifacts: Array.from(artifactMap.values()),
+                metadata: {
+                    source: 'system',
+                    projectPath: contexts[0].metadata.projectPath,
+                    relatedFiles: Array.from(relatedFilesSet),
+                    tags: Array.from(tagsSet),
+                },
+            });
+        },
+        get(context, key) {
+            return getFromContext(context, key);
+        },
+        getArtifacts(context) {
+            return getAllArtifacts(context);
+        },
+    };
+}
+/**
+ * Create a snapshot of context for persistence
+ *
+ * @param context - Context to snapshot
+ * @returns Serializable snapshot
+ */
+export function createContextSnapshot(context) {
+    const knowledge = {};
+    for (const [key, value] of context.sharedKnowledge) {
+        knowledge[key] = value;
+    }
+    return {
+        taskId: context.taskId,
+        knowledge,
+        artifactIds: context.artifacts.map((a) => a.id),
+        metadata: context.metadata,
+        timestamp: context.timestamp.toISOString(),
+    };
+}
+//# sourceMappingURL=ContextManager.js.map

package/dist/application/ContextManager.js.map

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

package/dist/application/ParallelExecutor.d.ts

@@ -0,0 +1,65 @@
+/**
+ * ParallelExecutor Application Service
+ *
+ * Executes independent tasks in parallel
+ *
+ * @see REQ-PAD-002 - Parallel Execution
+ * @see DES-PAD-002 - ParallelExecutor
+ */
+import type { SubagentSpec, SubagentResult } from '../domain/entities/SubagentSpec.js';
+import type { DependencyGraph } from '../domain/services/DependencyAnalyzer.js';
+/**
+ * Executor function type
+ */
+export type SubagentExecutor = (spec: SubagentSpec) => Promise<SubagentResult>;
+/**
+ * Parallel executor interface
+ */
+export interface IParallelExecutor {
+    /**
+     * Execute specs in parallel respecting dependencies
+     * @param specs - Subagent specifications
+     * @param graph - Dependency graph
+     * @param executor - Executor function
+     * @returns All results
+     */
+    execute(specs: SubagentSpec[], graph: DependencyGraph, executor: SubagentExecutor): Promise<SubagentResult[]>;
+    /**
+     * Execute specs in a single level (all parallel)
+     * @param specs - Subagent specifications
+     * @param executor - Executor function
+     * @returns Results
+     */
+    executeLevel(specs: SubagentSpec[], executor: SubagentExecutor): Promise<SubagentResult[]>;
+}
+/**
+ * Executor configuration
+ */
+export interface ParallelExecutorConfig {
+    /** Maximum concurrent executions (default: 5) */
+    maxConcurrency?: number;
+    /** Continue on error (default: true) */
+    continueOnError?: boolean;
+    /** Global timeout (ms) */
+    globalTimeoutMs?: number;
+}
+/**
+ * Create a parallel executor
+ *
+ * @param config - Optional configuration
+ * @returns IParallelExecutor implementation
+ */
+export declare function createParallelExecutor(config?: ParallelExecutorConfig): IParallelExecutor;
+/**
+ * Execution progress callback
+ */
+export type ProgressCallback = (completed: number, total: number, current: SubagentResult) => void;
+/**
+ * Create executor with progress tracking
+ *
+ * @param config - Configuration
+ * @param onProgress - Progress callback
+ * @returns Executor with progress
+ */
+export declare function createProgressExecutor(config?: ParallelExecutorConfig, onProgress?: ProgressCallback): IParallelExecutor;
+//# sourceMappingURL=ParallelExecutor.d.ts.map

package/dist/application/ParallelExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParallelExecutor.d.ts","sourceRoot":"","sources":["../../src/application/ParallelExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,OAAO,CACL,KAAK,EAAE,YAAY,EAAE,EACrB,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE7B;;;;;OAKG;IACH,YAAY,CACV,KAAK,EAAE,YAAY,EAAE,EACrB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,0BAA0B;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,GAAE,sBAA2B,GAClC,iBAAiB,CAyJnB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,KACpB,IAAI,CAAC;AAEV;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,GAAE,sBAA2B,EACnC,UAAU,CAAC,EAAE,gBAAgB,GAC5B,iBAAiB,CAiCnB"}

package/dist/application/ParallelExecutor.js

@@ -0,0 +1,149 @@
+/**
+ * ParallelExecutor Application Service
+ *
+ * Executes independent tasks in parallel
+ *
+ * @see REQ-PAD-002 - Parallel Execution
+ * @see DES-PAD-002 - ParallelExecutor
+ */
+import { createSubagentResult } from '../domain/entities/SubagentSpec.js';
+/**
+ * Create a parallel executor
+ *
+ * @param config - Optional configuration
+ * @returns IParallelExecutor implementation
+ */
+export function createParallelExecutor(config = {}) {
+    const maxConcurrency = config.maxConcurrency ?? 5;
+    const continueOnError = config.continueOnError ?? true;
+    const globalTimeoutMs = config.globalTimeoutMs ?? 600000; // 10 minutes
+    /**
+     * Execute with concurrency limit
+     */
+    async function executeWithLimit(items, fn, limit) {
+        const results = [];
+        const executing = [];
+        for (const item of items) {
+            const promise = fn(item).then((result) => {
+                results.push(result);
+            });
+            executing.push(promise);
+            if (executing.length >= limit) {
+                await Promise.race(executing);
+                // Remove completed promises
+                const completed = executing.filter((p) => p.settled);
+                for (const c of completed) {
+                    const index = executing.indexOf(c);
+                    if (index > -1)
+                        executing.splice(index, 1);
+                }
+            }
+        }
+        await Promise.all(executing);
+        return results;
+    }
+    /**
+     * Execute single spec with timeout
+     */
+    async function executeWithTimeout(spec, executor) {
+        const startTime = Date.now();
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => {
+                reject(new Error(`Timeout after ${spec.timeoutMs}ms`));
+            }, spec.timeoutMs);
+        });
+        try {
+            const result = await Promise.race([executor(spec), timeoutPromise]);
+            return result;
+        }
+        catch (error) {
+            const durationMs = Date.now() - startTime;
+            return createSubagentResult(spec.id, false, '', durationMs, [], error instanceof Error ? error.message : String(error));
+        }
+    }
+    return {
+        async execute(specs, graph, executor) {
+            if (graph.hasCircular) {
+                throw new Error(`Cannot execute: circular dependency detected: ${graph.circularPath?.join(' → ')}`);
+            }
+            const allResults = [];
+            const specMap = new Map(specs.map((s) => [s.id, s]));
+            const completedIds = new Set();
+            // Global timeout
+            const globalStart = Date.now();
+            // Execute level by level
+            for (const level of graph.levels) {
+                // Check global timeout
+                if (Date.now() - globalStart > globalTimeoutMs) {
+                    // Create timeout results for remaining specs
+                    for (const id of level) {
+                        if (!completedIds.has(id)) {
+                            allResults.push(createSubagentResult(id, false, '', 0, [], `Global timeout exceeded (${globalTimeoutMs}ms)`));
+                        }
+                    }
+                    break;
+                }
+                // Get specs for this level
+                const levelSpecs = level
+                    .map((id) => specMap.get(id))
+                    .filter((s) => s !== undefined);
+                // Execute level in parallel
+                const levelResults = await this.executeLevel(levelSpecs, executor);
+                // Track results
+                for (const result of levelResults) {
+                    allResults.push(result);
+                    completedIds.add(result.specId);
+                    // Check if we should stop on error
+                    if (!result.success && !continueOnError) {
+                        return allResults;
+                    }
+                }
+            }
+            return allResults;
+        },
+        async executeLevel(specs, executor) {
+            if (specs.length === 0) {
+                return [];
+            }
+            // Execute all specs in parallel with concurrency limit
+            const results = await executeWithLimit(specs, (spec) => executeWithTimeout(spec, executor), maxConcurrency);
+            return results;
+        },
+    };
+}
+/**
+ * Create executor with progress tracking
+ *
+ * @param config - Configuration
+ * @param onProgress - Progress callback
+ * @returns Executor with progress
+ */
+export function createProgressExecutor(config = {}, onProgress) {
+    const baseExecutor = createParallelExecutor(config);
+    let completed = 0;
+    return {
+        async execute(specs, graph, executor) {
+            completed = 0;
+            const total = specs.length;
+            const wrappedExecutor = async (spec) => {
+                const result = await executor(spec);
+                completed++;
+                onProgress?.(completed, total, result);
+                return result;
+            };
+            return baseExecutor.execute(specs, graph, wrappedExecutor);
+        },
+        async executeLevel(specs, executor) {
+            const total = specs.length;
+            let levelCompleted = 0;
+            const wrappedExecutor = async (spec) => {
+                const result = await executor(spec);
+                levelCompleted++;
+                onProgress?.(levelCompleted, total, result);
+                return result;
+            };
+            return baseExecutor.executeLevel(specs, wrappedExecutor);
+        },
+    };
+}
+//# sourceMappingURL=ParallelExecutor.js.map

package/dist/application/ParallelExecutor.js.map

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

package/dist/application/ResultAggregator.d.ts

@@ -0,0 +1,107 @@
+/**
+ * ResultAggregator Application Service
+ *
+ * Aggregates results from multiple subagents
+ *
+ * @see REQ-PAD-003 - Result Aggregation
+ * @see DES-PAD-003 - ResultAggregator
+ */
+import type { SubagentResult, SubagentArtifact } from '../domain/entities/SubagentSpec.js';
+/**
+ * Conflict detection result
+ */
+export interface ConflictInfo {
+    /** Conflicting spec IDs */
+    readonly specIds: readonly string[];
+    /** Conflicting file path */
+    readonly filePath: string;
+    /** Conflict type */
+    readonly type: 'file' | 'content' | 'semantic';
+    /** Description */
+    readonly description: string;
+    /** Can be auto-resolved */
+    readonly autoResolvable: boolean;
+}
+/**
+ * Aggregated output
+ */
+export interface AggregatedOutput {
+    /** All results */
+    readonly results: readonly SubagentResult[];
+    /** Overall success */
+    readonly success: boolean;
+    /** Combined content */
+    readonly combinedContent: string;
+    /** All artifacts (deduplicated) */
+    readonly artifacts: readonly SubagentArtifact[];
+    /** Detected conflicts */
+    readonly conflicts: readonly ConflictInfo[];
+    /** Failed results */
+    readonly failures: readonly SubagentResult[];
+    /** Statistics */
+    readonly stats: AggregationStats;
+}
+/**
+ * Aggregation statistics
+ */
+export interface AggregationStats {
+    readonly totalSpecs: number;
+    readonly succeeded: number;
+    readonly failed: number;
+    readonly totalDurationMs: number;
+    readonly averageDurationMs: number;
+    readonly artifactCount: number;
+    readonly conflictCount: number;
+}
+/**
+ * Result aggregator interface
+ */
+export interface IResultAggregator {
+    /**
+     * Aggregate results from multiple subagents
+     * @param results - Subagent results
+     * @returns Aggregated output
+     */
+    aggregate(results: SubagentResult[]): AggregatedOutput;
+    /**
+     * Detect conflicts between results
+     * @param results - Subagent results
+     * @returns Detected conflicts
+     */
+    detectConflicts(results: SubagentResult[]): ConflictInfo[];
+    /**
+     * Merge artifacts from results
+     * @param results - Subagent results
+     * @returns Merged artifacts
+     */
+    mergeArtifacts(results: SubagentResult[]): SubagentArtifact[];
+}
+/**
+ * Aggregator configuration
+ */
+export interface ResultAggregatorConfig {
+    /** Enable conflict detection (default: true) */
+    detectConflicts?: boolean;
+    /** Content separator for combining */
+    contentSeparator?: string;
+}
+/**
+ * Create a result aggregator
+ *
+ * @param config - Optional configuration
+ * @returns IResultAggregator implementation
+ */
+export declare function createResultAggregator(config?: ResultAggregatorConfig): IResultAggregator;
+/**
+ * Create a conflict resolution strategy
+ */
+export type ConflictResolver = (conflict: ConflictInfo, artifacts: SubagentArtifact[]) => SubagentArtifact | null;
+/**
+ * Default conflict resolver - use latest artifact
+ */
+export declare const latestArtifactResolver: ConflictResolver;
+/**
+ * Merge resolver - attempt to merge content
+ */
+export declare const mergeResolver: ConflictResolver;
+//# sourceMappingURL=ResultAggregator.d.ts.map

package/dist/application/ResultAggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultAggregator.d.ts","sourceRoot":"","sources":["../../src/application/ResultAggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IAC/C,kBAAkB;IAClB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2BAA2B;IAC3B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,sBAAsB;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uBAAuB;IACvB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,qBAAqB;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,gBAAgB,CAAC;IAEvD;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,YAAY,EAAE,CAAC;IAE3D;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,gBAAgB,EAAE,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,GAAE,sBAA2B,GAClC,iBAAiB,CAsHnB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,gBAAgB,EAAE,KAC1B,gBAAgB,GAAG,IAAI,CAAC;AAE7B;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,gBAGpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,gBAiB3B,CAAC"}