nttp 1.4.6 → 1.4.10

package/dist/cli/setup-non-interactive.js

@@ -0,0 +1,166 @@
+/**
+ * Non-interactive setup for LLM agents and automation
+ */
+import { writeFileSync, existsSync } from 'fs';
+import { execSync } from 'child_process';
+const LLM_MODELS = {
+    anthropic: 'claude-sonnet-4-5-20250929',
+    openai: 'gpt-4o',
+    cohere: 'command-r-plus',
+    mistral: 'mistral-large-latest',
+    google: 'gemini-pro',
+};
+export function runNonInteractiveSetup(options) {
+    console.log('🤖 Running non-interactive setup...\n');
+    // Validate required options
+    const errors = [];
+    if (!options.databaseType) {
+        errors.push('--database-type is required (pg, mysql2, better-sqlite3, mssql)');
+    }
+    if (options.databaseType === 'better-sqlite3') {
+        if (!options.databasePath) {
+            errors.push('--database-path is required for SQLite');
+        }
+    }
+    else {
+        if (!options.databaseUrl) {
+            errors.push('--database-url is required');
+        }
+    }
+    if (!options.llmProvider) {
+        errors.push('--llm-provider is required (anthropic, openai, cohere, mistral, google)');
+    }
+    if (!options.llmApiKey) {
+        errors.push('--llm-api-key is required');
+    }
+    if (options.enableL2Cache && !options.embeddingApiKey) {
+        errors.push('--embedding-api-key is required when --enable-l2-cache is set');
+    }
+    if (errors.length > 0) {
+        console.error('❌ Configuration errors:\n');
+        errors.forEach(err => console.error(`  • ${err}`));
+        console.error('\n💡 Example usage:');
+        console.error('  npx nttp setup --non-interactive \\');
+        console.error('    --database-type=pg \\');
+        console.error('    --database-url=postgresql://user:pass@localhost/db \\');
+        console.error('    --llm-provider=anthropic \\');
+        console.error('    --llm-api-key=sk-ant-... \\');
+        console.error('    --redis-url=redis://localhost:6379 \\');
+        console.error('    --enable-l2-cache \\');
+        console.error('    --embedding-api-key=sk-...');
+        process.exit(1);
+    }
+    // Auto-fill model if not provided
+    const llmModel = options.llmModel || LLM_MODELS[options.llmProvider];
+    console.log('✓ Configuration validated');
+    console.log('✓ Creating .env file...');
+    // Generate .env file
+    const envLines = [
+        '# nttp configuration',
+        '# Generated by nttp setup --non-interactive',
+        '',
+        '# Database',
+    ];
+    if (options.databaseType === 'better-sqlite3') {
+        envLines.push(`DATABASE_PATH=${options.databasePath}`);
+    }
+    else {
+        envLines.push(`DATABASE_URL=${options.databaseUrl}`);
+    }
+    envLines.push(`DATABASE_TYPE=${options.databaseType}`);
+    envLines.push('');
+    envLines.push('# LLM Provider');
+    envLines.push(`LLM_PROVIDER=${options.llmProvider}`);
+    envLines.push(`LLM_MODEL=${llmModel}`);
+    const envKeys = {
+        anthropic: 'ANTHROPIC_API_KEY',
+        openai: 'OPENAI_API_KEY',
+        cohere: 'COHERE_API_KEY',
+        mistral: 'MISTRAL_API_KEY',
+        google: 'GOOGLE_API_KEY',
+    };
+    envLines.push(`${envKeys[options.llmProvider]}=${options.llmApiKey}`);
+    if (options.redisUrl) {
+        envLines.push('');
+        envLines.push('# Redis Cache');
+        envLines.push(`REDIS_URL=${options.redisUrl}`);
+    }
+    if (options.enableL2Cache) {
+        envLines.push('');
+        envLines.push('# Semantic Cache');
+        envLines.push('EMBEDDING_PROVIDER=openai');
+        envLines.push(`OPENAI_API_KEY=${options.embeddingApiKey}`);
+    }
+    writeFileSync('.env', envLines.join('\n') + '\n');
+    console.log('✓ .env created');
+    // Generate example code
+    console.log('✓ Creating nttp-example.js...');
+    const code = `/**
+ * NTTP Example - Ready to run!
+ * Run: node nttp-example.js or npm start
+ */
+
+import 'dotenv/config';
+import { NTTP } from 'nttp';
+
+async function main() {
+  // Load configuration from .env
+  const nttp = await NTTP.fromEnv();
+
+  console.log('✓ Connected to database');
+
+  // Run a natural language query
+  const result = await nttp.query('show me 5 records');
+
+  console.log(\`\\n✓ Query succeeded! Got \${result.data.length} rows\`);
+  console.log(\`  Generated SQL: \${result.sql}\`);
+  console.log(\`  Cache hit: \${result.cacheHit}\`);
+  console.log(\`  Time: \${result.executionTimeMs}ms\\n\`);
+
+  // Display results
+  console.table(result.data);
+
+  // Cleanup
+  await nttp.close();
+}
+
+main().catch(console.error);
+`;
+    writeFileSync('nttp-example.js', code);
+    console.log('✓ nttp-example.js created');
+    // Create package.json if it doesn't exist
+    if (!existsSync('package.json')) {
+        console.log('✓ Creating package.json...');
+        const packageJson = {
+            name: 'nttp-project',
+            version: '1.0.0',
+            type: 'module',
+            scripts: {
+                start: 'node nttp-example.js'
+            }
+        };
+        writeFileSync('package.json', JSON.stringify(packageJson, null, 2));
+        console.log('✓ package.json created');
+    }
+    // Install dependencies
+    console.log('✓ Installing dependencies (nttp, dotenv)...');
+    try {
+        execSync('npm install nttp dotenv', { stdio: 'inherit' });
+        console.log('✓ Dependencies installed');
+    }
+    catch (error) {
+        console.error('⚠ Failed to install dependencies. Please run: npm install nttp dotenv');
+    }
+    // Success message
+    console.log('\n✅ Setup complete!\n');
+    console.log('Created:');
+    console.log('  • .env (your configuration)');
+    console.log('  • nttp-example.js (example code)');
+    console.log('  • package.json (if not exists)');
+    console.log('  • node_modules/ (installed nttp, dotenv)\n');
+    console.log('Next steps:');
+    console.log('  1. Try CLI: npx nttp query "show me 5 records"');
+    console.log('  2. Or run code: node nttp-example.js');
+    console.log('  3. Or use in your code: npm start\n');
+}
+//# sourceMappingURL=setup-non-interactive.js.map

