@gitsense/gsc-utils 0.2.3 → 0.2.4

package/dist/gsc-utils.cjs.js

@@ -18,7 +18,7 @@ function getDefaultExportFromCjs (x) {
  * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v1.1.0), Gemini 2.5 Flash Thinking (v1.2.0)
  */
 
-const fs = require$$0;
+const fs$2 = require$$0;
 const path = require$$1;
 const ANALYZE_MESSAGE_REGEXP = /^# Analyze - `([^`]+)`\n/;
 
@@ -58,7 +58,7 @@ function getChatTemplateMessages$1(dirname, messageType) {
 
     try {
         // Read all files in the directory
-        const files = fs.readdirSync(messagesDir);
+        const files = fs$2.readdirSync(messagesDir);
 
         // Sort files numerically (1.md, 2.md, etc.)
         const sortedFiles = files.sort((a, b) => {
@@ -71,7 +71,7 @@ function getChatTemplateMessages$1(dirname, messageType) {
         for (const file of sortedFiles) {
             if (path.extname(file) === '.md') {
                 const filePath = path.join(messagesDir, file);
-                const fileContent = fs.readFileSync(filePath, 'utf8');
+                const fileContent = fs$2.readFileSync(filePath, 'utf8');
 
                 // Split by triple newline to separate metadata from content
                 const parts = fileContent.split('\n\n\n');
@@ -8790,7 +8790,7 @@ var GSToolBlockUtils$3 = {
     formatToolBlock
 };
 
-/**
+/*
  * Component: CodeBlockUtils Continuation Utilities
  * Block-UUID: 6fdf5c7d-4def-42a1-bc88-0312f6002cfc
  * Parent-UUID: 6322afcd-2e5e-425a-9a43-4c72c887f668
@@ -8956,8 +8956,8 @@ Example of the START of your response:
 \`\`\`${language}
 /**
  * Component: ${componentName}
-* Block-UUID: 01147ddf-320f-498a-a744-198d42a9d2ee
-* Parent-UUID: e4c0d839-ea17-467d-a0cc-d269d1dbc404
+ * Block-UUID: 01147ddf-320f-498a-a744-198d42a9d2ee
+ * Parent-UUID: e4c0d839-ea17-467d-a0cc-d269d1dbc404
  * Version: ${nextVersion}
  * Description: ${description}
  * Language: ${language}
@@ -10966,15 +10966,188 @@ var LLMUtils$1 = {
     estimateTokens: estimateTokens$1,
 };
 
+/*
+ * Component: Config Utilities
+ * Block-UUID: 89016e46-9898-42f0-bef4-564e442cfaf3
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Provides utility functions for loading and accessing application configuration from data/chats.json.
+ * Language: JavaScript
+ * Created-at: 2025-08-28T17:46:26.948Z
+ * Authors: Gemini 2.5 Flash (v1.0.0)
+ */
+
+const fs$1 = require$$0.promises;
+
+/**
+ * Loads and parses the application configuration from the specified JSON file.
+ *
+ * @param {string} filePath - The absolute path to the data/chats.json file.
+ * @returns {Promise<Object>} A promise that resolves with the parsed configuration object.
+ * @throws {Error} If the file cannot be read or parsed.
+ */
+async function loadConfig$1(filePath) {
+    try {
+        const fileContent = await fs$1.readFile(filePath, 'utf8');
+        return JSON.parse(fileContent);
+    } catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`Configuration file not found at: ${filePath}`);
+        }
+        throw new Error(`Failed to load or parse configuration from ${filePath}: ${error.message}`);
+    }
+}
+
+/**
+ * Retrieves the configuration details for a specific LLM provider.
+ *
+ * @param {Object} config - The loaded configuration object.
+ * @param {string} providerName - The name of the LLM provider (e.g., "Google", "Anthropic").
+ * @returns {Object|null} The provider's configuration object or null if not found.
+ */
+function getProviderConfig$1(config, providerName) {
+    if (!config || !config.providers || !Array.isArray(config.providers)) {
+        return null;
+    }
+    return config.providers.find(p => p.name === providerName) || null;
+}
+
+/**
+ * Finds the specific modelId and other details for a given user-friendly modelName and providerName.
+ *
+ * @param {Object} config - The loaded configuration object.
+ * @param {string} modelName - The user-friendly name of the model (e.g., "Gemini 2.5 Flash").
+ * @param {string} providerName - The name of the provider associated with that model.
+ * @returns {Object|null} An object containing modelId, maxOutputTokens, and other provider-specific model details, or null if not found.
+ */
+function getModelProviderDetails$1(config, modelName, providerName) {
+    if (!config || !config.models || !Array.isArray(config.models)) {
+        return null;
+    }
+
+    const modelEntry = config.models.find(m => m.name === modelName);
+    if (!modelEntry || !modelEntry.providers || !Array.isArray(modelEntry.providers)) {
+        return null;
+    }
+
+    return modelEntry.providers.find(p => p.name === providerName) || null;
+}
+
+/**
+ * Retrieves the environment variable name (e.g., "GEMINI_API_KEY") for the API key of a specific provider.
+ *
+ * @param {Object} config - The loaded configuration object.
+ * @param {string} providerName - The name of the LLM provider.
+ * @returns {string|null} The name of the environment variable that holds the API key, or null if not found.
+ */
+function getApiKeyName$1(config, providerName) {
+    const providerConfig = getProviderConfig$1(config, providerName);
+    return providerConfig ? providerConfig.apiKeyName : null;
+}
+
+var ConfigUtils$1 = {
+    loadConfig: loadConfig$1,
+    getProviderConfig: getProviderConfig$1,
+    getModelProviderDetails: getModelProviderDetails$1,
+    getApiKeyName: getApiKeyName$1
+};
+
+/*
+ * Component: Environment Utilities
+ * Block-UUID: a4f78a41-3054-45f1-a839-778a3bd598f2
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Provides utility functions for loading and accessing environment variables from a .env file.
+ * Language: JavaScript
+ * Created-at: 2025-08-28T17:46:26.948Z
+ * Authors: Gemini 2.5 Flash (v1.0.0)
+ */
+
+const fs = require$$0.promises;
+
+// Simple .env parser, as dotenv is not explicitly a dependency
+// This handles basic KEY=VALUE pairs, ignores comments and empty lines.
+async function parseEnvFile(filePath) {
+    const env = {};
+    try {
+        const fileContent = await fs.readFile(filePath, 'utf8');
+        fileContent.split('\n').forEach(line => {
+            const trimmedLine = line.trim();
+            if (trimmedLine.length === 0 || trimmedLine.startsWith('#')) {
+                return; // Skip empty lines and comments
+            }
+            const parts = trimmedLine.split('=');
+            if (parts.length >= 2) {
+                const key = parts[0].trim();
+                const value = parts.slice(1).join('=').trim(); // Handle values with '='
+                env[key] = value;
+            }
+        });
+    } catch (error) {
+        if (error.code === 'ENOENT') {
+            console.warn(`EnvUtils: .env file not found at ${filePath}. Proceeding without loading.`);
+        } else {
+            throw new Error(`EnvUtils: Failed to read or parse .env file at ${filePath}: ${error.message}`);
+        }
+    }
+    return env;
+}
+
 /**
+ * Loads environment variables from the specified .env file path into process.env.
+ * This function will only load the .env file once per process.
+ *
+ * @param {string} filePath - The absolute path to the .env file.
+ * @returns {Promise<void>} A promise that resolves when the .env file has been processed.
+ * @throws {Error} If the file exists but cannot be read or parsed.
+ */
+let envLoaded = false;
+async function loadEnv$1(filePath) {
+    if (envLoaded) {
+        return; // Only load once
+    }
+
+    const envVars = await parseEnvFile(filePath);
+    for (const key in envVars) {
+        if (Object.hasOwnProperty.call(envVars, key)) {
+            // Only set if not already set in process.env (e.g., by system environment)
+            if (process.env[key] === undefined) {
+                process.env[key] = envVars[key];
+            }
+        }
+    }
+    envLoaded = true;
+}
+
+/**
+ * Retrieves the value of a specific API key from process.env.
+ * Assumes loadEnv has been called previously.
+ *
+ * @param {string} keyName - The name of the environment variable holding the API key (e.g., "GEMINI_API_KEY").
+ * @returns {string|null} The API key string, or null if the environment variable is not set.
+ */
+function getApiKey$1(keyName) {
+    if (typeof keyName !== 'string' || keyName.trim() === '') {
+        console.warn('EnvUtils: Attempted to get API key with an invalid keyName.');
+        return null;
+    }
+    return process.env[keyName] || null;
+}
+
+var EnvUtils$1 = {
+    loadEnv: loadEnv$1,
+    getApiKey: getApiKey$1
+};
+
+/*
  * Component: GitSenseChatUtils
  * Block-UUID: 5e8d1a9c-0b3f-4e1a-8c7d-9f0b2e1d3a4b
  * Parent-UUID: 7a9b1c8e-f1a4-4b2d-9e8f-6f7a0b1c2d3f
- * Version: 2.1.1
- * 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.
+ * Version: 2.1.2
+ * 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)
+ * 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)
  */
 
 const ChatUtils = ChatUtils$1;
@@ -10987,13 +11160,15 @@ const PatchUtils = PatchUtils$2;
 const GSToolBlockUtils = GSToolBlockUtils$3;
 const LLMUtils = LLMUtils$1;
 const JsonUtils = JsonUtils$2;
+const ConfigUtils = ConfigUtils$1;
+const EnvUtils = EnvUtils$1;
 
 const {
     estimateTokens
 } = LLMUtils;
 
-const { 
-    detectJsonComments 
+const {
+    detectJsonComments
 } = JsonUtils;
 
 const {
@@ -11059,11 +11234,24 @@ const {
     verifyAndCorrectLineNumbers,
 } = PatchUtils;
 
-const { 
+const {
     isToolBlock,
     parseToolBlock
 } = GSToolBlockUtils;
 
+const {
+    loadConfig,
+    getProviderConfig,
+    getModelProviderDetails,
+    getApiKeyName
+} = ConfigUtils;
+
+const {
+    loadEnv,
+    getApiKey
+} = EnvUtils;
+
+
 /**
  * GitSenseChatUtils class provides a unified interface to code block and patch utilities.
  * Focuses on markdown code block extraction and processing.
@@ -11208,8 +11396,8 @@ class GitSenseChatUtils {
     extractDiffContent(patchText) {
         // Uses function from PatchUtils (assuming it's named extractPatchContent or similar)
         // If PatchUtils.extractDiffContent exists, use it. Otherwise, use extractPatchContent.
-        return PatchUtils.extractDiffContent 
-            ? PatchUtils.extractDiffContent(patchText) 
+        return PatchUtils.extractDiffContent
+            ? PatchUtils.extractDiffContent(patchText)
             : PatchUtils.extractPatchContent(patchText);
     }
 
@@ -11284,6 +11472,8 @@ var GitSenseChatUtils_1 = {
     ChatUtils,
     GSToolBlockUtils,
     JsonUtils,
+    ConfigUtils,
+    EnvUtils,
 
     // --- Individual Function Exports (sourced correctly) ---
 
@@ -11316,14 +11506,14 @@ var GitSenseChatUtils_1 = {
     formatBlockWithLineNumbers,
     formatBlocksWithLineNumbers,
     removeLineNumbers,
-     
+
     // Other Utilities (from CodeBlockUtils)
     removeCodeBlockMarkers,
     parseCommentDelimitedBlocks,
     updateCodeBlockByIndex,
     deleteCodeBlockByIndex,
 
-    // Analysis Block Utilities 
+    // Analysis Block Utilities
     isOverviewBlock,
     getOverviewType,
     parseOverviewMetadata,
@@ -11335,7 +11525,7 @@ var GitSenseChatUtils_1 = {
     validateLLMAnalysisData: AnalyzerUtils.validateLLMAnalysisData,
 
     // ChatUtils
-    getChatMessages, 
+    getChatMessages,
 
     // Message Utils
     getChatTemplateMessages,
@@ -11355,6 +11545,16 @@ var GitSenseChatUtils_1 = {
     isToolBlock,
     parseToolBlock,
 
+    // Config Utils
+    loadConfig,
+    getProviderConfig,
+    getModelProviderDetails,
+    getApiKeyName,
+
+    // EnvUtils
+    loadEnv,
+    getApiKey,
+
     // Note: Internal helpers like findAllCodeFences, matchFencesAndExtractBlocks are
     // typically not exported directly from the facade but are available via CodeBlockUtils object.
 };

package/dist/gsc-utils.esm.js

@@ -16,7 +16,7 @@ function getDefaultExportFromCjs (x) {
  * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v1.1.0), Gemini 2.5 Flash Thinking (v1.2.0)
  */
 
-const fs = require$$0;
+const fs$2 = require$$0;
 const path = require$$1;
 const ANALYZE_MESSAGE_REGEXP = /^# Analyze - `([^`]+)`\n/;
 
@@ -56,7 +56,7 @@ function getChatTemplateMessages$1(dirname, messageType) {
 
     try {
         // Read all files in the directory
-        const files = fs.readdirSync(messagesDir);
+        const files = fs$2.readdirSync(messagesDir);
 
         // Sort files numerically (1.md, 2.md, etc.)
         const sortedFiles = files.sort((a, b) => {
@@ -69,7 +69,7 @@ function getChatTemplateMessages$1(dirname, messageType) {
         for (const file of sortedFiles) {
             if (path.extname(file) === '.md') {
                 const filePath = path.join(messagesDir, file);
-                const fileContent = fs.readFileSync(filePath, 'utf8');
+                const fileContent = fs$2.readFileSync(filePath, 'utf8');
 
                 // Split by triple newline to separate metadata from content
                 const parts = fileContent.split('\n\n\n');
@@ -8788,7 +8788,7 @@ var GSToolBlockUtils$3 = {
     formatToolBlock
 };
 
-/**
+/*
  * Component: CodeBlockUtils Continuation Utilities
  * Block-UUID: 6fdf5c7d-4def-42a1-bc88-0312f6002cfc
  * Parent-UUID: 6322afcd-2e5e-425a-9a43-4c72c887f668
@@ -8954,8 +8954,8 @@ Example of the START of your response:
 \`\`\`${language}
 /**
  * Component: ${componentName}
-* Block-UUID: 01147ddf-320f-498a-a744-198d42a9d2ee
-* Parent-UUID: e4c0d839-ea17-467d-a0cc-d269d1dbc404
+ * Block-UUID: 01147ddf-320f-498a-a744-198d42a9d2ee
+ * Parent-UUID: e4c0d839-ea17-467d-a0cc-d269d1dbc404
  * Version: ${nextVersion}
  * Description: ${description}
  * Language: ${language}
@@ -10964,15 +10964,188 @@ var LLMUtils$1 = {
     estimateTokens: estimateTokens$1,
 };
 
+/*
+ * Component: Config Utilities
+ * Block-UUID: 89016e46-9898-42f0-bef4-564e442cfaf3
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Provides utility functions for loading and accessing application configuration from data/chats.json.
+ * Language: JavaScript
+ * Created-at: 2025-08-28T17:46:26.948Z
+ * Authors: Gemini 2.5 Flash (v1.0.0)
+ */
+
+const fs$1 = require$$0.promises;
+
+/**
+ * Loads and parses the application configuration from the specified JSON file.
+ *
+ * @param {string} filePath - The absolute path to the data/chats.json file.
+ * @returns {Promise<Object>} A promise that resolves with the parsed configuration object.
+ * @throws {Error} If the file cannot be read or parsed.
+ */
+async function loadConfig$1(filePath) {
+    try {
+        const fileContent = await fs$1.readFile(filePath, 'utf8');
+        return JSON.parse(fileContent);
+    } catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`Configuration file not found at: ${filePath}`);
+        }
+        throw new Error(`Failed to load or parse configuration from ${filePath}: ${error.message}`);
+    }
+}
+
+/**
+ * Retrieves the configuration details for a specific LLM provider.
+ *
+ * @param {Object} config - The loaded configuration object.
+ * @param {string} providerName - The name of the LLM provider (e.g., "Google", "Anthropic").
+ * @returns {Object|null} The provider's configuration object or null if not found.
+ */
+function getProviderConfig$1(config, providerName) {
+    if (!config || !config.providers || !Array.isArray(config.providers)) {
+        return null;
+    }
+    return config.providers.find(p => p.name === providerName) || null;
+}
+
+/**
+ * Finds the specific modelId and other details for a given user-friendly modelName and providerName.
+ *
+ * @param {Object} config - The loaded configuration object.
+ * @param {string} modelName - The user-friendly name of the model (e.g., "Gemini 2.5 Flash").
+ * @param {string} providerName - The name of the provider associated with that model.
+ * @returns {Object|null} An object containing modelId, maxOutputTokens, and other provider-specific model details, or null if not found.
+ */
+function getModelProviderDetails$1(config, modelName, providerName) {
+    if (!config || !config.models || !Array.isArray(config.models)) {
+        return null;
+    }
+
+    const modelEntry = config.models.find(m => m.name === modelName);
+    if (!modelEntry || !modelEntry.providers || !Array.isArray(modelEntry.providers)) {
+        return null;
+    }
+
+    return modelEntry.providers.find(p => p.name === providerName) || null;
+}
+
+/**
+ * Retrieves the environment variable name (e.g., "GEMINI_API_KEY") for the API key of a specific provider.
+ *
+ * @param {Object} config - The loaded configuration object.
+ * @param {string} providerName - The name of the LLM provider.
+ * @returns {string|null} The name of the environment variable that holds the API key, or null if not found.
+ */
+function getApiKeyName$1(config, providerName) {
+    const providerConfig = getProviderConfig$1(config, providerName);
+    return providerConfig ? providerConfig.apiKeyName : null;
+}
+
+var ConfigUtils$1 = {
+    loadConfig: loadConfig$1,
+    getProviderConfig: getProviderConfig$1,
+    getModelProviderDetails: getModelProviderDetails$1,
+    getApiKeyName: getApiKeyName$1
+};
+
+/*
+ * Component: Environment Utilities
+ * Block-UUID: a4f78a41-3054-45f1-a839-778a3bd598f2
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Provides utility functions for loading and accessing environment variables from a .env file.
+ * Language: JavaScript
+ * Created-at: 2025-08-28T17:46:26.948Z
+ * Authors: Gemini 2.5 Flash (v1.0.0)
+ */
+
+const fs = require$$0.promises;
+
+// Simple .env parser, as dotenv is not explicitly a dependency
+// This handles basic KEY=VALUE pairs, ignores comments and empty lines.
+async function parseEnvFile(filePath) {
+    const env = {};
+    try {
+        const fileContent = await fs.readFile(filePath, 'utf8');
+        fileContent.split('\n').forEach(line => {
+            const trimmedLine = line.trim();
+            if (trimmedLine.length === 0 || trimmedLine.startsWith('#')) {
+                return; // Skip empty lines and comments
+            }
+            const parts = trimmedLine.split('=');
+            if (parts.length >= 2) {
+                const key = parts[0].trim();
+                const value = parts.slice(1).join('=').trim(); // Handle values with '='
+                env[key] = value;
+            }
+        });
+    } catch (error) {
+        if (error.code === 'ENOENT') {
+            console.warn(`EnvUtils: .env file not found at ${filePath}. Proceeding without loading.`);
+        } else {
+            throw new Error(`EnvUtils: Failed to read or parse .env file at ${filePath}: ${error.message}`);
+        }
+    }
+    return env;
+}
+
 /**
+ * Loads environment variables from the specified .env file path into process.env.
+ * This function will only load the .env file once per process.
+ *
+ * @param {string} filePath - The absolute path to the .env file.
+ * @returns {Promise<void>} A promise that resolves when the .env file has been processed.
+ * @throws {Error} If the file exists but cannot be read or parsed.
+ */
+let envLoaded = false;
+async function loadEnv$1(filePath) {
+    if (envLoaded) {
+        return; // Only load once
+    }
+
+    const envVars = await parseEnvFile(filePath);
+    for (const key in envVars) {
+        if (Object.hasOwnProperty.call(envVars, key)) {
+            // Only set if not already set in process.env (e.g., by system environment)
+            if (process.env[key] === undefined) {
+                process.env[key] = envVars[key];
+            }
+        }
+    }
+    envLoaded = true;
+}
+
+/**
+ * Retrieves the value of a specific API key from process.env.
+ * Assumes loadEnv has been called previously.
+ *
+ * @param {string} keyName - The name of the environment variable holding the API key (e.g., "GEMINI_API_KEY").
+ * @returns {string|null} The API key string, or null if the environment variable is not set.
+ */
+function getApiKey$1(keyName) {
+    if (typeof keyName !== 'string' || keyName.trim() === '') {
+        console.warn('EnvUtils: Attempted to get API key with an invalid keyName.');
+        return null;
+    }
+    return process.env[keyName] || null;
+}
+
+var EnvUtils$1 = {
+    loadEnv: loadEnv$1,
+    getApiKey: getApiKey$1
+};
+
+/*
  * Component: GitSenseChatUtils
  * Block-UUID: 5e8d1a9c-0b3f-4e1a-8c7d-9f0b2e1d3a4b
  * Parent-UUID: 7a9b1c8e-f1a4-4b2d-9e8f-6f7a0b1c2d3f
- * Version: 2.1.1
- * 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.
+ * Version: 2.1.2
+ * 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)
+ * 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)
  */
 
 const ChatUtils = ChatUtils$1;
@@ -10985,13 +11158,15 @@ const PatchUtils = PatchUtils$2;
 const GSToolBlockUtils = GSToolBlockUtils$3;
 const LLMUtils = LLMUtils$1;
 const JsonUtils = JsonUtils$2;
+const ConfigUtils = ConfigUtils$1;
+const EnvUtils = EnvUtils$1;
 
 const {
     estimateTokens
 } = LLMUtils;
 
-const { 
-    detectJsonComments 
+const {
+    detectJsonComments
 } = JsonUtils;
 
 const {
@@ -11057,11 +11232,24 @@ const {
     verifyAndCorrectLineNumbers,
 } = PatchUtils;
 
-const { 
+const {
     isToolBlock,
     parseToolBlock
 } = GSToolBlockUtils;
 
+const {
+    loadConfig,
+    getProviderConfig,
+    getModelProviderDetails,
+    getApiKeyName
+} = ConfigUtils;
+
+const {
+    loadEnv,
+    getApiKey
+} = EnvUtils;
+
+
 /**
  * GitSenseChatUtils class provides a unified interface to code block and patch utilities.
  * Focuses on markdown code block extraction and processing.
@@ -11206,8 +11394,8 @@ class GitSenseChatUtils {
     extractDiffContent(patchText) {
         // Uses function from PatchUtils (assuming it's named extractPatchContent or similar)
         // If PatchUtils.extractDiffContent exists, use it. Otherwise, use extractPatchContent.
-        return PatchUtils.extractDiffContent 
-            ? PatchUtils.extractDiffContent(patchText) 
+        return PatchUtils.extractDiffContent
+            ? PatchUtils.extractDiffContent(patchText)
             : PatchUtils.extractPatchContent(patchText);
     }
 
@@ -11282,6 +11470,8 @@ var GitSenseChatUtils_1 = {
     ChatUtils,
     GSToolBlockUtils,
     JsonUtils,
+    ConfigUtils,
+    EnvUtils,
 
     // --- Individual Function Exports (sourced correctly) ---
 
@@ -11314,14 +11504,14 @@ var GitSenseChatUtils_1 = {
     formatBlockWithLineNumbers,
     formatBlocksWithLineNumbers,
     removeLineNumbers,
-     
+
     // Other Utilities (from CodeBlockUtils)
     removeCodeBlockMarkers,
     parseCommentDelimitedBlocks,
     updateCodeBlockByIndex,
     deleteCodeBlockByIndex,
 
-    // Analysis Block Utilities 
+    // Analysis Block Utilities
     isOverviewBlock,
     getOverviewType,
     parseOverviewMetadata,
@@ -11333,7 +11523,7 @@ var GitSenseChatUtils_1 = {
     validateLLMAnalysisData: AnalyzerUtils.validateLLMAnalysisData,
 
     // ChatUtils
-    getChatMessages, 
+    getChatMessages,
 
     // Message Utils
     getChatTemplateMessages,
@@ -11353,6 +11543,16 @@ var GitSenseChatUtils_1 = {
     isToolBlock,
     parseToolBlock,
 
+    // Config Utils
+    loadConfig,
+    getProviderConfig,
+    getModelProviderDetails,
+    getApiKeyName,
+
+    // EnvUtils
+    loadEnv,
+    getApiKey,
+
     // Note: Internal helpers like findAllCodeFences, matchFencesAndExtractBlocks are
     // typically not exported directly from the facade but are available via CodeBlockUtils object.
 };

package/package.json

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

package/src/CodeBlockUtils/continuationUtils.js

@@ -1,4 +1,4 @@
-/**
+/*
  * Component: CodeBlockUtils Continuation Utilities
  * Block-UUID: 6fdf5c7d-4def-42a1-bc88-0312f6002cfc
  * Parent-UUID: 6322afcd-2e5e-425a-9a43-4c72c887f668
@@ -165,8 +165,8 @@ Example of the START of your response:
 \`\`\`${language}
 /**
  * Component: ${componentName}
-* Block-UUID: 01147ddf-320f-498a-a744-198d42a9d2ee
-* Parent-UUID: e4c0d839-ea17-467d-a0cc-d269d1dbc404
+ * Block-UUID: 01147ddf-320f-498a-a744-198d42a9d2ee
+ * Parent-UUID: e4c0d839-ea17-467d-a0cc-d269d1dbc404
  * Version: ${nextVersion}
  * Description: ${description}
  * Language: ${language}

package/src/ConfigUtils.js

@@ -0,0 +1,86 @@
+/*
+ * Component: Config Utilities
+ * Block-UUID: 89016e46-9898-42f0-bef4-564e442cfaf3
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Provides utility functions for loading and accessing application configuration from data/chats.json.
+ * Language: JavaScript
+ * Created-at: 2025-08-28T17:46:26.948Z
+ * Authors: Gemini 2.5 Flash (v1.0.0)
+ */
+
+
+const fs = require('fs').promises;
+
+/**
+ * Loads and parses the application configuration from the specified JSON file.
+ *
+ * @param {string} filePath - The absolute path to the data/chats.json file.
+ * @returns {Promise<Object>} A promise that resolves with the parsed configuration object.
+ * @throws {Error} If the file cannot be read or parsed.
+ */
+async function loadConfig(filePath) {
+    try {
+        const fileContent = await fs.readFile(filePath, 'utf8');
+        return JSON.parse(fileContent);
+    } catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`Configuration file not found at: ${filePath}`);
+        }
+        throw new Error(`Failed to load or parse configuration from ${filePath}: ${error.message}`);
+    }
+}
+
+/**
+ * Retrieves the configuration details for a specific LLM provider.
+ *
+ * @param {Object} config - The loaded configuration object.
+ * @param {string} providerName - The name of the LLM provider (e.g., "Google", "Anthropic").
+ * @returns {Object|null} The provider's configuration object or null if not found.
+ */
+function getProviderConfig(config, providerName) {
+    if (!config || !config.providers || !Array.isArray(config.providers)) {
+        return null;
+    }
+    return config.providers.find(p => p.name === providerName) || null;
+}
+
+/**
+ * Finds the specific modelId and other details for a given user-friendly modelName and providerName.
+ *
+ * @param {Object} config - The loaded configuration object.
+ * @param {string} modelName - The user-friendly name of the model (e.g., "Gemini 2.5 Flash").
+ * @param {string} providerName - The name of the provider associated with that model.
+ * @returns {Object|null} An object containing modelId, maxOutputTokens, and other provider-specific model details, or null if not found.
+ */
+function getModelProviderDetails(config, modelName, providerName) {
+    if (!config || !config.models || !Array.isArray(config.models)) {
+        return null;
+    }
+
+    const modelEntry = config.models.find(m => m.name === modelName);
+    if (!modelEntry || !modelEntry.providers || !Array.isArray(modelEntry.providers)) {
+        return null;
+    }
+
+    return modelEntry.providers.find(p => p.name === providerName) || null;
+}
+
+/**
+ * Retrieves the environment variable name (e.g., "GEMINI_API_KEY") for the API key of a specific provider.
+ *
+ * @param {Object} config - The loaded configuration object.
+ * @param {string} providerName - The name of the LLM provider.
+ * @returns {string|null} The name of the environment variable that holds the API key, or null if not found.
+ */
+function getApiKeyName(config, providerName) {
+    const providerConfig = getProviderConfig(config, providerName);
+    return providerConfig ? providerConfig.apiKeyName : null;
+}
+
+module.exports = {
+    loadConfig,
+    getProviderConfig,
+    getModelProviderDetails,
+    getApiKeyName
+};

package/src/EnvUtils.js

@@ -0,0 +1,88 @@
+/*
+ * Component: Environment Utilities
+ * Block-UUID: a4f78a41-3054-45f1-a839-778a3bd598f2
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Provides utility functions for loading and accessing environment variables from a .env file.
+ * Language: JavaScript
+ * Created-at: 2025-08-28T17:46:26.948Z
+ * Authors: Gemini 2.5 Flash (v1.0.0)
+ */
+
+
+const fs = require('fs').promises;
+const path = require('path');
+
+// Simple .env parser, as dotenv is not explicitly a dependency
+// This handles basic KEY=VALUE pairs, ignores comments and empty lines.
+async function parseEnvFile(filePath) {
+    const env = {};
+    try {
+        const fileContent = await fs.readFile(filePath, 'utf8');
+        fileContent.split('\n').forEach(line => {
+            const trimmedLine = line.trim();
+            if (trimmedLine.length === 0 || trimmedLine.startsWith('#')) {
+                return; // Skip empty lines and comments
+            }
+            const parts = trimmedLine.split('=');
+            if (parts.length >= 2) {
+                const key = parts[0].trim();
+                const value = parts.slice(1).join('=').trim(); // Handle values with '='
+                env[key] = value;
+            }
+        });
+    } catch (error) {
+        if (error.code === 'ENOENT') {
+            console.warn(`EnvUtils: .env file not found at ${filePath}. Proceeding without loading.`);
+        } else {
+            throw new Error(`EnvUtils: Failed to read or parse .env file at ${filePath}: ${error.message}`);
+        }
+    }
+    return env;
+}
+
+/**
+ * Loads environment variables from the specified .env file path into process.env.
+ * This function will only load the .env file once per process.
+ *
+ * @param {string} filePath - The absolute path to the .env file.
+ * @returns {Promise<void>} A promise that resolves when the .env file has been processed.
+ * @throws {Error} If the file exists but cannot be read or parsed.
+ */
+let envLoaded = false;
+async function loadEnv(filePath) {
+    if (envLoaded) {
+        return; // Only load once
+    }
+
+    const envVars = await parseEnvFile(filePath);
+    for (const key in envVars) {
+        if (Object.hasOwnProperty.call(envVars, key)) {
+            // Only set if not already set in process.env (e.g., by system environment)
+            if (process.env[key] === undefined) {
+                process.env[key] = envVars[key];
+            }
+        }
+    }
+    envLoaded = true;
+}
+
+/**
+ * Retrieves the value of a specific API key from process.env.
+ * Assumes loadEnv has been called previously.
+ *
+ * @param {string} keyName - The name of the environment variable holding the API key (e.g., "GEMINI_API_KEY").
+ * @returns {string|null} The API key string, or null if the environment variable is not set.
+ */
+function getApiKey(keyName) {
+    if (typeof keyName !== 'string' || keyName.trim() === '') {
+        console.warn('EnvUtils: Attempted to get API key with an invalid keyName.');
+        return null;
+    }
+    return process.env[keyName] || null;
+}
+
+module.exports = {
+    loadEnv,
+    getApiKey
+};

package/src/GitSenseChatUtils.js

@@ -1,12 +1,12 @@
-/**
+/*
  * Component: GitSenseChatUtils
  * Block-UUID: 5e8d1a9c-0b3f-4e1a-8c7d-9f0b2e1d3a4b
  * Parent-UUID: 7a9b1c8e-f1a4-4b2d-9e8f-6f7a0b1c2d3f
- * Version: 2.1.1
- * 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.
+ * Version: 2.1.2
+ * 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)
+ * 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)
  */
 
 
@@ -20,13 +20,15 @@ const PatchUtils = require('./PatchUtils');
 const GSToolBlockUtils = require('./GSToolBlockUtils');
 const LLMUtils = require('./LLMUtils');
 const JsonUtils = require('./JsonUtils');
+const ConfigUtils = require('./ConfigUtils');
+const EnvUtils = require('./EnvUtils');
 
 const {
     estimateTokens
 } = LLMUtils;
 
-const { 
-    detectJsonComments 
+const {
+    detectJsonComments
 } = JsonUtils;
 
 const {
@@ -92,11 +94,24 @@ const {
     verifyAndCorrectLineNumbers,
 } = PatchUtils;
 
-const { 
+const {
     isToolBlock,
     parseToolBlock
 } = GSToolBlockUtils;
 
+const {
+    loadConfig,
+    getProviderConfig,
+    getModelProviderDetails,
+    getApiKeyName
+} = ConfigUtils;
+
+const {
+    loadEnv,
+    getApiKey
+} = EnvUtils;
+
+
 /**
  * GitSenseChatUtils class provides a unified interface to code block and patch utilities.
  * Focuses on markdown code block extraction and processing.
@@ -241,8 +256,8 @@ class GitSenseChatUtils {
     extractDiffContent(patchText) {
         // Uses function from PatchUtils (assuming it's named extractPatchContent or similar)
         // If PatchUtils.extractDiffContent exists, use it. Otherwise, use extractPatchContent.
-        return PatchUtils.extractDiffContent 
-            ? PatchUtils.extractDiffContent(patchText) 
+        return PatchUtils.extractDiffContent
+            ? PatchUtils.extractDiffContent(patchText)
             : PatchUtils.extractPatchContent(patchText);
     }
 
@@ -317,6 +332,8 @@ module.exports = {
     ChatUtils,
     GSToolBlockUtils,
     JsonUtils,
+    ConfigUtils,
+    EnvUtils,
 
     // --- Individual Function Exports (sourced correctly) ---
 
@@ -349,14 +366,14 @@ module.exports = {
     formatBlockWithLineNumbers,
     formatBlocksWithLineNumbers,
     removeLineNumbers,
-     
+
     // Other Utilities (from CodeBlockUtils)
     removeCodeBlockMarkers,
     parseCommentDelimitedBlocks,
     updateCodeBlockByIndex,
     deleteCodeBlockByIndex,
 
-    // Analysis Block Utilities 
+    // Analysis Block Utilities
     isOverviewBlock,
     getOverviewType,
     parseOverviewMetadata,
@@ -368,7 +385,7 @@ module.exports = {
     validateLLMAnalysisData: AnalyzerUtils.validateLLMAnalysisData,
 
     // ChatUtils
-    getChatMessages, 
+    getChatMessages,
 
     // Message Utils
     getChatTemplateMessages,
@@ -388,6 +405,16 @@ module.exports = {
     isToolBlock,
     parseToolBlock,
 
+    // Config Utils
+    loadConfig,
+    getProviderConfig,
+    getModelProviderDetails,
+    getApiKeyName,
+
+    // EnvUtils
+    loadEnv,
+    getApiKey,
+
     // Note: Internal helpers like findAllCodeFences, matchFencesAndExtractBlocks are
     // typically not exported directly from the facade but are available via CodeBlockUtils object.
 };