AI: harness-aware model validation, official codex contract, launch fail-fast

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QKxGW1raAWaqeU8WdHsMsp

cn/lib/ai.sh

@@ -35,6 +35,16 @@ cn_ai_combo_level() {
   jq -r --arg h "$1" --arg p "$2" '.combos[$h][$p].level // "unsupported"' "$CN_AI_COMPAT"
 }
 
+# Combo-specific model allowlist; empty output means no restriction
+cn_ai_combo_models() {
+  jq -r --arg h "$1" --arg p "$2" '.combos[$h][$p].models // [] | .[]' "$CN_AI_COMPAT"
+}
+
+cn_ai_model_protocol() {
+  jq -r --arg p "$1" --arg m "$2" \
+    '.providers[$p].models[] | select(.id == $m) | .protocol // ""' "$CN_AI_PROVIDERS"
+}
+
 # Profile files are flat key="value" lines
 cn_ai_profile_field() {
   local file="$CN_AI_PROFILE_DIR/$1.toml" key="$2"
@@ -60,7 +70,9 @@ cn_ai_render_env() {
     base=$(cn_ai_endpoint "$provider" anthropic)
     fast=$(cn_ai_fast_model "$provider")
     printf 'export ANTHROPIC_BASE_URL=%q\n' "$base"
+    # Docs vary between AUTH_TOKEN (deepseek/zai) and API_KEY (kimi): set both
     printf 'export ANTHROPIC_AUTH_TOKEN=%q\n' "$key"
+    printf 'export ANTHROPIC_API_KEY=%q\n' "$key"
     printf 'export ANTHROPIC_MODEL=%q\n' "$model"
     printf 'export ANTHROPIC_DEFAULT_SONNET_MODEL=%q\n' "$model"
     printf 'export ANTHROPIC_DEFAULT_OPUS_MODEL=%q\n' "$model"
@@ -80,7 +92,8 @@ cn_ai_render_env() {
   esac
 }
 
-# Write ~/.codex/config.toml provider block (official DeepSeek codex format)
+# Write ~/.codex/config.toml + models.json per DeepSeek's official codex
+# integration contract (mirrors cdn.deepseek.com codex-deepseek-setup script)
 cn_ai_render_codex_config() {
   local provider="$1" model="$2" key="$3"
   local base cfg="$HOME/.codex/config.toml"
@@ -93,34 +106,47 @@ cn_ai_render_codex_config() {
 
   mkdir -p "${cfg%/*}"
   touch "$cfg"
-  if [[ -s $cfg ]]; then
-    cp "$cfg" "$cfg.omarchycn-bak-$(date +%Y%m%d-%H%M%S)"
-  fi
 
-  # Top-level keys must precede the first [section]; provider table goes last.
-  # Strip our old blocks and any pre-section model keys, keep the rest intact.
+  # Strip our old blocks first, then check for an unmanaged provider table
   awk '
     /^# OmarchyCN ai (model|provider) begin$/ { skip = 1; next }
     /^# OmarchyCN ai (model|provider) end$/ { skip = 0; next }
     skip { next }
     /^\[/ { in_section = 1 }
-    !in_section && /^(model|model_provider) = / { next }
+    !in_section && /^(model|model_provider|model_catalog_json)[[:space:]]*=/ { next }
     { print }
   ' "$cfg" > "$cfg.omarchycn-tmp"
 
-  {
-    echo "# OmarchyCN ai model begin"
-    echo "model = \"$model\""
-    echo "model_provider = \"$provider\""
-    echo "# OmarchyCN ai model end"
-    cat "$cfg.omarchycn-tmp"
-    echo "# OmarchyCN ai provider begin"
-    echo "[model_providers.$provider]"
-    echo "name = \"$provider\""
-    echo "base_url = \"$base\""
-    echo "experimental_bearer_token = \"$key\""
-    echo "# OmarchyCN ai provider end"
-  } > "$cfg"
+  if grep -qE "^\[model_providers\.$provider\]" "$cfg.omarchycn-tmp"; then
+    rm -f "$cfg.omarchycn-tmp"
+    echo "codex: $cfg 已有非托管的 [model_providers.$provider]，请手动清理后重试" >&2
+    return 1
+  fi
+
+  if [[ -s $cfg ]]; then
+    cp "$cfg" "$cfg.omarchycn-bak-$(date +%Y%m%d-%H%M%S)"
+  fi
+
+  cp "$OMARCHY_PATH/cn/registry/codex-deepseek-models.json" "$HOME/.codex/models.json"
+
+  (
+    umask 077
+    {
+      echo "# OmarchyCN ai model begin"
+      echo "model = \"$model\""
+      echo "model_provider = \"$provider\""
+      echo "model_catalog_json = \"~/.codex/models.json\""
+      echo "# OmarchyCN ai model end"
+      cat "$cfg.omarchycn-tmp"
+      echo "# OmarchyCN ai provider begin"
+      echo "[model_providers.$provider]"
+      echo "name = \"$provider\""
+      echo "base_url = \"$base\""
+      echo "wire_api = \"responses\""
+      echo "experimental_bearer_token = \"$key\""
+      echo "# OmarchyCN ai provider end"
+    } > "$cfg.omarchycn-new"
+  )
+  mv "$cfg.omarchycn-new" "$cfg"
   rm -f "$cfg.omarchycn-tmp"
-  chmod 600 "$cfg"
 }

cn/registry/ai-compatibility.json

@@ -18,7 +18,13 @@
     "codex": {
       "deepseek": {
         "level": "official-doc",
-        "doc": "https://api-docs.deepseek.com/quick_start/agent_integrations/codex/"
+        "doc": "https://api-docs.deepseek.com/quick_start/agent_integrations/codex/",
+        "models": [
+          "deepseek-v4-flash",
+          "deepseek-v4-pro",
+          "deepseek-v4-flash-vision-exp"
+        ],
+        "catalog": "codex-deepseek-models.json"
       }
     },
     "opencode": {