break_out_of_automation
Break a port free from Advance Automation by disabling the governing automation and locking co-ports to their current speeds, allowing safe manual control on AC Infinity controllers.
Instructions
Break a port out of Advance Automation control and lock co-governed ports.
This is the safe way to manually override a port that is currently under Advance Automation. It:
Checks that the port is actually under automation (idempotent: no-ops if not).
Finds the governing automation.
Identifies all other ports in the same automation as the target port (co-ports). Only those ports are locked — ports in other automations or empty ports are unaffected.
On dry_run=False: a. Disables the automation. b. Locks each co-port to its current manual speed (prevents unexpected speed changes). c. Leaves the target port free for your manual change.
Defaults to dry_run=True. For live execution (dry_run=False), you must supply
confirm_automation_name matching the automation name (case-insensitive) as a
safety confirmation.
Args: device_id: The AC Infinity device code (from discover_devices). port: The port number you want to break free (1-based). dry_run: If True (default), returns the execution plan without making changes. confirm_automation_name: Required when dry_run=False — the name of the automation to disable, for safety confirmation.
Returns:
Dry-run: JSON plan with sequence of steps, co_ports_to_lock, estimated_duration.
Live: JSON with co_ports_locked and target_port_freed.
Idempotent: {"info": "Port is not currently under automation control."}
On failure returns {"error": "..."}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device_id | Yes | ||
| port | Yes | ||
| dry_run | No | ||
| confirm_automation_name | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |