fix(webapp): show sessions with no live run as Idle instead of Active

Session status was derived only from closedAt/expiresAt, so an open session
whose run had already finished stayed Active forever and its duration ticked
up from createdAt without end. Status is now derived from the current run's
liveness: a session with no live run reads Idle, and its duration freezes at
the run's completion instead of counting up. Active is reserved for sessions
with a run actually executing. Applies to the sessions list and the session
detail page.

Author: D-K-P

.server-changes/sessions-idle-status.md

@@ -0,0 +1,6 @@
+---
+area: webapp
+type: fix
+---
+
+The Sessions list no longer shows an abandoned session as Active with a duration that climbs forever. A session whose run has finished now shows as Idle with a duration frozen at when it stopped, and only sessions with a run still executing show as Active.

apps/webapp/app/components/sessions/v1/SessionStatus.tsx

@@ -1,26 +1,34 @@
 import { CheckCircleIcon, ClockIcon } from "@heroicons/react/20/solid";
 import assertNever from "assert-never";
-import { type SessionStatus } from "~/services/sessionsRepository/sessionsRepository.server";
+import {
+  type SessionDisplayStatus,
+  type SessionStatus,
+} from "~/services/sessionsRepository/sessionsRepository.server";
 import { cn } from "~/utils/cn";
 
+// Filterable statuses only — `IDLE` is display-only and derived from run
+// liveness, so it never appears in the filter surface.
 export const allSessionStatuses = ["ACTIVE", "CLOSED", "EXPIRED"] as const satisfies Readonly<
   Array<SessionStatus>
 >;
 
