Aptiva

Check on a program started with generate_workout_program. While it is still generating returns status pending; once ready it activates the program as the user's current program and returns it (status complete). Returns failed if generation failed (start again), blocked if another program became active meanwhile, and none if there is nothing generating. job_id defaults to the most recent generation.

get_program_generation

Mark the user's active Aptiva workout program as completed once every day is finished. Fails and lists the unfinished days otherwise.

complete_program

Build a NEW custom workout for the authenticated user from ONLY real, category-scoped exercises, fitted to a target duration, and persist it via ms-user-workouts. Every generated workout ENDS with a short dedicated "Stretching" cool-down section (up to 3 stretches, max 2 minutes) whose time is INCLUDED in target_duration_minutes — do not ask for extra time for it, and do not tell the user to stretch separately; the result reports stretching_duration and stretching_count. If the scoped exercise pool is too small to fill the target, exercises are repeated as extra rounds (max 3 passes) and then per-exercise time is increased (up to 2x); the result reports target_met and duration_shortfall_seconds — relay the real duration to the user when the target is not met.

create_custom_workout

Create the authenticated user's PRIVATE workout program (user-scoped in ms-user-workouts, NOT the public catalogue). References existing catalogue workouts by their IDs.

create_workout_program

Generate a new daily meal plan (calorie and macro targets plus Breakfast, Lunch, Snack and Dinner) for today, a past day or up to 7 days ahead. Use when the day has no plan or the user asks for a new one. Meals already eaten are kept. If a plan exists the tool asks for confirmation first; call again with confirm_replace=true only after the user agrees. Requires Premium. Takes about 10 seconds.

generate_meal_plan

Start generating a new personalised Aptiva workout program for the user from their fitness profile (and their last completed program, if any). Generation runs in the background and takes about a minute; afterwards call get_program_generation to check on it and activate it. Requires Premium. Refuses when the user already has an active program. Optional feedback (how the last program went, what to change) is saved on the completed program and steers the new one. Calling it again while a generation is running returns the same job.

generate_workout_program

Summarise the user's recent Aptiva activity: water intake, mood check-ins, weight log and completed program days. Choose period 'today', '7d' (default) or '30d', or pass from/to dates (YYYY-MM-DD) to override.

get_activity

Retrieve the authenticated user's fitness profile: goals, level, body metrics and this week's calories burned (kcal_week)

get_user_fitness_profile

Read the user's live nutrition for a day in Aptiva: calorie and macro targets, planned meals, what is logged and what is left. Use for "what did I eat", "what's left today" or before suggesting what to eat next. Works for today, a past day, or up to 7 days ahead. The reply always states the date.

get_nutrition_today

Return the authenticated user's stable id, name (when known) and email

get_profile