package/dist/cli/setup-non-interactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-non-interactive.js","sourceRoot":"","sources":["../../src/cli/setup-non-interactive.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -6,14 +6,25 @@ import { Command } from 'commander';
 import { runSetup } from './cli/setup-ink.js';
 import { runQuery } from './cli/query.js';
 import { runInit } from './cli/init.js';
+import { runDocs } from './cli/docs.js';
 const program = new Command();
 program
     .name('nttp')
     .description('Query databases with natural language')
-    .version('1.4.6');
+    .version('1.4.10');
 program
     .command('setup')
-    .description('Interactive setup wizard')
+    .description('Interactive setup wizard (or use --non-interactive for agents)')
+    .option('--non-interactive', 'Run setup without interactive prompts (for agents/automation)')
+    .option('--database-type <type>', 'Database type: pg, mysql2, better-sqlite3, mssql')
+    .option('--database-url <url>', 'Database connection URL')
+    .option('--database-path <path>', 'SQLite database path (for better-sqlite3)')
+    .option('--llm-provider <provider>', 'LLM provider: anthropic, openai, cohere, mistral, google')
+    .option('--llm-model <model>', 'LLM model name')
+    .option('--llm-api-key <key>', 'LLM API key')
+    .option('--redis-url <url>', 'Redis URL for L1 cache persistence (optional)')
+    .option('--enable-l2-cache', 'Enable L2 semantic cache (optional)')
+    .option('--embedding-api-key <key>', 'OpenAI API key for embeddings (required if --enable-l2-cache)')
     .action(runSetup);
 program
     .command('init')
@@ -24,5 +35,10 @@ program
     .description('Execute a natural language query')
     .option('-f, --format <type>', 'Output format (json|table)', 'table')
     .action(runQuery);
