Added destination and v6 api to Talon (#1717)

Depends on #1637

- Fixes #725
- Partially addresses #1440
- Fixes #1319 

## Checklist

- [/] I have added
[tests](https://www.cursorless.org/docs/contributing/test-case-recorder/)
- [x] 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)
- [x] Update cheatsheet spoken form defaults
- [x] Manually test the various snippet terms
- [x] Manually test the snippet apis
- [ ] I have not broken the cheatsheet

---------

Co-authored-by: Pokey Rule <755842+pokey@users.noreply.github.com>
Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com>

Author: 3 people

src/actions/actions.py

@@ -1,14 +1,15 @@
 from talon import Module, actions, app
 
 from ..csv_overrides import init_csv_and_watch_changes
-from ..primitive_target import create_implicit_target
+from ..targets.target_types import CursorlessTarget, ImplicitDestination
 from .actions_callback import callback_action_defaults, callback_action_map
 from .actions_simple import (
     no_wait_actions,
     no_wait_actions_post_sleep,
-    positional_action_defaults,
     simple_action_defaults,
 )
+from .bring_move import BringMoveTargets
+from .execute_command import cursorless_execute_command_action
 
 mod = Module()
 
@@ -39,55 +40,53 @@ def cursorless_action_or_ide_command(m) -> dict:
 
 @mod.action_class
 class Actions:
-    def cursorless_command(action_id: str, target: dict):
+    def cursorless_command(action_name: str, target: CursorlessTarget):
         """Perform cursorless command on target"""
-        if action_id in callback_action_map:
-            return callback_action_map[action_id](target)
-        elif action_id in no_wait_actions:
-            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, create_implicit_target()]
+        if action_name in callback_action_map:
+            callback_action_map[action_name](target)
+        elif action_name in ["replaceWithTarget", "moveToTarget"]:
+            actions.user.cursorless_bring_move(
+                action_name, BringMoveTargets(target, ImplicitDestination())
             )
+        elif action_name in no_wait_actions:
+            action = {"name": action_name, "target": target}
+            actions.user.private_cursorless_command_no_wait(action)
+            if action_name in no_wait_actions_post_sleep:
+                actions.sleep(no_wait_actions_post_sleep[action_name])
         else:
-            return actions.user.cursorless_single_target_command(action_id, target)
+            action = {"name": action_name, "target": target}
+            actions.user.private_cursorless_command_and_wait(action)
 
-    def cursorless_vscode_command(command_id: str, target: dict):
+    def cursorless_vscode_command(command_id: str, target: CursorlessTarget):
         """
         Perform vscode command on cursorless target
 
         Deprecated: prefer `cursorless_ide_command`
         """
         return actions.user.cursorless_ide_command(command_id, target)
 
-    def cursorless_ide_command(command_id: str, target: dict):
+    def cursorless_ide_command(command_id: str, target: CursorlessTarget):
         """Perform ide command on cursorless target"""
-        return ide_command(command_id, target)
+        return cursorless_execute_command_action(command_id, target)
 
-    def cursorless_action_or_ide_command(instruction: dict, target: dict):
+    def private_cursorless_action_or_ide_command(
+        instruction: dict, target: CursorlessTarget
+    ):
         """Perform cursorless action or ide command on target (internal use only)"""
         type = instruction["type"]
         value = instruction["value"]
         if type == "cursorless_action":
-            return actions.user.cursorless_command(value, target)
+            actions.user.cursorless_command(value, target)
         elif type == "ide_command":
