auq-mcp-server 2.6.3 → 2.7.0

package/dist/src/tui/shared/utils/recommended.js

@@ -0,0 +1,52 @@
+/**
+ * Utility for detecting recommended options in question labels.
+ * Supports multiple languages and bracket styles.
+ */
+/**
+ * Regex patterns for detecting recommended markers in labels.
+ * Requires matching delimiters: either (word) or [word].
+ * Matches case-insensitively and supports both parentheses and brackets.
+ */
+export const RECOMMENDED_PATTERNS = {
+    /** Matches (recommended) or [recommended] - case insensitive, requires matching delimiters */
+    EN: /(?:\(recommended\)|\[recommended\])/i,
+    /** Matches (추천) or [추천] - requires matching delimiters */
+    KO: /(?:\(추천\)|\[추천\])/,
+};
+/**
+ * Combined regex for detecting any recommended pattern.
+ * Requires matching delimiters: either (word) or [word].
+ * Matches case-insensitively for English, exactly for Korean.
+ */
+const RECOMMENDED_REGEX = /(?:\(recommended\)|\[recommended\]|\(추천\)|\[추천\])/i;
+/**
+ * Detects if a label contains a recommended pattern.
+ * Supports English "recommended" and Korean "추천" in parentheses or brackets.
+ * Case-insensitive matching.
+ *
+ * @param label - The option label to check
+ * @returns true if the label contains a recommended marker
+ *
+ * @example
+ * isRecommendedOption("Option A (recommended)") // true
+ * isRecommendedOption("[추천] Option B") // true
+ * isRecommendedOption("Option C") // false
+ */
+export function isRecommendedOption(label) {
+    return RECOMMENDED_REGEX.test(label);
+}
+/**
+ * Extracts the clean label by removing recommended markers.
+ * Removes recommended patterns and trims whitespace.
+ *
+ * @param label - The option label with potential recommended marker
+ * @returns The clean label without recommended markers
+ *
+ * @example
+ * extractCleanLabel("Option A (recommended)") // "Option A"
+ * extractCleanLabel("[추천] Option B") // "Option B"
+ * extractCleanLabel("  Option C  ") // "Option C"
+ */
+export function extractCleanLabel(label) {
+    return label.replace(RECOMMENDED_REGEX, "").trim().replace(/\s+/g, " ");
+}

package/dist/src/tui/shared/utils/relativeTime.js

@@ -0,0 +1,24 @@
+/**
+ * Format a timestamp as a concise relative time string.
+ *
+ * @param date - A Date object or a numeric epoch-ms timestamp
+ * @returns Human-readable label such as "just now", "12s ago", "3m ago"
+ */
+export function formatRelativeTime(date) {
+    const now = Date.now();
+    const then = typeof date === "number" ? date : date.getTime();
+    const diffMs = Math.max(0, now - then);
+    const diffSec = Math.floor(diffMs / 1000);
+    if (diffSec < 5)
+        return "just now";
+    if (diffSec < 60)
+        return `${diffSec}s ago`;
+    const diffMin = Math.floor(diffSec / 60);
+    if (diffMin < 60)
+        return `${diffMin}m ago`;
+    const diffHr = Math.floor(diffMin / 60);
+    if (diffHr < 24)
+        return `${diffHr}h ago`;
+    const diffDay = Math.floor(diffHr / 24);
+    return `${diffDay}d ago`;
+}

package/dist/src/tui/shared/utils/sessionSwitching.js

@@ -0,0 +1,56 @@
+/**
+ * Calculate the next session index with cyclic wrap-around.
+ * Returns current index if queue has <= 1 item.
+ */
+export function getNextSessionIndex(currentIndex, queueLength) {
+    if (queueLength <= 1) {
+        return currentIndex;
+    }
+    return (currentIndex + 1) % queueLength;
+}
+/**
+ * Calculate the previous session index with cyclic wrap-around.
+ * Returns current index if queue has <= 1 item.
+ */
+export function getPrevSessionIndex(currentIndex, queueLength) {
+    if (queueLength <= 1) {
+        return currentIndex;
+    }
+    return (currentIndex - 1 + queueLength) % queueLength;
+}
+/**
+ * Validate and return the target index for a direct jump (1-based input).
+ * Returns null if the jump is invalid (out of range, same as current).
+ */
+export function getDirectJumpIndex(keyNumber, currentIndex, queueLength) {
+    if (keyNumber < 1 || keyNumber > 9) {
+        return null;
+    }
+    const targetIndex = keyNumber - 1;
+    if (targetIndex >= queueLength) {
+        return null;
+    }
+    if (targetIndex === currentIndex) {
+        return null;
+    }
+    return targetIndex;
+}
+/**
+ * Calculate the new active session index after removing a session.
+ * Handles: removal before active, removal at active, removal after active, queue becoming empty.
+ */
+export function getAdjustedIndexAfterRemoval(removedIndex, activeIndex, newQueueLength) {
+    if (newQueueLength === 0) {
+        return 0;
+    }
+    if (removedIndex < activeIndex) {
+        return activeIndex - 1;
+    }
+    if (removedIndex > activeIndex) {
+        return activeIndex;
+    }
+    if (removedIndex < newQueueLength) {
+        return removedIndex;
+    }
+    return newQueueLength - 1;
+}