+program
+    .command('docs [query]')
+    .description('Show documentation (optionally search with query)')
+    .option('-q, --query <search>', 'Search query for documentation')
+    .action(runDocs);
 program.parse();
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,MAAM,CAAC;KACZ,WAAW,CAAC,uCAAuC,CAAC;KACpD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,OAAO,CAAC,CAAC;AAEnB,OAAO;KACJ,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,qBAAqB,EAAE,4BAA4B,EAAE,OAAO,CAAC;KACpE,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEpB,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,MAAM,CAAC;KACZ,WAAW,CAAC,uCAAuC,CAAC;KACpD,OAAO,CAAC,QAAQ,CAAC,CAAC;AAErB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,mBAAmB,EAAE,+DAA+D,CAAC;KAC5F,MAAM,CAAC,wBAAwB,EAAE,kDAAkD,CAAC;KACpF,MAAM,CAAC,sBAAsB,EAAE,yBAAyB,CAAC;KACzD,MAAM,CAAC,wBAAwB,EAAE,2CAA2C,CAAC;KAC7E,MAAM,CAAC,2BAA2B,EAAE,0DAA0D,CAAC;KAC/F,MAAM,CAAC,qBAAqB,EAAE,gBAAgB,CAAC;KAC/C,MAAM,CAAC,qBAAqB,EAAE,aAAa,CAAC;KAC5C,MAAM,CAAC,mBAAmB,EAAE,+CAA+C,CAAC;KAC5E,MAAM,CAAC,mBAAmB,EAAE,qCAAqC,CAAC;KAClE,MAAM,CAAC,2BAA2B,EAAE,+DAA+D,CAAC;KACpG,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,OAAO,CAAC,CAAC;AAEnB,OAAO;KACJ,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,qBAAqB,EAAE,4BAA4B,EAAE,OAAO,CAAC;KACpE,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,mDAAmD,CAAC;KAChE,MAAM,CAAC,sBAAsB,EAAE,gCAAgC,CAAC;KAChE,MAAM,CAAC,OAAO,CAAC,CAAC;AAEnB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/errors.d.ts

