mirror of
https://github.com/jlengrand/Maestro.git
synced 2026-03-10 08:31:19 +00:00
66b2895d90
- Added session lifecycle tracking with created/closed events and durations 🚀 - Introduced `session_lifecycle` SQLite table plus indexes via v3 migration 🗄️ - Expanded stats aggregation with total sessions, per-agent, per-day rollups 📊 - Usage Dashboard gained a new “Sessions” summary card (now six metrics) 🧩 - New IPC endpoints to record sessions and fetch lifecycle history cleanly 🔌 - Session create/close events now fire automatically from the main app flow 🧠 - Old-data cleanup now purges session lifecycle rows for leaner databases 🧹 - Stats collection toggle respected for session-created recording, avoiding noise 🔒 - Updated typings across shared/renderer APIs for new session stats fields 🧾 - Bumped package version to 0.14.1 for this stats upgrade release 🎉
112 lines
2.8 KiB
TypeScript
112 lines
2.8 KiB
TypeScript
/**
|
|
* Type definitions for the stats tracking system
|
|
*
|
|
* These types are shared between main process (stats-db.ts) and renderer (dashboard).
|
|
*/
|
|
|
|
/**
|
|
* A single AI query event - represents one user/auto message -> AI response cycle
|
|
*/
|
|
export interface QueryEvent {
|
|
id: string;
|
|
sessionId: string;
|
|
agentType: string;
|
|
source: 'user' | 'auto';
|
|
startTime: number;
|
|
duration: number;
|
|
projectPath?: string;
|
|
tabId?: string;
|
|
/** Whether this query was executed on a remote SSH session */
|
|
isRemote?: boolean;
|
|
}
|
|
|
|
/**
|
|
* An Auto Run session - a complete batch processing run of a document
|
|
*/
|
|
export interface AutoRunSession {
|
|
id: string;
|
|
sessionId: string;
|
|
agentType: string;
|
|
documentPath?: string;
|
|
startTime: number;
|
|
duration: number;
|
|
tasksTotal?: number;
|
|
tasksCompleted?: number;
|
|
projectPath?: string;
|
|
}
|
|
|
|
/**
|
|
* A single task within an Auto Run session
|
|
*/
|
|
export interface AutoRunTask {
|
|
id: string;
|
|
autoRunSessionId: string;
|
|
sessionId: string;
|
|
agentType: string;
|
|
taskIndex: number;
|
|
taskContent?: string;
|
|
startTime: number;
|
|
duration: number;
|
|
success: boolean;
|
|
}
|
|
|
|
/**
|
|
* Session lifecycle event - tracks when sessions are created and closed
|
|
*/
|
|
export interface SessionLifecycleEvent {
|
|
id: string;
|
|
sessionId: string;
|
|
agentType: string;
|
|
projectPath?: string;
|
|
createdAt: number;
|
|
closedAt?: number;
|
|
/** Duration in ms (computed from closedAt - createdAt when session is closed) */
|
|
duration?: number;
|
|
/** Whether this was a remote SSH session */
|
|
isRemote?: boolean;
|
|
}
|
|
|
|
/**
|
|
* Time range for querying stats
|
|
*/
|
|
export type StatsTimeRange = 'day' | 'week' | 'month' | 'year' | 'all';
|
|
|
|
/**
|
|
* Aggregated stats for dashboard display
|
|
*/
|
|
export interface StatsAggregation {
|
|
totalQueries: number;
|
|
totalDuration: number;
|
|
avgDuration: number;
|
|
byAgent: Record<string, { count: number; duration: number }>;
|
|
bySource: { user: number; auto: number };
|
|
byDay: Array<{ date: string; count: number; duration: number }>;
|
|
/** Breakdown by session location (local vs SSH remote) */
|
|
byLocation: { local: number; remote: number };
|
|
/** Breakdown by hour of day (0-23) for peak hours chart */
|
|
byHour: Array<{ hour: number; count: number; duration: number }>;
|
|
/** Total unique sessions launched in the time period */
|
|
totalSessions: number;
|
|
/** Sessions by agent type */
|
|
sessionsByAgent: Record<string, number>;
|
|
/** Sessions launched per day */
|
|
sessionsByDay: Array<{ date: string; count: number }>;
|
|
/** Average session duration in ms (for closed sessions) */
|
|
avgSessionDuration: number;
|
|
}
|
|
|
|
/**
|
|
* Filters for querying stats
|
|
*/
|
|
export interface StatsFilters {
|
|
agentType?: string;
|
|
source?: 'user' | 'auto';
|
|
projectPath?: string;
|
|
sessionId?: string;
|
|
}
|
|
|
|
/**
|
|
* Database schema version for migrations
|
|
*/
|
|
export const STATS_DB_VERSION = 3;
|