package/dist/src/tui/shared/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/dist/src/tui/themes/catppuccin-latte.js

@@ -1,127 +1,2 @@
-/**
- * Catppuccin Latte Theme
- * Soothing pastel theme - light flavor.
- * https://github.com/catppuccin/catppuccin
- */
-export const catppuccinLatteTheme = {
-    name: "catppuccin-latte",
-    gradient: {
-        start: "#1e66f5", // blue
-        middle: "#8839ef", // mauve
-        end: "#1e66f5",
-    },
-    colors: {
-        primary: "#1e66f5", // blue
-        success: "#40a02b", // green
-        warning: "#df8e1d", // yellow
-        error: "#d20f39", // red
-        info: "#04a5e5", // sky
-        focused: "#1e66f5",
-        selected: "#40a02b",
-        pending: "#fe640b", // peach
-        unansweredHighlight: "#d20f39",
-        text: "#4c4f69", // text
-        textDim: "#acb0c0", // overlay0 lightened
-        textBold: "#4c4f69",
-    },
-    borders: {
-        primary: "#1e66f5",
-        warning: "#df8e1d",
-        error: "#d20f39",
-        neutral: "#ccd0da", // surface0
-    },
-    components: {
-        header: {
-            border: "#9ca0b0", // overlay0 - slightly more visible
-            queueActive: "#1e66f5",
-            queueEmpty: "#acb0c0",
-            queueFlash: "#8839ef",
-            pillBg: "#ccd0da",
-        },
-        directory: {
-            label: "#acb0c0",
-            path: "#4c4f69",
-        },
-        tabBar: {
-            selected: "#4c4f69",
-            selectedBg: "#ccd0da",
-            default: "#acb0c0",
-            answered: "#40a02b",
-            unanswered: "#acb0c0",
-            divider: "#ccd0da",
-        },
-        options: {
-            focused: "#40a02b",
-            focusedBg: "#ccd0da",
-            selected: "#1e66f5",
-            selectedBg: "#ccd0da",
-            default: "#4c4f69",
-            description: "#6c6f85", // subtext0 - darker for readability
-            hint: "#6c6f85", // subtext0 - darker for readability
-        },
-        input: {
-            border: "#ccd0da",
-            borderFocused: "#1e66f5",
-            placeholder: "#acb0c0",
-            cursor: "#1e66f5",
-            cursorDim: "#8839ef",
-        },
-        review: {
-            border: "#ccd0da",
-            confirmBorder: "#1e66f5",
-            selectedOption: "#40a02b",
-            customAnswer: "#df8e1d",
-            questionId: "#acb0c0",
-            divider: "#ccd0da",
-        },
-        questionDisplay: {
-            questionId: "#1e66f5",
-            typeIndicator: "#acb0c0",
-            elapsed: "#acb0c0",
-        },
-        footer: {
-            border: "#ccd0da",
-            keyBg: "#ccd0da",
-            keyFg: "#1e66f5",
-            action: "#7c7f93", // overlay1 - darker for visibility
-            separator: "#ccd0da",
-        },
-        toast: {
-            success: "#40a02b",
-            successPillBg: "#dce0e8",
-            error: "#d20f39",
-            info: "#1e66f5",
-            warning: "#df8e1d",
-            border: "#ccd0da",
-        },
-        markdown: {
-            codeBlockBg: "#eff1f5",
-            codeBlockText: "#4c4f69",
-            codeBlockBorder: "#ccd0da",
-        },
-        sessionDots: {
-            active: "#1e66f5",
-            answered: "#40a02b",
-            inProgress: "#df8e1d",
-            untouched: "#acb0c0",
-            number: "#4c4f69",
-            activeNumber: "#1e66f5",
-            stale: "#df8e1d",
-            abandoned: "#d20f39",
-        },
-        sessionPicker: {
-            border: "#1e66f5",
-            title: "#1e66f5",
-            rowText: "#4c4f69",
-            rowDim: "#acb0c0",
-            highlightBg: "#ccd0da",
-            highlightFg: "#40a02b",
-            activeMark: "#1e66f5",
-            progress: "#04a5e5",
-            staleIcon: "#df8e1d",
-            staleText: "#df8e1d",
-            staleAge: "#df8e1d",
-            staleSubtitle: "#acb0c0",
-        },
-    },
-};
+// Re-export from shared location for backward compatibility
+export * from "../shared/themes/catppuccin-latte.js";

