From 919c57ec4e80161e62e268cb2696ca8491523b96 Mon Sep 17 00:00:00 2001
From: Max Nigmatulin <mvnigma@gmail.com>
Date: Wed, 20 Sep 2023 12:19:33 +0300
Subject: [PATCH 1/2] Add GNN path selector

---
 Game_env/test_model.onnx                      | Bin 0 -> 82137 bytes
 buildSrc/src/main/kotlin/Versions.kt          |   2 +
 .../kotlin/usvm.kotlin-conventions.gradle.kts |   1 +
 .../src/main/kotlin/org/usvm/PathTrieNode.kt  |  13 +-
 .../src/main/kotlin/org/usvm/ps/BlockGraph.kt | 149 ++++++++++++
 .../org/usvm/ps/BlockGraphPathSelector.kt     | 196 ++++++++++++++++
 .../kotlin/org/usvm/ps/GNNPathSelector.kt     | 221 ++++++++++++++++++
 .../kotlin/org/usvm/ps/PathSelectorFactory.kt |   5 +
 .../org/usvm/statistics/ApplicationGraph.kt   |   2 +
 .../org/usvm/statistics/CoverageStatistics.kt |   4 +
 .../org/usvm/statistics/StepsStatistics.kt    |  18 ++
 .../org/usvm/machine/JcApplicationGraph.kt    |   5 +
 .../machine/interpreter/JcExprResolver.kt     |   2 +-
 .../usvm/machine/interpreter/JcInterpreter.kt |   2 +-
 .../org/usvm/machine/state/JcMethodResult.kt  |   5 +-
 .../kotlin/org/usvm/machine/state/JcState.kt  |   3 +
 .../org/usvm/machine/state/JcStateUtils.kt    |   4 +-
 .../main/kotlin/org/usvm/UMachineOptions.kt   |   7 +-
 18 files changed, 631 insertions(+), 8 deletions(-)
 create mode 100644 Game_env/test_model.onnx
 create mode 100644 usvm-core/src/main/kotlin/org/usvm/ps/BlockGraph.kt
 create mode 100644 usvm-core/src/main/kotlin/org/usvm/ps/BlockGraphPathSelector.kt
 create mode 100644 usvm-core/src/main/kotlin/org/usvm/ps/GNNPathSelector.kt
 create mode 100644 usvm-core/src/main/kotlin/org/usvm/statistics/StepsStatistics.kt

