@swarmclawai/swarmclaw 0.5.2 → 0.6.0

package/src/app/api/tasks/bulk/route.ts

@@ -0,0 +1,100 @@
+import { NextResponse } from 'next/server'
+import { loadTasks, saveTasks, logActivity } from '@/lib/server/storage'
+import { enqueueTask, disableSessionHeartbeat } from '@/lib/server/queue'
+import { pushMainLoopEventToMainSessions } from '@/lib/server/main-agent-loop'
+import { notify } from '@/lib/server/ws-hub'
+import { createNotification } from '@/lib/server/create-notification'
+import type { BoardTaskStatus } from '@/types'
+
+const VALID_STATUSES: BoardTaskStatus[] = ['backlog', 'queued', 'running', 'completed', 'failed', 'archived']
+
+/**
+ * Bulk update tasks — batch status changes, agent/project reassignment, or archive/delete.
+ *
+ * POST body:
+ *   ids: string[]                — required, task IDs to update
+ *   status?: BoardTaskStatus     — move all to this status
+ *   agentId?: string | null      — reassign agent (null to clear)
+ *   projectId?: string | null    — reassign project (null to clear)
+ */
+export async function POST(req: Request) {
+  const body = await req.json()
+  const ids: unknown = body.ids
+  if (!Array.isArray(ids) || ids.length === 0) {
+    return NextResponse.json({ error: 'ids must be a non-empty array' }, { status: 400 })
+  }
+
+  const taskIds = ids.filter((id): id is string => typeof id === 'string')
+  if (taskIds.length === 0) {
+    return NextResponse.json({ error: 'No valid task IDs provided' }, { status: 400 })
+  }
+
+  const tasks = loadTasks()
+  let updated = 0
+  const results: string[] = []
+
+  for (const id of taskIds) {
+    if (!tasks[id]) continue
+    const prevStatus = tasks[id].status
+
+    if (typeof body.status === 'string' && VALID_STATUSES.includes(body.status as BoardTaskStatus)) {
+      tasks[id].status = body.status as BoardTaskStatus
+      if (body.status === 'archived' && prevStatus !== 'archived') {
+        tasks[id].archivedAt = Date.now()
+      }
+    }
+
+    if ('agentId' in body) {
+      tasks[id].agentId = body.agentId === null ? '' : String(body.agentId)
+    }
+
+    if ('projectId' in body) {
+      if (body.projectId === null) {
+        delete tasks[id].projectId
+      } else {
+        tasks[id].projectId = String(body.projectId)
+      }
+    }
+
+    tasks[id].updatedAt = Date.now()
+    updated++
+    results.push(id)
+
+    // Side-effects for status transitions
+    if (prevStatus !== tasks[id].status) {
+      logActivity({
+        entityType: 'task',
+        entityId: id,
+        action: 'updated',
+        actor: 'user',
+        summary: `Bulk update: "${tasks[id].title}" (${prevStatus} → ${tasks[id].status})`,
+      })
+      pushMainLoopEventToMainSessions({
+        type: 'task_status_changed',
+        text: `Task "${tasks[id].title}" (${id}) moved ${prevStatus} → ${tasks[id].status}.`,
+      })
+      if (tasks[id].status === 'completed' || tasks[id].status === 'failed') {
+        disableSessionHeartbeat(tasks[id].sessionId)
+      }
+      if (prevStatus !== 'queued' && tasks[id].status === 'queued') {
+        enqueueTask(id)
+      }
+    }
+  }
+
+  saveTasks(tasks)
+
+  if (updated > 0) {
+    const action = body.status
+      ? `moved ${updated} task(s) to ${body.status}`
+      : `updated ${updated} task(s)`
+    createNotification({
+      type: 'success',
+      title: `Bulk update: ${action}`,
+      entityType: 'task',
+    })
+  }
+
+  notify('tasks')
+  return NextResponse.json({ updated, ids: results })
+}

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

