@goodandready/dsh-cron 0.1.24 → 0.2.0

package/lib/index.js

@@ -8,38 +8,296 @@ import { createKanbanCard } from './integrations.js';
 import { defineTool } from '@deepseek-ai/dsh-tools';
 import { randomUUID } from 'node:crypto';
 import z from '@deepseek-ai/schemastery';
+import {
+  parseJsonBody,
+  isCrossOrigin,
+  pickPatchableFields,
+  SCRIPT_CONFIRM_HEADER,
+} from './http-utils.js';
 
 export const name = '@goodandready/dsh-cron';
 export const inject = ['tools', 'webServer', 'settings', 'llm', 'agents', 'agentDefaultModel'];
 
 export const Config = z.object({
-  botToken: z.string().role('secret').default('').description('Telegram Bot Token для отправки отчетов'),
-  chatId: z.string().default('').description('Telegram Chat ID получателя'),
-  notifyTelegram: z.boolean().default(false).description('Включить глобальную отправку отчетов в Telegram'),
-  onlyOnFailure: z.boolean().default(false).description('Отправлять отчеты в Telegram только при ошибках'),
-  kanbanBaseUrl: z.string().default('http://127.0.0.1:3000').description('Базовый URL Kanban API'),
+  botToken: z.string().role('secret').default('').description('Telegram Bot API token used to deliver task reports'),
+  chatId: z.string().default('').description('Telegram chat ID that receives task reports'),
+  notifyTelegram: z.boolean().default(false).description('Deliver task reports to Telegram for every task'),
+  onlyOnFailure: z.boolean().default(false).description('Deliver reports only for failed runs'),
+  kanbanBaseUrl: z.string().default('http://127.0.0.1:3000').description('Base URL of the dsh-kanban HTTP API'),
 });
 
-function parseJsonBody(req) {
-  return new Promise((resolve, reject) => {
-    let data = '';
-    req.on('data', (chunk) => { data += chunk; });
-    req.on('end', () => {
-      try {
-        resolve(data ? JSON.parse(data) : {});
-      } catch (err) {
-        reject(err);
-      }
-    });
-    req.on('error', reject);
-  });
-}
+const PATCHABLE_TASK_FIELDS = [
+  'title',
+  'schedule',
+  'scheduleText',
+  'prompt',
+  'type',
+  'delivery',
+  'provider',
+  'model',
+  'notifyTelegram',
+  'onlyOnFailure',
+  'timeoutSeconds',
+  'overlapPolicy',
+  'kanbanMode',
+  'status',
+  'oneShot',
+];
 
 function sendJson(res, statusCode, data) {
   res.writeHead(statusCode, { 'Content-Type': 'application/json' });
   res.end(JSON.stringify(data));
 }
 