package/dist/src/tui/themes/catppuccin-mocha.js

@@ -1,127 +1,2 @@
-/**
- * Catppuccin Mocha Theme
- * Soothing pastel theme - darkest flavor.
- * https://github.com/catppuccin/catppuccin
- */
-export const catppuccinMochaTheme = {
-    name: "catppuccin-mocha",
-    gradient: {
-        start: "#89b4fa", // blue
-        middle: "#cba6f7", // mauve
-        end: "#89b4fa",
-    },
-    colors: {
-        primary: "#89b4fa", // blue
-        success: "#a6e3a1", // green
-        warning: "#f9e2af", // yellow
-        error: "#f38ba8", // red
-        info: "#89dceb", // sky
-        focused: "#89b4fa",
-        selected: "#a6e3a1",
-        pending: "#fab387", // peach
-        unansweredHighlight: "#f38ba8",
-        text: "#cdd6f4", // text
-        textDim: "#8688a0", // overlay0 brightened
-        textBold: "#cdd6f4",
-    },
-    borders: {
-        primary: "#89b4fa",
-        warning: "#f9e2af",
-        error: "#f38ba8",
-        neutral: "#313244", // surface0
-    },
-    components: {
-        header: {
-            border: "#45475a", // surface1 - slightly more visible
-            queueActive: "#89b4fa",
-            queueEmpty: "#8688a0",
-            queueFlash: "#cba6f7",
-            pillBg: "#313244",
-        },
-        directory: {
-            label: "#8688a0",
-            path: "#cdd6f4",
-        },
-        tabBar: {
-            selected: "#cdd6f4",
-            selectedBg: "#313244",
-            default: "#8688a0",
-            answered: "#a6e3a1",
-            unanswered: "#8688a0",
-            divider: "#313244",
-        },
-        options: {
-            focused: "#a6e3a1",
-            focusedBg: "#313244",
-            selected: "#89b4fa",
-            selectedBg: "#313244",
-            default: "#cdd6f4",
-            description: "#a6adc8", // subtext0 - lighter for readability
-            hint: "#a6adc8", // subtext0 - lighter for readability
-        },
-        input: {
-            border: "#313244",
-            borderFocused: "#89b4fa",
-            placeholder: "#8688a0",
-            cursor: "#89b4fa",
-            cursorDim: "#cba6f7",
-        },
-        review: {
-            border: "#313244",
-            confirmBorder: "#89b4fa",
-            selectedOption: "#a6e3a1",
-            customAnswer: "#f9e2af",
-            questionId: "#8688a0",
-            divider: "#313244",
-        },
-        questionDisplay: {
-            questionId: "#89b4fa",
-            typeIndicator: "#8688a0",
-            elapsed: "#8688a0",
-        },
-        footer: {
-            border: "#313244",
-            keyBg: "#313244",
-            keyFg: "#89b4fa",
-            action: "#9399b2", // overlay2 - brighter for visibility
-            separator: "#313244",
-        },
-        toast: {
-            success: "#a6e3a1",
-            successPillBg: "#313244",
-            error: "#f38ba8",
-            info: "#89b4fa",
-            warning: "#f9e2af",
-            border: "#313244",
-        },
-        markdown: {
-            codeBlockBg: "#1e1e2e",
-            codeBlockText: "#cdd6f4",
-            codeBlockBorder: "#313244",
-        },
-        sessionDots: {
-            active: "#89b4fa",
-            answered: "#a6e3a1",
-            inProgress: "#f9e2af",
-            untouched: "#8688a0",
-            number: "#cdd6f4",
-            activeNumber: "#89b4fa",
-            stale: "#f9e2af",
-            abandoned: "#f38ba8",
-        },
-        sessionPicker: {
-            border: "#89b4fa",
-            title: "#89b4fa",
-            rowText: "#cdd6f4",
-            rowDim: "#8688a0",
-            highlightBg: "#313244",
-            highlightFg: "#a6e3a1",
-            activeMark: "#89b4fa",
-            progress: "#89dceb",
-            staleIcon: "#f9e2af",
-            staleText: "#f9e2af",
-            staleAge: "#f9e2af",
-            staleSubtitle: "#8688a0",
-        },
-    },
-};
+// Re-export from shared location for backward compatibility
+export * from "../shared/themes/catppuccin-mocha.js";

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

