Skip to content

App

The main application module containing the TUI application class.

Main Textual application for Agent Runner.

AgentDetails

Bases: VerticalScroll

Widget showing details of the selected agent.

Source code in src/opensymbolicai_cli/app.py 
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
class AgentDetails(VerticalScroll):
    """Widget showing details of the selected agent."""

    def compose(self) -> ComposeResult:
        yield Vertical(id="agent-details-content")

    def show_agent(self, agent: DiscoveredAgent) -> None:
        """Display high-level agent information."""
        content = self.query_one("#agent-details-content", Vertical)
        content.remove_children()

        # Agent name
        content.mount(Static(f"[bold]{agent.name}[/bold]", classes="detail-title"))

        # Description
        if agent.description:
            content.mount(Static(agent.description, classes="detail-text"))
            content.mount(Static(""))

        # High-level metadata
        content.mount(Static(f"Class: [bold]{agent.class_name}[/bold]"))
        content.mount(Static(f"Base: {agent.base_class}"))
        if agent.version:
            content.mount(Static(f"Version: {agent.version}"))
        content.mount(Static(f"File: {agent.file_path.name}"))

        # Methods summary
        primitives = [m for m in agent.methods if m.method_type == "primitive"]
        decompositions = [m for m in agent.methods if m.method_type == "decomposition"]
        read_only_count = sum(1 for m in primitives if m.read_only)
        mutable_count = len(primitives) - read_only_count

        content.mount(Static(""))
        content.mount(Static("[bold]Capabilities[/bold]", classes="detail-section"))
        content.mount(Static(f"  Primitives: {len(primitives)}"))
        if primitives:
            content.mount(Static(f"    Read-only: {read_only_count}"))
            content.mount(Static(f"    Mutable: {mutable_count}"))
        content.mount(Static(f"  Decompositions: {len(decompositions)}"))

    def show_placeholder(self) -> None:
        """Show placeholder when no agent is selected."""
        content = self.query_one("#agent-details-content", Vertical)
        content.remove_children()
        content.mount(Static("Select an agent to view details", classes="placeholder"))

show_agent(agent)

Display high-level agent information.

Source code in src/opensymbolicai_cli/app.py 
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
def show_agent(self, agent: DiscoveredAgent) -> None:
    """Display high-level agent information."""
    content = self.query_one("#agent-details-content", Vertical)
    content.remove_children()

    # Agent name
    content.mount(Static(f"[bold]{agent.name}[/bold]", classes="detail-title"))

    # Description
    if agent.description:
        content.mount(Static(agent.description, classes="detail-text"))
        content.mount(Static(""))

    # High-level metadata
    content.mount(Static(f"Class: [bold]{agent.class_name}[/bold]"))
    content.mount(Static(f"Base: {agent.base_class}"))
    if agent.version:
        content.mount(Static(f"Version: {agent.version}"))
    content.mount(Static(f"File: {agent.file_path.name}"))

    # Methods summary
    primitives = [m for m in agent.methods if m.method_type == "primitive"]
    decompositions = [m for m in agent.methods if m.method_type == "decomposition"]
    read_only_count = sum(1 for m in primitives if m.read_only)
    mutable_count = len(primitives) - read_only_count

    content.mount(Static(""))
    content.mount(Static("[bold]Capabilities[/bold]", classes="detail-section"))
    content.mount(Static(f"  Primitives: {len(primitives)}"))
    if primitives:
        content.mount(Static(f"    Read-only: {read_only_count}"))
        content.mount(Static(f"    Mutable: {mutable_count}"))
    content.mount(Static(f"  Decompositions: {len(decompositions)}"))

show_placeholder()

Show placeholder when no agent is selected.

Source code in src/opensymbolicai_cli/app.py 
74
75
76
77
78
def show_placeholder(self) -> None:
    """Show placeholder when no agent is selected."""
    content = self.query_one("#agent-details-content", Vertical)
    content.remove_children()
    content.mount(Static("Select an agent to view details", classes="placeholder"))

AgentListItem

