auq-mcp-server 2.2.2 → 2.4.0

package/dist/src/tui/themes/gruvbox-light.js

@@ -91,6 +91,7 @@ export const gruvboxLightTheme = {
             successPillBg: "#ebdbb2", // light1 - light bg
             error: "#9d0006",
             info: "#076678",
+            warning: "#b57614",
             border: "#d5c4a1",
         },
         markdown: {
@@ -105,6 +106,8 @@ export const gruvboxLightTheme = {
             untouched: "#a89984",
             number: "#3c3836",
             activeNumber: "#076678",
+            stale: "#b57614",
+            abandoned: "#9d0006",
         },
         sessionPicker: {
             border: "#076678",
@@ -115,6 +118,10 @@ export const gruvboxLightTheme = {
             highlightFg: "#79740e",
             activeMark: "#076678",
             progress: "#076678",
+            staleIcon: "#b57614",
+            staleText: "#b57614",
+            staleAge: "#b57614",
+            staleSubtitle: "#a89984",
         },
     },
 };

package/dist/src/tui/themes/light.js

@@ -91,6 +91,7 @@ export const lightTheme = {
             successPillBg: "#E6F9EE",
             error: "#CF222E",
             info: "#007EA7",
+            warning: "#B07D00",
             border: "#D0D7DE",
         },
         markdown: {
@@ -105,6 +106,8 @@ export const lightTheme = {
             untouched: "#6E7781",
             number: "#24292F",
             activeNumber: "#007EA7",
+            stale: "#B07D00",
+            abandoned: "#CF222E",
         },
         sessionPicker: {
             border: "#007EA7",
@@ -115,6 +118,10 @@ export const lightTheme = {
             highlightFg: "#2DA44E",
             activeMark: "#007EA7",
             progress: "#007EA7",
+            staleIcon: "#B07D00",
+            staleText: "#B07D00",
+            staleAge: "#B07D00",
+            staleSubtitle: "#6E7781",
         },
     },
 };

package/dist/src/tui/themes/monokai.js

@@ -92,6 +92,7 @@ export const monokaiTheme = {
             successPillBg: "#272822",
             error: "#F92672",
             info: "#66D9EF",
+            warning: "#E6DB74",
             border: "#49483E",
         },
         markdown: {
@@ -106,6 +107,8 @@ export const monokaiTheme = {
             untouched: "#908B78",
             number: "#F8F8F2",
             activeNumber: "#66D9EF",
+            stale: "#E6DB74",
+            abandoned: "#F92672",
         },
         sessionPicker: {
             border: "#66D9EF",
@@ -116,6 +119,10 @@ export const monokaiTheme = {
             highlightFg: "#A6E22E",
             activeMark: "#66D9EF",
             progress: "#66D9EF",
+            staleIcon: "#E6DB74",
+            staleText: "#E6DB74",
+            staleAge: "#E6DB74",
+            staleSubtitle: "#908B78",
         },
     },
 };

package/dist/src/tui/themes/nord.js

@@ -91,6 +91,7 @@ export const nordTheme = {
             successPillBg: "#3b4252", // nord1
             error: "#bf616a", // nord11
             info: "#88c0d0", // nord8
+            warning: "#ebcb8b",
             border: "#3b4252", // nord1
         },
         markdown: {
@@ -105,6 +106,8 @@ export const nordTheme = {
             untouched: "#616E88",
             number: "#eceff4",
             activeNumber: "#88c0d0",
+            stale: "#ebcb8b",
+            abandoned: "#bf616a",
         },
         sessionPicker: {
             border: "#88c0d0",
@@ -115,6 +118,10 @@ export const nordTheme = {
             highlightFg: "#a3be8c",
             activeMark: "#88c0d0",
             progress: "#81a1c1",
+            staleIcon: "#ebcb8b",
+            staleText: "#ebcb8b",
+            staleAge: "#ebcb8b",
+            staleSubtitle: "#616E88",
         },
     },
 };

package/dist/src/tui/themes/one-dark.js