diff --git a/Game_env/test_model.onnx b/Game_env/test_model.onnx
new file mode 100644
index 0000000000000000000000000000000000000000..d67d151a47ab74565da0010d7a74a645c4d17875
GIT binary patch
literal 82137
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
D^dj(z

literal 0
HcmV?d00001

diff --git a/buildSrc/src/main/kotlin/Versions.kt b/buildSrc/src/main/kotlin/Versions.kt
index 8f765786f8..b3b0b91976 100644
--- a/buildSrc/src/main/kotlin/Versions.kt
+++ b/buildSrc/src/main/kotlin/Versions.kt
@@ -7,6 +7,8 @@ object Versions {
     const val jcdb = "1.2.0"
     const val mockk = "1.13.4"
     const val junitParams = "5.9.3"
+    const val serialization = "1.5.1"
+    const val onnxruntime = "1.15.1"
     const val logback = "1.4.8"
 
     // versions for jvm samples
diff --git a/buildSrc/src/main/kotlin/usvm.kotlin-conventions.gradle.kts b/buildSrc/src/main/kotlin/usvm.kotlin-conventions.gradle.kts
index 2d3c8a49c4..1f8c90aa72 100644
--- a/buildSrc/src/main/kotlin/usvm.kotlin-conventions.gradle.kts
+++ b/buildSrc/src/main/kotlin/usvm.kotlin-conventions.gradle.kts
@@ -20,6 +20,7 @@ dependencies {
     implementation(kotlin("stdlib-jdk8"))
     implementation(kotlin("reflect"))
     implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:${Versions.coroutines}")
+    implementation("com.microsoft.onnxruntime", "onnxruntime", Versions.onnxruntime)
 
     testImplementation(kotlin("test"))
 }
diff --git a/usvm-core/src/main/kotlin/org/usvm/PathTrieNode.kt b/usvm-core/src/main/kotlin/org/usvm/PathTrieNode.kt
index 13ae4d9b88..f8425720b9 100644
--- a/usvm-core/src/main/kotlin/org/usvm/PathTrieNode.kt
+++ b/usvm-core/src/main/kotlin/org/usvm/PathTrieNode.kt
@@ -34,6 +34,11 @@ sealed class PathsTrieNode<State : UState<*, *, Statement, *, *, State>, Stateme
      */
     abstract val depth: Int
 
+    /**
+     * States that were forked from this node
+     */
+    abstract val accumulatedForks: MutableCollection<State>
+
     /**
      * Adds a new label to [labels] collection.
      */
@@ -77,9 +82,10 @@ class PathsTrieNodeImpl<State : UState<*, *, Statement, *, *, State>, Statement>
         depth = parentNode.depth + 1,
         parent = parentNode,
         states = hashSetOf(state),
-        statement = statement
+        statement = statement,
     ) {
         parentNode.children[statement] = this
+        parentNode.accumulatedForks.addAll(this.states)
     }
 
     internal constructor(parentNode: PathsTrieNodeImpl<State, Statement>, statement: Statement, state: State) : this(
@@ -89,11 +95,14 @@ class PathsTrieNodeImpl<State : UState<*, *, Statement, *, *, State>, Statement>
         statement = statement
     ) {
         parentNode.children[statement] = this
+        parentNode.accumulatedForks.addAll(this.states)
         parentNode.states -= state
     }
 
     override val labels: MutableSet<Any> = hashSetOf()
 
+    override val accumulatedForks: MutableCollection<State> = mutableSetOf()
+
     override fun addLabel(label: Any) {
         labels.add(label)
     }
@@ -115,6 +124,8 @@ class RootNode<State : UState<*, *, Statement, *, *, State>, Statement> : PathsT
 
     override val labels: MutableSet<Any> = hashSetOf()
 
+    override val accumulatedForks: MutableCollection<State> = mutableSetOf()
+
     override val depth: Int = 0
 
     override fun addLabel(label: Any) {
diff --git a/usvm-core/src/main/kotlin/org/usvm/ps/BlockGraph.kt b/usvm-core/src/main/kotlin/org/usvm/ps/BlockGraph.kt
new file mode 100644
index 0000000000..612cd8f36b
--- /dev/null
+++ b/usvm-core/src/main/kotlin/org/usvm/ps/BlockGraph.kt
@@ -0,0 +1,149 @@
+package org.usvm.ps
+
+import org.usvm.statistics.ApplicationGraph
+
+data class Block<Statement>(
+    val id: Int,
+    var path: MutableList<Statement> = mutableListOf(),
+
+    var parents: MutableSet<Block<Statement>> = mutableSetOf(),
+    var children: MutableSet<Block<Statement>> = mutableSetOf()
+) {
+    override fun hashCode(): Int = id
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) return true
+        if (javaClass != other?.javaClass) return false
+
+        other as Block<*>
+
+        if (id != other.id) return false
+
+        return true
+    }
+}
+
+class BlockGraph<Method, Statement>(
+    initialStatement: Statement,
+    private val applicationGraph: ApplicationGraph<Method, Statement>,
+) {
+    val root: Block<Statement>
+    private var nextBlockId: Int = 0
+    private val blockStatementMapping = HashMap<Block<Statement>, MutableList<Statement>>()
+
+    val blocks: Collection<Block<Statement>>
+        get() = blockStatementMapping.keys
+
+    init {
+        root = buildGraph(initialStatement)
+    }
+
+    fun getGraphBlock(statement: Statement): Block<Statement>? {
+        blockStatementMapping.forEach {
+            if (statement in it.value) {
+                return it.key
+            }
+        }
+        return null
+    }
+
+    private fun initializeGraphBlockWith(statement: Statement): Block<Statement> {
+        val currentBlock = Block(nextBlockId++, path = mutableListOf(statement))
+        blockStatementMapping.computeIfAbsent(currentBlock) { mutableListOf() }.add(statement)
+        return currentBlock
+    }
+
+    private fun createAndLinkWithPreds(statement: Statement): Block<Statement> {
+        val currentBlock = initializeGraphBlockWith(statement)
+        for (pred in applicationGraph.predecessors(statement)) {
+            getGraphBlock(pred)?.children?.add(currentBlock)
+            getGraphBlock(pred)?.let { currentBlock.parents.add(it) }
+        }
+        return currentBlock
+    }
+
+    private fun Statement.inBlock() = getGraphBlock(this) != null
+
+    private fun ApplicationGraph<Method, Statement>.filterStmtSuccsNotInBlock(
+        statement: Statement,
+        forceNewBlock: Boolean
+    ): Sequence<Pair<Statement, Boolean>> {
+        return this.successors(statement).filter { !it.inBlock() }.map { Pair(it, forceNewBlock) }
+    }
+
+    fun buildGraph(initial: Statement): Block<Statement> {
+        val root = initializeGraphBlockWith(initial)
+        var currentBlock = root
+        val statementQueue = ArrayDeque<Pair<Statement, Boolean>>()
+
+        val initialHasMultipleSuccessors = applicationGraph.successors(initial).count() > 1
+        statementQueue.addAll(
+            applicationGraph.filterStmtSuccsNotInBlock(
+                initial,
+                forceNewBlock = initialHasMultipleSuccessors
+            )
+        )
+
+        while (statementQueue.isNotEmpty()) {
+            val (currentStatement, forceNew) = statementQueue.removeFirst()
+
+            if (forceNew) {
+                // don't need to add `currentStatement` succs, we did it earlier
+                createAndLinkWithPreds(currentStatement)
+                continue
+            }
+
+            // if statement is a call or if statement has multiple successors: next statements start new block
+            if (applicationGraph.callees(currentStatement).any() || applicationGraph.successors(currentStatement).count() > 1) {
+                currentBlock.path.add(currentStatement)
+                blockStatementMapping.computeIfAbsent(currentBlock) { mutableListOf() }.add(currentStatement)
+                statementQueue.addAll(applicationGraph.filterStmtSuccsNotInBlock(currentStatement, forceNewBlock = true))
+                continue
+            }
+
+            // if statement has multiple ins: next statements start new block
+            if (applicationGraph.predecessors(currentStatement).count() > 1) {
+                currentBlock = createAndLinkWithPreds(currentStatement)
+                blockStatementMapping.computeIfAbsent(currentBlock) { mutableListOf() }.add(currentStatement)
+                statementQueue.addAll(applicationGraph.filterStmtSuccsNotInBlock(currentStatement, forceNewBlock = true))
+                continue
+            }
+
+            currentBlock.path.add(currentStatement)
+            blockStatementMapping.computeIfAbsent(currentBlock) { mutableListOf() }.add(currentStatement)
+            statementQueue.addAll(applicationGraph.filterStmtSuccsNotInBlock(currentStatement, forceNewBlock = false))
+        }
+
+        return root
+    }
+
+    fun getEdges(): List<GameMapEdge> {
+        return blocks.flatMap { block ->
+            block.children.map { GameMapEdge(it.id, block.id, GameEdgeLabel(0)) }
+        }
+    }
+
+    fun getVertices(): Collection<Block<Statement>> = blocks
+
+    fun getBlockFeatures(
+        block: Block<Statement>, isCovered: (Statement) -> Boolean,
+        inCoverageZone: (Statement) -> Boolean,
+        isVisited: (Statement) -> Boolean,
+        stateIdsInBlock: List<UInt>
+    ): BlockFeatures {
+        val firstStatement = block.path.first()
+        val lastStatement = block.path.last()
+        val visitedByState = isVisited(lastStatement)
+        val touchedByState = visitedByState || isVisited(firstStatement)
+
+        return BlockFeatures(
+            id = block.id,
+            inCoverageZone = inCoverageZone(firstStatement),
+            basicBlockSize = block.path.size,
+            coveredByTest = isCovered(firstStatement),
+            visitedByState = visitedByState,
+            touchedByState = touchedByState,
+            states = stateIdsInBlock
+        )
+    }
+}
diff --git a/usvm-core/src/main/kotlin/org/usvm/ps/BlockGraphPathSelector.kt b/usvm-core/src/main/kotlin/org/usvm/ps/BlockGraphPathSelector.kt
new file mode 100644
index 0000000000..f45cab5941
--- /dev/null
+++ b/usvm-core/src/main/kotlin/org/usvm/ps/BlockGraphPathSelector.kt
@@ -0,0 +1,196 @@
+package org.usvm.ps
+
+import org.usvm.*
+import org.usvm.constraints.UPathConstraints
+import org.usvm.statistics.*
+import java.io.File
+import kotlin.io.path.Path
+
+data class GameEdgeLabel(
+    val token: Int
+)
+
+data class GameMapEdge(
+    val vertexFrom: Int,
+    val vertexTo: Int,
+    val label: GameEdgeLabel,
+)
+
+data class BlockFeatures(
+    val uid: Int = 0,
+    val id: Int,
+    val basicBlockSize: Int,
+    val inCoverageZone: Boolean,
+    val coveredByTest: Boolean,
+    val visitedByState: Boolean,
+    val touchedByState: Boolean,
+    val states: List<UInt>,
+)
+
+data class StateHistoryElem(
+    val graphVertexId: Int,
+    val numOfVisits: Int,
+)
+
+data class StateFeatures(
+    val id: StateId,
+    val position: Int = 0,
+    val predictedUsefulness: Int = 42,
+    val pathConditionSize: Int,
+    val visitedAgainVertices: Int,
+    val visitedNotCoveredVerticesInZone: Int,
+    val visitedNotCoveredVerticesOutOfZone: Int,
+    val history: List<StateHistoryElem>,
+    val children: List<UInt>,
+)
+
+open class BlockGraphPathSelector<State : UState<*, Method, Statement, *, *, State>, Statement, Method>(
+    private val coverageStatistics: CoverageStatistics<Method, Statement, State>,
+    val applicationGraph: ApplicationGraph<Method, Statement>
+) : UPathSelector<State> {
+    protected val states: MutableList<State> = mutableListOf()
+    private val visitedStatements = HashSet<Statement>()
+
+    private val filename: String
+
+    protected val blockGraph: BlockGraph<Method, Statement>
+
+    init {
+        val method = applicationGraph.methodOf(coverageStatistics.getUncoveredStatements().first())
+        filename = method.toString().dropWhile { it != ')' }.drop(1)
+        blockGraph = BlockGraph(applicationGraph.entryPoints(method).first(), applicationGraph)
+    }
+
+    private fun getNonThrowingLeaves(root: Block<Statement>): Collection<Block<Statement>> {
+        val queue = ArrayDeque<Block<Statement>>()
+        val visited = HashSet<Block<Statement>>()
+        val leaves = mutableListOf<Block<Statement>>()
+        queue.addAll(root.children)
+
+        while (queue.isNotEmpty()) {
+            val next = queue.removeFirst()
+            if (next.children.isEmpty() && next.path.none { applicationGraph.isThrowing(it) }) {
+                leaves.add(next)
+            }
+            visited.add(next)
+            queue.addAll(next.children)
+        }
+
+        return leaves
+    }
+
+    fun getStateFeatures(state: State): StateFeatures {
+        val blockHistory = mutableListOf<Block<Statement>>()
+
+        var lastBlock: Block<Statement> = blockGraph.root
+        blockHistory.add(lastBlock)
+        for (statement in state.listPath()) {
+            if (statement !in lastBlock.path) {
+                val someBlockOpt = blockGraph.getGraphBlock(statement)
+                // if `statement` already has a block
+                if (someBlockOpt != null) {
+                    blockHistory.add(someBlockOpt)
+                    lastBlock = someBlockOpt
+                }
+                else {  // encountered non-explored statements, extend block graph
+                    val callRoot = blockGraph.buildGraph(statement)
+                    val callExitBlocksToConnect = getNonThrowingLeaves(callRoot)
+
+                    // if `statement` is last in prev block -> connect to `lastBlock` children
+                    if (statement == lastBlock.path.last() && statement != state.listPath().last()) {
+                        lastBlock.children.forEach { lastBlockChild ->
+                            callExitBlocksToConnect.forEach { callExitBlock ->
+                                callExitBlock.children.add(lastBlockChild)
+                            }
+                        }
+                    } else { // connect to last block itself
+                        callExitBlocksToConnect.forEach { externalExitBlock ->
+                            externalExitBlock.children.add(lastBlock)
+                        }
+                    }
+                }
+            }
+        }
+
+        var visitedNotCoveredVerticesInZone = 0
+        var visitedNotCoveredVerticesOutOfZone = 0
+
+        for (block in blockHistory.map { block ->
+            blockGraph.getBlockFeatures(
+                block = block,
+                isCovered = ::isCovered,
+                inCoverageZone = ::inCoverageZone,
+                isVisited = ::isVisited,
+                stateIdsInBlock = states.filter { it.currentStatement in block.path }.map { it.id }
+            )
+        }) {
+            if (block.visitedByState && !block.coveredByTest) {
+                if (block.inCoverageZone) {
+                    visitedNotCoveredVerticesInZone += 1
+                } else visitedNotCoveredVerticesOutOfZone += 1
+            }
+        }
+
+        return StateFeatures(
+            id = state.id,
+            pathConditionSize = state.pathConstraints.size(),
+            visitedAgainVertices = state.listPath().count() - state.listPath().distinct().count(),
+            visitedNotCoveredVerticesInZone = visitedNotCoveredVerticesInZone,
+            visitedNotCoveredVerticesOutOfZone = visitedNotCoveredVerticesOutOfZone,
+            history = blockHistory.map { block ->
+                StateHistoryElem(
+                    block.id,
+                    blockHistory.count { block.id == it.id })
+            },
+            children = state.pathLocation.accumulatedForks.map { it.id }
+        )
+    }
+
+    protected fun isCovered(statement: Statement): Boolean {
+        return statement in coverageStatistics.getUncoveredStatements()
+    }
+
+    protected fun inCoverageZone(statement: Statement): Boolean {
+        return coverageStatistics.inCoverageZone(applicationGraph.methodOf(statement))
+    }
+
+    protected fun isVisited(statement: Statement) = statement in visitedStatements
+
+    override fun isEmpty(): Boolean {
+        return states.isEmpty()
+    }
+
+    override fun peek(): State {
+        return states.first()
+    }
+
+    override fun update(state: State) {}
+
+    override fun add(states: Collection<State>) {
+        this.states += states
+    }
+
+    override fun remove(state: State) {
+        states.remove(state)
+    }
+}
+
+fun <Type> UPathConstraints<Type, *>.size(): Int {
+    return numericConstraints.constraints().count() +
+            this.equalityConstraints.distinctReferences.count() +
+            this.equalityConstraints.equalReferences.count() +
+            this.equalityConstraints.referenceDisequalities.count() +
+            this.equalityConstraints.nullableDisequalities.count() +
+            this.logicalConstraints.count() +
+            this.typeConstraints.symbolicRefToTypeRegion.count()  // TODO: maybe throw out?
+}
+
+fun<State : UState<*, *, Statement, *, *, State>, Statement> UState<*, *, Statement, *, *, State>.listPath(): List<Statement> {
+    val statements = mutableListOf<Statement>()
+    var current: PathsTrieNode<State, Statement>? = this.pathLocation
+    while (current !is RootNode && current != null) {
+        statements.add(current.statement)
+        current = current.parent
+    }
+    return statements
+}
diff --git a/usvm-core/src/main/kotlin/org/usvm/ps/GNNPathSelector.kt b/usvm-core/src/main/kotlin/org/usvm/ps/GNNPathSelector.kt
new file mode 100644
index 0000000000..94bfbf6187
--- /dev/null
+++ b/usvm-core/src/main/kotlin/org/usvm/ps/GNNPathSelector.kt
@@ -0,0 +1,221 @@
+package org.usvm.ps
+
+import ai.onnxruntime.OnnxTensor
+import ai.onnxruntime.OrtEnvironment
+import ai.onnxruntime.OrtSession
+import org.usvm.UState
+import org.usvm.statistics.ApplicationGraph
+import org.usvm.statistics.CoverageStatistics
+import java.nio.FloatBuffer
+import java.nio.LongBuffer
+import kotlin.collections.set
+import kotlin.io.path.Path
+
+data class GraphNative(
+    val gameVertex: List<List<Int>>,
+    val stateVertex: List<List<Int>>,
+    val gameVertexToGameVertex: List<List<Int>>,
+    val gameVertexHistoryStateVertexIndex: List<List<Int>>,
+    val gameVertexHistoryStateVertexAttrs: List<Int>,
+    val gameVertexInStateVertex: List<List<Int>>,
+    val stateVertexParentOfStateVertex: List<List<Int>>,
+    val stateMap: Map<Int, Int>
+)
+
+open class GNNPathSelector<State : UState<*, Method, Statement, *, *, State>, Statement, Method>(
+    applicationGraph: ApplicationGraph<Method, Statement>,
+    private val coverageStatistics: CoverageStatistics<Method, Statement, State>,
+) : BlockGraphPathSelector<State, Statement, Method>(
+    coverageStatistics,
+    applicationGraph
+) {
+    companion object {
+        private val gnnModelPath = Path("/Users/emax/Data/usvm/Game_env/test_model.onnx").toString()
+        private var env: OrtEnvironment = OrtEnvironment.getEnvironment()
+        private var gnnSession: OrtSession = env.createSession(gnnModelPath)
+    }
+
+    fun coverage(): Float {
+        return coverageStatistics.getTotalCoverage()
+    }
+
+    override fun peek(): State {
+        val nativeInput = createNativeInput()
+
+        val gameVertexTensor = onnxFloatTensor(nativeInput.gameVertex)
+        val stateVertexTensor = onnxFloatTensor(nativeInput.stateVertex)
+        val gameVertexToGameVertexTensor = onnxLongTensor(nativeInput.gameVertexToGameVertex.transpose())
+        val gameVertexHistoryStateVertexIndexTensor =
+            onnxLongTensor(nativeInput.gameVertexHistoryStateVertexIndex.transpose())
+        val gameVertexHistoryStateVertexAttrsTensor =
+            onnxLongTensor(nativeInput.gameVertexHistoryStateVertexAttrs.map { listOf(it) })
+        val gameVertexInStateVertexTensor = onnxLongTensor(nativeInput.gameVertexInStateVertex.transpose())
+        val stateVertexParentOfStateVertexTensor =
+            onnxLongTensor(nativeInput.stateVertexParentOfStateVertex.transpose())
+
+        val res = gnnSession.run(
+            mapOf(
+                "game_vertex" to gameVertexTensor,
+                "state_vertex" to stateVertexTensor,
+                "game_vertex to game_vertex" to gameVertexToGameVertexTensor,
+                "game_vertex history state_vertex index" to gameVertexHistoryStateVertexIndexTensor,
+                "game_vertex history state_vertex attrs" to gameVertexHistoryStateVertexAttrsTensor,
+                "game_vertex in state_vertex" to gameVertexInStateVertexTensor,
+                "state_vertex parent_of state_vertex" to stateVertexParentOfStateVertexTensor
+            )
+        )
+
+        val predictedStatesRanks =
+            (res["out"].get().value as Array<*>).map { it as FloatArray }.map { it.toList() }.toList()
+        val chosenStateId = predictState(predictedStatesRanks, nativeInput.stateMap)
+
+        return states.single { state -> state.id.toInt() == chosenStateId }
+    }
+
+    private fun createNativeInput(): GraphNative {
+        val nodesState = mutableListOf<List<Int>>()
+        val nodesVertex = mutableListOf<List<Int>>()
+        val edgesIndexVSHistory = mutableListOf<List<Int>>()
+        val edgesAttrVS = mutableListOf<Int>()
+        val edgesIndexSS = mutableListOf<List<Int>>()
+        val edgesIndexVSIn = mutableListOf<List<Int>>()
+
+        val stateMap = mutableMapOf<Int, Int>()
+        val vertexMap = mutableMapOf<Int, Int>()
+
+        val statesFeatures = states.map { getStateFeatures(it) }
+
+        for ((stateIndexOrder, stateFeatures) in statesFeatures.withIndex()) {
+            stateMap[stateFeatures.id.toInt()] = stateIndexOrder
+            nodesState.add(stateFeatures.toList())
+        }
+
+        for ((vertexIndexOrder, vertex) in blockGraph.getVertices().withIndex()) {
+            vertexMap[vertex.id] = vertexIndexOrder
+            val blockFeatures = blockGraph.getBlockFeatures(
+                block = vertex,
+                isCovered = ::isCovered,
+                inCoverageZone = ::inCoverageZone,
+                isVisited = ::isVisited,
+                stateIdsInBlock = states.filter { it.currentStatement in vertex.path }.map { it.id }
+            )
+            nodesVertex.add(blockFeatures.toList())
+        }
+
+        val edgesIndexVV = blockGraph.getEdges().map { listOf(vertexMap[it.vertexFrom]!!, vertexMap[it.vertexTo]!!) }
+
+        for ((stateIndexOrder, stateFeatures) in statesFeatures.withIndex()) {
+            for (historyEdge in stateFeatures.history) {
+                val vertexTo = vertexMap[historyEdge.graphVertexId]!!
+                edgesIndexVSHistory.add(listOf(vertexTo, stateIndexOrder))
+                edgesAttrVS.add(historyEdge.numOfVisits)
+            }
+        }
+
+        for (stateFeatures in statesFeatures) {
+            for (childId in stateFeatures.children) {
+                if (childId.toInt() in stateMap.keys)
+                    edgesIndexSS.add(listOf(stateMap[stateFeatures.id.toInt()]!!, stateMap[childId.toInt()]!!))
+            }
+        }
+
+        for (vertex in blockGraph.getVertices()) {
+            for (state in states) {
+                edgesIndexVSIn.add(listOf(vertexMap[vertex.id]!!, stateMap[state.id.toInt()]!!))
+            }
+        }
+
+        return GraphNative(
+            gameVertex = nodesVertex,
+            stateVertex = nodesState,
+            gameVertexToGameVertex = edgesIndexVV,
+            gameVertexHistoryStateVertexIndex = edgesIndexVSHistory,
+            gameVertexHistoryStateVertexAttrs = edgesAttrVS,
+            gameVertexInStateVertex = edgesIndexVSIn,
+            stateVertexParentOfStateVertex = edgesIndexSS,
+            stateMap = stateMap
+        )
+    }
+
+    private fun List<Float>.create2DFloatBuffer(shape: Pair<Int, Int>): OnnxTensor {
+        val longArrayOfShape = longArrayOf(shape.first.toLong(), shape.second.toLong())
+        return OnnxTensor.createTensor(
+            env,
+            FloatBuffer.wrap(this.toFloatArray()),
+            longArrayOfShape
+        )
+    }
+
+    private fun List<Long>.create2DLongBuffer(shape: Pair<Int, Int>): OnnxTensor {
+        val longArrayOfShape = longArrayOf(shape.first.toLong(), shape.second.toLong())
+        return OnnxTensor.createTensor(
+            env,
+            LongBuffer.wrap(this.toLongArray()),
+            longArrayOfShape
+        )
+    }
+
+    private fun onnxFloatTensor(data: List<List<Int>>): OnnxTensor {
+        return data.flatten().map { it.toFloat() }.create2DFloatBuffer(get2DShape(data))
+    }
+
+    private fun onnxLongTensor(data: List<List<Int>>): OnnxTensor {
+        return data.flatten().map { it.toLong() }.create2DLongBuffer(get2DShape(data))
+    }
+}
+
+private fun predictState(stateRank: List<List<Float>>, stateMap: Map<Int, Int>): Int {
+    val reverseStateMap = stateMap.entries.associate { (k, v) -> v to k }
+
+    val stateRankMapping = stateRank.mapIndexed { orderIndex, rank ->
+        reverseStateMap[orderIndex]!! to rank
+    }
+
+    return stateRankMapping.maxBy { it.second.sum() }.first
+}
+
+private fun <T> get2DShape(data: List<List<T>>): Pair<Int, Int> {
+    if (data.isEmpty()) {
+        return Pair(0, 0)
+    }
+    if (data[0].isEmpty()) {
+        return Pair(data.size, 0)
+    }
+    return Pair(data.size, data[0].size)
+}
+
+private fun <T> List<List<T>>.transpose(): List<List<T>> {
+    if (this.isEmpty()) {
+        return listOf(listOf(), listOf())
+    }
+
+    val (rows, cols) = get2DShape(this)
+    return List(cols) { j ->
+        List(rows) { i ->
+            this[i][j]
+        }
+    }
+}
+
+private fun Boolean.toInt(): Int = if (this) 1 else 0
+
+private fun BlockFeatures.toList(): List<Int> {
+    return listOf(
+        this.inCoverageZone.toInt(),
+        this.basicBlockSize,
+        this.coveredByTest.toInt(),
+        this.visitedByState.toInt(),
+        this.touchedByState.toInt()
+    )
+}
+
+private fun StateFeatures.toList(): List<Int> {
+    return listOf(
+        this.position,
+        this.predictedUsefulness,
+        this.pathConditionSize,
+        this.visitedAgainVertices,
+        this.visitedNotCoveredVerticesInZone,
+        this.visitedNotCoveredVerticesOutOfZone
+    )
+}
diff --git a/usvm-core/src/main/kotlin/org/usvm/ps/PathSelectorFactory.kt b/usvm-core/src/main/kotlin/org/usvm/ps/PathSelectorFactory.kt
index 321c04ff56..9b1a933fcc 100644
--- a/usvm-core/src/main/kotlin/org/usvm/ps/PathSelectorFactory.kt
+++ b/usvm-core/src/main/kotlin/org/usvm/ps/PathSelectorFactory.kt
@@ -84,6 +84,11 @@ fun <Method, Statement, Target : UTarget<Statement, Target, State>, State : USta
                 applicationGraph,
                 random
             )