Bases: ListItem

A list item representing an agent.

Source code in src/opensymbolicai_cli/app.py 
15
16
17
18
19
20
21
22
23
class AgentListItem(ListItem):
    """A list item representing an agent."""

    def __init__(self, agent: DiscoveredAgent) -> None:
        super().__init__()
        self.agent = agent

    def compose(self) -> ComposeResult:
        yield Static(self.agent.name, classes="agent-name")

AgentRunnerApp

Bases: App[None]

A TUI for discovering and running agents.

Source code in src/opensymbolicai_cli/app.py 
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
class AgentRunnerApp(App[None]):
    """A TUI for discovering and running agents."""

    TITLE = "OpenSymbolicAI Agent Runner"
    CSS = """
    Screen {
        layout: grid;
        grid-size: 2;
        grid-columns: 1fr 3fr;
    }

    Sidebar {
        width: 100%;
        height: 100%;
        border: solid $primary;
        padding: 1;
    }

    .sidebar-title {
        text-style: bold;
        color: $accent;
        margin-bottom: 1;
    }

    #agent-list {
        height: 1fr;
    }

    .agent-name {
        padding: 0 1;
    }

    MainContent {
        width: 100%;
        height: 100%;
        border: solid $secondary;
        padding: 1;
    }

    .content-title {
        text-style: bold;
        color: $accent;
        margin-bottom: 1;
    }

    #agent-details {
        height: 1fr;
    }

    .detail-title {
        text-style: bold;
        color: $accent;
        margin-bottom: 1;
    }

    .detail-section {
        color: $accent;
        margin-top: 1;
    }

    .detail-text {
        color: $text-muted;
    }

    .placeholder {
        color: $text-muted;
        text-style: italic;
    }
    """

    BINDINGS = [
        Binding("q", "quit", "Quit"),
        Binding("d", "details", "Details"),
        Binding("s", "settings", "Settings"),
        Binding("r", "refresh", "Refresh"),
        Binding("?", "help", "Help"),
    ]

    def __init__(self) -> None:
        super().__init__()
        self.settings = Settings.load()
        self.agents: list[DiscoveredAgent] = []
        self.selected_agent: DiscoveredAgent | None = None

    def compose(self) -> ComposeResult:
        yield Header()
        yield Sidebar()
        yield MainContent()
        yield Footer()

    def on_mount(self) -> None:
        """Called when the app is mounted."""
        self._scan_agents()

    def _scan_agents(self) -> None:
        """Scan for agents in the configured folder."""
        agent_list = self.query_one("#agent-list", ListView)
        details = self.query_one("#agent-details", AgentDetails)
        agent_list.clear()

        if not self.settings.agents_folder:
            details.show_placeholder()
            self.notify("No agents folder configured. Press 's' to set one.")
            return

        if not self.settings.agents_folder.exists():
            details.show_placeholder()
            self.notify(f"Agents folder not found: {self.settings.agents_folder}")
            return

        self.agents = scan_directory_for_agents(self.settings.agents_folder)

        if not self.agents:
            details.show_placeholder()
            self.notify("No agents found in the configured folder.")
            return

        for agent in self.agents:
            agent_list.append(AgentListItem(agent))

        # Auto-select the first agent
        agent_list.index = 0
        self.selected_agent = self.agents[0]
        details.show_agent(self.agents[0])

        self.notify(f"Found {len(self.agents)} agent(s)")

    def on_list_view_highlighted(self, event: ListView.Highlighted) -> None:
        """Handle cursor movement in the agent list."""
        if isinstance(event.item, AgentListItem):
            self.selected_agent = event.item.agent
            details = self.query_one("#agent-details", AgentDetails)
            details.show_agent(event.item.agent)

    def on_list_view_selected(self, event: ListView.Selected) -> None:
        """Handle agent selection from the list - opens execution screen."""
        if isinstance(event.item, AgentListItem):
            self.selected_agent = event.item.agent
            # Open execution screen when Enter is pressed
            self.push_screen(AgentExecutionScreen(event.item.agent, self.settings))

    def action_settings(self) -> None:
        """Open the settings screen."""
        self.push_screen(SettingsScreen(self.settings), self._on_settings_closed)

    def _on_settings_closed(self, settings: Settings | None) -> None:
        """Handle settings screen closing."""
        if settings is not None:
            self.settings = settings
            settings.save()
            self.notify(f"Settings saved: {settings.default_provider}/{settings.default_model}")
            # Rescan agents with new folder
            self._scan_agents()

    def action_refresh(self) -> None:
        """Refresh the agent list."""
        self._scan_agents()

    def action_help(self) -> None:
        """Show help."""
        self.notify("Help: q=quit, d=details, s=settings, r=refresh, ?=help")

    def action_details(self) -> None:
        """Open the agent details screen."""
        if self.selected_agent is None:
            self.notify("No agent selected")
            return
        if not self.selected_agent.methods:
            self.notify("No methods found for this agent")
            return
        self.push_screen(AgentDetailsScreen(self.selected_agent))