@@ -91,6 +91,7 @@ export const oneDarkTheme = {
             successPillBg: "#282c34",
             error: "#e06c75",
             info: "#61afef",
+            warning: "#d19a66",
             border: "#3e4451",
         },
         markdown: {
@@ -105,6 +106,8 @@ export const oneDarkTheme = {
             untouched: "#767D8A",
             number: "#abb2bf",
             activeNumber: "#61afef",
+            stale: "#d19a66",
+            abandoned: "#e06c75",
         },
         sessionPicker: {
             border: "#61afef",
@@ -115,6 +118,10 @@ export const oneDarkTheme = {
             highlightFg: "#98c379",
             activeMark: "#61afef",
             progress: "#56b6c2",
+            staleIcon: "#d19a66",
+            staleText: "#d19a66",
+            staleAge: "#d19a66",
+            staleSubtitle: "#767D8A",
         },
     },
 };

package/dist/src/tui/themes/rose-pine.js

@@ -92,6 +92,7 @@ export const rosePineTheme = {
             successPillBg: "#191724",
             error: "#eb6f92",
             info: "#9ccfd8",
+            warning: "#f6c177",
             border: "#26233a",
         },
         markdown: {
@@ -106,6 +107,8 @@ export const rosePineTheme = {
             untouched: "#8884a0",
             number: "#e0def4",
             activeNumber: "#ebbcba",
+            stale: "#f6c177",
+            abandoned: "#eb6f92",
         },
         sessionPicker: {
             border: "#ebbcba",
@@ -116,6 +119,10 @@ export const rosePineTheme = {
             highlightFg: "#31748f",
             activeMark: "#ebbcba",
             progress: "#9ccfd8",
+            staleIcon: "#f6c177",
+            staleText: "#f6c177",
+            staleAge: "#f6c177",
+            staleSubtitle: "#8884a0",
         },
     },
 };

package/dist/src/tui/themes/solarized-dark.js

@@ -91,6 +91,7 @@ export const solarizedDarkTheme = {
             successPillBg: "#073642",
             error: "#dc322f",
             info: "#268bd2",
+            warning: "#b58900",
             border: "#073642",
         },
         markdown: {
@@ -105,6 +106,8 @@ export const solarizedDarkTheme = {
             untouched: "#6c7c83",
             number: "#839496",
             activeNumber: "#268bd2",
+            stale: "#b58900",
+            abandoned: "#dc322f",
         },
         sessionPicker: {
             border: "#268bd2",
@@ -115,6 +118,10 @@ export const solarizedDarkTheme = {
             highlightFg: "#859900",
             activeMark: "#268bd2",
             progress: "#2aa198",
+            staleIcon: "#b58900",
+            staleText: "#b58900",
+            staleAge: "#b58900",
+            staleSubtitle: "#6c7c83",
         },
     },
 };

package/dist/src/tui/themes/solarized-light.js

@@ -91,6 +91,7 @@ export const solarizedLightTheme = {
             successPillBg: "#eee8d5",
             error: "#dc322f",
             info: "#268bd2",
+            warning: "#b58900",
             border: "#eee8d5",
         },
         markdown: {
@@ -105,6 +106,8 @@ export const solarizedLightTheme = {
             untouched: "#a3b1b1",
             number: "#657b83",
             activeNumber: "#268bd2",
+            stale: "#b58900",
+            abandoned: "#dc322f",
         },
         sessionPicker: {
             border: "#268bd2",
@@ -115,6 +118,10 @@ export const solarizedLightTheme = {
             highlightFg: "#859900",
             activeMark: "#268bd2",
             progress: "#2aa198",
+            staleIcon: "#b58900",
+            staleText: "#b58900",
+            staleAge: "#b58900",
+            staleSubtitle: "#a3b1b1",
         },
     },
 };

package/dist/src/tui/themes/tokyo-night.js

@@ -91,6 +91,7 @@ export const tokyoNightTheme = {
             successPillBg: "#1a1b26",
             error: "#f7768e",
             info: "#7aa2f7",
+            warning: "#e0af68",
             border: "#24283b",
         },
         markdown: {
@@ -105,6 +106,8 @@ export const tokyoNightTheme = {
             untouched: "#7078A3",
             number: "#c0caf5",
             activeNumber: "#7aa2f7",
+            stale: "#e0af68",
+            abandoned: "#f7768e",
         },
         sessionPicker: {
             border: "#7aa2f7",
@@ -115,6 +118,10 @@ export const tokyoNightTheme = {
             highlightFg: "#9ece6a",
             activeMark: "#7aa2f7",
             progress: "#7dcfff",
+            staleIcon: "#e0af68",
+            staleText: "#e0af68",
+            staleAge: "#e0af68",
+            staleSubtitle: "#7078A3",
         },
     },
 };

