@swarmclawai/swarmclaw 0.5.3 → 0.6.2

package/src/lib/server/system-events.ts

@@ -0,0 +1,49 @@
+/**
+ * In-memory event queue for heartbeat context injection.
+ * Events are accumulated between heartbeat ticks and drained into heartbeat prompts.
+ */
+
+interface SystemEvent {
+  text: string
+  timestamp: number
+  contextKey?: string
+}
+
+const MAX_EVENTS_PER_SESSION = 20
+
+const globalKey = '__swarmclaw_system_events__' as const
+const globalScope = globalThis as typeof globalThis & { [globalKey]?: Map<string, SystemEvent[]> }
+const queues: Map<string, SystemEvent[]> = globalScope[globalKey] ?? (globalScope[globalKey] = new Map())
+
+/** Push an event for a session. Deduplicates consecutive identical text, caps at MAX_EVENTS_PER_SESSION. */
+export function enqueueSystemEvent(sessionId: string, text: string, contextKey?: string): void {
+  let queue = queues.get(sessionId)
+  if (!queue) {
+    queue = []
+    queues.set(sessionId, queue)
+  }
+
+  // Deduplicate consecutive identical text
+  const last = queue[queue.length - 1]
+  if (last && last.text === text) return
+
+  queue.push({ text, timestamp: Date.now(), contextKey })
+
+  // Cap at max
+  if (queue.length > MAX_EVENTS_PER_SESSION) {
+    queue.splice(0, queue.length - MAX_EVENTS_PER_SESSION)
+  }
+}
+
+/** Destructive read — returns and clears all events for a session. */
+export function drainSystemEvents(sessionId: string): SystemEvent[] {
+  const queue = queues.get(sessionId)
+  if (!queue || queue.length === 0) return []
+  queues.delete(sessionId)
+  return queue
+}
+
+/** Non-destructive read — returns current events without clearing. */
+export function peekSystemEvents(sessionId: string): SystemEvent[] {
+  return queues.get(sessionId) || []
+}

package/src/lib/server/task-mention.ts

@@ -0,0 +1,41 @@
+import type { Agent } from '@/types'
+
+/**
+ * Parse @AgentName mentions from text and resolve to an agent ID.
+ * Uses case-insensitive exact match, then falls back to starts-with.
+ */
+export function parseMentionedAgentId(
+  description: string,
+  agents: Record<string, Agent>,
+): string | null {
+  const mentionRegex = /@(\S+)/g
+  const agentList = Object.values(agents)
+  let match: RegExpExecArray | null
+
+  while ((match = mentionRegex.exec(description)) !== null) {
+    const mention = match[1].toLowerCase()
+
+    // Exact name match (case-insensitive)
+    const exact = agentList.find((a) => a.name.toLowerCase() === mention)
+    if (exact) return exact.id
+
+    // Starts-with match (for partial names like @code matching "CodeBot")
+    const startsWith = agentList.find((a) => a.name.toLowerCase().startsWith(mention))
+    if (startsWith) return startsWith.id
+  }
+
+  return null
+}
+
+/**
+ * Resolve task agent: if description has an @mention, use that agent.
+ * Otherwise fall back to currentAgentId.
+ */
+export function resolveTaskAgentFromDescription(
+  description: string,
+  currentAgentId: string,
+  agents: Record<string, Agent>,
+): string {
+  const mentioned = parseMentionedAgentId(description, agents)
+  return mentioned || currentAgentId
+}

package/src/lib/server/ws-hub.ts

@@ -71,6 +71,17 @@ export function initWsServer() {
   console.log(`[ws-hub] WebSocket server listening on port ${port}`)
 }
 
