Enum A2aCommands 

pub enum A2aCommands {
    Serve {
        host: String,
        port: u16,
        base_url: Option<String>,
        enable_push: bool,
    },
    Discover {
        agent_url: String,
    },
    SendTask {
        agent_url: String,
        message: String,
        stream: bool,
        context_id: Option<String>,
    },
    ListTasks {
        agent_url: String,
        context_id: Option<String>,
        limit: u32,
    },
    GetTask {
        agent_url: String,
        task_id: String,
    },
    CancelTask {
        agent_url: String,
        task_id: String,
    },
}

A2A Protocol commands

Variants

Serve

Serve VT Code as an A2A agent (requires a2a-server feature)

Starts an HTTP server exposing A2A endpoints:

• /.well-known/agent-card.json - Agent discovery
• /a2a - JSON-RPC endpoint for task management
• /a2a/stream - Server-Sent Events streaming

Examples: vtcode a2a serve –port 8080 vtcode a2a serve –host 0.0.0.0 –port 8080

Fields

host: String

Host to bind the server to

port: u16

Port to listen on

base_url: Option<String>

Base URL for the agent (used in agent card)

enable_push: bool

Enable push notifications via webhooks

Discover

Discover and display information about a remote A2A agent

Fetches and displays the agent card from the remote agent, showing capabilities, skills, and supported features.

Examples: vtcode a2a discover https://agent.example.com vtcode a2a discover https://localhost:8080

Fields

agent_url: String

URL of the remote A2A agent

SendTask

Send a task to a remote A2A agent

Sends a message to a remote agent and returns the task result. The agent will process the request and return structured results.

Examples: vtcode a2a send-task https://agent.example.com “Help me refactor this code” vtcode a2a send-task https://localhost:8080 “Explain this error message”

Fields

agent_url: String

URL of the remote A2A agent

message: String

The task/message to send to the agent

stream: bool

Wait for task completion and stream progress

context_id: Option<String>

Optional context ID for conversation tracking

ListTasks

List active tasks in a running A2A agent

Queries a remote A2A agent for its current and recent tasks.

Examples: vtcode a2a list-tasks https://agent.example.com vtcode a2a list-tasks https://localhost:8080 –context-id my-conversation

Fields

agent_url: String

URL of the remote A2A agent

context_id: Option<String>

Filter by context ID

limit: u32

Maximum number of tasks to return

GetTask

Get details about a specific task

Retrieves the current status, artifacts, and history of a task.

Examples: vtcode a2a get-task https://agent.example.com task-123 vtcode a2a get-task https://localhost:8080 task-456

Fields

agent_url: String

URL of the remote A2A agent

task_id: String

Task ID to retrieve

CancelTask

Cancel a running task

Requests cancellation of a task that is currently being processed.

Examples: vtcode a2a cancel-task https://agent.example.com task-123

Fields

agent_url: String

URL of the remote A2A agent

task_id: String

Task ID to cancel

Trait Implementations

impl Clone for A2aCommands

fn clone(&self) -> A2aCommands

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for A2aCommands

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for A2aCommands

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for A2aCommands

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand