u-foo 2.2.3 → 2.3.0

package/src/bus/subscriber.js

@@ -175,20 +175,29 @@ class SubscriberManager {
     // 检查是否是重新加入（rejoin）
     const existingMeta = this.busData.agents[subscriber];
     let finalNickname = nickname;
+    let finalScopedNickname = typeof options.scopedNickname === "string"
+      ? options.scopedNickname.trim()
+      : (typeof process.env.UFOO_SCOPED_NICKNAME === "string" ? process.env.UFOO_SCOPED_NICKNAME.trim() : "");
 
-    if (existingMeta && existingMeta.nickname) {
-      // 重新加入，保留原昵称
-      finalNickname = existingMeta.nickname;
-    } else if (nickname) {
+    if (nickname) {
       // 新昵称，检查冲突
-      if (nicknameManager.nicknameExists(nickname, subscriber)) {
+      const conflictTarget = finalScopedNickname || nickname;
+      if (nicknameManager.nicknameExists(conflictTarget, subscriber)) {
         throw new Error(`Nickname "${nickname}" already exists`);
       }
       finalNickname = nickname;
+    } else if (existingMeta && existingMeta.nickname) {
+      // 重新加入，保留原昵称
+      finalNickname = existingMeta.nickname;
+      finalScopedNickname = existingMeta.scoped_nickname || finalScopedNickname || finalNickname;
     } else {
       // 自动生成昵称（并标记占用，避免并发重复）
       finalNickname = nicknameManager.generateAutoNickname(agentType);
-      nicknameManager.setNickname(subscriber, finalNickname);
+      nicknameManager.setNickname(subscriber, finalNickname, finalScopedNickname);
+    }
+
+    if (!finalScopedNickname) {
+      finalScopedNickname = existingMeta?.scoped_nickname || finalNickname;
     }
 
     const explicitLaunchMode = typeof options.launchMode === "string"
@@ -221,6 +230,7 @@ class SubscriberManager {
     const inheritedNickname = await this.cleanupDuplicateTty(subscriber, finalTty);
     if (inheritedNickname && !nickname && !existingMeta) {
       finalNickname = inheritedNickname;
+      if (!finalScopedNickname) finalScopedNickname = inheritedNickname;
     }
 
     // 更新订阅者信息（保留已有字段，如 provider_session_*）
@@ -252,6 +262,7 @@ class SubscriberManager {
       ...preserved,
       agent_type: agentType,
       nickname: finalNickname,
+      scoped_nickname: finalScopedNickname || finalNickname,
       status: "active",
       activity_state: "starting",
       activity_since: getTimestamp(),
@@ -311,7 +322,11 @@ class SubscriberManager {
     // 创建队列目录
     this.queueManager.ensureQueueDir(subscriber);
 
-    return { subscriber, nickname: finalNickname };
+    return {
+      subscriber,
+      nickname: finalNickname,
+      scopedNickname: this.busData.agents[subscriber].scoped_nickname || finalNickname,
+    };
   }
 
   /**
@@ -333,22 +348,27 @@ class SubscriberManager {
   /**
    * 重命名订阅者
    */
-  async rename(subscriber, newNickname) {
+  async rename(subscriber, newNickname, options = {}) {
     if (!this.busData.agents || !this.busData.agents[subscriber]) {
       throw new Error(`Subscriber "${subscriber}" not found`);
     }
 
     const nicknameManager = new NicknameManager(this.busData);
+    const scopedNickname = typeof options.scopedNickname === "string" && options.scopedNickname.trim()
+      ? options.scopedNickname.trim()
+      : newNickname;
 
     // 检查昵称冲突
-    if (nicknameManager.nicknameExists(newNickname, subscriber)) {
+    if (nicknameManager.nicknameExists(scopedNickname, subscriber)) {
       throw new Error(`Nickname "${newNickname}" already exists`);
     }
 
     const oldNickname = this.busData.agents[subscriber].nickname;
+    const oldScopedNickname = this.busData.agents[subscriber].scoped_nickname || oldNickname;
     this.busData.agents[subscriber].nickname = newNickname;
+    this.busData.agents[subscriber].scoped_nickname = scopedNickname;
 
-    return { subscriber, oldNickname, newNickname };
+    return { subscriber, oldNickname, newNickname, oldScopedNickname, newScopedNickname: scopedNickname };
   }
 
   /**

package/src/chat/agentDirectory.js

@@ -10,8 +10,8 @@ function buildAgentMaps(activeAgents = [], metaList = [], fallbackMap = null) {
 
   for (const id of activeAgents) {
     const meta = metaById.get(id);
-    const label = meta && meta.nickname
-      ? meta.nickname
+    const label = meta && (meta.display_nickname || meta.nickname)
+      ? (meta.display_nickname || meta.nickname)
       : (fallbackMap && fallbackMap.get(id)) || id;
     labelMap.set(id, label);
     if (meta) {

package/src/chat/commandExecutor.js

@@ -11,10 +11,15 @@ const {
   normalizeControllerMode,
 } = require("../config");
 const { resolveTransport } = require("../code/nativeRunner");
+const { resolveDisplayNickname } = require("../daemon/nicknameScope");
 const { parseIntervalMs, formatIntervalMs } = require("./cronScheduler");
 const { isGlobalControllerProjectRoot, resolveGlobalControllerUfooDir } = require("../projects");
 const { loadPromptProfileRegistry } = require("../group/promptProfiles");
 const { resolveSoloAgentType } = require("../solo/commands");
+const {
+  inspectDirectAuthStatus,
+  formatDirectAuthStatus,
+} = require("../agent/directAuthStatus");
 
 function defaultCreateDoctor(projectRoot) {
   const UfooDoctor = require("../doctor");
@@ -38,6 +43,41 @@ function defaultResolveTerminalApp() {
   return "";
 }
 
+const SETTINGS_MODEL_DEFAULTS = Object.freeze({
+  agent: Object.freeze({
+    codex: "gpt-5.5",
+    claude: "opus-4.7",
+  }),
+  router: Object.freeze({
+    codex: "gpt-5.4-mini",
+    claude: "sonnet-4.7",
+  }),
+});
+
+function normalizeSettingsProvider(value = "", fallback = "codex-cli") {
+  const text = String(value || "").trim().toLowerCase();
+  if (text === "claude" || text === "claude-cli" || text === "claude-code" || text === "anthropic") {
+    return "claude-cli";
+  }
+  if (text === "codex" || text === "codex-cli" || text === "codex-code" || text === "openai") {
+    return "codex-cli";
+  }
+  return fallback;
+}
+
+function agentProviderKey(value = "") {
+  return normalizeSettingsProvider(value) === "claude-cli" ? "claude" : "codex";
+}
+
+function defaultAgentModelForProvider(value = "") {
+  return SETTINGS_MODEL_DEFAULTS.agent[agentProviderKey(value)] || SETTINGS_MODEL_DEFAULTS.agent.codex;
+}
+
+function defaultGateModelForProvider(value = "") {
+  const key = agentProviderKey(value);
+  return SETTINGS_MODEL_DEFAULTS.router[key] || SETTINGS_MODEL_DEFAULTS.router.codex;
+}
+
 function collectHostLaunchRequestContext(env = process.env) {
   const hostInjectSock = String(env.UFOO_HOST_INJECT_SOCK || env.HORIZON_INJECT_SOCK || "").trim();
   const hostDaemonSock = String(env.UFOO_HOST_DAEMON_SOCK || "").trim();
@@ -101,6 +141,8 @@ function createCommandExecutor(options = {}) {
     listCronTasks = () => [],
     stopCronTask = () => false,
     runGroupCore = runGroupCoreCommand,
+    inspectDirectAuth = inspectDirectAuthStatus,
+    formatDirectAuth = formatDirectAuthStatus,
     requestCron = null,
     globalMode = false,
     listProjects = () => [],
@@ -163,6 +205,14 @@ function createCommandExecutor(options = {}) {
     } else {
       logMessage("system", "{white-fg}✗{/white-fg} Daemon is not running");
     }
+
+    const authStatus = await inspectDirectAuth({
+      projectRoot: getActiveProjectRoot(),
+      autoRefresh: false,
+    });
+    for (const line of formatDirectAuth(authStatus, { compact: true })) {
+      logMessage("system", escapeBlessed(line));
+    }
   }
 
   async function handleDaemonCommand(args = []) {
@@ -319,7 +369,8 @@ function createCommandExecutor(options = {}) {
         } else {
           logMessage("system", "{cyan-fg}Active agents:{/cyan-fg}");
           for (const [id, meta] of subscribers) {
-            const nickname = meta && meta.nickname ? ` (${meta.nickname})` : "";
+            const displayNickname = meta ? resolveDisplayNickname(projectRoot, meta) : "";
+            const nickname = displayNickname ? ` (${displayNickname})` : "";
             const status = meta && meta.status ? meta.status : "unknown";
             logMessage("system", `  • ${id}${nickname} {white-fg}[${status}]{/white-fg}`);
           }
@@ -1138,8 +1189,14 @@ function createCommandExecutor(options = {}) {
 
   async function handleSettingsCommand(args = []) {
     const section = String(args[0] || "").trim().toLowerCase();
-    if (!section) {
-      logMessage("error", "{white-fg}✗{/white-fg} Usage: /settings <router|ucode> ...");
+    if (!section || section === "show" || section === "status") {
+      await handleSettingsOverviewCommand();
+      return;
+    }
+
+    if (section === "agent" || section === "ufoo") {
+      const subArgs = args.slice(1);
+      await handleAgentSettingsCommand(subArgs);
       return;
     }
 
@@ -1159,7 +1216,116 @@ function createCommandExecutor(options = {}) {
       return;
     }
 
-    logMessage("error", "{white-fg}✗{/white-fg} Unknown settings section. Use: router, ucode");
+    logMessage("error", "{white-fg}✗{/white-fg} Unknown settings section. Use: show, agent, router, ucode");
+  }
+
+  async function handleSettingsOverviewCommand() {
+    const config = loadConfig(projectRoot) || {};
+    const agentProvider = normalizeSettingsProvider(config.agentProvider);
+    const agentKey = agentProviderKey(agentProvider);
+    const agentModel = String(config.agentModel || "").trim();
+    const routerMode = normalizeControllerMode(config.controllerMode);
+    const routerProvider = String(config.routerProvider || "").trim();
+    const routerModel = String(config.routerModel || "").trim();
+    const ucodeConfig = loadUcodeConfig() || {};
+    const ucodeProvider = String(ucodeConfig.ucodeProvider || "").trim();
+    const ucodeModel = String(ucodeConfig.ucodeModel || "").trim();
+
+    logMessage("system", "{cyan-fg}settings:{/cyan-fg}");
+    logMessage("system", `  • agent: ${agentKey} · model ${agentModel || `(unset, recommended ${defaultAgentModelForProvider(agentProvider)})`}`);
+    logMessage("system", `  • router: mode ${routerMode} · provider ${routerProvider || "(unset)"} · model ${routerModel || "(unset)"}`);
+    logMessage("system", `  • ucode: provider ${ucodeProvider || "(unset)"} · model ${ucodeModel || "(unset)"}`);
+    logMessage("system", "  • use: /settings agent | /settings router | /settings ucode");
+  }
+
+  async function handleAgentSettingsCommand(args = []) {
+    const first = String(args[0] || "").trim().toLowerCase();
+    const hasInlineKv = args.some((item) => String(item || "").includes("="));
+    const action = !first ? "show" : (hasInlineKv ? "set" : first);
+
+    if (action === "show" || action === "status") {
+      const config = loadConfig(projectRoot) || {};
+      const provider = normalizeSettingsProvider(config.agentProvider);
+      const key = agentProviderKey(provider);
+      const model = String(config.agentModel || "").trim();
+      logMessage("system", "{cyan-fg}ufoo-agent config:{/cyan-fg}");
+      logMessage("system", `  • provider: ${key}`);
+      logMessage("system", `  • model: ${model || `(unset, recommended ${defaultAgentModelForProvider(provider)})`}`);
+      logMessage("system", `  • defaults: codex=${SETTINGS_MODEL_DEFAULTS.agent.codex}, claude=${SETTINGS_MODEL_DEFAULTS.agent.claude}`);
+      logMessage("system", "  • use: /settings agent set provider=<codex|claude> model=<id>");
+      return;
+    }
+
+    if (action === "codex" || action === "claude") {
+      const kv = parseKeyValueArgs(args.slice(1));
+      const provider = action === "claude" ? "claude-cli" : "codex-cli";
+      const model = String(kv.model || defaultAgentModelForProvider(provider)).trim();
+      saveConfig(projectRoot, {
+        agentProvider: provider,
+        agentModel: model,
+      });
+      logMessage("system", "{white-fg}✓{/white-fg} ufoo-agent config updated");
+      logMessage("system", `  • provider: ${agentProviderKey(provider)}`);
+      logMessage("system", `  • model: ${model}`);
+      await restartDaemon(projectRoot);
+      return;
+    }
+
+    if (action === "set") {
+      const kvArgs = hasInlineKv ? args : args.slice(1);
+      const kv = parseKeyValueArgs(kvArgs);
+      const updates = {};
+      let nextProvider = "";
+
+      if (Object.prototype.hasOwnProperty.call(kv, "provider")) {
+        nextProvider = normalizeSettingsProvider(kv.provider, "");
+        if (!nextProvider) {
+          logMessage("error", "{white-fg}✗{/white-fg} Usage: /settings agent set provider=<codex|claude> model=<id>");
+          return;
+        }
+        updates.agentProvider = nextProvider;
+      }
+      if (Object.prototype.hasOwnProperty.call(kv, "model")) {
+        updates.agentModel = String(kv.model || "").trim();
+      } else if (nextProvider) {
+        updates.agentModel = defaultAgentModelForProvider(nextProvider);
+      }
+
+      if (Object.keys(updates).length === 0) {
+        logMessage("error", "{white-fg}✗{/white-fg} Usage: /settings agent set provider=<codex|claude> model=<id>");
+        return;
+      }
+
+      saveConfig(projectRoot, updates);
+      logMessage("system", "{white-fg}✓{/white-fg} ufoo-agent config updated");
+      if (Object.prototype.hasOwnProperty.call(updates, "agentProvider")) {
+        logMessage("system", `  • provider: ${agentProviderKey(updates.agentProvider)}`);
+      }
+      if (Object.prototype.hasOwnProperty.call(updates, "agentModel")) {
+        logMessage("system", `  • model: ${updates.agentModel || "(unset)"}`);
+      }
+      await restartDaemon(projectRoot);
+      return;
+    }
+
+    if (action === "clear") {
+      const fieldsRaw = args.slice(1).map((item) => String(item || "").trim().toLowerCase()).filter(Boolean);
+      const fields = fieldsRaw.length === 0 ? ["model"] : fieldsRaw;
+      const updates = {};
+      const clearAll = fields.includes("all");
+      if (clearAll || fields.includes("provider")) updates.agentProvider = "codex-cli";
+      if (clearAll || fields.includes("model")) updates.agentModel = "";
+      if (Object.keys(updates).length === 0) {
+        logMessage("error", "{white-fg}✗{/white-fg} Usage: /settings agent clear [provider|model|all]");
+        return;
+      }
+      saveConfig(projectRoot, updates);
+      logMessage("system", "{white-fg}✓{/white-fg} ufoo-agent config cleared");
+      await restartDaemon(projectRoot);
+      return;
+    }
+
+    logMessage("error", "{white-fg}✗{/white-fg} Unknown settings agent action. Use: show, set, clear, codex, claude");
   }
 
   async function handleRouterSettingsCommand(args = []) {
@@ -1170,11 +1336,27 @@ function createCommandExecutor(options = {}) {
     if (action === "show" || action === "status") {
       const config = loadConfig(projectRoot) || {};
       const mode = normalizeControllerMode(config.controllerMode);
-      logMessage("system", "{cyan-fg}router config:{/cyan-fg}");
+      logMessage("system", "{cyan-fg}gate router config:{/cyan-fg}");
       logMessage("system", `  • controllerMode: ${mode}`);
       logMessage("system", `  • provider: ${String(config.routerProvider || "").trim() || "(unset)"}`);
       logMessage("system", `  • model: ${String(config.routerModel || "").trim() || "(unset)"}`);
       logMessage("system", "  • allowed modes: main | loop | legacy | shadow");
+      logMessage("system", `  • defaults: codex=${SETTINGS_MODEL_DEFAULTS.router.codex}, claude=${SETTINGS_MODEL_DEFAULTS.router.claude}`);
+      return;
+    }
+
+    if (action === "codex" || action === "claude") {
+      const kv = parseKeyValueArgs(args.slice(1));
+      const provider = action;
+      const model = String(kv.model || defaultGateModelForProvider(provider)).trim();
+      saveConfig(projectRoot, {
+        routerProvider: provider,
+        routerModel: model,
+      });
+      logMessage("system", "{white-fg}✓{/white-fg} gate router config updated");
+      logMessage("system", `  • provider: ${provider}`);
+      logMessage("system", `  • model: ${model}`);
+      await restartDaemon(projectRoot);
       return;
     }
 
@@ -1200,7 +1382,7 @@ function createCommandExecutor(options = {}) {
       }
 
       saveConfig(projectRoot, updates);
-      logMessage("system", "{white-fg}✓{/white-fg} router config updated");
+      logMessage("system", "{white-fg}✓{/white-fg} gate router config updated");
       if (Object.prototype.hasOwnProperty.call(updates, "controllerMode")) {
         logMessage("system", `  • controllerMode: ${updates.controllerMode}`);
       }
@@ -1227,7 +1409,7 @@ function createCommandExecutor(options = {}) {
         return;
       }
       saveConfig(projectRoot, updates);
-      logMessage("system", "{white-fg}✓{/white-fg} router config cleared");
+      logMessage("system", "{white-fg}✓{/white-fg} gate router config cleared");
       await restartDaemon(projectRoot);
       return;
     }
@@ -1239,7 +1421,7 @@ function createCommandExecutor(options = {}) {
     }
 
     saveConfig(projectRoot, { controllerMode: nextMode });
-    logMessage("system", `{white-fg}✓{/white-fg} router mode set to ${nextMode}`);
+    logMessage("system", `{white-fg}✓{/white-fg} gate router mode set to ${nextMode}`);
     await restartDaemon(projectRoot);
   }
 

package/src/chat/commands.js

@@ -87,20 +87,39 @@ const COMMAND_TREE = {
   "/settings": {
     desc: "Settings operations",
     children: {
+      show: {
+        desc: "Show settings overview",
+        order: 1,
+      },
+      agent: {
+        desc: "Manage main ufoo-agent/router provider/model",
+        order: 2,
+        children: {
+          show: { desc: "Show main agent provider/model", order: 1 },
+          set: { desc: "Set provider=<codex|claude> model=<id>", order: 2 },
+          clear: { desc: "Clear agent model or reset provider", order: 3 },
+          codex: { desc: "Use Codex default model (gpt-5.5)", order: 4 },
+          claude: { desc: "Use Claude default model (opus-4.7)", order: 5 },
+        },
+      },
       router: {
-        desc: "Manage controller routing mode/provider/model",
+        desc: "Manage gate router mode/provider/model",
+        order: 3,
         children: {
-          show: { desc: "Show router mode/provider/model", order: 1 },
-          set: { desc: "Set router mode/provider/model", order: 2 },
-          clear: { desc: "Clear router provider/model or reset mode", order: 3 },
+          show: { desc: "Show gate router mode/provider/model", order: 1 },
+          set: { desc: "Set mode/provider/model", order: 2 },
+          clear: { desc: "Clear gate router provider/model or reset mode", order: 3 },
           main: { desc: "Set router mode to main", order: 4 },
           loop: { desc: "Set router mode to loop", order: 5 },
           legacy: { desc: "Set router mode to legacy", order: 6 },
           shadow: { desc: "Set router mode to shadow", order: 7 },
+          codex: { desc: "Use Codex gate model (gpt-5.4-mini)", order: 8 },
+          claude: { desc: "Use Claude gate model (sonnet-4.7)", order: 9 },
         },
       },
       ucode: {
         desc: "Manage ucode model provider config",
+        order: 4,
         children: {
           show: { desc: "Show ucode provider/model/url/key", order: 1 },
           set: { desc: "Set ucode provider/model/url/key", order: 2 },

package/src/chat/completionController.js

@@ -24,6 +24,34 @@ function mapSubcommandSuggestions(subs = [], parentCmd, tokenIndex, filterText =
     .sort(sortSubcommandEntries);
 }
 
+function buildNestedSubcommandSuggestions(subs = [], mainCmd, parts = [], endsWithSpace = false) {
+  let currentSubs = Array.isArray(subs) ? subs : [];
+  if (currentSubs.length === 0) return [];
+
+  for (let index = 1; index < parts.length; index += 1) {
+    const token = String(parts[index] || "");
+    const exact = currentSubs.find((sub) =>
+      String(sub && sub.cmd ? sub.cmd : "").toLowerCase() === token.toLowerCase()
+    );
+    const isLastToken = index === parts.length - 1;
+
+    if (exact && Array.isArray(exact.subcommands) && exact.subcommands.length > 0) {
+      if (!isLastToken || endsWithSpace) {
+        currentSubs = exact.subcommands;
+        continue;
+      }
+    }
+
+    if (exact && isLastToken && endsWithSpace) {
+      return [];
+    }
+
+    return mapSubcommandSuggestions(currentSubs, mainCmd, index, token);
+  }
+
+  return mapSubcommandSuggestions(currentSubs, mainCmd, parts.length, "");
+}
+
 function createCompletionController(options = {}) {
   const {
     input,
@@ -230,14 +258,9 @@ function createCompletionController(options = {}) {
           subs = Array.from(merged.values());
         }
         if (isLaunch) {
-          return mapSubcommandSuggestions(subs, mainCmd, 1, "");
-        }
-        const selectedSub = subs.find((sub) => String(sub && sub.cmd ? sub.cmd : "").toLowerCase() === subFilter.toLowerCase());
-        if (selectedSub && selectedSub.subcommands && (parts.length > 2 || endsWithSpace)) {
-          const nestedFilter = parts[2] || "";
-          return mapSubcommandSuggestions(selectedSub.subcommands, mainCmd, 2, nestedFilter);
+          return mapSubcommandSuggestions(subs, mainCmd, 1, subFilter);
         }
-        return mapSubcommandSuggestions(subs, mainCmd, 1, subFilter);
+        return buildNestedSubcommandSuggestions(subs, mainCmd, parts, endsWithSpace);
       }
       return [];
     }

package/src/chat/daemonMessageRouter.js

@@ -229,7 +229,8 @@ function createDaemonMessageRouter(options = {}) {
       if (recoverableList.length > 0) {
         logMessage("system", "{cyan-fg}Recoverable agents:{/cyan-fg}");
         recoverableList.forEach((item) => {
-          const nickname = item.nickname ? ` (${item.nickname})` : "";
+          const displayNickname = item.display_nickname || item.nickname || "";
+          const nickname = displayNickname ? ` (${displayNickname})` : "";
           const meta = item.launchMode ? ` [${item.agent}/${item.launchMode}]` : ` [${item.agent}]`;
           logMessage("system", `  • ${escapeBlessed(`${item.id}${nickname}${meta}`)}`);
         });

package/src/chat/index.js

@@ -15,6 +15,7 @@ const UfooInit = require("../init");
 const AgentActivator = require("../bus/activate");
 const { subscriberToSafeName } = require("../bus/utils");
 const { getUfooPaths } = require("../ufoo/paths");
+const { resolveDisplayNickname } = require("../daemon/nicknameScope");
 const { startDaemon, stopDaemon, connectWithRetry } = require("./transport");
 const { escapeBlessed, stripBlessedTags, truncateText } = require("./text");
 const { COMMAND_REGISTRY, parseCommand, parseAtTarget } = require("./commands");
@@ -562,6 +563,7 @@ async function runChat(projectRoot, options = {}) {
       return registry.templates.map((item) => ({
         alias: item.alias,
         name: item.templateName || item.templateId || "",
+        desc: item.templateDescription || "",
         source: item.source || "",
       }));
     },
@@ -915,7 +917,7 @@ async function runChat(projectRoot, options = {}) {
           const busPath = getUfooPaths(activeProjectRoot).agentsFile;
           const bus = JSON.parse(fs.readFileSync(busPath, "utf8"));
           for (const [id, meta] of Object.entries(bus.agents || {})) {
-            if (meta && meta.nickname === nickname) return id;
+            if (meta && (meta.nickname === nickname || meta.scoped_nickname === nickname)) return id;
           }
         } catch {
           // ignore lookup errors
@@ -934,7 +936,7 @@ async function runChat(projectRoot, options = {}) {
           const busPath = getUfooPaths(activeProjectRoot).agentsFile;
           const bus = JSON.parse(fs.readFileSync(busPath, "utf8"));
           const meta = bus.agents && bus.agents[id];
-          if (meta && meta.nickname) return meta.nickname;
+          if (meta) return resolveDisplayNickname(activeProjectRoot, meta);
         } catch {
           // Keep original publisher ID
         }
@@ -1275,7 +1277,9 @@ async function runChat(projectRoot, options = {}) {
         const bus = JSON.parse(fs.readFileSync(busPath, "utf8"));
         fallbackMap = new Map();
         for (const [id, meta] of Object.entries(bus.agents || {})) {
-          if (meta && meta.nickname) fallbackMap.set(id, meta.nickname);
+          if (!meta) continue;
+          const displayNickname = resolveDisplayNickname(activeProjectRoot, meta);
+          if (displayNickname) fallbackMap.set(id, displayNickname);
         }
       } catch {
         fallbackMap = null;
@@ -2100,12 +2104,9 @@ async function runChat(projectRoot, options = {}) {
         if (runtimeWatchDebounce) return;
         runtimeWatchDebounce = setTimeout(() => {
           runtimeWatchDebounce = null;
-          const prevCount = projectRuntimes.length;
           refreshProjectRuntimes();
-          if (projectRuntimes.length !== prevCount) {
-            renderDashboard();
-            screen.render();
-          }
+          renderDashboard();
+          screen.render();
         }, 300);
       });
       screen.on("destroy", () => watcher.close());

package/src/cli/groupCoreCommands.js

@@ -80,6 +80,9 @@ function printList({ templates, errors }, { write, json, cwd }) {
       const displayPath = formatDisplayPath(item.filePath, cwd);
       write(`- ${item.alias} [${item.source}]`);
       write(`  name: ${nameLabel}`);
+      if (item.templateDescription) {
+        write(`  desc: ${item.templateDescription}`);
+      }
       write(`  id: ${idLabel}  schema: ${verLabel}`);
       write(`  file: ${displayPath}`);
     }
@@ -170,6 +173,7 @@ async function runGroupCoreCommand(subcmd, cmdArgs = [], options = {}) {
       filePath: item.filePath,
       templateId: item.templateId || "",
       templateName: item.templateName || "",
+      templateDescription: item.templateDescription || "",
       schemaVersion: item.schemaVersion,
     }));
     printList({ templates, errors: registry.errors }, { write, json, cwd });
@@ -190,6 +194,7 @@ async function runGroupCoreCommand(subcmd, cmdArgs = [], options = {}) {
       filePath: item.filePath,
       templateId: item.templateId || "",
       templateName: item.templateName || "",
+      templateDescription: item.templateDescription || "",
       schemaVersion: item.schemaVersion,
     }));
     printList({ templates, errors: registry.errors }, { write, json, cwd });