metheus-governance-mcp-cli 0.2.185 → 0.2.187

package/cli.mjs

@@ -20,7 +20,9 @@ import {
   planRoleExecutionWithAI,
   repairRoleExecutionPlanWithAI,
   buildLocalBotPrompt,
+  resolveIntentParserModelDisplayName,
   resolveLocalAIExecutionModel,
+  resolveResponderAdjudicatorModelDisplayName,
   resolveGeminiReasoningConfig,
   suggestLocalAIModelDisplayName,
   SUPPORTED_LOCAL_AI_CLIENTS,
@@ -2172,7 +2174,9 @@ function collectBotRunnerConversationSessionFacts(routeRaw, conversationIDRaw) {
     }
     const candidateRoute = normalizeRunnerRoute(candidateRouteRaw);
     const routeKey = runnerRouteKey(candidateRoute);
-    const session = safeObject(safeObject(safeObject(runnerState.routes)[routeKey]).conversation_sessions)[conversationID];
+    const session = safeObject(
+      safeObject(safeObject(safeObject(runnerState.routes)[routeKey]).conversation_sessions)[conversationID],
+    );
     if (!Object.keys(session).length) {
       continue;
     }
@@ -11364,6 +11368,26 @@ TELEGRAM_BOT_REVIEW_TOKEN=review-token
       && kakaotalkSupport.localTokenVerification === false,
     summarizeProviderSupport("kakaotalk"),
   );
