@uluops/core 0.5.0

package/dist/executor/CommandExecutor.js

@@ -0,0 +1,183 @@
+import { runPreflightChecks } from './preflight.js';
+import { parseRef } from '../utils/parseRef.js';
+import { sumTokenMetrics } from '../utils/sumTokenMetrics.js';
+/**
+ * Executes command definitions.
+ *
+ * - Single-agent commands: delegates to AgentExecutor
+ * - Multi-agent commands: runs agents in sequence, aggregates results
+ *
+ * Handles preflight checks, model/threshold overrides from command definition,
+ * and multi-agent score aggregation.
+ */
+export class CommandExecutor {
+    agentExecutor;
+    registry;
+    constructor(agentExecutor, registry) {
+        this.agentExecutor = agentExecutor;
+        this.registry = registry;
+    }
+    /**
+     * Execute a command definition
+     */
+    async execute(resolved, input) {
+        const startTime = Date.now();
+        const def = resolved.definition;
+        // 1. Run preflight checks
+        if (def.command.execution.preflight) {
+            await runPreflightChecks(def.command.execution.preflight, input);
+        }
+        // 2. Resolve referenced agents
+        const agentRefs = def.command.agents;
+        // 3. Single-agent: delegate to AgentExecutor
+        if (agentRefs.length === 1) {
+            const ref = agentRefs[0];
+            if (!ref)
+                throw new Error('Agent refs array is empty despite length check');
+            const [name, version] = parseRef(ref);
+            const agentResolved = await this.registry.resolve(name, version, 'agent');
+            const agentResult = await this.agentExecutor.execute(agentResolved, input, {
+                model: def.command.execution.model.default,
+                timeoutMs: def.command.execution.timeout,
+                thresholds: def.command.execution.thresholds,
+            });
+            return this.wrapAgentResult(agentResult, def, resolved.hash, startTime);
+        }
+        // 4. Multi-agent: execute each and aggregate
+        const executeAgent = async (ref) => {
+            const [name, version] = parseRef(ref);
+            const agentResolved = await this.registry.resolve(name, version, 'agent');
+            return this.agentExecutor.execute(agentResolved, input, {
+                model: def.command.execution.model.default,
+                timeoutMs: def.command.execution.timeout,
+            });
+        };
+        const agentResults = def.command.execution.sequential === false
+            ? await Promise.all(agentRefs.map(executeAgent))
+            : await this.executeSequentially(agentRefs, executeAgent);
+        return this.aggregateResults(agentResults, def, resolved.hash, startTime, def.command.aggregation ?? { method: 'average' });
+    }
+    async executeSequentially(refs, fn) {
+        const results = [];
+        for (const ref of refs) {
+            results.push(await fn(ref));
+        }
+        return results;
+    }
+    /**
+     * Wrap a single agent result as a CommandResult
+     */
+    wrapAgentResult(agentResult, def, hash, startTime) {
+        const durationMs = Date.now() - startTime;
+        const metrics = {
+            ...agentResult.metrics,
+            durationMs,
+            toolCalls: agentResult.metrics.toolCallCount ?? 0,
+        };
+        const base = {
+            type: 'command',
+            name: def.command.interface.name,
+            version: def.command.interface.version,
+            definitionHash: hash,
+            agentType: agentResult.agentType,
+            decision: agentResult.decision,
+            threshold: def.command.execution.thresholds?.pass,
+            recommendations: agentResult.recommendations,
+            durationMs,
+            metrics,
+        };
+        if (agentResult.agentType === 'validator') {
+            return {
+                ...base,
+                score: agentResult.score,
+                maxScore: agentResult.maxScore,
+                categories: agentResult.categories?.map(c => ({
+                    name: c.name,
+                    score: c.score,
+                    maxPoints: c.maxScore,
+                    findings: c.findings,
+                })),
+            };
+        }
+        return { ...base, artifacts: agentResult.artifacts };
+    }
+    /**
+     * Aggregate multiple agent results into a single CommandResult
+     */
+    aggregateResults(results, def, hash, startTime, aggregation) {
+        const durationMs = Date.now() - startTime;
+        // Collect all recommendations
+        const recommendations = results.flatMap(r => r.recommendations);
+        // Aggregate scores (for validators)
+        const validatorResults = results.filter((r) => r.agentType === 'validator');
+        let score;
+        let maxScore;
+        if (validatorResults.length > 0) {
+            const scores = validatorResults.map(r => r.score);
+            switch (aggregation.method) {
+                case 'min':
+                    score = Math.min(...scores);
+                    break;
+                case 'max':
+                    score = Math.max(...scores);
+                    break;
+                case 'weighted_average': {
+                    const weights = aggregation.weights ?? {};
+                    let totalWeight = 0;
+                    let weightedSum = 0;
+                    for (const r of validatorResults) {
+                        const w = weights[r.name] ?? 1;
+                        totalWeight += w;
+                        weightedSum += r.score * w;
+                    }
+                    score = totalWeight > 0 ? weightedSum / totalWeight : 0;
+                    break;
+                }
+                case 'average':
+                default:
+                    score = scores.reduce((a, b) => a + b, 0) / scores.length;
+            }
+            maxScore = Math.max(...validatorResults.map(r => r.maxScore ?? 100));
+        }
+        // Determine overall decision
+        const threshold = def.command.execution.thresholds?.pass ?? 70;
+        const warnThreshold = def.command.execution.thresholds?.warn ?? 50;
+        let decision;
+        if (score !== undefined) {
+            if (score >= threshold)
+                decision = 'PASS';
+            else if (score >= warnThreshold)
+                decision = 'WARN';
+            else
+                decision = 'FAIL';
+        }
+        else {
+            const failed = results.some(r => r.decision === 'FAILED');
+            const partial = results.some(r => r.decision === 'PARTIAL');
+            decision = failed ? 'FAILED' : partial ? 'PARTIAL' : 'COMPLETE';
+        }
+        // Aggregate metrics
+        const totalToolCalls = results.reduce((sum, r) => sum + (r.metrics.toolCallCount ?? 0), 0);
+        const metrics = {
+            ...sumTokenMetrics(results.map(r => r.metrics)),
+            durationMs,
+            model: 'mixed',
+            toolCalls: totalToolCalls,
+        };
+        return {
+            type: 'command',
+            name: def.command.interface.name,
+            version: def.command.interface.version,
+            definitionHash: hash,
+            agentType: validatorResults.length > 0 ? 'validator' : 'executor',
+            decision,
+            score,
+            maxScore,
+            threshold,
+            recommendations,
+            durationMs,
+            metrics,
+        };
+    }
+}
+//# sourceMappingURL=CommandExecutor.js.map

