ofiere-openclaw-plugin 3.2.0 → 3.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ofiere-openclaw-plugin",
-  "version": "3.2.0",
+  "version": "3.4.0",
   "type": "module",
   "description": "OpenClaw plugin for Ofiere PM — 9 meta-tools covering tasks, agents, projects, scheduling, knowledge, workflows, notifications, memory, and prompts",
   "keywords": ["openclaw", "ofiere", "project-management", "agents", "plugin"],

package/src/tools.ts

@@ -191,12 +191,13 @@ function registerTaskOps(
       `Manage tasks in the Ofiere PM dashboard. All task operations go through this tool.\n\n` +
       `Actions:\n` +
       `- "list": List/filter tasks. Optional: status, agent_id, space_id, folder_id, limit\n` +
-      `- "create": Create a task. Required: title. Optional: agent_id, description, status, priority, space_id, folder_id, start_date, due_date, tags, instructions, execution_plan, goals, constraints, system_prompt\n` +
+      `- "create": Create a task. Required: title. Optional: agent_id, description, status, priority, space_id, folder_id, start_date, due_date, tags, instructions, execution_plan, goals, constraints, system_prompt, recurrence_type, recurrence_interval, scheduled_time\n` +
       `- "update": Update a task. Required: task_id. Optional: all create fields + progress\n` +
       `- "delete": Delete task + subtasks. Required: task_id\n\n` +
       `For complex tasks, fill in execution_plan (step-by-step plan), goals, constraints, and system_prompt to help the executing agent.\n` +
       `For simple tasks, just provide title and optionally description.\n` +
       `agent_id: Pass your name to self-assign, another agent's name, or 'none'.\n` +
+      `For recurring tasks: set start_date + recurrence_type + recurrence_interval. Example: every 2 minutes = recurrence_type: "minutely", recurrence_interval: 2.\n` +
       `Status: PENDING, IN_PROGRESS, DONE, FAILED | Priority: 0=LOW, 1=MEDIUM, 2=HIGH, 3=CRITICAL`,
     parameters: {
       type: "object",
@@ -224,8 +225,15 @@ function registerTaskOps(
         progress: { type: "number", description: "Progress percentage 0-100 (update only)" },
         space_id: { type: "string", description: "PM Space ID" },
         folder_id: { type: "string", description: "PM Folder ID" },
-        start_date: { type: "string", description: "Start date (ISO 8601)" },
+        start_date: { type: "string", description: "Start date (ISO 8601). Required for scheduled/recurring tasks." },
         due_date: { type: "string", description: "Due date (ISO 8601)" },
+        scheduled_time: { type: "string", description: "Time to execute in HH:MM format (UTC). If omitted, extracted from start_date or defaults to now+60s." },
+        recurrence_type: {
+          type: "string",
+          description: "How often the task recurs. 'none' for one-shot.",
+          enum: ["none", "minutely", "hourly", "daily", "weekly", "monthly"],
+        },
+        recurrence_interval: { type: "number", description: "Recurrence interval. e.g. recurrence_type='minutely', recurrence_interval=2 → every 2 minutes. Default: 1" },
         tags: {
           type: "array",
           items: { type: "string" },
@@ -430,11 +438,54 @@ async function handleCreateTask(
     const effectiveAgentId = (insertData.agent_id as string) || assignee;
     if (startDate && effectiveAgentId) {
       try {
-        const scheduledTime = (params.scheduled_time as string) || "09:00"; // default 9am
-        const datePart = startDate; // YYYY-MM-DD
-        const timePart = scheduledTime; // HH:MM
-        const dt = new Date(`${datePart}T${timePart}:00`);
-        const nextRunAt = Math.floor(dt.getTime() / 1000);
+        // Parse start_date robustly — it can be:
+        //   "2026-04-19"                    (date only)
+        //   "2026-04-19T18:45:00"           (local datetime)
+        //   "2026-04-19 11:45:00+00"        (Supabase timestamptz)
+        //   "2026-04-19T11:45:00.000Z"      (ISO UTC)
+        const parsedDate = new Date(startDate);
+        const explicitScheduledTime = params.scheduled_time as string | undefined;
+
+        let nextRunAtEpoch: number;
+        let scheduledTimeFinal: string;
+        let scheduledDateFinal: string;
+
+        if (!isNaN(parsedDate.getTime())) {
+          // Valid date — check if it includes a meaningful time component
+          const hasTimeInfo = /[T ]\d{2}:\d{2}/.test(startDate);
+
+          if (explicitScheduledTime) {
+            // Agent explicitly passed a scheduled_time — use date from start_date + explicit time
+            const dateStr = parsedDate.toISOString().split("T")[0]; // YYYY-MM-DD
+            const dt = new Date(`${dateStr}T${explicitScheduledTime}:00Z`);
+            nextRunAtEpoch = Math.floor(dt.getTime() / 1000);
+            scheduledTimeFinal = explicitScheduledTime;
+            scheduledDateFinal = dateStr;
+          } else if (hasTimeInfo) {
+            // start_date already contains time — use it directly
+            nextRunAtEpoch = Math.floor(parsedDate.getTime() / 1000);
+            scheduledTimeFinal = `${String(parsedDate.getUTCHours()).padStart(2, "0")}:${String(parsedDate.getUTCMinutes()).padStart(2, "0")}`;
+            scheduledDateFinal = parsedDate.toISOString().split("T")[0];
+          } else {
+            // Date only, no time — default to 09:00 UTC
+            const dateStr = parsedDate.toISOString().split("T")[0];
+            const dt = new Date(`${dateStr}T09:00:00Z`);
+            nextRunAtEpoch = Math.floor(dt.getTime() / 1000);
+            scheduledTimeFinal = "09:00";
+            scheduledDateFinal = dateStr;
+          }
+        } else {
+          // Unparseable date — fallback to now + 60s
+          nextRunAtEpoch = Math.floor(Date.now() / 1000) + 60;
+          scheduledTimeFinal = "00:00";
+          scheduledDateFinal = new Date().toISOString().split("T")[0];
+        }
+
+        // Safety net: if computed time is in the past, schedule for now + 60s
+        const nowEpoch = Math.floor(Date.now() / 1000);
+        if (nextRunAtEpoch <= nowEpoch) {
+          nextRunAtEpoch = nowEpoch + 60;
+        }
 
         await supabase.from("scheduler_events").insert({
           id: crypto.randomUUID(),
@@ -443,13 +494,13 @@ async function handleCreateTask(
           agent_id: effectiveAgentId,
           title: params.title,
           description: (params.description as string) || (params.instructions as string) || null,
-          scheduled_date: datePart,
-          scheduled_time: timePart,
+          scheduled_date: scheduledDateFinal,
+          scheduled_time: scheduledTimeFinal,
           duration_minutes: 30,
-          recurrence_type: "none",
-          recurrence_interval: 1,
+          recurrence_type: (params.recurrence_type as string) || "none",
+          recurrence_interval: (params.recurrence_interval as number) || 1,
           status: "scheduled",
-          next_run_at: nextRunAt,
+          next_run_at: nextRunAtEpoch,
           run_count: 0,
           priority: params.priority !== undefined ? params.priority : 1,
         });