@swarmclawai/swarmclaw 0.9.7 → 0.9.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "0.9.7",
+  "version": "0.9.9",
   "description": "Self-hosted AI agent orchestration dashboard — manage LLM providers, orchestrate agent swarms, schedule tasks, and bridge agents to chat platforms.",
   "license": "MIT",
   "publishConfig": {
@@ -75,9 +75,9 @@
     "@huggingface/transformers": "^3.8.1",
     "@langchain/anthropic": "^1.3.18",
     "@langchain/core": "^1.1.31",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "@langchain/langgraph": "^1.2.2",
     "@langchain/openai": "^1.2.8",
-    "@modelcontextprotocol/sdk": "^1.27.1",
     "@multiavatar/multiavatar": "^1.0.7",
     "@playwright/mcp": "^0.0.68",
     "@slack/bolt": "^4.6.0",

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

@@ -104,6 +104,8 @@ export function ScheduleSheet() {
   const [cron, setCron] = useState('0 * * * *')
   const [intervalMs, setIntervalMs] = useState(3600000)
   const [status, setStatus] = useState<ScheduleStatus>('active')
+  const [taskMode, setTaskMode] = useState<'task' | 'wake_only'>('task')
+  const [message, setMessage] = useState('')
   const [customCron, setCustomCron] = useState(false)
   const [confirmDelete, setConfirmDelete] = useState(false)
   const [deleting, setDeleting] = useState(false)
@@ -131,6 +133,8 @@ export function ScheduleSheet() {
         setCron(editing.cron || '0 * * * *')
         setIntervalMs(editing.intervalMs || 3600000)
         setStatus(editing.status)
+        setTaskMode(editing.taskMode === 'wake_only' ? 'wake_only' : 'task')
+        setMessage(editing.message || '')
         setCustomCron(!CRON_PRESETS.some((p) => p.cron === editing.cron))
       } else if (templatePrefill) {
         // Opened from a quick-start card with pre-filled values
@@ -155,6 +159,8 @@ export function ScheduleSheet() {
         setCron('0 * * * *')
         setIntervalMs(3600000)
         setStatus('active')
+        setTaskMode('task')
+        setMessage('')
         setCustomCron(false)
       }
     }
@@ -178,7 +184,9 @@ export function ScheduleSheet() {
     const data = {
       name: name.trim(),
       agentId,
-      taskPrompt,
+      taskPrompt: taskMode === 'wake_only' ? message : taskPrompt,
+      taskMode,
+      message: taskMode === 'wake_only' ? message : undefined,
       scheduleType,
       cron: scheduleType === 'cron' ? cron : undefined,
       intervalMs: scheduleType === 'interval' ? intervalMs : undefined,
@@ -217,7 +225,7 @@ export function ScheduleSheet() {
   }
 
   // Step validation
-  const step0Valid = name.trim().length > 0 && agentId.length > 0 && taskPrompt.trim().length > 0
+  const step0Valid = name.trim().length > 0 && agentId.length > 0 && (taskMode === 'wake_only' ? message.trim().length > 0 : taskPrompt.trim().length > 0)
   const step1Valid = scheduleType === 'cron' ? cron.trim().length > 0 : intervalMs > 0
 
   const selectedAgent = agentId ? agents[agentId] : null
@@ -333,16 +341,61 @@ export function ScheduleSheet() {
           </div>
 
           <div className="mb-8">
-            <SectionLabel>Task Prompt</SectionLabel>
-            <textarea
-              value={taskPrompt}
-              onChange={(e) => setTaskPrompt(e.target.value)}
-              placeholder="What should the agent do when triggered?"
-              rows={4}
-              className={`${inputClass} resize-y min-h-[100px]`}
-              style={{ fontFamily: 'inherit' }}
-            />
+            <div className="flex items-center gap-2 mb-3">
+              <SectionLabel className="mb-0">Task Mode</SectionLabel>
+              <HintTip text="Create task: creates a board task for the agent. Wake agent only: sends a message to the agent without creating a task." />
+            </div>
+            <div className="grid grid-cols-2 gap-3">
+              <button
+                onClick={() => setTaskMode('task')}
+                className={`py-3 px-4 rounded-[14px] text-center cursor-pointer transition-all duration-200
+                  active:scale-[0.97] text-[14px] font-600 border
+                  ${taskMode === 'task'
+                    ? 'bg-accent-soft border-accent-bright/25 text-accent-bright'
+                    : 'bg-surface border-white/[0.06] text-text-2 hover:bg-surface-2'}`}
+                style={{ fontFamily: 'inherit' }}
+              >
+                Create task
+              </button>
+              <button
+                onClick={() => setTaskMode('wake_only')}
+                className={`py-3 px-4 rounded-[14px] text-center cursor-pointer transition-all duration-200
+                  active:scale-[0.97] text-[14px] font-600 border
+                  ${taskMode === 'wake_only'
+                    ? 'bg-accent-soft border-accent-bright/25 text-accent-bright'
+                    : 'bg-surface border-white/[0.06] text-text-2 hover:bg-surface-2'}`}
+                style={{ fontFamily: 'inherit' }}
+              >
+                Wake agent only
+              </button>
+            </div>
           </div>
+
+          {taskMode === 'wake_only' ? (
+            <div className="mb-8">
+              <SectionLabel>Wake Message</SectionLabel>
+              <textarea
+                value={message}
+                onChange={(e) => setMessage(e.target.value)}
+                placeholder="Message to send to the agent when woken"
+                rows={4}
+                className={`${inputClass} resize-y min-h-[100px]`}
+                style={{ fontFamily: 'inherit' }}
+              />
+            </div>
+          ) : (
+            <div className="mb-8">
+              <SectionLabel>Task Prompt</SectionLabel>
+              <textarea
+                value={taskPrompt}
+                onChange={(e) => setTaskPrompt(e.target.value)}
+                placeholder="What should the agent do when triggered?"
+                rows={4}
+                className={`${inputClass} resize-y min-h-[100px]`}
+                style={{ fontFamily: 'inherit' }}
+              />
+            </div>
+          )}
         </div>
       )}
 
@@ -498,8 +551,12 @@ export function ScheduleSheet() {
               </div>
             )}
             <div>
-              <span className="text-[11px] text-text-3/50 uppercase tracking-wider font-600">Task</span>
-              <div className="text-[13px] text-text-2 mt-0.5 whitespace-pre-wrap">{taskPrompt}</div>
+              <span className="text-[11px] text-text-3/50 uppercase tracking-wider font-600">Mode</span>
+              <div className="text-[14px] text-text font-600 mt-0.5">{taskMode === 'wake_only' ? 'Wake agent only' : 'Create task'}</div>
+            </div>
+            <div>
+              <span className="text-[11px] text-text-3/50 uppercase tracking-wider font-600">{taskMode === 'wake_only' ? 'Wake Message' : 'Task'}</span>
+              <div className="text-[13px] text-text-2 mt-0.5 whitespace-pre-wrap">{taskMode === 'wake_only' ? message : taskPrompt}</div>
             </div>
             <div className="h-px bg-white/[0.06]" />
             <div>

package/src/lib/server/builtin-plugins.ts

@@ -6,7 +6,6 @@ import '@/lib/server/session-tools/memory'
 import '@/lib/server/session-tools/platform'
 import '@/lib/server/session-tools/monitor'
 import '@/lib/server/session-tools/discovery'
-import '@/lib/server/session-tools/sample-ui'
 import '@/lib/server/session-tools/git'
 import '@/lib/server/session-tools/wallet'
 import '@/lib/server/session-tools/connector'

package/src/lib/server/runtime/scheduler.ts

@@ -40,6 +40,8 @@ interface SchedulerScheduleLike {
   followupThreadId?: string | null
   followupSenderId?: string | null
   followupSenderName?: string | null
+  taskMode?: 'task' | 'wake_only'
+  message?: string
 }
 
 export function startScheduler() {
@@ -67,7 +69,10 @@ function computeNextRuns() {
     if (schedule.status !== 'active') continue
     if (schedule.scheduleType === 'cron' && schedule.cron && !schedule.nextRunAt) {
       try {
-        const interval = CronExpressionParser.parse(schedule.cron)
+        const interval = CronExpressionParser.parse(
+          schedule.cron,
+          schedule.timezone ? { tz: schedule.timezone } : undefined,
+        )
         schedule.nextRunAt = interval.next().getTime()
         changedEntries.push([schedule.id, schedule])
       } catch (err) {
@@ -157,34 +162,57 @@ async function tick() {
     // Compute next run
     advanceSchedule(schedule)
 
-    const { taskId } = prepareScheduledTaskRun({
-      schedule,
-      tasks,
-      now,
-      scheduleSignature,
-    })
-
-    upsertTask(taskId, tasks[taskId])
-    upsertSchedule(schedule.id, schedule)
-
-    enqueueTask(taskId)
-    if (scheduleSignature) inFlightScheduleKeys.add(scheduleSignature)
-    pushMainLoopEventToMainSessions({
-      type: 'schedule_fired',
-      text: `Schedule fired: "${schedule.name}" (${schedule.id}) run #${schedule.runNumber} — task ${taskId}`,
-    })
-
-    // Enqueue system event + heartbeat wake for the schedule's agent
-    if (schedule.createdInSessionId) {
-      enqueueSystemEvent(schedule.createdInSessionId, `Schedule triggered: ${schedule.name}`)
+    if (schedule.taskMode === 'wake_only') {
+      // Wake-only: no board task, just heartbeat the agent
+      upsertSchedule(schedule.id, schedule)
+
+      const wakeMessage = schedule.message || `Schedule triggered: ${schedule.name}`
+      pushMainLoopEventToMainSessions({
+        type: 'schedule_fired',
+        text: `Schedule fired (wake-only): "${schedule.name}" (${schedule.id}) run #${schedule.runNumber}`,
+      })
+
+      if (schedule.createdInSessionId) {
+        enqueueSystemEvent(schedule.createdInSessionId, wakeMessage)
+      }
+      requestHeartbeatNow({
+        agentId: schedule.agentId,
+        eventId: `${schedule.id}:${schedule.runNumber}`,
+        reason: 'schedule',
+        source: `schedule:${schedule.id}`,
+        resumeMessage: wakeMessage,
+        detail: `Run #${schedule.runNumber} (wake-only).`,
+      })
+    } else {
+      // Default task mode: create a board task
+      const { taskId } = prepareScheduledTaskRun({
+        schedule,
+        tasks,
+        now,
+        scheduleSignature,
+      })
+
+      upsertTask(taskId, tasks[taskId])
+      upsertSchedule(schedule.id, schedule)
+
+      enqueueTask(taskId)
+      if (scheduleSignature) inFlightScheduleKeys.add(scheduleSignature)
+      pushMainLoopEventToMainSessions({
+        type: 'schedule_fired',
+        text: `Schedule fired: "${schedule.name}" (${schedule.id}) run #${schedule.runNumber} — task ${taskId}`,
+      })
+
+      if (schedule.createdInSessionId) {
+        enqueueSystemEvent(schedule.createdInSessionId, `Schedule triggered: ${schedule.name}`)
+      }
+      requestHeartbeatNow({
+        agentId: schedule.agentId,
+        eventId: `${schedule.id}:${schedule.runNumber}`,
+        reason: 'schedule',
+        source: `schedule:${schedule.id}`,
+        resumeMessage: `Schedule triggered: ${schedule.name}`,
+        detail: `Run #${schedule.runNumber} queued task ${taskId}.`,
+      })
     }
-    requestHeartbeatNow({
-      agentId: schedule.agentId,
-      eventId: `${schedule.id}:${schedule.runNumber}`,
-      reason: 'schedule',
-      source: `schedule:${schedule.id}`,
-      resumeMessage: `Schedule triggered: ${schedule.name}`,
-      detail: `Run #${schedule.runNumber} queued task ${taskId}.`,
-    })
   }
 }

package/src/lib/server/schedules/schedule-normalization.ts

@@ -1,5 +1,6 @@
 import fs from 'node:fs'
 import path from 'node:path'
+import { CronExpressionParser } from 'cron-parser'
 import { WORKSPACE_DIR } from '@/lib/server/data-dir'
 
 type SchedulePayload = Record<string, unknown>
@@ -212,11 +213,24 @@ export function normalizeSchedulePayload(payload: SchedulePayload, opts: Normali
   }
   normalized.agentId = agentId
 
-  const taskPrompt = deriveTaskPrompt(normalized)
-  if (!taskPrompt) {
-    return { ok: false, error: 'Error: schedules require a taskPrompt, command, or action/path payload.' }
+  // Preserve taskMode and message fields
+  const taskMode = normalized.taskMode === 'wake_only' ? 'wake_only' : 'task'
+  normalized.taskMode = taskMode
+  if (taskMode === 'wake_only') {
+    const message = trimString(normalized.message)
+    if (!message) {
+      return { ok: false, error: 'Error: wake_only schedules require a message.' }
+    }
+    normalized.message = message
+    // wake_only still needs a taskPrompt for display/logging — derive or use message
+    normalized.taskPrompt = normalized.taskPrompt ? trimString(normalized.taskPrompt) : message
+  } else {
+    const taskPrompt = deriveTaskPrompt(normalized)
+    if (!taskPrompt) {
+      return { ok: false, error: 'Error: schedules require a taskPrompt, command, or action/path payload.' }
+    }
+    normalized.taskPrompt = taskPrompt
   }
-  normalized.taskPrompt = taskPrompt
 
   const validationError = validateScheduleArtifacts(normalized, baseDir)
   if (validationError) return { ok: false, error: `Error: ${validationError}` }
@@ -228,6 +242,17 @@ export function normalizeSchedulePayload(payload: SchedulePayload, opts: Normali
     } else if (normalized.scheduleType === 'interval') {
       const intervalMs = normalizePositiveInt(normalized.intervalMs)
       if (intervalMs != null) normalized.nextRunAt = applyStagger(now + intervalMs, normalized.staggerSec as number | null)
+    } else if (normalized.scheduleType === 'cron' && normalized.cron) {
+      try {
+        const cronTimezone = trimString(normalized.timezone)
+        const interval = CronExpressionParser.parse(
+          normalized.cron as string,
+          cronTimezone ? { tz: cronTimezone } : undefined,
+        )
+        normalized.nextRunAt = applyStagger(interval.next().getTime(), normalized.staggerSec as number | null)
+      } catch {
+        return { ok: false, error: 'Error: invalid cron expression.' }
+      }
     }
   }
 

package/src/lib/server/session-tools/index.ts

@@ -32,7 +32,6 @@ import { buildOpenClawNodeTools } from './openclaw-nodes'
 import { buildContextTools } from './context-mgmt'
 import { buildDiscoveryTools } from './discovery'
 import { buildMonitorTools } from './monitor'
-import { buildSampleUITools } from './sample-ui'
 import { buildPluginCreatorTools } from './plugin-creator'
 import { buildImageGenTools } from './image-gen'
 import { buildEmailTools } from './email'
@@ -182,7 +181,6 @@ export async function buildSessionTools(cwd: string, enabledPlugins: string[], c
       ['context_mgmt', buildContextTools],
       ['discovery', buildDiscoveryTools],
       ['monitor', buildMonitorTools],
-      ['sample_ui', buildSampleUITools],
       ['plugin_creator', buildPluginCreatorTools],
       ['image_gen', buildImageGenTools],
       ['email', buildEmailTools],

package/src/lib/server/tool-aliases.ts

@@ -24,7 +24,6 @@ const PLUGIN_ALIAS_GROUPS: string[][] = [
   ['sandbox', 'sandbox_exec', 'sandbox_list_runtimes'],
   ['wallet', 'wallet_tool'],
   ['monitor', 'monitor_tool'],
-  ['sample_ui', 'show_plugin_card'],
   ['context_mgmt', 'context_status', 'context_summarize'],
   ['openclaw_workspace'],
   ['openclaw_nodes'],

package/src/lib/server/tool-capability-policy.ts

@@ -83,7 +83,6 @@ const TOOL_DESCRIPTORS: Record<string, ToolDescriptor> = {
   spawn_subagent: { categories: ['delegation', 'platform'], concreteTools: ['spawn_subagent', 'delegate_to_agent'] },
   context_mgmt: { categories: ['memory'], concreteTools: ['context_mgmt', 'context_status', 'context_summarize'] },
   plugin_creator: { categories: ['filesystem', 'execution'], concreteTools: ['plugin_creator', 'plugin_creator_tool'] },
-  sample_ui: { categories: ['platform'], concreteTools: ['sample_ui', 'show_plugin_card'] },
   mailbox: { categories: ['network', 'platform', 'outbound'], concreteTools: ['mailbox', 'inbox'] },
   ask_human: { categories: ['platform'], concreteTools: ['ask_human', 'human_loop'] },
   document: { categories: ['filesystem', 'platform'], concreteTools: ['document', 'ocr_document', 'parse_document'] },

package/src/lib/server/universal-tool-access.ts

@@ -34,7 +34,6 @@ const UNIVERSAL_CORE_PLUGIN_IDS = [
   'context_mgmt',
   'discovery',
   'plugin_creator',
-  'sample_ui',
   'image_gen',
   'email',
   'calendar',

package/src/lib/tool-definitions.ts

@@ -24,7 +24,6 @@ export const AVAILABLE_TOOLS: ToolDefinition[] = [
   { 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 focused plugins for durable capabilities and recurring automations' },
-  { id: 'sample_ui', label: 'Sample UI', description: 'Demonstration of dynamic UI injection into Sidebar and Chat Header' },
   { id: 'image_gen', label: 'Image Generation', description: 'Generate images from text prompts using OpenAI, Stability AI, Replicate, fal.ai, and more' },
   { id: 'email', label: 'Email', description: 'Send emails via SMTP with plain text and HTML support' },
   { id: 'calendar', label: 'Calendar', description: 'Manage Google Calendar or Outlook events — list, create, update, delete' },

package/src/types/index.ts

@@ -986,6 +986,10 @@ export interface Schedule {
   agentId: string
   projectId?: string
   taskPrompt: string
+  /** 'task' (default) creates a board task; 'wake_only' just wakes the agent with a message */
+  taskMode?: 'task' | 'wake_only'
+  /** Wake message sent to agent when taskMode is 'wake_only' */
+  message?: string
   scheduleType: ScheduleType
   action?: string
   path?: string

package/src/lib/server/session-tools/sample-ui.ts

@@ -1,97 +0,0 @@
-import { z } from 'zod'
-import { tool } from '@langchain/core/tools'
-import { getPluginManager } from '../plugins'
-import type { Plugin, PluginHooks } from '@/types'
-import { normalizeToolInputArgs } from './normalize-tool-args'
-
-/**
- * Sample UI Extension Plugin
- * This demonstrates how a plugin can add a sidebar item, 
- * a chat header widget, and a custom message type.
- */
-const SampleUIPlugin: Plugin = {
-  name: 'Sample UI',
-  description: 'Demonstration of plugin-driven UI: Sidebar, Header, and Chat.',
-  ui: {
-    sidebarItems: [
-      {
-        id: 'sample-dashboard',
-        label: 'Plugin View',
-        href: 'https://openclaw.ai',
-        position: 'top'
-      }
-    ],
-    headerWidgets: [
-      {
-        id: 'sample-status',
-        label: '🔌 Plugin Active'
-      }
-    ],
-    chatInputActions: [
-      {
-        id: 'sample-action',
-        label: 'Quick Scan',
-        tooltip: 'Run a sample system scan',
-        action: 'message',
-        value: 'Please perform a quick system scan and report the health.'
-      }
-    ]
-  },
-  hooks: {
-    transformInboundMessage: async ({ text }) => {
-      console.log('[plugin:sample_ui] Transforming inbound message')
-      return text // No-op but demonstrates hook
-    },
-    transformOutboundMessage: async ({ text }) => {
-      console.log('[plugin:sample_ui] Transforming outbound message')
-      return text + '\n\n*-- Sent via Sample UI Plugin --*'
-    }
-  } as PluginHooks,
-  tools: [
-    {
-      name: 'show_plugin_card',
-      description: 'Trigger a rich UI card in the chat using the plugin-ui message kind.',
-      parameters: {
-        type: 'object',
-        properties: {
-          title: { type: 'string' },
-          content: { type: 'string' }
-        },
-        required: ['title', 'content']
-      },
-      execute: async (args) => {
-        const normalized = normalizeToolInputArgs((args ?? {}) as Record<string, unknown>)
-        const title = normalized.title as string
-        const content = normalized.content as string
-        // Return a structured payload that the frontend MessageBubble will interpret
-        return JSON.stringify({
-          kind: 'plugin-ui',
-          text: `### ${title}\n\n${content}`,
-          actions: [
-            { id: 'view-more', label: 'View Details', href: 'https://openclaw.ai' }
-          ]
-        })
-      }
-    }
-  ]
-}
-
-// Auto-register
-getPluginManager().registerBuiltin('sample_ui', SampleUIPlugin)
-
-export function buildSampleUITools(bctx: any) {
-  if (!bctx.hasPlugin('sample_ui')) return []
-  return [
-    tool(
-      async (args) => SampleUIPlugin.tools![0].execute(args as any, bctx),
-      {
-        name: 'show_plugin_card',
-        description: SampleUIPlugin.tools![0].description,
-        schema: z.object({
-          title: z.string(),
-          content: z.string()
-        })
-      }
-    )
-  ]
-}