feat: add Namer sub-agent role for titling conversations

Introduce a specialized 'namer' sub-agent dedicated to generating
concise conversation titles. This internal agent uses a strict
output format to handle naming tasks.

Changes include:
- Add `namer` case to `SubAgentRole` and `SubAgentActivityRole` enums
- Add `conversationTitling` task type and map it to the namer role
- Define UI properties for the namer role (amber color, textformat.abc icon)
- Update animated role icons to support the new agent type

Author: tooury

Axon/Models/SubAgentActivityAttributes.swift

@@ -53,12 +53,14 @@ enum SubAgentActivityRole: String, Codable, Hashable {
     case scout
     case mechanic
     case designer
+    case namer
 
     var displayName: String {
         switch self {
         case .scout: return "Scout"
         case .mechanic: return "Mechanic"
         case .designer: return "Designer"
+        case .namer: return "Namer"
         }
     }
 
@@ -67,6 +69,7 @@ enum SubAgentActivityRole: String, Codable, Hashable {
         case .scout: return "binoculars"
         case .mechanic: return "wrench.and.screwdriver"
         case .designer: return "square.and.pencil"
+        case .namer: return "textformat.abc"
         }
     }
 
@@ -75,6 +78,7 @@ enum SubAgentActivityRole: String, Codable, Hashable {
         case .scout: return "Exploring"
         case .mechanic: return "Fixing"
         case .designer: return "Designing"
+        case .namer: return "Naming"
         }
     }
 
@@ -84,6 +88,7 @@ enum SubAgentActivityRole: String, Codable, Hashable {
         case .scout: return "mercury"      // Standard cyan-ish
         case .mechanic: return "lichen"    // Green tint
         case .designer: return "amethyst"  // Purple tint
+        case .namer: return "amber"
         }
     }
 }
@@ -166,6 +171,7 @@ extension SubAgentActivityRole {
         case .scout: self = .scout
         case .mechanic: self = .mechanic
         case .designer: self = .designer
+        case .namer: self = .namer
         }
     }
 }

Axon/Models/SubAgentJob/ModelTaskAffinity.swift

@@ -149,6 +149,7 @@ enum TaskType: String, Codable, CaseIterable, Sendable {
     case codeExecution        // Mechanic: running code
     case fileModification     // Mechanic: editing files
     case codeGeneration       // Mechanic: writing new code
+    case conversationTitling  // Namer: concise conversation title generation
     case taskDecomposition    // Designer: breaking down tasks
     case agentSelection       // Designer: choosing which agent
     case reasoning            // Deep reasoning tasks
@@ -164,6 +165,7 @@ enum TaskType: String, Codable, CaseIterable, Sendable {
         case .codeExecution: return "Code Execution"
         case .fileModification: return "File Modification"
         case .codeGeneration: return "Code Generation"
+        case .conversationTitling: return "Conversation Titling"
         case .taskDecomposition: return "Task Decomposition"
         case .agentSelection: return "Agent Selection"
         case .reasoning: return "Reasoning"
@@ -180,6 +182,8 @@ enum TaskType: String, Codable, CaseIterable, Sendable {
             return [.scout]
         case .codeExecution, .fileModification, .codeGeneration:
             return [.mechanic]
+        case .conversationTitling:
+            return [.namer]
         case .taskDecomposition, .agentSelection:
             return [.designer]
         case .reasoning, .summarization, .translation, .dataExtraction:

Axon/Models/SubAgentJob/SubAgentRole.swift

@@ -16,6 +16,7 @@ enum SubAgentRole: String, Codable, CaseIterable, Identifiable, Sendable {
     case scout      // Lightweight reconnaissance, read-only, fast/cheap models
     case mechanic   // Focused execution, read+write, balanced models
     case designer   // Meta-reasoning, task decomposition, capable models
+    case namer      // Internal read-only titling agent with strict output format
 
     var id: String { rawValue }
 
@@ -26,6 +27,7 @@ enum SubAgentRole: String, Codable, CaseIterable, Identifiable, Sendable {
         case .scout: return "Scout"
         case .mechanic: return "Mechanic"
         case .designer: return "Designer"
+        case .namer: return "Namer"
         }
     }
 
@@ -34,6 +36,7 @@ enum SubAgentRole: String, Codable, CaseIterable, Identifiable, Sendable {
         case .scout: return "binoculars"
         case .mechanic: return "wrench.and.screwdriver"
         case .designer: return "square.and.pencil"
+        case .namer: return "textformat.abc"
         }
     }
 
@@ -45,6 +48,8 @@ enum SubAgentRole: String, Codable, CaseIterable, Identifiable, Sendable {
             return "Focused execution agent. Carries out specific tasks with precision based on inherited context."
         case .designer:
             return "Meta-level reasoning agent. Analyzes tasks, decomposes problems, and recommends agent assignments."
+        case .namer:
+            return "Internal title agent. Generates concise conversation titles with strict one-line output."
         }
     }
 
@@ -82,6 +87,15 @@ enum SubAgentRole: String, Codable, CaseIterable, Identifiable, Sendable {
                 maxTokenBudget: 16_000,
                 maxDurationSeconds: 120
             )
+        case .namer:
+            return SubAgentPermissions(
+                canRead: true,
+                canWrite: false,
+                allowedTools: [],
+                memoryScope: .none,
+                maxTokenBudget: 1_000,
+                maxDurationSeconds: 30
+            )
         }
     }
 