+
+            PathSelectionStrategy.GNN -> GNNPathSelector(
+                applicationGraph,
+                requireNotNull(coverageStatistics()) { "Coverage statistics is required for Hetero GNN path selector" },
+            )
         }
     }
 
diff --git a/usvm-core/src/main/kotlin/org/usvm/statistics/ApplicationGraph.kt b/usvm-core/src/main/kotlin/org/usvm/statistics/ApplicationGraph.kt
index 48fab1befe..aa02c7fdd2 100644
--- a/usvm-core/src/main/kotlin/org/usvm/statistics/ApplicationGraph.kt
+++ b/usvm-core/src/main/kotlin/org/usvm/statistics/ApplicationGraph.kt
@@ -13,4 +13,6 @@ interface ApplicationGraph<Method, Statement> {
     fun methodOf(node: Statement): Method
 
     fun statementsOf(method: Method): Sequence<Statement>
+
+    fun isThrowing(node: Statement): Boolean
 }
diff --git a/usvm-core/src/main/kotlin/org/usvm/statistics/CoverageStatistics.kt b/usvm-core/src/main/kotlin/org/usvm/statistics/CoverageStatistics.kt
index d2751472f8..2d345ec347 100644
--- a/usvm-core/src/main/kotlin/org/usvm/statistics/CoverageStatistics.kt
+++ b/usvm-core/src/main/kotlin/org/usvm/statistics/CoverageStatistics.kt
@@ -89,6 +89,10 @@ class CoverageStatistics<Method, Statement, State : UState<*, Method, Statement,
         return uncoveredStatements.values.flatten()
     }
 
