From 2af0ff0ee45b5ef6e384d1fd2b095bd03d7ebe5c Mon Sep 17 00:00:00 2001 From: nvaldez Date: Tue, 3 Nov 2026 16:42:55 +0100 Subject: [PATCH] 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 --- SPEC.md | 80 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) diff --git a/SPEC.md b/SPEC.md index cd0d5f5..ed7d05c 100644 --- a/SPEC.md +++ b/SPEC.md @@ -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