+  push(
+    "intent_parser_default_model_uses_codex_spark_without_openai_api_key",
+    resolveIntentParserModelDisplayName({ client: "gpt", env: {} }) === "gpt-5.3-codex-spark",
+    resolveIntentParserModelDisplayName({ client: "gpt", env: {} }),
+  );
+  push(
+    "intent_parser_prefers_gpt_5_mini_when_openai_api_key_present",
+    resolveIntentParserModelDisplayName({ client: "gpt", env: { OPENAI_API_KEY: "sk-selftest" } }) === "gpt-5-mini",
+    resolveIntentParserModelDisplayName({ client: "gpt", env: { OPENAI_API_KEY: "sk-selftest" } }),
+  );
+  push(
+    "responder_adjudicator_default_model_uses_codex_spark_without_openai_api_key",
+    resolveResponderAdjudicatorModelDisplayName({ client: "gpt", env: {} }) === "gpt-5.3-codex-spark",
+    resolveResponderAdjudicatorModelDisplayName({ client: "gpt", env: {} }),
+  );
+  push(
+    "responder_adjudicator_prefers_gpt_5_mini_when_openai_api_key_present",
+    resolveResponderAdjudicatorModelDisplayName({ client: "gpt", env: { OPENAI_API_KEY: "sk-selftest" } }) === "gpt-5-mini",
+    resolveResponderAdjudicatorModelDisplayName({ client: "gpt", env: { OPENAI_API_KEY: "sk-selftest" } }),
+  );
   const unsupportedProviderRouteDiagnostics = collectRunnerRouteDiagnostics(
     {
       enabled: true,

package/lib/local-ai-adapters.mjs

@@ -25,6 +25,11 @@ const LOCAL_AI_MODEL_MAPPINGS = {
       execution: "gpt-5.4",
       aliases: ["gpt-5.4", "gpt 5.4", "GPT-5.4"],
     },
+    {
+      display: "gpt-5-mini",
+      execution: "gpt-5-mini",
+      aliases: ["gpt-5-mini", "gpt 5 mini", "GPT-5-mini", "gpt5-mini"],
+    },
     {
       display: "gpt-5.3-codex",
       execution: "gpt-5.3-codex",
@@ -1055,6 +1060,64 @@ export function suggestLocalAIModelDisplayName(clientName, rawModelValue = "") {
   return String(localAIModelMappingsForClient(clientName)[0]?.display || "").trim();
 }
 
+function truthyEnvFlag(value) {
+  const normalized = String(value || "").trim().toLowerCase();
+  return ["1", "true", "yes", "on"].includes(normalized);
+}
+
+function defaultAdjudicationModelForClient(clientName, env = process.env) {
+  const normalizedClient = normalizeLocalAIClientName(clientName, "");
+  if (normalizedClient === "gpt") {
+    const hasOpenAIAPIKey = String(env?.OPENAI_API_KEY || "").trim().length > 0;
+    const prefersMini = truthyEnvFlag(env?.METHEUS_PREFER_GPT_5_MINI_ADJUDICATOR);
+    if (hasOpenAIAPIKey || prefersMini) {
+      return "gpt-5-mini";
+    }
+    return "gpt-5.3-codex-spark";
+  }
+  return suggestLocalAIModelDisplayName(normalizedClient, "");
+}
+
+export function resolveIntentParserModelDisplayName({
+  client = "",
+  model = "",
+  env = process.env,
+} = {}) {
+  const parserClient = normalizeLocalAIClientName(
+    String(client || env?.METHEUS_INTENT_PARSER_CLIENT || "").trim(),
+    "gpt",
+  );
+  return String(
+    model
+    || env?.METHEUS_INTENT_PARSER_MODEL
+    || defaultAdjudicationModelForClient(parserClient, env)
+    || "",
+  ).trim();
+}
+
+export function resolveResponderAdjudicatorModelDisplayName({
+  client = "",
+  model = "",
+  env = process.env,
+} = {}) {
+  const adjudicatorClient = normalizeLocalAIClientName(
+    String(
+      client
+      || env?.METHEUS_RESPONDER_ADJUDICATOR_CLIENT
+      || env?.METHEUS_INTENT_PARSER_CLIENT
+      || "",
+    ).trim(),
+    "gpt",
+  );
+  return String(
+    model
+    || env?.METHEUS_RESPONDER_ADJUDICATOR_MODEL
+    || env?.METHEUS_INTENT_PARSER_MODEL
+    || defaultAdjudicationModelForClient(adjudicatorClient, env)
+    || "",
+  ).trim();
+}
+
 export function resolveLocalAIExecutionModel(clientName, rawModelValue = "") {
   const modelValue = String(rawModelValue || "").trim();
   if (!modelValue) return "";
@@ -2230,7 +2293,11 @@ export function analyzeHumanConversationIntentWithAI({
     String(client || env?.METHEUS_INTENT_PARSER_CLIENT || "").trim(),
     "gpt",
   );
-  const parserModel = String(model || env?.METHEUS_INTENT_PARSER_MODEL || suggestLocalAIModelDisplayName(parserClient, "") || "").trim();
+  const parserModel = resolveIntentParserModelDisplayName({
+    client: parserClient,
+    model,
+    env,
+  });
   const rawText = runLocalAIPromptRawText({
     client: parserClient,
     promptText: buildConversationIntentAnalysisPrompt({
@@ -2304,13 +2371,11 @@ export function adjudicateRunnerRespondersWithAI({
     ).trim(),
     "gpt",
   );
-  const adjudicatorModel = String(
-    model
-    || env?.METHEUS_RESPONDER_ADJUDICATOR_MODEL
-    || env?.METHEUS_INTENT_PARSER_MODEL
-    || suggestLocalAIModelDisplayName(adjudicatorClient, "")
-    || "",
-  ).trim();
+  const adjudicatorModel = resolveResponderAdjudicatorModelDisplayName({
+    client: adjudicatorClient,
+    model,
+    env,
+  });
   const rawText = runLocalAIPromptRawText({
     client: adjudicatorClient,
     promptText: buildResponderAdjudicationPrompt({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metheus-governance-mcp-cli",
-  "version": "0.2.185",
+  "version": "0.2.187",
   "description": "Metheus Governance MCP CLI (setup + stdio proxy)",
   "type": "module",
   "files": [