Current robot status: activity (cleaning, paused, returning, charging, docked, ready, error or offline), battery %, current room, error codes, bag full/missing flags and firmware, plus settings (water flow, deep mop, pet waste avoidance, child lock, voice). Never fails for connectivity: an unreachable robot reports activity 'offline' with a message.

Rooms on the robot's map, groups of numbered segments (e.g. 'Living Room' covers 'Living Room 1..3') and the user's room aliases. Use these names with matic_start_cleaning.

Dust bag usage since the last recorded bag swap: swap date, days, runs, total cleaning, vacuum and mop seconds, whether the robot reports the bag full or missing, previous bags and an estimate of the remaining life. The robot has no fill gauge, only full/missing flags. If 'complete' is false, runs before 'counted_from' may be missing; say so.

Recent cleaning runs, newest first: start and end (UTC), total duration, vacuum and mop seconds, rooms, modes and whether the run completed. The robot keeps about 20 runs; older ones come from the local ledger.

A 1024x1024 PNG of the floor plan with room names, the robot's position and, while a run is active, its route.

Start the robot cleaning now. Give rooms, or set whole_floor for everything. Pick mode from the user's words: 'vacuum' when they say vacuum (or hoover/sweep), 'mop' when they say mop, 'both' (vacuum then mop) when they just say clean or ask for both. coverage: 'standard' unless they ask for a quick pass ('quick') or a deep, thorough clean ('heavy_duty'). ordered: true only if they want the rooms done in the order given. Returns the rooms accepted and the robot's activity a few seconds later.

Pause the current cleaning run (resume later with matic_resume).

Resume a paused cleaning run.

Stop and end the current cleaning run (the robot stays where it is). Use matic_dock to send it home.

Send the robot back to its dock (ends the current run).

Change one robot setting and return all settings. water_flow: mop water amount, 0.5 to 2.0 in 0.1 steps (1.0 is normal). deep_mop: double-pass mopping, on/off. pet_waste: pet waste avoidance, on/off. child_lock: on/off. voice: spoken prompts, on/off.

Record that the user changed the robot's dust bag, then return the bag report. Omit when if they changed it today or just now. For an earlier day pass that local date or time, e.g. '2026-10-06' or '2026-10-06T18:30' (convert 'yesterday' or 'last Monday' to a date yourself). A date earlier than the current bag's swap corrects it (the later swap is removed), so use this to fix a wrong date too.

Create or replace a room alias so the user can say e.g. 'office' for 'Room 3' or 'downstairs' for several rooms. An alias can't reuse a room name, a group name or 'all'. Returns the updated rooms, groups and aliases.