@@ -96,6 +110,8 @@ enum SubAgentRole: String, Codable, CaseIterable, Identifiable, Sendable {
             return [.balanced, .capable]  // Sonnet, GPT-4o, Gemini Pro
         case .designer:
             return [.capable, .flagship]  // Opus, o3, Gemini-3-Pro
+        case .namer:
+            return [.fast, .cheap]
         }
     }
 
@@ -171,6 +187,18 @@ enum SubAgentRole: String, Codable, CaseIterable, Identifiable, Sendable {
             Add spawn recommendations to your AGENT ASSIGNMENTS section.
             Axon will review and authorize each spawn individually.
             """
+        case .namer:
+            return """
+            ## Sub-Agent Role: Namer
+            You generate concise conversation titles.
+
+            **Constraints:**
+            - READ-ONLY
+            - Return exactly one line
+            - Required format: TITLE: <3-6 word title>
+            - No markdown, bullets, numbering, quotes, or extra commentary
+            - Avoid greetings or generic filler titles
+            """
         }
     }
 }

Axon/Services/AgentControl/AgentActionRegistry.swift

@@ -225,7 +225,14 @@ final class AgentActionRegistry: ObservableObject {
         let conversation = ConversationService.shared.currentConversation
 
         let fallbackConversationId = selectedConversationId ?? conversation?.id
-        let fallbackConversationTitle = selectedConversationTitle ?? conversation?.title
+        let resolvedCurrentConversationTitle: String? = {
+            guard let conversation else { return nil }
+            return SettingsStorage.shared.resolvedConversationTitle(
+                conversationId: conversation.id,
+                persistedTitle: conversation.title
+            )
+        }()
+        let fallbackConversationTitle = selectedConversationTitle ?? resolvedCurrentConversationTitle
         let fallbackView = currentViewRef ?? "chat"
 
         return AgentActionStateSnapshot(
@@ -251,7 +258,14 @@ final class AgentActionRegistry: ObservableObject {
     func updateUIState(currentView: String, selectedConversation: Conversation?) {
         currentViewRef = currentView
         selectedConversationId = selectedConversation?.id
-        selectedConversationTitle = selectedConversation?.title
+        if let selectedConversation {
+            selectedConversationTitle = SettingsStorage.shared.resolvedConversationTitle(
+                conversationId: selectedConversation.id,
+                persistedTitle: selectedConversation.title
+            )
+        } else {
+            selectedConversationTitle = nil
+        }
     }
 
     // MARK: UI Request Completion

Axon/Services/AgentOrchestrator/AgentOrchestratorService+ModelSelection.swift

@@ -184,6 +184,7 @@ extension AgentOrchestratorService {
         case .scout: taskType = .webResearch
         case .mechanic: taskType = .codeExecution
         case .designer: taskType = .taskDecomposition
+        case .namer: taskType = .conversationTitling
         }
 
         // Check affinities

Axon/Services/AgentOrchestrator/AgentOrchestratorService.swift

@@ -577,6 +577,9 @@ final class AgentOrchestratorService: ObservableObject {
         if taskLower.contains("summarize") || taskLower.contains("summary") {
             return .summarization
         }
+        if taskLower.contains("title:") || taskLower.contains("conversation title") || taskLower.contains("title ") {
+            return .conversationTitling
+        }
         if taskLower.contains("analyze") || taskLower.contains("read") {
             return .documentAnalysis
         }
@@ -586,6 +589,7 @@ final class AgentOrchestratorService: ObservableObject {
         case .scout: return .webResearch
         case .mechanic: return .codeExecution
         case .designer: return .taskDecomposition
+        case .namer: return .conversationTitling
         }
     }
 

Axon/Services/Conversation/ConversationService.swift

@@ -67,6 +67,9 @@ class ConversationService: ObservableObject {
 
         print("[ConversationService] Loaded \(loaded.count) conversations from Core Data")
         conversations = loaded
+
+        // Startup catch-up for legacy placeholder/first-message titles.
+        ConversationTitleMaintenanceService.shared.scheduleStartupCatchUp(conversations: loaded)
     }
 
     /// Clean up deletion records older than retention period
@@ -435,6 +438,10 @@ class ConversationService: ObservableObject {
             messages = []
         }
 
+        // Remove local title overrides for deleted conversations.
+        SettingsStorage.shared.setDisplayName(nil, for: id)
+        SettingsStorage.shared.setGeneratedTitle(nil, for: id)
+
         // For local-only conversations OR when no backend configured, hard delete immediately
         if id.hasPrefix("local_") || !apiClient.isBackendConfigured {
             try localStore.deleteLocalConversation(id: id)
@@ -754,16 +761,12 @@ class ConversationService: ObservableObject {
             // Save both messages to Core Data immediately
             try await syncManager.saveMessagesToCoreData([userMessage, assistantMessage], conversationId: conversationId)
 
-            // After the assistant completes its response, attempt to generate a concise chat title
-            // using Apple Intelligence (FoundationModels). This does NOT replace the existing
-            // initial-title method; it just upgrades the title post-response.
-            Task { @MainActor in
-                await self.tryAutoRenameConversationAfterFirstReply(
-                    conversationId: conversationId,
-                    userMessage: userMessage,
-                    assistantMessage: assistantMessage
-                )
-            }
+            // Shared post-reply titling entrypoint (used by both non-streaming and streaming).
+            schedulePostReplyTitling(
+                conversationId: conversationId,
+                userMessage: userMessage,
+                assistantMessage: assistantMessage
+            )
 
             // Process and save memories if any were created
             if let memories = memories, !memories.isEmpty {
@@ -912,66 +915,18 @@ class ConversationService: ObservableObject {
 
     // MARK: - Auto Title
 
-    /// Attempts to auto-rename a conversation after the assistant completes a reply.
-    ///
-    /// - Important: Will not override user manual renames (displayNameOverride).
-    /// - Important: Uses only the last (user, assistant) messages to keep latency predictable.
+    /// Shared post-reply title hook used by both non-streaming and streaming completion paths.
     @MainActor
-    private func tryAutoRenameConversationAfterFirstReply(
+    func schedulePostReplyTitling(
         conversationId: String,
         userMessage: Message,
         assistantMessage: Message
-    ) async {
-        // Do not override a manual rename.
-        if SettingsStorage.shared.displayName(for: conversationId) != nil {
-            print("[ConversationService] ℹ️ Auto-title skipped: manual rename exists")
-            return
-        }
-
-        // Only attempt when we have a conversation loaded.
-        guard let conv = conversations.first(where: { $0.id == conversationId }) else {
-            print("[ConversationService] ⚠️ Auto-title skipped: conversation not in memory")
-            return
-        }
-
-        // Heuristic: only auto-rename if the current title looks like the placeholder
-        // (the app currently uses the first user message prefix).
-        let placeholderTitle = String(userMessage.content.prefix(50)).trimmingCharacters(in: .whitespacesAndNewlines)
-        let isPlaceholder = conv.title == "New Chat" || conv.title == placeholderTitle
-        guard isPlaceholder else {
-            print("[ConversationService] ℹ️ Auto-title skipped: title already non-placeholder ('\(conv.title)')")
-            return
-        }
-
-        do {
-            let generated = try await ConversationTitleOrchestrator.shared.generateTitle(
-                userMessage: userMessage,
-                assistantMessage: assistantMessage
-            )
-
-            let trimmed = generated.trimmingCharacters(in: .whitespacesAndNewlines)
-            guard !trimmed.isEmpty else {
-                print("[ConversationService] ⚠️ Auto-title generation produced empty title; skipping")
-                return
-            }
-
-            // 1) Update UI immediately via local display name override.
-            ConversationTitleOrchestrator.shared.applyTitle(trimmed, to: conversationId)
-
-            // 2) Persist/sync as the official conversation title (if possible).
-            do {
-                _ = try await updateConversation(id: conversationId, title: trimmed)
-            } catch {
-                // In local-only / offline mode this can still succeed (local store), but if it
-                // fails we keep the displayNameOverride so the UI still shows the new title.
-                print("[ConversationService] ⚠️ Auto-title could not persist server-side: \(error.localizedDescription)")
-            }
-
-            print("[ConversationService] ✅ Auto-renamed conversation \(conversationId) -> '\(trimmed)'")
-        } catch {
-            // Leave the existing title as-is.
-            print("[ConversationService] ⚠️ Auto-title generation failed: \(error.localizedDescription)")
-        }
+    ) {
+        ConversationTitleSubAgentService.shared.schedulePostReplyTitling(
+            conversationId: conversationId,
+            userMessage: userMessage,
+            assistantMessage: assistantMessage
+        )
     }
 
     // MARK: - Message Editing & Deletion