Skip to content

trading_agent.client.subagent_commands

The trading-agent subagents list command: shows every subagent definition and any that cannot be read.

Typical usage example:

exit_code = SubagentCommands(library).list()

SubagentCommands 

SubagentCommands(library, output=stdout)

Lists subagents for the user.

Creates the commands.

Parameters:

Name Type Description Default
library SubagentLibrary

The definitions.

 required
output TextIO

Where to print.

 stdout
Source code in src/trading_agent/client/subagent_commands.py 
18
19
20
21
22
23
24
25
26
27
28
29
30
def __init__(
    self,
    library: subagent_library_module.SubagentLibrary,
    output: TextIO = sys.stdout,
):
    """Creates the commands.

    Args:
        library (subagent_library_module.SubagentLibrary): The definitions.
        output (TextIO): Where to print.
    """
    self._library = library
    self._output = output

list 

list()

Prints each subagent, then each file that could not be read.

Returns:

Type Description
int

0 when every file was readable, 1 otherwise.
Source code in src/trading_agent/client/subagent_commands.py 
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
def list(self) -> int:
    """Prints each subagent, then each file that could not be read.

    Returns:
        int: 0 when every file was readable, 1 otherwise.
    """
    definitions = self._library.definitions()
    if not definitions:
        self._print(f'No subagents in {self._library.agents_directory}.')
    for definition in definitions:
        models = (
            ', '.join(definition.models)
            if definition.models
            else "the desk's order"
        )
        tools = definition.tool_names or subagent_toolbox.DEFAULT_TOOL_NAMES
        self._print(f'{definition.name}: {definition.description}')
        self._print(
            f'  model: {models}; up to {definition.maximum_turns} turns and {definition.timeout_seconds} s'
        )
        self._print(f'  tools: {", ".join(tools)}')
        self._print(f'  file: {definition.path}')
    broken = self._library.broken()
    for item in broken:
        self._print(f'cannot read {item.path}: {item.error}')
    if broken:
        return 1
    return 0