package/dist/src/tui/utils/__tests__/detectTheme.test.js

@@ -0,0 +1,78 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { detectSystemTheme, clearThemeCache } from "../detectTheme.js";
+describe("detectSystemTheme", () => {
+    const originalEnv = process.env;
+    beforeEach(() => {
+        // Reset environment and clear cache before each test
+        process.env = { ...originalEnv };
+        clearThemeCache();
+    });
+    afterEach(() => {
+        process.env = originalEnv;
+        clearThemeCache();
+    });
+    describe("COLORFGBG detection", () => {
+        it("should detect dark theme when background is 0 (black)", () => {
+            process.env.COLORFGBG = "15;0";
+            expect(detectSystemTheme()).toBe("dark");
+        });
+        it("should detect dark theme when background is 6", () => {
+            process.env.COLORFGBG = "7;6";
+            expect(detectSystemTheme()).toBe("dark");
+        });
+        it("should detect light theme when background is 7 (white/light gray)", () => {
+            process.env.COLORFGBG = "0;7";
+            expect(detectSystemTheme()).toBe("light");
+        });
+        it("should detect light theme when background is 15 (bright white)", () => {
+            process.env.COLORFGBG = "0;15";
+            expect(detectSystemTheme()).toBe("light");
+        });
+        it("should handle three-part COLORFGBG format", () => {
+            // Some terminals use foreground;middle;background format
+            process.env.COLORFGBG = "15;default;0";
+            expect(detectSystemTheme()).toBe("dark");
+        });
+        it("should handle three-part COLORFGBG with light background", () => {
+            process.env.COLORFGBG = "0;default;15";
+            expect(detectSystemTheme()).toBe("light");
+        });
+    });
+    describe("fallback behavior", () => {
+        it("should fallback to dark when COLORFGBG is not set", () => {
+            delete process.env.COLORFGBG;
+            expect(detectSystemTheme()).toBe("dark");
+        });
+        it("should fallback to dark when COLORFGBG is invalid", () => {
+            process.env.COLORFGBG = "invalid";
+            expect(detectSystemTheme()).toBe("dark");
+        });
+        it("should fallback to dark when COLORFGBG has invalid number", () => {
+            process.env.COLORFGBG = "15;abc";
+            expect(detectSystemTheme()).toBe("dark");
+        });
+        it("should fallback to dark when COLORFGBG is empty", () => {
+            process.env.COLORFGBG = "";
+            expect(detectSystemTheme()).toBe("dark");
+        });
+    });
+    describe("caching", () => {
+        it("should cache the result", () => {
+            process.env.COLORFGBG = "15;0";
+            expect(detectSystemTheme()).toBe("dark");
+            // Change the environment variable
+            process.env.COLORFGBG = "0;15";
+            // Should still return cached result
+            expect(detectSystemTheme()).toBe("dark");
+        });
+        it("should return fresh result after cache is cleared", () => {
+            process.env.COLORFGBG = "15;0";
+            expect(detectSystemTheme()).toBe("dark");
+            // Clear cache and change environment
+            clearThemeCache();
+            process.env.COLORFGBG = "0;15";
+            // Should return new result
+            expect(detectSystemTheme()).toBe("light");
+        });
+    });
+});

package/dist/src/tui/utils/__tests__/staleDetection.test.js

