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:
nvaldez
2026-11-03 16:42:55 +01:00
parent d9a52e0366
commit 2af0ff0ee4
+80
View File
@@ -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