+    fun inCoverageZone(method: Method): Boolean {
+        return coveredStatements.containsKey(method) || uncoveredStatements.containsKey(method)
+    }
+
     /**
      * Adds a listener triggered when a new statement is covered.
      */
diff --git a/usvm-core/src/main/kotlin/org/usvm/statistics/StepsStatistics.kt b/usvm-core/src/main/kotlin/org/usvm/statistics/StepsStatistics.kt
new file mode 100644
index 0000000000..40d2266bee
--- /dev/null
+++ b/usvm-core/src/main/kotlin/org/usvm/statistics/StepsStatistics.kt
@@ -0,0 +1,18 @@
+package org.usvm.statistics
+
+import org.usvm.UState
+
+
+/**
+ * [UMachineObserver] which tracks amount of steps taken
+ *
+ */
+class StepsStatistics<State : UState<*, *, *, *, *, *>> : UMachineObserver<State> {
+
+    private var steps = 0
+    override fun onState(parent: State, forks: Sequence<State>) {
+        steps += 1
+    }
+
+    fun getStepsCount() = steps
+}
diff --git a/usvm-jvm/src/main/kotlin/org/usvm/machine/JcApplicationGraph.kt b/usvm-jvm/src/main/kotlin/org/usvm/machine/JcApplicationGraph.kt
index f0a0e2bb4a..405159e5cb 100644
--- a/usvm-jvm/src/main/kotlin/org/usvm/machine/JcApplicationGraph.kt
+++ b/usvm-jvm/src/main/kotlin/org/usvm/machine/JcApplicationGraph.kt
@@ -5,6 +5,7 @@ import org.jacodb.api.JcClasspath
 import org.jacodb.api.JcMethod
 import org.jacodb.api.JcTypedMethod
 import org.jacodb.api.cfg.JcInst
+import org.jacodb.api.cfg.JcThrowInst
 import org.jacodb.api.ext.toType
 import org.jacodb.impl.features.HierarchyExtensionImpl
 import org.jacodb.impl.features.SyncUsagesExtension
@@ -73,4 +74,8 @@ class JcApplicationGraph(
 
         return statements
     }
+
+    override fun isThrowing(node: JcInst): Boolean {
+        return node is JcThrowInst
+    }
 }
diff --git a/usvm-jvm/src/main/kotlin/org/usvm/machine/interpreter/JcExprResolver.kt b/usvm-jvm/src/main/kotlin/org/usvm/machine/interpreter/JcExprResolver.kt
index 7fd0043522..c7d6fb55e4 100644
--- a/usvm-jvm/src/main/kotlin/org/usvm/machine/interpreter/JcExprResolver.kt
+++ b/usvm-jvm/src/main/kotlin/org/usvm/machine/interpreter/JcExprResolver.kt
@@ -805,7 +805,7 @@ class JcExprResolver(
     fun allocateException(type: JcRefType): (JcState) -> Unit = { state ->
         // TODO should we consider exceptions with negative addresses?
         val address = state.memory.allocConcrete(type)
-        state.throwExceptionWithoutStackFrameDrop(address, type)
+        state.throwExceptionWithoutStackFrameDrop(address, type, false)
     }
 
     fun checkArrayIndex(idx: USizeExpr, length: USizeExpr) = with(ctx) {
diff --git a/usvm-jvm/src/main/kotlin/org/usvm/machine/interpreter/JcInterpreter.kt b/usvm-jvm/src/main/kotlin/org/usvm/machine/interpreter/JcInterpreter.kt
index 5e6f15c3b9..372d81288b 100644
--- a/usvm-jvm/src/main/kotlin/org/usvm/machine/interpreter/JcInterpreter.kt
+++ b/usvm-jvm/src/main/kotlin/org/usvm/machine/interpreter/JcInterpreter.kt
@@ -334,7 +334,7 @@ class JcInterpreter(
         val address = resolver.resolveJcExpr(stmt.throwable)?.asExpr(ctx.addressSort) ?: return
 
         scope.calcOnState {
-            throwExceptionWithoutStackFrameDrop(address, stmt.throwable.type)
+            throwExceptionWithoutStackFrameDrop(address, stmt.throwable.type, expected = true)
         }
     }
 
diff --git a/usvm-jvm/src/main/kotlin/org/usvm/machine/state/JcMethodResult.kt b/usvm-jvm/src/main/kotlin/org/usvm/machine/state/JcMethodResult.kt
index f0f05b2663..29c5688d68 100644
--- a/usvm-jvm/src/main/kotlin/org/usvm/machine/state/JcMethodResult.kt
+++ b/usvm-jvm/src/main/kotlin/org/usvm/machine/state/JcMethodResult.kt
@@ -31,8 +31,9 @@ sealed interface JcMethodResult {
     open class JcException(
         val address: UHeapRef,
         val type: JcType,
-        val symbolicStackTrace: List<UStackTraceFrame<JcMethod, JcInst>>
+        val symbolicStackTrace: List<UStackTraceFrame<JcMethod, JcInst>>,
+        val expected: Boolean,
     ) : JcMethodResult {
-        override fun toString(): String = "${this::class.simpleName}: Address: $address, type: ${type.typeName}"
+        override fun toString(): String = "${this::class.simpleName}: Address: $address, type: ${type.typeName}, is expected: $expected"
     }
 }
diff --git a/usvm-jvm/src/main/kotlin/org/usvm/machine/state/JcState.kt b/usvm-jvm/src/main/kotlin/org/usvm/machine/state/JcState.kt
index 066c9ded34..ae05f53271 100644
--- a/usvm-jvm/src/main/kotlin/org/usvm/machine/state/JcState.kt
+++ b/usvm-jvm/src/main/kotlin/org/usvm/machine/state/JcState.kt
@@ -47,6 +47,9 @@ class JcState(
     override val isExceptional: Boolean
         get() = methodResult is JcMethodResult.JcException
 
+    val isExceptionalAndNotExpected: Boolean
+        get() = isExceptional && !(methodResult as JcMethodResult.JcException).expected
+
     override fun toString(): String = buildString {
         appendLine("Instruction: $lastStmt")
         if (isExceptional) appendLine("Exception: $methodResult")
diff --git a/usvm-jvm/src/main/kotlin/org/usvm/machine/state/JcStateUtils.kt b/usvm-jvm/src/main/kotlin/org/usvm/machine/state/JcStateUtils.kt
index 4dafd26f58..9b7a8e112e 100644
--- a/usvm-jvm/src/main/kotlin/org/usvm/machine/state/JcStateUtils.kt
+++ b/usvm-jvm/src/main/kotlin/org/usvm/machine/state/JcStateUtils.kt
@@ -37,8 +37,8 @@ fun JcState.returnValue(valueToReturn: UExpr<out USort>) {
 /**
  * Create an unprocessed exception with the [address] and the [type] and assign it to the [JcState.methodResult].
  */
-fun JcState.throwExceptionWithoutStackFrameDrop(address: UHeapRef, type: JcType) {
-    methodResult = JcMethodResult.JcException(address, type, callStack.stackTrace(lastStmt))
+fun JcState.throwExceptionWithoutStackFrameDrop(address: UHeapRef, type: JcType, expected: Boolean) {
+    methodResult = JcMethodResult.JcException(address, type, callStack.stackTrace(lastStmt), expected)
 }
 
 fun JcState.throwExceptionAndDropStackFrame() {
diff --git a/usvm-util/src/main/kotlin/org/usvm/UMachineOptions.kt b/usvm-util/src/main/kotlin/org/usvm/UMachineOptions.kt
index 797a631e09..b2e52287af 100644
--- a/usvm-util/src/main/kotlin/org/usvm/UMachineOptions.kt
+++ b/usvm-util/src/main/kotlin/org/usvm/UMachineOptions.kt
@@ -77,7 +77,12 @@ enum class PathSelectionStrategy {
      * reachability.
      * States are selected randomly with distribution based on distance to targets.
      */
-    TARGETED_CALL_STACK_LOCAL_RANDOM
+    TARGETED_CALL_STACK_LOCAL_RANDOM,
+
+    /**
+     * Selects state with the best score according to GNN
+     */
+    GNN
 }
 
 enum class PathSelectorCombinationStrategy {

From 961053db8d1acce2337280238573e62270a2b4a0 Mon Sep 17 00:00:00 2001
From: Max Nigmatulin <mvnigma@gmail.com>
Date: Wed, 20 Sep 2023 12:36:42 +0300
Subject: [PATCH 2/2] Fix CI, refactor code

---
 .../main/kotlin/org/usvm/ps/BlockGraphPathSelector.kt  | 10 ++++------
 .../src/test/kotlin/org/usvm/TestApplicationGraph.kt   |  2 ++
 .../kotlin/org/usvm/machine/SampleApplicationGraph.kt  |  2 ++
 3 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/usvm-core/src/main/kotlin/org/usvm/ps/BlockGraphPathSelector.kt b/usvm-core/src/main/kotlin/org/usvm/ps/BlockGraphPathSelector.kt
index f45cab5941..87e549337e 100644
--- a/usvm-core/src/main/kotlin/org/usvm/ps/BlockGraphPathSelector.kt
+++ b/usvm-core/src/main/kotlin/org/usvm/ps/BlockGraphPathSelector.kt
@@ -2,9 +2,8 @@ package org.usvm.ps
 
 import org.usvm.*
 import org.usvm.constraints.UPathConstraints
-import org.usvm.statistics.*
-import java.io.File
-import kotlin.io.path.Path
+import org.usvm.statistics.ApplicationGraph
+import org.usvm.statistics.CoverageStatistics
 
 data class GameEdgeLabel(
     val token: Int
@@ -91,8 +90,7 @@ open class BlockGraphPathSelector<State : UState<*, Method, Statement, *, *, Sta
                 if (someBlockOpt != null) {
                     blockHistory.add(someBlockOpt)
                     lastBlock = someBlockOpt
-                }
-                else {  // encountered non-explored statements, extend block graph
+                } else {  // encountered non-explored statements, extend block graph
                     val callRoot = blockGraph.buildGraph(statement)
                     val callExitBlocksToConnect = getNonThrowingLeaves(callRoot)
 
@@ -185,7 +183,7 @@ fun <Type> UPathConstraints<Type, *>.size(): Int {
             this.typeConstraints.symbolicRefToTypeRegion.count()  // TODO: maybe throw out?
 }
 
-fun<State : UState<*, *, Statement, *, *, State>, Statement> UState<*, *, Statement, *, *, State>.listPath(): List<Statement> {
+fun <State : UState<*, *, Statement, *, *, State>, Statement> UState<*, *, Statement, *, *, State>.listPath(): List<Statement> {
     val statements = mutableListOf<Statement>()
     var current: PathsTrieNode<State, Statement>? = this.pathLocation
     while (current !is RootNode && current != null) {
diff --git a/usvm-core/src/test/kotlin/org/usvm/TestApplicationGraph.kt b/usvm-core/src/test/kotlin/org/usvm/TestApplicationGraph.kt
index e87ad7f549..d85252a5d8 100644
--- a/usvm-core/src/test/kotlin/org/usvm/TestApplicationGraph.kt
+++ b/usvm-core/src/test/kotlin/org/usvm/TestApplicationGraph.kt
@@ -104,6 +104,8 @@ private class TestApplicationGraphBuilderImpl : TestApplicationGraphBuilder, App
             .map { TestInstruction(method, it) }
             .asSequence()
     }
+
+    override fun isThrowing(node: TestInstruction) = false
 }
 
 internal fun appGraph(init: TestApplicationGraphBuilder.() -> Unit): ApplicationGraph<String, TestInstruction> {
diff --git a/usvm-sample-language/src/main/kotlin/org/usvm/machine/SampleApplicationGraph.kt b/usvm-sample-language/src/main/kotlin/org/usvm/machine/SampleApplicationGraph.kt
index fc5675da0c..35f99a74ac 100644
--- a/usvm-sample-language/src/main/kotlin/org/usvm/machine/SampleApplicationGraph.kt
+++ b/usvm-sample-language/src/main/kotlin/org/usvm/machine/SampleApplicationGraph.kt
@@ -137,6 +137,8 @@ class SampleApplicationGraph(
         return info.method
     }
 
+    override fun isThrowing(node: Stmt) = false
+
     private data class StmtInfo(
         val method: Method<*>,
         val predecessors: List<Stmt>,