@dexto/tools-scheduler 1.6.0

package/dist/tools/trigger-schedule.js

@@ -0,0 +1,32 @@
+import { TriggerScheduleInputSchema } from "../schemas.js";
+function createTriggerScheduleTool(getManager) {
+  return {
+    id: "trigger_schedule_now",
+    description: "Manually trigger a schedule to execute immediately, outside of its normal schedule.",
+    inputSchema: TriggerScheduleInputSchema,
+    execute: async (input, context) => {
+      const { scheduleId } = input;
+      const manager = await getManager(context);
+      const log = await manager.triggerScheduleNow(scheduleId);
+      const durationLine = log.duration != null ? `Duration: ${log.duration}ms` : "Duration: (unknown)";
+      const errorLine = log.error ?? "Unknown error";
+      const message = log.status === "success" ? `Schedule executed successfully
+
+Execution ID: ${log.id}
+Status: ${log.status}
+${durationLine}
+
+Result:
+${log.result || "(no result)"}` : `Schedule execution failed
+
+Execution ID: ${log.id}
+Status: ${log.status}
+${durationLine}
+Error: ${errorLine}`;
+      return { message, execution: log };
+    }
+  };
+}
+export {
+  createTriggerScheduleTool
+};

package/dist/tools/update-schedule.cjs

