Support "bring" in custom api (#1226)

Enables things like:

```talon
foo bar <user.cursorless_target>:
    some.stuff()
    user.cursorless_command("replaceWithTarget", cursorless_target)
    other.stuff()
```

## Checklist

- [ ] I have added
[tests](https://www.cursorless.org/docs/contributing/test-case-recorder/)
- [ ] I have updated the
[docs](https://github.com/cursorless-dev/cursorless/tree/main/docs) and
[cheatsheet](https://github.com/cursorless-dev/cursorless/tree/main/cursorless-talon/src/cheatsheet)
- [ ] I have not broken the cheatsheet

Co-authored-by: Andreas Arvidsson <[email protected]>

Author: pokey

cursorless-talon/src/actions/actions.py

@@ -1,6 +1,7 @@
 from talon import Module, actions, app
 
 from ..csv_overrides import init_csv_and_watch_changes
+from ..primitive_target import IMPLICIT_TARGET
 from .actions_callback import callback_action_defaults, callback_action_map
 from .actions_custom import custom_action_defaults
 from .actions_simple import (
@@ -43,6 +44,10 @@ def cursorless_command(action_id: str, target: dict):
             actions.user.cursorless_single_target_command_no_wait(action_id, target)
             if action_id in no_wait_actions_post_sleep:
                 actions.sleep(no_wait_actions_post_sleep[action_id])
+        elif action_id in ["replaceWithTarget", "moveToTarget"]:
+            actions.user.cursorless_multiple_target_command(
+                action_id, [target, IMPLICIT_TARGET.copy()]
+            )
         else:
             return actions.user.cursorless_single_target_command(action_id, target)
 

docs/user/customization.md

@@ -111,10 +111,11 @@ Cursorless exposes a couple talon actions and captures that you can use to defin
 
 ### Public Talon actions
 
-- `user.cursorless_command(action_id: str, target: cursorless_target)`
+- `user.cursorless_command(action_id: str, target: cursorless_target)`:
   Perform a Cursorless command on the given target
-  eg: `user.cursorless_command("setSelection", cursorless_target)`
-- `user.cursorless_ide_command(command_id: str, target: cursorless_target)`
+  eg: `user.cursorless_command("setSelection", cursorless_target)`.
+  Note that for `"bring"` (`replaceWithTarget`), `cursorless_target` will be the source of the bring and the destination will be the current selection(s), as if you had said `"bring <target>"`
+- `user.cursorless_ide_command(command_id: str, target: cursorless_target)`:
   Performs a built-in IDE command on the given target
   eg: `user.cursorless_ide_command("editor.action.addCommentLine", cursorless_target)`