action_details()

Open the agent details screen.

Source code in src/opensymbolicai_cli/app.py 
251
252
253
254
255
256
257
258
259
def action_details(self) -> None:
    """Open the agent details screen."""
    if self.selected_agent is None:
        self.notify("No agent selected")
        return
    if not self.selected_agent.methods:
        self.notify("No methods found for this agent")
        return
    self.push_screen(AgentDetailsScreen(self.selected_agent))

action_help()

Show help.

Source code in src/opensymbolicai_cli/app.py 
247
248
249
def action_help(self) -> None:
    """Show help."""
    self.notify("Help: q=quit, d=details, s=settings, r=refresh, ?=help")

action_refresh()

Refresh the agent list.

Source code in src/opensymbolicai_cli/app.py 
243
244
245
def action_refresh(self) -> None:
    """Refresh the agent list."""
    self._scan_agents()

action_settings()

Open the settings screen.

Source code in src/opensymbolicai_cli/app.py 
230
231
232
def action_settings(self) -> None:
    """Open the settings screen."""
    self.push_screen(SettingsScreen(self.settings), self._on_settings_closed)

on_list_view_highlighted(event)

Handle cursor movement in the agent list.

Source code in src/opensymbolicai_cli/app.py 
216
217
218
219
220
221
def on_list_view_highlighted(self, event: ListView.Highlighted) -> None:
    """Handle cursor movement in the agent list."""
    if isinstance(event.item, AgentListItem):
        self.selected_agent = event.item.agent
        details = self.query_one("#agent-details", AgentDetails)
        details.show_agent(event.item.agent)

on_list_view_selected(event)

Handle agent selection from the list - opens execution screen.

Source code in src/opensymbolicai_cli/app.py 
223
224
225
226
227
228
def on_list_view_selected(self, event: ListView.Selected) -> None:
    """Handle agent selection from the list - opens execution screen."""
    if isinstance(event.item, AgentListItem):
        self.selected_agent = event.item.agent
        # Open execution screen when Enter is pressed
        self.push_screen(AgentExecutionScreen(event.item.agent, self.settings))

on_mount()

Called when the app is mounted.

Source code in src/opensymbolicai_cli/app.py 
179
180
181
def on_mount(self) -> None:
    """Called when the app is mounted."""
    self._scan_agents()

MainContent

Bases: Static

Main content area for agent details.

Source code in src/opensymbolicai_cli/app.py 
81
82
83
84
85
86
class MainContent(Static):
    """Main content area for agent details."""

    def compose(self) -> ComposeResult:
        yield Static("Agent Details", classes="content-title")
        yield AgentDetails(id="agent-details")

Sidebar

Bases: Static

Sidebar widget for agent list.

Source code in src/opensymbolicai_cli/app.py 
26
27
28
29
30
31
class Sidebar(Static):
    """Sidebar widget for agent list."""

    def compose(self) -> ComposeResult:
        yield Static("Agents", classes="sidebar-title")
        yield ListView(id="agent-list")