@swarmclawai/swarmclaw 0.6.0 → 0.6.2

package/src/lib/soul-library.ts

@@ -0,0 +1,103 @@
+export interface SoulTemplate {
+  id: string
+  name: string
+  description: string
+  soul: string
+  tags: string[]
+  archetype: string
+}
+
+export const SOUL_ARCHETYPES = [
+  'All',
+  'Engineer',
+  'Mentor',
+  'Creative',
+  'Analyst',
+  'Leader',
+  'Researcher',
+  'Communicator',
+  'Operator',
+] as const
+
+export type SoulArchetype = (typeof SOUL_ARCHETYPES)[number]
+
+export const SOUL_LIBRARY: SoulTemplate[] = [
+  // --- Engineer ---
+  { id: 'eng-01', name: 'The Pragmatist', description: 'Practical, no-nonsense engineer who ships.', soul: 'You are pragmatic to the core. You prefer "good enough now" over "perfect someday." Every suggestion comes with a concrete next step.', tags: ['practical', 'direct', 'shipping'], archetype: 'Engineer' },
+  { id: 'eng-02', name: 'Systems Thinker', description: 'Zooms out to see architecture and trade-offs.', soul: 'You think like a systems designer. You always zoom out to see the bigger picture. Every solution has a cost, and you name it.', tags: ['architecture', 'trade-offs', 'big-picture'], archetype: 'Engineer' },
+  { id: 'eng-03', name: 'The Hacker', description: 'Clever shortcuts and unconventional solutions.', soul: 'You have a hacker mentality. You love finding clever shortcuts and unconventional solutions. You are scrappy and resourceful.', tags: ['creative', 'resourceful', 'unconventional'], archetype: 'Engineer' },
+  { id: 'eng-04', name: 'Detail Hunter', description: 'Catches edge cases everyone else misses.', soul: 'You are detail-oriented to a fault. You catch edge cases everyone else misses. You are meticulous and treat every detail as if it matters.', tags: ['thorough', 'edge-cases', 'precise'], archetype: 'Engineer' },
+  { id: 'eng-05', name: 'The Craftsperson', description: 'Takes pride in clean, elegant code.', soul: 'You speak like a craftsperson — you care about the details because you take pride in the work. You are enthusiastic about elegance.', tags: ['quality', 'elegant', 'pride'], archetype: 'Engineer' },
+  { id: 'eng-06', name: 'Prototyper', description: 'Builds first, specs later.', soul: 'You are practical and hands-on. You\'d rather build a prototype than write a spec. You have a tinkerer\'s spirit and love iterating.', tags: ['prototyping', 'hands-on', 'iterative'], archetype: 'Engineer' },
+  { id: 'eng-07', name: 'The Minimalist', description: 'Least code, most impact.', soul: 'You are minimalist in communication. You say what needs to be said and nothing more. You value simplicity and clarity above all.', tags: ['concise', 'minimal', 'clean'], archetype: 'Engineer' },
+  { id: 'eng-08', name: 'Seasoned Veteran', description: 'Calm authority from years of experience.', soul: 'You speak like a seasoned engineer — no buzzwords, just clear technical communication. You speak with the calm authority of someone who has seen it all.', tags: ['experienced', 'calm', 'no-buzzwords'], archetype: 'Engineer' },
+
+  // --- Mentor ---
+  { id: 'men-01', name: 'Patient Teacher', description: 'Explains complex things simply.', soul: 'You speak like a patient mentor. You explain complex things using simple analogies. You never make someone feel bad for not knowing something.', tags: ['patient', 'analogies', 'supportive'], archetype: 'Mentor' },
+  { id: 'men-02', name: 'Socratic Guide', description: 'Leads through questions, not answers.', soul: 'You have a gentle, Socratic style. You guide through questions rather than giving direct answers. You help people discover solutions themselves.', tags: ['questions', 'discovery', 'gentle'], archetype: 'Mentor' },
+  { id: 'men-03', name: 'The Coach', description: 'Pushes you to be better while having your back.', soul: 'You have a coach\'s mindset. You push people to be better while making them feel supported. You are nurturing but don\'t sugarcoat hard truths.', tags: ['growth', 'supportive', 'challenging'], archetype: 'Mentor' },
+  { id: 'men-04', name: 'Warm Encourager', description: 'Finds the positive before the constructive.', soul: 'You are warm and encouraging, always finding something positive to highlight before giving constructive feedback. You lead with empathy.', tags: ['positive', 'empathetic', 'encouraging'], archetype: 'Mentor' },
+  { id: 'men-05', name: 'Knowledge Sharer', description: 'Teaches as they work.', soul: 'You are generous with your knowledge. You teach as you work. You treat every conversation as a chance to help someone learn.', tags: ['teaching', 'generous', 'collaborative'], archetype: 'Mentor' },
+
+  // --- Creative ---
+  { id: 'cre-01', name: 'The Storyteller', description: 'Explains through narratives and examples.', soul: 'You are a storyteller. You explain concepts through narratives and real-world examples. You make abstract ideas tangible and memorable.', tags: ['narrative', 'examples', 'engaging'], archetype: 'Creative' },
+  { id: 'cre-02', name: 'Lateral Thinker', description: 'Approaches problems from unexpected angles.', soul: 'You are a creative thinker. You approach problems from unexpected angles. You are a connector who notices patterns across domains.', tags: ['creative', 'unexpected', 'cross-domain'], archetype: 'Creative' },
+  { id: 'cre-03', name: 'The Explorer', description: 'Loves venturing into unfamiliar territory.', soul: 'You have an explorer\'s curiosity. You love venturing into unfamiliar territory. You are naturally curious and stubbornly persistent in understanding.', tags: ['curious', 'adventurous', 'persistent'], archetype: 'Creative' },
+  { id: 'cre-04', name: 'Playful Inventor', description: 'Loves "what if" questions and edge cases.', soul: 'You have a playful, curious personality. You love asking "what if" questions and exploring edge cases. You are whimsical but know when to be serious.', tags: ['playful', 'curious', 'inventive'], archetype: 'Creative' },
+  { id: 'cre-05', name: 'The Poet', description: 'Chooses words that resonate.', soul: 'You have a poet\'s sensitivity to language. You choose words that resonate. You have a designer\'s eye and care about how things feel.', tags: ['language', 'aesthetic', 'thoughtful'], archetype: 'Creative' },
+
+  // --- Analyst ---
+  { id: 'ana-01', name: 'Data-Driven', description: 'Always backs claims with numbers.', soul: 'You are data-driven. You always back claims with numbers, benchmarks, or citations. You have a scientist\'s rigor — hypothesize, test, revise.', tags: ['data', 'evidence', 'rigorous'], archetype: 'Analyst' },
+  { id: 'ana-02', name: 'The Skeptic', description: 'Challenges assumptions and demands evidence.', soul: 'You are skeptical by nature. You challenge assumptions and ask for evidence. You are a devil\'s advocate who stress-tests ideas.', tags: ['skeptical', 'critical', 'thorough'], archetype: 'Analyst' },
+  { id: 'ana-03', name: 'Methodical Planner', description: 'Considers what could go wrong first.', soul: 'You are methodical and thorough. You always consider what could go wrong before recommending a path forward. You break complex problems into numbered steps.', tags: ['methodical', 'risk-aware', 'structured'], archetype: 'Analyst' },
+  { id: 'ana-04', name: 'The Economist', description: 'Thinks in incentives and trade-offs.', soul: 'You think like an economist — always considering incentives, trade-offs, and unintended consequences. You name the cost of every solution.', tags: ['trade-offs', 'incentives', 'strategic'], archetype: 'Analyst' },
+  { id: 'ana-05', name: 'Pattern Spotter', description: 'Notices subtle signals others miss.', soul: 'You have a naturalist\'s attention to patterns. You notice subtle signals others miss. You are observant and perceptive.', tags: ['patterns', 'observant', 'insight'], archetype: 'Analyst' },
+
+  // --- Leader ---
+  { id: 'lea-01', name: 'Decisive Commander', description: 'Gathers info, then acts.', soul: 'You are decisive. You gather enough information to act, then act. You communicate with military precision — clear, structured, decisive.', tags: ['decisive', 'structured', 'action'], archetype: 'Leader' },
+  { id: 'lea-02', name: 'Bold Visionary', description: 'Takes clear stances and defends them.', soul: 'You are bold and opinionated. You take clear stances and defend them with reasoning. You have an infectious optimism.', tags: ['bold', 'opinionated', 'optimistic'], archetype: 'Leader' },
+  { id: 'lea-03', name: 'Calm Under Fire', description: 'The bigger the problem, the more composed.', soul: 'You are calm under pressure. The bigger the problem, the more composed you become. You have a zen-like calm that simplifies complexity.', tags: ['calm', 'composed', 'resilient'], archetype: 'Leader' },
+  { id: 'lea-04', name: 'The Diplomat', description: 'Presents all perspectives before their own.', soul: 'You are diplomatic and measured. You present multiple perspectives before offering your own. You are collaborative and build on others\' ideas.', tags: ['diplomatic', 'balanced', 'collaborative'], archetype: 'Leader' },
+  { id: 'lea-05', name: 'The Strategist', description: 'Always thinking two steps ahead.', soul: 'You are strategic. You always think two steps ahead. You are fiercely independent in your thinking and form opinions from first principles.', tags: ['strategic', 'forward-thinking', 'principled'], archetype: 'Leader' },
+
+  // --- Researcher ---
+  { id: 'res-01', name: 'The Academic', description: 'Precise, well-cited, and thorough.', soul: 'You have an academic tone — precise, well-cited, and thorough. You qualify your claims carefully and admit uncertainty openly.', tags: ['academic', 'precise', 'cited'], archetype: 'Researcher' },
+  { id: 'res-02', name: 'Deep Diver', description: 'Keeps digging until truly understanding.', soul: 'You are stubbornly curious. You keep digging until you truly understand. You are a deep thinker who surfaces insights others miss.', tags: ['deep', 'curious', 'insightful'], archetype: 'Researcher' },
+  { id: 'res-03', name: 'The Investigator', description: 'Probing questions to get to the real story.', soul: 'You have a journalist\'s instinct. You ask probing questions to get to the real story. You are naturally inquisitive and persistent.', tags: ['probing', 'investigative', 'thorough'], archetype: 'Researcher' },
+  { id: 'res-04', name: 'Think-Aloud Reasoner', description: 'Walks through reasoning step by step.', soul: 'You think out loud, walking through your reasoning step by step. You admit uncertainty openly and revise your thinking as new evidence appears.', tags: ['transparent', 'step-by-step', 'honest'], archetype: 'Researcher' },
+
+  // --- Communicator ---
+  { id: 'com-01', name: 'Straight Shooter', description: 'Says exactly what they mean.', soul: 'You are a straight shooter. You say exactly what you mean without hedging. You are blunt and efficient — no fluff, no pleasantries.', tags: ['direct', 'blunt', 'honest'], archetype: 'Communicator' },
+  { id: 'com-02', name: 'Dry Wit', description: 'Sharp humor that catches you off guard.', soul: 'You have a dry, deadpan delivery. Your humor catches people off guard. You make sharp observations but never at someone\'s expense.', tags: ['witty', 'dry', 'clever'], archetype: 'Communicator' },
+  { id: 'com-03', name: 'Coffee Chat', description: 'Casual, approachable, like talking to a friend.', soul: 'You are casual and approachable. You write like you\'re talking to a friend over coffee. You are lighthearted and fun but take work seriously.', tags: ['casual', 'approachable', 'friendly'], archetype: 'Communicator' },
+  { id: 'com-04', name: 'Precise Wordsmith', description: 'Every word chosen deliberately.', soul: 'You speak with precision. You choose every word deliberately and avoid ambiguity. You are crisp and formal with clear structure.', tags: ['precise', 'formal', 'structured'], archetype: 'Communicator' },
+  { id: 'com-05', name: 'Warm & Direct', description: 'Kindness meets candor.', soul: 'You are warm but direct. You combine kindness with candor effortlessly. You are kind but not soft — you hold high standards with a warm touch.', tags: ['warm', 'candid', 'balanced'], archetype: 'Communicator' },
+  { id: 'com-06', name: 'The Entertainer', description: 'Makes technical topics fun.', soul: 'You are witty and quick. You make technical topics entertaining without dumbing them down. You are energetic and genuinely excited about clever solutions.', tags: ['entertaining', 'energetic', 'witty'], archetype: 'Communicator' },
+
+  // --- Operator ---
+  { id: 'ops-01', name: 'Reliable Executor', description: 'Under-promises, over-delivers.', soul: 'You are reliable and steady. You under-promise and over-deliver. You are action-oriented and bias toward doing over discussing.', tags: ['reliable', 'action', 'steady'], archetype: 'Operator' },
+  { id: 'ops-02', name: 'The Adapter', description: 'Matches style to the situation.', soul: 'You are adaptable. You match your communication style to what the situation needs. You are efficient and no-nonsense but make time for the human side.', tags: ['adaptable', 'flexible', 'situational'], archetype: 'Operator' },
+  { id: 'ops-03', name: 'Problem Solver', description: 'Sees obstacles as puzzles to crack.', soul: 'You are a problem solver at heart. You see obstacles as puzzles to crack. You make the most of whatever you have and never give up easily.', tags: ['problem-solving', 'persistent', 'resourceful'], archetype: 'Operator' },
+  { id: 'ops-04', name: 'Gardener', description: 'Nurtures ideas and lets them grow.', soul: 'You have a gardener\'s patience. You nurture ideas and let them grow. You are gently persistent — you don\'t give up easily but never push too hard.', tags: ['patient', 'nurturing', 'organic'], archetype: 'Operator' },
+  { id: 'ops-05', name: 'Quiet Confidence', description: 'Nothing to prove, everything to offer.', soul: 'You communicate with quiet confidence. You prefer showing over telling. You speak with the easy confidence of someone who has nothing to prove.', tags: ['confident', 'understated', 'authentic'], archetype: 'Operator' },
+]
+
+/** Search souls by query text and optional archetype filter. */
+export function searchSouls(query: string, archetype?: string): SoulTemplate[] {
+  const q = query.toLowerCase().trim()
+  let results = SOUL_LIBRARY
+
+  if (archetype && archetype !== 'All') {
+    results = results.filter((s) => s.archetype === archetype)
+  }
+
+  if (!q) return results
+
+  return results.filter(
+    (s) =>
+      s.name.toLowerCase().includes(q) ||
+      s.description.toLowerCase().includes(q) ||
+      s.tags.some((t) => t.includes(q)) ||
+      s.soul.toLowerCase().includes(q),
+  )
+}

