@swarmclawai/swarmclaw 0.6.6 → 0.6.7

package/src/lib/setup-defaults.ts

@@ -0,0 +1,277 @@
+/**
+ * Shared setup defaults used by both the web wizard and CLI.
+ * Isomorphic — no 'use client', no server imports.
+ */
+
+export type SetupProvider =
+  | 'anthropic'
+  | 'openai'
+  | 'google'
+  | 'deepseek'
+  | 'groq'
+  | 'together'
+  | 'mistral'
+  | 'xai'
+  | 'fireworks'
+  | 'ollama'
+  | 'openclaw'
+
+export interface SetupProviderOption {
+  id: SetupProvider
+  name: string
+  description: string
+  requiresKey: boolean
+  supportsEndpoint: boolean
+  defaultEndpoint?: string
+  keyUrl?: string
+  keyLabel?: string
+  keyPlaceholder?: string
+  optionalKey?: boolean
+  badge?: string
+  icon: string
+}
+
+export const SETUP_PROVIDERS: SetupProviderOption[] = [
+  {
+    id: 'openai',
+    name: 'OpenAI',
+    description: 'Great default for most users. Fast, reliable GPT models.',
+    requiresKey: true,
+    supportsEndpoint: true,
+    defaultEndpoint: 'https://api.openai.com/v1',
+    keyUrl: 'https://platform.openai.com/api-keys',
+    keyLabel: 'platform.openai.com',
+    badge: 'Recommended',
+    icon: 'O',
+  },
+  {
+    id: 'anthropic',
+    name: 'Anthropic',
+    description: 'Claude models — strong for coding, analysis, and long-form reasoning.',
+    requiresKey: true,
+    supportsEndpoint: false,
+    keyUrl: 'https://console.anthropic.com/settings/keys',
+    keyLabel: 'console.anthropic.com',
+    icon: 'A',
+  },
+  {
+    id: 'google',
+    name: 'Google Gemini',
+    description: 'Gemini models with strong multimodal and coding support.',
+    requiresKey: true,
+    supportsEndpoint: false,
+    keyUrl: 'https://aistudio.google.com/app/apikey',
+    keyLabel: 'aistudio.google.com',
+    keyPlaceholder: 'AIza...',
+    icon: 'G',
+  },
+  {
+    id: 'deepseek',
+    name: 'DeepSeek',
+    description: 'High-value reasoning and coding models from DeepSeek.',
+    requiresKey: true,
+    supportsEndpoint: false,
+    keyUrl: 'https://platform.deepseek.com/api_keys',
+    keyLabel: 'platform.deepseek.com',
+    icon: 'D',
+  },
+  {
+    id: 'groq',
+    name: 'Groq',
+    description: 'Very fast inference with open and reasoning model options.',
+    requiresKey: true,
+    supportsEndpoint: false,
+    keyUrl: 'https://console.groq.com/keys',
+    keyLabel: 'console.groq.com',
+    icon: 'G',
+  },
+  {
+    id: 'together',
+    name: 'Together AI',
+    description: 'Broad catalog of open models with OpenAI-compatible APIs.',
+    requiresKey: true,
+    supportsEndpoint: false,
+    keyUrl: 'https://api.together.xyz/settings/api-keys',
+    keyLabel: 'api.together.xyz',
+    icon: 'T',
+  },
+  {
+    id: 'mistral',
+    name: 'Mistral AI',
+    description: 'Efficient frontier models with strong latency and quality.',
+    requiresKey: true,
+    supportsEndpoint: false,
+    keyUrl: 'https://console.mistral.ai/api-keys/',
+    keyLabel: 'console.mistral.ai',
+    icon: 'M',
+  },
+  {
+    id: 'xai',
+    name: 'xAI (Grok)',
+    description: 'Grok models for fast answers, coding, and analysis.',
+    requiresKey: true,
+    supportsEndpoint: false,
+    keyUrl: 'https://console.x.ai',
+    keyLabel: 'console.x.ai',
+    icon: 'X',
+  },
+  {
+    id: 'fireworks',
+    name: 'Fireworks AI',
+    description: 'Serverless and optimized open-model inference endpoints.',
+    requiresKey: true,
+    supportsEndpoint: false,
+    keyUrl: 'https://fireworks.ai/account/api-keys',
+    keyLabel: 'fireworks.ai',
+    icon: 'F',
+  },
+  {
+    id: 'openclaw',
+    name: 'OpenClaw',
+    description: 'Connect to your local or remote OpenClaw gateway (multi-OpenClaw ready).',
+    requiresKey: false,
+    supportsEndpoint: true,
+    defaultEndpoint: 'http://localhost:18789/v1',
+    optionalKey: true,
+    badge: 'OpenClaw',
+    icon: 'C',
+  },
+  {
+    id: 'ollama',
+    name: 'Ollama',
+    description: 'Run local open-source models. No API key required.',
+    requiresKey: false,
+    supportsEndpoint: true,
+    defaultEndpoint: 'http://localhost:11434',
+    badge: 'Local',
+    icon: 'L',
+  },
+]
+
+export const STARTER_AGENT_TOOLS = [
+  'memory',
+  'files',
+  'web_search',
+  'web_fetch',
+  'browser',
+  'manage_agents',
+  'manage_tasks',
+  'manage_schedules',
+  'manage_skills',
+  'manage_connectors',
+  'manage_sessions',
+  'manage_secrets',
+  'manage_documents',
+  'manage_webhooks',
+  'claude_code',
+  'codex_cli',
+  'opencode_cli',
+  'openclaw_workspace',
+]
+
+export const SWARMCLAW_ASSISTANT_PROMPT = `You are the default SwarmClaw assistant inside the SwarmClaw dashboard.
+
+Primary objective:
+- Help the user operate SwarmClaw itself before anything else.
+
+When the user asks about SwarmClaw, prioritize concrete guidance with exact UI paths and commands:
+- Sessions: create, configure provider/model, and run chats.
+- Agents: create specialist agents/orchestrators, set provider/model, tools, and prompts.
+- Providers: connect API keys/endpoints, troubleshoot auth/model issues.
+- Tasks + Schedules: queue work and automate recurring runs.
+- Skills + Connectors + Webhooks + Secrets + Memory: explain when to use each and how to configure safely.
+
+Behavior:
+- Be concise, direct, and action-oriented.
+- If the request is ambiguous, ask one focused clarifying question.
+- Prefer step-by-step instructions that can be executed immediately.
+- When the user asks for direct execution (for example browsing, screenshots, research, or file edits), use available tools and return real results instead of only describing what to do.
+- If a capability depends on provider/tool configuration, call that out explicitly.`
+
+export interface DefaultAgentConfig {
+  name: string
+  description: string
+  systemPrompt: string
+  model: string
+  tools: string[]
+}
+
+export const DEFAULT_AGENTS: Record<SetupProvider, DefaultAgentConfig> = {
+  anthropic: {
+    name: 'Claude',
+    description: 'A helpful Claude-powered assistant.',
+    systemPrompt: SWARMCLAW_ASSISTANT_PROMPT,
+    model: 'claude-sonnet-4-6',
+    tools: STARTER_AGENT_TOOLS,
+  },
+  openai: {
+    name: 'Atlas',
+    description: 'A helpful GPT-powered assistant.',
+    systemPrompt: SWARMCLAW_ASSISTANT_PROMPT,
+    model: 'gpt-4o',
+    tools: STARTER_AGENT_TOOLS,
+  },
+  google: {
+    name: 'Gemini',
+    description: 'A helpful Gemini-powered assistant.',
+    systemPrompt: SWARMCLAW_ASSISTANT_PROMPT,
+    model: 'gemini-2.5-pro',
+    tools: STARTER_AGENT_TOOLS,
+  },
+  deepseek: {
+    name: 'DeepSeek',
+    description: 'A helpful DeepSeek-powered assistant.',
+    systemPrompt: SWARMCLAW_ASSISTANT_PROMPT,
+    model: 'deepseek-chat',
+    tools: STARTER_AGENT_TOOLS,
+  },
+  groq: {
+    name: 'Bolt',
+    description: 'A low-latency assistant powered by Groq.',
+    systemPrompt: SWARMCLAW_ASSISTANT_PROMPT,
+    model: 'llama-3.3-70b-versatile',
+    tools: STARTER_AGENT_TOOLS,
+  },
+  together: {
+    name: 'Mosaic',
+    description: 'A helpful assistant powered by Together AI.',
+    systemPrompt: SWARMCLAW_ASSISTANT_PROMPT,
+    model: 'meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8',
+    tools: STARTER_AGENT_TOOLS,
+  },
+  mistral: {
+    name: 'Mistral',
+    description: 'A helpful assistant powered by Mistral.',
+    systemPrompt: SWARMCLAW_ASSISTANT_PROMPT,
+    model: 'mistral-large-latest',
+    tools: STARTER_AGENT_TOOLS,
+  },
+  xai: {
+    name: 'Grok',
+    description: 'A helpful assistant powered by xAI Grok.',
+    systemPrompt: SWARMCLAW_ASSISTANT_PROMPT,
+    model: 'grok-3',
+    tools: STARTER_AGENT_TOOLS,
+  },
+  fireworks: {
+    name: 'Spark',
+    description: 'A helpful assistant powered by Fireworks AI.',
+    systemPrompt: SWARMCLAW_ASSISTANT_PROMPT,
+    model: 'accounts/fireworks/models/deepseek-r1-0528',
+    tools: STARTER_AGENT_TOOLS,
+  },
+  ollama: {
+    name: 'Local',
+    description: 'A local assistant running through Ollama.',
+    systemPrompt: SWARMCLAW_ASSISTANT_PROMPT,
+    model: 'llama3',
+    tools: STARTER_AGENT_TOOLS,
+  },
+  openclaw: {
+    name: 'OpenClaw Operator',
+    description: 'A manager agent for talking to and coordinating OpenClaw instances.',
+    systemPrompt: 'You are an operator focused on reliable execution, clear status updates, and task completion.',
+    model: 'default',
+    tools: STARTER_AGENT_TOOLS,
+  },
+}

