Start a video-clipping job. Ask the user for aspect_ratio and caption_style if they're not given. If the user says 'just pick,' default to aspect_ratio '9:16' and caption_style 'minimalist'. Videos must be 2–180 minutes long. Jobs take 10–30 minutes; Vugola will email the user when done, and the agent can check status via get_clip_status.

Check whether a clipping job is done. Call this when the user asks about a job they've already started.

Return how many credits the user has, their plan, and how many they've used this month.

Schedule clips or media to post on supported social platforms. Ask the user for platform, post_type, caption, and scheduled_at if missing. Instagram carousels need 2-10 items. YouTube, TikTok, and Instagram single posts require media.

List scheduled social posts. Optional filters: status ('scheduled' | 'processing' | 'posted' | 'failed'), platform, limit (default 20, max 100), offset. Use this when the user asks about their calendar, queue, or upcoming posts.

Cancel a scheduled post before it goes live. Only works for posts with status 'scheduled' — posts that are already processing or posted can't be cancelled and will return an error. Get the post_id from list_scheduled_posts.

Download a rendered clip to the user's local Downloads folder (or a configured directory). Returns the saved file path and size in bytes. Use this after get_clip_status reports a job is complete, with the clip_index (1-based) matching the clip the user wants. Don't call this for jobs that are still processing.

Add captions to a short video (up to 5 minutes). Ask the user for aspect_ratio and caption_style if they're not given. If the user says 'just pick,' default to aspect_ratio '9:16' and caption_style 'minimalist'. Jobs take 3-8 minutes; Vugola will email the user when done, and the agent can check status via get_clip_status.