@swarmclawai/swarmclaw 0.5.2 → 0.5.3

package/README.md

@@ -20,6 +20,7 @@ Inspired by [OpenClaw](https://github.com/openclaw).
 - Always use the access key authentication (generated on first run)
 - Never expose port 3456 without a reverse proxy + TLS
 - Review agent system prompts before giving them shell or browser tools
+- Repeated failed access key attempts are rate-limited to slow brute-force attacks
 
 ## Features
 
@@ -40,6 +41,8 @@ Inspired by [OpenClaw](https://github.com/openclaw).
 - **Session Run Queue** — Per-session queued runs with followup/steer/collect modes, collect coalescing for bursty inputs, and run-state APIs
 - **Chat Iteration Workflow** — Edit-and-resend user turns, fork a new session from any message, bookmark key messages, use contextual follow-up suggestion chips, and auto-continue after tool access grants
 - **Live Chat Telemetry** — Thinking/tool/responding stream phases, live main-loop status badges, connector activity presence, tone indicator, and optional sound notifications
+- **Global Search Palette** — `Cmd/Ctrl+K` search across agents, tasks, sessions, schedules, webhooks, and skills from anywhere in the app
+- **Notification Center** — Real-time in-app notifications for task/schedule/daemon events with unread tracking and quick actions
 - **Preview-Rich Chat UI** — Side preview panel for tool outputs (image/browser/html/code), inline code/PDF previews for attachments, and image lightbox support
 - **Voice Settings** — Per-instance ElevenLabs API key + voice ID for TTS replies, plus configurable speech recognition language for chat input
 - **Chat Connectors** — Bridge agents to Discord, Slack, Telegram, WhatsApp, BlueBubbles (iMessage), Signal, Microsoft Teams, Google Chat, Matrix, and OpenClaw with media-aware inbound handling
@@ -48,6 +51,7 @@ Inspired by [OpenClaw](https://github.com/openclaw).
 - **Context Management** — Auto-compaction of conversation history when approaching context limits, with manual `context_status` and `context_summarize` tools for agents
 - **Memory** — Per-agent and per-session memory with hybrid FTS5 + vector embeddings search, relevance-based memory recall injected into runs, and periodic auto-journaling for durable execution context
 - **Cost Tracking** — Per-message token counting and cost estimation displayed in the chat header
+- **Provider Health Metrics** — Usage dashboard surfaces provider request volume, success rates, models used, and last-used timestamps
 - **Model Failover** — Automatic key rotation on rate limits and auth errors with configurable fallback credentials
 - **Plugin System** — Extend agent behavior with JS plugins (hooks: beforeAgentStart, afterAgentComplete, beforeToolExec, afterToolExec, onMessage)
 - **Secrets Vault** — Encrypted storage for API keys and service tokens
@@ -81,7 +85,7 @@ curl -fsSL https://raw.githubusercontent.com/swarmclawai/swarmclaw/main/install.
 ```
 
 The installer resolves the latest stable release tag and installs that version by default.
-To pin a version: `SWARMCLAW_VERSION=v0.5.2 curl ... | bash`
+To pin a version: `SWARMCLAW_VERSION=v0.5.3 curl ... | bash`
 
 Or run locally from the repo (friendly for non-technical users):
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "Self-hosted AI agent orchestration dashboard — manage LLM providers, orchestrate agent swarms, schedule tasks, and bridge agents to chat platforms.",
   "license": "MIT",
   "repository": {

package/src/app/api/notifications/[id]/route.ts

@@ -0,0 +1,27 @@
+import { NextResponse } from 'next/server'
+import { loadNotifications, markNotificationRead, deleteNotification } from '@/lib/server/storage'
+import { notify } from '@/lib/server/ws-hub'
+
+export async function PUT(_req: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params
+  const all = loadNotifications()
+  if (!all[id]) {
+    return NextResponse.json({ error: 'Not found' }, { status: 404 })
+  }
+
+  markNotificationRead(id)
+  notify('notifications')
+  return NextResponse.json({ ok: true })
+}
+
+export async function DELETE(_req: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params
+  const all = loadNotifications()
+  if (!all[id]) {
+    return NextResponse.json({ error: 'Not found' }, { status: 404 })
+  }
+
+  deleteNotification(id)
+  notify('notifications')
+  return NextResponse.json({ ok: true })
+}

package/src/app/api/notifications/route.ts

@@ -0,0 +1,64 @@
+import { NextResponse } from 'next/server'
+import { genId } from '@/lib/id'
+import { loadNotifications, saveNotification, deleteNotification } from '@/lib/server/storage'
+import { notify } from '@/lib/server/ws-hub'
+import type { AppNotification } from '@/types'
+export const dynamic = 'force-dynamic'
+
+export async function GET(req: Request) {
+  const { searchParams } = new URL(req.url)
+  const unreadOnly = searchParams.get('unreadOnly') === 'true'
+  const limit = Math.min(200, Math.max(1, Number(searchParams.get('limit')) || 100))
+
+  const all = loadNotifications()
+  let entries = Object.values(all) as AppNotification[]
+
+  if (unreadOnly) {
+    entries = entries.filter((e) => !e.read)
+  }
+
+  entries.sort((a, b) => b.createdAt - a.createdAt)
+  entries = entries.slice(0, limit)
+
+  return NextResponse.json(entries)
+}
+
+export async function POST(req: Request) {
+  const body = (await req.json()) as Record<string, unknown>
+  const id = genId()
+  const notification: AppNotification = {
+    id,
+    type: (['info', 'success', 'warning', 'error'].includes(body.type as string) ? body.type : 'info') as AppNotification['type'],
+    title: typeof body.title === 'string' ? body.title : 'Notification',
+    message: typeof body.message === 'string' ? body.message : undefined,
+    entityType: typeof body.entityType === 'string' ? body.entityType : undefined,
+    entityId: typeof body.entityId === 'string' ? body.entityId : undefined,
+    read: false,
+    createdAt: Date.now(),
+  }
+
+  saveNotification(id, notification)
+  notify('notifications')
+  return NextResponse.json(notification, { status: 201 })
+}
+
+export async function DELETE(req: Request) {
+  const { searchParams } = new URL(req.url)
+  const specificId = searchParams.get('id')
+
+  if (specificId) {
+    deleteNotification(specificId)
+  } else {
+    // Clear all read notifications
+    const all = loadNotifications()
+    for (const raw of Object.values(all)) {
+      const entry = raw as AppNotification
+      if (entry.read) {
+        deleteNotification(entry.id)
+      }
+    }
+  }
+
+  notify('notifications')
+  return NextResponse.json({ ok: true })
+}

package/src/app/api/search/route.ts

@@ -0,0 +1,105 @@
+import { NextResponse } from 'next/server'
+import {
+  loadTasks,
+  loadAgents,
+  loadSessions,
+  loadSchedules,
+  loadWebhooks,
+  loadSkills,
+} from '@/lib/server/storage'
+
+interface SearchResult {
+  type: 'task' | 'agent' | 'session' | 'schedule' | 'webhook' | 'skill'
+  id: string
+  title: string
+  description?: string
+  status?: string
+}
+
+const MAX_RESULTS = 20
+
+function matches(haystack: string | undefined | null, needle: string): boolean {
+  if (!haystack) return false
+  return haystack.toLowerCase().includes(needle)
+}
+
+function searchCollection(
+  collection: Record<string, Record<string, unknown>>,
+  type: SearchResult['type'],
+  needle: string,
+  titleKey: string,
+  descKey: string,
+  statusKey?: string,
+): SearchResult[] {
+  const results: SearchResult[] = []
+  for (const [id, item] of Object.entries(collection)) {
+    const title = item[titleKey] as string | undefined
+    const desc = item[descKey] as string | undefined
+    const idStr = typeof item.id === 'string' ? item.id : id
+    if (matches(title, needle) || matches(desc, needle) || matches(idStr, needle)) {
+      results.push({
+        type,
+        id,
+        title: title || idStr || id,
+        description: desc ? desc.slice(0, 120) : undefined,
+        status: statusKey ? (item[statusKey] as string | undefined) : undefined,
+      })
+    }
+  }
+  return results
+}
+
+export async function GET(req: Request) {
+  const { searchParams } = new URL(req.url)
+  const q = (searchParams.get('q') || '').trim().toLowerCase()
+
+  if (q.length < 2) {
+    return NextResponse.json({ results: [] })
+  }
+
+  const tasks = loadTasks() as Record<string, Record<string, unknown>>
+  const agents = loadAgents() as Record<string, Record<string, unknown>>
+  const sessions = loadSessions() as Record<string, Record<string, unknown>>
+  const schedules = loadSchedules() as Record<string, Record<string, unknown>>
+  const webhooks = loadWebhooks() as Record<string, Record<string, unknown>>
+  const skills = loadSkills() as Record<string, Record<string, unknown>>
+
+  const buckets: SearchResult[][] = [
+    searchCollection(agents, 'agent', q, 'name', 'description'),
+    searchCollection(tasks, 'task', q, 'title', 'description', 'status'),
+    searchCollection(sessions, 'session', q, 'name', 'cwd'),
+    searchCollection(schedules, 'schedule', q, 'name', 'taskPrompt', 'status'),
+    searchCollection(webhooks, 'webhook', q, 'name', 'source'),
+    searchCollection(skills, 'skill', q, 'name', 'description'),
+  ]
+
+  // Proportional allocation across types
+  const totalRaw = buckets.reduce((s, b) => s + b.length, 0)
+  if (totalRaw === 0) {
+    return NextResponse.json({ results: [] })
+  }
+
+  const results: SearchResult[] = []
+  if (totalRaw <= MAX_RESULTS) {
+    for (const bucket of buckets) results.push(...bucket)
+  } else {
+    // Give each bucket a fair share, round-robin leftover slots
+    const perBucket = Math.floor(MAX_RESULTS / buckets.length)
+    let remaining = MAX_RESULTS
+    for (const bucket of buckets) {
+      const take = Math.min(bucket.length, perBucket)
+      results.push(...bucket.slice(0, take))
+      remaining -= take
+    }
+    // Fill remaining slots from buckets that had more
+    for (const bucket of buckets) {
+      if (remaining <= 0) break
+      const alreadyTaken = Math.min(bucket.length, perBucket)
+      const extra = bucket.slice(alreadyTaken, alreadyTaken + remaining)
+      results.push(...extra)
+      remaining -= extra.length
+    }
+  }
+
+  return NextResponse.json({ results })
+}

package/src/app/api/tasks/[id]/route.ts

@@ -7,6 +7,7 @@ import { ensureTaskCompletionReport } from '@/lib/server/task-reports'
 import { formatValidationFailure, validateTaskCompletion } from '@/lib/server/task-validation'
 import { pushMainLoopEventToMainSessions } from '@/lib/server/main-agent-loop'
 import { notify } from '@/lib/server/ws-hub'
+import { createNotification } from '@/lib/server/create-notification'
 
 export async function GET(_req: Request, { params }: { params: Promise<{ id: string }> }) {
   // Keep completed queue integrity even if daemon is not running.
@@ -76,6 +77,13 @@ export async function PUT(req: Request, { params }: { params: Promise<{ id: stri
   // If task is manually transitioned to a terminal status, disable session heartbeat.
   if (prevStatus !== tasks[id].status && (tasks[id].status === 'completed' || tasks[id].status === 'failed')) {
     disableSessionHeartbeat(tasks[id].sessionId)
+    createNotification({
+      type: tasks[id].status === 'completed' ? 'success' : 'error',
+      title: `Task ${tasks[id].status}: "${tasks[id].title}"`,
+      message: tasks[id].status === 'failed' ? tasks[id].error?.slice(0, 200) : undefined,
+      entityType: 'task',
+      entityId: id,
+    })
   }
 
   // Dependency check: cannot queue a task if any blocker is incomplete

package/src/app/api/usage/route.ts

@@ -78,6 +78,50 @@ export async function GET(req: Request) {
     .sort(([a], [b]) => a.localeCompare(b))
     .map(([bucket, data]) => ({ bucket, tokens: data.tokens, cost: Math.round(data.cost * 10000) / 10000 }))
 
+  // Provider health stats
+  const healthAccum: Record<string, {
+    totalRequests: number
+    successCount: number
+    errorCount: number
+    lastUsed: number
+    models: Set<string>
+  }> = {}
+
+  for (const r of records) {
+    const prov = r.provider || 'unknown'
+    if (!healthAccum[prov]) {
+      healthAccum[prov] = { totalRequests: 0, successCount: 0, errorCount: 0, lastUsed: 0, models: new Set() }
+    }
+    const h = healthAccum[prov]
+    h.totalRequests += 1
+    // UsageRecord has no error/status field — logged records are successful completions
+    h.successCount += 1
+    if ((r.timestamp || 0) > h.lastUsed) h.lastUsed = r.timestamp || 0
+    if (r.model) h.models.add(r.model)
+  }
+
+  const providerHealth: Record<string, {
+    totalRequests: number
+    successCount: number
+    errorCount: number
+    errorRate: number
+    avgLatencyMs: number
+    lastUsed: number
+    models: string[]
+  }> = {}
+
+  for (const [prov, h] of Object.entries(healthAccum)) {
+    providerHealth[prov] = {
+      totalRequests: h.totalRequests,
+      successCount: h.successCount,
+      errorCount: h.errorCount,
+      errorRate: h.totalRequests > 0 ? h.errorCount / h.totalRequests : 0,
+      avgLatencyMs: 0, // UsageRecord does not track latency
+      lastUsed: h.lastUsed,
+      models: Array.from(h.models),
+    }
+  }
+
   return NextResponse.json({
     records,
     totalTokens,
@@ -85,5 +129,6 @@ export async function GET(req: Request) {
     byAgent,
     byProvider,
     timeSeries,
+    providerHealth,
   })
 }

package/src/cli/index.js

@@ -183,6 +183,17 @@ const COMMAND_GROUPS = [
       cmd('get', 'GET', '/memory-images/:filename', 'Download memory image by filename', { responseType: 'binary' }),
     ],
   },
+  {
+    name: 'notifications',
+    description: 'Manage in-app notifications',
+    commands: [
+      cmd('list', 'GET', '/notifications', 'List notifications (use --query unreadOnly=true --query limit=100)'),
+      cmd('create', 'POST', '/notifications', 'Create notification', { expectsJsonBody: true }),
+      cmd('clear', 'DELETE', '/notifications', 'Clear read notifications'),
+      cmd('mark-read', 'PUT', '/notifications/:id', 'Mark notification as read'),
+      cmd('delete', 'DELETE', '/notifications/:id', 'Delete notification by id'),
+    ],
+  },
   {
     name: 'mcp-servers',
     description: 'Manage MCP server configurations',
@@ -293,6 +304,13 @@ const COMMAND_GROUPS = [
       cmd('models-clear', 'DELETE', '/providers/:id/models', 'Clear provider model overrides'),
     ],
   },
+  {
+    name: 'search',
+    description: 'Global search across app resources',
+    commands: [
+      cmd('query', 'GET', '/search', 'Search agents/tasks/sessions/schedules/webhooks/skills (use --query q=term)'),
+    ],
+  },
   {
     name: 'runs',
     description: 'Session run queue/history',

package/src/cli/spec.js

@@ -130,6 +130,16 @@ const COMMAND_GROUPS = {
       get: { description: 'Download memory image by filename', method: 'GET', path: '/memory-images/:filename', params: ['filename'], binary: true },
     },
   },
+  notifications: {
+    description: 'In-app notification center',
+    commands: {
+      list: { description: 'List notifications (supports --query unreadOnly=true,limit=100)', method: 'GET', path: '/notifications' },
+      create: { description: 'Create notification', method: 'POST', path: '/notifications' },
+      clear: { description: 'Clear read notifications', method: 'DELETE', path: '/notifications' },
+      'mark-read': { description: 'Mark notification as read', method: 'PUT', path: '/notifications/:id', params: ['id'] },
+      delete: { description: 'Delete notification by id', method: 'DELETE', path: '/notifications/:id', params: ['id'] },
+    },
+  },
   orchestrator: {
     description: 'Orchestrator runs and run-state APIs',
     commands: {
@@ -198,6 +208,12 @@ const COMMAND_GROUPS = {
       'models-reset': { description: 'Delete provider model overrides', method: 'DELETE', path: '/providers/:id/models', params: ['id'] },
     },
   },
+  search: {
+    description: 'Global search across app resources',
+    commands: {
+      query: { description: 'Search agents/tasks/sessions/schedules/webhooks/skills (supports --query q=term)', method: 'GET', path: '/search' },
+    },
+  },
   schedules: {
     description: 'Scheduled task automation',
     commands: {

package/src/components/layout/app-layout.tsx

@@ -40,10 +40,12 @@ import { ActivityFeed } from '@/components/activity/activity-feed'
 import { MetricsDashboard } from '@/components/usage/metrics-dashboard'
 import { ProjectList } from '@/components/projects/project-list'
 import { ProjectSheet } from '@/components/projects/project-sheet'
+import { SearchDialog } from '@/components/shared/search-dialog'
 import { NetworkBanner } from './network-banner'
 import { UpdateBanner } from './update-banner'
 import { MobileHeader } from './mobile-header'
 import { DaemonIndicator } from './daemon-indicator'
+import { NotificationCenter } from '@/components/shared/notification-center'
 import { ChatArea } from '@/components/chat/chat-area'
 import { Tooltip, TooltipTrigger, TooltipContent } from '@/components/ui/tooltip'
 import type { AppView } from '@/types'
@@ -238,6 +240,37 @@ export function AppLayout() {
             </RailTooltip>
           )}
 
+          {/* Search */}
+          {railExpanded ? (
+            <div className="px-3 mb-2">
+              <button
+                onClick={() => window.dispatchEvent(new CustomEvent('swarmclaw:open-search'))}
+                className="w-full flex items-center gap-2.5 px-3 py-2 rounded-[10px] text-[13px] font-500 cursor-pointer transition-all
+                  bg-transparent text-text-3 hover:text-text hover:bg-white/[0.04] border-none"
+                style={{ fontFamily: 'inherit' }}
+              >
+                <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round">
+                  <circle cx="11" cy="11" r="8" /><line x1="21" y1="21" x2="16.65" y2="16.65" />
+                </svg>
+                Search
+                <kbd className="ml-auto px-1.5 py-0.5 rounded-[5px] bg-white/[0.06] border border-white/[0.08] text-[10px] font-mono text-text-3">
+                  ⌘K
+                </kbd>
+              </button>
+            </div>
+          ) : (
+            <RailTooltip label="Search" description="Search across all entities (⌘K)">
+              <button
+                onClick={() => window.dispatchEvent(new CustomEvent('swarmclaw:open-search'))}
+                className="rail-btn self-center mb-2"
+              >
+                <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round">
+                  <circle cx="11" cy="11" r="8" /><line x1="21" y1="21" x2="16.65" y2="16.65" />
+                </svg>
+              </button>
+            </RailTooltip>
+          )}
+
           {/* Nav items */}
           <div className={`flex flex-col gap-0.5 ${railExpanded ? 'px-3' : 'items-center'}`}>
             <NavItem view="agents" label="Agents" expanded={railExpanded} active={activeView} sidebarOpen={sidebarOpen} onClick={() => handleNavClick('agents')}>
@@ -363,6 +396,18 @@ export function AppLayout() {
               </RailTooltip>
             )}
             {railExpanded && <DaemonIndicator />}
+            {railExpanded ? (
+              <div className="flex items-center gap-1 px-3 py-1">
+                <span className="text-[12px] font-500 text-text-3 flex-1">Alerts</span>
+                <NotificationCenter />
+              </div>
+            ) : (
+              <RailTooltip label="Notifications" description="View system notifications">
+                <div className="rail-btn flex items-center justify-center">
+                  <NotificationCenter />
+                </div>
+              </RailTooltip>
+            )}
             {railExpanded ? (
               <button
                 onClick={() => handleNavClick('settings')}
@@ -644,6 +689,7 @@ export function AppLayout() {
         </div>
       </ErrorBoundary>
 
+      <SearchDialog />
       <AgentSheet />
       <ScheduleSheet />
       <MemorySheet />

package/src/components/layout/mobile-header.tsx

@@ -2,6 +2,7 @@
 
 import { useAppStore } from '@/stores/use-app-store'
 import { IconButton } from '@/components/shared/icon-button'
+import { NotificationCenter } from '@/components/shared/notification-center'
 
 export function MobileHeader() {
   const toggleSidebar = useAppStore((s) => s.toggleSidebar)
@@ -26,6 +27,7 @@ export function MobileHeader() {
           <span className="font-700">SwarmClaw</span>
         )}
       </h1>
+      <NotificationCenter />
     </header>
   )
 }

package/src/components/schedules/schedule-card.tsx

@@ -3,6 +3,7 @@
 import type { Schedule } from '@/types'
 import { useAppStore } from '@/stores/use-app-store'
 import { api } from '@/lib/api-client'
+import { cronToHuman } from '@/lib/cron-human'
 
 const STATUS_COLORS: Record<string, string> = {
   active: 'text-emerald-400 bg-emerald-400/[0.08]',
@@ -95,7 +96,7 @@ export function ScheduleCard({ schedule, inSidebar }: Props) {
       <div className="text-[12px] text-text-3/70 mt-1.5 truncate">
         {agent?.name || 'Unknown agent'} &middot; {schedule.scheduleType}
         {!inSidebar && schedule.scheduleType === 'cron' && schedule.cron && (
-          <span className="font-mono text-text-3/50 ml-1">({schedule.cron})</span>
+          <span className="text-text-3/50 ml-1" title={schedule.cron}>({cronToHuman(schedule.cron)})</span>
         )}
         {!inSidebar && schedule.scheduleType === 'interval' && schedule.intervalMs && (
           <span className="text-text-3/50 ml-1">