package/src/lib/validation/schemas.ts

@@ -0,0 +1,69 @@
+import { z } from 'zod'
+
+export const AgentCreateSchema = z.object({
+  name: z.string().min(1, 'Agent name is required'),
+  provider: z.string().min(1, 'Provider is required'),
+  description: z.string().optional().default(''),
+  systemPrompt: z.string().optional().default(''),
+  model: z.string().optional().default(''),
+  credentialId: z.string().nullable().optional().default(null),
+  apiEndpoint: z.string().nullable().optional().default(null),
+  isOrchestrator: z.boolean().optional().default(false),
+  subAgentIds: z.array(z.string()).optional().default([]),
+  tools: z.array(z.string()).optional().default([]),
+  capabilities: z.array(z.string()).optional().default([]),
+  thinkingLevel: z.string().optional(),
+  soul: z.string().optional(),
+})
+
+export const ConnectorCreateSchema = z.object({
+  name: z.string().min(1, 'Connector name is required').optional(),
+  platform: z.enum([
+    'discord', 'telegram', 'slack', 'whatsapp', 'openclaw',
+    'bluebubbles', 'signal', 'teams', 'googlechat', 'matrix', 'email',
+  ]),
+  agentId: z.string().nullable().optional().default(null),
+  chatroomId: z.string().nullable().optional().default(null),
+  credentialId: z.string().nullable().optional().default(null),
+  config: z.record(z.string(), z.string()).optional().default({}),
+  autoStart: z.boolean().optional(),
+})
+
+export const TaskCreateSchema = z.object({
+  title: z.string().min(1, 'Task title is required'),
+  description: z.string().optional().default(''),
+  status: z.string().optional(),
+  agentId: z.string().optional().default(''),
+  projectId: z.string().nullable().optional(),
+  goalContract: z.string().nullable().optional(),
+  cwd: z.string().nullable().optional(),
+  file: z.string().nullable().optional(),
+  blockedBy: z.array(z.string()).optional(),
+  blocks: z.array(z.string()).optional(),
+  tags: z.array(z.string()).optional(),
+  maxAttempts: z.number().optional(),
+  retryBackoffSec: z.number().optional(),
+  priority: z.enum(['low', 'medium', 'high', 'critical']).optional(),
+  dueAt: z.number().nullable().optional(),
+})
+
+export const ChatroomCreateSchema = z.object({
+  name: z.string().min(1, 'Chatroom name is required'),
+  agentIds: z.array(z.string()).default([]),
+  description: z.string().optional().default(''),
+  chatMode: z.enum(['sequential', 'parallel']).optional(),
+  autoAddress: z.boolean().optional(),
+  routingRules: z.array(z.object({
+    id: z.string(),
+    type: z.enum(['keyword', 'capability']),
+    pattern: z.string().optional(),
+    keywords: z.array(z.string()).optional(),
+    agentId: z.string(),
+    priority: z.number(),
+  })).optional(),
+})
+
+/** Format ZodError into a 400-friendly payload */
+export function formatZodError(err: z.ZodError) {
+  return { error: 'Validation failed', issues: err.issues.map((i) => ({ path: i.path.join('.'), message: i.message })) }
+}

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