-const descriptions: Record<SessionStatus, string> = {
-  ACTIVE: "The session is open and can receive input or schedule new runs.",
+const descriptions: Record<SessionDisplayStatus, string> = {
+  ACTIVE: "The session has a run currently executing.",
+  IDLE: "The session is open but has no run currently executing.",
   CLOSED: "The session was closed; no further input or runs can be triggered against it.",
   EXPIRED: "The session passed its expiry time without being closed explicitly.",
 };
 
-export function descriptionForSessionStatus(status: SessionStatus): string {
+export function descriptionForSessionStatus(status: SessionDisplayStatus): string {
   return descriptions[status];
 }
 
-export function sessionStatusTitle(status: SessionStatus): string {
+export function sessionStatusTitle(status: SessionDisplayStatus): string {
   switch (status) {
     case "ACTIVE":
       return "Active";
+    case "IDLE":
+      return "Idle";
     case "CLOSED":
       return "Closed";
     case "EXPIRED":
@@ -30,10 +38,12 @@ export function sessionStatusTitle(status: SessionStatus): string {
   }
 }
 
-export function sessionStatusColor(status: SessionStatus): string {
+export function sessionStatusColor(status: SessionDisplayStatus): string {
   switch (status) {
     case "ACTIVE":
       return "text-pending";
+    case "IDLE":
+      return "text-text-dimmed";
     case "CLOSED":
       return "text-success";
     case "EXPIRED":
@@ -48,7 +58,7 @@ export function SessionStatusIcon({
   className,
   pulse = true,
 }: {
-  status: SessionStatus;
+  status: SessionDisplayStatus;
   className: string;
   pulse?: boolean;
 }) {
@@ -64,6 +74,14 @@ export function SessionStatusIcon({
           </span>
         </span>
       );
+    case "IDLE":
+      // Open but not live: a static, dimmed dot (no pulse) — distinct from
+      // ACTIVE's pulsing dot and EXPIRED's clock.
+      return (
+        <span className={cn("inline-flex items-center justify-center", className)}>
+          <span className="size-2 rounded-full bg-text-dimmed" />
+        </span>
+      );
     case "CLOSED":
       return <CheckCircleIcon className={cn(sessionStatusColor(status), className)} />;
     case "EXPIRED":
@@ -73,7 +91,7 @@ export function SessionStatusIcon({
   }
 }
 
-export function SessionStatusLabel({ status }: { status: SessionStatus }) {
+export function SessionStatusLabel({ status }: { status: SessionDisplayStatus }) {
   // system-mono-label: System themes uncolor the label (see tailwind.css)
   return (
     <span className={cn("system-mono-label", sessionStatusColor(status))}>
@@ -88,7 +106,7 @@ export function SessionStatusCombo({
   iconClassName,
   pulse = true,
 }: {
-  status: SessionStatus;
+  status: SessionDisplayStatus;
   className?: string;
   iconClassName?: string;
   pulse?: boolean;

apps/webapp/app/components/sessions/v1/SessionsTable.tsx

@@ -195,23 +195,29 @@ export function SessionsTable({
 }
 
 function SessionDuration({ session }: { session: SessionListItem }) {
-  // Active sessions tick live; closed/expired sessions freeze at the
-  // moment they ended (closedAt for explicit closes, expiresAt when the
-  // TTL ran out without a close call).
+  // Only a genuinely live session ticks. Everything else freezes at the moment
+  // it stopped being live: closedAt for explicit closes, expiresAt when the TTL
+  // ran out, or the current run's completedAt for an idle (open, not-running)
+  // session — so an abandoned session doesn't count up forever.
+  if (session.status === "ACTIVE") {
+    return <LiveTimer startTime={new Date(session.createdAt)} />;
+  }
+
   const endedAt =
     session.status === "CLOSED"
       ? session.closedAt
       : session.status === "EXPIRED"
         ? session.expiresAt
-        : undefined;
+        : session.currentRunCompletedAt;
 
   if (endedAt) {
     return (
       <>{formatDuration(new Date(session.createdAt), new Date(endedAt), { style: "short" })}</>
     );
   }
 
-  return <LiveTimer startTime={new Date(session.createdAt)} />;
+  // Idle session that never ran — nothing to measure.
+  return <span className="text-text-dimmed">–</span>;
 }
 
 function SessionActionsCell({ runPath, allRunsPath }: { runPath?: string; allRunsPath: string }) {

apps/webapp/app/presenters/v3/SessionListPresenter.server.ts

@@ -10,6 +10,7 @@ import {
   LEGACY_PLAYGROUND_TAG,
 } from "~/services/sessionsRepository/sessionsRepository.server";
 import { ServiceValidationError } from "~/v3/services/baseService.server";
+import { deriveSessionStatus } from "./deriveSessionStatus";
 import { findCurrentWorkerFromEnvironment } from "~/v3/models/workerDeployment.server";
 import { runStore } from "~/v3/runStore.server";
 import { startActiveSpan } from "~/v3/tracer.server";
@@ -192,7 +193,7 @@ export class SessionListPresenter {
                   projectId,
                   runtimeEnvironmentId: environmentId,
                 },
-                select: { id: true, friendlyId: true },
+                select: { id: true, friendlyId: true, status: true, completedAt: true },
               },
               this.replica
             )
@@ -205,15 +206,19 @@ export class SessionListPresenter {
 
     return {
       sessions: sessions.map((session) => {
-        const status: SessionStatus =
-          session.closedAt != null
-            ? "CLOSED"
-            : session.expiresAt != null && session.expiresAt.getTime() < now
-              ? "EXPIRED"
-              : "ACTIVE";
-
         const currentRun = session.currentRunId ? runById.get(session.currentRunId) : undefined;
 
+        // A session is only ACTIVE while its current run is genuinely live.
+        // Open sessions whose run has terminated (or that have no run) read
+        // IDLE rather than ticking ACTIVE forever.
+        const status = deriveSessionStatus({
+          closedAt: session.closedAt,
+          expiresAt: session.expiresAt,
+          currentRunId: session.currentRunId,
+          currentRunStatus: currentRun?.status,
+          now,
+        });
+
         return {
           id: session.id,
           friendlyId: session.friendlyId,
@@ -235,6 +240,11 @@ export class SessionListPresenter {
           updatedAt: session.updatedAt.toISOString(),
           environment: displayableEnvironment,
           currentRunFriendlyId: currentRun?.friendlyId,
+          // Freeze point for an IDLE session's duration — when its current run
+          // finished. Undefined when the session never ran (renders as a dash).
+          currentRunCompletedAt: currentRun?.completedAt
+            ? currentRun.completedAt.toISOString()
+            : undefined,
         };
       }),
       pagination: {

apps/webapp/app/presenters/v3/deriveSessionStatus.test.ts

@@ -0,0 +1,92 @@
+import { describe, expect, it } from "vitest";
+import { deriveSessionStatus } from "./deriveSessionStatus";
+
+const NOW = new Date("2026-08-06T12:00:00.000Z").getTime();
+const PAST = new Date("2026-08-01T00:00:00.000Z");
+const FUTURE = new Date("2026-08-10T00:00:00.000Z");
+
+describe("deriveSessionStatus", () => {
+  it("returns CLOSED when closedAt is set, even with a live run", () => {
+    expect(
+      deriveSessionStatus({
+        closedAt: PAST,
+        expiresAt: null,
+        currentRunId: "run_1",
+        currentRunStatus: "EXECUTING",
+        now: NOW,
+      })
+    ).toBe("CLOSED");
+  });
+
+  it("prefers CLOSED over an elapsed expiresAt", () => {
+    expect(
+      deriveSessionStatus({
+        closedAt: PAST,
+        expiresAt: PAST,
+        currentRunId: null,
+        currentRunStatus: undefined,
+        now: NOW,
+      })
+    ).toBe("CLOSED");
+  });
+
+  it("returns EXPIRED when expiresAt is in the past", () => {
+    expect(
+      deriveSessionStatus({
+        closedAt: null,
+        expiresAt: PAST,
+        currentRunId: "run_1",
+        currentRunStatus: "EXECUTING",
+        now: NOW,
+      })
+    ).toBe("EXPIRED");
+  });
+
+  it("returns ACTIVE when the current run is non-final", () => {
+    expect(
+      deriveSessionStatus({
+        closedAt: null,
+        expiresAt: FUTURE,
+        currentRunId: "run_1",
+        currentRunStatus: "EXECUTING",
+        now: NOW,
+      })
+    ).toBe("ACTIVE");
+  });
+
+  it("returns IDLE when the current run has reached a terminal state", () => {
+    expect(
+      deriveSessionStatus({
+        closedAt: null,
+        expiresAt: null,
+        currentRunId: "run_1",
+        currentRunStatus: "EXPIRED",
+        now: NOW,
+      })
+    ).toBe("IDLE");
+  });
+
+  it("returns IDLE when there is no current run", () => {
+    expect(
+      deriveSessionStatus({
+        closedAt: null,
+        expiresAt: null,
+        currentRunId: null,
+        currentRunStatus: undefined,
+        now: NOW,
+      })
+    ).toBe("IDLE");
+  });
+
+  it("returns IDLE when the current run pointer can't be resolved (status unknown)", () => {
+    expect(
+      deriveSessionStatus({
+        closedAt: null,
+        expiresAt: null,
+        currentRunId: "run_missing",
+        currentRunStatus: undefined,
+        now: NOW,
+      })
+    ).toBe("IDLE");
+  });
+});

apps/webapp/app/presenters/v3/deriveSessionStatus.ts

@@ -0,0 +1,46 @@
+import { type TaskRunStatus } from "@trigger.dev/database";
+import { type SessionDisplayStatus } from "~/services/sessionsRepository/sessionsRepository.server";
+import { isFinalRunStatus } from "~/v3/taskStatus";
+
+export type DeriveSessionStatusInput = {
+  /** `Session.closedAt` — set once when the session is explicitly closed. */
+  closedAt: Date | null;
+  /** `Session.expiresAt` — retention deadline, if any. */
+  expiresAt: Date | null;
+  /** `Session.currentRunId` — pointer to the current run (no FK). */
+  currentRunId: string | null;
+  /**
+   * Status of the run named by `currentRunId`. `undefined` when there is no
+   * current run, or the pointer couldn't be resolved (stale / cross-env).
+   */
+  currentRunStatus: TaskRunStatus | undefined;
+  /** `Date.now()` at the time of derivation. */
+  now: number;
+};
+
+/**
+ * Derives the display status of a session from its terminal markers and the
+ * liveness of its current run.
+ *
+ * Precedence: an explicit close wins, then an elapsed retention deadline. Only
+ * then do we ask whether the session is genuinely live: it's `ACTIVE` when its
+ * current run exists and is non-final, otherwise `IDLE` (open but nothing
+ * running). This is what stops an abandoned session whose run terminated long
+ * ago from reading `ACTIVE` forever.
+ */
+export function deriveSessionStatus(input: DeriveSessionStatusInput): SessionDisplayStatus {
+  if (input.closedAt != null) {
+    return "CLOSED";
+  }
+
+  if (input.expiresAt != null && input.expiresAt.getTime() < input.now) {
+    return "EXPIRED";
+  }
+
+  const hasLiveRun =
+    input.currentRunId != null &&
+    input.currentRunStatus !== undefined &&
+    !isFinalRunStatus(input.currentRunStatus);
+
+  return hasLiveRun ? "ACTIVE" : "IDLE";
+}