package/dist/executor/CommandExecutor.js.map

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

package/dist/executor/PipelineExecutor.d.ts

@@ -0,0 +1,55 @@
+import type { CommandExecutor } from './CommandExecutor.js';
+import type { WorkflowExecutor } from './WorkflowExecutor.js';
+import type { RegistryClient } from '../registry/RegistryClient.js';
+import type { ResolvedDefinition } from '../types/registry.js';
+import type { PipelineResult, PipelineState, PipelineHandle as IPipelineHandle } from '../types/pipeline.js';
+import type { ExecutionInput } from '../types/execution.js';
+/**
+ * Executes pipelines with multi-stage orchestration and async support.
+ *
+ * Handles stage dependency resolution, conditional execution,
+ * mix of workflow and command stages, and state tracking.
+ */
+export declare class PipelineExecutor {
+    private workflowExecutor;
+    private commandExecutor;
+    private registry;
+    constructor(workflowExecutor: WorkflowExecutor, commandExecutor: CommandExecutor, registry: RegistryClient);
+    /**
+     * Start pipeline execution asynchronously.
+     * Returns a PipelineHandle for monitoring progress and retrieving results.
+     */
+    start(resolved: ResolvedDefinition, input: ExecutionInput): Promise<PipelineHandle>;
+    /**
+     * Execute pipeline synchronously (blocking).
+     */
+    execute(resolved: ResolvedDefinition, input: ExecutionInput): Promise<PipelineResult>;
+    private executeAsync;
+    private executeStage;
+    private checkStageDependencies;
+    /**
+     * Safe condition evaluator for stage conditions.
+     * Supports: "stage.field op value" expressions
+     */
+    private evaluateCondition;
+    /** Safely access a field on an object via runtime narrowing (avoids double assertion). */
+    private getField;
+    private createSkippedStage;
+}
+/**
+ * Handle for monitoring and controlling an async pipeline execution
+ */
+declare class PipelineHandle implements IPipelineHandle {
+    readonly executionId: string;
+    private state;
+    private execution;
+    constructor(executionId: string, state: PipelineState, execution: Promise<void>);
+    status(): Promise<PipelineResult>;
+    isComplete(): boolean;
+    wait(_pollIntervalMs?: number): Promise<PipelineResult>;
+    cancel(): Promise<void>;
+    private buildResult;
+    private computeDecision;
+}
+export {};
+//# sourceMappingURL=PipelineExecutor.d.ts.map

