Fix bug to compute usage metrics

Author: amrit110

services/analytics/app/components/templates-table.tsx

@@ -52,7 +52,7 @@ export function TemplatesTable({ templates }: TemplatesTableProps) {
                 </Tooltip>
               </th>
               <th className="px-6 py-4 text-right text-xs font-semibold text-slate-700 dark:text-slate-300 uppercase tracking-wider">
-                <Tooltip content="Sum of all workspace lifetime hours (from creation to now) for this template" position="right">
+                <Tooltip content="Sum of workspace usage hours (time from first connection to last connection) for this template" position="right">
                   Total Hours
                 </Tooltip>
               </th>

services/analytics/app/template/[templateName]/template-teams-content.tsx

@@ -215,7 +215,7 @@ export default function TemplateTeamsContent({ user, templateName }: TemplateTea
                       </Tooltip>
                     </th>
                     <th className="px-6 py-4 text-right text-xs font-semibold text-slate-700 dark:text-slate-300 uppercase tracking-wider">
-                      <Tooltip content="Sum of all workspace lifetime hours for this team">
+                      <Tooltip content="Sum of workspace usage hours (time from first connection to last connection) for this team">
                         Total Hours
                       </Tooltip>
                     </th>

services/analytics/lib/metrics.ts

@@ -38,6 +38,47 @@ function hoursBetween(date1: Date, date2: Date): number {
   return Math.floor(diffTime / (1000 * 60 * 60));
 }
 
+/**
+ * Calculate workspace usage hours based on agent connection window
+ * Uses first_connected_at to last_connected_at for more accurate usage tracking
+ */
+function calculateWorkspaceUsageHours(workspace: CoderWorkspace): number {
+  try {
+    const resources = workspace.latest_build?.resources || [];
+    let earliestConnection: Date | null = null;
+    let latestConnection: Date | null = null;
+
+    for (const resource of resources) {
+      const agents = resource.agents || [];
+      for (const agent of agents) {
+        if (agent.first_connected_at) {
+          const firstConnected = new Date(agent.first_connected_at);
+          if (!earliestConnection || firstConnected < earliestConnection) {
+            earliestConnection = firstConnected;
+          }
+        }
+        if (agent.last_connected_at) {
+          const lastConnected = new Date(agent.last_connected_at);
+          if (!latestConnection || lastConnected > latestConnection) {
+            latestConnection = lastConnected;
+          }
+        }
+      }
+    }
+
+    // If we have both connection timestamps, calculate the usage window
+    if (earliestConnection && latestConnection) {
+      return hoursBetween(earliestConnection, latestConnection);
+    }
+
+    // Fallback: if no connections yet, workspace has 0 usage hours
+    return 0;
+  } catch (error) {
+    console.warn(`Error calculating usage hours for workspace ${workspace.id}:`, error);
+    return 0;
+  }
+}
+
 /**
  * Classify activity status based on days since last active
  */
@@ -161,7 +202,7 @@ export function enrichWorkspaceData(
     const lastActive = getLastActiveTimestamp(workspace);
     const daysSinceActive = daysBetween(new Date(lastActive), now);
     const daysSinceCreated = daysBetween(new Date(workspace.created_at), now);
-    const workspaceHours = hoursBetween(new Date(workspace.created_at), now);
+    const workspaceHours = calculateWorkspaceUsageHours(workspace);
 
     // Determine full name
     let ownerName = workspace.owner_name;

services/analytics/lib/types.ts

@@ -123,7 +123,7 @@ export interface WorkspaceMetrics {
   last_build_at: string;
   days_since_created: number;
   days_since_active: number;
-  workspace_hours: number;  // Total lifetime hours (from creation to now)
+  workspace_hours: number;  // Total usage hours (from first connection to last connection)
 
   // Build metrics
   total_builds: number;
@@ -141,8 +141,8 @@ export interface TeamMetrics {
   unique_active_users: number;    // Number of unique users with activity in last 7 days
 
   // Time-based metrics
-  total_workspace_hours: number;  // Sum of all workspace lifetime hours
-  avg_workspace_hours: number;    // Average workspace lifetime hours
+  total_workspace_hours: number;  // Sum of all workspace usage hours (first to last connection)
+  avg_workspace_hours: number;    // Average workspace usage hours (first to last connection)
   active_days: number;            // Number of unique days with workspace activity
 
   // Template breakdown
@@ -189,8 +189,8 @@ export interface TemplateMetrics {
   total_workspaces: number;
   active_workspaces: number;
   unique_active_users: number;    // Number of unique users with activity in last 7 days
-  total_workspace_hours: number;  // Sum of all workspace lifetime hours for this template
-  avg_workspace_hours: number;    // Average workspace lifetime hours
+  total_workspace_hours: number;  // Sum of workspace usage hours (first to last connection) for this template
+  avg_workspace_hours: number;    // Average workspace usage hours (first to last connection)
   team_distribution: Record<string, number>;
 }