obol-ai 0.2.31 → 0.2.32

package/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 0.2.32
+- fix cron-parser v5 tz option, enforce cron_expr for recurring events
+
 ## 0.2.31
 - update readme: remove github/vercel from onboarding, remove vercel tool references
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "obol-ai",
-  "version": "0.2.31",
+  "version": "0.2.32",
   "description": "Self-evolving AI assistant that learns, remembers, and acts on its own. Persistent vector memory, self-rewriting personality, proactive heartbeats.",
   "main": "src/index.js",
   "bin": {

package/src/claude/prompt.js

@@ -161,11 +161,12 @@ Returns the tapped button label, or \`"timeout"\` if the user doesn't respond wi
 
 ### Scheduling (\`schedule_event\`, \`list_events\`, \`cancel_event\`)
 Schedule one-time or recurring reminders. The user gets a Telegram message each time an event fires.
-- \`schedule_event\` — schedule a reminder with title, due_at (ISO 8601), timezone (IANA), optional description. For recurring events add \`cron_expr\` (5-field cron), optional \`max_runs\` and \`ends_at\`.
+- \`schedule_event\` — schedule a reminder with title, due_at (ISO 8601), timezone (IANA), optional description
 - \`list_events\` — list pending/sent/cancelled/completed events
 - \`cancel_event\` — cancel a scheduled event by ID
 
-Cron examples: \`0 9 * * 1-5\` (weekdays 9am), \`0 8 * * 1\` (Mondays 8am), \`*/30 * * * *\` (every 30 min), \`0 0 1 * *\` (1st of month).
+**Recurring events:** use \`cron_expr\` (5-field cron). The system auto-reschedules after each fire — never chain one-time events manually.
+Examples: \`*/30 * * * *\` (every 30 min), \`0 9 * * 1-5\` (weekdays 9am), \`0 8 * * 1\` (Mondays 8am), \`0 0 1 * *\` (1st of month).
 
 When scheduling: always search memory first for the user's timezone/location. If no timezone found, ask the user or default to UTC. Parse natural language dates relative to the user's timezone.
 

package/src/claude/tools/scheduler.js

@@ -3,7 +3,15 @@ const { toUTC } = require('../utils');
 const definitions = [
   {
     name: 'schedule_event',
-    description: 'Schedule a one-time or recurring reminder/event. For recurring events, provide a cron_expr (standard 5-field cron: minute hour day-of-month month day-of-week). The user will receive a Telegram message each time it fires. Always search memory first for the user\'s timezone/location.',
+    description: `Schedule a one-time or recurring reminder/event. The user will receive a Telegram message each time it fires.
+
+For RECURRING events (e.g. "every 30 minutes", "daily at 9am", "every Monday"):
+- ALWAYS use cron_expr — do NOT schedule one-time events and chain them manually
+- cron_expr is a standard 5-field cron: minute hour day-of-month month day-of-week
+- Examples: "*/30 * * * *" (every 30 min), "0 9 * * 1-5" (weekdays 9am), "0 8 * * 1" (Mondays 8am)
+- The system will auto-reschedule after each fire — no need to re-schedule manually
+
+Always search memory first for the user's timezone/location.`,
     input_schema: {
       type: 'object',
       properties: {
@@ -11,7 +19,7 @@ const definitions = [
         due_at: { type: 'string', description: 'ISO 8601 datetime for the first fire time (e.g. 2026-02-25T15:00:00)' },
         timezone: { type: 'string', description: 'IANA timezone (e.g. Europe/Brussels, America/New_York). Default: UTC' },
         description: { type: 'string', description: 'Context or details about the event' },
-        cron_expr: { type: 'string', description: 'Cron expression for recurring events (5-field: "0 9 * * 1-5" = weekdays 9am). Omit for one-time events.' },
+        cron_expr: { type: 'string', description: 'Cron expression for recurring events (5-field). REQUIRED for any repeating schedule — do not omit and chain one-time events instead.' },
         max_runs: { type: 'number', description: 'Maximum number of times to fire (omit for unlimited)' },
         ends_at: { type: 'string', description: 'ISO 8601 datetime after which the recurring event stops' },
       },
@@ -51,7 +59,7 @@ const handlers = {
     if (input.cron_expr) {
       try {
         const { parseExpression } = require('cron-parser');
-        parseExpression(input.cron_expr, { tz });
+        parseExpression(input.cron_expr, { timezone: tz });
       } catch (e) {
         return `Invalid cron expression "${input.cron_expr}": ${e.message}`;
       }

package/src/scheduler.js

@@ -36,7 +36,7 @@ function createScheduler(supabaseConfig, userId = 0) {
   async function list(opts = {}) {
     const status = opts.status || 'pending';
     const limit = opts.limit || 20;
-    let fetchUrl = `${url}/rest/v1/obol_events?user_id=eq.${userId}&status=eq.${status}&order=due_at.asc&limit=${limit}&select=id,title,description,due_at,timezone,status,created_at,cron_expr,last_run_at,run_count,max_runs,ends_at`;
+    const fetchUrl = `${url}/rest/v1/obol_events?user_id=eq.${userId}&status=eq.${status}&order=due_at.asc&limit=${limit}&select=id,title,description,due_at,timezone,status,created_at,cron_expr,last_run_at,run_count,max_runs,ends_at`;
     const res = await fetch(fetchUrl, { headers });
     const data = await res.json();
     if (!res.ok) throw new Error(JSON.stringify(data));
@@ -87,7 +87,7 @@ function createScheduler(supabaseConfig, userId = 0) {
     }
 
     try {
-      const nextDate = parseExpression(cronExpr, { currentDate: new Date(), tz: timezone || 'UTC' }).next().toDate();
+      const nextDate = parseExpression(cronExpr, { currentDate: new Date(), timezone: timezone || 'UTC' }).next().toDate();
 
       if (endsAt && nextDate > new Date(endsAt)) {
         return patch(eventId, { status: 'completed', run_count: newRunCount, last_run_at: new Date().toISOString() });