@gitsense/gsc-utils 0.2.21 → 0.2.24

package/dist/gsc-utils.cjs.js

@@ -6810,7 +6810,9 @@ function createPatchFromCodeBlocks(CodeBlockUtils, sourceCodeBlockText, targetCo
     const targetContent = targetContentTemp.join('\n\n');
 
     // Get the number of lines in the header + two blank lines
-    const sourceHeaderLineCount = sourceHeaderText.split('\n').length;
+    // Note, before the code block header format was solidified, we use to include 'Updated-at' but no more so
+    // we need to filter it out from the source header
+    const sourceHeaderLineCount = sourceHeaderText.split('\n').filter(line => !line.includes('Updated-at')).length;
     const targetHeaderLineCount = targetHeaderText.split('\n').length;
 
     // To keep things simple we are going to require the source and target header line count to be the same.
@@ -6818,7 +6820,7 @@ function createPatchFromCodeBlocks(CodeBlockUtils, sourceCodeBlockText, targetCo
     if (sourceHeaderLineCount !== targetHeaderLineCount) {
         // Some LLMs will not generate a Parent-UUID for the first version so we won't make this
         // fatal if the sourceHeader does not have a Parent-UUID
-        if (sourceHeaderLineCount.includes('Parent-UUID')) {
+        if (sourceHeaderText.includes('Parent-UUID')) {
             throw new Error('Source and target header line count must be the same');
         }
     }
@@ -10628,13 +10630,13 @@ var CodeBlockUtils$5 = {
 
 /*
  * Component: ContextUtils
- * Block-UUID: c018b1f9-2291-4bc9-9c4b-ab53a5db745e
- * Parent-UUID: c199efe3-003c-4226-af3c-d460392a6569
- * Version: 1.2.0
+ * Block-UUID: a0b71292-b1cc-401a-8ce2-544a047b0fef
+ * Parent-UUID: c018b1f9-2291-4bc9-9c4b-ab53a5db745e
+ * Version: 1.3.0
  * Description: Provides utility functions for parsing context message sections to extract file details and code blocks, and for formatting content for LLM context.
  * Language: JavaScript
  * Created-at: 2025-05-09T01:36:20.107Z
- * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Gemini 2.5 Flash (v1.1.0), Qwen 3 Coder 480B - Cerebras (v1.2.0)
+ * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Gemini 2.5 Flash (v1.1.0), Qwen 3 Coder 480B - Cerebras (v1.2.0), Qwen 3 Coder 480B - Cerebras (v1.3.0)
  */
 
 const CodeBlockUtils$4 = CodeBlockUtils$5;
@@ -10815,12 +10817,26 @@ function extractContextSections$1(messageContent) {
     const [summary, items] = messageContent.split(/\n---Start of Context---\n\n/);
     const sections = items.split(/\n---End of Item---\n/);
 
+    // Determine the origin of the context based on the message header
+    let contextOrigin = 'unknown'; // Default value if not determinable
+    if (messageContent.includes("## FILE CONTENT - WORKING DIRECTORY")) {
+        contextOrigin = 'working-directory';
+    } else if (messageContent.includes("## FILE CONTENT - IMPORTED")) {
+        contextOrigin = 'imported';
+    } else if (messageContent.includes("## OVERVIEW - IMPORTED")) {
+         // Handle the overview case as well, though it uses 'file content' type
+         contextOrigin = 'imported';
+    }
+
     // Process sections starting from the first potential path delimiter.
     for (let i = 0; i < sections.length; i++) {
         const contextSection = parseContextSection$1(sections[i]);
 
         if (contextSection) {
             contextSections.push(contextSection);
+            // Attach the determined context origin to the section
+            // This provides information on how the context was introduced
+            contextSection.contextOrigin = contextOrigin;
         }
     }
 
@@ -10841,6 +10857,7 @@ function extractContextItemsOverviewTableRows$1(messageContent) {
         return null;
     }
 
+    // Map the column number to the type
     const col2Field = {
         1: 'chatId',
         2: 'type', // file, tree, etc.
@@ -12038,6 +12055,174 @@ var LLMUtils$1 = {
     estimateTokens: estimateTokens$1,
 };
 
+/**
+ * Component: Date Utilities
+ * Block-UUID: fef3b0f4-8055-4690-9336-e68a9cc33a61
+ * Parent-UUID: 716e5ce9-84df-4f12-89e7-4a28e4a39a81
+ * Version: 1.0.0
+ * Description: Date formatting and manipulation utilities for GitSense Chat
+ * Language: JavaScript
+ * Created-at: 2025-10-11T23:26:20.815Z
+ * Authors: Claude-3.5-Sonnet (v1.0.0), Qwen 3 Coder 480B - Cerebras (v1.0.0)
+ */
+
+/**
+ * Ensures a date string has a timezone indicator
+ * @param {string} dateString - Date string in format "YYYY-MM-DD(T| )HH:mm:ss.SSS"
+ * @returns {string} Date string with 'Z' timezone indicator if not present
+ */
+function normalizeDateTime$1(dateString) {
+    return dateString.includes('Z') ? dateString : dateString + 'Z';
+}
+
+/**
+ * Calculates the time difference between now and a given date
+ * @param {string} dateString - Date string to compare against current time
+ * @returns {number} Difference in seconds
+ */
+function getTimeDifference$1(dateString) {
+    const now = new Date();
+    const date = new Date(normalizeDateTime$1(dateString));
+    return Math.floor((now - date) / 1000);
+}
+
+/**
+ * Formats a time difference in seconds to a human-readable string
+ * @param {number} diff - Time difference in seconds
+ * @returns {string} Formatted string (e.g., "5s ago", "2m ago", "3h ago", "2d ago")
+ */
+function formatTimeDifference$1(diff) {
+    if (diff < 60) {
+        return `${diff}s ago`;
+    } else if (diff < 3600) {
+        const minutes = Math.floor(diff / 60);
+        return `${minutes}m ago`;
+    } else if (diff < 86400) {
+        const hours = Math.floor(diff / 3600);
+        return `${hours}h ago`;
+    } else {
+        const days = Math.floor(diff / 86400);
+        return `${days}d ago`;
+    }
+}
+
+/**
+ * Formats a date string into a relative time string
+ * @param {string} dateString - Date string to format
+ * @returns {string} Formatted relative time string
+ */
+function formatAge$1(dateString) {
+    if (!dateString) {
+        return 'N/A';
+    }
+
+    try {
+        const diff = getTimeDifference$1(dateString);
+        return formatTimeDifference$1(diff);
+    } catch (error) {
+        console.error('Error formatting date:', error);
+        return 'Invalid date';
+    }
+}
+
+/**
+ * Validates a date string format
+ * @param {string} dateString - Date string to validate
+ * @returns {boolean} True if date string is valid
+ */
+function isValidDateString$1(dateString) {
+    if (!dateString) return false;
+    
+    const pattern = /^\d{4}-\d{2}-\d{2}(T| )\d{2}:\d{2}:\d{2}\.\d{3}Z?$/;
+    if (!pattern.test(dateString)) return false;
+
+    const date = new Date(normalizeDateTime$1(dateString));
+    return date instanceof Date && !isNaN(date);
+}
+
+/**
+ * Compares two date strings
+ * @param {string} dateA - First date string
+ * @param {string} dateB - Second date string
+ * @returns {number} -1 if dateA is earlier, 0 if equal, 1 if dateA is later
+ */
+function compareDates$1(dateA, dateB) {
+    if (!isValidDateString$1(dateA) || !isValidDateString$1(dateB)) {
+        throw new Error(`Invalid date string format. A: ${dateA} B: ${dateB})`);
+    }
+
+    const timeA = new Date(normalizeDateTime$1(dateA)).getTime();
+    const timeB = new Date(normalizeDateTime$1(dateB)).getTime();
+    
+    if (timeA < timeB) return -1;
+    if (timeA > timeB) return 1;
+    return 0;
+}
+
+var DateUtils$1 = {
+    formatAge: formatAge$1,
+    isValidDateString: isValidDateString$1,
+    compareDates: compareDates$1,
+    normalizeDateTime: normalizeDateTime$1,
+    getTimeDifference: getTimeDifference$1,
+    formatTimeDifference: formatTimeDifference$1
+};
+
+/**
+ * Component: Formatter Utilities
+ * Block-UUID: 9b1e07bf-e92c-43c1-9ac0-5dacdb7ae618
+ * Parent-UUID: 9c07d12f-5a05-4402-99d2-85d872d7b2f7
+ * Version: 1.0.0
+ * Description: Utility functions for formatting content in GitSense Chat
+ * Language: JavaScript
+ * Created-at: 2025-10-11T23:27:15.420Z
+ * Authors: Claude 3.7 Sonnet (v1.0.0), Claude 3.7 Sonnet (v1.1.0), Gemini 2.5 Flash Thinking (v1.2.0), Gemini 2.5 Flash Thinking (v1.3.0), Qwen 3 Coder 480B - Cerebras (v1.4.0), Qwen 3 Coder 480B - Cerebras (v1.5.0), Qwen 3 Coder 480B - Cerebras (v1.0.0)
+ */
+
+/**
+ * Formats bytes into human-readable string (KB, MB, GB)
+ * @param {number} bytes - Number of bytes
+ * @returns {string} Formatted size string
+ */
+function formatBytes$1(bytes) {
+    if (typeof bytes !== 'number' || isNaN(bytes)) return '0 bytes';
+    if (bytes === 0) return '0 bytes';
+
+    const k = 1024;
+    const sizes = ['bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+
+    // Special case for bytes (no decimal)
+    if (i === 0) return `${bytes} ${sizes[i]}`;
+
+    const value = bytes / Math.pow(k, i);
+    // Show no decimal if whole number
+    const decimalPlaces = value % 1 === 0 ? 0 : 1;
+    return `${value.toFixed(decimalPlaces)} ${sizes[i]}`;
+}
+
+/**
+ * Formats token count into human-readable string (k, m, b)
+ * @param {number} count - Number of tokens
+ * @returns {string} Formatted token string
+ */
+function formatTokens$1(count) {
+    if (typeof count !== 'number' || isNaN(count)) return '0';
+    if (count === 0) return '0';
+
+    if (count < 1000) return `${count}`;
+    if (count < 1000000) return `${(count/1000).toFixed(count >= 10000 ? 1 : 0)}k`;
+    if (count < 1000000000) return `${(count/1000000).toFixed(1)}m`;
+
+    // For billions
+    return `${(count/1000000000).toFixed(1)}b`;
+}
+
+var FormatterUtils$1 = {
+    formatBytes: formatBytes$1,
+    formatTokens: formatTokens$1
+};
+
 /*
  * Component: Config Utilities
  * Block-UUID: 65b39008-da68-462e-bcac-27db873c9ddc
@@ -12236,13 +12421,13 @@ var EnvUtils$1 = {
 
 /*
  * Component: GitSenseChatUtils
- * Block-UUID: 5e8d1a9c-0b3f-4e1a-8c7d-9f0b2e1d3a4b
- * Parent-UUID: 7a9b1c8e-f1a4-4b2d-9e8f-6f7a0b1c2d3f
- * Version: 2.1.4
+ * Block-UUID: d7cdbb94-f335-4f85-bdc4-0dd3ae95127e
+ * Parent-UUID: 5e8d1a9c-0b3f-4e1a-8c7d-9f0b2e1d3a4b
+ * Version: 2.1.5
  * Description: Interface class for GitSense Chat utilities providing a unified API for code block parsing (markdown), extraction, and patch operations. Integrates functionalities from CodeBlockUtils and PatchUtils modules, and now includes ConfigUtils and EnvUtils.
  * Language: JavaScript
  * Created-at: 2025-04-15T16:04:26.780Z
- * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v2.0.0), Gemini 2.5 Pro (v2.1.0), Gemini 2.5 Pro (v2.1.1), Gemini 2.5 Flash (v2.1.2), Gemini 2.5 Flash (v2.1.3), Gemini 2.5 Flash (v2.1.4)
+ * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v2.0.0), Gemini 2.5 Pro (v2.1.0), Gemini 2.5 Pro (v2.1.1), Gemini 2.5 Flash (v2.1.2), Gemini 2.5 Flash (v2.1.3), Gemini 2.5 Flash (v2.1.4), Qwen 3 Coder 480B - Cerebras (v2.1.5)
  */
 
 const ChatUtils = ChatUtils$1;
@@ -12255,9 +12440,20 @@ const PatchUtils = PatchUtils$2;
 const GSToolBlockUtils = GSToolBlockUtils$3;
 const LLMUtils = LLMUtils$1;
 const JsonUtils = JsonUtils$2;
+const DateUtils = DateUtils$1;
+const FormatterUtils = FormatterUtils$1;
 const ConfigUtils = ConfigUtils$1;
 const EnvUtils = EnvUtils$1;
 
+const {
+    formatAge,
+    isValidDateString,
+    compareDates,
+    normalizeDateTime,
+    getTimeDifference,
+    formatTimeDifference
+} = DateUtils;
+
 const {
     estimateTokens
 } = LLMUtils;
@@ -12359,6 +12555,11 @@ const {
     getApiKey
 } = EnvUtils;
 
+const {
+    formatBytes,
+    formatTokens,
+} = FormatterUtils;
+
 const {
     parseContextSection,
     extractContextSections,
@@ -12573,6 +12774,12 @@ class GitSenseChatUtils {
 // Export the main class, the aggregated CodeBlockUtils, PatchUtils,
 // and individual functions for backward compatibility or direct use.
 var GitSenseChatUtils_1 = {
+    // New Utility Modules
+    DateUtils,
+    FormatterUtils,
+
+    // Date Utility Functions
+
     // Main class
     GitSenseChatUtils,
 
@@ -12588,6 +12795,9 @@ var GitSenseChatUtils_1 = {
     GSToolBlockUtils,
     JsonUtils,
     ConfigUtils,
+    DateUtils,
+    FormatterUtils,
+
     EnvUtils,
 
     // --- Individual Function Exports (sourced correctly) ---
@@ -12662,6 +12872,18 @@ var GitSenseChatUtils_1 = {
     // LLM Utils
     estimateTokens,
 
+    // Date Utils
+    formatAge,
+    isValidDateString,
+    compareDates,
+    normalizeDateTime,
+    getTimeDifference,
+    formatTimeDifference,
+
+    // Formatter Utils
+    formatBytes,
+    formatTokens,
+
     // GS Tool Block
     isToolBlock,
     parseToolBlock,

package/dist/gsc-utils.esm.js

@@ -6808,7 +6808,9 @@ function createPatchFromCodeBlocks(CodeBlockUtils, sourceCodeBlockText, targetCo
     const targetContent = targetContentTemp.join('\n\n');
 
     // Get the number of lines in the header + two blank lines
-    const sourceHeaderLineCount = sourceHeaderText.split('\n').length;
+    // Note, before the code block header format was solidified, we use to include 'Updated-at' but no more so
+    // we need to filter it out from the source header
+    const sourceHeaderLineCount = sourceHeaderText.split('\n').filter(line => !line.includes('Updated-at')).length;
     const targetHeaderLineCount = targetHeaderText.split('\n').length;
 
     // To keep things simple we are going to require the source and target header line count to be the same.
@@ -6816,7 +6818,7 @@ function createPatchFromCodeBlocks(CodeBlockUtils, sourceCodeBlockText, targetCo
     if (sourceHeaderLineCount !== targetHeaderLineCount) {
         // Some LLMs will not generate a Parent-UUID for the first version so we won't make this
         // fatal if the sourceHeader does not have a Parent-UUID
-        if (sourceHeaderLineCount.includes('Parent-UUID')) {
+        if (sourceHeaderText.includes('Parent-UUID')) {
             throw new Error('Source and target header line count must be the same');
         }
     }
@@ -10626,13 +10628,13 @@ var CodeBlockUtils$5 = {
 
 /*
  * Component: ContextUtils
- * Block-UUID: c018b1f9-2291-4bc9-9c4b-ab53a5db745e
- * Parent-UUID: c199efe3-003c-4226-af3c-d460392a6569
- * Version: 1.2.0
+ * Block-UUID: a0b71292-b1cc-401a-8ce2-544a047b0fef
+ * Parent-UUID: c018b1f9-2291-4bc9-9c4b-ab53a5db745e
+ * Version: 1.3.0
  * Description: Provides utility functions for parsing context message sections to extract file details and code blocks, and for formatting content for LLM context.
  * Language: JavaScript
  * Created-at: 2025-05-09T01:36:20.107Z
- * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Gemini 2.5 Flash (v1.1.0), Qwen 3 Coder 480B - Cerebras (v1.2.0)
+ * Authors: Gemini 2.5 Flash Thinking (v1.0.0), Gemini 2.5 Flash (v1.1.0), Qwen 3 Coder 480B - Cerebras (v1.2.0), Qwen 3 Coder 480B - Cerebras (v1.3.0)
  */
 
 const CodeBlockUtils$4 = CodeBlockUtils$5;
@@ -10813,12 +10815,26 @@ function extractContextSections$1(messageContent) {
     const [summary, items] = messageContent.split(/\n---Start of Context---\n\n/);
     const sections = items.split(/\n---End of Item---\n/);
 
+    // Determine the origin of the context based on the message header
+    let contextOrigin = 'unknown'; // Default value if not determinable
+    if (messageContent.includes("## FILE CONTENT - WORKING DIRECTORY")) {
+        contextOrigin = 'working-directory';
+    } else if (messageContent.includes("## FILE CONTENT - IMPORTED")) {
+        contextOrigin = 'imported';
+    } else if (messageContent.includes("## OVERVIEW - IMPORTED")) {
+         // Handle the overview case as well, though it uses 'file content' type
+         contextOrigin = 'imported';
+    }
+
     // Process sections starting from the first potential path delimiter.
     for (let i = 0; i < sections.length; i++) {
         const contextSection = parseContextSection$1(sections[i]);
 
         if (contextSection) {
             contextSections.push(contextSection);
+            // Attach the determined context origin to the section
+            // This provides information on how the context was introduced
+            contextSection.contextOrigin = contextOrigin;
         }
     }
 
@@ -10839,6 +10855,7 @@ function extractContextItemsOverviewTableRows$1(messageContent) {
         return null;
     }
 
+    // Map the column number to the type
     const col2Field = {
         1: 'chatId',
         2: 'type', // file, tree, etc.
@@ -12036,6 +12053,174 @@ var LLMUtils$1 = {
     estimateTokens: estimateTokens$1,
 };
 
+/**
+ * Component: Date Utilities
+ * Block-UUID: fef3b0f4-8055-4690-9336-e68a9cc33a61
+ * Parent-UUID: 716e5ce9-84df-4f12-89e7-4a28e4a39a81
+ * Version: 1.0.0
+ * Description: Date formatting and manipulation utilities for GitSense Chat
+ * Language: JavaScript
+ * Created-at: 2025-10-11T23:26:20.815Z
+ * Authors: Claude-3.5-Sonnet (v1.0.0), Qwen 3 Coder 480B - Cerebras (v1.0.0)
+ */
+
+/**
+ * Ensures a date string has a timezone indicator
+ * @param {string} dateString - Date string in format "YYYY-MM-DD(T| )HH:mm:ss.SSS"
+ * @returns {string} Date string with 'Z' timezone indicator if not present
+ */
+function normalizeDateTime$1(dateString) {
+    return dateString.includes('Z') ? dateString : dateString + 'Z';
+}
+
+/**
+ * Calculates the time difference between now and a given date
+ * @param {string} dateString - Date string to compare against current time
+ * @returns {number} Difference in seconds
+ */
+function getTimeDifference$1(dateString) {
+    const now = new Date();
+    const date = new Date(normalizeDateTime$1(dateString));
+    return Math.floor((now - date) / 1000);
+}
+
+/**
+ * Formats a time difference in seconds to a human-readable string
+ * @param {number} diff - Time difference in seconds
+ * @returns {string} Formatted string (e.g., "5s ago", "2m ago", "3h ago", "2d ago")
+ */
+function formatTimeDifference$1(diff) {
+    if (diff < 60) {
+        return `${diff}s ago`;
+    } else if (diff < 3600) {
+        const minutes = Math.floor(diff / 60);
+        return `${minutes}m ago`;
+    } else if (diff < 86400) {
+        const hours = Math.floor(diff / 3600);
+        return `${hours}h ago`;
+    } else {
+        const days = Math.floor(diff / 86400);
+        return `${days}d ago`;
+    }
+}
+
+/**
+ * Formats a date string into a relative time string
+ * @param {string} dateString - Date string to format
+ * @returns {string} Formatted relative time string
+ */
+function formatAge$1(dateString) {
+    if (!dateString) {
+        return 'N/A';
+    }
+
+    try {
+        const diff = getTimeDifference$1(dateString);
+        return formatTimeDifference$1(diff);
+    } catch (error) {
+        console.error('Error formatting date:', error);
+        return 'Invalid date';
+    }
+}
+
+/**
+ * Validates a date string format
+ * @param {string} dateString - Date string to validate
+ * @returns {boolean} True if date string is valid
+ */
+function isValidDateString$1(dateString) {
+    if (!dateString) return false;
+    
+    const pattern = /^\d{4}-\d{2}-\d{2}(T| )\d{2}:\d{2}:\d{2}\.\d{3}Z?$/;
+    if (!pattern.test(dateString)) return false;
+
+    const date = new Date(normalizeDateTime$1(dateString));
+    return date instanceof Date && !isNaN(date);
+}
+
+/**
+ * Compares two date strings
+ * @param {string} dateA - First date string
+ * @param {string} dateB - Second date string
+ * @returns {number} -1 if dateA is earlier, 0 if equal, 1 if dateA is later
+ */
+function compareDates$1(dateA, dateB) {
+    if (!isValidDateString$1(dateA) || !isValidDateString$1(dateB)) {
+        throw new Error(`Invalid date string format. A: ${dateA} B: ${dateB})`);
+    }
+
+    const timeA = new Date(normalizeDateTime$1(dateA)).getTime();
+    const timeB = new Date(normalizeDateTime$1(dateB)).getTime();
+    
+    if (timeA < timeB) return -1;
+    if (timeA > timeB) return 1;
+    return 0;
+}
+
+var DateUtils$1 = {
+    formatAge: formatAge$1,
+    isValidDateString: isValidDateString$1,
+    compareDates: compareDates$1,
+    normalizeDateTime: normalizeDateTime$1,
+    getTimeDifference: getTimeDifference$1,
+    formatTimeDifference: formatTimeDifference$1
+};
+
+/**
+ * Component: Formatter Utilities
+ * Block-UUID: 9b1e07bf-e92c-43c1-9ac0-5dacdb7ae618
+ * Parent-UUID: 9c07d12f-5a05-4402-99d2-85d872d7b2f7
+ * Version: 1.0.0
+ * Description: Utility functions for formatting content in GitSense Chat
+ * Language: JavaScript
+ * Created-at: 2025-10-11T23:27:15.420Z
+ * Authors: Claude 3.7 Sonnet (v1.0.0), Claude 3.7 Sonnet (v1.1.0), Gemini 2.5 Flash Thinking (v1.2.0), Gemini 2.5 Flash Thinking (v1.3.0), Qwen 3 Coder 480B - Cerebras (v1.4.0), Qwen 3 Coder 480B - Cerebras (v1.5.0), Qwen 3 Coder 480B - Cerebras (v1.0.0)
+ */
+
+/**
+ * Formats bytes into human-readable string (KB, MB, GB)
+ * @param {number} bytes - Number of bytes
+ * @returns {string} Formatted size string
+ */
+function formatBytes$1(bytes) {
+    if (typeof bytes !== 'number' || isNaN(bytes)) return '0 bytes';
+    if (bytes === 0) return '0 bytes';
+
+    const k = 1024;
+    const sizes = ['bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+
+    // Special case for bytes (no decimal)
+    if (i === 0) return `${bytes} ${sizes[i]}`;
+
+    const value = bytes / Math.pow(k, i);
+    // Show no decimal if whole number
+    const decimalPlaces = value % 1 === 0 ? 0 : 1;
+    return `${value.toFixed(decimalPlaces)} ${sizes[i]}`;
+}
+
+/**
+ * Formats token count into human-readable string (k, m, b)
+ * @param {number} count - Number of tokens
+ * @returns {string} Formatted token string
+ */
+function formatTokens$1(count) {
+    if (typeof count !== 'number' || isNaN(count)) return '0';
+    if (count === 0) return '0';
+
+    if (count < 1000) return `${count}`;
+    if (count < 1000000) return `${(count/1000).toFixed(count >= 10000 ? 1 : 0)}k`;
+    if (count < 1000000000) return `${(count/1000000).toFixed(1)}m`;
+
+    // For billions
+    return `${(count/1000000000).toFixed(1)}b`;
+}
+
+var FormatterUtils$1 = {
+    formatBytes: formatBytes$1,
+    formatTokens: formatTokens$1
+};
+
 /*
  * Component: Config Utilities
  * Block-UUID: 65b39008-da68-462e-bcac-27db873c9ddc
@@ -12234,13 +12419,13 @@ var EnvUtils$1 = {
 
 /*
  * Component: GitSenseChatUtils
- * Block-UUID: 5e8d1a9c-0b3f-4e1a-8c7d-9f0b2e1d3a4b
- * Parent-UUID: 7a9b1c8e-f1a4-4b2d-9e8f-6f7a0b1c2d3f
- * Version: 2.1.4
+ * Block-UUID: d7cdbb94-f335-4f85-bdc4-0dd3ae95127e
+ * Parent-UUID: 5e8d1a9c-0b3f-4e1a-8c7d-9f0b2e1d3a4b
+ * Version: 2.1.5
  * Description: Interface class for GitSense Chat utilities providing a unified API for code block parsing (markdown), extraction, and patch operations. Integrates functionalities from CodeBlockUtils and PatchUtils modules, and now includes ConfigUtils and EnvUtils.
  * Language: JavaScript
  * Created-at: 2025-04-15T16:04:26.780Z
- * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v2.0.0), Gemini 2.5 Pro (v2.1.0), Gemini 2.5 Pro (v2.1.1), Gemini 2.5 Flash (v2.1.2), Gemini 2.5 Flash (v2.1.3), Gemini 2.5 Flash (v2.1.4)
+ * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v2.0.0), Gemini 2.5 Pro (v2.1.0), Gemini 2.5 Pro (v2.1.1), Gemini 2.5 Flash (v2.1.2), Gemini 2.5 Flash (v2.1.3), Gemini 2.5 Flash (v2.1.4), Qwen 3 Coder 480B - Cerebras (v2.1.5)
  */
 
 const ChatUtils = ChatUtils$1;
@@ -12253,9 +12438,20 @@ const PatchUtils = PatchUtils$2;
 const GSToolBlockUtils = GSToolBlockUtils$3;
 const LLMUtils = LLMUtils$1;
 const JsonUtils = JsonUtils$2;
+const DateUtils = DateUtils$1;
+const FormatterUtils = FormatterUtils$1;
 const ConfigUtils = ConfigUtils$1;
 const EnvUtils = EnvUtils$1;
 
+const {
+    formatAge,
+    isValidDateString,
+    compareDates,
+    normalizeDateTime,
+    getTimeDifference,
+    formatTimeDifference
+} = DateUtils;
+
 const {
     estimateTokens
 } = LLMUtils;
@@ -12357,6 +12553,11 @@ const {
     getApiKey
 } = EnvUtils;
 
+const {
+    formatBytes,
+    formatTokens,
+} = FormatterUtils;
+
 const {
     parseContextSection,
     extractContextSections,
@@ -12571,6 +12772,12 @@ class GitSenseChatUtils {
 // Export the main class, the aggregated CodeBlockUtils, PatchUtils,
 // and individual functions for backward compatibility or direct use.
 var GitSenseChatUtils_1 = {
+    // New Utility Modules
+    DateUtils,
+    FormatterUtils,
+
+    // Date Utility Functions
+
     // Main class
     GitSenseChatUtils,
 
@@ -12586,6 +12793,9 @@ var GitSenseChatUtils_1 = {
     GSToolBlockUtils,
     JsonUtils,
     ConfigUtils,
+    DateUtils,
+    FormatterUtils,
+
     EnvUtils,
 
     // --- Individual Function Exports (sourced correctly) ---
@@ -12660,6 +12870,18 @@ var GitSenseChatUtils_1 = {
     // LLM Utils
     estimateTokens,
 
+    // Date Utils
+    formatAge,
+    isValidDateString,
+    compareDates,
+    normalizeDateTime,
+    getTimeDifference,
+    formatTimeDifference,
+
+    // Formatter Utils
+    formatBytes,
+    formatTokens,
+
     // GS Tool Block
     isToolBlock,
     parseToolBlock,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitsense/gsc-utils",
-  "version": "0.2.21",
+  "version": "0.2.24",
   "description": "Utilities for GitSense Chat (GSC)",
   "main": "dist/gsc-utils.cjs.js",
   "module": "dist/gsc-utils.esm.js",