refine utility structure

Author: Jicheng Lu

src/lib/helpers/types/agentTypes.js

@@ -131,11 +131,20 @@
 
 /**
  * @typedef {Object} AgentUtility
+ * @property {string} category 
  * @property {string} name 
  * @property {boolean} disabled
  * @property {string?} [visibility_expression]
- * @property {import('$commonTypes').NameBase[]} functions
- * @property {import('$commonTypes').NameBase[]} templates
+ * @property {UtilityItem[]} items
+ */
+
+/**
+ * @typedef {Object} UtilityItem
+ * @property {string} function_name
+ * @property {string?} [function_display_name]
+ * @property {string?} [template_name]
+ * @property {string?} [template_display_name]
+ * @property {string?} [visibility_expression]
  */
 
 /**

src/lib/helpers/utils/common.js

@@ -54,8 +54,8 @@ export function formatObject(object) {
 
 
 /**
- * @param {string?} str
- * @param {string?} prefix
+ * @param {string | null | undefined} str
+ * @param {string | null | undefined} prefix
  */
 export function truncateByPrefix(str, prefix) {
     if (!str || !prefix) {