Skip to content

1.2.0

Choose a tag to compare

@mutilator mutilator released this 26 Feb 14:56

[1.2.0] - 2026-02-26

Calendar Event Management Services

This release introduces Calendar Services to Clockwork, enabling programmatic management of calendar events directly from automations and scripts.

Added

  • Calendar Service: Delete Event

    • Delete a single calendar event by ID
    • Supports recurring event deletion (all events or single occurrence)
    • Full error handling with helpful error messages in logs
  • Calendar Service: Update Event

    • Modify event properties (summary, description, location, start/end times)
    • Supports recurring event updates (affects all occurrences)
    • Validates calendar entity and event existence before updating
    • Timezone-aware datetime handling
  • Calendar Service: Delete Events in Range

    • Batch delete all calendar events within a date range
    • Supports date-only filtering (deletes matching date regardless of time)
    • Useful for clearing calendar periods or cleanup operations
  • Custom Automation Condition: Last Triggered

    • Check how long it's been since an automation was last triggered
    • Compare timespan using above, below, and equal_to operators (in seconds)
    • Only allows selecting automation domain entities (automation.*)
    • Uses the last_triggered attribute timestamp for calculations
    • Available in the visual automation editor with robot icon
    • Supports standard Home Assistant automation fields (alias, enabled)
    • Use cases: Re-run automations if not triggered recently, conditional actions based on automation trigger timing, debouncing
  • Service Documentation

    • Comprehensive service definitions in services.yaml with schema validation
    • Wiki page with usage examples and automation integration patterns
    • README updated with calendar services feature and link
  • Test Coverage

    • Full test suite for calendar service registration and handler verification
    • Integration with existing test infrastructure

Technical Details

  • Services registered in clockwork domain (clockwork.delete_event, etc.)
  • Async service handlers with proper error handling and logging
  • Entity lookup via Home Assistant calendar component
  • Support for all calendar entity types