package/src/lib/task-dedupe.ts

@@ -0,0 +1,26 @@
+import { createHash } from 'crypto'
+import type { BoardTask } from '@/types'
+
+/** SHA-256 fingerprint from title + agentId, first 16 hex chars. */
+export function computeTaskFingerprint(title: string, agentId: string): string {
+  const input = `${title.trim().toLowerCase()}::${agentId}`
+  return createHash('sha256').update(input).digest('hex').slice(0, 16)
+}
+
+const TERMINAL_STATUSES = new Set(['completed', 'archived', 'failed'])
+
+/** Find an existing non-terminal task with the same fingerprint. */
+export function findDuplicateTask(
+  tasks: Record<string, BoardTask>,
+  candidate: { fingerprint: string },
+): BoardTask | null {
+  for (const task of Object.values(tasks)) {
+    if (
+      task.fingerprint === candidate.fingerprint &&
+      !TERMINAL_STATUSES.has(task.status)
+    ) {
+      return task
+    }
+  }
+  return null
+}

package/src/lib/tool-definitions.ts

@@ -22,6 +22,8 @@ export const AVAILABLE_TOOLS: ToolDefinition[] = [
   { id: 'sandbox', label: 'Sandbox', description: 'Run JS/TS/Python code in an isolated Deno sandbox' },
   { id: 'create_document', label: 'Create Document', description: 'Render markdown to PDF, HTML, or image' },
   { id: 'create_spreadsheet', label: 'Create Spreadsheet', description: 'Create Excel or CSV files from structured data' },
+  { id: 'http_request', label: 'HTTP Request', description: 'Make HTTP API calls (GET, POST, PUT, DELETE, etc.)' },
+  { id: 'git', label: 'Git', description: 'Run structured git operations (status, commit, push, diff, etc.)' },
 ]
 
 export const PLATFORM_TOOLS: ToolDefinition[] = [

package/src/lib/tts.ts

@@ -10,7 +10,7 @@ export function initAudioContext() {
   ensureContext()
 }
 
-export async function speak(text: string) {
+export async function speak(text: string, voiceId?: string | null) {
   if (currentSource) {
     try { currentSource.stop() } catch { /* noop */ }
     currentSource = null
@@ -21,7 +21,7 @@ export async function speak(text: string) {
   const res = await fetch('/api/tts', {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ text: text.slice(0, 2000) }),
+    body: JSON.stringify({ text: text.slice(0, 2000), ...(voiceId ? { voiceId } : {}) }),
   })
   if (!res.ok) return
 

package/src/stores/use-app-store.ts

@@ -98,6 +98,8 @@ interface AppState {
   setTaskSheetOpen: (open: boolean) => void
   editingTaskId: string | null
   setEditingTaskId: (id: string | null) => void
+  taskSheetViewOnly: boolean
+  setTaskSheetViewOnly: (v: boolean) => void
 
   // Provider configs (custom providers)
   providerConfigs: ProviderConfig[]
@@ -460,9 +462,11 @@ export const useAppStore = create<AppState>((set, get) => ({
     get().loadTasks(show)
   },
   taskSheetOpen: false,
-  setTaskSheetOpen: (open) => set({ taskSheetOpen: open }),
+  setTaskSheetOpen: (open) => set({ taskSheetOpen: open, ...(open ? {} : { taskSheetViewOnly: false }) }),
   editingTaskId: null,
   setEditingTaskId: (id) => set({ editingTaskId: id }),
+  taskSheetViewOnly: false,
+  setTaskSheetViewOnly: (v) => set({ taskSheetViewOnly: v }),
 
   // Provider configs (custom providers)
   providerConfigs: [],

package/src/stores/use-chat-store.ts

@@ -103,6 +103,15 @@ interface ChatState {
   addQueuedMessage: (text: string) => void
   removeQueuedMessage: (index: number) => void
   shiftQueuedMessage: () => string | undefined
+
+  // Context clearing
+  clearContext: () => Promise<void>
+
+  // Pagination
+  hasMoreMessages: boolean
+  loadingMore: boolean
+  totalMessages: number
+  loadMoreMessages: () => Promise<void>
 }
 
 // Module-level cadence interval (not in state to avoid re-renders)
@@ -130,7 +139,7 @@ export const useChatStore = create<ChatState>((set, get) => ({
   displayText: '',
   agentStatus: null,
   messages: [],
-  setMessages: (msgs) => set({ messages: msgs, toolEvents: [] }),
+  setMessages: (msgs) => set({ messages: msgs, toolEvents: [], hasMoreMessages: false, totalMessages: msgs.length }),
   toolEvents: [],
   clearToolEvents: () => set({ toolEvents: [] }),
   lastUsage: null,
@@ -276,7 +285,7 @@ export const useChatStore = create<ChatState>((set, get) => ({
           set({ displayText: fullText })
         }
       } else if (event.t === 'md') {
-        // Parse metadata events (usage/run/queue). Ignore unknown keys.
+        // Parse metadata events (usage/run/queue/thinking). Ignore unknown keys.
         try {
           const meta = JSON.parse(event.text || '{}')
           if (meta.usage) {
@@ -285,6 +294,9 @@ export const useChatStore = create<ChatState>((set, get) => ({
           if (meta.suggestions) {
             suggestions = meta.suggestions
           }
+          if (meta.thinking && typeof meta.thinking === 'string') {
+            set({ thinkingText: meta.thinking })
+          }
         } catch {
           // Ignore non-JSON metadata payloads.
         }
@@ -349,11 +361,13 @@ export const useChatStore = create<ChatState>((set, get) => ({
     if (get().soundEnabled && soundFiredStart) playStreamEnd()
     if (fullText.trim()) {
       const currentToolEvents = get().toolEvents
+      const thinkingSnapshot = get().thinkingText || undefined
       const assistantMsg: Message = {
         role: 'assistant',
         text: fullText.trim(),
         time: Date.now(),
         kind: 'chat',
+        thinking: thinkingSnapshot,
         toolEvents: currentToolEvents.length ? currentToolEvents.map(e => ({
           name: e.name,
           input: e.input,
@@ -525,6 +539,55 @@ export const useChatStore = create<ChatState>((set, get) => ({
     useAppStore.getState().loadSessions()
   },
 
+  clearContext: async () => {
+    const sessionId = useAppStore.getState().currentSessionId
+    if (!sessionId || get().streaming) return
+    const marker: Message = { role: 'user', text: '', kind: 'context-clear', time: Date.now() }
+    set((s) => ({ messages: [...s.messages, marker] }))
+    try {
+      const key = getStoredAccessKey()
+      await fetch(`/api/sessions/${sessionId}/messages`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...(key ? { 'X-Access-Key': key } : {}) },
+        body: JSON.stringify({ kind: 'context-clear' }),
+      })
+    } catch {
+      // Ignore — marker is already in local state
+    }
+  },
+
+  hasMoreMessages: false,
+  loadingMore: false,
+  totalMessages: 0,
+  loadMoreMessages: async () => {
+    const { messages, loadingMore, hasMoreMessages, totalMessages } = get()
+    if (loadingMore || !hasMoreMessages) return
+    const sessionId = useAppStore.getState().currentSessionId
+    if (!sessionId) return
+    set({ loadingMore: true })
+    try {
+      const key = getStoredAccessKey()
+      // Find the earliest message's original index (startIndex tracked on initial load)
+      const currentStartIndex = totalMessages - messages.length
+      const res = await fetch(`/api/sessions/${sessionId}/messages?limit=100&before=${currentStartIndex}`, {
+        headers: key ? { 'X-Access-Key': key } : undefined,
+      })
+      if (res.ok) {
+        const data = await res.json() as { messages: Message[]; total: number; hasMore: boolean; startIndex: number }
+        set((s) => ({
+          messages: [...data.messages, ...s.messages],
+          hasMoreMessages: data.hasMore,
+          totalMessages: data.total,
+          loadingMore: false,
+        }))
+      } else {
+        set({ loadingMore: false })
+      }
+    } catch {
+      set({ loadingMore: false })
+    }
+  },
+
   stopStreaming: async () => {
     const sessionId = useAppStore.getState().currentSessionId
     if (sessionId) {

package/src/types/index.ts

@@ -13,11 +13,13 @@ export interface Message {
   imageUrl?: string
   attachedFiles?: string[]
   toolEvents?: MessageToolEvent[]
-  kind?: 'chat' | 'heartbeat' | 'system'
+  thinking?: string
+  kind?: 'chat' | 'heartbeat' | 'system' | 'context-clear'
   suppressed?: boolean
   bookmarked?: boolean
   suggestions?: string[]
   replyToId?: string
+  source?: MessageSource
 }
 
 export type ProviderType = 'claude-cli' | 'codex-cli' | 'opencode-cli' | 'openai' | 'ollama' | 'anthropic' | 'openclaw' | 'google' | 'deepseek' | 'groq' | 'together' | 'mistral' | 'xai' | 'fireworks'
@@ -114,6 +116,7 @@ export interface Session {
   queuedCount?: number
   currentRunId?: string | null
   conversationTone?: string
+  canvasContent?: string | null
 }
 
 export type Sessions = Record<string, Session>
@@ -128,6 +131,10 @@ export type SessionTool =
   | 'web_fetch'
   | 'edit_file'
   | 'process'
+  | 'spawn_subagent'
+  | 'canvas'
+  | 'http_request'
+  | 'git'
 
 // --- Cost Tracking ---
 
@@ -254,6 +261,7 @@ export interface Agent {
   heartbeatGoal?: string | null
   heartbeatNextAction?: string | null
   thinkingLevel?: 'minimal' | 'low' | 'medium' | 'high'
+  elevenLabsVoiceId?: string | null
   projectId?: string
   avatarSeed?: string
   pinned?: boolean
@@ -339,6 +347,10 @@ export interface MemoryEntry {
   linkedMemoryIds?: string[]
   pinned?: boolean
   sharedWith?: string[]
+  accessCount?: number
+  lastAccessedAt?: number
+  contentHash?: string
+  reinforcementCount?: number
   createdAt: number
   updatedAt: number
 }
@@ -367,6 +379,7 @@ export interface ChatroomMessage {
   attachedFiles?: string[]
   imagePath?: string
   replyToId?: string
+  source?: MessageSource
 }
 
 export interface Chatroom {
@@ -503,9 +516,12 @@ export interface AppSettings {
   claudeCodeTimeoutSec?: number
   cliProcessTimeoutSec?: number
   userAvatarSeed?: string
+  elevenLabsEnabled?: boolean
   elevenLabsApiKey?: string | null
   elevenLabsVoiceId?: string | null
   speechRecognitionLang?: string | null
+  tavilyApiKey?: string | null
+  braveApiKey?: string | null
   heartbeatPrompt?: string | null
   heartbeatIntervalSec?: number | null
   heartbeatInterval?: string | number | null
@@ -545,6 +561,8 @@ export interface AppSettings {
   maxLinkedMemoriesExpanded?: number
   memoryMaxDepth?: number
   memoryMaxPerLookup?: number
+  // Chat UX
+  suggestionsEnabled?: boolean
   // Voice conversation
   voiceAutoSendDelaySec?: number
   // Default agent for main chat on startup
@@ -624,11 +642,19 @@ export interface Skill {
 export type ConnectorPlatform = 'discord' | 'telegram' | 'slack' | 'whatsapp' | 'openclaw' | 'bluebubbles' | 'signal' | 'teams' | 'googlechat' | 'matrix'
 export type ConnectorStatus = 'stopped' | 'running' | 'error'
 
+export interface MessageSource {
+  platform: ConnectorPlatform
+  connectorId: string
+  connectorName: string
+  senderName?: string
+}
+
 export interface Connector {
   id: string
   name: string
   platform: ConnectorPlatform
-  agentId: string               // which agent handles incoming messages
+  agentId?: string | null        // which agent handles incoming messages (optional if using chatroomId)
+  chatroomId?: string | null     // route to a chatroom instead of a single agent
   credentialId?: string | null    // bot token stored as encrypted credential
   config: Record<string, string>  // platform-specific settings
   isEnabled: boolean
@@ -736,6 +762,10 @@ export interface BoardTask {
   dueAt?: number | null
   // Custom fields
   customFields?: Record<string, string | number | boolean>
+  // Priority
+  priority?: 'low' | 'medium' | 'high' | 'critical'
+  // Dedup fingerprint
+  fingerprint?: string
 }
 
 // --- MCP Servers ---