@@ -0,0 +1,118 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { DEFAULT_GRACE_PERIOD, formatStaleToastMessage, isSessionAbandoned, isSessionStale, } from "../staleDetection.js";
+describe("staleDetection", () => {
+    const now = new Date("2026-01-01T12:00:00.000Z");
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(now);
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    describe("isSessionStale", () => {
+        const TWO_HOURS = 7200000; // default staleThreshold from config
+        it("should return true when session is older than threshold", () => {
+            // Session created 3 hours ago, threshold is 2 hours
+            const threeHoursAgo = now.getTime() - 3 * 3600000;
+            expect(isSessionStale(threeHoursAgo, TWO_HOURS)).toBe(true);
+        });
+        it("should return false when session is younger than threshold", () => {
+            // Session created 1 hour ago, threshold is 2 hours
+            const oneHourAgo = now.getTime() - 1 * 3600000;
+            expect(isSessionStale(oneHourAgo, TWO_HOURS)).toBe(false);
+        });
+        it("should return false when session is exactly at threshold", () => {
+            // Edge case: exactly at threshold boundary (not greater than)
+            const exactlyAtThreshold = now.getTime() - TWO_HOURS;
+            expect(isSessionStale(exactlyAtThreshold, TWO_HOURS)).toBe(false);
+        });
+        it("should return false when stale session has recent interaction within grace period", () => {
+            // Session created 3 hours ago (stale), but user interacted 10 minutes ago
+            const threeHoursAgo = now.getTime() - 3 * 3600000;
+            const tenMinutesAgo = now.getTime() - 10 * 60000;
+            expect(isSessionStale(threeHoursAgo, TWO_HOURS, tenMinutesAgo)).toBe(false);
+        });
+        it("should return true when stale session has old interaction outside grace period", () => {
+            // Session created 3 hours ago, last interaction 45 minutes ago (outside 30min grace)
+            const threeHoursAgo = now.getTime() - 3 * 3600000;
+            const fortyFiveMinutesAgo = now.getTime() - 45 * 60000;
+            expect(isSessionStale(threeHoursAgo, TWO_HOURS, fortyFiveMinutesAgo)).toBe(true);
+        });
+        it("should respect custom grace period", () => {
+            // Session created 3 hours ago, last interaction 45 minutes ago
+            // With a 1-hour custom grace period, should NOT be stale
+            const threeHoursAgo = now.getTime() - 3 * 3600000;
+            const fortyFiveMinutesAgo = now.getTime() - 45 * 60000;
+            const oneHourGrace = 3600000;
+            expect(isSessionStale(threeHoursAgo, TWO_HOURS, fortyFiveMinutesAgo, oneHourGrace)).toBe(false);
+        });
+        it("should use DEFAULT_GRACE_PERIOD when no grace period provided", () => {
+            // Interaction 29 minutes ago (within default 30-minute grace)
+            const threeHoursAgo = now.getTime() - 3 * 3600000;
+            const twentyNineMinutesAgo = now.getTime() - 29 * 60000;
+            expect(isSessionStale(threeHoursAgo, TWO_HOURS, twentyNineMinutesAgo)).toBe(false);
+            // Interaction 31 minutes ago (outside default 30-minute grace)
+            const thirtyOneMinutesAgo = now.getTime() - 31 * 60000;
+            expect(isSessionStale(threeHoursAgo, TWO_HOURS, thirtyOneMinutesAgo)).toBe(true);
+        });
+        it("should handle undefined lastInteraction", () => {
+            const threeHoursAgo = now.getTime() - 3 * 3600000;
+            // No interaction => stale if age exceeds threshold
+            expect(isSessionStale(threeHoursAgo, TWO_HOURS, undefined)).toBe(true);
+        });
+        it("should handle zero threshold (always stale if age > 0)", () => {
+            const oneSecondAgo = now.getTime() - 1000;
+            expect(isSessionStale(oneSecondAgo, 0)).toBe(true);
+        });
+    });
+    describe("isSessionAbandoned", () => {
+        it("should return true for 'abandoned' status", () => {
+            expect(isSessionAbandoned("abandoned")).toBe(true);
+        });
+        it("should return false for 'pending' status", () => {
+            expect(isSessionAbandoned("pending")).toBe(false);
+        });
+        it("should return false for 'completed' status", () => {
+            expect(isSessionAbandoned("completed")).toBe(false);
+        });
+        it("should return false for 'in-progress' status", () => {
+            expect(isSessionAbandoned("in-progress")).toBe(false);
+        });
+        it("should return false for 'rejected' status", () => {
+            expect(isSessionAbandoned("rejected")).toBe(false);
+        });
+        it("should return false for 'timed_out' status", () => {
+            expect(isSessionAbandoned("timed_out")).toBe(false);
+        });
+        it("should return false for empty string", () => {
+            expect(isSessionAbandoned("")).toBe(false);
+        });
+    });
+    describe("formatStaleToastMessage", () => {
+        it("should format hours correctly for a 3-hour-old session", () => {
+            const threeHoursAgo = now.getTime() - 3 * 3600000;
+            const message = formatStaleToastMessage("Test Session", threeHoursAgo);
+            expect(message).toBe('Session "Test Session" may be orphaned (created 3h ago)');
+        });
+        it("should show 0h for very recent sessions", () => {
+            const thirtyMinutesAgo = now.getTime() - 30 * 60000;
+            const message = formatStaleToastMessage("New Session", thirtyMinutesAgo);
+            expect(message).toBe('Session "New Session" may be orphaned (created 0h ago)');
+        });
+        it("should show large hour counts for old sessions", () => {
+            const twoDaysAgo = now.getTime() - 48 * 3600000;
+            const message = formatStaleToastMessage("Old Session", twoDaysAgo);
+            expect(message).toBe('Session "Old Session" may be orphaned (created 48h ago)');
+        });
+        it("should handle session title with special characters", () => {
+            const twoHoursAgo = now.getTime() - 2 * 3600000;
+            const message = formatStaleToastMessage("Session \"quoted\"", twoHoursAgo);
+            expect(message).toBe('Session "Session "quoted"" may be orphaned (created 2h ago)');
+        });
+    });
+    describe("DEFAULT_GRACE_PERIOD", () => {
+        it("should be 30 minutes in milliseconds", () => {
+            expect(DEFAULT_GRACE_PERIOD).toBe(1800000);
+        });
+    });
+});

