List configured TimeTree public calendars. Without args, returns the calendars set in TIMETREE_CALENDAR_ALIASES env var. Pass alias_codes to override (each code is the short ID in the URL https://timetr.ee/p/). Returns calendar id, alias_code, name, category, subscription count, and label palette.

List events in a TimeTree public calendar within a date range. Pass alias_code (from list_calendars) and ISO date strings for from/to. Timezone defaults to Asia/Taipei.

Create an event in a TimeTree public calendar that the authenticated account manages. Use this after reading an event poster: pass alias_code (from list_calendars), title, ISO start date, optional location, and a short description (1-2 sentences). Timezone defaults to Asia/Taipei. Returns the created event with id and public URL.

Update an existing event in a TimeTree public calendar (full replace — PUT). Use this to add/replace/remove a cover image on an existing event, or change title/time/etc. Pass event_id (from list_events) plus all the fields you want the event to have. For cover: pass image_path to upload+set a new one, or remove_image=true to clear it; if neither is passed, cover is CLEARED (PUT is full-replace). To preserve the current cover while editing other fields, you must re-upload via image_path.

Prepare and inspect the local poster workflow folder. Creates the standard folders if missing, moves loose image files from the root into 00_待處理 by default, and returns only pending poster image paths that should be read next.

Move one poster image out of 00_待處理 after processing and append the CSV log. Normally create_event/update_event do this automatically when image_path is inside 00_待處理. Use this for manual corrections or posters that need review.