modules

type Module interface {
	// Name returns the unique identifier for this module (e.g. "email", "finance").
	Name() string

	// Description returns a human-readable summary of what the module does.
	Description() string

	// Tools returns the set of tools this module exposes to the agent.
	Tools() []agent.Tool

	// ScheduledTasks returns tasks that should run on a cron schedule.
	ScheduledTasks() []ScheduledTask

	// Init configures the module with its config section and a memory store
	// for persisting state. Called once at startup before any tools or tasks run.
	Init(cfg map[string]any, mem *memory.Store) error
}

type ScheduledTask struct {
	Name string
	Cron string // standard 5-field cron expression: minute hour day month weekday
	Task func(ctx context.Context, a *agent.Agent) error
}