+function rejectCrossOrigin(req, res) {
+  if (isCrossOrigin(req)) {
+    sendJson(res, 403, { ok: false, error: 'Cross-origin request rejected' });
+    return true;
+  }
+  return false;
+}
+
+async function readBody(req, res) {
+  try {
+    return { body: await parseJsonBody(req) };
+  } catch (err) {
+    sendJson(res, err.statusCode || 400, { ok: false, error: err.message });
+    return { error: true };
+  }
+}
+
+/**
+ * Shared implementation for the /dsh-cron/tasks... and /dsh-cron/action...
+ * route families — the #66 alias is kept alive by the same code path instead
+ * of a duplicated handler.
+ *
+ * IMPORTANT: prefix routes must be registered WITHOUT a trailing slash —
+ * with one, the core degrades matching to exact-path equality and every
+ * deeper path unrouted (#96).
+ */
+function createCronApiHandler(store, scheduler, collection) {
+  return async function handleCronApi(req, res) {
+    try {
+      const url = new URL(req.url, 'http://127.0.0.1');
+      const parts = url.pathname.split('/').filter(Boolean);
+      const scope = parts[1]; // 'tasks' | 'action'
+      const id = parts[2];
+      const action = parts[3];
+
+      // Collection level: /dsh-cron/tasks (list + create)
+      if (!id) {
+        if (scope === 'action' || !collection) {
+          sendJson(res, 405, { ok: false, error: 'Method not allowed' });
+          return;
+        }
+        if (req.method === 'GET') {
+          const status = url.searchParams.get('status') || 'all';
+          const query = url.searchParams.get('query') || '';
+          const list = store.list({ status, query });
+          const stats = store.getAggregatedStats();
+          sendJson(res, 200, { ok: true, tasks: list, recommendations: collection.recommendations, stats });
+          return;
+        }
+        if (req.method === 'POST') {
+          if (rejectCrossOrigin(req, res)) return;
+          const { body, error } = await readBody(req, res);
+          if (error) return;
+          if (!body.title || !body.schedule || !body.prompt) {
+            sendJson(res, 400, { ok: false, error: 'Fields title, schedule and prompt are required' });
+            return;
+          }
+          const taskType = body.type === 'script' ? 'script' : 'llm';
+          if (taskType === 'script' && req.headers[SCRIPT_CONFIRM_HEADER] !== 'script') {
+            sendJson(res, 403, { ok: false, error: 'Creating script tasks over HTTP requires the x-dsh-cron-confirm: script header' });
+            return;
+          }
+          const parsed = parseScheduleExpression(body.schedule);
+          const current = body.id ? store.get(body.id) : null;
+          const resolvedStatus = body.status || (current ? current.status : 'active');
+
+          const task = store.set({
+            id: body.id,
+            title: body.title,
+            schedule: parsed.cronPattern || body.schedule,
+            scheduleText: body.scheduleText || parsed.humanText,
+            prompt: body.prompt,
+            type: taskType,
+            delivery: body.delivery || 'current',
+            status: resolvedStatus,
+            provider: body.provider || undefined,
+            model: body.model || undefined,
+            notifyTelegram: body.notifyTelegram !== undefined ? Boolean(body.notifyTelegram) : (current ? current.notifyTelegram : false),
+            onlyOnFailure: body.onlyOnFailure !== undefined ? Boolean(body.onlyOnFailure) : (current ? current.onlyOnFailure : false),
+            timeoutSeconds: body.timeoutSeconds !== undefined ? Number(body.timeoutSeconds) : (current ? current.timeoutSeconds : 1800),
+            overlapPolicy: body.overlapPolicy || (current ? current.overlapPolicy : 'skip'),
+            kanbanMode: body.kanbanMode || (current ? current.kanbanMode : 'none'),
+            oneShot: Boolean(parsed.isOneShot || body.oneShot),
+          });
+          if (task.status === 'active') {
+            scheduler.scheduleTask(task);
+          } else {
+            scheduler.pauseTask(task.id);
+          }
+          sendJson(res, 200, { ok: true, task });
+          return;
+        }
+        sendJson(res, 405, { ok: false, error: 'Method not allowed' });
+        return;
+      }
+
+      // Item level: /dsh-cron/{tasks|action}/:id[/:action]
+      if (req.method !== 'GET' && rejectCrossOrigin(req, res)) return;
+
+      if (req.method === 'GET' && (action === 'history' || !action)) {
+        const limit = parseInt(url.searchParams.get('limit') || '20', 10);
+        sendJson(res, 200, { ok: true, history: store.getHistory(id, limit) });
+        return;
+      }
+
+      if (req.method === 'POST' && action === 'run') {
+        await scheduler.triggerManualRun(id);
+        sendJson(res, 200, { ok: true, task: store.get(id) });
+        return;
+      }
+
+      if (req.method === 'POST' && action === 'pause') {
+        const task = scheduler.pauseTask(id);
+        if (!task) {
+          sendJson(res, 404, { ok: false, error: 'Task not found' });
+          return;
+        }
+        sendJson(res, 200, { ok: true, task });
+        return;
+      }
+
+      if (req.method === 'POST' && action === 'resume') {
+        const task = scheduler.resumeTask(id);
+        if (!task) {
+          sendJson(res, 404, { ok: false, error: 'Task not found' });
+          return;
+        }
+        sendJson(res, 200, { ok: true, task });
+        return;
+      }
+
+      if (req.method === 'POST' && (action === 'toggle' || (!action && url.searchParams.get('action') === 'toggle'))) {
+        const current = store.get(id);
+        if (!current) {
+          sendJson(res, 404, { ok: false, error: 'Task not found' });
+          return;
+        }
+        const task = scheduler.toggleTask(id);
+        sendJson(res, 200, { ok: true, task });
+        return;
+      }
+
+      if (req.method === 'PATCH') {
+        const current = store.get(id);
+        if (!current) {
+          sendJson(res, 404, { ok: false, error: 'Task not found' });
+          return;
+        }
+        const { body, error } = await readBody(req, res);
+        if (error) return;
+        // Whitelist patchable fields so stats/timestamps stay server-owned (#90)
+        const patchData = pickPatchableFields(body, PATCHABLE_TASK_FIELDS);
+        if (patchData.type === 'script' && current.type !== 'script' && req.headers[SCRIPT_CONFIRM_HEADER] !== 'script') {
+          sendJson(res, 403, { ok: false, error: 'Switching a task to the script type over HTTP requires the x-dsh-cron-confirm: script header' });
+          return;
+        }
+        if (patchData.schedule) {
+          const parsed = parseScheduleExpression(patchData.schedule);
+          patchData.schedule = parsed.cronPattern || patchData.schedule;
+          patchData.scheduleText = body.scheduleText || parsed.humanText;
+          patchData.oneShot = Boolean(parsed.isOneShot || body.oneShot);
+        }
+        const task = store.set({ ...current, ...patchData, id });
+        if (task.status === 'active') {
+          scheduler.scheduleTask(task);
+        } else {
+          scheduler.pauseTask(id);
+        }
+        sendJson(res, 200, { ok: true, task });
+        return;
+      }
+
+      if (req.method === 'DELETE' || (req.method === 'POST' && action === 'delete')) {
+        const current = store.get(id);
+        if (current) {
+          scheduler.pauseTask(id);
+          store.delete(id);
+        }
+        sendJson(res, 200, { ok: true });
+        return;
+      }
+
+      sendJson(res, 405, { ok: false, error: 'Method not allowed' });
+    } catch (err) {
+      sendJson(res, err.statusCode || 500, { ok: false, error: err.message });
+    }
+  };
+}
+
+/**
+ * Single implementation behind the cron_create_task / cron_schedule_task
+ * alias pair (#70, #92).
+ */
+function executeCreateTask(store, scheduler, args) {
+  const taskType = args.type === 'script' ? 'script' : 'llm';
+  const parsed = parseScheduleExpression(args.schedule);
+  const task = store.set({
+    title: args.title,
+    schedule: parsed.cronPattern || args.schedule,
+    scheduleText: parsed.humanText,
+    prompt: args.prompt,
+    type: taskType,
+    delivery: args.delivery || 'isolated',
+    status: 'active',
+    provider: args.provider,
+    model: args.model,
+    notifyTelegram: Boolean(args.notifyTelegram),
+    onlyOnFailure: Boolean(args.onlyOnFailure),
+    timeoutSeconds: Number(args.timeoutSeconds) || 1800,
+    overlapPolicy: args.overlapPolicy || 'skip',
+    kanbanMode: args.kanbanMode || 'none',
+    oneShot: Boolean(parsed.isOneShot),
+  });
+  scheduler.scheduleTask(task);
+  return {
+    success: true,
+    message: `Task "${task.title}" scheduled successfully (${task.scheduleText})`,
+    task
+  };
+}
+
+const createTaskParameters = {
+  title: { type: 'string', description: 'Short task name', required: true },
+  schedule: { type: 'string', description: 'Schedule: cron ("0 9 * * *"), interval ("every 2h") or one-shot ("in 30m", "at: 2026-09-05T15:00:00Z")', required: true },
+  prompt: { type: 'string', description: 'Prompt/instruction for the agent at run time', required: true },
+  type: { type: 'string', enum: ['prompt', 'script'], description: 'Task type' },
+  delivery: { type: 'string', enum: ['current', 'isolated'], description: 'Run mode: current (in the current chat) or isolated (separate session)' },
+  provider: { type: 'string', description: 'Model provider (optional)' },
+  model: { type: 'string', description: 'Model (optional)' },
+  notifyTelegram: { type: 'boolean', description: 'Send the run report to Telegram' },
+  onlyOnFailure: { type: 'boolean', description: 'Send reports only for failures' },
+  timeoutSeconds: { type: 'number', description: 'Execution time limit in seconds' },
+  overlapPolicy: { type: 'string', enum: ['skip', 'queue', 'replace'], description: 'Overlap policy' },
+  kanbanMode: { type: 'string', enum: ['none', 'on_failure', 'always'], description: 'Create a dsh-kanban card for runs' },
+};
+
+const createTaskOutput = {
+  schema: {
+    type: 'object',
+    additionalProperties: true,
+    properties: {
+      success: { type: 'boolean' },
+      message: { type: 'string' },
+      task: { type: 'object', additionalProperties: true }
+    }
+  },
+  render: (_args, val) => [{ type: 'text', text: val.message || JSON.stringify(val) }]
+};
+
 export function apply(ctx, config) {
   const store = new TaskStore();
   const runner = new SessionRunner(ctx);
@@ -74,94 +332,47 @@ export function apply(ctx, config) {
   const recommendations = [
     {
       id: 'rec_daily_digest',
-      title: 'Ежедневная сводка',
+      title: 'Daily digest',
       schedule: '0 8 * * 1-5',
-      scheduleText: 'В будние дни в 8:00',
-      prompt: 'Сделай краткую утреннюю сводку: проверь список активных задач, открытые тикеты в Gitea и наметь ключевые приоритеты на сегодня.',
-      description: 'Начинайте каждый будний день со сводки календаря, непрочитанных писем и приоритетов',
+      scheduleText: 'Weekdays at 08:00',
+      prompt: 'Prepare a brief morning digest: review the list of active tasks, open Gitea tickets and outline the key priorities for today.',
+      description: 'Start every weekday with a summary of calendar, unread mail and priorities',
       icon: 'bell'
     },
     {
       id: 'rec_weekly_review',
-      title: 'Еженедельный обзор',
+      title: 'Weekly review',
       schedule: '0 16 * * 5',
-      scheduleText: 'Пятницы в 16:00',
-      prompt: 'Подготовь еженедельный отчет о проделанной работе: список закрытых задач, созданных PR и актуальный статус текущих проектов.',
-      description: 'Каждую пятницу создавайте краткий отчет о проделанной работе',
+      scheduleText: 'Fridays at 16:00',
+      prompt: 'Prepare a weekly report on the work done: the list of closed tasks, created PRs and the current status of ongoing projects.',
+      description: 'Every Friday create a short report on the completed work',
       icon: 'clipboard'
     },
     {
       id: 'rec_monitor_status',
-      title: 'Мониторинг дальнейших действий',
+      title: 'Follow-up monitor',
       schedule: '0 9 * * 1-5',
-      scheduleText: 'В будние дни в 9:00',
-      prompt: 'Проверь недавнюю активность в проектах, статус сборок и отметь всё, что требует внимания разработчика.',
-      description: 'Проверяйте недавнюю активность в проектах и отмечайте всё, что требует вашего внимания',
+      scheduleText: 'Weekdays at 09:00',
+      prompt: 'Review recent project activity, build statuses and flag everything that requires developer attention.',
+      description: 'Review recent project activity and flag anything that needs your attention',
       icon: 'activity'
     }
   ];
 
-  // 1. REST API
-  // GET & POST /dsh-cron/tasks
+  // 1. REST API — collection (list/create) + item actions in one prefix
+  // handler per route family; registered WITHOUT the trailing slash (#96)
   ctx.effect(() => ctx.webServer.register({
-    kind: 'exact',
+    kind: 'prefix',
     path: '/dsh-cron/tasks',
-    handler: async (req, res) => {
-      try {
-        if (req.method === 'GET') {
-          const url = new URL(req.url, 'http://127.0.0.1');
-          const status = url.searchParams.get('status') || 'all';
-          const query = url.searchParams.get('query') || '';
-          const list = store.list({ status, query });
-          const stats = store.getAggregatedStats();
-          sendJson(res, 200, { ok: true, tasks: list, recommendations, stats });
-          return;
-        }
-
-        if (req.method === 'POST') {
-          const body = await parseJsonBody(req);
-          if (!body.title || !body.schedule || !body.prompt) {
-            sendJson(res, 400, { ok: false, error: 'Поля title, schedule и prompt обязательны' });
-            return;
-          }
-          const parsed = parseScheduleExpression(body.schedule);
-          const current = body.id ? store.get(body.id) : null;
-          const resolvedStatus = body.status || (current ? current.status : 'active');
-          const taskType = body.type === 'script' ? 'script' : 'llm';
-
-          const task = store.set({
-            id: body.id,
-            title: body.title,
-            schedule: parsed.cronPattern || body.schedule,
-            scheduleText: body.scheduleText || parsed.humanText,
-            prompt: body.prompt,
-            type: taskType,
-            delivery: body.delivery || 'current',
-            status: resolvedStatus,
-            provider: body.provider || undefined,
-            model: body.model || undefined,
-            notifyTelegram: body.notifyTelegram !== undefined ? Boolean(body.notifyTelegram) : (current ? current.notifyTelegram : false),
-            onlyOnFailure: body.onlyOnFailure !== undefined ? Boolean(body.onlyOnFailure) : (current ? current.onlyOnFailure : false),
-            timeoutSeconds: body.timeoutSeconds !== undefined ? Number(body.timeoutSeconds) : (current ? current.timeoutSeconds : 1800),
-            overlapPolicy: body.overlapPolicy || (current ? current.overlapPolicy : 'skip'),
-            kanbanMode: body.kanbanMode || (current ? current.kanbanMode : 'none'),
-            oneShot: Boolean(parsed.isOneShot || body.oneShot),
-          });
-          if (task.status === 'active') {
-            scheduler.scheduleTask(task);
-          } else {
-            scheduler.pauseTask(task.id);
-          }
-          sendJson(res, 200, { ok: true, task });
-          return;
-        }
+    handler: createCronApiHandler(store, scheduler, { recommendations })
+  }), 'dsh-cron: /tasks[...]');
 
-        sendJson(res, 405, { ok: false, error: 'Method not allowed' });
-      } catch (err) {
-        sendJson(res, 500, { ok: false, error: err.message });
-      }
-    }
-  }), 'dsh-cron: /tasks');
+  // Alias route /dsh-cron/action/:id/:action for backward compatibility (#66)
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'prefix',
+    path: '/dsh-cron/action',
+    handler: createCronApiHandler(store, scheduler, null)
+  }), 'dsh-cron: /action/:id/:action');
 
   // GET /dsh-cron/models
   ctx.effect(() => ctx.webServer.register({
@@ -177,6 +388,7 @@ export function apply(ctx, config) {
     kind: 'exact',
     path: '/dsh-cron/chat/start',
     handler: async (req, res) => {
+      if (req.method === 'POST' && rejectCrossOrigin(req, res)) return;
       await chatStartHandler(ctx, req, res, parseJsonBody, sendJson, randomUUID);
     }
   }), 'dsh-cron: /chat/start');
@@ -192,14 +404,16 @@ export function apply(ctx, config) {
           return;
         }
         if (req.method === 'POST') {
-          const body = await parseJsonBody(req);
+          if (rejectCrossOrigin(req, res)) return;
+          const { body, error } = await readBody(req, res);
+          if (error) return;
           store.saveSettings(body);
           sendJson(res, 200, { ok: true, settings: store.getClientSettings() });
           return;
         }
         sendJson(res, 405, { ok: false, error: 'Method not allowed' });
       } catch (err) {
-        sendJson(res, 500, { ok: false, error: err.message });
+        sendJson(res, err.statusCode || 500, { ok: false, error: err.message });
       }
     }
   }), 'dsh-cron: /settings');
