lom_call
Invoke an allowlisted method on a Live object via its dotted path and method name. Use only when no dedicated tool exists; prefer create_clip, delete_track, set_tempo, and similar tools.
Instructions
Invoke an allowlisted method on a Live object.
The escape hatch for the calls that have no tool of their own, such as
``song.move_device`` for reordering a device chain. What it can reach is bounded
by the Remote Script's allowlist, not by this signature.
Returns:
Dictionary reporting the call and its return value. A refused call names the
reason, and where a dedicated tool covers the same ground it comes back with
``use_instead`` naming that tool.
Note:
A method call has no read-back, so nothing here proves the effect the way a
write through lom_set or set_parameter does. Follow it with the matching read
(get_devices after a move, get_session after a structural change) rather than
treating a successful return as evidence.
Prefer the dedicated tool wherever one exists: create_clip, delete_track,
set_tempo, play and stop all verify what this cannot. Use lom_get and lom_set
for properties, which are not reachable as methods, and lom_batch to send
several calls in one round trip.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| args | No | Positional arguments, in order. Keyword arguments are not supported. A Live object is passed as a reference dict, {'__path__': 'song.tracks[2]'}, rather than as a name or an index. | |
| path | Yes | Dotted LOM path to the object the method sits on, e.g. 'song' for song.move_device or 'song.tracks[0]' for a track method. The object that owns the method, not the object being acted on. | |
| method | Yes | Method name to invoke, e.g. 'move_device'. Only names on the Remote Script's allowlist are accepted; lom_describe lists the ones permitted on a given object. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||