Fixed KDOC comments and applied smart cast by 'check'

Author: igordayen

embabel-agent-api/src/main/kotlin/com/embabel/agent/api/common/TerminationSignal.kt

@@ -32,7 +32,7 @@ enum class TerminationScope(val value: String) {
 }
 
 /**
- * Signal for graceful termination. When placed on the blackboard,
+ * Signal for graceful termination. When set on the agent process,
  * the agent or action will terminate at the next natural checkpoint.
  *
  * For agent termination: checked before each tick() in AbstractAgentProcess.

embabel-agent-api/src/main/kotlin/com/embabel/agent/api/termination/TerminationExtensions.kt

@@ -37,9 +37,10 @@ import com.embabel.agent.core.support.AbstractAgentProcess
  * @see com.embabel.agent.api.tool.TerminateAgentException for immediate termination
  */
 fun ProcessContext.terminateAgent(reason: String) {
-    (agentProcess as AbstractAgentProcess).setTerminationRequest(
-        TerminationSignal(TerminationScope.AGENT, reason)
-    )
+    check(agentProcess is AbstractAgentProcess) {
+        "Termination signals require AbstractAgentProcess (found: ${agentProcess::class.simpleName})"
+    }
+    agentProcess.setTerminationRequest(TerminationSignal(TerminationScope.AGENT, reason))
 }
 
 /**
@@ -58,9 +59,10 @@ fun ProcessContext.terminateAgent(reason: String) {
  * @see com.embabel.agent.api.tool.TerminateActionException for immediate termination
  */
 fun ProcessContext.terminateAction(reason: String) {
-    (agentProcess as AbstractAgentProcess).setTerminationRequest(
-        TerminationSignal(TerminationScope.ACTION, reason)
-    )
+    check(agentProcess is AbstractAgentProcess) {
+        "Termination signals require AbstractAgentProcess (found: ${agentProcess::class.simpleName})"
+    }
+    agentProcess.setTerminationRequest(TerminationSignal(TerminationScope.ACTION, reason))
 }
 
 /**