@@ -214,19 +428,21 @@ export function apply(ctx, config) {
           sendJson(res, 405, { ok: false, error: 'Method not allowed' });
           return;
         }
-        const body = await parseJsonBody(req);
+        if (rejectCrossOrigin(req, res)) return;
+        const { body, error } = await readBody(req, res);
+        if (error) return;
         const settings = store.getSettings();
         const botToken = body.botToken || settings.botToken;
         const chatId = body.chatId || settings.chatId;
 
         if (!botToken || !chatId) {
-          sendJson(res, 400, { ok: false, error: 'Не указан botToken или chatId' });
+          sendJson(res, 400, { ok: false, error: 'botToken or chatId is not configured' });
           return;
         }
 
-        const text = `🔔 *Тестовое оповещение dsh-cron*\n\nСвязь между DSH Cron и Telegram успешно настроена! Проверка времени: \`${new Date().toISOString()}\``;
+        const text = `🔔 *dsh-cron test notification*\n\nConnection between DSH Cron and Telegram is working! Checked at: \`${new Date().toISOString()}\``;
         await sendTelegramMessage({ botToken, chatId, text });
-        sendJson(res, 200, { ok: true, message: 'Тестовое сообщение успешно отправлено' });
+        sendJson(res, 200, { ok: true, message: 'Test message sent successfully' });
       } catch (err) {
         sendJson(res, 500, { ok: false, error: err.message });
       }
