@swarmclawai/swarmclaw 0.6.7 → 0.7.0

package/src/lib/tool-definitions.ts

@@ -4,39 +4,39 @@ export interface ToolDefinition {
   description: string
 }
 
+/** 
+ * Standard dynamic tools. 
+ * Many granular tools (read_file, write_file, etc.) are now unified under 'files'.
+ */
 export const AVAILABLE_TOOLS: ToolDefinition[] = [
-  { id: 'shell', label: 'Shell', description: 'Execute commands in the working directory' },
-  { id: 'files', label: 'Files', description: 'Read, write, list, move, copy, and send files' },
-  { id: 'copy_file', label: 'Copy File', description: 'Copy files within the working directory' },
-  { id: 'move_file', label: 'Move File', description: 'Move/rename files within the working directory' },
-  { id: 'delete_file', label: 'Delete File', description: 'Delete files/directories (disabled by default)' },
-  { id: 'edit_file', label: 'Edit File', description: 'Search-and-replace editing within files' },
-  { id: 'process', label: 'Process', description: 'Monitor and control long-running shell commands' },
-  { id: 'web_search', label: 'Web Search', description: 'Search the web via DuckDuckGo' },
-  { id: 'web_fetch', label: 'Web Fetch', description: 'Fetch and extract text from URLs' },
-  { id: 'claude_code', label: 'Claude Code', description: 'Delegate complex tasks to Claude Code CLI' },
-  { id: 'codex_cli', label: 'Codex CLI', description: 'Delegate complex tasks to OpenAI Codex CLI' },
-  { id: 'opencode_cli', label: 'OpenCode CLI', description: 'Delegate complex tasks to OpenCode CLI' },
+  { id: 'shell', label: 'Shell', description: 'Execute commands in the working directory and manage background processes' },
+  { id: 'files', label: 'Files', description: 'Complete file management: read, write, list, move, copy, delete, and send' },
+  { id: 'edit_file', label: 'Edit File', description: 'Surgical search-and-replace within files' },
+  { id: 'web', label: 'Web', description: 'Search the web via DuckDuckGo and fetch text from URLs' },
+  { id: 'delegate', label: 'Delegate', description: 'Delegate complex tasks to specialized backends (Claude Code, Codex, OpenCode)' },
   { id: 'browser', label: 'Browser', description: 'Playwright — browse, scrape, interact with web pages' },
   { id: 'memory', label: 'Memory', description: 'Store and retrieve long-term memories across conversations' },
-  { id: 'sandbox', label: 'Sandbox', description: 'Run JS/TS/Python code in an isolated Deno sandbox' },
+  { id: 'sandbox', label: 'Sandbox', description: 'Secure isolated code execution for JS, TS, and Python' },
   { 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: 'http_request', label: 'HTTP Request', description: 'Make direct HTTP API calls with custom methods, headers, and bodies' },
   { id: 'git', label: 'Git', description: 'Run structured git operations (status, commit, push, diff, etc.)' },
   { id: 'wallet', label: 'Wallet', description: 'Manage agent crypto wallet — check balance, send SOL, view transactions' },
+  { id: 'monitor', label: 'Monitor', description: 'System observability: check resource usage, watch logs, and ping endpoints' },
+  { id: 'plugin_creator', label: 'Plugin Creator', description: 'Design, write, and test custom SwarmClaw plugins dynamically' },
+  { id: 'sample_ui', label: 'Sample UI', description: 'Demonstration of dynamic UI injection into Sidebar and Chat Header' },
 ]
 