package/dist/executor/PipelineExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PipelineExecutor.d.ts","sourceRoot":"","sources":["../../src/executor/PipelineExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAuC,cAAc,EAAe,aAAa,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC/J,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAM5D;;;;;GAKG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,QAAQ;gBAFR,gBAAgB,EAAE,gBAAgB,EAClC,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,cAAc;IAGlC;;;OAGG;IACG,KAAK,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IA0BzF;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;YAK7E,YAAY;YAyCZ,YAAY;IAuC1B,OAAO,CAAC,sBAAsB;IAO9B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA2BzB,0FAA0F;IAC1F,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,kBAAkB;CAU3B;AAED;;GAEG;AACH,cAAM,cAAe,YAAW,eAAe;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAgB;gBAErB,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC;IAMzE,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAIvC,UAAU,IAAI,OAAO;IAIf,IAAI,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAevD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAU7B,OAAO,CAAC,WAAW;IAiDnB,OAAO,CAAC,eAAe;CAkBxB"}

package/dist/executor/PipelineExecutor.js

@@ -0,0 +1,273 @@
+import { PipelineError } from '../errors/index.js';
+import { parseRef } from '../utils/parseRef.js';
+import { formatErrorMessage } from '../utils/formatError.js';
+import { sumTokenMetrics } from '../utils/sumTokenMetrics.js';
+/**
+ * Executes pipelines with multi-stage orchestration and async support.
+ *
+ * Handles stage dependency resolution, conditional execution,
+ * mix of workflow and command stages, and state tracking.
+ */
+export class PipelineExecutor {
+    workflowExecutor;
+    commandExecutor;
+    registry;
+    constructor(workflowExecutor, commandExecutor, registry) {
+        this.workflowExecutor = workflowExecutor;
+        this.commandExecutor = commandExecutor;
+        this.registry = registry;
+    }
+    /**
+     * Start pipeline execution asynchronously.
+     * Returns a PipelineHandle for monitoring progress and retrieving results.
+     */
+    async start(resolved, input) {
+        const def = resolved.definition;
+        const pipelineId = `pipeline_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+        const state = {
+            pipelineId,
+            definitionVersion: def.pipeline.interface.version,
+            definitionHash: resolved.hash,
+            status: 'running',
+            currentStageIndex: 0,
+            stageResults: [],
+            startTime: Date.now(),
+        };
+        // Start execution in background, capturing errors into state
+        const execution = this.executeAsync(resolved, input, state);
+        execution.catch((error) => {
+            if (state.status === 'running') {
+                state.status = 'failed';
+                state.error = formatErrorMessage(error);
+            }
+        });
+        return new PipelineHandle(pipelineId, state, execution);
+    }
+    /**
+     * Execute pipeline synchronously (blocking).
+     */
+    async execute(resolved, input) {
+        const handle = await this.start(resolved, input);
+        return handle.wait(10); // Very short poll for sync mode
+    }
+    async executeAsync(resolved, input, state) {
+        const def = resolved.definition;
+        try {
+            for (let i = 0; i < def.pipeline.stages.length; i++) {
+                if (state.status === 'cancelled')
+                    break;
+                const stage = def.pipeline.stages[i];
+                if (!stage)
+                    break;
+                state.currentStageIndex = i;
+                // Check dependencies
+                if (!this.checkStageDependencies(stage.depends_on, state.stageResults)) {
+                    state.stageResults.push(this.createSkippedStage(stage, 'dependencies_not_met'));
+                    continue;
+                }
+                // Evaluate skip condition
+                if (stage.skip_if && this.evaluateCondition(stage.skip_if, state.stageResults)) {
+                    state.stageResults.push(this.createSkippedStage(stage, 'skip_if_true'));
+                    continue;
+                }
+                // Execute stage
+                const stageResult = await this.executeStage(stage, input);
+                state.stageResults.push(stageResult);
+            }
+            if (state.status === 'running') {
+                state.status = 'completed';
+            }
+        }
+        catch (error) {
+            state.status = 'failed';
+            state.error = formatErrorMessage(error);
+        }
+    }
+    async executeStage(stage, input) {
+        const [refName, refVersion] = parseRef(stage.ref);
+        const resolved = await this.registry.resolve(refName, refVersion, stage.type);
+        const startTime = Date.now();
+        try {
+            if (stage.type === 'workflow') {
+                const result = await this.workflowExecutor.execute(resolved, input);
+                return {
+                    id: stage.id,
+                    name: stage.name,
+                    type: 'workflow',
+                    status: 'completed',
+                    result,
+                    durationMs: Date.now() - startTime,
+                };
+            }
+            const result = await this.commandExecutor.execute(resolved, input);
+            return {
+                id: stage.id,
+                name: stage.name,
+                type: 'command',
+                status: 'completed',
+                result,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            return {
+                id: stage.id,
+                name: stage.name,
+                type: stage.type,
+                status: 'failed',
+                skipReason: formatErrorMessage(error),
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    checkStageDependencies(deps, results) {
+        if (!deps || deps.length === 0)
+            return true;
+        return deps.every(dep => results.some(r => r.id === dep && r.status === 'completed'));
+    }
+    /**
+     * Safe condition evaluator for stage conditions.
+     * Supports: "stage.field op value" expressions
+     */
+    evaluateCondition(condition, results) {
+        const context = Object.fromEntries(results.map(r => [r.id, r.result]));
+        const match = condition.match(/^([\w-]+)\.([\w]+)\s*(==|!=|>=|<=|>|<)\s*(?:'([^']*)'|"([^"]*)"|(\d+(?:\.\d+)?))$/);
+        if (!match)
+            return false;
+        const [, stageId, field, op, strVal1, strVal2, numVal] = match;
+        const stageResult = stageId ? context[stageId] : undefined;
+        if (!stageResult || typeof stageResult !== 'object')
+            return false;
+        const actual = this.getField(stageResult, field);
+        const expected = numVal !== undefined ? Number(numVal) : (strVal1 ?? strVal2);
+        switch (op) {
+            case '==': return String(actual) === String(expected);
+            case '!=': return String(actual) !== String(expected);
+            case '>=': return Number(actual) >= Number(expected);
+            case '<=': return Number(actual) <= Number(expected);
+            case '>': return Number(actual) > Number(expected);
+            case '<': return Number(actual) < Number(expected);
+            default: return false;
+        }
+    }
+    /** Safely access a field on an object via runtime narrowing (avoids double assertion). */
+    getField(obj, field) {
+        return field in obj ? obj[field] : undefined;
+    }
+    createSkippedStage(stage, reason) {
+        return {
+            id: stage.id,
+            name: stage.name,
+            type: stage.type,
+            status: 'skipped',
+            skipReason: reason,
+            durationMs: 0,
+        };
+    }
+}
+/**
+ * Handle for monitoring and controlling an async pipeline execution
+ */
+class PipelineHandle {
+    executionId;
+    state;
+    execution;
+    constructor(executionId, state, execution) {
+        this.executionId = executionId;
+        this.state = state;
+        this.execution = execution;
+    }
+    async status() {
+        return this.buildResult();
+    }
+    isComplete() {
+        return this.state.status !== 'running' && this.state.status !== 'pending';
+    }
+    async wait(_pollIntervalMs) {
+        // Await the actual execution promise instead of polling
+        await this.execution;
+        const result = this.buildResult();
+        if (this.state.status === 'failed') {
+            throw new PipelineError(`Pipeline ${this.executionId} failed: ${this.state.error ?? 'Unknown error'}`);
+        }
+        return result;
+    }
+    async cancel() {
+        if (this.isComplete()) {
+            throw new PipelineError(`Pipeline ${this.executionId} is already complete (status: ${this.state.status})`);
+        }
+        this.state.status = 'cancelled';
+        this.state.error = 'Pipeline cancelled by user';
+    }
+    buildResult() {
+        const durationMs = Date.now() - this.state.startTime;
+        const stageScores = this.state.stageResults
+            .map(s => s.result?.score)
+            .filter((score) => score !== undefined);
+        const score = stageScores.length > 0
+            ? stageScores.reduce((a, b) => a + b, 0) / stageScores.length
+            : 0;
+        const recommendations = this.state.stageResults
+            .flatMap(s => s.result?.recommendations ?? []);
+        const decision = this.computeDecision();
+        return {
+            type: 'pipeline',
+            name: this.state.pipelineId,
+            version: this.state.definitionVersion,
+            definitionHash: this.state.definitionHash,
+            decision,
+            score,
+            durationMs,
+            status: mapPipelineStatus(this.state.status),
+            stages: this.state.stageResults,
+            recommendations,
+            metrics: {
+                ...sumTokenMetrics(this.state.stageResults
+                    .map(s => s.result?.metrics)
+                    .filter((m) => m != null)),
+                durationMs,
+                model: 'mixed',
+                stagesExecuted: this.state.stageResults.filter(s => s.status === 'completed').length,
+                stagesPassed: this.state.stageResults.filter(s => {
+                    const d = s.result?.decision;
+                    return d === 'PASS' || d === 'SHIP' || d === 'COMPLETE';
+                }).length,
+                stagesFailed: this.state.stageResults.filter(s => {
+                    const d = s.result?.decision;
+                    return d === 'FAIL' || d === 'BLOCK' || d === 'FAILED';
+                }).length,
+                stagesSkipped: this.state.stageResults.filter(s => s.status === 'skipped').length,
+            },
+        };
+    }
+    computeDecision() {
+        if (this.state.status === 'cancelled')
+            return 'CANCELLED';
+        if (this.state.status === 'failed')
+            return 'FAIL';
+        const hasFailures = this.state.stageResults.some(s => {
+            const d = s.result?.decision;
+            return d === 'FAIL' || d === 'FAILED' || d === 'BLOCK';
+        });
+        if (hasFailures)
+            return 'FAIL';
+        const hasWarnings = this.state.stageResults.some(s => {
+            const d = s.result?.decision;
+            return d === 'WARN' || d === 'HOLD';
+        });
+        if (hasWarnings)
+            return 'WARN';
+        return 'PASS';
+    }
+}
+/** Map internal PipelineState status to PipelineResult status (completed → complete). */
+function mapPipelineStatus(status) {
+    switch (status) {
+        case 'completed': return 'complete';
+        case 'pending': return 'pending';
+        case 'running': return 'running';
+        case 'failed': return 'failed';
+        case 'cancelled': return 'cancelled';
+    }
+}
+//# sourceMappingURL=PipelineExecutor.js.map

package/dist/executor/PipelineExecutor.js.map

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

package/dist/executor/ToolHandler.d.ts

@@ -0,0 +1,47 @@
+import type { Tool, ToolUseBlock, ToolResult } from '../types/index.js';
+import type { Logger } from '@uluops/sdk-core';
+/**
+ * Handles filesystem tool calls, fulfilling them against the local target directory.
+ * All paths are sandboxed to the base path to prevent directory traversal.
+ */
+export declare class ToolHandler {
+    private basePath;
+    private logger;
+    constructor(basePath: string, logger?: Logger);
+    /**
+     * Get tool definitions for LLM API.
+     */
+    getTools(): Tool[];
+    /**
+     * Fulfill a tool call from the LLM.
+     * Dispatches to read_file, list_files, or search_content handlers.
+     * All paths are sandboxed to the base path.
+     *
+     * @param toolUse - Tool use block from the LLM response
+     * @returns Tool result with content or error
+     */
+    fulfill(toolUse: ToolUseBlock): Promise<ToolResult>;
+    /**
+     * Check if resolved path is within base path (security).
+     * Uses fs.realpath() to follow symlinks and detect escape attempts.
+     */
+    private isPathSafe;
+    private readFile;
+    private listFiles;
+    private searchContent;
+    private searchFileMode;
+    private searchCountMode;
+    private searchMatchesMode;
+    private getFileInfo;
+    private getDirectoryTree;
+    /**
+     * Recursively build directory tree, returning lines and accumulated stats.
+     * Stats bubble up so parent directories can display file count + total size
+     * without a redundant recursive glob + stat pass.
+     */
+    private buildTree;
+    private formatFileEntry;
+    private getSymbols;
+}
+export declare function extToLanguage(ext: string): string;
+//# sourceMappingURL=ToolHandler.d.ts.map

package/dist/executor/ToolHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolHandler.d.ts","sourceRoot":"","sources":["../../src/executor/ToolHandler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAsB/C;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAK7C;;OAEG;IACH,QAAQ,IAAI,IAAI,EAAE;IA4IlB;;;;;;;OAOG;IACG,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAwEzD;;;OAGG;YACW,UAAU;YAeV,QAAQ;YAyCR,SAAS;YAuCT,aAAa;YA2Cb,cAAc;YAkBd,eAAe;YAyBf,iBAAiB;YAiDjB,WAAW;YAoBX,gBAAgB;IAW9B;;;;OAIG;YACW,SAAS;YA+ET,eAAe;YAyBf,UAAU;CAmBzB;AAoDD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD"}