@@ -243,13 +459,15 @@ export function apply(ctx, config) {
           sendJson(res, 405, { ok: false, error: 'Method not allowed' });
           return;
         }
-        const body = await parseJsonBody(req);
+        if (rejectCrossOrigin(req, res)) return;
+        const { body, error } = await readBody(req, res);
+        if (error) return;
         const settings = store.getSettings();
         const kanbanBaseUrl = body.kanbanBaseUrl || settings.kanbanBaseUrl || 'http://127.0.0.1:3000';
 
         const result = await createKanbanCard({
-          title: `[Тест] Проверка связи DSH Cron -> Kanban`,
-          body: `Тестовая карточка создана автоматически из модуля \`dsh-cron\` в ${new Date().toLocaleString('ru-RU')}.`,
+          title: '[Test] dsh-cron -> Kanban connectivity check',
+          body: `Test card created automatically by the \`dsh-cron\` module at ${new Date().toISOString()}.`,
           board: 'main',
           column: 'backlog',
           labels: ['cron', 'test'],
@@ -267,289 +485,29 @@ export function apply(ctx, config) {
     }
   }), 'dsh-cron: /kanban/test');
 
-  // PATCH & DELETE /dsh-cron/tasks/:id
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'prefix',
-    path: '/dsh-cron/tasks/',
-    handler: async (req, res) => {
-      try {
-        const url = new URL(req.url, 'http://127.0.0.1');
-        const parts = url.pathname.split('/').filter(Boolean);
-        const id = parts[2];
-        const action = parts[3];
-
-        if (!id) {
-          sendJson(res, 400, { ok: false, error: 'ID задачи не указан' });
-          return;
-        }
-
-        if (req.method === 'GET' && action === 'history') {
-          const limit = parseInt(url.searchParams.get('limit') || '20', 10);
-          const history = store.getHistory(id, limit);
-          sendJson(res, 200, { ok: true, history });
-          return;
-        }
-
-        if (req.method === 'POST' && action === 'run') {
-          await scheduler.triggerManualRun(id);
-          const task = store.get(id);
-          sendJson(res, 200, { ok: true, task });
-          return;
-        }
-
-        if (req.method === 'POST' && action === 'pause') {
-          const task = scheduler.pauseTask(id);
-          if (!task) {
-            sendJson(res, 404, { ok: false, error: 'Задача не найдена' });
-            return;
-          }
-          sendJson(res, 200, { ok: true, task });
-          return;
-        }
-
-        if (req.method === 'POST' && action === 'resume') {
-          const task = scheduler.resumeTask(id);
-          if (!task) {
-            sendJson(res, 404, { ok: false, error: 'Задача не найдена' });
-            return;
-          }
-          sendJson(res, 200, { ok: true, task });
-          return;
-        }
-
-        if (req.method === 'POST' && (action === 'toggle' || (!action && url.searchParams.get('action') === 'toggle'))) {
-          const current = store.get(id);
-          if (!current) {
-            sendJson(res, 404, { ok: false, error: 'Задача не найдена' });
-            return;
-          }
-          const task = scheduler.toggleTask(id);
-          sendJson(res, 200, { ok: true, task });
-          return;
-        }
-
-        if (req.method === 'PATCH') {
-          const body = await parseJsonBody(req);
-          const current = store.get(id);
-          if (!current) {
-            sendJson(res, 404, { ok: false, error: 'Задача не найдена' });
-            return;
-          }
-          let patchData = { ...body };
-          if (body.schedule) {
-            const parsed = parseScheduleExpression(body.schedule);
-            patchData.schedule = parsed.cronPattern || body.schedule;
-            patchData.scheduleText = body.scheduleText || parsed.humanText;
-            patchData.oneShot = Boolean(parsed.isOneShot || body.oneShot);
-          }
-          const task = store.set({ ...current, ...patchData, id });
-          if (task.status === 'active') {
-            scheduler.scheduleTask(task);
-          } else {
-            scheduler.pauseTask(id);
-          }
-          sendJson(res, 200, { ok: true, task });
-          return;
-        }
-
-        if (req.method === 'DELETE' || (req.method === 'POST' && action === 'delete')) {
-          const current = store.get(id);
-          if (current) {
-            scheduler.pauseTask(id);
-            store.delete(id);
-          }
-          sendJson(res, 200, { ok: true });
-          return;
-        }
-
-        sendJson(res, 405, { ok: false, error: 'Method not allowed' });
-      } catch (err) {
-        sendJson(res, 500, { ok: false, error: err.message });
-      }
-    }
-  }), 'dsh-cron: /tasks/:id');
-
-  // Alias route /dsh-cron/action/:id/:action for backward compatibility (#66)
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'prefix',
-    path: '/dsh-cron/action/',
-    handler: async (req, res) => {
-      try {
-        const url = new URL(req.url, 'http://127.0.0.1');
-        const parts = url.pathname.split('/').filter(Boolean);
-        const id = parts[2];
-        const action = parts[3];
-
-        if (!id) {
-          sendJson(res, 400, { ok: false, error: 'ID задачи не указан' });
-          return;
-        }
-
-        if (action === 'history' || (req.method === 'GET' && !action)) {
-          const limit = parseInt(url.searchParams.get('limit') || '20', 10);
-          const history = store.getHistory(id, limit);
-          sendJson(res, 200, { ok: true, history });
-          return;
-        }
-
-        if (action === 'run') {
-          await scheduler.triggerManualRun(id);
-          const task = store.get(id);
-          sendJson(res, 200, { ok: true, task });
-          return;
-        }
-
-        if (action === 'toggle') {
-          const current = store.get(id);
-          if (!current) {
-            sendJson(res, 404, { ok: false, error: 'Задача не найдена' });
-            return;
-          }
-          const task = scheduler.toggleTask(id);
-          sendJson(res, 200, { ok: true, task });
-          return;
-        }
-
-        if (action === 'delete') {
-          const current = store.get(id);
-          if (current) {
-            scheduler.pauseTask(id);
-            store.delete(id);
-          }
-          sendJson(res, 200, { ok: true });
-          return;
-        }
-
-        sendJson(res, 405, { ok: false, error: 'Action not supported' });
-      } catch (err) {
-        sendJson(res, 500, { ok: false, error: err.message });
-      }
-    }
-  }), 'dsh-cron: /action/:id/:action');
-
   // 2. Tools
   ctx.tools.register(defineTool({
     name: 'cron_create_task',
-    description: 'Создать новую запланированную задачу cron (запуск по расписанию или разово через "at: ISO" или "in 20m")',
-    parameters: {
-      title: { type: 'string', description: 'Краткое название задачи', required: true },
-      schedule: { type: 'string', description: 'Расписание: cron ("0 9 * * *"), интервал ("every 2h") или разово ("in 30m", "at: 2026-09-05T15:00:00Z")', required: true },
-      prompt: { type: 'string', description: 'Промпт/инструкция для агента при запуске', required: true },
-      type: { type: 'string', enum: ['prompt', 'script'], description: 'Тип задачи' },
-      delivery: { type: 'string', enum: ['current', 'isolated'], description: 'Режим запуска: current (в текущем чате) или isolated (изолированная сессия)' },
-      provider: { type: 'string', description: 'Провайдер модели (опционально)' },
-      model: { type: 'string', description: 'Модель (опционально)' },
-      notifyTelegram: { type: 'boolean', description: 'Отправлять отчет в Telegram' },
-      onlyOnFailure: { type: 'boolean', description: 'Отправлять отчет только при сбоях' },
-      timeoutSeconds: { type: 'number', description: 'Лимит времени выполнения в секундах' },
-      overlapPolicy: { type: 'string', enum: ['skip', 'queue', 'replace'], description: 'Политика перекрытия' },
-      kanbanMode: { type: 'string', enum: ['none', 'on_failure', 'always'], description: 'Создавать карточку в Kanban' },
-    },
-    output: {
-      schema: {
-        type: 'object',
-        additionalProperties: true,
-        properties: {
-          success: { type: 'boolean' },
-          message: { type: 'string' },
-          task: { type: 'object', additionalProperties: true }
-        }
-      },
-      render: (_args, val) => [{ type: 'text', text: val.message || JSON.stringify(val) }]
-    },
-    execute: async (args) => {
-      const taskType = args.type === 'script' ? 'script' : 'llm';
-      const parsed = parseScheduleExpression(args.schedule);
-      const task = store.set({
-        title: args.title,
-        schedule: parsed.cronPattern || args.schedule,
-        scheduleText: parsed.humanText,
-        prompt: args.prompt,
-        type: taskType,
-        delivery: args.delivery || 'isolated',
-        status: 'active',
-        provider: args.provider,
-        model: args.model,
-        notifyTelegram: Boolean(args.notifyTelegram),
-        onlyOnFailure: Boolean(args.onlyOnFailure),
-        timeoutSeconds: Number(args.timeoutSeconds) || 1800,
-        overlapPolicy: args.overlapPolicy || 'skip',
-        kanbanMode: args.kanbanMode || 'none',
-        oneShot: Boolean(parsed.isOneShot),
-      });
-      scheduler.scheduleTask(task);
-      return {
-        success: true,
-        message: `Задача "${task.title}" успешно запланирована (${task.scheduleText})`,
-        task
-      };
-    }
+    description: 'Create a new scheduled cron task (cron schedule, or one-shot via "at: <ISO timestamp>" or "in 20m")',
+    parameters: createTaskParameters,
+    output: createTaskOutput,
+    execute: async (args) => executeCreateTask(store, scheduler, args)
   }));
 
   // Alias tool cron_schedule_task for compatibility with agent prompts (#70)
   ctx.tools.register(defineTool({
     name: 'cron_schedule_task',
-    description: 'Алиас для cron_create_task: создать новую запланированную задачу cron',
-    parameters: {
-      title: { type: 'string', description: 'Краткое название задачи', required: true },
-      schedule: { type: 'string', description: 'Расписание: cron, интервал или разово', required: true },
-      prompt: { type: 'string', description: 'Промпт/инструкция для агента при запуске', required: true },
-      type: { type: 'string', enum: ['llm', 'prompt', 'script'], description: 'Тип задачи' },
-      delivery: { type: 'string', enum: ['current', 'isolated'], description: 'Режим запуска' },
-      provider: { type: 'string', description: 'Провайдер модели (опционально)' },
-      model: { type: 'string', description: 'Модель (опционально)' },
-      notifyTelegram: { type: 'boolean', description: 'Отправлять отчет в Telegram' },
-      onlyOnFailure: { type: 'boolean', description: 'Отправлять отчет только при сбоях' },
-      timeoutSeconds: { type: 'number', description: 'Лимит времени выполнения в секундах' },
-      overlapPolicy: { type: 'string', enum: ['skip', 'queue', 'replace'], description: 'Политика перекрытия' },
-      kanbanMode: { type: 'string', enum: ['none', 'on_failure', 'always'], description: 'Создавать карточку в Kanban' },
-    },
-    output: {
-      schema: {
-        type: 'object',
-        additionalProperties: true,
-        properties: {
-          success: { type: 'boolean' },
-          message: { type: 'string' },
-          task: { type: 'object', additionalProperties: true }
-        }
-      },
-      render: (_args, val) => [{ type: 'text', text: val.message || JSON.stringify(val) }]
-    },
-    execute: async (args) => {
-      const taskType = args.type === 'script' ? 'script' : 'llm';
-      const parsed = parseScheduleExpression(args.schedule);
-      const task = store.set({
-        title: args.title,
-        schedule: parsed.cronPattern || args.schedule,
-        scheduleText: parsed.humanText,
-        prompt: args.prompt,
-        type: taskType,
-        delivery: args.delivery || 'isolated',
-        status: 'active',
-        provider: args.provider,
-        model: args.model,
-        notifyTelegram: Boolean(args.notifyTelegram),
-        onlyOnFailure: Boolean(args.onlyOnFailure),
-        timeoutSeconds: Number(args.timeoutSeconds) || 1800,
-        overlapPolicy: args.overlapPolicy || 'skip',
-        kanbanMode: args.kanbanMode || 'none',
-        oneShot: Boolean(parsed.isOneShot),
-      });
-      scheduler.scheduleTask(task);
-      return {
-        success: true,
-        message: `Задача "${task.title}" успешно запланирована (${task.scheduleText})`,
-        task
-      };
-    }
+    description: 'Alias for cron_create_task: create a new scheduled cron task',
+    parameters: createTaskParameters,
+    output: createTaskOutput,
+    execute: async (args) => executeCreateTask(store, scheduler, args)
   }));
 
   ctx.tools.register(defineTool({
     name: 'cron_list_tasks',
-    description: 'Получить список всех запланированных задач cron',
+    description: 'List all scheduled cron tasks',
     parameters: {
-      status: { type: 'string', enum: ['all', 'active', 'paused', 'completed'], description: 'Фильтр по статусу' }
+      status: { type: 'string', enum: ['all', 'active', 'paused', 'completed'], description: 'Filter by status' }
     },
     output: {
       schema: {
@@ -560,7 +518,7 @@ export function apply(ctx, config) {
           tasks: { type: 'array', items: { type: 'object', additionalProperties: true } }
         }
       },
-      render: (_args, val) => [{ type: 'text', text: `Всего задач: ${val.count}` }]
+      render: (_args, val) => [{ type: 'text', text: `Total tasks: ${val.count}` }]
     },
     execute: async (args) => {
       const tasks = store.list({ status: args.status || 'all' });
@@ -583,9 +541,9 @@ export function apply(ctx, config) {
 
   ctx.tools.register(defineTool({
     name: 'cron_pause_task',
-    description: 'Приостановить выполнение задачи по её ID',
+    description: 'Pause a task by its ID',
     parameters: {
-      id: { type: 'string', description: 'Идентификатор задачи', required: true }
+      id: { type: 'string', description: 'Task identifier', required: true }
     },
     output: {
       schema: {
@@ -600,16 +558,16 @@ export function apply(ctx, config) {
     },
     execute: async (args) => {
       const task = scheduler.pauseTask(args.id);
-      if (!task) return { success: false, message: 'Задача не найдена' };
-      return { success: true, message: `Задача "${task.title}" приостановлена` };
+      if (!task) return { success: false, message: 'Task not found' };
+      return { success: true, message: `Task "${task.title}" paused` };
     }
   }));
 
   ctx.tools.register(defineTool({
     name: 'cron_resume_task',
-    description: 'Возобновить выполнение приостановленной задачи',
+    description: 'Resume a paused task',
     parameters: {
-      id: { type: 'string', description: 'Идентификатор задачи', required: true }
+      id: { type: 'string', description: 'Task identifier', required: true }
     },
     output: {
       schema: {
@@ -624,16 +582,16 @@ export function apply(ctx, config) {
     },
     execute: async (args) => {
       const task = scheduler.resumeTask(args.id);
-      if (!task) return { success: false, message: 'Задача не найдена' };
-      return { success: true, message: `Задача "${task.title}" возобновлена (${task.scheduleText})` };
+      if (!task) return { success: false, message: 'Task not found' };
+      return { success: true, message: `Task "${task.title}" resumed (${task.scheduleText})` };
     }
   }));
 
   ctx.tools.register(defineTool({
     name: 'cron_delete_task',
-    description: 'Удалить задачу по её ID',
+    description: 'Delete a task by its ID',
     parameters: {
-      id: { type: 'string', description: 'Идентификатор задачи', required: true }
+      id: { type: 'string', description: 'Task identifier', required: true }
     },
     output: {
       schema: {
@@ -649,15 +607,15 @@ export function apply(ctx, config) {
     execute: async (args) => {
       scheduler.pauseTask(args.id);
       const ok = store.delete(args.id);
-      return { success: ok, message: ok ? 'Задача удалена' : 'Задача не найдена' };
+      return { success: ok, message: ok ? 'Task deleted' : 'Task not found' };
     }
   }));
 
   ctx.tools.register(defineTool({
     name: 'cron_run_task',
-    description: 'Запустить задачу немедленно вне очереди',
+    description: 'Trigger a task immediately, out of band',
     parameters: {
-      id: { type: 'string', description: 'Идентификатор задачи', required: true }
+      id: { type: 'string', description: 'Task identifier', required: true }
     },
     output: {
       schema: {
@@ -672,9 +630,9 @@ export function apply(ctx, config) {
     },
     execute: async (args) => {
       const task = store.get(args.id);
-      if (!task) return { success: false, message: 'Задача не найдена' };
+      if (!task) return { success: false, message: 'Task not found' };
       scheduler.triggerManualRun(args.id);
-      return { success: true, message: `Запущен внеплановый старт задачи "${task.title}"` };
+      return { success: true, message: `Manual run started for task "${task.title}"` };
     }
   }));
 }