Plugin API Reference

function onLoad() {
  console.log("Plugin loaded!");
  // One-time initialization
}

function onEnable() {
  // Register event listeners
  elysium.events.on("task.completed", handleTaskComplete);
  elysium.events.on("habit.completed", handleHabitComplete);
}

function onDisable() {
  // Clean up
  elysium.events.off("task.completed", handleTaskComplete);
  elysium.events.off("habit.completed", handleHabitComplete);
}

function onUnload() {
  // Final cleanup
  console.log("Plugin unloaded");
}

// Get all tasks
const tasks = await elysium.tasks.list();

// Get tasks with filters
const overdue = await elysium.tasks.list({
  status: "todo",
  overdue: true
});

// Get a specific task
const task = await elysium.tasks.get("task-id");

// Create a new task
await elysium.tasks.create({
  title: "Review pull request",
  due: "2024-03-15",
  tags: ["work", "code-review"]
});

// Update a task
await elysium.tasks.update("task-id", {
  status: "done"
});

// Get all habits
const habits = await elysium.habits.list();

// Get habit with streak info
const habit = await elysium.habits.get("habit-id");
console.log(habit.streak, habit.bestStreak);

// Log a habit completion
await elysium.habits.complete("habit-id");

// Get completion history
const history = await elysium.habits.history("habit-id", {
  days: 30
});

// Get all goals
const goals = await elysium.goals.list();

// Update goal progress
await elysium.goals.updateProgress("goal-id", {
  current: 75,
  target: 100
});

// Get milestones
const milestones = await elysium.goals.milestones("goal-id");

// Get all odysseys (multi-step journeys)
const odysseys = await elysium.odysseys.list();

// Get odyssey with steps
const odyssey = await elysium.odysseys.get("odyssey-id");
console.log(odyssey.steps, odyssey.currentStep);

// Update progress
await elysium.odysseys.advanceStep("odyssey-id");

// Get appointments
const appointments = await elysium.appointments.list();

// Get appointments for a date range
const upcoming = await elysium.appointments.list({
  from: "2024-03-15",
  to: "2024-03-22"
});

// Create an appointment
await elysium.appointments.create({
  title: "Team standup",
  startTime: "2024-03-15T09:00:00",
  endTime: "2024-03-15T09:30:00"
});

// Get all reminders
const reminders = await elysium.reminders.list();

// Create a reminder
await elysium.reminders.create({
  title: "Take medication",
  time: "2024-03-15T08:00:00",
  repeat: "daily"
});

// Delete a reminder
await elysium.reminders.delete("reminder-id");

// Get all categories
const categories = await elysium.categories.list();

// Get all tags
const tags = await elysium.tags.list();

// Create a category
await elysium.categories.create({
  name: "Work",
  color: "#3b82f6"
});

elysium.goals.*         // Goals and milestones
elysium.tasks.*         // Tasks and to-dos
elysium.habits.*        // Habits and streaks
elysium.odysseys.*      // Multi-step journeys
elysium.appointments.*  // Calendar appointments
elysium.reminders.*     // Time-based reminders
elysium.categories.*    // Item categories
elysium.tags.*          // Tags management
elysium.timeline.*      // Timeline access
elysium.schedules.*     // Schedule management
elysium.events.*        // Event listeners
elysium.commands.*      // Register commands
elysium.storage.*       // Plugin data persistence
elysium.settings.*      // App settings access
elysium.theme.*         // Theme customization
elysium.ui.*            // UI components
elysium.notifications.* // System notifications
elysium.console.*       // Debug logging

// Inject a view into the empty state area
elysium.ui.injectView({
  id: "daily-stats",
  slot: "empty_state",
  view: {
    type: "card",
    title: "Today's Progress",
    content: "3 of 5 tasks completed"
  }
});

// Update an existing injected view (same id replaces it)
elysium.ui.injectView({
  id: "daily-stats",
  slot: "empty_state",
  view: {
    type: "card",
    title: "Today's Progress",
    content: "5 of 5 tasks completed!"
  }
});

elysium.ui.removeView("daily-stats");

const emptyStateViews = elysium.ui.getViewsForSlot("empty_state");

"commands": [
  {
    "id": "show-quote",
    "name": "Show Daily Quote",
    "description": "Display today's motivational quote"
  },
  {
    "id": "reset-stats",
    "name": "Reset Statistics",
    "description": "Reset all plugin statistics"
  }
]

function onLoad() {
  elysium.commands.register("show-quote", "Show Daily Quote", showQuoteHandler);
  elysium.commands.register("reset-stats", "Reset Statistics", resetStatsHandler);
}

function showQuoteHandler() {
  elysium.ui.showNotification({
    title: "Daily Quote",
    message: "The only way to do great work is to love what you do.",
    type: "info"
  });
}