@@ -70,6 +70,7 @@ export async function POST(req: Request) {
     description: body.description || '',
     status: body.status || 'backlog',
     agentId: body.agentId || '',
+    projectId: typeof body.projectId === 'string' && body.projectId ? body.projectId : null,
     goalContract: body.goalContract || null,
     cwd: typeof body.cwd === 'string' ? body.cwd : null,
     file: typeof body.file === 'string' ? body.file : null,

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/app/api/webhooks/[id]/route.ts

@@ -1,8 +1,11 @@
 import { genId } from '@/lib/id'
+import { timingSafeEqual } from 'node:crypto'
 import { NextResponse } from 'next/server'
 import { loadAgents, loadSessions, loadWebhooks, saveSessions, saveWebhooks, appendWebhookLog, upsertWebhookRetry } from '@/lib/server/storage'
 import { WORKSPACE_DIR } from '@/lib/server/data-dir'
 import { enqueueSessionRun } from '@/lib/server/session-run-manager'
+import { enqueueSystemEvent } from '@/lib/server/system-events'
+import { requestHeartbeatNow } from '@/lib/server/heartbeat-wake'
 import { mutateItem, deleteItem, notFound, type CollectionOps } from '@/lib/server/collection-helpers'
 import type { WebhookRetryEntry } from '@/types'
 
@@ -71,7 +74,12 @@ export async function POST(req: Request, { params }: { params: Promise<{ id: str
   if (secret) {
     const url = new URL(req.url)
     const provided = req.headers.get('x-webhook-secret') || url.searchParams.get('secret') || ''
-    if (provided !== secret) {
+    const secretBuf = Buffer.from(secret)
+    const providedBuf = Buffer.from(provided)
+    // timingSafeEqual requires equal lengths; compare against secretBuf if lengths differ
+    const compareBuf = providedBuf.length === secretBuf.length ? providedBuf : secretBuf
+    const isInvalid = providedBuf.length !== secretBuf.length || !timingSafeEqual(secretBuf, compareBuf)
+    if (isInvalid) {
       appendWebhookLog(genId(8), {
         id: genId(8), webhookId: id, event: 'unknown',
         payload: '', status: 'error', error: 'Invalid webhook secret', timestamp: Date.now(),
@@ -193,6 +201,12 @@ export async function POST(req: Request, { params }: { params: Promise<{ id: str
       mode: 'followup',
     })
 
+    // Enqueue system event + heartbeat wake
+    enqueueSystemEvent(sid, `Webhook received: ${webhook.name || id} (${incomingEvent})`)
+    if (webhook.agentId) {
+      requestHeartbeatNow({ agentId: webhook.agentId, reason: 'webhook' })
+    }
+
     appendWebhookLog(genId(8), {
       id: genId(8), webhookId: id, event: incomingEvent,
       payload: (rawBody || '').slice(0, 2000), status: 'success',

package/src/app/globals.css

@@ -49,16 +49,17 @@
   --radius-4xl: calc(var(--radius) + 16px);
 
   /* ===== Midnight Glass Palette ===== */
-  --color-bg: #08080d;
-  --color-raised: #0d0d14;
-  --color-surface: #13131e;
-  --color-surface-2: #1e1e30;
-  --color-surface-3: #23233a;
+  /* Surfaces derived from --neutral-tint for single-knob theming */
+  --color-bg: color-mix(in srgb, var(--neutral-tint, #1e1e30) 40%, #000);
+  --color-raised: color-mix(in srgb, var(--neutral-tint, #1e1e30) 50%, #000);
+  --color-surface: color-mix(in srgb, var(--neutral-tint, #1e1e30) 65%, #000);
+  --color-surface-2: var(--neutral-tint, #1e1e30);
+  --color-surface-3: color-mix(in srgb, var(--neutral-tint, #1e1e30) 80%, #333);
   --color-border-hi: rgba(255,255,255,0.07);
   --color-border-focus: rgba(99,102,241,0.5);
   --color-text: #e2e2ec;
-  --color-text-2: #8e8ea8;
-  --color-text-3: #5c5c78;
+  --color-text-2: #a0a0ba;
+  --color-text-3: #8282a0;
   --color-accent-soft: rgba(99,102,241,0.08);
   --color-accent-glow: rgba(99,102,241,0.18);
   --color-accent-bright: #818CF8;
@@ -83,25 +84,29 @@
   --font-sora: 'Segoe UI';
   --font-jetbrains-mono: 'SF Mono';
   --radius: 0.625rem;
-  --background: #08080d;
+
+  /* ===== Single-Tint Theming ===== */
+  /* Change this one value to shift the entire palette hue */
+  --neutral-tint: #1e1e30;
+  --background: color-mix(in srgb, var(--neutral-tint) 40%, #000);
   --foreground: #e2e2ec;
-  --card: #0d0d14;
+  --card: color-mix(in srgb, var(--neutral-tint) 50%, #000);
   --card-foreground: #e2e2ec;
-  --popover: #0d0d14;
+  --popover: color-mix(in srgb, var(--neutral-tint) 50%, #000);
   --popover-foreground: #e2e2ec;
   --primary: #6366F1;
   --primary-foreground: #ffffff;
-  --secondary: #13131e;
+  --secondary: color-mix(in srgb, var(--neutral-tint) 65%, #000);
   --secondary-foreground: #e2e2ec;
-  --muted: #13131e;
-  --muted-foreground: #8e8ea8;
+  --muted: color-mix(in srgb, var(--neutral-tint) 65%, #000);
+  --muted-foreground: #a0a0ba;
   --accent: #6366F1;
   --accent-foreground: #ffffff;
   --destructive: #F43F5E;
   --border: rgba(255,255,255,0.04);
   --input: rgba(255,255,255,0.04);
   --ring: rgba(99,102,241,0.4);
-  --sidebar: #0d0d14;
+  --sidebar: color-mix(in srgb, var(--neutral-tint) 50%, #000);
   --sidebar-foreground: #e2e2ec;
   --sidebar-primary: #6366F1;
   --sidebar-primary-foreground: #ffffff;
@@ -113,7 +118,7 @@
   /* ===== Status Badge System ===== */
   --status-idle-bg: rgba(255,255,255,0.04);
   --status-idle-border: rgba(255,255,255,0.06);
-  --status-idle-fg: #8e8ea8;
+  --status-idle-fg: #a0a0ba;
   --status-running-bg: rgba(52,211,153,0.08);
   --status-running-border: rgba(52,211,153,0.15);
   --status-running-fg: #34D399;
@@ -205,6 +210,10 @@ textarea:hover::-webkit-scrollbar { width: 6px; }
   from { opacity: 0; transform: scale(0.97) translateY(6px); }
   to { opacity: 1; transform: scale(1) translateY(0); }
 }
+@keyframes msg-in {
+  from { opacity: 0; transform: translateY(6px); }
+  to { opacity: 1; transform: translateY(0); }
+}
 @keyframes spin { to { transform: rotate(360deg); } }
 @keyframes slide-in-left {
   from { transform: translateX(-100%); }
@@ -243,6 +252,30 @@ textarea:hover::-webkit-scrollbar { width: 6px; }
   to { opacity: 1; transform: translateY(0); }
 }
 
+/* Heartbeat float animation */
+@keyframes heartbeat-float {
+  0% { opacity: 1; transform: translateY(0) scale(1); }
+  50% { opacity: 0.7; transform: translateY(-14px) scale(1.15); }
+  100% { opacity: 0; transform: translateY(-26px) scale(0.85); }
+}
+
+/* Activity moment animations */
+@keyframes activity-moment-in {
+  from { opacity: 0; transform: translateY(6px) scale(0.92); }
+  to { opacity: 1; transform: translateY(0) scale(1); }
+}
+@keyframes activity-moment-out {
+  from { opacity: 1; transform: translateY(0) scale(1); }
+  to { opacity: 0; transform: translateY(-8px) scale(0.95); }
+}
+
+@keyframes avatar-moment-pulse {
+  0% { transform: scale(1); }
+  30% { transform: scale(1.15); }
+  60% { transform: scale(0.95); }
+  100% { transform: scale(1); }
+}
+
 /* AI avatar mood animations */
 @keyframes ai-pulse { 0%,100% { transform: scale(1); } 50% { transform: scale(1.15); } }
 @keyframes ai-glow { 0%,100% { box-shadow: 0 0 0 0 rgba(99,102,241,0); } 50% { box-shadow: 0 0 12px 4px rgba(99,102,241,0.35); } }
@@ -414,6 +447,16 @@ textarea:hover::-webkit-scrollbar { width: 6px; }
   font-family: var(--font-sora), 'Sora', system-ui, sans-serif;
 }
 
+/* Monospace micro-label utility */
+.label-mono {
+  font-family: var(--font-mono);
+  font-size: 10px;
+  font-weight: 600;
+  letter-spacing: 0.06em;
+  text-transform: uppercase;
+  color: var(--color-text-3);
+}
+
 /* ===== Status Badge Classes ===== */
 .status-badge-idle, .status-badge-running, .status-badge-error,
 .status-badge-connecting, .status-badge-connected, .status-badge-disconnected,

package/src/app/page.tsx

@@ -12,6 +12,130 @@ import { SetupWizard } from '@/components/auth/setup-wizard'
 import { AppLayout } from '@/components/layout/app-layout'
 import { useViewRouter } from '@/hooks/use-view-router'
 
+function FullScreenLoader() {
+  return (
+    <div className="h-full flex flex-col items-center justify-center bg-bg overflow-hidden select-none">
+      {/* Animated orbital ring */}
+      <div className="relative w-[120px] h-[120px] mb-8">
+        {/* Outer glow pulse */}
+        <div
+          className="absolute inset-[-20px] rounded-full"
+          style={{
+            background: 'radial-gradient(circle, rgba(99,102,241,0.08) 0%, transparent 70%)',
+            animation: 'sc-glow 2.5s ease-in-out infinite',
+          }}
+        />
+
+        {/* Orbital ring */}
+        <div
+          className="absolute inset-0 rounded-full border border-white/[0.06]"
+          style={{ animation: 'sc-ring 3s linear infinite' }}
+        />
+
+        {/* Orbiting dots */}
+        {[0, 1, 2, 3, 4, 5].map((i) => (
+          <div
+            key={i}
+            className="absolute inset-0"
+            style={{
+              animation: `sc-orbit 2.4s cubic-bezier(0.4, 0, 0.2, 1) infinite`,
+              animationDelay: `${i * -0.4}s`,
+            }}
+          >
+            <div
+              className="absolute top-0 left-1/2 -translate-x-1/2 -translate-y-1/2 rounded-full"
+              style={{
+                width: i === 0 ? 8 : 6,
+                height: i === 0 ? 8 : 6,
+                background: i === 0 ? '#818CF8' : `rgba(129, 140, 248, ${0.7 - i * 0.1})`,
+                boxShadow: i === 0 ? '0 0 12px rgba(99,102,241,0.5)' : 'none',
+              }}
+            />
+          </div>
+        ))}
+
+        {/* Center logo mark */}
+        <div className="absolute inset-0 flex items-center justify-center">
+          <div
+            className="relative"
+            style={{ animation: 'sc-breathe 2.5s ease-in-out infinite' }}
+          >
+            <svg width="36" height="36" viewBox="0 0 36 36" fill="none">
+              {/* Hexagonal claw mark */}
+              <path
+                d="M18 4L30 11V25L18 32L6 25V11L18 4Z"
+                stroke="rgba(129, 140, 248, 0.3)"
+                strokeWidth="1"
+                fill="none"
+              />
+              <path
+                d="M18 9L25 13V23L18 27L11 23V13L18 9Z"
+                stroke="rgba(129, 140, 248, 0.5)"
+                strokeWidth="1.5"
+                fill="rgba(99, 102, 241, 0.06)"
+              />
+              {/* Claw lines */}
+              <path d="M14 15L18 20L22 15" stroke="#818CF8" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" />
+              <path d="M12 13L18 20L24 13" stroke="rgba(129, 140, 248, 0.3)" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
+            </svg>
+          </div>
+        </div>
+      </div>
+
+      {/* Brand text */}
+      <div
+        className="text-[15px] font-display font-700 tracking-[0.15em] uppercase"
+        style={{
+          background: 'linear-gradient(135deg, rgba(255,255,255,0.6), rgba(129, 140, 248, 0.8))',
+          WebkitBackgroundClip: 'text',
+          WebkitTextFillColor: 'transparent',
+          animation: 'sc-text-fade 2s ease-in-out infinite alternate',
+        }}
+      >
+        SwarmClaw
+      </div>
+
+      {/* Loading bar */}
+      <div className="mt-4 w-[100px] h-[2px] rounded-full bg-white/[0.06] overflow-hidden">
+        <div
+          className="h-full rounded-full bg-accent-bright/60"
+          style={{ animation: 'sc-progress 1.5s ease-in-out infinite' }}
+        />
+      </div>
+
+      {/* Loading animation keyframes */}
+      <style>{`
+        @keyframes sc-orbit {
+          from { transform: rotate(0deg); }
+          to { transform: rotate(360deg); }
+        }
+        @keyframes sc-ring {
+          from { transform: rotate(0deg) scale(1); }
+          50% { transform: rotate(180deg) scale(1.02); }
+          to { transform: rotate(360deg) scale(1); }
+        }
+        @keyframes sc-breathe {
+          0%, 100% { transform: scale(1); opacity: 0.9; }
+          50% { transform: scale(1.06); opacity: 1; }
+        }
+        @keyframes sc-glow {
+          0%, 100% { opacity: 0.5; transform: scale(0.9); }
+          50% { opacity: 1; transform: scale(1.1); }
+        }
+        @keyframes sc-text-fade {
+          0% { opacity: 0.6; }
+          100% { opacity: 1; }
+        }
+        @keyframes sc-progress {
+          0% { width: 0; margin-left: 0; }
+          50% { width: 70%; margin-left: 15%; }
+          100% { width: 0; margin-left: 100%; }
+        }
+      `}</style>
+    </div>
+  )
+}
+
 export default function Home() {
   const currentUser = useAppStore((s) => s.currentUser)
   const setUser = useAppStore((s) => s.setUser)
@@ -83,26 +207,31 @@ export default function Home() {
 
   useWs('sessions', loadSessions, 5000)
 
-  // Auto-select default agent's thread on load
+  // Auto-select agent's thread on load — resolves a persisted agentId into a session,
+  // or falls back to defaultAgentId from settings, then first agent.
+  const [agentReady, setAgentReady] = useState(false)
   useEffect(() => {
     if (!authenticated || !currentUser) return
-    const state = useAppStore.getState()
-    // Only auto-select if no agent is selected yet
-    if (state.currentAgentId) return
-
-    // Load agents and select 'default' agent
     let cancelled = false
     ;(async () => {
       try {
+        const state = useAppStore.getState()
         await state.loadAgents()
         if (cancelled) return
-        const agents = useAppStore.getState().agents
-        // Try 'default' agent first, then fall back to first agent
-        const defaultAgent = agents['default'] || Object.values(agents)[0]
-        if (defaultAgent) {
-          await useAppStore.getState().setCurrentAgent(defaultAgent.id)
+
+        const { agents, currentAgentId, appSettings } = useAppStore.getState()
+        // Priority: persisted agent > settings default > first agent
+        const targetId = (currentAgentId && agents[currentAgentId])
+          ? currentAgentId
+          : (appSettings.defaultAgentId && agents[appSettings.defaultAgentId])
+            ? appSettings.defaultAgentId
+            : Object.values(agents)[0]?.id || null
+
+        if (targetId) {
+          await useAppStore.getState().setCurrentAgent(targetId)
         }
       } catch { /* ignore */ }
+      if (!cancelled) setAgentReady(true)
     })()
     return () => { cancelled = true }
   }, [authenticated, currentUser])
@@ -148,10 +277,10 @@ export default function Home() {
 
   useViewRouter()
 
-  if (!hydrated || !authChecked) return null
+  if (!hydrated || !authChecked) return <FullScreenLoader />
   if (!authenticated) return <AccessKeyGate onAuthenticated={() => setAuthenticated(true)} />
   if (!currentUser) return <UserPicker />
-  if (setupDone === null) return null
+  if (setupDone === null || !agentReady) return <FullScreenLoader />
   if (!setupDone) return <SetupWizard onComplete={() => setSetupDone(true)} />
   return <AppLayout />
 }

package/src/cli/index.js

@@ -56,6 +56,29 @@ const COMMAND_GROUPS = [
       cmd('install', 'POST', '/clawhub/install', 'Install a skill from ClawHub', { expectsJsonBody: true }),
     ],
   },
+  {
+    name: 'chatrooms',
+    description: 'Manage multi-agent chatrooms',
+    commands: [
+      cmd('list', 'GET', '/chatrooms', 'List chatrooms'),
+      cmd('get', 'GET', '/chatrooms/:id', 'Get chatroom by id'),
+      cmd('create', 'POST', '/chatrooms', 'Create a chatroom', { expectsJsonBody: true }),
+      cmd('update', 'PUT', '/chatrooms/:id', 'Update a chatroom', { expectsJsonBody: true }),
+      cmd('delete', 'DELETE', '/chatrooms/:id', 'Delete a chatroom'),
+      cmd('chat', 'POST', '/chatrooms/:id/chat', 'Post a message to a chatroom and stream agent replies', {
+        expectsJsonBody: true,
+        responseType: 'sse',
+      }),
+      cmd('add-member', 'POST', '/chatrooms/:id/members', 'Add an agent to a chatroom (use --data \'{"agentId":"..."}\')', { expectsJsonBody: true }),
+      cmd('remove-member', 'DELETE', '/chatrooms/:id/members', 'Remove an agent from a chatroom (use --data \'{"agentId":"..."}\')', { expectsJsonBody: true }),
+      cmd('react', 'POST', '/chatrooms/:id/reactions', 'Toggle a reaction on a chatroom message', {
+        expectsJsonBody: true,
+      }),
+      cmd('pin', 'POST', '/chatrooms/:id/pins', 'Toggle pin on a chatroom message', {
+        expectsJsonBody: true,
+      }),
+    ],
+  },
   {
     name: 'connectors',
     description: 'Manage chat connectors',
@@ -183,6 +206,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 +327,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',
@@ -409,6 +450,7 @@ const COMMAND_GROUPS = [
       cmd('list', 'GET', '/tasks', 'List tasks'),
       cmd('get', 'GET', '/tasks/:id', 'Get task'),
       cmd('create', 'POST', '/tasks', 'Create task', { expectsJsonBody: true }),
+      cmd('bulk', 'POST', '/tasks/bulk', 'Bulk update tasks (status/agent/project)', { expectsJsonBody: true }),
       cmd('update', 'PUT', '/tasks/:id', 'Update task', { expectsJsonBody: true }),
       cmd('delete', 'DELETE', '/tasks/:id', 'Delete task'),
       cmd('purge', 'DELETE', '/tasks', 'Bulk delete tasks', { expectsJsonBody: true }),

package/src/cli/index.test.js

@@ -81,6 +81,36 @@ test('CLI command map covers all API route method/path pairs', () => {
   assert.deepEqual(missing, [])
 })
 
+test('Binary CLI router reaches every mapped API command pair', async () => {
+  const { shouldUseLegacyTsCli, TS_CLI_ACTIONS } = await import('../../bin/swarmclaw.js')
+
+  for (const command of COMMANDS) {
+    if (command.virtual) continue
+
+    const pathArgs = extractPathParams(command.route).map((name, index) => `${name}-${index + 1}`)
+    const routedToLegacyTs = shouldUseLegacyTsCli([command.group, command.action, ...pathArgs])
+
+    if (routedToLegacyTs) {
+      assert.ok(
+        TS_CLI_ACTIONS[command.group]?.has(command.action),
+        `legacy TS router should only claim known actions (${command.group} ${command.action})`,
+      )
+    }
+  }
+
+  // Spot-check known API commands that are map-only today.
+  assert.equal(shouldUseLegacyTsCli(['chatrooms', 'list']), false)
+  assert.equal(shouldUseLegacyTsCli(['tasks', 'approve', 'task-1']), false)
+
+  // Help paths should route to mapped CLI for full command discoverability.
+  assert.equal(shouldUseLegacyTsCli([]), false)
+  assert.equal(shouldUseLegacyTsCli(['--help']), false)
+  assert.equal(shouldUseLegacyTsCli(['tasks', '--help']), false)
+
+  // And a legacy command that should remain on the richer TS path.
+  assert.equal(shouldUseLegacyTsCli(['tasks', 'create']), true)
+})
+
 test('parseArgv parses group/action/options', () => {
   const parsed = parseArgv([
     'runs',