+/**
+ * Platform capability tools.
+ * Granular CRUD tools are now unified under 'manage_platform'.
+ */
 export const PLATFORM_TOOLS: ToolDefinition[] = [
-  { id: 'manage_agents', label: 'Agents', description: 'Create, edit, and delete agents' },
-  { id: 'manage_tasks', label: 'Tasks', description: 'Create, edit, and delete tasks' },
-  { id: 'manage_schedules', label: 'Schedules', description: 'Create, edit, and delete schedules' },
-  { id: 'manage_skills', label: 'Skills', description: 'Create, edit, and delete skills' },
-  { id: 'manage_documents', label: 'Documents', description: 'Upload, search, and delete indexed documents' },
-  { id: 'manage_webhooks', label: 'Webhooks', description: 'Register webhooks that trigger agent workflows' },
-  { id: 'manage_connectors', label: 'Connectors', description: 'Create, edit, and delete connectors' },
-  { id: 'manage_sessions', label: 'Chats', description: 'List chats, send messages, and spawn agent work' },
-  { id: 'manage_secrets', label: 'Secrets', description: 'Store and retrieve encrypted service secrets' },
+  { id: 'manage_platform', label: 'Platform', description: 'Unified management of agents, tasks, schedules, skills, documents, and secrets' },
+  { id: 'manage_connectors', label: 'Connectors', description: 'Manage chat platform bridges and send outbound messages' },
+  { id: 'manage_chatrooms', label: 'Chatrooms', description: 'Manage SwarmClaw routing rules and multi-agent chatrooms' },
+  { id: 'delegate_to_agent', label: 'Assign Agent', description: 'Delegate a task to another specific agent' },
+  { id: 'schedule_wake', label: 'Reminders', description: 'Schedule a proactive wake event in the current chat' },
 ]
 
 export const ALL_TOOLS: ToolDefinition[] = [...AVAILABLE_TOOLS, ...PLATFORM_TOOLS]
