vorto 0.14.0

A Vim-flavored modal terminal editor with batteries included: tree-sitter, LSP, fuzzy pickers, vim-surround, multi-cursor, and optional Copilot.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

//! AI-agent launcher domain types, shared between the config layer
//! (which resolves the agent catalog + default) and the `:agent` command
//! (which opens an in-app pane). The agent runs in a PTY *inside* vorto
//! ([`session::AgentSession`]); keystrokes are encoded to terminal byte
//! sequences by [`keys::encode_key`].

mod keys;
mod session;

pub use keys::encode_key;
pub use session::{AgentSession, GridSnapshot};

/// Placeholder substituted with the prompt text in [`AgentSpec::prompt_args`].
pub const PROMPT_PLACEHOLDER: &str = "{prompt}";

/// A launchable AI agent: a display name plus the command line to run in
/// the new pane. Resolved from the built-in catalog overlaid with the
/// user's `[agents.<name>]` config blocks.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct AgentSpec {
    /// Catalog key — what the picker shows and `[agent].default` names.
    pub name: String,
    /// Executable to launch (looked up on `PATH`).
    pub command: String,
    /// Extra arguments passed to `command`.
    pub args: Vec<String>,
    /// Template argv for handing the agent an initial prompt at launch
    /// (e.g. `:agent explain @file`). Appended after [`Self::args`], with
    /// every [`PROMPT_PLACEHOLDER`] occurrence replaced by the prompt text.
    /// Most CLIs take the prompt as a positional arg (`["{prompt}"]`);
    /// aider wants `["--message", "{prompt}"]`. Empty → the agent takes no
    /// launch-time prompt, so a prompted `:agent` opens it bare.
    pub prompt_args: Vec<String>,
}

/// Default `prompt_args` for an agent that doesn't specify its own: pass
/// the prompt as a single positional argument, which claude and codex
/// both accept ("starts an interactive session ... [prompt]").
pub fn default_prompt_args() -> Vec<String> {
    vec![PROMPT_PLACEHOLDER.to_string()]
}

/// Built-in agent catalog. Offered by the picker when the user has no
/// `[agents.*]` of their own; any entry can be overridden by a config
/// block of the same name. Commands assume the agent's CLI is on `PATH`.
pub fn builtin_agents() -> Vec<AgentSpec> {
    // claude/codex/gemini take the prompt positionally; aider's positional
    // args are files, so it gets the prompt via `--message`.
    [
        ("claude", &["{prompt}"][..]),
        ("codex", &["{prompt}"][..]),
        ("gemini", &["{prompt}"][..]),
        ("aider", &["--message", "{prompt}"][..]),
    ]
    .into_iter()
    .map(|(name, prompt_args)| AgentSpec {
        name: name.to_string(),
        command: name.to_string(),
        args: Vec::new(),
        prompt_args: prompt_args.iter().map(|s| s.to_string()).collect(),
    })
    .collect()
}