@@ -1,128 +1,2 @@
-/**
- * Visual direction: graphite + electric-cyan accent.
- * Keep the palette tight; lean on neutrals for structure.
- *
- * This is the original AUQ theme, optimized for dark terminals.
- */
-export const darkTheme = {
-    name: "AUQ dark",
-    gradient: {
-        start: "#46D9FF",
-        middle: "#B8F2FF",
-        end: "#46D9FF",
-    },
-    colors: {
-        primary: "#46D9FF",
-        success: "#5AF78E",
-        warning: "#FFD36A",
-        error: "#FF5C57",
-        info: "#46D9FF",
-        focused: "#46D9FF",
-        selected: "#5AF78E",
-        pending: "#FFD36A",
-        unansweredHighlight: "#FF6B6B",
-        text: "#E7EEF5",
-        textDim: "#A0AAB4",
-        textBold: "#F5FAFF",
-    },
-    borders: {
-        primary: "#46D9FF",
-        warning: "#FFD36A",
-        error: "#FF5C57",
-        neutral: "#2A3238",
-    },
-    components: {
-        header: {
-            border: "#3D4852", // slightly more visible
-            queueActive: "#46D9FF",
-            queueEmpty: "#A0AAB4",
-            queueFlash: "#B8F2FF",
-            pillBg: "#0B1F26",
-        },
-        directory: {
-            label: "#A0AAB4",
-            path: "#E7EEF5",
-        },
-        tabBar: {
-            selected: "#E7EEF5",
-            selectedBg: "#0B1F26",
-            default: "#A0AAB4",
-            answered: "#5AF78E",
-            unanswered: "#A0AAB4",
-            divider: "#2A3238",
-        },
-        options: {
-            focused: "#5AF78E",
-            focusedBg: "#0F2417",
-            selected: "#46D9FF",
-            selectedBg: "#0B1F26",
-            default: "#E7EEF5",
-            description: "#A8B2BC",
-            hint: "#A8B2BC",
-        },
-        input: {
-            border: "#2A3238",
-            borderFocused: "#46D9FF",
-            placeholder: "#A0AAB4",
-            cursor: "#46D9FF",
-            cursorDim: "#B8F2FF",
-        },
-        review: {
-            border: "#2A3238",
-            confirmBorder: "#46D9FF",
-            selectedOption: "#5AF78E",
-            customAnswer: "#FFD36A",
-            questionId: "#A0AAB4",
-            divider: "#2A3238",
-        },
-        questionDisplay: {
-            questionId: "#46D9FF",
-            typeIndicator: "#A0AAB4",
-            elapsed: "#A0AAB4",
-        },
-        footer: {
-            border: "#2A3238",
-            keyBg: "#0B1F26",
-            keyFg: "#46D9FF",
-            action: "#A8B2BC",
-            separator: "#2A3238",
-        },
-        toast: {
-            success: "#5AF78E",
-            successPillBg: "#0F2417",
-            error: "#FF5C57",
-            info: "#46D9FF",
-            warning: "#FFD36A",
-            border: "#2A3238",
-        },
-        markdown: {
-            codeBlockBg: "#0F1419",
-            codeBlockText: "#E7EEF5",
-            codeBlockBorder: "#2A3238",
-        },
-        sessionDots: {
-            active: "#46D9FF",
-            answered: "#5AF78E",
-            inProgress: "#FFD36A",
-            untouched: "#A0AAB4",
-            number: "#E7EEF5",
-            activeNumber: "#46D9FF",
-            stale: "#FFD36A",
-            abandoned: "#FF5C57",
-        },
-        sessionPicker: {
-            border: "#46D9FF",
-            title: "#46D9FF",
-            rowText: "#E7EEF5",
-            rowDim: "#A0AAB4",
-            highlightBg: "#0F2417",
-            highlightFg: "#5AF78E",
-            activeMark: "#46D9FF",
-            progress: "#46D9FF",
-            staleIcon: "#FFD36A",
-            staleText: "#FFD36A",
-            staleAge: "#FFD36A",
-            staleSubtitle: "#A0AAB4",
-        },
-    },
-};
+// Re-export from shared location for backward compatibility
+export * from "../shared/themes/dark.js";