SPEC: add GUI interface feature requirement
Add section 5.8 GUI Interface with: - Cross-platform Python GUI (Windows and Linux support) - Default harness from %APPDATA%/agent-cost-estimator/settings.json - Tree view of sessions in chronological order (latest on top) - Three columns: model, session price, current turn price - Status: Not Implemented Generated by Mistral Vibe. Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
This commit is contained in:
@@ -36,6 +36,7 @@ updated: 2026-10-24
|
||||
- [5.5. Hook System](#55-hook-system)
|
||||
- [5.6. Integration Command](#56-integration-command)
|
||||
- [5.7. Output Formatting](#57-output-formatting)
|
||||
- [5.8. GUI Interface](#58-gui-interface)
|
||||
- [6. Configuration Files](#6-configuration-files)
|
||||
- [6.1. pricing.json](#61-pricingjson)
|
||||
- [6.2. User Configurable Pricing Files](#62-user-configurable-pricing-files)
|
||||
@@ -885,6 +886,85 @@ When a model falls back to default pricing, all output modes include:
|
||||
**model price not available**
|
||||
```
|
||||
|
||||
### 5.8. GUI Interface
|
||||
|
||||
**Status:** Not Implemented
|
||||
|
||||
**Purpose:** Provide a graphical user interface for visualizing session costs
|
||||
and interacting with the cost estimator in a user-friendly way.
|
||||
|
||||
**Platform Support:**
|
||||
- Windows: Native support
|
||||
- Linux: Native support
|
||||
- Uses cross-platform Python GUI framework (e.g., Tkinter, PyQt, or similar)
|
||||
|
||||
**Default Harness Configuration:**
|
||||
|
||||
- **Settings File Location:**
|
||||
- Windows: `%APPDATA%\agent-cost-estimator\settings.json`
|
||||
- Linux: `$XDG_CONFIG_HOME/agent-cost-estimator/settings.json`
|
||||
(defaults to `~/.config/agent-cost-estimator/settings.json`)
|
||||
|
||||
- **settings.json Structure:**
|
||||
```json
|
||||
{
|
||||
"default_harness": "vibe"
|
||||
}
|
||||
```
|
||||
|
||||
- **Default Harness:** On first launch, if settings.json does not exist,
|
||||
default to `vibe` harness
|
||||
|
||||
- **Harness Selection:** User can change the default harness in settings,
|
||||
which persists across application restarts
|
||||
|
||||
**GUI Components:**
|
||||
|
||||
- **Main Window:**
|
||||
- Title: "Agent Cost Estimator"
|
||||
- Menu bar with File, View, Help menus
|
||||
- Status bar showing current harness and version
|
||||
|
||||
- **Session Tree View:**
|
||||
- **Display:** Tree structure showing all discovered sessions
|
||||
- **Ordering:** Chronological order, latest session on top
|
||||
- **Root Nodes:** Each harness (vibe, hermes) as a root node
|
||||
- **Child Nodes:** Individual sessions under each harness
|
||||
- **Session Discovery:** Auto-discover sessions from harness home directories
|
||||
|
||||
- **Columns Display:**
|
||||
- **Column 1 - Model:**
|
||||
- Format: `provider:model` (e.g., `mistral:mistral-medium`)
|
||||
- Source: Session metadata from meta.json
|
||||
- **Column 2 - Session Price:**
|
||||
- Format: `$X.XX` (USD currency)
|
||||
- Value: Cumulative cost for the entire session
|
||||
- Calculation: Sum of all token costs (input + output + cached) * pricing
|
||||
- **Column 3 - Current Turn Price:**
|
||||
- Format: `$Y.YY` (USD currency)
|
||||
- Value: Cost of the most recent turn in the session
|
||||
- Calculation: Token costs for the latest turn * pricing
|
||||
|
||||
- **Tree View Behavior:**
|
||||
- Single click on session: Selects the session
|
||||
- Double click on session: Opens detailed view for that session
|
||||
- Right click on session: Context menu with actions (refresh, copy, etc.)
|
||||
- Auto-refresh: Optional periodic refresh of session data
|
||||
|
||||
**Data Source:**
|
||||
|
||||
- Uses existing harness adapters to read session data
|
||||
- Reuses pricing configuration from existing pricing system
|
||||
- Combines data from both bundled and custom pricing files
|
||||
|
||||
**Future Enhancements:**
|
||||
|
||||
- Add per-turn breakdown view
|
||||
- Add filtering and sorting capabilities
|
||||
- Add export functionality (CSV, JSON)
|
||||
- Add historical cost charts
|
||||
- Add real-time cost tracking with live updates
|
||||
|
||||
## 6. Configuration Files
|
||||
|
||||
### 6.1. pricing.json
|
||||
|
||||
Reference in New Issue
Block a user