@@ -45,3 +45,4 @@ export const ALL_TOOLS: ToolDefinition[] = [...AVAILABLE_TOOLS, ...PLATFORM_TOOL
 export const TOOL_LABELS: Record<string, string> = Object.fromEntries(
   ALL_TOOLS.map((t) => [t.id, t.label]),
 )
+

package/src/lib/validation/schemas.ts

@@ -14,6 +14,11 @@ export const AgentCreateSchema = z.object({
   capabilities: z.array(z.string()).optional().default([]),
   thinkingLevel: z.string().optional(),
   soul: z.string().optional(),
+  autoRecovery: z.boolean().optional().default(false),
+  monthlyBudget: z.number().positive().nullable().optional().default(null),
+  dailyBudget: z.number().positive().nullable().optional().default(null),
+  hourlyBudget: z.number().positive().nullable().optional().default(null),
+  budgetAction: z.enum(['warn', 'block']).optional().default('warn'),
 })
 
 export const ConnectorCreateSchema = z.object({
@@ -45,6 +50,14 @@ export const TaskCreateSchema = z.object({
   retryBackoffSec: z.number().optional(),
   priority: z.enum(['low', 'medium', 'high', 'critical']).optional(),
   dueAt: z.number().nullable().optional(),
+  qualityGate: z.object({
+    enabled: z.boolean().optional(),
+    minResultChars: z.number().optional(),
+    minEvidenceItems: z.number().optional(),
+    requireVerification: z.boolean().optional(),
+    requireArtifact: z.boolean().optional(),
+    requireReport: z.boolean().optional(),
+  }).nullable().optional(),
 })
 
 export const ChatroomCreateSchema = z.object({

package/src/lib/view-routes.ts

@@ -1,30 +1,9 @@
 import type { AppView } from '@/types'
+import { VIEW_ROUTE_PATHS } from '../../view-route-paths'
 
 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',
-  secrets: '/secrets',
-  providers: '/providers',
-  skills: '/skills',
-  connectors: '/connectors',
-  webhooks: '/webhooks',
-  mcp_servers: '/mcp-servers',
-  knowledge: '/knowledge',
-  plugins: '/plugins',
-  usage: '/usage',
-  wallets: '/wallets',
-  runs: '/runs',
-  logs: '/logs',
-  settings: '/settings',
-  projects: '/projects',
-  activity: '/activity',
-}
+export const VIEW_TO_PATH: Record<AppView, string> = VIEW_ROUTE_PATHS
 
 const entries = Object.entries(VIEW_TO_PATH) as [AppView, string][]
 export const PATH_TO_VIEW: Record<string, AppView> = Object.fromEntries(

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

@@ -1,7 +1,7 @@
 'use client'
 
 import { create } from 'zustand'
-import type { Sessions, Session, NetworkInfo, Directory, ProviderInfo, Credentials, Agent, Schedule, AppView, BoardTask, AppSettings, OrchestratorSecret, ProviderConfig, Skill, Connector, Webhook, McpServerConfig, PluginMeta, Project, FleetFilter, ActivityEntry, AppNotification } from '../types'
+import type { Sessions, Session, NetworkInfo, Directory, ProviderInfo, Credentials, Agent, Schedule, AppView, BoardTask, AppSettings, OrchestratorSecret, ProviderConfig, Skill, Connector, Webhook, McpServerConfig, PluginMeta, Project, FleetFilter, ActivityEntry, AppNotification, ApprovalRequest } from '../types'
 import { fetchSessions, fetchDirs, fetchProviders, fetchCredentials } from '../lib/sessions'
 import { fetchAgents } from '../lib/agents'
 import { fetchSchedules } from '../lib/schedules'
@@ -198,6 +198,11 @@ interface AppState {
   lastReadTimestamps: Record<string, number>
   markChatRead: (id: string) => void
 
+  // Approvals
+  approvals: Record<string, ApprovalRequest>
+  loadApprovals: () => Promise<void>
+  submitApprovalDecision: (id: string, approved: boolean) => Promise<void>
+
   // Notifications
   notifications: AppNotification[]
   unreadNotificationCount: number
@@ -643,6 +648,23 @@ export const useAppStore = create<AppState>((set, get) => ({
     safeStorageSet('sc_last_read', JSON.stringify(ts))
   },
 
+  // Approvals
+  approvals: {},
+  loadApprovals: async () => {
+    try {
+      const list = await api<ApprovalRequest[]>('GET', '/approvals')
+      const approvals: Record<string, ApprovalRequest> = {}
+      for (const a of list) approvals[a.id] = a
+      set({ approvals })
+    } catch { /* ignore */ }
+  },
+  submitApprovalDecision: async (id, approved) => {
+    try {
+      await api('POST', '/approvals', { id, approved })
+      await get().loadApprovals()
+    } catch { /* ignore */ }
+  },
+
   // Notifications
   notifications: [],
   unreadNotificationCount: 0,

package/src/types/index.ts

@@ -14,12 +14,14 @@ export interface Message {
   attachedFiles?: string[]
   toolEvents?: MessageToolEvent[]
   thinking?: string
-  kind?: 'chat' | 'heartbeat' | 'system' | 'context-clear'
+  kind?: 'chat' | 'heartbeat' | 'system' | 'context-clear' | 'plugin-ui'
   suppressed?: boolean
   bookmarked?: boolean
   suggestions?: string[]
   replyToId?: string
   source?: MessageSource
+  /** True while the message is still being streamed — cleared on final persist. */
+  streaming?: boolean
 }
 
 export type ProviderType = 'claude-cli' | 'codex-cli' | 'opencode-cli' | 'openai' | 'ollama' | 'anthropic' | 'openclaw' | 'google' | 'deepseek' | 'groq' | 'together' | 'mistral' | 'xai' | 'fireworks'
@@ -75,6 +77,8 @@ export interface Session {
   heartbeatIntervalSec?: number | null
   heartbeatTarget?: 'last' | 'none' | string | null
   lastAutoMemoryAt?: number | null
+  lastHeartbeatText?: string | null
+  lastHeartbeatSentAt?: number | null
   mainLoopState?: {
     goal?: string | null
     goalContract?: GoalContract | null
@@ -102,6 +106,8 @@ export interface Session {
       note: string
       status?: 'idle' | 'progress' | 'blocked' | 'ok'
     }>
+    missionTokens?: number
+    missionCostUsd?: number
     followupChainCount?: number
     metaMissCount?: number
     workingMemoryNotes?: string[]
@@ -116,6 +122,11 @@ export interface Session {
   queuedCount?: number
   currentRunId?: string | null
   conversationTone?: string
+  emoji?: string
+  creature?: string
+  vibe?: string
+  theme?: string
+  avatar?: string
   canvasContent?: string | null
 }
 
@@ -136,7 +147,25 @@ export type SessionTool =
   | 'http_request'
   | 'git'
 
-// --- Cost Tracking ---
+// --- Approvals ---
+
+export type ApprovalCategory = 'tool_access' | 'wallet_transfer' | 'plugin_scaffold' | 'plugin_install' | 'task_tool'
+
+export interface ApprovalRequest {
+  id: string
+  category: ApprovalCategory
+  agentId?: string | null
+  sessionId?: string | null
+  taskId?: string | null
+  title: string
+  description?: string
+  data: Record<string, unknown>
+  createdAt: number
+  updatedAt: number
+  status: 'pending' | 'approved' | 'rejected'
+}
+
+export type Approvals = Record<string, ApprovalRequest>
 
 export interface UsageRecord {
   sessionId: string
@@ -148,6 +177,7 @@ export interface UsageRecord {
   totalTokens: number
   estimatedCost: number
   timestamp: number
+  durationMs?: number
 }
 
 // --- Plugin System ---
@@ -155,15 +185,78 @@ export interface UsageRecord {
 export interface PluginHooks {
   beforeAgentStart?: (ctx: { session: Session; message: string }) => Promise<void> | void
   afterAgentComplete?: (ctx: { session: Session; response: string }) => Promise<void> | void
-  beforeToolExec?: (ctx: { toolName: string; input: any }) => Promise<any> | any
-  afterToolExec?: (ctx: { toolName: string; input: any; output: string }) => Promise<void> | void
+  beforeToolExec?: (ctx: { toolName: string; input: Record<string, unknown> | null }) => Promise<Record<string, unknown> | void> | Record<string, unknown> | void
+  afterToolExec?: (ctx: { toolName: string; input: Record<string, unknown> | null; output: string }) => Promise<void> | void
   onMessage?: (ctx: { session: Session; message: Message }) => Promise<void> | void
+
+  // Orchestration & Swarm Hooks
+  onTaskComplete?: (ctx: { taskId: string; result: unknown }) => Promise<void> | void
+  onAgentDelegation?: (ctx: { sourceAgentId: string; targetAgentId: string; task: string }) => Promise<void> | void
+
+  // Chat Middleware (Transform messages)
+  transformInboundMessage?: (ctx: { session: Session; text: string }) => Promise<string> | string
+  transformOutboundMessage?: (ctx: { session: Session; text: string }) => Promise<string> | string
+}
+
+export interface PluginToolDef {
+  name: string
+  description: string
+  parameters: Record<string, unknown>
+  execute: (args: Record<string, unknown>, ctx: { session: Session; message: string }) => Promise<string | object> | string | object
+}
+
+export interface PluginUIExtension {
+  sidebarItems?: Array<{
+    id: string
+    label: string
+    icon?: string
+    href: string
+    position?: 'top' | 'bottom'
+  }>
+  headerWidgets?: Array<{
+    id: string
+    label: string
+    icon?: string
+  }>
+  chatInputActions?: Array<{
+    id: string
+    label: string
+    icon?: string
+    tooltip?: string
+    action: 'message' | 'link' | 'tool'
+    value: string
+  }>
+}
+
+export interface PluginProviderExtension {
+  id: string
+  name: string
+  models: string[]
+  requiresApiKey: boolean
+  requiresEndpoint: boolean
+  defaultEndpoint?: string
+  streamChat: (opts: any) => Promise<string>
+}
+
+export interface PluginConnectorExtension {
+  id: string
+  name: string
+  description: string
+  // For sending outbound
+  sendMessage?: (params: any) => Promise<any>
+  // For polling/listening
+  startListener?: (onMessage: (msg: any) => void) => Promise<() => void>
 }
 
 export interface Plugin {
   name: string
+  version?: string
   description?: string
-  hooks: PluginHooks
+  hooks?: PluginHooks
+  tools?: PluginToolDef[]
+  ui?: PluginUIExtension
+  providers?: PluginProviderExtension[]
+  connectors?: PluginConnectorExtension[]
 }
 
 export interface PluginMeta {
@@ -175,8 +268,18 @@ export interface PluginMeta {
   version?: string
   source?: 'local' | 'marketplace'
   openclaw?: boolean
+  failureCount?: number
+  lastFailureAt?: number
+  lastFailureStage?: string
+  lastFailureError?: string
+  autoDisabled?: boolean
+  toolCount?: number
+  hookCount?: number
+  hasUI?: boolean
+  providerCount?: number
+  connectorCount?: number
+  createdByAgentId?: string | null
 }
-
 export interface MarketplacePlugin {
   id: string
   name: string
@@ -184,9 +287,10 @@ export interface MarketplacePlugin {
   author: string
   version: string
   url: string
-  tags: string[]
-  openclaw: boolean
-  downloads: number
+  source?: 'swarmclaw' | 'clawhub'
+  tags?: string[]
+  openclaw?: boolean
+  downloads?: number
 }
 
 export interface SSEEvent {
@@ -233,6 +337,11 @@ export interface Agent {
   name: string
   description: string
   soul?: string
+  emoji?: string
+  creature?: string
+  vibe?: string
+  theme?: string
+  avatar?: string
   systemPrompt: string
   provider: ProviderType
   model: string
@@ -273,9 +382,18 @@ export interface Agent {
   openclawAllowedSkills?: string[]
   walletId?: string | null
   monthlyBudget?: number | null
+  dailyBudget?: number | null
+  hourlyBudget?: number | null
+  autoRecovery?: boolean
+
   budgetAction?: 'warn' | 'block'
   /** Runtime-enriched: current month's spend. Populated by GET /api/agents when monthlyBudget is set. */
   monthlySpend?: number
+  /** Runtime-enriched: current day's spend. Populated by GET /api/agents when dailyBudget is set. */
+  dailySpend?: number
+  /** Runtime-enriched: trailing 1-hour spend. Populated by GET /api/agents when hourlyBudget is set. */
+  hourlySpend?: number
+  maxFollowupChain?: number
   createdAt: number
   updatedAt: number
 }
@@ -408,7 +526,7 @@ export interface MemoryEntry {
 }
 
 export type SessionType = 'human' | 'orchestrated'
-export type AppView = 'home' | 'agents' | 'chatrooms' | 'schedules' | 'memory' | 'tasks' | 'secrets' | 'providers' | 'skills' | 'connectors' | 'webhooks' | 'mcp_servers' | 'knowledge' | 'plugins' | 'usage' | 'wallets' | 'runs' | 'logs' | 'settings' | 'projects' | 'activity'
+export type AppView = 'home' | 'agents' | 'chatrooms' | 'schedules' | 'memory' | 'tasks' | 'approvals' | 'secrets' | 'providers' | 'skills' | 'connectors' | 'webhooks' | 'mcp_servers' | 'knowledge' | 'plugins' | 'usage' | 'wallets' | 'runs' | 'logs' | 'settings' | 'projects' | 'activity'
 
 // --- Chatrooms ---
 
@@ -579,8 +697,10 @@ export interface AppSettings {
   agentLoopRecursionLimit?: number
   orchestratorLoopRecursionLimit?: number
   legacyOrchestratorMaxTurns?: number
+  delegationMaxDepth?: number
   ongoingLoopMaxIterations?: number
   ongoingLoopMaxRuntimeMinutes?: number
+  maxFollowupChain?: number
   shellCommandTimeoutSec?: number
   claudeCodeTimeoutSec?: number
   cliProcessTimeoutSec?: number
@@ -651,6 +771,19 @@ export interface AppSettings {
   alertWebhookUrl?: string | null
   alertWebhookType?: 'discord' | 'slack' | 'custom' | null
   alertWebhookEvents?: ('error' | 'warning')[]
+  // Deterministic LLM response cache
+  responseCacheEnabled?: boolean
+  responseCacheTtlSec?: number
+  responseCacheMaxEntries?: number
+  // Task quality gate defaults
+  taskQualityGateEnabled?: boolean
+  taskQualityGateMinResultChars?: number
+  taskQualityGateMinEvidenceItems?: number
+  taskQualityGateRequireVerification?: boolean
+  taskQualityGateRequireArtifact?: boolean
+  taskQualityGateRequireReport?: boolean
+  // Integrity monitor
+  integrityMonitorEnabled?: boolean
 }
 
 // --- Orchestrator Secrets ---
@@ -678,6 +811,15 @@ export interface TaskComment {
   createdAt: number
 }
 
+export interface TaskQualityGateConfig {
+  enabled?: boolean
+  minResultChars?: number
+  minEvidenceItems?: number
+  requireVerification?: boolean
+  requireArtifact?: boolean
+  requireReport?: boolean
+}
+
 // --- Custom Providers ---
 
 export interface ProviderConfig {
@@ -809,6 +951,8 @@ export interface BoardTask {
   createdByAgentId?: string | null
   createdInSessionId?: string | null
   delegatedByAgentId?: string | null
+  delegatedFromTaskId?: string | null
+  delegationDepth?: number | null
   createdAt: number
   updatedAt: number
   queuedAt?: number | null
@@ -862,6 +1006,7 @@ export interface BoardTask {
   priority?: 'low' | 'medium' | 'high' | 'critical'
   // Dedup fingerprint
   fingerprint?: string
+  qualityGate?: TaskQualityGateConfig | null
 }
 
 // --- MCP Servers ---