Add CheckEnv job and enhance error handling for OAF_MODEL environment variable

Author: nmaguiar

mini-a-web.yaml

@@ -123,6 +123,7 @@ include:
 - oJobHTTPd.yaml
 
 todo:
+- CheckEnv
 - Init
 - Periodic cleanup of old sessions
 - Shutdown history S3 client
@@ -619,7 +620,7 @@ ojob:
   - oJob-common
   - mini-a
   - S3
-  catch       : printErrnl("[" + job.name + "] "); $err(exception, __, __, job.exec)
+  catch       : printErrnl("[" + job.name + "] "); printErr(exception)
   logToConsole: true   # to change when finished
   daemon      : true
   argsFromEnvs: true
@@ -634,6 +635,12 @@ ojob:
 
 jobs:
 # ---------------------
+- name : CheckEnv
+  exec : | #js
+    if (isUnDef(getEnv("OAF_MODEL"))) {
+      throw "OAF_MODEL environment variable not set. Please export OAF_MODEL with your model configuration before starting the Mini-A web server."
+    }
+
 - name : Static content
   exec : | #js
     args.path = getOPackPath("mini-a") + "/public"

mini-a.js

@@ -2932,8 +2932,9 @@ MiniA.prototype.init = function(args) {
 
     // Using OAF_MODEL env var for model selection
     if (isUnDef(getEnv("OAF_MODEL"))) {
-      logErr("OAF_MODEL environment variable not set. Please set it to your desired LLM model.")
-      return
+      var _msg = "OAF_MODEL environment variable not set. Please set it to your desired LLM model."
+      logErr(_msg)
+      throw new Error(_msg)
     }
     // Check for the low-cost model in OAF_LC_MODEL
     if (isDef(getEnv("OAF_LC_MODEL")) && isUnDef(this._oaf_lc_model)) {
@@ -3229,7 +3230,7 @@ MiniA.prototype.start = function(args) {
         this.state = "stop"
         var errMsg = (isDef(e) && isDef(e.message)) ? e.message : e
         this.fnI("error", `Agent failed: ${errMsg}`)
-        throw e
+        return
     }
 }
 

mini-a.yaml

@@ -160,19 +160,26 @@ help:
     mandatory: false
 
 todo:
+- CheckEnv
 - MiniAgent
 
 ojob:
   opacks      :
   - openaf: 20250725
   - mini-a
-  catch       : printErrnl("[" + job.name + "] "); $err(exception, __, __, job.exec)
+  catch       : printErrnl("[" + job.name + "] "); printErr(exception)
   logToConsole: false   # to change when finished
   loadLibs    :
   - mini-a.js
 
 jobs:
 # ----------------
+- name : CheckEnv
+  exec : | #js
+    if (isUnDef(getEnv("OAF_MODEL"))) {
+      throw "OAF_MODEL environment variable not set. Please export OAF_MODEL with your model configuration before running Mini-A."
+    }
+
 - name : MiniAgent
   check:
     in: