QuartzAgentScheduler

AgentScheduler implementation based on Quartz Scheduler.

This scheduler integrates with Quartz to provide robust task scheduling capabilities for agents within the application. It supports various scheduling modes and lifecycle management.

Key Features:

• In-memory or persistent scheduling (configurable via Quartz properties)

• Support for cron expressions, fixed rate, and fixed delay execution

• Full lifecycle management: schedule, pause, resume, cancel

• Thread-safe task management

Prerequisites:

• Quartz dependencies must be on the classpath

• Proper configuration of Quartz properties if using persistence

Usage Example:

`// 1. Create scheduler
AgentScheduler scheduler = QuartzAgentScheduler.builder()
.autoStart(true)
.build();

// 2. Create agent configuration
AgentConfig agentConfig = AgentConfig.builder()
.name("MyAgent")
.description("My scheduled agent")
.agentFactory(() -> ReActAgent.builder()
.name("MyAgent")
.model(model)
.toolkit(toolkit)
.build())
.build();

// 3. Configure schedule
ScheduleConfig scheduleConfig = ScheduleConfig.builder()
.scheduleMode(ScheduleMode.CRON)
.cronExpression("0 0 8 * * ?") // Run at 8:00 AM every day
.build();

// 4. Schedule the agent
ScheduleAgentTask task = scheduler.schedule(agentConfig, scheduleConfig);

// 5. Manage task
scheduler.pause("MyAgent");
scheduler.resume("MyAgent");
scheduler.cancel("MyAgent");
`

Important Notes:

• Uses a QuartzAgentSchedulerRegistry to bridge Quartz Jobs with Scheduler instances

• Supports FIXED_DELAY mode by manually rescheduling triggers after job completion

• Each scheduler instance has a unique ID to support multiple schedulers in the same JVM