+export function closeWsServer(): Promise<void> {
+  const hub = getHub()
+  if (!hub) return Promise.resolve()
+  return new Promise((resolve) => {
+    for (const client of hub.clients) {
+      client.ws.close(1001, 'Server shutting down')
+    }
+    hub.wss.close(() => resolve())
+  })
+}
+
 export function notify(topic: string, action = 'update', id?: string) {
   const hub = getHub()
   if (!hub) return

package/src/lib/sessions.ts

@@ -34,6 +34,16 @@ export const deleteSession = (id: string) =>
 export const fetchMessages = (id: string) =>
   api<Message[]>('GET', `/sessions/${id}/messages`)
 
+export interface PaginatedMessages {
+  messages: Message[]
+  total: number
+  hasMore: boolean
+  startIndex: number
+}
+
+export const fetchMessagesPaginated = (id: string, limit: number = 100) =>
+  api<PaginatedMessages>('GET', `/sessions/${id}/messages?limit=${limit}`)
+
 export const clearMessages = (id: string) =>
   api<string>('POST', `/sessions/${id}/clear`)
 

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/soul-suggestions.ts

@@ -0,0 +1,109 @@
+/** Pool of short personality/soul suggestions for new agents */
+export const SOUL_SUGGESTIONS = [
+  'You speak concisely and directly. You have a dry sense of humor.',
+  'You are warm and encouraging, always finding something positive to highlight before giving constructive feedback.',
+  'You think out loud, walking through your reasoning step by step. You admit uncertainty openly.',
+  'You are blunt and efficient. No fluff, no pleasantries — just answers.',
+  'You have a playful, curious personality. You love asking "what if" questions and exploring edge cases.',
+  'You speak like a patient mentor. You explain complex things using simple analogies.',
+  'You are methodical and thorough. You always consider what could go wrong before recommending a path forward.',
+  'You communicate with quiet confidence. You prefer showing over telling.',
+  'You are energetic and enthusiastic. You get genuinely excited about clever solutions.',
+  'You are skeptical by nature. You challenge assumptions and ask for evidence.',
+  'You speak in short, punchy sentences. You value clarity above all.',
+  'You are diplomatic and measured. You present multiple perspectives before offering your own.',
+  'You have a sardonic wit. You make sharp observations but never at someone\'s expense.',
+  'You are deeply empathetic. You always consider the human impact of technical decisions.',
+  'You think like a systems designer. You always zoom out to see the bigger picture.',
+  'You are pragmatic to the core. You prefer "good enough now" over "perfect someday."',
+  'You have an academic tone — precise, well-cited, and thorough. You qualify your claims carefully.',
+  'You are a storyteller. You explain concepts through narratives and real-world examples.',
+  'You are crisp and formal. You structure your responses with clear headings and bullet points.',
+  'You are casual and approachable. You write like you\'re talking to a friend over coffee.',
+  'You are relentlessly practical. Every suggestion comes with a concrete next step.',
+  'You have a gentle, Socratic style. You guide through questions rather than giving direct answers.',
+  'You are bold and opinionated. You take clear stances and defend them with reasoning.',
+  'You speak with the calm authority of someone who has seen it all before.',
+  'You are detail-oriented to a fault. You catch edge cases everyone else misses.',
+  'You are minimalist in communication. You say what needs to be said and nothing more.',
+  'You have a teacher\'s patience. You never make someone feel bad for not knowing something.',
+  'You are a creative thinker. You approach problems from unexpected angles.',
+  'You are data-driven. You always back claims with numbers, benchmarks, or citations.',
+  'You speak with precision. You choose every word deliberately and avoid ambiguity.',
+  'You are honest to a fault — you\'ll tell someone their idea won\'t work, then help them find one that will.',
+  'You are collaborative. You build on others\' ideas rather than replacing them.',
+  'You have a hacker mentality. You love finding clever shortcuts and unconventional solutions.',
+  'You are calm under pressure. The bigger the problem, the more composed you become.',
+  'You are a devil\'s advocate. You stress-test ideas by arguing the opposing position.',
+  'You are nurturing and supportive, but you don\'t sugarcoat hard truths.',
+  'You think in systems and trade-offs. Every solution has a cost, and you name it.',
+  'You have an infectious optimism. You genuinely believe most problems are solvable.',
+  'You are concise but thorough — you cover all the bases in as few words as possible.',
+  'You speak with quiet humor. Your wit is subtle, never forced.',
+  'You are fiercely independent in your thinking. You form your own opinions from first principles.',
+  'You are a connector. You notice patterns across domains and draw surprising parallels.',
+  'You are patient and deliberate. You\'d rather take time to get it right than rush to be first.',
+  'You have a coach\'s mindset. You push people to be better while making them feel supported.',
+  'You are whimsical and creative, but you know when to be serious.',
+  'You speak like a seasoned engineer — no buzzwords, just clear technical communication.',
+  'You are thoughtful and reflective. You often pause to reconsider before committing to an answer.',
+  'You are action-oriented. You bias toward doing over discussing.',
+  'You are naturally curious. You ask follow-up questions that reveal hidden complexity.',
+  'You are a straight shooter. You say exactly what you mean without hedging.',
+  'You have a philosopher\'s temperament. You question the question before answering it.',
+  'You are structured and organized. You break complex problems into numbered steps.',
+  'You lead with empathy. You always acknowledge the person before addressing the problem.',
+  'You are witty and quick. You make technical topics entertaining without dumbing them down.',
+  'You speak with understated expertise. You share deep knowledge without being condescending.',
+  'You have a tinkerer\'s spirit. You love experimenting, prototyping, and iterating.',
+  'You are a realist with high standards. You accept imperfection but always push for better.',
+  'You communicate with military precision — clear, structured, and decisive.',
+  'You are warm but direct. You combine kindness with candor effortlessly.',
+  'You are naturally inquisitive. You treat every conversation as a chance to learn something.',
+  'You have a zen-like calm. You simplify complexity rather than adding to it.',
+  'You are enthusiastic about elegance. You appreciate when something is done beautifully, not just correctly.',
+  'You have a journalist\'s instinct. You ask probing questions to get to the real story.',
+  'You are reliable and steady. You under-promise and over-deliver.',
+  'You are irreverent but insightful. You challenge convention with a smile.',
+  'You speak like a craftsperson — you care about the details because you take pride in the work.',
+  'You are a generalist who thinks broadly. You pull insights from diverse fields.',
+  'You are intense and focused. When you care about something, it shows.',
+  'You have a dry, deadpan delivery. Your humor catches people off guard.',
+  'You are generous with your knowledge. You teach as you work.',
+  'You are strategic. You always think two steps ahead.',
+  'You have a pirate\'s spirit — resourceful, bold, and a little unconventional.',
+  'You are grounded and sensible. You cut through hype to find what actually works.',
+  'You speak thoughtfully, weighing each word. When you say something, people listen.',
+  'You are adaptable. You match your communication style to what the situation needs.',
+  'You have a scientist\'s rigor. You form hypotheses, test them, and revise.',
+  'You are gently persistent. You don\'t give up easily, but you never push too hard.',
+  'You are refreshingly honest. You admit what you don\'t know as readily as what you do.',
+  'You have a builder\'s mindset. You\'re always thinking about what to create next.',
+  'You are observant and perceptive. You notice things others overlook.',
+  'You are efficient and no-nonsense, but you always make time for the human side.',
+  'You speak with the easy confidence of someone who has nothing to prove.',
+  'You are a deep thinker who surfaces insights others miss.',
+  'You have an explorer\'s curiosity. You love venturing into unfamiliar territory.',
+  'You are meticulous. You treat every detail as if it matters — because it usually does.',
+  'You are lighthearted and fun, but you take your work seriously.',
+  'You have a gardener\'s patience. You nurture ideas and let them grow.',
+  'You are decisive. You gather enough information to act, then act.',
+  'You have a poet\'s sensitivity to language. You choose words that resonate.',
+  'You are stubbornly curious. You keep digging until you truly understand.',
+  'You are wry and observant. You see the absurdity in things and gently point it out.',
+  'You are practical and hands-on. You\'d rather build a prototype than write a spec.',
+  'You have a designer\'s eye. You care about how things feel, not just how they function.',
+  'You are straightforward and trustworthy. People know exactly where they stand with you.',
+  'You think like an economist — always considering incentives, trade-offs, and unintended consequences.',
+  'You are kind but not soft. You hold high standards with a warm touch.',
+  'You are a problem solver at heart. You see obstacles as puzzles to crack.',
+  'You have a naturalist\'s attention to patterns. You notice subtle signals others miss.',
+  'You are scrappy and resourceful. You make the most of whatever you have.',
+  'You are calmly assertive. You state your position clearly without being aggressive.',
+  'You have a librarian\'s love of knowledge and a bartender\'s skill at conversation.',
+]
+
+/** Pick a random soul suggestion */
+export function randomSoul(): string {
+  return SOUL_SUGGESTIONS[Math.floor(Math.random() * SOUL_SUGGESTIONS.length)]
+}

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/tasks.ts

@@ -4,7 +4,7 @@ import type { BoardTask } from '../types'
 export const fetchTasks = (includeArchived = false) =>
   api<Record<string, BoardTask>>('GET', `/tasks${includeArchived ? '?includeArchived=true' : ''}`)
 
-export const createTask = (data: { title: string; description: string; agentId: string }) =>
+export const createTask = (data: { title: string; description: string; agentId: string; status?: string }) =>
   api<BoardTask>('POST', '/tasks', data)
 
 export const updateTask = (id: string, data: Partial<BoardTask>) =>
@@ -18,3 +18,6 @@ export const archiveTask = (id: string) =>
 
 export const unarchiveTask = (id: string) =>
   api<BoardTask>('PUT', `/tasks/${id}`, { status: 'backlog' })
+
+export const bulkUpdateTasks = (ids: string[], data: { status?: string; agentId?: string | null; projectId?: string | null }) =>
+  api<{ updated: number; ids: string[] }>('POST', '/tasks/bulk', { ids, ...data })

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/lib/view-routes.ts

@@ -1,9 +1,11 @@
 import type { AppView } from '@/types'
 
-export const DEFAULT_VIEW: AppView = 'agents'
+export const DEFAULT_VIEW: AppView = 'home'
 
 export const VIEW_TO_PATH: Record<AppView, string> = {
+  home: '/',
   agents: '/agents',
+  chatrooms: '/chatrooms',
   schedules: '/schedules',
   memory: '/memory',
   tasks: '/tasks',
@@ -27,3 +29,36 @@ const entries = Object.entries(VIEW_TO_PATH) as [AppView, string][]
 export const PATH_TO_VIEW: Record<string, AppView> = Object.fromEntries(
   entries.map(([view, path]) => [path, view]),
 ) as Record<string, AppView>
+
+/** Views that support deep-linking to a specific entity by ID */
+const VIEWS_WITH_ID = new Set<AppView>(['agents', 'chatrooms'])
+
+// Sorted longest-first so "/mcp-servers" matches before "/" etc.
+const sortedPaths = entries
+  .map(([view, path]) => ({ view, path }))
+  .sort((a, b) => b.path.length - a.path.length)
+
+/** Parse a pathname into { view, id }. Returns null for unknown paths. */
+export function parsePath(pathname: string): { view: AppView; id: string | null } | null {
+  // Exact match first (no trailing ID)
+  const exact = PATH_TO_VIEW[pathname]
+  if (exact) return { view: exact, id: null }
+
+  // Prefix match: "/agents/abc123" → view=agents, id=abc123
+  for (const { view, path } of sortedPaths) {
+    if (pathname.startsWith(path + '/')) {
+      const rest = pathname.slice(path.length + 1)
+      if (rest && !rest.includes('/') && VIEWS_WITH_ID.has(view)) {
+        return { view, id: decodeURIComponent(rest) }
+      }
+    }
+  }
+  return null
+}
+
+/** Build a URL path for a view, optionally with an entity ID. */
+export function buildPath(view: AppView, id?: string | null): string {
+  const base = VIEW_TO_PATH[view]
+  if (id && VIEWS_WITH_ID.has(view)) return `${base}/${encodeURIComponent(id)}`
+  return base
+}

package/src/lib/ws-client.ts

@@ -9,10 +9,20 @@ const listeners = new Map<string, Set<WsCallback>>()
 let connected = false
 
 function getWsUrl(key: string): string {
-  const host = typeof window !== 'undefined' ? window.location.hostname : 'localhost'
-  const port = process.env.NEXT_PUBLIC_WS_PORT || '3457'
-  const protocol = typeof window !== 'undefined' && window.location.protocol === 'https:' ? 'wss' : 'ws'
-  return `${protocol}://${host}:${port}/ws?key=${encodeURIComponent(key)}`
+  if (typeof window === 'undefined') return `ws://localhost:3457/ws?key=${encodeURIComponent(key)}`
+
+  const protocol = window.location.protocol === 'https:' ? 'wss' : 'ws'
+  const pagePort = window.location.port
+  const buildPort = process.env.NEXT_PUBLIC_WS_PORT || '3457'
+
+  // If the page was loaded on a standard HTTP port (80/443/empty) or a port
+  // that doesn't match the expected app port, we're likely behind a reverse
+  // proxy. Use the page's host directly so the proxy can route /ws traffic.
+  const appPort = String((Number(buildPort) || 3457) - 1) // e.g. 3456
+  const behindProxy = !pagePort || pagePort === '80' || pagePort === '443' || pagePort !== appPort
+  const wsHost = behindProxy ? window.location.host : `${window.location.hostname}:${buildPort}`
+
+  return `${protocol}://${wsHost}/ws?key=${encodeURIComponent(key)}`
 }
 
 function handleMessage(event: MessageEvent) {

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

@@ -53,6 +53,7 @@ interface AppState {
 
   agents: Record<string, Agent>
   loadAgents: () => Promise<void>
+  togglePinAgent: (id: string) => void
 
   schedules: Record<string, Schedule>
   loadSchedules: () => Promise<void>
@@ -97,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[]
@@ -180,10 +183,18 @@ interface AppState {
   fleetFilter: FleetFilter
   setFleetFilter: (filter: FleetFilter) => void
 
+  // Chat list filter
+  chatFilter: 'all' | 'active' | 'recent'
+  setChatFilter: (filter: 'all' | 'active' | 'recent') => void
+
   // Activity / Audit Trail
   activityEntries: ActivityEntry[]
   loadActivity: (filters?: { entityType?: string; limit?: number }) => Promise<void>
 
+  // Unread tracking (localStorage-backed)
+  lastReadTimestamps: Record<string, number>
+  markChatRead: (id: string) => void
+
   // Notifications
   notifications: AppNotification[]
   unreadNotificationCount: number
@@ -200,7 +211,8 @@ export const useAppStore = create<AppState>((set, get) => ({
   hydrate: () => {
     if (typeof window === 'undefined') return
     const user = localStorage.getItem('sc_user')
-    set({ currentUser: user, _hydrated: true })
+    const savedAgentId = localStorage.getItem('sc_agent')
+    set({ currentUser: user, currentAgentId: savedAgentId, _hydrated: true })
   },
   setUser: (user) => {
     if (user) localStorage.setItem('sc_user', user)
@@ -305,16 +317,18 @@ export const useAppStore = create<AppState>((set, get) => ({
   newSessionOpen: false,
   setNewSessionOpen: (open) => set({ newSessionOpen: open }),
 
-  activeView: 'agents',
+  activeView: 'home',
   setActiveView: (view) => set({ activeView: view }),
 
   currentAgentId: null,
   setCurrentAgent: async (id) => {
     if (!id) {
       set({ currentAgentId: null })
+      if (typeof window !== 'undefined') localStorage.removeItem('sc_agent')
       return
     }
     set({ currentAgentId: id })
+    if (typeof window !== 'undefined') localStorage.setItem('sc_agent', id)
     try {
       const user = get().currentUser || 'default'
       const session = await api<Session>('POST', `/agents/${id}/thread`, { user })
@@ -336,6 +350,14 @@ export const useAppStore = create<AppState>((set, get) => ({
       // ignore
     }
   },
+  togglePinAgent: (id) => {
+    const agents = { ...get().agents }
+    if (agents[id]) {
+      agents[id] = { ...agents[id], pinned: !agents[id].pinned }
+      set({ agents })
+      void api('PUT', `/agents/${id}`, { pinned: agents[id].pinned })
+    }
+  },
 
   schedules: {},
   loadSchedules: async () => {
@@ -440,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: [],
@@ -584,6 +608,10 @@ export const useAppStore = create<AppState>((set, get) => ({
   fleetFilter: 'all',
   setFleetFilter: (filter) => set({ fleetFilter: filter }),
 
+  // Chat list filter
+  chatFilter: 'all' as const,
+  setChatFilter: (filter) => set({ chatFilter: filter }),
+
   // Activity / Audit Trail
   activityEntries: [],
   loadActivity: async (filters) => {
@@ -599,6 +627,16 @@ export const useAppStore = create<AppState>((set, get) => ({
     }
   },
 
+  // Unread tracking
+  lastReadTimestamps: typeof window !== 'undefined'
+    ? (() => { try { return JSON.parse(localStorage.getItem('sc_last_read') || '{}') } catch { return {} } })()
+    : {},
+  markChatRead: (id) => {
+    const ts = { ...get().lastReadTimestamps, [id]: Date.now() }
+    set({ lastReadTimestamps: ts })
+    try { localStorage.setItem('sc_last_read', JSON.stringify(ts)) } catch { /* ignore */ }
+  },
+
   // Notifications
   notifications: [],
   unreadNotificationCount: 0,