@@ -0,0 +1,53 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var update_schedule_exports = {};
+__export(update_schedule_exports, {
+  createUpdateScheduleTool: () => createUpdateScheduleTool
+});
+module.exports = __toCommonJS(update_schedule_exports);
+var import_schemas = require("../schemas.js");
+function createUpdateScheduleTool(getManager) {
+  return {
+    id: "update_schedule",
+    description: `Update an existing scheduled task. Can modify timing, instruction, or session mode.
+
+When changing sessionMode to "inherit", the current conversation will be captured as the target session.`,
+    inputSchema: import_schemas.UpdateScheduleInputSchema,
+    execute: async (input, context) => {
+      const { scheduleId, ...updates } = input;
+      const manager = await getManager(context);
+      const schedule = await manager.updateSchedule(scheduleId, updates, context.sessionId);
+      const sessionInfo = schedule.sessionMode === "inherit" ? `Session: Inheriting conversation (${schedule.sessionId})` : schedule.sessionMode === "fixed" ? `Session: Fixed to ${schedule.sessionId}` : schedule.sessionMode === "dedicated" ? `Session: Dedicated thread` : `Session: Ephemeral (new each run)`;
+      const message = `Schedule updated successfully
+
+ID: ${schedule.id}
+Name: ${schedule.name}
+Cron: ${schedule.cronExpression}
+Mode: ${schedule.sessionMode}
+${sessionInfo}
+Status: ${schedule.enabled ? "Enabled" : "Disabled"}
+Next run: ${schedule.nextRunAt ? new Date(schedule.nextRunAt).toISOString() : "N/A"}`;
+      return { message, schedule };
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createUpdateScheduleTool
+});

package/dist/tools/update-schedule.d.cts

@@ -0,0 +1,14 @@
+import { Tool } from '@dexto/core';
+import { SchedulerManagerGetter } from '../tool-types.cjs';
+import '../manager.cjs';
+import '../schemas.cjs';
+import 'zod';
+import '../types.cjs';
+
+/**
+ * Tool for updating schedules
+ */
+
+declare function createUpdateScheduleTool(getManager: SchedulerManagerGetter): Tool;
+
+export { createUpdateScheduleTool };

package/dist/tools/update-schedule.d.ts

@@ -0,0 +1,14 @@
+import { Tool } from '@dexto/core';
+import { SchedulerManagerGetter } from '../tool-types.js';
+import '../manager.js';
+import '../schemas.js';
+import 'zod';
+import '../types.js';
+
+/**
+ * Tool for updating schedules
+ */
+
+declare function createUpdateScheduleTool(getManager: SchedulerManagerGetter): Tool;
+
+export { createUpdateScheduleTool };

package/dist/tools/update-schedule.js

@@ -0,0 +1,29 @@
+import { UpdateScheduleInputSchema } from "../schemas.js";
+function createUpdateScheduleTool(getManager) {
+  return {
+    id: "update_schedule",
+    description: `Update an existing scheduled task. Can modify timing, instruction, or session mode.
+
+When changing sessionMode to "inherit", the current conversation will be captured as the target session.`,
+    inputSchema: UpdateScheduleInputSchema,
+    execute: async (input, context) => {
+      const { scheduleId, ...updates } = input;
+      const manager = await getManager(context);
+      const schedule = await manager.updateSchedule(scheduleId, updates, context.sessionId);
+      const sessionInfo = schedule.sessionMode === "inherit" ? `Session: Inheriting conversation (${schedule.sessionId})` : schedule.sessionMode === "fixed" ? `Session: Fixed to ${schedule.sessionId}` : schedule.sessionMode === "dedicated" ? `Session: Dedicated thread` : `Session: Ephemeral (new each run)`;
+      const message = `Schedule updated successfully
+
+ID: ${schedule.id}
+Name: ${schedule.name}
+Cron: ${schedule.cronExpression}
+Mode: ${schedule.sessionMode}
+${sessionInfo}
+Status: ${schedule.enabled ? "Enabled" : "Disabled"}
+Next run: ${schedule.nextRunAt ? new Date(schedule.nextRunAt).toISOString() : "N/A"}`;
+      return { message, schedule };
+    }
+  };
+}
+export {
+  createUpdateScheduleTool
+};

package/dist/types.cjs

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/types.d.cts

@@ -0,0 +1,72 @@
+import { ScheduleSessionMode } from './schemas.cjs';
+import 'zod';
+
+/**
+ * Core types for scheduler tool provider
+ */
+
+/**
+ * Schedule definition for automated task execution
+ */
+interface Schedule {
+    id: string;
+    /** Human-readable name for the schedule (e.g., "Coffee Reminder") */
+    name: string;
+    cronExpression: string;
+    timezone: string;
+    enabled: boolean;
+    task: {
+        /** Instruction for the executing agent */
+        instruction: string;
+        metadata?: Record<string, unknown>;
+    };
+    /**
+     * How session context is managed for executions.
+     * @default 'ephemeral'
+     */
+    sessionMode: ScheduleSessionMode;
+    /**
+     * Session ID for 'fixed' mode, or captured session for 'inherit' mode.
+     * Not used for 'ephemeral' or 'dedicated' modes.
+     */
+    sessionId?: string;
+    /** Optional workspace path for executions */
+    workspacePath?: string;
+    createdAt: number;
+    updatedAt: number;
+    lastRunAt?: number;
+    nextRunAt?: number;
+    runCount: number;
+    successCount: number;
+    failureCount: number;
+    lastError?: string;
+}
+/**
+ * Execution log entry for schedule runs
+ */
+interface ExecutionLog {
+    id: string;
+    scheduleId: string;
+    triggeredAt: number;
+    completedAt?: number;
+    status: 'pending' | 'success' | 'failed' | 'timeout';
+    duration?: number;
+    error?: string;
+    result?: string;
+}
+/**
+ * Schedule filters for listing
+ */
+interface ScheduleFilters {
+    enabled?: boolean;
+}
+/**
+ * Executor function type - called to execute scheduled tasks
+ */
+type ScheduleExecutorFn = (params: {
+    prompt: string;
+    sessionId: string;
+    schedule: Schedule;
+}) => Promise<string>;
+
+export type { ExecutionLog, Schedule, ScheduleExecutorFn, ScheduleFilters };

package/dist/types.d.ts

@@ -0,0 +1,72 @@
+import { ScheduleSessionMode } from './schemas.js';
+import 'zod';
+
+/**
+ * Core types for scheduler tool provider
+ */
+
+/**
+ * Schedule definition for automated task execution
+ */
+interface Schedule {
+    id: string;
+    /** Human-readable name for the schedule (e.g., "Coffee Reminder") */
+    name: string;
+    cronExpression: string;
+    timezone: string;
+    enabled: boolean;
+    task: {
+        /** Instruction for the executing agent */
+        instruction: string;
+        metadata?: Record<string, unknown>;
+    };
+    /**
+     * How session context is managed for executions.
+     * @default 'ephemeral'
+     */
+    sessionMode: ScheduleSessionMode;
+    /**
+     * Session ID for 'fixed' mode, or captured session for 'inherit' mode.
+     * Not used for 'ephemeral' or 'dedicated' modes.
+     */
+    sessionId?: string;
+    /** Optional workspace path for executions */
+    workspacePath?: string;
+    createdAt: number;
+    updatedAt: number;
+    lastRunAt?: number;
+    nextRunAt?: number;
+    runCount: number;
+    successCount: number;
+    failureCount: number;
+    lastError?: string;
+}
+/**
+ * Execution log entry for schedule runs
+ */
+interface ExecutionLog {
+    id: string;
+    scheduleId: string;
+    triggeredAt: number;
+    completedAt?: number;
+    status: 'pending' | 'success' | 'failed' | 'timeout';
+    duration?: number;
+    error?: string;
+    result?: string;
+}
+/**
+ * Schedule filters for listing
+ */
+interface ScheduleFilters {
+    enabled?: boolean;
+}
+/**
+ * Executor function type - called to execute scheduled tasks
+ */
+type ScheduleExecutorFn = (params: {
+    prompt: string;
+    sessionId: string;
+    schedule: Schedule;
+}) => Promise<string>;
+
+export type { ExecutionLog, Schedule, ScheduleExecutorFn, ScheduleFilters };

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@dexto/tools-scheduler",
+  "version": "1.6.0",
+  "description": "Scheduler tools provider for Dexto agents - enables proactive task scheduling",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "keywords": [
+    "dexto",
+    "tools",
+    "scheduler",
+    "cron",
+    "automation"
+  ],
+  "dependencies": {
+    "cron-parser": "^4.9.0",
+    "node-cron": "^4.2.1",
+    "zod": "^3.25.0",
+    "@dexto/agent-config": "1.6.0",
+    "@dexto/core": "1.6.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.3"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}