-            return actions.user.cursorless_ide_command(value, target)
-
-
-def ide_command(command_id: str, target: dict, command_options: dict = {}):
-    return actions.user.cursorless_single_target_command(
-        "executeCommand", target, command_id, command_options
-    )
+            actions.user.cursorless_ide_command(value, target)
 
 
 default_values = {
     "simple_action": simple_action_defaults,
-    "positional_action": positional_action_defaults,
     "callback_action": callback_action_defaults,
+    "paste_action": {"paste": "pasteFromClipboard"},
+    "bring_move_action": {"bring": "replaceWithTarget", "move": "moveToTarget"},
     "swap_action": {"swap": "swapTargets"},
-    "move_bring_action": {"bring": "replaceWithTarget", "move": "moveToTarget"},
     "wrap_action": {"wrap": "wrapWithPairedDelimiter", "repack": "rewrap"},
     "insert_snippet_action": {"snippet": "insertSnippet"},
     "reformat_action": {"format": "applyFormatter"},

src/actions/actions_callback.py

@@ -4,8 +4,8 @@
 
 from talon import Module, actions
 
-from .call import run_call_action
-from .homophones import run_homophones_action
+from .call import cursorless_call_action
+from .homophones import cursorless_homophones_action
 
 
 @dataclass
@@ -18,11 +18,9 @@ class CallbackAction:
 # NOTE: Please do not change these dicts.  Use the CSVs for customization.
 # See https://www.cursorless.org/docs/user/customization/
 callbacks = [
-    CallbackAction("call", "callAsFunction", run_call_action),
-    CallbackAction(
-        "scout", "findInDocument", actions.user.cursorless_private_run_find_action
-    ),
-    CallbackAction("phones", "nextHomophone", run_homophones_action),
+    CallbackAction("call", "callAsFunction", cursorless_call_action),
+    CallbackAction("scout", "findInDocument", actions.user.private_cursorless_find),
+    CallbackAction("phones", "nextHomophone", cursorless_homophones_action),
 ]
 
 callback_action_defaults = {

src/actions/actions_simple.py

@@ -44,12 +44,6 @@
     "unfold": "unfoldRegion",
 }
 
-# NOTE: Please do not change these dicts.  Use the CSVs for customization.
-# See https://www.cursorless.org/docs/user/customization/
-positional_action_defaults = {
-    "paste": "pasteFromClipboard",
-}
-
 # Don't wait for these actions to finish, usually because they hang on some kind of user interaction
 no_wait_actions = [
     "generateSnippet",
@@ -66,7 +60,3 @@
     "cursorless_simple_action",
     desc="Supported simple actions for cursorless navigation",
 )
-mod.list(
-    "cursorless_positional_action",
-    desc="Supported actions for cursorless that expect a positional target",
-)

src/actions/bring_move.py

@@ -0,0 +1,46 @@
+from dataclasses import dataclass
+
+from talon import Module, actions
+
+from ..targets.target_types import (
+    CursorlessDestination,
+    CursorlessTarget,
+    ImplicitDestination,
+)
+
+
+@dataclass
+class BringMoveTargets:
+    source: CursorlessTarget
+    destination: CursorlessDestination
+
+
+mod = Module()
+
+
+mod.list("cursorless_bring_move_action", desc="Cursorless bring or move actions")
+
+
+@mod.capture(rule="<user.cursorless_target> [<user.cursorless_destination>]")
+def cursorless_bring_move_targets(m) -> BringMoveTargets:
+    source = m.cursorless_target
+
+    try:
+        destination = m.cursorless_destination
+    except AttributeError:
+        destination = ImplicitDestination()
+
+    return BringMoveTargets(source, destination)
+
+
+@mod.action_class
+class Actions:
+    def private_cursorless_bring_move(action_name: str, targets: BringMoveTargets):
+        """Execute Cursorless move/bring action"""
+        actions.user.private_cursorless_command_and_wait(
+            {
+                "name": action_name,
+                "source": targets.source,
+                "destination": targets.destination,
+            }
+        )

src/actions/call.py

@@ -1,10 +1,13 @@
-from talon import Module, actions
+from talon import actions
 
-from ..primitive_target import create_implicit_target
+from ..targets.target_types import CursorlessTarget, ImplicitTarget
 
-mod = Module()
 
-
-def run_call_action(target: dict):
-    targets = [target, create_implicit_target()]
-    actions.user.cursorless_multiple_target_command("callAsFunction", targets)
+def cursorless_call_action(target: CursorlessTarget):
+    actions.user.private_cursorless_command_and_wait(
+        {
+            "name": "callAsFunction",
+            "callee": target,
+            "argument": ImplicitTarget(),
+        }
+    )

src/actions/execute_command.py

@@ -0,0 +1,17 @@
+from talon import actions
+
+from ..targets.target_types import CursorlessTarget
+
+
+def cursorless_execute_command_action(
+    command_id: str, target: CursorlessTarget, command_options: dict = {}
+):
+    """Execute Cursorless execute command action"""
+    actions.user.private_cursorless_command_and_wait(
+        {
+            "name": "executeCommand",
+            "commandId": command_id,
+            "options": command_options,
+            "target": target,
+        }
+    )

src/actions/find.py

@@ -1,9 +1,11 @@
 from talon import Module
 
+from ..targets.target_types import CursorlessTarget
+
 mod = Module()
 
 
 @mod.action_class
 class Actions:
-    def cursorless_private_run_find_action(target: dict):
-        """Find text of target in editor"""
+    def private_cursorless_find(target: CursorlessTarget):
+        """Execute Cursorless find action. Find text of target in editor"""

src/actions/get_text.py

@@ -2,18 +2,22 @@
 
 from talon import actions
 
+from ..targets.target_types import CursorlessTarget
 
-def get_text(
-    target: dict,
+
+def cursorless_get_text_action(
+    target: CursorlessTarget,
     show_decorations: Optional[bool] = None,
     ensure_single_target: Optional[bool] = None,
-):
+) -> list[str]:
     """Get target texts"""
-    return actions.user.cursorless_single_target_command_get(
-        "getText",
-        target,
+    return actions.user.private_cursorless_command_get(
         {
-            "showDecorations": show_decorations,
-            "ensureSingleTarget": ensure_single_target,
-        },
+            "name": "getText",
+            "options": {
+                "showDecorations": show_decorations,
+                "ensureSingleTarget": ensure_single_target,
+            },
+            "target": target,
+        }
     )

src/actions/homophones.py

@@ -1,17 +1,18 @@
 from talon import actions, app
 
-from .get_text import get_text
+from .get_text import cursorless_get_text_action
+from .replace import cursorless_replace_action
 
 
-def run_homophones_action(target: dict):
+def cursorless_homophones_action(target: dict):
     """Replaced target with next homophone"""
-    texts = get_text(target, show_decorations=False)
+    texts = cursorless_get_text_action(target, show_decorations=False)
     try:
         updated_texts = list(map(get_next_homophone, texts))
     except LookupError as e:
         app.notify(str(e))
         return
-    actions.user.cursorless_replace(target, updated_texts)
+    cursorless_replace_action(target, updated_texts)
 
 
 def get_next_homophone(word: str):