@@ -1,35 +1,128 @@
 /**
  * Custom error classes for NTTP application.
- * Mirrors Python exception classes for API compatibility.
+ * Enhanced with Claude 4.x best practices: clear explanations and actionable suggestions.
  */
 /**
  * Error thrown when intent parsing fails.
+ *
+ * This error occurs when the LLM cannot understand the natural language query
+ * or cannot map it to a valid database operation.
+ *
+ * Common causes:
+ * - Query references unknown tables or fields
+ * - Query is too ambiguous or vague
+ * - LLM API is unavailable or quota exceeded
+ *
+ * Suggested fixes:
+ * - Simplify your query (e.g., "show users" instead of complex phrasing)
+ * - Ensure table/field names match your database schema
+ * - Check LLM API key and quota
+ * - Try a more explicit query (e.g., "list all products" instead of "products")
  */
 export declare class IntentParseError extends Error {
-    constructor(message: string);
+    readonly suggestions: string[];
+    constructor(message: string, suggestions?: string[]);
+    private static formatMessage;
+    private static getDefaultSuggestions;
 }
 /**
  * Error thrown when SQL generation fails.
+ *
+ * This error occurs when the LLM cannot generate valid SQL from the parsed intent,
+ * or when the generated SQL fails safety validation.
+ *
+ * Common causes:
+ * - Complex query requires table relationships not in schema
+ * - Generated SQL violates safety rules (e.g., attempted UPDATE/DELETE)
+ * - Schema description is incomplete or incorrect
+ * - LLM hallucinated invalid SQL syntax
+ *
+ * Suggested fixes:
+ * - Ensure your database schema is complete and accurate
+ * - Try a simpler query with fewer joins
+ * - Check that the LLM model supports structured outputs
+ * - Verify the intent was parsed correctly (use explain() method)
  */
 export declare class SQLGenerationError extends Error {
-    constructor(message: string);
+    readonly suggestions: string[];
+    constructor(message: string, suggestions?: string[]);
+    private static formatMessage;
+    private static getDefaultSuggestions;
 }
 /**
  * Error thrown when SQL execution fails.
+ *
+ * This error occurs when the database rejects the generated SQL query.
+ *
+ * Common causes:
+ * - Database connection issues
+ * - Table or column doesn't exist (schema mismatch)
+ * - Type mismatch in WHERE clause (e.g., string vs integer)
+ * - Database permissions insufficient for SELECT
+ * - Syntax error in generated SQL
+ *
+ * Suggested fixes:
+ * - Verify database connection is active
+ * - Ensure schema matches actual database structure
+ * - Check database user has SELECT permissions
+ * - Examine the generated SQL for syntax errors
+ * - Try regenerating with forceNewSchema option
  */
 export declare class SQLExecutionError extends Error {
-    constructor(message: string);
+    readonly sql?: string;
+    readonly suggestions: string[];
+    constructor(message: string, sql?: string, suggestions?: string[]);
+    private static formatMessage;
+    private static getDefaultSuggestions;
 }
 /**
  * Error thrown when LLM API calls fail.
+ *
+ * This error occurs when communication with the LLM provider fails.
+ *
+ * Common causes:
+ * - Invalid or expired API key
+ * - Rate limit or quota exceeded
+ * - Network connectivity issues
+ * - LLM provider service outage
+ * - Request timeout
+ *
+ * Suggested fixes:
+ * - Verify API key is correct and active
+ * - Check API quota and rate limits with provider
+ * - Ensure network connectivity to LLM provider
+ * - Wait and retry (automatic retry with backoff is already applied)
+ * - Check LLM provider status page for outages
  */
 export declare class LLMError extends Error {
-    constructor(message: string);
+    readonly suggestions: string[];
+    constructor(message: string, suggestions?: string[]);
+    private static formatMessage;
+    private static getDefaultSuggestions;
 }
 /**
  * Error thrown when cache operations fail.
+ *
+ * This error occurs when the caching system encounters an issue.
+ *
+ * Common causes:
+ * - Redis connection failed (if using Redis L1 cache)
+ * - Redis authentication error
+ * - Network issues with Redis server
+ * - Embedding API failure (if using L2 semantic cache)
+ * - Out of memory for in-memory caches
+ *
+ * Suggested fixes:
+ * - Verify Redis server is running (if using Redis)
+ * - Check REDIS_URL format: redis://host:port
+ * - Ensure Redis authentication credentials are correct
+ * - Check OpenAI API key for embeddings (if L2 enabled)
+ * - Reduce cache size limits if memory is constrained
  */
 export declare class CacheError extends Error {
-    constructor(message: string);
+    readonly suggestions: string[];
+    constructor(message: string, suggestions?: string[]);
+    private static formatMessage;
+    private static getDefaultSuggestions;
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAK5B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,WAAW,EAAE,MAAM,EAAE,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;IAQnD,OAAO,CAAC,MAAM,CAAC,aAAa;IAK5B,OAAO,CAAC,MAAM,CAAC,qBAAqB;CAQrC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAgB,WAAW,EAAE,MAAM,EAAE,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;IAQnD,OAAO,CAAC,MAAM,CAAC,aAAa;IAK5B,OAAO,CAAC,MAAM,CAAC,qBAAqB;CAQrC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,GAAG,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAgB,WAAW,EAAE,MAAM,EAAE,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;IASjE,OAAO,CAAC,MAAM,CAAC,aAAa;IAU5B,OAAO,CAAC,MAAM,CAAC,qBAAqB;CASrC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,WAAW,EAAE,MAAM,EAAE,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;IAQnD,OAAO,CAAC,MAAM,CAAC,aAAa;IAK5B,OAAO,CAAC,MAAM,CAAC,qBAAqB;CASrC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,WAAW,EAAE,MAAM,EAAE,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;IAQnD,OAAO,CAAC,MAAM,CAAC,aAAa;IAK5B,OAAO,CAAC,MAAM,CAAC,qBAAqB;CASrC"}

package/dist/errors.js

@@ -1,55 +1,217 @@
 /**
  * Custom error classes for NTTP application.
- * Mirrors Python exception classes for API compatibility.
+ * Enhanced with Claude 4.x best practices: clear explanations and actionable suggestions.
  */
 /**
  * Error thrown when intent parsing fails.
+ *
+ * This error occurs when the LLM cannot understand the natural language query
+ * or cannot map it to a valid database operation.
+ *
+ * Common causes:
+ * - Query references unknown tables or fields
+ * - Query is too ambiguous or vague
+ * - LLM API is unavailable or quota exceeded
+ *
+ * Suggested fixes:
+ * - Simplify your query (e.g., "show users" instead of complex phrasing)
+ * - Ensure table/field names match your database schema
+ * - Check LLM API key and quota
+ * - Try a more explicit query (e.g., "list all products" instead of "products")
  */
 export class IntentParseError extends Error {
-    constructor(message) {
-        super(message);
+    suggestions;
+    constructor(message, suggestions) {
+        const enhancedMessage = IntentParseError.formatMessage(message, suggestions);
+        super(enhancedMessage);
         this.name = 'IntentParseError';
+        this.suggestions = suggestions || IntentParseError.getDefaultSuggestions();
         Object.setPrototypeOf(this, IntentParseError.prototype);
     }
+    static formatMessage(message, suggestions) {
+        const suggestionList = suggestions || IntentParseError.getDefaultSuggestions();
+        return `${message}\n\nSuggested fixes:\n${suggestionList.map(s => `  • ${s}`).join('\n')}`;
+    }
+    static getDefaultSuggestions() {
+        return [
+            'Simplify your query (e.g., "show users" instead of complex phrasing)',
+            'Ensure table/field names match your database schema',
+            'Try a more explicit query (e.g., "list all products")',
+            'Check if LLM API key is valid and has quota available',
+        ];
+    }
 }
 /**
  * Error thrown when SQL generation fails.
+ *
+ * This error occurs when the LLM cannot generate valid SQL from the parsed intent,
+ * or when the generated SQL fails safety validation.
+ *
+ * Common causes:
+ * - Complex query requires table relationships not in schema
+ * - Generated SQL violates safety rules (e.g., attempted UPDATE/DELETE)
+ * - Schema description is incomplete or incorrect
+ * - LLM hallucinated invalid SQL syntax
+ *
+ * Suggested fixes:
+ * - Ensure your database schema is complete and accurate
+ * - Try a simpler query with fewer joins
+ * - Check that the LLM model supports structured outputs
+ * - Verify the intent was parsed correctly (use explain() method)
  */
 export class SQLGenerationError extends Error {
-    constructor(message) {
-        super(message);
+    suggestions;
+    constructor(message, suggestions) {
+        const enhancedMessage = SQLGenerationError.formatMessage(message, suggestions);
+        super(enhancedMessage);
         this.name = 'SQLGenerationError';
+        this.suggestions = suggestions || SQLGenerationError.getDefaultSuggestions();
         Object.setPrototypeOf(this, SQLGenerationError.prototype);
     }
+    static formatMessage(message, suggestions) {
+        const suggestionList = suggestions || SQLGenerationError.getDefaultSuggestions();
+        return `${message}\n\nSuggested fixes:\n${suggestionList.map(s => `  • ${s}`).join('\n')}`;
+    }
+    static getDefaultSuggestions() {
+        return [
+            'Ensure your database schema is complete and accurate',
+            'Try a simpler query with fewer joins or filters',
+            'Verify the intent was parsed correctly (use explain() method)',
+            'Check that the LLM model supports your database dialect',
+        ];
+    }
 }
 /**
  * Error thrown when SQL execution fails.
+ *
+ * This error occurs when the database rejects the generated SQL query.
+ *
+ * Common causes:
+ * - Database connection issues
+ * - Table or column doesn't exist (schema mismatch)
+ * - Type mismatch in WHERE clause (e.g., string vs integer)
+ * - Database permissions insufficient for SELECT
+ * - Syntax error in generated SQL
+ *
+ * Suggested fixes:
+ * - Verify database connection is active
+ * - Ensure schema matches actual database structure
+ * - Check database user has SELECT permissions
+ * - Examine the generated SQL for syntax errors
+ * - Try regenerating with forceNewSchema option
  */
 export class SQLExecutionError extends Error {
-    constructor(message) {
-        super(message);
+    sql;
+    suggestions;
+    constructor(message, sql, suggestions) {
+        const enhancedMessage = SQLExecutionError.formatMessage(message, sql, suggestions);
+        super(enhancedMessage);
         this.name = 'SQLExecutionError';
+        this.sql = sql;
+        this.suggestions = suggestions || SQLExecutionError.getDefaultSuggestions();
         Object.setPrototypeOf(this, SQLExecutionError.prototype);
     }
+    static formatMessage(message, sql, suggestions) {
+        let formatted = message;
+        if (sql) {
+            formatted += `\n\nGenerated SQL:\n${sql}`;
+        }
+        const suggestionList = suggestions || SQLExecutionError.getDefaultSuggestions();
+        formatted += `\n\nSuggested fixes:\n${suggestionList.map(s => `  • ${s}`).join('\n')}`;
+        return formatted;
+    }
+    static getDefaultSuggestions() {
+        return [
+            'Verify database connection is active (check DATABASE_URL)',
+            'Ensure schema matches actual database structure',
+            'Check database user has SELECT permissions on the table',
+            'Examine the generated SQL for syntax errors',
+            'Try regenerating with forceNewSchema: true option',
+        ];
+    }
 }
 /**
  * Error thrown when LLM API calls fail.
+ *
+ * This error occurs when communication with the LLM provider fails.
+ *
+ * Common causes:
+ * - Invalid or expired API key
+ * - Rate limit or quota exceeded
+ * - Network connectivity issues
+ * - LLM provider service outage
+ * - Request timeout
+ *
+ * Suggested fixes:
+ * - Verify API key is correct and active
+ * - Check API quota and rate limits with provider
+ * - Ensure network connectivity to LLM provider
+ * - Wait and retry (automatic retry with backoff is already applied)
+ * - Check LLM provider status page for outages
  */
 export class LLMError extends Error {
-    constructor(message) {
-        super(message);
+    suggestions;
+    constructor(message, suggestions) {
+        const enhancedMessage = LLMError.formatMessage(message, suggestions);
+        super(enhancedMessage);
         this.name = 'LLMError';
+        this.suggestions = suggestions || LLMError.getDefaultSuggestions();
         Object.setPrototypeOf(this, LLMError.prototype);
     }
+    static formatMessage(message, suggestions) {
+        const suggestionList = suggestions || LLMError.getDefaultSuggestions();
+        return `${message}\n\nSuggested fixes:\n${suggestionList.map(s => `  • ${s}`).join('\n')}`;
+    }
+    static getDefaultSuggestions() {
+        return [
+            'Verify API key is correct (check ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.)',
+            'Check API quota and rate limits with your provider',
+            'Ensure network connectivity to the LLM provider',
+            'Wait a moment and retry (automatic backoff already applied)',
+            'Check provider status page for service outages',
+        ];
+    }
 }
 /**
  * Error thrown when cache operations fail.
+ *
+ * This error occurs when the caching system encounters an issue.
+ *
+ * Common causes:
+ * - Redis connection failed (if using Redis L1 cache)
+ * - Redis authentication error
+ * - Network issues with Redis server
+ * - Embedding API failure (if using L2 semantic cache)
+ * - Out of memory for in-memory caches
+ *
+ * Suggested fixes:
+ * - Verify Redis server is running (if using Redis)
+ * - Check REDIS_URL format: redis://host:port
+ * - Ensure Redis authentication credentials are correct
+ * - Check OpenAI API key for embeddings (if L2 enabled)
+ * - Reduce cache size limits if memory is constrained
  */
 export class CacheError extends Error {
-    constructor(message) {
-        super(message);
+    suggestions;
+    constructor(message, suggestions) {
+        const enhancedMessage = CacheError.formatMessage(message, suggestions);
+        super(enhancedMessage);
         this.name = 'CacheError';
+        this.suggestions = suggestions || CacheError.getDefaultSuggestions();
         Object.setPrototypeOf(this, CacheError.prototype);
     }
+    static formatMessage(message, suggestions) {
+        const suggestionList = suggestions || CacheError.getDefaultSuggestions();
+        return `${message}\n\nSuggested fixes:\n${suggestionList.map(s => `  • ${s}`).join('\n')}`;
+    }
+    static getDefaultSuggestions() {
+        return [
+            'Verify Redis server is running (if using Redis)',
+            'Check REDIS_URL format: redis://host:port',
+            'Ensure Redis authentication credentials are correct',
+            'Verify OpenAI API key for embeddings (if L2 cache enabled)',
+            'Try disabling cache temporarily to isolate the issue',
+        ];
+    }
 }
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EACX,MAAM,EAEN,eAAe,EAIf,MAAM,YAAY,CAAC;AAMpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnF,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAqDxD,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,eAAe,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,aAAa;IAItB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,OAAO,CAAC;IAChB,OAAO,CAAC,OAAO,CAAC;IAPlB,OAAO,CAAC,YAAY,CAAe;gBAGzB,EAAE,EAAE,IAAI,EACR,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,GAAE,UAAU,GAAG,eAAe,aAAA,EACtC,OAAO,CAAC,EAAE,aAAa,YAAA;IAGjC;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA4I9D;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAkEhE;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IAwChD;;OAEG;YACW,UAAU;IAqBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiB9B;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAOzB"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EACX,MAAM,EAEN,eAAe,EAIf,MAAM,YAAY,CAAC;AAMpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnF,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAkHxD,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,eAAe,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,aAAa;IAItB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,OAAO,CAAC;IAChB,OAAO,CAAC,OAAO,CAAC;IAPlB,OAAO,CAAC,YAAY,CAAe;gBAGzB,EAAE,EAAE,IAAI,EACR,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,GAAE,UAAU,GAAG,eAAe,aAAA,EACtC,OAAO,CAAC,EAAE,aAAa,YAAA;IAGjC;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA4I9D;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAkEhE;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IAwChD;;OAEG;YACW,UAAU;IAqBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiB9B;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAOzB"}