git-coco 0.26.0 → 0.27.1

package/dist/index.d.ts

@@ -86,6 +86,14 @@ type OllamaFields = Partial<OllamaInput> & BaseLLMParams;
 type OpenAILLMService = BaseLLMService & {
     provider: 'openai';
     model: OpenAIModel;
+    /**
+     * Custom base URL for OpenAI-compatible APIs (e.g., OpenRouter, Azure OpenAI).
+     * If not specified, uses the default OpenAI API endpoint.
+     *
+     * @example "https://openrouter.ai/api/v1"
+     * @example "https://your-resource.openai.azure.com"
+     */
+    baseURL?: string;
     fields?: OpenAIFields;
 };
 type OllamaLLMService = BaseLLMService & {

package/dist/index.esm.mjs

@@ -46,7 +46,7 @@ import { pathToFileURL } from 'url';
 /**
  * Current build version from package.json
  */
-const BUILD_VERSION = "0.26.0";
+const BUILD_VERSION = "0.27.1";
 
 const isInteractive = (config) => {
     return config?.mode === 'interactive' || !!config?.interactive;
@@ -226,6 +226,16 @@ class LangChainAuthenticationError extends LangChainError {
         super(message, context);
     }
 }
+/**
+ * Network/connection errors (service unreachable, DNS failures, etc.)
+ */
+class LangChainNetworkError extends LangChainError {
+    constructor(message, endpoint, provider, context) {
+        super(message, { ...context, endpoint, provider });
+        this.endpoint = endpoint;
+        this.provider = provider;
+    }
+}
 
 /**
  * Validates that a required parameter is not null or undefined
@@ -479,6 +489,7 @@ function loadEnvConfig(config) {
         'COCO_SERVICE_PROVIDER',
         'COCO_SERVICE_MODEL',
         'OPEN_AI_KEY',
+        'COCO_SERVICE_BASE_URL',
         'COCO_SERVICE_ENDPOINT',
         'COCO_SERVICE_REQUEST_OPTIONS_TIMEOUT',
         'COCO_SERVICE_REQUEST_OPTIONS_MAX_RETRIES',
@@ -493,6 +504,7 @@ function loadEnvConfig(config) {
         if (key === 'COCO_SERVICE_PROVIDER' ||
             key === 'COCO_SERVICE_MODEL' ||
             key === 'OPEN_AI_KEY' ||
+            key === 'COCO_SERVICE_BASE_URL' ||
             key === 'COCO_SERVICE_ENDPOINT' ||
             key === 'COCO_SERVICE_REQUEST_OPTIONS_TIMEOUT' ||
             key === 'COCO_SERVICE_REQUEST_OPTIONS_MAX_RETRIES' ||
@@ -531,6 +543,12 @@ function handleServiceEnvVar(service, key, value) {
                 };
             }
             break;
+        case 'COCO_SERVICE_BASE_URL':
+            if (service.provider === 'openai') {
+                // Cast to OpenAILLMService to access baseURL property
+                service.baseURL = value;
+            }
+            break;
         case 'COCO_SERVICE_ENDPOINT':
             if (service.provider === 'ollama') {
                 service.endpoint = value;
@@ -659,6 +677,7 @@ function loadGitConfig(config) {
                 maxParsingAttempts: gitConfigParsed.coco?.serviceMaxParsingAttempts
                     ? Number(gitConfigParsed.coco.serviceMaxParsingAttempts)
                     : undefined,
+                baseURL: gitConfigParsed.coco?.serviceBaseURL,
                 authentication: {
                     type: 'APIKey',
                     credentials: {
@@ -738,6 +757,11 @@ const appendToGitConfig = async (filePath, config) => {
                 if (service.requestOptions?.maxRetries) {
                     contentLines.push(`	serviceRequestOptionsMaxRetries = ${service.requestOptions.maxRetries}`);
                 }
+                // Handle baseURL for OpenAI
+                if (service.provider === 'openai' && 'baseURL' in service && service.baseURL) {
+                    contentLines.push(`	serviceBaseURL = ${service.baseURL}`);
+                }
+                // Handle endpoint for Ollama
                 if (service.provider === 'ollama') {
                     const ollamaService = service;
                     if (ollamaService.endpoint) {
@@ -928,6 +952,14 @@ const schema$1 = {
                 "model": {
                     "$ref": "#/definitions/LLMModel"
                 },
+                "baseURL": {
+                    "type": "string",
+                    "description": "Custom base URL for OpenAI-compatible APIs (e.g., OpenRouter, Azure OpenAI). If not specified, uses the default OpenAI API endpoint.",
+                    "examples": [
+                        "https://openrouter.ai/api/v1",
+                        "https://your-resource.openai.azure.com"
+                    ]
+                },
                 "fields": {
                     "type": "object",
                     "additionalProperties": false,
@@ -2202,12 +2234,14 @@ function parseServiceConfig(service) {
             return {
                 provider: 'openai',
                 model: service.model,
+                baseURL: service.baseURL,
                 authentication: {
                     type: 'APIKey',
                     credentials: {
                         apiKey: service.apiKey
                     }
-                }
+                },
+                fields: service.fields
             };
         case 'anthropic':
             return {
@@ -2327,6 +2361,59 @@ class Logger {
     }
 }
 
+/**
+ * Formats a network error with helpful troubleshooting information
+ */
+function formatNetworkError(error, logger) {
+    const endpoint = error.endpoint || 'unknown endpoint';
+    const provider = error.provider || 'LLM service';
+    logger.log('\nFailed to execute command', { color: 'yellow' });
+    logger.log(`\nError: Unable to connect to ${provider}`, { color: 'red' });
+    if (error.endpoint) {
+        logger.log(`       Endpoint: ${endpoint}`, { color: 'red' });
+    }
+    logger.log('\nTroubleshooting:', { color: 'cyan' });
+    // Provider-specific troubleshooting
+    if (provider === 'ollama' || endpoint.includes('11434')) {
+        logger.log('  • Is Ollama running? Try: ollama serve', { color: 'white' });
+        logger.log('  • Check if the endpoint is correct in your config', { color: 'white' });
+        logger.log(`  • Verify Ollama is accessible: curl ${endpoint}/api/version`, { color: 'white' });
+    }
+    else if (provider === 'openai' || endpoint.includes('openai')) {
+        logger.log('  • Check your internet connection', { color: 'white' });
+        logger.log('  • Verify the API endpoint is accessible', { color: 'white' });
+        logger.log('  • If using a custom baseURL, verify it is correct', { color: 'white' });
+    }
+    else if (provider === 'anthropic') {
+        logger.log('  • Check your internet connection', { color: 'white' });
+        logger.log('  • Verify the Anthropic API is accessible', { color: 'white' });
+    }
+    else {
+        logger.log('  • Check your internet connection', { color: 'white' });
+        logger.log('  • Verify the service endpoint is correct', { color: 'white' });
+        logger.log('  • Ensure the LLM service is running and accessible', { color: 'white' });
+    }
+    logger.verbose(`\nOriginal error: ${error.message}`, { color: 'gray' });
+}
+/**
+ * Formats an authentication error with helpful information
+ */
+function formatAuthenticationError(error, logger) {
+    logger.log('\nFailed to execute command', { color: 'yellow' });
+    logger.log('\nError: Authentication failed', { color: 'red' });
+    logger.log('\nTroubleshooting:', { color: 'cyan' });
+    logger.log('  • Verify your API key is correct', { color: 'white' });
+    logger.log('  • Check that your API key has not expired', { color: 'white' });
+    logger.log('  • Ensure the API key is set in your environment or config', { color: 'white' });
+    logger.verbose(`\nOriginal error: ${error.message}`, { color: 'gray' });
+}
+/**
+ * Formats a generic error
+ */
+function formatGenericError(error, logger) {
+    logger.log('\nFailed to execute command', { color: 'yellow' });
+    logger.verbose(`\nError: "${error.message}"`, { color: 'red' });
+}
 function commandExecutor(handler) {
     return async (argv) => {
         const options = loadConfig(argv);
@@ -2335,8 +2422,16 @@ function commandExecutor(handler) {
             await handler(argv, logger);
         }
         catch (error) {
-            logger.log('\nFailed to execute command', { color: 'yellow' });
-            logger.verbose(`\nError: "${error.message}"`, { color: 'red' });
+            // Handle specific error types with helpful messages
+            if (error instanceof LangChainNetworkError) {
+                formatNetworkError(error, logger);
+            }
+            else if (error instanceof LangChainAuthenticationError) {
+                formatAuthenticationError(error, logger);
+            }
+            else {
+                formatGenericError(error, logger);
+            }
             logger.log('\nThanks for using coco, make it a great day! 👋🤖', { color: 'blue' });
             process.exit(0);
         }
@@ -6228,10 +6323,50 @@ async function withRetry(operation, options = {}) {
     throw new Error(`Operation failed after ${maxAttempts} attempts. Last error: ${lastError.message}`);
 }
 
+/**
+ * Network error patterns to detect connection failures
+ */
+const NETWORK_ERROR_PATTERNS = [
+    'fetch failed',
+    'ECONNREFUSED',
+    'ENOTFOUND',
+    'ETIMEDOUT',
+    'ECONNRESET',
+    'ENETUNREACH',
+    'EHOSTUNREACH',
+    'socket hang up',
+    'network request failed',
+    'Failed to fetch',
+    'getaddrinfo',
+    'connect ECONNREFUSED',
+];
+/**
+ * Checks if an error message indicates a network/connection failure
+ */
+function isNetworkError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    const errorCause = error?.cause?.message?.toLowerCase() || '';
+    return NETWORK_ERROR_PATTERNS.some(pattern => message.includes(pattern.toLowerCase()) ||
+        errorCause.includes(pattern.toLowerCase()));
+}
 /**
  * Wraps errors with additional context and converts them to LangChain errors
  */
 function handleLangChainError(error, context, additionalContext) {
+    // Check for network errors first
+    if (error instanceof Error && isNetworkError(error)) {
+        const endpoint = additionalContext?.endpoint;
+        const provider = additionalContext?.provider;
+        throw new LangChainNetworkError(error.message, endpoint, provider, {
+            originalError: error.name,
+            originalMessage: error.message,
+            stack: error.stack,
+            context,
+            ...additionalContext
+        });
+    }
     // If it's already a LangChain error, re-throw with additional context
     if (error instanceof LangChainError) {
         throw new LangChainExecutionError(`${context}: ${error.message}`, {
@@ -6302,11 +6437,22 @@ function getLlm(provider, model, config) {
                     model,
                 });
             case 'openai':
-                return new ChatOpenAI({
+                const openaiConfig = {
                     apiKey: apiKey,
                     model,
                     temperature: config.service.temperature || 0.2,
-                });
+                };
+                // Add custom base URL if specified (for OpenRouter, Azure OpenAI, etc.)
+                if ('baseURL' in config.service && config.service.baseURL) {
+                    openaiConfig.configuration = {
+                        baseURL: config.service.baseURL,
+                    };
+                }
+                // Merge any additional fields from config
+                if ('fields' in config.service && config.service.fields) {
+                    Object.assign(openaiConfig, config.service.fields);
+                }
+                return new ChatOpenAI(openaiConfig);
             default:
                 throw new LangChainConfigurationError(`getLlm: Unsupported provider '${provider}'`, { provider, model, supportedProviders: ['openai', 'anthropic', 'ollama'] });
         }
@@ -7004,21 +7150,55 @@ You must return ONLY valid JSON that matches the schema exactly. Do not include
     }
 }
 
+/**
+ * Extracts provider and endpoint info from LLM instance if available
+ */
+function extractLlmInfo(llm) {
+    const info = {};
+    // Try to extract provider from class name
+    const className = llm?.constructor?.name || '';
+    if (className.includes('Ollama')) {
+        info.provider = 'ollama';
+        // Try to get baseUrl from ollama instance
+        if ('lc_kwargs' in llm && typeof llm.lc_kwargs === 'object' && llm.lc_kwargs !== null) {
+            const kwargs = llm.lc_kwargs;
+            if (typeof kwargs.baseUrl === 'string') {
+                info.endpoint = kwargs.baseUrl;
+            }
+        }
+    }
+    else if (className.includes('OpenAI')) {
+        info.provider = 'openai';
+    }
+    else if (className.includes('Anthropic')) {
+        info.provider = 'anthropic';
+    }
+    return info;
+}
 /**
  * Executes a LangChain pipeline with the provided LLM, prompt, variables, and parser.
  * @param params - The execution parameters
  * @returns The parsed result from the LLM chain
  * @throws LangChainExecutionError if the chain execution fails or returns empty results
+ * @throws LangChainNetworkError if a network/connection error occurs
  */
-const executeChain = async ({ llm, prompt, variables, parser }) => {
+const executeChain = async ({ llm, prompt, variables, parser, provider, endpoint, }) => {
     validateRequired(llm, 'llm', 'executeChain');
     validateRequired(prompt, 'prompt', 'executeChain');
     validateRequired(variables, 'variables', 'executeChain');
     validateRequired(parser, 'parser', 'executeChain');
     // Validate that variables is an object
     if (typeof variables !== 'object' || Array.isArray(variables)) {
-        throw new LangChainExecutionError('executeChain: Variables must be a non-array object', { variables, type: typeof variables, isArray: Array.isArray(variables) });
+        throw new LangChainExecutionError('executeChain: Variables must be a non-array object', {
+            variables,
+            type: typeof variables,
+            isArray: Array.isArray(variables),
+        });
     }
+    // Extract LLM info for error reporting if not provided
+    const llmInfo = extractLlmInfo(llm);
+    const effectiveProvider = provider || llmInfo.provider;
+    const effectiveEndpoint = endpoint || llmInfo.endpoint;
     try {
         const chain = prompt.pipe(llm).pipe(parser);
         const result = await chain.invoke(variables);
@@ -7029,14 +7209,27 @@ const executeChain = async ({ llm, prompt, variables, parser }) => {
     }
     catch (error) {
         // Re-throw LangChain errors as-is
-        if (error instanceof LangChainExecutionError) {
+        if (error instanceof LangChainExecutionError || error instanceof LangChainNetworkError) {
             throw error;
         }
+        // Check for network errors and throw specific error type
+        if (error instanceof Error && isNetworkError(error)) {
+            throw new LangChainNetworkError(error.message, effectiveEndpoint, effectiveProvider, {
+                originalError: error.name,
+                originalMessage: error.message,
+                stack: error.stack,
+                promptInputVariables: prompt.inputVariables,
+                variableKeys: Object.keys(variables),
+                parserType: parser.constructor.name,
+            });
+        }
         // Wrap other errors with context
         handleLangChainError(error, 'executeChain: Chain execution failed', {
             promptInputVariables: prompt.inputVariables,
             variableKeys: Object.keys(variables),
-            parserType: parser.constructor.name
+            parserType: parser.constructor.name,
+            provider: effectiveProvider,
+            endpoint: effectiveEndpoint,
         });
     }
 };

package/dist/index.js

@@ -68,7 +68,7 @@ var readline__namespace = /*#__PURE__*/_interopNamespaceDefault(readline);
 /**
  * Current build version from package.json
  */
-const BUILD_VERSION = "0.26.0";
+const BUILD_VERSION = "0.27.1";
 
 const isInteractive = (config) => {
     return config?.mode === 'interactive' || !!config?.interactive;
@@ -248,6 +248,16 @@ class LangChainAuthenticationError extends LangChainError {
         super(message, context);
     }
 }
+/**
+ * Network/connection errors (service unreachable, DNS failures, etc.)
+ */
+class LangChainNetworkError extends LangChainError {
+    constructor(message, endpoint, provider, context) {
+        super(message, { ...context, endpoint, provider });
+        this.endpoint = endpoint;
+        this.provider = provider;
+    }
+}
 
 /**
  * Validates that a required parameter is not null or undefined
@@ -501,6 +511,7 @@ function loadEnvConfig(config) {
         'COCO_SERVICE_PROVIDER',
         'COCO_SERVICE_MODEL',
         'OPEN_AI_KEY',
+        'COCO_SERVICE_BASE_URL',
         'COCO_SERVICE_ENDPOINT',
         'COCO_SERVICE_REQUEST_OPTIONS_TIMEOUT',
         'COCO_SERVICE_REQUEST_OPTIONS_MAX_RETRIES',
@@ -515,6 +526,7 @@ function loadEnvConfig(config) {
         if (key === 'COCO_SERVICE_PROVIDER' ||
             key === 'COCO_SERVICE_MODEL' ||
             key === 'OPEN_AI_KEY' ||
+            key === 'COCO_SERVICE_BASE_URL' ||
             key === 'COCO_SERVICE_ENDPOINT' ||
             key === 'COCO_SERVICE_REQUEST_OPTIONS_TIMEOUT' ||
             key === 'COCO_SERVICE_REQUEST_OPTIONS_MAX_RETRIES' ||
@@ -553,6 +565,12 @@ function handleServiceEnvVar(service, key, value) {
                 };
             }
             break;
+        case 'COCO_SERVICE_BASE_URL':
+            if (service.provider === 'openai') {
+                // Cast to OpenAILLMService to access baseURL property
+                service.baseURL = value;
+            }
+            break;
         case 'COCO_SERVICE_ENDPOINT':
             if (service.provider === 'ollama') {
                 service.endpoint = value;
@@ -681,6 +699,7 @@ function loadGitConfig(config) {
                 maxParsingAttempts: gitConfigParsed.coco?.serviceMaxParsingAttempts
                     ? Number(gitConfigParsed.coco.serviceMaxParsingAttempts)
                     : undefined,
+                baseURL: gitConfigParsed.coco?.serviceBaseURL,
                 authentication: {
                     type: 'APIKey',
                     credentials: {
@@ -760,6 +779,11 @@ const appendToGitConfig = async (filePath, config) => {
                 if (service.requestOptions?.maxRetries) {
                     contentLines.push(`	serviceRequestOptionsMaxRetries = ${service.requestOptions.maxRetries}`);
                 }
+                // Handle baseURL for OpenAI
+                if (service.provider === 'openai' && 'baseURL' in service && service.baseURL) {
+                    contentLines.push(`	serviceBaseURL = ${service.baseURL}`);
+                }
+                // Handle endpoint for Ollama
                 if (service.provider === 'ollama') {
                     const ollamaService = service;
                     if (ollamaService.endpoint) {
@@ -950,6 +974,14 @@ const schema$1 = {
                 "model": {
                     "$ref": "#/definitions/LLMModel"
                 },
+                "baseURL": {
+                    "type": "string",
+                    "description": "Custom base URL for OpenAI-compatible APIs (e.g., OpenRouter, Azure OpenAI). If not specified, uses the default OpenAI API endpoint.",
+                    "examples": [
+                        "https://openrouter.ai/api/v1",
+                        "https://your-resource.openai.azure.com"
+                    ]
+                },
                 "fields": {
                     "type": "object",
                     "additionalProperties": false,
@@ -2224,12 +2256,14 @@ function parseServiceConfig(service) {
             return {
                 provider: 'openai',
                 model: service.model,
+                baseURL: service.baseURL,
                 authentication: {
                     type: 'APIKey',
                     credentials: {
                         apiKey: service.apiKey
                     }
-                }
+                },
+                fields: service.fields
             };
         case 'anthropic':
             return {
@@ -2349,6 +2383,59 @@ class Logger {
     }
 }
 
+/**
+ * Formats a network error with helpful troubleshooting information
+ */
+function formatNetworkError(error, logger) {
+    const endpoint = error.endpoint || 'unknown endpoint';
+    const provider = error.provider || 'LLM service';
+    logger.log('\nFailed to execute command', { color: 'yellow' });
+    logger.log(`\nError: Unable to connect to ${provider}`, { color: 'red' });
+    if (error.endpoint) {
+        logger.log(`       Endpoint: ${endpoint}`, { color: 'red' });
+    }
+    logger.log('\nTroubleshooting:', { color: 'cyan' });
+    // Provider-specific troubleshooting
+    if (provider === 'ollama' || endpoint.includes('11434')) {
+        logger.log('  • Is Ollama running? Try: ollama serve', { color: 'white' });
+        logger.log('  • Check if the endpoint is correct in your config', { color: 'white' });
+        logger.log(`  • Verify Ollama is accessible: curl ${endpoint}/api/version`, { color: 'white' });
+    }
+    else if (provider === 'openai' || endpoint.includes('openai')) {
+        logger.log('  • Check your internet connection', { color: 'white' });
+        logger.log('  • Verify the API endpoint is accessible', { color: 'white' });
+        logger.log('  • If using a custom baseURL, verify it is correct', { color: 'white' });
+    }
+    else if (provider === 'anthropic') {
+        logger.log('  • Check your internet connection', { color: 'white' });
+        logger.log('  • Verify the Anthropic API is accessible', { color: 'white' });
+    }
+    else {
+        logger.log('  • Check your internet connection', { color: 'white' });
+        logger.log('  • Verify the service endpoint is correct', { color: 'white' });
+        logger.log('  • Ensure the LLM service is running and accessible', { color: 'white' });
+    }
+    logger.verbose(`\nOriginal error: ${error.message}`, { color: 'gray' });
+}
+/**
+ * Formats an authentication error with helpful information
+ */
+function formatAuthenticationError(error, logger) {
+    logger.log('\nFailed to execute command', { color: 'yellow' });
+    logger.log('\nError: Authentication failed', { color: 'red' });
+    logger.log('\nTroubleshooting:', { color: 'cyan' });
+    logger.log('  • Verify your API key is correct', { color: 'white' });
+    logger.log('  • Check that your API key has not expired', { color: 'white' });
+    logger.log('  • Ensure the API key is set in your environment or config', { color: 'white' });
+    logger.verbose(`\nOriginal error: ${error.message}`, { color: 'gray' });
+}
+/**
+ * Formats a generic error
+ */
+function formatGenericError(error, logger) {
+    logger.log('\nFailed to execute command', { color: 'yellow' });
+    logger.verbose(`\nError: "${error.message}"`, { color: 'red' });
+}
 function commandExecutor(handler) {
     return async (argv) => {
         const options = loadConfig(argv);
@@ -2357,8 +2444,16 @@ function commandExecutor(handler) {
             await handler(argv, logger);
         }
         catch (error) {
-            logger.log('\nFailed to execute command', { color: 'yellow' });
-            logger.verbose(`\nError: "${error.message}"`, { color: 'red' });
+            // Handle specific error types with helpful messages
+            if (error instanceof LangChainNetworkError) {
+                formatNetworkError(error, logger);
+            }
+            else if (error instanceof LangChainAuthenticationError) {
+                formatAuthenticationError(error, logger);
+            }
+            else {
+                formatGenericError(error, logger);
+            }
             logger.log('\nThanks for using coco, make it a great day! 👋🤖', { color: 'blue' });
             process.exit(0);
         }
@@ -6250,10 +6345,50 @@ async function withRetry(operation, options = {}) {
     throw new Error(`Operation failed after ${maxAttempts} attempts. Last error: ${lastError.message}`);
 }
 
+/**
+ * Network error patterns to detect connection failures
+ */
+const NETWORK_ERROR_PATTERNS = [
+    'fetch failed',
+    'ECONNREFUSED',
+    'ENOTFOUND',
+    'ETIMEDOUT',
+    'ECONNRESET',
+    'ENETUNREACH',
+    'EHOSTUNREACH',
+    'socket hang up',
+    'network request failed',
+    'Failed to fetch',
+    'getaddrinfo',
+    'connect ECONNREFUSED',
+];
+/**
+ * Checks if an error message indicates a network/connection failure
+ */
+function isNetworkError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    const errorCause = error?.cause?.message?.toLowerCase() || '';
+    return NETWORK_ERROR_PATTERNS.some(pattern => message.includes(pattern.toLowerCase()) ||
+        errorCause.includes(pattern.toLowerCase()));
+}
 /**
  * Wraps errors with additional context and converts them to LangChain errors
  */
 function handleLangChainError(error, context, additionalContext) {
+    // Check for network errors first
+    if (error instanceof Error && isNetworkError(error)) {
+        const endpoint = additionalContext?.endpoint;
+        const provider = additionalContext?.provider;
+        throw new LangChainNetworkError(error.message, endpoint, provider, {
+            originalError: error.name,
+            originalMessage: error.message,
+            stack: error.stack,
+            context,
+            ...additionalContext
+        });
+    }
     // If it's already a LangChain error, re-throw with additional context
     if (error instanceof LangChainError) {
         throw new LangChainExecutionError(`${context}: ${error.message}`, {
@@ -6324,11 +6459,22 @@ function getLlm(provider, model, config) {
                     model,
                 });
             case 'openai':
-                return new openai.ChatOpenAI({
+                const openaiConfig = {
                     apiKey: apiKey,
                     model,
                     temperature: config.service.temperature || 0.2,
-                });
+                };
+                // Add custom base URL if specified (for OpenRouter, Azure OpenAI, etc.)
+                if ('baseURL' in config.service && config.service.baseURL) {
+                    openaiConfig.configuration = {
+                        baseURL: config.service.baseURL,
+                    };
+                }
+                // Merge any additional fields from config
+                if ('fields' in config.service && config.service.fields) {
+                    Object.assign(openaiConfig, config.service.fields);
+                }
+                return new openai.ChatOpenAI(openaiConfig);
             default:
                 throw new LangChainConfigurationError(`getLlm: Unsupported provider '${provider}'`, { provider, model, supportedProviders: ['openai', 'anthropic', 'ollama'] });
         }
@@ -7026,21 +7172,55 @@ You must return ONLY valid JSON that matches the schema exactly. Do not include
     }
 }
 
+/**
+ * Extracts provider and endpoint info from LLM instance if available
+ */
+function extractLlmInfo(llm) {
+    const info = {};
+    // Try to extract provider from class name
+    const className = llm?.constructor?.name || '';
+    if (className.includes('Ollama')) {
+        info.provider = 'ollama';
+        // Try to get baseUrl from ollama instance
+        if ('lc_kwargs' in llm && typeof llm.lc_kwargs === 'object' && llm.lc_kwargs !== null) {
+            const kwargs = llm.lc_kwargs;
+            if (typeof kwargs.baseUrl === 'string') {
+                info.endpoint = kwargs.baseUrl;
+            }
+        }
+    }
+    else if (className.includes('OpenAI')) {
+        info.provider = 'openai';
+    }
+    else if (className.includes('Anthropic')) {
+        info.provider = 'anthropic';
+    }
+    return info;
+}
 /**
  * Executes a LangChain pipeline with the provided LLM, prompt, variables, and parser.
  * @param params - The execution parameters
  * @returns The parsed result from the LLM chain
  * @throws LangChainExecutionError if the chain execution fails or returns empty results
+ * @throws LangChainNetworkError if a network/connection error occurs
  */
-const executeChain = async ({ llm, prompt, variables, parser }) => {
+const executeChain = async ({ llm, prompt, variables, parser, provider, endpoint, }) => {
     validateRequired(llm, 'llm', 'executeChain');
     validateRequired(prompt, 'prompt', 'executeChain');
     validateRequired(variables, 'variables', 'executeChain');
     validateRequired(parser, 'parser', 'executeChain');
     // Validate that variables is an object
     if (typeof variables !== 'object' || Array.isArray(variables)) {
-        throw new LangChainExecutionError('executeChain: Variables must be a non-array object', { variables, type: typeof variables, isArray: Array.isArray(variables) });
+        throw new LangChainExecutionError('executeChain: Variables must be a non-array object', {
+            variables,
+            type: typeof variables,
+            isArray: Array.isArray(variables),
+        });
     }
+    // Extract LLM info for error reporting if not provided
+    const llmInfo = extractLlmInfo(llm);
+    const effectiveProvider = provider || llmInfo.provider;
+    const effectiveEndpoint = endpoint || llmInfo.endpoint;
     try {
         const chain = prompt.pipe(llm).pipe(parser);
         const result = await chain.invoke(variables);
@@ -7051,14 +7231,27 @@ const executeChain = async ({ llm, prompt, variables, parser }) => {
     }
     catch (error) {
         // Re-throw LangChain errors as-is
-        if (error instanceof LangChainExecutionError) {
+        if (error instanceof LangChainExecutionError || error instanceof LangChainNetworkError) {
             throw error;
         }
+        // Check for network errors and throw specific error type
+        if (error instanceof Error && isNetworkError(error)) {
+            throw new LangChainNetworkError(error.message, effectiveEndpoint, effectiveProvider, {
+                originalError: error.name,
+                originalMessage: error.message,
+                stack: error.stack,
+                promptInputVariables: prompt.inputVariables,
+                variableKeys: Object.keys(variables),
+                parserType: parser.constructor.name,
+            });
+        }
         // Wrap other errors with context
         handleLangChainError(error, 'executeChain: Chain execution failed', {
             promptInputVariables: prompt.inputVariables,
             variableKeys: Object.keys(variables),
-            parserType: parser.constructor.name
+            parserType: parser.constructor.name,
+            provider: effectiveProvider,
+            endpoint: effectiveEndpoint,
         });
     }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "git-coco",
-  "version": "0.26.0",
+  "version": "0.27.1",
   "description": "zero-effort git commits with coco.",
   "author": "gfargo <ghfargo@gmail.com>",
   "license": "MIT",