package/dist/src/tui/utils/staleDetection.js

@@ -0,0 +1,51 @@
+/**
+ * Stale Session Detection Utilities
+ *
+ * Pure functions for computing session staleness. No I/O or React dependencies.
+ * Design Decision 4: "Stale is computed flag, not persisted status"
+ * Design Decision 8: "Interaction resets stale check for that session"
+ */
+/**
+ * Default grace period in milliseconds (30 minutes).
+ * If a user interacted with a session within this window, it is not considered stale.
+ */
+export const DEFAULT_GRACE_PERIOD = 1800000; // 30 minutes
+/**
+ * Determine whether a session should be considered stale based on its age,
+ * a configurable threshold, and an optional last-interaction timestamp.
+ *
+ * @param requestTimestamp - When the session was originally created (epoch ms)
+ * @param staleThreshold - Maximum allowed age before a session is stale (ms)
+ * @param lastInteraction - Last time the user interacted with this session (epoch ms)
+ * @param gracePeriod - Time after an interaction during which the session is not stale (ms)
+ * @returns true if the session is stale
+ */
+export function isSessionStale(requestTimestamp, staleThreshold, lastInteraction, gracePeriod = DEFAULT_GRACE_PERIOD) {
+    const now = Date.now();
+    // If the user interacted recently (within grace period), session is not stale
+    if (lastInteraction && now - lastInteraction < gracePeriod) {
+        return false;
+    }
+    return now - requestTimestamp > staleThreshold;
+}
+/**
+ * Check whether a session has been explicitly marked as abandoned
+ * (e.g. AI disconnected).
+ *
+ * @param status - The session's current status string
+ * @returns true if status is "abandoned"
+ */
+export function isSessionAbandoned(status) {
+    return status === "abandoned";
+}
+/**
+ * Build a human-readable toast message for a stale session.
+ *
+ * @param sessionTitle - Display name or ID of the session
+ * @param createdAtMs - Session creation time in epoch milliseconds
+ * @returns Formatted message string
+ */
+export function formatStaleToastMessage(sessionTitle, createdAtMs) {
+    const hoursAgo = Math.floor((Date.now() - createdAtMs) / 3600000);
+    return `Session "${sessionTitle}" may be orphaned (created ${hoursAgo}h ago)`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auq-mcp-server",
-  "version": "2.2.2",
+  "version": "2.4.0",
   "main": "dist/index.js",
   "bin": {
     "auq": "dist/bin/auq.js"