@@ -68,6 +68,8 @@ interface AppState {
   setScheduleSheetOpen: (open: boolean) => void
   editingScheduleId: string | null
   setEditingScheduleId: (id: string | null) => void
+  scheduleTemplatePrefill: { name: string; taskPrompt: string; scheduleType: 'cron' | 'interval'; cron?: string; intervalMs?: number } | null
+  setScheduleTemplatePrefill: (prefill: { name: string; taskPrompt: string; scheduleType: 'cron' | 'interval'; cron?: string; intervalMs?: number } | null) => void
 
   memorySheetOpen: boolean
   setMemorySheetOpen: (open: boolean) => void
@@ -382,6 +384,8 @@ export const useAppStore = create<AppState>((set, get) => ({
   setScheduleSheetOpen: (open) => set({ scheduleSheetOpen: open }),
   editingScheduleId: null,
   setEditingScheduleId: (id) => set({ editingScheduleId: id }),
+  scheduleTemplatePrefill: null,
+  setScheduleTemplatePrefill: (prefill) => set({ scheduleTemplatePrefill: prefill }),
 
   memorySheetOpen: false,
   setMemorySheetOpen: (open) => set({ memorySheetOpen: open }),
@@ -608,9 +612,9 @@ export const useAppStore = create<AppState>((set, get) => ({
   inspectorTab: 'overview',
   setInspectorTab: (tab) => set({ inspectorTab: tab }),
 
-  // Fleet sidebar filter
-  fleetFilter: 'all',
-  setFleetFilter: (filter) => set({ fleetFilter: filter }),
+  // Fleet sidebar filter (persisted to localStorage)
+  fleetFilter: (safeStorageGet('sc_fleet_filter') as FleetFilter) || 'all',
+  setFleetFilter: (filter) => { safeStorageSet('sc_fleet_filter', filter); set({ fleetFilter: filter }) },
 
   // Chat list filter
   chatFilter: 'all' as const,

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

@@ -2,7 +2,7 @@
 
 import { create } from 'zustand'
 import { api, getStoredAccessKey } from '@/lib/api-client'
-import type { Chatroom, ChatroomMessage, SSEEvent } from '@/types'
+import type { Chatroom, ChatroomMessage, ChatroomRoutingRule, SSEEvent } from '@/types'
 import type { PendingFile } from '@/stores/use-chat-store'
 
 interface ToolEvent {
@@ -37,7 +37,7 @@ interface ChatroomState {
   setReplyingTo: (msg: ChatroomMessage | null) => void
 
   loadChatrooms: () => Promise<void>
-  createChatroom: (data: { name: string; description?: string; agentIds?: string[]; chatMode?: 'sequential' | 'parallel'; autoAddress?: boolean }) => Promise<Chatroom>
+  createChatroom: (data: { name: string; description?: string; agentIds?: string[]; chatMode?: 'sequential' | 'parallel'; autoAddress?: boolean; routingRules?: ChatroomRoutingRule[] }) => Promise<Chatroom>
   updateChatroom: (id: string, data: Partial<Chatroom>) => Promise<void>
   deleteChatroom: (id: string) => Promise<void>
   setCurrentChatroom: (id: string | null) => void
@@ -48,6 +48,12 @@ interface ChatroomState {
   removeMember: (agentId: string) => Promise<void>
   setChatroomSheetOpen: (open: boolean) => void
   setEditingChatroomId: (id: string | null) => void
+
+  // Moderation
+  deleteMessage: (messageId: string, targetAgentId: string) => Promise<void>
+  muteAgent: (targetAgentId: string, minutes?: number) => Promise<void>
+  unmuteAgent: (targetAgentId: string) => Promise<void>
+  setMemberRole: (targetAgentId: string, role: 'admin' | 'moderator' | 'member') => Promise<void>
 }
 
 export const useChatroomStore = create<ChatroomState>((set, get) => ({
@@ -273,4 +279,48 @@ export const useChatroomStore = create<ChatroomState>((set, get) => ({
 
   setChatroomSheetOpen: (open) => set({ chatroomSheetOpen: open }),
   setEditingChatroomId: (id) => set({ editingChatroomId: id }),
+
+  // Moderation
+  deleteMessage: async (messageId, targetAgentId) => {
+    const { currentChatroomId } = get()
+    if (!currentChatroomId) return
+    const chatroom = await api<Chatroom>('POST', `/chatrooms/${currentChatroomId}/moderate`, {
+      action: 'delete-message',
+      targetAgentId,
+      messageId,
+    })
+    set((s) => ({ chatrooms: { ...s.chatrooms, [currentChatroomId]: chatroom } }))
+  },
+
+  muteAgent: async (targetAgentId, minutes = 30) => {
+    const { currentChatroomId } = get()
+    if (!currentChatroomId) return
+    const chatroom = await api<Chatroom>('POST', `/chatrooms/${currentChatroomId}/moderate`, {
+      action: 'mute',
+      targetAgentId,
+      muteDurationMinutes: minutes,
+    })
+    set((s) => ({ chatrooms: { ...s.chatrooms, [currentChatroomId]: chatroom } }))
+  },
+
+  unmuteAgent: async (targetAgentId) => {
+    const { currentChatroomId } = get()
+    if (!currentChatroomId) return
+    const chatroom = await api<Chatroom>('POST', `/chatrooms/${currentChatroomId}/moderate`, {
+      action: 'unmute',
+      targetAgentId,
+    })
+    set((s) => ({ chatrooms: { ...s.chatrooms, [currentChatroomId]: chatroom } }))
+  },
+
+  setMemberRole: async (targetAgentId, role) => {
+    const { currentChatroomId } = get()
+    if (!currentChatroomId) return
+    const chatroom = await api<Chatroom>('POST', `/chatrooms/${currentChatroomId}/moderate`, {
+      action: 'set-role',
+      targetAgentId,
+      role,
+    })
+    set((s) => ({ chatrooms: { ...s.chatrooms, [currentChatroomId]: chatroom } }))
+  },
 }))

package/src/types/index.ts

@@ -272,6 +272,10 @@ export interface Agent {
   openclawSkillMode?: SkillAllowlistMode
   openclawAllowedSkills?: string[]
   walletId?: string | null
+  monthlyBudget?: number | null
+  budgetAction?: 'warn' | 'block'
+  /** Runtime-enriched: current month's spend. Populated by GET /api/agents when monthlyBudget is set. */
+  monthlySpend?: number
   createdAt: number
   updatedAt: number
 }
@@ -408,6 +412,21 @@ export type AppView = 'home' | 'agents' | 'chatrooms' | 'schedules' | 'memory' |
 
 // --- Chatrooms ---
 
+export interface ChatroomRoutingRule {
+  id: string
+  type: 'keyword' | 'capability'
+  pattern?: string
+  keywords?: string[]
+  agentId: string
+  priority: number
+}
+
+export interface ChatroomMember {
+  agentId: string
+  role: 'admin' | 'moderator' | 'member'
+  mutedUntil?: string
+}
+
 export interface ChatroomReaction {
   emoji: string
   reactorId: string   // 'user' or agentId
@@ -435,10 +454,12 @@ export interface Chatroom {
   name: string
   description?: string
   agentIds: string[]
+  members?: ChatroomMember[]
   messages: ChatroomMessage[]
   pinnedMessageIds?: string[]
   chatMode?: 'sequential' | 'parallel'
   autoAddress?: boolean
+  routingRules?: ChatroomRoutingRule[]
   createdAt: number
   updatedAt: number
 }
@@ -626,6 +647,10 @@ export interface AppSettings {
   openclawWorkspacePath?: string | null
   openclawAutoSyncMemory?: boolean
   openclawAutoSyncSchedules?: boolean
+  // Outbound ops alert webhook
+  alertWebhookUrl?: string | null
+  alertWebhookType?: 'discord' | 'slack' | 'custom' | null
+  alertWebhookEvents?: ('error' | 'warning')[]
 }
 
 // --- Orchestrator Secrets ---
@@ -685,9 +710,21 @@ export interface Skill {
   updatedAt: number
 }
 
+// --- Connector Health Events ---
+
+export type ConnectorHealthEventType = 'started' | 'stopped' | 'error' | 'reconnected' | 'disconnected'
+
+export interface ConnectorHealthEvent {
+  id: string
+  connectorId: string
+  event: ConnectorHealthEventType
+  message?: string
+  timestamp: string
+}
+
 // --- Connectors (Chat Platform Bridges) ---
 
-export type ConnectorPlatform = 'discord' | 'telegram' | 'slack' | 'whatsapp' | 'openclaw' | 'bluebubbles' | 'signal' | 'teams' | 'googlechat' | 'matrix'
+export type ConnectorPlatform = 'discord' | 'telegram' | 'slack' | 'whatsapp' | 'openclaw' | 'bluebubbles' | 'signal' | 'teams' | 'googlechat' | 'matrix' | 'email'
 export type ConnectorStatus = 'stopped' | 'running' | 'error'
 
 export interface MessageSource {

package/tsconfig.json

@@ -38,6 +38,7 @@
     ".next/dev/dev/types/**/*.ts"
   ],
   "exclude": [
-    "node_modules"
+    "node_modules",
+    "src/cli"
   ]
 }